1.136.2 Send methods

path ->append: point

Append a point at the end of the path. The point is specified in the graphical<-device coordinate system. path->insert may be used to insert points in the middle or prepend points.

See also

path->insert

path ->compute:

Computes graphical<-area from the path<-points and path<-interpolation from path<-points if path<-kind = smooth.

path ->delete: point

Delete a point from the path. To delete points interactively, see also path<-point.

path ->geometry: x=[int], y=[int], width=[int], height=[int]

Moves and resizes the path to fit the requested bounding-box. Paths may also be resized using path->resize.

path ->initialise: kind=[{poly,smooth}], radius_or_interval=[int], points=[chain]

The first argument specifies the path<-kind. When path<-kind equals smooth, the second argument specifies the path<-intervals. If the points arguments is supplied, the method path->points is invoked using this argument to specify the initial set of control-points.

path ->insert: point, point*

Insert a new point after the second argument. If the second argument is @nil, the point is added as the first point of the chain. For interactive editing, path<-segment may be used to find the point to insert after.

See also

path->append

path ->inside: x=int, y=int

Succeed if the point (X, Y) — in the path's graphical<-device coordinate system — lies inside the area the path encloses, as determined by path<-fill_rule. Each sub-path is implicitly closed, so path<-closed is not consulted: an open polygon can still be probed as a closed region for hit-testing purposes. For smooth paths the test is performed against the interpolated poly-line. Fails silently when the path has fewer than two points.

Companion to graphical->in_event_area, which combines this test with a near-outline distance test to make edge hits work on closed paths as well as open ones.

path ->svg_data: char_array

Replace the points of the path by the path described by SVG path data, the d attribute of an SVG <path> element. All commands (M, L, H, V, C, S, Q, T, A and Z, absolute and relative) are supported. Sets path<-kind to poly and path<-closed to whether the first sub-path is closed. Fails with a syntax error if the data is not valid.

send(P, svg_data, "M10 80 Q 52.5 10, 95 80 T 180 80").

path ->relative_move: diff=point, how=[{offset,points}]

Move the graphical relative to its current position using the X- and Y-values of point. How defines how the path is moved: by adusting its path<-offset (default) or by adjusting each of the path<-points.

path ->set_point: point=point, x=[int], y=[int]

Move a member point. The arguments are the X- and Y-coordinates in the graphical<-device’s coordinate system.