Main Page   Namespace List   Compound List   File List   Compound Members   File Members   Related Pages  

dfvifc_c.h

Go to the documentation of this file.
00001 /**
00002  * @file    dfvifc_c.h
00003  * @brief   SBC C Interface
00004  *
00005  * @author  Antenna House, Inc.
00006  *
00007  * Copyright (C) 2002-2013 Antenna House, Inc. All rights reserved.
00008  */
00009 
00010 #ifndef DFVIFC_C_H__
00011 #define DFVIFC_C_H__
00012 
00013 #include <stddef.h>
00014 
00015 #if !defined(_DOXYGEN) && defined(_MSC_VER) && defined(_WIN32)
00016     #ifdef DFVINTERFACE_EXPORTS
00017         #define DFVINTERFACE_API    __declspec( dllexport )
00018     #else
00019         #define DFVINTERFACE_API    __declspec( dllimport )
00020     #endif
00021 #else
00022     #define DFVINTERFACE_API
00023 #endif
00024 
00025 /**
00026  * Error Code
00027  */
00028 typedef long DfvIfErrorCode;    /* 0 means no error */
00029 
00030 /**
00031  * Error Level
00032  */
00033 typedef enum {
00034     ELVL_NORMAL         = 0,    /* no error */
00035     ELVL_INFORMATION    = 1,
00036     ELVL_WARNING        = 2,
00037     ELVL_RECOVERABLE    = 3,
00038     ELVL_FATAL          = 4
00039 } DfvIfErrorLevel;
00040 
00041 /**
00042  * Error Stream Type for MessageListener
00043  */
00044 typedef enum {
00045     EST_NONE,               /* no output */
00046     EST_STDOUT,             /* output to stdout */
00047     EST_STDERR              /* output to stderr */
00048 } DfvErrorStreamType;
00049 
00050 /**
00051  * PDF version
00052  */
00053 typedef enum  {
00054     PDF_13,                 /* PDF 1.3 */
00055     PDF_14,                 /* PDF 1.4 */
00056     PDF_15,                 /* PDF 1.5 */
00057     PDF_16,                 /* PDF 1.6 */
00058     PDF_17,                 /* PDF 1.7 */
00059     PDF_20 = 10,            /* PDF 2.0 (ISO 32000-2:2017) */
00060     PDFA_1b_2005 = 400      /* ISO 19005-1:2005 (based on PDF1.4) */
00061     ,PDFA_2b_2011 = 602     /* ISO 19005-2:2011 (based on PDF1.7) */
00062 } DfvPDFVERSION;
00063 
00064 /**
00065  * PDF encrypt level
00066  */
00067 typedef enum  {
00068     ENCLEVEL_40RC4 = 0, /* 40-bit RC4 */
00069     ENCLEVEL_128RC4, /* 128-bit RC4 */
00070     ENCLEVEL_128AES, /* 128-bit AES */
00071     ENCLEVEL_256AES, /* 256-bit AES */
00072     ENCLEVEL_40 = ENCLEVEL_40RC4,
00073     ENCLEVEL_128 = ENCLEVEL_128RC4
00074 } DfvPDFENCRYPTLEVEL;
00075 
00076 /**
00077  * PDF print allow
00078  */
00079 typedef enum {
00080     PRALLOW_NONE,           /* not allowed */
00081     PRALLOW_LOW,            /* low resolution printing */
00082     PRALLOW_HIGH            /* high resolution printing */
00083 } DfvPDFPRINTALLOW;
00084 
00085 /**
00086  * PDF image compression
00087  */
00088 typedef enum {
00089     IMGCMPR_AUTO,           /* auto */
00090     IMGCMPR_JPEG,           /* JPEG */
00091     IMGCMPR_ZLIB,           /* ZLIB */
00092     IMGCMPR_JPEG2K          /* JPEG2000 */
00093 } DfvPDFIMAGECOMPRESSION;
00094 
00095 /**
00096  * PDF RGB conversion
00097  */
00098 typedef enum {
00099     RGBCONV_NONE,           /* no conversion */
00100     RGBCONV_BLACK,          /* black to devicegray */
00101     RGBCONV_GRAY,           /* gray to devicegray */
00102     RGBCONV_ALL             /* all rgb to devicegray */
00103 } DfvPDFRGBCONVERSION;
00104 
00105 /**
00106  * Embed font
00107  */
00108 typedef enum {
00109     EMBALLFONT_PART,        /* specified fonts */
00110     EMBALLFONT_ALL,         /* all fonts except Base14 fonts */
00111     EMBALLFONT_BASE14       /* all fonts */
00112 } DfvEMBEDALLFONT;
00113 
00114 /**
00115  * Image downsampling
00116  */
00117 typedef enum {
00118     IMGDOWNSAMPLING_NONE,       /* no downsampling */
00119     IMGDOWNSAMPLING_AVERAGE,    /* average downsampling */
00120     IMGDOWNSAMPLING_BICUBIC,    /* bicubic downsampling */
00121     IMGDOWNSAMPLING_SUBSAMPLING /* subsampling */
00122 } DfvIMAGEDOWNSAMPLING;
00123 
00124 /**
00125  * Monochrome compression
00126  */
00127 typedef enum {
00128     MONOCMPR_CCITT4,        /* CCITTFaxDecode group 4 filter,default value */
00129     MONOCMPR_CCITT3,        /* CCITTFaxDecode group 3 filter */
00130     MONOCMPR_RUNLENGTH,     /* RunLengthDecode filter */
00131     MONOCMPR_ZLIB,          /* FlateDecode filter */
00132     MONOCMPR_OFF            /* no filter */
00133 } DfvMONOCHROMECOMPRESSION;
00134 
00135 /**
00136  * SVG version
00137  */
00138 typedef enum {
00139     SVG_11,                 /* SVG 1.1 */
00140     SVG_Basic,              /* SVG Basic */
00141     SVG_Tiny                /* SVG Tiny */
00142 } DfvSVGVERSION;
00143 
00144 /**
00145  * Image processing
00146  */
00147 typedef enum {
00148     IMGPT_EMBED_ALL,        /* embed all */
00149     IMGPT_COPY_ALL,         /* copy all */
00150     IMGPT_LINK,             /* link */
00151     IMGPT_COPY              /* copy */
00152 } DfvIMAGEPROCTYPE;
00153 
00154 /**
00155  * Image conversion
00156  */
00157 typedef enum {
00158     IMGCNV_AUTO,            /* auto */
00159     IMGCNV_JPEG,            /* jpeg conversion except png */
00160     IMGCNV_PNG,             /* png conversion except jpeg */
00161     IMGCNV_JPEGALL          /* jpeg-all conversion */
00162 } DfvIMAGECONVERSION;
00163 
00164 /**
00165  * INX output mode
00166  */
00167 typedef enum  {
00168     INXOM_TEXT,             /* text area output mode */
00169     INXOM_LINE,             /* line area output */
00170     INXOM_BLOCK             /* block area output */
00171 } DfvINXOUTPUTMODE;
00172 
00173 /**
00174  * MIF output mode
00175  */
00176 typedef enum  {
00177     MIFOM_TEXT,             /* text area output mode */
00178     MIFOM_LINE,             /* line area output */
00179     MIFOM_BLOCK             /* block area output */
00180 } DfvMIFOUTPUTMODE;
00181 
00182 /***************************************************************
00183  * format information
00184  */
00185 
00186 #ifdef __cplusplus
00187 extern "C" {
00188 #endif
00189 
00190 /** Pointer to DfvObj instance. */
00191 typedef void*   CDfvObjPtr;
00192 
00193 /**
00194  * Error callback handler
00195  */
00196 typedef void (DfvOnMessageProc)(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
00197 typedef void (DfvOnMessageProcW)(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);
00198 typedef void (DfvOnFormatPageProc)(long pageNo);
00199 
00200 typedef void (DfvOnMessageProcEx)(void* pAnyObj, DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
00201 typedef void (DfvOnMessageProcExW)(void* pAnyObj, DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);
00202 typedef void (DfvOnFormatPageProcEx)(void* pAnyObj, long pageNo);
00203 
00204 /**
00205  * Create instance of DfvObj
00206  *
00207  * @return  Pointer to DfvObj instance.
00208  */
00209 DFVINTERFACE_API CDfvObjPtr dfv_createDfvObject();
00210 
00211 /**
00212  * Release instance of DfvObj
00213  *
00214  * @param   pDfvObj Pointer to DfvObj instance.
00215  */
00216 DFVINTERFACE_API void dfv_releaseDfvObject(CDfvObjPtr pDfvObj);
00217 
00218 /**
00219  * Get the URL of document you will format.
00220  *
00221  * @param   pDfvObj Pointer to DfvObj instance.
00222  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
00223  *            the string is truncated and terminated with a NULL character.
00224  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00225  * @return  Returns the 'pVal'.
00226  */
00227 DFVINTERFACE_API char* dfv_getDocumentURI(CDfvObjPtr pDfvObj, char* pVal, int size);
00228 /**
00229  * Get the URL of document you will format.
00230  *
00231  * @param   pDfvObj Pointer to DfvObj instance.
00232  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
00233  *            the string is truncated and terminated with a NULL character.
00234  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00235  * @return  Returns the 'pVal'.
00236  */
00237 DFVINTERFACE_API wchar_t* dfv_getDocumentURIW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
00238 
00239 /**
00240  * Specifies the URL of document you will format.
00241  * If it is omitted or "\@STDIN" is specified, document is loaded from stdin.
00242  * The document loaded from stdin are supposed to be FO files.
00243  *
00244  * @param   pDfvObj Pointer to DfvObj instance.
00245  * @param   newVal  Pointer to a null-terminated string to be used as the URL of XSL document.
00246  */
00247 DFVINTERFACE_API void dfv_setDocumentURI(CDfvObjPtr pDfvObj, const char* newVal);
00248 /**
00249  * Specifies the URL of document you will format.
00250  * If it is omitted or "\@STDIN" is specified, document is loaded from stdin.
00251  * The document loaded from stdin are supposed to be FO files.
00252  *
00253  * @param   pDfvObj Pointer to DfvObj instance.
00254  * @param   newVal  Pointer to a null-terminated string to be used as the URL of XSL document.
00255  */
00256 DFVINTERFACE_API void dfv_setDocumentURIW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
00257 
00258 /**
00259  * Get the path name of the output file.
00260  *
00261  * @param   pDfvObj Pointer to DfvObj instance.
00262  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
00263  *            the string is truncated and terminated with a NULL character.
00264  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00265  * @return  Returns the 'pVal'.
00266  */
00267 DFVINTERFACE_API char* dfv_getOutputFilePath(CDfvObjPtr pDfvObj, char* pVal, int size);
00268 /**
00269  * Get the path name of the output file.
00270  *
00271  * @param   pDfvObj Pointer to DfvObj instance.
00272  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
00273  *            the string is truncated and terminated with a NULL character.
00274  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00275  * @return  Returns the 'pVal'.
00276  */
00277 DFVINTERFACE_API wchar_t* dfv_getOutputFilePathW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
00278 
00279 /**
00280  * Specifies the path name of the output file. When "\@STDOUT" is specified, it is considered as stdout.
00281  * If both the printer name and  this property are specified, the formatted result will be stored in
00282  * the file by the printer driver.
00283  * When "\@PDF" is specified as output, the PDF is stored in the file specified by this property.
00284  * If the property is not specified, it is considered as stdout.
00285  *
00286  * @param   pDfvObj Pointer to DfvObj instance.
00287  * @param   newVal  Pointer to a null-terminated string to be used as the path name of the output file.
00288  */
00289 DFVINTERFACE_API void dfv_setOutputFilePath(CDfvObjPtr pDfvObj, const char* newVal);
00290 /**
00291  * Specifies the path name of the output file. When "\@STDOUT" is specified, it is considered as stdout.
00292  * If both the printer name and  this property are specified, the formatted result will be stored in
00293  * the file by the printer driver.
00294  * When "\@PDF" is specified as output, the PDF is stored in the file specified by this property.
00295  * If the property is not specified, it is considered as stdout.
00296  *
00297  * @param   pDfvObj Pointer to DfvObj instance.
00298  * @param   newVal  Pointer to a null-terminated string to be used as the path name of the output file.
00299  */
00300 DFVINTERFACE_API void dfv_setOutputFilePathW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
00301 
00302 /**
00303  * Get the path name of format Option setting file which describes Office Server Document Converter options.
00304  *
00305  * @param   pDfvObj Pointer to DfvObj instance.
00306  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
00307  *            the string is truncated and terminated with a NULL character.
00308  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00309  * @param   n       Specifies to get n-th URI. 0 means first URI.
00310  * @return  Returns the 'pVal'.
00311  */
00312 DFVINTERFACE_API char* dfv_getOptionFileURI(CDfvObjPtr pDfvObj, char* pVal, int size, int n);
00313 /**
00314  * Get the path name of format Option setting file which describes Office Server Document Converter options.
00315  *
00316  * @param   pDfvObj Pointer to DfvObj instance.
00317  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
00318  *            the string is truncated and terminated with a NULL character.
00319  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00320  * @param   n       Specifies to get n-th URI. 0 means first URI.
00321  * @return  Returns the 'pVal'.
00322  */
00323 DFVINTERFACE_API wchar_t* dfv_getOptionFileURIW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size, int n);
00324 
00325 /**
00326  * Specifies the path name of format Option setting file which describes Office Server Document Converter options.
00327  * The set of former URIs is thrown away.
00328  *
00329  * @param   pDfvObj Pointer to DfvObj instance.
00330  * @param   newVal  Pointer to a null-terminated string to be used as the path name of format Option setting file.
00331  */
00332 DFVINTERFACE_API void dfv_setOptionFileURI(CDfvObjPtr pDfvObj, const char* newVal);
00333 /**
00334  * Specifies the path name of format Option setting file which describes Office Server Document Converter options.
00335  * The set of former URIs is thrown away.
00336  *
00337  * @param   pDfvObj Pointer to DfvObj instance.
00338  * @param   newVal  Pointer to a null-terminated string to be used as the path name of format Option setting file.
00339  */
00340 DFVINTERFACE_API void dfv_setOptionFileURIW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
00341 
00342 /**
00343  * Append the path name of format Option setting file which describes Office Server Document Converter options.
00344  * 
00345  *
00346  * @param   pDfvObj Pointer to DfvObj instance.
00347  * @param   newVal  Pointer to a null-terminated string to be used as the path name of format Option setting file.
00348  */
00349 DFVINTERFACE_API void dfv_addOptionFileURI(CDfvObjPtr pDfvObj, const char* newVal);
00350 /**
00351  * Append the path name of format Option setting file which describes Office Server Document Converter options.
00352  * 
00353  *
00354  * @param   pDfvObj Pointer to DfvObj instance.
00355  * @param   newVal  Pointer to a null-terminated string to be used as the path name of format Option setting file.
00356  */
00357 DFVINTERFACE_API void dfv_addOptionFileURIW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
00358 
00359 /**
00360  * Get the number of URIs of format Option setting file which describes Office Server Document Converter options.
00361  * 
00362  *
00363  * @param   pDfvObj Pointer to DfvObj instance.
00364  * @return  Returns the number of URIs.
00365  */
00366 DFVINTERFACE_API int dfv_getOptionFileCount(CDfvObjPtr pDfvObj);
00367 
00368 /**
00369  * Get the start page number of document to output.
00370  *
00371  * @param   pDfvObj Pointer to DfvObj instance.
00372  * @return  start page number of output.
00373  */
00374 DFVINTERFACE_API long dfv_getStartPage(CDfvObjPtr pDfvObj);
00375 
00376 /**
00377  * Specifies the start page number of document to output.
00378  * If the start page is omitted or the specified value is 0 or less, the start page is
00379  * considered from the first page.
00380  * If the setting is inconsistent, (for example, StartPage=5 EndPage=3) an error occurs.
00381  *
00382  * @param   pDfvObj Pointer to DfvObj instance.
00383  * @param   newVal  start page number of output.
00384  */
00385 DFVINTERFACE_API void dfv_setStartPage(CDfvObjPtr pDfvObj, long newVal);
00386 
00387 /**
00388  * Get the end page number of document to output.
00389  *
00390  * @param   pDfvObj Pointer to DfvObj instance.
00391  * @return  end page number of output.
00392  */
00393 DFVINTERFACE_API long dfv_getEndPage(CDfvObjPtr pDfvObj);
00394 
00395 /**
00396  * Specifies the end page number of document to output.
00397  * If the end page is omitted or the specified value exceeds the actual page number, the end page
00398  * is considered as the last page.
00399  * If the setting is inconsistent, (for example, StartPage=5 EndPage=3) an error occurs.
00400  *
00401  * @param   pDfvObj Pointer to DfvObj instance.
00402  * @param   newVal  end page number of output.
00403  */
00404 DFVINTERFACE_API void dfv_setEndPage(CDfvObjPtr pDfvObj, long newVal);
00405 
00406 /**
00407  * Effective when outputting to PDF.
00408  * Specifies the owner password for PDF. The password must be within 32 bytes.
00409  * 
00410  *
00411  * @param   pDfvObj Pointer to DfvObj instance.
00412  * @param   newVal  Pointer to a null-terminated string to be used as the owner password.
00413  */
00414 DFVINTERFACE_API void dfv_setPdfOwnerPassword(CDfvObjPtr pDfvObj, const char* newVal);
00415 
00416 /**
00417  * Effective when outputting to PDF.
00418  * Specifies the owner password for PDF. The password must be within 32 bytes.
00419  * 
00420  *
00421  * @param   pDfvObj Pointer to DfvObj instance.
00422  * @param   newVal  Pointer to a null-terminated string to be used as the owner password.
00423  */
00424 DFVINTERFACE_API void dfv_setPdfOwnerPasswordW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
00425 
00426 /**
00427  * Effective when outputting to PDF.
00428  * Specifies the user password for PDF. The password must be within 32 bytes.
00429  * 
00430  *
00431  * @param   pDfvObj Pointer to DfvObj instance.
00432  * @param   newVal  Pointer to a null-terminated string to be used as the user password.
00433  */
00434 DFVINTERFACE_API void dfv_setPdfUserPassword(CDfvObjPtr pDfvObj, const char* newVal);
00435 
00436 /**
00437  * Effective when outputting to PDF.
00438  * Specifies the user password for PDF. The password must be within 32 bytes.
00439  * 
00440  *
00441  * @param   pDfvObj Pointer to DfvObj instance.
00442  * @param   newVal  Pointer to a null-terminated string to be used as the user password.
00443  */
00444 DFVINTERFACE_API void dfv_setPdfUserPasswordW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
00445 
00446 /**
00447  * Effective when outputting to PDF.
00448  * Disables printing the PDF file.
00449  * 
00450  *
00451  * @param   pDfvObj Pointer to DfvObj instance.
00452  * @param   newVal  If nonezero is specified, Disables printing the PDF file.
00453  */
00454 DFVINTERFACE_API void dfv_setPdfNoPrinting(CDfvObjPtr pDfvObj, long newVal);
00455 
00456 /**
00457  * Effective when outputting to PDF.
00458  * Get disables printing the PDF file.
00459  * 
00460  *
00461  * @param   pDfvObj Pointer to DfvObj instance.
00462  * @return  If zero is returned, Enables printing the PDF file.
00463  *          If nonezero is returned, Disables printing the PDF file.
00464  */
00465 DFVINTERFACE_API long dfv_getPdfNoPrinting(CDfvObjPtr pDfvObj);
00466 
00467 /**
00468  * Effective when outputting to PDF.
00469  * Disables making changes of the PDF file.
00470  * 
00471  *
00472  * @param   pDfvObj Pointer to DfvObj instance.
00473  * @param   newVal  If nonezero is specified, Disables making changes of the PDF file.
00474  */
00475 DFVINTERFACE_API void dfv_setPdfNoChanging(CDfvObjPtr pDfvObj, long newVal);
00476 
00477 /**
00478  * Effective when outputting to PDF.
00479  * Get disables making changes of the PDF file.
00480  * 
00481  *
00482  * @param   pDfvObj Pointer to DfvObj instance.
00483  * @return  If zero is returned, Enables making changes of the PDF file.
00484  *          If nonezero is returned, Disables making changes of the PDF file.
00485  */
00486 DFVINTERFACE_API long dfv_getPdfNoChanging(CDfvObjPtr pDfvObj);
00487 
00488 /**
00489  * Effective when outputting to PDF.
00490  * Disables copying the content of the PDF file.
00491  * 
00492  *
00493  * @param   pDfvObj Pointer to DfvObj instance.
00494  * @param   newVal  If nonezero is specified, Disables copying the content of the PDF file.
00495  */
00496 DFVINTERFACE_API void dfv_setPdfNoContentCopying(CDfvObjPtr pDfvObj, long newVal);
00497 
00498 /**
00499  * Effective when outputting to PDF.
00500  * Get disables copying the content of the PDF file.
00501  * 
00502  *
00503  * @param   pDfvObj Pointer to DfvObj instance.
00504  * @return  If zero is returned, Enables copying the content of the PDF file.
00505  *          If nonezero is returned, Disables copying the content of the PDF file.
00506  */
00507 DFVINTERFACE_API long dfv_getPdfNoContentCopying(CDfvObjPtr pDfvObj);
00508 
00509 /**
00510  * Effective when outputting to PDF.
00511  * Disables adding comments and form fields to the PDF file.
00512  * 
00513  *
00514  * @param   pDfvObj Pointer to DfvObj instance.
00515  * @param   newVal  If nonezero is specified, Disables adding comments and form fields to the PDF file.
00516  */
00517 DFVINTERFACE_API void dfv_setPdfNoAddingOrChangingCommnets(CDfvObjPtr pDfvObj, long newVal);
00518 
00519 /**
00520  * Effective when outputting to PDF.
00521  * Get disables adding comments and form fields to the PDF file.
00522  * 
00523  *
00524  * @param   pDfvObj Pointer to DfvObj instance.
00525  * @return  If zero is returned, Enables adding comments and form fields to the PDF file.
00526  *          If nonezero is returned, Disables adding comments and form fields to the PDF file.
00527  */
00528 DFVINTERFACE_API long dfv_getPdfNoAddingOrChangingCommnets(CDfvObjPtr pDfvObj);
00529 
00530 /**
00531  * Effective when outputting to PDF.
00532  * Disables adding comments and form fields to the PDF file.
00533  * 
00534  *
00535  * @param   pDfvObj Pointer to DfvObj instance.
00536  * @param   newVal  If nonezero is specified, Disables adding comments and form fields to the PDF file.
00537  */
00538 DFVINTERFACE_API void dfv_setPdfNoAddingOrChangingComments(CDfvObjPtr pDfvObj, long newVal);
00539 
00540 /**
00541  * Effective when outputting to PDF.
00542  * Get disables adding comments and form fields to the PDF file.
00543  * 
00544  *
00545  * @param   pDfvObj Pointer to DfvObj instance.
00546  * @return  If zero is returned, Enables adding comments and form fields to the PDF file.
00547  *          If nonezero is returned, Disables adding comments and form fields to the PDF file.
00548  */
00549 DFVINTERFACE_API long dfv_getPdfNoAddingOrChangingComments(CDfvObjPtr pDfvObj);
00550 
00551 /**
00552  * Effective when outputting to PDF.
00553  * Set the version of PDF.
00554  *
00555  *
00556  * @param   pDfvObj Pointer to DfvObj instance.
00557  * @param   newVal  Specifies the version of PDF.
00558  */
00559 DFVINTERFACE_API void dfv_setPdfVersion(CDfvObjPtr pDfvObj, DfvPDFVERSION newVal);
00560 
00561 /**
00562  * Effective when outputting to PDF.
00563  * Get the version of PDF.
00564  * 
00565  *
00566  * @param   pDfvObj Pointer to DfvObj instance.
00567  * @return  the version of PDF.
00568  */
00569 DFVINTERFACE_API DfvPDFVERSION  dfv_getPdfVersion(CDfvObjPtr pDfvObj);
00570 
00571 /**
00572  * Effective when outputting to PDF.
00573  * Disables filling in of form fields and signing of the PDF file.
00574  * This parameter is effective only when you specify PDF1.4 or later to PDF version.
00575  * 
00576  *
00577  * @param   pDfvObj Pointer to DfvObj instance.
00578  * @param   newVal  If nonezero is specified, Disables filling in of form fields and signing of the PDF file.
00579  */
00580 DFVINTERFACE_API void dfv_setPdfNoFillForm(CDfvObjPtr pDfvObj, long newVal);
00581 
00582 /**
00583  * Effective when outputting to PDF.
00584  * Get disables filling in of form fields and signing of the PDF file.
00585  * 
00586  *
00587  * @param   pDfvObj Pointer to DfvObj instance.
00588  * @return  If zero is returned, Enables filling in of form fields and signing of the PDF file.
00589  *          If nonezero is returned, Disables filling in of form fields and signing of the PDF file.
00590  */
00591 DFVINTERFACE_API long dfv_getPdfNoFillForm(CDfvObjPtr pDfvObj);
00592 
00593 /**
00594  * Effective when outputting to PDF.
00595  * Disables text access for screen reader devices of the PDF file.
00596  * This parameter is effective only when you specify 1.4 or later with PDF version.
00597  * 
00598  *
00599  * @param   pDfvObj Pointer to DfvObj instance.
00600  * @param   newVal  If nonezero is specified, Disables text access for screen reader devices of the PDF file.
00601  */
00602 DFVINTERFACE_API void dfv_setPdfNoAccessibility(CDfvObjPtr pDfvObj, long newVal);
00603 
00604 /**
00605  * Effective when outputting to PDF.
00606  * Get disables text access for screen reader devices of the PDF file.
00607  * 
00608  *
00609  * @param   pDfvObj Pointer to DfvObj instance.
00610  * @return  If zero is returned, Enables text access for screen reader devices of the PDF file.
00611  *          If nonezero is returned, Disables text access for screen reader devices of the PDF file.
00612  */
00613 DFVINTERFACE_API long dfv_getPdfNoAccessibility(CDfvObjPtr pDfvObj);
00614 
00615 /**
00616  * Effective when outputting to PDF.
00617  * Disables inserting, deleting and rotating the PDF pages.
00618  * This parameter is effective only when you specify 1.4 or later with PDF version
00619  * 
00620  *
00621  * @param   pDfvObj Pointer to DfvObj instance.
00622  * @param   newVal  If nonezero is specified, Disables inserting, deleting and rotating the PDF pages.
00623  */
00624 DFVINTERFACE_API void dfv_setPdfNoAssembleDoc(CDfvObjPtr pDfvObj, long newVal);
00625 
00626 /**
00627  * Effective when outputting to PDF.
00628  * Get disables inserting, deleting and rotating the PDF pages.
00629  * 
00630  *
00631  * @param   pDfvObj Pointer to DfvObj instance.
00632  * @return  If zero is returned, Enables inserting, deleting and rotating the PDF pages.
00633  *          If nonezero is returned, Disables inserting, deleting and rotating the PDF pages.
00634  */
00635 DFVINTERFACE_API long dfv_getPdfNoAssembleDoc(CDfvObjPtr pDfvObj);
00636 
00637 /**
00638  * Effective when outputting to PDF.
00639  * Specifies the key length when encrypting the PDF file during outputting.
00640  * The key length can be specified as either 40 or 128 (bit).
00641  * This parameter is effective only when you specify PDF1.4 or later with PDF version
00642  * 
00643  *
00644  * @param   pDfvObj Pointer to DfvObj instance.
00645  * @param   newVal  Specifies the key length.
00646  */
00647 DFVINTERFACE_API void dfv_setPdfEncryptLevel(CDfvObjPtr pDfvObj, DfvPDFENCRYPTLEVEL newVal);
00648 
00649 /**
00650  * Effective when outputting to PDF.
00651  * Get the key length when encrypting the PDF file during outputting.
00652  * 
00653  *
00654  * @param   pDfvObj Pointer to DfvObj instance.
00655  * @return  the key length.
00656  */
00657 DFVINTERFACE_API DfvPDFENCRYPTLEVEL dfv_getPdfEncryptLevel(CDfvObjPtr pDfvObj);
00658 
00659 /**
00660  * Effective when outputting to PDF.
00661  * Gets the value of whether to embed all embeddable fonts in PDF.
00662  * 
00663  *
00664  * @param   pDfvObj Pointer to DfvObj instance.
00665  * @return  the value of whether to embed all embeddable fonts
00666  */
00667 DFVINTERFACE_API long dfv_getPdfEmbedAllFonts(CDfvObjPtr pDfvObj);
00668 
00669 /**
00670  * Effective when outputting to PDF.
00671  * Embeds all embeddable fonts in PDF to create.
00672  * 
00673  *
00674  * @param   pDfvObj Pointer to DfvObj instance.
00675  * @param   newVal  If the value is 'true' is specified, Embeds all embeddable fonts
00676  */
00677 DFVINTERFACE_API void dfv_setPdfEmbedAllFonts(CDfvObjPtr pDfvObj, long newVal);
00678 
00679 /**
00680  * Effective when outputting to PDF.
00681  * Gets the font specified to be embedded in PDF.
00682  * 
00683  *
00684  * @param   pDfvObj Pointer to DfvObj instance.
00685  * @param   pVal        Pointer to the buffer that will receive the fontnames. If the string is as long or longer than the buffer,
00686  *            the string is truncated and terminated with a NULL character.
00687  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00688  * @return  Returns the 'pVal'.
00689  */
00690 DFVINTERFACE_API char* dfv_getPdfEmbedFonts(CDfvObjPtr pDfvObj, char* pVal, int size);
00691 
00692 /**
00693  * Effective when outputting to PDF.
00694  * Gets the font specified to be embedded in PDF.
00695  * 
00696  *
00697  * @param   pDfvObj Pointer to DfvObj instance.
00698  * @param   pVal        Pointer to the buffer that will receive the fontnames. If the string is as long or longer than the buffer,
00699  *            the string is truncated and terminated with a NULL character.
00700  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
00701  * @return  Returns the 'pVal'.
00702  */
00703 DFVINTERFACE_API wchar_t* dfv_getPdfEmbedFontsW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
00704 
00705 /**
00706  * Effective when outputting to PDF.
00707  * Embeds the specified font in PDF to create. If you want to specify plural fonts, put commas between fonts.
00708  * 
00709  *
00710  * @param   pDfvObj Pointer to DfvObj instance.
00711  * @param   newVal  fonts specified to embed
00712  */
00713 DFVINTERFACE_API void dfv_setPdfEmbedFonts(CDfvObjPtr pDfvObj, const char* newVal);
00714 
00715 /**
00716  * Effective when outputting to PDF.
00717  * Embeds the specified font in PDF to create. If you want to specify plural fonts, put commas between fonts.
00718  * 
00719  *
00720  * @param   pDfvObj Pointer to DfvObj instance.
00721  * @param   newVal  fonts specified to embed
00722  */
00723 DFVINTERFACE_API void dfv_setPdfEmbedFontsW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
00724 
00725 /**
00726  * Effective when outputting to PDF.
00727  * Gets the value of whether to issues the error when failing to embed fonts.
00728  * 
00729  *
00730  * @param   pDfvObj Pointer to DfvObj instance.
00731  * @return  the value of whether to issues the error
00732  */
00733 DFVINTERFACE_API long dfv_getPdfErrorOnEmbedFault(CDfvObjPtr pDfvObj);
00734 
00735 /**
00736  * Effective when outputting to PDF.
00737  * An error is issued in case of failing to embed fonts.
00738  * 
00739  *
00740  * @param   pDfvObj Pointer to DfvObj instance.
00741  * @param   newVal  If the value is 'true' is specified, an error is issued.
00742  */
00743 DFVINTERFACE_API void dfv_setPdfErrorOnEmbedFault(CDfvObjPtr pDfvObj, long newVal);
00744 
00745 /**
00746  * Effective when outputting to PDF.
00747  * Gets the value of whether to issues the error when missing glyph.
00748  * 
00749  *
00750  * @param   pDfvObj Pointer to DfvObj instance.
00751  * @return  the value of whether to issues the error
00752  */
00753 DFVINTERFACE_API long dfv_getPdfErrorOnMissingGlyph(CDfvObjPtr pDfvObj);
00754 
00755 /**
00756  * Effective when outputting to PDF.
00757  * An error is issued in case of missing glyph.
00758  * 
00759  *
00760  * @param   pDfvObj Pointer to DfvObj instance.
00761  * @param   newVal  If the value is 'true' is specified, an error is issued.
00762  */
00763 DFVINTERFACE_API void dfv_setPdfErrorOnMissingGlyph(CDfvObjPtr pDfvObj, long newVal);
00764 
00765 /**
00766  * Effective when outputting to PDF.
00767  * Gets the value of whether to print the resulting PDF file or not.
00768  * 
00769  *
00770  * <table border="0" cellspacing="0" cellpadding="0">
00771  *  <tr><td>PRALLOW_NONE    </td><td>= 0 Not Allowed</td></tr>
00772  *  <tr><td>PRALLOW_LOW     </td><td>= 1 Low Resolution Printing</td></tr>
00773  *  <tr><td>PRALLOW_HIGH    </td><td>= 2 High Resolution Printing</td></tr>
00774  * </table>
00775  *
00776  * @param   pDfvObj Pointer to DfvObj instance.
00777  * @return  the value of printing allowed
00778  */
00779 DFVINTERFACE_API DfvPDFPRINTALLOW dfv_getPdfPrintingAllowed(CDfvObjPtr pDfvObj);
00780 
00781 /**
00782  * Effective when outputting to PDF.
00783  * Spesifies whether to permit printing PDF to create with one of the following values.
00784  * This parameter is effective only when you specify PDF1.4 or later to PDF version (setPdfVersion).
00785  * 
00786  *
00787  * <table border="0" cellspacing="0" cellpadding="0">
00788  *  <tr><td>PRALLOW_NONE    </td><td>= 0 Not Allowed</td></tr>
00789  *  <tr><td>PRALLOW_LOW     </td><td>= 1 Low Resolution Printing</td></tr>
00790  *  <tr><td>PRALLOW_HIGH    </td><td>= 2 High Resolution Printing</td></tr>
00791  * </table>
00792  *
00793  * @param   pDfvObj Pointer to DfvObj instance.
00794  * @param   newVal  the value of printing allowed
00795  */
00796 DFVINTERFACE_API void dfv_setPdfPrintingAllowed(CDfvObjPtr pDfvObj, DfvPDFPRINTALLOW newVal);
00797 
00798 /**
00799  * Effective when outputting to PDF.
00800  * Gets the value of how to compress the color images embedded in PDF.
00801  * 
00802  *
00803  * <table border="0" cellspacing="0" cellpadding="0">
00804  *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
00805  *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
00806  *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
00807  *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
00808  * </table>
00809  *
00810  * @param   pDfvObj Pointer to DfvObj instance.
00811  * @return  the value of how raster graphics are compressed and stored
00812  */
00813 DFVINTERFACE_API DfvPDFIMAGECOMPRESSION dfv_getPdfImageCompression(CDfvObjPtr pDfvObj);
00814 
00815 /**
00816  * Effective when outputting to PDF.
00817  * When the color image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.<BR>
00818  * When IMGCMPR_AUTO is selected, the process is automatically done and creates the image data according to the setting of dfv_setPdfJPEGQuality and dfv_setPdfRasterizeResolution. Whichever has the smaller compressed size, JPEG or ZLIB, is selected. <BR>
00819 This is the setting for the color image. Spesify dfv_setPdfGrayscaleImageCompression for the grayscale image, and dfv_setPdfMonochromeImageCompression for the monochrome image.
00820  * 
00821  *
00822  * <table border="0" cellspacing="0" cellpadding="0">
00823  *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
00824  *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
00825  *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
00826  *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
00827  * </table>
00828  *
00829  * @param   pDfvObj Pointer to DfvObj instance.
00830  * @param   newVal  the value of how raster graphics are compressed and stored
00831  */
00832 DFVINTERFACE_API void dfv_setPdfImageCompression(CDfvObjPtr pDfvObj, DfvPDFIMAGECOMPRESSION newVal);
00833 
00834 /**
00835  * Gets the value of the quality of JPEG format that is specified by dfv_setPdfImageCompression() stored in PDF.
00836  * 
00837  *
00838  * @param   pDfvObj Pointer to DfvObj instance.
00839  * @return  the value of the quality of JPEG format
00840  */
00841 DFVINTERFACE_API int     dfv_getPdfJPEGQuality(CDfvObjPtr pDfvObj);
00842 
00843 /**
00844  * Effective when outputting to PDF.
00845  * For the color image format that can not be stored directly in PDF, specifies the image quality by the numerical value within the range of 1-100 when IMGCMPR_JPEG is specified by setPdfImageCompression. The quality becomes higher in proportion to the increase in the number; however the file size also becomes larger.<BR>
00846  * CAUTION:     It is not for changing the quality of a JPEG format image.<BR>
00847  * This is the setting for the color image. Spesify setPdfGrayscaleJPEGQuality for the grayscale image.
00848  * 
00849  *
00850  * @param   pDfvObj Pointer to DfvObj instance.
00851  * @param   newVal  the value of the quality of JPEG format
00852  */
00853 DFVINTERFACE_API void dfv_setPdfJPEGQuality(CDfvObjPtr pDfvObj, int newVal);
00854 
00855 /**
00856  * Effective when outputting to PDF.
00857  * 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.
00858  * 
00859  *
00860  * @param   pDfvObj Pointer to DfvObj instance.
00861  * @return  the value of whether make the size of PDF smaller or not
00862  */
00863 DFVINTERFACE_API long dfv_getPdfCompressContentStream(CDfvObjPtr pDfvObj);
00864 
00865 /**
00866  * Effective when outputting to PDF.
00867  * Specifies whether the text and the line art in PDF are compressed in order to make the size of PDF smaller or not.
00868  * 
00869  *
00870  * @param   pDfvObj Pointer to DfvObj instance.
00871  * @param   newVal  If the value is 'true' is specified, make the PDF compress
00872  */
00873 DFVINTERFACE_API void dfv_setPdfCompressContentStream(CDfvObjPtr pDfvObj, long newVal);
00874 
00875 /**
00876  * Effective when outputting to PDF.
00877  * Gets the value of how to transform external link specified by the relative address in the PDF link.
00878  * 
00879  *
00880  * @param   pDfvObj Pointer to DfvObj instance.
00881  * @return  the value of how to transform external link
00882  */
00883 DFVINTERFACE_API long dfv_getPdfUseLaunchForRelativeURI(CDfvObjPtr pDfvObj);
00884 
00885 /**
00886  * Effective when outputting to PDF.
00887  * 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.
00888  * 
00889  *
00890  * @param   pDfvObj Pointer to DfvObj instance.
00891  * @param   newVal  If nonezero is specified, it is transformed to 'Open the file'. If zero is specified, it is transformed to 'World Wide Web link'
00892  */
00893 DFVINTERFACE_API void dfv_setPdfUseLaunchForRelativeURI(CDfvObjPtr pDfvObj, long newVal);
00894 
00895 /**
00896  * Effective when outputting to PDF.
00897  * Gets the value of how to convert the RGB color space (DebiceRGB) to DeviceGray.
00898  * 
00899  *
00900  * <table border="0" cellspacing="0" cellpadding="0">
00901  *  <tr><td>RGBCONV_NONE    </td><td>= 0 No Conversion</td></tr>
00902  *  <tr><td>RGBCONV_BLACK   </td><td>= 1 Black to DeviceGray</td></tr>
00903  *  <tr><td>RGBCONV_GRAY    </td><td>= 2 Gray to DeviceGray</td></tr>
00904  *  <tr><td>RGBCONV_ALL     </td><td>= 3 All RGB to DeviceGray</td></tr>
00905  * </table>
00906  *
00907  * @param   pDfvObj Pointer to DfvObj instance.
00908  * @return  the value of how to convert
00909  */
00910 DFVINTERFACE_API DfvPDFRGBCONVERSION dfv_getPdfRGBConversion(CDfvObjPtr pDfvObj);
00911 
00912 /**
00913  * Effective when outputting to PDF.
00914  * Specifies how to convert the RGB color space (DeviceRGB) to DeviceGray.
00915  * 
00916  *
00917  * <table border="0" cellspacing="0" cellpadding="0">
00918  *  <tr><td>RGBCONV_NONE    </td><td>= 0 No Conversion</td></tr>
00919  *  <tr><td>RGBCONV_BLACK   </td><td>= 1 Black to DeviceGray</td></tr>
00920  *  <tr><td>RGBCONV_GRAY    </td><td>= 2 Gray to DeviceGray</td></tr>
00921  *  <tr><td>RGBCONV_ALL     </td><td>= 3 All RGB to DeviceGray</td></tr>
00922  * </table>
00923  *
00924  * @param   pDfvObj Pointer to DfvObj instance.
00925  * @param   newVal  the value of how to convert
00926  */
00927 DFVINTERFACE_API void dfv_setPdfRGBConversion(CDfvObjPtr pDfvObj, DfvPDFRGBCONVERSION newVal);
00928 
00929 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
00930 
00931 /**
00932  * Effective when outputting to PDF.
00933  * Gets the value of the rasterised-resolution of the transformed raster images.
00934  * 
00935  *
00936  * @param   pDfvObj Pointer to DfvObj instance.
00937  * @return  Rasterised-resolution
00938  */
00939 DFVINTERFACE_API int dfv_getPdfRasterizeResolution(CDfvObjPtr pDfvObj);
00940 
00941 /**
00942  * Effective when outputting to PDF.
00943  * 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.
00944  * This setting is effective only with Windows version.
00945  * 
00946  *
00947  * @param   pDfvObj Pointer to DfvObj instance.
00948  * @param   newVal  Rasterised-resolution (70 to 500)
00949  */
00950 DFVINTERFACE_API void dfv_setPdfRasterizeResolution(CDfvObjPtr pDfvObj, int newVal);
00951 
00952 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
00953 
00954 /**
00955  * Effective when outputting to PDF.
00956  * Gets the value of whether to output linearize PDF or not.
00957  * @since 7.0
00958  *
00959  * @param   pDfvObj Pointer to DfvObj instance.
00960  * @return  the value of whether to output linearize pdf or not.
00961  */
00962 DFVINTERFACE_API long dfv_getPdfLinearize(CDfvObjPtr pDfvObj);
00963 /**
00964  * Effective when outputting to PDF.
00965  * Specifies whether to output linearize PDF or not.
00966  * @since 7.0
00967  *
00968  * @param   pDfvObj Pointer to DfvObj instance.
00969  * @param   newVal  If the value is 'true' is specified, output linearlize PDF.
00970  */
00971 DFVINTERFACE_API void dfv_setPdfLinearize(CDfvObjPtr pDfvObj, long newVal);
00972 
00973 /**
00974  * Effective when outputting to PDF.
00975  * Gets the value of whether to embed all embeddable fonts
00976  * 
00977  *
00978  * <table border="0" cellspacing="0" cellpadding="0">
00979  *  <tr><td>EMBALLFONT_PART </td><td>= 0 Specified fonts </td></tr>
00980  *  <tr><td>EMBALLFONT_ALL  </td><td>= 1 All fonts except Base14 fonts</td></tr>
00981  *  <tr><td>EMBALLFONT_BASE14   </td><td>= 2 All fonts</td></tr>
00982  * </table>
00983  *
00984  * @param   pDfvObj Pointer to DfvObj instance.
00985  * @return  the value of whether to embed all embeddable fonts
00986  */
00987 DFVINTERFACE_API DfvEMBEDALLFONT dfv_getPdfEmbedAllFontsEx(CDfvObjPtr pDfvObj);
00988 
00989 /**
00990  * Effective when outputting to PDF.
00991  * 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.
00992  * 
00993  *
00994  * <table border="0" cellspacing="0" cellpadding="0">
00995  *  <tr><td>EMBALLFONT_PART </td><td>= 0 Specified fonts </td></tr>
00996  *  <tr><td>EMBALLFONT_ALL  </td><td>= 1 All fonts except Base14 fonts</td></tr>
00997  *  <tr><td>EMBALLFONT_BASE14   </td><td>= 2 All fonts</td></tr>
00998  * </table>
00999  *
01000  *If the value is EMBALLFONT_PART, only fonts specified in dfv_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.
01001  *
01002  * @param   pDfvObj Pointer to DfvObj instance.
01003  * @param   newVal  the value of whether to embed all embeddable fonts
01004  */
01005 DFVINTERFACE_API void dfv_setPdfEmbedAllFontsEx(CDfvObjPtr pDfvObj, DfvEMBEDALLFONT newVal);
01006 
01007 /**
01008  * Effective when outputting to PDF.
01009  * Gets the value of method to downsample the color image
01010  * 
01011  *
01012  * @param   pDfvObj Pointer to DfvObj instance.
01013  * @return  the value of method to downsample the color image
01014  */
01015 DFVINTERFACE_API DfvIMAGEDOWNSAMPLING dfv_getPdfImageDownSampling(CDfvObjPtr pDfvObj);
01016 
01017 /**
01018  * Effective when outputting to PDF.
01019  * Specifies the following either of method to downsample the color image that is put into PDF.
01020  * 
01021  *
01022  * <table border="0" cellspacing="0" cellpadding="0">
01023  *  <tr><td>IMGDOWNSAMPLING_NONE    </td><td>= 0 No downsampling </td></tr>
01024  *  <tr><td>IMGDOWNSAMPLING_AVERAGE </td><td>= 1 Average downsamplin</td></tr>
01025  *  <tr><td>IMGDOWNSAMPLING_BICUBIC </td><td>= 2 Bicubic downsampling</td></tr>
01026  *  <tr><td>IMGDOWNSAMPLING_SUBSAMPLING </td><td>= 3 Subsampling</td></tr>
01027  * </table>
01028  *
01029  * When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by dfv_setPdfImageDownSamplingDPI will be downsampled into the resolution specified by dfv_setPdfImageDownSamplingTarget.
01030 This is the setting for the color image. Spesify dfv_setPdfGrayscaleImageDownSampling for the grayscale image, and dfv_setPdfMonochromeImageDownSampling for the monochrome image.
01031  *
01032  * @param   pDfvObj Pointer to DfvObj instance.
01033  * @param   newVal  the value of method to downsample the color image
01034  */
01035 DFVINTERFACE_API void dfv_setPdfImageDownSampling(CDfvObjPtr pDfvObj, DfvIMAGEDOWNSAMPLING newVal);
01036 
01037 /**
01038  * Effective when outputting to PDF.
01039  * Gets resolution when the color image is downsampled.
01040  * 
01041  *
01042  * @param   pDfvObj Pointer to DfvObj instance.
01043  * @return  the value of resolution.
01044  */
01045 DFVINTERFACE_API int dfv_getPdfImageDownSamplingTarget(CDfvObjPtr pDfvObj);
01046 
01047 /**
01048  * Effective when outputting to PDF.
01049  * Set resolution when the color image is downsampled.
01050  * 
01051  *
01052  * @param   pDfvObj Pointer to DfvObj instance.
01053  * @param   newVal  the value of resolution.
01054  */
01055 DFVINTERFACE_API void dfv_setPdfImageDownSamplingTarget(CDfvObjPtr pDfvObj, int newVal);
01056 
01057 /**
01058  * Effective when outputting to PDF.
01059  * Gets resolution of the color image which performs a downsampling.
01060  * 
01061  *
01062  * @param   pDfvObj Pointer to DfvObj instance.
01063  * @return  the value of resolution.
01064  */
01065 DFVINTERFACE_API int dfv_getPdfImageDownSamplingDPI(CDfvObjPtr pDfvObj);
01066 
01067 /**
01068  * Effective when outputting to PDF.
01069  * Set resolution of the color image which performs a downsampling.
01070  * 
01071  *
01072  * @param   pDfvObj Pointer to DfvObj instance.
01073  * @param   newVal  the value of resolution.
01074  */
01075 DFVINTERFACE_API void dfv_setPdfImageDownSamplingDPI(CDfvObjPtr pDfvObj, int newVal);
01076 
01077 /**
01078  * Effective when outputting to PDF.
01079  * Gets specification whether to embed to PDF the ICC profile of the color image that will be embedded to PDF.
01080  * 
01081  *
01082  *
01083  * @param   pDfvObj Pointer to DfvObj instance.
01084  * @return  If nonezero is specified, it is embedded. If zero is specified, it is not embedded.
01085  */
01086 DFVINTERFACE_API long dfv_getPdfPutImageColorProfile(CDfvObjPtr pDfvObj);
01087 
01088 /**
01089  * Effective when outputting to PDF.
01090  * Specifies whether to embed to PDF the ICC profile of the color image that will be embedded to PDF.
01091  * 
01092  *
01093  * @param   pDfvObj Pointer to DfvObj instance.
01094  * @param   newVal  If nonezero is specified, it is embedded. If zero is specified, it is not embedded.
01095  */
01096 DFVINTERFACE_API void dfv_setPdfPutImageColorProfile(CDfvObjPtr pDfvObj, long newVal);
01097 
01098 /**
01099  * Effective when outputting to PDF.
01100  * Gets the value of how to compress the grayscale images embedded in PDF.
01101  * 
01102  *
01103  * <table border="0" cellspacing="0" cellpadding="0">
01104  *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
01105  *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
01106  *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
01107  *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
01108  * </table>
01109  *
01110  * @param   pDfvObj Pointer to DfvObj instance.
01111  * @return  the value of how raster graphics are compressed and stored
01112  */
01113 DFVINTERFACE_API DfvPDFIMAGECOMPRESSION dfv_getPdfGrayscaleImageCompression(CDfvObjPtr pDfvObj);
01114 
01115 /**
01116  * Effective when outputting to PDF.
01117  * When the grayscale image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.<BR>
01118  * When IMGCMPR_AUTO is selected, the process is automatically done and creates the image data according to the setting of dfv_setPdfGrayscaleJPEGQuality and dfv_setPdfRasterizeResolution. Whichever has the smaller compressed size, JPEG or ZLIB, is selected. <BR>
01119 This is the setting for the grayscale image. Spesify dfv_setPdfImageCompression for the color image, and dfv_setPdfMonochromeImageCompression for the monochrome image.
01120  * 
01121  *
01122  * <table border="0" cellspacing="0" cellpadding="0">
01123  *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto</td></tr>
01124  *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG compression</td></tr>
01125  *  <tr><td>IMGCMPR_ZLIB    </td><td>= 2 ZLIB compression</td></tr>
01126  *  <tr><td>IMGCMPR_JPEG2K  </td><td>= 3 JPEG2000 compression</td></tr>
01127  * </table>
01128  *
01129  * @param   pDfvObj Pointer to DfvObj instance.
01130  * @param   newVal  the value of how raster graphics are compressed and stored
01131  */
01132 DFVINTERFACE_API void dfv_setPdfGrayscaleImageCompression(CDfvObjPtr pDfvObj, DfvPDFIMAGECOMPRESSION newVal);
01133 
01134 /**
01135  * Effective when outputting to PDF.
01136  * Gets the value of the quality of JPEG format that is specified by dfv_setPdfGrayscaleImageCompression stored in PDF.
01137  * 
01138  *
01139  * @param   pDfvObj Pointer to DfvObj instance.
01140  * @return  the value of the quality of JPEG format
01141  */
01142 DFVINTERFACE_API int dfv_getPdfGrayscaleJPEGQuality(CDfvObjPtr pDfvObj);
01143 
01144 /**
01145  * Effective when outputting to PDF.
01146  * 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 dfv_setPdfGrayscaleImageCompression. The quality becomes higher in proportion to the increase in the number; however the file size also becomes larger.<BR>
01147  * CAUTION: It is not for changing the quality of a JPEG format image.<BR>
01148  * This is the setting for the grayscale image. Spesify dfv_setPdfJPEGQuality for the color image.
01149  * 
01150  *
01151  * @param   pDfvObj Pointer to DfvObj instance.
01152  * @param   newVal  the value of the quality of JPEG format
01153  */
01154 DFVINTERFACE_API void dfv_setPdfGrayscaleJPEGQuality(CDfvObjPtr pDfvObj, int newVal);
01155 
01156 /**
01157  * Effective when outputting to PDF.
01158  * Gets the value of method to downsample the grayscale image
01159  * 
01160  *
01161  * @param   pDfvObj Pointer to DfvObj instance.
01162  * @return  the value of method to downsample the grayscale image
01163  */
01164 DFVINTERFACE_API DfvIMAGEDOWNSAMPLING dfv_getPdfGrayscaleImageDownSampling(CDfvObjPtr pDfvObj);
01165 
01166 /**
01167  * Effective when outputting to PDF.
01168  * 
01169  *
01170  * @param   pDfvObj Pointer to DfvObj instance.
01171  * @param   newVal
01172  */
01173 DFVINTERFACE_API void dfv_setPdfGrayscaleImageDownSampling(CDfvObjPtr pDfvObj, DfvIMAGEDOWNSAMPLING newVal);
01174 
01175 /**
01176  * Effective when outputting to PDF.
01177  * Gets resolution when the grayscale image is downsampled.
01178  * 
01179  *
01180  * @param   pDfvObj Pointer to DfvObj instance.
01181  * @return  the value of resolution.
01182  */
01183 DFVINTERFACE_API int dfv_getPdfGrayscaleImageDownSamplingTarget(CDfvObjPtr pDfvObj);
01184 
01185 /**
01186  * Effective when outputting to PDF.
01187  * Specifies the following either of method to downsample the grayscale image that is put into PDF.
01188  * 
01189  *
01190  * <table border="0" cellspacing="0" cellpadding="0">
01191  *  <tr><td>IMGDOWNSAMPLING_NONE    </td><td>= 0 No downsampling </td></tr>
01192  *  <tr><td>IMGDOWNSAMPLING_AVERAGE </td><td>= 1 Average downsamplin</td></tr>
01193  *  <tr><td>IMGDOWNSAMPLING_BICUBIC </td><td>= 2 Bicubic downsampling</td></tr>
01194  *  <tr><td>IMGDOWNSAMPLING_SUBSAMPLING </td><td>= 3 Subsampling</td></tr>
01195  * </table>
01196  *
01197  * When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by dfv_setPdfGrayscaleImageDownSamplingDPI will be downsampled into the resolution specified by dfv_setPdfGrayscaleImageDownSamplingTarget.
01198 This is the setting for the grayscale image. Spesify dfv_setPdfImageDownSampling for the color image, and dfv_setPdfMonochromeImageDownSampling for the monochrome image.
01199  *
01200  * @param   pDfvObj Pointer to DfvObj instance.
01201  * @param   newVal  the value of method to downsample the grayscale image
01202  */
01203 DFVINTERFACE_API void dfv_setPdfGrayscaleImageDownSamplingTarget(CDfvObjPtr pDfvObj, int newVal);
01204 
01205 /**
01206  * Effective when outputting to PDF.
01207  * Gets resolution of the grayscale image which performs a downsampling.
01208  * 
01209  *
01210  * @param   pDfvObj Pointer to DfvObj instance.
01211  * @return  the value of resolution.
01212  */
01213 DFVINTERFACE_API int dfv_getPdfGrayscaleImageDownSamplingDPI(CDfvObjPtr pDfvObj);
01214 
01215 /**
01216  * Effective when outputting to PDF.
01217  * Set resolution of the grayscale image which performs a downsampling.
01218  * 
01219  *
01220  * @param   pDfvObj Pointer to DfvObj instance.
01221  * @param   newVal  the value of resolution.
01222  */
01223 DFVINTERFACE_API void dfv_setPdfGrayscaleImageDownSamplingDPI(CDfvObjPtr pDfvObj, int newVal);
01224 
01225 /**
01226  * Effective when outputting to PDF.
01227  * Gets the value of how to compress the monochrome images embedded in PDF.
01228  * 
01229  *
01230  * <table border="0" cellspacing="0" cellpadding="0">
01231  *  <tr><td>MONOCMPR_CCITT4     </td><td>= 0 CCITTFaxDecode group 4 filter,default value</td></tr>
01232  *  <tr><td>MONOCMPR_CCITT3     </td><td>= 1 CCITTFaxDecode group 3 filter</td></tr>
01233  *  <tr><td>MONOCMPR_RUNLENGTH  </td><td>= 2 RunLengthDecode filter</td></tr>
01234  *  <tr><td>MONOCMPR_ZLIB       </td><td>= 3 FlateDecode filter</td></tr>
01235  *  <tr><td>MONOCMPR_OFF        </td><td>= 4 no filter</td></tr>
01236  * </table>
01237  *
01238  * @param   pDfvObj Pointer to DfvObj instance.
01239  * @return  the value of how raster graphics are compressed and stored
01240  */
01241 DFVINTERFACE_API DfvMONOCHROMECOMPRESSION dfv_getPdfMonochromeImageCompression(CDfvObjPtr pDfvObj);
01242 
01243 /**
01244  * Effective when outputting to PDF.
01245  * When the monochrome image format cannot be stored directly in PDF, the image is stored after being transformed into the bit map format which is compatible with PDF. The compression method of the data stored in a PDF file is then specified by one of the following values.<BR>
01246 This is the setting for the monochrome image. Spesify dfv_setPdfGrayscaleImageCompression for the grayscale image, and dfv_setPdfImageCompression for the color image.
01247  * 
01248  *
01249  * <table border="0" cellspacing="0" cellpadding="0">
01250  *  <tr><td>MONOCMPR_CCITT4     </td><td>= 0 CCITTFaxDecode group 4 filter,default value</td></tr>
01251  *  <tr><td>MONOCMPR_CCITT3     </td><td>= 1 CCITTFaxDecode group 3 filter</td></tr>
01252  *  <tr><td>MONOCMPR_RUNLENGTH  </td><td>= 2 RunLengthDecode filter</td></tr>
01253  *  <tr><td>MONOCMPR_ZLIB       </td><td>= 3 FlateDecode filter</td></tr>
01254  *  <tr><td>MONOCMPR_OFF        </td><td>= 4 no filter</td></tr>
01255  * </table>
01256  *
01257  * @param   pDfvObj Pointer to DfvObj instance.
01258  * @param   newVal  the value of how raster graphics are compressed and stored
01259  */
01260 DFVINTERFACE_API void dfv_setPdfMonochromeImageCompression(CDfvObjPtr pDfvObj, DfvMONOCHROMECOMPRESSION newVal);
01261 
01262 /**
01263  * Effective when outputting to PDF.
01264  * Gets the value of method to downsample the monochrome image
01265  * 
01266  *
01267  * @param   pDfvObj Pointer to DfvObj instance.
01268  * @return  the value of method to downsample the monochrome image
01269  */
01270 DFVINTERFACE_API DfvIMAGEDOWNSAMPLING dfv_getPdfMonochromeImageDownSampling(CDfvObjPtr pDfvObj);
01271 
01272 /**
01273  * Effective when outputting to PDF.
01274  * Specifies the following either of method to downsample the monochrome image that is put into PDF.
01275  * 
01276  *
01277  * <table border="0" cellspacing="0" cellpadding="0">
01278  *  <tr><td>IMGDOWNSAMPLING_NONE    </td><td>= 0 No downsampling </td></tr>
01279  *  <tr><td>IMGDOWNSAMPLING_AVERAGE </td><td>= 1 Average downsamplin</td></tr>
01280  *  <tr><td>IMGDOWNSAMPLING_BICUBIC </td><td>= 2 Bicubic downsampling</td></tr>
01281  *  <tr><td>IMGDOWNSAMPLING_SUBSAMPLING </td><td>= 3 Subsampling</td></tr>
01282  * </table>
01283  *
01284  * When the value except IMGDOWNSAMPLING_NONE is specified, the image that has the resolution larger than the one specified by dfv_setPdfMonochromeImageDownSamplingDPI will be downsampled into the resolution specified by dfv_setPdfMonochromeImageDownSamplingTarget.
01285 This is the setting for the monochrome image. Spesify dfv_setPdfImageDownSampling for the color image, and dfv_setPdfGrayscaleImageDownSampling for the grayscale image.
01286  *
01287  * @param   pDfvObj Pointer to DfvObj instance.
01288  * @param   newVal  the value of method to downsample the monochrome image
01289  */
01290 DFVINTERFACE_API void dfv_setPdfMonochromeImageDownSampling(CDfvObjPtr pDfvObj, DfvIMAGEDOWNSAMPLING newVal);
01291 
01292 /**
01293  * Effective when outputting to PDF.
01294  * Gets resolution when the monochrome image is downsampled.
01295  * 
01296  *
01297  * @param   pDfvObj Pointer to DfvObj instance.
01298  * @return  the value of resolution.
01299  */
01300 DFVINTERFACE_API int dfv_getPdfMonochromeImageDownSamplingTarget(CDfvObjPtr pDfvObj);
01301 
01302 /**
01303  * Effective when outputting to PDF.
01304  * Set resolution when the monochrome image is downsampled.
01305  * 
01306  *
01307  * @param   pDfvObj Pointer to DfvObj instance.
01308  * @param   newVal  the value of resolution.
01309  */
01310 DFVINTERFACE_API void dfv_setPdfMonochromeImageDownSamplingTarget(CDfvObjPtr pDfvObj, int newVal);
01311 
01312 /**
01313  * Effective when outputting to PDF.
01314  * Gets resolution of the monochrome image which performs a downsampling.
01315  * 
01316  *
01317  * @param   pDfvObj Pointer to DfvObj instance.
01318  * @return  the value of resolution.
01319  */
01320 DFVINTERFACE_API int dfv_getPdfMonochromeImageDownSamplingDPI(CDfvObjPtr pDfvObj);
01321 
01322 /**
01323  * Effective when outputting to PDF.
01324  * Set resolution of the monochrome image which performs a downsampling.
01325  * 
01326  *
01327  * @param   pDfvObj Pointer to DfvObj instance.
01328  * @param   newVal  the value of resolution.
01329  */
01330 DFVINTERFACE_API void dfv_setPdfMonochromeImageDownSamplingDPI(CDfvObjPtr pDfvObj, int newVal);
01331 
01332 /**
01333  * Effective when outputting to PDF.
01334  * Gets the width of PDF to output.
01335  * 
01336  *
01337  * @param   pDfvObj Pointer to DfvObj instance.
01338  * @param   pVal        Pointer to the buffer that will receive the width of PDF. If the string is as long or longer than the buffer,
01339  *            the string is truncated and terminated with a NULL character.
01340  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01341  * @return  Returns the 'pVal'.
01342  */
01343 DFVINTERFACE_API char* dfv_getPdfOutputWidth(CDfvObjPtr pDfvObj, char* pVal, int size);
01344 
01345 /**
01346  * Effective when outputting to PDF.
01347  * Gets the width of PDF to output.
01348  * 
01349  *
01350  * @param   pDfvObj Pointer to DfvObj instance.
01351  * @param   pVal        Pointer to the buffer that will receive the width of PDF. If the string is as long or longer than the buffer,
01352  *            the string is truncated and terminated with a NULL character.
01353  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01354  * @return  Returns the 'pVal'.
01355  */
01356 DFVINTERFACE_API wchar_t* dfv_getPdfOutputWidthW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01357 
01358 /**
01359  * Effective when outputting to PDF.
01360  * Scales the width of PDF to output. A value with a unit or % value can be specified as length.
01361  * 
01362  *
01363  * @param   pDfvObj Pointer to DfvObj instance.
01364  * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
01365  */
01366 DFVINTERFACE_API void dfv_setPdfOutputWidth(CDfvObjPtr pDfvObj, const char* newVal);
01367 
01368 /**
01369  * Effective when outputting to PDF.
01370  * Scales the width of PDF to output. A value with a unit or % value can be specified as length.
01371  * 
01372  *
01373  * @param   pDfvObj Pointer to DfvObj instance.
01374  * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
01375  */
01376 DFVINTERFACE_API void dfv_setPdfOutputWidthW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01377 
01378 /**
01379  * Effective when outputting to PDF.
01380  * Gets the height of PDF to output.
01381  * 
01382  *
01383  * @param   pDfvObj Pointer to DfvObj instance.
01384  * @param   pVal        Pointer to the buffer that will receive the height of PDF. If the string is as long or longer than the buffer,
01385  *            the string is truncated and terminated with a NULL character.
01386  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01387  * @return  Returns the 'pVal'.
01388  */
01389 DFVINTERFACE_API char* dfv_getPdfOutputHeight(CDfvObjPtr pDfvObj, char* pVal, int size);
01390 
01391 /**
01392  * Effective when outputting to PDF.
01393  * Gets the height of PDF to output.
01394  * 
01395  *
01396  * @param   pDfvObj Pointer to DfvObj instance.
01397  * @param   pVal        Pointer to the buffer that will receive the height of PDF. If the string is as long or longer than the buffer,
01398  *            the string is truncated and terminated with a NULL character.
01399  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01400  * @return  Returns the 'pVal'.
01401  */
01402 DFVINTERFACE_API wchar_t* dfv_getPdfOutputHeightW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01403 
01404 /**
01405  * Effective when outputting to PDF.
01406  * Scales the height of PDF to output. A value with a unit or % value can be specified as length.
01407  * 
01408  *
01409  * @param   pDfvObj Pointer to DfvObj instance.
01410  * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
01411  */
01412 DFVINTERFACE_API void dfv_setPdfOutputHeight(CDfvObjPtr pDfvObj, const char* newVal);
01413 
01414 /**
01415  * Effective when outputting to PDF.
01416  * Scales the height of PDF to output. A value with a unit or % value can be specified as length.
01417  * 
01418  *
01419  * @param   pDfvObj Pointer to DfvObj instance.
01420  * @param   newVal  Pointer to a null-terminated string to be used as the width of PDF to output.
01421  */
01422 DFVINTERFACE_API void dfv_setPdfOutputHeightW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01423 
01424 /**
01425 * Specifies the scaling ratio of the PDF to output.
01426 * A value with a unit or % value can be specified as length.
01427 * Effective when outputting to PDF.
01428 *
01429 * @param    pDfvObj Pointer to DfvObj instance.
01430 * @param    newVal      the scaling ratio of the PDF
01431 */
01432 DFVINTERFACE_API void dfv_setPdfOutputScale(CDfvObjPtr pDfvObj, const char* newVal);
01433 
01434 /**
01435 * Specifies the scaling ratio of the PDF to output.
01436 * A value with a unit or % value can be specified as length.
01437 * Effective when outputting to PDF.
01438 *
01439 * @param    pDfvObj Pointer to DfvObj instance.
01440 * @param    newVal      the scaling ratio of the PDF
01441 */
01442 DFVINTERFACE_API void dfv_setPdfOutputScaleW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01443 
01444 /**
01445  * Effective when outputting to PDF.
01446  * Gets the value of whether to issue error or not when PDF/X is generating.
01447  * 
01448  *
01449  * @param   pDfvObj Pointer to DfvObj instance.
01450  * @return  the value of whether to issue error.
01451  */
01452 DFVINTERFACE_API long dfv_getPdfErrorOnPDFXFault(CDfvObjPtr pDfvObj);
01453 
01454 /**
01455  * Effective when outputting to PDF.
01456  * An error is not issued when PDF/X is generating.
01457  * 
01458  *
01459  * @param   pDfvObj Pointer to DfvObj instance.
01460  * @param   newVal  If the value is 'true' is specified, no error is issued.
01461  */
01462 DFVINTERFACE_API void dfv_setPdfErrorOnPDFXFault(CDfvObjPtr pDfvObj, long newVal);
01463 
01464 
01465 /**
01466  * Effective when inputting from PDF.
01467  * Specifies whether to output PDF Anottation.
01468  * 
01469  *
01470  * @param   pDfvObj Pointer to DfvObj instance.
01471  * @return  If non zero is returned, Anottation is output.
01472  *          If zero is returned, Anottation is not output.
01473  */
01474 DFVINTERFACE_API long dfv_getPdfAnnotation(CDfvObjPtr pDfvObj);
01475 
01476 /**
01477 * Effective when inputting from PDF.
01478 * Gets the setting indicating whether  to output PDF Anottation.
01479 * 
01480 *
01481 * @param    pDfvObj Pointer to DfvObj instance.
01482 * @param    newVal  If non zero is specified, Anottation is output.
01483 */
01484 DFVINTERFACE_API void dfv_setPdfAnnotation(CDfvObjPtr pDfvObj, long newVal);
01485 
01486 
01487 /**
01488 * Effective when outputting to PDF.
01489 * Gets the format for naming files when the outputted PDF becomes multiple.
01490 *
01491 *
01492 * @param    pDfvObj Pointer to DfvObj instance.
01493 * @param    pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
01494 * @param    size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01495 * @return   Returns the 'pVal'.
01496 */
01497 DFVINTERFACE_API char* dfv_getPdfFormat(CDfvObjPtr pDfvObj, char* pVal, int size);
01498 
01499 /**
01500 * Effective when outputting to PDF.
01501 * Gets the format for naming files when the outputted PDF becomes multiple.
01502 *
01503 *
01504 * @param    pDfvObj Pointer to DfvObj instance.
01505 * @param    pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
01506 * @param    size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01507 * @return   Returns the 'pVal'.
01508 */
01509 DFVINTERFACE_API wchar_t* dfv_getPdfFormatW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01510 
01511 /**
01512 * Effective when outputting to PDF.
01513 * Specifies the format for naming files when the outputted PDF becomes multiple.
01514 *
01515 *
01516 * @param    pDfvObj Pointer to DfvObj instance.
01517 * @param    newVal  Pointer to a null-terminated string to be used as the PDF file name format.
01518 */
01519 DFVINTERFACE_API void dfv_setPdfFormat(CDfvObjPtr pDfvObj, const char* newVal);
01520 
01521 /**
01522 * Effective when outputting to PDF.
01523 * Specifies the format for naming files when the outputted PDF becomes multiple.
01524 *
01525 *
01526 * @param    pDfvObj Pointer to DfvObj instance.
01527 * @param    newVal  Pointer to a null-terminated string to be used as the PDF file name format.
01528 */
01529 DFVINTERFACE_API void dfv_setPdfFormatW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01530 
01531 
01532 /**
01533  * Effective when outputting to SVG.
01534  * Get the version of SVG.
01535  * 
01536  *
01537  * @param   pDfvObj Pointer to DfvObj instance.
01538  * @return  the version of SVG.
01539  */
01540 DFVINTERFACE_API DfvSVGVERSION  dfv_getSvgVersion(CDfvObjPtr pDfvObj);
01541 
01542 /**
01543  * Effective when outputting to SVG.
01544  * Enables specifying whether the version of SVG is 1.1, Basic or Tiny.
01545  * 
01546  *
01547  * @param   pDfvObj Pointer to DfvObj instance.
01548  * @param   newVal  Specifies the version of SVG.
01549  */
01550 DFVINTERFACE_API void dfv_setSvgVersion(CDfvObjPtr pDfvObj, DfvSVGVERSION newVal);
01551 
01552 /**
01553  * Effective when outputting to SVG.
01554  * Gets the setting indicating whether to compress the outputted SVG into gzip format or not.
01555  * 
01556  *
01557  * @param   pDfvObj Pointer to DfvObj instance.
01558  * @return  whether gzip compression or not.
01559  */
01560 DFVINTERFACE_API long dfv_getSvgGzipCompression(CDfvObjPtr pDfvObj);
01561 
01562 /**
01563  * Effective when outputting to SVG.
01564  * Specifies whether to compress the outputted SVG into gzip format or not.
01565  * 
01566  *
01567  * @param   pDfvObj Pointer to DfvObj instance.
01568  * @param   newVal  If the value is 'true' is specified, enables to compress data into gzip format.
01569  */
01570 DFVINTERFACE_API void dfv_setSvgGzipCompression(CDfvObjPtr pDfvObj, long newVal);
01571 
01572 /**
01573  * this function is not supported.
01574  */
01575 DFVINTERFACE_API long dfv_getSvgEmbedAllFonts(CDfvObjPtr pDfvObj);
01576 
01577 /**
01578  * this function is not supported.
01579  */
01580 DFVINTERFACE_API void dfv_setSvgEmbedAllFonts(CDfvObjPtr pDfvObj, long newVal);
01581 
01582 /**
01583  * Effective when outputting to SVG.
01584  * Gets the format for naming files when the outputted SVG becomes multiple.
01585  * 
01586  *
01587  * @param   pDfvObj Pointer to DfvObj instance.
01588  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
01589  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01590  * @return  Returns the 'pVal'.
01591  */
01592 DFVINTERFACE_API char* dfv_getSvgFormat(CDfvObjPtr pDfvObj, char* pVal, int size);
01593 
01594 /**
01595  * Effective when outputting to SVG.
01596  * Gets the format for naming files when the outputted SVG becomes multiple.
01597  * 
01598  *
01599  * @param   pDfvObj Pointer to DfvObj instance.
01600  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer, the string is truncated and terminated with a NULL character.
01601  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01602  * @return  Returns the 'pVal'.
01603  */
01604 DFVINTERFACE_API wchar_t* dfv_getSvgFormatW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01605 
01606 /**
01607  * Effective when outputting to SVG.
01608  * Specifies the format for naming files when the outputted SVG becomes multiple.
01609  * 
01610  *
01611  * @param   pDfvObj Pointer to DfvObj instance.
01612  * @param   newVal  Pointer to a null-terminated string to be used as the SVG file name format.
01613  */
01614 DFVINTERFACE_API void dfv_setSvgFormat(CDfvObjPtr pDfvObj, const char* newVal);
01615 
01616 /**
01617  * Effective when outputting to SVG.
01618  * Specifies the format for naming files when the outputted SVG becomes multiple.
01619  * 
01620  *
01621  * @param   pDfvObj Pointer to DfvObj instance.
01622  * @param   newVal  Pointer to a null-terminated string to be used as the SVG file name format.
01623  */
01624 DFVINTERFACE_API void dfv_setSvgFormatW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01625 
01626 /**
01627  * this function is not supported.
01628  */
01629 DFVINTERFACE_API char* dfv_getSvgEmbedFonts(CDfvObjPtr pDfvObj, char* pVal, int size);
01630 
01631 /**
01632  * this function is not supported.
01633  */
01634 DFVINTERFACE_API wchar_t* dfv_getSvgEmbedFontsW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01635 
01636 /**
01637  * this function is not supported.
01638  */
01639 DFVINTERFACE_API void dfv_setSvgEmbedFonts(CDfvObjPtr pDfvObj, const char* newVal);
01640 
01641 /**
01642  * this function is not supported.
01643  */
01644 DFVINTERFACE_API void dfv_setSvgEmbedFontsW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01645 
01646 /**
01647  * this function is not supported.
01648  */
01649 DFVINTERFACE_API long dfv_getSvgErrorOnEmbedFault(CDfvObjPtr pDfvObj);
01650 
01651 /**
01652  * this function is not supported.
01653  */
01654 DFVINTERFACE_API void dfv_setSvgErrorOnEmbedFault(CDfvObjPtr pDfvObj, long newVal);
01655 
01656 /**
01657  * this function is not supported.
01658  */
01659 DFVINTERFACE_API DfvIMAGECONVERSION dfv_getSvgImageConversion(CDfvObjPtr pDfvObj);
01660 
01661 /**
01662  * Effective when outputting to SVG.
01663  * Selects how to compress the images embedded in SVG to create from the following.
01664  * 
01665  *
01666  * <table border="0" cellspacing="0" cellpadding="0">
01667  *  <tr><td>IMGCMPR_AUTO    </td><td>= 0 Auto conversion</td></tr>
01668  *  <tr><td>IMGCMPR_JPEG    </td><td>= 1 JPEG conversion</td></tr>
01669  *  <tr><td>IMGCMPR_PNG     </td><td>= 2 PNG conversion</td></tr>
01670  * </table>
01671  *
01672  * @param   pDfvObj Pointer to DfvObj instance.
01673  * @param   newVal  the value of how raster graphics are compressed and stored
01674  */
01675 DFVINTERFACE_API void dfv_setSvgImageConversion(CDfvObjPtr pDfvObj, DfvIMAGECONVERSION newVal);
01676 
01677 /**
01678  * Gets the value of the quality of JPEG format that is specified by dfv_setSvgImageConversion() stored in SVG.
01679  * 
01680  *
01681  * @param   pDfvObj Pointer to DfvObj instance.
01682  * @return  the value of the quality
01683  */
01684 DFVINTERFACE_API int dfv_getSvgJPEGQuality(CDfvObjPtr pDfvObj);
01685 
01686 /**
01687  * Effective when outputting to SVG.
01688  * Specifies the quality of the Raster graphics when stored in JPEG format using the range of 1-100.
01689  * The quality becomes higher in proportion to the increase in the number; however the file size also becomes larger.
01690  * The initial value is 80.
01691  * 
01692  *
01693  * @param   pDfvObj Pointer to DfvObj instance.
01694  * @param   newVal  JPEG quality (1 to 100)
01695  */
01696 DFVINTERFACE_API void dfv_setSvgJPEGQuality(CDfvObjPtr pDfvObj, int newVal);
01697 
01698 /**
01699  * Effective when outputting to SVG.
01700  * Gets specification how to treat the referred image.
01701  * 
01702  *
01703  * <table border="0" cellspacing="0" cellpadding="0">
01704  *  <tr><td>IMGPT_EMBED_ALL </td><td>= 0 Embeds all images to SVG.</td></tr>
01705  *  <tr><td>IMGPT_COPY_ALL  </td><td>= 1 Copies all image files to the destination that is specified by setSvgImageCopyPath, and then links.</td></tr>
01706  *  <tr><td>IMGPT_LINK      </td><td>= 2 Links images that have been linked, and embeds the embedded image. However, the raster images other than JPEG and PNG are always embedded.</td></tr>
01707  *  <tr><td>IMGPT_COPY      </td><td>= 3 Copies images that have been linked to the destination that is specified by setSvgImageCopyPath, and links. The embedded image are embedded.</td></tr>
01708  * </table>
01709  *
01710  * @param   pDfvObj Pointer to DfvObj instance.
01711  * @return  specification how to treat the referred image.
01712  */
01713 DFVINTERFACE_API DfvIMAGEPROCTYPE dfv_getSvgImageProcessingType(CDfvObjPtr pDfvObj);
01714 
01715 /**
01716  * Effective when outputting to SVG.
01717  * Specifies how to treat the referred image.
01718  * 
01719  *
01720  * <table border="0" cellspacing="0" cellpadding="0">
01721  *  <tr><td>IMGPT_EMBED_ALL </td><td>= 0 Embeds all images to SVG.</td></tr>
01722  *  <tr><td>IMGPT_COPY_ALL  </td><td>= 1 Copies all image files to the destination that is specified by setSvgImageCopyPath, and then links.</td></tr>
01723  *  <tr><td>IMGPT_LINK      </td><td>= 2 Links images that have been linked, and embeds the embedded image. However, the raster images other than JPEG and PNG are always embedded.</td></tr>
01724  *  <tr><td>IMGPT_COPY      </td><td>= 3 Copies images that have been linked to the destination that is specified by setSvgImageCopyPath, and links. The embedded image are embedded.</td></tr>
01725  * </table>
01726  *
01727  * @param   pDfvObj Pointer to DfvObj instance.
01728  * @param   newVal  specification how to treat the referred image.
01729  */
01730 DFVINTERFACE_API void dfv_setSvgImageProcessingType(CDfvObjPtr pDfvObj, DfvIMAGEPROCTYPE newVal);
01731 
01732 /**
01733  * Effective when outputting to SVG.
01734  * Gets the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by dfv_setSvgImageProcessingType.
01735  * 
01736  *
01737  * @param   pDfvObj Pointer to DfvObj instance.
01738  * @param   pVal        Pointer to the buffer that will receive the image copy path. If the string is as long or longer than the buffer,
01739  *            the string is truncated and terminated with a NULL character.
01740  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01741  * @return  Returns the 'pVal'.
01742  */
01743 DFVINTERFACE_API char* dfv_getSvgImageCopyPath(CDfvObjPtr pDfvObj, char* pVal, int size);
01744 
01745 /**
01746  * Effective when outputting to SVG.
01747  * Specifies the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by dfv_setSvgImageProcessingType.
01748  * 
01749  *
01750  * @param   pDfvObj Pointer to DfvObj instance.
01751  * @param   newVal  Pointer to a null-terminated string to be used as image copy path
01752  */
01753 DFVINTERFACE_API void dfv_setSvgImageCopyPath(CDfvObjPtr pDfvObj, const char* newVal);
01754 
01755 /**
01756  * Effective when outputting to SVG.
01757  * Gets the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by dfv_setSvgImageProcessingType.
01758  * 
01759  *
01760  * @param   pDfvObj Pointer to DfvObj instance.
01761  * @param   pVal        Pointer to the buffer that will receive the image copy path. If the string is as long or longer than the buffer,
01762  *            the string is truncated and terminated with a NULL character.
01763  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01764  * @return  Returns the 'pVal'.
01765  */
01766 DFVINTERFACE_API wchar_t* dfv_getSvgImageCopyPathW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01767 
01768 /**
01769  * Effective when outputting to SVG.
01770  * Specifies the copy destination of image as specifying IMGPT_COPY_ALL or IMGPT_COPY by dfv_setSvgImageProcessingType.
01771  * 
01772  *
01773  * @param   pDfvObj Pointer to DfvObj instance.
01774  * @param   newVal  Pointer to a null-terminated string to be used as image copy path
01775  */
01776 DFVINTERFACE_API void dfv_setSvgImageCopyPathW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01777 
01778 /**
01779  * Effective when outputting to SVG.
01780  * Gets specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages. <BR>
01781  * 
01782  *
01783  * @param   pDfvObj Pointer to DfvObj instance.
01784  * @return  specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages.
01785  */
01786 DFVINTERFACE_API long dfv_getSvgSingleFile(CDfvObjPtr pDfvObj);
01787 
01788 /**
01789  * Effective when outputting to SVG.
01790  * Specifies whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages. <BR>
01791  * If the value is true, outputs one SVG. If the value is false, outputs multiple SVG. When multiple SVG is output, the file name is modified by specifying format. <BR>
01792  * Effective only when outputting to the file. It is invalid in the output without the file name like the stream etc.
01793  * 
01794  *
01795  * @param   pDfvObj Pointer to DfvObj instance.
01796  * @param   newVal  specification whether to divide into multiple SVG or to output as one SVG when the formatted result extends to multiple pages.
01797  */
01798 DFVINTERFACE_API void dfv_setSvgSingleFile(CDfvObjPtr pDfvObj, long newVal);
01799 
01800 #if !defined(_DOXYGEN)
01801 
01802 /**
01803  * Gets the value specified by setSvgSingleFileMaxPages.
01804  * Effective when outputting to SVG. 
01805  *
01806  * @param   pDfvObj Pointer to DfvObj instance.
01807  * @return  the value specified by setSvgSingleFileMaxPages.
01808  */
01809 DFVINTERFACE_API int dfv_getSvgSingleFileMaxPages(CDfvObjPtr pDfvObj);
01810 
01811 /**
01812  * Specifies the maximum number of pages outputted when setSvgSingleFile = True is specified. .
01813  * When this parameter is omitted If this parameter is omitted, "5000" is considered as specified.
01814  * When either setSvgSingleFileMaxPages or setSvgSingleFileMaxHeight is specified, or both are specified, and the page exceeds either the maximum size (setSvgSingleFileMaxHeight) or the maximum number of pages (setSvgSingleFileMaxPages), Server Based Converter V1.2 will stop converting and abort the job as an error. Effective when outputting to SVG. 
01815  * 
01816  * @param   pDfvObj Pointer to DfvObj instance.
01817  * @param   newVal  maximum number of pages 
01818  */
01819 DFVINTERFACE_API void dfv_setSvgSingleFileMaxPages(CDfvObjPtr pDfvObj, int newVal);
01820 
01821 /**
01822  * Gets the value specified by setSvgImageDownsamplingDPI.
01823  * Effective when outputting to SVG. 
01824  * 
01825  * @param   pDfvObj Pointer to DfvObj instance.
01826  * @return  the value specified by setSvgImageDownsamplingDPI. 
01827  */
01828 DFVINTERFACE_API int dfv_getSvgImageDownsamplingDPI(CDfvObjPtr pDfvObj);
01829 
01830 /**
01831  * Specifies the resolution of the down sampling when embedding an image with 1 or more integers. .
01832  * When the resolution of the original image is lower than specification, it's embedded with the lower resolution. Effective when outputting to SVG. 
01833  * 
01834  * @param   pDfvObj Pointer to DfvObj instance.
01835  * @return  newVal  the resolution of the down sampling 
01836  */
01837 DFVINTERFACE_API void dfv_setSvgImageDownsamplingDPI(CDfvObjPtr pDfvObj, int dpi);
01838 
01839 /**
01840  * Gets the value specified by setSvgImageDownsamplingMethod.
01841  * Effective when outputting to SVG. 
01842  * 
01843  * @param   pDfvObj Pointer to DfvObj instance.
01844  * @return  the value specified by setSvgImageDownsamplingMethod
01845  */
01846 DFVINTERFACE_API int dfv_getSvgImageDownsamplingMethod(CDfvObjPtr pDfvObj);
01847 
01848 /**
01849  * Specifies the way of compression when down sampled.
01850  * 
01851  * S_SVG_IMGDOWNSAMPLING_AVERAGE : biliner 
01852  * S_SVG_IMGDOWNSAMPLING_BICUBIC : bicubic 
01853  * S_SVG_IMGDOWNSAMPLING_SUBSAMPLING : nearest neighbor
01854  * If this parameter is omitted, "IMGDOWNSAMPLING_AVERAGE" is considered as specified. Effective when outputting to SVG. 
01855  * 
01856  * @param   pDfvObj Pointer to DfvObj instance.
01857  * @param   type    the way of compression when down sampled 
01858  */
01859 DFVINTERFACE_API void dfv_setSvgImageDownsamplingMethod(CDfvObjPtr pDfvObj, int type);
01860 
01861 #endif
01862 
01863 /**
01864  * Effective when outputting to SVG.
01865  * Gets specification whether to rename all file name to prefix specified by dfv_setSvgImagePrefix, or use original name.
01866  * 
01867  *
01868  * @param   pDfvObj Pointer to DfvObj instance.
01869  * @return  specification whether to rename all file name to prefix specified by dfv_setSvgImagePrefix, or use original name.
01870  */
01871 DFVINTERFACE_API long dfv_getSvgImageRename(CDfvObjPtr pDfvObj);
01872 
01873 /**
01874  * Effective when outputting to SVG.
01875  * When images are copied to the directory specified by dfv_setSvgImageCopyPath etc. and processed, specifies whether to rename all file name to prefix specified by dfv_setSvgImagePrefix, or use original name. When the file name overlaps, sequential number is added. When true is specified, all files are renamed.
01876  *
01877  * 
01878  *
01879  * @param   pDfvObj Pointer to DfvObj instance.
01880  * @param   newVal  specification whether to rename all file name to prefix specified by dfv_setSvgImagePrefix, or use original name.
01881  */
01882 DFVINTERFACE_API void dfv_setSvgImageRename(CDfvObjPtr pDfvObj, long newVal);
01883 
01884 /**
01885  * Effective when outputting to SVG.
01886  * Gets the prefix of the file name when images are copied to the directory specified by dfv_setSvgImageCopyPath and processed.
01887  * 
01888  *
01889  * @param   pDfvObj Pointer to DfvObj instance.
01890  * @param   pVal        Pointer to the buffer that will receive the prefix. If the string is as long or longer than the buffer,
01891  *            the string is truncated and terminated with a NULL character.
01892  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01893  * @return  Returns the 'pVal'.
01894  */
01895 DFVINTERFACE_API char* dfv_getSvgImagePrefix(CDfvObjPtr pDfvObj, char* pVal, int size);
01896 
01897 /**
01898  * Effective when outputting to SVG.
01899  * When images are copied to the directory specified by dfv_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.
01900  *
01901  * 
01902  *
01903  * @param   pDfvObj Pointer to DfvObj instance.
01904  * @param   newVal  the prefix of the file name.
01905  */
01906 DFVINTERFACE_API void dfv_setSvgImagePrefix(CDfvObjPtr pDfvObj, const char* newVal);
01907 
01908 /**
01909  * Effective when outputting to SVG.
01910  * Gets the prefix of the file name when images are copied to the directory specified by dfv_setSvgImageCopyPath and processed.
01911  * 
01912  *
01913  * @param   pDfvObj Pointer to DfvObj instance.
01914  * @param   pVal        Pointer to the buffer that will receive the prefix. If the string is as long or longer than the buffer,
01915  *            the string is truncated and terminated with a NULL character.
01916  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01917  * @return  Returns the 'pVal'.
01918  */
01919 DFVINTERFACE_API wchar_t* dfv_getSvgImagePrefixW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01920 
01921 /**
01922  * Effective when outputting to SVG.
01923  * When images are copied to the directory specified by dfv_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.
01924  * 
01925  *
01926  * @param   pDfvObj Pointer to DfvObj instance.
01927  * @param   newVal  the prefix of the file name.
01928  */
01929 DFVINTERFACE_API void dfv_setSvgImagePrefixW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01930 
01931 /**
01932  * Effective when outputting to SVG.
01933  * Gets specification whether to add sequential number to the output SVG even if it has only one-page.
01934  * 
01935  *
01936  * @param   pDfvObj Pointer to DfvObj instance.
01937  * @return  specification whether to add sequential number to the output SVG even if it has only one-page.
01938  */
01939 DFVINTERFACE_API long dfv_getSvgSinglePageNumber(CDfvObjPtr pDfvObj);
01940 
01941 /**
01942  * Effective when outputting to SVG.
01943  * When dfv_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.
01944  * 
01945  *
01946  * @param   pDfvObj Pointer to DfvObj instance.
01947  * @param   newVal  specification whether to add sequential number to the output SVG even if it has only one-page.
01948  */
01949 DFVINTERFACE_API void dfv_setSvgSinglePageNumber(CDfvObjPtr pDfvObj, long newVal);
01950 
01951 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
01952 
01953 /**
01954  * Effective when outputting to SVG.
01955  * Gets the value of the rasterised-resolution of the transformed raster images.
01956  * 
01957  *
01958  * @param   pDfvObj Pointer to DfvObj instance.
01959  * @return  Rasterised-resolution
01960  */
01961 DFVINTERFACE_API int dfv_getSvgRasterizeResolution(CDfvObjPtr pDfvObj);
01962 
01963 /**
01964  * Effective when outputting to SVG.
01965  * 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.
01966  * This setting is effective only with Windows version.
01967  * 
01968  *
01969  * @param   pDfvObj Pointer to DfvObj instance.
01970  * @param   newVal  Rasterised-resolution (70 to 500)
01971  */
01972 DFVINTERFACE_API void dfv_setSvgRasterizeResolution(CDfvObjPtr pDfvObj, int newVal);
01973 
01974 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
01975 
01976 /**
01977 * Get the start volume of document to output.
01978 * @since 7.1
01979 *
01980 * @param    pDfvObj Pointer to DfvObj instance.
01981 * @return   start volume of output.
01982 */
01983 DFVINTERFACE_API long dfv_getStartVolume(CDfvObjPtr pDfvObj);
01984 
01985 /**
01986 * Specifies the start volume of document to output.
01987 * If the start volume is omitted or the specified value is 0 or less, the start volume is
01988 * considered from the first volume.
01989 * If the setting is inconsistent, (for example, StartVolume=5 EndVolume=3) an error occurs.
01990 * @since 7.1
01991 *
01992 * @param    pDfvObj Pointer to DfvObj instance.
01993 * @param    newVal  start volume of output.
01994 */
01995 DFVINTERFACE_API void dfv_setStartVolume(CDfvObjPtr pDfvObj, long newVal);
01996 
01997 /**
01998 * Get the end volume of document to output.
01999 * @since 7.1
02000 *
02001 * @param    pDfvObj Pointer to DfvObj instance.
02002 * @return   end volume of output.
02003 */
02004 DFVINTERFACE_API long dfv_getEndVolume(CDfvObjPtr pDfvObj);
02005 
02006 /**
02007 * Specifies the end volume of document to output.
02008 * If the end volume is omitted or the specified value exceeds the actual volume number, the end volume
02009 * is considered as the last volume.
02010 * If the setting is inconsistent, (for example, StartVolume=5 EndVolume=3) an error occurs.
02011 * @since 7.1
02012 *
02013 * @param    pDfvObj Pointer to DfvObj instance.
02014 * @param    newVal  end volume of output.
02015 */
02016 DFVINTERFACE_API void dfv_setEndVolume(CDfvObjPtr pDfvObj, long newVal);
02017 
02018 /**
02019 * Get multiple volume  of PDF output.
02020 * @since 7.1
02021 *
02022 * @param    pDfvObj Pointer to DfvObj instance.
02023 * @return   If zero is returned, multiple volume don't specified.
02024 *             If nonezero is returned, multiple volume specified.
02025 */
02026 DFVINTERFACE_API long dfv_getMultiVolume(CDfvObjPtr pDfvObj);
02027 
02028 /**
02029 * Specifies multiple volume of PDF output.
02030 * @since 7.1
02031 *
02032 * @param    pDfvObj Pointer to DfvObj instance.
02033 * @param    newVal  Specifies zero or nonzero.
02034 */
02035 DFVINTERFACE_API void dfv_setMultiVolume(CDfvObjPtr pDfvObj, long newVal);
02036 
02037 /**
02038  * Get the error level to abort formatting process.
02039  *
02040  * @param   pDfvObj Pointer to DfvObj instance.
02041  * @return  Returns the error level.
02042  */
02043 DFVINTERFACE_API DfvIfErrorLevel dfv_getExitLevel(CDfvObjPtr pDfvObj);
02044 
02045 /**
02046  * Error level to abort formatting process. Office Server Document Converter will stop formatting when the detected
02047  * error level is equal to ExitLevel property or higher. The default value is 2 (Warning).
02048  * Thus if an error occurred and error level is 2 (Warning) or higher, formatting process will be
02049  * aborted. Please use the value from 1 to 4. When the value of 5 or more specified, it is considered
02050  * to be the value of 4. If a error-level:4 (fatal error) occurs, the formatting process will be
02051  * aborted unconditionally.
02052  * BTW : An error is not displayed no matter what value may be specified to be this property.
02053  *
02054  * <table border="0" cellspacing="0" cellpadding="0">
02055  *  <tr><td>ELVL_INFORMATION    </td><td>= 1 Information</td></tr>
02056  *  <tr><td>ELVL_WARNING        </td><td>= 2 Warning</td></tr>
02057  *  <tr><td>ELVL_RECOVERABLE    </td><td>= 3 Recoveable Error</td></tr>
02058  *  <tr><td>ELVL_FATAL          </td><td>= 4 Fatal Error</td></tr>
02059  * </table>
02060  *
02061  * @param   pDfvObj Pointer to DfvObj instance.
02062  * @param   newVal  error level to abort formatting process.
02063  */
02064 DFVINTERFACE_API void dfv_setExitLevel(CDfvObjPtr pDfvObj, DfvIfErrorLevel newVal);
02065 
02066 /**
02067  * Returns the error level of the error that occurred during the formatting process.
02068  *
02069  * <table border="0" cellspacing="0" cellpadding="0">
02070  *  <tr><td>ELVL_INFORMATION    </td><td>= 1 Information</td></tr>
02071  *  <tr><td>ELVL_WARNING        </td><td>= 2 Warning</td></tr>
02072  *  <tr><td>ELVL_RECOVERABLE    </td><td>= 3 Recoveable Error</td></tr>
02073  *  <tr><td>ELVL_FATAL          </td><td>= 4 Fatal Error</td></tr>
02074  * </table>
02075  *
02076  * @param   pDfvObj Pointer to DfvObj instance.
02077  * @return  Returns the error level.
02078  */
02079 DFVINTERFACE_API DfvIfErrorLevel dfv_getErrorLevel(CDfvObjPtr pDfvObj);
02080 
02081 /**
02082  * Returns the error code of the error that occurred during the formatting process.
02083  * Zero means no error. Non-zero indicates any error occurred.
02084  *
02085  * @param   pDfvObj Pointer to DfvObj instance.
02086  * @return  Returns the error code.
02087  */
02088 DFVINTERFACE_API DfvIfErrorCode dfv_getErrorCode(CDfvObjPtr pDfvObj);
02089 
02090 /**
02091  * Returns the error message of the error that occurred during the formatting process.
02092  *
02093  * @param   pDfvObj Pointer to DfvObj instance.
02094  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02095  *            the string is truncated and terminated with a NULL character.
02096  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02097  * @return  Returns the 'pVal'.
02098  */
02099 DFVINTERFACE_API char* dfv_getErrorMessage(CDfvObjPtr pDfvObj, char* pVal, int size);
02100 /**
02101  * Returns the error message of the error that occurred during the formatting process.
02102  *
02103  * @param   pDfvObj Pointer to DfvObj instance.
02104  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02105  *            the string is truncated and terminated with a NULL character.
02106  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02107  * @return  Returns the 'pVal'.
02108  */
02109 DFVINTERFACE_API wchar_t* dfv_getErrorMessageW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02110 
02111 /**
02112  * Sets the substitution of font name. This substitution acts on the font names existing in FO.
02113  * The font name 'fontName' is replaced to 'aliasName'.
02114  * You cannot specify generic font names (serif, sans-serif, monospace, cursive, fantasy) as the substitute source (src).
02115  *
02116  * @param   pDfvObj Pointer to DfvObj instance.
02117  * @param   src     Specifies the font name which is replaced.
02118  * @param   dst     Specifies the aliasName.
02119  */
02120 DFVINTERFACE_API void dfv_setFontAlias(CDfvObjPtr pDfvObj, const char* src, const char* dst);
02121 /**
02122  * Sets the substitution of font name. This substitution acts on the font names existing in FO.
02123  * The font name 'fontName' is replaced to 'aliasName'.
02124  * You cannot specify generic font names (serif, sans-serif, monospace, cursive, fantasy) as the substitute source (src).
02125  *
02126  * @param   pDfvObj Pointer to DfvObj instance.
02127  * @param   src     Specifies the font name which is replaced.
02128  * @param   dst     Specifies the aliasName.
02129  */
02130 DFVINTERFACE_API void dfv_setFontAliasW(CDfvObjPtr pDfvObj, const wchar_t* src, const wchar_t* dst);
02131 
02132 /**
02133  * Clear all substitutions of font name.
02134  *
02135  * @param   pDfvObj Pointer to DfvObj instance.
02136  */
02137 DFVINTERFACE_API void dfv_clearFontAlias(CDfvObjPtr pDfvObj);
02138 /**
02139  * Clear all substitutions of font name.
02140  *
02141  * @param   pDfvObj Pointer to DfvObj instance.
02142  */
02143 
02144 /**
02145  * Erase the substitution of font name 'fontName'.
02146  *
02147  * @param   pDfvObj Pointer to DfvObj instance.
02148  * @param   src Specifies the font name which is replaced.
02149  */
02150 DFVINTERFACE_API void dfv_eraseFontAlias(CDfvObjPtr pDfvObj, const char* src);
02151 DFVINTERFACE_API void dfv_eraseFontAliasW(CDfvObjPtr pDfvObj, const wchar_t* src);
02152 
02153 /**
02154  * Execute formatting and output to a PDF specified in OutputFilePath or printer specified in PrinterName.
02155  *
02156  * @param   pDfvObj Pointer to DfvObj instance.
02157  * @return  Returns the error code. Zero means no error. Non-zero indicates any error occurred.
02158  */
02159 DFVINTERFACE_API DfvIfErrorCode dfv_execute(CDfvObjPtr pDfvObj);
02160 
02161 /**
02162  * Initialize formatting engine.
02163  *
02164  * @param   pDfvObj Pointer to DfvObj instance.
02165  */
02166 DFVINTERFACE_API void dfv_clear(CDfvObjPtr pDfvObj);
02167 
02168 /**
02169  * Specifies the callback fucntion.
02170  * The error that occurred during the formatting process can be received.
02171  *
02172  * @param   pDfvObj Pointer to DfvObj instance.
02173  * @param   proc        Address of the callback function.
02174  *  <br>Callback function has the following form:<pre>
02175  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
02176  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
02177  */
02178 DFVINTERFACE_API void dfv_setOnMessageProc(CDfvObjPtr pDfvObj, DfvOnMessageProc* proc);
02179 
02180 /**
02181  * Specifies the callback fucntion.
02182  * The error that occurred during the formatting process can be received.
02183  *
02184  * @param   pDfvObj Pointer to DfvObj instance.
02185  * @param   proc        Address of the callback function.
02186  *  <br>Callback function has the following form:<pre>
02187  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
02188  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
02189  */
02190 DFVINTERFACE_API void dfv_setOnMessageProcW(CDfvObjPtr pDfvObj, DfvOnMessageProcW* proc);
02191 
02192 /**
02193  * Specifies the callback fucntion.
02194  * The page number in the formatting process can be received.
02195  *
02196  * @param   pDfvObj Pointer to DfvObj instance.
02197  * @param   proc    Address of the callback function.
02198  *  <br>Callback function has the following form:<pre>
02199  * void DfvOnFormatPageProc(long pageNo);</pre>
02200  */
02201 DFVINTERFACE_API void dfv_setOnFormatPageProc(CDfvObjPtr pDfvObj, DfvOnFormatPageProc* proc);
02202 
02203 /**
02204  * Specifies the callback fucntion.
02205  * The error that occurred during the formatting process can be received.
02206  *
02207  * @param   pDfvObj Pointer to DfvObj instance.
02208  * @param   proc        Address of the callback function.
02209  *  <br>Callback function has the following form:<pre>
02210  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
02211  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
02212  * @param   pAnyObj     Address of an any object.
02213  */
02214 DFVINTERFACE_API void dfv_setOnMessageProcEx(CDfvObjPtr pDfvObj, DfvOnMessageProcEx* proc, void* pAnyObj);
02215 
02216 /**
02217  * Specifies the callback fucntion.
02218  * The error that occurred during the formatting process can be received.
02219  *
02220  * @param   pDfvObj Pointer to DfvObj instance.
02221  * @param   proc        Address of the callback function.
02222  *  <br>Callback function has the following form:<pre>
02223  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
02224  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
02225  * @param   pAnyObj     Address of an any object.
02226  */
02227 DFVINTERFACE_API void dfv_setOnMessageProcExW(CDfvObjPtr pDfvObj, DfvOnMessageProcExW* proc, void* pAnyObj);
02228 
02229 /**
02230  * Specifies the callback fucntion.
02231  * The page number in the formatting process can be received.
02232  *
02233  * @param   pDfvObj Pointer to DfvObj instance.
02234  * @param   proc    Address of the callback function.
02235  *  <br>Callback function has the following form:<pre>
02236  * void DfvOnFormatPageProc(long pageNo);</pre>
02237  * @param   pAnyObj     Address of an any object.
02238  */
02239 DFVINTERFACE_API void dfv_setOnFormatPageProcEx(CDfvObjPtr pDfvObj, DfvOnFormatPageProcEx* proc, void* pAnyObj);
02240 
02241 /* Print Interface */
02242 /**
02243  * Get the printer name where the formatted result is outputted.
02244  *
02245  * @param   pDfvObj Pointer to DfvObj instance.
02246  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02247  *            the string is truncated and terminated with a NULL character.
02248  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02249  * @return  Returns the 'pVal'.
02250  */
02251 DFVINTERFACE_API char* dfv_getPrinterName(CDfvObjPtr pDfvObj, char* pVal, int size);
02252 /**
02253  * Get the printer name where the formatted result is outputted.
02254  *
02255  * @param   pDfvObj Pointer to DfvObj instance.
02256  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02257  *            the string is truncated and terminated with a NULL character.
02258  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02259  * @return  Returns the 'pVal'.
02260  */
02261 DFVINTERFACE_API wchar_t* dfv_getPrinterNameW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02262 
02263 /**
02264  * Specifies the output format or the printer name to output.
02265  * When a printer name is specified, the formatted result is outputted to that printer.
02266  * When "\@STDPRN" is specified, the converted result is outputted to the currently used printer.
02267  * When "\@PDF" is specified, the converted result is outputted to PDF.
02268  * When "\@SVG" is specified, the converted result is outputted to SVG.
02269  * When "\@INX" is specified, the converted result is outputted to INX.
02270  * When "\@XPS" is specified, the converted result is outputted to XPS.
02271  * When "\@JPEG" is specified, the converted result is outputted to JPEG.
02272  * When "\@PJPEG" is specified, the converted result is output as progressive JPEG.
02273  * When "\@PNG" is specified, the converted result is outputted to PNG.
02274  * When "\@IPNG" is specified, the converted result is output as interlaced PNG.
02275  * When "\@TIFF" is specified, the converted result is outputted to TIFF.
02276  * When "\@TIFFC" is specified, the converted result is outputted to TIFF CMYK.
02277  * When "\@MTIFF" is specified, the converted result is outputted to multi-page TIFF.
02278  * When "\@MTIFFC" is specified, the converted result is outputted to multi-page TIFF of CMYK.
02279  * When omitted, it is considered as "\@PDF" was specified.
02280  * It's impossible to output to the printer with any OS's other than Windows.
02281  *
02282  * @param   pDfvObj Pointer to DfvObj instance.
02283  * @param   newVal  Pointer to a null-terminated string to be used as the printer name.
02284  */
02285 DFVINTERFACE_API void dfv_setPrinterName(CDfvObjPtr pDfvObj, const char* newVal);
02286 /**
02287  * Specifies the output format or the printer name to output.
02288  * When a printer name is specified, the formatted result is outputted to that printer.
02289  * When "\@STDPRN" is specified, the converted result is outputted to the currently used printer.
02290  * When "\@PDF" is specified, the converted result is outputted to PDF.
02291  * When "\@SVG" is specified, the converted result is outputted to SVG.
02292  * When "\@INX" is specified, the converted result is outputted to INX.
02293  * When "\@XPS" is specified, the converted result is outputted to XPS.
02294  * When "\@JPEG" is specified, the converted result is outputted to JPEG.
02295  * When "\@PJPEG" is specified, the converted result is output as progressive JPEG.
02296  * When "\@PNG" is specified, the converted result is outputted to PNG.
02297  * When "\@IPNG" is specified, the converted result is output as interlaced PNG.
02298  * When "\@TIFF" is specified, the converted result is outputted to TIFF.
02299  * When "\@TIFFC" is specified, the converted result is outputted to TIFF CMYK.
02300  * When "\@MTIFF" is specified, the converted result is outputted to multi-page TIFF.
02301  * When "\@MTIFFC" is specified, the converted result is outputted to multi-page TIFF of CMYK.
02302  * When omitted, it is considered as "\@PDF" was specified.
02303  * It's impossible to output to the printer with any OS's other than Windows.
02304  *
02305  * @param   pDfvObj Pointer to DfvObj instance.
02306  * @param   newVal  Pointer to a null-terminated string to be used as the printer name.
02307  */
02308 DFVINTERFACE_API void dfv_setPrinterNameW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02309 
02310 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02311 
02312 /**
02313  * Get the number of copies. Effective when outputting to printer.
02314  * This setting is effective only with Windows version.
02315  *
02316  * @param   pDfvObj Pointer to DfvObj instance.
02317  * @return  Returns the number of copies.
02318  */
02319 DFVINTERFACE_API long dfv_getPrnCopies(CDfvObjPtr pDfvObj);
02320 
02321 /**
02322  * Specifies the number of copies. Effective when outputting to printer.
02323  * If nothing is specified, the value is considered as 1.
02324  * This setting is effective only with Windows version.
02325  *
02326  * @param   pDfvObj Pointer to DfvObj instance.
02327  * @param   newVal  the number of copies.
02328  */
02329 DFVINTERFACE_API void dfv_setPrnCopies(CDfvObjPtr pDfvObj, long newVal);
02330 
02331 /**
02332  * Get collation of multiple copies.
02333  * This setting is effective only with Windows version.
02334  *
02335  * @param   pDfvObj Pointer to DfvObj instance.
02336  * @return  If zero is returned, the same page is multi-copied continuously.
02337  *            If nonezero is returned, the pages specified from start to end are printed repeatedly.
02338  */
02339 DFVINTERFACE_API long dfv_getPrnCollate(CDfvObjPtr pDfvObj);
02340 
02341 /**
02342  * Specifies collation of multiple copies. Effective when outputting to printer and the number of
02343  * copies is plural. If it is not specified or the value zero is specified, the same page is
02344  * multi-copied continuously.
02345  * If nonezero is specified, the pages specified from start to end are printed repeatedly.
02346  * This setting is effective only with Windows version.
02347  *
02348  * @param   pDfvObj Pointer to DfvObj instance.
02349  * @param   newVal  Zpecifies zero or nonzero.
02350  */
02351 DFVINTERFACE_API void dfv_setPrnCollate(CDfvObjPtr pDfvObj, long newVal);
02352 
02353 /**
02354  * Get the setting of whether print dialog box is displayed or not when printing
02355  * This setting is effective only with Windows version.
02356  *
02357  * @param   pDfvObj Pointer to DfvObj instance.
02358  * @return  If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.
02359  */
02360 DFVINTERFACE_API long dfv_getBatchPrint(CDfvObjPtr pDfvObj);
02361 
02362 /**
02363  * When the value 'false' is specified, the print dialog box is displayed when printing.
02364  * If the setting is omitted or the value 'true' is specified, the print dialog is not displayed.
02365  * This setting is effective only with Windows version.
02366  *
02367  * @param   pDfvObj Pointer to DfvObj instance.
02368  * @param   newVal  If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.
02369  */
02370 DFVINTERFACE_API void dfv_setBatchPrint(CDfvObjPtr pDfvObj, long newVal);
02371 
02372 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))   /* _WIN32 */
02373 
02374 /**
02375  * Get the version string of Office Server Document Converter.
02376  * 
02377  *
02378  * @param   pDfvObj Pointer to DfvObj instance.
02379  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02380  *            the string is truncated and terminated with a NULL character.
02381  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02382  * @return  Returns the 'pVal'.
02383  */
02384 DFVINTERFACE_API char* dfv_getVersion(CDfvObjPtr pDfvObj, char* pVal, int size);
02385 
02386 /**
02387  * Get the version string of Office Server Document Converter.
02388  * 
02389  *
02390  * @param   pDfvObj Pointer to DfvObj instance.
02391  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02392  *            the string is truncated and terminated with a NULL character.
02393  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02394  * @return  Returns the 'pVal'.
02395  */
02396 DFVINTERFACE_API wchar_t* dfv_getVersionW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02397 
02398 /**
02399  * Get INX output mode.
02400  *
02401  * @param   pDfvObj Pointer to DfvObj instance.
02402  * @return  output mode of INX.
02403  */
02404 DFVINTERFACE_API DfvINXOUTPUTMODE dfv_getInxOutputMode(CDfvObjPtr pDfvObj);
02405 
02406 /**
02407  * Set INX output mode.
02408  *
02409  * @param   pDfvObj Pointer to DfvObj instance.
02410  * @param   newVal mode of INX.
02411  */
02412 DFVINTERFACE_API void dfv_setInxOutputMode(CDfvObjPtr pDfvObj, DfvINXOUTPUTMODE newVal);
02413 
02414 /**
02415  * Get the specification that omit blank pages. return Specification that omit blank pages 
02416  */
02417 DFVINTERFACE_API int dfv_getOmitBlankPages(CDfvObjPtr pDfvObj);
02418     
02419 /**
02420  * In MS Word files, skip a blank page when it is at the beginning of the document.
02421  * Skip also if a page at the beginning of the document is only header and footer.
02422  * In MS Excel files, skip a blank page.
02423  * The original file is valid only for MS Word or MS Excel.
02424  * To skip and get only the page with the first content found, specify this property in combination with setEndPage = 1.
02425  * Operation in combination with anything other than setEndPage = 1 is not guaranteed.
02426  *
02427  * @param   pDfvObj Pointer to DfvObj instance.
02428  * @param   newVal      If the value is 'true' is specified, omit blank pages 
02429  */
02430 DFVINTERFACE_API void dfv_setOmitBlankPages(CDfvObjPtr pDfvObj, int newVal);
02431 
02432 
02433 /**
02434      * this function is not supported.
02435  */
02436 DFVINTERFACE_API long dfv_getFlashPartiallyOutput(CDfvObjPtr pDfvObj);
02437 
02438 /**
02439      * this function is not supported.
02440  */
02441 DFVINTERFACE_API void dfv_setFlashPartiallyOutput(CDfvObjPtr pDfvObj, long newVal);
02442 
02443 /**
02444      * this function is not supported.
02445  */
02446 DFVINTERFACE_API long dfv_getFlashHidePageButton(CDfvObjPtr pDfvObj);
02447 
02448 /**
02449      * this function is not supported.
02450  */
02451 DFVINTERFACE_API void dfv_setFlashHidePageButton(CDfvObjPtr pDfvObj, long newVal);
02452 
02453 /**
02454      * this function is not supported.
02455  */
02456 DFVINTERFACE_API long dfv_getFlashSplitPage(CDfvObjPtr pDfvObj);
02457 
02458 /**
02459      * this function is not supported.
02460  */
02461 DFVINTERFACE_API void dfv_setFlashSplitPage(CDfvObjPtr pDfvObj, long newVal);
02462 
02463 /**
02464      * this function is not supported.
02465  */
02466 DFVINTERFACE_API long dfv_getFlashOutputAction(CDfvObjPtr pDfvObj);
02467 
02468 /**
02469      * this function is not supported.
02470  */
02471 DFVINTERFACE_API void dfv_setFlashOutputAction(CDfvObjPtr pDfvObj, long newVal);
02472 
02473 /**
02474      * this function is not supported.
02475  */
02476 DFVINTERFACE_API int dfv_getFlashImageLimitSize(CDfvObjPtr pDfvObj);
02477 
02478 /**
02479      * this function is not supported.
02480  */
02481 DFVINTERFACE_API void dfv_setFlashImageLimitSize(CDfvObjPtr pDfvObj, int newVal);
02482 
02483 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02484 
02485 /**
02486  * It print at size of paper.
02487  * Default is false.
02488  * Effective only when outputting to printer with Windows version. 
02489  * 
02490  * @param   pDfvObj Pointer to DfvObj instance.
02491  * @param   newVal      If the value is 'true' is specified, print at size of paper. 
02492  */
02493 DFVINTERFACE_API void dfv_setPrnFitPaper(CDfvObjPtr pDfvObj, int newVal);
02494 
02495 #endif  // #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02496 
02497 
02498 /**
02499  * Get the image resolution when outputting JPEG and PNG.
02500  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02501  *
02502  * @param   pDfvObj Pointer to DfvObj instance.
02503  * @return      Image resolution 
02504  */
02505 DFVINTERFACE_API int dfv_getRasterDPI(CDfvObjPtr pDfvObj);
02506 
02507 /**
02508  * Sets the image resolution when outputting JPEG and PNG.
02509  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02510  *
02511  * @param   pDfvObj Pointer to DfvObj instance.
02512  * @param   newVal      Image resolution (1 to 1440)
02513  */
02514 DFVINTERFACE_API void dfv_setRasterDPI(CDfvObjPtr pDfvObj, int newVal);
02515 
02516 /**
02517  * Get the image scale when outputting JPEG and PNG.
02518  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02519  *
02520  * @param   pDfvObj Pointer to DfvObj instance.
02521  * @param   pVal        
02522  *          Pointer to the buffer that will receive the text. 
02523  *          If the string is as long or longer than the buffer,
02524  *          the string is truncated and terminated with a NULL character.
02525  * @param   size
02526  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02527  *          If the text exceeds this limit, it is truncated.
02528  * @return  Returns the 'pVal'.
02529  */
02530 DFVINTERFACE_API char* dfv_getRasterScale(CDfvObjPtr pDfvObj, char* pVal, int size);
02531 
02532 /**
02533  * Get the image scale when outputting JPEG and PNG.
02534  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02535  *
02536  * @param   pDfvObj Pointer to DfvObj instance.
02537  * @param   pVal        
02538  *          Pointer to the buffer that will receive the text. 
02539  *          If the string is as long or longer than the buffer,
02540  *          the string is truncated and terminated with a NULL character.
02541  * @param   size
02542  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02543  *          If the text exceeds this limit, it is truncated.
02544  * @return  Returns the 'pVal'.
02545  */
02546 DFVINTERFACE_API wchar_t* dfv_getRasterScaleW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02547 
02548 /**
02549  * Sets the image scale when outputting JPEG and PNG.
02550  * A numerical value, "%", or "px" (pixel) is available as the unit.
02551  * Specify the percentage for a numerical value and "%", and specify the width of image for pixel.
02552  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02553  *
02554  * @param   pDfvObj Pointer to DfvObj instance.
02555  * @param   newVal      Image scale 
02556  */
02557 DFVINTERFACE_API void dfv_setRasterScale(CDfvObjPtr pDfvObj, const char* newVal);
02558 
02559 /**
02560  * Sets the image scale when outputting JPEG and PNG.
02561  * A numerical value, "%", or "px" (pixel) is available as the unit.
02562  * Specify the percentage for a numerical value and "%", and specify the width of image for pixel.
02563  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02564  *
02565  * @param   pDfvObj Pointer to DfvObj instance.
02566  * @param   newVal      Image scale 
02567  */
02568 DFVINTERFACE_API void dfv_setRasterScaleW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02569 
02570 /**
02571  * Get the maximum image height when outputting JPEG and PNG.<BR>
02572  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02573  *
02574  * @param   pDfvObj Pointer to DfvObj instance.
02575  * @return          Maximum image height
02576  */
02577 DFVINTERFACE_API int dfv_getRasterHeight(CDfvObjPtr pDfvObj);
02578 
02579 /**
02580  * Sets the maximum image height decided by setRasterScale when outputting JPEG and PNG.<BR>
02581  * "px" (pixel) is available as the unit. 
02582  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02583  *
02584  * @param   pDfvObj Pointer to DfvObj instance.
02585  * @param   newVal  Maximum image height
02586  */
02587 DFVINTERFACE_API void dfv_setRasterHeight(CDfvObjPtr pDfvObj, int newVal);
02588 
02589 /**
02590  * Get the file name naming format when outputting PNG and JPEG.<BR>
02591  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02592  *
02593  * @param   pDfvObj Pointer to DfvObj instance.
02594  * @param   pVal        
02595  *          Pointer to the buffer that will receive the text. 
02596  *          If the string is as long or longer than the buffer,
02597  *          the string is truncated and terminated with a NULL character.
02598  * @param   size
02599  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02600  *          If the text exceeds this limit, it is truncated.
02601  * @return  Returns the 'pVal'.
02602  */
02603 DFVINTERFACE_API char* dfv_getRasterFormat(CDfvObjPtr pDfvObj, char* pVal, int size);
02604 
02605 /**
02606  * Get the file name naming format when outputting PNG and JPEG.<BR>
02607  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02608  *
02609  * @param   pDfvObj Pointer to DfvObj instance.
02610  * @param   pVal        
02611  *          Pointer to the buffer that will receive the text. 
02612  *          If the string is as long or longer than the buffer,
02613  *          the string is truncated and terminated with a NULL character.
02614  * @param   size
02615  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02616  *          If the text exceeds this limit, it is truncated.
02617  * @return  Returns the 'pVal'.
02618  */
02619 DFVINTERFACE_API wchar_t* dfv_getRasterFormatW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02620 
02621 /**
02622  * Specifies the file name naming format when outputting PNG and JPEG.<BR>
02623  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02624  *
02625  * @param   pDfvObj Pointer to DfvObj instance.
02626  * @param   newVal  format for naming files
02627  */
02628 DFVINTERFACE_API void dfv_setRasterFormat(CDfvObjPtr pDfvObj, const char* newVal);
02629 
02630 /**
02631  * Specifies the file name naming format when outputting PNG and JPEG.<BR>
02632  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02633  *
02634  * @param   pDfvObj Pointer to DfvObj instance.
02635  * @param   newVal  format for naming files
02636  */
02637 DFVINTERFACE_API void dfv_setRasterFormatW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02638 
02639 /**
02640  * Get the conversion accuracy when outputting JPEG.<BR>
02641  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02642  *
02643  * @param   pDfvObj Pointer to DfvObj instance.
02644  * @return          JPEG quality
02645  */
02646 DFVINTERFACE_API int dfv_getRasterJpegQuality(CDfvObjPtr pDfvObj);
02647 
02648 /**
02649  * Specifies the conversion accuracy by the value with the range of 1-100(%) when outputting JPEG.<BR>
02650  * When this parameter is omitted, it is regarded as 80%.
02651  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02652  *
02653  * @param   pDfvObj Pointer to DfvObj instance.
02654  * @param   newVal  JPEG quality
02655  */
02656 DFVINTERFACE_API void dfv_setRasterJpegQuality(CDfvObjPtr pDfvObj, int newVal);
02657 
02658 
02659 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02660 
02661 /**
02662  * Gets specification whether to use GdiPlus .<BR>
02663  * Effective only when outputting to image with Windows version
02664  *
02665  * @param   pDfvObj Pointer to DfvObj instance.
02666  * @return          Specification whether to use GdiPlus.
02667  */
02668 DFVINTERFACE_API long dfv_getRasterUseGdiPlus(CDfvObjPtr pDfvObj);
02669 
02670 /**
02671  * GdiPlus is used when the file is converted to Jpeg or PNG.<BR>
02672  * This setting is effective only with Windows Vista or later / Windows Server 2003.
02673  * Effective only when outputting to image with Windows version
02674  *
02675  * @param   pDfvObj Pointer to DfvObj instance.
02676  * @param newVal Specifies whether to use GdiPlus.
02677  */
02678 DFVINTERFACE_API void dfv_setRasterUseGdiPlus(CDfvObjPtr pDfvObj, long newVal);
02679 
02680 /**
02681  * Gets specification whether to convert to monochrome image, when outputting JPEG and PNG.<BR>
02682  * Effective only when outputting to image with Windows version
02683  *
02684  * @param   pDfvObj Pointer to DfvObj instance.
02685  * @return          Specification whether to convert to monochrome.
02686  */
02687 DFVINTERFACE_API long dfv_getRasterMonochrome(CDfvObjPtr pDfvObj);
02688 
02689 /**
02690  * Specifies whether to convert to monochrome image, when outputting JPEG and PNG.<BR>
02691  * Effective only when outputting to image with Windows version
02692  *
02693  * @param   pDfvObj Pointer to DfvObj instance.
02694  * @param newVal Specifies whether to convert to monochrome.
02695  */
02696 DFVINTERFACE_API void dfv_setRasterMonochrome(CDfvObjPtr pDfvObj, long newVal);
02697 
02698 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02699 
02700 
02701 /**
02702  * @deprecated
02703  * Get the path name of RGB ICC profile for input when outputting CMYK TIFF.
02704  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02705  *
02706  * @param   pDfvObj Pointer to DfvObj instance.
02707  * @param   pVal        
02708  *          Pointer to the buffer that will receive the text. 
02709  *          If the string is as long or longer than the buffer,
02710  *          the string is truncated and terminated with a NULL character.
02711  * @param   size
02712  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02713  *          If the text exceeds this limit, it is truncated.
02714  * @return  Returns the 'pVal'.
02715  */
02716 DFVINTERFACE_API char* dfv_getRasterRGBProfile(CDfvObjPtr pDfvObj, char* pVal, int size);
02717 
02718 /**
02719  * @deprecated
02720  * Get the path name of RGB ICC profile for input when outputting CMYK TIFF.
02721  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02722  *
02723  * @param   pDfvObj Pointer to DfvObj instance.
02724  * @param   pVal        
02725  *          Pointer to the buffer that will receive the text. 
02726  *          If the string is as long or longer than the buffer,
02727  *          the string is truncated and terminated with a NULL character.
02728  * @param   size
02729  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02730  *          If the text exceeds this limit, it is truncated.
02731  * @return  Returns the 'pVal'.
02732  */
02733 DFVINTERFACE_API wchar_t* dfv_getRasterRGBProfileW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02734 
02735 /**
02736  * @deprecated
02737  * Set the path name of RGB ICC profile for input when outputting CMYK TIFF.
02738  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02739  *
02740  * @param   pDfvObj Pointer to DfvObj instance.
02741  * @param   newVal  Pointer to a null-terminated string.
02742  */
02743 DFVINTERFACE_API void dfv_setRasterRGBProfile(CDfvObjPtr pDfvObj, const char* newVal);
02744 
02745 /**
02746  * @deprecated
02747  * Set the path name of RGB ICC profile for input when outputting CMYK TIFF.
02748  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02749  *
02750  * @param   pDfvObj Pointer to DfvObj instance.
02751  * @param   newVal  Pointer to a null-terminated string.
02752  */
02753 DFVINTERFACE_API void dfv_setRasterRGBProfileW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02754 
02755 /**
02756  * @deprecated
02757  * Get the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02758  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02759  *
02760  * @param   pDfvObj Pointer to DfvObj instance.
02761  * @param   pVal        
02762  *          Pointer to the buffer that will receive the text. 
02763  *          If the string is as long or longer than the buffer,
02764  *          the string is truncated and terminated with a NULL character.
02765  * @param   size
02766  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02767  *          If the text exceeds this limit, it is truncated.
02768  * @return  Returns the 'pVal'.
02769  */
02770 DFVINTERFACE_API char* dfv_getRasterCMYKProfile(CDfvObjPtr pDfvObj, char* pVal, int size);
02771 
02772 /**
02773  * @deprecated
02774  * Get the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02775  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02776  *
02777  * @param   pDfvObj Pointer to DfvObj instance.
02778  * @param   pVal        
02779  *          Pointer to the buffer that will receive the text. 
02780  *          If the string is as long or longer than the buffer,
02781  *          the string is truncated and terminated with a NULL character.
02782  * @param   size
02783  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02784  *          If the text exceeds this limit, it is truncated.
02785  * @return  Returns the 'pVal'.
02786  */
02787 DFVINTERFACE_API wchar_t* dfv_getRasterCMYKProfileW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02788 
02789 /**
02790  * @deprecated
02791  * Set the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02792  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02793  *
02794  * @param   pDfvObj Pointer to DfvObj instance.
02795  * @param   newVal  Pointer to a null-terminated string.
02796  */
02797 DFVINTERFACE_API void dfv_setRasterCMYKProfile(CDfvObjPtr pDfvObj, const char* newVal);
02798 
02799 /**
02800  * @deprecated
02801  * Set the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02802  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02803  *
02804  * @param   pDfvObj Pointer to DfvObj instance.
02805  * @param   newVal  Pointer to a null-terminated string.
02806  */
02807 DFVINTERFACE_API void dfv_setRasterCMYKProfileW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02808 
02809 /**
02810  * Get the setting of whether to convert images to grayscale 256 tones.
02811  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02812  *
02813  * @param   pDfvObj Pointer to DfvObj instance.
02814  * @return 
02815  * Specify whether to convert images to grayscale 256 tones.
02816  */
02817 DFVINTERFACE_API long dfv_getRasterGrayscale(CDfvObjPtr pDfvObj);
02818 
02819 /**
02820  * Outputs grayscale 256 tones..<BR>
02821  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02822  *
02823  * @param   pDfvObj Pointer to DfvObj instance.
02824  * @param newVal
02825  * If "true" is specified, convert images to grayscale 256 tones.
02826  */
02827 DFVINTERFACE_API void dfv_setRasterGrayscale(CDfvObjPtr pDfvObj, long newVal);
02828 
02829 
02830 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02831 
02832 /**
02833  * Get the setting of whether to convert images to 256 colors.
02834  * Effective only when outputting to image with Windows version
02835  *
02836  * @param   pDfvObj Pointer to DfvObj instance.
02837  * @return
02838  * Specify whether to convert images to 256 colors.
02839  */
02840 DFVINTERFACE_API long dfv_getRaster256Color(CDfvObjPtr pDfvObj);
02841 
02842 /**
02843  * Outputs 256 colors..<BR>
02844  * Effective only when outputting to image with Windows version
02845  *
02846  * @param   pDfvObj Pointer to DfvObj instance.
02847  * @param newVal
02848  * If "true" is specified, convert images to 256 colors.
02849  */
02850 DFVINTERFACE_API void dfv_setRaster256Color(CDfvObjPtr pDfvObj, long newVal);
02851 
02852 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02853 
02854 
02855 /**
02856  * @deprecated
02857  * Get the compression method when outputting TIFF / MTIFF.
02858  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02859  *
02860  * @param   pDfvObj Pointer to DfvObj instance.
02861  * @param   pVal        
02862  *          Pointer to the buffer that will receive the text. 
02863  *          If the string is as long or longer than the buffer,
02864  *          the string is truncated and terminated with a NULL character.
02865  * @param   size
02866  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02867  *          If the text exceeds this limit, it is truncated.
02868  * @return  Returns the 'pVal'.
02869  */
02870 DFVINTERFACE_API char* dfv_getRasterCompression(CDfvObjPtr pDfvObj, char* pVal, int size);
02871 
02872 /**
02873  * @deprecated
02874  * Get the compression method when outputting TIFF / MTIFF.
02875  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02876  *
02877  * @param   pDfvObj Pointer to DfvObj instance.
02878  * @param   pVal        
02879  *          Pointer to the buffer that will receive the text. 
02880  *          If the string is as long or longer than the buffer,
02881  *          the string is truncated and terminated with a NULL character.
02882  * @param   size
02883  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02884  *          If the text exceeds this limit, it is truncated.
02885  * @return  Returns the 'pVal'.
02886  */
02887 DFVINTERFACE_API wchar_t* dfv_getRasterCompressionW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02888 
02889 /**
02890  * @deprecated
02891  * Specifies the compression method when outputting TIFF / MTIFF.<BR>
02892  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02893  * The compression method.<BR>
02894  * none : None<BR>
02895  * lzw : ZLIB compression(When this parameter is omitted, lzw is applied.)<BR>
02896  * dct : DCTDecode<BR>
02897  * flate : FlateDecode<BR>
02898  * runlength : Run Length compression<BR>
02899  * ccitt3 : CCITT Group3<BR>
02900  * ccitt4 : CCITT Group4<BR>
02901  *
02902  * @param   pDfvObj Pointer to DfvObj instance.
02903  * @param   newVal  Pointer to a null-terminated string.
02904  */
02905 DFVINTERFACE_API void dfv_setRasterCompression(CDfvObjPtr pDfvObj, const char* newVal);
02906 
02907 /**
02908  * @deprecated
02909  * Specifies the compression method when outputting TIFF / MTIFF.<BR>
02910  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02911  * The compression method.<BR>
02912  * none : None<BR>
02913  * lzw : ZLIB compression(When this parameter is omitted, lzw is applied.)<BR>
02914  * dct : DCTDecode<BR>
02915  * flate : FlateDecode<BR>
02916  * runlength : Run Length compression<BR>
02917  * ccitt3 : CCITT Group3<BR>
02918  * ccitt4 : CCITT Group4<BR>
02919  *
02920  * @param   pDfvObj Pointer to DfvObj instance.
02921  * @param   newVal  Pointer to a null-terminated string.
02922  */
02923 DFVINTERFACE_API void dfv_setRasterCompressionW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02924 
02925 
02926 /**
02927  * Specifies the height of the paper when inputting text.
02928  * Effective when inputting text. 
02929  *
02930  * @param   pDfvObj Pointer to DfvObj instance.
02931  * @param   newVal      the height of paper 
02932  */
02933 DFVINTERFACE_API void dfv_setTextPaperHeight(CDfvObjPtr pDfvObj, const char* newVal);
02934 
02935 /**
02936  * Specifies the height of the paper when inputting text.
02937  * Effective when inputting text. 
02938  *
02939  * @param   pDfvObj Pointer to DfvObj instance.
02940  * @param   newVal      the height of paper 
02941  */
02942 DFVINTERFACE_API void dfv_setTextPaperHeightW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02943 
02944 /**
02945  * Specifies the width of the paper when inputting text.
02946  * Effective when inputting text. 
02947  *
02948  * @param   pDfvObj Pointer to DfvObj instance.
02949  * @param   newVal      the width of paper 
02950  */
02951 DFVINTERFACE_API void dfv_setTextPaperWidth(CDfvObjPtr pDfvObj, const char* newVal);
02952 
02953 /**
02954  * Specifies the width of the paper when inputting text.
02955  * Effective when inputting text. 
02956  *
02957  * @param   pDfvObj Pointer to DfvObj instance.
02958  * @param   newVal      the width of paper 
02959  */
02960 DFVINTERFACE_API void dfv_setTextPaperWidthW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02961 
02962 /**
02963  * Specifies the left margin of the paper when inputting text.
02964  * Effective when inputting text. 
02965  *
02966  * @param   pDfvObj Pointer to DfvObj instance.
02967  * @param   newVal       the left margin of the paper 
02968  */
02969 DFVINTERFACE_API void dfv_setTextMarginLeft(CDfvObjPtr pDfvObj, const char* newVal);
02970 
02971 /**
02972  * Specifies the left margin of the paper when inputting text.
02973  * Effective when inputting text. 
02974  *
02975  * @param   pDfvObj Pointer to DfvObj instance.
02976  * @param   newVal       the left margin of the paper 
02977  */
02978 DFVINTERFACE_API void dfv_setTextMarginLeftW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02979 
02980 /**
02981  * Specifies the right margin of the paper when inputting text.
02982  * Effective when inputting text. 
02983  *
02984  * @param   pDfvObj Pointer to DfvObj instance.
02985  * @param   newVal      the top margin of the paper 
02986  */
02987 DFVINTERFACE_API void dfv_setTextMarginTop(CDfvObjPtr pDfvObj, const char* newVal);
02988 
02989 /**
02990  * Specifies the right margin of the paper when inputting text.
02991  * Effective when inputting text. 
02992  *
02993  * @param   pDfvObj Pointer to DfvObj instance.
02994  * @param   newVal      the top margin of the paper 
02995  */
02996 DFVINTERFACE_API void dfv_setTextMarginTopW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02997 
02998 /**
02999  * Specifies the right margin of the paper when inputting text.
03000  * Effective when inputting text. 
03001  *
03002  * @param   pDfvObj Pointer to DfvObj instance.
03003  * @param   newVal      the right margin of the paper 
03004  */
03005 DFVINTERFACE_API void dfv_setTextMarginRight(CDfvObjPtr pDfvObj, const char* newVal);
03006 
03007 /**
03008  * Specifies the right margin of the paper when inputting text.
03009  * Effective when inputting text. 
03010  *
03011  * @param   pDfvObj Pointer to DfvObj instance.
03012  * @param   newVal      the right margin of the paper 
03013  */
03014 DFVINTERFACE_API void dfv_setTextMarginRightW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03015 
03016 /**
03017  * Specifies the right margin of the paper when inputting text.
03018  * Effective when inputting text. 
03019  *
03020  * @param   pDfvObj Pointer to DfvObj instance.
03021  * @param   newVal      the bottom margin of the paper 
03022  */
03023 DFVINTERFACE_API void dfv_setTextMarginBottom(CDfvObjPtr pDfvObj, const char* newVal);
03024 
03025 /**
03026  * Specifies the right margin of the paper when inputting text.
03027  * Effective when inputting text. 
03028  *
03029  * @param   pDfvObj Pointer to DfvObj instance.
03030  * @param   newVal      the bottom margin of the paper 
03031  */
03032 DFVINTERFACE_API void dfv_setTextMarginBottomW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03033 
03034 /**
03035  * Specifies the font family name when inputting text.
03036  * Effective when inputting text. 
03037  *
03038  * @param   pDfvObj Pointer to DfvObj instance.
03039  * @param   newVal      font family name 
03040  */
03041 DFVINTERFACE_API void dfv_setTextFontFamily(CDfvObjPtr pDfvObj, const char* newVal);
03042 
03043 /**
03044  * Specifies the font family name when inputting text.
03045  * Effective when inputting text. 
03046  *
03047  * @param   pDfvObj Pointer to DfvObj instance.
03048  * @param   newVal      font family name 
03049  */
03050 DFVINTERFACE_API void dfv_setTextFontFamilyW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03051 
03052 /**
03053  * Specifies the font size when inputting text.
03054  * Effective when inputting text. 
03055  *
03056  * @param   pDfvObj Pointer to DfvObj instance.
03057  * @param   newVal      font size 
03058  */
03059 DFVINTERFACE_API void dfv_setTextFontSize(CDfvObjPtr pDfvObj, const char* newVal);
03060 
03061 /**
03062  * Specifies the font size when inputting text.
03063  * Effective when inputting text. 
03064  *
03065  * @param   pDfvObj Pointer to DfvObj instance.
03066  * @param   newVal      font size 
03067  */
03068 DFVINTERFACE_API void dfv_setTextFontSizeW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03069 
03070 /**
03071  * Specifies the value of whether show page number or not when inputting text.
03072  * Effective when inputting text. 
03073  * 
03074  * @param   pDfvObj Pointer to DfvObj instance.
03075  * @param   newVal      the value of whether show page number or not 
03076  */
03077 DFVINTERFACE_API void dfv_setTextShowPageNumber(CDfvObjPtr pDfvObj, int newVal);
03078 
03079 /**
03080  * Specifies the value of whether show page number or not when inputting text.
03081  * Effective when inputting text. 
03082  * 
03083  * @param   pDfvObj Pointer to DfvObj instance.
03084  * @param   newVal      the value of whether show page number or not    
03085  */
03086 DFVINTERFACE_API void dfv_setTextShowLineNumber(CDfvObjPtr pDfvObj, int newVal);
03087 
03088 /**
03089  * Specifies the offset value of range from body area when showing line number and inputting text.
03090  * Effective when inputting text. 
03091  * 
03092  * @param   pDfvObj Pointer to DfvObj instance.
03093  * @param   newVal      the offset value
03094  */
03095 DFVINTERFACE_API void dfv_setTextLineNumberOffset(CDfvObjPtr pDfvObj, const char* newVal);
03096 
03097 /**
03098  * Specifies the offset value of range from body area when showing line number and inputting text.
03099  * Effective when inputting text. 
03100  * 
03101  * @param   pDfvObj Pointer to DfvObj instance.
03102  * @param   newVal      the offset value
03103  */
03104 DFVINTERFACE_API void dfv_setTextLineNumberOffsetW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03105 
03106 /**
03107  * Specifies the line number format when showing line number and inputting text.
03108  * Effective when inputting text. 
03109  * 
03110  * @param   pDfvObj Pointer to DfvObj instance.
03111  * @param   newVal      line number format  
03112  */
03113 DFVINTERFACE_API void dfv_setTextLineNumberFormat(CDfvObjPtr pDfvObj, const char* newVal);
03114 
03115 /**
03116  * Specifies the line number format when showing line number and inputting text.
03117  * Effective when inputting text. 
03118  * 
03119  * @param   pDfvObj Pointer to DfvObj instance.
03120  * @param   newVal      line number format  
03121  */
03122 DFVINTERFACE_API void dfv_setTextLineNumberFormatW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03123 
03124 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
03125 /**
03126  * Acquires the setting of the smoothing processing to text.<BR>
03127  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03128  *
03129  * @param   pDfvObj Pointer to DfvObj instance.
03130  * @return          
03131  * Specify whether to perform the smoothing processing to text.
03132  */
03133 DFVINTERFACE_API int dfv_getGdiTextAntialias(CDfvObjPtr pDfvObj);
03134 
03135 /**
03136  * Performs the smoothing processing to text.<BR>
03137  * Effective only when printing and outputting images.<BR>
03138  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03139  *
03140  * @param   pDfvObj Pointer to DfvObj instance.
03141  * @param   newVal  
03142  * Performs the smoothing processing when true is specified.
03143  */
03144 DFVINTERFACE_API void dfv_setGdiTextAntialias(CDfvObjPtr pDfvObj, int newVal);
03145 
03146 /**
03147  * Acquires the setting of the smoothing processing to borders.<BR>
03148  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03149  *
03150  * @param   pDfvObj Pointer to DfvObj instance.
03151  * @return          
03152  * Specify whether to perform the smoothing processing to borders.
03153  */
03154 DFVINTERFACE_API int dfv_getGdiLineartSmoothing(CDfvObjPtr pDfvObj);
03155 
03156 /**
03157  * Performs the smoothing processing to borders.<BR>
03158  * Effective only when printing and outputting images.<BR>
03159  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03160  *
03161  * @param   pDfvObj Pointer to DfvObj instance.
03162  * @param   newVal  
03163  * Performs the smoothing processing when true is specified.
03164  */
03165 DFVINTERFACE_API void dfv_setGdiLineartSmoothing(CDfvObjPtr pDfvObj, int newVal);
03166 
03167 /**
03168  * Acquires the setting of the smoothing processing to images.<BR>
03169  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03170  *
03171  * @param   pDfvObj Pointer to DfvObj instance.
03172  * @return          
03173  * Specify whether to perform the smoothing processing to images.
03174  */
03175 DFVINTERFACE_API int dfv_getGdiImageSmoothing(CDfvObjPtr pDfvObj);
03176 
03177 /**
03178  * Performs the smoothing processing to images.<BR>
03179  * Effective only when printing and outputting images.<BR>
03180  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03181  *
03182  * @param   pDfvObj Pointer to DfvObj instance.
03183  * @param   newVal  
03184  * Performs the smoothing processing when true is specified.
03185  */
03186 DFVINTERFACE_API void dfv_setGdiImageSmoothing(CDfvObjPtr pDfvObj, int newVal);
03187 
03188 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
03189 
03190 /**
03191  * @deprecated
03192  * Get the watermark text on each page.
03193  *
03194  * @param   pDfvObj Pointer to DfvObj instance.
03195  * @param   pVal        
03196  *          Pointer to the buffer that will receive the text. 
03197  *          If the string is as long or longer than the buffer,
03198  *          the string is truncated and terminated with a NULL character.
03199  * @param   size
03200  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03201  *          If the text exceeds this limit, it is truncated.
03202  * @return  Returns the 'pVal'.
03203  */
03204 DFVINTERFACE_API char* dfv_getWatermarkText(CDfvObjPtr pDfvObj, char* pVal, int size);
03205 
03206 /**
03207  * @deprecated
03208  * Get the watermark text on each page. 
03209  *
03210  * @param   pDfvObj Pointer to DfvObj instance.
03211  * @param   pVal        
03212  *          Pointer to the buffer that will receive the text. 
03213  *          If the string is as long or longer than the buffer,
03214  *          the string is truncated and terminated with a NULL character.
03215  * @param   size
03216  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03217  *          If the text exceeds this limit, it is truncated.
03218  * @return  Returns the 'pVal'.
03219  */
03220 DFVINTERFACE_API wchar_t* dfv_getWatermarkTextW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03221 
03222 /**
03223  * @deprecated
03224  * Displays the specified watermark text on each page. 
03225  * Possible to make it multiple lines by delimiting with the line feed \n. 
03226  * This setting is invalid with the evaluation version.  
03227  *
03228  * @param   pDfvObj Pointer to DfvObj instance.
03229  * @param   newVal  Pointer to a null-terminated string.
03230  */
03231 DFVINTERFACE_API void dfv_setWatermarkText(CDfvObjPtr pDfvObj, const char* newVal);
03232 
03233 /**
03234  * @deprecated
03235  * Displays the specified watermark text on each page. 
03236  * Possible to make it multiple lines by delimiting with the line feed \n. 
03237  * This setting is invalid with the evaluation version.  
03238  *
03239  * @param   pDfvObj Pointer to DfvObj instance.
03240  * @param   newVal  Pointer to a null-terminated string.
03241  */
03242 DFVINTERFACE_API void dfv_setWatermarkTextW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03243 
03244 /**
03245  * @deprecated
03246  * Get the font family of the watermark text.
03247  *
03248  * @param   pDfvObj Pointer to DfvObj instance.
03249  * @param   pVal        
03250  *          Pointer to the buffer that will receive the text. 
03251  *          If the string is as long or longer than the buffer,
03252  *          the string is truncated and terminated with a NULL character.
03253  * @param   size
03254  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03255  *          If the text exceeds this limit, it is truncated.
03256  * @return  Returns the 'pVal'.
03257  */
03258 DFVINTERFACE_API char* dfv_getWatermarkFontFamily(CDfvObjPtr pDfvObj, char* pVal, int size);
03259 
03260 /**
03261  * @deprecated
03262  * Get the font family of the watermark text.
03263  *
03264  * @param   pDfvObj Pointer to DfvObj instance.
03265  * @param   pVal        
03266  *          Pointer to the buffer that will receive the text. 
03267  *          If the string is as long or longer than the buffer,
03268  *          the string is truncated and terminated with a NULL character.
03269  * @param   size
03270  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03271  *          If the text exceeds this limit, it is truncated.
03272  * @return  Returns the 'pVal'.
03273  */
03274 DFVINTERFACE_API wchar_t* dfv_getWatermarkFontFamilyW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03275 
03276 /**
03277  * @deprecated
03278  * Specifies the font family to the character string which you set to watermark-text.  
03279  *
03280  * @param   pDfvObj Pointer to DfvObj instance.
03281  * @param   newVal  Pointer to a null-terminated string.
03282  */
03283 DFVINTERFACE_API void dfv_setWatermarkFontFamily(CDfvObjPtr pDfvObj, const char* newVal);
03284 
03285 /**
03286  * @deprecated
03287  * Specifies the font family to the character string which you set to watermark-text.  
03288  *
03289  * @param   pDfvObj Pointer to DfvObj instance.
03290  * @param   newVal  Pointer to a null-terminated string.
03291  */
03292 DFVINTERFACE_API void dfv_setWatermarkFontFamilyW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03293 
03294 /**
03295  * @deprecated
03296  * Get the font weight of the watermark text.
03297  *
03298  * @param   pDfvObj Pointer to DfvObj instance.
03299  * @param   pVal        
03300  *          Pointer to the buffer that will receive the text. 
03301  *          If the string is as long or longer than the buffer,
03302  *          the string is truncated and terminated with a NULL character.
03303  * @param   size
03304  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03305  *          If the text exceeds this limit, it is truncated.
03306  * @return  Returns the 'pVal'.
03307  */
03308 DFVINTERFACE_API char* dfv_getWatermarkFontWeight(CDfvObjPtr pDfvObj, char* pVal, int size);
03309 
03310 /**
03311  * @deprecated
03312  * Get the font weight of the watermark text. 
03313  *
03314  * @param   pDfvObj Pointer to DfvObj instance.
03315  * @param   pVal        
03316  *          Pointer to the buffer that will receive the text. 
03317  *          If the string is as long or longer than the buffer,
03318  *          the string is truncated and terminated with a NULL character.
03319  * @param   size
03320  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03321  *          If the text exceeds this limit, it is truncated.
03322  * @return  Returns the 'pVal'.
03323  */
03324 DFVINTERFACE_API wchar_t* dfv_getWatermarkFontWeightW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03325 
03326 /**
03327  * @deprecated
03328  * Specifies the font weight to the character string which you set to watermark-text. 
03329  * Possible to specify normal, bold or the numerical value from 100 to 900.  
03330  *
03331  * @param   pDfvObj Pointer to DfvObj instance.
03332  * @param   newVal  Pointer to a null-terminated string.
03333  */
03334 DFVINTERFACE_API void dfv_setWatermarkFontWeight(CDfvObjPtr pDfvObj, const char* newVal);
03335 
03336 /**
03337  * @deprecated
03338  * Specifies the font weight to the character string which you set to watermark-text. 
03339  * Possible to specify normal, bold or the numerical value from 100 to 900.  
03340  *
03341  * @param   pDfvObj Pointer to DfvObj instance.
03342  * @param   newVal  Pointer to a null-terminated string.
03343  */
03344 DFVINTERFACE_API void dfv_setWatermarkFontWeightW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03345 
03346 /**
03347  * @deprecated
03348  * Get the font style of the watermark text.
03349  *
03350  * @param   pDfvObj Pointer to DfvObj instance.
03351  * @param   pVal        
03352  *          Pointer to the buffer that will receive the text. 
03353  *          If the string is as long or longer than the buffer,
03354  *          the string is truncated and terminated with a NULL character.
03355  * @param   size
03356  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03357  *          If the text exceeds this limit, it is truncated.
03358  * @return  Returns the 'pVal'.
03359  */
03360 DFVINTERFACE_API char* dfv_getWatermarkFontStyle(CDfvObjPtr pDfvObj, char* pVal, int size);
03361 
03362 /**
03363  * @deprecated
03364  * Get the font style of the watermark text. 
03365  *
03366  * @param   pDfvObj Pointer to DfvObj instance.
03367  * @param   pVal        
03368  *          Pointer to the buffer that will receive the text. 
03369  *          If the string is as long or longer than the buffer,
03370  *          the string is truncated and terminated with a NULL character.
03371  * @param   size
03372  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03373  *          If the text exceeds this limit, it is truncated.
03374  * @return  Returns the 'pVal'.
03375  */
03376 DFVINTERFACE_API wchar_t* dfv_getWatermarkFontStyleW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03377 
03378 /**
03379  * @deprecated
03380  * Specifies the font style to the character string which you set to watermark-text.  
03381  *
03382  * @param   pDfvObj Pointer to DfvObj instance.
03383  * @param   newVal  Pointer to a null-terminated string.
03384  */
03385 DFVINTERFACE_API void dfv_setWatermarkFontStyle(CDfvObjPtr pDfvObj, const char* newVal);
03386 
03387 /**
03388  * @deprecated
03389  * Specifies the font style to the character string which you set to watermark-text.  
03390  *
03391  * @param   pDfvObj Pointer to DfvObj instance.
03392  * @param   newVal  Pointer to a null-terminated string.
03393  */
03394 DFVINTERFACE_API void dfv_setWatermarkFontStyleW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03395 
03396 /**
03397  * @deprecated
03398  * Get the opacity of the watermark text. 
03399  *
03400  * @param   pDfvObj Pointer to DfvObj instance.
03401  * @param   pVal        
03402  *          Pointer to the buffer that will receive the text. 
03403  *          If the string is as long or longer than the buffer,
03404  *          the string is truncated and terminated with a NULL character.
03405  * @param   size
03406  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03407  *          If the text exceeds this limit, it is truncated.
03408  * @return  Returns the 'pVal'.
03409  */
03410 DFVINTERFACE_API char* dfv_getWatermarkOpacity(CDfvObjPtr pDfvObj, char* pVal, int size);
03411 
03412 /**
03413  * @deprecated
03414  * Get the opacity of the watermark text. 
03415  *
03416  * @param   pDfvObj Pointer to DfvObj instance.
03417  * @param   pVal        
03418  *          Pointer to the buffer that will receive the text. 
03419  *          If the string is as long or longer than the buffer,
03420  *          the string is truncated and terminated with a NULL character.
03421  * @param   size
03422  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03423  *          If the text exceeds this limit, it is truncated.
03424  * @return  Returns the 'pVal'.
03425  */
03426 DFVINTERFACE_API wchar_t* dfv_getWatermarkOpacityW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03427 
03428 /**
03429  * @deprecated
03430  * Specifies the opacity to the character string which you set to watermark-text.  
03431  *
03432  * @param   pDfvObj Pointer to DfvObj instance.
03433  * @param   newVal  Pointer to a null-terminated string.
03434  */
03435 DFVINTERFACE_API void dfv_setWatermarkOpacity(CDfvObjPtr pDfvObj, const char* newVal);
03436 
03437 /**
03438  * @deprecated
03439  * Specifies the opacity to the character string which you set to watermark-text.  
03440  *
03441  * @param   pDfvObj Pointer to DfvObj instance.
03442  * @param   newVal  Pointer to a null-terminated string.
03443  */
03444 DFVINTERFACE_API void dfv_setWatermarkOpacityW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03445 
03446 /**
03447  * Gets the setting of continuous page numbers across worksheets in Excel header footer/number of pages as a total of all worksheets.
03448  * @param   pDfvObj Pointer to DfvObj instance.
03449  * @return          
03450  * If true, inserts continuous page numbers across all worksheets/number of pages as a total of all worksheets.
03451  */
03452 DFVINTERFACE_API int dfv_getContinuePageNumber(CDfvObjPtr pDfvObj);
03453 
03454 /**
03455  * Sets continuous page numbers across worksheets in Excel header footer/number of pages as a total of all worksheets.
03456  *
03457  * @param   pDfvObj Pointer to DfvObj instance.
03458  * @param   newVal  
03459  * If true, sets continuous page numbers across all worksheets/number of pages as a total of all worksheets.
03460  */
03461 DFVINTERFACE_API void dfv_setContinuePageNumber(CDfvObjPtr pDfvObj, int newVal);
03462 
03463 /**
03464  * Get the ICC profile file name.
03465  *
03466  * @param   pDfvObj Pointer to DfvObj instance.
03467  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03468  *            the string is truncated and terminated with a NULL character.
03469  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03470  * @return  Returns the 'pVal'.
03471  */
03472 
03473 DFVINTERFACE_API char* dfv_getPdfColorProfile(CDfvObjPtr pDfvObj, char* pVal, int size);
03474 /**
03475  * Get the ICC profile file name.
03476  *
03477  * @param   pDfvObj Pointer to DfvObj instance.
03478  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03479  *            the string is truncated and terminated with a NULL character.
03480  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03481  * @return  Returns the 'pVal'.
03482  */
03483 DFVINTERFACE_API wchar_t* dfv_getPdfColorProfileW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03484 
03485 /**
03486  * Set the ICC profile file name.
03487  * When PDF/A-1b:2005 or PDF/A-2b:2011 is specified for PdfVersion, the ICC profile must be specified. In that case, specify the full path of the ICC profile to this parameter. This parameter is invalid except for PDF/A-1b:2005 and PDF/A-2b:2011.
03488  *
03489  * @param   pDfvObj Pointer to DfvObj instance.
03490  * @param   newVal  Pointer to a null-terminated string to be used as the ICC profile file name.
03491  */
03492 DFVINTERFACE_API void dfv_setPdfColorProfile(CDfvObjPtr pDfvObj, const char* newVal);
03493 
03494 /**
03495  * Set the ICC profile file name.
03496      * When PDF/A-1b:2005 or PDF/A-2b:2011 is specified for PdfVersion, the ICC profile must be specified. In that case, specify the full path of the ICC profile to this parameter. This parameter is invalid except for PDF/A-1b:2005 and PDF/A-2b:2011.
03497  *
03498  * @param   pDfvObj Pointer to DfvObj instance.
03499  * @param   newVal  Pointer to a null-terminated string to be used as the ICC profile file name.
03500  */
03501 DFVINTERFACE_API void dfv_setPdfColorProfileW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03502 
03503 /**
03504  * Specifies the open password for document.
03505  *
03506  * @param   pDfvObj Pointer to DfvObj instance.
03507  * @param   newVal  Pointer to a null-terminated string.
03508  */
03509 DFVINTERFACE_API void dfv_setOpenPassword(CDfvObjPtr pDfvObj, const char* newVal);
03510 
03511 /**
03512  * Specifies the open password for document.
03513  *
03514  * @param   pDfvObj Pointer to DfvObj instance.
03515  * @param   newVal  Pointer to a null-terminated string.
03516  */
03517 DFVINTERFACE_API void dfv_setOpenPasswordW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03518 
03519 /**
03520  * Get the setting of Support for correct number of pages in Word.
03521  *
03522  * @param   pDfvObj Pointer to DfvObj instance.
03523  * @return          
03524  * If true, support for correct number of pages and dynamically updating table of contents in Word.
03525  */
03526 DFVINTERFACE_API long dfv_getPageNumberCorrection(CDfvObjPtr pDfvObj);
03527 
03528 /**
03529  * Set the setting of Support for correct number of pages in Word.
03530  *
03531  * @param   pDfvObj Pointer to DfvObj instance.
03532  * @param   newVal  
03533  * If true, sets support for correct number of pages and dynamically updating table of contents in Word.
03534  */
03535 DFVINTERFACE_API void dfv_setPageNumberCorrection(CDfvObjPtr pDfvObj, long newVal);
03536 
03537 /**
03538  * Get the specification that output to the first sheet that was active. return Specification that output to the first sheet that was active 
03539  */
03540 DFVINTERFACE_API int dfv_getSheetOrderActiveFirst(CDfvObjPtr pDfvObj);
03541     
03542 /**
03543  * Output to the first sheet that was active when you save in MS Excel.
03544  *
03545  * @param   pDfvObj Pointer to DfvObj instance.
03546  * @param   newVal      If the value is 'true' is specified, first sheet that was active
03547  */
03548 DFVINTERFACE_API void dfv_setSheetOrderActiveFirst(CDfvObjPtr pDfvObj, int newVal);
03549 
03550 /**
03551  * Get the sheet order and select.
03552  *
03553  * @param   pDfvObj Pointer to DfvObj instance.
03554  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03555  *            the string is truncated and terminated with a NULL character.
03556  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03557  * @return  Returns the 'pVal'.
03558  */
03559 
03560 DFVINTERFACE_API char* dfv_getSheetOrderSelect(CDfvObjPtr pDfvObj, char* pVal, int size);
03561 /**
03562  * Get the sheet order and select.
03563  *
03564  * @param   pDfvObj Pointer to DfvObj instance.
03565  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03566  *            the string is truncated and terminated with a NULL character.
03567  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03568  * @return  Returns the 'pVal'.
03569  */
03570 DFVINTERFACE_API wchar_t* dfv_getSheetOrderSelectW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03571 
03572 /**
03573  * Set the sheet order and select.
03574  *
03575  * @param   pDfvObj Pointer to DfvObj instance.
03576  * @param   newVal  Pointer to a null-terminated string to be used as the sheet order and select.
03577  */
03578 DFVINTERFACE_API void dfv_setSheetOrderSelect(CDfvObjPtr pDfvObj, const char* newVal);
03579 
03580 /**
03581  * Set the sheet order and select.
03582  *
03583  * @param   pDfvObj Pointer to DfvObj instance.
03584  * @param   newVal  Pointer to a null-terminated string to be used as the sheet order and select.
03585  */
03586 DFVINTERFACE_API void dfv_setSheetOrderSelectW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03587 
03588 /**
03589  * Get the locale.
03590  *
03591  * @param   pDfvObj Pointer to DfvObj instance.
03592  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03593  *            the string is truncated and terminated with a NULL character.
03594  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03595  * @return  Returns the 'pVal'.
03596  */
03597 
03598 DFVINTERFACE_API char* dfv_getLocale(CDfvObjPtr pDfvObj, char* pVal, int size);
03599 /**
03600  * Get the locale.
03601  *
03602  * @param   pDfvObj Pointer to DfvObj instance.
03603  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03604  *            the string is truncated and terminated with a NULL character.
03605  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03606  * @return  Returns the 'pVal'.
03607  */
03608 DFVINTERFACE_API wchar_t* dfv_getLocaleW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03609 
03610 /**
03611  * Set the locale.
03612  *
03613  * @param   pDfvObj Pointer to DfvObj instance.
03614  * @param   newVal  Pointer to a null-terminated string to be used as the locale.
03615  */
03616 DFVINTERFACE_API void dfv_setLocale(CDfvObjPtr pDfvObj, const char* newVal);
03617 
03618 /**
03619  * Set the locale.
03620  *
03621  * @param   pDfvObj Pointer to DfvObj instance.
03622  * @param   newVal  Pointer to a null-terminated string to be used as the locale.
03623  */
03624 DFVINTERFACE_API void dfv_setLocaleW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03625 
03626 /**
03627  * Get the RowColControl configuration file name.
03628  *
03629  * @param   pDfvObj Pointer to DfvObj instance.
03630  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03631  *          the string is truncated and terminated with a NULL character.
03632  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03633  * @return  Returns the 'pVal'.
03634  */
03635 DFVINTERFACE_API char* dfv_getRowColControlFileName(CDfvObjPtr pDfvObj, char* pVal, int size);
03636 
03637 /**
03638  * Get the RowColControl configuration file name.
03639  *
03640  * @param   pDfvObj Pointer to DfvObj instance.
03641  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03642  *          the string is truncated and terminated with a NULL character.
03643  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03644  * @return  Returns the 'pVal'.
03645  */
03646 DFVINTERFACE_API wchar_t* dfv_getRowColControlFileNameW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03647 
03648 /**
03649  * Set the RowColControl configuration file name.
03650  *
03651  * @param   pDfvObj Pointer to DfvObj instance.
03652  * @param   newVal  Pointer to a null-terminated string to be used as the file name.
03653  */
03654 DFVINTERFACE_API void dfv_setRowColControlFileName(CDfvObjPtr pDfvObj, const char* newVal);
03655 
03656 /**
03657  * Set the RowColControl configuration file name.
03658  *
03659  * @param   pDfvObj Pointer to DfvObj instance.
03660  * @param   newVal  Pointer to a null-terminated string to be used as the file name.
03661  */
03662 DFVINTERFACE_API void dfv_setRowColControlFileNameW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03663 
03664 /**
03665  * Get the RowColControl parameter row,col string.
03666  *
03667  * @param   pDfvObj Pointer to DfvObj instance.
03668  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03669  *          the string is truncated and terminated with a NULL character.
03670  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03671  * @return  Returns the 'pVal'.
03672  */
03673 DFVINTERFACE_API char* dfv_getRowColControlParameter(CDfvObjPtr pDfvObj, char* pVal, int size);
03674 
03675 /**
03676  * Get the RowColControl parameter row,col string.
03677  *
03678  * @param   pDfvObj Pointer to DfvObj instance.
03679  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03680  *          the string is truncated and terminated with a NULL character.
03681  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03682  * @return  Returns the 'pVal'.
03683  */
03684 DFVINTERFACE_API wchar_t* dfv_getRowColControlParameterW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03685 
03686 /**
03687  * Set the RowColControl parameter row,col.
03688  *
03689  * @param   pDfvObj Pointer to DfvObj instance.
03690  * @param   newVal  Pointer to a null-terminated string to be used as the parameter row,col string.
03691  */
03692 DFVINTERFACE_API void dfv_setRowColControlParameter(CDfvObjPtr pDfvObj, const char* newVal);
03693 
03694 /**
03695  * Set the RowColControl parameter row,col.
03696  *
03697  * @param   pDfvObj Pointer to DfvObj instance.
03698  * @param   newVal  Pointer to a null-terminated string to be used as the parameter row,col string.
03699  */
03700 DFVINTERFACE_API void dfv_setRowColControlParameterW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03701 
03702 /**
03703  * Gets the view information option.
03704  *   default font name/size in file & printer name in sheet and matched parameter.
03705  *
03706  * @param   pDfvObj Pointer to DfvObj instance.
03707  * @return Return to this option.
03708  */
03709 DFVINTERFACE_API int dfv_getXlsInfoView(CDfvObjPtr pDfvObj);
03710 
03711 /**
03712  * Set the view information option.
03713  *   default font name/size in file & printer name in sheet and matched parameter.
03714  *
03715  * @param   pDfvObj Pointer to DfvObj instance.
03716  * @param   newVal      If the value is 'true' is specified, Set to the view information option.
03717  */
03718 DFVINTERFACE_API void dfv_setXlsInfoView(CDfvObjPtr pDfvObj, int newVal);
03719 
03720 /**
03721  * Get the XlsPaperDefault parameter string.
03722  *
03723  * @param   pDfvObj Pointer to DfvObj instance.
03724  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03725  *          the string is truncated and terminated with a NULL character.
03726  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03727  * @return  Returns the 'pVal'.
03728  */
03729 DFVINTERFACE_API char* dfv_getXlsPaperDefault(CDfvObjPtr pDfvObj, char* pVal, int size);
03730 
03731 /**
03732  * Get the XlsPaperDefault parameter string.
03733  *
03734  * @param   pDfvObj Pointer to DfvObj instance.
03735  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03736  *          the string is truncated and terminated with a NULL character.
03737  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03738  * @return  Returns the 'pVal'.
03739  */
03740 DFVINTERFACE_API wchar_t* dfv_getXlsPaperDefaultW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03741 
03742 /**
03743  * Set the XlsPaperDefault parameter string.
03744  *
03745  * @param   pDfvObj Pointer to DfvObj instance.
03746  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03747  */
03748 DFVINTERFACE_API void dfv_setXlsPaperDefault(CDfvObjPtr pDfvObj, const char* newVal);
03749 
03750 /**
03751  * Set the XlsPaperDefault parameter string.
03752  *
03753  * @param   pDfvObj Pointer to DfvObj instance.
03754  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03755  */
03756 DFVINTERFACE_API void dfv_setXlsPaperDefaultW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03757 
03758 /**
03759  * Get the XlsPaper parameter string.
03760  *
03761  * @param   pDfvObj Pointer to DfvObj instance.
03762  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03763  *          the string is truncated and terminated with a NULL character.
03764  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03765  * @return  Returns the 'pVal'.
03766  */
03767 DFVINTERFACE_API char* dfv_getXlsPaper(CDfvObjPtr pDfvObj, char* pVal, int size);
03768 
03769 /**
03770  * Get the XlsPaper parameter string.
03771  *
03772  * @param   pDfvObj Pointer to DfvObj instance.
03773  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03774  *          the string is truncated and terminated with a NULL character.
03775  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03776  * @return  Returns the 'pVal'.
03777  */
03778 DFVINTERFACE_API wchar_t* dfv_getXlsPaperW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03779 
03780 /**
03781  * Set the XlsPaper parameter string.
03782  *
03783  * @param   pDfvObj Pointer to DfvObj instance.
03784  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03785  */
03786 DFVINTERFACE_API void dfv_setXlsPaper(CDfvObjPtr pDfvObj, const char* newVal);
03787 
03788 /**
03789  * Set the XlsPaper parameter string.
03790  *
03791  * @param   pDfvObj Pointer to DfvObj instance.
03792  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03793  */
03794 DFVINTERFACE_API void dfv_setXlsPaperW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03795 
03796 
03797 
03798 /**
03799  * Get whether Word outline level is reflected on PDF bookmark hierarchy.
03800  *
03801  * @param   pDfvObj Pointer to DfvObj instance.
03802  * @return  If 1-9, Generates a hierarchy and folds it at the hierarchy value.
03803  *          If 0, Does not generate a hierarchy.
03804  */
03805 DFVINTERFACE_API int dfv_getDocPdfBookmarkLevel(CDfvObjPtr pDfvObj);
03806 
03807 /**
03808  * Specifies whether Word outline level is reflected on PDF bookmark hierarchy.
03809  *
03810  * @param   pDfvObj Pointer to DfvObj instance.
03811  * @param   newVal  If 1-9, Generates a hierarchy and folds it at the hierarchy value.
03812  *                  If 0, Does not generate a hierarchy.
03813  */
03814 DFVINTERFACE_API void dfv_setDocPdfBookmarkLevel(CDfvObjPtr pDfvObj, int newVal);
03815 
03816 
03817 
03818 /**
03819  * Get specification to output only selected sheet when files are saved in MS Excel.
03820  */
03821 DFVINTERFACE_API int dfv_getXlsSelectedSheet(CDfvObjPtr pDfvObj);
03822     
03823 /**
03824  * Set to output only the selected sheet when files are saved in MS Excel.
03825  *
03826  * @param   pDfvObj Pointer to DfvObj instance.
03827  * @param   newVal  If the value is 'true' is specified, only the selected sheet is output when files are saved in MS Excel
03828  */
03829 DFVINTERFACE_API void dfv_setXlsSelectedSheet(CDfvObjPtr pDfvObj, int newVal);
03830 
03831 
03832 /**
03833  * Get whether to output Notes page in PowerPoint.
03834  *
03835  * @param   pDfvObj Pointer to DfvObj instance.
03836  * @return Return If true is returened, Notes page is output.
03837  *                If false is returned, Slide (normal layout) is output.
03838  */
03839 DFVINTERFACE_API int dfv_getPptNotes(CDfvObjPtr pDfvObj);
03840 
03841 /**
03842  * Specifies whether to output Notes page in PowerPoint.
03843  *
03844  * @param   pDfvObj Pointer to DfvObj instance.
03845  * @param newVal If true, Notes page is output.
03846  *               If false, Slide (normal layout) is output.
03847  */
03848 DFVINTERFACE_API void dfv_setPptNotes(CDfvObjPtr pDfvObj, int newVal);
03849 
03850 
03851 
03852 /**
03853  * Gets the output track change option in MS Word.
03854  *
03855  * @param   pDfvObj Pointer to DfvObj instance.
03856  * @return          
03857  * If true, output track change option in Word.
03858  */
03859 DFVINTERFACE_API int dfv_getDocTrackChange(CDfvObjPtr pDfvObj);
03860 
03861 /**
03862  * Set the setting of Support for correct number of pages in Word.
03863  *
03864  * @param   pDfvObj Pointer to DfvObj instance.
03865  * @param   newVal  
03866  * If true, sets support for output track change in Word.
03867  */
03868 DFVINTERFACE_API void dfv_setDocTrackChange(CDfvObjPtr pDfvObj, int newVal);
03869 
03870 
03871 /**
03872  * Gets the tagged-pdf output.
03873  *
03874  * @param   pDfvObj Pointer to DfvObj instance.
03875  * @return Return to this option.
03876  */
03877 DFVINTERFACE_API long dfv_getPdfTag(CDfvObjPtr pDfvObj);
03878 
03879 
03880 /**
03881  * Set the tagged-pdf output.
03882  *
03883  * @param   pDfvObj Pointer to DfvObj instance.
03884  * @param   newVal      If the value is 'true' is specified, Set to the output tagged-pdf.
03885  */
03886 DFVINTERFACE_API void dfv_setPdfTag(CDfvObjPtr pDfvObj, long newVal);
03887 
03888 /**
03889  * Get the linkfile output.
03890  *
03891  * @param   pDfvObj Pointer to DfvObj instance.
03892  * @return Return to this option.
03893  */
03894 DFVINTERFACE_API int dfv_getLinkfile(CDfvObjPtr pDfvObj);
03895 
03896 /**
03897  * Set the linkfile output.
03898  *
03899  * @param   pDfvObj Pointer to DfvObj instance.
03900  * @param newVal If the value is 'true' is specified, Set to the output linkfile.
03901  */
03902 DFVINTERFACE_API void dfv_setLinkfile(CDfvObjPtr pDfvObj, int newVal);
03903 
03904 
03905 
03906 /**
03907  * Get the property non-output.
03908  *
03909  * @param   pDfvObj Pointer to DfvObj instance.
03910  * @return Return If the value is 'true' is specified, Set to the non-output property.
03911  */
03912 DFVINTERFACE_API int dfv_getPropertyNonOutput(CDfvObjPtr pDfvObj);
03913 
03914 /**
03915  * Specifies whether to non-output property.
03916  *
03917  * @param   pDfvObj Pointer to DfvObj instance.
03918  * @param newVal If the value is 'true' is specified, Set to the non-output property.
03919  */
03920 DFVINTERFACE_API void dfv_setPropertyNonOutput(CDfvObjPtr pDfvObj, int newVal);
03921 
03922 /**
03923  * Get specification to output cell-area.
03924  *
03925  * @param   pDfvObj Pointer to DfvObj instance.
03926  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03927  *          the string is truncated and terminated with a NULL character.
03928  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03929  * @return  Returns the 'pVal'.
03930  */
03931 DFVINTERFACE_API char* dfv_getXlsOutputArea(CDfvObjPtr pDfvObj, char* pVal, int size);
03932 
03933 /**
03934  * Get the output cell-area parameter string.
03935  *
03936  * @param   pDfvObj Pointer to DfvObj instance.
03937  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03938  *          the string is truncated and terminated with a NULL character.
03939  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03940  * @return  Returns the 'pVal'.
03941  */
03942 DFVINTERFACE_API wchar_t* dfv_getXlsOutputAreaW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03943 
03944 /**
03945  * Set the output cell-area parameter string.
03946  *
03947  * @param   pDfvObj Pointer to DfvObj instance.
03948  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03949  */
03950 DFVINTERFACE_API void dfv_setXlsOutputArea(CDfvObjPtr pDfvObj, const char* newVal);
03951 
03952 /**
03953  * Set the output cell-area parameter string.
03954  *
03955  * @param   pDfvObj Pointer to DfvObj instance.
03956  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03957  */
03958 DFVINTERFACE_API void dfv_setXlsOutputAreaW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03959 
03960 
03961 DFVINTERFACE_API void dfv_setOutputSVGFilePath(CDfvObjPtr pDfvObj, const char* newVal);
03962 DFVINTERFACE_API void dfv_setOutputSVGFilePathW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03963 
03964 
03965 
03966 /**
03967      * Gets the NonOutline option in MS Word.
03968  *
03969  * @param   pDfvObj Pointer to DfvObj instance.
03970  * @return          
03971  * If true, Do not convert outlines to bookmarks. in Word.
03972  */
03973 DFVINTERFACE_API int dfv_getDocNonOutline(CDfvObjPtr pDfvObj);
03974 
03975 /**
03976      * Set the NonOutline option.
03977  *
03978  * @param   pDfvObj Pointer to DfvObj instance.
03979  * @param   newVal  
03980  * If true, sets support for Do not convert outlines to bookmarks. in Word
03981  */
03982 DFVINTERFACE_API void dfv_setDocNonOutline(CDfvObjPtr pDfvObj, int newVal);
03983 
03984 
03985 
03986 /**
03987  * Gets the IndexHyperLink option in MS Word.
03988  *
03989  * @return Return to this option.
03990  */
03991 DFVINTERFACE_API int dfv_getIndexHyperLink(CDfvObjPtr pDfvObj);
03992 
03993 /**
03994  * Set the IndexHyperLink option in MS Word.<BR>
03995  * Page number of the index page is hyperlinked to the term marked as index entries in the body
03996  *
03997  * @param   newVal  0, Does not generate a Index Hyperlink.
03998  *                  1, Link to the index terms from the first page to the index page.
03999  *                  2, Link to the index terms on pages after the index page too (processing time will be doubled).
04000  */
04001 DFVINTERFACE_API void dfv_setIndexHyperLink(CDfvObjPtr pDfvObj, int newVal);
04002 
04003 
04004     /**
04005      * Gets specification whether to use Direct2d .<BR>
04006      * Effective only when outputting to image with Windows version
04007      *
04008      * @param   pDfvObj Pointer to DfvObj instance.
04009      * @return          Specification whether to use Direct2d.
04010      */
04011 DFVINTERFACE_API int dfv_getRasterUseDirect2d(CDfvObjPtr pDfvObj);
04012 
04013     /**
04014      * Direct2d is used when converting files from PDF to raster image.<BR>
04015      * This setting is effective only with Windows Vista or later / Windows Server 2003.
04016      * Effective only when outputting to image with Windows version
04017      *
04018      * @param   pDfvObj Pointer to DfvObj instance.
04019      * @param newVal Specifies whether to use Direct2d.
04020      */
04021 DFVINTERFACE_API void dfv_setRasterUseDirect2d(CDfvObjPtr pDfvObj,int newVal);
04022 
04023 
04024 #ifdef __cplusplus
04025 }
04026 #endif  /* __cplusplus */
04027 
04028 #endif  /* DFVIFC_C_H__ */

Generated on 5 Jan 2026 for Office Server Document Converter C/C++ Interface by Doxygen 1.3-rc2