/[svn]/libgig/trunk/man/wav2gig.1.in
ViewVC logotype

Contents of /libgig/trunk/man/wav2gig.1.in

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3994 - (show annotations) (download)
Thu Sep 2 16:22:36 2021 UTC (7 weeks, 5 days ago) by schoenebeck
File size: 4847 byte(s)
* src/tools/wav2gig.cpp: fix default RegEx patterns to ignore leading path.

* src/tools/wav2gig.cpp: fix --regex-* argument parsing.

* src/tools/wav2gig.cpp: print source of parameters if --verbose is used.

* man/wav2gig.1.in: point out where samples' root note is taken from.

* Bumped version (4.3.0.svn34).

1 .TH "wav2gig" "1" "02 Sep 2021" "libgig @VERSION@" "libgig tools"
2 .SH NAME
3 wav2gig \- Create GigaStudio (.gig) file from a set of WAV files.
4 .SH SYNOPSIS
5 .B wav2gig
6 [ OPTIONS ] GIG_FILE WAV_FILE_OR_DIR_1 [ WAV_FILE_OR_DIR_2 ... ]
7 .SH DESCRIPTION
8 Takes a list of wave (.wav) files and / or directories containing wave files as
9 argument(s) and creates one new GigaStudio / GigaSampler (.gig) file for those
10 samples.
11
12 The created GigaStudio (.gig) file will contain the given input samples. The
13 samples' meta information (as far as available) like root note
14 (a.k.a 'unity note'), fine tune, loop points, loop type and loop play count
15 are automatically extracted from the input wave (.wav) files and applied
16 accordingly.
17
18 Additionally this tool creates exactly one instrument inside the newly created
19 GigaStudio (.gig) file and tries to automatically map the samples in a
20 meaningful way to that instrument. As the wave (.wav) format currently does not
21 support many of the meta information required for this particular task, this
22 tool tries to guess the required information from the individual sample's name
23 for mapping the samples accordingly. See
24 .BR SAMPLE
25 .BR NAMES
26 below for details on the assumed naming scheme for input sample files and how
27 to override that default naming scheme by providing custom regular expression
28 patterns.
29
30 .SH OPTIONS
31 .TP
32 .B \ GIG_FILE
33 GigaStudio / GigaSampler (.gig) filename to be created
34 .TP
35 .B \ WAV_FILE_OR_DIR_1
36 Filename or directory containing wave (.wav) file(s)
37 .TP
38 .B \ WAV_FILE_OR_DIR_2
39 Filename or directory containing wave (.wav) file(s)
40 .TP
41 .B \ -r
42 Recurse through all subdirectories of provided input WAV directories.
43 .TP
44 .B \ -f
45 Overwrite output GigaStudio (.gig) file in case it already exists.
46 .TP
47 .B \ -v
48 Print version and exit.
49 .TP
50 .B \ --dry-run
51 Scan input sample (.wav) files, but exit before creating any .gig file.
52 .TP
53 .B \ --verbose
54 Increase amount of info being shown.
55 .TP
56 .B \ --regex-name1 PATTERN
57 Regular expression for overriding the
58 .BR NAME1
59 part of the input sample file name scheme.
60
61 Defaults to '([^-\/\\]+) - [^-]+ - [^-]+ - [^-]+ - [^.]+'.
62
63 .TP
64 .B \ --regex-name2 PATTERN
65 Regular expression for overriding the
66 .BR NAME2
67 part of the input sample file name scheme.
68
69 Defaults to '[^-\/\\]+ - ([^-]+) - [^-]+ - [^-]+ - [^.]+'.
70
71 .TP
72 .B \ --regex-velocity-nr PATTERN
73 Regular expression for overriding the
74 .BR VELOCITY_NR
75 part of the input sample file name scheme.
76
77 Defaults to '[^-\/\\]+ - [^-]+ - ([^-]+) - [^-]+ - [^.]+'.
78
79 .TP
80 .B \ --regex-note-nr PATTERN
81 Regular expression for overriding the
82 .BR NOTE_NR
83 part of the input sample file name scheme.
84
85 Defaults to '[^-\/\\]+ - [^-]+ - [^-]+ - ([^-]+) - [^.]+'.
86
87 .TP
88 .B \ --regex-note-name PATTERN
89 Regular expression for overriding the
90 .BR NOTE_NAME
91 part of the input sample file name scheme.
92
93 Defaults to '[^-\/\\]+ - [^-]+ - [^-]+ - [^-]+ - ([^.]+)'.
94
95 .SH SAMPLE NAMES
96 By default this tool assumes the following input sample file naming scheme for
97 automatically mapping samples to regions on the keyboard, as well as mapping
98 them to velocity splits adequately:
99
100 .B 'NAME1 - NAME2 - VELOCITY_NR - NOTE_NR - NOTE_NAME.wav'
101
102 Which are interpreted in the following way:
103
104 .TP
105 .B \ NAME1
106 Primary name of the sample (e.g. "Violin").
107
108 This is not interpreted for sample mapping, but it will be used to assemble the
109 final sample name inside the GigaStudio (.gig) file.
110
111 You may use
112 .BR --regex-name1
113 to override this part of the naming scheme.
114
115 .TP
116 .B \ NAME2
117 Secondary name of the sample (e.g. "Cresc").
118
119 This is currently ignored, but might be used in future.
120
121 You may use
122 .BR --regex-name2
123 to override this part of the naming scheme.
124
125 .TP
126 .B \ VELOCITY_NR
127 MIDI Velocity number of the sample (e.g. "18").
128
129 This informtion will be used to automatically create velocity splits.
130
131 You may use
132 .BR --regex-velocity-nr
133 to override this part of the naming scheme.
134
135 .TP
136 .B \ NOTE_NR
137 MIDI Note number of the sample (e.g. "021" for note a-1).
138
139 This informtion will be used to automatically map the sample to a region on the
140 keyboard. The sample's root note (a.k.a. "unity note") is taken directly from
141 the .wav file content, however if the .wav file content does not contain a root
142 note information then
143 .B \ NOTE_NR
144 is used as root note as well.
145
146 You may use
147 .BR --regex-note-nr
148 to override this part of the naming scheme.
149
150 .TP
151 .B \ NOTE_NAME
152 Note name of the sample (e.g. "a-1").
153
154 This is not interpreted for sample mapping, but it will be used to assemble the
155 final sample name inside the GigaStudio (.gig) file.
156
157 You may use
158 .BR --regex-note-name
159 to override this part of the naming scheme.
160
161 .SH "SEE ALSO"
162 .BR gig2mono(1),
163 .BR gigextract(1),
164 .BR gigdump(1),
165 .BR gigmerge(1)
166 .BR korg2gig(1)
167
168 .SH "BUGS"
169 Check and report bugs at http://bugs.linuxsampler.org
170 .SH "Author"
171 Application and manual page written by Christian Schoenebeck <cuse@users.sf.net>

  ViewVC Help
Powered by ViewVC