diff options
author | Tom Sepez <tsepez@chromium.org> | 2015-01-28 15:55:04 -0800 |
---|---|---|
committer | Tom Sepez <tsepez@chromium.org> | 2015-01-28 15:55:04 -0800 |
commit | 90f9e6180384672db231e52c417c55c6f8a5872a (patch) | |
tree | 20fcaa0123892800eeae7ae8baa86456645a49ff /fpdfsdk/include | |
parent | 506e6dc4649803ab56ef60d73d9a896f1876a7e6 (diff) | |
download | pdfium-90f9e6180384672db231e52c417c55c6f8a5872a.tar.xz |
Merge to Master: Cover fpdftext.h API with embeddertests.
Original Review URL: https://codereview.chromium.org/878333003
TBR=thestig@chromium.org
Review URL: https://codereview.chromium.org/884873002
Diffstat (limited to 'fpdfsdk/include')
-rw-r--r-- | fpdfsdk/include/fpdftext.h | 38 |
1 files changed, 21 insertions, 17 deletions
diff --git a/fpdfsdk/include/fpdftext.h b/fpdfsdk/include/fpdftext.h index 8b897798e6..d37715f6b8 100644 --- a/fpdfsdk/include/fpdftext.h +++ b/fpdfsdk/include/fpdftext.h @@ -16,32 +16,31 @@ extern "C" { // Function: FPDFText_LoadPage // Prepare information about all characters in a page. -// Parameters: -// page - Handle to the page. Returned by FPDF_LoadPage function (in FPDFVIEW module). +// Parameters: +// page - Handle to the page. Returned by FPDF_LoadPage function (in FPDFVIEW module). // Return value: // A handle to the text page information structure. // NULL if something goes wrong. // Comments: // Application must call FPDFText_ClosePage to release the text page information. -// If you don't purchase Text Module , this function will return NULL. -// +// DLLEXPORT FPDF_TEXTPAGE STDCALL FPDFText_LoadPage(FPDF_PAGE page); // Function: FPDFText_ClosePage // Release all resources allocated for a text page information structure. -// Parameters: +// Parameters: // text_page - Handle to a text page information structure. Returned by FPDFText_LoadPage function. // Return Value: // None. // DLLEXPORT void STDCALL FPDFText_ClosePage(FPDF_TEXTPAGE text_page); - + // Function: FPDFText_CountChars // Get number of characters in a page. -// Parameters: +// Parameters: // text_page - Handle to a text page information structure. Returned by FPDFText_LoadPage function. // Return value: -// Number of characters in the page. Return -1 for error. +// Number of characters in the page. Return -1 for error. // Generated characters, like additional space characters, new line characters, are also counted. // Comments: // Characters in a page form a "stream", inside the stream, each character has an index. @@ -52,7 +51,7 @@ DLLEXPORT int STDCALL FPDFText_CountChars(FPDF_TEXTPAGE text_page); // Function: FPDFText_GetUnicode // Get Unicode of a character in a page. -// Parameters: +// Parameters: // text_page - Handle to a text page information structure. Returned by FPDFText_LoadPage function. // index - Zero-based index of the character. // Return value: @@ -64,7 +63,7 @@ DLLEXPORT unsigned int STDCALL FPDFText_GetUnicode(FPDF_TEXTPAGE text_page, int // Function: FPDFText_GetFontSize // Get the font size of a particular character. -// Parameters: +// Parameters: // text_page - Handle to a text page information structure. Returned by FPDFText_LoadPage function. // index - Zero-based index of the character. // Return value: @@ -75,7 +74,7 @@ DLLEXPORT double STDCALL FPDFText_GetFontSize(FPDF_TEXTPAGE text_page, int index // Function: FPDFText_GetCharBox // Get bounding box of a particular character. -// Parameters: +// Parameters: // text_page - Handle to a text page information structure. Returned by FPDFText_LoadPage function. // index - Zero-based index of the character. // left - Pointer to a double number receiving left position of the character box. @@ -118,7 +117,7 @@ DLLEXPORT int STDCALL FPDFText_GetCharIndexAtPos(FPDF_TEXTPAGE text_page, // Number of characters written into the result buffer, including the trailing terminator. // Comments: // This function ignores characters without unicode information. -// +// DLLEXPORT int STDCALL FPDFText_GetText(FPDF_TEXTPAGE text_page, int start_index, int count, unsigned short* result); // Function: FPDFText_CountRects @@ -163,10 +162,15 @@ DLLEXPORT void STDCALL FPDFText_GetRect(FPDF_TEXTPAGE text_page, int rect_index, // buffer - A unicode buffer. // buflen - Number of characters (not bytes) for the buffer, excluding an additional terminator. // Return Value: -// If buffer is NULL or buflen is zero, return number of characters (not bytes) needed, -// otherwise, return number of characters copied into the buffer. +// If buffer is NULL or buflen is zero, return number of characters (not bytes) of text present within +// the rectangle, excluding a terminating NUL. Generally you should pass a buffer at least one larger +// than this if you want a terminating NUL, which will be provided if space is available. +// Otherwise, return number of characters copied into the buffer, including the terminating NUL +// when space for it is available. +// Comment: +// If the buffer is too small, as much text as will fit is copied into it. // -DLLEXPORT int STDCALL FPDFText_GetBoundedText(FPDF_TEXTPAGE text_page,double left, double top, +DLLEXPORT int STDCALL FPDFText_GetBoundedText(FPDF_TEXTPAGE text_page,double left, double top, double right, double bottom,unsigned short* buffer,int buflen); @@ -236,7 +240,7 @@ DLLEXPORT void STDCALL FPDFText_FindClose(FPDF_SCHHANDLE handle); // Prepare information about weblinks in a page. // Parameters: // text_page - Handle to a text page information structure. Returned by FPDFText_LoadPage function. -// Return Value: +// Return Value: // A handle to the page's links information structure. // NULL if something goes wrong. // Comments: @@ -296,7 +300,7 @@ DLLEXPORT int STDCALL FPDFLink_CountRects(FPDF_PAGELINK link_page, int link_inde // Return Value: // None. // -DLLEXPORT void STDCALL FPDFLink_GetRect(FPDF_PAGELINK link_page, int link_index, int rect_index, +DLLEXPORT void STDCALL FPDFLink_GetRect(FPDF_PAGELINK link_page, int link_index, int rect_index, double* left, double* top,double* right, double* bottom); // Function: FPDFLink_CloseWebLinks |