Context state

Every time you create a context by calling mmr_context_create(), mm-renderer also creates a context directory with the same name. For instance, creating a context named movie1 creates a directory named /pps/services/multimedia/renderer/context/movie1.

Inside each context directory, mm-renderer creates several objects (files) that hold the state of the context. When an input is attached to the context, additional objects may be created in the context directory, depending on the input type.

The state of a context is represented by the following objects, where the # character indicates a numeric value encoded as decimal:

param

Contains the parameters set with mmr_context_parameters().

output#

Created when an output is attached, deleted when it's detached. The # token is the output ID returned by mmr_output_attach(). This object contains the URL, output type, and the latest parameters set with mmr_output_parameters().

input

Populated when an input is attached, emptied when it's detached. This object contains the URL, input type, and the latest parameters set with mmr_input_parameters().

status

A snapshot of the current status. This is potentially high bandwidth, so delta mode shouldn't be used to read this object. This object holds information on the playback position, the buffer capacity, and the buffer activity.

state

The play state. This object is intended to be read in delta mode, otherwise errors or warnings may be lost. Depending on the play state, the state object may have these attributes:

state

playing, stopped, or idle.

speed

The current speed, in units of 1/1000th of normal speed.

warning

The most recent warning (which is deleted when playback is stopped).

warning_pos

The play position when the warning happened.

error

The most recent error code (which is deleted when playback is restarted).

error_pos

The play position when the error happened.