Technical Reference > Graphics Builder Automation Interface > Object Drawing and Property Functions > Attribute3dEffectDepth

Attribute3dEffectDepth

Applies a level of depth to a 3D effect, or retrieves the current depth setting.

This function applies to the selected object, which is typically the last placed object. By using the PageSelectFirstObject() and PageSelectNextObject() functions, you can access your objects and change or read their properties.

Syntax

Attribute3dEffectDepth(EffectDepth)

EffectDepth:

A value between 0 and 32 representing the depth of the 3D effect used.

Return Value

If retrieving the current depth setting for a 3D effect, a value between 0 and 32. If applying depth to a 3D effect, 0 (zero) if successful. In both cases, an error is returned if unsuccessful. If values are out of range on writing to the attribute, the function will exit and report the error E_INVALIDARG. If there is no active object, they will exit with a return value of E_HANDLE.

Note: For details on handling return and error values, see Error Handling.

Related Functions

Attribute3dEffects, AttributeShadowColour, AttributeHiLightColour, AttributeLoLightColour

Example

' Applies depth to a 3D effect for the current object
GraphicsBuilder.Attribute3dEffectDepth = 28

' Retrieves the 3D depth for the current object
MyVariable = GraphicsBuilder.Attribute3dEffectDepth

Note: This function is implemented in the C++ environment as two separate functions: put_Attribute3dEffectDepth applies depth to 3D effect, and get_Attribute3dEffectDepth retrieves the current 3D depth setting.