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