epoger@google.com | ec3ed6a | 2011-07-28 14:26:00 +0000 | [diff] [blame] | 1 | |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 2 | /* |
epoger@google.com | ec3ed6a | 2011-07-28 14:26:00 +0000 | [diff] [blame] | 3 | * Copyright 2006 The Android Open Source Project |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 4 | * |
epoger@google.com | ec3ed6a | 2011-07-28 14:26:00 +0000 | [diff] [blame] | 5 | * Use of this source code is governed by a BSD-style license that can be |
| 6 | * found in the LICENSE file. |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 7 | */ |
| 8 | |
epoger@google.com | ec3ed6a | 2011-07-28 14:26:00 +0000 | [diff] [blame] | 9 | |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 10 | #ifndef SkUserConfig_DEFINED |
| 11 | #define SkUserConfig_DEFINED |
| 12 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 13 | /* SkTypes.h, the root of the public header files, does the following trick: |
reed@google.com | 9d0d195 | 2011-01-28 22:19:22 +0000 | [diff] [blame] | 14 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 15 | #include "SkPreConfig.h" |
| 16 | #include "SkUserConfig.h" |
| 17 | #include "SkPostConfig.h" |
reed@google.com | 9d0d195 | 2011-01-28 22:19:22 +0000 | [diff] [blame] | 18 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 19 | SkPreConfig.h runs first, and it is responsible for initializing certain |
| 20 | skia defines. |
reed@google.com | 9d0d195 | 2011-01-28 22:19:22 +0000 | [diff] [blame] | 21 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 22 | SkPostConfig.h runs last, and its job is to just check that the final |
| 23 | defines are consistent (i.e. that we don't have mutually conflicting |
| 24 | defines). |
reed@google.com | 9d0d195 | 2011-01-28 22:19:22 +0000 | [diff] [blame] | 25 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 26 | SkUserConfig.h (this file) runs in the middle. It gets to change or augment |
| 27 | the list of flags initially set in preconfig, and then postconfig checks |
| 28 | that everything still makes sense. |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 29 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 30 | Below are optional defines that add, subtract, or change default behavior |
| 31 | in Skia. Your port can locally edit this file to enable/disable flags as |
| 32 | you choose, or these can be delared on your command line (i.e. -Dfoo). |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 33 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 34 | By default, this include file will always default to having all of the flags |
| 35 | commented out, so including it will have no effect. |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 36 | */ |
| 37 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 38 | /////////////////////////////////////////////////////////////////////////////// |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 39 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 40 | /* Skia has lots of debug-only code. Often this is just null checks or other |
| 41 | parameter checking, but sometimes it can be quite intrusive (e.g. check that |
| 42 | each 32bit pixel is in premultiplied form). This code can be very useful |
| 43 | during development, but will slow things down in a shipping product. |
reed@google.com | 9d0d195 | 2011-01-28 22:19:22 +0000 | [diff] [blame] | 44 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 45 | By default, these mutually exclusive flags are defined in SkPreConfig.h, |
| 46 | based on the presence or absence of NDEBUG, but that decision can be changed |
| 47 | here. |
| 48 | */ |
| 49 | //#define SK_DEBUG |
| 50 | //#define SK_RELEASE |
| 51 | |
djsollen@google.com | 077348c | 2012-10-22 20:23:32 +0000 | [diff] [blame] | 52 | /* Skia has certain debug-only code that is extremely intensive even for debug |
| 53 | builds. This code is useful for diagnosing specific issues, but is not |
| 54 | generally applicable, therefore it must be explicitly enabled to avoid |
| 55 | the performance impact. By default these flags are undefined, but can be |
| 56 | enabled by uncommenting them below. |
| 57 | */ |
djsollen@google.com | 000dea7 | 2012-11-30 16:19:32 +0000 | [diff] [blame] | 58 | //#define SK_DEBUG_GLYPH_CACHE |
djsollen@google.com | 077348c | 2012-10-22 20:23:32 +0000 | [diff] [blame] | 59 | //#define SK_DEBUG_PATH |
| 60 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 61 | /* preconfig will have attempted to determine the endianness of the system, |
| 62 | but you can change these mutually exclusive flags here. |
| 63 | */ |
| 64 | //#define SK_CPU_BENDIAN |
| 65 | //#define SK_CPU_LENDIAN |
| 66 | |
bungeman@google.com | f8d1aee | 2012-02-02 19:15:21 +0000 | [diff] [blame] | 67 | /* Most compilers use the same bit endianness for bit flags in a byte as the |
| 68 | system byte endianness, and this is the default. If for some reason this |
| 69 | needs to be overridden, specify which of the mutually exclusive flags to |
| 70 | use. For example, some atom processors in certain configurations have big |
| 71 | endian byte order but little endian bit orders. |
| 72 | */ |
| 73 | //#define SK_UINT8_BITFIELD_BENDIAN |
| 74 | //#define SK_UINT8_BITFIELD_LENDIAN |
| 75 | |
robertphillips@google.com | 0e6e8cc | 2013-08-15 13:43:23 +0000 | [diff] [blame] | 76 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 77 | /* To write debug messages to a console, skia will call SkDebugf(...) following |
| 78 | printf conventions (e.g. const char* format, ...). If you want to redirect |
| 79 | this to something other than printf, define yours here |
| 80 | */ |
| 81 | //#define SkDebugf(...) MyFunction(__VA_ARGS__) |
| 82 | |
reed@google.com | 77407ca | 2011-11-08 13:48:32 +0000 | [diff] [blame] | 83 | /* |
| 84 | * To specify a different default font cache limit, define this. If this is |
| 85 | * undefined, skia will use a built-in value. |
| 86 | */ |
| 87 | //#define SK_DEFAULT_FONT_CACHE_LIMIT (1024 * 1024) |
| 88 | |
reed@google.com | 602a1d7 | 2013-07-23 19:13:54 +0000 | [diff] [blame] | 89 | /* |
| 90 | * To specify the default size of the image cache, undefine this and set it to |
| 91 | * the desired value (in bytes). SkGraphics.h as a runtime API to set this |
| 92 | * value as well. If this is undefined, a built-in value will be used. |
| 93 | */ |
| 94 | //#define SK_DEFAULT_IMAGE_CACHE_LIMIT (1024 * 1024) |
| 95 | |
vandebo@chromium.org | 1f16589 | 2011-07-26 02:11:41 +0000 | [diff] [blame] | 96 | /* Define this to provide font subsetter in PDF generation. |
| 97 | */ |
halcanary | e37aa89 | 2016-08-24 12:28:38 -0700 | [diff] [blame] | 98 | //#define SK_SFNTLY_SUBSETTER "sample/chromium/font_subsetter.h" |
vandebo@chromium.org | 1f16589 | 2011-07-26 02:11:41 +0000 | [diff] [blame] | 99 | |
reed@google.com | c27b741 | 2011-09-13 17:20:30 +0000 | [diff] [blame] | 100 | /* Define this to set the upper limit for text to support LCD. Values that |
| 101 | are very large increase the cost in the font cache and draw slower, without |
| 102 | improving readability. If this is undefined, Skia will use its default |
| 103 | value (e.g. 48) |
| 104 | */ |
| 105 | //#define SK_MAX_SIZE_FOR_LCDTEXT 48 |
| 106 | |
reed@android.com | 5c80ea1 | 2009-01-08 17:49:50 +0000 | [diff] [blame] | 107 | /* If SK_DEBUG is defined, then you can optionally define SK_SUPPORT_UNITTEST |
| 108 | which will run additional self-tests at startup. These can take a long time, |
| 109 | so this flag is optional. |
| 110 | */ |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 111 | #ifdef SK_DEBUG |
reed@android.com | 0f0cfae | 2009-10-13 13:33:16 +0000 | [diff] [blame] | 112 | //#define SK_SUPPORT_UNITTEST |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 113 | #endif |
| 114 | |
scroggo | b66365f | 2011-03-18 21:43:03 +0000 | [diff] [blame] | 115 | /* Change the ordering to work in X windows. |
| 116 | */ |
| 117 | #ifdef SK_SAMPLES_FOR_X |
| 118 | #define SK_R32_SHIFT 16 |
| 119 | #define SK_G32_SHIFT 8 |
| 120 | #define SK_B32_SHIFT 0 |
| 121 | #define SK_A32_SHIFT 24 |
| 122 | #endif |
| 123 | |
bsalomon@google.com | cf8fb1f | 2012-08-02 14:03:32 +0000 | [diff] [blame] | 124 | |
| 125 | /* Determines whether to build code that supports the GPU backend. Some classes |
| 126 | that are not GPU-specific, such as SkShader subclasses, have optional code |
| 127 | that is used allows them to interact with the GPU backend. If you'd like to |
| 128 | omit this code set SK_SUPPORT_GPU to 0. This also allows you to omit the gpu |
| 129 | directories from your include search path when you're not building the GPU |
| 130 | backend. Defaults to 1 (build the GPU code). |
| 131 | */ |
| 132 | //#define SK_SUPPORT_GPU 1 |
sugoi@google.com | 7775fd5 | 2012-11-21 15:47:04 +0000 | [diff] [blame] | 133 | |
ericrk | 369e937 | 2016-02-05 15:32:36 -0800 | [diff] [blame] | 134 | /* Skia makes use of histogram logging macros to trace the frequency of |
| 135 | * events. By default, Skia provides no-op versions of these macros. |
| 136 | * Skia consumers can provide their own definitions of these macros to |
| 137 | * integrate with their histogram collection backend. |
| 138 | */ |
| 139 | //#define SK_HISTOGRAM_BOOLEAN(name, value) |
| 140 | //#define SK_HISTOGRAM_ENUMERATION(name, value, boundary_value) |
| 141 | |
reed@android.com | 8a1c16f | 2008-12-17 15:59:43 +0000 | [diff] [blame] | 142 | #endif |