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`