Initialize the mode on how the video is displayed. This method must be called before video can be displayed.
Two modes are defined:
On platforms with LCDUI support, both modes must be supported.
@param mode The video mode that determines how video isdisplayed. It can be
USE_GUI_PRIMITIVE
,
USE_DIRECT_VIDEO
or an implementation- specific mode.
@param arg The exact semantics of this argument isspecified in the respective mode definitions.
@return The exact semantics and type of the object returnedare specified in the respective mode definitions.
@exception IllegalStateException Thrown if
initDisplayMode
is called again after it has previously been called successfully.
@exception IllegalArgumentException Thrown ifthe
mode
or
arg
argument is invalid.
mode
must be
USE_GUI_PRIMITIVE
,
USE_DIRECT_VIDEO
, or a custom mode supported by this implementation.
arg
must conform to the conditions defined by the respective mode definitions. Refer to the mode definitions for the required type of
arg
.