Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
gigdump(1)			  libgig tools			      gigdump(1)

NAME
     gigdump - List information about a Gigasampler (.gig) file.

SYNOPSIS
     gigdump [OPTIONS] GIGFILE

DESCRIPTION
     By default it prints out a list of all available samples, real-time instru-
     ment  scripts  and instruments within a Gigasampler (.gig) file, along with
     detailed information about their properties and settings.

OPTIONS
      GIGFILE
	    filename of the Gigasampler file

      --instrument-names
	    Only list instrument names and their index number.

      --rebuild-checksums
	    Rebuild checksum table for all samples. Read description of   --ver-
	    ify  option for more details about sample checksums in general. Usu-
	    ally you only need to use  --rebuild-checksums in case the	samples'
	    CRC  checksum  table  itself  was damaged. The  --verify option will
	    tell you if that is really the case and will suggest to you  to  use
	     --rebuild-checksums  to repair the table in such cases. If only in-
	    dividual samples were damaged, you rather might want to replace only
	    those damaged samples with gigedit(1) for example. Read  description
	    of	 --verify  for reasons to do so. When using  --rebuild-checksums
	    all checksums of all samples will be regenerated. Hence  you  should
	    manually  check all samples once after using this option. That is by
	    using your ears, or by exporting the samples, but not by  using  the
	     --verify  option.	Because the latter cannot identifiy damaged sam-
	    ples that have been damaged before the  entire  checksum  table  had
	    been regenerated.

      -v    Print version and exit.

      --verify
	    Check  raw	wave  data  integrity of all samples and print result of
	    this check.  For all samples of a  gig  file  a  correspondig  CRC32
	    checksum  is  stored along to its raw wave form data whenever a con-
	    scious change to the wave form data was performed. By  calling  gig-
	    dump  with	this  option  all  samples are scanned and compared with
	    their existing checksums to detect any damage to individual samples.
	    The individual damaged samples are listed by gigdump in  this  case.
	    Since  essentially	the  entire file has to be read, this can take a
	    long time and hence this check is  not  by	default  performed  i.e.
	    each  time a gig file is loaded for regular use for example. Accord-
	    ingly you may use  --verify from time to time  to  check  explicitly
	    whether your gig files have been damaged for some reason, i.e. after
	    modifying  them  with an instrument editor like gigedit(1).  In case
	    damaged samples were found, you may replace  those	damaged  samples
	    with  gigedit(1).	By doing this, only the replaced samples' check-
	    sums will be updated. All other checksums remain  untouched.  That's
	    why  this approach is recommended over using  --rebuild-checksums in
	    such cases.

SEE ALSO
     gigextract(1), gigmerge(1), gig2mono(1),  gig2stereo(1),  wav2gig(1),  dls-
     dump(1), rifftree(1), akaidump(1), sf2dump(1), korgdump(1)

BUGS
     Check and report bugs at http://bugs.linuxsampler.org

Author
     Application    and   manual   page   written   by	 Christian   Schoenebeck
     <cuse@users.sf.net>

libgig 4.5.2			   08 May 2018			      gigdump(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gigdump&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help