Documentation: FAQ TOC

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)
++   [How to add hardware acceleration in Skia](#hw-acceleration)
++   [Does Skia support Font hinting?](#font-hinting)
++   [Does Skia shape text (kerning)?](#kerning)
+
+* * *
+
 <span id="gypdefines"></span>
 
 Gyp Options
 -----------
 
 When running `sync-and-gyp`, the `GYP_DEFINES` environment variable can
 be used to change Skia’s compile-time settings, using a
 space-separated list of key=value pairs. For example, to disable both
 the Skia GPU backend and PDF backends, run it as follows:
 
@@ skipping 12 matching lines @@
 <!--?prettify lang=sh?-->
 
     CC='clang' CXX='clang++' python bin/sync-and-gyp
     ninja -C out/Debug
 
 To build with clang and enable a compiler warning for unused parameters in C++
 (but not C or assembly) code:
 
 <!--?prettify lang=sh?-->
 
-    CXXFLAGS='-Wunused-parameter'
-    CC='clang' CXX='clang++' python bin/sync-and-gyp
+    CXXFLAGS='-Wunused-parameter' \
+        CC='clang' CXX='clang++' python bin/sync-and-gyp
     ninja -C out/Debug
 
 
 The `GYP_GENERATORS` environment variable can be used to set the
 build systems that you want to use (as a comma-separated list).
 The default is `'ninja,msvs-ninja'` on Windows, `'ninja,xcode'` on
 Mac OS X, and just `'ninja'` on Linux.  For example, to generate
 only Ninja files on Mac:
 
 <!--?prettify lang=sh?-->
@@ skipping 23 matching lines @@
 Taking a subset of a bitmap is effectively free - no pixels are copied or
 memory is allocated. This allows Skia to offer an API that typically operates
 on entire bitmaps; clients who want to operate on a subset of a bitmap can use
 the following pattern, here being used to magnify a portion of an image with
 drawBitmapNine():
 
     SkBitmap subset;
     bitmap.extractSubset(&subset, rect);
     canvas->drawBitmapNine(subset, ...);
 
+[An example](https://fiddle.skia.org/c/c91694020f0810994917b56c323e4559)
+
 * * *
 
 <span id="skp-capture"></span>
 
 Capture a `.skp` file on a web page in Chromium
 -----------------------------------------------
 
 1.  Launch Chrome or Chromium with `--no-sandbox --enable-gpu-benchmarking`
 2.  Open the JS console (ctrl-shift-J)
 3.  Execute: `chrome.gpuBenchmarking.printToSkPicture('/tmp')`
@@ skipping 57 matching lines @@
 
 Does Skia shape text (kerning)?
 -------------------------------
 
 No.  Skia provides interfaces to draw glyphs, but does not implement a
 text shaper. Skia's client's often use
 [HarfBuzz](http://www.freedesktop.org/wiki/Software/HarfBuzz/) to
 generate the glyphs and their positions, including kerning.
 
 <div style="margin-bottom:99%"></div>