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
![]() ![]() ![]() |