Print Preview: Make preview generation event driven to eliminate synchronous messages.

chrome/renderer/print_web_view_helper.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_RENDERER_PRINT_WEB_VIEW_HELPER_H_
 #define CHROME_RENDERER_PRINT_WEB_VIEW_HELPER_H_
 #pragma once
 
+#include <vector>
+
 #include "base/memory/scoped_ptr.h"
 #include "base/shared_memory.h"
 #include "base/time.h"
 #include "content/renderer/render_view_observer.h"
 #include "content/renderer/render_view_observer_tracker.h"
 #include "printing/metafile.h"
 #include "third_party/WebKit/Source/WebKit/chromium/public/WebFrameClient.h"
 #include "third_party/WebKit/Source/WebKit/chromium/public/WebViewClient.h"
 #include "ui/gfx/size.h"
 
 struct PrintMsg_Print_Params;
 struct PrintMsg_PrintPage_Params;
 struct PrintMsg_PrintPages_Params;
 
 namespace base {
 class DictionaryValue;
 }
 
 // Class that calls the Begin and End print functions on the frame and changes
 // the size of the view temporarily to support full page printing..
 // Do not serve any events in the time between construction and destruction of
 // this class because it will cause flicker.
 class PrepareFrameAndViewForPrint {
  public:
   // Prints |frame|.  If |node| is not NULL, then only that node will be
   // printed.
   PrepareFrameAndViewForPrint(const PrintMsg_Print_Params& print_params,
                               WebKit::WebFrame* frame,
-                              WebKit::WebNode* node,
-                              WebKit::WebView* web_view);
+                              WebKit::WebNode* node);
   ~PrepareFrameAndViewForPrint();
 
   int GetExpectedPageCount() const {
     return expected_pages_count_;
   }
 
   bool ShouldUseBrowserOverlays() const {
     return use_browser_overlays_;
   }
 
@@ skipping 52 matching lines @@
   virtual void PrintPage(WebKit::WebFrame* frame);
 
   // Message handlers ---------------------------------------------------------
 
   // Print the document.
   void OnPrintPages();
 
   // Initiate print preview.
   void OnInitiatePrintPreview();
 
-  // Generate a print preview using |settings|.
+  // Start the process of generating a print preview using |settings|.
   void OnPrintPreview(const base::DictionaryValue& settings);
+  // Initialize the print preview document.
+  bool CreatePreviewDocument();
+
+  // Continue generating the print preview.
+  void OnContinuePreview();
+  // Renders a print preview page. |page_number| is 0-based.
+  void RenderPreviewPage(int page_number);
+  // Finalize the print preview document.
+  bool FinalizePreviewDocument();
+
+  // Cancel the preview to put |print_preview_context_| into the 'DONE' state.
+  void OnCancelPreview();
+
+  // Abort the preview to put |print_preview_context_| into the 'UNINITIALIZED'
+  // state.
+  void OnAbortPreview();
 
   // Print / preview the node under the context menu.
   void OnPrintNodeUnderContextMenu();
 
   // Print the pages for print preview. Do not display the native print dialog
   // for user settings. |job_settings| has new print job settings values.
   void OnPrintForPrintPreview(const base::DictionaryValue& job_settings);
 
   void OnPrintingDone(bool success);
 
   // Main printing code -------------------------------------------------------
 
   void Print(WebKit::WebFrame* frame, WebKit::WebNode* node);
 
-  void PrintPreview(WebKit::WebFrame* frame,
-                    WebKit::WebNode* node,
-                    const base::DictionaryValue& settings);
-
   enum PrintingResult {
     OK,
     FAIL_PRINT,
     FAIL_PREVIEW,
+    CANCEL_PREVIEW,
+    ABORT_PREVIEW,
   };
 
   // Notification when printing is done - signal tear-down/free resources.
   void DidFinishPrinting(PrintingResult result);
 
   // Print Settings -----------------------------------------------------------
 
   // Initialize print page settings with default settings.
   bool InitPrintSettings(WebKit::WebFrame* frame,
                          WebKit::WebNode* node);
