quickwin 2.3.1 → 3.0.1

package/lib/windows/{gdi32.ts → gdi32.d.ts}

@@ -1,55 +1,51 @@
-// gdi32 绑定（品牌约定见 lib/windows/user32.ts 头注释）：
-//   - HDC 出入参用 <HDC>ptr（品牌指针 Ptr<'HDC'>，与 user32 的 GetDC/ReleaseDC 同型互认）
-//   - GDI 对象通用句柄统一 <HGDIOBJ>ptr（HBRUSH/HPEN/HFONT/HBITMAP/HRGN 在 Win32 同为
-//     HGDIOBJ）：创建/选入/取出/删除全链同品牌闭环，拦 DeleteObject(hdc) 类异种误传；
-//     user32 结构里的 HBRUSH 字段仍收裸位——品牌值赋给裸 number 位天然兼容
-//   - 结构位按方向分流：CreateFontIndirect 的 LOGFONTW 是纯入参位，注册 encoder 收
-//     DeepPartial 对象直传（缺省字段跳过 = 保持 0 合法零值语义）
-import { bind, type CodecMap } from '../ffi/bind.js'
-import { structArray } from '../ffi/struct.js'
-import { LOGFONTW, POINT, RECT } from './structs.js'
-
-// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释；第三参透传 encoders）
-const b = <const S extends string, const LE extends CodecMap = {}>(name: string, sig: S, encoders?: LE) =>
-    bind('gdi32.dll', name, sig, encoders)
-
-// 点数组编解码对（Polyline/Polygon/PlgBlt 共享）：注册后 <POINT>ptr 位收元素数组
-// （值域由 encoder 推导），C 侧 NULL 位传 NULL（number 直通），[]/单对象 fail-loud
-const POINTArr = /*@__PURE__*/ structArray(POINT)
-
 /** 创建实心画刷；配对 DeleteObject
  *  @returns 失败 → 0
  *  @param args_0 crColor 画刷颜色 0x00BBGGRR */
-export const CreateSolidBrush = /*@__PURE__*/ b('CreateSolidBrush', 'u32 -> <HGDIOBJ>ptr')
+export declare const CreateSolidBrush: (args_0: number) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 删除 GDI 对象（画刷/画笔/字体/位图等通用句柄，传 CreateXxx 返回的 number）
  *  @returns 成功 → 非 0
  *  @param args_0 hGdiObj */
