Revert of Revert of linux/gyp: Find missing symbols at build time, not runtime. ...
[chromium-blink-merge.git] / pdf / pdf_engine.h
bloba9f828e53c36ef158476a3460949b304fe4122c0
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef PDF_PDF_ENGINE_H_
6 #define PDF_PDF_ENGINE_H_
8 #include "build/build_config.h"
10 #if defined(OS_WIN)
11 #include <windows.h>
12 #endif
14 #include <string>
15 #include <vector>
17 #include "base/strings/string16.h"
19 #include "ppapi/c/dev/pp_cursor_type_dev.h"
20 #include "ppapi/c/dev/ppp_printing_dev.h"
21 #include "ppapi/c/ppb_input_event.h"
22 #include "ppapi/cpp/completion_callback.h"
23 #include "ppapi/cpp/image_data.h"
24 #include "ppapi/cpp/rect.h"
25 #include "ppapi/cpp/size.h"
26 #include "ppapi/cpp/url_loader.h"
27 #include "ppapi/cpp/var_array.h"
29 namespace pp {
30 class InputEvent;
33 const uint32 kBackgroundColor = 0xFFCCCCCC;
35 namespace chrome_pdf {
37 class Stream;
39 #if defined(OS_MACOSX)
40 const uint32 kDefaultKeyModifier = PP_INPUTEVENT_MODIFIER_METAKEY;
41 #else // !OS_MACOSX
42 const uint32 kDefaultKeyModifier = PP_INPUTEVENT_MODIFIER_CONTROLKEY;
43 #endif // OS_MACOSX
45 // Do one time initialization of the SDK.
46 bool InitializeSDK();
47 // Tells the SDK that we're shutting down.
48 void ShutdownSDK();
50 // This class encapsulates a PDF rendering engine.
51 class PDFEngine {
52 public:
54 enum DocumentPermission {
55 PERMISSION_COPY,
56 PERMISSION_COPY_ACCESSIBLE,
57 PERMISSION_PRINT_LOW_QUALITY,
58 PERMISSION_PRINT_HIGH_QUALITY,
61 // The interface that's provided to the rendering engine.
62 class Client {
63 public:
64 // Informs the client about the document's size in pixels.
65 virtual void DocumentSizeUpdated(const pp::Size& size) = 0;
67 // Informs the client that the given rect needs to be repainted.
68 virtual void Invalidate(const pp::Rect& rect) = 0;
70 // Informs the client to scroll the plugin area by the given offset.
71 virtual void Scroll(const pp::Point& point) = 0;
73 // Scroll the horizontal/vertical scrollbars to a given position.
74 virtual void ScrollToX(int position) = 0;
75 virtual void ScrollToY(int position) = 0;
77 // Scroll to the specified page.
78 virtual void ScrollToPage(int page) = 0;
80 // Navigate to the given url.
81 virtual void NavigateTo(const std::string& url, bool open_in_new_tab) = 0;
83 // Updates the cursor.
84 virtual void UpdateCursor(PP_CursorType_Dev cursor) = 0;
86 // Updates the tick marks in the vertical scrollbar.
87 virtual void UpdateTickMarks(const std::vector<pp::Rect>& tickmarks) = 0;
89 // Updates the number of find results for the current search term. If
90 // there are no matches 0 should be passed in. Only when the plugin has
91 // finished searching should it pass in the final count with final_result
92 // set to true.
93 virtual void NotifyNumberOfFindResultsChanged(int total,
94 bool final_result) = 0;
96 // Updates the index of the currently selected search item.
97 virtual void NotifySelectedFindResultChanged(int current_find_index) = 0;
99 // Prompts the user for a password to open this document. The callback is
100 // called when the password is retrieved.
101 virtual void GetDocumentPassword(
102 pp::CompletionCallbackWithOutput<pp::Var> callback) = 0;
104 // Puts up an alert with the given message.
105 virtual void Alert(const std::string& message) = 0;
107 // Puts up a confirm with the given message, and returns true if the user
108 // presses OK, or false if they press cancel.
109 virtual bool Confirm(const std::string& message) = 0;
111 // Puts up a prompt with the given message and default answer and returns
112 // the answer.
113 virtual std::string Prompt(const std::string& question,
114 const std::string& default_answer) = 0;
116 // Returns the url of the pdf.
117 virtual std::string GetURL() = 0;
119 // Send an email.
120 virtual void Email(const std::string& to,
121 const std::string& cc,
122 const std::string& bcc,
123 const std::string& subject,
124 const std::string& body) = 0;
126 // Put up the print dialog.
127 virtual void Print() = 0;
129 // Submit the data using HTTP POST.
130 virtual void SubmitForm(const std::string& url,
131 const void* data,
132 int length) = 0;
134 // Pops up a file selection dialog and returns the result.
135 virtual std::string ShowFileSelectionDialog() = 0;
137 // Creates and returns new URL loader for partial document requests.
138 virtual pp::URLLoader CreateURLLoader() = 0;
140 // Calls the client's OnCallback() function in delay_in_ms with the given
141 // id.
142 virtual void ScheduleCallback(int id, int delay_in_ms) = 0;
144 // Searches the given string for "term" and returns the results. Unicode-
145 // aware.
146 struct SearchStringResult {
147 int start_index;
148 int length;
150 virtual void SearchString(const base::char16* string,
151 const base::char16* term,
152 bool case_sensitive,
153 std::vector<SearchStringResult>* results) = 0;
155 // Notifies the client that the engine has painted a page from the document.
156 virtual void DocumentPaintOccurred() = 0;
158 // Notifies the client that the document has finished loading.
159 virtual void DocumentLoadComplete(int page_count) = 0;
161 // Notifies the client that the document has failed to load.
162 virtual void DocumentLoadFailed() = 0;
164 virtual pp::Instance* GetPluginInstance() = 0;
166 // Notifies that an unsupported feature in the PDF was encountered.
167 virtual void DocumentHasUnsupportedFeature(const std::string& feature) = 0;
169 // Notifies the client about document load progress.
170 virtual void DocumentLoadProgress(uint32 available, uint32 doc_size) = 0;
172 // Notifies the client about focus changes for form text fields.
173 virtual void FormTextFieldFocusChange(bool in_focus) = 0;
175 // Returns true if the plugin has been opened within print preview.
176 virtual bool IsPrintPreview() = 0;
179 // Factory method to create an instance of the PDF Engine.
180 static PDFEngine* Create(Client* client);
182 virtual ~PDFEngine() {}
183 // Most of these functions are similar to the Pepper functions of the same
184 // name, so not repeating the description here unless it's different.
185 virtual bool New(const char* url) = 0;
186 virtual bool New(const char* url,
187 const char* headers) = 0;
188 virtual void PageOffsetUpdated(const pp::Point& page_offset) = 0;
189 virtual void PluginSizeUpdated(const pp::Size& size) = 0;
190 virtual void ScrolledToXPosition(int position) = 0;
191 virtual void ScrolledToYPosition(int position) = 0;
192 // Paint is called a series of times. Before these n calls are made, PrePaint
193 // is called once. After Paint is called n times, PostPaint is called once.
194 virtual void PrePaint() = 0;
195 virtual void Paint(const pp::Rect& rect,
196 pp::ImageData* image_data,
197 std::vector<pp::Rect>* ready,
198 std::vector<pp::Rect>* pending) = 0;
199 virtual void PostPaint() = 0;
200 virtual bool HandleDocumentLoad(const pp::URLLoader& loader) = 0;
201 virtual bool HandleEvent(const pp::InputEvent& event) = 0;
202 virtual uint32_t QuerySupportedPrintOutputFormats() = 0;
203 virtual void PrintBegin() = 0;
204 virtual pp::Resource PrintPages(
205 const PP_PrintPageNumberRange_Dev* page_ranges,
206 uint32_t page_range_count,
207 const PP_PrintSettings_Dev& print_settings) = 0;
208 virtual void PrintEnd() = 0;
209 virtual void StartFind(const char* text, bool case_sensitive) = 0;
210 virtual bool SelectFindResult(bool forward) = 0;
211 virtual void StopFind() = 0;
212 virtual void ZoomUpdated(double new_zoom_level) = 0;
213 virtual void RotateClockwise() = 0;
214 virtual void RotateCounterclockwise() = 0;
215 virtual std::string GetSelectedText() = 0;
216 virtual std::string GetLinkAtPosition(const pp::Point& point) = 0;
217 virtual bool IsSelecting() = 0;
218 // Checks the permissions associated with this document.
219 virtual bool HasPermission(DocumentPermission permission) const = 0;
220 virtual void SelectAll() = 0;
221 // Gets the number of pages in the document.
222 virtual int GetNumberOfPages() = 0;
223 // Gets the 0-based page number of |destination|, or -1 if it does not exist.
224 virtual int GetNamedDestinationPage(const std::string& destination) = 0;
225 // Gets the index of the first visible page, or -1 if none are visible.
226 virtual int GetFirstVisiblePage() = 0;
227 // Gets the index of the most visible page, or -1 if none are visible.
228 virtual int GetMostVisiblePage() = 0;
229 // Gets the rectangle of the page including shadow.
230 virtual pp::Rect GetPageRect(int index) = 0;
231 // Gets the rectangle of the page excluding any additional areas.
232 virtual pp::Rect GetPageContentsRect(int index) = 0;
233 // Gets the offset of the vertical scrollbar from the top in document
234 // coordinates.
235 virtual int GetVerticalScrollbarYPosition() = 0;
236 // Paints page thumbnail to the ImageData.
237 virtual void PaintThumbnail(pp::ImageData* image_data, int index) = 0;
238 // Set color / grayscale rendering modes.
239 virtual void SetGrayscale(bool grayscale) = 0;
240 // Callback for timer that's set with ScheduleCallback().
241 virtual void OnCallback(int id) = 0;
242 // Gets the JSON representation of the PDF file
243 virtual std::string GetPageAsJSON(int index) = 0;
244 // Gets the PDF document's print scaling preference. True if the document can
245 // be scaled to fit.
246 virtual bool GetPrintScaling() = 0;
247 // Returns number of copies to be printed.
248 virtual int GetCopiesToPrint() = 0;
250 // Returns a VarArray of Bookmarks, each a VarDictionary containing the
251 // following key/values:
252 // - "title" - a string Var.
253 // - "page" - an int Var.
254 // - "children" - a VarArray(), with each entry containing a VarDictionary of
255 // the same structure.
256 virtual pp::VarArray GetBookmarks() = 0;
258 // Append blank pages to make a 1-page document to a |num_pages| document.
259 // Always retain the first page data.
260 virtual void AppendBlankPages(int num_pages) = 0;
261 // Append the first page of the document loaded with the |engine| to this
262 // document at page |index|.
263 virtual void AppendPage(PDFEngine* engine, int index) = 0;
265 // Allow client to query and reset scroll positions in document coordinates.
266 // Note that this is meant for cases where the device scale factor changes,
267 // and not for general scrolling - the engine will not repaint due to this.
268 virtual pp::Point GetScrollPosition() = 0;
269 virtual void SetScrollPosition(const pp::Point& position) = 0;
271 virtual bool IsProgressiveLoad() = 0;
274 // Interface for exports that wrap the PDF engine.
275 class PDFEngineExports {
276 public:
277 struct RenderingSettings {
278 RenderingSettings(int dpi_x,
279 int dpi_y,
280 const pp::Rect& bounds,
281 bool fit_to_bounds,
282 bool stretch_to_bounds,
283 bool keep_aspect_ratio,
284 bool center_in_bounds,
285 bool autorotate)
286 : dpi_x(dpi_x), dpi_y(dpi_y), bounds(bounds),
287 fit_to_bounds(fit_to_bounds), stretch_to_bounds(stretch_to_bounds),
288 keep_aspect_ratio(keep_aspect_ratio),
289 center_in_bounds(center_in_bounds), autorotate(autorotate) {
291 int dpi_x;
292 int dpi_y;
293 pp::Rect bounds;
294 bool fit_to_bounds;
295 bool stretch_to_bounds;
296 bool keep_aspect_ratio;
297 bool center_in_bounds;
298 bool autorotate;
301 PDFEngineExports() {}
302 virtual ~PDFEngineExports() {}
303 static PDFEngineExports* Create();
304 #if defined(OS_WIN)
305 // See the definition of RenderPDFPageToDC in pdf.cc for details.
306 virtual bool RenderPDFPageToDC(const void* pdf_buffer,
307 int buffer_size,
308 int page_number,
309 const RenderingSettings& settings,
310 HDC dc) = 0;
311 #endif // OS_WIN
312 // See the definition of RenderPDFPageToBitmap in pdf.cc for details.
313 virtual bool RenderPDFPageToBitmap(const void* pdf_buffer,
314 int pdf_buffer_size,
315 int page_number,
316 const RenderingSettings& settings,
317 void* bitmap_buffer) = 0;
319 virtual bool GetPDFDocInfo(const void* pdf_buffer,
320 int buffer_size,
321 int* page_count,
322 double* max_page_width) = 0;
324 // See the definition of GetPDFPageSizeByIndex in pdf.cc for details.
325 virtual bool GetPDFPageSizeByIndex(const void* pdf_buffer,
326 int pdf_buffer_size, int page_number,
327 double* width, double* height) = 0;
330 } // namespace chrome_pdf
332 #endif // PDF_PDF_ENGINE_H_