preferred3dRenderer

Usage

-- Lingo syntax
_movie.preferred3dRenderer

// JavaScript syntax
_movie.preferred3dRenderer;

Description

Movie property; allows you to get or set the default renderer used to draw 3D sprites within a particular movie if that renderer is available on the client machine. Read/write.

If the specified renderer is not available on the client machine, the movie selects the most suitable available renderer.

The possible values for this property are as follows:

The value set for this property is used as the default for the Renderer Services object's renderer property.

This property differs from the getRendererServices() object's renderer property in that the preferred3dRenderer specifies the preferred renderer to use, whereas the getRendererServices() object's renderer property indicates what renderer is actually being used by the movie.

Shockwave Player users have the option of specifying the renderer of their choice using the 3D Renderer context menu in Shockwave Player. If the user selects the "Obey content settings" option, the renderer specified by the renderer or preferred3DRenderer property is used to draw the movie (if available on the user's system), otherwise, the renderer selected by the user is used.

Example

This statement allows the movie to pick the best 3D renderer available on the user's system:

-- Lingo syntax
_movie.preferred3dRenderer = #auto

// JavaScript syntax
_movie.preferred3dRenderer = "auto";

See also

getRendererServices(), Movie, renderer