comp • gb.cairo • cairopattern • matrix

CairoPattern.Matrix (gb.cairo)

Property Matrix As CairoMatrix

Returns or sets the pattern transformation matrix.

This matrix is a transformation from user space to pattern space.

When a pattern is first created it always has the identity matrix for its transformation matrix, which means that pattern space is initially identical to user space.

Please note that the direction of this transformation matrix is from user space to pattern space. This means that if you imagine the flow from a pattern to user space (and on to device space), then coordinates in that flow will be transformed by the inverse of the pattern matrix.

For example, if you want to make a pattern appear twice as large as it does by default the correct code to use is:

Dim MyPattern As CairoPattern

MyPattern.Matrix = CairoMatrix().Scale(0.5, 0.5)

Meanwhile, using values of 2.0 rather than 0.5 in the code above would cause the pattern to appear at half of its default size.

Also, please note the discussion of the user-space locking semantics of Cairo.Source.