User Guide

495

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 the Director 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