VectorImage::AddArc

Adds an arc to the VectorImage.

GSErrCode AddArc (
    short               pen,
    short               pattern,
    short               layer,
    short               drwIndex,
    double              xOrigin,
    double              yOrigin,
    double              xBegPt,
    double              yBegPt,
    double              xEndPt,
    double              yEndPt,
    double*             begAng,
    double*             endAng,
    double              r,
    double              ratio,
    double              angle
);

Parameters

pen: Pen (color and line thickness).
pattern: The lineType info.
layer: The number of the fragment (layer) the arc belongs to. Ranges from 1 to 16.
drwIndex: Index in drawing order or 0. It influences the drawing order of the arc.
xOrigin: The x coordinate of the centre of the arc in meters.
yOrigin: The y coordinate of the centre of the arc in meters.
xBegPt: The x coordinate of the beginning of the arc in meters.
yBegPt: The y coordinate of the beginning of the arc in meters.
xEndPt: The x coordinate of the ending of the arc in meters.
yEndPt: The y coordinate of the ending of the arc in meters.
BegAng: The angle of the starting point of the arc in radians.
EndAng: The angle of the ending point of the arc in radians.
r: The radius of the the ellipse/circle in meters.
ratio: If different from 1.0 the arc will elliptical instead of circular. The number is the ratio between the minor and major axis of the ellipse used to draw the arc.
angle: The declination of the major axis of the ellipse used to draw the arc. Value is disregarded if ratio equals 1.0.

Return value

If the function succeeds, the return value is NoError. If the function fails, the return value is the error code.

Description

Addition always merges the new item to the end of the primitives list but drawing order can differ from placing order.

Requirements

Version:API 10.0 or later, ModelerGraphics 8 or later

Library:ModelerGraphicsImp.lib (Win) or ModelerGraphics.framework (Mac)

Header:VectorImage.hpp