Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  


The function sets the user unit of the current open page.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
DynaPDF 3.4 Yes Yes Yes Yes Yes

MBS( "DynaPDF.SetUserUnit"; PDF; Value )


Parameter Description Example value
PDF The PDF reference returned from DynaPDF.New. $pdf
Value The new scale. 10.0


Returns OK on success or error message.


The function sets the user unit of the current open page.
A user unit is a scaling factor. The page format and all page coordinates are multiplied with this factor in a viewer application. The default size of a PDF unit is 1/72 inch. User units can be useful if the page format would be too large to be expressed in standard PDF units. The largest page format in PDF is limited to 14,400 units or 200 inches. This limit can be extended with the user unit.
The largest value that is supported is 75.0 which results in a maximum page format of 15,000 x 15,000 inches or 1,800,000 units. Note that all functions which return page coordinates or page properties do not consider the user unit.
The page format must still be in the range 3..14400 units. It is also strongly recommended to set the user unit only if necessary. This is only the case if the required page format is larger 14400 units.
Default value = 1.0

See also SetUserUnit function in DynaPDF manual.

See also

DynaPDF.SetUseVisibleCoords   -   DynaPDF.SetWMFDefExtent

Feedback: Report problem or ask question.

MBS Xojo PDF Plugins