Files
Misaki.HighPerformance/Misaki.HighPerformance.Image/ImageResult.cs
2026-03-30 12:47:29 +09:00

109 lines
2.8 KiB
C#

using Misaki.HighPerformance.Image.Runtime;
using System;
using System.Collections.Generic;
using System.IO;
namespace Misaki.HighPerformance.Image;
/// <summary>
/// Represents the result of loading an image, including pixel data and image metadata.
/// </summary>
/// <remarks>The image data is stored as a contiguous block of unmanaged memory and must be released by calling
/// <see cref="Dispose"/> when no longer needed. Be careful that this struct won't stop your double free if you copy it.
/// Ensure to have proper ownership management when using this struct.</remarks>
public readonly unsafe struct ImageResult : IDisposable
{
public byte* Data
{
get; init;
}
public uint Width
{
get; init;
}
public uint Height
{
get; init;
}
public ColorComponents SourceComp
{
get; init;
}
public ColorComponents Comp
{
get; init;
}
public ulong Size
{
get
{
if (Data == null)
{
return 0;
}
return (ulong)(Width * Height * (int)Comp);
}
}
internal static ImageResult FromResult(byte* result, uint width, uint height, ColorComponents comp, ColorComponents req_comp)
{
if (result == null)
{
throw new InvalidOperationException(StbImage.stbi__g_failure_reason);
}
var image = new ImageResult
{
Data = result,
Width = width,
Height = height,
SourceComp = comp,
Comp = req_comp == ColorComponents.Default ? comp : req_comp
};
return image;
}
public static ImageResult FromStream(Stream stream,
ColorComponents requiredComponents = ColorComponents.Default)
{
int x, y, comp;
var context = new StbImage.stbi__context(stream);
var result = StbImage.stbi__load_and_postprocess_8bit(context, &x, &y, &comp, (int)requiredComponents);
return FromResult(result, (uint)x, (uint)y, (ColorComponents)comp, requiredComponents);
}
public static ImageResult FromMemory(byte[] data, ColorComponents requiredComponents = ColorComponents.Default)
{
using var stream = new MemoryStream(data);
return FromStream(stream, requiredComponents);
}
public static IEnumerable<AnimatedFrameResult> AnimatedGifFramesFromStream(Stream stream,
ColorComponents requiredComponents = ColorComponents.Default)
{
return new AnimatedGifEnumerable(stream, requiredComponents);
}
public Span<byte> AsSpan()
{
if (Data == null)
{
return Span<byte>.Empty;
}
return new Span<byte>(Data, (int)Size);
}
public void Dispose()
{
CRuntime.free(Data);
}
}