public class PngViewOptions extends ViewOptions implements IMaxSizeOptions
Provides options for rendering documents into PNG format.
The PngViewOptions class encapsulates additional settings and parameters that can be used to control the rendering of documents into PNG format in the GroupDocs.Viewer component.
Example usage:
PngViewOptions options = new PngViewOptions();
options.setHeight(1080);
options.setWidth(1920);
options.setRenderComments(true);
options.setRenderComments(true);
try (Viewer viewer = new Viewer("document.docx")) {
viewer.view(options);
// Use the viewer object for further operations
}
Note: The PngViewOptions class implements the IMaxSizeOptions interface to specify the maximum size of the output PNG images. For details, see this page and its children.
The factory that implements methods for creating and releasing the output page stream.
PngViewOptions()
public PngViewOptions()
Initializes new instance of PngViewOptions class.
This constructor initializes new instance of PngViewOptions with “p_{0}.png” as file path format for the output files. The output files will be placed into current working directory of the application. For the code example, see the documentation.
PngViewOptions(String filePathFormat)
public PngViewOptions(String filePathFormat)
Initializes a new instance of the PngViewOptions class.
For example, if the file path format is ‘page_{0}.png’, the output files will be named as ‘page_1.png’, ‘page_2.png’, and so on, based on the page number.
Note: It is important to note that the output files will be placed into the current working directory of the application. For the code example, see the documentation.
Parameters:
Parameter
Type
Description
filePathFormat
java.lang.String
The file path format, e.g., ‘page_{0}.png’.
PngViewOptions(Path filePathFormat)
public PngViewOptions(Path filePathFormat)
Initializes a new instance of the PngViewOptions class.
For example, if the file path format is ‘page_{0}.png’, the output files will be named as ‘page_1.png’, ‘page_2.png’, and so on, based on the page number. For the code example, see the documentation.
Parameters:
Parameter
Type
Description
filePathFormat
java.nio.file.Path
The file path format, e.g., ‘page_{0}.png’.
getMaxWidth()
public int getMaxWidth()
Returns the maximum width of an output image in pixels.
Use this property to set the maximum output image width (in pixels). For code example, see the documentation. If you set the property, this property is ignored.
Returns:
int - the maximum width of the output image.
setMaxWidth(int maxWidth)
public void setMaxWidth(int maxWidth)
Sets the maximum width of an output image in pixels.
Use this property to set the maximum output image width (in pixels). For code example, see the documentation. If you set the property, this property is ignored.
Parameters:
Parameter
Type
Description
maxWidth
int
The maximum width of the output image.
getMaxHeight()
public int getMaxHeight()
Returns the maximum height of an output image in pixels.
Use this property to set the maximum output image height (in pixels). For code example, see the documentation. If you set the property, this property is ignored.
Returns:
int - the maximum height of the output image.
setMaxHeight(int maxHeight)
public void setMaxHeight(int maxHeight)
Sets the maximum height of an output image in pixels.
Use this property to set the maximum output image height (in pixels). For code example, see the documentation. If you set the property, this property is ignored.
Parameters:
Parameter
Type
Description
maxHeight
int
The maximum height of the output image.
isExtractText()
public final boolean isExtractText()
Determines whether text extraction is enabled.
This option might be useful when you want to add a selectable text layer over the image. Use this property to get the text contained in a source document and its coordinates. Then you can use this data to add a selectable text over the image or to implement a text search in image-based rendering. For code example, see the documentation.
Returns:
boolean - true if text extraction is enabled, false otherwise.
setExtractText(boolean value)
public final void setExtractText(boolean value)
Enables or disables text extraction.
This option might be useful when you want to add a selectable text layer over the image.
Parameters:
Parameter
Type
Description
value
boolean
true to enable text extraction, false to disable it.
getWidth()
public final int getWidth()
Returns the width of the output image in pixels.
Use this property to set the output image width (in pixels). For code example, see the documentation. If you set this property, the property is ignored.
Returns:
int - the width of the output image.
setWidth(int value)
public final void setWidth(int value)
Sets the width of the output image in pixels.
Use this property to set the output image width (in pixels). For code example, see the documentation. If you set this property, the property is ignored.
Parameters:
Parameter
Type
Description
value
int
The width of the output image.
getHeight()
public final int getHeight()
Returns the height of the output image in pixels.
Use this property to set the output image height (in pixels). For code example, see the documentation. If you set this property, the property is ignored.
Returns:
int - the height of the output image.
setHeight(int value)
public final void setHeight(int value)
Sets the height of the output image in pixels.
Use this property to set the output image height (in pixels). For code example, see the documentation. If you set this property, the property is ignored.
Parameters:
Parameter
Type
Description
value
int
The height of the output image.
getDocumentSavingCallback()
public IDocumentSavingCallback getDocumentSavingCallback()
Retrieves the callback for estimating the saving progress of a document.
Returns:
com.groupdocs.viewer.domain.documents.converting.tohtml.utils.IDocumentSavingCallback - the callback to estimate the document saving progress.