Texture2D.cs

浏览该文件的文档.

#if DIRECT3D11
using SharpDX.DXGI;
using SharpDX;
using SharpDX.Direct3D11;
#else
using Silk.NET.OpenGLES;
#endif
using System.Runtime.InteropServices;
using Engine.Media;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;
using Image = Engine.Media.Image;
 
namespace Engine.Graphics {
    public class Texture2D : GraphicsResource {
        int m_width;
        int m_height;
        ColorFormat m_colorFormat;
        int m_mipLevelsCount;
        object m_tag;
        string m_debugName;
#if DIRECT3D11
        public SharpDX.Direct3D11.Texture2D m_texture;
        public ShaderResourceView m_textureView;
 
        public IntPtr NativeHandle => m_texture.NativePointer;
#else
        public int m_texture;
        public PixelFormat m_pixelFormat;
        public PixelType m_pixelType;
 
        public IntPtr NativeHandle => m_texture;
#endif
 
        public string DebugName {
            get {
#if DIRECT3D11
                return m_texture.DebugName;
#else
                return m_debugName;
#endif
            }
            set {
#if DIRECT3D11
                m_texture.DebugName = value;
#else
                m_debugName = value;
#endif
            }
        }
 
        public int Width {
            get => m_width;
            set => m_width = value;
        }
 
        public int Height {
            get => m_height;
            set => m_height = value;
        }
 
        public ColorFormat ColorFormat {
            get => m_colorFormat;
            set => m_colorFormat = value;
        }
 
        public int MipLevelsCount {
            get => m_mipLevelsCount;
            set => m_mipLevelsCount = value;
        }
 
        public object Tag {
            get => m_tag;
            set => m_tag = value;
        }
 
        public Texture2D() { }
 
        public Texture2D(int width, int height, int mipLevelsCount, ColorFormat colorFormat) {
            InitializeTexture2D(width, height, mipLevelsCount, colorFormat);
#if !DIRECT3D11
            switch (ColorFormat) {
                case ColorFormat.Rgba8888:
                    m_pixelFormat = PixelFormat.Rgba;
                    m_pixelType = PixelType.UnsignedByte;
                    break;
                case ColorFormat.Rgb565:
                    m_pixelFormat = PixelFormat.Rgb;
                    m_pixelType = PixelType.UnsignedShort565;
                    break;
                case ColorFormat.Rgba5551:
                    m_pixelFormat = PixelFormat.Rgba;
                    m_pixelType = PixelType.UnsignedShort5551;
                    break;
                case ColorFormat.R8:
                    m_pixelFormat = (PixelFormat)6409; // GL_LUMINANCE, avoid warning "Deprecated in version 3.2"
                    m_pixelType = PixelType.UnsignedByte;
                    break;
                default: throw new InvalidOperationException("Unsupported surface format.");
            }
#endif
            AllocateTexture();
        }
 
        public override void Dispose() {
            base.Dispose();
            DeleteTexture();
        }
 
        public virtual void SetData<T>(int mipLevel, T[] source, int sourceStartIndex = 0) where T : unmanaged {
            VerifyParametersSetData(mipLevel, source, sourceStartIndex);
            GCHandle gCHandle = GCHandle.Alloc(source, GCHandleType.Pinned);
            try {
                int num = Utilities.SizeOf<T>();
                SetDataInternal(mipLevel, gCHandle.AddrOfPinnedObject() + sourceStartIndex * num);
            }
            finally {
                gCHandle.Free();
            }
        }
 
        public virtual void SetData(int mipLevel, nint source) {
            VerifyParametersSetData(mipLevel, source);
            SetDataInternal(mipLevel, source);
        }
 
