BLMatrix2D Struct Reference

2D matrix represents an affine transformation matrix that can be used to transform geometry and images.

Public Members

union {

  double m[6]

  struct {

    double m00

    double m01

    double m10

    double m11

    double m20

    double m21

  }

};

Member Functions

Construction & Destruction

BLMatrix2D() = default

constexpr BLMatrix2D(const BLMatrix2D& src) = default

constexpr BLMatrix2D(double m00Value, double m01Value, double m10Value, double m11Value, double m20Value, double m21Value)

Reset Matrix

void reset()

void reset(const BLMatrix2D& other)

void reset(double m00Value, double m01Value, double m10Value, double m11Value, double m20Value, double m21Value)

void resetToTranslation(double x, double y)

void resetToTranslation(const BLPointI& p)

void resetToTranslation(const BLPoint& p)

void resetToScaling(double xy)

void resetToScaling(double x, double y)

void resetToScaling(const BLPointI& p)

void resetToScaling(const BLPoint& p)

void resetToSkewing(double x, double y)

void resetToSkewing(const BLPoint& p)

void resetToSinCos(double sin, double cos, double tx = 0.0, double ty = 0.0)

void resetToSinCos(double sin, double cos, const BLPoint& t)

void resetToRotation(double angle)

void resetToRotation(double angle, double x, double y)

void resetToRotation(double angle, const BLPoint& origin)

Overloaded Operators

BLMatrix2D& operator=(const BLMatrix2D& other) = default

bool operator==(const BLMatrix2D& other) const

bool operator!=(const BLMatrix2D& other) const

Common Functionality

bool equals(const BLMatrix2D& other) const

Matrix Properties

BLTransformType type() const

double determinant() const

Matrix Operations

BLResult translate(double x, double y)

BLResult translate(const BLPointI& p)

BLResult translate(const BLPoint& p)

BLResult scale(double xy)

BLResult scale(double x, double y)

BLResult scale(const BLPointI& p)

BLResult scale(const BLPoint& p)

BLResult skew(double x, double y)

BLResult skew(const BLPoint& p)

BLResult rotate(double angle)

BLResult rotate(double angle, double x, double y)

BLResult rotate(double angle, const BLPointI& origin)

BLResult rotate(double angle, const BLPoint& origin)

BLResult transform(const BLMatrix2D& m)

BLResult postTranslate(double x, double y)

BLResult postTranslate(const BLPointI& p)

BLResult postTranslate(const BLPoint& p)

BLResult postScale(double xy)

BLResult postScale(double x, double y)

BLResult postScale(const BLPointI& p)

BLResult postScale(const BLPoint& p)

BLResult postSkew(double x, double y)

BLResult postSkew(const BLPoint& p)

BLResult postRotate(double angle)

BLResult postRotate(double angle, double x, double y)

BLResult postRotate(double angle, const BLPointI& origin)

BLResult postRotate(double angle, const BLPoint& origin)

BLResult postTransform(const BLMatrix2D& m)

BLResult invert()

Map Points and Primitives

BLPoint mapPoint(double x, double y) const

BLPoint mapPoint(const BLPoint& p) const

BLPoint mapVector(double x, double y) const

BLPoint mapVector(const BLPoint& v) const

Static Functions

Static Constructors

static constexpr BLMatrix2D makeIdentity()

static constexpr BLMatrix2D makeTranslation(double x, double y)

static constexpr BLMatrix2D makeTranslation(const BLPointI& p)

static constexpr BLMatrix2D makeTranslation(const BLPoint& p)

static constexpr BLMatrix2D makeScaling(double xy)

static constexpr BLMatrix2D makeScaling(double x, double y)

static constexpr BLMatrix2D makeScaling(const BLPointI& p)

static constexpr BLMatrix2D makeScaling(const BLPoint& p)

static BLMatrix2D makeRotation(double angle)

static BLMatrix2D makeRotation(double angle, double x, double y)

static BLMatrix2D makeRotation(double angle, const BLPoint& origin)

static BLMatrix2D makeSkewing(double x, double y)

static BLMatrix2D makeSkewing(const BLPoint& p)

static BLMatrix2D makeSinCos(double sin, double cos, double tx = 0.0, double ty = 0.0)

static BLMatrix2D makeSinCos(double sin, double cos, const BLPoint& t)

Static Operations

static BLResult invert(BLMatrix2D& dst, const BLMatrix2D& src)

Constructor & Destructor Documentation

BLMatrix2D::BLMatrix2D()default[1/3]

Creates an uninitialized 2D matrix, you must initialize all members before use.

BLMatrix2D::BLMatrix2D(const BLMatrix2D& src)constexprconstexprdefault[2/3]

