Products | Support | Email a link to this topic. | Send comments on this topic. | Back to Introduction - All Topics | Help Version 19.0.8.30
|
Leadtools.Codecs Namespace > CodecsRasterizeDocumentLoadOptions Class : Resolution Property |
public int Resolution {get; set;}
'Declaration
Public Property Resolution As Integer
'Usage
Dim instance As CodecsRasterizeDocumentLoadOptions Dim value As Integer instance.Resolution = value value = instance.Resolution
public int Resolution {get; set;}
public int getResolution() public void setResolution(int value)
<br/>get_Resolution();<br/>set_Resolution(value);<br/>Object.defineProperty('Resolution');
This class supports setting the horizontal and vertical resolutions individually (XResolution and YResolution properties respectively). In most cases, it is desirable to set both to the same value. The Resolution property provides a shortcut to do just that. Setting Resolution to a value, sets both XResolution and YResolution to the same value. Getting the value of Resolution will return the maximum of XResolution and YResolution (usually they have the same value).
The resolution controls the pixel density of the resulting raster image. For example, if you specify 8.5 by 11 inches page width and height and a resolution of 96, the resulting image will have a pixel width and height of (8.5 * 96 = 816) and (11 * 96 = 1056) pixels. This is suitable for viewing at a 100 percent zoom but when you start zooming in, the image will get pixelated. Pixelation can also occur if you send the raster image to a printer, since printers usually have much higher resolution than a screen.
If zooming in or high quality printing is a requirement in your code, then a higher resolution value must be specified, for example 300 by 300. For an 8.5 by 11 inch document, this results in a raster image size if (8.5 * 300 = 2550) and (11 * 300 = 3300) pixels. More than suitable for printing or zooming in. Keep in mind that increasing the resolution increases the memory used to hold the image data. Finding the right balance between pixel density and memory consumption depends on the application's needs.
After the RasterImage is loaded, the image resolution set in RasterImage.XResolution and RasterImage.YResolution will be the same as XResolution and YResolution.
The horizontal resolution is specified in XResolution. For most normal usage, the value of XResolution and YResolution should be equal.