NSImage加载Windows .cur文件后，如何获取NSCursor所需热点？

好问题！我之前也折腾过这个需求——NSImage确实能加载Windows的.cur光标文件，但系统框架并没有直接提供API来提取里面的热点（Hotspot）信息，所以得手动解析.cur文件的格式来拿到这个关键数据。

核心思路 #

.cur文件的格式和.ico图标文件非常相似，只是文件头里的类型字段不同，并且每个光标条目里包含了x/y热点的信息。我们需要直接读取.cur文件的原始二进制数据，解析出这些字段，而不是依赖NSImage（因为NSImage加载后会丢弃这些元数据）。

具体实现步骤 #

1. 读取.cur文件的原始数据
   用NSData加载目标.cur文件，确保拿到完整的二进制内容。

2. 解析.cur文件结构
   .cur文件的结构分为三部分：

   • 文件头（6字节）：保留位（0x0000）、类型（0x0002表示.cur）、光标数量
   • 光标目录项（每个16字节）：包含宽度、高度、颜色数、保留位、planes、bitCount、数据大小、数据偏移，以及xHotspot和yHotspot（这正是我们需要的！）
   • 实际的光标像素数据

3. 编写解析代码
   这里是一段实用的Objective-C代码示例，用来提取第一个光标条目的热点信息：

- (NSPoint)hotspotForCURFileAtPath:(NSString *)filePath {
    NSData *fileData = [NSData dataWithContentsOfFile:filePath];
    if (!fileData || fileData.length < 6 + 16) {
        return NSMakePoint(0, 0); // 无效文件返回默认热点
    }
    
    const uint8_t *bytes = fileData.bytes;
    
    // 验证文件头：保留位必须是0，类型必须是0x0002（.cur）
    uint16_t reserved = CFSwapInt16LittleToHost(*(uint16_t *)bytes);
    uint16_t type = CFSwapInt16LittleToHost(*(uint16_t *)(bytes + 2));
    if (reserved != 0 || type != 0x0002) {
        return NSMakePoint(0, 0);
    }
    
    // 取第一个光标条目（大多数.cur文件只有一个）
    const uint8_t *entryBytes = bytes + 6;
    uint16_t xHotspot = CFSwapInt16LittleToHost(*(uint16_t *)(entryBytes + 12));
    uint16_t yHotspot = CFSwapInt16LittleToHost(*(uint16_t *)(entryBytes + 14));
    
    // 注意：.cur的yHotspot是从顶部开始计算的，和NSCursor的坐标系一致，无需转换
    return NSMakePoint(xHotspot, yHotspot);
}

4. 创建NSCursor实例
   拿到热点后，就可以结合NSImage来初始化NSCursor了：

NSString *curPath = @"/path/to/your/cursor.cur";
NSImage *cursorImage = [[NSImage alloc] initWithContentsOfFile:curPath];
NSPoint hotspot = [self hotspotForCURFileAtPath:curPath];
NSCursor *customCursor = [[NSCursor alloc] initWithImage:cursorImage hotSpot:hotspot];

注意事项 #

• 如果.cur文件包含多个光标条目，上面的代码只取了第一个，你可以根据需求修改逻辑选择特定的条目。
• 要处理文件读取失败、格式无效等异常情况，避免崩溃。
• 测试时确保.cur文件是标准格式，有些非标准的.cur可能会解析出错。

内容的提问来源于stack exchange，提问作者Lars C.Hassing