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 
01658 /**
01659  * Effective when outputting to SVG.
01660  * Gets specification whether to rename all file name to prefix specified by dfv_setSvgImagePrefix, or use original name.
01661  * 
01662  *
01663  * @param   pDfvObj Pointer to DfvObj instance.
01664  * @return  specification whether to rename all file name to prefix specified by dfv_setSvgImagePrefix, or use original name.
01665  */
01666 DFVINTERFACE_API long dfv_getSvgImageRename(CDfvObjPtr pDfvObj);
01667 
01668 /**
01669  * Effective when outputting to SVG.
01670  * 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.
01671  *
01672  * 
01673  *
01674  * @param   pDfvObj Pointer to DfvObj instance.
01675  * @param   newVal  specification whether to rename all file name to prefix specified by dfv_setSvgImagePrefix, or use original name.
01676  */
01677 DFVINTERFACE_API void dfv_setSvgImageRename(CDfvObjPtr pDfvObj, long newVal);
01678 
01679 /**
01680  * Effective when outputting to SVG.
01681  * Gets the prefix of the file name when images are copied to the directory specified by dfv_setSvgImageCopyPath and processed.
01682  * 
01683  *
01684  * @param   pDfvObj Pointer to DfvObj instance.
01685  * @param   pVal        Pointer to the buffer that will receive the prefix. If the string is as long or longer than the buffer,
01686  *            the string is truncated and terminated with a NULL character.
01687  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01688  * @return  Returns the 'pVal'.
01689  */
01690 DFVINTERFACE_API char* dfv_getSvgImagePrefix(CDfvObjPtr pDfvObj, char* pVal, int size);
01691 
01692 /**
01693  * Effective when outputting to SVG.
01694  * 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.
01695  *
01696  * 
01697  *
01698  * @param   pDfvObj Pointer to DfvObj instance.
01699  * @param   newVal  the prefix of the file name.
01700  */
01701 DFVINTERFACE_API void dfv_setSvgImagePrefix(CDfvObjPtr pDfvObj, const char* newVal);
01702 
01703 /**
01704  * Effective when outputting to SVG.
01705  * Gets the prefix of the file name when images are copied to the directory specified by dfv_setSvgImageCopyPath and processed.
01706  * 
01707  *
01708  * @param   pDfvObj Pointer to DfvObj instance.
01709  * @param   pVal        Pointer to the buffer that will receive the prefix. If the string is as long or longer than the buffer,
01710  *            the string is truncated and terminated with a NULL character.
01711  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01712  * @return  Returns the 'pVal'.
01713  */
01714 DFVINTERFACE_API wchar_t* dfv_getSvgImagePrefixW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01715 
01716 /**
01717  * Effective when outputting to SVG.
01718  * 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.
01719  * 
01720  *
01721  * @param   pDfvObj Pointer to DfvObj instance.
01722  * @param   newVal  the prefix of the file name.
01723  */
01724 DFVINTERFACE_API void dfv_setSvgImagePrefixW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
01725 
01726 /**
01727  * Effective when outputting to SVG.
01728  * Gets specification whether to add sequential number to the output SVG even if it has only one-page.
01729  * 
01730  *
01731  * @param   pDfvObj Pointer to DfvObj instance.
01732  * @return  specification whether to add sequential number to the output SVG even if it has only one-page.
01733  */
01734 DFVINTERFACE_API long dfv_getSvgSinglePageNumber(CDfvObjPtr pDfvObj);
01735 
01736 /**
01737  * Effective when outputting to SVG.
01738  * 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.
01739  * 
01740  *
01741  * @param   pDfvObj Pointer to DfvObj instance.
01742  * @param   newVal  specification whether to add sequential number to the output SVG even if it has only one-page.
01743  */
01744 DFVINTERFACE_API void dfv_setSvgSinglePageNumber(CDfvObjPtr pDfvObj, long newVal);
01745 
01746 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
01747 
01748 /**
01749  * Effective when outputting to SVG.
01750  * Gets the value of the rasterised-resolution of the transformed raster images.
01751  * 
01752  *
01753  * @param   pDfvObj Pointer to DfvObj instance.
01754  * @return  Rasterised-resolution
01755  */
01756 DFVINTERFACE_API int dfv_getSvgRasterizeResolution(CDfvObjPtr pDfvObj);
01757 
01758 /**
01759  * Effective when outputting to SVG.
01760  * 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.
01761  * This setting is effective only with Windows version.
01762  * 
01763  *
01764  * @param   pDfvObj Pointer to DfvObj instance.
01765  * @param   newVal  Rasterised-resolution (70 to 500)
01766  */
01767 DFVINTERFACE_API void dfv_setSvgRasterizeResolution(CDfvObjPtr pDfvObj, int newVal);
01768 
01769 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
01770 
01771 /**
01772 * Get the start volume of document to output.
01773 * @since 7.1
01774 *
01775 * @param    pDfvObj Pointer to DfvObj instance.
01776 * @return   start volume of output.
01777 */
01778 DFVINTERFACE_API long dfv_getStartVolume(CDfvObjPtr pDfvObj);
01779 
01780 /**
01781 * Specifies the start volume of document to output.
01782 * If the start volume is omitted or the specified value is 0 or less, the start volume is
01783 * considered from the first volume.
01784 * If the setting is inconsistent, (for example, StartVolume=5 EndVolume=3) an error occurs.
01785 * @since 7.1
01786 *
01787 * @param    pDfvObj Pointer to DfvObj instance.
01788 * @param    newVal  start volume of output.
01789 */
01790 DFVINTERFACE_API void dfv_setStartVolume(CDfvObjPtr pDfvObj, long newVal);
01791 
01792 /**
01793 * Get the end volume of document to output.
01794 * @since 7.1
01795 *
01796 * @param    pDfvObj Pointer to DfvObj instance.
01797 * @return   end volume of output.
01798 */
01799 DFVINTERFACE_API long dfv_getEndVolume(CDfvObjPtr pDfvObj);
01800 
01801 /**
01802 * Specifies the end volume of document to output.
01803 * If the end volume is omitted or the specified value exceeds the actual volume number, the end volume
01804 * is considered as the last volume.
01805 * If the setting is inconsistent, (for example, StartVolume=5 EndVolume=3) an error occurs.
01806 * @since 7.1
01807 *
01808 * @param    pDfvObj Pointer to DfvObj instance.
01809 * @param    newVal  end volume of output.
01810 */
01811 DFVINTERFACE_API void dfv_setEndVolume(CDfvObjPtr pDfvObj, long newVal);
01812 
01813 /**
01814 * Get multiple volume  of PDF output.
01815 * @since 7.1
01816 *
01817 * @param    pDfvObj Pointer to DfvObj instance.
01818 * @return   If zero is returned, multiple volume don't specified.
01819 *             If nonezero is returned, multiple volume specified.
01820 */
01821 DFVINTERFACE_API long dfv_getMultiVolume(CDfvObjPtr pDfvObj);
01822 
01823 /**
01824 * Specifies multiple volume of PDF output.
01825 * @since 7.1
01826 *
01827 * @param    pDfvObj Pointer to DfvObj instance.
01828 * @param    newVal  Specifies zero or nonzero.
01829 */
01830 DFVINTERFACE_API void dfv_setMultiVolume(CDfvObjPtr pDfvObj, long newVal);
01831 
01832 /**
01833  * Get the error level to abort formatting process.
01834  *
01835  * @param   pDfvObj Pointer to DfvObj instance.
01836  * @return  Returns the error level.
01837  */
01838 DFVINTERFACE_API DfvIfErrorLevel dfv_getExitLevel(CDfvObjPtr pDfvObj);
01839 
01840 /**
01841  * Error level to abort formatting process. Office Server Document Converter will stop formatting when the detected
01842  * error level is equal to ExitLevel property or higher. The default value is 2 (Warning).
01843  * Thus if an error occurred and error level is 2 (Warning) or higher, formatting process will be
01844  * aborted. Please use the value from 1 to 4. When the value of 5 or more specified, it is considered
01845  * to be the value of 4. If a error-level:4 (fatal error) occurs, the formatting process will be
01846  * aborted unconditionally.
01847  * BTW : An error is not displayed no matter what value may be specified to be this property.
01848  *
01849  * <table border="0" cellspacing="0" cellpadding="0">
01850  *  <tr><td>ELVL_INFORMATION    </td><td>= 1 Information</td></tr>
01851  *  <tr><td>ELVL_WARNING        </td><td>= 2 Warning</td></tr>
01852  *  <tr><td>ELVL_RECOVERABLE    </td><td>= 3 Recoveable Error</td></tr>
01853  *  <tr><td>ELVL_FATAL          </td><td>= 4 Fatal Error</td></tr>
01854  * </table>
01855  *
01856  * @param   pDfvObj Pointer to DfvObj instance.
01857  * @param   newVal  error level to abort formatting process.
01858  */
01859 DFVINTERFACE_API void dfv_setExitLevel(CDfvObjPtr pDfvObj, DfvIfErrorLevel newVal);
01860 
01861 /**
01862  * Returns the error level of the error that occurred during the formatting process.
01863  *
01864  * <table border="0" cellspacing="0" cellpadding="0">
01865  *  <tr><td>ELVL_INFORMATION    </td><td>= 1 Information</td></tr>
01866  *  <tr><td>ELVL_WARNING        </td><td>= 2 Warning</td></tr>
01867  *  <tr><td>ELVL_RECOVERABLE    </td><td>= 3 Recoveable Error</td></tr>
01868  *  <tr><td>ELVL_FATAL          </td><td>= 4 Fatal Error</td></tr>
01869  * </table>
01870  *
01871  * @param   pDfvObj Pointer to DfvObj instance.
01872  * @return  Returns the error level.
01873  */
01874 DFVINTERFACE_API DfvIfErrorLevel dfv_getErrorLevel(CDfvObjPtr pDfvObj);
01875 
01876 /**
01877  * Returns the error code of the error that occurred during the formatting process.
01878  * Zero means no error. Non-zero indicates any error occurred.
01879  *
01880  * @param   pDfvObj Pointer to DfvObj instance.
01881  * @return  Returns the error code.
01882  */
01883 DFVINTERFACE_API DfvIfErrorCode dfv_getErrorCode(CDfvObjPtr pDfvObj);
01884 
01885 /**
01886  * Returns the error message of the error that occurred during the formatting process.
01887  *
01888  * @param   pDfvObj Pointer to DfvObj instance.
01889  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
01890  *            the string is truncated and terminated with a NULL character.
01891  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01892  * @return  Returns the 'pVal'.
01893  */
01894 DFVINTERFACE_API char* dfv_getErrorMessage(CDfvObjPtr pDfvObj, char* pVal, int size);
01895 /**
01896  * Returns the error message of the error that occurred during the formatting process.
01897  *
01898  * @param   pDfvObj Pointer to DfvObj instance.
01899  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
01900  *            the string is truncated and terminated with a NULL character.
01901  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
01902  * @return  Returns the 'pVal'.
01903  */
01904 DFVINTERFACE_API wchar_t* dfv_getErrorMessageW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
01905 
01906 /**
01907  * Sets the substitution of font name. This substitution acts on the font names existing in FO.
01908  * The font name 'fontName' is replaced to 'aliasName'.
01909  *
01910  * @param   pDfvObj Pointer to DfvObj instance.
01911  * @param   src     Specifies the font name which is replaced.
01912  * @param   dst     Specifies the aliasName.
01913  */
01914 DFVINTERFACE_API void dfv_setFontAlias(CDfvObjPtr pDfvObj, const char* src, const char* dst);
01915 /**
01916  * Sets the substitution of font name. This substitution acts on the font names existing in FO.
01917  * The font name 'fontName' is replaced to 'aliasName'.
01918  *
01919  * @param   pDfvObj Pointer to DfvObj instance.
01920  * @param   src     Specifies the font name which is replaced.
01921  * @param   dst     Specifies the aliasName.
01922  */
01923 DFVINTERFACE_API void dfv_setFontAliasW(CDfvObjPtr pDfvObj, const wchar_t* src, const wchar_t* dst);
01924 
01925 /**
01926  * Clear all substitutions of font name.
01927  *
01928  * @param   pDfvObj Pointer to DfvObj instance.
01929  */
01930 DFVINTERFACE_API void dfv_clearFontAlias(CDfvObjPtr pDfvObj);
01931 /**
01932  * Clear all substitutions of font name.
01933  *
01934  * @param   pDfvObj Pointer to DfvObj instance.
01935  */
01936 
01937 /**
01938  * Erase the substitution of font name 'fontName'.
01939  *
01940  * @param   pDfvObj Pointer to DfvObj instance.
01941  * @param   src Specifies the font name which is replaced.
01942  */
01943 DFVINTERFACE_API void dfv_eraseFontAlias(CDfvObjPtr pDfvObj, const char* src);
01944 DFVINTERFACE_API void dfv_eraseFontAliasW(CDfvObjPtr pDfvObj, const wchar_t* src);
01945 
01946 /**
01947  * Execute formatting and output to a PDF specified in OutputFilePath or printer specified in PrinterName.
01948  *
01949  * @param   pDfvObj Pointer to DfvObj instance.
01950  * @return  Returns the error code. Zero means no error. Non-zero indicates any error occurred.
01951  */
01952 DFVINTERFACE_API DfvIfErrorCode dfv_execute(CDfvObjPtr pDfvObj);
01953 
01954 /**
01955  * Initialize formatting engine.
01956  *
01957  * @param   pDfvObj Pointer to DfvObj instance.
01958  */
01959 DFVINTERFACE_API void dfv_clear(CDfvObjPtr pDfvObj);
01960 
01961 /**
01962  * Specifies the callback fucntion.
01963  * The error that occurred during the formatting process can be received.
01964  *
01965  * @param   pDfvObj Pointer to DfvObj instance.
01966  * @param   proc        Address of the callback function.
01967  *  <br>Callback function has the following form:<pre>
01968  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
01969  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
01970  */
01971 DFVINTERFACE_API void dfv_setOnMessageProc(CDfvObjPtr pDfvObj, DfvOnMessageProc* proc);
01972 
01973 /**
01974  * Specifies the callback fucntion.
01975  * The error that occurred during the formatting process can be received.
01976  *
01977  * @param   pDfvObj Pointer to DfvObj instance.
01978  * @param   proc        Address of the callback function.
01979  *  <br>Callback function has the following form:<pre>
01980  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
01981  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
01982  */
01983 DFVINTERFACE_API void dfv_setOnMessageProcW(CDfvObjPtr pDfvObj, DfvOnMessageProcW* proc);
01984 
01985 /**
01986  * Specifies the callback fucntion.
01987  * The page number in the formatting process can be received.
01988  *
01989  * @param   pDfvObj Pointer to DfvObj instance.
01990  * @param   proc    Address of the callback function.
01991  *  <br>Callback function has the following form:<pre>
01992  * void DfvOnFormatPageProc(long pageNo);</pre>
01993  */
01994 DFVINTERFACE_API void dfv_setOnFormatPageProc(CDfvObjPtr pDfvObj, DfvOnFormatPageProc* proc);
01995 
01996 /**
01997  * Specifies the callback fucntion.
01998  * The error that occurred during the formatting process can be received.
01999  *
02000  * @param   pDfvObj Pointer to DfvObj instance.
02001  * @param   proc        Address of the callback function.
02002  *  <br>Callback function has the following form:<pre>
02003  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
02004  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
02005  * @param   pAnyObj     Address of an any object.
02006  */
02007 DFVINTERFACE_API void dfv_setOnMessageProcEx(CDfvObjPtr pDfvObj, DfvOnMessageProcEx* proc, void* pAnyObj);
02008 
02009 /**
02010  * Specifies the callback fucntion.
02011  * The error that occurred during the formatting process can be received.
02012  *
02013  * @param   pDfvObj Pointer to DfvObj instance.
02014  * @param   proc        Address of the callback function.
02015  *  <br>Callback function has the following form:<pre>
02016  * void DfvOnMessageProc(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const char* errMessage);
02017  * void DfvOnMessageProcW(DfvIfErrorLevel errLevel, DfvIfErrorCode errCode, const wchar_t* errMessage);</pre>
02018  * @param   pAnyObj     Address of an any object.
02019  */
02020 DFVINTERFACE_API void dfv_setOnMessageProcExW(CDfvObjPtr pDfvObj, DfvOnMessageProcExW* proc, void* pAnyObj);
02021 
02022 /**
02023  * Specifies the callback fucntion.
02024  * The page number in the formatting process can be received.
02025  *
02026  * @param   pDfvObj Pointer to DfvObj instance.
02027  * @param   proc    Address of the callback function.
02028  *  <br>Callback function has the following form:<pre>
02029  * void DfvOnFormatPageProc(long pageNo);</pre>
02030  * @param   pAnyObj     Address of an any object.
02031  */
02032 DFVINTERFACE_API void dfv_setOnFormatPageProcEx(CDfvObjPtr pDfvObj, DfvOnFormatPageProcEx* proc, void* pAnyObj);
02033 
02034 /* Print Interface */
02035 /**
02036  * Get the printer name where the formatted result is outputted.
02037  *
02038  * @param   pDfvObj Pointer to DfvObj instance.
02039  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02040  *            the string is truncated and terminated with a NULL character.
02041  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02042  * @return  Returns the 'pVal'.
02043  */
02044 DFVINTERFACE_API char* dfv_getPrinterName(CDfvObjPtr pDfvObj, char* pVal, int size);
02045 /**
02046  * Get the printer name where the formatted result is outputted.
02047  *
02048  * @param   pDfvObj Pointer to DfvObj instance.
02049  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02050  *            the string is truncated and terminated with a NULL character.
02051  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02052  * @return  Returns the 'pVal'.
02053  */
02054 DFVINTERFACE_API wchar_t* dfv_getPrinterNameW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02055 
02056 /**
02057  * Specifies the output format or the printer name to output.
02058  * When a printer name is specified, the formatted result is outputted to that printer.
02059  * When "\@STDPRN" is specified, the converted result is outputted to the currently used printer.
02060  * When "\@PDF" is specified, the converted result is outputted to PDF.
02061  * When "\@SVG" is specified, the converted result is outputted to SVG.
02062  * When "\@INX" is specified, the converted result is outputted to INX.
02063  * When "\@XPS" is specified, the converted result is outputted to XPS.
02064  * When "\@JPEG" is specified, the converted result is outputted to JPEG.
02065  * When "\@PJPEG" is specified, the converted result is output as progressive JPEG.
02066  * When "\@PNG" is specified, the converted result is outputted to PNG.
02067  * When "\@IPNG" is specified, the converted result is output as interlaced PNG.
02068  * When "\@Flash" is specified, the formatted result is outputted to Flash.
02069  * When "\@TIFF" is specified, the converted result is outputted to TIFF.
02070  * When "\@TIFFC" is specified, the converted result is outputted to TIFF CMYK.
02071  * When "\@MTIFF" is specified, the converted result is outputted to multi-page TIFF.
02072  * When "\@MTIFFC" is specified, the converted result is outputted to multi-page TIFF of CMYK.
02073  * When omitted, it is considered as "\@PDF" was specified.
02074  * It's impossible to output to the printer with any OS's other than Windows.
02075  *
02076  * @param   pDfvObj Pointer to DfvObj instance.
02077  * @param   newVal  Pointer to a null-terminated string to be used as the printer name.
02078  */
02079 DFVINTERFACE_API void dfv_setPrinterName(CDfvObjPtr pDfvObj, const char* newVal);
02080 /**
02081  * Specifies the output format or the printer name to output.
02082  * When a printer name is specified, the formatted result is outputted to that printer.
02083  * When "\@STDPRN" is specified, the converted result is outputted to the currently used printer.
02084  * When "\@PDF" is specified, the converted result is outputted to PDF.
02085  * When "\@SVG" is specified, the converted result is outputted to SVG.
02086  * When "\@INX" is specified, the converted result is outputted to INX.
02087  * When "\@XPS" is specified, the converted result is outputted to XPS.
02088  * When "\@JPEG" is specified, the converted result is outputted to JPEG.
02089  * When "\@PJPEG" is specified, the converted result is output as progressive JPEG.
02090  * When "\@PNG" is specified, the converted result is outputted to PNG.
02091  * When "\@IPNG" is specified, the converted result is output as interlaced PNG.
02092  * When "\@Flash" is specified, the formatted result is outputted to Flash.
02093  * When "\@TIFF" is specified, the converted result is outputted to TIFF.
02094  * When "\@TIFFC" is specified, the converted result is outputted to TIFF CMYK.
02095  * When "\@MTIFF" is specified, the converted result is outputted to multi-page TIFF.
02096  * When "\@MTIFFC" is specified, the converted result is outputted to multi-page TIFF of CMYK.
02097  * When omitted, it is considered as "\@PDF" was specified.
02098  * It's impossible to output to the printer with any OS's other than Windows.
02099  *
02100  * @param   pDfvObj Pointer to DfvObj instance.
02101  * @param   newVal  Pointer to a null-terminated string to be used as the printer name.
02102  */
02103 DFVINTERFACE_API void dfv_setPrinterNameW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02104 
02105 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02106 
02107 /**
02108  * Get the number of copies. Effective when outputting to printer.
02109  * This setting is effective only with Windows version.
02110  *
02111  * @param   pDfvObj Pointer to DfvObj instance.
02112  * @return  Returns the number of copies.
02113  */
02114 DFVINTERFACE_API long dfv_getPrnCopies(CDfvObjPtr pDfvObj);
02115 
02116 /**
02117  * Specifies the number of copies. Effective when outputting to printer.
02118  * If nothing is specified, the value is considered as 1.
02119  * This setting is effective only with Windows version.
02120  *
02121  * @param   pDfvObj Pointer to DfvObj instance.
02122  * @param   newVal  the number of copies.
02123  */
02124 DFVINTERFACE_API void dfv_setPrnCopies(CDfvObjPtr pDfvObj, long newVal);
02125 
02126 /**
02127  * Get collation of multiple copies.
02128  * This setting is effective only with Windows version.
02129  *
02130  * @param   pDfvObj Pointer to DfvObj instance.
02131  * @return  If zero is returned, the same page is multi-copied continuously.
02132  *            If nonezero is returned, the pages specified from start to end are printed repeatedly.
02133  */
02134 DFVINTERFACE_API long dfv_getPrnCollate(CDfvObjPtr pDfvObj);
02135 
02136 /**
02137  * Specifies collation of multiple copies. Effective when outputting to printer and the number of
02138  * copies is plural. If it is not specified or the value zero is specified, the same page is
02139  * multi-copied continuously.
02140  * If nonezero is specified, the pages specified from start to end are printed repeatedly.
02141  * This setting is effective only with Windows version.
02142  *
02143  * @param   pDfvObj Pointer to DfvObj instance.
02144  * @param   newVal  Zpecifies zero or nonzero.
02145  */
02146 DFVINTERFACE_API void dfv_setPrnCollate(CDfvObjPtr pDfvObj, long newVal);
02147 
02148 /**
02149  * Get the setting of whether print dialog box is displayed or not when printing
02150  * This setting is effective only with Windows version.
02151  *
02152  * @param   pDfvObj Pointer to DfvObj instance.
02153  * @return  If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.
02154  */
02155 DFVINTERFACE_API long dfv_getBatchPrint(CDfvObjPtr pDfvObj);
02156 
02157 /**
02158  * When the value 'false' is specified, the print dialog box is displayed when printing.
02159  * If the setting is omitted or the value 'true' is specified, the print dialog is not displayed.
02160  * This setting is effective only with Windows version.
02161  *
02162  * @param   pDfvObj Pointer to DfvObj instance.
02163  * @param   newVal  If zero, the print dialog box is displayed. If nonezero, the print dialog box is not displayed.
02164  */
02165 DFVINTERFACE_API void dfv_setBatchPrint(CDfvObjPtr pDfvObj, long newVal);
02166 
02167 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))   /* _WIN32 */
02168 
02169 /**
02170  * Get the version string of Office Server Document Converter.
02171  * 
02172  *
02173  * @param   pDfvObj Pointer to DfvObj instance.
02174  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02175  *            the string is truncated and terminated with a NULL character.
02176  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02177  * @return  Returns the 'pVal'.
02178  */
02179 DFVINTERFACE_API char* dfv_getVersion(CDfvObjPtr pDfvObj, char* pVal, int size);
02180 
02181 /**
02182  * Get the version string of Office Server Document Converter.
02183  * 
02184  *
02185  * @param   pDfvObj Pointer to DfvObj instance.
02186  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
02187  *            the string is truncated and terminated with a NULL character.
02188  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
02189  * @return  Returns the 'pVal'.
02190  */
02191 DFVINTERFACE_API wchar_t* dfv_getVersionW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02192 
02193 /**
02194  * Get INX output mode.
02195  *
02196  * @param   pDfvObj Pointer to DfvObj instance.
02197  * @return  output mode of INX.
02198  */
02199 DFVINTERFACE_API DfvINXOUTPUTMODE dfv_getInxOutputMode(CDfvObjPtr pDfvObj);
02200 
02201 /**
02202  * Set INX output mode.
02203  *
02204  * @param   pDfvObj Pointer to DfvObj instance.
02205  * @param   newVal mode of INX.
02206  */
02207 DFVINTERFACE_API void dfv_setInxOutputMode(CDfvObjPtr pDfvObj, DfvINXOUTPUTMODE newVal);
02208 
02209 /**
02210  * Get the specification that omit blank pages. return Specification that omit blank pages 
02211  */
02212 DFVINTERFACE_API int dfv_getOmitBlankPages(CDfvObjPtr pDfvObj);
02213     
02214 /**
02215  * In MS Word files, skip a blank page when it is at the beginning of the document.
02216  * Skip also if a page at the beginning of the document is only header and footer.
02217  * In MS Excel files, skip a blank page.
02218  * The original file is valid only for MS Word or MS Excel.
02219  * To skip and get only the page with the first content found, specify this property in combination with setEndPage = 1.
02220  * Operation in combination with anything other than setEndPage = 1 is not guaranteed.
02221  *
02222  * @param   pDfvObj Pointer to DfvObj instance.
02223  * @param   newVal      If the value is 'true' is specified, omit blank pages 
02224  */
02225 DFVINTERFACE_API void dfv_setOmitBlankPages(CDfvObjPtr pDfvObj, int newVal);
02226 
02227 
02228 /**
02229  * Get specifies of the FlashPartiallyOutput.
02230  * @since 2.1
02231  *
02232  * @param   pDfvObj Pointer to DfvObj instance.
02233  * @return  specifies of FlashPartiallyOutput.
02234  */
02235 DFVINTERFACE_API long dfv_getFlashPartiallyOutput(CDfvObjPtr pDfvObj);
02236 
02237 /**
02238  * When an error occurs within the document, the flash file in process will be outputted.
02239  * Effective when outputting to Flash.
02240  * @since 2.1
02241  *
02242  * @param   pDfvObj Pointer to DfvObj instance.
02243  * @param   newVal  If the value is 'true' is specified, output the flash file.
02244  */
02245 DFVINTERFACE_API void dfv_setFlashPartiallyOutput(CDfvObjPtr pDfvObj, long newVal);
02246 
02247 /**
02248  * Get specifies of the FlashHidePageButton.
02249  * @since 3.0
02250  *
02251  * @param   pDfvObj Pointer to DfvObj instance.
02252  * @return  specifies of FlashHidePageButton.
02253  */
02254 DFVINTERFACE_API long dfv_getFlashHidePageButton(CDfvObjPtr pDfvObj);
02255 
02256 /**
02257  * Output a no page button. Effective when outputting to Flash.
02258  * @since 3.0
02259  *
02260  * @param   pDfvObj Pointer to DfvObj instance.
02261  * @param   newVal  If the value is 'true' is specified, output a no page button.
02262  */
02263 DFVINTERFACE_API void dfv_setFlashHidePageButton(CDfvObjPtr pDfvObj, long newVal);
02264 
02265 /**
02266  * Get the setting of the FlashSplitPage.
02267  *
02268  * @param   pDfvObj Pointer to DfvObj instance.
02269  * @return
02270  * Specify FlashSplitPage.
02271  */
02272 DFVINTERFACE_API long dfv_getFlashSplitPage(CDfvObjPtr pDfvObj);
02273 
02274 /**
02275  * Outputs Flash file per page and saves as every single file..<BR>
02276  * Effective when outputting to Flash.
02277  *
02278  * @param   pDfvObj Pointer to DfvObj instance.
02279  * @param newVal
02280  * If 'true' is specified, do not output Flash file per page.
02281  */
02282 DFVINTERFACE_API void dfv_setFlashSplitPage(CDfvObjPtr pDfvObj, long newVal);
02283 
02284 /**
02285  * Get the setting of FlashOutputAction.
02286  *
02287  * @param   pDfvObj Pointer to DfvObj instance.
02288  * @return
02289  * Specify FlashOutputAction.
02290  */
02291 DFVINTERFACE_API long dfv_getFlashOutputAction(CDfvObjPtr pDfvObj);
02292 
02293 /**
02294  * Do not output features of ActionScript1.0, such as stop action per page, the page navigation button, linking, etc..<BR>
02295  * Effective when outputting to Flash.
02296  *
02297  * @param   pDfvObj Pointer to DfvObj instance.
02298  * @param newVal
02299  * If 'true' is specified, do not output Flash file per page.
02300  */
02301 DFVINTERFACE_API void dfv_setFlashOutputAction(CDfvObjPtr pDfvObj, long newVal);
02302 
02303 /**
02304  * Get the setting of FlashImageLimitSize.
02305  *
02306  * @param   pDfvObj Pointer to DfvObj instance.
02307  * @return
02308  * Specify FlashImageLimitSize.
02309  */
02310 DFVINTERFACE_API int dfv_getFlashImageLimitSize(CDfvObjPtr pDfvObj);
02311 
02312 /**
02313  * Specifies the number of maximum pixels of images outputted to the Flash file by the integral value. 
02314  * When the width or the height of the output image exceeds the specified value, 
02315  * it is reduced to the specified value when outputting the flash file. 
02316  * When this parameter is omitted, 1000 is applied.  <BR>
02317  * The image size that can be embedded in Flash is limited to the value of width x height with 2 raised to the 24th power (16,777,216) 
02318  * by the number of pixels. Please note that when embedded image exceeds this size, 
02319  * it may not be displayed with Flash Player.<BR>
02320  * Effective when outputting to Flash.
02321  *
02322  * @param   pDfvObj Pointer to DfvObj instance.
02323  * @param newVal
02324  * If 'true' is specified, do not output Flash file per page.
02325  */
02326 DFVINTERFACE_API void dfv_setFlashImageLimitSize(CDfvObjPtr pDfvObj, int newVal);
02327 
02328 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02329 
02330 /**
02331  * It print at size of paper.
02332  * Default is false.
02333  * Effective only when outputting to printer with Windows version. 
02334  * 
02335  * @param   pDfvObj Pointer to DfvObj instance.
02336  * @param   newVal      If the value is 'true' is specified, print at size of paper. 
02337  */
02338 DFVINTERFACE_API void dfv_setPrnFitPaper(CDfvObjPtr pDfvObj, int newVal);
02339 
02340 #endif  // #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02341 
02342 
02343 /**
02344  * Get the image resolution when outputting JPEG and PNG.
02345  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02346  *
02347  * @param   pDfvObj Pointer to DfvObj instance.
02348  * @return      Image resolution 
02349  */
02350 DFVINTERFACE_API int dfv_getRasterDPI(CDfvObjPtr pDfvObj);
02351 
02352 /**
02353  * Sets the image resolution when outputting JPEG and PNG.
02354  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02355  *
02356  * @param   pDfvObj Pointer to DfvObj instance.
02357  * @param   newVal      Image resolution (1 to 1440)
02358  */
02359 DFVINTERFACE_API void dfv_setRasterDPI(CDfvObjPtr pDfvObj, int newVal);
02360 
02361 /**
02362  * Get the image scale when outputting JPEG and PNG.
02363  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02364  *
02365  * @param   pDfvObj Pointer to DfvObj instance.
02366  * @param   pVal        
02367  *          Pointer to the buffer that will receive the text. 
02368  *          If the string is as long or longer than the buffer,
02369  *          the string is truncated and terminated with a NULL character.
02370  * @param   size
02371  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02372  *          If the text exceeds this limit, it is truncated.
02373  * @return  Returns the 'pVal'.
02374  */
02375 DFVINTERFACE_API char* dfv_getRasterScale(CDfvObjPtr pDfvObj, char* pVal, int size);
02376 
02377 /**
02378  * Get the image scale when outputting JPEG and PNG.
02379  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02380  *
02381  * @param   pDfvObj Pointer to DfvObj instance.
02382  * @param   pVal        
02383  *          Pointer to the buffer that will receive the text. 
02384  *          If the string is as long or longer than the buffer,
02385  *          the string is truncated and terminated with a NULL character.
02386  * @param   size
02387  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02388  *          If the text exceeds this limit, it is truncated.
02389  * @return  Returns the 'pVal'.
02390  */
02391 DFVINTERFACE_API wchar_t* dfv_getRasterScaleW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02392 
02393 /**
02394  * Sets the image scale when outputting JPEG and PNG.
02395  * A numerical value, "%", or "px" (pixel) is available as the unit.
02396  * Specify the percentage for a numerical value and "%", and specify the width of image for pixel.
02397  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02398  *
02399  * @param   pDfvObj Pointer to DfvObj instance.
02400  * @param   newVal      Image scale 
02401  */
02402 DFVINTERFACE_API void dfv_setRasterScale(CDfvObjPtr pDfvObj, const char* newVal);
02403 
02404 /**
02405  * Sets the image scale when outputting JPEG and PNG.
02406  * A numerical value, "%", or "px" (pixel) is available as the unit.
02407  * Specify the percentage for a numerical value and "%", and specify the width of image for pixel.
02408  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02409  *
02410  * @param   pDfvObj Pointer to DfvObj instance.
02411  * @param   newVal      Image scale 
02412  */
02413 DFVINTERFACE_API void dfv_setRasterScaleW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02414 
02415 /**
02416  * Get the maximum image height when outputting JPEG and PNG.<BR>
02417  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02418  *
02419  * @param   pDfvObj Pointer to DfvObj instance.
02420  * @return          Maximum image height
02421  */
02422 DFVINTERFACE_API int dfv_getRasterHeight(CDfvObjPtr pDfvObj);
02423 
02424 /**
02425  * Sets the maximum image height decided by setRasterScale when outputting JPEG and PNG.<BR>
02426  * "px" (pixel) is available as the unit. 
02427  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02428  *
02429  * @param   pDfvObj Pointer to DfvObj instance.
02430  * @param   newVal  Maximum image height
02431  */
02432 DFVINTERFACE_API void dfv_setRasterHeight(CDfvObjPtr pDfvObj, int newVal);
02433 
02434 /**
02435  * Get the file name naming format when outputting PNG and JPEG.<BR>
02436  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02437  *
02438  * @param   pDfvObj Pointer to DfvObj instance.
02439  * @param   pVal        
02440  *          Pointer to the buffer that will receive the text. 
02441  *          If the string is as long or longer than the buffer,
02442  *          the string is truncated and terminated with a NULL character.
02443  * @param   size
02444  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02445  *          If the text exceeds this limit, it is truncated.
02446  * @return  Returns the 'pVal'.
02447  */
02448 DFVINTERFACE_API char* dfv_getRasterFormat(CDfvObjPtr pDfvObj, char* pVal, int size);
02449 
02450 /**
02451  * Get the file name naming format when outputting PNG and JPEG.<BR>
02452  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02453  *
02454  * @param   pDfvObj Pointer to DfvObj instance.
02455  * @param   pVal        
02456  *          Pointer to the buffer that will receive the text. 
02457  *          If the string is as long or longer than the buffer,
02458  *          the string is truncated and terminated with a NULL character.
02459  * @param   size
02460  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02461  *          If the text exceeds this limit, it is truncated.
02462  * @return  Returns the 'pVal'.
02463  */
02464 DFVINTERFACE_API wchar_t* dfv_getRasterFormatW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02465 
02466 /**
02467  * Specifies the file name naming format when outputting PNG and JPEG.<BR>
02468  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02469  *
02470  * @param   pDfvObj Pointer to DfvObj instance.
02471  * @param   newVal  format for naming files
02472  */
02473 DFVINTERFACE_API void dfv_setRasterFormat(CDfvObjPtr pDfvObj, const char* newVal);
02474 
02475 /**
02476  * Specifies the file name naming format when outputting PNG and JPEG.<BR>
02477  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02478  *
02479  * @param   pDfvObj Pointer to DfvObj instance.
02480  * @param   newVal  format for naming files
02481  */
02482 DFVINTERFACE_API void dfv_setRasterFormatW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02483 
02484 /**
02485  * Get the conversion accuracy when outputting JPEG.<BR>
02486  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02487  *
02488  * @param   pDfvObj Pointer to DfvObj instance.
02489  * @return          JPEG quality
02490  */
02491 DFVINTERFACE_API int dfv_getRasterJpegQuality(CDfvObjPtr pDfvObj);
02492 
02493 /**
02494  * Specifies the conversion accuracy by the value with the range of 1-100(%) when outputting JPEG.<BR>
02495  * When this parameter is omitted, it is regarded as 80%.
02496  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02497  *
02498  * @param   pDfvObj Pointer to DfvObj instance.
02499  * @param   newVal  JPEG quality
02500  */
02501 DFVINTERFACE_API void dfv_setRasterJpegQuality(CDfvObjPtr pDfvObj, int newVal);
02502 
02503 
02504 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02505 
02506 /**
02507  * Gets specification whether to use GdiPlus .<BR>
02508  * Effective only when outputting to image with Windows version
02509  *
02510  * @param   pDfvObj Pointer to DfvObj instance.
02511  * @return          Specification whether to use GdiPlus.
02512  */
02513 DFVINTERFACE_API long dfv_getRasterUseGdiPlus(CDfvObjPtr pDfvObj);
02514 
02515 /**
02516  * GdiPlus is used when the file is converted to Jpeg or PNG.<BR>
02517  * This setting is effective only with Windows Vista or later / Windows Server 2003.
02518  * Effective only when outputting to image with Windows version
02519  *
02520  * @param   pDfvObj Pointer to DfvObj instance.
02521  * @param newVal Specifies whether to use GdiPlus.
02522  */
02523 DFVINTERFACE_API void dfv_setRasterUseGdiPlus(CDfvObjPtr pDfvObj, long newVal);
02524 
02525 /**
02526  * Gets specification whether to convert to monochrome image, when outputting JPEG and PNG.<BR>
02527  * Effective only when outputting to image with Windows version
02528  *
02529  * @param   pDfvObj Pointer to DfvObj instance.
02530  * @return          Specification whether to convert to monochrome.
02531  */
02532 DFVINTERFACE_API long dfv_getRasterMonochrome(CDfvObjPtr pDfvObj);
02533 
02534 /**
02535  * Specifies whether to convert to monochrome image, when outputting JPEG and PNG.<BR>
02536  * Effective only when outputting to image with Windows version
02537  *
02538  * @param   pDfvObj Pointer to DfvObj instance.
02539  * @param newVal Specifies whether to convert to monochrome.
02540  */
02541 DFVINTERFACE_API void dfv_setRasterMonochrome(CDfvObjPtr pDfvObj, long newVal);
02542 
02543 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02544 
02545 
02546 /**
02547  * @deprecated
02548  * Get the path name of RGB ICC profile for input when outputting CMYK TIFF.
02549  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02550  *
02551  * @param   pDfvObj Pointer to DfvObj instance.
02552  * @param   pVal        
02553  *          Pointer to the buffer that will receive the text. 
02554  *          If the string is as long or longer than the buffer,
02555  *          the string is truncated and terminated with a NULL character.
02556  * @param   size
02557  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02558  *          If the text exceeds this limit, it is truncated.
02559  * @return  Returns the 'pVal'.
02560  */
02561 DFVINTERFACE_API char* dfv_getRasterRGBProfile(CDfvObjPtr pDfvObj, char* pVal, int size);
02562 
02563 /**
02564  * @deprecated
02565  * Get the path name of RGB ICC profile for input when outputting CMYK TIFF.
02566  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02567  *
02568  * @param   pDfvObj Pointer to DfvObj instance.
02569  * @param   pVal        
02570  *          Pointer to the buffer that will receive the text. 
02571  *          If the string is as long or longer than the buffer,
02572  *          the string is truncated and terminated with a NULL character.
02573  * @param   size
02574  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02575  *          If the text exceeds this limit, it is truncated.
02576  * @return  Returns the 'pVal'.
02577  */
02578 DFVINTERFACE_API wchar_t* dfv_getRasterRGBProfileW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02579 
02580 /**
02581  * @deprecated
02582  * Set the path name of RGB ICC profile for input when outputting CMYK TIFF.
02583  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02584  *
02585  * @param   pDfvObj Pointer to DfvObj instance.
02586  * @param   newVal  Pointer to a null-terminated string.
02587  */
02588 DFVINTERFACE_API void dfv_setRasterRGBProfile(CDfvObjPtr pDfvObj, const char* newVal);
02589 
02590 /**
02591  * @deprecated
02592  * Set the path name of RGB ICC profile for input when outputting CMYK TIFF.
02593  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02594  *
02595  * @param   pDfvObj Pointer to DfvObj instance.
02596  * @param   newVal  Pointer to a null-terminated string.
02597  */
02598 DFVINTERFACE_API void dfv_setRasterRGBProfileW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02599 
02600 /**
02601  * @deprecated
02602  * Get the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02603  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02604  *
02605  * @param   pDfvObj Pointer to DfvObj instance.
02606  * @param   pVal        
02607  *          Pointer to the buffer that will receive the text. 
02608  *          If the string is as long or longer than the buffer,
02609  *          the string is truncated and terminated with a NULL character.
02610  * @param   size
02611  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02612  *          If the text exceeds this limit, it is truncated.
02613  * @return  Returns the 'pVal'.
02614  */
02615 DFVINTERFACE_API char* dfv_getRasterCMYKProfile(CDfvObjPtr pDfvObj, char* pVal, int size);
02616 
02617 /**
02618  * @deprecated
02619  * Get the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02620  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02621  *
02622  * @param   pDfvObj Pointer to DfvObj instance.
02623  * @param   pVal        
02624  *          Pointer to the buffer that will receive the text. 
02625  *          If the string is as long or longer than the buffer,
02626  *          the string is truncated and terminated with a NULL character.
02627  * @param   size
02628  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02629  *          If the text exceeds this limit, it is truncated.
02630  * @return  Returns the 'pVal'.
02631  */
02632 DFVINTERFACE_API wchar_t* dfv_getRasterCMYKProfileW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02633 
02634 /**
02635  * @deprecated
02636  * Set the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02637  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02638  *
02639  * @param   pDfvObj Pointer to DfvObj instance.
02640  * @param   newVal  Pointer to a null-terminated string.
02641  */
02642 DFVINTERFACE_API void dfv_setRasterCMYKProfile(CDfvObjPtr pDfvObj, const char* newVal);
02643 
02644 /**
02645  * @deprecated
02646  * Set the path name of CMYK ICC profile for output when outputting CMYK TIFF.
02647  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02648  *
02649  * @param   pDfvObj Pointer to DfvObj instance.
02650  * @param   newVal  Pointer to a null-terminated string.
02651  */
02652 DFVINTERFACE_API void dfv_setRasterCMYKProfileW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02653 
02654 /**
02655  * Get the setting of whether to convert images to grayscale 256 tones.
02656  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02657  *
02658  * @param   pDfvObj Pointer to DfvObj instance.
02659  * @return 
02660  * Specify whether to convert images to grayscale 256 tones.
02661  */
02662 DFVINTERFACE_API long dfv_getRasterGrayscale(CDfvObjPtr pDfvObj);
02663 
02664 /**
02665  * Outputs grayscale 256 tones..<BR>
02666  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02667  *
02668  * @param   pDfvObj Pointer to DfvObj instance.
02669  * @param newVal
02670  * If "true" is specified, convert images to grayscale 256 tones.
02671  */
02672 DFVINTERFACE_API void dfv_setRasterGrayscale(CDfvObjPtr pDfvObj, long newVal);
02673 
02674 
02675 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02676 
02677 /**
02678  * Get the setting of whether to convert images to 256 colors.
02679  * Effective only when outputting to image with Windows version
02680  *
02681  * @param   pDfvObj Pointer to DfvObj instance.
02682  * @return
02683  * Specify whether to convert images to 256 colors.
02684  */
02685 DFVINTERFACE_API long dfv_getRaster256Color(CDfvObjPtr pDfvObj);
02686 
02687 /**
02688  * Outputs 256 colors..<BR>
02689  * Effective only when outputting to image with Windows version
02690  *
02691  * @param   pDfvObj Pointer to DfvObj instance.
02692  * @param newVal
02693  * If "true" is specified, convert images to 256 colors.
02694  */
02695 DFVINTERFACE_API void dfv_setRaster256Color(CDfvObjPtr pDfvObj, long newVal);
02696 
02697 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02698 
02699 
02700 /**
02701  * @deprecated
02702  * Get the compression method when outputting TIFF / MTIFF.
02703  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02704  *
02705  * @param   pDfvObj Pointer to DfvObj instance.
02706  * @param   pVal        
02707  *          Pointer to the buffer that will receive the text. 
02708  *          If the string is as long or longer than the buffer,
02709  *          the string is truncated and terminated with a NULL character.
02710  * @param   size
02711  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02712  *          If the text exceeds this limit, it is truncated.
02713  * @return  Returns the 'pVal'.
02714  */
02715 DFVINTERFACE_API char* dfv_getRasterCompression(CDfvObjPtr pDfvObj, char* pVal, int size);
02716 
02717 /**
02718  * @deprecated
02719  * Get the compression method when outputting TIFF / MTIFF.
02720  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02721  *
02722  * @param   pDfvObj Pointer to DfvObj instance.
02723  * @param   pVal        
02724  *          Pointer to the buffer that will receive the text. 
02725  *          If the string is as long or longer than the buffer,
02726  *          the string is truncated and terminated with a NULL character.
02727  * @param   size
02728  *          Specifies the number of the 'pVal' buffer, including the NULL character.
02729  *          If the text exceeds this limit, it is truncated.
02730  * @return  Returns the 'pVal'.
02731  */
02732 DFVINTERFACE_API wchar_t* dfv_getRasterCompressionW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
02733 
02734 /**
02735  * @deprecated
02736  * Specifies the compression method when outputting TIFF / MTIFF.<BR>
02737  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02738  * The compression method.<BR>
02739  * none : None<BR>
02740  * lzw : ZLIB compression(When this parameter is omitted, lzw is applied.)<BR>
02741  * dct : DCTDecode<BR>
02742  * flate : FlateDecode<BR>
02743  * runlength : Run Length compression<BR>
02744  * ccitt3 : CCITT Group3<BR>
02745  * ccitt4 : CCITT Group4<BR>
02746  *
02747  * @param   pDfvObj Pointer to DfvObj instance.
02748  * @param   newVal  Pointer to a null-terminated string.
02749  */
02750 DFVINTERFACE_API void dfv_setRasterCompression(CDfvObjPtr pDfvObj, const char* newVal);
02751 
02752 /**
02753  * @deprecated
02754  * Specifies the compression method when outputting TIFF / MTIFF.<BR>
02755  * Effective only when outputting to image with Windows version and Linux version 6.0 or later.
02756  * The compression method.<BR>
02757  * none : None<BR>
02758  * lzw : ZLIB compression(When this parameter is omitted, lzw is applied.)<BR>
02759  * dct : DCTDecode<BR>
02760  * flate : FlateDecode<BR>
02761  * runlength : Run Length compression<BR>
02762  * ccitt3 : CCITT Group3<BR>
02763  * ccitt4 : CCITT Group4<BR>
02764  *
02765  * @param   pDfvObj Pointer to DfvObj instance.
02766  * @param   newVal  Pointer to a null-terminated string.
02767  */
02768 DFVINTERFACE_API void dfv_setRasterCompressionW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02769 
02770 
02771 /**
02772  * Specifies the height of the paper when inputting text.
02773  * Effective when inputting text. 
02774  *
02775  * @param   pDfvObj Pointer to DfvObj instance.
02776  * @param   newVal      the height of paper 
02777  */
02778 DFVINTERFACE_API void dfv_setTextPaperHeight(CDfvObjPtr pDfvObj, const char* newVal);
02779 
02780 /**
02781  * Specifies the height of the paper when inputting text.
02782  * Effective when inputting text. 
02783  *
02784  * @param   pDfvObj Pointer to DfvObj instance.
02785  * @param   newVal      the height of paper 
02786  */
02787 DFVINTERFACE_API void dfv_setTextPaperHeightW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02788 
02789 /**
02790  * Specifies the width of the paper when inputting text.
02791  * Effective when inputting text. 
02792  *
02793  * @param   pDfvObj Pointer to DfvObj instance.
02794  * @param   newVal      the width of paper 
02795  */
02796 DFVINTERFACE_API void dfv_setTextPaperWidth(CDfvObjPtr pDfvObj, const char* newVal);
02797 
02798 /**
02799  * Specifies the width of the paper when inputting text.
02800  * Effective when inputting text. 
02801  *
02802  * @param   pDfvObj Pointer to DfvObj instance.
02803  * @param   newVal      the width of paper 
02804  */
02805 DFVINTERFACE_API void dfv_setTextPaperWidthW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02806 
02807 /**
02808  * Specifies the left margin of the paper when inputting text.
02809  * Effective when inputting text. 
02810  *
02811  * @param   pDfvObj Pointer to DfvObj instance.
02812  * @param   newVal       the left margin of the paper 
02813  */
02814 DFVINTERFACE_API void dfv_setTextMarginLeft(CDfvObjPtr pDfvObj, const char* newVal);
02815 
02816 /**
02817  * Specifies the left margin of the paper when inputting text.
02818  * Effective when inputting text. 
02819  *
02820  * @param   pDfvObj Pointer to DfvObj instance.
02821  * @param   newVal       the left margin of the paper 
02822  */
02823 DFVINTERFACE_API void dfv_setTextMarginLeftW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02824 
02825 /**
02826  * Specifies the right margin of the paper when inputting text.
02827  * Effective when inputting text. 
02828  *
02829  * @param   pDfvObj Pointer to DfvObj instance.
02830  * @param   newVal      the top margin of the paper 
02831  */
02832 DFVINTERFACE_API void dfv_setTextMarginTop(CDfvObjPtr pDfvObj, const char* newVal);
02833 
02834 /**
02835  * Specifies the right margin of the paper when inputting text.
02836  * Effective when inputting text. 
02837  *
02838  * @param   pDfvObj Pointer to DfvObj instance.
02839  * @param   newVal      the top margin of the paper 
02840  */
02841 DFVINTERFACE_API void dfv_setTextMarginTopW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02842 
02843 /**
02844  * Specifies the right margin of the paper when inputting text.
02845  * Effective when inputting text. 
02846  *
02847  * @param   pDfvObj Pointer to DfvObj instance.
02848  * @param   newVal      the right margin of the paper 
02849  */
02850 DFVINTERFACE_API void dfv_setTextMarginRight(CDfvObjPtr pDfvObj, const char* newVal);
02851 
02852 /**
02853  * Specifies the right margin of the paper when inputting text.
02854  * Effective when inputting text. 
02855  *
02856  * @param   pDfvObj Pointer to DfvObj instance.
02857  * @param   newVal      the right margin of the paper 
02858  */
02859 DFVINTERFACE_API void dfv_setTextMarginRightW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02860 
02861 /**
02862  * Specifies the right margin of the paper when inputting text.
02863  * Effective when inputting text. 
02864  *
02865  * @param   pDfvObj Pointer to DfvObj instance.
02866  * @param   newVal      the bottom margin of the paper 
02867  */
02868 DFVINTERFACE_API void dfv_setTextMarginBottom(CDfvObjPtr pDfvObj, const char* newVal);
02869 
02870 /**
02871  * Specifies the right margin of the paper when inputting text.
02872  * Effective when inputting text. 
02873  *
02874  * @param   pDfvObj Pointer to DfvObj instance.
02875  * @param   newVal      the bottom margin of the paper 
02876  */
02877 DFVINTERFACE_API void dfv_setTextMarginBottomW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02878 
02879 /**
02880  * Specifies the font family name when inputting text.
02881  * Effective when inputting text. 
02882  *
02883  * @param   pDfvObj Pointer to DfvObj instance.
02884  * @param   newVal      font family name 
02885  */
02886 DFVINTERFACE_API void dfv_setTextFontFamily(CDfvObjPtr pDfvObj, const char* newVal);
02887 
02888 /**
02889  * Specifies the font family name when inputting text.
02890  * Effective when inputting text. 
02891  *
02892  * @param   pDfvObj Pointer to DfvObj instance.
02893  * @param   newVal      font family name 
02894  */
02895 DFVINTERFACE_API void dfv_setTextFontFamilyW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02896 
02897 /**
02898  * Specifies the font size when inputting text.
02899  * Effective when inputting text. 
02900  *
02901  * @param   pDfvObj Pointer to DfvObj instance.
02902  * @param   newVal      font size 
02903  */
02904 DFVINTERFACE_API void dfv_setTextFontSize(CDfvObjPtr pDfvObj, const char* newVal);
02905 
02906 /**
02907  * Specifies the font size when inputting text.
02908  * Effective when inputting text. 
02909  *
02910  * @param   pDfvObj Pointer to DfvObj instance.
02911  * @param   newVal      font size 
02912  */
02913 DFVINTERFACE_API void dfv_setTextFontSizeW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02914 
02915 /**
02916  * Specifies the value of whether show page number or not when inputting text.
02917  * Effective when inputting text. 
02918  * 
02919  * @param   pDfvObj Pointer to DfvObj instance.
02920  * @param   newVal      the value of whether show page number or not 
02921  */
02922 DFVINTERFACE_API void dfv_setTextShowPageNumber(CDfvObjPtr pDfvObj, int newVal);
02923 
02924 /**
02925  * Specifies the value of whether show page number or not when inputting text.
02926  * Effective when inputting text. 
02927  * 
02928  * @param   pDfvObj Pointer to DfvObj instance.
02929  * @param   newVal      the value of whether show page number or not    
02930  */
02931 DFVINTERFACE_API void dfv_setTextShowLineNumber(CDfvObjPtr pDfvObj, int newVal);
02932 
02933 /**
02934  * Specifies the offset value of range from body area when showing line number and inputting text.
02935  * Effective when inputting text. 
02936  * 
02937  * @param   pDfvObj Pointer to DfvObj instance.
02938  * @param   newVal      the offset value
02939  */
02940 DFVINTERFACE_API void dfv_setTextLineNumberOffset(CDfvObjPtr pDfvObj, const char* newVal);
02941 
02942 /**
02943  * Specifies the offset value of range from body area when showing line number and inputting text.
02944  * Effective when inputting text. 
02945  * 
02946  * @param   pDfvObj Pointer to DfvObj instance.
02947  * @param   newVal      the offset value
02948  */
02949 DFVINTERFACE_API void dfv_setTextLineNumberOffsetW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02950 
02951 /**
02952  * Specifies the line number format when showing line number and inputting text.
02953  * Effective when inputting text. 
02954  * 
02955  * @param   pDfvObj Pointer to DfvObj instance.
02956  * @param   newVal      line number format  
02957  */
02958 DFVINTERFACE_API void dfv_setTextLineNumberFormat(CDfvObjPtr pDfvObj, const char* newVal);
02959 
02960 /**
02961  * Specifies the line number format when showing line number and inputting text.
02962  * Effective when inputting text. 
02963  * 
02964  * @param   pDfvObj Pointer to DfvObj instance.
02965  * @param   newVal      line number format  
02966  */
02967 DFVINTERFACE_API void dfv_setTextLineNumberFormatW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
02968 
02969 #if defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
02970 /**
02971  * Acquires the setting of the smoothing processing to text.<BR>
02972  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
02973  *
02974  * @param   pDfvObj Pointer to DfvObj instance.
02975  * @return          
02976  * Specify whether to perform the smoothing processing to text.
02977  */
02978 DFVINTERFACE_API int dfv_getGdiTextAntialias(CDfvObjPtr pDfvObj);
02979 
02980 /**
02981  * Performs the smoothing processing to text.<BR>
02982  * Effective only when printing and outputting images.<BR>
02983  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
02984  *
02985  * @param   pDfvObj Pointer to DfvObj instance.
02986  * @param   newVal  
02987  * Performs the smoothing processing when true is specified.
02988  */
02989 DFVINTERFACE_API void dfv_setGdiTextAntialias(CDfvObjPtr pDfvObj, int newVal);
02990 
02991 /**
02992  * Acquires the setting of the smoothing processing to borders.<BR>
02993  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
02994  *
02995  * @param   pDfvObj Pointer to DfvObj instance.
02996  * @return          
02997  * Specify whether to perform the smoothing processing to borders.
02998  */
02999 DFVINTERFACE_API int dfv_getGdiLineartSmoothing(CDfvObjPtr pDfvObj);
03000 
03001 /**
03002  * Performs the smoothing processing to borders.<BR>
03003  * Effective only when printing and outputting images.<BR>
03004  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03005  *
03006  * @param   pDfvObj Pointer to DfvObj instance.
03007  * @param   newVal  
03008  * Performs the smoothing processing when true is specified.
03009  */
03010 DFVINTERFACE_API void dfv_setGdiLineartSmoothing(CDfvObjPtr pDfvObj, int newVal);
03011 
03012 /**
03013  * Acquires the setting of the smoothing processing to images.<BR>
03014  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03015  *
03016  * @param   pDfvObj Pointer to DfvObj instance.
03017  * @return          
03018  * Specify whether to perform the smoothing processing to images.
03019  */
03020 DFVINTERFACE_API int dfv_getGdiImageSmoothing(CDfvObjPtr pDfvObj);
03021 
03022 /**
03023  * Performs the smoothing processing to images.<BR>
03024  * Effective only when printing and outputting images.<BR>
03025  * This setting is effective only with Windows Vista or later / Windows Server 2003 or later.
03026  *
03027  * @param   pDfvObj Pointer to DfvObj instance.
03028  * @param   newVal  
03029  * Performs the smoothing processing when true is specified.
03030  */
03031 DFVINTERFACE_API void dfv_setGdiImageSmoothing(CDfvObjPtr pDfvObj, int newVal);
03032 
03033 #endif // defined(_DOXYGEN) || (defined(_MSC_VER) && defined(_WIN32))
03034 
03035 /**
03036  * @deprecated
03037  * Get the watermark text on each page.
03038  *
03039  * @param   pDfvObj Pointer to DfvObj instance.
03040  * @param   pVal        
03041  *          Pointer to the buffer that will receive the text. 
03042  *          If the string is as long or longer than the buffer,
03043  *          the string is truncated and terminated with a NULL character.
03044  * @param   size
03045  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03046  *          If the text exceeds this limit, it is truncated.
03047  * @return  Returns the 'pVal'.
03048  */
03049 DFVINTERFACE_API char* dfv_getWatermarkText(CDfvObjPtr pDfvObj, char* pVal, int size);
03050 
03051 /**
03052  * @deprecated
03053  * Get the watermark text on each page. 
03054  *
03055  * @param   pDfvObj Pointer to DfvObj instance.
03056  * @param   pVal        
03057  *          Pointer to the buffer that will receive the text. 
03058  *          If the string is as long or longer than the buffer,
03059  *          the string is truncated and terminated with a NULL character.
03060  * @param   size
03061  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03062  *          If the text exceeds this limit, it is truncated.
03063  * @return  Returns the 'pVal'.
03064  */
03065 DFVINTERFACE_API wchar_t* dfv_getWatermarkTextW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03066 
03067 /**
03068  * @deprecated
03069  * Displays the specified watermark text on each page. 
03070  * Possible to make it multiple lines by delimiting with the line feed \n. 
03071  * This setting is invalid with the evaluation version.  
03072  *
03073  * @param   pDfvObj Pointer to DfvObj instance.
03074  * @param   newVal  Pointer to a null-terminated string.
03075  */
03076 DFVINTERFACE_API void dfv_setWatermarkText(CDfvObjPtr pDfvObj, const char* newVal);
03077 
03078 /**
03079  * @deprecated
03080  * Displays the specified watermark text on each page. 
03081  * Possible to make it multiple lines by delimiting with the line feed \n. 
03082  * This setting is invalid with the evaluation version.  
03083  *
03084  * @param   pDfvObj Pointer to DfvObj instance.
03085  * @param   newVal  Pointer to a null-terminated string.
03086  */
03087 DFVINTERFACE_API void dfv_setWatermarkTextW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03088 
03089 /**
03090  * @deprecated
03091  * Get the font family of the watermark text.
03092  *
03093  * @param   pDfvObj Pointer to DfvObj instance.
03094  * @param   pVal        
03095  *          Pointer to the buffer that will receive the text. 
03096  *          If the string is as long or longer than the buffer,
03097  *          the string is truncated and terminated with a NULL character.
03098  * @param   size
03099  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03100  *          If the text exceeds this limit, it is truncated.
03101  * @return  Returns the 'pVal'.
03102  */
03103 DFVINTERFACE_API char* dfv_getWatermarkFontFamily(CDfvObjPtr pDfvObj, char* pVal, int size);
03104 
03105 /**
03106  * @deprecated
03107  * Get the font family of the watermark text.
03108  *
03109  * @param   pDfvObj Pointer to DfvObj instance.
03110  * @param   pVal        
03111  *          Pointer to the buffer that will receive the text. 
03112  *          If the string is as long or longer than the buffer,
03113  *          the string is truncated and terminated with a NULL character.
03114  * @param   size
03115  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03116  *          If the text exceeds this limit, it is truncated.
03117  * @return  Returns the 'pVal'.
03118  */
03119 DFVINTERFACE_API wchar_t* dfv_getWatermarkFontFamilyW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03120 
03121 /**
03122  * @deprecated
03123  * Specifies the font family to the character string which you set to watermark-text.  
03124  *
03125  * @param   pDfvObj Pointer to DfvObj instance.
03126  * @param   newVal  Pointer to a null-terminated string.
03127  */
03128 DFVINTERFACE_API void dfv_setWatermarkFontFamily(CDfvObjPtr pDfvObj, const char* newVal);
03129 
03130 /**
03131  * @deprecated
03132  * Specifies the font family to the character string which you set to watermark-text.  
03133  *
03134  * @param   pDfvObj Pointer to DfvObj instance.
03135  * @param   newVal  Pointer to a null-terminated string.
03136  */
03137 DFVINTERFACE_API void dfv_setWatermarkFontFamilyW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03138 
03139 /**
03140  * @deprecated
03141  * Get the font weight of the watermark text.
03142  *
03143  * @param   pDfvObj Pointer to DfvObj instance.
03144  * @param   pVal        
03145  *          Pointer to the buffer that will receive the text. 
03146  *          If the string is as long or longer than the buffer,
03147  *          the string is truncated and terminated with a NULL character.
03148  * @param   size
03149  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03150  *          If the text exceeds this limit, it is truncated.
03151  * @return  Returns the 'pVal'.
03152  */
03153 DFVINTERFACE_API char* dfv_getWatermarkFontWeight(CDfvObjPtr pDfvObj, char* pVal, int size);
03154 
03155 /**
03156  * @deprecated
03157  * Get the font weight of the watermark text. 
03158  *
03159  * @param   pDfvObj Pointer to DfvObj instance.
03160  * @param   pVal        
03161  *          Pointer to the buffer that will receive the text. 
03162  *          If the string is as long or longer than the buffer,
03163  *          the string is truncated and terminated with a NULL character.
03164  * @param   size
03165  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03166  *          If the text exceeds this limit, it is truncated.
03167  * @return  Returns the 'pVal'.
03168  */
03169 DFVINTERFACE_API wchar_t* dfv_getWatermarkFontWeightW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03170 
03171 /**
03172  * @deprecated
03173  * Specifies the font weight to the character string which you set to watermark-text. 
03174  * Possible to specify normal, bold or the numerical value from 100 to 900.  
03175  *
03176  * @param   pDfvObj Pointer to DfvObj instance.
03177  * @param   newVal  Pointer to a null-terminated string.
03178  */
03179 DFVINTERFACE_API void dfv_setWatermarkFontWeight(CDfvObjPtr pDfvObj, const char* newVal);
03180 
03181 /**
03182  * @deprecated
03183  * Specifies the font weight to the character string which you set to watermark-text. 
03184  * Possible to specify normal, bold or the numerical value from 100 to 900.  
03185  *
03186  * @param   pDfvObj Pointer to DfvObj instance.
03187  * @param   newVal  Pointer to a null-terminated string.
03188  */
03189 DFVINTERFACE_API void dfv_setWatermarkFontWeightW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03190 
03191 /**
03192  * @deprecated
03193  * Get the font style of the watermark text.
03194  *
03195  * @param   pDfvObj Pointer to DfvObj instance.
03196  * @param   pVal        
03197  *          Pointer to the buffer that will receive the text. 
03198  *          If the string is as long or longer than the buffer,
03199  *          the string is truncated and terminated with a NULL character.
03200  * @param   size
03201  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03202  *          If the text exceeds this limit, it is truncated.
03203  * @return  Returns the 'pVal'.
03204  */
03205 DFVINTERFACE_API char* dfv_getWatermarkFontStyle(CDfvObjPtr pDfvObj, char* pVal, int size);
03206 
03207 /**
03208  * @deprecated
03209  * Get the font style of the watermark text. 
03210  *
03211  * @param   pDfvObj Pointer to DfvObj instance.
03212  * @param   pVal        
03213  *          Pointer to the buffer that will receive the text. 
03214  *          If the string is as long or longer than the buffer,
03215  *          the string is truncated and terminated with a NULL character.
03216  * @param   size
03217  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03218  *          If the text exceeds this limit, it is truncated.
03219  * @return  Returns the 'pVal'.
03220  */
03221 DFVINTERFACE_API wchar_t* dfv_getWatermarkFontStyleW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03222 
03223 /**
03224  * @deprecated
03225  * Specifies the font style to the character string which you set to watermark-text.  
03226  *
03227  * @param   pDfvObj Pointer to DfvObj instance.
03228  * @param   newVal  Pointer to a null-terminated string.
03229  */
03230 DFVINTERFACE_API void dfv_setWatermarkFontStyle(CDfvObjPtr pDfvObj, const char* newVal);
03231 
03232 /**
03233  * @deprecated
03234  * Specifies the font style to the character string which you set to watermark-text.  
03235  *
03236  * @param   pDfvObj Pointer to DfvObj instance.
03237  * @param   newVal  Pointer to a null-terminated string.
03238  */
03239 DFVINTERFACE_API void dfv_setWatermarkFontStyleW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03240 
03241 /**
03242  * @deprecated
03243  * Get the opacity of the watermark text. 
03244  *
03245  * @param   pDfvObj Pointer to DfvObj instance.
03246  * @param   pVal        
03247  *          Pointer to the buffer that will receive the text. 
03248  *          If the string is as long or longer than the buffer,
03249  *          the string is truncated and terminated with a NULL character.
03250  * @param   size
03251  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03252  *          If the text exceeds this limit, it is truncated.
03253  * @return  Returns the 'pVal'.
03254  */
03255 DFVINTERFACE_API char* dfv_getWatermarkOpacity(CDfvObjPtr pDfvObj, char* pVal, int size);
03256 
03257 /**
03258  * @deprecated
03259  * Get the opacity of the watermark text. 
03260  *
03261  * @param   pDfvObj Pointer to DfvObj instance.
03262  * @param   pVal        
03263  *          Pointer to the buffer that will receive the text. 
03264  *          If the string is as long or longer than the buffer,
03265  *          the string is truncated and terminated with a NULL character.
03266  * @param   size
03267  *          Specifies the number of the 'pVal' buffer, including the NULL character.
03268  *          If the text exceeds this limit, it is truncated.
03269  * @return  Returns the 'pVal'.
03270  */
03271 DFVINTERFACE_API wchar_t* dfv_getWatermarkOpacityW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03272 
03273 /**
03274  * @deprecated
03275  * Specifies the opacity to the character string which you set to watermark-text.  
03276  *
03277  * @param   pDfvObj Pointer to DfvObj instance.
03278  * @param   newVal  Pointer to a null-terminated string.
03279  */
03280 DFVINTERFACE_API void dfv_setWatermarkOpacity(CDfvObjPtr pDfvObj, const char* newVal);
03281 
03282 /**
03283  * @deprecated
03284  * Specifies the opacity to the character string which you set to watermark-text.  
03285  *
03286  * @param   pDfvObj Pointer to DfvObj instance.
03287  * @param   newVal  Pointer to a null-terminated string.
03288  */
03289 DFVINTERFACE_API void dfv_setWatermarkOpacityW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03290 
03291 /**
03292  * Gets the setting of continuous page numbers across worksheets in Excel header footer/number of pages as a total of all worksheets.
03293  * @param   pDfvObj Pointer to DfvObj instance.
03294  * @return          
03295  * If true, inserts continuous page numbers across all worksheets/number of pages as a total of all worksheets.
03296  */
03297 DFVINTERFACE_API int dfv_getContinuePageNumber(CDfvObjPtr pDfvObj);
03298 
03299 /**
03300  * Sets continuous page numbers across worksheets in Excel header footer/number of pages as a total of all worksheets.
03301  *
03302  * @param   pDfvObj Pointer to DfvObj instance.
03303  * @param   newVal  
03304  * If true, sets continuous page numbers across all worksheets/number of pages as a total of all worksheets.
03305  */
03306 DFVINTERFACE_API void dfv_setContinuePageNumber(CDfvObjPtr pDfvObj, int newVal);
03307 
03308 /**
03309  * Get the ICC profile file name.
03310  *
03311  * @param   pDfvObj Pointer to DfvObj instance.
03312  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03313  *            the string is truncated and terminated with a NULL character.
03314  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03315  * @return  Returns the 'pVal'.
03316  */
03317 
03318 DFVINTERFACE_API char* dfv_getPdfColorProfile(CDfvObjPtr pDfvObj, char* pVal, int size);
03319 /**
03320  * Get the ICC profile file name.
03321  *
03322  * @param   pDfvObj Pointer to DfvObj instance.
03323  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03324  *            the string is truncated and terminated with a NULL character.
03325  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03326  * @return  Returns the 'pVal'.
03327  */
03328 DFVINTERFACE_API wchar_t* dfv_getPdfColorProfileW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03329 
03330 /**
03331  * Set the ICC profile file name.
03332  * 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.
03333  *
03334  * @param   pDfvObj Pointer to DfvObj instance.
03335  * @param   newVal  Pointer to a null-terminated string to be used as the ICC profile file name.
03336  */
03337 DFVINTERFACE_API void dfv_setPdfColorProfile(CDfvObjPtr pDfvObj, const char* newVal);
03338 
03339 /**
03340  * Set the ICC profile file name.
03341      * 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.
03342  *
03343  * @param   pDfvObj Pointer to DfvObj instance.
03344  * @param   newVal  Pointer to a null-terminated string to be used as the ICC profile file name.
03345  */
03346 DFVINTERFACE_API void dfv_setPdfColorProfileW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03347 
03348 /**
03349  * Specifies the open password for document.
03350  *
03351  * @param   pDfvObj Pointer to DfvObj instance.
03352  * @param   newVal  Pointer to a null-terminated string.
03353  */
03354 DFVINTERFACE_API void dfv_setOpenPassword(CDfvObjPtr pDfvObj, const char* newVal);
03355 
03356 /**
03357  * Specifies the open password for document.
03358  *
03359  * @param   pDfvObj Pointer to DfvObj instance.
03360  * @param   newVal  Pointer to a null-terminated string.
03361  */
03362 DFVINTERFACE_API void dfv_setOpenPasswordW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03363 
03364 /**
03365  * Get the setting of Support for correct number of pages in Word.
03366  *
03367  * @param   pDfvObj Pointer to DfvObj instance.
03368  * @return          
03369  * If true, support for correct number of pages and dynamically updating table of contents in Word.
03370  */
03371 DFVINTERFACE_API long dfv_getPageNumberCorrection(CDfvObjPtr pDfvObj);
03372 
03373 /**
03374  * Set the setting of Support for correct number of pages in Word.
03375  *
03376  * @param   pDfvObj Pointer to DfvObj instance.
03377  * @param   newVal  
03378  * If true, sets support for correct number of pages and dynamically updating table of contents in Word.
03379  */
03380 DFVINTERFACE_API void dfv_setPageNumberCorrection(CDfvObjPtr pDfvObj, long newVal);
03381 
03382 /**
03383  * Get the specification that output to the first sheet that was active. return Specification that output to the first sheet that was active 
03384  */
03385 DFVINTERFACE_API int dfv_getSheetOrderActiveFirst(CDfvObjPtr pDfvObj);
03386     
03387 /**
03388  * Output to the first sheet that was active when you save in MS Excel.
03389  *
03390  * @param   pDfvObj Pointer to DfvObj instance.
03391  * @param   newVal      If the value is 'true' is specified, first sheet that was active
03392  */
03393 DFVINTERFACE_API void dfv_setSheetOrderActiveFirst(CDfvObjPtr pDfvObj, int newVal);
03394 
03395 /**
03396  * Get the sheet order and select.
03397  *
03398  * @param   pDfvObj Pointer to DfvObj instance.
03399  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03400  *            the string is truncated and terminated with a NULL character.
03401  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03402  * @return  Returns the 'pVal'.
03403  */
03404 
03405 DFVINTERFACE_API char* dfv_getSheetOrderSelect(CDfvObjPtr pDfvObj, char* pVal, int size);
03406 /**
03407  * Get the sheet order and select.
03408  *
03409  * @param   pDfvObj Pointer to DfvObj instance.
03410  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03411  *            the string is truncated and terminated with a NULL character.
03412  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03413  * @return  Returns the 'pVal'.
03414  */
03415 DFVINTERFACE_API wchar_t* dfv_getSheetOrderSelectW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03416 
03417 /**
03418  * Set the sheet order and select.
03419  *
03420  * @param   pDfvObj Pointer to DfvObj instance.
03421  * @param   newVal  Pointer to a null-terminated string to be used as the sheet order and select.
03422  */
03423 DFVINTERFACE_API void dfv_setSheetOrderSelect(CDfvObjPtr pDfvObj, const char* newVal);
03424 
03425 /**
03426  * Set the sheet order and select.
03427  *
03428  * @param   pDfvObj Pointer to DfvObj instance.
03429  * @param   newVal  Pointer to a null-terminated string to be used as the sheet order and select.
03430  */
03431 DFVINTERFACE_API void dfv_setSheetOrderSelectW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03432 
03433 /**
03434  * Get the locale.
03435  *
03436  * @param   pDfvObj Pointer to DfvObj instance.
03437  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03438  *            the string is truncated and terminated with a NULL character.
03439  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03440  * @return  Returns the 'pVal'.
03441  */
03442 
03443 DFVINTERFACE_API char* dfv_getLocale(CDfvObjPtr pDfvObj, char* pVal, int size);
03444 /**
03445  * Get the locale.
03446  *
03447  * @param   pDfvObj Pointer to DfvObj instance.
03448  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03449  *            the string is truncated and terminated with a NULL character.
03450  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03451  * @return  Returns the 'pVal'.
03452  */
03453 DFVINTERFACE_API wchar_t* dfv_getLocaleW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03454 
03455 /**
03456  * Set the locale.
03457  *
03458  * @param   pDfvObj Pointer to DfvObj instance.
03459  * @param   newVal  Pointer to a null-terminated string to be used as the locale.
03460  */
03461 DFVINTERFACE_API void dfv_setLocale(CDfvObjPtr pDfvObj, const char* newVal);
03462 
03463 /**
03464  * Set the locale.
03465  *
03466  * @param   pDfvObj Pointer to DfvObj instance.
03467  * @param   newVal  Pointer to a null-terminated string to be used as the locale.
03468  */
03469 DFVINTERFACE_API void dfv_setLocaleW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03470 
03471 /**
03472  * Get the RowColControl configuration file name.
03473  *
03474  * @param   pDfvObj Pointer to DfvObj instance.
03475  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03476  *          the string is truncated and terminated with a NULL character.
03477  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03478  * @return  Returns the 'pVal'.
03479  */
03480 DFVINTERFACE_API char* dfv_getRowColControlFileName(CDfvObjPtr pDfvObj, char* pVal, int size);
03481 
03482 /**
03483  * Get the RowColControl configuration file name.
03484  *
03485  * @param   pDfvObj Pointer to DfvObj instance.
03486  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03487  *          the string is truncated and terminated with a NULL character.
03488  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03489  * @return  Returns the 'pVal'.
03490  */
03491 DFVINTERFACE_API wchar_t* dfv_getRowColControlFileNameW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03492 
03493 /**
03494  * Set the RowColControl configuration file name.
03495  *
03496  * @param   pDfvObj Pointer to DfvObj instance.
03497  * @param   newVal  Pointer to a null-terminated string to be used as the file name.
03498  */
03499 DFVINTERFACE_API void dfv_setRowColControlFileName(CDfvObjPtr pDfvObj, const char* newVal);
03500 
03501 /**
03502  * Set the RowColControl configuration file name.
03503  *
03504  * @param   pDfvObj Pointer to DfvObj instance.
03505  * @param   newVal  Pointer to a null-terminated string to be used as the file name.
03506  */
03507 DFVINTERFACE_API void dfv_setRowColControlFileNameW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03508 
03509 /**
03510  * Get the RowColControl parameter row,col string.
03511  *
03512  * @param   pDfvObj Pointer to DfvObj instance.
03513  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03514  *          the string is truncated and terminated with a NULL character.
03515  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03516  * @return  Returns the 'pVal'.
03517  */
03518 DFVINTERFACE_API char* dfv_getRowColControlParameter(CDfvObjPtr pDfvObj, char* pVal, int size);
03519 
03520 /**
03521  * Get the RowColControl parameter row,col string.
03522  *
03523  * @param   pDfvObj Pointer to DfvObj instance.
03524  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03525  *          the string is truncated and terminated with a NULL character.
03526  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03527  * @return  Returns the 'pVal'.
03528  */
03529 DFVINTERFACE_API wchar_t* dfv_getRowColControlParameterW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03530 
03531 /**
03532  * Set the RowColControl parameter row,col.
03533  *
03534  * @param   pDfvObj Pointer to DfvObj instance.
03535  * @param   newVal  Pointer to a null-terminated string to be used as the parameter row,col string.
03536  */
03537 DFVINTERFACE_API void dfv_setRowColControlParameter(CDfvObjPtr pDfvObj, const char* newVal);
03538 
03539 /**
03540  * Set the RowColControl parameter row,col.
03541  *
03542  * @param   pDfvObj Pointer to DfvObj instance.
03543  * @param   newVal  Pointer to a null-terminated string to be used as the parameter row,col string.
03544  */
03545 DFVINTERFACE_API void dfv_setRowColControlParameterW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03546 
03547 /**
03548  * Gets the view information option.
03549  *   default font name/size in file & printer name in sheet and matched parameter.
03550  *
03551  * @param   pDfvObj Pointer to DfvObj instance.
03552  * @return Return to this option.
03553  */
03554 DFVINTERFACE_API int dfv_getXlsInfoView(CDfvObjPtr pDfvObj);
03555 
03556 /**
03557  * Set the view information option.
03558  *   default font name/size in file & printer name in sheet and matched parameter.
03559  *
03560  * @param   pDfvObj Pointer to DfvObj instance.
03561  * @param   newVal      If the value is 'true' is specified, Set to the view information option.
03562  */
03563 DFVINTERFACE_API void dfv_setXlsInfoView(CDfvObjPtr pDfvObj, int newVal);
03564 
03565 /**
03566  * Get the XlsPaperDefault parameter string.
03567  *
03568  * @param   pDfvObj Pointer to DfvObj instance.
03569  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03570  *          the string is truncated and terminated with a NULL character.
03571  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03572  * @return  Returns the 'pVal'.
03573  */
03574 DFVINTERFACE_API char* dfv_getXlsPaperDefault(CDfvObjPtr pDfvObj, char* pVal, int size);
03575 
03576 /**
03577  * Get the XlsPaperDefault parameter string.
03578  *
03579  * @param   pDfvObj Pointer to DfvObj instance.
03580  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03581  *          the string is truncated and terminated with a NULL character.
03582  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03583  * @return  Returns the 'pVal'.
03584  */
03585 DFVINTERFACE_API wchar_t* dfv_getXlsPaperDefaultW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03586 
03587 /**
03588  * Set the XlsPaperDefault parameter string.
03589  *
03590  * @param   pDfvObj Pointer to DfvObj instance.
03591  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03592  */
03593 DFVINTERFACE_API void dfv_setXlsPaperDefault(CDfvObjPtr pDfvObj, const char* newVal);
03594 
03595 /**
03596  * Set the XlsPaperDefault parameter string.
03597  *
03598  * @param   pDfvObj Pointer to DfvObj instance.
03599  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03600  */
03601 DFVINTERFACE_API void dfv_setXlsPaperDefaultW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03602 
03603 /**
03604  * Get the XlsPaper parameter string.
03605  *
03606  * @param   pDfvObj Pointer to DfvObj instance.
03607  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03608  *          the string is truncated and terminated with a NULL character.
03609  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03610  * @return  Returns the 'pVal'.
03611  */
03612 DFVINTERFACE_API char* dfv_getXlsPaper(CDfvObjPtr pDfvObj, char* pVal, int size);
03613 
03614 /**
03615  * Get the XlsPaper parameter string.
03616  *
03617  * @param   pDfvObj Pointer to DfvObj instance.
03618  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03619  *          the string is truncated and terminated with a NULL character.
03620  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03621  * @return  Returns the 'pVal'.
03622  */
03623 DFVINTERFACE_API wchar_t* dfv_getXlsPaperW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03624 
03625 /**
03626  * Set the XlsPaper parameter string.
03627  *
03628  * @param   pDfvObj Pointer to DfvObj instance.
03629  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03630  */
03631 DFVINTERFACE_API void dfv_setXlsPaper(CDfvObjPtr pDfvObj, const char* newVal);
03632 
03633 /**
03634  * Set the XlsPaper parameter string.
03635  *
03636  * @param   pDfvObj Pointer to DfvObj instance.
03637  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03638  */
03639 DFVINTERFACE_API void dfv_setXlsPaperW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03640 
03641 
03642 
03643 /**
03644  * Get whether Word outline level is reflected on PDF bookmark hierarchy.
03645  *
03646  * @param   pDfvObj Pointer to DfvObj instance.
03647  * @return  If 1-9, Generates a hierarchy and folds it at the hierarchy value.
03648  *          If 0, Does not generate a hierarchy.
03649  */
03650 DFVINTERFACE_API int dfv_getDocPdfBookmarkLevel(CDfvObjPtr pDfvObj);
03651 
03652 /**
03653  * Specifies whether Word outline level is reflected on PDF bookmark hierarchy.
03654  *
03655  * @param   pDfvObj Pointer to DfvObj instance.
03656  * @param   newVal  If 1-9, Generates a hierarchy and folds it at the hierarchy value.
03657  *                  If 0, Does not generate a hierarchy.
03658  */
03659 DFVINTERFACE_API void dfv_setDocPdfBookmarkLevel(CDfvObjPtr pDfvObj, int newVal);
03660 
03661 
03662 
03663 /**
03664  * Get specification to output only selected sheet when files are saved in MS Excel.
03665  */
03666 DFVINTERFACE_API int dfv_getXlsSelectedSheet(CDfvObjPtr pDfvObj);
03667     
03668 /**
03669  * Set to output only the selected sheet when files are saved in MS Excel.
03670  *
03671  * @param   pDfvObj Pointer to DfvObj instance.
03672  * @param   newVal  If the value is 'true' is specified, only the selected sheet is output when files are saved in MS Excel
03673  */
03674 DFVINTERFACE_API void dfv_setXlsSelectedSheet(CDfvObjPtr pDfvObj, int newVal);
03675 
03676 
03677 /**
03678  * Get whether to output Notes page in PowerPoint.
03679  *
03680  * @param   pDfvObj Pointer to DfvObj instance.
03681  * @return Return If true is returened, Notes page is output.
03682  *                If false is returned, Slide (normal layout) is output.
03683  */
03684 DFVINTERFACE_API int dfv_getPptNotes(CDfvObjPtr pDfvObj);
03685 
03686 /**
03687  * Specifies whether to output Notes page in PowerPoint.
03688  *
03689  * @param   pDfvObj Pointer to DfvObj instance.
03690  * @param newVal If true, Notes page is output.
03691  *               If false, Slide (normal layout) is output.
03692  */
03693 DFVINTERFACE_API void dfv_setPptNotes(CDfvObjPtr pDfvObj, int newVal);
03694 
03695 
03696 
03697 /**
03698  * Gets the output track change option in MS Word.
03699  *
03700  * @param   pDfvObj Pointer to DfvObj instance.
03701  * @return          
03702  * If true, output track change option in Word.
03703  */
03704 DFVINTERFACE_API int dfv_getDocTrackChange(CDfvObjPtr pDfvObj);
03705 
03706 /**
03707  * Set the setting of Support for correct number of pages in Word.
03708  *
03709  * @param   pDfvObj Pointer to DfvObj instance.
03710  * @param   newVal  
03711  * If true, sets support for output track change in Word.
03712  */
03713 DFVINTERFACE_API void dfv_setDocTrackChange(CDfvObjPtr pDfvObj, int newVal);
03714 
03715 
03716 /**
03717  * Gets the tagged-pdf output.
03718  *
03719  * @param   pDfvObj Pointer to DfvObj instance.
03720  * @return Return to this option.
03721  */
03722 DFVINTERFACE_API long dfv_getPdfTag(CDfvObjPtr pDfvObj);
03723 
03724 
03725 /**
03726  * Set the tagged-pdf output.
03727  *
03728  * @param   pDfvObj Pointer to DfvObj instance.
03729  * @param   newVal      If the value is 'true' is specified, Set to the output tagged-pdf.
03730  */
03731 DFVINTERFACE_API void dfv_setPdfTag(CDfvObjPtr pDfvObj, long newVal);
03732 
03733 /**
03734  * Get the linkfile output.
03735  *
03736  * @param   pDfvObj Pointer to DfvObj instance.
03737  * @return Return to this option.
03738  */
03739 DFVINTERFACE_API int dfv_getLinkfile(CDfvObjPtr pDfvObj);
03740 
03741 /**
03742  * Set the linkfile output.
03743  *
03744  * @param   pDfvObj Pointer to DfvObj instance.
03745  * @param newVal If the value is 'true' is specified, Set to the output linkfile.
03746  */
03747 DFVINTERFACE_API void dfv_setLinkfile(CDfvObjPtr pDfvObj, int newVal);
03748 
03749 
03750 
03751 /**
03752  * Get the property non-output.
03753  *
03754  * @param   pDfvObj Pointer to DfvObj instance.
03755  * @return Return If the value is 'true' is specified, Set to the non-output property.
03756  */
03757 DFVINTERFACE_API int dfv_getPropertyNonOutput(CDfvObjPtr pDfvObj);
03758 
03759 /**
03760  * Specifies whether to non-output property.
03761  *
03762  * @param   pDfvObj Pointer to DfvObj instance.
03763  * @param newVal If the value is 'true' is specified, Set to the non-output property.
03764  */
03765 DFVINTERFACE_API void dfv_setPropertyNonOutput(CDfvObjPtr pDfvObj, int newVal);
03766 
03767 /**
03768  * Get specification to output cell-area.
03769  *
03770  * @param   pDfvObj Pointer to DfvObj instance.
03771  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03772  *          the string is truncated and terminated with a NULL character.
03773  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03774  * @return  Returns the 'pVal'.
03775  */
03776 DFVINTERFACE_API char* dfv_getXlsOutputArea(CDfvObjPtr pDfvObj, char* pVal, int size);
03777 
03778 /**
03779  * Get the output cell-area parameter string.
03780  *
03781  * @param   pDfvObj Pointer to DfvObj instance.
03782  * @param   pVal        Pointer to the buffer that will receive the text. If the string is as long or longer than the buffer,
03783  *          the string is truncated and terminated with a NULL character.
03784  * @param   size        Specifies the number of the 'pVal' buffer, including the NULL character. If the text exceeds this limit, it is truncated.
03785  * @return  Returns the 'pVal'.
03786  */
03787 DFVINTERFACE_API wchar_t* dfv_getXlsOutputAreaW(CDfvObjPtr pDfvObj, wchar_t* pVal, int size);
03788 
03789 /**
03790  * Set the output cell-area parameter string.
03791  *
03792  * @param   pDfvObj Pointer to DfvObj instance.
03793  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03794  */
03795 DFVINTERFACE_API void dfv_setXlsOutputArea(CDfvObjPtr pDfvObj, const char* newVal);
03796 
03797 /**
03798  * Set the output cell-area parameter string.
03799  *
03800  * @param   pDfvObj Pointer to DfvObj instance.
03801  * @param   newVal  Pointer to a null-terminated string to be used as the parameter string.
03802  */
03803 DFVINTERFACE_API void dfv_setXlsOutputAreaW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03804 
03805 
03806 DFVINTERFACE_API void dfv_setOutputSVGFilePath(CDfvObjPtr pDfvObj, const char* newVal);
03807 DFVINTERFACE_API void dfv_setOutputSVGFilePathW(CDfvObjPtr pDfvObj, const wchar_t* newVal);
03808 
03809 
03810 
03811 /**
03812      * Gets the NonOutline option in MS Word.
03813  *
03814  * @param   pDfvObj Pointer to DfvObj instance.
03815  * @return          
03816  * If true, Do not convert outlines to bookmarks. in Word.
03817  */
03818 DFVINTERFACE_API int dfv_getDocNonOutline(CDfvObjPtr pDfvObj);
03819 
03820 /**
03821      * Set the NonOutline option.
03822  *
03823  * @param   pDfvObj Pointer to DfvObj instance.
03824  * @param   newVal  
03825  * If true, sets support for Do not convert outlines to bookmarks. in Word
03826  */
03827 DFVINTERFACE_API void dfv_setDocNonOutline(CDfvObjPtr pDfvObj, int newVal);
03828 
03829 
03830 
03831 /**
03832  * Gets the IndexHyperLink option in MS Word.
03833  *
03834  * @return Return to this option.
03835  */
03836 DFVINTERFACE_API int dfv_getIndexHyperLink(CDfvObjPtr pDfvObj);
03837 
03838 /**
03839  * Set the IndexHyperLink option in MS Word.<BR>
03840  * Page number of the index page is hyperlinked to the term marked as index entries in the body
03841  *
03842  * @param   newVal  0, Does not generate a Index Hyperlink.
03843  *                  1, Link to the index terms from the first page to the index page.
03844  *                  2, Link to the index terms on pages after the index page too (processing time will be doubled).
03845  */
03846 DFVINTERFACE_API void dfv_setIndexHyperLink(CDfvObjPtr pDfvObj, int newVal);
03847 
03848 
03849     /**
03850      * Gets specification whether to use Direct2d .<BR>
03851      * Effective only when outputting to image with Windows version
03852      *
03853      * @param   pDfvObj Pointer to DfvObj instance.
03854      * @return          Specification whether to use Direct2d.
03855      */
03856 DFVINTERFACE_API int dfv_getRasterUseDirect2d(CDfvObjPtr pDfvObj);
03857 
03858     /**
03859      * Direct2d is used when the file is converted to Raster image.<BR>
03860      * This setting is effective only with Windows Vista or later / Windows Server 2003.
03861      * Effective only when outputting to image with Windows version
03862      *
03863      * @param   pDfvObj Pointer to DfvObj instance.
03864      * @param newVal Specifies whether to use Direct2d.
03865      */
03866 DFVINTERFACE_API void dfv_setRasterUseDirect2d(CDfvObjPtr pDfvObj,int newVal);
03867 
03868 
03869 #ifdef __cplusplus
03870 }
03871 #endif  /* __cplusplus */
03872 
03873 #endif  /* DFVIFC_C_H__ */

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