mmr_output_parameters()

Set output parameters

Synopsis:

#include <renderer.h>

int mmr_output_parameters( mmr_context_t *ctxt,
                           unsigned output_id,
                           strm_dict_t *parms );

Arguments:

ctxt
A context handle.
output_id
An output ID.
parms
A handle to a dictionary object containing the parameters to set. Note that the dictionary object handle is closed and becomes invalid after this call, even on failure. For more information, see Dictionary Object API .

Library:

mmrndclient

Description:

The function mmr_output_parameters() sets parameters for the specified output device. The parameters that apply for the BlackBerry Tablet OS are as follows.

For video outputs (the following are all numeric parameters):

  • video_dest_x
  • video_dest_y
  • video_dest_w
  • video_dest_h
  • video_src_x
  • video_src_y
  • video_src_w
  • video_src_h
  • video_clip_x
  • video_clip_y
  • video_clip_w
  • video_clip_h

For audio outputs:

  • volume, which must be in the range of 0 to 100

In addition, the mmr_output_attach() function sets the parameters url and type, which some plugins will allow you to modify using mmr_output_parameters().

Returns:

0
Success.
-1
An error occurred. Use the function mmr_error_info() to retrieve information about the error.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes