1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/gfx/skia/trunk/include/gpu/GrTextureAccess.h Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,188 @@
1.4 +/*
1.5 + * Copyright 2012 Google Inc.
1.6 + *
1.7 + * Use of this source code is governed by a BSD-style license that can be
1.8 + * found in the LICENSE file.
1.9 + */
1.10 +
1.11 +#ifndef GrTextureAccess_DEFINED
1.12 +#define GrTextureAccess_DEFINED
1.13 +
1.14 +#include "SkRefCnt.h"
1.15 +#include "SkShader.h"
1.16 +#include "SkTypes.h"
1.17 +
1.18 +class GrTexture;
1.19 +
1.20 +/**
1.21 + * Represents the filtering and tile modes used to access a texture. It is mostly used with
1.22 + * GrTextureAccess (defined below). Also, some of the texture cache methods require knowledge about
1.23 + * filtering and tiling to perform a cache lookup. If it wasn't for this latter usage this would
1.24 + * be folded into GrTextureAccess. The default is clamp tile modes and no filtering.
1.25 + */
1.26 +class GrTextureParams {
1.27 +public:
1.28 + GrTextureParams() {
1.29 + this->reset();
1.30 + }
1.31 +
1.32 + enum FilterMode {
1.33 + kNone_FilterMode,
1.34 + kBilerp_FilterMode,
1.35 + kMipMap_FilterMode
1.36 + };
1.37 +
1.38 + GrTextureParams(SkShader::TileMode tileXAndY, FilterMode filterMode) {
1.39 + this->reset(tileXAndY, filterMode);
1.40 + }
1.41 +
1.42 + GrTextureParams(const SkShader::TileMode tileModes[2], FilterMode filterMode) {
1.43 + this->reset(tileModes, filterMode);
1.44 + }
1.45 +
1.46 + GrTextureParams(const GrTextureParams& params) {
1.47 + *this = params;
1.48 + }
1.49 +
1.50 + GrTextureParams& operator= (const GrTextureParams& params) {
1.51 + fTileModes[0] = params.fTileModes[0];
1.52 + fTileModes[1] = params.fTileModes[1];
1.53 + fFilterMode = params.fFilterMode;
1.54 + return *this;
1.55 + }
1.56 +
1.57 + void reset() {
1.58 + this->reset(SkShader::kClamp_TileMode, kNone_FilterMode);
1.59 + }
1.60 +
1.61 + void reset(SkShader::TileMode tileXAndY, FilterMode filterMode) {
1.62 + fTileModes[0] = fTileModes[1] = tileXAndY;
1.63 + fFilterMode = filterMode;
1.64 + }
1.65 +
1.66 + void reset(const SkShader::TileMode tileModes[2], FilterMode filterMode) {
1.67 + fTileModes[0] = tileModes[0];
1.68 + fTileModes[1] = tileModes[1];
1.69 + fFilterMode = filterMode;
1.70 + }
1.71 +
1.72 + void setClampNoFilter() {
1.73 + fTileModes[0] = fTileModes[1] = SkShader::kClamp_TileMode;
1.74 + fFilterMode = kNone_FilterMode;
1.75 + }
1.76 +
1.77 + void setClamp() {
1.78 + fTileModes[0] = fTileModes[1] = SkShader::kClamp_TileMode;
1.79 + }
1.80 +
1.81 + void setFilterMode(FilterMode filterMode) { fFilterMode = filterMode; }
1.82 +
1.83 + void setTileModeX(const SkShader::TileMode tm) { fTileModes[0] = tm; }
1.84 + void setTileModeY(const SkShader::TileMode tm) { fTileModes[1] = tm; }
1.85 + void setTileModeXAndY(const SkShader::TileMode tm) { fTileModes[0] = fTileModes[1] = tm; }
1.86 +
1.87 + SkShader::TileMode getTileModeX() const { return fTileModes[0]; }
1.88 +
1.89 + SkShader::TileMode getTileModeY() const { return fTileModes[1]; }
1.90 +
1.91 + bool isTiled() const {
1.92 + return SkShader::kClamp_TileMode != fTileModes[0] ||
1.93 + SkShader::kClamp_TileMode != fTileModes[1];
1.94 + }
1.95 +
1.96 + FilterMode filterMode() const { return fFilterMode; }
1.97 +
1.98 + bool operator== (const GrTextureParams& other) const {
1.99 + return fTileModes[0] == other.fTileModes[0] &&
1.100 + fTileModes[1] == other.fTileModes[1] &&
1.101 + fFilterMode == other.fFilterMode;
1.102 + }
1.103 +
1.104 + bool operator!= (const GrTextureParams& other) const { return !(*this == other); }
1.105 +
1.106 +private:
1.107 +
1.108 + SkShader::TileMode fTileModes[2];
1.109 + FilterMode fFilterMode;
1.110 +};
1.111 +
1.112 +/** A class representing the swizzle access pattern for a texture. Note that if the texture is
1.113 + * an alpha-only texture then the alpha channel is substituted for other components. Any mangling
1.114 + * to handle the r,g,b->a conversions for alpha textures is automatically included in the stage
1.115 + * key. However, if a GrEffect uses different swizzles based on its input then it must
1.116 + * consider that variation in its key-generation.
1.117 + */
1.118 +class GrTextureAccess : public SkNoncopyable {
1.119 +public:
1.120 + /**
1.121 + * A default GrTextureAccess must have reset() called on it in a GrEffect subclass's
1.122 + * constructor if it will be accessible via GrEffect::textureAccess().
1.123 + */
1.124 + GrTextureAccess();
1.125 +
1.126 + /**
1.127 + * Uses the default swizzle, "rgba".
1.128 + */
1.129 + GrTextureAccess(GrTexture*, const GrTextureParams&);
1.130 + explicit GrTextureAccess(GrTexture*,
1.131 + GrTextureParams::FilterMode = GrTextureParams::kNone_FilterMode,
1.132 + SkShader::TileMode tileXAndY = SkShader::kClamp_TileMode);
1.133 +
1.134 + /**
1.135 + * swizzle must be a string between one and four (inclusive) characters containing only 'r',
1.136 + * 'g', 'b', and/or 'a'.
1.137 + */
1.138 + GrTextureAccess(GrTexture*, const char* swizzle, const GrTextureParams&);
1.139 + GrTextureAccess(GrTexture*,
1.140 + const char* swizzle,
1.141 + GrTextureParams::FilterMode = GrTextureParams::kNone_FilterMode,
1.142 + SkShader::TileMode tileXAndY = SkShader::kClamp_TileMode);
1.143 +
1.144 + void reset(GrTexture*, const GrTextureParams&);
1.145 + void reset(GrTexture*,
1.146 + GrTextureParams::FilterMode = GrTextureParams::kNone_FilterMode,
1.147 + SkShader::TileMode tileXAndY = SkShader::kClamp_TileMode);
1.148 + void reset(GrTexture*, const char* swizzle, const GrTextureParams&);
1.149 + void reset(GrTexture*,
1.150 + const char* swizzle,
1.151 + GrTextureParams::FilterMode = GrTextureParams::kNone_FilterMode,
1.152 + SkShader::TileMode tileXAndY = SkShader::kClamp_TileMode);
1.153 +
1.154 + bool operator== (const GrTextureAccess& other) const {
1.155 +#ifdef SK_DEBUG
1.156 + // below assumes all chars in fSwizzle are initialized even if string is < 4 chars long.
1.157 + SkASSERT(memcmp(fSwizzle, other.fSwizzle, sizeof(fSwizzle)-1) ==
1.158 + strcmp(fSwizzle, other.fSwizzle));
1.159 +#endif
1.160 + return fParams == other.fParams &&
1.161 + (fTexture.get() == other.fTexture.get()) &&
1.162 + (0 == memcmp(fSwizzle, other.fSwizzle, sizeof(fSwizzle)-1));
1.163 + }
1.164 +
1.165 + bool operator!= (const GrTextureAccess& other) const { return !(*this == other); }
1.166 +
1.167 + GrTexture* getTexture() const { return fTexture.get(); }
1.168 +
1.169 + /**
1.170 + * Returns a string representing the swizzle. The string is is null-terminated.
1.171 + */
1.172 + const char* getSwizzle() const { return fSwizzle; }
1.173 +
1.174 + /** Returns a mask indicating which components are referenced in the swizzle. The return
1.175 + is a bitfield of GrColorComponentFlags. */
1.176 + uint32_t swizzleMask() const { return fSwizzleMask; }
1.177 +
1.178 + const GrTextureParams& getParams() const { return fParams; }
1.179 +
1.180 +private:
1.181 + void setSwizzle(const char*);
1.182 +
1.183 + GrTextureParams fParams;
1.184 + SkAutoTUnref<GrTexture> fTexture;
1.185 + uint32_t fSwizzleMask;
1.186 + char fSwizzle[5];
1.187 +
1.188 + typedef SkNoncopyable INHERITED;
1.189 +};
1.190 +
1.191 +#endif
