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