DynaPDF.SetUseTransparency
--------------------------

Whether to use transparency color.

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

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

**MBS**( **"DynaPDF.SetUseTransparency";** /\* Whether to use transparency color. \*/  
**$PDF**; /\* The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). \*/   
**$Value**) /\* Whether to use transparency. Can be 0 to 1.e.g. 1 \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| PDF | The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). | $pdf |
| Value | Whether to use transparency. Can be 0 to 1. | 1 |

### Result

Returns OK on success or error.

### Description

Whether to use transparency color.  
The property specifies whether images should be masked with the current transparent color to make this color transparent, see also [DynaPDF.SetTransparentColor](DynaPDFSetTransparentColor.md)(). This technique is known as color key masking.  
The default transparent color is white. Please note that the color is changed to the appropriate value when changing the color space.  
Alpha based transparency can be applied with an extended graphics state that must be active before inserting an image. See CreateExtGState for further information.  
Default value = 1 (true)  
  
Requires DynaPDF Lite license.  
Default is true in DynaPDF 4 vs. false in DynaPDF 5.  
See also [SetUseTransparency](https://www.monkeybreadsoftware.com/DynaPDF-Manual/SetUseTransparency.shtml) function in DynaPDF manual.

### Examples

Don't try to apply transparency by key color:

 MBS ( "DynaPDF.SetUseTransparency"; $PDF ; 0 )  
### See also

- [DynaPDF.AddButtonImage](DynaPDFAddButtonImage.md)
- [DynaPDF.CreateExtGState](DynaPDFCreateExtGState.md)
- [DynaPDF.GetDocUsesTransparency](DynaPDFGetDocUsesTransparency.md)
- [DynaPDF.GetUsesTransparency](DynaPDFGetUsesTransparency.md)
- [DynaPDF.GetUseTransparency](DynaPDFGetUseTransparency.md)
- [DynaPDF.InsertImage](DynaPDFInsertImage.md)
- [DynaPDF.InsertImageFile](DynaPDFInsertImageFile.md)
- [DynaPDF.New](DynaPDFNew.md)
- [DynaPDF.SetSaveNewImageFormat](DynaPDFSetSaveNewImageFormat.md)
- [DynaPDF.SetTransparentColor](DynaPDFSetTransparentColor.md)

### Example Databases

- [DynaPDF/Scan with WIA to PDF](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/DynaPDF/Scan%20with%20WIA%20to%20PDF.shtml#24ScriptAnchor_)

### Blog Entries

- [Page Layouting in DynaPDF](https://www.mbsplugins.de/archive/2024-04-05/Page_Layouting_in_DynaPDF/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 14th February 2026

  
[DynaPDF.SetUseSystemFonts](DynaPDFSetUseSystemFonts.md) - [DynaPDF.SetUseVisibleCoords](DynaPDFSetUseVisibleCoords.md)

[HTML Version](DynaPDFSetUseTransparency.shtml)