Add a simpler key type for scratch resource keys.

include/gpu/GrResourceKey.h

 
 /*
  * Copyright 2014 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef GrResourceKey_DEFINED
 #define GrResourceKey_DEFINED
 
 #include "GrTypes.h"
+#include "SkTemplates.h"
 #include "GrBinHashKey.h"
 
+/**
+ * A key used for scratch resources. The key consists of a resource type (subclass) identifier, a
+ * hash, a data length, and type-specific data. A Builder object is used to initialize the
+ * key contents. The contents must be initialized before the key can be used.
+ */
+class GrScratchKey {
+public:
+    /** Uniquely identifies the type of resource that is cached as scratch. */
+    typedef uint32_t ResourceType;
+    /** Generate a unique ResourceType. */
+    static ResourceType GenerateResourceType();
+
+    GrScratchKey() { this->reset(); }
+    GrScratchKey(const GrScratchKey& that) { *this = that; }
+
+    /** Reset to an invalid key. */
+    void reset() {
+        fKey.reset(kExtraDataCnt);
+        fKey[kHashIdx] = 0;
+        fKey[kTypeAndSizeIdx] = kInvalidResourceType;
+    }
+
+    bool isValid() const { return kInvalidResourceType != this->resourceType(); }
+
+    ResourceType resourceType() const { return fKey[kTypeAndSizeIdx] & 0xffff; }
+
+    uint32_t hash() const { return fKey[kHashIdx]; }
+
+    size_t size() const { return SkToInt(fKey[kTypeAndSizeIdx] >> 16); }
+
+    const uint32_t* data() const { return &fKey[kExtraDataCnt]; }
+
+    GrScratchKey& operator=(const GrScratchKey& that) {
+        size_t size = that.size();
+        fKey.reset(SkToInt(size));
+        memcpy(fKey.get(), that.fKey.get(), size);
+        return *this;
+    }
+
+    bool operator==(const GrScratchKey& that) const {
+        return 0 == memcmp(fKey.get(), that.fKey.get(), this->size());
+    }
+    bool operator!=(const GrScratchKey& that) const { return !(*this == that); }
+
+    /** Used to initialize scratch key. */
+    class Builder {
+    public:
+        Builder(GrScratchKey* key, ResourceType type, int data32Count) : fKey(key) {
+            SkASSERT(data32Count >= 0);
+            SkASSERT(type != kInvalidResourceType);
+            key->fKey.reset(kExtraDataCnt + data32Count);
+            SkASSERT(type <= SK_MaxU16);
+            int size = (data32Count + kExtraDataCnt) * sizeof(uint32_t);
+            SkASSERT(size <= SK_MaxU16);
+            key->fKey[kTypeAndSizeIdx] = type | (size << 16);
+        }
+
+        ~Builder() { this->finish(); }
+
+        void finish();
+
+        uint32_t& operator[](int dataIdx) {
+            SkASSERT(fKey);
+            SkDEBUGCODE(size_t dataCount = fKey->size() / sizeof(uint32_t) - kExtraDataCnt;)
+            SkASSERT(SkToU32(dataIdx) < dataCount);
+            return fKey->fKey[kExtraDataCnt + dataIdx];
+        }
+
+    private:
+        GrScratchKey* fKey;
+    };
+
+private:

[robertphillips, 2014/12/30 18:19:52]

This enum is a bit mixed. Would it make more sense for kInvalidResourceType be a
separate "static const int" decl, the two k*Idx guys be the real members of the
enum and then kExtraDataCnt be computed from a new "kLastIdx" enum member?

[bsalomon, 2014/12/30 18:37:09]

Done.

+    enum {
+        kInvalidResourceType = 1,
+        kExtraDataCnt = 2,
+        kHashIdx = 0,

[robertphillips, 2014/12/30 18:19:52]

// type and size are folded together into one 32-bit entry ?

[bsalomon, 2014/12/30 18:37:09]

Done.

+        kTypeAndSizeIdx = 1,
+    };

[robertphillips, 2014/12/30 18:19:52]

// 2 b.c. the stencil and texture resource both require 2 ints of data for their
keys

?

[bsalomon, 2014/12/30 18:37:09]

Done.

+    SkAutoSTArray<kExtraDataCnt + 2, uint32_t> fKey;
+};
+
 class GrResourceKey {
 public:
-    static GrCacheID::Domain ScratchDomain();
-
-    /** Uniquely identifies the GrGpuResource subclass in the key to avoid collisions
-        across resource types. */
-    typedef uint8_t ResourceType;
-
     /** Flags set by the GrGpuResource subclass. */
     typedef uint8_t ResourceFlags;
 
-    /** Generate a unique ResourceType */
-    static ResourceType GenerateResourceType();
-
     /** Creates a key for resource */
-    GrResourceKey(const GrCacheID& id, ResourceType type, ResourceFlags flags) {
-        this->init(id.getDomain(), id.getKey(), type, flags);
+    GrResourceKey(const GrCacheID& id, ResourceFlags flags) {
+        this->init(id.getDomain(), id.getKey(), flags);
     };
 
     GrResourceKey(const GrResourceKey& src) { fKey = src.fKey; }
 
     GrResourceKey() { fKey.reset(); }
 
-    void reset(const GrCacheID& id, ResourceType type, ResourceFlags flags) {
-        this->init(id.getDomain(), id.getKey(), type, flags);
+    void reset(const GrCacheID& id, ResourceFlags flags) {
+        this->init(id.getDomain(), id.getKey(), flags);
     }
 
     uint32_t getHash() const { return fKey.getHash(); }
 
-    bool isScratch() const {
-        return ScratchDomain() ==
-            *reinterpret_cast<const GrCacheID::Domain*>(fKey.getData() +
-                                                        kCacheIDDomainOffset);
-    }
-
-    ResourceType getResourceType() const {
-        return *reinterpret_cast<const ResourceType*>(fKey.getData() +
-                                                      kResourceTypeOffset);
-    }
-
     ResourceFlags getResourceFlags() const {
         return *reinterpret_cast<const ResourceFlags*>(fKey.getData() +
                                                        kResourceFlagsOffset);
     }
 
     bool operator==(const GrResourceKey& other) const { return fKey == other.fKey; }
 
     // A key indicating that the resource is not usable as a scratch resource.
     static GrResourceKey& NullScratchKey();
 
-    bool isNullScratch() const {
-        return this->isScratch() && NoneResourceType() == this->getResourceType();
-    }
-
 private:
     enum {
         kCacheIDKeyOffset = 0,
         kCacheIDDomainOffset = kCacheIDKeyOffset + sizeof(GrCacheID::Key),
-        kResourceTypeOffset = kCacheIDDomainOffset + sizeof(GrCacheID::Domain),
-        kResourceFlagsOffset = kResourceTypeOffset + sizeof(ResourceType),
+        kResourceFlagsOffset = kCacheIDDomainOffset + sizeof(GrCacheID::Domain),
         kPadOffset = kResourceFlagsOffset + sizeof(ResourceFlags),
         kKeySize = SkAlign4(kPadOffset),
         kPadSize = kKeySize - kPadOffset
     };
 
-    static ResourceType NoneResourceType();
-
-    void init(const GrCacheID::Domain domain,
-              const GrCacheID::Key& key,
-              ResourceType type,
-              ResourceFlags flags) {
+    void init(const GrCacheID::Domain domain, const GrCacheID::Key& key, ResourceFlags flags) {
         union {
             uint8_t  fKey8[kKeySize];
             uint32_t fKey32[kKeySize / 4];
         } keyData;
 
         uint8_t* k = keyData.fKey8;
         memcpy(k + kCacheIDKeyOffset, key.fData8, sizeof(GrCacheID::Key));
         memcpy(k + kCacheIDDomainOffset, &domain, sizeof(GrCacheID::Domain));
-        memcpy(k + kResourceTypeOffset, &type, sizeof(ResourceType));
         memcpy(k + kResourceFlagsOffset, &flags, sizeof(ResourceFlags));
         memset(k + kPadOffset, 0, kPadSize);
         fKey.setKeyData(keyData.fKey32);
     }
     GrBinHashKey<kKeySize> fKey;
 };
 
 #endif