GroupDocs.Viewer for Java 21.2 Release Notes

    class PdfOptions {
        /*
         * When this option enabled the output pages will have the same size
         * in pixels as page size in a source PDF document.
         * By default GroupDocs.Viewer calculates output image page size for better rendering quality.
         * Note: This option is supported when rendering into PNG or JPG formats.
         */
        void setEnableFontHinting(boolean value)
        boolean isRenderOriginalPageSize()
    }

    enum FileType {
        /*
         * Gnu Zipped File (.gz)
         */
        GZ("Gnu Zipped File", ".gz")
    
        /*
         * Gnu Zipped File (.gzip)
         */
        GZIP("Gnu Zipped File", ".gzip")
        
        /*
         * Microsoft Excel Template (.xlt)
         */
        XLT("Microsoft Excel Template", ".xlt")
        /*
         * Roshal ARchive (.rar) are compressed files generated using the RAR (WINRAR version 4) compression method.
         */
        RAR("Rar Compressed File", ".rar")
        
        /*
         * Excel 2003 XML (SpreadsheetML) represents Excel Binary File Format. 
         * Such files can be created by Microsoft Excel as well as other similar spreadsheet programs such as OpenOffice Calc or Apple Numbers.
         */
        EXCEL_2003_XML("Excel 2003 XML (SpreadsheetML)", ".xml")

        /*
         * Apple numbers represent Excel-like Binary File Format. Such files can be created by Apple numbers application.
         */
        NUMBERS("Apple numbers", ".numbers")
     
        /*
         * Maps file media type to file type e.g. 'application/pdf' will be mapped to `FileType.PDF`/>.
         * If `null` or `empty` was passed, it returns `FileType.Unknown` file type
         * @param mediaType File media type e.g. application/pdf.
         * @return corresponding media type when found, otherwise returns default `UNKNOWN` file type.
         */
        FileType fromMediaType(String mediaType)
    
        /*
         * This method now accepts `null` or `empty` string and returns `FileType.Unknown` file type instead of throwing `InvalidArgumentException`.
         */
        FileType fromExtension(String)
        /*
         * Detects file type by reading the file signature.
         * @param source The file stream.
         * @return Returns file type in case it was detected successfully otherwise returns default `FileType.Unknown` file type.
         */
        FileType fromStream(InputStream source)
        /*
         * Detects file type by reading the file signature.
         * @param source The file stream.
         * @param password The password to open the file.
         * @return Returns file type in case it was detected successfully otherwise returns default `FileType.Unknown` file type.
         */
        FileType fromStream(InputStream source, String password)
    }

    class ArchiveOptions {
        /*
         * Methods were added to display in the header. By default, the name of the source file is displayed.
         */
        FileName getFileName()
        void setFileName(FileName fileName)

        /*
         * Methods were added to specify the number of records per page (for rendering to HTML only)
         */
        int getItemsPerPage()
        void setItemsPerPage(int)
    }

    class FileName {
        /**
         * The empty filename.
         */
        static EMPTY("<empty>")
        /**
         * The name of the source file.
         */
        static SOURCE("<source>")
    
        /**
         * Initializes new instance of FileName class.
         *
         * @param fileName The name of the file.
         */
        public FileName(String fileName)
    
        /**
         * Returns a string that represents the current object.
         */
        String toString()
    }

    class Attachment {
        /*
         * Initializes new instance of attachment class.
         * @param fileName file name.
         */
        public Attachment(String fileName)
    }

    class Viewer {
        /*
         * Method was set as deprecated. And will removed in future releases. Please switch to the method that accepts Attachment as a first parameter.
         */
        void saveAttachment(String attachmentId, OutputStream destination)
        
        /*
         * Method added to save attachment file to the destination stream.
         * @param attachment The attachment.
         * @param destination The writable stream.
         */
        void saveAttachment(Attachment attachment, OutputStream destination)

        /*
        * Added new method to support checking if file is encrypted or not.
        * Returns information about file such as file-type and flag that indicates if file is encrypted.
        */
        FileInfo getFileInfo()
    }

    class CadOptions {
        /*
         * Image background color
         */
        Color getBackgroundColor()
        void setBackgroundColor(Color color)
    }

    class SpreadsheetOptions {
        /*
         * Enables headings rendering.
         */
        boolean isRenderHeadings()
        void setRenderHeadings(boolean render)

        /*
         * Initializes new instance of `SpreadsheetOptions` for rendering sheet into pages.
         * @param countRowsPerPage Rows count to include into each page.
         * @param countColumnsPerPage Columns count to include into each page.
         */
        SpreadsheetOptions forSplitSheetIntoPages(int countRowsPerPage, int countColumnsPerPage)

        /*
         * The method was added to support partial rendering of Excel spreadsheets by splitting worksheets into pages by rows and columns.
         * The columns count to include into each page when splitting worksheet into pages.
         */
        int getCountColumnsPerPage()
    }

/*
 * Contains information about file.
 */
class FileInfo {

    /*
    * The type of the file.
    */
    FileType getFileType()
    /*
     * Indicates that file is encrypted.
     */
    boolean isEncrypted()
    void setEncrypted(boolean)

    /*
    * Returns a string that represents the current object.
    */
    String toString()
}

    class HtmlViewOptions {
        /*
         * Methods were added to support rendering text files to a single page
         * Enables HTML content will be rendered to single page
         */
        boolean isRenderSinglePage()
        void setRenderSinglePage(boolean)
    }

    class WordProcessingOptions {

        /*
         * Left page margin (for HTML rendering only)
         */
        float getLeftMargin()
        void setLeftMargin(float)
    
        /*
         * Right page margin (for HTML rendering only)
         */
        float getRightMargin()
        void setRightMargin(float)
    
        /*
         * Top page margin (for HTML rendering only)
         */
        float getTopMargin()
        void setTopMargin(float)
    
        /*
         * Bottom page margin (for HTML rendering only)
         */
        float getBottomMargin()
        void setBottomMargin(float)
    }