1 |
schoenebeck |
1405 |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
2 |
|
|
<html lang="en"> |
3 |
|
|
<head> |
4 |
|
|
<title>libgig</title> |
5 |
|
|
<link rel="shortcut icon" href="http://download.linuxsampler.org/favicon.ico" type="image/x-icon"> |
6 |
|
|
<link rel="stylesheet" type="text/css" href="css/content.css" title="content" media="all"> |
7 |
|
|
</head> |
8 |
|
|
<body> |
9 |
|
|
<center><h1>libgig</h1></center> |
10 |
|
|
<p> |
11 |
|
|
libgig is a C++ library for loading, modifying existing and creating new |
12 |
schoenebeck |
2822 |
Gigasampler (.gig) files and DLS (Downloadable Sounds) Level 1/2 files, KORG sample |
13 |
|
|
based instruments (.KSF and .KMP files), SoundFont v2 (.sf2) files and AKAI sampler data. |
14 |
|
|
The source code package includes a couple of command line tools based on the |
15 |
schoenebeck |
1405 |
library. The library and tools are released in source code format under the |
16 |
schoenebeck |
2822 |
<a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</a>, |
17 |
|
|
except the AKAI classes which are released under the |
18 |
|
|
<a href="http://www.gnu.org/copyleft/lgpl.html">GNU Lesser General Public License</a>. |
19 |
schoenebeck |
1405 |
</p> |
20 |
|
|
<p> |
21 |
|
|
This library is developed and optimized for POSIX compliant operating |
22 |
|
|
systems like Linux and OSX and since release 3.1.1 for Windows as well. |
23 |
|
|
libgig was developed to compile on any operating system, though since |
24 |
|
|
release 3.0.0 libgig uses one tiny operating system dependant method to |
25 |
|
|
be able to resize files. Should be a 5 minute job to implement this method |
26 |
|
|
for other operating systems as well though. |
27 |
|
|
</p> |
28 |
|
|
|
29 |
|
|
<a name="src"></a> |
30 |
|
|
<h1>Source Code</h1> |
31 |
|
|
<p> |
32 |
|
|
<table border="1"> |
33 |
|
|
<TH> |
34 |
|
|
<TR> |
35 |
|
|
<TD>Version</TD> |
36 |
|
|
<TD>File Name</TD> |
37 |
|
|
<TD>File Size</TD> |
38 |
|
|
<TD>Date</TD> |
39 |
|
|
</TR> |
40 |
|
|
</TH> |
41 |
|
|
<tbody> |
42 |
schoenebeck |
2822 |
<tr> |
43 |
schoenebeck |
3526 |
<td>4.2.0</td> |
44 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-4.2.0.tar.bz2">libgig-4.2.0.tar.bz2</a></td> |
45 |
|
|
<td>729k</td> |
46 |
|
|
<td>25-Jul-2017 13:10</td> |
47 |
|
|
</tr> |
48 |
|
|
<tr> |
49 |
schoenebeck |
3390 |
<td>4.1.0</td> |
50 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-4.1.0.tar.bz2">libgig-4.1.0.tar.bz2</a></td> |
51 |
|
|
<td>526k</td> |
52 |
|
|
<td>25-Nov-2017 13:52</td> |
53 |
|
|
</tr> |
54 |
|
|
<tr> |
55 |
schoenebeck |
2822 |
<td>4.0.0</td> |
56 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-4.0.0.tar.bz2">libgig-4.0.0.tar.bz2</a></td> |
57 |
|
|
<td>684k</td> |
58 |
|
|
<td>14-Jul-2015 18:36</td> |
59 |
|
|
</tr> |
60 |
schoenebeck |
1405 |
<tr> |
61 |
schoenebeck |
1991 |
<td>3.3.0</td> |
62 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-3.3.0.tar.bz2">libgig-3.3.0.tar.bz2</a></td> |
63 |
|
|
<td>330k</td> |
64 |
|
|
<td>30-Jul-2009 10:35</td> |
65 |
|
|
</tr> |
66 |
|
|
<tr> |
67 |
schoenebeck |
1914 |
<td>3.2.1</td> |
68 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-3.2.1.tar.bz2">libgig-3.2.1.tar.bz2</a></td> |
69 |
|
|
<td>316k</td> |
70 |
|
|
<td>05-Dec-2007 16:33</td> |
71 |
|
|
</tr> |
72 |
|
|
<tr> |
73 |
schoenebeck |
1422 |
<td>3.2.0</td> |
74 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-3.2.0.tar.bz2">libgig-3.2.0.tar.bz2</a></td> |
75 |
|
|
<td>329k</td> |
76 |
|
|
<td>14-Oct-2007 16:52</td> |
77 |
|
|
</tr> |
78 |
|
|
<tr> |
79 |
schoenebeck |
1405 |
<td>3.1.1</td> |
80 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-3.1.1.tar.bz2">libgig-3.1.1.tar.bz2</a></td> |
81 |
|
|
<td>294k</td> |
82 |
|
|
<td>24-Mar-2007 19:26</td> |
83 |
|
|
</tr> |
84 |
|
|
<tr> |
85 |
|
|
<td>3.1.0</td> |
86 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-3.1.0.tar.bz2">libgig-3.1.0.tar.bz2</a></td> |
87 |
|
|
<td>294k</td> |
88 |
|
|
<td>24-Nov-2006 14:03</td> |
89 |
|
|
</tr> |
90 |
|
|
<tr> |
91 |
|
|
<td>3.0.0</td> |
92 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-3.0.0.tar.bz2">libgig-3.0.0.tar.bz2</a></td> |
93 |
|
|
<td>275k</td> |
94 |
|
|
<td>28-Apr-2006 20:05</td> |
95 |
|
|
</tr> |
96 |
|
|
<tr> |
97 |
|
|
<td>2.0.2</td> |
98 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-2.0.2.tar.bz2">libgig-2.0.2.tar.bz2</a></td> |
99 |
|
|
<td>255k</td> |
100 |
|
|
<td>15-Aug-2005 19:34</td> |
101 |
|
|
</tr> |
102 |
|
|
<tr> |
103 |
|
|
<td>2.0.1</td> |
104 |
|
|
<td><a href="http://download.linuxsampler.org/packages/libgig-2.0.1.tar.bz2">libgig-2.0.1.tar.bz2</a></td> |
105 |
|
|
<td>241k</td> |
106 |
|
|
<td>13-June-2005 02:18</td> |
107 |
|
|
</tr> |
108 |
|
|
<tr> |
109 |
|
|
<td>2.0.0</td> |
110 |
|
|
<td><A href="http://download.linuxsampler.org/packages/libgig-2.0.0.tar.bz2">libgig-2.0.0.tar.bz2</A></td> |
111 |
|
|
<td>61k</td> |
112 |
|
|
<td>10-May-2005 12:08</td> |
113 |
|
|
</tr> |
114 |
|
|
<tr> |
115 |
|
|
<td>1.0.0</td> |
116 |
|
|
<td><A href="http://download.linuxsampler.org/packages/libgig-1.0.0.tar.bz2">libgig-1.0.0.tar.bz2</A></td> |
117 |
|
|
<td>67k</td> |
118 |
|
|
<td>26-Nov-2004 23:39</td> |
119 |
|
|
</tr> |
120 |
|
|
<tr> |
121 |
|
|
<td>0.7.1</td> |
122 |
|
|
<td><A href="http://download.linuxsampler.org/packages/libgig-0.7.1.tar.bz2">libgig-0.7.1.tar.bz2</A></td> |
123 |
|
|
<td>56k</td> |
124 |
|
|
<td>09-July-2004 00:13</td> |
125 |
|
|
</tr> |
126 |
|
|
<tr> |
127 |
|
|
<td>0.7.0</td> |
128 |
|
|
<td><A href="http://download.linuxsampler.org/packages/libgig-0.7.0.tar.bz2">libgig-0.7.0.tar.bz2</A></td> |
129 |
|
|
<td>253k</td> |
130 |
|
|
<td>03-May-2004 16:51</td> |
131 |
|
|
</tr> |
132 |
|
|
<tr> |
133 |
|
|
<td>0.6.0</td> |
134 |
|
|
<td><A href="http://download.linuxsampler.org/packages/libgig-0.6.0.tar.bz2">libgig-0.6.0.tar.bz2</A></td> |
135 |
|
|
<td>336k</td> |
136 |
|
|
<td>20-Dec-2003 05:41</td> |
137 |
|
|
</tr> |
138 |
|
|
</tbody> |
139 |
|
|
</table> |
140 |
|
|
<br> |
141 |
persson |
2179 |
See <a href="http://svn.linuxsampler.org/cgi-bin/viewvc.cgi/libgig/trunk/ChangeLog"> |
142 |
schoenebeck |
1405 |
Changelog</a> for details. |
143 |
|
|
</p> |
144 |
|
|
|
145 |
|
|
<a name="binaries"></a> |
146 |
|
|
<h1>Binary Packages</h1> |
147 |
|
|
For <a href="http://download.linuxsampler.org/packages/win32/">Windows</a> you can find a precompiled DLL of libgig, |
148 |
|
|
coming with the example command line tools as .exe files, packed into one |
149 |
|
|
.zip file. For Linux there are currently <a href="http://download.linuxsampler.org/packages/debian/">Debian</a> packages |
150 |
|
|
and <a href="http://download.linuxsampler.org/packages/rpms/">RPM</a> packages for Redhat / Fedora, SuSE and Mandrake. |
151 |
|
|
Note that libgig is already part of many distributions. You might want to use |
152 |
|
|
packages coming with your distribution instead. |
153 |
|
|
|
154 |
|
|
<a name="tools"></a> |
155 |
|
|
<h1>Tools</h1> |
156 |
|
|
The libgig sources and the 'gigtools' Debian package contain the following command line tools: |
157 |
|
|
<ul> |
158 |
|
|
<li><b>gigextract</b> (Extracts samples from a .gig file)</li> |
159 |
|
|
<li><b>gigdump</b> (Prints out the content of a .gig file)</li> |
160 |
schoenebeck |
2822 |
<li><b>gigmerge</b> (Merges several .gig files to one .gig file)</li> |
161 |
|
|
<li><b>gig2mono</b> (Converts .gig files from stereo to mono)</li> |
162 |
|
|
<li><b>gig2stereo</b> (Converts .gig files to true interleaved stereo sounds)</li> |
163 |
|
|
<li><b>korgdump</b> (Prints out the content of the various KORG file types)</li> |
164 |
|
|
<li><b>korg2gig</b> (Convert KORG sound file to Gigasampler/GigaStudio format)</li> |
165 |
|
|
<li><b>sf2dump</b> (Prints out the content of a .sf2 file)</li> |
166 |
|
|
<li><b>sf2extract</b> (Extracts audio samples from a .sf2 file)</li> |
167 |
|
|
<li><b>akaidump</b> (Dump an AKAI media i.e. from a CDROM drive as disk image file |
168 |
|
|
to your hard disk drive)</li> |
169 |
|
|
<li><b>akaiextract</b> (Extracts samples from an Akai disk image, either from a media |
170 |
|
|
i.e. CDROM or Zip drive, from a AKAI disk image file)</li> |
171 |
schoenebeck |
1405 |
<li><b>dlsdump</b> (Prints out the content of a DLS file)</li> |
172 |
|
|
<li><b>rifftree</b> (Prints out the RIFF tree structure of an arbitrary RIFF file)</li> |
173 |
|
|
</ul> |
174 |
|
|
|
175 |
|
|
<a name="doc"></a> |
176 |
|
|
<h1>Documentation</h1> |
177 |
|
|
<p> |
178 |
schoenebeck |
2822 |
Online API Documentation for the latest libgig version (automatically updated to latest version from SVN) |
179 |
schoenebeck |
1405 |
(<a href="http://download.linuxsampler.org/doc/libgig/api/">HTML</a>) |
180 |
|
|
</p> |
181 |
|
|
<p> |
182 |
schoenebeck |
2822 |
Old kick start documentation for libgig (<a href="http://download.linuxsampler.org/doc/libgig/Introduction.sxw">OpenOffice</a>, <a href="http://download.linuxsampler.org/doc/libgig/Introduction.pdf">PDF</a>) |
183 |
schoenebeck |
1405 |
</p> |
184 |
|
|
|
185 |
|
|
<a name="examples"></a> |
186 |
|
|
<h1>Examples</h1> |
187 |
|
|
There are couple of example applications which demonstrate how to use the |
188 |
|
|
library. Beside the mentioned <a href="#tools">tools</a> coming with the |
189 |
|
|
source packages, there are also the following demo applications (only in |
190 |
|
|
source code format): |
191 |
|
|
<ul> |
192 |
|
|
<li><a href="examples/gigwritedemo.cpp"><b>gigwritedemo.cpp</b></a> (demonstrates how to create and modify Gigasampler format files)</li> |
193 |
|
|
<li><a href="examples/dlswritedemo.cpp"><b>dlswritedemo.cpp</b></a> (demonstrates how to create and modify DLS Level 1/2 files)</li> |
194 |
|
|
<li><a href="examples/riffwritedemo.cpp"><b>riffwritedemo.cpp</b></a> (demonstrates how to create and modify RIFF files in general)</li> |
195 |
|
|
</ul> |
196 |
|
|
|
197 |
schoenebeck |
1990 |
<a name="apps"></a> |
198 |
|
|
<h1>Applications</h1> |
199 |
|
|
<p> |
200 |
|
|
Besides <a href="http://www.linuxsampler.org">LinuxSampler</a> and its |
201 |
|
|
related programs (e.g. qsampler, gigedit), the following third party |
202 |
|
|
applications are also using libgig to access Gigasampler format files: |
203 |
|
|
<ul> |
204 |
|
|
<li><a href="http://www.wikid.co.uk/capture/">Capture</a></li> |
205 |
|
|
</ul> |
206 |
|
|
You are also using libgig for your application? Please let me know! |
207 |
|
|
</p> |
208 |
|
|
|
209 |
schoenebeck |
1405 |
<a name="diagrams"></a> |
210 |
|
|
<h1>Diagrams</h1> |
211 |
|
|
<p> |
212 |
|
|
UML static structure diagram focused on the aspect of actually using the |
213 |
|
|
library (created with <a href="http://wwwhome.cs.utwente.nl/~tcm/">TCM</a>): |
214 |
|
|
<table border="1"> |
215 |
|
|
<TH> |
216 |
|
|
<TR> |
217 |
|
|
<TD>Version</TD> |
218 |
|
|
<TD>File Formats</TD> |
219 |
|
|
<TD>Date</TD> |
220 |
|
|
</TR> |
221 |
|
|
</TH> |
222 |
|
|
<tbody> |
223 |
|
|
<tr> |
224 |
|
|
<td>1.0.0</td> |
225 |
|
|
<td> |
226 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-1.0.0.ssd">TCM</A>, |
227 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-1.0.0.pdf">PDF</A>, |
228 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-1.0.0.ps">PostScript</A> |
229 |
|
|
</td> |
230 |
|
|
<td>26-Nov-2004 21:18</td> |
231 |
|
|
</tr> |
232 |
|
|
<tr> |
233 |
|
|
<td>0.7.x</td> |
234 |
|
|
<td> |
235 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-0.7.0.ssd">TCM</A>, |
236 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-0.7.0.pdf">PDF</A>, |
237 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-0.7.0.ps">PostScript</A> |
238 |
|
|
</td> |
239 |
|
|
<td>03-May-2004 17:36</td> |
240 |
|
|
</tr> |
241 |
|
|
<tr> |
242 |
|
|
<td>0.6.0</td> |
243 |
|
|
<td> |
244 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-0.6.0.ssd">TCM</A>, |
245 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-0.6.0.pdf">PDF</A>, |
246 |
|
|
<A href="http://download.linuxsampler.org/doc/libgig/libgig-0.6.0.ps">PostScript</A> |
247 |
|
|
</td> |
248 |
|
|
<td>20-Dec-2003 05:41</td> |
249 |
|
|
</tr> |
250 |
|
|
</tbody> |
251 |
|
|
</table> |
252 |
|
|
(Sorry, these UML diagrams are a bit outdated). |
253 |
|
|
</p> |
254 |
|
|
|
255 |
persson |
2178 |
<a name="svn"></a> |
256 |
|
|
<h1>Subversion</h1> |
257 |
schoenebeck |
1405 |
<p> |
258 |
|
|
You can check out the latest development version of libgig from the |
259 |
persson |
2178 |
LinuxSampler Subversion server: |
260 |
schoenebeck |
1405 |
</p> |
261 |
|
|
<p> |
262 |
|
|
<table border="1"> |
263 |
|
|
<tbody> |
264 |
persson |
2178 |
<tr><TD>svn co https://svn.linuxsampler.org/svn/libgig/trunk libgig</TD></tr> |
265 |
schoenebeck |
1405 |
</tbody> |
266 |
|
|
</table> |
267 |
|
|
</p> |
268 |
|
|
<p> |
269 |
persson |
2178 |
You can also <a href="http://svn.linuxsampler.org/cgi-bin/viewvc.cgi/libgig/trunk/">browse the libgig Subversion repository</a>. |
270 |
schoenebeck |
1405 |
</p> |
271 |
|
|
|
272 |
|
|
<a name="author"></a> |
273 |
|
|
<h1>Author</h1> |
274 |
|
|
<p>This library was written by <a href="mailto:cuse@users.sf.net">Christian Schoenebeck</a> |
275 |
|
|
(<a href="http://stud.fh-heilbronn.de/~cschoene/gpg.asc">PGP/GPG Public Key</a>). |
276 |
|
|
</p> |
277 |
|
|
|
278 |
|
|
<a name="license"></a> |
279 |
|
|
<h1>Licensing</h1> |
280 |
|
|
<p> |
281 |
|
|
libgig and its tools are released under the |
282 |
schoenebeck |
2822 |
<a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</a>, |
283 |
|
|
except the AKAI classes which are released under the |
284 |
|
|
<a href="http://www.gnu.org/copyleft/lgpl.html">GNU Lesser General Public License</a> |
285 |
schoenebeck |
1405 |
</p> |
286 |
|
|
|
287 |
|
|
<a name="contact"></a> |
288 |
|
|
<h1>Contact</h1> |
289 |
|
|
<p>You can either send emails to the |
290 |
|
|
<a href="mailto:linuxsampler-devel@lists.sourceforge.net">LinuxSampler Developers Mailing List</a> |
291 |
|
|
or contact <a href="mailto:cuse@users.sf.net">me</a> directly. |
292 |
|
|
</p> |
293 |
|
|
|
294 |
|
|
<p> |
295 |
|
|
Happy hacking!<br> |
296 |
|
|
Christian |
297 |
|
|
</p> |
298 |
|
|
</body> |
299 |
|
|
</html> |