---
title: "Interface: IGetProofImagesOptions | Customer's Canvas On-Premises"
canonical: "https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/Editor.Editor.IGetProofImagesOptions/"
---

# Interface: IGetProofImagesOptions

> Parameters of rendering the preview images.

## Remarks

(Editor:class).getProofImages takes these options.

When defining the width and height, the resulting image will be proportionally resized to fit the defined rectangle. For example, if the maximum width and height are both set to `640` pixels, then a `1280 x 960` px image will be resized to `640 x 480` px. When using _mockups_, specify the size of proof images more than or equal to the preview mockup size to avoid loss of the image quality.

## Example

``` js
// Getting links to proof images.
const links = await editor.getProofImages({maxHeight: 720, maxWidth: 720, pregeneratePreviewImages: true});
// Get the links from the promise properties.
proofImageUrls = links.proofImageUrls;
```

## Properties

### maxWidth?

> `optional` **maxWidth?**: `number`

The maximum width of proof images. This value is `500` by default.

***

### maxHeight?

> `optional` **maxHeight?**: `number`

The maximum height of proof images. This value is `500` by default.

***

### pregeneratePreviewImages?

> `optional` **pregeneratePreviewImages?**: `boolean`

If `true`, this method starts generating preview images in the background when called. In this case, the resulting links to these images will be returned before the image generation is complete. If `false`, this method only returns links to these images and starts generating the preview images when a request to download them is received. The default value is `false`.

***

### generateProductProof?

> `optional` **generateProductProof?**: `boolean`

If `true`, this method renders previews of all product pages to a multi-page `PDF` file. In this case, the file format specified in `proofImageFileFormat` will be ignored. The default value is `false`.

#### Remarks

When you generate product previews in PDF files and allow your users to directly download these files using the links returned by this method, you can pass the `filename` query parameter that enables the download and customizes the resulting file name. For example, to download a `booklet.pdf` file:
 **https://example.com/api/rendering/GetProofImage/JohnWood/06047be9-78fb-4b89-98c5-8b1712ba1b51/-1_-1.pdf?filename=booklet**

***

### generateLargePreviews?

> `optional` **generateLargePreviews?**: `boolean`

If `true`, this method renders real-size proof images. If `largePreviewMaxWidth` and `largePreviewMaxHeight` are not set, then this method will take the size of the rendered surface. The default value is `false`.

***

### largePreviewMaxWidth?

> `optional` **largePreviewMaxWidth?**: `number`

The maximum width of large proof images. By default, this value is equal to the surface width.

***

### largePreviewMaxHeight?

> `optional` **largePreviewMaxHeight?**: `number`

The maximum height of large proof images. By default, this value is equal to the surface height.

***

### applyDataToVariablesOnly?

> `optional` **applyDataToVariablesOnly?**: `boolean`

if `false`, applies personalization data to any field with the specified name; if `true`, the data applies only to fields marked as variable. The default value is `false`.

***

### productProofPageIndexes?

> `optional` **productProofPageIndexes?**: `string`

Specifies the indexes of the product surfaces to be included in the output PDF file. You can specify comma-separated numbers as well as page ranges (two numbers separated by a dash "-"), in any order. Any negative values are not allowed. For multiple entries of an index, only one surface copy will be rendered to the file. By default, the resulting PDF will contain all product surfaces.

#### Example

```ts
"0,1,2,3,4"
"3,4,1,0,2" the result is equal to "0,1,2,3,4"
"1,1,2,0,0" the result is equal to "0,1,2"
"0-4"
"0-4,6,8-10,12"
```