Creates a new matrix initialized to a copy of src matrix.

BLMatrix2D::BLMatrix2D(double m00Value, double m01Value, double m10Value, double m11Value, double m20Value, double m21Value)constexprconstexpr[3/3]

Creates a new matrix initialized to:

[m00 m01]
[m10 m11]
[m20 m21]

Member Function Documentation

BLMatrix2D BLMatrix2D::makeIdentity()constexprstaticconstexpr

Creates a new matrix initialized to identity.

BLMatrix2D BLMatrix2D::makeTranslation(double x, double y)constexprstaticconstexpr[1/3]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLMatrix2D BLMatrix2D::makeTranslation(const BLPointI& p)constexprstaticconstexpr[2/3]

Creates a new matrix initialized to translation.

BLMatrix2D BLMatrix2D::makeTranslation(const BLPoint& p)constexprstaticconstexpr[3/3]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLMatrix2D BLMatrix2D::makeScaling(double xy)constexprstaticconstexpr[1/4]

Creates a new matrix initialized to scaling.

BLMatrix2D BLMatrix2D::makeScaling(double x, double y)constexprstaticconstexpr[2/4]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLMatrix2D BLMatrix2D::makeScaling(const BLPointI& p)constexprstaticconstexpr[3/4]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLMatrix2D BLMatrix2D::makeScaling(const BLPoint& p)constexprstaticconstexpr[4/4]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLMatrix2D BLMatrix2D::makeRotation(double angle)static[1/3]

Creates a new matrix initialized to rotation.

BLMatrix2D BLMatrix2D::makeRotation(double angle, double x, double y)static[2/3]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLMatrix2D BLMatrix2D::makeRotation(double angle, const BLPoint& origin)static[3/3]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

BLMatrix2D BLMatrix2D::makeSkewing(double x, double y)static[1/2]

Create a new skewing matrix.

BLMatrix2D BLMatrix2D::makeSkewing(const BLPoint& p)static[2/2]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

void BLMatrix2D::reset()[1/3]

Resets matrix to identity.

void BLMatrix2D::reset(const BLMatrix2D& other)[2/3]

Resets matrix to other (copy its content to this matrix).

void BLMatrix2D::reset(double m00Value, double m01Value, double m10Value, double m11Value, double m20Value, double m21Value)[3/3]

Resets matrix to [m00Value, m01Value, m10Value, m11Value, m20Value, m21Value].

void BLMatrix2D::resetToTranslation(double x, double y)[1/3]

Resets matrix to translation.

void BLMatrix2D::resetToTranslation(const BLPointI& p)[2/3]

Resets matrix to translation.

void BLMatrix2D::resetToTranslation(const BLPoint& p)[3/3]

Resets matrix to translation.

void BLMatrix2D::resetToScaling(double xy)[1/4]

Resets matrix to scaling.

void BLMatrix2D::resetToScaling(double x, double y)[2/4]

Resets matrix to scaling.

void BLMatrix2D::resetToScaling(const BLPointI& p)[3/4]

Resets matrix to scaling.

void BLMatrix2D::resetToScaling(const BLPoint& p)[4/4]

Resets matrix to scaling.

void BLMatrix2D::resetToSkewing(double x, double y)[1/2]

Resets matrix to skewing.

void BLMatrix2D::resetToSkewing(const BLPoint& p)[2/2]

Resets matrix to skewing.

void BLMatrix2D::resetToSinCos(double sin, double cos, double tx = 0.0, double ty = 0.0)[1/2]

Resets matrix to rotation specified by sin and cos and optional translation tx and ty.

void BLMatrix2D::resetToSinCos(double sin, double cos, const BLPoint& t)[2/2]

Resets matrix to rotation specified by sin and cos and optional translation t.

void BLMatrix2D::resetToRotation(double angle)[1/3]

Resets matrix to rotation.

void BLMatrix2D::resetToRotation(double angle, double x, double y)[2/3]

Resets matrix to rotation around a point [x, y].

void BLMatrix2D::resetToRotation(double angle, const BLPoint& origin)[3/3]

Resets matrix to rotation around a point p.

BLTransformType BLMatrix2D::type() const

Returns the matrix type, see BLTransformType.

double BLMatrix2D::determinant() const

Calculates the matrix determinant.

BLResult BLMatrix2D::invert()[1/2]

Inverts the matrix, returns BL_SUCCESS if the matrix has been inverted successfully.

BLResult BLMatrix2D::invert(BLMatrix2D& dst, const BLMatrix2D& src)static[2/2]

Inverts src matrix and stores the result in `dst.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Member Data Documentation

double BLMatrix2D::m[6]

Matrix values, use BL_MATRIX2D_VALUE indexes to get a particular one.