Skip to content

IGR_Canvas_Chord

Draws a closed figure represented by the intersection of a line and an ellipse, with the current pen. The ellipse is bisected by a line that runs between X3,Y3 and X4,Y4.

Prototype

IGR_LONG IGR_Canvas_Chord(
    HCANVAS canvas,
    IGR_LONG x,
    IGR_LONG y,
    IGR_LONG x2,
    IGR_LONG y2,
    IGR_LONG x3,
    IGR_LONG y3,
    IGR_LONG x4,
    IGR_LONG y4,
    Error_Control_Block* error);

Parameters

Canvas: HCANVAS

Handle to a canvas, opened by a call to IGR_Make_Output_Canvas.

X: IGR_LONG

Left-most coordinate of the bounding box.

Y: IGR_LONG

Top-most coordinate of the bounding box.

X2: IGR_LONG

Right-most coordinate of the bounding box.

Y2: IGR_LONG

Bottom-most coordinate of the bounding box.

X3: IGR_LONG

X coordinate of the start point.

Y3: IGR_LONG

Y coordinate of the start point.

X4: IGR_LONG

X coordinate of the end point.

Y4: IGR_LONG

Y coordinate of the end point.

Error: Pointer to Error_Control_Block

Returns error details if the call fails.

Return value

Success: LONG

Returns IGR_OK.

Failure: LONG

Returns one of the possible IGR_E error codes.

Additional information

Use IGR_Canvas_Chord to a shape that is an arc and a line that joins the endpoints of the arc. The chord consists of a portion of an ellipse that is bounded by X1, Y1, X2 and Y2. The ellipse is bisected by a line that runs between X3,Y3 and X4,Y4.

Note The drawing API is available for bitmap and PDF outputs only. Drawing onto an HTML5 output is not supported.

See also