Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for sfxload (redhat section 1)

sfxload(1)			     General Commands Manual			       sfxload(1)

NAME
       sfxload - load a SoundFont file on the AWE32 sound driver

SYNOPSIS
       sfxload [-options] fontfile

DESCRIPTION
       sfxload	is  a utility program to transfer the sound wave and instruments data in a Sound-
       Font file to the AWE32 sound driver.  This program is necessary for playing  MIDI  samples
       via sequencer programs supporting AWE driver.

       Basically, sfxload behaves as two ways.
		 % sfxload fontfile
		 % sfxload -b1 fontfile

       The  first  usage  is  to  read SF2 (or SBK) file and transfer to the awe driver.  In this
       case, the samples which were loaded on the driver are replaced with the new one.   In  the
       second case, sfxload reads the file and appends it to the pre-loaded samples on the driver
       with specified bank number.  The old samples remain in the driver.  The additional samples
       can be cleared via -x option (see below).

       The sound files are searched through the path list.  The path list is defined as built-in.
       If the environment variable SFBANKDIR or the command line option -P is given, it  replaces
       the default search list.  The file extension .sf2, and .sbk can be abbreviated.

OPTIONS
       -i, --clear[=bool]
	      Remove all samples before loading the fonts.  This is an explicit directive (see -b
	      option).	If this option is  specified  alone  without  soundfont  file  arguments,
	      sfxload  does onlay remove samples.  Either of "on", "off", "yes", "no", "true", or
	      "false" can be specified as an optional argument.

       -x, --remove[=bool]
	      Remove the optional samples previouly loaded via -b  option.   Otherwise,  all  new
	      samples are simply appended.

       -N, --increment[=bool]
	      Do  not  clear samples even with the absence of -b option.  However, this option is
	      not exclusive with -x option.  If both options are specified, and the  memory  full
	      error  is  encountered during loading fonts, sfxload will try to remove samples and
	      load the fonts again.

       -b, --bank=number
	      Append the sound samples on the specified bank.  Without this option,  all  present
	      samples  in the driver are removed before loading the new fonts unless -N option is
	      specified.  Usually, this option is necessary to load user bank, typically in  bank
	      one.  For example,
			% sfxload synthgm.sbk
			% sfxload -b1 surprise.sf2

       -l, --lock[=bool]
	      Lock the font.  The locked font is no longer removed via remove option (-x) even if
	      it's loaded together with -b option.

       -C, --compat[=bool]
	      Use the old (v0.4.2) parameter calculations.

       -A, --sense=sensitivity
	      (Only valid on compatible mode)
	      Set sample attenuation sensitivity.  This option controls the sensitivity  of  ini-
	      tial  attenuation  parameter  of each instrument defined in SoundFont file.  In the
	      program, each parameter is calculated from the value divided by this number for the
	      original value.  The number 1.0 means that the original initial attenuation parame-
	      ters would be used.  Generally, smaller number makes drum sounds louder.	(I  think
	      -A 2 would be similar to Windows sounds.)  The default value is 10.  Note that this
	      option changes also the default attenuation automatically (see below).

       -a, --atten=attenuation
	      (Only valid on compatible mode)
	      Set the default attenuation level.  This option controls the minimum attenuation of
	      the sample.  The parameter is given in raw digit number for AWE driver, that is, in
	      8/3 dB unit.  Since --sense option changes the default  attenuation  automatically,
	      specify this option later from --sense option.  The default value is 32.

       -d, --decay=scale
	      (Only valid on compatible mode)
	      Set  the	scale  of envelope decay time.	Default value is 50.0.	Sounds decay fast
	      when larger number is set.  The ver.0.3 sfxload uses 54.8.  If you want to keep the
	      same sound, use this number instead.

       -M, --memory[=bool]
	      Display the left memory size in DRAM on the AWE32 card.

       -c, --chorus=percent
	      Specify  the  effects  of  chorus.   The	value  is in percent, from 0 to 100.  The
	      default is unspecified.  This value may be overwritten by MIDI control messages.

       -r, --reverb=percent
	      Specify the effects of reverb.  The value is  in	percent,  from	0  to  100.   The
	      default is unspecified.  This value may be overwritten by MIDI control messages.

       -B, --addblank[=bool]
	      Add  48 size of blank loop on each sample data.  Usually, this option is not neces-
	      sary.  Most of soundfont files are designed well for enough blank  loops	for  each
	      sample.

       -L, --extract=source[:map]
	      Extract  and load only the specified preset(s).  This option is usually employed by
	      drvmidi.	The preset is given as same as in virtual bank file.

       -v, --verbose[=level]
	      Increase or set the verbosity level.

       -V, --volume=percent
	      Specify the total volume of sounds, provided in percent.	 The  default  volume  is
	      70%.

       -P, --path=path1:path2:pathN
	      Specify  the search path list.  The sound files are searched from path1, path2, and
	      so on.  This overrides both the system path and environment variable SFBANKDIR.

       -d, --device=file
	      Speicfy the device file name.  As default, /dev/sequencer is used.

