Index: pdf/pdf_engine.h |
diff --git a/pdf/pdf_engine.h b/pdf/pdf_engine.h |
index ee1cb1ff000341f1f0569dc1d617de11ee1260f5..17c9210aab11b8e2dc20775912ab13a4dbf72a9c 100644 |
--- a/pdf/pdf_engine.h |
+++ b/pdf/pdf_engine.h |
@@ -295,23 +295,75 @@ class PDFEngineExports { |
virtual ~PDFEngineExports() {} |
static PDFEngineExports* Create(); |
#if defined(OS_WIN) |
- // See the definition of RenderPDFPageToDC in pdf.cc for details. |
+ // |pdf_buffer| is the buffer that contains the entire PDF document to be |
+ // rendered. |
+ // |buffer_size| is the size of |pdf_buffer| in bytes. |
+ // |page_number| is the 0-based index of the page to be rendered. |
+ // |dc| is the device context to render into. |
Dan Beam
2014/07/09 23:18:24
remove from here down:
|
+ // |dpi_x| and |dpi_y| are the x and y resolutions respectively. If either |
+ // value is -1, the dpi from the DC will be used. |
+ // |bounds_origin_x|, |bounds_origin_y|, |bounds_width| and |bounds_height| |
+ // specify a bounds rectangle within the DC in which to render the PDF |
+ // page. |
+ // |fit_to_bounds| specifies whether the output should be shrunk to fit the |
+ // supplied bounds if the page size is larger than the bounds in any |
+ // dimension. If this is false, parts of the PDF page that lie outside |
+ // the bounds will be clipped. |
+ // |stretch_to_bounds| specifies whether the output should be stretched to fit |
+ // the supplied bounds if the page size is smaller than the bounds in any |
+ // dimension. |
+ // If both |fit_to_bounds| and |stretch_to_bounds| are true, then |
+ // |fit_to_bounds| is honored first. |
+ // |keep_aspect_ratio| If any scaling is to be done is true, this flag |
+ // specifies whether the original aspect ratio of the page should be |
+ // preserved while scaling. |
+ // |center_in_bounds| specifies whether the final image (after any scaling is |
+ // done) should be centered within the given bounds. |
+ // |autorotate| specifies whether the final image should be rotated to match |
+ // the output bound. |
Dan Beam
2014/07/09 23:18:23
^ to here
|
+ // Returns false if the document or the page number are not valid. |
virtual bool RenderPDFPageToDC(const void* pdf_buffer, |
int buffer_size, |
int page_number, |
const RenderingSettings& settings, |
HDC dc) = 0; |
#endif // OS_WIN |
Dan Beam
2014/07/09 23:18:24
nit: \n
|
- // See the definition of RenderPDFPageToBitmap in pdf.cc for details. |
+ // Renders PDF page into 4-byte per pixel BGRA color bitmap. |
+ // |pdf_buffer| is the buffer that contains the entire PDF document to be |
+ // rendered. |
+ // |pdf_buffer_size| is the size of |pdf_buffer| in bytes. |
+ // |page_number| is the 0-based index of the page to be rendered. |
+ // |bitmap_buffer| is the output buffer for bitmap. |
+ // |bitmap_width| is the width of the output bitmap. |
Dan Beam
2014/07/09 23:18:24
I don't see |bitmap_width|, |bitmap_height|, |dpi|
|
+ // |bitmap_height| is the height of the output bitmap. |
+ // |dpi| is the resolutions. |
+ // |autorotate| specifies whether the final image should be rotated to match |
+ // the output bound. |
+ // Returns false if the document or the page number are not valid. |
virtual bool RenderPDFPageToBitmap(const void* pdf_buffer, |
int pdf_buffer_size, |
int page_number, |
const RenderingSettings& settings, |
void* bitmap_buffer) = 0; |
Dan Beam
2014/07/09 23:18:23
nit: \n
|
+ // |page_count| and |max_page_width| are optional and can be NULL. |
+ // Returns false if the document is not valid. |
virtual bool GetPDFDocInfo(const void* pdf_buffer, |
int buffer_size, |
int* page_count, |
double* max_page_width) = 0; |
+ |
+ // Gets the dimensions of a specific page in a document. |
+ // |pdf_buffer| is the buffer that contains the entire PDF document to be |
+ // rendered. |
+ // |pdf_buffer_size| is the size of |pdf_buffer| in bytes. |
+ // |page_number| is the page number that the function will get the dimensions |
+ // of. |
+ // |width| is the output for the width of the page in points. |
+ // |height| is the output for the height of the page in points. |
+ // Returns false if the document or the page number are not valid. |
+ virtual bool GetPDFPageSizeByIndex(const void* pdf_buffer, |
+ int pdf_buffer_size, int page_number, |
+ double* width, double* height) = 0; |
}; |
} // namespace chrome_pdf |