Win32 API 日本語リファレンス
ホームGraphics.Gdi › GetGlyphOutlineW

GetGlyphOutlineW

関数
文字のグリフ輪郭やビットマップを取得する。
DLLGDI32.dll文字セットUnicode (-W)呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// GDI32.dll  (Unicode / -W)
#include <windows.h>

DWORD GetGlyphOutlineW(
    HDC hdc,
    DWORD uChar,
    GET_GLYPH_OUTLINE_FORMAT fuFormat,
    GLYPHMETRICS* lpgm,
    DWORD cjBuffer,
    void* pvBuffer,   // optional
    const MAT2* lpmat2
);

パラメーター

名前方向説明
hdcHDCinデバイスコンテキストへのハンドル。
uCharDWORDinデータを返す対象の文字。
fuFormatGET_GLYPH_OUTLINE_FORMATin

関数が取得するデータの形式。このパラメーターには、次のいずれかの値を指定できます。

意味
GGO_BEZIER
曲線データを(2 次スプライン形式ではなく)3 次ベジェスプラインとして取得します。
GGO_BITMAP
グリフのビットマップを取得します。メモリ割り当てについては、後述の「解説」セクションを参照してください。
GGO_GLYPH_INDEX
uChar パラメーターが文字コードではなく TrueType のグリフインデックスであることを示します。グリフインデックスに関する補足は ExtTextOut 関数を参照してください。
GGO_GRAY2_BITMAP
5 階調のグレースケールを含むグリフビットマップを取得します。
GGO_GRAY4_BITMAP
17 階調のグレースケールを含むグリフビットマップを取得します。
GGO_GRAY8_BITMAP
65 階調のグレースケールを含むグリフビットマップを取得します。
GGO_METRICS
lpgm で指定された GLYPHMETRICS 構造体のみを取得します。lpvBuffer は無視されます。この値は失敗時の関数の戻り値の意味に影響します。「戻り値」セクションを参照してください。
GGO_NATIVE
曲線データのポイントをラスタライザーのネイティブ形式で取得し、フォントのデザイン単位を使用します。
GGO_UNHINTED
ヒンティングされていないアウトラインのみを返します。このフラグは GGO_BEZIER および GGO_NATIVE と組み合わせた場合にのみ機能します。

GGO_GRAYn_BITMAP の各値では、関数は n^2+1(n の 2 乗に 1 を加えた数)階調のグレースケールを含むグリフビットマップを取得することに注意してください。

lpgmGLYPHMETRICS*out文字セル内におけるグリフの配置を記述する GLYPHMETRICS 構造体へのポインター。
cjBufferDWORDinアウトライン文字に関する情報を関数がコピーするバッファー (*lpvBuffer) のサイズ(バイト単位)。この値が 0 の場合、関数は必要なバッファーサイズを返します。
pvBuffervoid*outoptionalアウトライン文字に関する情報を受け取るバッファーへのポインター。この値が NULL の場合、関数は必要なバッファーサイズを返します。
lpmat2MAT2*in文字の変換マトリックスを指定する MAT2 構造体へのポインター。

戻り値の型: DWORD

公式ドキュメント

GetGlyphOutline 関数は、指定したデバイスコンテキストに選択されている TrueType フォント内の文字について、アウトラインまたはビットマップを取得します。(Unicode)

戻り値

GGO_BITMAPGGO_GRAY2_BITMAPGGO_GRAY4_BITMAPGGO_GRAY8_BITMAP、または GGO_NATIVE が指定され、関数が成功した場合、戻り値は 0 より大きい値になります。それ以外の場合、戻り値は GDI_ERROR です。これらのフラグのいずれかが指定され、バッファーサイズまたはアドレスが 0 の場合、戻り値は必要なバッファーサイズ(バイト単位)を示します。

GGO_METRICS が指定され、関数が失敗した場合、戻り値は GDI_ERROR です。

解説(Remarks)