-export const DeleteObject = /*@__PURE__*/ b('DeleteObject', '<HGDIOBJ>ptr -> i32')
+export declare const DeleteObject: (args_0: import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">) => number;
 /** 取设备能力值
  *  @returns 索引对应的设备能力值
  *  @param args_0 hdc
  *  @param args_1 index 能力索引（LOGPIXELSX = 88，LOGPIXELSY = 90，BITSPIXEL = 12 等） */
-export const GetDeviceCaps = /*@__PURE__*/ b('GetDeviceCaps', '<HDC>ptr! i32@DeviceCap -> i32')
+export declare const GetDeviceCaps: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../../constants.js").DeviceCap) => number;
 /** 按 LOGFONTW 创建字体（入参位对象直传 DeepPartial：至少给 lfHeight 与 lfFaceName，其余缺省
  *  跳过保持 0）；配对 DeleteObject
  *  @returns 失败 → 0
  *  @param args_0 lplf LOGFONTW 对象 */
-export const CreateFontIndirect = /*@__PURE__*/ b('CreateFontIndirectW', '<LOGFONTW>ptr -> <HGDIOBJ>ptr', { LOGFONTW })
-
-// ============ 内存 DC / 位图（截屏类流程：CreateCompatibleDC → SelectObject → BitBlt → GetDIBits）============
-
+export declare const CreateFontIndirect: (args_0: {
+    lfCharSet?: number | undefined;
+    lfClipPrecision?: number | undefined;
+    lfEscapement?: number | undefined;
+    lfFaceName?: string | undefined;
+    lfHeight?: number | undefined;
+    lfItalic?: number | undefined;
+    lfOrientation?: number | undefined;
+    lfOutPrecision?: number | undefined;
+    lfPitchAndFamily?: number | undefined;
+    lfQuality?: number | undefined;
+    lfStrikeOut?: number | undefined;
+    lfUnderline?: number | undefined;
+    lfWeight?: number | undefined;
+    lfWidth?: number | undefined;
+} | import("../ffi/ctype.js").MaybePtr<"LOGFONTW">) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 建与 hdc 兼容的内存 DC；配对 DeleteDC
  *  @returns 失败 → NULL
  *  @param args_0 hdc 参考 DC，NULL = 与屏幕兼容 */
-export const CreateCompatibleDC = /*@__PURE__*/ b('CreateCompatibleDC', '<HDC>ptr -> <HDC>ptr')
+export declare const CreateCompatibleDC: (args_0: import("../ffi/ctype.js").MaybePtr<"HDC">) => import("../ffi/ctype.js").MaybePtr<"HDC">;
 /** 建与 hdc 兼容的位图（尺寸取决于 hdc 当前选中对象：内存 DC 刚建时选中 1×1 单色图，
  *  所以要传屏幕 DC）；配对 DeleteObject
  *  @returns 失败 → NULL
  *  @param args_0 hdc 参考 DC（决定位图格式，须为屏幕或真实 DC）
  *  @param args_1 cx 宽度（像素）
  *  @param args_2 cy 高度（像素） */
-export const CreateCompatibleBitmap = /*@__PURE__*/ b('CreateCompatibleBitmap', '<HDC>ptr! i32 i32 -> <HGDIOBJ>ptr')
-
+export declare const CreateCompatibleBitmap: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 创建独立位图（与任何 DC 无关）；bits 喂原始像素缓冲则直接初始化（NULL = 未初始化）；
  *  1bpp 单色行内 bit7 = 最左像素、行按 word(2B) 对齐（非 DIB 的 4B，MaskBlt 实测）；
  *  配对 DeleteObject
@@ -59,14 +55,14 @@ export const CreateCompatibleBitmap = /*@__PURE__*/ b('CreateCompatibleBitmap',
  *  @param args_2 nPlanes 色平面数（恒 1）
  *  @param args_3 nBitCount 每像素位数（1 = 单色 / 32 = BGRA）
  *  @param args_4 lpBits 原始像素缓冲（ArrayBuffer，可 NULL） */
-export const CreateBitmap = /*@__PURE__*/ b('CreateBitmap',
-    'i32 i32 u32 u32 <BYTE>ptr -> <HGDIOBJ>ptr')
-
+export declare const CreateBitmap: (args_0: number, args_1: number, args_2: number, args_3: number, args_4: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 把 GDI 对象选进 hdc（用完选回去再删除新对象）
  *  @returns 被替换的旧对象；失败 → NULL
  *  @param args_0 hdc 目标 DC
  *  @param args_1 h 新对象句柄（HGDIOBJ 通称） */
-export const SelectObject = /*@__PURE__*/ b('SelectObject', '<HDC>ptr! <HGDIOBJ>ptr -> <HGDIOBJ>ptr')
+export declare const SelectObject: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 位块传送
  *  @returns 成功 → 非 0
  *  @param args_0 hdcDest 目标 DC
@@ -78,8 +74,9 @@ export const SelectObject = /*@__PURE__*/ b('SelectObject', '<HDC>ptr! <HGDIOBJ>
  *  @param args_6 x1 源起始 x
  *  @param args_7 y1 源起始 y
  *  @param args_8 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
-// hdcDest 非空（!）；hdcSrc 在 PATCOPY 等特定 rop 下 C 允许 NULL，保持可空档。
-export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 u32@RasterOp -> i32')
+export declare const BitBlt: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: import("../ffi/ctype.js").MaybePtr<"HDC">, args_6: number, args_7: number, args_8: import("../../constants.js").RasterOp) => number;
 /** 取位图像素到 lpvBits（lpbmi 为 BITMAPINFO，32bpp BI_RGB 无颜色表时头部即全部：
  *  有颜色表的格式由调用方自备更大的缓冲）
  *  @returns 成功取到的扫描行数；失败 → 0
@@ -89,19 +86,46 @@ export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>
  *  @param args_3 cLines 扫描行数
  *  @param args_4 lpvBits 像素接收缓冲（ArrayBuffer）
  *  @param args_5 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
- *  @param args_6 uUsage DIB_RGB_COLORS(0) */
-export const GetDIBits = /*@__PURE__*/ b('GetDIBits', '<HDC>ptr! <HGDIOBJ>ptr u32 u32 <BYTE>ptr <>ptr u32 -> i32')
+ *  @param args_6 uUsage ColorUse.RGB_COLORS */
+export declare const GetDIBits: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">, args_2: number, args_3: number, args_4: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_5: import("../ffi/ctype.js").MaybePtr<"">, args_6: import("../../constants.js").ColorUse) => number;
+/** 建 32bpp DIB 段位图（biHeight 负 = 自顶向下，像素内存由系统分配）——像素内容靠
+ *  SetDIBits 从调用方缓冲装入，故 ppvBits 出参槽可传 NULL 不取位地址（要直写像素
+ *  才需要非空槽）
+ *  @returns 位图句柄；失败 → 0（用完 DeleteObject）
+ *  @param args_0 hdc 参考 DC（NULL 即可，只取 DIB 格式）
+ *  @param args_1 pbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr，同 GetDIBits）
+ *  @param args_2 iUsage ColorUse.RGB_COLORS
+ *  @param args_3 ppvBits 收位地址的出参槽（NULL = 不取）
+ *  @param args_4 hSection NULL（无文件映射区）
+ *  @param args_5 offset 位数据在映射区内的偏移（无映射区恒 0） */
+export declare const CreateDIBSection: (args_0: import("../ffi/ctype.js").MaybePtr<"HDC">, args_1: import("../ffi/ctype.js").MaybePtr<"">, args_2: import("../../constants.js").ColorUse, args_3: import("../ffi/ctype.js").MaybePtr<"">, args_4: import("../ffi/ctype.js").MaybePtr<"">, args_5: number) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
+/** 把 lpvBits 的像素装进位图（lpbmi 描述源的格式；ColorUse.RGB_COLORS 时 hdc 只定
+ *  目标格式，本仓传 NULL 实测可用——MSDN：仅 DIB_PAL_COLORS 才用 hdc）
+ *  @returns 成功复制的扫描行数；失败 → 0
+ *  @param args_0 hdc 参考 DC（NULL 即可，见上）
+ *  @param args_1 hbm 目标位图（DIB 段同可用）
+ *  @param args_2 uStartScan 起始扫描行
+ *  @param args_3 cLines 扫描行数
+ *  @param args_4 lpvBits 像素源缓冲（ArrayBuffer）
+ *  @param args_5 lpbmi BITMAPINFO 缓冲（同 GetDIBits）
+ *  @param args_6 iUsage ColorUse.RGB_COLORS */
+export declare const SetDIBits: (args_0: import("../ffi/ctype.js").MaybePtr<"HDC">, args_1: number & {
+    readonly ptrBrand: "HGDIOBJ";
+}, args_2: number, args_3: number, args_4: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_5: import("../ffi/ctype.js").MaybePtr<"">, args_6: import("../../constants.js").ColorUse) => number;
 /** 取 GDI 对象信息到 lpv（hFont → LOGFONTW 等）
  *  @returns 写入的字节数；失败 → 0
  *  @param args_0 h GDI 对象句柄（字体/画笔/位图等）
  *  @param args_1 cb 输出缓冲字节数（如 LOGFONTW.size）
  *  @param args_2 lpv 输出缓冲（LOGFONTW.alloc() 等） */
-export const GetObject = /*@__PURE__*/ b('GetObjectW', '<HGDIOBJ>ptr i32 <BYTE>ptr -> i32')
+export declare const GetObject: (args_0: import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">, args_1: number, args_2: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;
 /** 删除内存 DC（CreateCompatibleDC 建的）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 要删的 DC */
-export const DeleteDC = /*@__PURE__*/ b('DeleteDC', '<HDC>ptr! -> i32')
-
+export declare const DeleteDC: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}) => number;
 /** 用画刷图案填充矩形
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -110,7 +134,9 @@ export const DeleteDC = /*@__PURE__*/ b('DeleteDC', '<HDC>ptr! -> i32')
  *  @param args_3 w 宽度
  *  @param args_4 h 高度
  *  @param args_5 rop RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
-export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@RasterOp -> i32')
+export declare const PatBlt: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: import("../../constants.js").RasterOp) => number;
 /** 拉伸位图传送（源区 wSrc×hSrc 放/缩到目标 wDest×hDest）
  *  @returns 成功 → 非 0
  *  @param args_0 hdcDest 目标 DC
@@ -124,18 +150,23 @@ export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@R
  *  @param args_8 wSrc 源区宽
  *  @param args_9 hSrc 源区高
  *  @param args_10 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
-export const StretchBlt = /*@__PURE__*/ b('StretchBlt',
-    '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 i32 i32 u32@RasterOp -> i32')
+export declare const StretchBlt: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: import("../ffi/ctype.js").MaybePtr<"HDC">, args_6: number, args_7: number, args_8: number, args_9: number, args_10: import("../../constants.js").RasterOp) => number;
 /** 设置拉伸取色模式；放大时各模式像素同为源色，缩小时降采样策略不同
  *  （DELETESCANS 丢行 / HALFTONE 平均取色最保真）
  *  @returns 旧值
  *  @param args_0 hdc 目标 DC
  *  @param args_1 iMode StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
-export const SetStretchBltMode = /*@__PURE__*/ b('SetStretchBltMode', '<HDC>ptr! i32@StretchBltMode -> i32')
+export declare const SetStretchBltMode: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../../constants.js").StretchBltMode) => number;
 /** 读拉伸取色模式（值域 = StretchBltMode 成员）；回传
  *  SetStretchBltMode 前需按成员值使用（裸 number 进不了枚举位）
  *  @returns number */
