16-Bit Pixels (翻译)

本文译者在学习DirectX基础上,深入研究16 - Bit Surfaces。介绍了16位像素格式,普遍为5 - 6 - 5格式。讲解了使用bitmask和移位操作提取像素颜色值,还给出修改后的GetRGB16函数获取像素格式值,以及Plot_Pixel函数绘制像素,同时提醒代码在不同显卡下的适配问题。
部署运行你感兴趣的模型镜像

/************************************************************************/

本文纯粹是译者学习,不作任何它用.译者尊重原作者拥有的一切权力!

转载请告知,E-mail: linuxsunshen@163.com

/************************************************************************/

 

16-Bit Pixels

by Sam Christiansen

       在学习DirectX有一定基础后,我决定我应该更深入地学习有关16-Bit Surfaces,更确切地说,应该是a routine to plot a pixel.在一番搜索后,我找到了两篇能从不同角度帮助我理解有关16-Bit pixels基础的文章.作为参考,第一篇文章是Angelic-Coders.comChris Barnes写的,标题是 "16 Bit Pixel Plotting",第二是Hugh Hunkin写的,标题是"16 Bit With Directdraw".我非常感谢Barnes先生和Hunkin先生的文章,感谢他们允许我在本文中使用他们的部分源代码.之所以我决定写这篇有关16-Bit pixels的新文章,是因为我发现Barnes先生和Hunkin先生文章相关的技术是非常容易理解的.

Pixel Formats

    首先,我要对有关16-bit directdraw surfaces简要说明一下.每个16-bit pixel on the surface拥有red(红), green(绿), blue(蓝)三个属性(Value),因为16不能被3平分,所以最普遍的方法是把像素信息(pixel information)分为5-6-5的格式.这意味着红色值(red value)是前5位(bit),其次是6位绿色值,最后5位是蓝色值.使用5-6-5格式,我们就能得到65536(2^16)种不同颜色.We have 32 shades of red, 64 shades of green, and 32 shades of blue.假如5-6-5格式不存在的话,事情也许会变得更容易.不管怎样,我们不得不面对不同的像素格式(pixel format)的存在.

A Word About Bitmasks and Shifting

       很多读者也许已经知道bitmask和shifting,如果是这样,就跳过下面这部分.如果你对bitmask感到疑惑或者根本不知道的话,请接着看.一个bitmask就是一个变量(variable),它使我们能从我们的16位值中提取红,绿,蓝值的相关部分.我们使用逻辑运算符( OR (|) 和 AND (&) )通过对两个变量的运算而从颜色值的相关部分得到一个新的变量.举个例子,假如我们有一个5-6-5颜色值排列如下:

red:    5 bits,    00011
green:  6 bits,    001011
blue:   5 bits,    00101

   把它们组合在一起,就成了下面的格式:

0001 1001 0110 0101 

(note the spacing is just to make it easier to read)

  它们看起来很让人迷惑,我们能看到颜色值在哪.但是我们怎样提取它们呢?对了,这就是bitmask起作用的地方啦.因为红色值是前5位,所以我们使用下面的二进制数字(binary number)

1111 1000 0000 0000

    对它进行逻辑与(AND)运算就能提取代表红色值的5位,看下面的操作:

0001 1001 0110 0101 &
1111 1000 0000 0000
---------------------
0001 1000 0000 0000

  现在我们能看到这个16位值很明显包含我们要的红色值,但是你看到啦,它的位置并不正确.如果我们现在读取这个值,它将不会是我们希望得到的1到31之间的值.我们还要用移位操作符(>>或<<)来把它移到右面正确的位置.你看到在我们的红色值右面有11个0,下面就是操作:

0001 1000 0000 0000 >> 11 =
0000 0000 0000 0011

  这样我们就得到了我们的红色值,我们就能读取他了.下面的代码就是我们要的:

// suppose "pixel" contains the value above
BYTE red;
red = ((pixel & 0xF800) >> 11);

  现在变量red就得到了变量pixel中的红色值,请注意我们的bitmask的值,0xF800是十六进制数.我们不必写那讨厌的11个0. ;-)

  在这部分中我们要注意的是:我们能用bitmask来提取我们要的像素值(pixel value).相关源代码见下.

