FONTOBJ
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| iUniq | DWORD | 4 | +0 | +0 | フォントの個別の実現 (realization) を指定します。ドライバーはこの値を使用して、キャッシュしている可能性のある GDI フォントを識別したり、ドライバー自身のフォントの実現を識別したりできます。GDI フォントでこのメンバーが 0 の場合、そのフォントはキャッシュしないでください。 | ||||||||||||||||||||||||||||||||||||
| iFace | DWORD | 4 | +4 | +4 | DrvQueryFont の呼び出しによって登録されたデバイスフォントのデバイスインデックスを指定します。フォントが GDI フォントの場合、このメンバーは GDI にとってのみ意味を持つため、ドライバーは無視してください。 | ||||||||||||||||||||||||||||||||||||
| cxMax | DWORD | 4 | +8 | +8 | 指定されたフォント内で最大のグリフの幅をピクセル単位で指定します。 | ||||||||||||||||||||||||||||||||||||
| flFontType | DWORD | 4 | +12 | +12 | フォントの種類を指定する値です。このメンバーには、次の表に示すフラグの組み合わせを指定できます (ただし、FO_GRAY16 と FO_NOGRAY16 は相互に排他的です)。
FO_RASTER フラグが設定されている場合、指定された STROBJ 構造体に書き込まれるグリフはビットマップです。設定されていない場合は PATHOBJ 構造体へのポインターになります。グリフイメージが PATHOBJ 構造体の形式で返される場合、ドライバーは関連する IFIMETRICS 構造体の flInfo メンバーの FM_INFO_TECH_STROKE フラグを調べる必要があります。このフラグが設定されている場合はパスをストローク描画し、設定されていない場合は交互 (alternating) モードの規則に従ってパスを塗りつぶす必要があります。 FO_GRAY16 フラグが設定されている場合、フォントのビットマップは 4 ビット/ピクセルのブレンド (アルファ) 値です。値が 0 の場合、結果のピクセルは背景と同じ色になります。アルファ値が k のとき、線形アルファブレンドまたはガンマ補正アルファブレンドを使用した場合の結果のピクセルの属性を次の表に示します。どちらの方式でも、前景色と背景色はそれぞれ cf と cb です。
GDI は、フォントを 16 段階の値のいずれかにグレースケール化するよう要求する際、DrvQueryFontData 関数の呼び出し時に FO_GRAY16 フラグを設定します。フォントドライバーが特定のフォントの実現をグレースケール化できない場合、フォントプロバイダーは FO_GRAY16 フラグをクリアし、FO_NOGRAY16 フラグを設定して、グレースケール化の要求が満たされないことを GDI に通知します。 | ||||||||||||||||||||||||||||||||||||
| iTTUniq | UINT_PTR | 8/4 | +16 | +16 | 関連付けられた TrueType ファイルを指定します。TrueType フォントフェイスの 2 つの異なるポイントサイズの実現は、同じ iTTUniq 値を共有する FONTOBJ 構造体を持ちますが、iUniq 値は異なります。iTTUniq メンバーが 0 以外の値になるのは TrueType フォントの種類のみです。詳細については flFontType を参照してください。 | ||||||||||||||||||||||||||||||||||||
| iFile | UINT_PTR | 8/4 | +24 | +20 | 既に読み込まれているデバイスフォントについて、ドライバー定義の値へのポインターです。フォントが GDI フォントの場合、このメンバーはフォントを識別するために内部的に使用されるため、無視してください。 | ||||||||||||||||||||||||||||||||||||
| sizLogResPpi | SIZE | 8 | +32 | +24 | このフォントが実現されたデバイスの解像度を指定します。 | ||||||||||||||||||||||||||||||||||||
| ulStyleSize | DWORD | 4 | +40 | +32 | フォントインスタンスのスタイルサイズをポイント単位で指定します。 | ||||||||||||||||||||||||||||||||||||
| pvConsumer | void* | 8/4 | +48 | +36 | このフォントインスタンスに関連付けられた、コンシューマーが割り当てたデータへのポインターです。コンシューマーとは、テキスト出力を生成するための入力としてグリフ情報を受け取るドライバーです。このメンバーを変更できるのはフォントコンシューマーだけです。このフォントのコンシューマーは、このメンバーが指す場所に任意の情報を格納できます。エンジンがこのメンバーを変更することはありません。pvConsumer メンバーは、FONTOBJ 構造体が最初にコンシューマーへ渡されるときには必ず null になります。 | ||||||||||||||||||||||||||||||||||||
| pvProducer | void* | 8/4 | +56 | +40 | このフォントインスタンスに関連付けられた、プロデューサーが割り当てたデータへのポインターです。プロデューサーとは、グリフ情報を出力として生成できるドライバーであり、これにはグリフメトリック、ビットマップ、アウトラインが含まれます。このメンバーを変更できるのはフォントプロデューサーだけです。このフォントのプロデューサーは、このメンバーが指す場所に任意の情報を格納できます。エンジンがこのメンバーを変更することはありません。pvProducer メンバーは、FONTOBJ 構造体が最初にプロデューサーへ渡されるときには必ず null になります。 |
公式ドキュメント
FONTOBJ 構造体は、フォントの特定のインスタンスに関する情報へのアクセスをドライバーに提供するために使用されます。
解説(Remarks)
高速化のため、ドライバーは FONTOBJ 構造体のパブリックメンバーにアクセスすることが許可されています。
ドライバーはプロデューサーとコンシューマーの両方になることができます。たとえばプリンタードライバーは、グリフメトリックを提供するためにドライバー提供の DrvQueryFontData 関数の呼び出しを処理している間はプロデューサーとして動作し、その後、ドライバー提供の DrvTextOut 関数の呼び出しを処理している間はコンシューマーとして動作できます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// SIZE (x64 8 / x86 8 バイト)
typedef struct SIZE {
INT cx;
INT cy;
} SIZE;
// FONTOBJ (x64 64 / x86 44 バイト)
typedef struct FONTOBJ {
DWORD iUniq;
DWORD iFace;
DWORD cxMax;
DWORD flFontType;
UINT_PTR iTTUniq;
UINT_PTR iFile;
SIZE sizLogResPpi;
DWORD ulStyleSize;
void* pvConsumer;
void* pvProducer;
} FONTOBJ;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SIZE
{
public int cx;
public int cy;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FONTOBJ
{
public uint iUniq;
public uint iFace;
public uint cxMax;
public uint flFontType;
public UIntPtr iTTUniq;
public UIntPtr iFile;
public SIZE sizLogResPpi;
public uint ulStyleSize;
public IntPtr pvConsumer;
public IntPtr pvProducer;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SIZE
Public cx As Integer
Public cy As Integer
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FONTOBJ
Public iUniq As UInteger
Public iFace As UInteger
Public cxMax As UInteger
Public flFontType As UInteger
Public iTTUniq As UIntPtr
Public iFile As UIntPtr
Public sizLogResPpi As SIZE
Public ulStyleSize As UInteger
Public pvConsumer As IntPtr
Public pvProducer As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class SIZE(ctypes.Structure):
_fields_ = [
("cx", ctypes.c_int),
("cy", ctypes.c_int),
]
class FONTOBJ(ctypes.Structure):
_fields_ = [
("iUniq", wintypes.DWORD),
("iFace", wintypes.DWORD),
("cxMax", wintypes.DWORD),
("flFontType", wintypes.DWORD),
("iTTUniq", ctypes.c_size_t),
("iFile", ctypes.c_size_t),
("sizLogResPpi", SIZE),
("ulStyleSize", wintypes.DWORD),
("pvConsumer", ctypes.c_void_p),
("pvProducer", ctypes.c_void_p),
]#[repr(C)]
pub struct SIZE {
pub cx: i32,
pub cy: i32,
}
#[repr(C)]
pub struct FONTOBJ {
pub iUniq: u32,
pub iFace: u32,
pub cxMax: u32,
pub flFontType: u32,
pub iTTUniq: usize,
pub iFile: usize,
pub sizLogResPpi: SIZE,
pub ulStyleSize: u32,
pub pvConsumer: *mut core::ffi::c_void,
pub pvProducer: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type SIZE struct {
cx int32
cy int32
}
type FONTOBJ struct {
iUniq uint32
iFace uint32
cxMax uint32
flFontType uint32
iTTUniq uintptr
iFile uintptr
sizLogResPpi SIZE
ulStyleSize uint32
pvConsumer uintptr
pvProducer uintptr
}type
SIZE = record
cx: Integer;
cy: Integer;
end;
FONTOBJ = record
iUniq: DWORD;
iFace: DWORD;
cxMax: DWORD;
flFontType: DWORD;
iTTUniq: NativeUInt;
iFile: NativeUInt;
sizLogResPpi: SIZE;
ulStyleSize: DWORD;
pvConsumer: Pointer;
pvProducer: Pointer;
end;const SIZE = extern struct {
cx: i32,
cy: i32,
};
const FONTOBJ = extern struct {
iUniq: u32,
iFace: u32,
cxMax: u32,
flFontType: u32,
iTTUniq: usize,
iFile: usize,
sizLogResPpi: SIZE,
ulStyleSize: u32,
pvConsumer: ?*anyopaque,
pvProducer: ?*anyopaque,
};type
SIZE {.bycopy.} = object
cx: int32
cy: int32
FONTOBJ {.bycopy.} = object
iUniq: uint32
iFace: uint32
cxMax: uint32
flFontType: uint32
iTTUniq: uint
iFile: uint
sizLogResPpi: SIZE
ulStyleSize: uint32
pvConsumer: pointer
pvProducer: pointerstruct SIZE
{
int cx;
int cy;
}
struct FONTOBJ
{
uint iUniq;
uint iFace;
uint cxMax;
uint flFontType;
size_t iTTUniq;
size_t iFile;
SIZE sizLogResPpi;
uint ulStyleSize;
void* pvConsumer;
void* pvProducer;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; FONTOBJ サイズ: 44 バイト(x86)
dim st, 11 ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; iUniq : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; iFace : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; cxMax : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; flFontType : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; iTTUniq : UINT_PTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; iFile : UINT_PTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; sizLogResPpi : SIZE (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ulStyleSize : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; pvConsumer : void* (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; pvProducer : void* (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FONTOBJ サイズ: 64 バイト(x64)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; iUniq : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; iFace : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; cxMax : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; flFontType : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; iTTUniq : UINT_PTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; iFile : UINT_PTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; sizLogResPpi : SIZE (+32, 8byte) varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; ulStyleSize : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; pvConsumer : void* (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pvProducer : void* (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global SIZE
#field int cx
#field int cy
#endstruct
#defstruct global FONTOBJ
#field int iUniq
#field int iFace
#field int cxMax
#field int flFontType
#field intptr iTTUniq
#field intptr iFile
#field SIZE sizLogResPpi
#field int ulStyleSize
#field intptr pvConsumer
#field intptr pvProducer
#endstruct
stdim st, FONTOBJ ; NSTRUCT 変数を確保
st->iUniq = 100
mes "iUniq=" + st->iUniq