Home | History | Annotate | Download | only in core 
      1 
      2 /*
      3  * Copyright 2006 The Android Open Source Project
      4  *
      5  * Use of this source code is governed by a BSD-style license that can be
      6  * found in the LICENSE file.
      7  */
      8 
      9 
     10 #ifndef SkUserConfig_DEFINED
     11 #define SkUserConfig_DEFINED
     12 
     13 /*  SkTypes.h, the root of the public header files, does the following trick:
     14 
     15     #include "SkPreConfig.h"
     16     #include "SkUserConfig.h"
     17     #include "SkPostConfig.h"
     18 
     19     SkPreConfig.h runs first, and it is responsible for initializing certain
     20     skia defines.
     21 
     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).
     25 
     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.
     29 
     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).
     33 
     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.
     36 */
     37 
     38 ///////////////////////////////////////////////////////////////////////////////
     39 
     40 //
     41 // ANDROID Specific changes - NO NOT CHECK BACK INTO code.google.com/p/skia
     42 //
     43 
     44 // When built as part of the system image we can enable certian non-NDK compliant
     45 // optimizations.
     46 #define SK_BUILD_FOR_ANDROID_FRAMEWORK
     47 #define SK_SUPPORT_GPU 1
     48 
     49 // Android Text Tuning
     50 #define SK_GAMMA_APPLY_TO_A8
     51 #define SK_GAMMA_EXPONENT 1.4
     52 #define SK_GAMMA_CONTRAST 0.0
     53 
     54 // Optimizations for chromium (m30)
     55 #define GR_GL_CUSTOM_SETUP_HEADER "gl/GrGLConfig_chrome.h"
     56 #define IGNORE_ROT_AA_RECT_OPT
     57 #define SKIA_IGNORE_GPU_MIPMAPS
     58 
     59 // Disable this check because it is too strict for some chromium-specific
     60 // subclasses of SkPixelRef. See bug: crbug.com/171776.
     61 #define SK_DISABLE_PIXELREF_LOCKCOUNT_BALANCE_CHECK
     62 
     63 // do this build check for other tools that still read this header
     64 #ifdef ANDROID
     65     #include <utils/misc.h>
     66 #endif
     67 
     68 #define SK_USE_POSIX_THREADS
     69 
     70 /*  Scalars (the fractional value type in skia) can be implemented either as
     71     floats or 16.16 integers (fixed). Exactly one of these two symbols must be
     72     defined.
     73 */
     74 #define SK_SCALAR_IS_FLOAT
     75 #undef SK_SCALAR_IS_FIXED
     76 
     77 
     78 /*  For some performance-critical scalar operations, skia will optionally work
     79     around the standard float operators if it knows that the CPU does not have
     80     native support for floats. If your environment uses software floating point,
     81     define this flag.
     82  */
     83 //#define SK_SOFTWARE_FLOAT
     84 
     85 
     86 /*  Skia has lots of debug-only code. Often this is just null checks or other
     87     parameter checking, but sometimes it can be quite intrusive (e.g. check that
     88     each 32bit pixel is in premultiplied form). This code can be very useful
     89     during development, but will slow things down in a shipping product.
     90 
     91     By default, these mutually exclusive flags are defined in SkPreConfig.h,
     92     based on the presence or absence of NDEBUG, but that decision can be changed
     93     here.
     94  */
     95 //#define SK_DEBUG
     96 //#define SK_RELEASE
     97 
     98 /*  Skia has certain debug-only code that is extremely intensive even for debug
     99     builds.  This code is useful for diagnosing specific issues, but is not
    100     generally applicable, therefore it must be explicitly enabled to avoid
    101     the performance impact. By default these flags are undefined, but can be
    102     enabled by uncommenting them below.
    103  */
    104 //#define SK_DEBUG_GLYPH_CACHE
    105 //#define SK_DEBUG_PATH
    106 
    107 /*  To assist debugging, Skia provides an instance counting utility in
    108     include/core/SkInstCount.h. This flag turns on and off that utility to
    109     allow instance count tracking in either debug or release builds. By
    110     default it is enabled in debug but disabled in release.
    111  */
    112 //#define SK_ENABLE_INST_COUNT 1
    113 
    114 /*  If, in debugging mode, Skia needs to stop (presumably to invoke a debugger)
    115     it will call SK_CRASH(). If this is not defined it, it is defined in
    116     SkPostConfig.h to write to an illegal address
    117  */
    118 //#define SK_CRASH() *(int *)(uintptr_t)0 = 0
    119 
    120 
    121 /*  preconfig will have attempted to determine the endianness of the system,
    122     but you can change these mutually exclusive flags here.
    123  */
    124 #if __BYTE_ORDER == __BIG_ENDIAN
    125     #define SK_CPU_BENDIAN
    126     #undef  SK_CPU_LENDIAN
    127 #else
    128     #define SK_CPU_LENDIAN
    129     #undef  SK_CPU_BENDIAN
    130 #endif
    131 
    132 /*  Most compilers use the same bit endianness for bit flags in a byte as the
    133     system byte endianness, and this is the default. If for some reason this
    134     needs to be overridden, specify which of the mutually exclusive flags to
    135     use. For example, some atom processors in certain configurations have big
    136     endian byte order but little endian bit orders.
    137 */
    138 //#define SK_UINT8_BITFIELD_BENDIAN
    139 //#define SK_UINT8_BITFIELD_LENDIAN
    140 
    141 
    142 /*  Some compilers don't support long long for 64bit integers. If yours does
    143     not, define this to the appropriate type.
    144  */
    145 #define SkLONGLONG int64_t
    146 
    147 
    148 /*  To write debug messages to a console, skia will call SkDebugf(...) following
    149     printf conventions (e.g. const char* format, ...). If you want to redirect
    150     this to something other than printf, define yours here
    151  */
    152 //#define SkDebugf(...)  MyFunction(__VA_ARGS__)
    153 
    154 /*
    155  *  To specify a different default font cache limit, define this. If this is
    156  *  undefined, skia will use a built-in value.
    157  */
    158 #define SK_DEFAULT_FONT_CACHE_LIMIT   (768 * 1024)
    159 
    160 /*
    161  *  To specify the default size of the image cache, undefine this and set it to
    162  *  the desired value (in bytes). SkGraphics.h as a runtime API to set this
    163  *  value as well. If this is undefined, a built-in value will be used.
    164  */
    165 //#define SK_DEFAULT_IMAGE_CACHE_LIMIT (1024 * 1024)
    166 
    167 /*  If zlib is available and you want to support the flate compression
    168     algorithm (used in PDF generation), define SK_ZLIB_INCLUDE to be the
    169     include path. Alternatively, define SK_SYSTEM_ZLIB to use the system zlib
    170     library specified as "#include <zlib.h>".
    171  */
    172 //#define SK_ZLIB_INCLUDE <zlib.h>
    173 //#define SK_SYSTEM_ZLIB
    174 
    175 /*  Define this to allow PDF scalars above 32k.  The PDF/A spec doesn't allow
    176     them, but modern PDF interpreters should handle them just fine.
    177  */
    178 //#define SK_ALLOW_LARGE_PDF_SCALARS
    179 
    180 /*  Define this to provide font subsetter in PDF generation.
    181  */
    182 #define SK_SFNTLY_SUBSETTER "sample/chromium/font_subsetter.h"
    183 
    184 /*  Define this to set the upper limit for text to support LCD. Values that
    185     are very large increase the cost in the font cache and draw slower, without
    186     improving readability. If this is undefined, Skia will use its default
    187     value (e.g. 48)
    188  */
    189 //#define SK_MAX_SIZE_FOR_LCDTEXT     48
    190 
    191 /*  If SK_DEBUG is defined, then you can optionally define SK_SUPPORT_UNITTEST
    192     which will run additional self-tests at startup. These can take a long time,
    193     so this flag is optional.
    194  */
    195 #ifdef SK_DEBUG
    196 //#define SK_SUPPORT_UNITTEST
    197 #endif
    198 
    199 /* If your system embeds skia and has complex event logging, define this
    200    symbol to name a file that maps the following macros to your system's
    201    equivalents:
    202        SK_TRACE_EVENT0(event)
    203        SK_TRACE_EVENT1(event, name1, value1)
    204        SK_TRACE_EVENT2(event, name1, value1, name2, value2)
    205    src/utils/SkDebugTrace.h has a trivial implementation that writes to
    206    the debug output stream. If SK_USER_TRACE_INCLUDE_FILE is not defined,
    207    SkTrace.h will define the above three macros to do nothing.
    208 */
    209 //#undef SK_USER_TRACE_INCLUDE_FILE
    210 
    211 /*  Change the ordering to work in X windows.
    212  */
    213 #ifdef SK_SAMPLES_FOR_X
    214         #define SK_R32_SHIFT    16
    215         #define SK_G32_SHIFT    8
    216         #define SK_B32_SHIFT    0
    217         #define SK_A32_SHIFT    24
    218 #endif
    219 
    220 
    221 /* Determines whether to build code that supports the GPU backend. Some classes
    222    that are not GPU-specific, such as SkShader subclasses, have optional code
    223    that is used allows them to interact with the GPU backend. If you'd like to
    224    omit this code set SK_SUPPORT_GPU to 0. This also allows you to omit the gpu
    225    directories from your include search path when you're not building the GPU
    226    backend. Defaults to 1 (build the GPU code).
    227  */
    228 //#define SK_SUPPORT_GPU 1
    229 
    230 /* The PDF generation code uses Path Ops to generate inverse fills and complex
    231  * clipping paths, but at this time, Path Ops is not release ready yet. So,
    232  * the code is hidden behind this #define guard. If you are feeling adventurous
    233  * and want the latest and greatest PDF generation code, uncomment the #define.
    234  * When Path Ops is release ready, the define guards and this user config
    235  * define should be removed entirely.
    236  */
    237 //#define SK_PDF_USE_PATHOPS
    238 
    239 #endif
    240