Media!Lab Codec Classes

Class Summary - Codec Classes

Typically Media!Lab applications operate soley using the higher level Media Classes, such as mImage, mSprite and mDirector. Derived from the high level Media Classes, Codec Classes supply the actual implementations for processing specific image, video and audio file types. Once a particular file has been opened, your application can operate simply using the virtual methods supplied in the higher level media class. This power and flexiblity allows you to use virually any popular media file type without needing to know the gritty details of each specific format. If you do need specialized information or control of a particular media type, the Codec Classes provide direct access to the actual implementations:


 mAudioAIFF . . . Mac AIFF audio class 
 mAudioAU . . . . Sun/Unix AU audio class 
 mAudioMIDI . . . MIDI audio class 
 mAudioWAV. . . . WAV audio class
 mImageAVI. . . . AVI video image class
 mImageBitmap . . memory bitmap image class
 mImageBMP. . . . BMP image class
 mImageFlic . . . FLC/FLI video image class
 mImageGIF. . . . GIF image class 
 mImageJPEG . . . JPEG image class 
 mImagePCX. . . . PCX/DCX image class

 New Media!Lab Version 3 feature.

(top)

mAudioAIFF Class

The mAudioAIFF class supplies the codec-specific functions supporting Apple Macintosh digital AIFF audio files. mAudioAIFF inherits the virtual functions of the base mAudio and mFile classes, and includes the following methods:


mAudioAIFF(). . . . constructor
~mAudioAIFF() . . . destructor
ReadAudioHeader() . read track header information
SetTrack(). . . . . seek to selected track
SeekAudio() . . . . seek to selected track position
ReadAudio() . . . . read audio data to buffer
PlayAudio() . . . . play audio
PauseAudio(). . . . pause playing
StopAudio() . . . . stop playing
SetVolume() . . . . set play volume
Close() . . . . . . close the audio file
SetBufferSize() . . set audio buffer sizes
LoadNextBuffer(). . load the next audio buffer

(top)

mAudioAU Class

The mAudioAU class supplies the codec-specific functions supporting Sun Microsystem Unix digital AU audio files. mAudioAU inherits the virtual functions of the base mAudio and mFile classes, and includes the following methods:


mAudioAU(). . . . . constructor
~mAudioAU() . . . . destructor
ReadAudioHeader() . read track header information
SetTrack(). . . . . seek to selected track
SeekAudio() . . . . seek to selected track position
ReadAudio() . . . . read audio data to buffer
PlayAudio() . . . . play audio
PauseAudio(). . . . pause playing
StopAudio() . . . . stop playing
SetVolume() . . . . set play volume
Close() . . . . . . close the audio file
SetBufferSize() . . set audio buffer sizes
LoadNextBuffer(). . load the next audio buffer

(top)

mAudioMIDI Class

The mAudioMIDI class supplies the codec-specific functions supporting digital Midi audio files. mAudioMIDI inherits the virtual methods of the base mAudio and mFile classes, and includes the following functions:


mAudioMIDI(). . . . constructor
~mAudioMIDI() . . . destructor
ReadAudioHeader() . read track header information
SetTrack(). . . . . seek to selected track
SeekAudio() . . . . seek to selected track position
ReadAudio() . . . . read audio data to buffer
PlayAudio() . . . . play audio
PauseAudio(). . . . pause playing
StopAudio() . . . . stop playing
SetVolume() . . . . set play volume
Close() . . . . . . close the audio file
SetBufferSize() . . set audio buffer sizes
LoadNextBuffer(). . load the next audio buffer

(top)

mAudioWAV Class

The mAudioWAV class supplies the codec-specific functions supporting digital WAV audio files. mAudioWAV inherits the virtual methods of the base mAudio and mFile classes, and includes the following functions:


mAudioWAV() . . . . constructor
~mAudioWAV(). . . . destructor
ReadAudioHeader() . read track header information
SetTrack(). . . . . seek to selected track
SeekAudio() . . . . seek to selected track position
ReadAudio() . . . . read audio data to buffer
PlayAudio() . . . . play audio
PauseAudio(). . . . pause playing
StopAudio() . . . . stop playing
SetVolume() . . . . set play volume
Close() . . . . . . close the audio file
SetBufferSize() . . set audio buffer sizes
LoadNextBuffer(). . load the next audio buffer

(top)

mImageAVI Class

The mImageAVI class supplies the codec-specific functions for working with AVI video files. mImageAVI inherits the members and functions of the base mImage class. In addition to the virtual methods provided by the mImage class, the mImageAVI class includes the following function methods:


