DynaPDF.GetUserUnit
-------------------

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

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [DynaPDF](component_DynaPDF.md) | [3.4](newinversion34.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "DynaPDF.GetUserUnit"; PDF ) 

**MBS**( **"DynaPDF.GetUserUnit";** /\* The function returns the user unit of the current open page. \*/  
**$PDF**) /\* The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| PDF | The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). | $pdf |

### Result

Returns OK on success or error message.

### Description

The function returns the user unit of the current open page.   
A user unit acts like 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 and the default user unit is 1.0. 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 14400 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.  
See also [GetUserUnit](https://www.monkeybreadsoftware.com/DynaPDF-Manual/GetUserUnit.shtml) function in DynaPDF manual.

### See also

- [DynaPDF.GetAscent](DynaPDFGetAscent.md)
- [DynaPDF.GetDescent](DynaPDFGetDescent.md)
- [DynaPDF.GetUserRights](DynaPDFGetUserRights.md)
- [DynaPDF.New](DynaPDFNew.md)
- [DynaPDF.SetUserUnit](DynaPDFSetUserUnit.md)

### Blog Entries

- [MBS Filemaker Plugin, version 3.4pr2](https://www.mbsplugins.de/archive/2013-08-28/MBS_Filemaker_Plugin_version_3/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

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

  
[DynaPDF.GetUserRights](DynaPDFGetUserRights.md) - [DynaPDF.GetUsesTransparency](DynaPDFGetUsesTransparency.md)

[HTML Version](DynaPDFGetUserUnit.shtml)