        public virtual void SetDataInternal(int mipLevel, nint source) {
#if DIRECT3D11
            int num = ColorFormat.GetSize() * Math.Max(Width >> mipLevel, 1);
            DataBox dataBox = new(source, num, 0);
            DXWrapper.Context.UpdateSubresource(dataBox, m_texture, mipLevel);
#else
            int width = MathUtils.Max(Width >> mipLevel, 1);
            int height = MathUtils.Max(Height >> mipLevel, 1);
            GLWrapper.BindTexture(TextureTarget.Texture2D, m_texture, false);
            GLWrapper.GL.TexImage2D(
                TextureTarget.Texture2D,
                mipLevel,
                (InternalFormat)m_pixelFormat,
                (uint)width,
                (uint)height,
                0,
                m_pixelFormat,
                m_pixelType,
                in source
            );
#endif
        }
 
        public virtual unsafe void SetDataInternal(int mipLevel, void* source) {
#if DIRECT3D11
            int num = ColorFormat.GetSize() * Math.Max(Width >> mipLevel, 1);
            DataBox dataBox = new((nint)source, num, 0);
            DXWrapper.Context.UpdateSubresource(dataBox, m_texture, mipLevel);
#else
            int width = MathUtils.Max(Width >> mipLevel, 1);
            int height = MathUtils.Max(Height >> mipLevel, 1);
            GLWrapper.BindTexture(TextureTarget.Texture2D, m_texture, false);
            GLWrapper.GL.TexImage2D(
                TextureTarget.Texture2D,
                mipLevel,
                (InternalFormat)m_pixelFormat,
                (uint)width,
                (uint)height,
                0,
                m_pixelFormat,
                m_pixelType,
                source
            );
#endif
        }
 
        public virtual void SetData(Image<Rgba32> source) {
            SetData(0, source);
        }
 
        public virtual unsafe void SetData(int mipLevel, Image<Rgba32> source) {
            VerifyParametersSetData(source);
            source.DangerousTryGetSinglePixelMemory(out Memory<Rgba32> memory);
            SetDataInternal(mipLevel, memory.Pin().Pointer);
        }
 
        public static void Swap(Texture2D texture1, Texture2D texture2) {
            VerifyParametersSwap(texture1, texture2);
            SwapTexture2D(texture1, texture2);
            Utilities.Swap(ref texture1.m_texture, ref texture2.m_texture);
#if DIRECT3D11
            Utilities.Swap(ref texture1.m_textureView, ref texture2.m_textureView);
#else
            Utilities.Swap(ref texture1.m_pixelFormat, ref texture2.m_pixelFormat);
            Utilities.Swap(ref texture1.m_pixelType, ref texture2.m_pixelType);
#endif
            Utilities.Swap(ref texture1.m_debugName, ref texture2.m_debugName);
        }
 
        public static void SwapTexture2D(Texture2D texture1, Texture2D texture2) {
            Utilities.Swap(ref texture1.m_width, ref texture2.m_width);
            Utilities.Swap(ref texture1.m_height, ref texture2.m_height);
            Utilities.Swap(ref texture1.m_colorFormat, ref texture2.m_colorFormat);
            Utilities.Swap(ref texture1.m_mipLevelsCount, ref texture2.m_mipLevelsCount);
            Utilities.Swap(ref texture1.m_tag, ref texture2.m_tag);
        }
 
        public override void HandleDeviceLost() {
            DeleteTexture();
        }
 
        public override void HandleDeviceReset() {
            AllocateTexture();
        }
 
