Documentation: MSKP

site/user/tips.md

 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)
 +   [How do I add drop shadow on text?](#text-shadow)
 
 * * *
 
 <span id="gypdefines"></span>
 
 Gyp Options
@@ skipping 92 matching lines @@
 <!--?prettify lang=sh?-->
 
     out/Release/dm --src skp --skps /tmp/layer_0.skp -w /tmp \
         --config 8888 gpu pdf --verbose
     ls -l /tmp/*/skp/layer_0.skp.*
 
     out/Release/SampleApp --picture /tmp/layer_0.skp
 
 * * *
 
+<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
 ----------------------------------------
 
 There are two ways Skia takes advantage of specific hardware.
 
 1.  Subclass SkCanvas
 
     Since all drawing calls go through SkCanvas, those calls can be
@@ skipping 70 matching lines @@
             SkBlurMaskFilter::ConvertRadiusToSigma(radius), 0));
         canvas->drawText(text, strlen(text), x + xDrop, y + yDrop, blur);
         canvas->drawText(text, strlen(text), x, y, paint);
     }
 
 <a href='https://fiddle.skia.org/c/@text_shadow'><img src='https://fiddle.skia.org/i/@text_shadow_raster.png'></a>
 
 * * *
 
 <div style="margin-bottom:99%"></div>