CompressedTexture2D

The ordinary path is ResourceLoader.Load<Texture2D>("asset://art/icon.png"): it applies import remapping and returns the appropriate resource type. CompressedTexture2D.Load reads an existing .ctex rather than importing PNG. The class name does not guarantee VRAM block compression: the checked Lossless import returns accessible pixel data.

This complete executed helper obtains an independent instance through CacheMode.Ignore. Use it for independent loading; retain resources rather than loading and reading back GPU data every frame:

using System;
using Reckfell;

public static class IndependentImportedTexture
{
    public static CompressedTexture2D Load(string projectPath)
    {
        var texture = ResourceLoader.Load<Texture2D>(projectPath, cacheMode: ResourceLoader.CacheMode.Ignore);
        if (texture is CompressedTexture2D imported) return imported;
        texture?.Dispose();
        throw new InvalidOperationException("Expected an imported CompressedTexture2D resource.");
    }
}

GetLoadPath/LoadPath identify the internal imported file; ResourcePath can remain the source-asset path. Direct Load does not assign ResourcePath. Successful reload preserves RID and emits Changed. The LoadPath setter does not expose Error; use the method for error handling. A valid RID can be a placeholder before loading.

Known current inconsistency: HasAlpha() returns false even for a checked transparent RGBA pixel. This defect was reproduced; the engine was not fixed. Do not use HasAlpha as the sole test of actual alpha. Alpha-cache reset on another Load works: Sprite2D.IsPixelOpaque correctly updated after replacing transparent data with opaque data. Loading a separate new instance also worked correctly.

Actual Lossless import, GPU readback, paths, notifications, RID and reload were checked on Windows/Vulkan. Shader drawing, graphics quality, VRAM/Basis/Lossy, mipmapped/streamed imports and other backends were not tested.

Declarations checked against C# SDK 1.0.0. Expand a name to see declarations and documentation.

public CompressedTexture2D();

public string LoadPath { get; set; }

public string GetLoadPath();

public Error Load(string path);