        public virtual void AllocateTexture() {
#if DIRECT3D11
            bool flag = this is RenderTarget2D || MipLevelsCount > 1;
            Texture2DDescription texture2DDescription = new() {
                ArraySize = 1,
                BindFlags = flag ? BindFlags.ShaderResource | BindFlags.RenderTarget : BindFlags.ShaderResource,
                CpuAccessFlags = CpuAccessFlags.None,
                Format = DXWrapper.TranslateColorFormat(ColorFormat),
                MipLevels = MipLevelsCount,
                OptionFlags = flag ? ResourceOptionFlags.GenerateMipMaps : ResourceOptionFlags.None,
                SampleDescription = new SampleDescription(1, 0),
                Usage = ResourceUsage.Default,
                Width = Width,
                Height = Height
            };
            m_texture = new SharpDX.Direct3D11.Texture2D(DXWrapper.Device, texture2DDescription);
            m_textureView = new ShaderResourceView(DXWrapper.Device, m_texture);
#else
            unsafe {
                GLWrapper.GL.GenTextures(1, out uint texture);
                m_texture = (int)texture;
                GLWrapper.BindTexture(TextureTarget.Texture2D, m_texture, false);
                for (int i = 0; i < MipLevelsCount; i++) {
                    int width = MathUtils.Max(Width >> i, 1);
                    int height = MathUtils.Max(Height >> i, 1);
                    GLWrapper.GL.TexImage2D(
                        TextureTarget.Texture2D,
                        i,
                        (InternalFormat)m_pixelFormat,
                        (uint)width,
                        (uint)height,
                        0,
                        m_pixelFormat,
                        m_pixelType,
                        null
                    );
                }
            }
#endif
        }
 
        public void DeleteTexture() {
#if DIRECT3D11
            Utilities.Dispose(ref m_texture);
            Utilities.Dispose(ref m_textureView);
#else
            if (m_texture != 0) {
                GLWrapper.DeleteTexture(m_texture);
                m_texture = 0;
            }
#endif
        }
 
        public override int GetGpuMemoryUsage() {
            int num = 0;
            for (int i = 0; i < MipLevelsCount; i++) {
                int num2 = MathUtils.Max(Width >> i, 1);
                int num3 = MathUtils.Max(Height >> i, 1);
                num += ColorFormat.GetSize() * num2 * num3;
            }
            return num;
        }
 
        public static Texture2D Load(LegacyImage image, int mipLevelsCount = 1) {
            Texture2D texture2D = new(image.Width, image.Height, mipLevelsCount, ColorFormat.Rgba8888);
            if (mipLevelsCount > 1) {
                LegacyImage[] array = LegacyImage.GenerateMipmaps(image, mipLevelsCount).ToArray();
                for (int i = 0; i < array.Length; i++) {
                    texture2D.SetData(i, array[i].Pixels);
                }
            }
            else {
                texture2D.SetData(0, image.Pixels);
            }
            texture2D.Tag = image;
            return texture2D;
        }
 
        public static Texture2D Load(Image image, int mipLevelsCount = 1) {
            Texture2D texture2D = new(image.Width, image.Height, mipLevelsCount, ColorFormat.Rgba8888);
            texture2D.SetData(image.m_trueImage);
            if (mipLevelsCount > 1) {
#if DIRECT3D11
                DXWrapper.Context.GenerateMips(texture2D.m_textureView);
#else
                GLWrapper.BindTexture(TextureTarget.Texture2D, texture2D.m_texture, false);
                GLWrapper.GL.GenerateMipmap(TextureTarget.Texture2D);
#endif
            }
            texture2D.Tag = image;
            return texture2D;
        }
 
        public static Texture2D Load(Image<Rgba32> image, int mipLevelsCount = 1) {
            Texture2D texture2D = new(image.Width, image.Height, mipLevelsCount, ColorFormat.Rgba8888);
            texture2D.SetData(image);
            if (mipLevelsCount > 1) {
#if DIRECT3D11
                DXWrapper.Context.GenerateMips(texture2D.m_textureView);
#else
                GLWrapper.BindTexture(TextureTarget.Texture2D, texture2D.m_texture, false);
                GLWrapper.GL.GenerateMipmap(TextureTarget.Texture2D);
#endif
            }
            texture2D.Tag = new Image(image);
            return texture2D;
        }
 
        public static Texture2D Load(Stream stream, bool premultiplyAlpha = false, int mipLevelsCount = 1) {
            Image image = Image.Load(stream);
            if (premultiplyAlpha) {
                Image.PremultiplyAlpha(image);
            }
            return Load(image, mipLevelsCount);
        }
 
