123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157 |
- /*
- * Copyright 2016 Google Inc.
- *
- * Use of this source code is governed by a BSD-style license that can be
- * found in the LICENSE file.
- */
- #ifndef GrTextureProxy_DEFINED
- #define GrTextureProxy_DEFINED
- #include "include/gpu/GrSamplerState.h"
- #include "src/gpu/GrSurfaceProxy.h"
- class GrCaps;
- class GrDeferredProxyUploader;
- class GrProxyProvider;
- class GrResourceProvider;
- class GrTextureOpList;
- class GrTextureProxyPriv;
- // This class delays the acquisition of textures until they are actually required
- class GrTextureProxy : virtual public GrSurfaceProxy {
- public:
- GrTextureProxy* asTextureProxy() override { return this; }
- const GrTextureProxy* asTextureProxy() const override { return this; }
- // Actually instantiate the backing texture, if necessary
- bool instantiate(GrResourceProvider*) override;
- GrSamplerState::Filter highestFilterMode() const;
- // If we are instantiated and have a target, return the mip state of that target. Otherwise
- // returns the proxy's mip state from creation time. This is useful for lazy proxies which may
- // claim to not need mips at creation time, but the instantiation happens to give us a mipped
- // target. In that case we should use that for our benefit to avoid possible copies/mip
- // generation later.
- GrMipMapped mipMapped() const;
- // Returns the GrMipMapped value of the proxy from creation time regardless of whether it has
- // been instantiated or not.
- GrMipMapped proxyMipMapped() const { return fMipMapped; }
- GrTextureType textureType() const { return this->backendFormat().textureType(); }
- /** If true then the texture does not support MIP maps and only supports clamp wrap mode. */
- bool hasRestrictedSampling() const {
- return GrTextureTypeHasRestrictedSampling(this->textureType());
- }
- // Returns true if the passed in proxies can be used as dynamic state together when flushing
- // draws to the gpu.
- static bool ProxiesAreCompatibleAsDynamicState(const GrTextureProxy* first,
- const GrTextureProxy* second);
- /**
- * Return the texture proxy's unique key. It will be invalid if the proxy doesn't have one.
- */
- const GrUniqueKey& getUniqueKey() const {
- #ifdef SK_DEBUG
- if (this->isInstantiated() && fUniqueKey.isValid() && fSyncTargetKey) {
- GrSurface* surface = this->peekSurface();
- SkASSERT(surface);
- SkASSERT(surface->getUniqueKey().isValid());
- // It is possible for a non-keyed proxy to have a uniquely keyed resource assigned to
- // it. This just means that a future user of the resource will be filling it with unique
- // data. However, if the proxy has a unique key its attached resource should also
- // have that key.
- SkASSERT(fUniqueKey == surface->getUniqueKey());
- }
- #endif
- return fUniqueKey;
- }
- /**
- * Internal-only helper class used for manipulations of the resource by the cache.
- */
- class CacheAccess;
- inline CacheAccess cacheAccess();
- inline const CacheAccess cacheAccess() const;
- // Provides access to special purpose functions.
- GrTextureProxyPriv texPriv();
- const GrTextureProxyPriv texPriv() const;
- protected:
- // DDL TODO: rm the GrSurfaceProxy friending
- friend class GrSurfaceProxy; // for ctors
- friend class GrProxyProvider; // for ctors
- friend class GrTextureProxyPriv;
- friend class GrSurfaceProxyPriv; // ability to change key sync state after lazy instantiation.
- // Deferred version - no data.
- GrTextureProxy(const GrBackendFormat&, const GrSurfaceDesc& srcDesc, GrSurfaceOrigin,
- GrMipMapped, const GrSwizzle& textureSwizzle, SkBackingFit, SkBudgeted,
- GrProtected, GrInternalSurfaceFlags);
- // Lazy-callback version
- // There are two main use cases for lazily-instantiated proxies:
- // basic knowledge - width, height, config, origin are known
- // minimal knowledge - only config is known.
- //
- // The basic knowledge version is used for DDL where we know the type of proxy we are going to
- // use, but we don't have access to the GPU yet to instantiate it.
- //
- // The minimal knowledge version is used for CCPR where we are generating an atlas but we do not
- // know the final size until flush time.
- GrTextureProxy(LazyInstantiateCallback&&, LazyInstantiationType, const GrBackendFormat&,
- const GrSurfaceDesc& desc, GrSurfaceOrigin, GrMipMapped, const GrSwizzle&,
- SkBackingFit, SkBudgeted, GrProtected, GrInternalSurfaceFlags);
- // Wrapped version
- GrTextureProxy(sk_sp<GrSurface>, GrSurfaceOrigin, const GrSwizzle&);
- ~GrTextureProxy() override;
- sk_sp<GrSurface> createSurface(GrResourceProvider*) const override;
- void setTargetKeySync(bool sync) { fSyncTargetKey = sync; }
- private:
- // WARNING: Be careful when adding or removing fields here. ASAN is likely to trigger warnings
- // when instantiating GrTextureRenderTargetProxy. The std::function in GrSurfaceProxy makes
- // each class in the diamond require 16 byte alignment. Clang appears to layout the fields for
- // each class to achieve the necessary alignment. However, ASAN checks the alignment of 'this'
- // in the constructors, and always looks for the full 16 byte alignment, even if the fields in
- // that particular class don't require it. Changing the size of this object can move the start
- // address of other types, leading to this problem.
- GrMipMapped fMipMapped;
- bool fSyncTargetKey = true; // Should target's unique key be sync'ed with ours.
- GrUniqueKey fUniqueKey;
- GrProxyProvider* fProxyProvider; // only set when fUniqueKey is valid
- // Only used for proxies whose contents are being prepared on a worker thread. This object
- // stores the texture data, allowing the proxy to remain uninstantiated until flush. At that
- // point, the proxy is instantiated, and this data is used to perform an ASAP upload.
- std::unique_ptr<GrDeferredProxyUploader> fDeferredUploader;
- size_t onUninstantiatedGpuMemorySize() const override;
- // Methods made available via GrTextureProxy::CacheAccess
- void setUniqueKey(GrProxyProvider*, const GrUniqueKey&);
- void clearUniqueKey();
- SkDEBUGCODE(void onValidateSurface(const GrSurface*) override;)
- // For wrapped proxies the GrTexture pointer is stored in GrIORefProxy.
- // For deferred proxies that pointer will be filled in when we need to instantiate
- // the deferred resource
- typedef GrSurfaceProxy INHERITED;
- };
- #endif
|