How Do We Find Out The Pixel Format?

  Chris Barnes在他的文章中建议使用一个他写的GetRGB16函数.我修改了这个函数以使它更容易理解.基本上讲,这个函数过程把一个directdraw surface作为输入和调用directdraw的函数GetSurfaceDesc()来得到一个surface的描述信息,并返回像数格式的值.一个重要的注意点:以下的代码过程假定像数的结构是红-绿-蓝格式.当然很多视频显示卡是使用RGB格式的,但也可能是使用RGB组合的别的形式(比如:BGR, GRB, BRG等).如果你想让以下的代码能100%在不同的视频显示卡下都能工作的话,那你必须修改GetRGB16()函数和Plot_Pixel()函数以使他们工作.

以下是我的GetRGB16函数:

// you need this struct for the getrgb16 proc
// note:  you could even yank the bitmask variables out of this
// if you find you aren't using them in any functions of your own
typedef struct
{
    DWORD dwRBitMask,
        dwGBitMask,
        dwBBitMask;
    RGBQUAD Position;   //  RGBQUAD is a data structure included with MSVC++5.0
} RGB16;


BOOL GetRGB16 ( LPDIRECTDRAWSURFACE Surface, RGB16 *rgb16)
{
    DDSURFACEDESC   ddsd;
    //get a surface description
    ddsd.dwSize = sizeof( ddsd );
    ddsd.dwFlags = DDSD_PIXELFORMAT;
    if (Surface->GetSurfaceDesc ( &ddsd ) != DD_OK )
return FALSE;

    // will increment r,g, or b for each 1 in it's bitmask, which will give
    // us the number of bits used for each color
    char r=0, g=0, b=0;
    for(int n = 1; n<65536; N<<=1)
    {
        IF(ddsd.ddpfPixelFormat.dwRBitMask & N)
            ++R;
        IF(ddsd.ddpfPixelFormat.dwRBitMask & N)
            ++G;
        IF(ddsd.ddpfPixelFormat.dwRBitMask & N)
            ++B;
    }

    // THIS IS THE PART THAT ASSUMES THE FORMAT IS RGB
    rgb16->dwRBitMask = ddsd.ddpfPixelFormat.dwRBitMask;
    rgb16->Position.rgbRed = g + b;

    rgb16->dwGBitMask = ddsd.ddpfPixelFormat.dwGBitMask;
    rgb16->Position.rgbGreen = b;

    rgb16->dwBBitMask = ddsd.ddpfPixelFormat.dwBBitMask;
    rgb16->Position.rgbBlue = 0;

    return TRUE;
}//GetRBG16

  现在我们得到了我们要的格式,以下是我的Plot_Pixel函数:

// Must have the surface locked, pass the surface description
// that gets returned from the lock call
void PlotRGB(int x, int y, int r, int g, int b, DDSURFACEDESC *ddsd, RGB16 *rgb16)
{
    WORD Pixel;
    Pixel = (r << RGB16->Position.rgbRed) |
        (g << RGB16->Position.rgbGreen) |
        (b);    //  once again, assuming format is RGB

    WORD *pixels = (WORD *)ddsd->lpSurface;
    DWORD pitch = ddsd->dwWidth;
    pixels[y*pitch + x] = Pixel;
}

这个PlotPixel函数假定dwWidth等于pitch of the surface. Barnes先生使用

DWORD pitch = ddsd->lPitch >> 1;

来代替

DWORD pitch = ddsd->dwWidth;

来提取我们想要的surface的任何值,我想dwWidth在这个例子中更容易理解.在你使用这个例子的时候一定要记住!

Optimizations?

(未完待续...................)

您可能感兴趣的与本文相关的镜像

ACE-Step

ACE-Step

音乐合成
ACE-Step

ACE-Step是由中国团队阶跃星辰(StepFun)与ACE Studio联手打造的开源音乐生成模型。 它拥有3.5B参数量,支持快速高质量生成、强可控性和易于拓展的特点。 最厉害的是,它可以生成多种语言的歌曲,包括但不限于中文、英文、日文等19种语言

