This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

Functions

The multimedia function set includes:

• MvGetDevFromMime()
• MvGetDevFromUrl()
• MvGetMimeFromPlugin()
• MvGetMimeFromUrl()
• MvGetMpDefaultSetting()
• MvGetMpSetting()
• MvGetPluginFromMime()
• MvGetPluginFromUrl()
• MvHttpOpen()
• MvPluginName()
• MvRegClose()
• MvRegGetEntry()
• MvRegOpen()
• MvSetMpSetting()
• MvViewerAudioCallbackF_t()
• MvViewerCallbackF_t()
• MvViewerVideoCallbackF_t()

MvGetDevFromMime()

const char * MvGetDevFromMime( char * buffer,
                               const char * mime, 
                               int flag );

The MvGetDevFromMime() function returns the correct /dev entry to handle a URL of a specific MIME type. (Future use.)

MvGetDevFromUrl()

const char * MvGetDevFromUrl( char * buffer, 
                              const char * url,
                              int flag );

The MvGetDevFromUrl() function returns the correct /dev entry to handle the specific URL provided. (Future use.)

MvGetMimeFromPlugin()

const char * MvGetMimeFromPlugin( char * buffer, 
                                  const char * plugin, 
                                  int flag );

Returns the most common MIME type handled by the plugin.

MvGetMimeFromUrl()

const char * MvGetMimeFromUrl( char * buffer, 
                               const char * url, 
                               int flag, 
                               char * err );

The MvGetMimeFromUrl() function returns the best guess of the MIME Type for a given URL (file:// or http://).

MvGetMpDefaultSetting()

void MvGetMpDefaultSetting( MvSetup_t * setup );

The MvGetMpDefaultSetting() function gets the system-calculated standard settings.

Returns: The new setup values.

MvGetMpSetting()

int MvGetMpSetting( MvSetup_t * setup );

The MvGetMpSetting() function gets the values stored in the mpsettings file.

setup

Pointer to a MvSetup_t structure allocated by the calling application.

Returns:

1

Success. Values have been updated for setup.

0

Failure. Couldn't open mpsettings for shared reading.

MvGetPluginFromMime()

const char * MvGetPluginFromMime( char * buffer,
                                  const char * mime,
                                  int flag );

The MvGetPluginFromMime() function returns the plugin to load to handle a specific MIME type.

MvGetPluginFromUrl()

const char * MvGetPluginFromUrl( char * buffer, 
                                 const char * url, 
                                 int flag,
                                 char * err );

The MvGetPluginFromUrl() function returns the correct plugin to load to handle the specific URL.

MvHttpOpen()

int MvHttpOpen( const char * url,
                char * mime,
                char * err );

The MvHttpOpen() function returns a socket to the specified URL.

MvPluginName()

char * MvPluginName( char * buf, 
                     const char * url );

The MvPluginName() function returns the associated plugin name based on an input filename. The pointer to the buffer with the name of the plugin to load is returned on success, or NULL on failure.

buf

The pointer to which to copy the name of plugin to load. It's assumed that the player allocates this memory.

url

The string of the form file://filename.ext (i.e. myfile.wav, or dog.mpeg).

MvRegClose()

void MvRegClose( MvReg_t * );

The MvRegClose() function closes the registry file.

MvRegGetEntry()

MvRegEntry_t const * MvRegGetEntry( MvReg_t * );

The MvRegGetEntry() function finds which plugin goes with a specific file type.

MvRegOpen()

MvReg_t * MvRegOpen( void );

The MvRegOpen() function opens the registry file.

MvSetMpSetting()

int MvSetMpSetting( MvSetup_t * setup );

The MvSetMpSetting() function writes to a new mpsettings file.

setup

The new setup values to be written to the mpsettings file.

Returns:

1

Success.

0

Failure. Couldn't open mpsettings for exclusive writing.

MvViewerAudioCallbackF_t()

typedef void MvViewerAudioCallbackF_t( MvPluginCtrl_t *ctrl, 
                                       void * audio_data,
                                       unsigned long len );

The MvViewerAudioCallbackF_t() function is called by a plugin that wants phplay to handle the audio PCM data. (Not implemented yet.)

MvViewerCallbackF_t()

typedef void MvViewerCallbackF_t( MvPluginCtrl_t * ctrl, 
                                  MvEventFlags_t change, 
                                  MvPluginStatus_t const * status );

The MvViewerCallbackF_t() function is called by a plugin to report status information about state changes to phplay.

MvViewerVideoCallbackF_t()

typedef void MvViewerVideoCallbackF_t( MvPluginCtrl_t * ctrl, 
                                       MvVideoFrameData_t * video_data );

The MvViewerVideoCallbackF_t() function is called by a plugin that wants phplay to handle the video processed data.