VIRTUAL BANK FILE
       The virtual bank file is a list of presets treated as one soundfont file.  The  syntax  of
       virtual bank is as follows:
		      # comments
		      source:map[:soundfont [preset-name]
		      source:map[:soundfont [preset-name]
		      ...

       The first and second items are the source and mapped presets, respectively.  The former is
       the existing preset in the soundfont, and the latter is the actual preset  loaded  on  the
       sound driver.  The preset is described by the following three values,
		      preset/bank/keynote
       If  bank  and  keynote are omitted, bank 0 and keynote -1 (meaning to search all keys) are
       applied.

       The third item is the name of soundfont file.  The file is searched  from  the  prescribed
       search-path.  The remaining arguments are ignored in sfxload.

       If  the	soundfont  name  is omitted, sfxload loads it as preset mapping.  It just behaves
       like a symbolic link of file opposing to copying of the file.   Any  sample  data  is  not
       referred at this time, but searched first when the note is played.

       A couple of special commands can be used together with the virtual presets above.  default
       command is used to specify the default soundfont file.  Any other presets  which  are  not
       defined	in  the  virtual preset lists are loaded from this default font.  For example, in
       the following virtual bank, 2mbgmgs.sf2 is used except for standard drumsets which employs
       drum.sf2:
		      0/128:0/128:drum.sf2
		      default 2mbgmgs.sf2

       Another	special  command  is  include command.	This simply includes another virtual bank
       file under the current position. For example,
		      default standard.sf2
		      0/128:0/128:drum.sf2
		      include xgsfx.bnk

SYSTEM RESROUCE FILE
       The default option arguments can be stored in the system resource  file.   There  are  two
       files loaded as default.
		 $HOME/.sfxloadrc
		 /etc/sfxloadrc

       The syntax is as follows:
		 fontname -options..
       The  first  argument  is soundfont file name for each option.  The remaining arguments are
       identical with command line options.  The font name default is used  for  default  options
       for  all  sound	fonts.	The default options are overridden by specific options or command
       line options.

       For example, to set default chorus level 20 except for  synthgm	font,  you  can  write	a
       resource file ~/.sfxloadrc like that:
		 default   --chorus=20
		 synthgm --chorus=0

ENVIRONMENT
       SFBANKDIR
	      Search path for sound files.  The current directory is always searched at first.

SEE ALSO
       drvmidi(1)

COPYRIGHT
       Copyright (C) 1996-1999 Takashi Iwai.

       The  AWE32  driver and utilties are free software; you can redistribute them and/or modify
       them under the terms of the GNU General Public License as published by the  Free  Software
       Foundation; either version 2 of the License, or (at your option) any later version.

					 December 1, 1998			       sfxload(1)


All times are GMT -4. The time now is 07:07 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password