GetGlyphOutline 関数が返すグリフアウトラインは、グリッドフィット処理されたグリフのものです。(グリッドフィット処理されたグリフとは、そのビットマップ画像がグリフの元のデザインに可能な限り近くなるように変更されたグリフです。)変更されていないグリフアウトラインが必要な場合、アプリケーションは、フォントの em 単位に等しいサイズのフォントで文字のグリフアウトラインを要求できます。フォントの em 単位の値は、OUTLINETEXTMETRIC 構造体の otmEMSquare メンバーに格納されています。

GGO_BITMAP が指定された場合に GetGlyphOutline が返すグリフビットマップは、DWORD 境界に整列した行指向のモノクロビットマップです。GGO_GRAY2_BITMAP が指定された場合、返されるビットマップは、値が 0 から 4 の範囲をとる、DWORD 境界に整列した行指向のバイト配列です。GGO_GRAY4_BITMAP が指定された場合、返されるビットマップは、値が 0 から 16 の範囲をとる、DWORD 境界に整列した行指向のバイト配列です。GGO_GRAY8_BITMAP が指定された場合、返されるビットマップは、値が 0 から 64 の範囲をとる、DWORD 境界に整列した行指向のバイト配列です。

GGO_NATIVE が指定された場合に GetGlyphOutline が返すネイティブバッファーは、グリフアウトラインです。グリフアウトラインは、TTPOLYGONHEADER 構造体に続いて 1 つ以上の曲線が定義された、1 つ以上の輪郭の連続として返されます。輪郭内の各曲線は、TTPOLYCURVE 構造体に続いて複数の POINTFX データポイントによって定義されます。POINTFX のポイントは相対的な移動ではなく絶対位置です。輪郭の開始点は TTPOLYGONHEADER 構造体の pfxStart メンバーで与えられます。各曲線の開始点は、前の曲線の最後のポイント、または輪郭の開始点です。曲線内のデータポイント数は TTPOLYCURVE 構造体の cpfx メンバーに格納されます。バッファー内の各輪郭のサイズ(バイト単位)は TTPOLYGONHEADER 構造体の cb メンバーに格納されます。追加の曲線定義は先行する曲線に続いてバッファーに詰め込まれ、追加の輪郭は先行する輪郭に続いてバッファーに詰め込まれます。バッファーには、GetGlyphOutline が返すバッファーに収まる数だけ輪郭が含まれます。

GLYPHMETRICS 構造体は、文字セルの幅と、文字セル内のグリフの位置を指定します。文字セルの原点は、セルの左側、フォントのベースライン上に位置します。グリフ原点の位置は文字セル原点を基準とした相対位置です。文字セルの高さ、ベースライン、およびフォント全体に共通するその他のメトリックは、OUTLINETEXTMETRIC 構造体で与えられます。

アプリケーションは、lpMatrix パラメーターに 2x2 の変換マトリックスを指定することで、ビットマップ形式またはネイティブ形式で取得される文字を変形できます。たとえば、マトリックス乗算を使用して、せん断、回転、拡大縮小、またはこれら 3 つの任意の組み合わせによってグリフを変更できます。

グリフアウトラインに関する追加情報は、TrueType および OpenType の技術仕様書にあります。

メモ

wingdi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして GetGlyphOutline を定義します。エンコーディングに依存しないエイリアスの使用を、エンコーディングに依存しないわけではないコードと混在させると、不一致が生じ、コンパイルエラーや実行時エラーを引き起こす可能性があります。詳細については、関数プロトタイプの規則を参照してください。

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

各言語での呼び出し定義

// GDI32.dll  (Unicode / -W)
#include <windows.h>

