Struct
GskPathBuilder
since: 4.14
Description [src]
struct GskPathBuilder {
/* No available fields */
}
GskPathBuilder is an auxiliary object for constructing
GskPath objects.
A path is constructed like this:
GskPath *
construct_path (void)
{
GskPathBuilder *builder;
builder = gsk_path_builder_new ();
// add contours to the path here
return gsk_path_builder_free_to_path (builder);
Adding contours to the path can be done in two ways.
The easiest option is to use the gsk_path_builder_add_* group
of functions that add predefined contours to the current path,
either common shapes like gsk_path_builder_add_circle()
or by adding from other paths like gsk_path_builder_add_path().
The gsk_path_builder_add_* methods always add complete contours,
and do not use or modify the current point.
The other option is to define each line and curve manually with
the gsk_path_builder_*_to group of functions. You start with
a call to gsk_path_builder_move_to() to set the starting point
and then use multiple calls to any of the drawing functions to
move the pen along the plane. Once you are done, you can call
gsk_path_builder_close() to close the path by connecting it
back with a line to the starting point.
This is similar to how paths are drawn in Cairo.
Note that GskPathBuilder will reduce the degree of added Bézier
curves as much as possible, to simplify rendering.
Available since: 4.14
Instance methods
gsk_path_builder_arc_to
Adds an elliptical arc from the current point to x2, y2
with x1, y1 determining the tangent directions.
since: 4.14
gsk_path_builder_conic_to
Adds a conic curve
from the current point to x2, y2 with the given weight and x1, y1 as the
control point.
since: 4.14
gsk_path_builder_cubic_to
Adds a cubic Bézier curve
from the current point to x3, y3 with x1, y1 and x2, y2 as the control points.
since: 4.14
gsk_path_builder_free_to_path
Creates a new GskPath from the current state of the
given builder, and unrefs the builder instance.
since: 4.14
gsk_path_builder_line_to
Draws a line from the current point to x, y and makes it
the new current point.
since: 4.14
gsk_path_builder_quad_to
Adds a quadratic Bézier curve
from the current point to x2, y2 with x1, y1 as the control point.
since: 4.14
gsk_path_builder_rel_arc_to
Adds an elliptical arc from the current point to x2, y2
with x1, y1 determining the tangent directions.
since: 4.14
gsk_path_builder_rel_conic_to
Adds a conic curve
from the current point to x2, y2 with the given weight and x1, y1 as the
control point.
since: 4.14
gsk_path_builder_rel_cubic_to
Adds a cubic Bézier curve
from the current point to x3, y3 with x1, y1 and x2, y2 as the control points.
since: 4.14
gsk_path_builder_rel_line_to
Draws a line from the current point to a point offset from it
by x, y and makes it the new current point.
since: 4.14
gsk_path_builder_rel_move_to
Starts a new contour by placing the pen at x, y
relative to the current point.
since: 4.14
gsk_path_builder_rel_quad_to
Adds a quadratic Bézier curve
from the current point to x2, y2 with x1, y1 the control point.
since: 4.14