-export const GetStretchBltMode = /*@__PURE__*/ b('GetStretchBltMode', '<HDC>ptr! -> i32')
+export declare const GetStretchBltMode: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}) => number;
 /** 平行四边形位图传送（源矩形映射到 lpPoint 三点定的平行四边形 = 旋转/斜切贴图，
  *  源区随之缩放到三点形）
  *  @returns 成功 → 非 0
@@ -149,8 +180,12 @@ export const GetStretchBltMode = /*@__PURE__*/ b('GetStretchBltMode', '<HDC>ptr!
  *  @param args_7 hbmMask 可选单色掩码（NULL = 直接贴）
  *  @param args_8 xMask 掩码内起点 x（掩码为 NULL 时忽略）
  *  @param args_9 yMask 掩码内起点 y */
-export const PlgBlt = /*@__PURE__*/ b('PlgBlt',
-    '<HDC>ptr! <POINT>ptr <HDC>ptr i32 i32 i32 i32 <>ptr i32 i32 -> i32', { POINT: POINTArr })
+export declare const PlgBlt: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: readonly {
+    x?: number | undefined;
+    y?: number | undefined;
+}[] | import("../ffi/ctype.js").MaybePtr<"POINT">, args_2: import("../ffi/ctype.js").MaybePtr<"HDC">, args_3: number, args_4: number, args_5: number, args_6: number, args_7: import("../ffi/ctype.js").MaybePtr<"">, args_8: number, args_9: number) => number;
 /** 单色掩码位块传送：掩码非零处取前景三元 rop、零处取背景三元 rop；
  *  dwRop = MAKEROP4(fore, back) 打包（gdi32.ts 不导出辅助，公式内联）：
  *    rop = (((back << 8) & 0xFF000000) | fore) >>> 0
@@ -169,8 +204,9 @@ export const PlgBlt = /*@__PURE__*/ b('PlgBlt',
  *  @param args_9 xMask 掩码内起点 x
  *  @param args_10 yMask 掩码内起点 y
  *  @param args_11 dwRop MAKEROP4 打包值（双 rop 组合域，非 @RasterOp 单值） */
-export const MaskBlt = /*@__PURE__*/ b('MaskBlt',
-    '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 <>ptr i32 i32 u32 -> i32')
+export declare const MaskBlt: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: import("../ffi/ctype.js").MaybePtr<"HDC">, args_6: number, args_7: number, args_8: import("../ffi/ctype.js").MaybePtr<"">, args_9: number, args_10: number, args_11: number) => number;
 /** 把 DIB 位图画到目标 DC
  *  @returns 扫描行数；失败 → 0
  *  @param args_0 hdc 目标 DC
@@ -184,10 +220,10 @@ export const MaskBlt = /*@__PURE__*/ b('MaskBlt',
  *  @param args_8 uNumScans 扫描行数
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲
- *  @param args_11 iUsage DIB_RGB_COLORS(0) */
-export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice',
-    '<HDC>ptr! i32 i32 u32 u32 i32 i32 u32 u32 <BYTE>ptr <BYTE>ptr u32 -> i32')
-
+ *  @param args_11 iUsage ColorUse.RGB_COLORS */
+export declare const SetDIBitsToDevice: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: number, args_6: number, args_7: number, args_8: number, args_9: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_10: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_11: import("../../constants.js").ColorUse) => number;
 /** 拉伸 DIB 传送（内存像素缓冲直接放/缩到目标，免创建 HBITMAP 中转）；
  *  DestWidth/DestHeight 传 0 = 源自然尺寸；SrcWidth/SrcHeight 负 = 翻转
  *  @returns 成功 → 扫描行数；失败 → 0
@@ -201,85 +237,97 @@ export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice',
  *  @param args_8 SrcHeight 源区高
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
- *  @param args_11 iUsage DIB_RGB_COLORS(0)
+ *  @param args_11 iUsage ColorUse.RGB_COLORS
  *  @param args_12 rop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
-export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits',
-    '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 <BYTE>ptr <BYTE>ptr u32 u32@RasterOp -> i32')
-
-// ============ 画图原语（笔 / 线 / 形状 / 文字） ============
-
+export declare const StretchDIBits: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: number, args_6: number, args_7: number, args_8: number, args_9: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_10: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_11: import("../../constants.js").ColorUse, args_12: import("../../constants.js").RasterOp) => number;
 /** 取系统共享对象（笔/刷/字体/调色板）；共享句柄不要 DeleteObject——
  *  SelectObject 选入 hdc 生效（如 NULL_BRUSH 让形状只描边不填充）
  *  @returns 失败 → 0
  *  @param args_0 iObject StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
-export const GetStockObject = /*@__PURE__*/ b('GetStockObject', 'i32@StockObject -> <HGDIOBJ>ptr')
-
+export declare const GetStockObject: (args_0: import("../../constants.js").StockObject) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 创建网格纹理画刷（线色 = crColor，间隙 = 背景：SetBkMode=TRANSPARENT 透底、OPAQUE
  *  用 SetBkColor）；配对 DeleteObject
  *  @returns 失败 → 0
  *  @param args_0 iHatch HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
  *  BDIAGONAL / CROSS / DIAGCROSS
  *  @param args_1 crColor 纹理线颜色 0x00BBGGRR */
