conco/OpenMaidEngine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

Decode color drag-pan cursor

Browse Source
This commit is contained in:
gamer147
2026-07-21 13:14:02 -04:00
parent 44bbf5b6b4
commit b0971f2047
5 changed files with 83 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
engine/Age.Engine.Tests/CurDecoderTests.cs
View File

@@ -22,7 +22,36 @@ public class CurDecoderTests
Assert.Contains(cursor.Image.Pixels.Where((_, i) => i % 4 == 3), alpha => alpha == 255);
}
[Fact]
public void HimegariPanCursor_DecodesFourBitPixelsAndHotspot()
{
var resources = ResourceMap.Load();
var entry = resources.ResolveCursor(0x32ce);
Assert.NotNull(entry);
Assert.Equal("CURSOR09.CUR", entry!.Name);
var cursor = resources.DecodeCursor(entry);
Assert.Equal(32, cursor.Image.Width);
Assert.Equal(32, cursor.Image.Height);
Assert.Equal(16, cursor.HotspotX);
Assert.Equal(14, cursor.HotspotY);
AssertPixel(cursor.Image, 0, 0, 0, 0, 0, 0);
AssertPixel(cursor.Image, 10, 10, 128, 128, 128, 255);
AssertPixel(cursor.Image, 12, 24, 0, 0, 128, 255);
}
[Fact]
public void TruncatedCursor_IsRejected()
=> Assert.Throws<InvalidDataException>(() => CurDecoder.Decode(new byte[21], "bad.cur"));
private static void AssertPixel(RgbaImage image, int x, int y,
byte r, byte g, byte b, byte a)
{
int offset = (y * image.Width + x) * 4;
Assert.Equal(r, image.Pixels[offset]);
Assert.Equal(g, image.Pixels[offset + 1]);
Assert.Equal(b, image.Pixels[offset + 2]);
Assert.Equal(a, image.Pixels[offset + 3]);
}
}

41
engine/Age.Engine/Sys4/CurDecoder.cs
View File

@@ -5,7 +5,7 @@ namespace Age.Engine.Sys4;
/// <summary>A decoded Windows cursor image and its native hotspot.</summary>
public sealed record CursorImage(RgbaImage Image, int HotspotX, int HotspotY);
/// <summary>Decoder for Himegari's monochrome Windows .CUR resources.</summary>
/// <summary>Decoder for Himegari's paletted Windows .CUR resources.</summary>
public static class CurDecoder
{
public static CursorImage Decode(ReadOnlySpan<byte> file, string name = "CUR")
@@ -31,16 +31,28 @@ public static class CurDecoder
int bitsPerPixel = U16(file, imageOffset + 14);
int compression = I32(file, imageOffset + 16);
if (dibWidth != width || System.Math.Abs(dibHeight) != height * 2 || planes != 1
|| bitsPerPixel != 1 || compression != 0)
throw new InvalidDataException($"{name}: expected an uncompressed 1-bit {width}x{height} cursor");
|| bitsPerPixel is not (1 or 4) || compression != 0)
throw new InvalidDataException(
$"{name}: expected an uncompressed 1-bit or 4-bit {width}x{height} cursor");
int paletteOffset = checked(imageOffset + headerSize);
if (paletteOffset > file.Length - 8) throw new InvalidDataException($"{name}: palette is truncated");
int xorStride = checked(((width + 31) / 32) * 4);
int maskBytes = checked(xorStride * height);
int xorOffset = checked(paletteOffset + 8);
int andOffset = checked(xorOffset + maskBytes);
if (andOffset > file.Length - maskBytes) throw new InvalidDataException($"{name}: cursor masks are truncated");
int colorsUsed = I32(file, imageOffset + 32);
int maximumPaletteEntries = 1 << bitsPerPixel;
int paletteEntries = colorsUsed == 0 ? maximumPaletteEntries : colorsUsed;
if (paletteEntries <= 0 || paletteEntries > maximumPaletteEntries)
throw new InvalidDataException($"{name}: cursor palette size is invalid");
int paletteBytes = checked(paletteEntries * 4);
if (paletteOffset > file.Length - paletteBytes)
throw new InvalidDataException($"{name}: palette is truncated");
int xorStride = checked(((width * bitsPerPixel + 31) / 32) * 4);
int andStride = checked(((width + 31) / 32) * 4);
int xorBytes = checked(xorStride * height);
int andBytes = checked(andStride * height);
int xorOffset = checked(paletteOffset + paletteBytes);
int andOffset = checked(xorOffset + xorBytes);
if (andOffset > file.Length - andBytes)
throw new InvalidDataException($"{name}: cursor masks are truncated");
var rgba = new byte[checked(width * height * 4)];
bool bottomUp = dibHeight > 0;
@@ -48,12 +60,15 @@ public static class CurDecoder
{
int sourceY = bottomUp ? height - 1 - y : y;
int xorRow = xorOffset + sourceY * xorStride;
int andRow = andOffset + sourceY * xorStride;
int andRow = andOffset + sourceY * andStride;
for (int x = 0; x < width; x++)
{
int shift = 7 - (x & 7);
int paletteIndex = (file[xorRow + (x >> 3)] >> shift) & 1;
bool transparent = ((file[andRow + (x >> 3)] >> shift) & 1) != 0 && paletteIndex == 0;
int paletteIndex = bitsPerPixel == 1
? (file[xorRow + (x >> 3)] >> (7 - (x & 7))) & 1
: (file[xorRow + (x >> 1)] >> ((1 - (x & 1)) * 4)) & 0xf;
int maskShift = 7 - (x & 7);
bool transparent = ((file[andRow + (x >> 3)] >> maskShift) & 1) != 0
&& paletteIndex == 0;
int palette = paletteOffset + paletteIndex * 4;
int dst = (y * width + x) * 4;
rgba[dst] = file[palette + 2];