Blend2D

2D Vector Graphics Engine

About

Roadmap

Performance

Docs

Blog

Research

Support

Download

{Fiddle}

API Reference

Index Class List Globals Containers Geometries Imaging Styling Text Rendering Runtime Filesystem Miscellaneous Impl API Macros C API Object Model

Topics

Getting StartedBuild InstructionsMultithreaded Rendering

Index ⭢ Geometries ⭢ BLMatrix2D

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() noexcept = default

constexpr BLMatrix2D(const BLMatrix2D& src) noexcept = default

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

Reset Matrix

void reset() noexcept

void reset(const BLMatrix2D& other) noexcept

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

void resetToTranslation(double x, double y) noexcept

void resetToTranslation(const BLPointI& p) noexcept

void resetToTranslation(const BLPoint& p) noexcept

void resetToScaling(double xy) noexcept

void resetToScaling(double x, double y) noexcept

void resetToScaling(const BLPointI& p) noexcept

void resetToScaling(const BLPoint& p) noexcept

void resetToSkewing(double x, double y) noexcept

void resetToSkewing(const BLPoint& p) noexcept

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

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

void resetToRotation(double angle) noexcept

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

void resetToRotation(double angle, const BLPoint& origin) noexcept

Overloaded Operators

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

bool operator==(const BLMatrix2D& other) const noexcept

bool operator!=(const BLMatrix2D& other) const noexcept

Common Functionality

bool equals(const BLMatrix2D& other) const noexcept

Matrix Properties

BLTransformType type() const noexcept

double determinant() const noexcept

Matrix Operations

BLResult translate(double x, double y) noexcept

BLResult translate(const BLPointI& p) noexcept

BLResult translate(const BLPoint& p) noexcept

BLResult scale(double xy) noexcept

BLResult scale(double x, double y) noexcept

BLResult scale(const BLPointI& p) noexcept

BLResult scale(const BLPoint& p) noexcept

BLResult skew(double x, double y) noexcept

BLResult skew(const BLPoint& p) noexcept

BLResult rotate(double angle) noexcept

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

BLResult rotate(double angle, const BLPointI& origin) noexcept

BLResult rotate(double angle, const BLPoint& origin) noexcept

BLResult transform(const BLMatrix2D& m) noexcept

BLResult postTranslate(double x, double y) noexcept

BLResult postTranslate(const BLPointI& p) noexcept

BLResult postTranslate(const BLPoint& p) noexcept

BLResult postScale(double xy) noexcept

BLResult postScale(double x, double y) noexcept

BLResult postScale(const BLPointI& p) noexcept

BLResult postScale(const BLPoint& p) noexcept

BLResult postSkew(double x, double y) noexcept

BLResult postSkew(const BLPoint& p) noexcept

BLResult postRotate(double angle) noexcept

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

BLResult postRotate(double angle, const BLPointI& origin) noexcept

BLResult postRotate(double angle, const BLPoint& origin) noexcept

BLResult postTransform(const BLMatrix2D& m) noexcept

BLResult invert() noexcept

Map Points and Primitives

BLPoint mapPoint(double x, double y) const noexcept

BLPoint mapPoint(const BLPoint& p) const noexcept

BLPoint mapVector(double x, double y) const noexcept

BLPoint mapVector(const BLPoint& v) const noexcept

Static Functions

Static Constructors

static constexpr BLMatrix2D makeIdentity() noexcept

static constexpr BLMatrix2D makeTranslation(double x, double y) noexcept

static constexpr BLMatrix2D makeTranslation(const BLPointI& p) noexcept

static constexpr BLMatrix2D makeTranslation(const BLPoint& p) noexcept

static constexpr BLMatrix2D makeScaling(double xy) noexcept

static constexpr BLMatrix2D makeScaling(double x, double y) noexcept

static constexpr BLMatrix2D makeScaling(const BLPointI& p) noexcept

static constexpr BLMatrix2D makeScaling(const BLPoint& p) noexcept

static BLMatrix2D makeRotation(double angle) noexcept

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

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

static BLMatrix2D makeSkewing(double x, double y) noexcept

static BLMatrix2D makeSkewing(const BLPoint& p) noexcept

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

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