DWORD GetGlyphOutlineW(
    HDC hdc,
    DWORD uChar,
    GET_GLYPH_OUTLINE_FORMAT fuFormat,
    GLYPHMETRICS* lpgm,
    DWORD cjBuffer,
    void* pvBuffer,   // optional
    const MAT2* lpmat2
);
[DllImport("GDI32.dll", CharSet = CharSet.Unicode, ExactSpelling = true)]
static extern uint GetGlyphOutlineW(
    IntPtr hdc,   // HDC
    uint uChar,   // DWORD
    uint fuFormat,   // GET_GLYPH_OUTLINE_FORMAT
    IntPtr lpgm,   // GLYPHMETRICS* out
    uint cjBuffer,   // DWORD
    IntPtr pvBuffer,   // void* optional, out
    IntPtr lpmat2   // MAT2*
);
<DllImport("GDI32.dll", CharSet:=CharSet.Unicode, ExactSpelling:=True)>
Public Shared Function GetGlyphOutlineW(
    hdc As IntPtr,   ' HDC
    uChar As UInteger,   ' DWORD
    fuFormat As UInteger,   ' GET_GLYPH_OUTLINE_FORMAT
    lpgm As IntPtr,   ' GLYPHMETRICS* out
    cjBuffer As UInteger,   ' DWORD
    pvBuffer As IntPtr,   ' void* optional, out
    lpmat2 As IntPtr   ' MAT2*
) As UInteger
End Function
' hdc : HDC
' uChar : DWORD
' fuFormat : GET_GLYPH_OUTLINE_FORMAT
' lpgm : GLYPHMETRICS* out
' cjBuffer : DWORD
' pvBuffer : void* optional, out
' lpmat2 : MAT2*
Declare PtrSafe Function GetGlyphOutlineW Lib "gdi32" ( _
    ByVal hdc As LongPtr, _
    ByVal uChar As Long, _
    ByVal fuFormat As Long, _
    ByVal lpgm As LongPtr, _
    ByVal cjBuffer As Long, _
    ByVal pvBuffer As LongPtr, _
    ByVal lpmat2 As LongPtr) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

