4D Doc Center : SVG_PATH

Home

4D v14

SVG_PATH_ARC


SVG_PATH_ARC ( parentSVGObject ; xRadius ; yRadius ; x ; y {; rotation {; arcpath}} )

Parameter	Type	Description
parentSVGObject	SVG_Ref	Reference of path element
xRadius	Longint	Radius of ellipse on X axis
yRadius	Longint	Radius of ellipse on Y axis
x	Longint	Coordinate on X axis of destination point
y	Longint	Coordinate on Y axis of destination point
rotation	Longint	Value of rotation
arcpath	Longint	Sets the way the arc will be drawn

Description

The SVG_PATH_ARC command draws an elliptical arc, from the current point to the point (x, y), at the end of the path referenced by parentSVGObject. If parentSVGObject is not a path reference (‘path’ element), an error is generated.

The size and orientation of the ellipse are set by two radii (xRadius, yRadius) and a rotation value on the X axis that indicates the rotation of the ellipse as a whole with respect to the current coordinate system.

The optional arcpath parameter can be used to apply a combination of constraints which will determine how the arc will be drawn. The large-arc-flag constraint is used to choose (or not) the larger of the two possible arcs (greater than 180°) and the sweep-flag constraint chooses the direction it will be drawn (positive angle or negative angle).

The following values, representing the four possible combinations of the two constraints, can be passed:

0: large-arc-flag = 0, sweep-flag = 1
1: large-arc-flag = 1, sweep-flag = 0
2: large-arc-flag = 0, sweep-flag = 0
3: large-arc-flag = 1, sweep-flag = 1

When large-arc-flag is equal to 1, the larger arc is drawn (and the smaller when it is equal to 0). When sweep-flag is equal to 1, the arc is drawn at a positive angle (and at a negative angle when it is equal to 0).

The following drawing illustrates the four possible combinations:

By default, the value of arcpath is 0 (large-arc-flag=0, sweep-flag=1).

Example

See the examples for the SVG_New_path command.