mImageAVI() . . . . . . constructor
~mImageAVI(). . . . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table changer
SetTransparent(). . . . enable/disable color transparency
SetTranslate(). . . . . enable/disable color translation
SetTransparentColor() . set transparent color
SetTrack(). . . . . . . select audio track
PlayImageAudio(). . . . begin audio output
PauseImageAudio() . . . pause audio output
StopImageAudio(). . . . end audio output

(top)

mImageBitmap Class

The mImageBitmap class supplies the implementation-specific functions for working with direct memory bitmap objects. mImageBitmap inherits the members and functions of the base mImage class, and provides the following capabilities:

Supplies a generic mImage interface for one or more bitmaps in memory.
Allows frames to be defined, then inserted or removed in any sequence.
Allows each frame to be defined with an independent origin and frame rate.
Allows frames to reside either on separate bitmaps, or on smaller rectangles on a larger shared bitmaps.
Constructs and inserts frames directly from bitmap files, or using ASCII Media!Lab script files.
Supports sprite animation interfacing to mSpriteImage.

The mImageBitmap class allows creation of special mImage objects with individual frames composed from one or multiple memory bitmaps. Frames can reside on individual bitmaps, or a single bitmap can contain multiple frames. In addition to the virtual methods inherited from the mImage class, the mImageBitmap class includes the following functions:


mImageBitmap(). . . . . constructor
mImageBitmap(). . . . . construct from script or image file
mImageBitmap(). . . . . copy constructor
mImageBitmap& =() . . . assignment operator
~mImageBitmap() . . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table change
SetTransparent(). . . . enable/disable color transparency
SetTransparentColor() . set transparent color
SetTranslate(). . . . . enable/disable color translation
InsertFrame() . . . . . insert a new frame after current position
RemoveFrame() . . . . . remove frame at current position
LoadFromScript(). . . . load and insert frames from script file

(top)

mImageBMP Class

The mImageBMP class supplies codec-specific functions for working with BMP image files. mImageBMP inherits the virtual methods of the base mImage class, and includes the following functions:


mImageBMP() . . . . . . constructor
~mImageBMP(). . . . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table change
SetTransparent(). . . . enable/disable color transparency
SetTransparentColor() . set transparent color
SetTranslate(). . . . . enable/disable color translation

(top)

mImageFlic Class

The mImageFlic class supplies the codec-specific functions for working with FLC and FLI video files. mImageFlic inherits the virtual methods of the base mImage class, and includes the following functions:


mImageFlic(). . . . . . constructor
~mImageFlic() . . . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table change
SetTransparent(). . . . enable/disable color transparency
SetTransparentColor() . set transparent color
SetTranslate(). . . . . enable/disable color translation

(top)

mImageGIF Class

The mImageFlic class supplies the codec-specific functions for working with GIF image and animation files. mImageGIF fully supports animated, transparent and interleaved GIF capabilities. mImageGIF inherits the virtual methods of the base mImage class, and includes the following functions:


mImageGIF() . . . . . . constructor
~mImageGIF(). . . . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table change
SetTransparent(). . . . enable/disable color transparency
SetTransparentColor() . set transparent color
SetTranslate(). . . . . enable/disable color translation

(top)

mImageJPEG Class

The mImageJPEG class supplies the codec-specific functions for working with JPEG image files. mImageJPEG inherits the virtual methods of the base mImage class, and includes the following functions:


mImageJPEG(). . . . . . constructor
~mImageJPEG() . . . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table change
SetTransparent(). . . . enable/disable color transparency
SetTransparentColor() . set transparent color
SetTranslate(). . . . . enable/disable color translation

(top)

mImagePCX Class

The mImagePCX class supplies the codec-specific functions for working with PCX and DCX image files. mImagePCX inherits the virtual methods of the base mImage class, and includes the following functions:


mImagePCX() . . . . . . constructor
~mImagePCX(). . . . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table change
SetTransparent(). . . . enable/disable color transparency
SetTransparentColor() . set transparent color
SetTranslate(). . . . . enable/disable color translation

(top)

mImageSmacker Class

The mImageSmacker class supplies the codec-specific functions for working with Smacker video files. mImageSmacker inherits the members and functions of the base mImage class. In addition to the virtual methods provided by the mImage class, the mImageSmacker class includes the following function methods:


mImageSmacker() . . . . constructor
~mImageSmacker(). . . . destructor
ReadHeader(). . . . . . read file header
ReadFrame() . . . . . . read next image frame to the bitmap
SeekFrame() . . . . . . seek to selected frame
ColorChange() . . . . . handle bitmap color table changer
SetTransparent(). . . . enable/disable color transparency
SetTranslate(). . . . . enable/disable color translation
SetTransparentColor() . set transparent color