This class describes a 3X3 matrix representation and associated operations.
Note that although 3x3 matrices are useful in calculation involving 3D rotations,
users should use Cog3DTransformRotation for general 3D rotation operations.
Inheritance Hierarchy
System MarshalByRefObject
Cognex.VisionPro.Implementation CogObjectBase
Cognex.VisionPro.Implementation CogSerializableObjectBase
Cognex.VisionPro.Implementation CogSerializableChangedEventBase
Cognex.VisionPro3D Cog3DMatrix3x3
Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D.Core (in Cognex.VisionPro3D.Core.dll) Version: 73.0.0.0
Syntax
The Cog3DMatrix3x3 type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
 | Cog3DMatrix3x3 |
Construct a default (representing an identity transform) Cog3DMatrix3x3.
|
| Cog3DMatrix3x3(Cog3DMatrix3x3) |
Construct this object by making a deep copy of the supplied
object.
|
 | Cog3DMatrix3x3(SerializationInfo, StreamingContext) |
Serialization constructor.
|
| Cog3DMatrix3x3(Double, Double, Double, Double, Double, Double, Double, Double, Double) |
Construct this Cog3DMatrix3x3 using the given element values.
|
Methods
| Name | Description | |
|---|---|---|
| CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.) |
| Dispose |
Dispose this object.
|
| Dispose(Boolean) | |
| Equals | (Inherited from Object.) |
| Finalize |
Finalize this object.
(Overrides Object Finalize .) |
| GetAttributes |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetClassName |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetComponentName |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetConverter |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetDefaultEvent |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetDefaultProperty |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetEditor |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetElement |
Gets one element of the matrix.
|
| GetEvents |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetEvents( Attribute ) |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
| GetObjectData |
Serializer for this object.
(Overrides CogSerializableObjectBase GetObjectData(SerializationInfo, StreamingContext).) |
| GetProperties |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetProperties( Attribute ) |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetPropertyOwner |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
| Inverse |
Compute the inverse matrix of this matrix.
|
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) |
| OnChanged(Int64) |
This method should be called internally whenever the object's state may
have changed.
(Inherited from CogSerializableChangedEventBase.) |
| OnChanged(CogChangedEventArgs) |
This method may be called internally whenever a derived object's state
may have changed and the derived object expresses this change via a
derived CogChangedEventArgs class.
(Inherited from CogSerializableChangedEventBase.) |
 | RealEqual |
Compares the internal state of the specified instances and returns
true if the internal state is within epsilon.
|
| ResumeAndRaiseChangedEvent |
Re-enables raising of the Changed event after SuspendChangedEvent
has been called, and raises the Changed event if the
ChangedEventSuspended count is reduced to zero and any changes were
made while events were suspended. Must be called once for each call to
SuspendChangedEvent.
(Inherited from CogSerializableChangedEventBase.) |
| SetElement |
Sets one element of the matrix.
|
| SuspendChangedEvent |
Temporarily suspends the raising of the Changed event. May be called
more than once, and a corresponding call to ResumeAndRaiseChangedEvent
must be made for each call to SuspendChangedEvent.
(Inherited from CogSerializableChangedEventBase.) |
| ToString |
Override of ToString method to get a string for describing this object.
(Overrides Object ToString .) |
| Transpose |
Compute the transpose matrix of this matrix.
|
Operators
| Name | Description | |
|---|---|---|
 | Addition |
Addition operator for one matrix and another matrix, defined as
matrix + rhs |
| Division(Double, Cog3DMatrix3x3) |
Division operator for a scalar and a matrix. Note that
scale / matrix = scale * matrix.Inverse().
|
| Division(Cog3DMatrix3x3, Cog3DMatrix3x3) |
Division operator for one matrix and another matrix. This operator is defined as
matrix / rhs = matrix * rhs.Inverse()
|
| Division(Cog3DMatrix3x3, Double) |
Division operator for a matrix and a scalar.
Note that matrix / scale = matrix * 1/scale. |
| Division(Cog3DVect3, Cog3DMatrix3x3) |
Division operator for a 3D point and a 3D matrix. The definition of this operator is
point3D / matrix = point3D * matrix.Inverse().
|
| Multiply(Double, Cog3DMatrix3x3) |
Multiplication operator for a scalar and a matrix.
Note that the definition of this operator is: scale * matrix = matrix * scale. |
| Multiply(Cog3DMatrix3x3, Cog3DMatrix3x3) |
Operator for composing one matrix and another matrix. Note that the definition of this operation is
matrix * rhs.
|
| Multiply(Cog3DMatrix3x3, Cog3DVect3) |
Multiplication operator for a 3D matrix and a 3D point. Note that the definition of this operation is
matrix * point3D.
|
| Multiply(Cog3DMatrix3x3, Double) |
Multiplication operator for a matrix and a scalar. Note that the definition of this operation is
matrix * scale.
|
| Multiply(Cog3DVect3, Cog3DMatrix3x3) |
Multiplication operator for a 3D point and a 3D matrix. The definition of this operator is
point3D * matrix = matrix.Transpose() * point3D.
|
| Subtraction |
Subtraction operator for one matrix and another matrix, defined as
matrix - rhs |
| UnaryNegation |
Unary minus Operator, defined as
-matrix |
Fields
| Name | Description | |
|---|---|---|
 | SfDeterminant | |
| SfElement | |
| SfIsIdentity | |
| SfIsSingular | |
 | SfNextSf | |
| SfScaleX | |
| SfScaleY | |
| SfScaleZ |
Properties
| Name | Description | |
|---|---|---|
 | ChangedEventSuspended |
If nonzero, indicates that the raising of the Changed event has been
suspended. This value is incremented when SuspendChangedEvent is called
and decremented when ResumeAndRaiseChangedEvent is called.
(Inherited from CogSerializableChangedEventBase.) |
| Determinant |
Gets the determinant of this matrix.
|
| Element |
This property is deprecated, please use GetElment and SetElement instead.
|
| HasChanged | (Inherited from CogSerializableChangedEventBase.) |
| IsIdentity |
Gets whether this matrix is identity.
|
| IsRotation |
Gets whether this matrix is a pure rotation.
|
| IsSingular |
Gets whether this matrix is singular.
|
| ScaleX |
Gets the x scale value of this matrix.
The x scale is defined to be the length of the vector
resulting from mapping the x unit vector through this matrix.
|
| ScaleY |
Gets the y scale value of this matrix.
The y scale is defined to be the length of the vector
resulting from mapping the y unit vector through this matrix.
|
| ScaleZ |
Gets the z scale value of this matrix.
The z scale is defined to be the length of the vector
resulting from mapping the z unit vector through this matrix.
|
| StateFlags |
Returns the complete set of state flags supported on this object. The
flags may be indexed by name as shown in the following C# code snippet:
if (changedObject.StateFlags["Color"] & eventArgs.StateFlags) { ... }
(Inherited from CogSerializableChangedEventBase.) |
Events
| Name | Description | |
|---|---|---|
 | Changed |
This event is raised when one or more parts of the object's state may
have changed.
(Inherited from CogSerializableChangedEventBase.) |
See Also