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


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

Component Version macOS Windows Linux Server iOS SDK
DynaPDF 3.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "DynaPDF.SetUserUnit"; PDF; Value )   More


Parameter Description Example
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

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 18th August 2014

DynaPDF.SetUseVisibleCoords - DynaPDF.SetViewerPreferences