xfoifc_c.h File Reference

AH Formatter C Interface. More...

Go to the source code of this file.

Defines

#define XFOINTERFACE_API

Typedefs

typedef long XfoIfErrorCode
 Error Code.
typedef void * CXfoObjPtr
 Pointer to XfoObj instance.
typedef void( XfoOnMessageProc )(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char *errMessage)
 Error callback handler.
typedef void( XfoOnMessageProcW )(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t *errMessage)
typedef void( XfoOnFormatPageProc )(long pageNo)
typedef void( XfoOnMessageProcEx )(void *pAnyObj, XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char *errMessage)
typedef void( XfoOnMessageProcExW )(void *pAnyObj, XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t *errMessage)
typedef void( XfoOnFormatPageProcEx )(void *pAnyObj, long pageNo)

Enumerations

enum  XfoIfErrorLevel {
  ELVL_NORMAL = 0, ELVL_INFORMATION = 1, ELVL_WARNING = 2, ELVL_RECOVERABLE = 3,
  ELVL_FATAL = 4
}
 Error Level. More...
enum  XfoErrorStreamType { EST_NONE, EST_STDOUT, EST_STDERR }
 Error Stream Type for MessageListener. More...
enum  PDFVERSION {
  PDF_13, PDF_14, PDF_15, PDF_16,
  PDF_17, PDFX_1a_2001 = 101, PDFX_3_2002 = 103, PDFX_1a_2003 = 104,
  PDFX_2_2003 = 105, PDFX_3_2003 = 106, PDFA_1a_2005 = 200, PDFA_1b_2005 = 400
}
 PDF version. More...
enum  PDFENCRYPTLEVEL { ENCLEVEL_40, ENCLEVEL_128 }
 PDF encrypt level. More...
enum  PDFPRINTALLOW { PRALLOW_NONE, PRALLOW_LOW, PRALLOW_HIGH }
 PDF print allow. More...
enum  PDFIMAGECOMPRESSION { IMGCMPR_AUTO, IMGCMPR_JPEG, IMGCMPR_ZLIB, IMGCMPR_JPEG2K }
 PDF image compression. More...
enum  PDFRGBCONVERSION { RGBCONV_NONE, RGBCONV_BLACK, RGBCONV_GRAY, RGBCONV_ALL }
 PDF RGB conversion. More...
enum  EMBEDALLFONT { EMBALLFONT_PART, EMBALLFONT_ALL, EMBALLFONT_BASE14 }
 Embed font. More...
enum  IMAGEDOWNSAMPLING { IMGDOWNSAMPLING_NONE, IMGDOWNSAMPLING_AVERAGE, IMGDOWNSAMPLING_BICUBIC, IMGDOWNSAMPLING_SUBSAMPLING }
 Image downsampling. More...
enum  MONOCHROMECOMPRESSION {
  MONOCMPR_CCITT4, MONOCMPR_CCITT3, MONOCMPR_RUNLENGTH, MONOCMPR_ZLIB,
  MONOCMPR_OFF
}
 Monochrome compression. More...
enum  SVGVERSION { SVG_11, SVG_Basic, SVG_Tiny }
 SVG version. More...
enum  IMAGEPROCTYPE { IMGPT_EMBED_ALL, IMGPT_COPY_ALL, IMGPT_LINK, IMGPT_COPY }
 Image processing. More...
enum  IMAGECONVERSION { IMGCNV_AUTO, IMGCNV_JPEG, IMGCNV_PNG, IMGCNV_JPEGALL }
 Image conversion. More...
enum  FORMATTERTYPE {
  FMTTYP_AUTO, FMTTYP_HTML, FMTTYP_XHTML, FMTTYP_XMLCSS,
  FMTTYP_XSLFO
}

Functions

CXfoObjPtr xfo_createXfoObject ()
 Create instance of XfoObj.
void xfo_releaseXfoObject (CXfoObjPtr pXfoObj)
 Release instance of XfoObj.
FORMATTERTYPE xfo_getFormatterType (CXfoObjPtr pXfoObj)
 Get formatter type.
void xfo_setFormatterType (CXfoObjPtr pXfoObj, FORMATTERTYPE newVal)
 Set formatter type.