GetGlyphOutlineW = ctypes.windll.gdi32.GetGlyphOutlineW
GetGlyphOutlineW.restype = wintypes.DWORD
GetGlyphOutlineW.argtypes = [
    wintypes.HANDLE,  # hdc : HDC
    wintypes.DWORD,  # uChar : DWORD
    wintypes.DWORD,  # fuFormat : GET_GLYPH_OUTLINE_FORMAT
    ctypes.c_void_p,  # lpgm : GLYPHMETRICS* out
    wintypes.DWORD,  # cjBuffer : DWORD
    ctypes.POINTER(None),  # pvBuffer : void* optional, out
    ctypes.c_void_p,  # lpmat2 : MAT2*
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('GDI32.dll')
GetGlyphOutlineW = Fiddle::Function.new(
  lib['GetGlyphOutlineW'],
  [
    Fiddle::TYPE_VOIDP,  # hdc : HDC
    -Fiddle::TYPE_INT,  # uChar : DWORD
    -Fiddle::TYPE_INT,  # fuFormat : GET_GLYPH_OUTLINE_FORMAT
    Fiddle::TYPE_VOIDP,  # lpgm : GLYPHMETRICS* out
    -Fiddle::TYPE_INT,  # cjBuffer : DWORD
    Fiddle::TYPE_VOIDP,  # pvBuffer : void* optional, out
    Fiddle::TYPE_VOIDP,  # lpmat2 : MAT2*
  ],
  -Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"
#[link(name = "gdi32")]
extern "system" {
    fn GetGlyphOutlineW(
        hdc: *mut core::ffi::c_void,  // HDC
        uChar: u32,  // DWORD
        fuFormat: u32,  // GET_GLYPH_OUTLINE_FORMAT
        lpgm: *mut GLYPHMETRICS,  // GLYPHMETRICS* out
        cjBuffer: u32,  // DWORD
        pvBuffer: *mut (),  // void* optional, out
        lpmat2: *const MAT2  // MAT2*
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("GDI32.dll", CharSet = CharSet.Unicode)]
public static extern uint GetGlyphOutlineW(IntPtr hdc, uint uChar, uint fuFormat, IntPtr lpgm, uint cjBuffer, IntPtr pvBuffer, IntPtr lpmat2);
"@
$api = Add-Type -MemberDefinition $sig -Name 'GDI32_GetGlyphOutlineW' -Namespace Win32 -PassThru
# $api::GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
#uselib "GDI32.dll"
#func global GetGlyphOutlineW "GetGlyphOutlineW" wptr, wptr, wptr, wptr, wptr, wptr, wptr
; GetGlyphOutlineW hdc, uChar, fuFormat, varptr(lpgm), cjBuffer, pvBuffer, varptr(lpmat2)   ; 戻り値は stat
; hdc : HDC -> "wptr"
; uChar : DWORD -> "wptr"
; fuFormat : GET_GLYPH_OUTLINE_FORMAT -> "wptr"
; lpgm : GLYPHMETRICS* out -> "wptr"
; cjBuffer : DWORD -> "wptr"
; pvBuffer : void* optional, out -> "wptr"
; lpmat2 : MAT2* -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "GDI32.dll"
#cfunc global GetGlyphOutlineW "GetGlyphOutlineW" sptr, int, int, var, int, sptr, var
; res = GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
; hdc : HDC -> "sptr"
; uChar : DWORD -> "int"
; fuFormat : GET_GLYPH_OUTLINE_FORMAT -> "int"
; lpgm : GLYPHMETRICS* out -> "var"
; cjBuffer : DWORD -> "int"
; pvBuffer : void* optional, out -> "sptr"
; lpmat2 : MAT2* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; DWORD GetGlyphOutlineW(HDC hdc, DWORD uChar, GET_GLYPH_OUTLINE_FORMAT fuFormat, GLYPHMETRICS* lpgm, DWORD cjBuffer, void* pvBuffer, MAT2* lpmat2)
#uselib "GDI32.dll"
#cfunc global GetGlyphOutlineW "GetGlyphOutlineW" intptr, int, int, var, int, intptr, var
; res = GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
; hdc : HDC -> "intptr"
; uChar : DWORD -> "int"
; fuFormat : GET_GLYPH_OUTLINE_FORMAT -> "int"
; lpgm : GLYPHMETRICS* out -> "var"
; cjBuffer : DWORD -> "int"
; pvBuffer : void* optional, out -> "intptr"
; lpmat2 : MAT2* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	gdi32 = windows.NewLazySystemDLL("GDI32.dll")
	procGetGlyphOutlineW = gdi32.NewProc("GetGlyphOutlineW")
)

// hdc (HDC), uChar (DWORD), fuFormat (GET_GLYPH_OUTLINE_FORMAT), lpgm (GLYPHMETRICS* out), cjBuffer (DWORD), pvBuffer (void* optional, out), lpmat2 (MAT2*)
r1, _, err := procGetGlyphOutlineW.Call(
	uintptr(hdc),
	uintptr(uChar),
	uintptr(fuFormat),
	uintptr(lpgm),
	uintptr(cjBuffer),
	uintptr(pvBuffer),
	uintptr(lpmat2),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function GetGlyphOutlineW(
  hdc: THandle;   // HDC
  uChar: DWORD;   // DWORD
  fuFormat: DWORD;   // GET_GLYPH_OUTLINE_FORMAT
  lpgm: Pointer;   // GLYPHMETRICS* out
  cjBuffer: DWORD;   // DWORD
  pvBuffer: Pointer;   // void* optional, out
  lpmat2: Pointer   // MAT2*
): DWORD; stdcall;
  external 'GDI32.dll' name 'GetGlyphOutlineW';
result := DllCall("GDI32\GetGlyphOutlineW"
    , "Ptr", hdc   ; HDC
    , "UInt", uChar   ; DWORD
    , "UInt", fuFormat   ; GET_GLYPH_OUTLINE_FORMAT
    , "Ptr", lpgm   ; GLYPHMETRICS* out
    , "UInt", cjBuffer   ; DWORD
    , "Ptr", pvBuffer   ; void* optional, out
    , "Ptr", lpmat2   ; MAT2*
    , "UInt")   ; return: DWORD
●GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2) = DLL("GDI32.dll", "dword GetGlyphOutlineW(void*, dword, dword, void*, dword, void*, void*)")
# 呼び出し: GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
# hdc : HDC -> "void*"
# uChar : DWORD -> "dword"
# fuFormat : GET_GLYPH_OUTLINE_FORMAT -> "dword"
# lpgm : GLYPHMETRICS* out -> "void*"
# cjBuffer : DWORD -> "dword"
# pvBuffer : void* optional, out -> "void*"
# lpmat2 : MAT2* -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。
const std = @import("std");

extern "gdi32" fn GetGlyphOutlineW(
    hdc: ?*anyopaque, // HDC
    uChar: u32, // DWORD
    fuFormat: u32, // GET_GLYPH_OUTLINE_FORMAT
    lpgm: [*c]GLYPHMETRICS, // GLYPHMETRICS* out
    cjBuffer: u32, // DWORD
    pvBuffer: ?*anyopaque, // void* optional, out
    lpmat2: [*c]MAT2 // MAT2*
) callconv(std.os.windows.WINAPI) u32;
// Unicode(-W): UTF-16LE のヌル終端バッファ([*c]const u16)を渡す。
proc GetGlyphOutlineW(
    hdc: pointer,  # HDC
    uChar: uint32,  # DWORD
    fuFormat: uint32,  # GET_GLYPH_OUTLINE_FORMAT
    lpgm: ptr GLYPHMETRICS,  # GLYPHMETRICS* out
    cjBuffer: uint32,  # DWORD
    pvBuffer: pointer,  # void* optional, out
    lpmat2: ptr MAT2  # MAT2*
): uint32 {.importc: "GetGlyphOutlineW", stdcall, dynlib: "GDI32.dll".}
# Unicode(-W): WideCString は newWideCString("...") で生成。
pragma(lib, "gdi32");
extern(Windows)
uint GetGlyphOutlineW(
    void* hdc,   // HDC
    uint uChar,   // DWORD
    uint fuFormat,   // GET_GLYPH_OUTLINE_FORMAT
    GLYPHMETRICS* lpgm,   // GLYPHMETRICS* out
    uint cjBuffer,   // DWORD
    void* pvBuffer,   // void* optional, out
    MAT2* lpmat2   // MAT2*
);
ccall((:GetGlyphOutlineW, "GDI32.dll"), stdcall, UInt32,
      (Ptr{Cvoid}, UInt32, UInt32, Ptr{GLYPHMETRICS}, UInt32, Ptr{Cvoid}, Ptr{MAT2}),
      hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
# hdc : HDC -> Ptr{Cvoid}
# uChar : DWORD -> UInt32
# fuFormat : GET_GLYPH_OUTLINE_FORMAT -> UInt32
# lpgm : GLYPHMETRICS* out -> Ptr{GLYPHMETRICS}
# cjBuffer : DWORD -> UInt32
# pvBuffer : void* optional, out -> Ptr{Cvoid}
# lpmat2 : MAT2* -> Ptr{MAT2}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
# Unicode(-W): Cwstring には transcode(UInt16, "...") 等で UTF-16 を渡す。
local ffi = require("ffi")
ffi.cdef[[
uint32_t GetGlyphOutlineW(
    void* hdc,
    uint32_t uChar,
    uint32_t fuFormat,
    void* lpgm,
    uint32_t cjBuffer,
    void* pvBuffer,
    void* lpmat2);
]]
local gdi32 = ffi.load("gdi32")
-- gdi32.GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
-- hdc : HDC
-- uChar : DWORD
-- fuFormat : GET_GLYPH_OUTLINE_FORMAT
-- lpgm : GLYPHMETRICS* out
-- cjBuffer : DWORD
-- pvBuffer : void* optional, out
-- lpmat2 : MAT2*
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
-- Unicode(-W): uint16_t* には UTF-16LE のバッファ(ffi.new("uint16_t[?]", ...))を渡す。
const koffi = require('koffi');
const lib = koffi.load('GDI32.dll');
const GetGlyphOutlineW = lib.func('__stdcall', 'GetGlyphOutlineW', 'uint32_t', ['void *', 'uint32_t', 'uint32_t', 'void *', 'uint32_t', 'void *', 'void *']);
// GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
// hdc : HDC -> 'void *'
// uChar : DWORD -> 'uint32_t'
// fuFormat : GET_GLYPH_OUTLINE_FORMAT -> 'uint32_t'
// lpgm : GLYPHMETRICS* out -> 'void *'
// cjBuffer : DWORD -> 'uint32_t'
// pvBuffer : void* optional, out -> 'void *'
// lpmat2 : MAT2* -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("GDI32.dll", {
  GetGlyphOutlineW: { parameters: ["pointer", "u32", "u32", "pointer", "u32", "pointer", "pointer"], result: "u32" },
});
// lib.symbols.GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2)
// hdc : HDC -> "pointer"
// uChar : DWORD -> "u32"
// fuFormat : GET_GLYPH_OUTLINE_FORMAT -> "u32"
// lpgm : GLYPHMETRICS* out -> "pointer"
// cjBuffer : DWORD -> "u32"
// pvBuffer : void* optional, out -> "pointer"
// lpmat2 : MAT2* -> "pointer"
// 文字列は "buffer"。Unicode(-W) は new TextEncoder() ではなく UTF-16LE のバイト列(末尾に \x00\x00)を Uint8Array で渡す。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
uint32_t GetGlyphOutlineW(
    void* hdc,
    uint32_t uChar,
    uint32_t fuFormat,
    void* lpgm,
    uint32_t cjBuffer,
    void* pvBuffer,
    void* lpmat2);
C, "GDI32.dll");
// $ffi->GetGlyphOutlineW(hdc, uChar, fuFormat, lpgm, cjBuffer, pvBuffer, lpmat2);
// hdc : HDC
// uChar : DWORD
// fuFormat : GET_GLYPH_OUTLINE_FORMAT
// lpgm : GLYPHMETRICS* out
// cjBuffer : DWORD
// pvBuffer : void* optional, out
// lpmat2 : MAT2*
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Gdi32 extends StdCallLibrary {
    Gdi32 INSTANCE = Native.load("gdi32", Gdi32.class, W32APIOptions.UNICODE_OPTIONS);
    int GetGlyphOutlineW(
        Pointer hdc,   // HDC
        int uChar,   // DWORD
        int fuFormat,   // GET_GLYPH_OUTLINE_FORMAT
        Pointer lpgm,   // GLYPHMETRICS* out
        int cjBuffer,   // DWORD
        Pointer pvBuffer,   // void* optional, out
        Pointer lpmat2   // MAT2*
    );
}
// Unicode(-W): WString(入力)/char[](出力)で UTF-16 をマーシャリング。
@[Link("gdi32")]
lib LibGDI32
  fun GetGlyphOutlineW = GetGlyphOutlineW(
    hdc : Void*,   # HDC
    uChar : UInt32,   # DWORD
    fuFormat : UInt32,   # GET_GLYPH_OUTLINE_FORMAT
    lpgm : GLYPHMETRICS*,   # GLYPHMETRICS* out
    cjBuffer : UInt32,   # DWORD
    pvBuffer : Void*,   # void* optional, out
    lpmat2 : MAT2*   # MAT2*
  ) : UInt32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef GetGlyphOutlineWNative = Uint32 Function(Pointer<Void>, Uint32, Uint32, Pointer<Void>, Uint32, Pointer<Void>, Pointer<Void>);
