1 2 /* 3 * Copyright 2011 Google Inc. 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 #ifndef GrTexture_DEFINED 10 #define GrTexture_DEFINED 11 12 #include "GrBackendSurface.h" 13 #include "GrSamplerState.h" 14 #include "GrSurface.h" 15 #include "SkImage.h" 16 #include "SkPoint.h" 17 #include "SkRefCnt.h" 18 #include "../private/GrTypesPriv.h" 19 20 class GrTexturePriv; 21 22 class SK_API GrTexture : virtual public GrSurface { 23 public: asTexture()24 GrTexture* asTexture() override { return this; } asTexture()25 const GrTexture* asTexture() const override { return this; } 26 27 virtual GrBackendTexture getBackendTexture() const = 0; 28 29 /** 30 * This function indicates that the texture parameters (wrap mode, filtering, ...) have been 31 * changed externally to Skia. 32 */ 33 virtual void textureParamsModified() = 0; 34 35 /** 36 * This function steals the backend texture from a uniquely owned GrTexture with no pending 37 * IO, passing it out to the caller. The GrTexture is deleted in the process. 38 * 39 * Note that if the GrTexture is not uniquely owned (no other refs), or has pending IO, this 40 * function will fail. 41 */ 42 static bool StealBackendTexture(sk_sp<GrTexture>, 43 GrBackendTexture*, 44 SkImage::BackendTextureReleaseProc*); 45 46 #ifdef SK_DEBUG validate()47 void validate() const { 48 this->INHERITED::validate(); 49 } 50 #endif 51 52 /** 53 * Installs a proc on this texture. It will be called when the texture becomes "idle". Idle is 54 * defined to mean that the texture has no refs or pending IOs and that GPU I/O operations on 55 * the texture are completed if the backend API disallows deletion of a texture before such 56 * operations occur (e.g. Vulkan). After the idle proc is called it is removed. The idle proc 57 * will always be called before the texture is destroyed, even in unusual shutdown scenarios 58 * (e.g. GrContext::abandonContext()). 59 */ addIdleProc(sk_sp<GrRefCntedCallback> callback)60 virtual void addIdleProc(sk_sp<GrRefCntedCallback> callback) { 61 callback->addChild(std::move(fIdleCallback)); 62 fIdleCallback = std::move(callback); 63 } 64 65 /** Access methods that are only to be used within Skia code. */ 66 inline GrTexturePriv texturePriv(); 67 inline const GrTexturePriv texturePriv() const; 68 69 protected: 70 GrTexture(GrGpu*, const GrSurfaceDesc&, GrTextureType, GrMipMapsStatus); 71 72 virtual bool onStealBackendTexture(GrBackendTexture*, SkImage::BackendTextureReleaseProc*) = 0; 73 74 sk_sp<GrRefCntedCallback> fIdleCallback; 75 willRemoveLastRefOrPendingIO()76 void willRemoveLastRefOrPendingIO() override { 77 // We're about to be idle in the resource cache. Do our part to trigger the idle callback. 78 fIdleCallback.reset(); 79 } 80 81 private: 82 void computeScratchKey(GrScratchKey*) const override; 83 size_t onGpuMemorySize() const override; 84 void markMipMapsDirty(); 85 void markMipMapsClean(); 86 87 GrTextureType fTextureType; 88 GrMipMapsStatus fMipMapsStatus; 89 int fMaxMipMapLevel; 90 friend class GrTexturePriv; 91 92 typedef GrSurface INHERITED; 93 }; 94 95 #endif 96