1.136.1 Instance variables

path <- closed: bool

If @on, the first and last points are connected. If the path has sub-paths (see class move_point), each of them is closed, unless move_point<-closed says otherwise.

Defaults: @off

path <-> event_area: {auto,painted,area,outline}

Which part of the path accepts mouse events:

[|](97, [117,116,111])

The interior if the path is closed or filled, as well as anything within the class variable graphical.event_tolerance of the line, so a thin line is easy to hit.

[|](112, [97,105,110,116,101,100])

Exactly what is painted: the interior if the path is filled and the line as wide as graphical<-pen. Use this for filled shapes that touch each other, such as the segments of a chart, as auto lets a shape accept events just outside it.

[|](97, [114,101,97])

The interior as determined by path<-fill_rule, whether or not the path is filled.

[|](111, [117,116,108,105,110,101])

Anything within the event tolerance of the line, ignoring the interior.

Defaults: auto

path <- fill: colour|gradient|image|{foreground,background}*

Colour, gradient or (repeated) image used to fill the interior of the path. Which parts are interior is determined by path<-fill_rule.

Defaults: @nil (not filled)

path <- fill_rule: {winding,even_odd}

Determines which parts of a path that intersects itself, or that has sub-paths, are inside. Using winding, a point is inside if the path goes around it more often in one direction than in the other. Using even_odd, a point is inside if a ray from it crosses the path an odd number of times. The difference shows for a sub-path inside another one, drawn the same way round: with even_odd it is a hole. The rule is also used by path->inside and for selecting a filled path with the mouse.

Defaults: winding

path <- interpolation: chain*

When kind is smooth, this is a chain of interpolated points. The interpolation is recomputed each time the path has been modified and needs to be painted. See also graphical->request_compute.

See also

path-kind

path <- intervals: 0..100

The number of interpolation-points between each two successive specified points.

Defaults: Resource defined (10).

path <- kind: {poly,smooth}

Determines whether the line is smooth or a collection of line-segments (poly). For smooth path objects, the number of interpolated points is determined by path<->intervals and the chain object holding all interpolated points is available in path<-interpolation.

Defaults: poly (line segments).

See also

path-interpolation

path <- mark: image*

When not @nil, each point of the path is marked using this image. Note that interpolation-points are not marked.

Defaults: @nil

path <- offset: point

Offset to origin. This offset is added to the location of the path<-points of the path if the path is painted. See also path->reference and path->relative_move.

path <- points: chain

Chain of points the line-segments goes through. The class of each point determines how the path gets there from the previous point: a straight line for a plain point, or a curve, arc or jump for a curve_point, arc_point or move_point. These are ignored for smooth paths. The send-method validates and possibly converts all members of the argument chain to be instances of class point and raises the error unexpected_type on failure. On successs, it replaces the path<-points chain of the path with the argument. The argument thus becomes a part of the path object. See also path->initialise.

path <- radius: int

Rounding radius for the corners of poly lines. Only corners between two straight segments are rounded. If the segments are too short, the radius is reduced such that each corner uses at most half of a segment.

Defaults: 0 (non-rounded corners).