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

Generated on 3 Apr 2024 for Office Server Document Converter C/C++ Interface by Doxygen 1.3-rc2