diff --git a/Dalamud/Interface/Textures/ISharedImmediateTexture.cs b/Dalamud/Interface/Textures/ISharedImmediateTexture.cs index 80a94e32b..591b9846c 100644 --- a/Dalamud/Interface/Textures/ISharedImmediateTexture.cs +++ b/Dalamud/Interface/Textures/ISharedImmediateTexture.cs @@ -64,8 +64,17 @@ public interface ISharedImmediateTexture /// Thrown when called outside the UI thread. bool TryGetWrap([NotNullWhen(true)] out IDalamudTextureWrap? texture, out Exception? exception); - /// Creates a new instance of holding a new reference to this texture. - /// The returned texture is guaranteed to be available until is called. + /// + /// + /// Creates a new instance of holding a new reference to this texture. + /// The returned texture is guaranteed to be available until is called. + /// + /// + /// WARNING! Usually, this method should be a "last resort"/compatibility wrapper for old code that does not + /// directly support directly. Prefer using any of the other methods if possible, + /// and DO NOT CACHE the resulting texture wrap from those functions. + /// + /// /// The cancellation token. /// A containing the loaded texture on success. ///