<<

Contents

Search

>>

 

LPCIRCLE

 

 

Function

 

 

Syntax:

LPCIRCLE(<Type>, <Y-Position>, <X-Position>, <Radius>, <Border Size>, <Fill>, <Red>, <Green>, <Blue> [,<Report>])

 

<Type>

= <NUM-EXPRESSION>

<Y-Position>

= <NUM-EXPRESSION>

<X-Position>

= <NUM-EXPRESSION>

<Radius>

= <NUM-EXPRESSION>

<Border Size>

= <NUM-EXPRESSION>

<Fill>

= <NUM-EXPRESSION>

<Red>

= <NUM-EXPRESSION>

<Green>

= <NUM-EXPRESSION>

<Blue>

= <NUM-EXPRESSION>

<Report>

= <NUM-EXPRESSION>

 

 

Meaning:

Draws a circle on the print document in the color <Red>,<Green>,<Blue>.

 

The switch LPGDI must be enabled.

 

<Y-Position> and <X-Position> specify the center and <Radius> specifies the radius of the circle. The parameter <Type> specifies to which measure these 3 parameters refer.

 

Type

Measure

1

TWIPS (1 TWIP = 1/20 point)

2

points

3

millimeters

otherwise

Grid coordinates

 

If <Report> <> 0 and LPCIRCLE is executed during a report, the number of the current line of the report (this is LINES + 1) is added to <Y-position>. This can be used to draw circles in the current line of a report. When a macro of a report is executed  LINES + 1 contains always the number of the current print line. However this number can change later, e.g. if at the end of the data block it has become apperent that a group change has occured.

 

With grid coordinates the radius is to be specified as a multiple of row height.

 

If <Fill> <> 0, the circle interior is filled with the color <Red>,<Green>,<Blue>.

 

LPCIRCLE returns the result –1 with DISABLE LPGDI or if an error occurred, otherwise 1.

 

Parameter:

Type

Specifies the measure for <Y-Position>,<X-Position> and <Radius>.

Y-Position

Y-coordinate of the center of the circle

X-Position

X-coordinate of the center of the circle

Radius

Radius

Border Size

Thickness of the border in TWIPS

Fill

If <Fill> <> 0, the circle interior is filled with the specified color.

Red

Red value

Green

Green value

Blue

Blue Value

Report

If <> 0 and a report is executed the number of the current line of the report (this is LINES + 1) is added to <Y-Position>.

 

Sample:

/* Grey filled circle with radius 20 millimeters with

/* center 3 cm right of and 4 cm below the upper left corner

H% = LPCIRCLE(3,40,30,20,1,192,192,192)

 

/* Draw a circle in the current report line

H% = LPCIRCLE(3,0,30,1,1,192,192,192,1)

 

See also:

LPDRAWLINE

LPDRAWRECT

LPFILLRECT

LPPOLYGON

CIRCLE