3D Lingo Dictionary > O-S > preferred3DRenderer

 

preferred3DRenderer

Syntax

the preferred3DRenderer

Description

3D 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. 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:

#openGL specifies the openGL drivers for a hardware acceleration that work with both Macintosh and Windows platforms.

#directX7_0 specifies the DirectX 7 drivers for hardware acceleration that work only with Windows platforms.

#directX5_2 specifies the DirectX 5.2 drivers for hardware acceleration that work only with Windows platforms.

#software specifies Director's built-in software renderer that works with both Macintosh and Windows platforms.

#auto specifies that the most suitable renderer should be chosen. This is the default value for this property.

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 users have the option of specifying the renderer of their choice using the 3D Renderer context menu in Shockwave. 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.

the preferred3dRenderer = #auto

See also

renderer, getRendererServices(), rendererDeviceList