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

FONTOBJ

構造体
サイズx64: 64 バイト / x86: 44 バイト

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

フィールド

フィールドサイズx64x86説明
iUniqDWORD4+0+0フォントの個別の実現 (realization) を指定します。ドライバーはこの値を使用して、キャッシュしている可能性のある GDI フォントを識別したり、ドライバー自身のフォントの実現を識別したりできます。GDI フォントでこのメンバーが 0 の場合、そのフォントはキャッシュしないでください。
iFaceDWORD4+4+4DrvQueryFont の呼び出しによって登録されたデバイスフォントのデバイスインデックスを指定します。フォントが GDI フォントの場合、このメンバーは GDI にとってのみ意味を持つため、ドライバーは無視してください。
cxMaxDWORD4+8+8指定されたフォント内で最大のグリフの幅をピクセル単位で指定します。
flFontTypeDWORD4+12+12

フォントの種類を指定する値です。このメンバーには、次の表に示すフラグの組み合わせを指定できます (ただし、FO_GRAY16FO_NOGRAY16 は相互に排他的です)。

フラグ 意味
FO_CFF PostScript OpenType フォントです。
FO_DBCS_FONT フォントが DBCS コードページをサポートします。
FO_EM_HEIGHT TrueType ドライバーの内部フラグです。
FO_GRAY16 フォントのビットマップが 4 ビット/ピクセルのブレンド (アルファ) 値です。
FO_MULTIPLEMASTER Multiple Master (Type1 または OpenType) フォントです。
FO_NOGRAY16 フォントドライバーが特定のフォントの実現をグレースケール化できない (または行わない) ことを示します。
FO_POSTSCRIPT PostScript (Type1 または OpenType) フォントです。
FO_SIM_BOLD ドライバーがシミュレートした太字フォントです。
FO_SIM_ITALIC ドライバーがシミュレートした斜体フォントです。
FO_TYPE_DEVICE デバイス固有のフォントです。
FO_TYPE_OPENTYPE OpenType フォントです。
FO_TYPE_RASTER ビットマップフォントです。
FO_TYPE_TRUETYPE TrueType フォントです。
FO_VERT_FACE 縦書きフォントです。

FO_RASTER フラグが設定されている場合、指定された STROBJ 構造体に書き込まれるグリフはビットマップです。設定されていない場合は PATHOBJ 構造体へのポインターになります。グリフイメージが PATHOBJ 構造体の形式で返される場合、ドライバーは関連する IFIMETRICS 構造体の flInfo メンバーの FM_INFO_TECH_STROKE フラグを調べる必要があります。このフラグが設定されている場合はパスをストローク描画し、設定されていない場合は交互 (alternating) モードの規則に従ってパスを塗りつぶす必要があります。

FO_GRAY16 フラグが設定されている場合、フォントのビットマップは 4 ビット/ピクセルのブレンド (アルファ) 値です。値が 0 の場合、結果のピクセルは背景と同じ色になります。アルファ値が k のとき、線形アルファブレンドまたはガンマ補正アルファブレンドを使用した場合の結果のピクセルの属性を次の表に示します。どちらの方式でも、前景色と背景色はそれぞれ cf と cb です。

ピクセルの属性 説明
ブレンド後の色
(線形アルファブレンド)
線形アルファブレンドでは、前景色と背景色の線形結合となるブレンド後の色が生成されます。

c = b * cf + (1 - b) * cb

ブレンド係数 b は次のように求めます。

b = k / 15 (k = 0, 1, 2, ..., 15)

注: 前景色と背景色には 3 つの色チャネル (R、G、B) すべてが含まれます。

ブレンド後の色
(ガンマ補正アルファブレンド)
ガンマ補正アルファブレンドでは、アルファ値に依存する変数を固定のべき乗にすることでブレンド後の色が生成されます。