你提到的“问题修复翻译”可能是指对技术内容、错误信息或代码注释中的中文术语进行 **准确、专业且符合工程习惯的英文翻译**,尤其是在嵌入式视觉系统(如海思平台)开发中常见的结构体字段、函数名、错误提示等。 我们以上一个例子中的结构体 `SC_IMAGE_S` 及其注释为例,来展示如何将原始“直译风”的中文注释,**修复为更专业、清晰、符合行业规范的技术文档翻译**。 --- ### ❌ 原始“问题翻译”示例(不推荐) ```c typedef struct SC_IMAGE_S { SC_IMAGE_TYPE_E enType; // 图像类型 SC_U8 *pu8Image[3]; // 图像各通道地址数组 SC_U8 u8AddHeight; // 图像的附加行高度 SC_U16 u16Stride[3]; // 图像的跨 SC_U16 u16Width; // 图像的宽度 SC_U16 u16Height; // 图像的高度 SC_U16 u16Reserved; // 保留位 } SC_IMAGE_S; ``` > 存在问题: - “图像的跨” → “stride” 是标准术语,不能直译为 "cross"; - “保留位” → 应为 "reserved",不是 "reserved bit(s)"(除非真是单个 bit); - “附加行高度” → 表意不清,易误解; - 注释风格不统一,缺乏专业性。 --- ### ✅ 修复后:标准技术翻译(Recommended) ```c /** * @brief Image structure representing planar or semi-planar pixel data. */ typedef struct SC_IMAGE_S { SC_IMAGE_TYPE_E enType; /**< Type of the image (e.g., YUV420, RGB, etc.) */ SC_U8 *pu8Image[3]; /**< Base addresses for each plane: * [0] = Y / R / G / B, * [1] = U/Cb / V/Cr (or UV/VCbCr for semi-planar), * [2] = V/Cr (if separated) */ SC_U8 u8AddHeight; /**< Additional height in lines (used for padding below the image) */ SC_U16 u16Stride[3]; /**< Memory stride (pitch) of each plane in bytes: * Number of bytes from one row to the next in memory, * may include padding for alignment. */ SC_U16 u16Width; /**< Valid pixel width (active width) */ SC_U16 u16Height; /**< Valid pixel height (active height) */ SC_U16 u16Reserved; /**< Reserved for alignment or future use */ } SC_IMAGE_S; ``` --- ### 🔧 翻译修复说明 | 原文 | 问题 | 修复建议 | 理由 | |------|------|---------|------| | `// 图像类型` | 太泛 | `/**< Type of the image ... */` | 明确用途,支持枚举类型解释 | | `// 图像的跨` | 错误术语,“跨”≠cross | `/**< Memory stride (pitch) ... */` | “stride” 是图像处理标准术语 | | `// 图像的宽度` | 不够精确 | `/**< Valid pixel width (active width) */` | 区分 active width 与 stride | | `// 保留位` | 中文直译 | `/**< Reserved for ... */` | 工程通用说法 | | `// 图像的附加行高度` | 含义模糊 | `/**< Additional height in lines (used for padding below...) */` | 解释其实际用途(如内存对齐预留行) | --- ### 📚 推荐术语对照表(图像处理领域) | 中文术语 | 推荐英文翻译 | 说明 | |--------|---------------|------| | 跨 | **Stride** 或 **Pitch** | 单位:字节;表示每行所占内存大小 | | 宽度 | **Width** | 一般指有效像素数(active pixels) | | 高度 | **Height** | 同上 | | 步长 | 同 stride | 避免使用“step”以免混淆 | | 保留位 | **Reserved** | 若为字段用 `reserved`, 若为比特位可用 `reserved bits` | | 地址数组 | **Base address array** 或 **plane base pointers** | 更准确描述多平面结构 | | 附加行高度 | **Additional height in lines** 或 **padding lines below** | 常用于帧缓冲区对齐扩展 | --- ### 💡 使用 Doxygen 风格提升可读性 建议使用类似 Doxygen 的文档格式,便于生成 API 文档: ```c /** * @struct SC_IMAGE_S * @brief Represents a raw image buffer with multi-plane support. * * This structure is typically used in ISP output, VI/VO modules, * and AI inference input on HiSilicon/RK platforms. */ ``` 然后配合工具生成 HTML/PDF 文档,提高团队协作效率。 --- ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值