typedef GetGlyphOutlineWDart = int Function(Pointer<Void>, int, int, Pointer<Void>, int, Pointer<Void>, Pointer<Void>);
final GetGlyphOutlineW = DynamicLibrary.open('GDI32.dll')
    .lookupFunction<GetGlyphOutlineWNative, GetGlyphOutlineWDart>('GetGlyphOutlineW');
// hdc : HDC -> Pointer<Void>
// uChar : DWORD -> Uint32
// fuFormat : GET_GLYPH_OUTLINE_FORMAT -> Uint32
// lpgm : GLYPHMETRICS* out -> Pointer<Void>
// cjBuffer : DWORD -> Uint32
// pvBuffer : void* optional, out -> Pointer<Void>
// lpmat2 : MAT2* -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function GetGlyphOutlineW(
  hdc: THandle;   // HDC
  uChar: DWORD;   // DWORD
  fuFormat: DWORD;   // GET_GLYPH_OUTLINE_FORMAT
  lpgm: Pointer;   // GLYPHMETRICS* out
  cjBuffer: DWORD;   // DWORD
  pvBuffer: Pointer;   // void* optional, out
  lpmat2: Pointer   // MAT2*
): DWORD; stdcall;
  external 'GDI32.dll' name 'GetGlyphOutlineW';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "GetGlyphOutlineW"
  c_GetGlyphOutlineW :: Ptr () -> Word32 -> Word32 -> Ptr () -> Word32 -> Ptr () -> Ptr () -> IO Word32
