ISceneObject

Performs a spatial query to find the nearest distance from the given point ⁱⁿ to this scene object.

This method is used by ISceneQueryProvider.QueryDistance.

Performs a spatial query to find the intersection of the given ray ⁱⁿ and this scene object.

This method is used by ISceneQueryProvider.Query for operations created with SceneQueryOp.ForRay.

Produces a SceneObjectResult for this ISceneObject.

Updates the state of this scene object, in order to reflect all changes that have been made to this object since the last call to this method.

This method can be called repeatedly. If there is no need for updating the state, the method will return silently.

Automatic calls to this method are made just before processing of the following callbacks:

If CallbackMask returns SceneObjectCallback.None or the scene object is not enabled / not visible, no callbacks would be performed, which also would eliminate the automatic calls to this method. The IScene and ISceneView implementations take care of that by always calling the UpdateState method once per frame, when processing the IUpdateableFrameTime callback.

Returns the callback mask that indicates which callbacks shall be performed.

This property may be used to tweak performance by returning only those callback flags for which an implementation provides an actual callback, instead of an empty default one.

Manually enables resp. disables this scene object.

Scene objects are enabled by default. Disabled scene objects are ignored during scene processing, i.e. they do not receive any callbacks (including rendering, so disabled scene objects are also invisible). State processing via UpdateState is always performed.

Does the state of this scene object need to be updated?

Returns the processing group of this scene object in its container.

Scene objects in a container (i.e. IScene.Entities or ISceneView.EntityViews) are grouped by their Order value and the groups are sorted ascending by their value. Within each group, the scene objects appear in the same order as they have been added to the container.

The default value is 0.

A bit-mask that will be used by spatial queries to determine which scene objects to process and which to ignore.

When a spatial query is issued via ISceneQueryProvider, a query mask must be provided as method parameter. During processing of the spatial query, the parameter query mask and the query mask each scene object are combined with the bit-wise AND operator: if the result is zero, the scene object will be ignored for the spatial query.

Defaults to ~0.

Optional user data object to associate with this scene object.