dfvifc.h

Go to the documentation of this file.

/**
 * @file    dfvifc.h
 * @brief   SBC C++ Interface
 *
 * @author  Antenna House, Inc.
 *
 * Copyright (C) 2002-2009 Antenna House, Inc. All rights reserved.
 */

#ifndef DFVIFC_H__
#define DFVIFC_H__

#ifndef __cplusplus
#error  This is a header for C++ compiler.
#endif

#include <iostream>
#include "dfvifc_c.h"   /* include common definitions */

namespace DfvInterface {

class DfvCppIfObject;

/***************************************************************
 * Event class that returns the error information in the formatting process.
 */
class DFVINTERFACE_API MessageListener
{
public:
    MessageListener() {}
    virtual ~MessageListener() {}

    /**
     * Event that returns the error information(error level, error code, error message) in the formatting process.
     *
     * errLevel     - Returns the errorlevel
     * errCode      - Returns the errorcode
     * errMessage   - Returns the errormessage
     */
    virtual void onMessage(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage) {}
    virtual void onMessageW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage) {}
};

/***************************************************************
 * Event class that returns the page number in the formatting process.
 */
class DFVINTERFACE_API DfvFormatPageListener
{
public:
    DfvFormatPageListener() {}
    virtual ~DfvFormatPageListener() {}

    /**
     * Event that returns the page number in the formatting process.
     *
     * pageNo       - Returns the page number
     */
    virtual void onFormatPage(long pageNo) {}
};

/***************************************************************
 * Server Based Converter C++ Interface Object Class
 */
class DFVINTERFACE_API DfvObj
{
private:
    DfvCppIfObject* m_pDfvObj;  /* instance of DfvObj */

public:
    /**
     * Constructor
     */
    DfvObj();

    /**
     * Destructor
     */
    virtual ~DfvObj();

    /**
     * Get instance of DfvObj
     *
     * @return  pointer to DfvObj instance.
     */
    DfvCppIfObject* getDfvObj() const { return m_pDfvObj; }

    /**
     * Get the URL of XML document you will format.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getDocumentURI(char* pVal, int size) const;
    /**
     * Get the URL of XML document you will format.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getDocumentURIW(wchar_t* pVal, int size) const;

    /**
     * Specifies the URL of XML document you will format.
     * If it is omitted or "\@STDIN" is specified, XML document is loaded from stdin.
     * The document loaded from stdin are supposed to be FO files.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the URL of XML document.
     */
    void setDocumentURI(const char* newVal);

    /**
     * Specifies the URL of XML document you will format.
     * If it is omitted or "\@STDIN" is specified, XML document is loaded from stdin.
     * The document loaded from stdin are supposed to be FO files.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the URL of XML document.
     */
    void setDocumentURIW(const wchar_t* newVal);

    /**
     * Get the path name of the output file.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getOutputFilePath(char* pVal, int size) const;
    /**
     * Get the path name of the output file.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getOutputFilePathW(wchar_t* pVal, int size) const;

    /**
     * Specifies the path name of the output file. When "\@STDOUT" is specified, it is considered as stdout.
     * If both the printer name and this property are specified, the formatted result will be stored in
     * the file by the printer driver.
     * When "\@PDF" is specified as output, the PDF is stored in the file specified by this property.
     * If the property is not specified, it is considered as stdout.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the path name of the output file.
     */
    void setOutputFilePath(const char* newVal);
    /**
     * Specifies the path name of the output file. When "\@STDOUT" is specified, it is considered as stdout.
     * If both the printer name and this property are specified, the formatted result will be stored in
     * the file by the printer driver.
     * When "\@PDF" is specified as output, the PDF is stored in the file specified by this property.
     * If the property is not specified, it is considered as stdout.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the path name of the output file.
     */
    void setOutputFilePathW(const wchar_t* newVal);

    /**
     * Get the path name of XML-format Option setting file which describes Server Based Converter options.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @param   n       Specifies to get n-th URI. 0 means first URI.
     * @return  Returns the 'pVal'.
     */
    char* getOptionFileURI(char* pVal, int size, int n=0) const;
    /**
     * Get the path name of XML-format Option setting file which describes Server Based Converter options.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @param   n       Specifies to get n-th URI. 0 means first URI.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getOptionFileURIW(wchar_t* pVal, int size, int n=0) const;

    /**
     * Specifies the path name of XML-format Option setting file which describes Server Based Converter options.
     * The set of former URIs is thrown away.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.
     */
    void setOptionFileURI(const char* newVal);
    /**
     * Specifies the path name of XML-format Option setting file which describes Server Based Converter options.
     * The set of former URIs is thrown away.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.
     */
    void setOptionFileURIW(const wchar_t* newVal);

    /**
     * Append the path name of XML-format Option setting file which describes Server Based Converter options.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.
     */
    void addOptionFileURI(const char* newVal);
    /**
     * Append the path name of XML-format Option setting file which describes Server Based Converter options.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.
     */
    void addOptionFileURIW(const wchar_t* newVal);

    /**
     * Get the number of URIs of XML-format Option setting file which describes Server Based Converter options.
     * 
     *
     * @return  Returns the number of URIs.
     */
    int getOptionFileCount() const;

    /**
     * Get the start page number of document to output.
     *
     * @return  start page number of document to output.
     */
    long getStartPage() const;

    /**
     * Specifies the start page number of document to output.
     * If the start page is omitted or the specified value is 0 or less, the start page is
     * considered from the first page.
     * If the setting is inconsistent, (for example, StartPage=5 EndPage=3) an error occurs.
     *
     * @param   newVal  start page number of output.
     */
    void setStartPage(long newVal);

    /**
     * Get the end page number of document to output.
     *
     * @return  end page number of output.
     */
    long getEndPage() const;

    /**
     * Specifies the end page number of document to output.
     * If the end page is omitted or the specified value exceeds the actual page number, the end page
     * is considered as the last page.
     * If the setting is inconsistent, (for example, StartPage=5 EndPage=3) an error occurs.
     *
     * @param   newVal  end page number of output.
     */
    void setEndPage(long newVal);

    /**
     * Effective when outputting to PDF.
     * Specifies the owner password for PDF. The password must be within 32 bytes.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the owner password.
     */
    void setPdfOwnerPassword(const char* newVal);

    /**
     * Effective when outputting to PDF.
     * Specifies the owner password for PDF. The password must be within 32 bytes.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the owner password.
     */
    void setPdfOwnerPasswordW(const wchar_t* newVal);

    /**
     * Effective when outputting to PDF.
     * Specifies the user password for PDF. The password must be within 32 bytes.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the user password.
     */
    void setPdfUserPassword(const char* newVal);

    /**
     * Effective when outputting to PDF.
     * Specifies the user password for PDF. The password must be within 32 bytes.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the user password.
     */
    void setPdfUserPasswordW(const wchar_t* newVal);

