2020.1

resource()
The resource() function returns information about an image resource. This function is useful in
a Control Script, for example to check the number of pages or the page height and width before
setting it as a background (see "Control Script: Setting a Print section's background" on
page887).
This function can also be used to check if a file exists. It returns null if the file does not exist.
There is no need to explicitly check for null; a check to see if a resource exists can simply be
written as:
var info = resource(path);
if (!info) {
// File does not exist
}
resource(location, pageNumber)
location
The location should be a URL relative to the template root or an absolute file-based URL
(without protocol), e.g. "C:/myfile.pdf".
pageNumber (optional)
The desired page. Counting starts at 1. If no page number is given, information about the first
page will be retrieved.
The returned object is of the type ImageInfo. It has the following fields:
Field Type Description
height float The height of the current page (in points).
page Number Current page number (counting from 1) within the
resource.
pages Number The total number of pages in the resource.
permissions
"Permissions" on
the facing page
PDF only. Allows to verify if a PDF is password-
protected or has restrictions for printing.
Page 1365