-export const CreateHatchBrush = /*@__PURE__*/ b('CreateHatchBrush', 'i32@HatchStyle u32 -> <HGDIOBJ>ptr')
-
+export declare const CreateHatchBrush: (args_0: import("../../constants.js").HatchStyle, args_1: number) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 创建位图平铺画刷（小位图铺满填充区；平铺锚定设备原点 (0,0)，与目标矩形角无关）；
  *  配对 DeleteObject —— 位图在画刷删除后再 DeleteObject（保守生命周期）
  *  @returns 失败 → 0
  *  @param args_0 hbm 位图句柄（CreateCompatibleBitmap 返回；调用前先退出选入状态） */
-export const CreatePatternBrush = /*@__PURE__*/ b('CreatePatternBrush', '<HGDIOBJ>ptr -> <HGDIOBJ>ptr')
-
+export declare const CreatePatternBrush: (args_0: import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 创建画笔（选入 hdc 生效，SelectObject 选回旧对象后 DeleteObject 配对）
  *  @returns 失败 → 0
  *  @param args_0 iStyle 笔型（PenStyle.SOLID / DASH / NULL 等）
  *  @param args_1 cWidth 笔宽（像素；>1 的几何宽设备相关，虚线样式可能被拉伸）
  *  @param args_2 crColor 笔色 0x00BBGGRR */
-export const CreatePen = /*@__PURE__*/ b('CreatePen', 'i32@PenStyle i32 u32 -> <HGDIOBJ>ptr')
+export declare const CreatePen: (args_0: import("../../constants.js").PenStyle, args_1: number, args_2: number) => import("../ffi/ctype.js").MaybePtr<"HGDIOBJ">;
 /** 设置文字/阴影背景填充模式
  *  @returns 旧模式（新建 DC 默认 OPAQUE）
  *  @param args_0 hdc 目标 DC
  *  @param args_1 iBkMode BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
-export const SetBkMode = /*@__PURE__*/ b('SetBkMode', '<HDC>ptr! i32@BackgroundMode -> i32')
+export declare const SetBkMode: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../../constants.js").BackgroundMode) => number;
 /** 设置文字颜色
  *  @returns 旧 COLORREF（0x00BBGGRR）
  *  @param args_0 hdc 目标 DC
  *  @param args_1 color 新文字色 0x00BBGGRR */
-export const SetTextColor = /*@__PURE__*/ b('SetTextColor', '<HDC>ptr! u32 -> u32')
+export declare const SetTextColor: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number) => number;
 /** 设置背景（SetBkMode=OPAQUE 时的衬底）颜色
  *  @returns 旧 COLORREF（0x00BBGGRR）
  *  @param args_0 hdc 目标 DC
  *  @param args_1 color 新背景色 0x00BBGGRR */