@@ skipping 35 matching lines @@
                          printing::Metafile* metafile);
 #else
   void PrintPageInternal(const PrintMsg_PrintPage_Params& params,
                          const gfx::Size& canvas_size,
                          WebKit::WebFrame* frame);
 #endif
 
   // Render the frame for printing.
   bool RenderPagesForPrint(WebKit::WebFrame* frame, WebKit::WebNode* node);
 
-  // Render the frame for preview.
-  bool RenderPagesForPreview(WebKit::WebFrame* frame, WebKit::WebNode* node);
-
-  // Renders all the pages listed in |params| for preview.
-  // On success, Send PrintHostMsg_PagesReadyForPreview message with a
-  // valid metafile data handle.
-  bool CreatePreviewDocument(const PrintMsg_PrintPages_Params& params,
-                             WebKit::WebFrame* frame,
-                             WebKit::WebNode* node);
-
   // Platform specific helper function for rendering page(s) to |metafile|.
 #if defined(OS_WIN)
   void RenderPage(const PrintMsg_Print_Params& params, float* scale_factor,
                   int page_number, bool is_preview, WebKit::WebFrame* frame,
                   scoped_ptr<printing::Metafile>* metafile);
 #elif defined(OS_MACOSX)
   void RenderPage(const gfx::Size& page_size, const gfx::Rect& content_area,
                   const float& scale_factor, int page_number,
                   WebKit::WebFrame* frame, printing::Metafile* metafile);
 #elif defined(OS_POSIX)
   bool RenderPages(const PrintMsg_PrintPages_Params& params,
-                   WebKit::WebFrame* frame,
-                   WebKit::WebNode* node,
-                   int* page_count,
-                   printing::Metafile* metafile,
-                   bool is_preview);
+                   WebKit::WebFrame* frame, WebKit::WebNode* node,
+                   int* page_count, printing::Metafile* metafile);
 #endif  // defined(OS_WIN)
 
   // Helper methods -----------------------------------------------------------
 
   bool CopyAndPrint(WebKit::WebFrame* web_frame);
 
   bool CopyMetafileDataToSharedMem(printing::Metafile* metafile,
                                    base::SharedMemoryHandle* shared_mem_handle);
 
   void GetPageSizeAndMarginsInPoints(
       WebKit::WebFrame* frame,
       int page_index,
       const PrintMsg_Print_Params& default_params,
       double* content_width_in_points,
       double* content_height_in_points,
       double* margin_top_in_points,
       double* margin_right_in_points,
       double* margin_bottom_in_points,
       double* margin_left_in_points);
 
-  bool IsModifiable(WebKit::WebFrame* frame, WebKit::WebNode* node);
-
   void UpdatePrintableSizeInPrintParameters(WebKit::WebFrame* frame,
                                             WebKit::WebNode* node,
                                             PrintMsg_Print_Params* params);
 
   bool GetPrintFrame(WebKit::WebFrame** frame);
 
-  // This reports the current time - |start_time| as the time to render
-  // a page and returns the current time.
-  base::TimeTicks ReportPreviewPageRenderTime(base::TimeTicks start_time);
-  void ReportTotalPreviewGenerationTime(int selected_pages_length,
-                                        int total_pages,
-                                        base::TimeDelta render_time,
-                                        base::TimeDelta total_time);
+  // This reports the current time - |start_time| as the time to render a page.
+  void ReportPreviewPageRenderTime(base::TimeTicks start_time);
 
   // Script Initiated Printing ------------------------------------------------
 
   // Returns true if script initiated printing occurs too often.
   bool IsScriptInitiatedPrintTooFrequent(WebKit::WebFrame* frame);
 
   // Reset the counter for script initiated printing.
   // Scripted printing will be allowed to continue.
   void ResetScriptedPrintCount();
 
   // Increment the counter for script initiated printing.
   // Scripted printing will be blocked for a limited amount of time.
   void IncrementScriptedPrintCount();
 
   // Displays the print job error message to the user.
   void DisplayPrintJobError();
 
   void RequestPrintPreview();
 
-  // Called every time print preview renders a page. Notify the browser of the
-  // event and check if print preview should be cancelled. Returns false if
-  // print preview has been cancelled. |page_number| is 0-based, or negative to
-  // indicate its a cancel check only.
-  bool PreviewPageRendered(int page_number);
+  // Notify the browser a print preview page has been rendered.
+  // |page_number| is 0-based.
+  void PreviewPageRendered(int page_number);
 
   WebKit::WebView* print_web_view_;
 
