Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

DynaPDF.RoundRectEx

The function draws a rectangle with elliptical corners.

Component Version macOS Windows Linux Server iOS SDK
DynaPDF 3.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "DynaPDF.RoundRectEx"; PDF; PosX; PosY; Width; Height; RadiusWidth; RadiusHeight; FillMode )   More

Parameters

Parameter Description Example
PDF The PDF reference returned from DynaPDF.New. $pdf
PosX X-Coordinate of rectangle $x
PosY Y-Coordinate of rectangle $y
Width Width of the rectangle $w
Height Height of the rectangle $h
RadiusWidth The radius for width. 20
RadiusHeight The radius for height. 30
FillMode Fill mode. Can be FillNoClose, StrokeNoClose, FillStrokeNoClose, Fill, Stroke, FillStroke, FillEvOdd, FillStrokeEvOdd, FillEvOddNoClose, FillStrokeEvOddNoClose, NoFill or Close. "fill"

Result

Returns OK or error.

Description

The function draws a rectangle with elliptical corners.
The parameter RadiusWidth must not be greater than the half width of the rectangle and the parameter RadiusHeight must not be greater than the half height of the rectangle.
If the coordinate system is bottom-up the point PosX, PosY defines the lower left corner of the rectangle. If the coordinate system is top-down it defines the upper left corner.
The draw direction can be changed with the function DynaPDF.SetDrawDirection.
A rectangle is a closed path that can be filled, stroked or both. It is also possible to draw a rectangle invisible to apply the filling rules nonzero winding number or even-odd. The filling rules are described under DynaPDF.ClipPath. The parameter FillMode is ignored if the rectangle is drawn inside a clipping path. The fill modes are described under DynaPDF.ClosePath.

See also RoundRectEx function in DynaPDF manual.

Examples

Draw blue round rectangle width different x/y radii:

Set Variable [ $r ; Value: MBS("DynaPDF.SetStrokeColor"; $pdf; 0; 0; 0) ]
Set Variable [ $r ; Value: MBS("DynaPDF.SetFillColor"; $pdf; 0; 0; ,8) ]
Set Variable [ $r ; Value: MBS("DynaPDF.SetLineWidth"; $pdf; 5) ]
Set Variable [ $r ; Value: MBS( "DynaPDF.RoundRectEx"; $pdf; 100; 100; 300; 200; 30; 20; "fillStroke" ) ]

Draw page number inside a round rectangle box:

# set color white to fill and light gray for frame
Set Variable [ $r ; Value: MBS( "DynaPDF.SetStrokeColor"; $pdf; ,1; ,1; ,1) ]
Set Variable [ $r ; Value: MBS( "DynaPDF.SetFillColor"; $pdf; 1; 1; 1) ]
# draw round rect with one point border
Set Variable [ $r ; Value: MBS( "DynaPDF.SetLineWidth"; $pdf; 1) ]
Set Variable [ $r ; Value: MBS( "DynaPDF.RoundRectEx"; $pdf; 50; $pageHeight - 50; $pageWidth - 100; 30; 5; 5; "FillStroke" ) ]
#
# set color black
Set Variable [ $r ; Value: MBS( "DynaPDF.SetStrokeColor"; $pdf; 0; 0; 0) ]
Set Variable [ $r ; Value: MBS( "DynaPDF.SetFillColor"; $pdf; 0; 0; 0) ]
# and write centered text
Set Variable [ $r ; Value: MBS( "DynaPDF.SetFont"; $pdf; "Helvetica"; 0; 20) ]
Set Variable [ $r ; Value: MBS( "DynaPDF.WriteFTextEx"; $pdf; 50; $pageHeight - 50; $pageWidth-100; 30; "center"; GetAsText($PageNumber) & " of " & $PageCount) ]

See also

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 13th December 2023


DynaPDF.RoundRect - DynaPDF.Save