-export const SetBkColor = /*@__PURE__*/ b('SetBkColor', '<HDC>ptr! u32 -> u32')
+export declare const SetBkColor: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number) => number;
 /** 保存 DC 当前绘图状态到 GDI 状态栈（颜色/模式/选中笔刷字体/裁剪区/映射模式…）；
  *  配对 RestoreDC——标准用法：进入绘制块 Save、退出 Restore
  *  @returns 状态 ID（0 = 失败）
  *  @param args_0 hdc 目标 DC */
-export const SaveDC = /*@__PURE__*/ b('SaveDC', '<HDC>ptr! -> i32')
+export declare const SaveDC: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}) => number;
 /** 从状态栈恢复 SaveDC 保存的 DC 状态（对应 ID 及更晚的保存随之失效）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
  *  @param args_1 state SaveDC 返回的状态 ID，或 -1 = 最近一次保存 */
-export const RestoreDC = /*@__PURE__*/ b('RestoreDC', '<HDC>ptr! i32 -> i32')
+export declare const RestoreDC: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number) => number;
 /** 设置多边形填充规则
  *  @returns 旧值（新建 DC 默认 ALTERNATE = 奇偶规则）
  *  @param args_0 hdc 目标 DC
  *  @param args_1 iMode PolyFillMode.ALTERNATE（自相交区域交替镂空）/
  *  WINDING（非零环绕，自相交区域整体实心） */
-export const SetPolyFillMode = /*@__PURE__*/ b('SetPolyFillMode', '<HDC>ptr! i32@PolyFillMode -> i32')
+export declare const SetPolyFillMode: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../../constants.js").PolyFillMode) => number;
 /** 设置前景画笔与目的像素的混合方式（二元光栅模式）；
  *  R2_XORPEN 可逆（同路径画两次抵消原样），适合橡皮筋交互
  *  @returns 旧值（默认 R2_COPYPEN = 直接画）
  *  @param args_0 hdc 目标 DC
  *  @param args_1 iMode RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
-export const SetROP2 = /*@__PURE__*/ b('SetROP2', '<HDC>ptr! i32@RasterMode -> i32')
+export declare const SetROP2: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../../constants.js").RasterMode) => number;
 /** 设置弧/弦/扇形的扫过方向
  *  @returns 旧值（新 DC 默认逆时针）
  *  @param args_0 hdc 目标 DC
  *  @param args_1 iDir ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
-export const SetArcDirection = /*@__PURE__*/ b('SetArcDirection', '<HDC>ptr! i32@ArcDirection -> i32')
+export declare const SetArcDirection: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: import("../../constants.js").ArcDirection) => number;
 /** 读弧扫过方向
  *  @returns AD_COUNTERCLOCKWISE=1 / AD_CLOCKWISE=2；失败 → 0 */