Static Operations

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

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

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

BLMatrix2D::BLMatrix2D(

const BLMatrix2D& src

)constexprdefaultnoexcept[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

)constexprnoexcept[3/3]

Creates a new matrix initialized to:

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

BLMatrix2D BLMatrix2D::makeIdentity()constexprstaticnoexcept

Creates a new matrix initialized to identity.

BLMatrix2D BLMatrix2D::makeTranslation(

double x,

double y

)constexprstaticnoexcept[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

)constexprstaticnoexcept[2/3]

Creates a new matrix initialized to translation.

BLMatrix2D BLMatrix2D::makeTranslation(

const BLPoint& p

)constexprstaticnoexcept[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

)constexprstaticnoexcept[1/4]

Creates a new matrix initialized to scaling.

BLMatrix2D BLMatrix2D::makeScaling(

double x,

double y

)constexprstaticnoexcept[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

)constexprstaticnoexcept[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

)constexprstaticnoexcept[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

)staticnoexcept[1/3]

Creates a new matrix initialized to rotation.

BLMatrix2D BLMatrix2D::makeRotation(

double angle,

double x,

double y

)staticnoexcept[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

)staticnoexcept[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

)staticnoexcept[1/2]

Create a new skewing matrix.

BLMatrix2D BLMatrix2D::makeSkewing(

const BLPoint& p

)staticnoexcept[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()noexcept[1/3]

Resets matrix to identity.

void BLMatrix2D::reset(

const BLMatrix2D& other

)noexcept[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

)noexcept[3/3]

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

void BLMatrix2D::resetToTranslation(

double x,

double y

)noexcept[1/3]

Resets matrix to translation.

void BLMatrix2D::resetToTranslation(

const BLPointI& p

)noexcept[2/3]

Resets matrix to translation.

void BLMatrix2D::resetToTranslation(

const BLPoint& p

)noexcept[3/3]

Resets matrix to translation.

void BLMatrix2D::resetToScaling(

double xy

)noexcept[1/4]

Resets matrix to scaling.

void BLMatrix2D::resetToScaling(

double x,

double y

)noexcept[2/4]

Resets matrix to scaling.

void BLMatrix2D::resetToScaling(

const BLPointI& p

)noexcept[3/4]

Resets matrix to scaling.

void BLMatrix2D::resetToScaling(

const BLPoint& p

)noexcept[4/4]

Resets matrix to scaling.

void BLMatrix2D::resetToSkewing(

double x,

double y

)noexcept[1/2]

Resets matrix to skewing.

void BLMatrix2D::resetToSkewing(

const BLPoint& p

)noexcept[2/2]

Resets matrix to skewing.

void BLMatrix2D::resetToSinCos(

double sin,

double cos,

double tx = 0.0,

double ty = 0.0

)noexcept[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

)noexcept[2/2]

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

void BLMatrix2D::resetToRotation(

double angle

)noexcept[1/3]

Resets matrix to rotation.

void BLMatrix2D::resetToRotation(

double angle,

double x,

double y

)noexcept[2/3]

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

void BLMatrix2D::resetToRotation(

double angle,

const BLPoint& origin

)noexcept[3/3]

Resets matrix to rotation around a point p.

BLTransformType BLMatrix2D::type() constnoexcept

Returns the matrix type, see BLTransformType.

double BLMatrix2D::determinant() constnoexcept

Calculates the matrix determinant.

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

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

BLResult BLMatrix2D::invert(

BLMatrix2D& dst,

const BLMatrix2D& src

)staticnoexcept[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.

double BLMatrix2D::m[6]

Matrix values stored in array.

More Information

About Blend2D

Project Roadmap

Performance Comparison

Documentation

Getting Started

Build Instructions

C/C++ API Reference

Support

Contact

Donation Options

Commercial Support

Get Blend2D

Download Page

Blend2D on GitHub

© 2017-2024 Blend2D Team | GitHub | Chat | Support | Download

Blend2D library and its dependencies are open source software released under the Zlib license and can be used safely in any open-source or commercial product, statically or dynamically linked, and without advertising the use of Blend2D. Code snippets and examples are released into public domain, see Unlicense for more details.