| FoxitPDFSDKforWeb v11.1.0 Archives Foxit PDF SDK for Web

Public Member Functions | List of all members
PDFDocRender Class Reference
PDFViewCtrl » renderers

The class that controls PDF document rendering. More...

Inherits Render.

## Public Member Functions
| disableDragToScroll ()
| Disables page scrolling by dragging, which can be enabled via the `enableDragToScroll()` API after being disabled. More...
| enableDragToScroll ()
| Enables page scrolling by dragging. More...
| getBoundingClientRects ()
| Get bounding client rects of visible pages. More...
| getCurrentPageIndex ()
| get current page index More...
| getCurrentViewMode ()
| Returns the current view mode instance. More...
| getHandlerDOM ()
| Get jquery object. More...
| getOffsetInfo ()
| get current pdfdoc offset info More...
| getPDFDoc ()
| getRotation ()
| Obtains the view rotation angle of current document. The result returned is one of these values: 0, 90, 180, 270. More...
| getScale ()
| Gets the current display multiple of the document. More...
| getUserPermission ()
| Gets permissions for the view's documents It's the intersection of PDFDoc::getPermissions() and initialization parameter options.customs.getDocPermissions for the pdfviewer. More...
| getViewMode ()
| Gets the current view mode instance object. More...
| getWatermarkConfig ()
| Gets the document watermark information. [Not support in Server] More...
| goToPage (index,{x=0, y=0}={}, isPDFPoint=false)
| Jump to page. More...
| renderPages (pageIndexes, scale)
| Renders the specified page. More...
| setWatermarkConfig (watermarkConfig)
| Sets the document watermark information. [Not support in Server] More...

## Detailed Description

The class that controls PDF document rendering.

## Member Function Documentation

## ◆ disableDragToScroll()

PDFDocRender::disableDragToScroll | ( |  | ) |
| inline

Disables page scrolling by dragging, which can be enabled via the `enableDragToScroll()` API after being disabled.

Returns
  void

See also
  enableDragToScroll

Since
  8.5.0

## ◆ enableDragToScroll()

PDFDocRender::enableDragToScroll | ( |  | ) |
| inline

Enables page scrolling by dragging.

Returns
  void

See also
  disableDragToScroll

Since
  8.5.0

## ◆ getBoundingClientRects()

PDFDocRender::getBoundingClientRects | ( |  | ) |
| inline

Get bounding client rects of visible pages.

Since
  7.2.0

Returns
  object[] -
  [{
  index:0,//page index
  scale:1, //zoom ratio. This value can be used in PDFPage.render() only.
  x:0,
  y:0;
  width:200,
  height:200,
  left:0,
  right:200,
  top:0,
  bottom:200
  }
  ...
  ]

## ◆ getCurrentPageIndex()

PDFDocRender::getCurrentPageIndex | ( |  | ) |
| inline

get current page index

Returns
  number -

Since
  7.2.0

## ◆ getCurrentViewMode()

PDFDocRender::getCurrentViewMode | ( |  | ) |
| inline

Returns the current view mode instance.

Returns
  IViewMode|null - Returns null if the PDF document is unready to render, otherwise an IViewMode instance.

## ◆ getHandlerDOM()

PDFDocRender::getHandlerDOM | ( |  | ) |
| inline

Get jquery object.

Returns
  HTMLElement - HTMLElement

Since
  7.3.0

## ◆ getOffsetInfo()

PDFDocRender::getOffsetInfo | ( |  | ) |
| inline

get current pdfdoc offset info

Since
  7.2.0

Returns
  Promise<{index: number, left: number, top: number, scale: number}> -
  index:current page index.
  top:The Y-axis offset in the upper-left corner of the page in the PDF coordinate.
  left: The X-axis offset in the upper-left corner of the page in the PDF coordinate.
  scale: The specific scale of the page. rotate: The specific rotate of the page.

## ◆ getPDFDoc()

PDFDocRender::getPDFDoc | ( |  | ) |
| inline

Get the PDF document object

Returns
  PDFDoc -

## ◆ getRotation()

PDFDocRender::getRotation | ( |  | ) |
| inline

Obtains the view rotation angle of current document. The result returned is one of these values: 0, 90, 180, 270.

Returns
  number

## ◆ getScale()

PDFDocRender::getScale | ( |  | ) |
| inline

Gets the current display multiple of the document.

Returns
  Promise<number | 'fitWidth' | 'fitHeight'> -

## ◆ getUserPermission()

PDFDocRender::getUserPermission | ( |  | ) |
| inline

Gets permissions for the view's documents
It's the intersection of PDFDoc::getPermissions() and initialization parameter options.customs.getDocPermissions for the pdfviewer.

Returns
  UserPermission - User access permission. Please refer to values starting from User_Permissions.print and this would be one of these values.
  function example (PDFViewer, UserPermission) {
  var pdfViewer = new PDFViewer({
  customs: {
  getDocPermissions: function (pdfDoc) {
  // All users have read-only access only
  var userPermission = new UserPermission();
  userPermission.putCannotModifyAny();
  return (userPermission).getValue();
  }
  }
  });
  ...
  var pdfDocRender = pdfViewer.getPDFDocRender();
  if (pdfDocRender) {
  pdfDocRender.getUserPermission().then(function (docViewerPermission) {
  })
  }
  }

Since
  7.1.0

## ◆ getViewMode()

PDFDocRender::getViewMode | ( |  | ) |
| inline

Gets the current view mode instance object.

Returns
  IViewMode|undefined - view mode instance object

## ◆ getWatermarkConfig()

PDFDocRender::getWatermarkConfig | ( |  | ) |
| inline

