Insert

_InsertLineCircle, InsertCircle, InsertCircleND, InsertEllipse, InsertEllipseND, InsertLine, InsertLineND, InsertLines, InsertLinesND, InsertMarker, InsertMarkerND, InsertMarkers, InsertMarkersND, InsertPoly, InsertRectangle, InsertRectangleND

InsertCircle

Description 

 InsertCircle(
   int  StartX,
   int  StartY,
   int  Radius,
   int  Filled,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function draws a circle or a disk into the current binary image.

Parameters

int StartX

X coordinate of the center. If StartX < 0, the circle (disk) is centered.

int StartY

Y coordinate of the center. If StartY < 0, the circle (disk) is centered.

int Radius

Radius length in pixels.

int Filled

Draws circle or disk.

0

Circle

1

Disk

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertCircleND

Description 

 InsertCircleND(
   int  StartX,
   int  StartY,
   int  Radius,
   int  Filled,
   dword  ModeOperation,
   bool  CalibratedUnits,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function draws a circle or a disk into the current binary image.

Parameters

int StartX

X coordinate of the center. If StartX < 0, the circle (disk) is centered.

int StartY

Y coordinate of the center. If StartY < 0, the circle (disk) is centered.

int Radius

Radius length in pixels.

int Filled

Draws circle or disk.

0

Circle

1

Disk

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

InsertEllipse

Description 

 InsertEllipse(
   int  StartX,
   int  StartY,
   int  L_a,
   int  L_b,
   int  Angle,
   int  Filled,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function draws an ellipse into the current binary image.

Parameters

int StartX

X coordinate of the center.

int StartY

Y coordinate of the center.

int L_a

Length of the ellipse's major axis.

int L_b

Length of the ellipse's minor axis.

int Angle

Angle between the ellipse's major axis and horizontal line.

int Filled

Draws ellipse or its contour.

0

Contour

1

Filled

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertEllipseND

Description 

 InsertEllipseND(
   int  StartX,
   int  StartY,
   int  LengthA,
   int  LengthB,
   int  Angle,
   int  Filled,
   dword  ModeOperation,
   bool  CalibratedUnits,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function draws an ellipse into the current binary image.

Parameters

int StartX

X coordinate of the center.

int StartY

Y coordinate of the center.

int LengthA

Length of the ellipse's major axis.

int LengthB

Length of the ellipse's minor axis.

int Angle

Angle between the ellipse's major axis and horizontal line.

int Filled

Draws ellipse or its contour.

0

Contour

1

Filled

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

InsertLine

Description 

 InsertLine(
   int  StartX,
   int  StartY,
   int  EndX,
   int  EndY,
   int  Connectivity,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function draws a line into the current binary image.

Parameters

int StartX

X coordinate of the start point.

int StartY

Y coordinate of the start point.

int EndX

X coordinate of the end point.

int EndY

Y coordinate of the end point.

int Connectivity

Connectivity type.

4

4-connectivity line

8

8-connectivity line

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertLineND

Description 

 InsertLineND(
   int  StartX,
   int  StartY,
   int  EndX,
   int  EndY,
   int  Connectivity,
   dword  ModeOperation,
   bool  CalibratedUnits,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function draws a line into the current binary image.

Parameters

int StartX

X coordinate of the start point.

int StartY

Y coordinate of the start point.

int EndX

X coordinate of the end point.

int EndY

Y coordinate of the end point.

int Connectivity

Connectivity type.

4

4-connectivity line

8

8-connectivity line

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

InsertLines

Description 

 InsertLines(
   int  Distance,
   int  Orientation,
   int  Connectivity,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function draws a system of equidistant lines into the current binary image.

Parameters

int Distance

Distance in pixels between lines.

int Orientation

Angle from +x axis.

0

0 degrees

1

45 degrees

2

90 degrees

3

135 degrees

4

180 degrees

5

225 degrees

6

270 degrees

7

315 degrees

int Connectivity

Connectivity type.

4

4-connectivity line

8

8-connectivity line

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertLinesND

Description 

 InsertLinesND(
   int  Distance,
   int  Orientation,
   int  Connectivity,
   dword  ModeOperation,
   bool  CalibratedUnits,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function draws a system of equidistant lines into the current binary image.

Parameters

int Distance

Distance in pixels between lines.

int Orientation

Angle from +x axis.

0

0 degrees

1

45 degrees

2

90 degrees

3

135 degrees

4

180 degrees

5

225 degrees

6

270 degrees

7

315 degrees

int Connectivity

Connectivity type.

4

4-connectivity line

8

8-connectivity line

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

InsertMarker

Description 

 InsertMarker(
   int  StartX,
   int  StartY,
   int  Type,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function inserts marker to specified point into binary image or annotations.

Parameters

int StartX

X coordinate of the marker.

int StartY

Y coordinate of the marker.

int Type

Marker shape type 0-11.

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertMarkerND

Description 

 InsertMarkerND(
   int  PosX,
   int  PosY,
   int  Type,
   dword  ModeOperation,
   bool  CalibratedUnits,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function inserts marker to specified point into binary image or annotations.

Parameters

int PosX

X coordinate in [px].

int PosY

Y coordinate in [px].

int Type

Marker shape type 0-11.

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

InsertMarkers

Description 

 InsertMarkers(
   int  Distance,
   int  Type,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function inserts markers into binary image or annotations. Distance parameter is the distance between two markers.

Parameters

int Distance

Distance in pixels between lines.

int Type

Marker shape type 0-11.

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertMarkersND

Description 

 InsertMarkersND(
   int  Distance,
   int  Type,
   dword  ModeOperation,
   bool  CalibratedUnits,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function inserts markers into binary image or annotations. Distance parameter is the distance between two markers.

Parameters

int Distance

Distance in pixels between lines.

int Type

Marker shape type 0-11.

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

InsertPoly

Description 

 InsertPoly(
   int *Points,
   int  PointsNumber,
   int  Closed,
   int  Filled,
   int  Connectivity,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function draws a polygon or a polyline into the current binary image.

Parameters

int *Points

Array of points in polygon. Even indices correspond to X coordinates, odd indices correspond to Y coordinates. The size of the array must be twice as big as the number of points.

int PointsNumber

Number of points in the array.

int Closed

Closed parameter.

0

draws polyline

1

draws polygon

int Filled

1 - filled polygon

0

draws polyline

1

draws polygon

int Connectivity

Connectivity type.

4

4-connectivity line

8

8-connectivity line

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertRectangle

Description 

 InsertRectangle(
   int  StartX,
   int  StartY,
   int  Width,
   int  Height,
   int  Filled,
   dword  ModeOperation,
   bool  CalibratedUnits
);

This function draws a rectangle into the current binary image.

Parameters

int StartX

X coordinate of an upper left corner.

int StartY

Y coordinate of an upper left corner.

int Width

Image width in pixels.

int Height

Image height in pixels.

int Filled

Filled rectangle or not.

0

draws rectangle

1

draws filled rectangle

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

InsertRectangleND

Description 

 InsertRectangleND(
   int  StartX,
   int  StartY,
   int  Width,
   int  Height,
   int  Filled,
   dword  ModeOperation,
   bool  CalibratedUnits,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function draws a rectangle into the current binary image.

Parameters

int StartX

X coordinate of an upper left corner.

int StartY

Y coordinate of an upper left corner.

int Width

Image width in pixels.

int Height

Image height in pixels.

int Filled

Filled rectangle or not.

0

draws rectangle

1

draws filled rectangle

dword ModeOperation

Drawing mode.

0

COPY

1

Logical AND

2

Logical OR

3

SUBTRACT

bool CalibratedUnits

1, TRUE

The input values are considered to be the calibration units of the current document.

0, FALSE

The input values are considered to be pixels.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

_InsertLineCircle

This function runs the Binary > Insert Line, Circle, Ellipse command.

Description 

 _InsertLineCircle();

Inserts line, parallel lines, circle, filled circle, ellipse, filled ellipse, rectangle and filled rectangle into the binary image. Dialog box for specification of the mode and parameters is displayed.

See Also 
InsertLine, InsertLines, InsertEllipse, InsertRectangle