Geometry

Functions
PEXPORT void PICAPI	ps_new_path (ps_context *ctx)
	Create a new empty path in the graphic context, clear the old one. More...
PEXPORT void PICAPI	ps_new_sub_path (ps_context *ctx)
	Close the current path, and add a new empty sub path in the graphic context. More...
PEXPORT void PICAPI	ps_add_sub_path (ps_context *ctx, const ps_path *path)
	Add a new sub path to current path in the graphic context. More...
PEXPORT void PICAPI	ps_set_path (ps_context *ctx, const ps_path *path)
	Replace the current path in the graphic context. More...
PEXPORT ps_bool PICAPI	ps_get_path (ps_context *ctx, ps_path *path)
	Get the current path in the graphic context. More...
PEXPORT void PICAPI	ps_close_path (ps_context *ctx)
	Close the current path in the graphic context. More...
PEXPORT void PICAPI	ps_move_to (ps_context *ctx, const ps_point *point)
	Begin a new sub path, and set the current point. More...
PEXPORT void PICAPI	ps_line_to (ps_context *ctx, const ps_point *point)
	Add a line to the current path from the current point to given point. More...
PEXPORT void PICAPI	ps_bezier_curve_to (ps_context *ctx, const ps_point *fcp, const ps_point *scp, const ps_point *ep)
	Add a cubic bezier spline to the current path from current point to end point. More...
PEXPORT void PICAPI	ps_quad_curve_to (ps_context *ctx, const ps_point *cp, const ps_point *ep)
	Add a quadratic bezier spline to the current path from current point to end point. More...
PEXPORT void PICAPI	ps_arc (ps_context *ctx, const ps_point *cp, float radius, float sangle, float eangle, ps_bool clockwise)
	Add a circular arc to the current path. More...
PEXPORT void PICAPI	ps_tangent_arc (ps_context *ctx, const ps_rect *rect, float sangle, float sweep)
	Add a circular arc which is inner tangent from a rectangle. More...
PEXPORT void PICAPI	ps_rectangle (ps_context *ctx, const ps_rect *rect)
	Add a rectangle to the current path. More...
PEXPORT void PICAPI	ps_rounded_rect (ps_context *ctx, const ps_rect *rect, float ltx, float lty, float rtx, float rty, float lbx, float lby, float rbx, float rby)
	Add a rounded rectangle to the current path. More...
PEXPORT void PICAPI	ps_ellipse (ps_context *ctx, const ps_rect *rect)
	Adds an ellipse to the current path which fits inside the specified rectangle. More...

Detailed Description

Function Documentation

ps_add_sub_path()

void ps_add_sub_path	(	ps_context *	ctx,
		const ps_path *	path
	)

Add a new sub path to current path in the graphic context.

Parameters

ctx	Pointer to an existing context object.
path	The path will be add to graphic context.

See also

ps_new_path, ps_new_sub_path, ps_set_path, ps_get_path, ps_close_path

ps_arc()

void ps_arc	(	ps_context *	ctx,
		const ps_point *	cp,
		float	radius,
		float	sangle,
		float	eangle,
		ps_bool	clockwise
	)

Add a circular arc to the current path.

Parameters

ctx	Pointer to an existing context object.
cp	The center point of the arc.
radius	The radius of the arc.
sangle	The start angle, in radians.
eangle	The end angle, in radians.
clockwise	True is clockwise, False is counter clockwise.

See also

ps_move_to, ps_line_to, ps_bezier_curve_to, ps_quad_curve_to, ps_tangent_arc, ps_rectangle, ps_rounded_rect, ps_ellipse

ps_bezier_curve_to()

void ps_bezier_curve_to	(	ps_context *	ctx,
		const ps_point *	fcp,
		const ps_point *	scp,
		const ps_point *	ep
	)

Add a cubic bezier spline to the current path from current point to end point.

Parameters

ctx	Pointer to an existing context object.
fcp	The first control point of the curve.
scp	The second control point of the curve.
ep	The end point of the curve.

See also

ps_move_to, ps_line_to, ps_quad_curve_to, ps_arc, ps_tangent_arc, ps_rectangle, ps_rounded_rect, ps_ellipse

ps_close_path()

void ps_close_path

(

ps_context *

ctx

)

Close the current path in the graphic context.

Parameters

ctx	Pointer to an existing context object.

See also

ps_new_path, ps_new_sub_path, ps_set_path, ps_get_path, ps_add_sub_path

ps_ellipse()

void ps_ellipse	(	ps_context *	ctx,
		const ps_rect *	rect
	)

Adds an ellipse to the current path which fits inside the specified rectangle.

Parameters

ctx	Pointer to an existing context object.
rect	The rectangle which the ellipse to fit in.

See also

