Context

degrees(radians) -> float

radians(degrees) -> float

point(x, y) -> struct<context.Point>

distance(p1, p2) -> float

interpolate(p1, p2, t) -> struct<context.Point>

new(width, height) -> int<collection.CONTEXT>

new_image(id) -> int<collection.CONTEXT>

new_direct(id) -> int<collection.CONTEXT>

Creates a new context directly on the image, this requires the image to use the RGBA color model. If not it will be converted to RGBA. This is also not thread safe, as modifying either the image or the context will affect the other, with no guarantee of the order of operations.

to_image(id, name, encoding, model?, copy?) -> int<collection.IMAGE>

to_mask(id, name, encoding) -> int<collection.IMAGE>

mask(id, img)

The image will be copied and converted to 'image.MODEL_ALPHA'.

size(id) -> int, int

@blocking

font_height(id) -> float

@blocking

string_measure(id, str) -> float, float

@blocking

string_measure_multiline(id, str, spacing) -> float, float

@blocking

current_point(id) -> float, float, bool

@blocking

transform_point(id, x, y) -> float, float

@blocking

Multiplies a point by the current matrix.

clear(id)

Fills the context with the current color.

clip(id, preserve?)

Updates the clipping region by intersecting the current clipping region with the current path as it would be filled by fill().

clip_reset(id)

Clears the clipping region.

path_clear(id)

Removes all points from the current path.

path_close(id)

Adds a line segment from the current point to the initial point.

path_to(id, x, y)

Starts a new subpath starting at the given point.

subpath(id)

Starts a new subpath starting at the current point. No current point will be set after.

draw_cubic(id, x1, y1, x2, y2, x3, y3)

Draws a cubic bezier curve to the path starting at the current point, if there isn't a current point, it moves to (x1, y1).

draw_quadratic(id, x1, y1, x2, y2)

Draws a quadratic bezier curve to the path starting at the current point, if there isn't a current point, it moves to (x1, y1).

draw_arc(id, x, y, r, angle1, angle2)

draw_circle(id, x, y, r)

draw_ellipse(id, x, y, rx, xy)

draw_elliptical_arc(id, x, y, rx, ry, angle1, angle2)

draw_image(id, img, x, y)

draw_image_anchor(id, img, x, y, ax, ay)

The anchor is a point between (0,0) and (1,1), so (0.5,0.5) is centered.

draw_line(id, x1, y1, x2, y2)

draw_line_to(id, x, y)

Draws a line to the point, starting from the current point. If there is no current point, no line will be drawn and the current point will be set.

draw_point(id, x, y, r)

Similar to draw_circle but ensures that a circle of the specified size is drawn regardless of the current transformation matrix. The position is still transformed, but not the shape of the point.

draw_rect(id, x, y, width, height)

draw_rect_round(id, x, y, width, height, r)

draw_polygon(id, n, x, y, r, rotation)

draw_string(id, str, x, y)

draw_string_anchor(id, str, x, y, ax, ay)

The anchor is a point between (0,0) and (1,1), so (0.5,0.5) is centered.

draw_string_wrap(id, str, x, y, ax, ay, width, spacing, align)

The anchor is a point between (0,0) and (1,1), so (0.5,0.5) is centered.

fill(id, preserve?)

Fills the current path with the current color. Closes open paths.

fill_rule(id, rule)

stroke(id, preserve?)

Strokes the current path with the current color.

identity(id)

Resets the current transformation matrix to the identity matrix.

mask_invert(id)

Inverts the alpha values of the clipping mask.

invert_y(id)

Flips the y axis so that Y=0 is at the bottom of the image.

push(id)

Push the current context state to the stack.

pop(id)

Pop the current context state to the stack.

rotate(id, angle)

Rotates the transformation matrix around the origin.

rotate_about(id, angle, x, y)

Rotates the transformation matrix around the point.

scale(id, x, y)

Scales the transformation matrix by a factor.

scale_about(id, sx, sy, x, y)

Scales the transformation matrix by a factor (sx,sy) starting at the point (x,y).

color_hex(id, hex)

Supports hex colors in the follow formats: #RGB #RRGGBB #RRGGBBAA. The leading # is optional.

color(id, color)

color_rgb(id, r, g, b)

Float values for r,g,b between 0 and 1.

color_rgb255(id, r, g, b)

Interger values for r,g,b between 0 and 255.

color_rgba(id, r, g, b, a)

Float values for r,g,b,a between 0 and 1.

color_rgba255(id, r, g, b, a)

Interger values for r,g,b,a between 0 and 255.

dash_set(id, pattern)

Sets the dash pattern to use. Call with empty array to disable dashes.

dash_set_offset(id, offset)

The initial offset for the dash pattern.

line_cap(id, cap)

line_join(id, join)

line_width(id, width)

pixel_set(id, x, y)

Sets a pixel to the current color.

shear(id, x, y)

Updates the current matrix with a shearing angle, at the origin.

shear_about(id, sx, sy, x, y)

Updates the current matrix with a shearing angle (sx,sy), at the given point (x,y).

translate(id, x, y)

Updates the current matrix with a translation.

word_wrap(id, str, width) -> []string

@blocking

matrix_new(xx, yx, xy, yy, x0, y0) -> struct<context.Matrix>

matrix_identity() -> struct<context.Matrix>

matrix_rotate(angle) -> struct<context.Matrix>

matrix_scale(x, y) -> struct<context.Matrix>

matrix_shear(x, y) -> struct<context.Matrix>

matrix_translate(x, y) -> struct<context.Matrix>

point_cubic_bezier(x0, y0, x1, y1, x2, y2, x3, y3) -> []struct<context.Point>

point_quadratic_bezier(x0, y0, x1, y1, x2, y2) -> []struct<context.Point>

pattern_solid(color) -> struct<context.PatternSolid>

pattern_surface(id, repeat_op) -> struct<context.PatternSurface>

Images are only grabbed when the pattern is set, not when this is called.

pattern_surface_sync(id, repeat_op) -> struct<context.PatternSurfaceSync>

This does not wait for the image to be ready or idle, if the image is not loaded it will grab an empy image. This also means it is not thread safe, it is unknown what state the image will be in when grabbed. Images are also only grabbed when the pattern is set, not when this is called.

pattern_custom(fn) -> struct<context.PatternCustom>

gradient_linear(x0, y0, x1, y1) -> struct<context.PatternGradientLinear>

gradient_radial(x0, y0, r0, x1, y1, r1) -> struct<context.PatternGradientRadial>

fill_style(id, pattern)

stroke_style(id, pattern)

font_load(path, points)

• FILLRULE_WINDING
• FILLRULE_EVENODD

• LINECAP_ROUND
• LINECAP_BUTT
• LINECAP_SQUARE

• LINEJOIN_ROUND
• LINEJOIN_BEVEL

• REPEAT_BOTH
• REPEAT_X
• REPEAT_Y
• REPEAT_NONE

• ALIGN_LEFT
• ALIGN_CENTER
• ALIGN_RIGHT

• PATTERN_SOLID
• PATTERN_SURFACE
• PATTERN_SURFACE_SYNC
• PATTERN_GRADIENT_LINEAR
• PATTERN_GRADIENT_RADIAL
• PATTERN_CUSTOM