ObjectContainer3D is the most basic scene graph node. It can contain other ObjectContainer3Ds. ObjectContainer3D can have its own scene partition assigned. However, when assigned to a different scene, it will loose any partition information, since partitions are tied to a scene.


Inherited from Object3D -> NamedAssetBase -> EventDispatcher.


Can be created using method new:

Lib.Away3D.Containers.ObjectContainer3D.new()

Creates a new ObjectContainer3D object.



Created ObjectContainer3D object has properties:

assetType

[read-only] String

ignoreTransform

Does not apply any transformations to this object. Boolean

inverseSceneTransform

[read-only] The inverse scene transform object that transforms from world to model space. (Matrix3D)

maxX

[read-only] The maximum extremum of the object along the X-axis.

maxY

[read-only] The maximum extremum of the object along the Y-axis.

maxZ

[read-only] The maximum extremum of the object along the Z-axis.

minX

[read-only] The minimum extremum of the object along the X-axis.

minY

[read-only] The minimum extremum of the object along the Y-axis.

minZ

[read-only] The minimum extremum of the object along the Z-axis.

mouseChildren

Boolean

mouseEnabled

Indicates whether the IRenderable should trigger mouse events, and hence should be rendered for hit testing. Boolean

numChildren

[read-only] The amount of child objects of the ObjectContainer3D. Int

parent

[read-only] The parent ObjectContainer3D to which this object's transformation is relative. (ObjectContainer3D)

partition

The space partition to be used by the object container and all its recursive children, unless it has its own space partition assigned. (Partition3D)

scene

A reference to the Scene3D object to which this object belongs. (Scene3D)

scenePosition

[read-only] The global position of the ObjectContainer3D in the scene. (Vector3D)

sceneTransform

[read-only] The transformation matrix that transforms from model to world space. (Matrix3D)

visible

Boolean


methods:

addChild(child)

Adds a child ObjectContainer3D to the current object.

child - The object to be added as a child. (ObjectContainer3D)

addChildren(childarray)

Adds an array of 3d objects to the scene as children of the container

childarray - vector array of (ObjectContainer3D)

addEventListener(type, listener, useCapture, priority, useWeakReference)

[override]

type - String

listener - Function

useCapture - Boolean (default = false)

priority - int (default = 0)

useWeakReference - Boolean (default = false)

clone()

[override] Clones this ObjectContainer3D instance along with all it's children, and returns the result (which will be a copy of this container, containing copies of all it's children.)


contains(child)

Return Boolean

child - (ObjectContainer3D)

dispatchEvent(event)

[override]

event - (Event)

dispose()

[override] Cleans up resources used by this asset.


disposeWithChildren()

Disposes the current ObjectContainer3D including all of its children.


getChildAt(index)

Retrieves the child object at the given index.

index - The index of the object to be retrieved. Int

lookAt(target, upAxis)

[override] Rotates the 3d object around to face a point defined relative to the local coordinates of the parent ObjectContainer3D.

target - The vector defining the point to be looked at (Vector3D)

upAxis - (default = nil) - An optional vector used to define the desired up orientation of the 3d object after rotation has occurred (Vector3D)

removeChild(child)

Removes a 3d object from the child array of the container

child - The 3d object to be removed (ObjectContainer3D)

removeChildAt(index)

Removes a 3d object from the child array of the container

index - Index of 3d object to be removed

removeEventListener(type, listener, useCapture)

[override]

type - String

listener - Function

useCapture - Boolean (default = false)

rotate(axis, angle)

[override]

axis - (Vector3D)

angle - Float

translateLocal(axis, distance)

[override]

axis - (Vector3D)

distance - Float

updateImplicitVisibility()




Events: MouseEvent3D, Object3DEvent: SCENE_CHANGED, SCENETRANSFORM_CHANGED

Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle