Snd Customization and Extension Part 2

related documentationsnd.htmlextsnd.htmlclm.htmlsndlib.htmlsndscm.htmlindex.html

Snd Startup
Runtime modules and external programs
Index

Snd Startup

Snd resources

In the Motif version, there are a few X-style resources that Snd looks for (see Snd.ad):

initFile	"~/.snd"
epsFile	"snd.eps"
overwriteCheck	0
autoResize	1
horizontalPanes	0

buttonFont	--times-medium-r---14------iso8859-1
boldbuttonFont	--times-bold-r---14------iso8859-1
axisLabelFont	--times-medium-r-normal--20-----*-iso8859-1
axisNumbersFont	--courier-medium-r-normal--14-----*-iso8859-1
helpTextFont	9x15
listenerFont	default

useSchemes	none
highlightcolor	ivory1
basiccolor	ivory2
positioncolor	ivory3
zoomcolor	ivory4
cursorcolor	red
selectioncolor	lightsteelblue1
mixcolor	lightgreen
mixfocuscolor	yellow2
listenercolor	aliceblue
envedwaveformcolor	blue
filterwaveformcolor	blue
mixwaveformcolor	darkgray
graphcolor	white
selectedgraphcolor	white
datacolor	black
selecteddatacolor	black
markcolor	red
pushedbuttoncolor	lightsteelblue1
sashcolor	lightgreen

If you have the HTML widget loaded, the following resources are also available:

htmlDir	"."
htmlWidth	600
htmlHeight	400
htmlFontSizeList	"14,10,24,24,18,14,12"
htmlFixedFontSizeList	"14,10"

You can experiment with other choices by using the -xrm command line argument:

  snd -xrm '*Highlightcolor: Red' oboe.snd
  snd -xrm '*AxisNumbersFont: 6x10' oboe.snd
  snd -xrm '*overwriteCheck: 1' oboe.snd
  snd -xrm '*useSchemes: all' -xrm '*scheme: Pacific'
  snd -xrm '*fontList: 9x15' oboe.snd
  snd -xrm '*listenerFont: 6x10' oboe.snd
  snd -xrm '*mixwaveformcolor: red' oboe.snd -notebook
  snd oboe.snd pistol.snd -xrm '*selectedgraphcolor: black' -xrm '*selecteddatacolor: white'
  snd oboe.snd -title hiho -display hummer.hiho:0.0 -xrm '*chn-graph*backgroundPixmap: text.xpm'

The color names can be found in rgb.scm. If you use SGI color schemes (the useSchemes resource), most of the color resources mentioned above are ignored (the cursor and selection colors are never ignored). If color schemes are available they're listed in /usr/lib/X11/schemes, probably -- it's unfortunate that there is the language Scheme used by Guile, and the notion of an SGI color scheme -- there is no connection between the two. The last example sets the window title to "hiho", rather than "snd", displays the window on the machine hummer.hiho (presumably accessible over the net), and tiles the graph backgrounds with the contents of text.xpm. To get the -geometry argument to work, set the autoResize resource to 0:

  snd oboe.snd -geometry 800x200 -xrm '*autoResize: 0'

These resources can be set in your .Xdefaults file:

snd*buttonFont:         -adobe-times-medium-r-*-*-14-*-*-*-*-*-*-*
snd*boldbuttonFont:     -adobe-times-bold-r-*-*-14-*-*-*-*-*-*-*
snd*axisLabelFont:      -adobe-times-medium-r-normal-*-18-*-*-*-*-*-*-*
snd*axisNumbersFont:    9x15
snd*fontList:           9x15
snd*helpTextFont:       9x15

The autoResize resource determines how Snd acts when files are added or removed from its overall display. The default (1) causes Snd to expand or contract the main window's size to accommodate the sounds (many people find this distracting); if autoResize is 0, the outer window size remains the same, and the sounds try to fit as best they can. See also the variable auto-resize. If overwriteCheck is 1, Snd asks before overwriting existing files. The horizontalPanes resource is equivalent to the -h flag; if 1, sounds are layed out horizontally rather than vertically; if 2, you get a notebook widget holding the sounds.

The various color resources are:

basiccolor	default background color everywhere	`basic-color`
cursorcolor	color of the cursor	`cursor-color`
datacolor	unselected data color	`data-color`
envedwaveformcolor	color of envelope editor waveform	`enved-waveform-color`
filterwaveformcolor	color of control panel filter waveform	`filter-waveform-color`
graphcolor	unselected channels' graph background	`graph-color`
highlightcolor	highlighting here and there	`highlight-color`
listenercolor	background color of the listener	`listener-color`
listenertextcolor	text color in the listener	`listener-text-color`
markcolor	color of the mark indicator	`mark-color`
mixcolor	used for mix waveforms	`mix-color`
selectedmixcolor	selected mix waveforms	`selected-mix-color`
positioncolor	color of position sliders	`position-color`
pushedbuttoncolor	color of pushed button	`pushed-button-color`
sashcolor	color of paned window sash handles	`sash-color`
selecteddatacolor	color of the data in selected channel	`selected-data-color`
selectedgraphcolor	background of selected channel's graph	`selected-graph-color`
selectioncolor	color of an active selection	`selection-color`
textfocuscolor	color of text field with focus	`text-focus-color`
zoomcolor	color of zoom sliders	`zoom-color`

Each of these colors can be set in Guile using the second name given above ("basic-color"). Colors are defined by calling make-color with the three red/green/blue values, each a float between 0.0 and 1.0. (set! (basic-color) (make-color 1.0 0.0 0.0)) sets the overall background color of Snd to red. rgb.scm defines all the standard X11 color names (you probably don't want to load the whole thing; just use the names as needed).

Ttr>