如何将Cairo Graphics的8位通道导出适配为16位颜色模式？

我正在使用Cairo Graphics库，目前我的应用通过以下函数实现每通道8位的导出：

// Write pixel 8-bit
PF_Pixel* sampleIntegral8(PF_EffectWorld& def, int x, int y) {
    return (PF_Pixel*)((char*)def.data +
        (y * def.rowbytes) +
        (x * sizeof(PF_Pixel)));
}

PF_Err cairoCopy8(void* refcon, A_long threadInd, A_long itemNum,
    A_long iterTotal)
{
    cairoRefcon* data = (cairoRefcon*)refcon;
    int i = itemNum;
    PF_Err err = PF_Err_NONE;
    uint32_t* rowP;
    PF_Pixel8* worldPtr = sampleIntegral8(data->output, 0, i);
    rowP = (uint32_t*)(data->data + i * data->stride);
    for (int x = 0; x < data->output.width; x++) {
        worldPtr->alpha = rowP[x] >> 24;
        if (worldPtr->alpha)
        {
            float rf = A_u_char(rowP[x] >> 16) / (float)worldPtr->alpha;
            float gf = A_u_char(rowP[x] >> 8) / (float)worldPtr->alpha;
            float bf = A_u_char(rowP[x] >> 0) / (float)worldPtr->alpha;
            worldPtr->red = A_u_char(rf * PF_MAX_CHAN8);
            worldPtr->green = A_u_char(gf * PF_MAX_CHAN8);
            worldPtr->blue = A_u_char(bf * PF_MAX_CHAN8);
        }
        worldPtr++;
    }

    return err;
}

该代码取自某个示例项目。我尝试将其适配为16位导出（计算逻辑已按16位调整），编写了如下代码：

PF_Pixel16* sampleIntegral16(PF_EffectWorld& def, int x, int y) {
    return (PF_Pixel16*)((char*)def.data +
        (y * def.rowbytes) +
        (x * sizeof(PF_Pixel16)));
}

PF_Err cairoCopy16(void* refcon, A_long threadInd, A_long itemNum,
    A_long iterTotal)
{
    cairoRefcon* data = (cairoRefcon*)refcon;
    int i = itemNum;
    PF_Err err = PF_Err_NONE;
    uint32_t* rowP;
    PF_Pixel16* worldPtr = sampleIntegral16(data->output, 0, i);
    rowP = (uint32_t*)(data->data + i * data->stride);
    for (int x = 0; x < data->output.width; x++) {
        worldPtr->alpha = rowP[x] >> 24;
        if (worldPtr->alpha)
        {
            float rf = A_u_char(rowP[x] >> 16) / (float)worldPtr->alpha;
            float gf = A_u_char(rowP[x] >> 8) / (float)worldPtr->alpha;
            float bf = A_u_char(rowP[x] >> 0) / (float)worldPtr->alpha;
            worldPtr->red = A_u_char(rf * PF_MAX_CHAN16);
            worldPtr->green = A_u_char(gf * PF_MAX_CHAN16);
            worldPtr->blue = A_u_char(bf * PF_MAX_CHAN16);
        }
        worldPtr++;
    }

    return err;
}

但该代码无法正常工作，我怀疑是位移位操作与8位版本不同导致的，但我对位移位并不了解。也可能是其他问题。恳请帮助找出问题所在，将该8位函数适配为可正常工作的16位版本。

你的16位版本代码存在几个关键问题，逐一修正如下：

1. 核心问题分析 #

• 数据类型不匹配：PF_Pixel16的通道是16位整数，但你用A_u_char（8位）截断Cairo输出的通道值，导致高位数据丢失；同时直接将8位Alpha值赋值给16位通道，范围映射错误。
• 计算逻辑偏差：保留了8位版本的除法计算逻辑，未适配16位通道的预乘规则，导致颜色精度丢失或计算错误。

修正后的完整代码 #

PF_Pixel16* sampleIntegral16(PF_EffectWorld& def, int x, int y) {
    return (PF_Pixel16*)((char*)def.data +
        (y * def.rowbytes) +
        (x * sizeof(PF_Pixel16)));
}

PF_Err cairoCopy16(void* refcon, A_long threadInd, A_long itemNum,
    A_long iterTotal)
{
    cairoRefcon* data = (cairoRefcon*)refcon;
    int i = itemNum;
    PF_Err err = PF_Err_NONE;
    uint32_t* rowP = (uint32_t*)(data->data + i * data->stride);
    PF_Pixel16* worldPtr = sampleIntegral16(data->output, 0, i);

    for (int x = 0; x < data->output.width; x++) {
        // 提取Cairo的8位Alpha，映射为16位范围（0-65535）
        uint16_t alpha = static_cast<uint16_t>(((rowP[x] >> 24) & 0xFF) * 257);
        worldPtr->alpha = alpha;

        if (alpha != 0) {
            // 提取8位RGB通道，转换为0-1的浮点值
            float r = static_cast<float>((rowP[x] >> 16) & 0xFF) / 255.0f;
            float g = static_cast<float>((rowP[x] >> 8) & 0xFF) / 255.0f;
            float b = static_cast<float>(rowP[x] & 0xFF) / 255.0f;

            // 预乘Alpha后转换为16位通道值
            worldPtr->red = static_cast<uint16_t>(r * alpha);
            worldPtr->green = static_cast<uint16_t>(g * alpha);
            worldPtr->blue = static_cast<uint16_t>(b * alpha);
        } else {
            // Alpha为0时直接置0，避免除0错误
            worldPtr->red = 0;
            worldPtr->green = 0;
            worldPtr->blue = 0;
        }
        worldPtr++;
    }

    return err;
}

关键修正点说明 #

• Alpha通道映射：将Cairo的8位Alpha（0-255）乘以257，精确映射到16位的0-65535范围（255*257=65535）。
• RGB通道处理：先将8位RGB转为0-1的浮点值，再乘以16位Alpha得到预乘的16位通道值，避免中间精度损失。
• 类型安全转换：用static_cast替代A_u_char，确保数据类型转换的正确性，防止截断。
• 除0防护：明确处理Alpha为0的情况，直接置RGB为0，避免潜在的除0错误。

内容的提问来源于stack exchange，提问作者Rich95