1 |
schoenebeck |
2685 |
.TH "gig2stereo" "1" "03 Jan 2015" "libgig @VERSION@" "libgig tools" |
2 |
|
|
.SH NAME |
3 |
|
|
gig2stereo \- Converts Gigasampler (.gig) files from mono pairs to true stereo. |
4 |
|
|
.SH SYNOPSIS |
5 |
|
|
.B gig2stereo |
6 |
|
|
[-v] [--verbose [LEVEL]] [-r] [--keep] [--force-replace] FILE_OR_DIR1 [ FILE_OR_DIR2 ... ] |
7 |
|
|
.SH DESCRIPTION |
8 |
|
|
Takes a list of Gigasampler (.gig) files and / or directories as argument(s) and |
9 |
|
|
converts the individual Gigasampler files from two separate mono sample pairs to |
10 |
|
|
true stereo interleaved format. Given directories are scanned for .gig files. |
11 |
|
|
The Gigasampler files are directly modified, not copied. Since at this point the |
12 |
|
|
Gigasampler format only defines mono and stereo samples, this program currently |
13 |
|
|
also assumes all samples in the .gig files provided to be either mono or stereo. |
14 |
|
|
|
15 |
|
|
Background: The Gigasampler/GigaStudio format allows to create stereo |
16 |
|
|
instruments in two ways: either by referencing true stereo (interleaved) samples |
17 |
|
|
in the instruments, or by referencing a pair of (two) mono samples. Unfortunately |
18 |
|
|
LinuxSampler does not support the latter at the moment, thus if a gig instrument |
19 |
|
|
uses mono sample pairs, you will still hear it in mono. This tool was created to |
20 |
|
|
circumvent this issue by allowing to convert gig files to using real stereo |
21 |
|
|
(interlaved) samples instead. And even if LinuxSampler would add support for |
22 |
|
|
mono sample pairs, it would be less efficient than using real stereo samples, |
23 |
|
|
both concerning disk streaming as well as DSP processing after streaming input. |
24 |
|
|
|
25 |
|
|
After conversion, you will find all newly created true stereo samples in |
26 |
|
|
separate new sample group(s), which will be postfixed with " STEREO" in their |
27 |
|
|
group names. So you should easily be able to distinguish the newly created true |
28 |
|
|
stereo samples (i.e. when editing the .gig file with |
29 |
|
|
.BR gigedit (1) |
30 |
|
|
) from old samples. Also, if the original (now replaced) mono samples were |
31 |
|
|
postfixed with a channel indicator in their sample names |
32 |
|
|
(i.e. "Spiccato D3 -L"), the new stereo samples will have a similar sample name, |
33 |
|
|
but without such an audio channel indicator at the end of their names. Thus in |
34 |
|
|
the mentioned example, the newly created stereo sample would be named |
35 |
|
|
"Spiccato D3" instead. |
36 |
|
|
.SH OPTIONS |
37 |
|
|
.TP |
38 |
|
|
.B \ FILE_OR_DIR1 |
39 |
|
|
Gigasampler (.gig) filename or directory |
40 |
|
|
.TP |
41 |
|
|
.B \ FILE_OR_DIR2 |
42 |
|
|
Gigasampler (.gig) filename or directory |
43 |
|
|
.TP |
44 |
|
|
.B \ --force-replace |
45 |
|
|
Force replacing any found old mono sample reference by the new true stereo |
46 |
|
|
samples. By default certain references of the old mono samples are not replaced |
47 |
|
|
by new true stereo samples, usually because the respective old mono reference is |
48 |
|
|
been used in an instrument context that seems to be entirely a mono use case, |
49 |
|
|
not stereo, and thus replacing the mono sample reference by stereo ones might |
50 |
|
|
not be intended for the respective instrument. Because there might indeed be |
51 |
|
|
instruments in the same .gig file which are designed as explicit mono variant |
52 |
|
|
(i.e. to allow the musician to save resources while playing, or for live |
53 |
|
|
mix-down reasons, which are usually mono on live venues). By using |
54 |
|
|
--force-replace all those old mono sample references in question will also be |
55 |
|
|
replaced by the new stereo sample references. |
56 |
|
|
.TP |
57 |
|
|
.B \ --keep |
58 |
|
|
Keep old mono samples. By default old converted mono samples, if they are not |
59 |
|
|
referenced by any instrument anymore, will automatically be deleted after |
60 |
|
|
conversion. By using this argument it will preserve all of the old mono samples. |
61 |
|
|
.TP |
62 |
|
|
.B \ -r |
63 |
|
|
Recurse through subdirectories. |
64 |
|
|
.TP |
65 |
|
|
.B \ -v |
66 |
|
|
Print version and exit. |
67 |
|
|
.TP |
68 |
|
|
.B \ --verbose [LEVEL] |
69 |
|
|
Be verbose and print additional informations while converting. The additional |
70 |
|
|
numeric argument is optional, it allows to define the verbosity level |
71 |
|
|
(1 .. 2, default: 1). |
72 |
|
|
|
73 |
|
|
.SH "SEE ALSO" |
74 |
|
|
.BR gig2mono(1), |
75 |
|
|
.BR gigextract(1), |
76 |
|
|
.BR gigdump(1), |
77 |
|
|
.BR gigmerge(1) |
78 |
|
|
|
79 |
|
|
.SH "BUGS" |
80 |
|
|
None. Report bugs to http://bugs.linuxsampler.org |
81 |
|
|
.SH "Author" |
82 |
|
|
Written by Christian Schoenebeck <cuse@users.sf.net> |