ホーム › Devices.Display › XLATEOBJ
XLATEOBJ
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| iUniq | DWORD | 4 | +0 | +0 | 以前にキャッシュした XLATEOBJ 構造体をドライバーが認識できるようにするキャッシュ識別子です。このメンバーが 0 の場合、ドライバーは XLATEOBJ 構造体をキャッシュしないでください。 | ||||||||||||||
| flXlate | DWORD | 4 | +4 | +4 | 変換に関するヒントを指定するフラグです。このメンバーには、次の値の任意の組み合わせを指定できます。
| ||||||||||||||
| iSrcType | WORD | 2 | +8 | +8 | 廃止されています。変換元の形式を照会するには XLATEOBJ_cGetPalette を使用してください。 | ||||||||||||||
| iDstType | WORD | 2 | +10 | +10 | 廃止されています。変換先の形式を照会するには XLATEOBJ_cGetPalette を使用してください。 | ||||||||||||||
| cEntries | DWORD | 4 | +12 | +12 | pulXlate メンバーが指す配列内のエントリ数を指定します。cEntries より大きい値で pulXlate にインデックスを指定すると、メモリアクセス違反が発生します。 | ||||||||||||||
| pulXlate | DWORD* | 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)
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 Structureimport 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: pointerstruct 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