Gjsify LogoGjsify Logo

A PangoMatrix specifies a transformation between user-space and device coordinates.

The transformation is given by

x_device = x_user * matrix->xx + y_user * matrix->xy + matrix->x0;
y_device = x_user * matrix->yx + y_user * matrix->yy + matrix->y0;
record

Hierarchy

  • Matrix

Index

Constructors

Properties

x0: number

x translation

field
xx: number

1st component of the transformation matrix

field
xy: number

2nd component of the transformation matrix

field
y0: number

y translation

field
yx: number

3rd component of the transformation matrix

field
yy: number

4th component of the transformation matrix

field
name: string

Methods

  • Changes the transformation represented by matrix to be the transformation given by first applying transformation given by new_matrix then applying the original transformation.

    Parameters

    Returns void

  • free(): void
  • getFontScaleFactor(): number
  • Returns the scale factor of a matrix on the height of the font.

    That is, the scale factor in the direction perpendicular to the vector that the X coordinate is mapped to. If the scale in the X coordinate is needed as well, use [methodPango.Matrix.get_font_scale_factors].

    Returns number

  • getFontScaleFactors(): [number, number]
  • Calculates the scale factor of a matrix on the width and height of the font.

    That is, xscale is the scale factor in the direction of the X coordinate, and yscale is the scale factor in the direction perpendicular to the vector that the X coordinate is mapped to.

    Note that output numbers will always be non-negative.

    Returns [number, number]

  • getSlantRatio(): number
  • Gets the slant ratio of a matrix.

    For a simple shear matrix in the form:

    1 λ
    0 1

    this is simply λ.

    Returns number

  • rotate(degrees: number): void
  • Changes the transformation represented by matrix to be the transformation given by first rotating by degrees degrees counter-clockwise then applying the original transformation.

    Parameters

    • degrees: number

      degrees to rotate counter-clockwise

    Returns void

  • scale(scaleX: number, scaleY: number): void
  • Changes the transformation represented by matrix to be the transformation given by first scaling by sx in the X direction and sy in the Y direction then applying the original transformation.

    Parameters

    • scaleX: number

      amount to scale by in X direction

    • scaleY: number

      amount to scale by in Y direction

    Returns void

  • transformDistance(dx: number, dy: number): [number, number]
  • Transforms the distance vector (dx,``dy) by matrix.

    This is similar to [methodPango.Matrix.transform_point], except that the translation components of the transformation are ignored. The calculation of the returned vector is as follows:

    dx2 = dx1 * xx + dy1 * xy;
    dy2 = dx1 * yx + dy1 * yy;

    Affine transformations are position invariant, so the same vector always transforms to the same vector. If (x1,y1) transforms to (x2,y2) then (x1+dx1,y1+dy1) will transform to (x1+dx2,y1+dy2) for all values of x1 and x2.

    Parameters

    • dx: number

      in/out X component of a distance vector

    • dy: number

      in/out Y component of a distance vector

    Returns [number, number]

  • First transforms the rect using matrix, then calculates the bounding box of the transformed rectangle.

    This function is useful for example when you want to draw a rotated PangoLayout to an image buffer, and want to know how large the image should be and how much you should shift the layout when rendering.

    For better accuracy, you should use [methodPango.Matrix.transform_rectangle] on original rectangle in Pango units and convert to pixels afterward using [funcextents_to_pixels]'s first argument.

    Parameters

    Returns Pango.Rectangle

  • transformPoint(x: number, y: number): [number, number]
  • Transforms the point (x, y) by matrix.

    Parameters

    • x: number

      in/out X position

    • y: number

      in/out Y position

    Returns [number, number]

  • First transforms rect using matrix, then calculates the bounding box of the transformed rectangle.

    This function is useful for example when you want to draw a rotated PangoLayout to an image buffer, and want to know how large the image should be and how much you should shift the layout when rendering.

    If you have a rectangle in device units (pixels), use [methodPango.Matrix.transform_pixel_rectangle].

    If you have the rectangle in Pango units and want to convert to transformed pixel bounding box, it is more accurate to transform it first (using this function) and pass the result to pango_extents_to_pixels(), first argument, for an inclusive rounded rectangle. However, there are valid reasons that you may want to convert to pixels first and then transform, for example when the transformed coordinates may overflow in Pango units (large matrix translation for example).

    Parameters

    Returns Pango.Rectangle

  • translate(tx: number, ty: number): void
  • Changes the transformation represented by matrix to be the transformation given by first translating by (tx, ty) then applying the original transformation.

    Parameters

    • tx: number

      amount to translate in the X direction

    • ty: number

      amount to translate in the Y direction

    Returns void

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Type alias with type parameter
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method