    /**
     * Effective when outputting to PDF.
     * Disables printing the PDF file.
     * 
     *
     * @param   newVal  If nonezero is specified, Disables printing the PDF file.
     */
    void setPdfNoPrinting(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables printing the PDF file.
     * 
     *
     * @return  If zero is returned, Enables printing the PDF file.
     *          If nonezero is returned, Disables printing the PDF file.
     */
    long getPdfNoPrinting() const;

    /**
     * Effective when outputting to PDF.
     * Disables making changes of the PDF file.
     * 
     *
     * @param   newVal  If nonezero is specified, Disables making changes of the PDF file.
     */
    void setPdfNoChanging(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables making changes of the PDF file.
     * 
     *
     * @return  If zero is returned, Enables making changes of the PDF file.
     *          If nonezero is returned, Disables making changes of the PDF file.
     */
    long getPdfNoChanging() const;

    /**
     * Effective when outputting to PDF.
     * Disables copying the content of the PDF file.
     * 
     *
     * @param   newVal  If nonezero is specified, Disables copying the content of the PDF file.
     */
    void setPdfNoContentCopying(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables copying the content of the PDF file.
     * 
     *
     * @return  If zero is returned, Enables copying the content of the PDF file.
     *          If nonezero is returned, Disables copying the content of the PDF file.
     */
    long getPdfNoContentCopying() const;

    /**
     * Effective when outputting to PDF.
     * Disables adding comments and form fields to the PDF file.
     * 
     *
     * @param   newVal  If nonezero is specified, Disables adding comments and form fields to the PDF file.
     */
    void setPdfNoAddingOrChangingCommnets(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables adding comments and form fields to the PDF file.
     * 
     *
     * @return  If zero is returned, Enables adding comments and form fields to the PDF file.
     *          If nonezero is returned, Disables adding comments and form fields to the PDF file.
     */
    long getPdfNoAddingOrChangingCommnets() const;

    /**
     * Effective when outputting to PDF.
     * Disables adding comments and form fields to the PDF file.
     * 
     *
     * @param   newVal  If nonezero is specified, Disables adding comments and form fields to the PDF file.
     */
    void setPdfNoAddingOrChangingComments(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables adding comments and form fields to the PDF file.
     * 
     *
     * @return  If zero is returned, Enables adding comments and form fields to the PDF file.
     *          If nonezero is returned, Disables adding comments and form fields to the PDF file.
     */
    long getPdfNoAddingOrChangingComments() const;

    /**
     * Effective when outputting to PDF.
     * Enables specifying whether the version of PDF is 1.3, 1.4 or 1.5.
     * 
     *
     * @param   newVal  Specifies the version of PDF.
     */
    void setPdfVersion(DfvPDFVERSION newVal);

    /**
     * Effective when outputting to PDF.
     * Get the version of PDF.
     * 
     *
     * @return  the version of PDF.
     */
    DfvPDFVERSION   getPdfVersion() const;

    /**
     * Effective when outputting to PDF.
     * Disables filling in of form fields and signing of the PDF file.
     * This parameter is effective only when you specify PDF1.4 or later to PDF version.
     * 
     *
     * @param   newVal  If nonezero is specified, Disables filling in of form fields and signing of the PDF file.
     */
    void setPdfNoFillForm(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables filling in of form fields and signing of the PDF file.
     * 
     *
     * @return  If zero is returned, Enables filling in of form fields and signing of the PDF file.
     *          If nonezero is returned, Disables filling in of form fields and signing of the PDF file.
     */
    long getPdfNoFillForm() const;

    /**
     * Effective when outputting to PDF.
     * Disables text access for screen reader devices of the PDF file.
     * This parameter is effective only when you specify 1.4 or later with PDF version.
     * 
     *
     * @param   newVal  If nonezero is specified, Disables text access for screen reader devices of the PDF file.
     */
    void setPdfNoAccessibility(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables text access for screen reader devices of the PDF file.
     * 
     *
     * @return  If zero is returned, Enables text access for screen reader devices of the PDF file.
     *          If nonezero is returned, Disables text access for screen reader devices of the PDF file.
     */
    long getPdfNoAccessibility() const;

    /**
     * Effective when outputting to PDF.
     * Disables inserting, deleting and rotating the PDF pages.
     * This parameter is effective only when you specify 1.4 or later with PDF version
     * 
     *
     * @param   newVal  If nonezero is specified, Disables inserting, deleting and rotating the PDF pages.
     */
    void setPdfNoAssembleDoc(long newVal);

    /**
     * Effective when outputting to PDF.
     * Get disables inserting, deleting and rotating the PDF pages.
     * 
     *
     * @return  If zero is returned, Enables inserting, deleting and rotating the PDF pages.
     *          If nonezero is returned, Disables inserting, deleting and rotating the PDF pages.
     */
    long getPdfNoAssembleDoc() const;

    /**
     * Effective when outputting to PDF.
     * Specifies the key length when encrypting the PDF file during outputting.
     * The key length can be specified as either 40 or 128 (bit).
     * This parameter is effective only when you specify PDF1.4 or later with PDF version
     * 
     *
     * @param   newVal  Specifies the key length.
     */
    void setPdfEncryptLevel(DfvPDFENCRYPTLEVEL newVal);

    /**
     * Effective when outputting to PDF.
     * Get the key length when encrypting the PDF file during outputting.
     * 
     *
     * @return  the key length.
     */
    DfvPDFENCRYPTLEVEL  getPdfEncryptLevel() const;

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to embed all embeddable fonts in PDF.
     * 
     *
     * @return  the value of whether to embed all embeddable fonts
     */
    long getPdfEmbedAllFonts() const;

    /**
     * Effective when outputting to PDF.
     * Embeds all embeddable fonts in PDF to create.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, Embeds all embeddable fonts
     */
    void setPdfEmbedAllFonts(long newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the font specified to be embedded in PDF.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  the font specified to be embedded
     */
    char* getPdfEmbedFonts(char* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Gets the font specified to be embedded in PDF.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  the font specified to be embedded
     */
    wchar_t* getPdfEmbedFontsW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Embeds the specified font in PDF to create. If you want to specify plural fonts, put commas between fonts.
     * 
     *
     * @param   newVal  fonts specified to embed
     */
    void setPdfEmbedFonts(const char* newVal);

    /**
     * Effective when outputting to PDF.
     * Embeds the specified font in PDF to create. If you want to specify plural fonts, put commas between fonts.
     * 
     *
     * @param   newVal  fonts specified to embed
     */
    void setPdfEmbedFontsW(const wchar_t* newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to issues the error when failing to embed fonts.
     * 
     *
     * @return  the value of whether to issues the error
     */
    long getPdfErrorOnEmbedFault() const;

    /**
     * Effective when outputting to PDF.
     * An error is issued in case of failing to embed fonts.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, an error is issued.
     */
    void setPdfErrorOnEmbedFault(long newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to issues the error when missing glyph.
     * 
     *
     * @return  the value of whether to issues the error
     */
    long getPdfErrorOnMissingGlyph() const;

    /**
     * Effective when outputting to PDF.
     * An error is issued in case of missing glyph.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, an error is issued.
     */
    void setPdfErrorOnMissingGlyph(long newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to print the resulting PDF file or not.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>PRALLOW_NONE    </td><td>= 0 Not Allowed</td></tr>
     *  <tr><td>PRALLOW_LOW     </td><td>= 1 Low Resolution Printing</td></tr>
     *  <tr><td>PRALLOW_HIGH    </td><td>= 2 High Resolution Printing</td></tr>
     * </table>
     *
     * @return  the value of printing allowed
     */
    DfvPDFPRINTALLOW getPdfPrintingAllowed() const;

    /**
     * Effective when outputting to PDF.
     * Spesifies whether to permit printing PDF to create with one of the following values.
     * This parameter is effective only when you specify PDF1.4 or later to PDF version (setPdfVersion).
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>PRALLOW_NONE    </td><td>= 0 Not Allowed</td></tr>
     *  <tr><td>PRALLOW_LOW     </td><td>= 1 Low Resolution Printing</td></tr>
     *  <tr><td>PRALLOW_HIGH    </td><td>= 2 High Resolution Printing</td></tr>
     * </table>
     *
     * @param   newVal  the value of printing allowed
     */
    void setPdfPrintingAllowed(DfvPDFPRINTALLOW newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of how to compress the color images embedded in PDF.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
     *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
     *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
     *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
     * </table>
     *
     * @return  the value of how raster graphics are compressed and stored
     */
    DfvPDFIMAGECOMPRESSION getPdfImageCompression() const;

    /**
     * Effective when outputting to PDF.
     * When the color image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.<BR>
     * When IMGCMPR_AUTO is selected, the process is automatically done and creates the image data according to the setting of setPdfJPEGQuality and setPdfRasterizeResolution. Whichever has the smaller compressed size, JPEG or ZLIB, is selected. <BR>
This is the setting for the color image. Spesify setPdfGrayscaleImageCompression for the grayscale image, and setPdfMonochromeImageCompression for the monochrome image.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
     *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
     *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
     *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
     * </table>
     *
     * @param   newVal  the value of how raster graphics are compressed and stored
     */
    void setPdfImageCompression(DfvPDFIMAGECOMPRESSION newVal);

    /**
     * Gets the value of the quality of JPEG format that is specified by xfo_setPdfImageCompression() stored in PDF.
     * 
     *
     * @return  the value of the quality of JPEG format
     */
    int getPdfJPEGQuality() const;

    /**
     * Effective when outputting to PDF.
     * For the color image format that can not be stored directly in PDF, specifies the image quality by the numerical value within the range of 1-100 when IMGCMPR_JPEG is specified by setPdfImageCompression. The quality becomes higher in proportion to the increase in the number; however the file size also becomes larger.<BR>
     * CAUTION:     It is not for changing the quality of a JPEG format image.<BR>
     * This is the setting for the color image. Spesify setPdfGrayscaleJPEGQuality for the grayscale image.
     * 
     *
     * @param   newVal  the value of the quality of JPEG format
     */
    void setPdfJPEGQuality(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether the text and the line art in PDF are compressed in order to make the size of PDF smaller or not.
     * 
     *
     * @return  the value of whether make the size of PDF smaller or not
     */
    long getPdfCompressContentStream() const;

    /**
     * Effective when outputting to PDF.
     * Specifies whether the text and the line art in PDF are compressed in order to make the size of PDF smaller or not.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, make the PDF compress
     */
    void setPdfCompressContentStream(long newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of how to transform external link specified by the relative address in the PDF link.
     * 
     *
     * @return  the value of how to transform external link
     */
    long getPdfUseLaunchForRelativeURI() const;

    /**
     * Effective when outputting to PDF.
     * Specifies whether the external link specified by the relative address is transformed into 'Open the file' or into 'World Wide Web link' in the PDF link properties.
     * 
     *
     * @param   newVal  If nonezero is specified, it is transformed to 'Open the file'. If zero is specified, it is transformed to 'World Wide Web link'
     */
    void setPdfUseLaunchForRelativeURI(long newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of how to convert the RGB color space (DebiceRGB) to DeviceGray.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>RGBCONV_NONE    </td><td>= 0 No Conversion</td></tr>
     *  <tr><td>RGBCONV_BLACK   </td><td>= 1 Black to DeviceGray</td></tr>
     *  <tr><td>RGBCONV_GRAY    </td><td>= 2 Gray to DeviceGray</td></tr>
     *  <tr><td>RGBCONV_ALL     </td><td>= 3 All RGB to DeviceGray</td></tr>
     * </table>
     *
     * @return  the value of how to convert
     */
    DfvPDFRGBCONVERSION getPdfRGBConversion() const;

    /**
     * Effective when outputting to PDF.
     * Specifies how to convert the RGB color space (DeviceRGB) to DeviceGray.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>RGBCONV_NONE    </td><td>= 0 No Conversion</td></tr>
     *  <tr><td>RGBCONV_BLACK   </td><td>= 1 Black to DeviceGray</td></tr>
     *  <tr><td>RGBCONV_GRAY    </td><td>= 2 Gray to DeviceGray</td></tr>
     *  <tr><td>RGBCONV_ALL     </td><td>= 3 All RGB to DeviceGray</td></tr>
     * </table>
     *
     * @param   newVal  the value of how to convert
     */
    void setPdfRGBConversion(DfvPDFRGBCONVERSION newVal);

#if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))

    /**
     * Effective when outputting to PDF.
     * Gets the value of the rasterised-resolution of the transformed raster images.
     * 
     *
     * @return  Rasterised-resolution
     */
    int getPdfRasterizeResolution() const;

    /**
     * Effective when outputting to PDF.
     * Specifies the value of the rasterised-resolution of the transformed raster images in the range from 70 to 500(dpi). SVG, EMF and WMF are drawn in PDF as vectors without being transformed to raster images.
     * This setting is effective only with Windows version.
     * 
     *
     * @param   newVal  Rasterised-resolution (70 to 500)
     */
    void setPdfRasterizeResolution(int newVal);

#endif

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to output linearize PDF or not.
     * 
     *
     * @return  the value of whether to output linearize pdf or not.
     */
    long getPdfLinearize() const;

    /**
     * Effective when outputting to PDF.
     * Specifies whether to output linearize PDF or not.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, output linearlize PDF.
     */
    void setPdfLinearize(long newVal);

#if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to sign a signature to PDF or not.
     * 
     *
     * @return  the value of whether to sign a signature to PDF or not.
     */
    long getPdfSignature() const;

    /**
     * Effective when outputting to PDF.
     * Specifies whether to sign a signature to PDF or not.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, sign a signature to PDF.
     */
    void setPdfSignature(long newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of a signature information name.
     * 
     *
     * @return  the value of a signature information name.
     */
    char* getPdfSignatureName(char* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Gets the value of a signature information name.
     * 
     *
     * @return  the value of a signature information name.
     */
    wchar_t* getPdfSignatureNameW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Sets a signature information name.
     * 
     *
     * @param   newVal  the value of a signature information name.
     */
    void setPdfSignatureName(const char* newVal);

    /**
     * Effective when outputting to PDF.
     * Sets a signature information name.
     * 
     *
     * @param   newVal  the value of a signature information name.
     */
    void setPdfSignatureNameW(const wchar_t* newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of a certificate information name.
     * 
     *
     * @return  the value of a certificate information name.
     */
    char* getPdfCertificateName(char* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Gets the value of a certificate information name.
     * 
     *
     * @return  the value of a certificate information name.
     */
    wchar_t* getPdfCertificateNameW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Sets a certificate information name.
     * 
     *
     * @param   newVal  the value of a certificate information name.
     */
    void setPdfCertificateName(const char* newVal);

    /**
     * Effective when outputting to PDF.
     * Sets a certificate information name.
     * 
     *
     * @param   newVal  the value of a certificate information name.
     */
    void setPdfCertificateNameW(const wchar_t* newVal);

#endif

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to embed all embeddable fonts
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>EMBALLFONT_PART </td><td>= 0 Specified fonts </td></tr>
     *  <tr><td>EMBALLFONT_ALL  </td><td>= 1 All fonts except Base14 fonts</td></tr>
     *  <tr><td>EMBALLFONT_BASE14   </td><td>= 2 All fonts</td></tr>
     * </table>
     *
     * @return  the value of whether to embed all embeddable fonts
     */
    DfvEMBEDALLFONT getPdfEmbedAllFontsEx(void) const;

    /**
     * Effective when outputting to PDF.
     * Specifies whether to embed the all outline data of fonts in PDF or not with one of the following values, which are True type fonts and Type1 Fonts and are embeddable in the formatted result.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>EMBALLFONT_PART </td><td>= 0 Specified fonts </td></tr>
     *  <tr><td>EMBALLFONT_ALL  </td><td>= 1 All fonts except Base14 fonts</td></tr>
     *  <tr><td>EMBALLFONT_BASE14   </td><td>= 2 All fonts</td></tr>
     * </table>
     *
     *If the value is EMBALLFONT_PART, only fonts specified in setPdfEmbedFonts are embedded. If the value is EMBALLFONT_ALL, all fonts that can be embedded except Base 14 fonts will be embedded. If the value is EMBALLFONT_BASE14, all fonts including Base 14 fonts that can be embedded will be embedded.
     *
     * @param   newVal  the value of whether to embed all embeddable fonts
     */
    void setPdfEmbedAllFontsEx(DfvEMBEDALLFONT newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of method to downsample the color image
     * 
     *
     * @return  the value of method to downsample the color image
     */
    DfvIMAGEDOWNSAMPLING getPdfImageDownSampling(void) const;

    /**
     * Effective when outputting to PDF.
     * Specifies the following either of method to downsample the color image that is put into PDF.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGDOWNSAMPLING_NONE    </td><td>= 0 No downsampling </td></tr>
     *  <tr><td>IMGDOWNSAMPLING_AVERAGE </td><td>= 1 Average downsamplin</td></tr>
     *  <tr><td>IMGDOWNSAMPLING_BICUBIC </td><td>= 2 Bicubic downsampling</td></tr>
     *  <tr><td>IMGDOWNSAMPLING_SUBSAMPLING </td><td>= 3 Subsampling</td></tr>
     * </table>
     *
     * When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by setPdfImageDownSamplingDPI will be downsampled into the resolution specified by setPdfImageDownSamplingTarget.
This is the setting for the color image. Spesify setPdfGrayscaleImageDownSampling for the grayscale image, and setPdfMonochromeImageDownSampling for the monochrome image.
     *
     * @param   newVal  the value of method to downsample the color image
     */
    void setPdfImageDownSampling(DfvIMAGEDOWNSAMPLING newVal);

    /**
     * Effective when outputting to PDF.
     * Gets resolution when the color image is downsampled.
     * 
     *
     * @return  the value of resolution.
     */
    int getPdfImageDownSamplingTarget(void) const;

    /**
     * Effective when outputting to PDF.
     * Set resolution when the color image is downsampled.
     * 
     *
     * @param   newVal  the value of resolution.
     */
    void setPdfImageDownSamplingTarget(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets resolution of the color image which performs a downsampling.
     * 
     *
     * @return  the value of resolution.
     */
    int getPdfImageDownSamplingDPI(void) const;

    /**
     * Effective when outputting to PDF.
     * Set resolution of the color image which performs a downsampling.
     * 
     *
     * @param   newVal  the value of resolution.
     */
    void setPdfImageDownSamplingDPI(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets specification whether to embed to PDF the color profile of the color image that will be embedded to PDF.
     * 
     *
     * @return  If nonezero is specified, it is embedded. If zero is specified, it is not embedded.
     */
    long getPdfPutImageColorProfile(void) const;

    /**
     * Effective when outputting to PDF.
     * Specifies whether to embed to PDF the color profile of the color image that will be embedded to PDF.
     * 
     *
     * @param   newVal  If nonezero is specified, it is embedded. If zero is specified, it is not embedded.
     */
    void setPdfPutImageColorProfile(long newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of how to compress the grayscale images embedded in PDF.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
     *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
     *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
     *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
     * </table>
     *
     * @return  the value of how raster graphics are compressed and stored
     */
    DfvPDFIMAGECOMPRESSION getPdfGrayscaleImageCompression(void) const;

    /**
     * Effective when outputting to PDF.
     * When the grayscale image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.<BR>
     * When IMGCMPR_AUTO is selected, the process is automatically done and creates the image data according to the setting of setPdfGrayscaleJPEGQuality and setPdfRasterizeResolution. Whichever has the smaller compressed size, JPEG or ZLIB, is selected. <BR>
This is the setting for the grayscale image. Spesify setPdfImageCompression for the color image, and setPdfMonochromeImageCompression for the monochrome image.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
     *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
     *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
     *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
     * </table>
     *
     * @param   newVal  the value of how raster graphics are compressed and stored
     */
    void setPdfGrayscaleImageCompression(DfvPDFIMAGECOMPRESSION newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of the quality of JPEG format that is specified by xfo_setPdfGrayscaleImageCompression stored in PDF.
     * 
     *
     * @return  the value of the quality of JPEG format
     */
    int getPdfGrayscaleJPEGQuality(void) const;

    /**
     * Effective when outputting to PDF.
     * For the grayscale image format that can not be stored directly in PDF, specifies the image quality by the numerical value within the range of 1-100 when IMGCMPR_JPEG is specified by setPdfGrayscaleImageCompression. The quality becomes higher in proportion to the increase in the number; however the file size also becomes larger.<BR>
     * CAUTION: It is not for changing the quality of a JPEG format image.<BR>
     * This is the setting for the grayscale image. Spesify setPdfJPEGQuality for the color image.
     * 
     *
     * @param   newVal  the value of the quality of JPEG format
     */
    void setPdfGrayscaleJPEGQuality(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of method to downsample the grayscale image
     * 
     *
     * @return  the value of method to downsample the grayscale image
     */
    DfvIMAGEDOWNSAMPLING getPdfGrayscaleImageDownSampling(void) const;

    /**
     * Effective when outputting to PDF.
     * Specifies the following either of method to downsample the grayscale image that is put into PDF.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGDOWNSAMPLING_NONE    </td><td>= 0 No downsampling </td></tr>
     *  <tr><td>IMGDOWNSAMPLING_AVERAGE </td><td>= 1 Average downsamplin</td></tr>
     *  <tr><td>IMGDOWNSAMPLING_BICUBIC </td><td>= 2 Bicubic downsampling</td></tr>
     *  <tr><td>IMGDOWNSAMPLING_SUBSAMPLING </td><td>= 3 Subsampling</td></tr>
     * </table>
     *
     * When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by setPdfGrayscaleImageDownSamplingDPI will be downsampled into the resolution specified by setPdfGrayscaleImageDownSamplingTarget.
This is the setting for the grayscale image. Spesify setPdfImageDownSampling for the color image, and setPdfMonochromeImageDownSampling for the monochrome image.
     *
     * @param   newVal  the value of method to downsample the grayscale image
     */
    void setPdfGrayscaleImageDownSampling(DfvIMAGEDOWNSAMPLING newVal);

    /**
     * Effective when outputting to PDF.
     * Gets resolution when the grayscale image is downsampled.
     * 
     *
     * @return  the value of resolution.
     */
    int getPdfGrayscaleImageDownSamplingTarget(void) const;

    /**
     * Effective when outputting to PDF.
     * Set resolution when the grayscale image is downsampled.
     * 
     *
     * @param   newVal  the value of resolution.
     */
    void setPdfGrayscaleImageDownSamplingTarget(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets resolution of the grayscale image which performs a downsampling.
     * 
     *
     * @return  the value of resolution.
     */
    int getPdfGrayscaleImageDownSamplingDPI(void) const;

    /**
     * Effective when outputting to PDF.
     * Set resolution of the grayscale image which performs a downsampling.
     * 
     *
     * @param   newVal  the value of resolution.
     */
    void setPdfGrayscaleImageDownSamplingDPI(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of how to compress the monochrome images embedded in PDF.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>MONOCMPR_CCITT4     </td><td>= 0 CCITTFaxDecode group 4 filter,default value</td></tr>
     *  <tr><td>MONOCMPR_CCITT3     </td><td>= 1 CCITTFaxDecode group 3 filter</td></tr>
     *  <tr><td>MONOCMPR_RUNLENGTH  </td><td>= 2 RunLengthDecode filter</td></tr>
     *  <tr><td>MONOCMPR_ZLIB       </td><td>= 3 FlateDecode filter</td></tr>
     *  <tr><td>MONOCMPR_OFF        </td><td>= 4 no filter</td></tr>
     * </table>
     *
     * @return  the value of how raster graphics are compressed and stored
     */
    DfvMONOCHROMECOMPRESSION getPdfMonochromeImageCompression(void) const;

    /**
     * Effective when outputting to PDF.
     * When the monochrome image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.<BR>
This is the setting for the monochrome image. Spesify setPdfGrayscaleImageCompression for the grayscale image, and setPdfImageCompression for the color image.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>MONOCMPR_CCITT4     </td><td>= 0 CCITTFaxDecode group 4 filter,default value</td></tr>
     *  <tr><td>MONOCMPR_CCITT3     </td><td>= 1 CCITTFaxDecode group 3 filter</td></tr>
     *  <tr><td>MONOCMPR_RUNLENGTH  </td><td>= 2 RunLengthDecode filter</td></tr>
     *  <tr><td>MONOCMPR_ZLIB       </td><td>= 3 FlateDecode filter</td></tr>
     *  <tr><td>MONOCMPR_OFF        </td><td>= 4 no filter</td></tr>
     * </table>
     *
     * @param   newVal  the value of how raster graphics are compressed and stored
     */
    void setPdfMonochromeImageCompression(DfvMONOCHROMECOMPRESSION newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of method to downsample the monochrome image
     * 
     *
     * @return  the value of method to downsample the monochrome image
     */
    DfvIMAGEDOWNSAMPLING getPdfMonochromeImageDownSampling(void) const;

    /**
     * Effective when outputting to PDF.
     * Specifies the following either of method to downsample the monochrome image that is put into PDF.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGDOWNSAMPLING_NONE    </td><td>= 0 No downsampling </td></tr>
     *  <tr><td>IMGDOWNSAMPLING_AVERAGE </td><td>= 1 Average downsamplin</td></tr>
     *  <tr><td>IMGDOWNSAMPLING_BICUBIC </td><td>= 2 Bicubic downsampling</td></tr>
     *  <tr><td>IMGDOWNSAMPLING_SUBSAMPLING </td><td>= 3 Subsampling</td></tr>
     * </table>
     *
     * When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by setPdfMonochromeImageDownSamplingDPI will be downsampled into the resolution specified by setPdfMonochromeImageDownSamplingTarget.
This is the setting for the monochrome image. Spesify setPdfImageDownSampling for the color image, and setPdfGrayscaleImageDownSampling for the grayscale image.
     *
     * @param   newVal  the value of method to downsample the monochrome image
     */
    void setPdfMonochromeImageDownSampling(DfvIMAGEDOWNSAMPLING newVal);

    /**
     * Effective when outputting to PDF.
     * Gets resolution when the monochrome image is downsampled.
     * 
     *
     * @return  the value of resolution.
     */
    int getPdfMonochromeImageDownSamplingTarget(void) const;

    /**
     * Effective when outputting to PDF.
     * Set resolution when the monochrome image is downsampled.
     * 
     *
     * @param   newVal  the value of resolution.
     */
    void setPdfMonochromeImageDownSamplingTarget(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets resolution of the monochrome image which performs a downsampling.
     * 
     *
     * @return  the value of resolution.
     */
    int getPdfMonochromeImageDownSamplingDPI(void) const;

    /**
     * Effective when outputting to PDF.
     * Set resolution of the monochrome image which performs a downsampling.
     * 
     *
     * @param   newVal  the value of resolution.
     */
    void setPdfMonochromeImageDownSamplingDPI(int newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the width of PDF to output.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the width of PDF. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getPdfOutputWidth(char* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Gets the width of PDF to output.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the width of PDF. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getPdfOutputWidthW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Scales the width of PDF to output. A value with a unit or % value can be specified as length.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
     */
    void setPdfOutputWidth(const char* newVal);

    /**
     * Effective when outputting to PDF.
     * Scales the width of PDF to output. A value with a unit or % value can be specified as length.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
     */
    void setPdfOutputWidthW(const wchar_t* newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the height of PDF to output.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the height of PDF. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getPdfOutputHeight(char* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Gets the height of PDF to output.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the height of PDF. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getPdfOutputHeightW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to PDF.
     * Scales the height of PDF to output. A value with a unit or % value can be specified as length.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
     */
    void setPdfOutputHeight(const char* newVal);

    /**
     * Effective when outputting to PDF.
     * Scales the height of PDF to output. A value with a unit or % value can be specified as length.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
     */
    void setPdfOutputHeightW(const wchar_t* newVal);

    /**
     * Effective when outputting to PDF.
     * Gets the value of whether to issue error or not when PDF/X is generating.
     * 
     *
     * @return  the value of whether to issue error.
     */
    long getPdfErrorOnPDFXFault();

    /**
     * Effective when outputting to PDF.
     * An error is not issued when PDF/X is generating.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, no error is issued.
     */
    void setPdfErrorOnPDFXFault(long newVal);

    /**
     * Effective when outputting to SVG.
     * Get the version of SVG.
     * 
     *
     * @return  the version of SVG.
     */
    DfvSVGVERSION   getSvgVersion() const;

    /**
     * Effective when outputting to SVG.
     * Enables specifying whether the version of SVG is 1.1, Basic or Tiny.
     * 
     *
     * @param   newVal  Specifies the version of SVG.
     */
    void setSvgVersion(DfvSVGVERSION newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the setting indicating whether to compress the outputted SVG into gzip format or not.
     * 
     *
     * @return  whether gzip compression or not.
     */
    long getSvgGzipCompression() const;

    /**
     * Effective when outputting to SVG.
     * Specifies whether to compress the outputted SVG into gzip format or not.
     * 
     *
     * @param   newVal      If the value is 'true' is specified, enables to compress data into gzip format.
     */
    void setSvgGzipCompression(long newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the setting indicating whether to embed fonts in the outputted SVG.
     * 
     *
     * @return  whether embeds fonts or not.
     */
    long getSvgEmbedAllFonts() const;

    /**
     * Effective when outputting to SVG.
     * Specifies whether to embed fonts in the outputted SVG.
     * 
     *
     * @param   newVal      If the value is 'true' is specified, embeds fonts.
     */
    void setSvgEmbedAllFonts(long newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the format for naming files when the outputted SVG becomes multiple.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getSvgFormat(char* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * Gets the format for naming files when the outputted SVG becomes multiple.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getSvgFormatW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * Specifies the format for naming files when the outputted SVG becomes multiple.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the SVG file name format.
     */
    void setSvgFormat(const char* newVal);

    /**
     * Effective when outputting to SVG.
     * Specifies the format for naming files when the outputted SVG becomes multiple.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the SVG file name format.
     */
    void setSvgFormatW(const wchar_t* newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the font specified to be embedded in SVG.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the fontnames. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getSvgEmbedFonts(char* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * Gets the font specified to be embedded in SVG.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the fontnames. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getSvgEmbedFontsW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * Embeds the specified font in SVG to create. If you want to specify plural fonts, put commas between fonts.
     * 
     *
     * @param   newVal  fonts specified to embed
     */
    void setSvgEmbedFonts(const char* newVal);

    /**
     * Effective when outputting to SVG.
     * Embeds the specified font in SVG to create. If you want to specify plural fonts, put commas between fonts.
     * 
     *
     * @param   newVal  fonts specified to embed
     */
    void setSvgEmbedFontsW(const wchar_t* newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the value of whether to issues the error when failing to embed fonts.
     * 
     *
     * @return  the value of whether to issues the error
     */
    long getSvgErrorOnEmbedFault() const;

    /**
     * Effective when outputting to SVG.
     * An error is issued in case of failing to embed fonts.
     * 
     *
     * @param   newVal  If the value is 'true' is specified, an error is issued.
     */
    void setSvgErrorOnEmbedFault(long newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the value of how to compress the images embedded in SVG.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto conversion</td></tr>
     *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG conversion</td></tr>
     *  <tr><td>IMGCMPR_PNG     </td><td>= 2 PNG conversion</td></tr>
     * </table>
     *
     * @return  the value of how raster graphics are compressed and stored
     */
    DfvIMAGECONVERSION getSvgImageConversion() const;

    /**
     * Effective when outputting to SVG.
     * Selects how to compress the images embedded in SVG to create from the following.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto conversion</td></tr>
     *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG conversion</td></tr>
     *  <tr><td>IMGCMPR_PNG     </td><td>= 2 PNG conversion</td></tr>
     * </table>
     *
     * @param   newVal  the value of how raster graphics are compressed and stored
     */
    void setSvgImageConversion(DfvIMAGECONVERSION newVal);

    /**
     * Gets the value of the quality of JPEG format that is specified by setSvgImageConversion() stored in SVG.
     * 
     *
     * @return  the value of the quality
     */
    int getSvgJPEGQuality() const;

    /**
     * Effective when outputting to SVG.
     * Specifies the quality of the Raster graphics when stored in JPEG format using the range of 1-100.
     * The quality becomes higher in proportion to the increase in the number; however the file size also becomes larger.
     * The initial value is 80.
     * 
     *
     * @param   newVal  JPEG quality (1 to 100)
     */
    void setSvgJPEGQuality(int newVal);

    /**
     * Effective when outputting to SVG.
     * Gets specification how to treat the referred image.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGPT_EMBED_ALL </td><td>= 0 Embeds all images to SVG.</td></tr>
     *  <tr><td>IMGPT_COPY_ALL  </td><td>= 1 Copies all image files to the destination that is specified by setSvgImageCopyPath, and then links.</td></tr>
     *  <tr><td>IMGPT_LINK      </td><td>= 2 Links images that have been linked, and embeds the embedded image. However, the raster images other than JPEG and PNG are always embedded.</td></tr>
     *  <tr><td>IMGPT_COPY      </td><td>= 3 Copies images that have been linked to the destination that is specified by setSvgImageCopyPath, and links. The embedded image are embedded.</td></tr>
     * </table>
     *
     * @return  specification how to treat the referred image.
     */
    DfvIMAGEPROCTYPE getSvgImageProcessingType() const;

    /**
     * Effective when outputting to SVG.
     * Specifies how to treat the referred image.
     * 
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>IMGPT_EMBED_ALL </td><td>= 0 Embeds all images to SVG.</td></tr>
     *  <tr><td>IMGPT_COPY_ALL  </td><td>= 1 Copies all image files to the destination that is specified by setSvgImageCopyPath, and then links.</td></tr>
     *  <tr><td>IMGPT_LINK      </td><td>= 2 Links images that have been linked, and embeds the embedded image. However, the raster images other than JPEG and PNG are always embedded.</td></tr>
     *  <tr><td>IMGPT_COPY      </td><td>= 3 Copies images that have been linked to the destination that is specified by setSvgImageCopyPath, and links. The embedded image are embedded.</td></tr>
     * </table>
     *
     * @param   newVal  specification how to treat the referred image.
     */
    void setSvgImageProcessingType(DfvIMAGEPROCTYPE newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by setSvgImageProcessingType.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the image copy path. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getSvgImageCopyPath(char* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * Specifies the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by setSvgImageProcessingType.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as image copy path
     */
    void setSvgImageCopyPath(const char* newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by setSvgImageProcessingType.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the image copy path. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getSvgImageCopyPathW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * Specifies the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by setSvgImageProcessingType.
     * 
     *
     * @param   newVal  Pointer to a null-terminated string to be used as image copy path
     */
    void setSvgImageCopyPathW(const wchar_t* newVal);

    /**
     * Effective when outputting to SVG.
     * Gets specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages. <BR>
     * 
     *
     * @return  specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages.
     */
    long getSvgSingleFile() const;

    /**
     * Effective when outputting to SVG.
     * Specifies whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages. <BR>
     * If the value is true, outputs one SVG. If the value is false, outputs multiple SVG. When multiple SVG is output, the file name is modified by specifying format. <BR>
     * Effective only when outputting to the file. It is invalid in the output without the file name like the stream etc.
     * 
     *
     * @param   newVal  specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages.
     */
    void setSvgSingleFile(long newVal);

#if !defined(_DOXYGEN)
    /**
     * Gets the value specified by setSvgSingleFileMaxPages.
     * Effective when outputting to SVG. 
     *
     * @return  the value specified by setSvgSingleFileMaxPages.
     */
    int getSvgSingleFileMaxPages() const;

    /**
     * Specifies the maximum number of pages outputted when setSvgSingleFile = True is specified. .
     * When this parameter is omitted If this parameter is omitted, "5000" is considered as specified.
     * When either setSvgSingleFileMaxPages or setSvgSingleFileMaxHeight is specified, or both are specified, and the page exceeds either the maximum size (setSvgSingleFileMaxHeight) or the maximum number of pages (setSvgSingleFileMaxPages), Server Based Converter V1.2 will stop converting and abort the job as an error. Effective when outputting to SVG. 
     * 
     * @param   newVal  maximum number of pages 
     */
    void setSvgSingleFileMaxPages(int newVal);

    /**
     * Gets the value specified by setSvgImageDownsamplingDPI.
     * Effective when outputting to SVG. 
     * 
     * @return  the value specified by setSvgImageDownsamplingDPI. 
     */
    int getSvgImageDownsamplingDPI() const;

    /**
     * Specifies the resolution of the down sampling when embedding an image with 1 or more integers. .
     * When the resolution of the original image is lower than specification, it's embedded with the lower resolution. Effective when outputting to SVG. 
     * 
     * @return  newVal  the resolution of the down sampling 
     */
    void setSvgImageDownsamplingDPI(int dpi);

    /**
     * Gets the value specified by setSvgImageDownsamplingMethod.
     * Effective when outputting to SVG. 
     * 
     * @return  the value specified by setSvgImageDownsamplingMethod
     */
    int getSvgImageDownsamplingMethod() const;

    /**
     * Specifies the way of compression when down sampled.
     * 
     * S_SVG_IMGDOWNSAMPLING_AVERAGE : biliner 
     * S_SVG_IMGDOWNSAMPLING_BICUBIC : bicubic 
     * S_SVG_IMGDOWNSAMPLING_SUBSAMPLING : nearest neighbor
     * If this parameter is omitted, "IMGDOWNSAMPLING_AVERAGE" is considered as specified. Effective when outputting to SVG. 
     * 
     * @param   type    the way of compression when down sampled 
     */
    void setSvgImageDownsamplingMethod(int type);
#endif

    /**
     * Effective when outputting to SVG.
     * Gets specification whether to rename all file name to prefix specified by setSvgImagePrefix, or use original name.
     * 
     *
     * @return  specification whether to rename all file name to prefix specified by setSvgImagePrefix, or use original name.
     */
    long getSvgImageRename() const;

    /**
     * Effective when outputting to SVG.
     * When images are copied to the directory specified by setSvgImageCopyPath etc. and processed, specifies whether to rename all file name to prefix specified by setSvgImagePrefix, or use original name. When the file name overlaps, sequential number is added. When true is specified, all files are renamed.
     * 
     *
     * @param   newVal  specification whether to rename all file name to prefix specified by xfo_setSvgImagePrefix, or use original nam
     */
    void setSvgImageRename(long newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the prefix of the file name when images are copied to the directory specified by setSvgImageCopyPath and processed.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the prefix. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getSvgImagePrefix(char* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * When images are copied to the directory specified by setSvgImageCopyPath and processed, specifies the prefix of the file name. The file name will be prefix with sequence numbers. Default is empty character string with only sequential numbers.
     * 
     *
     * @param   newVal  the prefix of the file name.
     */
    void setSvgImagePrefix(const char* newVal);

    /**
     * Effective when outputting to SVG.
     * Gets the prefix of the file name when images are copied to the directory specified by setSvgImageCopyPath and processed.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the prefix. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getSvgImagePrefixW(wchar_t* pVal, int size) const;

    /**
     * Effective when outputting to SVG.
     * When images are copied to the directory specified by setSvgImageCopyPath and processed, specifies the prefix of the file name. The file name will be prefix with sequence numbers. Default is empty character string with only sequential numbers.
     * 
     *
     * @param   newVal  the prefix of the file name.
     */
    void setSvgImagePrefixW(const wchar_t* newVal);

    /**
     * Effective when outputting to SVG.
     * Gets specification whether to add sequential number to the output SVG even if it has only one-page.
     * 
     *
     * @return  specification whether to add sequential number to the output SVG even if it has only one-page.
     */
    long getSvgSinglePageNumber() const;

    /**
     * Effective when outputting to SVG.
     * When xfo_setSvgSingleFile = 0 is specified, specifies whether to add sequential number to the output SVG even if it has only one-page. It is not added in case of false.
     * 
     *
     * @param   newVal  specification whether to add sequential number to the output SVG even if it has only one-page.
     */
    void setSvgSinglePageNumber(long newVal);


#if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
    /**
     * Effective when outputting to SVG.
     * Gets the value of the rasterised-resolution of the transformed raster images.
     * 
     *
     * @return  Rasterised-resolution
     */
    int getSvgRasterizeResolution() const;

    /**
     * Effective when outputting to SVG.
     * Specifies the value of the rasterised-resolution of the transformed raster images in the range from 70 to 500(dpi). SVG, EMF and WMF are drawn in SVG as vectors without being transformed to raster images.
     * This setting is effective only with Windows version.
     * 
     *
     * @param   newVal  Rasterised-resolution (70 to 500)
     */
    void setSvgRasterizeResolution(int newVal);
#endif

    /**
     * Get the error level to abort formatting process.
     *
     * @return  Returns the error level.
     */
    DfvIfErrorLevel getExitLevel() const;

    /**
     * Error level to abort formatting process. Server Based Converter will stop formatting when the detected
     * error level is equal to ExitLevel property or higher. The default value is 2 (Warning).
     * Thus if an error occurred and error level is 2 (Warning) or higher, formatting process will be
     * aborted. Please use the value from 1 to 4. When the value of 5 or more specified, it is considered
     * to be the value of 4. If a error-level:4 (fatal error) occurs, the formatting process will be
     * aborted unconditionally.
     * BTW : An error is not displayed no matter what value may be specified to be this property.
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>ELVL_INFORMATION    </td><td>= 1 Information</td></tr>
     *  <tr><td>ELVL_WARNING        </td><td>= 2 Warning</td></tr>
     *  <tr><td>ELVL_RECOVERABLE    </td><td>= 3 Recoveable Error</td></tr>
     *  <tr><td>ELVL_FATAL          </td><td>= 4 Fatal Error</td></tr>
     * </table>
     *
     * @param   newVal  error level to abort formatting process.
     */
    void setExitLevel(DfvIfErrorLevel newVal);

    /**
     * Returns the error level of the error that occurred during the formatting process.
     *
     * <table border="0" cellspacing="0" cellpadding="0">
     *  <tr><td>ELVL_INFORMATION    </td><td>= 1 Information</td></tr>
     *  <tr><td>ELVL_WARNING        </td><td>= 2 Warning</td></tr>
     *  <tr><td>ELVL_RECOVERABLE    </td><td>= 3 Recoveable Error</td></tr>
     *  <tr><td>ELVL_FATAL          </td><td>= 4 Fatal Error</td></tr>
     * </table>
     *
     * @return  Returns the error level.
     */
    DfvIfErrorLevel getErrorLevel() const;

    /**
     * Returns the error code of the error that occurred during the formatting process.
     * Zero means no error. Non-zero indicates any error occurred.
     *
     * @return  Returns the error code.
     */
    DfvIfErrorCode getErrorCode() const;

    /**
     * Returns the error message of the error that occurred during the formatting process.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getErrorMessage(char* pVal, int size) const;
    /**
     * Returns the error message of the error that occurred during the formatting process.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getErrorMessageW(wchar_t* pVal, int size) const;

    /**
     * Sets the substitution of font name. This substitution acts on the font names existing in FO.
     * The font name 'fontName' is replaced to 'aliasName'.
     *
     * @param   src     Specifies the font name which is replaced.
     * @param   dst     Specifies the aliasName.
     */
    void setFontAlias(const char* src, const char* dst);
    /**
     * Sets the substitution of font name. This substitution acts on the font names existing in FO.
     * The font name 'fontName' is replaced to 'aliasName'.
     *
     * @param   src     Specifies the font name which is replaced.
     * @param   dst     Specifies the aliasName.
     */
    void setFontAliasW(const wchar_t* src, const wchar_t* dst);

    /**
     * Clear all substitutions of font name.
     *
     */
    void clearFontAlias();

    /**
     * Erase the substitution of font name 'fontName'.
     *
     * @param   src Specifies the font name which is replaced.
     */
    void eraseFontAlias(const char* src);
    /**
     * Erase the substitution of font name 'fontName'.
     *
     * @param   src Specifies the font name which is replaced.
     */
    void eraseFontAliasW(const wchar_t* src);

    /**
     * Execute formatting and output to a PDF specified in OutputFilePath or printer specified in PrinterName.
     *
     * @param   bNoThrow
     * If the value of 'false' is specified, throws XfoException.<BR>
     * If the value of 'true' is specified, returns the error code.
     * @return  Returns the error code. Zero means no error. Non-zero indicates any error occurred.
     */
    DfvIfErrorCode execute(bool bNoThrow=false);

    /**
     * Initialize formatting engine.
     *
     */
    void clear();

    /**
     * Register the MessageListener interface to the instance of implemented class
     * The error that occurred during the formatting process can be received as the event.
     *
     * @param   listener Pointer of the MessageListener instance.
     */
    void setMessageListener(MessageListener* listener);

    /**
     * Register the DfvFormatPageListener interface to the instance of implemented class
     * The page number that formatted during the formatting process can be received as the event.
     *
     * @param   listener Pointer of the DfvFormatPageListener instance.
     */
    void setFormatPageListener(DfvFormatPageListener* listener);

    /**
     * Get the printer name where the formatted result is outputted.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getPrinterName(char* pVal, int size) const;
    /**
     * Get the printer name where the formatted result is outputted.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getPrinterNameW(wchar_t* pVal, int size) const;

    /**
     * Specifies the output format or the printer name to output.
     * When a printer name is specified, the formatted result is outputted to that printer.
     * When "\@STDPRN" is specified, the formatted result is outputted to the currently used printer.
     * When "\@PDF" is specified, the formatted result is outputted to PDF.
     * When "\@SVG" is specified, the formatted result is outputted to SVG.
     * When "\@PS" is specified, the formatted result is outputted to PostScript.
     * When "\@INX" is specified, the formatted result is outputted to INX.
     * When "\@MIF" is specified, the formatted result is outputted to MIF.
     * When "\@TEXT" is specified, the formatted result is outputted to a text format file.
     * When "\@AreaTree" is specified, the AreaTree will be outputted.
     * When omitted, it is considered as "\@PDF" was specified.
     * It's impossible to output to the printer with any OS's other than Windows.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the printer name.
     */
    void setPrinterName(const char* newVal);
    /**
     * Specifies the output format or the printer name to output.
     * When a printer name is specified, the formatted result is outputted to that printer.
     * When "\@STDPRN" is specified, the formatted result is outputted to the currently used printer.
     * When "\@PDF" is specified, the formatted result is outputted to PDF.
     * When "\@SVG" is specified, the formatted result is outputted to SVG.
     * When "\@PS" is specified, the formatted result is outputted to PostScript.
     * When "\@INX" is specified, the formatted result is outputted to INX.
     * When "\@MIF" is specified, the formatted result is outputted to MIF.
     * When "\@TEXT" is specified, the formatted result is outputted to a text format file.
     * When "\@AreaTree" is specified, the AreaTree will be outputted.
     * When omitted, it is considered as "\@PDF" was specified.
     * It's impossible to output to the printer with any OS's other than Windows.
     *
     * @param   newVal  Pointer to a null-terminated string to be used as the printer name.
     */
    void setPrinterNameW(const wchar_t* newVal);

#if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))

    /**
     * Get the number of copies. Effective when outputting to printer.
     *
     * @return  Returns the number of copies.
     */
    long getPrnCopies() const;

    /**
     * Specifies the number of copies. Effective when outputting to printer.
     * If nothing is specified, the value is considered as 1.
     * This setting is effective only with Windows version.
     *
     * @param   newVal  the number of copies.
     */
    void setPrnCopies(long newVal);

    /**
     * Get collation of multiple copies.
     *
     * @return  If zero is returned, the same page is multi-copied continuously.
     *          If nonezero is returned, the pages specified from start to end are printed repeatedly.
     */
    long getPrnCollate() const;

    /**
     * Specifies collation of multiple copies. Effective when outputting to printer and the number of
     * copies is plural. If it is not specified or the value zero is specified, the same page is
     * multi-copied continuously.
     * If nonezero is specified, the pages specified from start to end are printed repeatedly.
     * This setting is effective only with Windows version.
     *
     * @param   newVal  Zpecifies zero or nonzero.
     */
    void setPrnCollate(long newVal);

    /**
     * Get the setting of whether print dialog box is displayed or not when printing
     *
     * @return  If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.
     */
    long getBatchPrint() const;

    /**
     * When the value 'false' is specified, the print dialog box is displayed when printing.
     * If the setting is omitted or the value 'true' is specified, the print dialog is not displayed.
     * This setting is effective only with Windows version.
     *
     * @param   newVal  If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.
     */
    void setBatchPrint(long newVal);

#endif  /* WIN32 */

    /**
     * Get the version string of Server Based Converter.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getVersion(char* pVal, int size) const;

    /**
     * Get the version string of Server Based Converter.
     * 
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getVersionW(wchar_t* pVal, int size) const;

    /**
     * Get INX output mode.
     *
     * @return  output mode of INX.
     */
    DfvINXOUTPUTMODE getInxOutputMode() const;

    /**
     * Set INX output mode.
     *
     * @param   newVal mode of INX.
     */
    void setInxOutputMode(DfvINXOUTPUTMODE newVal);

    /**
     * Get the specification that omit blank pages. return Specification that omit blank pages 
     */
    bool getOmitBlankPages();
    
    /**
     * Disregard any empty pages.
     * Effective only when the original file is MS Word or MS Excel. 
     * Specifies to disregard any empty pages at the beginning of document. 
     * By using this parameter with setEndPage = 1 parameter,
     * it is possible to acquire the output of the first page which has actual contents.
     * Other operation is not guaranteed. 
     *
     * @param   newVal      If the value is 'true' is specified, omit blank pages 
     */
    void setOmitBlankPages(bool newVal);

    /**
     * Get specifies of the FlashPartiallyOutput.
     * @since 2.1
     *
     * @return  specifies of FlashPartiallyOutput.
     */
    long getFlashPartiallyOutput() const;

    /**
     * When an error occurs within the document, the flash file in process will be outputted.
     * Effective when outputting to Flash.
     * @since 2.1
     *
     * @param   newVal  Specifies zero or nonzero.
     */
    void setFlashPartiallyOutput(long newVal);

    /**
     * Get specifies of the FlashHidePageButton.
     * @since 3.0
     *
     * @return  specifies of FlashHidePageButton.
     */
    long getFlashHidePageButton() const;

    /**
     * Output a no page button. Effective when outputting to Flash.
     * @since 3.0
     *
     * @param   newVal  If the value is 'true' is specified, output a no page button.
     */
    void setFlashHidePageButton(long newVal);

#if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
    /**
     * It print at size of paper.
     * Default is false.
     * Effective when outputting to printer, and only Windows version. 
     * 
     * @param   newVal      If the value is 'true' is specified, print at size of paper. 
     */
    void setPrnFitPaper(bool newVal);

    /**
     * Specifies the scaling ratio of the PDF to output.
     * A value with a unit or % value can be specified as length.
     * Effective when outputting to PDF. 
     *
     * @param   newVal      the scaling ratio of the PDF 
     */
    void setPdfOutputScale(const char* newVal);
    void setPdfOutputScaleW(const wchar_t* newVal);

    /**
     * Get the image resolution when outputting JPEG and PNG.
     * This setting is effective only with Windows version.
     * Effective when outputting to image, and only Windows version. 
     *
     * @ @return        Image resolution 
     */
    int getRasterDPI(void) const;

    /**
     * Effective when outputting to image, and only Windows version. 
     *
     * @param   newVal      Image resolution (50 to 500) 
     */
    void setRasterDPI(int newVal);

    /**
     *  Get the image scale when outputting JPEG and PNG.
     * Effective when outputting to image, and only Windows version. 
     *
     * @return      Image scale 
     */
    char* getRasterScale(char* pVal, int size) const;
    wchar_t* getRasterScaleW(wchar_t* pVal, int size) const;

    /**
     * Sets the image scale when outputting JPEG and PNG.
     * A numerical value, "%", or "px" (pixel) is available as the unit.
     * Specify the percentage for a numerical value and "%", and specify the width of image for pixel.
     * Effective when outputting to image, and only Windows version. 
     *
     * @param   newVal      Image scale 
     */
    void setRasterScale(const char* newVal);
    void setRasterScaleW(const wchar_t* newVal);

    /**
     * Get the maximum image height when outputting JPEG and PNG.<BR>
     * Effective when outputting to image, and only Windows version.
     *
     * @return          Maximum image height
     */
    int getRasterHeight() const;

    /**
     * Sets the maximum image height decided by setRasterScale when outputting JPEG and PNG.<BR>
     * "px" (pixel) is available as the unit. 
     * Effective when outputting to image, and only Windows version.
     *
     * @param   newVal  Maximum image height
     */
    void setRasterHeight(int newVal);

    /**
     * Get the file name naming format when outputting PNG and JPEG.<BR>
     * Effective when outputting to image, and only Windows version.
     *
     * @return          format for naming files
     */
    char* getRasterFormat(char* pVal, int size) const;
    wchar_t* getRasterFormatW(wchar_t* pVal, int size) const;

    /**
     * Specifies the file name naming format when outputting PNG and JPEG.<BR>
     * Effective when outputting to image, and only Windows version.
     *
     * @param   newVal  format for naming files
     */
    void setRasterFormat(const char* newVal);
    void setRasterFormatW(const wchar_t* newVal);

    /**
     * Get the conversion accuracy when outputting JPEG.<BR>
     * Effective when outputting to image, and only Windows version.
     *
     * @return          JPEG quality
     */
    int getRasterJpegQuality() const;

    /**
     * Specifies the conversion accuracy by the value with the range of 1-100(%) when outputting JPEG.<BR>
     * When this parameter is omitted, it is regarded as 80%.
     * Effective when outputting to image, and only Windows version.
     *
     * @param   newVal  JPEG quality
     */
    void setRasterJpegQuality(int newVal);

    /**
     * Gets specification whether to use GdiPlus .<BR>
     * Effective when outputting to image, and only Windows version.
     *
     * return           Specification whether to use GdiPlus.
     */
    bool getRasterUseGdiPlus() const;

    /**
     * GdiPlus is used when the file is converted to Jpeg or PNG.<BR>
     * This setting is effective only with Windows XP or later / Windows Server2003.
     * Effective when outputting to image, and only Windows version.
     *
     * @param newVal Specifies whether to use GdiPlus.
     */
    void setRasterUseGdiPlus(bool newVal);

    /**
     * Gets specification whether to convert to monochrome image, when outputting JPEG and PNG.<BR>
     * Effective when outputting to image, and only Windows version.
     *
     * return           Specification whether to convert to monochrome.
     */
    bool getRasterMonochrome() const;

    /**
     * Specifies whether to convert to monochrome image, when outputting JPEG and PNG.<BR>
     * Effective when outputting to image, and only Windows version.
     *
     * @param newVal Specifies whether to convert to monochrome.
     */
    void setRasterMonochrome(bool newVal);

#endif  // #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))

    /**
     * Specifies the height of the paper when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal      the height of paper 
     */
    void setTextPaperHeight(const char* newVal);
    void setTextPaperHeightW(const wchar_t* newVal);

    /**
     * Specifies the width of the paper when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal      the width of paper 
     */
    void setTextPaperWidth(const char* newVal);
    void setTextPaperWidthW(const wchar_t* newVal);

    /**
     * Specifies the left margin of the paper when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal       the left margin of the paper 
     */
    void setTextMarginLeft(const char* newVal);
    void setTextMarginLeftW(const wchar_t* newVal);

    /**
     * Specifies the right margin of the paper when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal      the top margin of the paper 
     */
    void setTextMarginTop(const char* newVal);
    void setTextMarginTopW(const wchar_t* newVal);

    /**
     * Specifies the right margin of the paper when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal      the right margin of the paper 
     */
    void setTextMarginRight(const char* newVal);
    void setTextMarginRightW(const wchar_t* newVal);

    /**
     * Specifies the right margin of the paper when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal      the bottom margin of the paper 
     */
    void setTextMarginBottom(const char* newVal);
    void setTextMarginBottomW(const wchar_t* newVal);

    /**
     * Specifies the font family name when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal      font family name 
     */
    void setTextFontFamily(const char* newVal);
    void setTextFontFamilyW(const wchar_t* newVal);

    /**
     * Specifies the font size when inputting text.
     * Effective when inputting text. 
     *
     * @param   newVal      font size 
     */
    void setTextFontSize(const char* newVal);
    void setTextFontSizeW(const wchar_t* newVal);

    /**
     * Specifies the value of whether show page number or not when inputting text.
     * Effective when inputting text. 
     * 
     * @param   newVal      the value of whether show page number or not 
     */
    void setTextShowPageNumber(bool newVal);

    /**
     * Specifies the value of whether show page number or not when inputting text.
     * Effective when inputting text. 
     * 
     * @param   newVal      the value of whether show page number or not    
     */
    void setTextShowLineNumber(bool newVal);

    /**
     * Specifies the offset value of range from body area when showing line number and inputting text.
     * Effective when inputting text. 
     * 
     * @param   newVal      the offset value
     */
    void setTextLineNumberOffset(const char* newVal);
    void setTextLineNumberOffsetW(const wchar_t* newVal);

    /**
     * Specifies the line number format when showing line number and inputting text.
     * Effective when inputting text. 
     * 
     * @param   newVal      line number format  
     */
    void setTextLineNumberFormat(const char* newVal);
    void setTextLineNumberFormatW(const wchar_t* newVal);

#if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
    /**
     * Acquires the setting of the smoothing processing to text.<BR>
     * This setting is effective only with Windows XP or later / Windows Server2003 or later.
     *
     * @return          
     * Specify whether to perform the smoothing processing to text.
     */
    bool getGdiTextAntialias() const;

    /**
     * Performs the smoothing processing to text.<BR>
     * Effective only when printing and outputting images.<BR>
     * This setting is effective only with Windows XP or later / Windows Server2003 or later.
     *
     * @param   newVal  
     * Performs the smoothing processing when true is specified.
     */
    void setGdiTextAntialias(bool newVal);

    /**
     * Acquires the setting of the smoothing processing to borders.<BR>
     * This setting is effective only with Windows XP or later / Windows Server2003 or later.
     *
     * @return          
     * Specify whether to perform the smoothing processing to borders.
     */
    bool getGdiLineartSmoothing() const;

    /**
     * Performs the smoothing processing to borders.<BR>
     * Effective only when printing and outputting images.<BR>
     * This setting is effective only with Windows XP or later / Windows Server2003 or later.
     *
     * @param   newVal  
     * Performs the smoothing processing when true is specified.
     */
    void setGdiLineartSmoothing(bool newVal);

    /**
     * Acquires the setting of the smoothing processing to images.<BR>
     * This setting is effective only with Windows XP or later / Windows Server2003 or later.
     *
     * @return          
     * Specify whether to perform the smoothing processing to images.
     */
    bool getGdiImageSmoothing() const;

    /**
     * Performs the smoothing processing to images.<BR>
     * Effective only when printing and outputting images.<BR>
     * This setting is effective only with Windows XP or later / Windows Server2003 or later.
     *
     * @param   newVal  
     * Performs the smoothing processing when true is specified.
     */
    void setGdiImageSmoothing(bool newVal);
#endif

    /**
     * Get the watermark text on each page. 
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text.
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getWatermarkText(char* pVal, int size) const;

    /**
     * Get watermark text on each page.
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text. 
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getWatermarkTextW(wchar_t* pVal, int size) const;

    /**
     * Displays the specified watermark text on each page. 
     * Possible to make it multiple lines by delimiting with the line feed \n. 
     * This setting is invalid with the evaluation version.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkText(const char* newVal);

    /**
     * Displays the specified watermark text on each page. 
     * Possible to make it multiple lines by delimiting with the line feed \n. 
     * This setting is invalid with the evaluation version.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkTextW(const wchar_t* newVal);

    /**
     * Get the font family of the watermark text. 
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text.
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getWatermarkFontFamily(char* pVal, int size) const;

    /**
     * Get the font family of the watermark text.
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text. 
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getWatermarkFontFamilyW(wchar_t* pVal, int size) const;

    /**
     * Specifies the font family to the character string which you set to watermark-text.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkFontFamily(const char* newVal);

    /**
     * Specifies the font family to the character string which you set to watermark-text.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkFontFamilyW(const wchar_t* newVal);

    /**
     * Get the font weight of the watermark text. 
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text.
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getWatermarkFontWeight(char* pVal, int size) const;

    /**
     * Get the font weight of the watermark text.  
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text. 
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getWatermarkFontWeightW(wchar_t* pVal, int size) const;

    /**
     * Specifies the font weight to the character string which you set to watermark-text. 
     * Possible to specify normal, bold or the numerical value from 100 to 900.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkFontWeight(const char* newVal);

    /**
     * Specifies the font weight to the character string which you set to watermark-text. 
     * Possible to specify normal, bold or the numerical value from 100 to 900.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkFontWeightW(const wchar_t* newVal);

    /**
     * Get the font style of the watermark text.
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text.
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getWatermarkFontStyle(char* pVal, int size) const;

    /**
     * Get the font style of the watermark text.  
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text. 
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getWatermarkFontStyleW(wchar_t* pVal, int size) const;

    /**
     * Specifies the font style to the character string which you set to watermark-text.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkFontStyle(const char* newVal);

    /**
     * Specifies the font style to the character string which you set to watermark-text.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkFontStyleW(const wchar_t* newVal);

    /**
     * Get the opacity of the watermark text.
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text.
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getWatermarkOpacity(char* pVal, int size) const;

    /**
     * Get the opacity of the watermark text.   
     *
     * @param   pVal
     *      Pointer to the buffer that will receive the text. 
     *      If the string is as long or longer than the buffer,
     *      the string is truncated and terminated with a NULL character.
     * @param   size
     *      Specifies the number of the 'pVal' buffer, including the NULL character.
     *      If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getWatermarkOpacityW(wchar_t* pVal, int size) const;

    /**
     * Specifies the opacity to the character string which you set to watermark-text.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkOpacity(const char* newVal);

    /**
     * Specifies the opacity to the character string which you set to watermark-text.  
     *
     * @param   newVal
     *      Pointer to a null-terminated string.
     */
    void setWatermarkOpacityW(const wchar_t* newVal);

};

/***************************************************************
 * Exception class that returns the error information in the formatting process.
 */
class DFVINTERFACE_API DfvException
{
public:
    /**
     * Constructor
     */
    DfvException(DfvIfErrorLevel errorLevel, DfvIfErrorCode errorCode, const wchar_t* errorMessage);

    /**
     * Copy constructor
     */
    DfvException(const DfvException &e);

    /**
     * Destructor
     */
    ~DfvException();

private:
    DfvIfErrorLevel m_errorLevel;           /* Error level */
    DfvIfErrorCode  m_errorCode;            /* Error code */
    wchar_t*        m_errorMessage;         /* Error message */

public:
    /**
     * Get the error level.
     *
     * @return  Returns the error level.
     */
    DfvIfErrorLevel getErrorLevel() const;

    /**
     * Get the error code.
     *
     * @return  Returns the error code.
     */
    DfvIfErrorCode getErrorCode() const;

    /**
     * Get the error message.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    char* getErrorMessage(char* pVal, int size) const;

    /**
     * Get the error message.
     *
     * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
     *          the string is truncated and terminated with a NULL character.
     * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
     * @return  Returns the 'pVal'.
     */
    wchar_t* getErrorMessageW(wchar_t* pVal, int size) const;
};

}

#endif  /* DFVIFC_H__ */

---