# DrawParams Class

> Settings for rendering PDF pages as images.

- Product: Adobe PDF Library 18
- Language: Java
- Version: APDFL18.0.5PlusP2e
- HTML page: https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/DrawParams
- Version index: https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/llms.txt

```java
class DrawParams
```

**Namespace:** `com::datalogics::PDFL`

## Description

Settings for rendering PDF pages as images. This is used for rendering PDF pages to images, such as PNG or JPG files, to export to separate files or to send to a printer.

**Referenced by:** [`DrawParams`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/DrawParams.md), [`Page`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Page.md)

**Uses types:** [`CancelProc`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/CancelProc.md), [`ColorSpace`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/ColorSpace.md), [`DrawParams`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/DrawParams.md), [`Matrix`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Matrix.md), [`OptionalContentContext`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/OptionalContentContext.md), [`Rect`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Rect.md), [`RenderProgressProc`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/RenderProgressProc.md)

## Constructors

### DrawParams

```java
com.datalogics.PDFL.DrawParams.DrawParams()
```

*constructor*

Construct default DrawParams. Initializes with DeviceRGB color space, relative colorimetric render intent, no smoothing, no draw flags, and no cancel or progress callbacks.

### DrawParams

```java
com.datalogics.PDFL.DrawParams.DrawParams(DrawParams rhs)
```

*constructor*

**Parameters**

- `rhs` ([`DrawParams`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/DrawParams.md)): The DrawParams to copy from.

Copy constructor.

## Methods

### delete

```java
synchronized void com.datalogics.PDFL.DrawParams.delete(Boolean disposing)
```

*protected*

**Parameters**

- `disposing` (`Boolean`)

**Returns:** `synchronized void`

### delete

```java
synchronized void com.datalogics.PDFL.DrawParams.delete()
```

**Returns:** `synchronized void`

### finalize

```java
void com.datalogics.PDFL.DrawParams.finalize()
```

*protected*

**Returns:** `void`

### getBypassCopyPerm

```java
boolean com.datalogics.PDFL.DrawParams.getBypassCopyPerm()
```

**Returns:** `boolean`

Bypass copy permissions. Only used when drawing to a bitmap.

### getCancelProc

```java
CancelProc com.datalogics.PDFL.DrawParams.getCancelProc()
```

**Returns:** [`CancelProc`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/CancelProc.md)

The current cancel callback, or null if none is set.

Get the cancel callback for rendering operations.

### getColorSpace

```java
ColorSpace com.datalogics.PDFL.DrawParams.getColorSpace()
```

**Returns:** [`ColorSpace`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/ColorSpace.md)

The color space in which the bitmap data is represented. Must be one of DeviceGray, DeviceRGB, DeviceRGBA, DeviceCMYK, Lab, or LabA. Only used when drawing to a bitmap.

### getDestRect

```java
Rect com.datalogics.PDFL.DrawParams.getDestRect()
```

**Returns:** [`Rect`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Rect.md)

The rectangle of the bitmap in device space coordinates. Only used when drawing to a bitmap.

### getEnableBlackPointCompensation

```java
boolean com.datalogics.PDFL.DrawParams.getEnableBlackPointCompensation()
```

**Returns:** `boolean`

Enable/disable black point compensation.

### getEnableThinLineHeuristics

```java
boolean com.datalogics.PDFL.DrawParams.getEnableThinLineHeuristics()
```

**Returns:** `boolean`

Enable/disable thin line adjustments when drawing rectangles

### getFlags

```java
java.util.EnumSet< DrawFlags > com.datalogics.PDFL.DrawParams.getFlags()
```

**Returns:** `java.util.EnumSet< DrawFlags >`

Drawing flags.

### getICCProfile

```java
ColorProfile com.datalogics.PDFL.DrawParams.getICCProfile()
```

**Returns:** `ColorProfile`

The ICC Profile of the colorspace to be used for rendering, from a known value. NOTE: The ICCProfileCustomPath must not be set for this property to be used. The profile must be compatible with the ColorSpace property value, which can't be set to ICCBased either.

### getICCProfileCustomPath

```java
String com.datalogics.PDFL.DrawParams.getICCProfileCustomPath()
```

**Returns:** `String`

The ICC Profile of the colorspace to be used for rendering, from a custom file path. NOTE: The ICCProfile is ignored when this property is a non-empty string. The profile must be compatible with the ColorSpace property value, which can't be set to ICCBased either.

### getMatrix

```java
Matrix com.datalogics.PDFL.DrawParams.getMatrix()
```

**Returns:** [`Matrix`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Matrix.md)

The matrix to concatenate onto the default page matrix. Useful for converting from page to window coordinates and for scaling.

### getOptionalContentContext

```java
OptionalContentContext com.datalogics.PDFL.DrawParams.getOptionalContentContext()
```

**Returns:** [`OptionalContentContext`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/OptionalContentContext.md)

The optional content context, or NULL if using the document's default.

Get the optional-content context used for visibility state information.

### getProgressProc

```java
RenderProgressProc com.datalogics.PDFL.DrawParams.getProgressProc()
```

**Returns:** [`RenderProgressProc`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/RenderProgressProc.md)

The current progress callback, or null if none is set.

Get the progress callback for rendering operations.

### getRenderIntent

```java
RenderIntent com.datalogics.PDFL.DrawParams.getRenderIntent()
```

**Returns:** `RenderIntent`

Default rendering intent is RelColorimetric (relative colorimetric). Only used when drawing to a bitmap.

### getSmoothFlags

```java
java.util.EnumSet< SmoothFlags > com.datalogics.PDFL.DrawParams.getSmoothFlags()
```

