1.117.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 polygon formed by the path's vertices. Uses the standard even-odd (ray-casting) rule with an implicit closing edge from the last vertex back to the first, 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 three vertices.

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 ->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.