sound_dtc.doc

     sound.datatype() 


sound.datatype/sound.datatype


    NAME
	sound.datatype -- root data type for sounds.

    FUNCTION
	The sound.datatype is the super-class for any sound related
	classes.

    METHODS
	OM_NEW -- Create a new sound object.

	OM_GET -- Obtain the value of an attribute.

	OM_SET -- Set the values of multiple attributes.

	OM_UPDATE -- Update the values of multiple attributes.

	OM_DISPOSE -- Dispose of a sound object.

	GM_LAYOUT -- Layout the object and notify the application of the
	    title and size.

	GM_HITTEST -- Determine if the object has been hit with the
	    mouse.

	GM_GOACTIVE -- Tell the object to go active.  On SELECTDOWN, the
	    sound will start playing.

	GM_HANDLEINPUT -- Handle input.  Currently input (other than
	    SELECTDOWN) doesn't affect the sound.

	GM_RENDER -- Cause the graphic to render.  Currently the graphic
	    for the sound is just a static icon.

	DTM_TRIGGER -- Cause an event to occur.  Currently the only
	    trigger event is STM_PLAY, which will cause the sound to start
	    playing.

	DTM_COPY -- Copy the entire sound to the clipboard as 8SVX.

	DTM_WRITE -- Write the entire sound to a file as 8SVX.

    TAGS
	SDTA_VoiceHeader (struct VoiceHeader *) -- Set and get the base
	    information for the sound.  VoiceHeader is defined in
	    .

	    Applicability is (ISG).

	SDTA_Sample (UWORD *) -- Set and get the sound data.  Starting
	    V40 the sample data does not need to be in CHIP memory.

	    Applicability is (ISG).

	SDTA_SampleLength (ULONG) -- Length of the sound data.

	    Applicability is (ISG).

	SDTA_Period (UWORD) -- Set and get the period of the sound.
	    This attribute can be used to affect a playing sound.

	    Default for this tag is 394.  Applicability is (ISG).

	SDTA_Volume (UWORD) -- Set and get the volume of the sound. This
	    attribute can be used to affect a playing sound.

	    Valid range is from 0 to 64.  Default for this tag is 64.
	    Applicability is (ISG).

	SDTA_Cycles (UWORD) -- Set and get the number of cycles the
	    sound will be played.

	    Default for this tag is 1.  Applicability is (ISG).

	The following tags are new for V40.

	SDTA_SignalTask (struct Task *) -- Task to signal when the
	    is complete, or if SDTA_Continuous is TRUE, when
	    the next buffer is needed.

	SDTA_SignalBit (BYTE) -- Signal bit to use with SDTA_SignalTask
	    or -1 to disable.

	SDTA_Continuous (BOOL) -- Used to indicate that the sound
	    datatype will be fed a continuous stream of data.  Defaults
	    to FALSE.

    BUGS
	Still doesn't support stereo or channel selection.


Converted on 22 Apr 2000 with RexxDoesAmigaGuide2HTML 2.1 by Michael Ranner.