Gets the document watermark information. [Not support in Server]

Returns
  object|object[] - Document watermarking configuration.

## ◆ goToPage()

PDFDocRender::goToPage | ( |  | index,
|  |  | {x=0, y=0} = `{}`,
|  |  | isPDFPoint = `false`
| ) |  |
| inline

Jump to page.

Parameters

  index | number - page index.
  [offset] | object - The offset in the upper left corner.
  offset.x | number - The X-axis offset in the upper-left corner of the page.
  offset.y | number - The Y-axis offset in the upper-left corner of the page.
  [isPDFPoint] | boolean - If true, offset is the PDF coordinate; otherwise, the device coordinate.

Returns
  Promise<void> -

## ◆ renderPages()

PDFDocRender::renderPages | ( |  | pageIndexes,
|  |  | scale
| ) |  |
| inline

Renders the specified page.

Since
  7.2.0

Parameters

  pageIndexes | number[] - page index array. eg:[0,1]
  scale | number|'fitWidth'|'fitHeight' - scale - Greater than zero. If it's a string, you can only take these values ('fitWidth', 'fitHeight').

Returns
  Promise<void> -

## ◆ setWatermarkConfig()

PDFDocRender::setWatermarkConfig | ( |  | watermarkConfig | ) |
| inline

Sets the document watermark information. [Not support in Server]

Parameters

  watermarkConfig | object|object[] - Page watermarking configuration. * Example: [{ type:"text", content:"This is a watermark", watermarkSettings:{ position:"TopLeft", offsetX:0, offsetY:0, scaleX:1, scaleY:1, rotation:45, opacity:100 }, watermarkTextProperties:{ font:"Microsoft Yahei", fontSize:20, color:"#000000", fontStyle:"normal", lineSpace:10, alignment:"center" } }];
  watermarkConfig.type | 'text'|'image' - Specifies watermark's type. One of following values: 1."text" represents a text type watermark. 2."image" represents the image ty pe watermark.
  watermarkConfig.content | string - Specifies watermark's type. One of following values: 1.text type:<string> Text type watermark string. 2.image type:<DataURL> Image of DataURL.
  watermarkConfig.pageStart | number - The start page index. Valid range: from 0 to (pageCount - 1).
  watermarkConfig.pageEnd | number - The end page index. Valid range: from 0 to (pageCount - 1).
  [watermarkConfig.isMultiline=false] | boolean - Whether multiline watermark tiling is supported. If the 'type' is image, the larger image requires compression, which may cause distortion
  [watermarkConfig.rowSpace=0] | number - The row spacing for multiple lines of watermark. In points. The default value is 0. It will work while the parameter "watermarkConfig.isMultiline" is true.
  [watermarkConfig.columnSpace=0] | number - The column spacing for multiple lines of watermark. In points. The default value is 0. It will work while the parameter "watermarkConfig.isMultiline" is true.
  [watermarkConfig.watermarkSettings] | object - Watermark related configuration.
  [watermarkConfig.watermarkSettings.position=Position.center] | Position - Position of watermark. Default value is "Center". Available values are listed below. 1."TopLeft":Position: top left. 2."TopCenter":Position: top center. 3."TopRight":Position: top right. 4."CenterLeft":Position center left. 5."Center":Position: center. 6."CenterRight":Position: center right. 7."BottomLeft":Position: bottom left. 8."BottomCenter":Position: bottom center. 9."BottomRight":Position: bottom right. **:** This property will work while the parameter "watermarkConfig.isMultiline" is not true.
  [watermarkConfig.watermarkSettings.offsetX=0] | number - Horizontal offset.The default value is 0. It will not work while the parameter "watermarkConfig.isMultiline" is true.
  [watermarkConfig.watermarkSettings.offsetY=0] | number - Vertical offset.The default value is 0. It will not work while the parameter "watermarkConfig.isMultiline" is true.
  [watermarkConfig.watermarkSettings.scaleX=1] | number - The horizontal scale coefficient for the watermark image. This parameter affects the horizontal scaling of the watermark and does not impact row spacing. The default value is 1.
  [watermarkConfig.watermarkSettings.scaleY=1] | number - The vertical scale coefficient for the watermark image. This parameter affects the vertical scaling of the watermark and does not impact column spacing. The default value is 1.
  [watermarkConfig.watermarkSettings.rotation=45] | number - Rotation angle in degrees.The default value is 45.
  [watermarkConfig.watermarkSettings.opacity=100] | number - Opacity in percents. Valid range: from 0 to 100. 0 for fully transparent and 100 for fully opaque.The default value is 100.
  [watermarkConfig.watermarkTextProperties] | object - Unique configuration for text watermarking.
  [watermarkConfig.watermarkTextProperties.font] | string - Font Name. It should be a CSS font. The default value is "Microsoft Yahei".
  [watermarkConfig.watermarkTextProperties.fontSize=20] | number - Font size.The default value is 20.
  [watermarkConfig.watermarkTextProperties.color] | string - Font color.The default value is "#000000".
  [watermarkConfig.watermarkTextProperties.fontStyle='normal'] | 'normal'|'underline' - The default value is "normal". Available values are listed below. 1."normal":Watermark font style: normal. 2."underline":Watermark font style: with underline.
  [watermarkConfig.watermarkTextProperties.lineSpace=10] | number - Line spacing.The default value is 10.
  [watermarkConfig.watermarkTextProperties.alignment='center'] | 'left'|'center'|'right' - Alignment. The default value is "center". Available values are listed below. 1."left":Left alignment. 2."center":Center alignment. 3."right":Right alignment.

@2026 Foxit Software Incorporated. All rights reserved.