-- hdc : HDC -> Ptr ()
-- uChar : DWORD -> Word32
-- fuFormat : GET_GLYPH_OUTLINE_FORMAT -> Word32
-- lpgm : GLYPHMETRICS* out -> Ptr ()
-- cjBuffer : DWORD -> Word32
-- pvBuffer : void* optional, out -> Ptr ()
-- lpmat2 : MAT2* -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let getglyphoutlinew =
  foreign "GetGlyphOutlineW"
    ((ptr void) @-> uint32_t @-> uint32_t @-> (ptr void) @-> uint32_t @-> (ptr void) @-> (ptr void) @-> returning uint32_t)
(* hdc : HDC -> (ptr void) *)
(* uChar : DWORD -> uint32_t *)
(* fuFormat : GET_GLYPH_OUTLINE_FORMAT -> uint32_t *)
(* lpgm : GLYPHMETRICS* out -> (ptr void) *)
(* cjBuffer : DWORD -> uint32_t *)
(* pvBuffer : void* optional, out -> (ptr void) *)
(* lpmat2 : MAT2* -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library gdi32 (t "GDI32.dll"))
(cffi:use-foreign-library gdi32)

(cffi:defcfun ("GetGlyphOutlineW" get-glyph-outline-w :convention :stdcall) :uint32
  (hdc :pointer)   ; HDC
  (u-char :uint32)   ; DWORD
  (fu-format :uint32)   ; GET_GLYPH_OUTLINE_FORMAT
  (lpgm :pointer)   ; GLYPHMETRICS* out
  (cj-buffer :uint32)   ; DWORD
  (pv-buffer :pointer)   ; void* optional, out
  (lpmat2 :pointer))   ; MAT2*
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $GetGlyphOutlineW = Win32::API::More->new('GDI32',
    'DWORD GetGlyphOutlineW(HANDLE hdc, DWORD uChar, DWORD fuFormat, LPVOID lpgm, DWORD cjBuffer, LPVOID pvBuffer, LPVOID lpmat2)');
# my $ret = $GetGlyphOutlineW->Call($hdc, $uChar, $fuFormat, $lpgm, $cjBuffer, $pvBuffer, $lpmat2);
# hdc : HDC -> HANDLE
# uChar : DWORD -> DWORD
# fuFormat : GET_GLYPH_OUTLINE_FORMAT -> DWORD
# lpgm : GLYPHMETRICS* out -> LPVOID
# cjBuffer : DWORD -> DWORD
# pvBuffer : void* optional, out -> LPVOID
# lpmat2 : MAT2* -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。
# Unicode(-W): LPCWSTR/LPWSTR は Win32::API が UTF-16 変換を行う。

関連項目

文字セット違い
公式の関連項目
使用する型