ps_move_to, ps_line_to, ps_bezier_curve_to, ps_quad_curve_to, ps_arc, ps_tangent_arc, ps_rectangle, ps_rounded_rect

ps_get_path()

ps_bool ps_get_path	(	ps_context *	ctx,
		ps_path *	path
	)

Get the current path in the graphic context.

Parameters

ctx	Pointer to an existing context object.
path	Pointer to a object to receiving the path.

Returns

True if is success, otherwise False.

See also

ps_new_path, ps_new_sub_path, ps_close_path, ps_set_path, ps_add_sub_path

ps_line_to()

void ps_line_to	(	ps_context *	ctx,
		const ps_point *	point
	)

Add a line to the current path from the current point to given point.

Parameters

ctx	Pointer to an existing context object.
point	The point which will line to.

See also

ps_move_to, ps_bezier_curve_to, ps_quad_curve_to ps_arc, ps_tangent_arc, ps_rectangle, ps_rounded_rect, ps_ellipse

ps_move_to()

void ps_move_to	(	ps_context *	ctx,
		const ps_point *	point
	)

Begin a new sub path, and set the current point.

Parameters

ctx	Pointer to an existing context object.
point	The point which will be set.

See also

ps_line_to, ps_bezier_curve_to, ps_quad_curve_to ps_arc, ps_tangent_arc, ps_rectangle, ps_rounded_rect, ps_ellipse

ps_new_path()

void ps_new_path

(

ps_context *

ctx

)

Create a new empty path in the graphic context, clear the old one.

Parameters

ctx	Pointer to an existing context object.

See also

ps_new_sub_path, ps_set_path, ps_get_path, ps_close_path, ps_add_sub_path

ps_new_sub_path()

void ps_new_sub_path

(

ps_context *

ctx

)

Close the current path, and add a new empty sub path in the graphic context.

Parameters

ctx	Pointer to an existing context object.

See also

ps_new_path, ps_set_path, ps_get_path, ps_close_path, ps_add_sub_path

ps_quad_curve_to()

void ps_quad_curve_to	(	ps_context *	ctx,
		const ps_point *	cp,
		const ps_point *	ep
	)

Add a quadratic bezier spline to the current path from current point to end point.

Parameters

ctx	Pointer to an existing context object.
cp	The control point of the curve.
ep	The end point of the curve.

See also

ps_move_to, ps_line_to, ps_bezier_curve_to, ps_arc, ps_tangent_arc, ps_rectangle, ps_rounded_rect, ps_ellipse

ps_rectangle()

void ps_rectangle	(	ps_context *	ctx,
		const ps_rect *	rect
	)

Add a rectangle to the current path.

Parameters

ctx	Pointer to an existing context object.
rect	The rectangle which will be added.

See also

ps_move_to, ps_line_to, ps_bezier_curve_to, ps_quad_curve_to, ps_arc, ps_tangent_arc, ps_rounded_rect, ps_ellipse

ps_rounded_rect()

void ps_rounded_rect	(	ps_context *	ctx,
		const ps_rect *	rect,
		float	ltx,
		float	lty,
		float	rtx,
		float	rty,
		float	lbx,
		float	lby,
		float	rbx,
		float	rby
	)

Add a rounded rectangle to the current path.

Parameters

ctx	Pointer to an existing context object.
rect	The rectangle which will be added.
ltx	The left top horizontal radius.
lty	The left top vertical radius.
rtx	The right top horizontal radius.
rty	The right top vertical radius.
lbx	The left bottom horizontal radius.
lby	The left bottom vertical radius.
rbx	The right bottom horizontal radius.
rby	The right bottom vertical radius.

See also

ps_move_to, ps_line_to, ps_bezier_curve_to, ps_quad_curve_to, ps_arc, ps_tangent_arc, ps_rectangle, ps_ellipse

ps_set_path()

void ps_set_path	(	ps_context *	ctx,
		const ps_path *	path
	)

Replace the current path in the graphic context.

Parameters

ctx	Pointer to an existing context object.
path	The path will be set to graphic context.

See also

ps_new_path, ps_new_sub_path, ps_get_path, ps_close_path, ps_add_sub_path

ps_tangent_arc()

void ps_tangent_arc	(	ps_context *	ctx,
		const ps_rect *	rect,
		float	sangle,
		float	sweep
	)

Add a circular arc which is inner tangent from a rectangle.

Parameters

ctx	Pointer to an existing context object.
rect	The rectangle which the arc to fit in.
sangle	The start angle, in radians.
sweep	The sweep angle, in radians.

See also

ps_move_to, ps_line_to, ps_bezier_curve_to, ps_quad_curve_to, ps_arc, ps_rectangle, ps_rounded_rect, ps_ellipse