**Returns:** `java.util.EnumSet< SmoothFlags >`

Smoothing flags. Only used when drawing to a bitmap.

### getUpdateRect

```java
Rect com.datalogics.PDFL.DrawParams.getUpdateRect()
```

**Returns:** [`Rect`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Rect.md)

The rectangle specifying the area to draw. A rectangle represented by the coordinates of its four sides. If unset (degenerate), the page's CropBox is used instead.

### setBypassCopyPerm

```java
void com.datalogics.PDFL.DrawParams.setBypassCopyPerm(boolean value)
```

**Parameters**

- `value` (`boolean`)

**Returns:** `void`

Bypass copy permissions. Only used when drawing to a bitmap.

### setCancelProc

```java
void com.datalogics.PDFL.DrawParams.setCancelProc(CancelProc cancelProc)
```

**Parameters**

- `cancelProc` ([`CancelProc`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/CancelProc.md)): The cancel callback to set, or null to clear.

**Returns:** `void`

The cancel callback for rendering operations. A CancelProc can return true to cancel the operation. May be null.

### setColorSpace

```java
void com.datalogics.PDFL.DrawParams.setColorSpace(ColorSpace colorSpace)
```

**Parameters**

- `colorSpace` ([`ColorSpace`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/ColorSpace.md))

**Returns:** `void`

The color space in which the bitmap data is represented. Must be one of DeviceGray, DeviceRGB, DeviceRGBA, DeviceCMYK, Lab, or LabA. Only used when drawing to a bitmap.

### setDestRect

```java
void com.datalogics.PDFL.DrawParams.setDestRect(Rect rect)
```

**Parameters**

- `rect` ([`Rect`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Rect.md))

**Returns:** `void`

The rectangle of the bitmap in device space coordinates. Only used when drawing to a bitmap.

### setEnableBlackPointCompensation

```java
void com.datalogics.PDFL.DrawParams.setEnableBlackPointCompensation(boolean value)
```

**Parameters**

- `value` (`boolean`)

**Returns:** `void`

Enable/disable black point compensation.

### setEnableThinLineHeuristics

```java
void com.datalogics.PDFL.DrawParams.setEnableThinLineHeuristics(boolean value)
```

**Parameters**

- `value` (`boolean`)

**Returns:** `void`

Enable/disable thin line adjustments when drawing rectangles

### setFlags

```java
void com.datalogics.PDFL.DrawParams.setFlags(java.util.EnumSet< DrawFlags > value)
```

**Parameters**

- `value` (`java.util.EnumSet< DrawFlags >`)

**Returns:** `void`

Drawing flags.

### setICCProfile

```java
void com.datalogics.PDFL.DrawParams.setICCProfile(ColorProfile colorProfile)
```

**Parameters**

- `colorProfile` (`ColorProfile`)

**Returns:** `void`

The ICC Profile of the colorspace to be used for rendering, from a known value. NOTE: The ICCProfileCustomPath must not be set for this property to be used. The profile must be compatible with the ColorSpace property value, which can't be set to ICCBased either.

### setICCProfileCustomPath

```java
void com.datalogics.PDFL.DrawParams.setICCProfileCustomPath(String colorProfilePath)
```

**Parameters**

- `colorProfilePath` (`String`)

**Returns:** `void`

The ICC Profile of the colorspace to be used for rendering, from a custom file path. NOTE: The ICCProfile is ignored when this property is a non-empty string. The profile must be compatible with the ColorSpace property value, which can't be set to ICCBased either.

### setMatrix

```java
void com.datalogics.PDFL.DrawParams.setMatrix(Matrix matrix)
```

**Parameters**

- `matrix` ([`Matrix`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Matrix.md))

**Returns:** `void`

The matrix to concatenate onto the default page matrix. Useful for converting from page to window coordinates and for scaling.

### setOptionalContentContext

```java
void com.datalogics.PDFL.DrawParams.setOptionalContentContext(OptionalContentContext context)
```

**Parameters**

- `context` ([`OptionalContentContext`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/OptionalContentContext.md)): The optional content context, or NULL for the default.

**Returns:** `void`

The optional-content context to use for visibility state information. Set to NULL to use the document's current states in the default context.

### setProgressProc

```java
void com.datalogics.PDFL.DrawParams.setProgressProc(RenderProgressProc progressProc)
```

**Parameters**

- `progressProc` ([`RenderProgressProc`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/RenderProgressProc.md)): The progress callback to set, or null to clear.

**Returns:** `void`

The progress callback for rendering operations. A RenderProgressProc receives updates regarding rendering progress. May be null.

### setRenderIntent

```java
void com.datalogics.PDFL.DrawParams.setRenderIntent(RenderIntent value)
```

**Parameters**

- `value` (`RenderIntent`)

**Returns:** `void`

Default rendering intent is RelColorimetric (relative colorimetric). Only used when drawing to a bitmap.

### setSmoothFlags

```java
void com.datalogics.PDFL.DrawParams.setSmoothFlags(java.util.EnumSet< SmoothFlags > value)
```

**Parameters**

- `value` (`java.util.EnumSet< SmoothFlags >`)

**Returns:** `void`

Smoothing flags. Only used when drawing to a bitmap.

### setUpdateRect

```java
void com.datalogics.PDFL.DrawParams.setUpdateRect(Rect rect)
```

**Parameters**

- `rect` ([`Rect`](https://docs.datalogics.com/apdfl18/Java/APDFL18.0.5PlusP2e/class/Rect.md))

**Returns:** `void`

The rectangle specifying the area to draw. A rectangle represented by the coordinates of its four sides. If unset (degenerate), the page's CropBox is used instead.