Documentation: MSKP

BUG=skia:
GOLD_TRYBOT_URL= https://gold.skia.org/search?issue=2332783002
NOTRY=true
DOCS_PREVIEW= https://skia.org/?cl=2332783002

Review-Url: https://codereview.chromium.org/2332783002

diff --git a/site/user/tips.md b/site/user/tips.md
index 7e6bc8a..1101582 100644 (file)
--- a/site/user/tips.md
+++ b/site/user/tips.md
@@ -4,6 +4,7 @@ Tips & FAQ
 +   [Gyp Options](#gypdefines)
 +   [Bitmap Subsetting](#bitmap-subsetting)
 +   [Capture a `.skp` file on a web page in Chromium](#skp-capture)
++   [Capture a `.mskp` file on a web page in Chromium](#mskp-capture)
 +   [How to add hardware acceleration in Skia](#hw-acceleration)
 +   [Does Skia support Font hinting?](#font-hinting)
 +   [Does Skia shape text (kerning)?](#kerning)
@@ -116,6 +117,34 @@ or use Skia's `SampleApp` to view it:
 
 * * *
 
+<span id="mskp-capture"></span>
+
+Capture a `.mskp` file on a web page in Chromium
+-----------------------------------------------
+
+Multipage Skia Picture files capture the commands sent to produce PDFs
+and printed documents.
+
+1.  Launch Chrome or Chromium with `--no-sandbox --enable-gpu-benchmarking`
+2.  Open the JS console (ctrl-shift-J)
+3.  Execute: `chrome.gpuBenchmarking.printPagesToSkPictures('/tmp/filename.mskp')`
+    This returns "undefined" on success.
+
+Open the resulting file in the [Skia Debugger](/dev/tools/debugger) or
+process it with `dm`.
+
+<!--?prettify lang=sh?-->
+
+    experimental/tools/mskp_parser.py /tmp/filename.mskp /tmp/filename.mskp.skp
+    ls -l /tmp/filename.mskp.skp
+    # open filename.mskp.skp in the debugger.
+
+    out/Release/dm --src mskp --mskps /tmp/filename.mskp -w /tmp \
+        --config pdf --verbose
+    ls -l /tmp/pdf/mskp/filename.mskp
+
+* * *
+
 <span id="hw-acceleration"></span>
 
 How to add hardware acceleration in Skia