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