SoLocalBBoxMatrixElement Class

Stores the transformation matrix from object space to some local coordinate space during application of an OIV.Inventor.Actions.SoGetBoundingBoxAction.

Inheritance Hierarchy

SystemObject
  OIV.InventorSoNetBase
    OIV.Inventor.ElementsSoElement
      OIV.Inventor.ElementsSoLocalBBoxMatrixElement

Namespace: OIV.Inventor.Elements
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2024.1.0.0 (2024.1.0)

Syntax

C++

Copy

public class SoLocalBBoxMatrixElement : SoElement

Public Class SoLocalBBoxMatrixElement
	Inherits SoElement

public ref class SoLocalBBoxMatrixElement : public SoElement

type SoLocalBBoxMatrixElement =  
    class
        inherit SoElement
    end

The SoLocalBBoxMatrixElement type exposes the following members.

Methods

	Name	Description
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Get	Returns current matrix from the state.
	GetClassStackIndex	Obsolete. Returns the stack id for this element.
	GetHashCode	Overrides GetHashCode(). (Inherited from SoNetBase.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MakeIdentity	Sets the local matrix to the identity matrix.
	Mult	Multiplies the given matrix into the local matrix.
	Pop	Pops element. (Inherited from SoElement.)
	PopMatrix	This method is used by the TransformSeparator node.
	Push	Overrides OIV.Inventor.Elements.SoLocalBBoxMatrixElement.Push(OIV.Inventor.Misc.SoState) method to copy values from next instance in the stack. (Overrides SoElementPush(SoState).)
	PushMatrix	This method is used by the TransformSeparator node.
	ResetAll	Resets all current instances in the state to identity.
	RotateBy	Multiplies a matrix that performs the specified transformation into the local matrix.
	ScaleBy	Multiplies a matrix that performs the specified transformation into the local matrix.
	Set	Sets the local matrix to the given matrix.
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	TranslateBy	Multiplies a matrix that performs the specified transformation into the local matrix.

Top

Remarks

This element stores the transformation matrix from object space to some local coordinate space during application of an OIV.Inventor.Actions.SoGetBoundingBoxAction. This element is needed to allow separators (and other caching nodes) to store cached bounding boxes in their own local space. Shapes that extend the current bounding box computed by the action use this matrix to transform the bounding box into local space. Separators cache this box, then transform it into the next local space up the hierarchy.

Because this element is set to identity by separators before traversing their children, it can never have an affect on any caching separator that it is not under. Therefore, it should never be tested for cache invalidation, so its matches() method prints an error message and returns false. It also means that it does not have to save node id's so there are no nodes passed in to any of the methods.

Reference

OIV.Inventor.Elements Namespace