diff options
author | Hal Canary <halcanary@google.com> | 2016-12-09 15:38:13 -0500 |
---|---|---|
committer | Skia Commit-Bot <skia-commit-bot@chromium.org> | 2016-12-09 21:15:27 +0000 |
commit | a4a338179013b029d6dd55e737b5bd648a9fb68c (patch) | |
tree | 92bbbedc12950187e83156b6d1ddd56a7b3e077c /site | |
parent | 0e8fc8b9e6a138cf4a66b421fb824679df717329 (diff) |
tools and docs: clean up gyp-specific things
BUG=skia:
DOCS_PREVIEW= https://skia.org/?cl=5770
Change-Id: Iadc436a68cbf7ec0d1dd3c019072eb28bf589bb6
Reviewed-on: https://skia-review.googlesource.com/5770
Commit-Queue: Hal Canary <halcanary@google.com>
Reviewed-by: Mike Klein <mtklein@chromium.org>
Diffstat (limited to 'site')
-rw-r--r-- | site/dev/design/sync.md | 5 | ||||
-rw-r--r-- | site/dev/tools/qtdebugger.md | 120 | ||||
-rw-r--r-- | site/user/special/msan.md | 19 |
3 files changed, 1 insertions, 143 deletions
diff --git a/site/dev/design/sync.md b/site/dev/design/sync.md index d7c192fdbc..7443dba6f4 100644 --- a/site/dev/design/sync.md +++ b/site/dev/design/sync.md @@ -2,8 +2,7 @@ sync ==== [`sync`](https://skia.googlesource.com/skia.git/+/master/bin/sync) -is a Python program that wraps `gclient sync` and `fetch-gn`. -Motivations for using it: +is a Python program that wraps `gclient sync`. Motivations for using it: - Written in Python, so it will work on all platforms. @@ -12,7 +11,5 @@ Motivations for using it: - Checks to see if the `DEPS` file has changed since it last ran `gclient sync`. If not, it skips that step. -- Calls `fetch-gn` if needed. - - Since running `sync` is fast when it can do nothing, it is easy to do before every recompile of Skia. This is a good habit. diff --git a/site/dev/tools/qtdebugger.md b/site/dev/tools/qtdebugger.md deleted file mode 100644 index bb3f97eba6..0000000000 --- a/site/dev/tools/qtdebugger.md +++ /dev/null @@ -1,120 +0,0 @@ -Skia Debugger (deprecated) -============= - -Introduction ------------- - -The Skia Debugger is a graphical tool used to step through and analyze the -contents of the Skia picture format. Pre-requisites include installing the Qt -Library and downloading the Skia code base. - -Qt is available here: http://qt-project.org/downloads. - -It can also be installed on linux using - -<!--?prettify?--> -~~~~ -sudo apt-get install libqt4-dev -~~~~ - -Note that the debugger has been tested with Qt 4.8.6; it is known not to work -with Qt 5.0RC1 on the Mac. - -Design Documents: - -https://docs.google.com/a/google.com/document/d/1b8muqVzfbJmYbno9nTv5721V2nlFMfnqXYLNHiSQ4ws/pub - - -How to build and run --------------------- - -Because the debugger uses Qt, you'll need to build skia in 64 bit mode: - -<!--?prettify?--> - - GYP_DEFINES="skia_arch_width=64" python bin/sync-and-gyp - ninja -C out/Debug debugger - out/Debug/debugger - -For Windows, Qt ships as 32 bit libraries so to build and run one should just be -able to: - -<!--?prettify?--> -~~~~ -cd trunk -make clean gyp -<open solution in VS2010 and build everything> -~~~~ - -Depending on how your Qt is installed you may also need to define an environment -variable like: - -~~~~ -GYP_DEFINES=qt_sdk='C:\Qt\4.8.6\' -~~~~ -(which needs to be set before you execute 'make gyp') - -On Windows, you may need to copy several DLL and PDB files from %QTDIR%\bin into -your executable directory (out/Debug or out/Release): - -QtCore4.dll QtCored4.dll QtCored4.pdb - -QtGui4.dll QtGuid4.dll QtGuid4.pdb - -QtOpenGL4.dll QtOpenGLd4.dll QtOpenGLd4.pdb - - -Producing SKPs for usage ------------------------- - -You may either use the Skia testing images (GMs) for use in the debugger or -create your own via chromium. - -To create SKPs from Chromium you must download and build chromium on your -platform of choice: http://www.chromium.org/Home - -<!--?prettify?--> -~~~~ -cd src -make chrome -out/Debug/chrome --no-sandbox --enable-gpu-benchmarking --force-compositing-mode -~~~~ - -After which go to Tools, Settings, Javascript Console and type: - -<!--?prettify?--> -~~~~ -chrome.gpuBenchmarking.printToSkPicture(dirname) -~~~~ - -Using the Debugger ------------------- - -The debugger is fairly straight forward to use once a picture is loaded in. We -can step through different commands via the up and down keys, and clicking on -the command in the list. We can pause execution of commands with the pause -button in order to inspect the details of the command in the inspector tabs -down below. - - - Command | Function - -------------|----------------------------------------------- - x | toggles the visibility of the selected command - alt-x | clears all hidden commands - ctrl-x | shows all deleted commands - b | creates a breakpoint on a command - alt-b | clears all breakpoints - ctrl-b | shows all breakpoints - ctrl-r | rewinds the picture to the first command - ctrl-p | plays to the next breakpoint or last command - ctrl-i | Toggles the inspector and settings widgets - ctrl-d | Toggles the directory widget - space | Pauses drawing execution - ctrl-o | Opens a file dialog for loading pictures - ctrl-s | Saves the skp if you deleted any commands - ctrl-shift-s | Saves the skp under the new specified name - ctrl-q | Quits - -![Debugger interface](/dev/tools/debugger.png) - - diff --git a/site/user/special/msan.md b/site/user/special/msan.md deleted file mode 100644 index c4fce78c10..0000000000 --- a/site/user/special/msan.md +++ /dev/null @@ -1,19 +0,0 @@ -Running with Memory Sanitizer -============================= - -Prerequisites -------------- - -The msan build builds Clang from scratch, so you need to download Clang first: - - bin/sync-and-gyp --deps=llvm - -Build ------ - - tools/xsan_build memory dm - -Run ---- - - out/Debug/dm -v --match ~Codec ~BlurLargeImage ~FontMgrAndroidParser |