数式は 2 つあります。前景色が背景色より数値的に大きい場合は一方を、その逆の場合はもう一方を使用します (前景色と背景色が等しい場合、どちらの数式も c = cb に簡約されます)。

cf > cb の場合、
c = cb + pow(b[k], (1 / gamma)) * (cf - cb)
cf < cb の場合、
c = cb + (1 - pow(1 - b[k], 1 / gamma)) * (cf - cb)

これらの数式において gamma = 2.33 であり、b[k] は k番目のブレンド係数で、次のように求めます。

b[k] = 0 (k = 0 の場合)、および
b[k] = (k + 1) / 16 (k = 1, 2, ..., 15 の場合)

注: 線形アルファブレンドとは異なり、これらの数式は 3 つの色チャネル (R、G、B) のそれぞれに適用する必要があります。

GDI は、フォントを 16 段階の値のいずれかにグレースケール化するよう要求する際、DrvQueryFontData 関数の呼び出し時に FO_GRAY16 フラグを設定します。フォントドライバーが特定のフォントの実現をグレースケール化できない場合、フォントプロバイダーは FO_GRAY16 フラグをクリアし、FO_NOGRAY16 フラグを設定して、グレースケール化の要求が満たされないことを GDI に通知します。

iTTUniqUINT_PTR8/4+16+16関連付けられた TrueType ファイルを指定します。TrueType フォントフェイスの 2 つの異なるポイントサイズの実現は、同じ iTTUniq 値を共有する FONTOBJ 構造体を持ちますが、iUniq 値は異なります。iTTUniq メンバーが 0 以外の値になるのは TrueType フォントの種類のみです。詳細については flFontType を参照してください。
iFileUINT_PTR8/4+24+20既に読み込まれているデバイスフォントについて、ドライバー定義の値へのポインターです。フォントが GDI フォントの場合、このメンバーはフォントを識別するために内部的に使用されるため、無視してください。
sizLogResPpiSIZE8+32+24このフォントが実現されたデバイスの解像度を指定します。
ulStyleSizeDWORD4+40+32フォントインスタンスのスタイルサイズをポイント単位で指定します。
pvConsumervoid*8/4+48+36このフォントインスタンスに関連付けられた、コンシューマーが割り当てたデータへのポインターです。コンシューマーとは、テキスト出力を生成するための入力としてグリフ情報を受け取るドライバーです。このメンバーを変更できるのはフォントコンシューマーだけです。このフォントのコンシューマーは、このメンバーが指す場所に任意の情報を格納できます。エンジンがこのメンバーを変更することはありません。pvConsumer メンバーは、FONTOBJ 構造体が最初にコンシューマーへ渡されるときには必ず null になります。
pvProducervoid*8/4+56+40このフォントインスタンスに関連付けられた、プロデューサーが割り当てたデータへのポインターです。プロデューサーとは、グリフ情報を出力として生成できるドライバーであり、これにはグリフメトリック、ビットマップ、アウトラインが含まれます。このメンバーを変更できるのはフォントプロデューサーだけです。このフォントのプロデューサーは、このメンバーが指す場所に任意の情報を格納できます。エンジンがこのメンバーを変更することはありません。pvProducer メンバーは、FONTOBJ 構造体が最初にプロデューサーへ渡されるときには必ず null になります。

公式ドキュメント

FONTOBJ 構造体は、フォントの特定のインスタンスに関する情報へのアクセスをドライバーに提供するために使用されます。

解説(Remarks)

高速化のため、ドライバーは FONTOBJ 構造体のパブリックメンバーにアクセスすることが許可されています。

ドライバーはプロデューサーとコンシューマーの両方になることができます。たとえばプリンタードライバーは、グリフメトリックを提供するためにドライバー提供の DrvQueryFontData 関数の呼び出しを処理している間はプロデューサーとして動作し、その後、ドライバー提供の DrvTextOut 関数の呼び出しを処理している間はコンシューマーとして動作できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: pointer
struct 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