-export const GetArcDirection = /*@__PURE__*/ b('GetArcDirection', '<HDC>ptr! -> i32')
-
+export declare const GetArcDirection: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}) => number;
 /** 移动画笔当前位置；lppt 接旧位置出参
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -287,27 +335,40 @@ export const GetArcDirection = /*@__PURE__*/ b('GetArcDirection', '<HDC>ptr! ->
  *  @param args_2 y 新位置 y
  *  @param args_3 lppt 出参位：传 POINT.alloc() 的 .ptr 接旧位置，或传 NULL 不要 ——
  *  刻意不注册 encoder（纯出参；对象形物化进引擎持有的缓冲，调用方读不到） */
-export const MoveToEx = /*@__PURE__*/ b('MoveToEx', '<HDC>ptr! i32 i32 <POINT>ptr -> i32')
+export declare const MoveToEx: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: import("../ffi/ctype.js").MaybePtr<"POINT">) => number;
 /** 从当前位置画线到 (x,y)（不含端点），当前位置随之移动
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
  *  @param args_1 x 终点 x
  *  @param args_2 y 终点 y */
-export const LineTo = /*@__PURE__*/ b('LineTo', '<HDC>ptr! i32 i32 -> i32')
-
+export declare const LineTo: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number) => number;
 /** 画折线（当前画笔描边，不填充、不自动闭合）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
  *  @param args_1 pts 点数组（structArray(POINT) encoder 直传元素数组；NULL 位传 NULL，
  *                []/单对象 fail-loud）
  *  @param args_2 cPoints 点数（= pts.length，C 侧显式计数位） */
-export const Polyline = /*@__PURE__*/ b('Polyline', '<HDC>ptr! <POINT>ptr i32 -> i32', { POINT: POINTArr })
+export declare const Polyline: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: readonly {
+    x?: number | undefined;
+    y?: number | undefined;
+}[] | import("../ffi/ctype.js").MaybePtr<"POINT">, args_2: number) => number;
 /** 多边形（画笔描边 + 当前画刷填充，首尾自动闭合）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
  *  @param args_1 pts 点数组（structArray(POINT) encoder 直传元素数组；NULL 位传 NULL）
  *  @param args_2 cPoints 点数（= pts.length） */
