| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright 2013 Google Inc. | 2 * Copyright 2013 Google Inc. |
| 3 * | 3 * |
| 4 * Use of this source code is governed by a BSD-style license that can be | 4 * Use of this source code is governed by a BSD-style license that can be |
| 5 * found in the LICENSE file. | 5 * found in the LICENSE file. |
| 6 */ | 6 */ |
| 7 | 7 |
| 8 #ifndef SkDocument_DEFINED | 8 #ifndef SkDocument_DEFINED |
| 9 #define SkDocument_DEFINED | 9 #define SkDocument_DEFINED |
| 10 | 10 |
| (...skipping 46 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 57 * Create a PDF-backed document, writing the results into a stream. | 57 * Create a PDF-backed document, writing the results into a stream. |
| 58 * If there is an error trying to create the doc, returns NULL. | 58 * If there is an error trying to create the doc, returns NULL. |
| 59 * | 59 * |
| 60 * The document may write to the stream at anytime during its lifetime, | 60 * The document may write to the stream at anytime during its lifetime, |
| 61 * until either close() is called or the document is deleted. Once close() | 61 * until either close() is called or the document is deleted. Once close() |
| 62 * has been called, and all of the data has been written to the stream, | 62 * has been called, and all of the data has been written to the stream, |
| 63 * if there is a Done proc provided, it will be called with the stream. | 63 * if there is a Done proc provided, it will be called with the stream. |
| 64 * The proc can delete the stream, or whatever it needs to do. | 64 * The proc can delete the stream, or whatever it needs to do. |
| 65 * encoder sets the DCTEncoder for images, to encode a bitmap | 65 * encoder sets the DCTEncoder for images, to encode a bitmap |
| 66 * as JPEG (DCT). | 66 * as JPEG (DCT). |
| 67 * Done - clean up method intended to allow deletion of the stream. |
| 68 * Its aborted parameter is true if the cleanup is due to an abort |
| 69 * call. It is false otherwise. |
| 67 * rasterDpi - the DPI at which features without native PDF support | 70 * rasterDpi - the DPI at which features without native PDF support |
| 68 * will be rasterized (e.g. draw image with perspective, | 71 * will be rasterized (e.g. draw image with perspective, |
| 69 * draw text with perspective, ...) | 72 * draw text with perspective, ...) |
| 70 * A larger DPI would create a PDF that reflects the original | 73 * A larger DPI would create a PDF that reflects the original |
| 71 * intent with better fidelity, but it can make for larger | 74 * intent with better fidelity, but it can make for larger |
| 72 * PDF files too, which would use more memory while rendering, | 75 * PDF files too, which would use more memory while rendering, |
| 73 * and it would be slower to be processed or sent online or | 76 * and it would be slower to be processed or sent online or |
| 74 * to printer. */ | 77 * to printer. */ |
| 75 static SkDocument* CreatePDF( | 78 static SkDocument* CreatePDF( |
| 76 SkWStream*, void (*Done)(SkWStream*) = NULL, | 79 SkWStream*, void (*Done)(SkWStream*,bool aborted) = NULL, |
| 77 SkPicture::EncodeBitmap encoder = NULL, | 80 SkPicture::EncodeBitmap encoder = NULL, |
| 78 SkScalar rasterDpi = SK_ScalarDefaultRasterDPI); | 81 SkScalar rasterDpi = SK_ScalarDefaultRasterDPI); |
| 79 | 82 |
| 80 /** | 83 /** |
| 81 * Begin a new page for the document, returning the canvas that will draw | 84 * Begin a new page for the document, returning the canvas that will draw |
| 82 * into the page. The document owns this canvas, and it will go out of | 85 * into the page. The document owns this canvas, and it will go out of |
| 83 * scope when endPage() or close() is called, or the document is deleted. | 86 * scope when endPage() or close() is called, or the document is deleted. |
| 84 */ | 87 */ |
| 85 SkCanvas* beginPage(SkScalar width, SkScalar height, | 88 SkCanvas* beginPage(SkScalar width, SkScalar height, |
| 86 const SkRect* content = NULL); | 89 const SkRect* content = NULL); |
| (...skipping 14 matching lines...) Expand all Loading... |
| 101 */ | 104 */ |
| 102 bool close(); | 105 bool close(); |
| 103 | 106 |
| 104 /** | 107 /** |
| 105 * Call abort() to stop producing the document immediately. | 108 * Call abort() to stop producing the document immediately. |
| 106 * The stream output must be ignored, and should not be trusted. | 109 * The stream output must be ignored, and should not be trusted. |
| 107 */ | 110 */ |
| 108 void abort(); | 111 void abort(); |
| 109 | 112 |
| 110 protected: | 113 protected: |
| 111 SkDocument(SkWStream*, void (*)(SkWStream*)); | 114 SkDocument(SkWStream*, void (*)(SkWStream*, bool aborted)); |
| 112 // note: subclasses must call close() in their destructor, as the base class | 115 // note: subclasses must call close() in their destructor, as the base class |
| 113 // cannot do this for them. | 116 // cannot do this for them. |
| 114 virtual ~SkDocument(); | 117 virtual ~SkDocument(); |
| 115 | 118 |
| 116 virtual SkCanvas* onBeginPage(SkScalar width, SkScalar height, | 119 virtual SkCanvas* onBeginPage(SkScalar width, SkScalar height, |
| 117 const SkRect& content) = 0; | 120 const SkRect& content) = 0; |
| 118 virtual void onEndPage() = 0; | 121 virtual void onEndPage() = 0; |
| 119 virtual bool onClose(SkWStream*) = 0; | 122 virtual bool onClose(SkWStream*) = 0; |
| 120 virtual void onAbort() = 0; | 123 virtual void onAbort() = 0; |
| 121 | 124 |
| 122 enum State { | 125 enum State { |
| 123 kBetweenPages_State, | 126 kBetweenPages_State, |
| 124 kInPage_State, | 127 kInPage_State, |
| 125 kClosed_State | 128 kClosed_State |
| 126 }; | 129 }; |
| 127 State getState() const { return fState; } | 130 State getState() const { return fState; } |
| 128 | 131 |
| 129 private: | 132 private: |
| 130 SkWStream* fStream; | 133 SkWStream* fStream; |
| 131 void (*fDoneProc)(SkWStream*); | 134 void (*fDoneProc)(SkWStream*, bool aborted); |
| 132 State fState; | 135 State fState; |
| 133 | 136 |
| 134 typedef SkRefCnt INHERITED; | 137 typedef SkRefCnt INHERITED; |
| 135 }; | 138 }; |
| 136 | 139 |
| 137 #endif | 140 #endif |
| OLD | NEW |