smp(4)									smp(4)

NAME    [Toc]    [Back]

     smp, SampleVision - Sample	Vision Audio File Format

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audiofile.h>

DESCRIPTION    [Toc]    [Back]

     The Audio File Library currently supports 13 of the commonly found	audio
     file formats, i.e., is able to recognize, read, and write sample data and
     header information	to and from files in these formats.  It	is important
     not to confuse sample or audio data formats with file formats.  The
     former refers to the bit-wise organization	of the sound samples in	the
     file, i.e., whether the format is 8-bit integer or	16-bit unsigned, etc.
     Audio file	format refers to the structure of the audio file header, the
     chunk of on-disk data which preceeds the samples and which	provides
     information about the file	to the audio program.  A single	audio file
     format may	support	a large	variety	of sample formats.

     The Sample	Vision File Format (smp) was developed for use with the	Sample
     Vision software program, which was	designed to send and receive samples
     via the MIDI interface on a PC.  It consists of a variable-length header
     followed by a contiguous block of binary data representing	the sound
     samples.

DATA FORMAT SPECIFICATIONS    [Toc]    [Back]

     Sample Formats:
	  Two's	complement integer only.

     Sample Widths:
	  16 bit only.

     Byte Orders:
	  Always littleendian.

     Channel Counts:
	  1 channel only.

     Compression Formats:
	  None.

FILE FORMAT SPECIFICATIONS    [Toc]    [Back]

     SMP file headers contain additional information.

     Instrument	Configurations:
	  Maximum of 1 allowed.	 Up to eight loops are allowed.	 Instparams
	  associated with this inst:  AF_INST_MIDI_BASENOTE only.   See
	  afSetInstParamLong(3dm) for more information about these parameters.

     Markers:
	  Unlike AIFF(3dm) and WAVE(3dm) files,	there is no direct association
	  between markers and loops.  However, for backwards compatibility, an
	  application may choose to specify loop start and end points via the



									Page 1






smp(4)									smp(4)



	  traditional AIFF-style method	using mark id's	(afSetLoopStart(3dm),
	  etc.)	or via the newer afSetLoopStartFrame(3dm) and related
	  routines.  In	the former case, both the loops	and the	markers	will
	  be written out to the	header;	in the latter case, only the loops
	  will be written out (unless other markers have been created).

     Miscellaneous Chunks:

	       AF_MISC_NAME	   name	string

	       AF_MISC_COMMENT	   comment string

SEE ALSO    [Toc]    [Back]

     afInitFileFormat(3dm), afGetFileFormat(3dm), afIntro(3dm),
     afSetLoopStart(3dm), afSetLoopEnd(3dm)


									PPPPaaaaggggeeee 2222