-export const Polygon = /*@__PURE__*/ b('Polygon', '<HDC>ptr! <POINT>ptr i32 -> i32', { POINT: POINTArr })
+export declare const Polygon: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: readonly {
+    x?: number | undefined;
+    y?: number | undefined;
+}[] | import("../ffi/ctype.js").MaybePtr<"POINT">, args_2: number) => number;
 /** 矩形（画笔描边 + 当前画刷填充；右/下边缘不画入区域）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -315,7 +376,9 @@ export const Polygon = /*@__PURE__*/ b('Polygon', '<HDC>ptr! <POINT>ptr i32 -> i
  *  @param args_2 t 左上 y
  *  @param args_3 r 右下 x（不含）
  *  @param args_4 b 右下 y（不含） */
-export const Rectangle = /*@__PURE__*/ b('Rectangle', '<HDC>ptr! i32 i32 i32 i32 -> i32')
+export declare const Rectangle: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number) => number;
 /** 椭圆（外接矩形内切，边缘可达四边中点；描边 + 填充）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -323,7 +386,9 @@ export const Rectangle = /*@__PURE__*/ b('Rectangle', '<HDC>ptr! i32 i32 i32 i32
  *  @param args_2 t 外接矩形上 y
  *  @param args_3 r 外接矩形右 x
  *  @param args_4 b 外接矩形下 y */
-export const Ellipse = /*@__PURE__*/ b('Ellipse', '<HDC>ptr! i32 i32 i32 i32 -> i32')
+export declare const Ellipse: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number) => number;
 /** 圆角矩形（四角为 w×h 椭圆弧；描边 + 填充）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -333,8 +398,9 @@ export const Ellipse = /*@__PURE__*/ b('Ellipse', '<HDC>ptr! i32 i32 i32 i32 ->
  *  @param args_4 b 右下 y（不含）
  *  @param args_5 w 四角椭圆横半径
  *  @param args_6 h 四角椭圆纵半径 */
-export const RoundRect = /*@__PURE__*/ b('RoundRect', '<HDC>ptr! i32 i32 i32 i32 i32 i32 -> i32')
-
+export declare const RoundRect: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: number, args_6: number) => number;
 /** 画圆弧（外接矩形内切椭圆上起点→终点的弧，默认逆时针、SetArcDirection 可改向；
  *  仅描边，不填充、不闭合）
  *  @returns 成功 → 非 0
@@ -347,7 +413,9 @@ export const RoundRect = /*@__PURE__*/ b('RoundRect', '<HDC>ptr! i32 i32 i32 i32
  *  @param args_6 yStart 弧起点 y
  *  @param args_7 xEnd 弧终点 x
  *  @param args_8 yEnd 弧终点 y */
-export const Arc = /*@__PURE__*/ b('Arc', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 -> i32')
+export declare const Arc: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: number, args_6: number, args_7: number, args_8: number) => number;
 /** 弓形（弧 + 起终点间弦闭合；描边 + 当前画刷填充）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -359,7 +427,9 @@ export const Arc = /*@__PURE__*/ b('Arc', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32
  *  @param args_6 yStart 弧起点 y
  *  @param args_7 xEnd 弧终点 x
  *  @param args_8 yEnd 弧终点 y */
-export const Chord = /*@__PURE__*/ b('Chord', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 -> i32')
+export declare const Chord: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: number, args_6: number, args_7: number, args_8: number) => number;
 /** 扇形（弧 + 中心到两端半径闭合；描边 + 当前画刷填充）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -371,8 +441,9 @@ export const Chord = /*@__PURE__*/ b('Chord', '<HDC>ptr! i32 i32 i32 i32 i32 i32
  *  @param args_6 yStart 弧起点 y
  *  @param args_7 xEnd 弧终点 x
  *  @param args_8 yEnd 弧终点 y */
-export const Pie = /*@__PURE__*/ b('Pie', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 -> i32')
-
+export declare const Pie: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: number, args_5: number, args_6: number, args_7: number, args_8: number) => number;
 /** 底层文字输出（颜色走 SetTextColor、衬底走 SetBkMode/SetBkColor，位置受 SetTextAlign
  *  默认左上对齐约束）
  *  @returns 成功 → 非 0
@@ -381,13 +452,17 @@ export const Pie = /*@__PURE__*/ b('Pie', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32
  *  @param args_2 y 起点 y
  *  @param args_3 str 文本（<WCHAR>ptr 位直传 string，引擎 UTF-16 编码并持活到调用结束）
  *  @param args_4 c 字符数（= str.length；C 要字符数不是字节数，不含 NUL） */
-export const TextOut = /*@__PURE__*/ b('TextOutW', '<HDC>ptr! i32 i32 <WCHAR>ptr i32 -> i32')
+export declare const TextOut: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: string | import("../ffi/ctype.js").MaybePtr<"WCHAR">, args_4: number) => number;
 /** 设置 TextOut/ExtTextOut 的对齐与当前位置更新方式；TA_* 按位组合
  *  （如 TextAlign.TA_CENTER | TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
  *  @returns 旧 flags（新 DC 默认 TA_LEFT|TA_TOP|TA_NOUPDATECP = 0）
  *  @param args_0 hdc 目标 DC
  *  @param args_1 fMode TextAlign 成员按位或 */
-export const SetTextAlign = /*@__PURE__*/ b('SetTextAlign', '<HDC>ptr! u32 -> u32')
+export declare const SetTextAlign: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number) => number;
 /** 按当前字体量字符串宽高（不含衬底与额外间距）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -395,15 +470,21 @@ export const SetTextAlign = /*@__PURE__*/ b('SetTextAlign', '<HDC>ptr! u32 -> u3
  *  @param args_2 c 字符数（= str.length）
  *  @param args_3 lpSize 出参位：SIZE.alloc().ptr 接 { cx, cy }，SIZE.decode(ptr) 读回
  *  （标 !：没出参此 API 无意义） */
-export const GetTextExtentPoint32 = /*@__PURE__*/ b('GetTextExtentPoint32W',
-    '<HDC>ptr! <WCHAR>ptr i32 <SIZE>ptr! -> i32')
+export declare const GetTextExtentPoint32: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: string | import("../ffi/ctype.js").MaybePtr<"WCHAR">, args_2: number, args_3: number & {
+    readonly ptrBrand: "SIZE";
+}) => number;
 /** 取当前字体完整度量（行高/ascent/descent/字符宽等 20 字段）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
  *  @param args_1 lptm 出参位：TEXTMETRICW.alloc().ptr 接、TEXTMETRICW.decode(ptr) 读回
  *  （标 !：没出参此 API 无意义，同 GetTextExtentPoint32 的 SIZE 位） */
-export const GetTextMetrics = /*@__PURE__*/ b('GetTextMetricsW',
-    '<HDC>ptr! <TEXTMETRICW>ptr! -> i32')
+export declare const GetTextMetrics: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number & {
+    readonly ptrBrand: "TEXTMETRICW";
+}) => number;
 /** 底层文字输出增强版（可选矩形衬底/裁剪 + 可选每字符间距）
  *  @returns 成功 → 非 0
  *  @param args_0 hdc 目标 DC
@@ -416,5 +497,11 @@ export const GetTextMetrics = /*@__PURE__*/ b('GetTextMetricsW',
  *  @param args_5 str 文本（<WCHAR>ptr 直传 string）
  *  @param args_6 c 字符数（= str.length）
  *  @param args_7 lpDx 每字符间距数组位：本版仅收 NULL（默认等宽间距），数组形态留后续 */
-export const ExtTextOut = /*@__PURE__*/ b('ExtTextOutW',
-    '<HDC>ptr! i32 i32 u32 <RECT>ptr <WCHAR>ptr i32 <>ptr -> i32', { RECT })
+export declare const ExtTextOut: (args_0: number & {
+    readonly ptrBrand: "HDC";
+}, args_1: number, args_2: number, args_3: number, args_4: {
+    bottom?: number | undefined;
+    left?: number | undefined;
+    right?: number | undefined;
+    top?: number | undefined;
+} | import("../ffi/ctype.js").MaybePtr<"RECT">, args_5: string | import("../ffi/ctype.js").MaybePtr<"WCHAR">, args_6: number, args_7: import("../ffi/ctype.js").MaybePtr<"">) => number;

package/lib/windows/gdi32.js

@@ -80,8 +80,30 @@ export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>
  *  @param args_3 cLines 扫描行数
  *  @param args_4 lpvBits 像素接收缓冲（ArrayBuffer）
  *  @param args_5 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
- *  @param args_6 uUsage DIB_RGB_COLORS(0) */
-export const GetDIBits = /*@__PURE__*/ b('GetDIBits', '<HDC>ptr! <HGDIOBJ>ptr u32 u32 <BYTE>ptr <>ptr u32 -> i32');
+ *  @param args_6 uUsage ColorUse.RGB_COLORS */
+export const GetDIBits = /*@__PURE__*/ b('GetDIBits', '<HDC>ptr! <HGDIOBJ>ptr u32 u32 <BYTE>ptr <>ptr u32@ColorUse -> i32');
+/** 建 32bpp DIB 段位图（biHeight 负 = 自顶向下，像素内存由系统分配）——像素内容靠
+ *  SetDIBits 从调用方缓冲装入，故 ppvBits 出参槽可传 NULL 不取位地址（要直写像素
+ *  才需要非空槽）
+ *  @returns 位图句柄；失败 → 0（用完 DeleteObject）
+ *  @param args_0 hdc 参考 DC（NULL 即可，只取 DIB 格式）
+ *  @param args_1 pbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr，同 GetDIBits）
+ *  @param args_2 iUsage ColorUse.RGB_COLORS
+ *  @param args_3 ppvBits 收位地址的出参槽（NULL = 不取）
+ *  @param args_4 hSection NULL（无文件映射区）
+ *  @param args_5 offset 位数据在映射区内的偏移（无映射区恒 0） */
+export const CreateDIBSection = /*@__PURE__*/ b('CreateDIBSection', '<HDC>ptr <>ptr u32@ColorUse <>ptr <>ptr u32 -> <HGDIOBJ>ptr');
+/** 把 lpvBits 的像素装进位图（lpbmi 描述源的格式；ColorUse.RGB_COLORS 时 hdc 只定
+ *  目标格式，本仓传 NULL 实测可用——MSDN：仅 DIB_PAL_COLORS 才用 hdc）
+ *  @returns 成功复制的扫描行数；失败 → 0
+ *  @param args_0 hdc 参考 DC（NULL 即可，见上）
+ *  @param args_1 hbm 目标位图（DIB 段同可用）
+ *  @param args_2 uStartScan 起始扫描行
+ *  @param args_3 cLines 扫描行数
+ *  @param args_4 lpvBits 像素源缓冲（ArrayBuffer）
+ *  @param args_5 lpbmi BITMAPINFO 缓冲（同 GetDIBits）
+ *  @param args_6 iUsage ColorUse.RGB_COLORS */
+export const SetDIBits = /*@__PURE__*/ b('SetDIBits', '<HDC>ptr <HGDIOBJ>ptr! u32 u32 <BYTE>ptr <>ptr u32@ColorUse -> i32');
 /** 取 GDI 对象信息到 lpv（hFont → LOGFONTW 等）
  *  @returns 写入的字节数；失败 → 0
  *  @param args_0 h GDI 对象句柄（字体/画笔/位图等）
@@ -171,8 +193,8 @@ export const MaskBlt = /*@__PURE__*/ b('MaskBlt', '<HDC>ptr! i32 i32 i32 i32 <HD
  *  @param args_8 uNumScans 扫描行数
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲
- *  @param args_11 iUsage DIB_RGB_COLORS(0) */
-export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice', '<HDC>ptr! i32 i32 u32 u32 i32 i32 u32 u32 <BYTE>ptr <BYTE>ptr u32 -> i32');
+ *  @param args_11 iUsage ColorUse.RGB_COLORS */
+export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice', '<HDC>ptr! i32 i32 u32 u32 i32 i32 u32 u32 <BYTE>ptr <BYTE>ptr u32@ColorUse -> i32');
 /** 拉伸 DIB 传送（内存像素缓冲直接放/缩到目标，免创建 HBITMAP 中转）；
  *  DestWidth/DestHeight 传 0 = 源自然尺寸；SrcWidth/SrcHeight 负 = 翻转
  *  @returns 成功 → 扫描行数；失败 → 0
@@ -186,9 +208,9 @@ export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice', '<HDC>ptr!
  *  @param args_8 SrcHeight 源区高
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
- *  @param args_11 iUsage DIB_RGB_COLORS(0)
+ *  @param args_11 iUsage ColorUse.RGB_COLORS
  *  @param args_12 rop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
-export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 <BYTE>ptr <BYTE>ptr u32 u32@RasterOp -> i32');
+export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 <BYTE>ptr <BYTE>ptr u32@ColorUse u32@RasterOp -> i32');
 // ============ 画图原语（笔 / 线 / 形状 / 文字） ============
 /** 取系统共享对象（笔/刷/字体/调色板）；共享句柄不要 DeleteObject——
  *  SelectObject 选入 hdc 生效（如 NULL_BRUSH 让形状只描边不填充）