char * xfo_getDocumentURI (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the URL of XML document you will format.
wchar_t * xfo_getDocumentURIW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the URL of XML document you will format.
void xfo_setDocumentURI (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the URL of XML document you will format.
void xfo_setDocumentURIW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the URL of XML document you will format.
char * xfo_getStylesheetURI (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the URI of XSL stylesheet for formatting.
wchar_t * xfo_getStylesheetURIW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the URI of XSL stylesheet for formatting.
void xfo_setStylesheetURI (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the URI of XSL stylesheet for formatting.
void xfo_setStylesheetURIW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the URI of XSL stylesheet for formatting.
void xfo_addUserStylesheetURI (CXfoObjPtr pXfoObj, const char *newVal)
 Append the path name of user stylesheet file which describes AH Formatter options.
void xfo_addUserStylesheetURIW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Append the path name of user stylesheet file which describes AH Formatter options.
char * xfo_getStylesheetTitle (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the prior stylesheet title.
wchar_t * xfo_getStylesheetTitleW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the prior stylesheet title.
void xfo_setStylesheetTitle (CXfoObjPtr pXfoObj, const char *newVal)
 Set the prior stylesheet title.
void xfo_setStylesheetTitleW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Set the prior stylesheet title.
char * xfo_getHtmlDefaultCharset (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get html default charset.
wchar_t * xfo_getHtmlDefaultCharsetW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get html default charset.
void xfo_setHtmlDefaultCharset (CXfoObjPtr pXfoObj, const char *newVal)
 Set html default charset.
void xfo_setHtmlDefaultCharsetW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Set html default charset.
char * xfo_getOutputFilePath (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the path name of the output file.
wchar_t * xfo_getOutputFilePathW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the path name of the output file.
void xfo_setOutputFilePath (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the path name of the output file.
void xfo_setOutputFilePathW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the path name of the output file.
char * xfo_getOptionFileURI (CXfoObjPtr pXfoObj, char *pVal, int size, int n)
 Get the path name of XML-format Option setting file which describes AH Formatter options.
wchar_t * xfo_getOptionFileURIW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size, int n)
 Get the path name of XML-format Option setting file which describes AH Formatter options.
void xfo_setOptionFileURI (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the path name of XML-format Option setting file which describes AH Formatter options.
void xfo_setOptionFileURIW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the path name of XML-format Option setting file which describes AH Formatter options.
void xfo_addOptionFileURI (CXfoObjPtr pXfoObj, const char *newVal)
 Append the path name of XML-format Option setting file which describes AH Formatter options.
void xfo_addOptionFileURIW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Append the path name of XML-format Option setting file which describes AH Formatter options.
int xfo_getOptionFileCount (CXfoObjPtr pXfoObj)
 Get the number of URIs of XML-format Option setting file which describes AH Formatter options.
char * xfo_getOutputFOPath (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.
wchar_t * xfo_getOutputFOPathW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.
void xfo_setOutputFOPath (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.
void xfo_setOutputFOPathW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.
char * xfo_getExternalXSLT (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the command line of External XSLT Processor.
wchar_t * xfo_getExternalXSLTW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the command line of External XSLT Processor.
void xfo_setExternalXSLT (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the command line of External XSLT Processor.
void xfo_setExternalXSLTW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the command line of External XSLT Processor.
char * xfo_getBaseURI (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the default base URI.
wchar_t * xfo_getBaseURIW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the default base URI.
void xfo_setBaseURI (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the default base URI.
void xfo_setBaseURIW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the default base URI.
char * xfo_getXSLTParamFormat (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the parameter format of xsl:param when using External XSLT Processor.
wchar_t * xfo_getXSLTParamFormatW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the parameter format of xsl:param when using External XSLT Processor.
void xfo_setXSLTParamFormat (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the parameter format of xsl:param when using External XSLT Processor.
void xfo_setXSLTParamFormatW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the parameter format of xsl:param when using External XSLT Processor.
long xfo_getStartPage (CXfoObjPtr pXfoObj)
 Get the start page number of document to output.
void xfo_setStartPage (CXfoObjPtr pXfoObj, long newVal)
 Specifies the start page number of document to output.
long xfo_getEndPage (CXfoObjPtr pXfoObj)
 Get the end page number of document to output.
void xfo_setEndPage (CXfoObjPtr pXfoObj, long newVal)
 Specifies the end page number of document to output.
void xfo_setPdfMasterPassword (CXfoObjPtr pXfoObj, const char *newVal)
void xfo_setPdfMasterPasswordW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
void xfo_setPdfOwnerPassword (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to PDF.
void xfo_setPdfOwnerPasswordW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to PDF.
void xfo_setPdfUserPassword (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to PDF.
void xfo_setPdfUserPasswordW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to PDF.
void xfo_setPdfNoPrinting (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoPrinting (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfNoChanging (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoChanging (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfNoContentCopying (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoContentCopying (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfNoAddingOrChangingCommnets (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoAddingOrChangingCommnets (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfNoAddingOrChangingComments (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoAddingOrChangingComments (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfVersion (CXfoObjPtr pXfoObj, PDFVERSION newVal)
 Effective when outputting to PDF.
PDFVERSION xfo_getPdfVersion (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfNoFillForm (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoFillForm (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfNoAccessibility (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoAccessibility (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfNoAssembleDoc (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfNoAssembleDoc (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfEncryptLevel (CXfoObjPtr pXfoObj, PDFENCRYPTLEVEL newVal)
 Effective when outputting to PDF.
PDFENCRYPTLEVEL xfo_getPdfEncryptLevel (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
long xfo_getPdfEmbedAllFonts (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfEmbedAllFonts (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
char * xfo_getPdfEmbedFonts (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to PDF.
wchar_t * xfo_getPdfEmbedFontsW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to PDF.
void xfo_setPdfEmbedFonts (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to PDF.
void xfo_setPdfEmbedFontsW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to PDF.
long xfo_getPdfErrorOnEmbedFault (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfErrorOnEmbedFault (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfErrorOnMissingGlyph (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfErrorOnMissingGlyph (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
PDFPRINTALLOW xfo_getPdfPrintingAllowed (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfPrintingAllowed (CXfoObjPtr pXfoObj, PDFPRINTALLOW newVal)
 Effective when outputting to PDF.
PDFIMAGECOMPRESSION xfo_getPdfImageCompression (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfImageCompression (CXfoObjPtr pXfoObj, PDFIMAGECOMPRESSION newVal)
 Effective when outputting to PDF.
int xfo_getPdfJPEGQuality (CXfoObjPtr pXfoObj)
 Gets the value of the quality of JPEG format that is specified by xfo_setPdfImageCompression() stored in PDF.
void xfo_setPdfJPEGQuality (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
long xfo_getPdfCompressContentStream (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfCompressContentStream (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfUseLaunchForRelativeURI (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfUseLaunchForRelativeURI (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
PDFRGBCONVERSION xfo_getPdfRGBConversion (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfRGBConversion (CXfoObjPtr pXfoObj, PDFRGBCONVERSION newVal)
 Effective when outputting to PDF.
int xfo_getPdfRasterizeResolution (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfRasterizeResolution (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
long xfo_getPdfLinearize (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfLinearize (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
long xfo_getPdfSignature (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfSignature (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
char * xfo_getPdfSignatureName (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to PDF.
wchar_t * xfo_getPdfSignatureNameW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to PDF.
void xfo_setPdfSignatureName (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to PDF.
void xfo_setPdfSignatureNameW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to PDF.
char * xfo_getPdfCertificateName (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to PDF.
wchar_t * xfo_getPdfCertificateNameW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to PDF.
void xfo_setPdfCertificateName (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to PDF.
void xfo_setPdfCertificateNameW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to PDF.
EMBEDALLFONT xfo_getPdfEmbedAllFontsEx (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfEmbedAllFontsEx (CXfoObjPtr pXfoObj, EMBEDALLFONT newVal)
 Effective when outputting to PDF.
IMAGEDOWNSAMPLING xfo_getPdfImageDownSampling (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfImageDownSampling (CXfoObjPtr pXfoObj, IMAGEDOWNSAMPLING newVal)
 Effective when outputting to PDF.
int xfo_getPdfImageDownSamplingTarget (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfImageDownSamplingTarget (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
int xfo_getPdfImageDownSamplingDPI (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfImageDownSamplingDPI (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
long xfo_getPdfPutImageColorProfile (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfPutImageColorProfile (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
PDFIMAGECOMPRESSION xfo_getPdfGrayscaleImageCompression (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfGrayscaleImageCompression (CXfoObjPtr pXfoObj, PDFIMAGECOMPRESSION newVal)
 Effective when outputting to PDF.
int xfo_getPdfGrayscaleJPEGQuality (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfGrayscaleJPEGQuality (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
IMAGEDOWNSAMPLING xfo_getPdfGrayscaleImageDownSampling (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfGrayscaleImageDownSampling (CXfoObjPtr pXfoObj, IMAGEDOWNSAMPLING newVal)
 Effective when outputting to PDF.
int xfo_getPdfGrayscaleImageDownSamplingTarget (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfGrayscaleImageDownSamplingTarget (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
int xfo_getPdfGrayscaleImageDownSamplingDPI (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfGrayscaleImageDownSamplingDPI (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
MONOCHROMECOMPRESSION xfo_getPdfMonochromeImageCompression (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfMonochromeImageCompression (CXfoObjPtr pXfoObj, MONOCHROMECOMPRESSION newVal)
 Effective when outputting to PDF.
IMAGEDOWNSAMPLING xfo_getPdfMonochromeImageDownSampling (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfMonochromeImageDownSampling (CXfoObjPtr pXfoObj, IMAGEDOWNSAMPLING newVal)
 Effective when outputting to PDF.
int xfo_getPdfMonochromeImageDownSamplingTarget (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfMonochromeImageDownSamplingTarget (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
int xfo_getPdfMonochromeImageDownSamplingDPI (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfMonochromeImageDownSamplingDPI (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to PDF.
long xfo_getTwoPassFormatting (CXfoObjPtr pXfoObj)
 Gets the specification of two pass format.
void xfo_setTwoPassFormatting (CXfoObjPtr pXfoObj, long newVal)
 Set the specification of two pass format.
long xfo_getPdfTag (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfTag (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
char * xfo_getPdfOutputWidth (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to PDF.
wchar_t * xfo_getPdfOutputWidthW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to PDF.
void xfo_setPdfOutputWidth (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to PDF.
void xfo_setPdfOutputWidthW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to PDF.
char * xfo_getPdfOutputHeight (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to PDF.
wchar_t * xfo_getPdfOutputHeightW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to PDF.
void xfo_setPdfOutputHeight (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to PDF.
void xfo_setPdfOutputHeightW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to PDF.
long xfo_getPdfErrorOnPDFXFault (CXfoObjPtr pXfoObj)
 Effective when outputting to PDF.
void xfo_setPdfErrorOnPDFXFault (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to PDF.
SVGVERSION xfo_getSvgVersion (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgVersion (CXfoObjPtr pXfoObj, SVGVERSION newVal)
 Effective when outputting to SVG.
long xfo_getSvgGzipCompression (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgGzipCompression (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to SVG.
long xfo_getSvgEmbedAllFonts (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgEmbedAllFonts (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to SVG.
char * xfo_getSvgFormat (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to SVG.
wchar_t * xfo_getSvgFormatW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to SVG.
void xfo_setSvgFormat (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to SVG.
void xfo_setSvgFormatW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to SVG.
char * xfo_getSvgEmbedFonts (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to SVG.
wchar_t * xfo_getSvgEmbedFontsW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to SVG.
void xfo_setSvgEmbedFonts (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to SVG.
void xfo_setSvgEmbedFontsW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to SVG.
long xfo_getSvgErrorOnEmbedFault (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgErrorOnEmbedFault (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to SVG.
IMAGECONVERSION xfo_getSvgImageConversion (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgImageConversion (CXfoObjPtr pXfoObj, IMAGECONVERSION newVal)
 Effective when outputting to SVG.
int xfo_getSvgJPEGQuality (CXfoObjPtr pXfoObj)
 Gets the value of the quality of JPEG format that is specified by xfo_setSvgImageConversion() stored in SVG.
void xfo_setSvgJPEGQuality (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to SVG.
IMAGEPROCTYPE xfo_getSvgImageProcessingType (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgImageProcessingType (CXfoObjPtr pXfoObj, IMAGEPROCTYPE newVal)
 Effective when outputting to SVG.
char * xfo_getSvgImageCopyPath (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to SVG.
void xfo_setSvgImageCopyPath (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to SVG.
wchar_t * xfo_getSvgImageCopyPathW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to SVG.
void xfo_setSvgImageCopyPathW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to SVG.
long xfo_getSvgSingleFile (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgSingleFile (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to SVG.
long xfo_getSvgImageRename (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgImageRename (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to SVG.
char * xfo_getSvgImagePrefix (CXfoObjPtr pXfoObj, char *pVal, int size)
 Effective when outputting to SVG.
void xfo_setSvgImagePrefix (CXfoObjPtr pXfoObj, const char *newVal)
 Effective when outputting to SVG.
wchar_t * xfo_getSvgImagePrefixW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Effective when outputting to SVG.
void xfo_setSvgImagePrefixW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Effective when outputting to SVG.
long xfo_getSvgSinglePageNumber (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgSinglePageNumber (CXfoObjPtr pXfoObj, long newVal)
 Effective when outputting to SVG.
int xfo_getSvgRasterizeResolution (CXfoObjPtr pXfoObj)
 Effective when outputting to SVG.
void xfo_setSvgRasterizeResolution (CXfoObjPtr pXfoObj, int newVal)
 Effective when outputting to SVG.
long xfo_getStartVolume (CXfoObjPtr pXfoObj)
 Get the start volume of document to output.
void xfo_setStartVolume (CXfoObjPtr pXfoObj, long newVal)
 Specifies the start volume of document to output.
long xfo_getEndVolume (CXfoObjPtr pXfoObj)
 Get the end volume of document to output.
void xfo_setEndVolume (CXfoObjPtr pXfoObj, long newVal)
 Specifies the end volume of document to output.
long xfo_getMultiVolume (CXfoObjPtr pXfoObj)
 Get multiple volume of PDF output.
long xfo_getTotalVolumeCount (CXfoObjPtr pXfoObj)
 Gets the number of all the separate volumes when outputting PDF to multiple separate volumes.
long xfo_getOutputVolumeCount (CXfoObjPtr pXfoObj)
 Gets the number of the actual separate volumes when outputting PDF to multiple separate volumes.
void xfo_setMultiVolume (CXfoObjPtr pXfoObj, long newVal)
 Specifies multiple volume of PDF output.
XfoIfErrorLevel xfo_getExitLevel (CXfoObjPtr pXfoObj)
 Get the error level to abort formatting process.
void xfo_setExitLevel (CXfoObjPtr pXfoObj, XfoIfErrorLevel newVal)
 Error level to abort formatting process.
XfoIfErrorLevel xfo_getErrorLevel (CXfoObjPtr pXfoObj)
 Returns the error level of the error that occurred during the formatting process.
XfoIfErrorCode xfo_getErrorCode (CXfoObjPtr pXfoObj)
 Returns the error code of the error that occurred during the formatting process.
char * xfo_getErrorMessage (CXfoObjPtr pXfoObj, char *pVal, int size)
 Returns the error message of the error that occurred during the formatting process.
wchar_t * xfo_getErrorMessageW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Returns the error message of the error that occurred during the formatting process.
void xfo_setFontAlias (CXfoObjPtr pXfoObj, const char *src, const char *dst)
 Sets the substitution of font name.
void xfo_setFontAliasW (CXfoObjPtr pXfoObj, const wchar_t *src, const wchar_t *dst)
 Sets the substitution of font name.
void xfo_clearFontAlias (CXfoObjPtr pXfoObj)
 Clear all substitutions of font name.
void xfo_eraseFontAlias (CXfoObjPtr pXfoObj, const char *src)
 Clear all substitutions of font name.
void xfo_eraseFontAliasW (CXfoObjPtr pXfoObj, const wchar_t *src)
XfoIfErrorCode xfo_execute (CXfoObjPtr pXfoObj)
 Execute formatting and output to a PDF specified in OutputFilePath or printer specified in PrinterName.
void xfo_clear (CXfoObjPtr pXfoObj)
 Initialize formatting engine.
void xfo_setOnMessageProc (CXfoObjPtr pXfoObj, XfoOnMessageProc *proc)
 Specifies the callback fucntion.
void xfo_setOnMessageProcW (CXfoObjPtr pXfoObj, XfoOnMessageProcW *proc)
 Specifies the callback fucntion.
void xfo_setOnFormatPageProc (CXfoObjPtr pXfoObj, XfoOnFormatPageProc *proc)
 Specifies the callback fucntion.
void xfo_setOnMessageProcEx (CXfoObjPtr pXfoObj, XfoOnMessageProcEx *proc, void *pAnyObj)
 Specifies the callback fucntion.
void xfo_setOnMessageProcExW (CXfoObjPtr pXfoObj, XfoOnMessageProcExW *proc, void *pAnyObj)
 Specifies the callback fucntion.
void xfo_setOnFormatPageProcEx (CXfoObjPtr pXfoObj, XfoOnFormatPageProcEx *proc, void *pAnyObj)
 Specifies the callback fucntion.
void xfo_setXSLTParam (CXfoObjPtr pXfoObj, const char *paramName, const char *value)
 Set parameter name and value for xsl:param.
void xfo_setXSLTParamW (CXfoObjPtr pXfoObj, const wchar_t *paramName, const wchar_t *value)
 Set parameter name and value for xsl:param.
void xfo_clearXSLTParam (CXfoObjPtr pXfoObj)
 Clear all parameter name and value for xsl:param.
XfoErrorStreamType xfo_getErrorStreamType (CXfoObjPtr pXfoObj)
 Get the error output type.
void xfo_setErrorStreamType (CXfoObjPtr pXfoObj, XfoErrorStreamType type)
 Set the error output type.
char * xfo_getPrinterName (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the printer name where the formatted result is outputted.
wchar_t * xfo_getPrinterNameW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the printer name where the formatted result is outputted.
void xfo_setPrinterName (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the output format or the printer name to output.
void xfo_setPrinterNameW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the output format or the printer name to output.
long xfo_getFormattedPages (CXfoObjPtr pXfoObj)
 Get formatted total pages.
char * xfo_getPrinterSettingURI (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the printer setting file URI.
wchar_t * xfo_getPrinterSettingURIW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the printer setting file URI.
void xfo_setPrinterSettingURI (CXfoObjPtr pXfoObj, const char *newVal)
 Specifies the printer setting file URI.
void xfo_setPrinterSettingURIW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
 Specifies the printer setting file URI.
long xfo_getPrnCopies (CXfoObjPtr pXfoObj)
 Get the number of copies.
void xfo_setPrnCopies (CXfoObjPtr pXfoObj, long newVal)
 Specifies the number of copies.
long xfo_getPrnCollate (CXfoObjPtr pXfoObj)
 Get collation of multiple copies.
void xfo_setPrnCollate (CXfoObjPtr pXfoObj, long newVal)
 Specifies collation of multiple copies.
long xfo_getBatchPrint (CXfoObjPtr pXfoObj)
 Get the setting of whether print dialog box is displayed or not when printing.
void xfo_setBatchPrint (CXfoObjPtr pXfoObj, long newVal)
 When the value 'false' is specified, the print dialog box is displayed when printing.
void xfo_setDocumentText (CXfoObjPtr pXfoObj, const char *newVal)
void xfo_setDocumentTextW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
char * xfo_getStylesheetText (CXfoObjPtr pXfoObj, char *pVal, int size)
wchar_t * xfo_getStylesheetTextW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
void xfo_setStylesheetText (CXfoObjPtr pXfoObj, const char *newVal)
void xfo_setStylesheetTextW (CXfoObjPtr pXfoObj, const wchar_t *newVal)
char * xfo_getVersion (CXfoObjPtr pXfoObj, char *pVal, int size)
 Get the version string of AH Formatter.
wchar_t * xfo_getVersionW (CXfoObjPtr pXfoObj, wchar_t *pVal, int size)
 Get the version string of AH Formatter.

Detailed Description

AH Formatter C Interface.

Author:
Antenna House, Inc.
Copyright (C) 2002-2006 Antenna House, Inc. All rights reserved.

Define Documentation

#define XFOINTERFACE_API

Typedef Documentation

typedef long XfoIfErrorCode

Error Code.

typedef void* CXfoObjPtr

Pointer to XfoObj instance.

typedef void( XfoOnMessageProc)(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char *errMessage)

Error callback handler.

typedef void( XfoOnMessageProcW)(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t *errMessage)

typedef void( XfoOnFormatPageProc)(long pageNo)

typedef void( XfoOnMessageProcEx)(void *pAnyObj, XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char *errMessage)

typedef void( XfoOnMessageProcExW)(void *pAnyObj, XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t *errMessage)

typedef void( XfoOnFormatPageProcEx)(void *pAnyObj, long pageNo)

Enumeration Type Documentation

enum XfoIfErrorLevel

Error Level.

Enumerator:
ELVL_NORMAL 
ELVL_INFORMATION 
ELVL_WARNING 
ELVL_RECOVERABLE 
ELVL_FATAL 

enum XfoErrorStreamType

Error Stream Type for MessageListener.

Enumerator:
EST_NONE 
EST_STDOUT 
EST_STDERR 

enum PDFVERSION

PDF version.

Enumerator:
PDF_13 
PDF_14 
PDF_15 
PDF_16 
PDF_17 
PDFX_1a_2001 
PDFX_3_2002 
PDFX_1a_2003 
PDFX_2_2003 
PDFX_3_2003 
PDFA_1a_2005 
PDFA_1b_2005 

enum PDFENCRYPTLEVEL

PDF encrypt level.

Enumerator:
ENCLEVEL_40 
ENCLEVEL_128 

enum PDFPRINTALLOW

PDF print allow.

Enumerator:
PRALLOW_NONE 
PRALLOW_LOW 
PRALLOW_HIGH 

enum PDFIMAGECOMPRESSION

PDF image compression.

Enumerator:
IMGCMPR_AUTO 
IMGCMPR_JPEG 
IMGCMPR_ZLIB 
IMGCMPR_JPEG2K 

enum PDFRGBCONVERSION

PDF RGB conversion.

Enumerator:
RGBCONV_NONE 
RGBCONV_BLACK 
RGBCONV_GRAY 
RGBCONV_ALL 

enum EMBEDALLFONT

Embed font.

Enumerator:
EMBALLFONT_PART 
EMBALLFONT_ALL 
EMBALLFONT_BASE14 

enum IMAGEDOWNSAMPLING

Image downsampling.

Enumerator:
IMGDOWNSAMPLING_NONE 
IMGDOWNSAMPLING_AVERAGE 
IMGDOWNSAMPLING_BICUBIC 
IMGDOWNSAMPLING_SUBSAMPLING 

enum MONOCHROMECOMPRESSION

Monochrome compression.

Enumerator:
MONOCMPR_CCITT4 
MONOCMPR_CCITT3 
MONOCMPR_RUNLENGTH 
MONOCMPR_ZLIB 
MONOCMPR_OFF 

enum SVGVERSION

SVG version.

Enumerator:
SVG_11 
SVG_Basic 
SVG_Tiny 

enum IMAGEPROCTYPE

Image processing.

Enumerator:
IMGPT_EMBED_ALL 
IMGPT_COPY_ALL 
IMGPT_LINK 
IMGPT_COPY 

enum IMAGECONVERSION

Image conversion.

Enumerator:
IMGCNV_AUTO 
IMGCNV_JPEG 
IMGCNV_PNG 
IMGCNV_JPEGALL 

enum FORMATTERTYPE

Enumerator:
FMTTYP_AUTO 
FMTTYP_HTML 
FMTTYP_XHTML 
FMTTYP_XMLCSS 
FMTTYP_XSLFO 

Function Documentation

CXfoObjPtr xfo_createXfoObject (  ) 

Create instance of XfoObj.

Returns:
Pointer to XfoObj instance.

void xfo_releaseXfoObject ( CXfoObjPtr  pXfoObj  ) 

Release instance of XfoObj.

Parameters:
pXfoObj Pointer to XfoObj instance.

FORMATTERTYPE xfo_getFormatterType ( CXfoObjPtr  pXfoObj  ) 

Get formatter type.

only after Formatter 5.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
type of formatter.

void xfo_setFormatterType ( CXfoObjPtr  pXfoObj,
FORMATTERTYPE  newVal 
)

Set formatter type.

only after Formatter 5.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal type of formatter.

char* xfo_getDocumentURI ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the URL of XML document you will format.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getDocumentURIW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the URL of XML document you will format.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setDocumentURI ( CXfoObjPtr  pXfoObj,
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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the URL of XSL document.

void xfo_setDocumentURIW ( CXfoObjPtr  pXfoObj,
const wchar_t *  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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the URL of XSL document.

char* xfo_getStylesheetURI ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the URI of XSL stylesheet for formatting.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getStylesheetURIW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the URI of XSL stylesheet for formatting.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setStylesheetURI ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Specifies the URI of XSL stylesheet for formatting.

If the specified XML document is FO, or the XML file contains the processing instruction <?xml-stylesheet ...?> and the XSL stylesheet is specified, this setting is ignored. Otherwise if there is no setting of this property, an error occurs.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the URL of XSL stylesheet.

void xfo_setStylesheetURIW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Specifies the URI of XSL stylesheet for formatting.

If the specified XML document is FO, or the XML file contains the processing instruction <?xml-stylesheet ...?> and the XSL stylesheet is specified, this setting is ignored. Otherwise if there is no setting of this property, an error occurs.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the URL of XSL stylesheet.

void xfo_addUserStylesheetURI ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Append the path name of user stylesheet file which describes AH Formatter options.

Since:
5.0
Parameters:
newVal Pointer to a null-terminated string to be used as the path name of HTML user stylesheet file.

void xfo_addUserStylesheetURIW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Append the path name of user stylesheet file which describes AH Formatter options.

Since:
5.0
Parameters:
newVal Pointer to a null-terminated string to be used as the path name of HTML user stylesheet file.

char* xfo_getStylesheetTitle ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the prior stylesheet title.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getStylesheetTitleW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the prior stylesheet title.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setStylesheetTitle ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Set the prior stylesheet title.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the title of priority stylesheet.

void xfo_setStylesheetTitleW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Set the prior stylesheet title.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the title of priority stylesheet.

char* xfo_getHtmlDefaultCharset ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get html default charset.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getHtmlDefaultCharsetW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get html default charset.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setHtmlDefaultCharset ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Set html default charset.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the html default charset.

void xfo_setHtmlDefaultCharsetW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Set html default charset.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the html default charset.

char* xfo_getOutputFilePath ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the path name of the output file.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getOutputFilePathW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the path name of the output file.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setOutputFilePath ( CXfoObjPtr  pXfoObj,
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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of the output file.

void xfo_setOutputFilePathW ( CXfoObjPtr  pXfoObj,
const wchar_t *  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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of the output file.

char* xfo_getOptionFileURI ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size,
int  n 
)

Get the path name of XML-format Option setting file which describes AH Formatter options.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
n Specifies to get n-th URI. 0 means first URI.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getOptionFileURIW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size,
int  n 
)

Get the path name of XML-format Option setting file which describes AH Formatter options.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
n Specifies to get n-th URI. 0 means first URI.
Returns:
Returns the 'pVal'.

void xfo_setOptionFileURI ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Specifies the path name of XML-format Option setting file which describes AH Formatter options.

The set of former URIs is thrown away.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.

void xfo_setOptionFileURIW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Specifies the path name of XML-format Option setting file which describes AH Formatter options.

The set of former URIs is thrown away.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.

void xfo_addOptionFileURI ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Append the path name of XML-format Option setting file which describes AH Formatter options.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.

void xfo_addOptionFileURIW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Append the path name of XML-format Option setting file which describes AH Formatter options.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of XML-format Option setting file.

int xfo_getOptionFileCount ( CXfoObjPtr  pXfoObj  ) 

Get the number of URIs of XML-format Option setting file which describes AH Formatter options.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns the number of URIs.

char* xfo_getOutputFOPath ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getOutputFOPathW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setOutputFOPath ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Specifies the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.

If the input file is FO, no file is outputted. When "\@STDOUT" is specified, it is considered as stdout. If the setting is omitted, nothing outputs.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of output FO file.

void xfo_setOutputFOPathW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Specifies the output FO file as the result of XSLT when the input files are an XML document and XSL stylesheet.

If the input file is FO, no file is outputted. When "\@STDOUT" is specified, it is considered as stdout. If the setting is omitted, nothing outputs.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the path name of output FO file.

char* xfo_getExternalXSLT ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the command line of External XSLT Processor.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getExternalXSLTW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the command line of External XSLT Processor.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setExternalXSLT ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Specifies the command line of External XSLT Processor.

If this is omitted, default MSXML3 will be used. For example: 

	xslt %param -o %3 %1 %2

These meanings are as follows.

	%1 : XML Document
	%2 : XSL Stylesheet
	%3 : XSLT Output File
	%param : xsl:param
%1 to %3 are used to express only parameter positions. Do not replace them actual file names. In case you use XSL:param for external XSLT processor, set the parameter in XSLTParamFormat and SetXSLTParam.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the command line of External XSLT Processor.

void xfo_setExternalXSLTW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Specifies the command line of External XSLT Processor.

If this is omitted, default MSXML3 will be used. For example: 

	xslt %param -o %3 %1 %2

These meanings are as follows.

	%1 : XML Document
	%2 : XSL Stylesheet
	%3 : XSLT Output File
	%param : xsl:param
%1 to %3 are used to express only parameter positions. Do not replace them actual file names. In case you use XSL:param for external XSLT processor, set the parameter in XSLTParamFormat and SetXSLTParam.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the command line of External XSLT Processor.

char* xfo_getBaseURI ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the default base URI.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getBaseURIW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the default base URI.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setBaseURI ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Specifies the default base URI.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the default base URI.

void xfo_setBaseURIW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Specifies the default base URI.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the default base URI.

char* xfo_getXSLTParamFormat ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the parameter format of xsl:param when using External XSLT Processor.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getXSLTParamFormatW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the parameter format of xsl:param when using External XSLT Processor.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setXSLTParamFormat ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Specifies the parameter format of xsl:param when using External XSLT Processor.

For example: 

	 -p %p %v

These meanings are as follows.

	%p : Parameter Name
	%v : Parameter Value

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the parameter format of xsl:param when using External XSLT Processor.

void xfo_setXSLTParamFormatW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Specifies the parameter format of xsl:param when using External XSLT Processor.

For example: 

	 -p %p %v

These meanings are as follows.

	%p : Parameter Name
	%v : Parameter Value

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the parameter format of xsl:param when using External XSLT Processor.

long xfo_getStartPage ( CXfoObjPtr  pXfoObj  ) 

Get the start page number of document to output.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
start page number of output.

void xfo_setStartPage ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal start page number of output.

long xfo_getEndPage ( CXfoObjPtr  pXfoObj  ) 

Get the end page number of document to output.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
end page number of output.

void xfo_setEndPage ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal end page number of output.

void xfo_setPdfMasterPassword ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Deprecated:
Effective when outputting to PDF. Specifies the master password for PDF. The password must be within 32 bytes.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the master password.

void xfo_setPdfMasterPasswordW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Deprecated:
Effective when outputting to PDF. Specifies the master password for PDF. The password must be within 32 bytes.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the master password.

void xfo_setPdfOwnerPassword ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Effective when outputting to PDF.

Specifies the owner password for PDF. The password must be within 32 bytes.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the owner password.

void xfo_setPdfOwnerPasswordW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Effective when outputting to PDF.

Specifies the owner password for PDF. The password must be within 32 bytes.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the owner password.

void xfo_setPdfUserPassword ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Effective when outputting to PDF.

Specifies the user password for PDF. The password must be within 32 bytes.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the user password.

void xfo_setPdfUserPasswordW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Effective when outputting to PDF.

Specifies the user password for PDF. The password must be within 32 bytes.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the user password.

void xfo_setPdfNoPrinting ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Disables printing the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables printing the PDF file.

long xfo_getPdfNoPrinting ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables printing the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
If zero is returned, Enables printing the PDF file. If nonezero is returned, Disables printing the PDF file.

void xfo_setPdfNoChanging ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Disables making changes of the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables making changes of the PDF file.

long xfo_getPdfNoChanging ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables making changes of the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
If zero is returned, Enables making changes of the PDF file. If nonezero is returned, Disables making changes of the PDF file.

void xfo_setPdfNoContentCopying ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Disables copying the content of the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables copying the content of the PDF file.

long xfo_getPdfNoContentCopying ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables copying the content of the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
If zero is returned, Enables copying the content of the PDF file. If nonezero is returned, Disables copying the content of the PDF file.

void xfo_setPdfNoAddingOrChangingCommnets ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Disables adding comments and form fields to the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables adding comments and form fields to the PDF file.

long xfo_getPdfNoAddingOrChangingCommnets ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables adding comments and form fields to the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
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.

void xfo_setPdfNoAddingOrChangingComments ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Disables adding comments and form fields to the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables adding comments and form fields to the PDF file.

long xfo_getPdfNoAddingOrChangingComments ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables adding comments and form fields to the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
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.

void xfo_setPdfVersion ( CXfoObjPtr  pXfoObj,
PDFVERSION  newVal 
)

Effective when outputting to PDF.

Enables specifying whether the version of PDF is 1.3, 1.4 or 1.5.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Specifies the version of PDF.

PDFVERSION xfo_getPdfVersion ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get the version of PDF.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the version of PDF.

void xfo_setPdfNoFillForm ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables filling in of form fields and signing of the PDF file.

long xfo_getPdfNoFillForm ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables filling in of form fields and signing of the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
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.

void xfo_setPdfNoAccessibility ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables text access for screen reader devices of the PDF file.

long xfo_getPdfNoAccessibility ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables text access for screen reader devices of the PDF file.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
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.

void xfo_setPdfNoAssembleDoc ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, Disables inserting, deleting and rotating the PDF pages.

long xfo_getPdfNoAssembleDoc ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get disables inserting, deleting and rotating the PDF pages.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
If zero is returned, Enables inserting, deleting and rotating the PDF pages. If nonezero is returned, Disables inserting, deleting and rotating the PDF pages.

void xfo_setPdfEncryptLevel ( CXfoObjPtr  pXfoObj,
PDFENCRYPTLEVEL  newVal 
)

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

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Specifies the key length.

PDFENCRYPTLEVEL xfo_getPdfEncryptLevel ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Get the key length when encrypting the PDF file during outputting.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the key length.

long xfo_getPdfEmbedAllFonts ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to embed all embeddable fonts in PDF.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to embed all embeddable fonts

void xfo_setPdfEmbedAllFonts ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Embeds all embeddable fonts in PDF to create.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, Embeds all embeddable fonts

char* xfo_getPdfEmbedFonts ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the font specified to be embedded in PDF.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getPdfEmbedFontsW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the font specified to be embedded in PDF.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setPdfEmbedFonts ( CXfoObjPtr  pXfoObj,
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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal fonts specified to embed

void xfo_setPdfEmbedFontsW ( CXfoObjPtr  pXfoObj,
const wchar_t *  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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal fonts specified to embed

long xfo_getPdfErrorOnEmbedFault ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to issues the error when failing to embed fonts.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to issues the error

void xfo_setPdfErrorOnEmbedFault ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

An error is issued in case of failing to embed fonts.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, an error is issued.

long xfo_getPdfErrorOnMissingGlyph ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to issues the error when missing glyph.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to issues the error

void xfo_setPdfErrorOnMissingGlyph ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

An error is issued in case of missing glyph.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, an error is issued.

PDFPRINTALLOW xfo_getPdfPrintingAllowed ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to print the resulting PDF file or not.

Since:
3.1
PRALLOW_NONE = 0 Not Allowed
PRALLOW_LOW = 1 Low Resolution Printing
PRALLOW_HIGH = 2 High Resolution Printing

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of printing allowed

void xfo_setPdfPrintingAllowed ( CXfoObjPtr  pXfoObj,
PDFPRINTALLOW  newVal 
)

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).

Since:
3.1
PRALLOW_NONE = 0 Not Allowed
PRALLOW_LOW = 1 Low Resolution Printing
PRALLOW_HIGH = 2 High Resolution Printing

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of printing allowed

PDFIMAGECOMPRESSION xfo_getPdfImageCompression ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of how to compress the color images embedded in PDF.

Since:
3.1
IMGCMPR_AUTO = 0 Auto
IMGCMPR_JPEG = 1 JPEG compression
IMGCMPR_ZLIB = 2 ZLIB compression
IMGCMPR_JPEG2K = 3 JPEG2000 compression

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of how raster graphics are compressed and stored

void xfo_setPdfImageCompression ( CXfoObjPtr  pXfoObj,
PDFIMAGECOMPRESSION  newVal 
)

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.
When IMGCMPR_AUTO is selected, the process is automatically done and creates the image data according to the setting of xfo_setPdfJPEGQuality and xfo_setPdfRasterizeResolution. Whichever has the smaller compressed size, JPEG or ZLIB, is selected.
This is the setting for the color image. Spesify xfo_setPdfGrayscaleImageCompression for the grayscale image, and xfo_setPdfMonochromeImageCompression for the monochrome image.

Since:
3.1
IMGCMPR_AUTO = 0 Auto
IMGCMPR_JPEG = 1 JPEG compression
IMGCMPR_ZLIB = 2 ZLIB compression
IMGCMPR_JPEG2K = 3 JPEG2000 compression

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of how raster graphics are compressed and stored

int xfo_getPdfJPEGQuality ( CXfoObjPtr  pXfoObj  ) 

Gets the value of the quality of JPEG format that is specified by xfo_setPdfImageCompression() stored in PDF.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of the quality of JPEG format

void xfo_setPdfJPEGQuality ( CXfoObjPtr  pXfoObj,
int  newVal 
)

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.
CAUTION: It is not for changing the quality of a JPEG format image.
This is the setting for the color image. Spesify setPdfGrayscaleJPEGQuality for the grayscale image.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of the quality of JPEG format

long xfo_getPdfCompressContentStream ( CXfoObjPtr  pXfoObj  ) 

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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether make the size of PDF smaller or not

void xfo_setPdfCompressContentStream ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, make the PDF compress

long xfo_getPdfUseLaunchForRelativeURI ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of how to transform external link specified by the relative address in the PDF link.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of how to transform external link

void xfo_setPdfUseLaunchForRelativeURI ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, it is transformed to 'Open the file'. If zero is specified, it is transformed to 'World Wide Web link'

PDFRGBCONVERSION xfo_getPdfRGBConversion ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of how to convert the RGB color space (DebiceRGB) to DeviceGray.

Since:
3.1
RGBCONV_NONE = 0 No Conversion
RGBCONV_BLACK = 1 Black to DeviceGray
RGBCONV_GRAY = 2 Gray to DeviceGray
RGBCONV_ALL = 3 All RGB to DeviceGray

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of how to convert

void xfo_setPdfRGBConversion ( CXfoObjPtr  pXfoObj,
PDFRGBCONVERSION  newVal 
)

Effective when outputting to PDF.

Specifies how to convert the RGB color space (DeviceRGB) to DeviceGray.

Since:
3.1
RGBCONV_NONE = 0 No Conversion
RGBCONV_BLACK = 1 Black to DeviceGray
RGBCONV_GRAY = 2 Gray to DeviceGray
RGBCONV_ALL = 3 All RGB to DeviceGray

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of how to convert

int xfo_getPdfRasterizeResolution ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of the rasterised-resolution of the transformed raster images.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Rasterised-resolution

void xfo_setPdfRasterizeResolution ( CXfoObjPtr  pXfoObj,
int  newVal 
)

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.

Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Rasterised-resolution (70 to 500)

long xfo_getPdfLinearize ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to output linearize PDF or not.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to output linearize pdf or not.

void xfo_setPdfLinearize ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Specifies whether to output linearize PDF or not.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, output linearlize PDF.

long xfo_getPdfSignature ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to sign a signature to PDF or not.

Since:
4.2
Returns:
the value of whether to sign a signature to PDF or not.

void xfo_setPdfSignature ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Specifies whether to sign a signature to PDF or not.

Since:
4.2
Parameters:
newVal If the value is 'true' is specified, sign a signature to PDF.

char* xfo_getPdfSignatureName ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the value of a signature information name.

Since:
4.2
Returns:
the value of a signature information name.

wchar_t* xfo_getPdfSignatureNameW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the value of a signature information name.

Since:
4.2
Returns:
the value of a signature information name.

void xfo_setPdfSignatureName ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Effective when outputting to PDF.

Sets a signature information name.

Since:
4.2
Parameters:
newVal the value of a signature information name.

void xfo_setPdfSignatureNameW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Effective when outputting to PDF.

Sets a signature information name.

Since:
4.2
Parameters:
newVal the value of a signature information name.

char* xfo_getPdfCertificateName ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the value of a certificate information name.

Since:
4.2
Returns:
the value of a certificate information name.

wchar_t* xfo_getPdfCertificateNameW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the value of a certificate information name.

Since:
4.2
Returns:
the value of a certificate information name.

void xfo_setPdfCertificateName ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Effective when outputting to PDF.

Sets a certificate information name.

Since:
4.2
Parameters:
newVal the value of a certificate information name.

void xfo_setPdfCertificateNameW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Effective when outputting to PDF.

Sets a certificate information name.

Since:
4.2
Parameters:
newVal the value of a certificate information name.

EMBEDALLFONT xfo_getPdfEmbedAllFontsEx ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to embed all embeddable fonts

Since:
3.3
EMBALLFONT_PART = 0 Specified fonts
EMBALLFONT_ALL = 1 All fonts except Base14 fonts
EMBALLFONT_BASE14 = 2 All fonts

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to embed all embeddable fonts

void xfo_setPdfEmbedAllFontsEx ( CXfoObjPtr  pXfoObj,
EMBEDALLFONT  newVal 
)

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.

Since:
3.3
EMBALLFONT_PART = 0 Specified fonts
EMBALLFONT_ALL = 1 All fonts except Base14 fonts
EMBALLFONT_BASE14 = 2 All fonts

If the value is EMBALLFONT_PART, only fonts specified in xfo_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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of whether to embed all embeddable fonts

IMAGEDOWNSAMPLING xfo_getPdfImageDownSampling ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of method to downsample the color image

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of method to downsample the color image

void xfo_setPdfImageDownSampling ( CXfoObjPtr  pXfoObj,
IMAGEDOWNSAMPLING  newVal 
)

Effective when outputting to PDF.

Specifies the following either of method to downsample the color image that is put into PDF.

Since:
3.3
IMGDOWNSAMPLING_NONE = 0 No downsampling
IMGDOWNSAMPLING_AVERAGE = 1 Average downsamplin
IMGDOWNSAMPLING_BICUBIC = 2 Bicubic downsampling
IMGDOWNSAMPLING_SUBSAMPLING = 3 Subsampling

When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by xfo_setPdfImageDownSamplingDPI will be downsampled into the resolution specified by xfo_setPdfImageDownSamplingTarget. This is the setting for the color image. Spesify xfo_setPdfGrayscaleImageDownSampling for the grayscale image, and xfo_setPdfMonochromeImageDownSampling for the monochrome image.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of method to downsample the color image

int xfo_getPdfImageDownSamplingTarget ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets resolution when the color image is downsampled.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of resolution.

void xfo_setPdfImageDownSamplingTarget ( CXfoObjPtr  pXfoObj,
int  newVal 
)

Effective when outputting to PDF.

Set resolution when the color image is downsampled.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of resolution.

int xfo_getPdfImageDownSamplingDPI ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets resolution of the color image which performs a downsampling.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of resolution.

void xfo_setPdfImageDownSamplingDPI ( CXfoObjPtr  pXfoObj,
int  newVal 
)

Effective when outputting to PDF.

Set resolution of the color image which performs a downsampling.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of resolution.

long xfo_getPdfPutImageColorProfile ( CXfoObjPtr  pXfoObj  ) 

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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
If nonezero is specified, it is embedded. If zero is specified, it is not embedded.

void xfo_setPdfPutImageColorProfile ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Specifies whether to embed to PDF the color profile of the color image that will be embedded to PDF.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If nonezero is specified, it is embedded. If zero is specified, it is not embedded.

PDFIMAGECOMPRESSION xfo_getPdfGrayscaleImageCompression ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of how to compress the grayscale images embedded in PDF.

Since:
3.3
IMGCMPR_AUTO = 0 Auto
IMGCMPR_JPEG = 1 JPEG compression
IMGCMPR_ZLIB = 2 ZLIB compression
IMGCMPR_JPEG2K = 3 JPEG2000 compression

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of how raster graphics are compressed and stored

void xfo_setPdfGrayscaleImageCompression ( CXfoObjPtr  pXfoObj,
PDFIMAGECOMPRESSION  newVal 
)

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.
When IMGCMPR_AUTO is selected, the process is automatically done and creates the image data according to the setting of xfo_setPdfGrayscaleJPEGQuality and xfo_setPdfRasterizeResolution. Whichever has the smaller compressed size, JPEG or ZLIB, is selected.
This is the setting for the grayscale image. Spesify xfo_setPdfImageCompression for the color image, and xfo_setPdfMonochromeImageCompression for the monochrome image.

Since:
3.3
IMGCMPR_AUTO = 0 Auto
IMGCMPR_JPEG = 1 JPEG compression
IMGCMPR_ZLIB = 2 ZLIB compression
IMGCMPR_JPEG2K = 3 JPEG2000 compression

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of how raster graphics are compressed and stored

int xfo_getPdfGrayscaleJPEGQuality ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of the quality of JPEG format that is specified by xfo_setPdfGrayscaleImageCompression stored in PDF.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of the quality of JPEG format

void xfo_setPdfGrayscaleJPEGQuality ( CXfoObjPtr  pXfoObj,
int  newVal 
)

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 xfo_setPdfGrayscaleImageCompression. The quality becomes higher in proportion to the increase in the number; however the file size also becomes larger.
CAUTION: It is not for changing the quality of a JPEG format image.
This is the setting for the grayscale image. Spesify xfo_setPdfJPEGQuality for the color image.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of the quality of JPEG format

IMAGEDOWNSAMPLING xfo_getPdfGrayscaleImageDownSampling ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of method to downsample the grayscale image

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of method to downsample the grayscale image

void xfo_setPdfGrayscaleImageDownSampling ( CXfoObjPtr  pXfoObj,
IMAGEDOWNSAMPLING  newVal 
)

Effective when outputting to PDF.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal 

int xfo_getPdfGrayscaleImageDownSamplingTarget ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets resolution when the grayscale image is downsampled.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of resolution.

void xfo_setPdfGrayscaleImageDownSamplingTarget ( CXfoObjPtr  pXfoObj,
int  newVal 
)

Effective when outputting to PDF.

Specifies the following either of method to downsample the grayscale image that is put into PDF.

Since:
3.3
IMGDOWNSAMPLING_NONE = 0 No downsampling
IMGDOWNSAMPLING_AVERAGE = 1 Average downsamplin
IMGDOWNSAMPLING_BICUBIC = 2 Bicubic downsampling
IMGDOWNSAMPLING_SUBSAMPLING = 3 Subsampling

When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by xfo_setPdfGrayscaleImageDownSamplingDPI will be downsampled into the resolution specified by xfo_setPdfGrayscaleImageDownSamplingTarget. This is the setting for the grayscale image. Spesify xfo_setPdfImageDownSampling for the color image, and xfo_setPdfMonochromeImageDownSampling for the monochrome image.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of method to downsample the grayscale image

int xfo_getPdfGrayscaleImageDownSamplingDPI ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets resolution of the grayscale image which performs a downsampling.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of resolution.

void xfo_setPdfGrayscaleImageDownSamplingDPI ( CXfoObjPtr  pXfoObj,
int  newVal 
)

Effective when outputting to PDF.

Set resolution of the grayscale image which performs a downsampling.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of resolution.

MONOCHROMECOMPRESSION xfo_getPdfMonochromeImageCompression ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of how to compress the monochrome images embedded in PDF.

Since:
3.3
MONOCMPR_CCITT4 = 0 CCITTFaxDecode group 4 filter,default value
MONOCMPR_CCITT3 = 1 CCITTFaxDecode group 3 filter
MONOCMPR_RUNLENGTH = 2 RunLengthDecode filter
MONOCMPR_ZLIB = 3 FlateDecode filter
MONOCMPR_OFF = 4 no filter

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of how raster graphics are compressed and stored

void xfo_setPdfMonochromeImageCompression ( CXfoObjPtr  pXfoObj,
MONOCHROMECOMPRESSION  newVal 
)

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.
This is the setting for the monochrome image. Spesify xfo_setPdfGrayscaleImageCompression for the grayscale image, and xfo_setPdfImageCompression for the color image.

Since:
3.3
MONOCMPR_CCITT4 = 0 CCITTFaxDecode group 4 filter,default value
MONOCMPR_CCITT3 = 1 CCITTFaxDecode group 3 filter
MONOCMPR_RUNLENGTH = 2 RunLengthDecode filter
MONOCMPR_ZLIB = 3 FlateDecode filter
MONOCMPR_OFF = 4 no filter

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of how raster graphics are compressed and stored

IMAGEDOWNSAMPLING xfo_getPdfMonochromeImageDownSampling ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of method to downsample the monochrome image

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of method to downsample the monochrome image

void xfo_setPdfMonochromeImageDownSampling ( CXfoObjPtr  pXfoObj,
IMAGEDOWNSAMPLING  newVal 
)

Effective when outputting to PDF.

Specifies the following either of method to downsample the monochrome image that is put into PDF.

Since:
3.3
IMGDOWNSAMPLING_NONE = 0 No downsampling
IMGDOWNSAMPLING_AVERAGE = 1 Average downsamplin
IMGDOWNSAMPLING_BICUBIC = 2 Bicubic downsampling
IMGDOWNSAMPLING_SUBSAMPLING = 3 Subsampling

When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by xfo_setPdfMonochromeImageDownSamplingDPI will be downsampled into the resolution specified by xfo_setPdfMonochromeImageDownSamplingTarget. This is the setting for the monochrome image. Spesify xfo_setPdfImageDownSampling for the color image, and xfo_setPdfGrayscaleImageDownSampling for the grayscale image.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of method to downsample the monochrome image

int xfo_getPdfMonochromeImageDownSamplingTarget ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets resolution when the monochrome image is downsampled.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of resolution.

void xfo_setPdfMonochromeImageDownSamplingTarget ( CXfoObjPtr  pXfoObj,
int  newVal 
)

Effective when outputting to PDF.

Set resolution when the monochrome image is downsampled.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of resolution.

int xfo_getPdfMonochromeImageDownSamplingDPI ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets resolution of the monochrome image which performs a downsampling.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of resolution.

void xfo_setPdfMonochromeImageDownSamplingDPI ( CXfoObjPtr  pXfoObj,
int  newVal 
)

Effective when outputting to PDF.

Set resolution of the monochrome image which performs a downsampling.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of resolution.

long xfo_getTwoPassFormatting ( CXfoObjPtr  pXfoObj  ) 

Gets the specification of two pass format.

Since:
4.1
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the specification of two pass format.

void xfo_setTwoPassFormatting ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Set the specification of two pass format.

Since:
4.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the specification of two pass format..

long xfo_getPdfTag ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to output Tagged PDF or not.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to output Tagged pdf or not.

void xfo_setPdfTag ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

Generates Tagged PDF. Ignored if PDF cannot be tagged depending on the PDF versions.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, output Tagged PDF.

char* xfo_getPdfOutputWidth ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the width of PDF to output.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getPdfOutputWidthW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the width of PDF to output.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setPdfOutputWidth ( CXfoObjPtr  pXfoObj,
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.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the width of PDF to output.

void xfo_setPdfOutputWidthW ( CXfoObjPtr  pXfoObj,
const wchar_t *  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.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the width of PDF to output.

char* xfo_getPdfOutputHeight ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the height of PDF to output.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getPdfOutputHeightW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to PDF.

Gets the height of PDF to output.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setPdfOutputHeight ( CXfoObjPtr  pXfoObj,
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.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the width of PDF to output.

void xfo_setPdfOutputHeightW ( CXfoObjPtr  pXfoObj,
const wchar_t *  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.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the width of PDF to output.

long xfo_getPdfErrorOnPDFXFault ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to PDF.

Gets the value of whether to issue error or not when PDF/X is generating.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to issue error.

void xfo_setPdfErrorOnPDFXFault ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to PDF.

An error is not issued when PDF/X is generating.

Since:
4.0
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, no error is issued.

SVGVERSION xfo_getSvgVersion ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Get the version of SVG.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the version of SVG.

void xfo_setSvgVersion ( CXfoObjPtr  pXfoObj,
SVGVERSION  newVal 
)

Effective when outputting to SVG.

Enables specifying whether the version of SVG is 1.1, Basic or Tiny.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Specifies the version of SVG.

long xfo_getSvgGzipCompression ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets the setting indicating whether to compress the outputted SVG into gzip format or not.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
whether gzip compression or not.

void xfo_setSvgGzipCompression ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to SVG.

Specifies whether to compress the outputted SVG into gzip format or not.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, enables to compress data into gzip format.

long xfo_getSvgEmbedAllFonts ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets the setting indicating whether to embed fonts in the outputted SVG.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
whether embeds fonts or not.

void xfo_setSvgEmbedAllFonts ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to SVG.

Specifies whether to embed fonts in the outputted SVG.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, embeds fonts.

char* xfo_getSvgFormat ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the format for naming files when the outputted SVG becomes multiple.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getSvgFormatW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the format for naming files when the outputted SVG becomes multiple.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setSvgFormat ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Effective when outputting to SVG.

Specifies the format for naming files when the outputted SVG becomes multiple.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the SVG file name format.

void xfo_setSvgFormatW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Effective when outputting to SVG.

Specifies the format for naming files when the outputted SVG becomes multiple.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the SVG file name format.

char* xfo_getSvgEmbedFonts ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the font specified to be embedded in SVG.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getSvgEmbedFontsW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the font specified to be embedded in SVG.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setSvgEmbedFonts ( CXfoObjPtr  pXfoObj,
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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal fonts specified to embed

void xfo_setSvgEmbedFontsW ( CXfoObjPtr  pXfoObj,
const wchar_t *  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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal fonts specified to embed

long xfo_getSvgErrorOnEmbedFault ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets the value of whether to issues the error when failing to embed fonts.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of whether to issues the error

void xfo_setSvgErrorOnEmbedFault ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to SVG.

An error is issued in case of failing to embed fonts.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If the value is 'true' is specified, an error is issued.

IMAGECONVERSION xfo_getSvgImageConversion ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets the value of how to compress the images embedded in SVG.

Since:
3.3
IMGCMPR_AUTO = 0 Auto conversion
IMGCMPR_JPEG = 1 JPEG conversion
IMGCMPR_PNG = 2 PNG conversion

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of how raster graphics are compressed and stored

void xfo_setSvgImageConversion ( CXfoObjPtr  pXfoObj,
IMAGECONVERSION  newVal 
)

Effective when outputting to SVG.

Selects how to compress the images embedded in SVG to create from the following.

Since:
3.3
IMGCMPR_AUTO = 0 Auto conversion
IMGCMPR_JPEG = 1 JPEG conversion
IMGCMPR_PNG = 2 PNG conversion

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the value of how raster graphics are compressed and stored

int xfo_getSvgJPEGQuality ( CXfoObjPtr  pXfoObj  ) 

Gets the value of the quality of JPEG format that is specified by xfo_setSvgImageConversion() stored in SVG.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
the value of the quality

void xfo_setSvgJPEGQuality ( CXfoObjPtr  pXfoObj,
int  newVal 
)

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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal JPEG quality (1 to 100)

IMAGEPROCTYPE xfo_getSvgImageProcessingType ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets specification how to treat the referred image.

Since:
3.3
IMGPT_EMBED_ALL = 0 Embeds all images to SVG.
IMGPT_COPY_ALL = 1 Copies all image files to the destination that is specified by setSvgImageCopyPath, and then links.
IMGPT_LINK = 2 Links images that have been linked, and embeds the embedded image. However, the raster images other than JPEG and PNG are always embedded.
IMGPT_COPY = 3 Copies images that have been linked to the destination that is specified by setSvgImageCopyPath, and links. The embedded image are embedded.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
specification how to treat the referred image.

void xfo_setSvgImageProcessingType ( CXfoObjPtr  pXfoObj,
IMAGEPROCTYPE  newVal 
)

Effective when outputting to SVG.

Specifies how to treat the referred image.

Since:
3.3
IMGPT_EMBED_ALL = 0 Embeds all images to SVG.
IMGPT_COPY_ALL = 1 Copies all image files to the destination that is specified by setSvgImageCopyPath, and then links.
IMGPT_LINK = 2 Links images that have been linked, and embeds the embedded image. However, the raster images other than JPEG and PNG are always embedded.
IMGPT_COPY = 3 Copies images that have been linked to the destination that is specified by setSvgImageCopyPath, and links. The embedded image are embedded.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal specification how to treat the referred image.

char* xfo_getSvgImageCopyPath ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by xfo_setSvgImageProcessingType.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setSvgImageCopyPath ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Effective when outputting to SVG.

Specifies the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by xfo_setSvgImageProcessingType.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as image copy path

wchar_t* xfo_getSvgImageCopyPathW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by xfo_setSvgImageProcessingType.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setSvgImageCopyPathW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Effective when outputting to SVG.

Specifies the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by xfo_setSvgImageProcessingType.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as image copy path

long xfo_getSvgSingleFile ( CXfoObjPtr  pXfoObj  ) 

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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages.

void xfo_setSvgSingleFile ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.
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.
Effective only when outputting to the file. It is invalid in the output without the file name like the stream etc.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages.

long xfo_getSvgImageRename ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets specification whether to rename all file name to prefix specified by xfo_setSvgImagePrefix, or use original name.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
specification whether to rename all file name to prefix specified by xfo_setSvgImagePrefix, or use original name.

void xfo_setSvgImageRename ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Effective when outputting to SVG.

When images are copied to the directory specified by xfo_setSvgImageCopyPath etc. and processed, specifies whether to rename all file name to prefix specified by xfo_setSvgImagePrefix, or use original name. When the file name overlaps, sequential number is added. When true is specified, all files are renamed.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal specification whether to rename all file name to prefix specified by xfo_setSvgImagePrefix, or use original name.

char* xfo_getSvgImagePrefix ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the prefix of the file name when images are copied to the directory specified by xfo_setSvgImageCopyPath and processed.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setSvgImagePrefix ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Effective when outputting to SVG.

When images are copied to the directory specified by xfo_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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the prefix of the file name.

wchar_t* xfo_getSvgImagePrefixW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Effective when outputting to SVG.

Gets the prefix of the file name when images are copied to the directory specified by xfo_setSvgImageCopyPath and processed.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setSvgImagePrefixW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Effective when outputting to SVG.

When images are copied to the directory specified by xfo_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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the prefix of the file name.

long xfo_getSvgSinglePageNumber ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets specification whether to add sequential number to the output SVG even if it has only one-page.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
specification whether to add sequential number to the output SVG even if it has only one-page.

void xfo_setSvgSinglePageNumber ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal specification whether to add sequential number to the output SVG even if it has only one-page.

int xfo_getSvgRasterizeResolution ( CXfoObjPtr  pXfoObj  ) 

Effective when outputting to SVG.

Gets the value of the rasterised-resolution of the transformed raster images.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Rasterised-resolution

void xfo_setSvgRasterizeResolution ( CXfoObjPtr  pXfoObj,
int  newVal 
)

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.

Since:
3.3
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Rasterised-resolution (70 to 500)

long xfo_getStartVolume ( CXfoObjPtr  pXfoObj  ) 

Get the start volume of document to output.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
start volume of output.

void xfo_setStartVolume ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Specifies the start volume of document to output.

If the start volume is omitted or the specified value is 0 or less, the start volume is considered from the first volume. If the setting is inconsistent, (for example, StartVolume=5 EndVolume=3) an error occurs.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal start volume of output.

long xfo_getEndVolume ( CXfoObjPtr  pXfoObj  ) 

Get the end volume of document to output.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
end volume of output.

void xfo_setEndVolume ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Specifies the end volume of document to output.

If the end volume is omitted or the specified value exceeds the actual volume number, the end volume is considered as the last volume. If the setting is inconsistent, (for example, StartVolume=5 EndVolume=3) an error occurs.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal end volume of output.

long xfo_getMultiVolume ( CXfoObjPtr  pXfoObj  ) 

Get multiple volume of PDF output.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
If zero is returned, multiple volume don't specified. If nonezero is returned, multiple volume specified.

long xfo_getTotalVolumeCount ( CXfoObjPtr  pXfoObj  ) 

Gets the number of all the separate volumes when outputting PDF to multiple separate volumes.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns total volume count.

long xfo_getOutputVolumeCount ( CXfoObjPtr  pXfoObj  ) 

Gets the number of the actual separate volumes when outputting PDF to multiple separate volumes.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns output volume count.

void xfo_setMultiVolume ( CXfoObjPtr  pXfoObj,
long  newVal 
)

Specifies multiple volume of PDF output.

Since:
3.2
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Zpecifies zero or nonzero.

XfoIfErrorLevel xfo_getExitLevel ( CXfoObjPtr  pXfoObj  ) 

Get the error level to abort formatting process.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns the error level.

void xfo_setExitLevel ( CXfoObjPtr  pXfoObj,
XfoIfErrorLevel  newVal 
)

Error level to abort formatting process.

AH Formatter 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.

ELVL_INFORMATION = 1 Information
ELVL_WARNING = 2 Warning
ELVL_RECOVERABLE = 3 Recoveable Error
ELVL_FATAL = 4 Fatal Error

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal error level to abort formatting process.

XfoIfErrorLevel xfo_getErrorLevel ( CXfoObjPtr  pXfoObj  ) 

Returns the error level of the error that occurred during the formatting process.

ELVL_INFORMATION = 1 Information
ELVL_WARNING = 2 Warning
ELVL_RECOVERABLE = 3 Recoveable Error
ELVL_FATAL = 4 Fatal Error

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns the error level.

XfoIfErrorCode xfo_getErrorCode ( CXfoObjPtr  pXfoObj  ) 

Returns the error code of the error that occurred during the formatting process.

Zero means no error. Non-zero indicates any error occurred.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns the error code.

char* xfo_getErrorMessage ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Returns the error message of the error that occurred during the formatting process.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getErrorMessageW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Returns the error message of the error that occurred during the formatting process.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setFontAlias ( CXfoObjPtr  pXfoObj,
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'.

Parameters:
pXfoObj Pointer to XfoObj instance.
src Specifies the font name which is replaced.
dst Specifies the aliasName.

void xfo_setFontAliasW ( CXfoObjPtr  pXfoObj,
const wchar_t *  src,
const wchar_t *  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'.

Parameters:
pXfoObj Pointer to XfoObj instance.
src Specifies the font name which is replaced.
dst Specifies the aliasName.

void xfo_clearFontAlias ( CXfoObjPtr  pXfoObj  ) 

Clear all substitutions of font name.

Parameters:
pXfoObj Pointer to XfoObj instance.

void xfo_eraseFontAlias ( CXfoObjPtr  pXfoObj,
const char *  src 
)

Clear all substitutions of font name.

Parameters:
pXfoObj Pointer to XfoObj instance. Erase the substitution of font name 'fontName'.
pXfoObj Pointer to XfoObj instance.
src Specifies the font name which is replaced.

void xfo_eraseFontAliasW ( CXfoObjPtr  pXfoObj,
const wchar_t *  src 
)

XfoIfErrorCode xfo_execute ( CXfoObjPtr  pXfoObj  ) 

Execute formatting and output to a PDF specified in OutputFilePath or printer specified in PrinterName.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns the error code. Zero means no error. Non-zero indicates any error occurred.

void xfo_clear ( CXfoObjPtr  pXfoObj  ) 

Initialize formatting engine.

Parameters:
pXfoObj Pointer to XfoObj instance.

void xfo_setOnMessageProc ( CXfoObjPtr  pXfoObj,
XfoOnMessageProc *  proc 
)

Specifies the callback fucntion.

The error that occurred during the formatting process can be received.

Parameters:
pXfoObj Pointer to XfoObj instance.
proc Address of the callback function.
Callback function has the following form:
 void XfoOnMessageProc(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char* errMessage);
 void XfoOnMessageProcW(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t* errMessage);

void xfo_setOnMessageProcW ( CXfoObjPtr  pXfoObj,
XfoOnMessageProcW *  proc 
)

Specifies the callback fucntion.

The error that occurred during the formatting process can be received.

Parameters:
pXfoObj Pointer to XfoObj instance.
proc Address of the callback function.
Callback function has the following form:
 void XfoOnMessageProc(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char* errMessage);
 void XfoOnMessageProcW(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t* errMessage);

void xfo_setOnFormatPageProc ( CXfoObjPtr  pXfoObj,
XfoOnFormatPageProc *  proc 
)

Specifies the callback fucntion.

The page number in the formatting process can be received.

Parameters:
pXfoObj Pointer to XfoObj instance.
proc Address of the callback function.
Callback function has the following form:
 void XfoOnFormatPageProc(long pageNo);

void xfo_setOnMessageProcEx ( CXfoObjPtr  pXfoObj,
XfoOnMessageProcEx *  proc,
void *  pAnyObj 
)

Specifies the callback fucntion.

The error that occurred during the formatting process can be received.

Parameters:
pXfoObj Pointer to XfoObj instance.
proc Address of the callback function.
Callback function has the following form:
 void XfoOnMessageProc(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char* errMessage);
 void XfoOnMessageProcW(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t* errMessage);
pAnyObj Address of an any object.

void xfo_setOnMessageProcExW ( CXfoObjPtr  pXfoObj,
XfoOnMessageProcExW *  proc,
void *  pAnyObj 
)

Specifies the callback fucntion.

The error that occurred during the formatting process can be received.

Parameters:
pXfoObj Pointer to XfoObj instance.
proc Address of the callback function.
Callback function has the following form:
 void XfoOnMessageProc(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const char* errMessage);
 void XfoOnMessageProcW(XfoIfErrorLevel errLevel, XfoIfErrorCode errCode, const wchar_t* errMessage);
pAnyObj Address of an any object.

void xfo_setOnFormatPageProcEx ( CXfoObjPtr  pXfoObj,
XfoOnFormatPageProcEx *  proc,
void *  pAnyObj 
)

Specifies the callback fucntion.

The page number in the formatting process can be received.

Parameters:
pXfoObj Pointer to XfoObj instance.
proc Address of the callback function.
Callback function has the following form:
 void XfoOnFormatPageProc(long pageNo);
pAnyObj Address of an any object.

void xfo_setXSLTParam ( CXfoObjPtr  pXfoObj,
const char *  paramName,
const char *  value 
)

Set parameter name and value for xsl:param.

Parameters:
pXfoObj Pointer to XfoObj instance.
paramName name.
value parameter value.

void xfo_setXSLTParamW ( CXfoObjPtr  pXfoObj,
const wchar_t *  paramName,
const wchar_t *  value 
)

Set parameter name and value for xsl:param.

Parameters:
pXfoObj Pointer to XfoObj instance.
paramName name.
value parameter value.

void xfo_clearXSLTParam ( CXfoObjPtr  pXfoObj  ) 

Clear all parameter name and value for xsl:param.

Parameters:
pXfoObj Pointer to XfoObj instance.

XfoErrorStreamType xfo_getErrorStreamType ( CXfoObjPtr  pXfoObj  ) 

Get the error output type.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Error output type.

void xfo_setErrorStreamType ( CXfoObjPtr  pXfoObj,
XfoErrorStreamType  type 
)

Set the error output type.

Parameters:
pXfoObj Pointer to XfoObj instance.
type Error output type.
OST_NONE : No error output
OST_STDOUT : Error output to stdout
OST_STDERR : Error output to stderr

char* xfo_getPrinterName ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the printer name where the formatted result is outputted.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getPrinterNameW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the printer name where the formatted result is outputted.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setPrinterName ( CXfoObjPtr  pXfoObj,
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 "\@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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the printer name.

void xfo_setPrinterNameW ( CXfoObjPtr  pXfoObj,
const wchar_t *  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 "\@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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the printer name.

long xfo_getFormattedPages ( CXfoObjPtr  pXfoObj  ) 

Get formatted total pages.

Returns:
the value of formatted total pages.

char* xfo_getPrinterSettingURI ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the printer setting file URI.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getPrinterSettingURIW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the printer setting file URI.

Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setPrinterSettingURI ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Specifies the printer setting file URI.

This setting is effective only with Windows version.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the printer name.

void xfo_setPrinterSettingURIW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Specifies the printer setting file URI.

This setting is effective only with Windows version.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the printer name.

long xfo_getPrnCopies ( CXfoObjPtr  pXfoObj  ) 

Get the number of copies.

Effective when outputting to printer.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
Returns the number of copies.

void xfo_setPrnCopies ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal the number of copies.

long xfo_getPrnCollate ( CXfoObjPtr  pXfoObj  ) 

Get collation of multiple copies.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
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.

void xfo_setPrnCollate ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Zpecifies zero or nonzero.

long xfo_getBatchPrint ( CXfoObjPtr  pXfoObj  ) 

Get the setting of whether print dialog box is displayed or not when printing.

Parameters:
pXfoObj Pointer to XfoObj instance.
Returns:
If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.

void xfo_setBatchPrint ( CXfoObjPtr  pXfoObj,
long  newVal 
)

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.

Parameters:
pXfoObj Pointer to XfoObj instance.
newVal If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.

void xfo_setDocumentText ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Deprecated:
Specifies the XML document you will format. MSXML3/MSXML4 is required when formatting. This setting is effective only with Windows version.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the text of XML document.

void xfo_setDocumentTextW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Deprecated:
Specifies the XML document you will format. MSXML3/MSXML4 is required when formatting. This setting is effective only with Windows version.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the text of XML document.

char* xfo_getStylesheetText ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Deprecated:
Get the text of XSL stylesheet for formatting.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getStylesheetTextW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Deprecated:
Get the text of XSL stylesheet for formatting.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

void xfo_setStylesheetText ( CXfoObjPtr  pXfoObj,
const char *  newVal 
)

Deprecated:
Specifies the text of XSL stylesheet for formatting. If the specified XML document is FO, or the XML file contains the processing instruction <?xml-stylesheet ...?> and the XSL stylesheet is specified, this setting is ignored. Otherwise if there is no setting of this property, an error occurs. MSXML3/MSXML4 is required when formatting. This setting is effective only with Windows version.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the text of XSL stylesheet.

void xfo_setStylesheetTextW ( CXfoObjPtr  pXfoObj,
const wchar_t *  newVal 
)

Deprecated:
Specifies the text of XSL stylesheet for formatting. If the specified XML document is FO, or the XML file contains the processing instruction <?xml-stylesheet ...?> and the XSL stylesheet is specified, this setting is ignored. Otherwise if there is no setting of this property, an error occurs. MSXML3/MSXML4 is required when formatting. This setting is effective only with Windows version.
Since:
3.1
Parameters:
pXfoObj Pointer to XfoObj instance.
newVal Pointer to a null-terminated string to be used as the text of XSL stylesheet.

char* xfo_getVersion ( CXfoObjPtr  pXfoObj,
char *  pVal,
int  size 
)

Get the version string of AH Formatter.

Since:
4.0MR4
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

wchar_t* xfo_getVersionW ( CXfoObjPtr  pXfoObj,
wchar_t *  pVal,
int  size 
)

Get the version string of AH Formatter.

Since:
4.0MR4
Parameters:
pXfoObj Pointer to XfoObj instance.
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.
size Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
Returns:
Returns the 'pVal'.

Generated on 19 Mar 2009 for AHFormatter C/C++ Interface by Doxygen 1.5.5