-  // The frame to print for script initiated print preview.
-  WebKit::WebFrame* script_initiated_preview_frame_;
-
-  // The node under the context menu to print preview.
-  scoped_ptr<WebKit::WebNode> context_menu_preview_node_;
-
   scoped_ptr<PrintMsg_PrintPages_Params> print_pages_params_;
   bool is_preview_;
 
   // Used for scripted initiated printing blocking.
   base::Time last_cancelled_script_print_;
   int user_cancelled_scripted_print_count_;
 
   // Let the browser process know of a printing failure. Only set to false when
   // the failure came from the browser in the first place.
   bool notify_browser_of_print_failure_;
 
-  int preview_page_count_;
   scoped_ptr<PrintMsg_PrintPages_Params> old_print_pages_params_;
 
+  // Keeps track of the state of print preview between messages.
+  class PrintPreviewContext {
+   public:
+    PrintPreviewContext();
+
+    // Initializes the print preview context. Need to be called to set
+    // the |web_frame| / |web_node| to generate the print preview for.
+    void InitWithFrame(WebKit::WebFrame* web_frame);
+    void InitWithNode(const WebKit::WebNode& web_node);
+
+    // Does bookkeeping at the beginning of print preview.
+    void OnPrintPreview();
+
+    // Create the print preview document. |pages| is empty to print all pages.
+    bool CreatePreviewDocument(const PrintMsg_Print_Params& params,
+                               const std::vector<int>& pages);
+
+    // Called after a page gets rendered. |page_time| is how long the
+    // rendering took.
+    void RenderedPreviewPage(const base::TimeDelta& page_time);
+
+    // Finalizes the print preview document.
+    void FinalizePreviewDocument();
+
+    // Cleanup after print preview finishes.
+    void Finished();
+
+    // Abort the print preview.
+    void Abort();
+
+    // Cancel the print preview.
+    void Cancel();
+
+    // Helper functions
+    int GetNextPageNumber();
+    bool IsReadyToRender() const;
+    bool IsBusy() const;
+    bool IsModifiable() const;
+
+    // Getters
+    WebKit::WebFrame* frame() const;
+    WebKit::WebNode* node() const;
+    int total_page_count() const;
+    printing::Metafile* metafile() const;
+    const PrintMsg_Print_Params& print_params() const;
+    const gfx::Size& GetPrintCanvasSize() const;
+
+   private:
+    enum State {
+      UNINITIALIZED,  // Not ready to render.
+      INITIALIZED,    // Ready to render.
+      RENDERING,      // Rendering.
+      DONE            // Finished rendering.
+    };
+
+    // Reset the internal rendering state.
+    void ResetRenderingState();
+
+    // Specifies what to render for print preview.
+    WebKit::WebFrame* frame_;
+    scoped_ptr<WebKit::WebNode> node_;
+
+    scoped_ptr<PrepareFrameAndViewForPrint> prep_frame_view_;
+    scoped_ptr<printing::Metafile> metafile_;
+    scoped_ptr<PrintMsg_Print_Params> print_params_;
+
+    // Total page count in the renderer.
+    int total_page_count_;
+
+    // Number of pages to print.

[kmadhusu, 2011/07/15 19:25:47]

// Actual number of pages that needs to be rendered ??

[Lei Zhang, 2011/07/15 20:23:35]

Done.

+    int actual_page_count_;
+
+    // The current page to print.

[kmadhusu, 2011/07/15 19:25:47]

s/print/render

[Lei Zhang, 2011/07/15 20:23:35]

Done.

+    int current_page_number_;
+
+    // Array to keep track of which pages have been printed.
+    std::vector<bool> rendered_pages_;
+
+    base::TimeDelta document_render_time_;
+    base::TimeTicks begin_time_;
+
+    State state_;
+  };
+
+  PrintPreviewContext print_preview_context_;
+
   DISALLOW_COPY_AND_ASSIGN(PrintWebViewHelper);
 };
 
 #endif  // CHROME_RENDERER_PRINT_WEB_VIEW_HELPER_H_