Index: fpdfsdk/include/fpdf_dataavail.h |
diff --git a/fpdfsdk/include/fpdf_dataavail.h b/fpdfsdk/include/fpdf_dataavail.h |
index 971ab2505c8b325ae1166cf5d7873bca52a20df6..64047468e82f6d53e90baacdbb9686c56876099b 100644 |
--- a/fpdfsdk/include/fpdf_dataavail.h |
+++ b/fpdfsdk/include/fpdf_dataavail.h |
@@ -1,7 +1,7 @@ |
// Copyright 2014 PDFium Authors. All rights reserved. |
// Use of this source code is governed by a BSD-style license that can be |
// found in the LICENSE file. |
- |
+ |
// Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com |
#ifndef _FPDF_DATAAVAIL_H_ |
@@ -11,12 +11,10 @@ |
#include "fpdfview.h" |
#endif |
- |
/** The result of the process which check linearized PDF. */ |
-#define FSDK_IS_LINEARIZED 1 |
-#define FSDK_NOT_LINEARIZED 0 |
-#define FSDK_UNKNOW_LINEARIZED -1 |
- |
+#define FSDK_IS_LINEARIZED 1 |
+#define FSDK_NOT_LINEARIZED 0 |
+#define FSDK_UNKNOW_LINEARIZED -1 |
#ifdef __cplusplus |
extern "C" { |
@@ -24,31 +22,35 @@ extern "C" { |
/** |
* Interface: FX_FILEAVAIL |
- * Interface for checking whether the section of the file is available. |
+ * Interface for checking whether the section of the file is |
+ *available. |
*/ |
typedef struct _FX_FILEAVAIL { |
- /** |
- * Version number of the interface. Currently must be 1. |
- */ |
- int version; |
- |
- /** |
- * Method: IsDataAvail |
- * Report whether the specified data section is available. A section is available only if all bytes in the section is available. |
- * Interface Version: |
- * 1 |
- * Implementation Required: |
- * Yes |
- * Parameters: |
- * pThis - Pointer to the interface structure itself. |
- * offset - The offset of the data section in the file. |
- * size - The size of the data section |
- * Return Value: |
- * true means the specified data section is available. |
- * Comments: |
- * Called by Foxit SDK to check whether the data section is ready. |
- */ |
- bool (*IsDataAvail)(struct _FX_FILEAVAIL* pThis, size_t offset, size_t size); |
+ /** |
+ * Version number of the interface. Currently must be 1. |
+ */ |
+ int version; |
+ |
+ /** |
+ * Method: IsDataAvail |
+ * Report whether the specified data section is available. A section is |
+ *available only if all bytes in the section is available. |
+ * Interface Version: |
+ * 1 |
+ * Implementation Required: |
+ * Yes |
+ * Parameters: |
+ * pThis - Pointer to the interface structure |
+ *itself. |
+ * offset - The offset of the data section in the |
+ *file. |
+ * size - The size of the data section |
+ * Return Value: |
+ * true means the specified data section is available. |
+ * Comments: |
+ * Called by Foxit SDK to check whether the data section is ready. |
+ */ |
+ bool (*IsDataAvail)(struct _FX_FILEAVAIL* pThis, size_t offset, size_t size); |
} FX_FILEAVAIL; |
typedef void* FPDF_AVAIL; |
@@ -57,22 +59,28 @@ typedef void* FPDF_AVAIL; |
* Function: FPDFAvail_Create |
* Create a document availability provider. |
* |
-* Parameters: |
-* file_avail - Pointer to file availability interface to check availability of file data. |
-* file - Pointer to a file access interface for reading data from file. |
+* Parameters: |
+* file_avail - Pointer to file availability |
+*interface to check availability of file data. |
+* file - Pointer to a file access |
+*interface for reading data from file. |
* Return value: |
-* A handle to the document availability provider. NULL for error. |
+* A handle to the document availability provider. NULL for |
+*error. |
* Comments: |
-* Application must call FPDFAvail_Destroy when done with the availability provider. |
+* Application must call FPDFAvail_Destroy when done with the |
+*availability provider. |
*/ |
-DLLEXPORT FPDF_AVAIL STDCALL FPDFAvail_Create(FX_FILEAVAIL* file_avail, FPDF_FILEACCESS* file); |
+DLLEXPORT FPDF_AVAIL STDCALL |
+ FPDFAvail_Create(FX_FILEAVAIL* file_avail, FPDF_FILEACCESS* file); |
/** |
* Function: FPDFAvail_Destroy |
* Destroy a document availibity provider. |
* |
-* Parameters: |
-* avail - Handle to document availability provider returned by FPDFAvail_Create |
+* Parameters: |
+* avail - Handle to document availability |
+*provider returned by FPDFAvail_Create |
* Return Value: |
* None. |
*/ |
@@ -80,135 +88,184 @@ DLLEXPORT void STDCALL FPDFAvail_Destroy(FPDF_AVAIL avail); |
/** |
* Interface: FX_DOWNLOADHINTS |
- * Download hints interface. Used to receive hints for further downloading. |
+ * Download hints interface. Used to receive hints for further |
+ *downloading. |
*/ |
typedef struct _FX_DOWNLOADHINTS { |
- /** |
- * Version number of the interface. Currently must be 1. |
- */ |
- int version; |
- |
- /** |
- * Method: AddSegment |
- * Add a section to be downloaded. |
- * Interface Version: |
- * 1 |
- * Implementation Required: |
- * Yes |
- * Parameters: |
- * pThis - Pointer to the interface structure itself. |
- * offset - The offset of the hint reported to be downloaded. |
- * size - The size of the hint reported to be downloaded. |
- * Return Value: |
- * None. |
- * Comments: |
- * Called by Foxit SDK to report some downloading hints for download manager. |
- * The position and size of section may be not accurate, part of the section might be already available. |
- * The download manager must deal with that to maximize download efficiency. |
- */ |
- void (*AddSegment)(struct _FX_DOWNLOADHINTS* pThis, size_t offset, size_t size); |
+ /** |
+ * Version number of the interface. Currently must be 1. |
+ */ |
+ int version; |
+ |
+ /** |
+ * Method: AddSegment |
+ * Add a section to be downloaded. |
+ * Interface Version: |
+ * 1 |
+ * Implementation Required: |
+ * Yes |
+ * Parameters: |
+ * pThis - Pointer to the interface structure |
+ *itself. |
+ * offset - The offset of the hint reported to be |
+ *downloaded. |
+ * size - The size of the hint reported to be |
+ *downloaded. |
+ * Return Value: |
+ * None. |
+ * Comments: |
+ * Called by Foxit SDK to report some downloading hints for download |
+ *manager. |
+ * The position and size of section may be not accurate, part of the |
+ *section might be already available. |
+ * The download manager must deal with that to maximize download |
+ *efficiency. |
+ */ |
+ void (*AddSegment)(struct _FX_DOWNLOADHINTS* pThis, |
+ size_t offset, |
+ size_t size); |
} FX_DOWNLOADHINTS; |
/** |
* Function: FPDFAvail_IsDocAvail |
-* Check whether the document is ready for loading, if not, get download hints. |
+* Check whether the document is ready for loading, if not, |
+*get download hints. |
* |
-* Parameters: |
-* avail - Handle to document availability provider returned by FPDFAvail_Create |
-* hints - Pointer to a download hints interface, receiving generated hints |
+* Parameters: |
+* avail - Handle to document availability |
+*provider returned by FPDFAvail_Create |
+* hints - Pointer to a download hints |
+*interface, receiving generated hints |
* Return value: |
-* Non-zero for page is fully available, 0 for page not yet available. |
+* Non-zero for page is fully available, 0 for page not yet |
+*available. |
* Comments: |
-* The application should call this function whenever new data arrived, and process all the |
-* generated download hints if any, until the function returns non-zero value. Then the |
-* application can call FPDFAvail_GetDocument() to get a document handle. |
+* The application should call this function whenever new |
+*data arrived, and process all the |
+* generated download hints if any, until the function |
+*returns non-zero value. Then the |
+* application can call FPDFAvail_GetDocument() to get a |
+*document handle. |
*/ |
-DLLEXPORT int STDCALL FPDFAvail_IsDocAvail(FPDF_AVAIL avail, FX_DOWNLOADHINTS* hints); |
+DLLEXPORT int STDCALL |
+ FPDFAvail_IsDocAvail(FPDF_AVAIL avail, FX_DOWNLOADHINTS* hints); |
/** |
* Function: FPDFAvail_GetDocument |
* Get document from the availability provider. |
* |
* Parameters: |
-* avail - Handle to document availability provider returned by FPDFAvail_Create |
+* avail - Handle to document availability |
+*provider returned by FPDFAvail_Create |
* password - Optional password for decrypting the PDF file. |
* Return value: |
* Handle to the document. |
* Comments: |
-* After FPDFAvail_IsDocAvail() returns TRUE, the application should call this function to |
-* get the document handle. To close the document, use FPDF_CloseDocument function. |
+* After FPDFAvail_IsDocAvail() returns TRUE, the application |
+*should call this function to |
+* get the document handle. To close the document, use |
+*FPDF_CloseDocument function. |
*/ |
-DLLEXPORT FPDF_DOCUMENT STDCALL FPDFAvail_GetDocument(FPDF_AVAIL avail, |
- FPDF_BYTESTRING password); |
+DLLEXPORT FPDF_DOCUMENT STDCALL |
+ FPDFAvail_GetDocument(FPDF_AVAIL avail, FPDF_BYTESTRING password); |
/** |
* Function: FPDFAvail_GetFirstPageNum |
-* Get page number for the first available page in a linearized PDF |
+* Get page number for the first available page in a |
+*linearized PDF |
* |
* Parameters: |
-* doc - A document handle returned by FPDFAvail_GetDocument |
+* doc - A document handle returned |
+*by FPDFAvail_GetDocument |
* Return Value: |
* Zero-based index for the first available page. |
* Comments: |
-* For most linearized PDFs, the first available page would be just the first page, however, |
-* some PDFs might make other page to be the first available page. |
-* For non-linearized PDF, this function will always return zero. |
+* For most linearized PDFs, the first available page would |
+*be just the first page, however, |
+* some PDFs might make other page to be the first available |
+*page. |
+* For non-linearized PDF, this function will always return |
+*zero. |
*/ |
DLLEXPORT int STDCALL FPDFAvail_GetFirstPageNum(FPDF_DOCUMENT doc); |
/** |
* Function: FPDFAvail_IsPageAvail |
-* Check whether a page is ready for loading, if not, get download hints. |
+* Check whether a page is ready for loading, if not, get |
+*download hints. |
* |
-* Parameters: |
-* avail - Handle to document availability provider returned by FPDFAvail_Create |
-* page_index - Index number of the page. 0 for the first page. |
-* hints - Pointer to a download hints interface, receiving generated hints |
+* Parameters: |
+* avail - Handle to document availability |
+*provider returned by FPDFAvail_Create |
+* page_index - Index number of the page. 0 for |
+*the first page. |
+* hints - Pointer to a download hints |
+*interface, receiving generated hints |
* Return value: |
-* Non-zero for page is fully available, 0 for page not yet available. |
+* Non-zero for page is fully available, 0 for page not yet |
+*available. |
* Comments: |
-* This function call be called only after FPDFAvail_GetDocument if called. |
-* The application should call this function whenever new data arrived, and process all the |
-* generated download hints if any, until the function returns non-zero value. Then the |
+* This function call be called only after |
+*FPDFAvail_GetDocument if called. |
+* The application should call this function whenever new |
+*data arrived, and process all the |
+* generated download hints if any, until the function |
+*returns non-zero value. Then the |
* application can perform page loading. |
*/ |
-DLLEXPORT int STDCALL FPDFAvail_IsPageAvail(FPDF_AVAIL avail, int page_index, FX_DOWNLOADHINTS* hints); |
+DLLEXPORT int STDCALL FPDFAvail_IsPageAvail(FPDF_AVAIL avail, |
+ int page_index, |
+ FX_DOWNLOADHINTS* hints); |
/** |
* Function: FPDFAvail_ISFormAvail |
-* Check whether Form data is ready for init, if not, get download hints. |
+* Check whether Form data is ready for init, if not, get |
+*download hints. |
* |
-* Parameters: |
-* avail - Handle to document availability provider returned by FPDFAvail_Create |
-* hints - Pointer to a download hints interface, receiving generated hints |
+* Parameters: |
+* avail - Handle to document availability |
+*provider returned by FPDFAvail_Create |
+* hints - Pointer to a download hints |
+*interface, receiving generated hints |
* Return value: |
-* Non-zero for Form data is fully available, 0 for Form data not yet available. |
-* Details: -1 - error, the input parameter not correct, such as hints is null. |
+* Non-zero for Form data is fully available, 0 for Form data |
+*not yet available. |
+* Details: -1 - error, the input parameter not correct, such |
+*as hints is null. |
* 0 - data not available |
* 1 - data available |
-* 2 - no form data. |
+* 2 - no form data. |
* Comments: |
-* This function call be called only after FPDFAvail_GetDocument if called. |
-* The application should call this function whenever new data arrived, and process all the |
-* generated download hints if any, until the function returns non-zero value. Then the |
-* application can perform page loading. Recommend to call FPDFDOC_InitFormFillEnviroument |
+* This function call be called only after |
+*FPDFAvail_GetDocument if called. |
+* The application should call this function whenever new |
+*data arrived, and process all the |
+* generated download hints if any, until the function |
+*returns non-zero value. Then the |
+* application can perform page loading. Recommend to call |
+*FPDFDOC_InitFormFillEnviroument |
* after the function returns non-zero value. |
*/ |
-DLLEXPORT int STDCALL FPDFAvail_IsFormAvail(FPDF_AVAIL avail, FX_DOWNLOADHINTS* hints); |
+DLLEXPORT int STDCALL |
+ FPDFAvail_IsFormAvail(FPDF_AVAIL avail, FX_DOWNLOADHINTS* hints); |
/** |
* Function: FPDFAvail_IsLinearized |
* To check whether a document is Linearized PDF file. |
* |
* Parameters: |
-* avail - Handle to document availability provider returned by FPDFAvail_Create |
+* avail - Handle to document availability |
+*provider returned by FPDFAvail_Create |
* Return value: |
-* return TRUE means the document is linearized PDF else not. |
+* return TRUE means the document is linearized PDF else |
+*not. |
* FSDK_IS_LINEARIZED is a linearize file. |
* FSDK_NOT_LINEARIZED is not a linearize file. |
-* FSDK_UNKNOW_LINEARIZED don't know whether the file is a linearize file. |
+* FSDK_UNKNOW_LINEARIZED don't know whether the file is a |
+*linearize file. |
* Comments: |
-* It return TRUE/FALSE as soon as we have first 1K data. If the file's size less than |
+* It return TRUE/FALSE as soon as we have first 1K data. |
+*If the file's size less than |
* 1K,we don't known whether the PDF is a linearized file. |
* |
*/ |
@@ -219,4 +276,3 @@ DLLEXPORT FPDF_BOOL STDCALL FPDFAvail_IsLinearized(FPDF_AVAIL avail); |
#endif |
#endif |
- |