How a page maps to pixels when it is rendered: the scale (or resolution) and an extra rotation. The page's own crop box,
Rotate and UserUnit always apply.
public sealed class RenderOptions
ISO 32000-2 §8.3.2.3 (default user space, one unit = UserUnit/72 inch), §7.7.3.3 Table 31 (Rotate,
UserUnit) and §14.11.2 (the crop box is the region displayed). GetDeviceTransform(PdfPage) maps the crop box onto a
bitmap of GetPixelSize(PdfPage) pixels whose origin is the top-left corner and whose y axis points down; any backend can
use the same mapping.
Mutable and fluent like the other options objects: set properties or chain the With* methods. Not safe to change while a render reads it.
kind:method, kind:property, kind:ctor. Press Esc to clear.DefaultDpiThe resolution of one pixel per point: 72 dots per inch, scale 1.DefaultImageSamplesPerPixelThe default of ImageSamplesPerPixel: a reduced image keeps at least 2 samples per device pixel.AntiAliasingGets or sets the kinds of painting that are anti-aliased; All by default. A kind left out paints whole pixels only.CancellationTokenGets or sets the token that cancels a render of a page: its display-list build and its drawing.ForceOutlinesGets or sets a value indicating whether every glyph is drawn from the outline the display list carries rather than by the backend's own font rendering; false by default.ImageSamplesPerPixelGets or sets the fewest decoded samples per device pixel a reduced image keeps when ScaledImageDecode is on: DefaultImageSamplesPerPixel (2) by default. 1 decodes less and renders faster, at a coarser average (35 to 48 dB against a full decode on photographs, where 2 gives 36 to 54 dB).IntentGets or sets what the render is for, which decides the annotations drawn, the optional content shown and the alternate images painted; View by default.LayersGets or sets the layers a page render draws: the content, the annotations and the form fields, in that order; All by default.OptionalContentStateGets or sets the states of the optional content groups that decide what the render shows, computed from any configuration of the document (GetStates(PdfOptionalContentConfiguration, PdfOptionalContentState?)); null, the default, for the states of the default configuration.OverprintPreviewGets or sets a value indicating whether the page is rendered with overprint preview, as a print-preview viewer shows it; false by default.ProgressGets or sets what receives a page render's progress, from 0 to 1; null, the default, for none.RegionGets or sets the part of the page to render, in default user space (the coordinates of the page's crop box), or null (the default) for the whole page.RotationGets or sets a rotation in degrees, clockwise, added to the page's own Rotate: a multiple of 90, stored as 0, 90, 180 or 270.ScaleGets or sets device pixels per unit of default user space (before UserUnit): 1 is 72 DPI, 2 is 144 DPI.ScaledImageDecodeGets or sets a value indicating whether images are decoded at the resolution they are drawn at rather than their own, for a page shown much smaller than its images; false by default.TransparentBackgroundGets or sets a value indicating whether a page render starts from transparent black instead of opaque white, so that the pixels nothing paints keep zero alpha and partly covered ones are partly transparent; false by default.GetDeviceTransform(PdfPage)Returns the transform from page's default user space to the pixels of a bitmap of GetPixelSize(PdfPage): origin at the top-left corner of the rotated crop box (or of the Region's pixels), y down, one unit = one pixel.GetPixelRectangle(PdfPage)Returns where a render of page with these options lies within a render of the whole page at the same scale and rotation: the whole page's pixels without a Region, else the pixels the region covers.GetPixelSize(PdfPage)Returns the size in pixels of page rendered with these options.WithDpi(Double)Sets Dpi.WithScale(Double)Sets Scale.