User`s guide

42 Dialogic
®
Host Media Processing Software Release 4.1LIN Release Guide
Programming Libraries
5.10 Dialogic
®
Multimedia API Library
The Dialogic
®
Multimedia API library is used to play and record digitized multimedia in
support of applications providing video services, such as video mail, video color ring,
video caller ID, and video location-based services.
For more information, see the Dialogic
®
Multimedia API Programming Guide and Library
Reference.
New Features
The Dialogic
®
Multimedia API library provides the following new capabilities in this
release:
New video codecs
H.264 and MPEG-4 are supported.
Video transcoding, video transrating, and image resizing
To support these video features, the MM_VIDEO_CODEC structure is updated with
new fields and associated enumerated values. A new header file, videodefs.h, is
introduced for video-related features.
For more information on video transcoding, see Section 3.1, “New Multimedia
(Audio/Video) Transcoding”, on page 15.
Audio transcoding
To support audio transcoding, a new MM_AUDIO_CODEC_OPTIONS_INFO
structure is added to the library; and the MM_AUDIO_CODEC structure is updated
with an audio coder option field and associated enumerated values.
WAVE file support
The mm_Play( ) and mm_Record( ) functions support the WAVE file format. The
MM_MEDIA_AUDIO, MM_MEDIA_VIDEO, MM_PLAY_RECORD_INFO structures
are updated.
3GP (3GPP) file support
The mm_Play( ) function supports the standard 3GP file. The MM_MEDIA_AUDIO
and MM_MEDIA_VIDEO structures are updated. For details on 3GP file support, see
Section 3.12, “Multimedia (Audio/Video) Play and Record”, on page 26.
Play a still image over a video stream
The mm_Play( ) function supports playing a still image. The MM_MEDIA_IMAGE
structure is added and several structures are updated to support this feature.
Record or capture a still image from a video stream
The new mm_Capture( ) function provides the ability to capture a still image. Several
structures are added to support this feature.
Digital Video Recorder (DVR) controls
The new mm_Seek( ), mm_Pause( ), mm_Resume( ), mm_GetDuration( ), and
mm_GetElapsedTime( ) functions are added to support DVR controls. Several
structures are added and others updated to support this feature.