2D Affine Transforms — cglm 0.9.6 documentation

# 2D Affine Transforms

Header: cglm/affine2d.h

2D Transforms uses 2d suffix for naming. If there is no 2D suffix it is 3D function.

## Initialize Transform Matrices

Functions with _make prefix expect you don’t have a matrix and they create a matrix for you. You don’t need to pass identity matrix.

But other functions expect you have a matrix and you want to transform them. If you didn’t have any existing matrix you have to initialize matrix to identity before sending to transform functions.

## Transforms Order

See Transforms Order to read similar section.

## Table of contents (click to go):

Functions:

1. `glm_translate2d()`

2. `glm_translate2d_to()`

3. `glm_translate2d_x()`

4. `glm_translate2d_y()`

5. `glm_translate2d_make()`

6. `glm_scale2d_to()`

7. `glm_scale2d_make()`

8. `glm_scale2d()`

9. `glm_scale2d_uni()`

10. `glm_rotate2d_make()`

11. `glm_rotate2d()`

12. `glm_rotate2d_to()`

void glm_translate2d(mat3 m, vec2 v)

  translate existing 2d transform matrix by v vector and stores result in same matrix

  Parameters:
    [in, out] m 2d affine transform
    [in] v translate vector [x, y]

void glm_translate2d_to(mat3 m, vec2 v, mat3 dest)

  translate existing 2d transform matrix by v vector and store result in dest

  Parameters:
    [in] m 2d affine transform
    [in] v translate vector [x, y]
    [out] dest translated matrix

void glm_translate2d_x(mat3 m, float x)

  translate existing 2d transform matrix by x factor

  Parameters:
    [in, out] m 2d affine transform
    [in] x x factor

void glm_translate2d_y(mat3 m, float y)

  translate existing 2d transform matrix by y factor

  Parameters:
    [in, out] m 2d affine transform
    [in] y y factor

void glm_translate2d_make(mat3 m, vec2 v)

  creates NEW translate 2d transform matrix by v vector

  Parameters:
    [in, out] m affine transform
    [in] v translate vector [x, y]

void glm_scale2d_to(mat3 m, vec2 v, mat3 dest)

  scale existing 2d transform matrix by v vector and store result in dest

  Parameters:
    [in] m affine transform
    [in] v scale vector [x, y]
    [out] dest scaled matrix

void glm_scale2d_make(mat3 m, vec2 v)

  creates NEW 2d scale matrix by v vector

  Parameters:
    [in, out] m affine transform
    [in] v scale vector [x, y]

void glm_scale2d(mat3 m, vec2 v)

  scales existing 2d transform matrix by v vector and stores result in same matrix

  Parameters:
    [in, out] m affine transform
    [in] v translate vector [x, y]

void glm_scale2d_uni(mat3 m, float s)

  applies uniform scale to existing 2d transform matrix v = [s, s] and stores result in same matrix

  Parameters:
    [in, out] m affine transform
    [in] s scale factor

void glm_rotate2d_make(mat3 m, float angle)

  creates NEW rotation matrix by angle around Z axis

  Parameters:
    [in, out] m affine transform
    [in] angle angle (radians)

void glm_rotate2d(mat3 m, float angle)

  rotate existing 2d transform matrix around Z axis by angle and store result in same matrix

  Parameters:
    [in, out] m affine transform
    [in] angle angle (radians)

void glm_rotate2d_to(mat3 m, float angle, mat3 dest)

  rotate existing 2d transform matrix around Z axis by angle and store result in dest

  Parameters:
    [in] m affine transform
    [in] angle angle (radians)
    [out] dest rotated matrix