Packages

 

com.aspose.cad

Class Matrix



  • public class Matrix
    extends Object

    Replaces the GDI+ Matrix.


    Most algorithms taken from Sun's AffineTransform.java. Java's names for matrix elements used internally. Map of java names to .net ones to description: m00 M11 Scale X m10 M12 Shear Y m01 M21 Shear X m11 M22 Scale Y m02 M31 Translate X m12 M32 Translate Y

    • Field Summary

      Fields 
      Modifier and Type Field and Description
      static int TYPE_FLIP
      This flag bit indicates that the transform defined by this object performs a mirror image flip about some axis which changes the normally right handed coordinate system into a left handed system in addition to the conversions indicated by other flag bits.
      static int TYPE_GENERAL_ROTATION
      This flag bit indicates that the transform defined by this object performs a rotation by an arbitrary angle in addition to the conversions indicated by other flag bits.
      static int TYPE_GENERAL_SCALE
      A general scale multiplies the length of vectors by different amounts in the x and y directions without changing the angle between perpendicular vectors.
      static int TYPE_GENERAL_TRANSFORM
      This constant indicates that the transform defined by this object performs an arbitrary conversion of the input coordinates.
      static int TYPE_IDENTITY
      An identity transform is one in which the output coordinates are always the same as the input coordinates.
      static int TYPE_MASK_ROTATION
      This constant is a bit mask for any of the rotation flag bits.
      static int TYPE_MASK_SCALE
      This constant is a bit mask for any of the scale flag bits.
      static int TYPE_QUADRANT_ROTATION
      This flag bit indicates that the transform defined by this object performs a quadrant rotation by some multiple of 90 degrees in addition to the conversions indicated by other flag bits.
      static int TYPE_TRANSLATION
      A translation moves the coordinates by a constant amount in x and y without changing the length or angle of vectors.
      static int TYPE_UNIFORM_SCALE
      A uniform scale multiplies the length of vectors by the same amount in both the x and y directions without changing the angle between vectors.
    • Constructor Summary

      Constructors 
      Constructor and Description
      Matrix()
      Initializes a new instance of the Matrix class as the identity matrix.
      Matrix(float m11, float m12, float m21, float m22, float m31, float m32)
      Initializes a new instance of the Matrix class.
      Matrix(RectangleF rect, PointF[] plgpts)
      Initializes a new instance of the Aspose.CAD.Matrix class to the geometric transform defined by the specified rectangle and array of points.
      Matrix(Rectangle rect, Point[] plgpts)
      Initializes a new instance of the Aspose.CAD.Matrix class to the geometric transform defined by the specified rectangle and array of points.
    • Method Summary

      Methods 
      Modifier and Type Method and Description
      static boolean equals(Matrix a, Matrix b)
      Determines whether two matrixes are equal.
      boolean equals(Object obj)
      Determines whether the specified System.Object is equal to this instance.
      float[] getElements()
      Gets the copy of matrix elements.
      float getM11()
      Gets the matrix element at first row first column.
      float getM12()
      Gets the matrix element at first row second column.
      float getM21()
      Gets the matrix element at second row first column.
      float getM22()
      Gets the matrix element at second row second column.
      float getM31()
      Gets the matrix element at third row first column.
      float getM32()
      Gets the matrix element at third row first column.
      int hashCode()
      Returns a hash code for this instance.
      void multiply(Matrix Tx)
      Multiplies this Matrix by the matrix specified in the matrix parameter using (default) Prepend order.
      void multiply(Matrix Tx, int order)
      Multiplies this Matrix by the matrix specified in the matrix parameter, and in the order specified in the order parameter.
      static boolean op_Equality(Matrix matrix1, Matrix matrix2)
      Implements the operator ==.
      static boolean op_Inequality(Matrix matrix1, Matrix matrix2)
      Implements the operator !=.
      void reset()
      Resets this Matrix to have the elements of the identity matrix.
      void rotate(float angle)
      Applies a clockwise rotation of an amount specified in the angle parameter, around the origin (zero x and y coordinates) for this Matrix in the default (Prepend) order.
      void rotate(float angle, int order)
      Applies a clockwise rotation of an amount specified in the angle parameter, around the origin (zero x and y coordinates) for this Matrix in the specified order.
      void rotateAt(float angle, PointF point)
      Applies a clockwise rotation about the specified point to this Matrix in the default (Prepend) order.
      void rotateAt(float angle, PointF point, int order)
      Applies a clockwise rotation about the specified point to this Matrix in the specified order.
      void scale(float sx, float sy)
      Applies the specified scale vector (scaleX and scaleY) to this Matrix using (default) Prepend order.
      void scale(float scaleX, float scaleY, int order)
      Applies the specified scale vector (scaleX and scaleY) to this Matrix using the specified order.
      String toString()
      Returns a System.String that represents this instance.
      void transformPoints(PointF[] points)
      Applies the geometric transform represented by this Matrix to a specified array of points.
      void translate(float tx, float ty)
      Applies the specified translation vector to this Matrix using (default) Prepend order.
      void translate(float offsetX, float offsetY, int order)
      Applies the specified translation vector to this Matrix in the specified order.
    • Field Detail

      • TYPE_IDENTITY

        public static final int TYPE_IDENTITY

        An identity transform is one in which the output coordinates are always the same as the input coordinates. If this transform is anything other than the identity transform, the type will either be the constant GENERAL_TRANSFORM or a combination of the appropriate flag bits for the various coordinate conversions that this transform performs.

        See Also:
        Constant Field Values
      • TYPE_TRANSLATION

        public static final int TYPE_TRANSLATION

        A translation moves the coordinates by a constant amount in x and y without changing the length or angle of vectors.

        See Also:
        Constant Field Values
      • TYPE_UNIFORM_SCALE

        public static final int TYPE_UNIFORM_SCALE

        A uniform scale multiplies the length of vectors by the same amount in both the x and y directions without changing the angle between vectors. This flag bit is mutually exclusive with the TypeGeneralScale flag.

        See Also:
        Constant Field Values
      • TYPE_GENERAL_SCALE

        public static final int TYPE_GENERAL_SCALE

        A general scale multiplies the length of vectors by different amounts in the x and y directions without changing the angle between perpendicular vectors. This flag bit is mutually exclusive with the TypeUniformScale flag.

        See Also:
        Constant Field Values
      • TYPE_MASK_SCALE

        public static final int TYPE_MASK_SCALE

        This constant is a bit mask for any of the scale flag bits.

        See Also:
        Constant Field Values
      • TYPE_FLIP

        public static final int TYPE_FLIP

        This flag bit indicates that the transform defined by this object performs a mirror image flip about some axis which changes the normally right handed coordinate system into a left handed system in addition to the conversions indicated by other flag bits. A right handed coordinate system is one where the positive X axis rotates counterclockwise to overlay the positive Y axis similar to the direction that the fingers on your right hand curl when you stare end on at your thumb. A left handed coordinate system is one where the positive X axis rotates clockwise to overlay the positive Y axis similar to the direction that the fingers on your left hand curl. There is no mathematical way to determine the angle of the original flipping or mirroring transformation since all angles of flip are identical given an appropriate adjusting rotation. NOTE: TypeFlip was added after GENERAL_TRANSFORM was in public circulation and the flag bits could no longer be conveniently renumbered without introducing binary incompatibility in outside code.

        See Also:
        Constant Field Values
      • TYPE_QUADRANT_ROTATION

        public static final int TYPE_QUADRANT_ROTATION

        This flag bit indicates that the transform defined by this object performs a quadrant rotation by some multiple of 90 degrees in addition to the conversions indicated by other flag bits. A rotation changes the angles of vectors by the same amount regardless of the original direction of the vector and without changing the length of the vector. This flag bit is mutually exclusive with the TypeGeneralRotation flag.

        See Also:
        Constant Field Values
      • TYPE_GENERAL_ROTATION

        public static final int TYPE_GENERAL_ROTATION

        This flag bit indicates that the transform defined by this object performs a rotation by an arbitrary angle in addition to the conversions indicated by other flag bits. A rotation changes the angles of vectors by the same amount regardless of the original direction of the vector and without changing the length of the vector. This flag bit is mutually exclusive with the

        See Also:
        Constant Field Values
      • TYPE_MASK_ROTATION

        public static final int TYPE_MASK_ROTATION

        This constant is a bit mask for any of the rotation flag bits.

        See Also:
        Constant Field Values
      • TYPE_GENERAL_TRANSFORM

        public static final int TYPE_GENERAL_TRANSFORM

        This constant indicates that the transform defined by this object performs an arbitrary conversion of the input coordinates. If this transform can be classified by any of the above constants, the type will either be the constant TypeIdentity or a combination of the appropriate flag bits for the various coordinate conversions that this transform performs.

        See Also:
        Constant Field Values
    • Constructor Detail

      • Matrix

        public Matrix()

        Initializes a new instance of the Matrix class as the identity matrix.

      • Matrix

        public Matrix(float m11,
              float m12,
              float m21,
              float m22,
              float m31,
              float m32)

        Initializes a new instance of the Matrix class.

        Parameters:
        m11 - m00 M11 Scale X
        m12 - m10 M12 Shear Y
        m21 - m01 M21 Shear X
        m22 - m11 M22 Scale Y
        m31 - m02 M31 Translate X
        m32 - m12 M32 Translate Y
      • Matrix

        public Matrix(RectangleF rect,
              PointF[] plgpts)

        Initializes a new instance of the Aspose.CAD.Matrix class to the geometric transform defined by the specified rectangle and array of points.

        Parameters:
        rect - A Aspose.CAD.RectangleF structure that represents the rectangle to be transformed.
        plgpts - An array of three Aspose.CAD.PointF structures that represents the points of a parallelogram to which the upper-left, upper-right, and lower-left corners of the rectangle is to be transformed. The lower-right corner of the parallelogram is implied by the first three corners.
      • Matrix

        public Matrix(Rectangle rect,
              Point[] plgpts)

        Initializes a new instance of the Aspose.CAD.Matrix class to the geometric transform defined by the specified rectangle and array of points.

        Parameters:
        rect - A Aspose.CAD.Rectangle structure that represents the rectangle to be transformed.
        plgpts - An array of three Aspose.CAD.Point structures that represents the points of a parallelogram to which the upper-left, upper-right, and lower-left corners of the rectangle is to be transformed. The lower-right corner of the parallelogram is implied by the first three corners.
    • Method Detail

      • getM11

        public float getM11()

        Gets the matrix element at first row first column. Represents scale along X axis.

      • getM12

        public float getM12()

        Gets the matrix element at first row second column. Represents shear along Y axis.

      • getM21

        public float getM21()

        Gets the matrix element at second row first column. Represents shear along X axis.

      • getM22

        public float getM22()

        Gets the matrix element at second row second column. Represents scale along Y axis.

      • getM31

        public float getM31()

        Gets the matrix element at third row first column. Represents translation along X axis.

      • getM32

        public float getM32()

        Gets the matrix element at third row first column. Represents translation along Y axis.

      • toString

        public String toString()

        Returns a System.String that represents this instance.

        Overrides:
        toString in class Object
        Returns:
        A System.String that represents this instance.
      • op_Equality

        public static boolean op_Equality(Matrix matrix1,
                          Matrix matrix2)

        Implements the operator ==.

        Parameters:
        matrix1 - The first matrix to compare.
        matrix2 - The second matrix to compare.
        Returns:
        The result of the operator.
      • op_Inequality

        public static boolean op_Inequality(Matrix matrix1,
                            Matrix matrix2)

        Implements the operator !=.

        Parameters:
        matrix1 - The first matrix to compare.
        matrix2 - The second matrix to compare.
        Returns:
        The result of the operator.
      • getElements

        public float[] getElements()

        Gets the copy of matrix elements.

        Returns:
        A matrix elements copy.
      • transformPoints

        public void transformPoints(PointF[] points)

        Applies the geometric transform represented by this Matrix to a specified array of points.

        Parameters:
        points - The points.
      • scale

        public void scale(float scaleX,
                 float scaleY,
                 int order)

        Applies the specified scale vector (scaleX and scaleY) to this Matrix using the specified order.

        Parameters:
        scaleX - The scale X.
        scaleY - The scale Y.
        order - The order.
      • scale

        public void scale(float sx,
                 float sy)

        Applies the specified scale vector (scaleX and scaleY) to this Matrix using (default) Prepend order.

        Parameters:
        sx - The sx. The sx. The sx.
        sy - The sy. The sy. The sy.
      • translate

        public void translate(float offsetX,
                     float offsetY,
                     int order)

        Applies the specified translation vector to this Matrix in the specified order.

        Parameters:
        offsetX - The offset X.
        offsetY - The offset Y.
        order - The order.
      • translate

        public void translate(float tx,
                     float ty)

        Applies the specified translation vector to this Matrix using (default) Prepend order.

        Parameters:
        tx - The tx. The tx. The tx.
        ty - The ty. The ty. The ty.
      • multiply

        public void multiply(Matrix Tx,
                    int order)

        Multiplies this Matrix by the matrix specified in the matrix parameter, and in the order specified in the order parameter.

        Parameters:
        Tx - The tx. The tx. The tx.
        order - The order. The order. The order.
      • multiply

        public void multiply(Matrix Tx)

        Multiplies this Matrix by the matrix specified in the matrix parameter using (default) Prepend order.

        Parameters:
        Tx - The matrix to multiply with.
      • rotate

        public void rotate(float angle,
                  int order)

        Applies a clockwise rotation of an amount specified in the angle parameter, around the origin (zero x and y coordinates) for this Matrix in the specified order.

        Parameters:
        angle - The rotate angle.
        order - The matrix order.
      • rotate

        public void rotate(float angle)

        Applies a clockwise rotation of an amount specified in the angle parameter, around the origin (zero x and y coordinates) for this Matrix in the default (Prepend) order.

        Parameters:
        angle - The rotate angle.
      • rotateAt

        public void rotateAt(float angle,
                    PointF point,
                    int order)

        Applies a clockwise rotation about the specified point to this Matrix in the specified order.

        Parameters:
        angle - The angle.
        point - The point.
        order - The order.
      • rotateAt

        public void rotateAt(float angle,
                    PointF point)

        Applies a clockwise rotation about the specified point to this Matrix in the default (Prepend) order.

        Parameters:
        angle - The angle.
        point - The point.
      • reset

        public void reset()

        Resets this Matrix to have the elements of the identity matrix.

      • hashCode

        public int hashCode()

        Returns a hash code for this instance.

        Overrides:
        hashCode in class Object
        Returns:
        A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.
      • equals

        public boolean equals(Object obj)

        Determines whether the specified System.Object is equal to this instance.

        Overrides:
        equals in class Object
        Parameters:
        obj - The System.Object to compare with this instance.
        Returns:
        true if the specified System.Object is equal to this instance; otherwise, false.
        Throws:
        T:System.NullReferenceException - The obj parameter is null.
      • equals

        public static boolean equals(Matrix a,
                     Matrix b)

        Determines whether two matrixes are equal.

        Parameters:
        a - The first matrix to compare.
        b - The second matrix to compare.
        Returns:
        True if matrixes are equal.