Win32 API 日本語リファレンス
ホームDevices.Display › XLATEOBJ

XLATEOBJ

構造体
サイズx64: 24 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
iUniqDWORD4+0+0以前にキャッシュした XLATEOBJ 構造体をドライバーが認識できるようにするキャッシュ識別子です。このメンバーが 0 の場合、ドライバーは XLATEOBJ 構造体をキャッシュしないでください。
flXlateDWORD4+4+4

変換に関するヒントを指定するフラグです。このメンバーには、次の値の任意の組み合わせを指定できます。

意味
XO_DEVICE_ICM デバイスで ICM が有効になっています。ドライバーは、DrvIcmCreateColorTransform によって作成されたカラー変換に従って色を変換する必要があります。ドライバーは XLATEOBJ_hGetColorTransform を呼び出して、カラー変換のハンドルを取得してください。このビットは XO_HOST_ICM と排他的です。
XO_FROM_CMYK ICM による変換の結果として、変換元インデックスは 32 ビットの CMYK カラー形式に変換されます。このビットが設定されている場合、iSrcTypeiDstTypecEntriespulXlate は無視してください。
XO_HOST_ICM ICM はグラフィックスエンジンによって実行されるため、このカラーテーブル内の色は変換先サーフェスに合わせて補正されています。このビットは、ドライバーへの情報として GDI が設定します。ドライバー側で必要な処理はありません。このビットは XO_DEVICE_ICM と排他的です。
XO_TABLE 変換元インデックスを変換先インデックスに変換するためのテーブルが提供されます。
XO_TO_MONO 変換元インデックスはモノクロ形式に変換されます。このとき、1 つを除くすべてのインデックスが 0 にマップされるという特別な性質があります。ドライバーはこれを利用してブロック転送を高速化できます。
XO_TRIVIAL 変換元インデックスをそのまま変換先インデックスとして使用できます。
iSrcTypeWORD2+8+8廃止されています。変換元の形式を照会するには XLATEOBJ_cGetPalette を使用してください。
iDstTypeWORD2+10+10廃止されています。変換先の形式を照会するには XLATEOBJ_cGetPalette を使用してください。
cEntriesDWORD4+12+12pulXlate メンバーが指す配列内のエントリ数を指定します。cEntries より大きい値で pulXlate にインデックスを指定すると、メモリアクセス違反が発生します。
pulXlateDWORD*8/4+16+16変換エントリの配列へのポインターです。

公式ドキュメント

XLATEOBJ 構造体は、あるパレットから別のパレットへカラーインデックスを変換するために使用されます。

解説(Remarks)

変換先パレットは、常に何らかの描画操作における変換先サーフェスに属します。変換元パレットは、アプリケーションが選択したパレット、または別のサーフェスのパレットです。

XLATEOBJ 構造体は、変換元パレットを参照するカラーインデックスを、変換先パレット用のインデックスに変換するために使用されます。得られたインデックスは、変換元の色に可能な限り近い色を示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// XLATEOBJ  (x64 24 / x86 20 バイト)
typedef struct XLATEOBJ {
    DWORD iUniq;
    DWORD flXlate;
    WORD iSrcType;
    WORD iDstType;
    DWORD cEntries;
    DWORD* pulXlate;
} XLATEOBJ;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct XLATEOBJ
{
    public uint iUniq;
    public uint flXlate;
    public ushort iSrcType;
    public ushort iDstType;
    public uint cEntries;
    public IntPtr pulXlate;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure XLATEOBJ
    Public iUniq As UInteger
    Public flXlate As UInteger
    Public iSrcType As UShort
    Public iDstType As UShort
    Public cEntries As UInteger
    Public pulXlate As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class XLATEOBJ(ctypes.Structure):
    _fields_ = [
        ("iUniq", wintypes.DWORD),
        ("flXlate", wintypes.DWORD),
        ("iSrcType", ctypes.c_ushort),
        ("iDstType", ctypes.c_ushort),
        ("cEntries", wintypes.DWORD),
        ("pulXlate", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct XLATEOBJ {
    pub iUniq: u32,
    pub flXlate: u32,
    pub iSrcType: u16,
    pub iDstType: u16,
    pub cEntries: u32,
    pub pulXlate: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type XLATEOBJ struct {
	iUniq uint32
	flXlate uint32
	iSrcType uint16
	iDstType uint16
	cEntries uint32
	pulXlate uintptr
}
type
  XLATEOBJ = record
    iUniq: DWORD;
    flXlate: DWORD;
    iSrcType: Word;
    iDstType: Word;
    cEntries: DWORD;
    pulXlate: Pointer;
  end;
const XLATEOBJ = extern struct {
    iUniq: u32,
    flXlate: u32,
    iSrcType: u16,
    iDstType: u16,
    cEntries: u32,
    pulXlate: ?*anyopaque,
};
type
  XLATEOBJ {.bycopy.} = object
    iUniq: uint32
    flXlate: uint32
    iSrcType: uint16
    iDstType: uint16
    cEntries: uint32
    pulXlate: pointer
struct XLATEOBJ
{
    uint iUniq;
    uint flXlate;
    ushort iSrcType;
    ushort iDstType;
    uint cEntries;
    void* pulXlate;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; XLATEOBJ サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; iUniq : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; flXlate : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; iSrcType : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; iDstType : WORD (+10, 2byte)  wpoke st,10,値  /  値 = wpeek(st,10)
; cEntries : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pulXlate : DWORD* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; XLATEOBJ サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; iUniq : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; flXlate : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; iSrcType : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; iDstType : WORD (+10, 2byte)  wpoke st,10,値  /  値 = wpeek(st,10)
; cEntries : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pulXlate : DWORD* (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global XLATEOBJ
    #field int iUniq
    #field int flXlate
    #field short iSrcType
    #field short iDstType
    #field int cEntries
    #field intptr pulXlate
#endstruct

stdim st, XLATEOBJ        ; NSTRUCT 変数を確保
st->iUniq = 100
mes "iUniq=" + st->iUniq