GetGlyphOutlineW
関数シグネチャ
// 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
);パラメーター
| 名前 | 型 | 方向 | 説明 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hdc | HDC | in | デバイスコンテキストへのハンドル。 | ||||||||||||||||||||
| uChar | DWORD | in | データを返す対象の文字。 | ||||||||||||||||||||
| fuFormat | GET_GLYPH_OUTLINE_FORMAT | in | 関数が取得するデータの形式。このパラメーターには、次のいずれかの値を指定できます。
GGO_GRAYn_BITMAP の各値では、関数は n^2+1(n の 2 乗に 1 を加えた数)階調のグレースケールを含むグリフビットマップを取得することに注意してください。 | ||||||||||||||||||||
| lpgm | GLYPHMETRICS* | out | 文字セル内におけるグリフの配置を記述する GLYPHMETRICS 構造体へのポインター。 | ||||||||||||||||||||
| cjBuffer | DWORD | in | アウトライン文字に関する情報を関数がコピーするバッファー (*lpvBuffer) のサイズ(バイト単位)。この値が 0 の場合、関数は必要なバッファーサイズを返します。 | ||||||||||||||||||||
| pvBuffer | void* | outoptional | アウトライン文字に関する情報を受け取るバッファーへのポインター。この値が NULL の場合、関数は必要なバッファーサイズを返します。 | ||||||||||||||||||||
| lpmat2 | MAT2* | in | 文字の変換マトリックスを指定する MAT2 構造体へのポインター。 |
戻り値の型: DWORD
公式ドキュメント
GetGlyphOutline 関数は、指定したデバイスコンテキストに選択されている TrueType フォント内の文字について、アウトラインまたはビットマップを取得します。(Unicode)
戻り値
GGO_BITMAP、GGO_GRAY2_BITMAP、GGO_GRAY4_BITMAP、GGO_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 公式リファレンス: 英語 (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 方式にも切替可。#uselib "GDI32.dll" #cfunc global GetGlyphOutlineW "GetGlyphOutlineW" sptr, int, int, sptr, int, sptr, sptr ; res = GetGlyphOutlineW(hdc, uChar, fuFormat, varptr(lpgm), cjBuffer, pvBuffer, varptr(lpmat2)) ; hdc : HDC -> "sptr" ; uChar : DWORD -> "int" ; fuFormat : GET_GLYPH_OUTLINE_FORMAT -> "int" ; lpgm : GLYPHMETRICS* out -> "sptr" ; cjBuffer : DWORD -> "int" ; pvBuffer : void* optional, out -> "sptr" ; lpmat2 : MAT2* -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは 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 方式にも切替可。; 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, intptr, int, intptr, intptr ; res = GetGlyphOutlineW(hdc, uChar, fuFormat, varptr(lpgm), cjBuffer, pvBuffer, varptr(lpmat2)) ; hdc : HDC -> "intptr" ; uChar : DWORD -> "int" ; fuFormat : GET_GLYPH_OUTLINE_FORMAT -> "int" ; lpgm : GLYPHMETRICS* out -> "intptr" ; cjBuffer : DWORD -> "int" ; pvBuffer : void* optional, out -> "intptr" ; lpmat2 : MAT2* -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは 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 // DWORDfunction 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 変換を行う。関連項目
- f GetGlyphOutlineA (ANSI版) — 文字のグリフ輪郭やビットマップを取得する。
- f ExtTextOutW — 矩形や文字間隔を指定して文字列を描画する(Unicode版)。
- f GetOutlineTextMetricsW — アウトラインフォントのテキストメトリックを取得する。
- s OUTLINETEXTMETRICW
- s POINT
- s POINTFX
- s TTPOLYCURVE
- s TTPOLYGONHEADER