1 /*
2 * Copyright 2014 Google Inc.
3 *
4 * Use of this source code is governed by a BSD-style license that can be
5 * found in the LICENSE file.
6 */
7
8 #ifndef SkSurfaceProps_DEFINED
9 #define SkSurfaceProps_DEFINED
10
11 #include "SkTypes.h"
12
13 /**
14 * Description of how the LCD strips are arranged for each pixel. If this is unknown, or the
15 * pixels are meant to be "portable" and/or transformed before showing (e.g. rotated, scaled)
16 * then use kUnknown_SkPixelGeometry.
17 */
18 enum SkPixelGeometry {
19 kUnknown_SkPixelGeometry,
20 kRGB_H_SkPixelGeometry,
21 kBGR_H_SkPixelGeometry,
22 kRGB_V_SkPixelGeometry,
23 kBGR_V_SkPixelGeometry,
24 };
25
26 // Returns true iff geo is a known geometry and is RGB.
SkPixelGeometryIsRGB(SkPixelGeometry geo)27 static inline bool SkPixelGeometryIsRGB(SkPixelGeometry geo) {
28 return kRGB_H_SkPixelGeometry == geo || kRGB_V_SkPixelGeometry == geo;
29 }
30
31 // Returns true iff geo is a known geometry and is BGR.
SkPixelGeometryIsBGR(SkPixelGeometry geo)32 static inline bool SkPixelGeometryIsBGR(SkPixelGeometry geo) {
33 return kBGR_H_SkPixelGeometry == geo || kBGR_V_SkPixelGeometry == geo;
34 }
35
36 // Returns true iff geo is a known geometry and is horizontal.
SkPixelGeometryIsH(SkPixelGeometry geo)37 static inline bool SkPixelGeometryIsH(SkPixelGeometry geo) {
38 return kRGB_H_SkPixelGeometry == geo || kBGR_H_SkPixelGeometry == geo;
39 }
40
41 // Returns true iff geo is a known geometry and is vertical.
SkPixelGeometryIsV(SkPixelGeometry geo)42 static inline bool SkPixelGeometryIsV(SkPixelGeometry geo) {
43 return kRGB_V_SkPixelGeometry == geo || kBGR_V_SkPixelGeometry == geo;
44 }
45
46 /**
47 * Describes properties and constraints of a given SkSurface. The rendering engine can parse these
48 * during drawing, and can sometimes optimize its performance (e.g. disabling an expensive
49 * feature).
50 */
51 class SK_API SkSurfaceProps {
52 public:
53 enum Flags {
54 kDisallowAntiAlias_Flag = 1 << 0,
55 kDisallowDither_Flag = 1 << 1,
56 kUseDistanceFieldFonts_Flag = 1 << 2,
57 };
58 SkSurfaceProps(uint32_t flags, SkPixelGeometry);
59
60 enum InitType {
61 kLegacyFontHost_InitType
62 };
63 SkSurfaceProps(InitType);
64 SkSurfaceProps(uint32_t flags, InitType);
65 SkSurfaceProps(const SkSurfaceProps& other);
66
flags()67 uint32_t flags() const { return fFlags; }
pixelGeometry()68 SkPixelGeometry pixelGeometry() const { return fPixelGeometry; }
69
isDisallowAA()70 bool isDisallowAA() const { return SkToBool(fFlags & kDisallowAntiAlias_Flag); }
isDisallowDither()71 bool isDisallowDither() const { return SkToBool(fFlags & kDisallowDither_Flag); }
isUseDistanceFieldFonts()72 bool isUseDistanceFieldFonts() const { return SkToBool(fFlags & kUseDistanceFieldFonts_Flag); }
73
74 private:
75 SkSurfaceProps();
76
77 uint32_t fFlags;
78 SkPixelGeometry fPixelGeometry;
79 };
80
81 #endif
82