        public static Texture2D Load(string fileName, bool premultiplyAlpha = false, int mipLevelsCount = 1) {
            using (Stream stream = Storage.OpenFile(fileName, OpenFileMode.Read)) {
                return Load(stream, premultiplyAlpha, mipLevelsCount);
            }
        }
 
        public static Texture2D Load(Color color, int width, int height) {
            Texture2D texture2D = new(width, height, 1, ColorFormat.Rgba8888);
            Color[] array = new Color[width * height];
            for (int i = 0; i < array.Length; i++) {
                array[i] = color;
            }
            texture2D.SetData(0, array);
            return texture2D;
        }
 
        public virtual void InitializeTexture2D(int width, int height, int mipLevelsCount, ColorFormat colorFormat) {
            if (width < 1) {
                throw new ArgumentOutOfRangeException(nameof(width));
            }
            if (height < 1) {
                throw new ArgumentOutOfRangeException(nameof(height));
            }
            if (mipLevelsCount < 1) {
                throw new ArgumentOutOfRangeException(nameof(mipLevelsCount));
            }
            if (colorFormat == ColorFormat.LinearLDR || colorFormat == ColorFormat.SrgbLDR) {
                throw new ArgumentException(nameof(colorFormat));
            }
            Width = width;
            Height = height;
            ColorFormat = colorFormat;
            if (mipLevelsCount > 1) {
                int num = 0;
                for (int num2 = MathUtils.Max(width, height); num2 >= 1; num2 /= 2) {
                    num++;
                }
                MipLevelsCount = MathUtils.Min(num, mipLevelsCount);
            }
            else {
                MipLevelsCount = 1;
            }
        }
 
        public virtual void VerifyParametersSetData<T>(int mipLevel, T[] source, int sourceStartIndex = 0) where T : unmanaged {
            VerifyNotDisposed();
            int num = Utilities.SizeOf<T>();
            int size = ColorFormat.GetSize();
            int num2 = MathUtils.Max(Width >> mipLevel, 1);
            int num3 = MathUtils.Max(Height >> mipLevel, 1);
            int num4 = size * num2 * num3;
            ArgumentNullException.ThrowIfNull(source);
            if (mipLevel < 0
                || mipLevel >= MipLevelsCount) {
                throw new ArgumentOutOfRangeException(nameof(mipLevel));
            }
            if (num > size) {
                throw new ArgumentException("Source array element size is larger than pixel size.");
            }
            if (size % num != 0) {
                throw new ArgumentException("Pixel size is not an integer multiple of source array element size.");
            }
            if (sourceStartIndex < 0
                || (source.Length - sourceStartIndex) * num < num4) {
                throw new InvalidOperationException("Not enough data in source array.");
            }
        }
 
        public virtual void VerifyParametersSetData(int mipLevel, nint source) {
            VerifyNotDisposed();
            if (source == IntPtr.Zero) {
                throw new ArgumentNullException(nameof(source));
            }
            if (mipLevel < 0
                || mipLevel >= MipLevelsCount) {
                throw new ArgumentOutOfRangeException(nameof(mipLevel));
            }
        }
 
        static void VerifyParametersSwap(Texture2D texture1, Texture2D texture2) {
            if (texture1 == null) {
                throw new ArgumentNullException(nameof(texture1));
            }
            if (texture2 == null) {
                throw new ArgumentNullException(nameof(texture2));
            }
            if (texture1.GetType() != typeof(Texture2D)) {
                throw new ArgumentException("texture1");
            }
            if (texture2.GetType() != typeof(Texture2D)) {
                throw new ArgumentException("texture2");
            }
            texture1.VerifyNotDisposed();
            texture2.VerifyNotDisposed();
        }
 
        void VerifyParametersSetData(Image<Rgba32> source) {
            VerifyNotDisposed();
            ArgumentNullException.ThrowIfNull(source);
        }
    }
}