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

TTEmbedFont

関数
TrueTypeフォントを文書へ埋め込むためにストリームに書き出す。
DLLt2embed.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// t2embed.dll
#include <windows.h>

INT TTEmbedFont(
    HDC hDC,
    TTEMBED_FLAGS ulFlags,
    EMBED_FONT_CHARSET ulCharSet,
    EMBEDDED_FONT_PRIV_STATUS* pulPrivStatus,
    DWORD* pulStatus,
    WRITEEMBEDPROC lpfnWriteToStream,
    void* lpvWriteStream,
    WORD* pusCharCodeSet,
    WORD usCharCodeCount,
    WORD usLanguage,
    TTEMBEDINFO* pTTEmbedInfo   // optional
);

パラメーター

名前方向説明
hDCHDCinデバイス コンテキストのハンドル。
ulFlagsTTEMBED_FLAGSin

埋め込み要求を指定するフラグ。このフラグには、次の値のうち 0 個以上を指定できます。

意味
TTEMBED_EMBEDEUDC
関連付けられた EUDC フォント ファイルのデータをフォント構造体に含めます。
TTEMBED_RAW
完全な文字セットを含む非圧縮のフォント構造体を返します。これがこの関数の既定の動作です。
TTEMBED_SUBSET
pusCharCodeSet または pulCharCodeSet パラメーターで指定されたグリフのみを含むサブセット化されたフォントを返します。これらの文字コードは、パラメーターに応じて 16 ビット文字または UCS-4 文字として指定する必要があります。
TTEMBED_TTCOMPRESSED
圧縮されたフォント構造体を返します。
ulCharSetEMBED_FONT_CHARSETin

埋め込むフォントの文字セットを指定するフラグ。このフラグには、次の値のいずれかを指定できます。

意味
CHARSET_UNICODE
Unicode 文字セット。16 ビット文字エンコードが必要です。
CHARSET_SYMBOL
シンボル文字セット。16 ビット文字エンコードが必要です。
pulPrivStatusEMBEDDED_FONT_PRIV_STATUS*out

フォントの埋め込み権限を示すフラグへのポインター。このフラグには、次の値のいずれかを指定できます。この関数は、許諾された最も制限の緩いライセンスを返します。

意味
EMBED_PREVIEWPRINT
プレビューおよび印刷のための埋め込み。
EMBED_EDITABLE
編集可能な埋め込み。
EMBED_INSTALLABLE
インストール可能な埋め込み。
EMBED_NOEMBEDDING
制限付きライセンスの埋め込み。
pulStatusDWORD*out埋め込み要求に関するステータス情報を格納するビットフィールドへのポインター。このフィールドは、この関数の完了時に設定されます。このパラメーターには現在定義されているビットはありません。
lpfnWriteToStreamWRITEEMBEDPROCinフォント構造体をドキュメント ストリームに書き込む、クライアント定義のコールバック関数へのポインター。WRITEEMBEDPROC を参照してください。
lpvWriteStreamvoid*in出力ストリームを表すトークン。
pusCharCodeSetWORD*inサブセット化に使用する省略可能な Unicode 文字コードを格納するバッファーへのポインター。このフィールドはフォントのサブセット化にのみ使用され、ulFlags フィールドに TTEMBED_SUBSET が指定されていない場合は無視されます。
usCharCodeCountWORDinpusCharCodeSet で示される文字リスト内の文字数。このフィールドはフォントのサブセット化にのみ使用され、ulFlags フィールドに TTEMBED_SUBSET が指定されていない場合は無視されます。
usLanguageWORDinサブセット化の際に name テーブルで保持する言語を指定します。すべての言語を保持するには 0 を設定します。このフィールドはフォントのサブセット化にのみ使用され、ulFlags フィールドに TTEMBED_SUBSET が指定されていない場合は無視されます。
pTTEmbedInfoTTEMBEDINFO*inoptional埋め込みフォント オブジェクトを正当に参照できる URL を格納する TTEMBEDINFO 構造体へのポインター。pTTEmbedInfoNULL の場合、埋め込みフォント オブジェクトに URL は追加されず、クライアントが TTLoadEmbeddedFont を呼び出した際に URL のチェックは行われません。

戻り値の型: INT

公式ドキュメント

サブセット化されたワイド文字(16 ビット)フォントを格納するフォント構造体を作成します。フォント情報は、デバイス コンテキスト(hDC)の現在のフォントから取得されます。

戻り値

埋め込みに成功した場合は E_NONE を返します。

フォント構造体はクライアントによってドキュメント ストリームに組み込まれます。pulPrivStatus にはフォントの埋め込み権限を示す値が設定され、pulStatus には埋め込み操作の結果が設定されます。

それ以外の場合は、Embedding-Function Error Messages で説明されているエラー コードを返します。

解説(Remarks)

フォントの文字セットの判定と指定は、クライアントの責任で行います。

UCS-4 文字の埋め込みについては、TTEmbedFontEx を参照してください。ファイルからのフォント文字の埋め込みについては、TTEmbedFontFromFileA を参照してください。

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

各言語での呼び出し定義

// t2embed.dll
#include <windows.h>

INT TTEmbedFont(
    HDC hDC,
    TTEMBED_FLAGS ulFlags,
    EMBED_FONT_CHARSET ulCharSet,
    EMBEDDED_FONT_PRIV_STATUS* pulPrivStatus,
    DWORD* pulStatus,
    WRITEEMBEDPROC lpfnWriteToStream,
    void* lpvWriteStream,
    WORD* pusCharCodeSet,
    WORD usCharCodeCount,
    WORD usLanguage,
    TTEMBEDINFO* pTTEmbedInfo   // optional
);
[DllImport("t2embed.dll", ExactSpelling = true)]
static extern int TTEmbedFont(
    IntPtr hDC,   // HDC
    uint ulFlags,   // TTEMBED_FLAGS
    uint ulCharSet,   // EMBED_FONT_CHARSET
    out uint pulPrivStatus,   // EMBEDDED_FONT_PRIV_STATUS* out
    out uint pulStatus,   // DWORD* out
    IntPtr lpfnWriteToStream,   // WRITEEMBEDPROC
    IntPtr lpvWriteStream,   // void*
    ref ushort pusCharCodeSet,   // WORD*
    ushort usCharCodeCount,   // WORD
    ushort usLanguage,   // WORD
    IntPtr pTTEmbedInfo   // TTEMBEDINFO* optional
);
<DllImport("t2embed.dll", ExactSpelling:=True)>
Public Shared Function TTEmbedFont(
    hDC As IntPtr,   ' HDC
    ulFlags As UInteger,   ' TTEMBED_FLAGS
    ulCharSet As UInteger,   ' EMBED_FONT_CHARSET
    <Out> ByRef pulPrivStatus As UInteger,   ' EMBEDDED_FONT_PRIV_STATUS* out
    <Out> ByRef pulStatus As UInteger,   ' DWORD* out
    lpfnWriteToStream As IntPtr,   ' WRITEEMBEDPROC
    lpvWriteStream As IntPtr,   ' void*
    ByRef pusCharCodeSet As UShort,   ' WORD*
    usCharCodeCount As UShort,   ' WORD
    usLanguage As UShort,   ' WORD
    pTTEmbedInfo As IntPtr   ' TTEMBEDINFO* optional
) As Integer
End Function
' hDC : HDC
' ulFlags : TTEMBED_FLAGS
' ulCharSet : EMBED_FONT_CHARSET
' pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
' pulStatus : DWORD* out
' lpfnWriteToStream : WRITEEMBEDPROC
' lpvWriteStream : void*
' pusCharCodeSet : WORD*
' usCharCodeCount : WORD
' usLanguage : WORD
' pTTEmbedInfo : TTEMBEDINFO* optional
Declare PtrSafe Function TTEmbedFont Lib "t2embed" ( _
    ByVal hDC As LongPtr, _
    ByVal ulFlags As Long, _
    ByVal ulCharSet As Long, _
    ByRef pulPrivStatus As Long, _
    ByRef pulStatus As Long, _
    ByVal lpfnWriteToStream As LongPtr, _
    ByVal lpvWriteStream As LongPtr, _
    ByRef pusCharCodeSet As Integer, _
    ByVal usCharCodeCount As Integer, _
    ByVal usLanguage As Integer, _
    ByVal pTTEmbedInfo As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

TTEmbedFont = ctypes.windll.t2embed.TTEmbedFont
TTEmbedFont.restype = ctypes.c_int
TTEmbedFont.argtypes = [
    wintypes.HANDLE,  # hDC : HDC
    wintypes.DWORD,  # ulFlags : TTEMBED_FLAGS
    wintypes.DWORD,  # ulCharSet : EMBED_FONT_CHARSET
    ctypes.c_void_p,  # pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
    ctypes.POINTER(wintypes.DWORD),  # pulStatus : DWORD* out
    ctypes.c_void_p,  # lpfnWriteToStream : WRITEEMBEDPROC
    ctypes.POINTER(None),  # lpvWriteStream : void*
    ctypes.POINTER(ctypes.c_ushort),  # pusCharCodeSet : WORD*
    ctypes.c_ushort,  # usCharCodeCount : WORD
    ctypes.c_ushort,  # usLanguage : WORD
    ctypes.c_void_p,  # pTTEmbedInfo : TTEMBEDINFO* optional
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('t2embed.dll')
TTEmbedFont = Fiddle::Function.new(
  lib['TTEmbedFont'],
  [
    Fiddle::TYPE_VOIDP,  # hDC : HDC
    -Fiddle::TYPE_INT,  # ulFlags : TTEMBED_FLAGS
    -Fiddle::TYPE_INT,  # ulCharSet : EMBED_FONT_CHARSET
    Fiddle::TYPE_VOIDP,  # pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
    Fiddle::TYPE_VOIDP,  # pulStatus : DWORD* out
    Fiddle::TYPE_VOIDP,  # lpfnWriteToStream : WRITEEMBEDPROC
    Fiddle::TYPE_VOIDP,  # lpvWriteStream : void*
    Fiddle::TYPE_VOIDP,  # pusCharCodeSet : WORD*
    -Fiddle::TYPE_SHORT,  # usCharCodeCount : WORD
    -Fiddle::TYPE_SHORT,  # usLanguage : WORD
    Fiddle::TYPE_VOIDP,  # pTTEmbedInfo : TTEMBEDINFO* optional
  ],
  Fiddle::TYPE_INT)
#[link(name = "t2embed")]
extern "system" {
    fn TTEmbedFont(
        hDC: *mut core::ffi::c_void,  // HDC
        ulFlags: u32,  // TTEMBED_FLAGS
        ulCharSet: u32,  // EMBED_FONT_CHARSET
        pulPrivStatus: *mut u32,  // EMBEDDED_FONT_PRIV_STATUS* out
        pulStatus: *mut u32,  // DWORD* out
        lpfnWriteToStream: *const core::ffi::c_void,  // WRITEEMBEDPROC
        lpvWriteStream: *mut (),  // void*
        pusCharCodeSet: *mut u16,  // WORD*
        usCharCodeCount: u16,  // WORD
        usLanguage: u16,  // WORD
        pTTEmbedInfo: *mut TTEMBEDINFO  // TTEMBEDINFO* optional
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("t2embed.dll")]
public static extern int TTEmbedFont(IntPtr hDC, uint ulFlags, uint ulCharSet, out uint pulPrivStatus, out uint pulStatus, IntPtr lpfnWriteToStream, IntPtr lpvWriteStream, ref ushort pusCharCodeSet, ushort usCharCodeCount, ushort usLanguage, IntPtr pTTEmbedInfo);
"@
$api = Add-Type -MemberDefinition $sig -Name 't2embed_TTEmbedFont' -Namespace Win32 -PassThru
# $api::TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
#uselib "t2embed.dll"
#func global TTEmbedFont "TTEmbedFont" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; TTEmbedFont hDC, ulFlags, ulCharSet, varptr(pulPrivStatus), varptr(pulStatus), lpfnWriteToStream, lpvWriteStream, varptr(pusCharCodeSet), usCharCodeCount, usLanguage, varptr(pTTEmbedInfo)   ; 戻り値は stat
; hDC : HDC -> "sptr"
; ulFlags : TTEMBED_FLAGS -> "sptr"
; ulCharSet : EMBED_FONT_CHARSET -> "sptr"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "sptr"
; pulStatus : DWORD* out -> "sptr"
; lpfnWriteToStream : WRITEEMBEDPROC -> "sptr"
; lpvWriteStream : void* -> "sptr"
; pusCharCodeSet : WORD* -> "sptr"
; usCharCodeCount : WORD -> "sptr"
; usLanguage : WORD -> "sptr"
; pTTEmbedInfo : TTEMBEDINFO* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "t2embed.dll"
#cfunc global TTEmbedFont "TTEmbedFont" sptr, int, int, var, var, sptr, sptr, var, int, int, var
; res = TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
; hDC : HDC -> "sptr"
; ulFlags : TTEMBED_FLAGS -> "int"
; ulCharSet : EMBED_FONT_CHARSET -> "int"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "var"
; pulStatus : DWORD* out -> "var"
; lpfnWriteToStream : WRITEEMBEDPROC -> "sptr"
; lpvWriteStream : void* -> "sptr"
; pusCharCodeSet : WORD* -> "var"
; usCharCodeCount : WORD -> "int"
; usLanguage : WORD -> "int"
; pTTEmbedInfo : TTEMBEDINFO* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; INT TTEmbedFont(HDC hDC, TTEMBED_FLAGS ulFlags, EMBED_FONT_CHARSET ulCharSet, EMBEDDED_FONT_PRIV_STATUS* pulPrivStatus, DWORD* pulStatus, WRITEEMBEDPROC lpfnWriteToStream, void* lpvWriteStream, WORD* pusCharCodeSet, WORD usCharCodeCount, WORD usLanguage, TTEMBEDINFO* pTTEmbedInfo)
#uselib "t2embed.dll"
#cfunc global TTEmbedFont "TTEmbedFont" intptr, int, int, var, var, intptr, intptr, var, int, int, var
; res = TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
; hDC : HDC -> "intptr"
; ulFlags : TTEMBED_FLAGS -> "int"
; ulCharSet : EMBED_FONT_CHARSET -> "int"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "var"
; pulStatus : DWORD* out -> "var"
; lpfnWriteToStream : WRITEEMBEDPROC -> "intptr"
; lpvWriteStream : void* -> "intptr"
; pusCharCodeSet : WORD* -> "var"
; usCharCodeCount : WORD -> "int"
; usLanguage : WORD -> "int"
; pTTEmbedInfo : TTEMBEDINFO* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	t2embed = windows.NewLazySystemDLL("t2embed.dll")
	procTTEmbedFont = t2embed.NewProc("TTEmbedFont")
)

// hDC (HDC), ulFlags (TTEMBED_FLAGS), ulCharSet (EMBED_FONT_CHARSET), pulPrivStatus (EMBEDDED_FONT_PRIV_STATUS* out), pulStatus (DWORD* out), lpfnWriteToStream (WRITEEMBEDPROC), lpvWriteStream (void*), pusCharCodeSet (WORD*), usCharCodeCount (WORD), usLanguage (WORD), pTTEmbedInfo (TTEMBEDINFO* optional)
r1, _, err := procTTEmbedFont.Call(
	uintptr(hDC),
	uintptr(ulFlags),
	uintptr(ulCharSet),
	uintptr(pulPrivStatus),
	uintptr(pulStatus),
	uintptr(lpfnWriteToStream),
	uintptr(lpvWriteStream),
	uintptr(pusCharCodeSet),
	uintptr(usCharCodeCount),
	uintptr(usLanguage),
	uintptr(pTTEmbedInfo),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // INT
function TTEmbedFont(
  hDC: THandle;   // HDC
  ulFlags: DWORD;   // TTEMBED_FLAGS
  ulCharSet: DWORD;   // EMBED_FONT_CHARSET
  pulPrivStatus: Pointer;   // EMBEDDED_FONT_PRIV_STATUS* out
  pulStatus: Pointer;   // DWORD* out
  lpfnWriteToStream: Pointer;   // WRITEEMBEDPROC
  lpvWriteStream: Pointer;   // void*
  pusCharCodeSet: Pointer;   // WORD*
  usCharCodeCount: Word;   // WORD
  usLanguage: Word;   // WORD
  pTTEmbedInfo: Pointer   // TTEMBEDINFO* optional
): Integer; stdcall;
  external 't2embed.dll' name 'TTEmbedFont';
result := DllCall("t2embed\TTEmbedFont"
    , "Ptr", hDC   ; HDC
    , "UInt", ulFlags   ; TTEMBED_FLAGS
    , "UInt", ulCharSet   ; EMBED_FONT_CHARSET
    , "Ptr", pulPrivStatus   ; EMBEDDED_FONT_PRIV_STATUS* out
    , "Ptr", pulStatus   ; DWORD* out
    , "Ptr", lpfnWriteToStream   ; WRITEEMBEDPROC
    , "Ptr", lpvWriteStream   ; void*
    , "Ptr", pusCharCodeSet   ; WORD*
    , "UShort", usCharCodeCount   ; WORD
    , "UShort", usLanguage   ; WORD
    , "Ptr", pTTEmbedInfo   ; TTEMBEDINFO* optional
    , "Int")   ; return: INT
●TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo) = DLL("t2embed.dll", "int TTEmbedFont(void*, dword, dword, void*, void*, void*, void*, void*, int, int, void*)")
# 呼び出し: TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
# hDC : HDC -> "void*"
# ulFlags : TTEMBED_FLAGS -> "dword"
# ulCharSet : EMBED_FONT_CHARSET -> "dword"
# pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "void*"
# pulStatus : DWORD* out -> "void*"
# lpfnWriteToStream : WRITEEMBEDPROC -> "void*"
# lpvWriteStream : void* -> "void*"
# pusCharCodeSet : WORD* -> "void*"
# usCharCodeCount : WORD -> "int"
# usLanguage : WORD -> "int"
# pTTEmbedInfo : TTEMBEDINFO* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "t2embed" fn TTEmbedFont(
    hDC: ?*anyopaque, // HDC
    ulFlags: u32, // TTEMBED_FLAGS
    ulCharSet: u32, // EMBED_FONT_CHARSET
    pulPrivStatus: [*c]u32, // EMBEDDED_FONT_PRIV_STATUS* out
    pulStatus: [*c]u32, // DWORD* out
    lpfnWriteToStream: ?*anyopaque, // WRITEEMBEDPROC
    lpvWriteStream: ?*anyopaque, // void*
    pusCharCodeSet: [*c]u16, // WORD*
    usCharCodeCount: u16, // WORD
    usLanguage: u16, // WORD
    pTTEmbedInfo: [*c]TTEMBEDINFO // TTEMBEDINFO* optional
) callconv(std.os.windows.WINAPI) i32;
proc TTEmbedFont(
    hDC: pointer,  # HDC
    ulFlags: uint32,  # TTEMBED_FLAGS
    ulCharSet: uint32,  # EMBED_FONT_CHARSET
    pulPrivStatus: ptr uint32,  # EMBEDDED_FONT_PRIV_STATUS* out
    pulStatus: ptr uint32,  # DWORD* out
    lpfnWriteToStream: pointer,  # WRITEEMBEDPROC
    lpvWriteStream: pointer,  # void*
    pusCharCodeSet: ptr uint16,  # WORD*
    usCharCodeCount: uint16,  # WORD
    usLanguage: uint16,  # WORD
    pTTEmbedInfo: ptr TTEMBEDINFO  # TTEMBEDINFO* optional
): int32 {.importc: "TTEmbedFont", stdcall, dynlib: "t2embed.dll".}
pragma(lib, "t2embed");
extern(Windows)
int TTEmbedFont(
    void* hDC,   // HDC
    uint ulFlags,   // TTEMBED_FLAGS
    uint ulCharSet,   // EMBED_FONT_CHARSET
    uint* pulPrivStatus,   // EMBEDDED_FONT_PRIV_STATUS* out
    uint* pulStatus,   // DWORD* out
    void* lpfnWriteToStream,   // WRITEEMBEDPROC
    void* lpvWriteStream,   // void*
    ushort* pusCharCodeSet,   // WORD*
    ushort usCharCodeCount,   // WORD
    ushort usLanguage,   // WORD
    TTEMBEDINFO* pTTEmbedInfo   // TTEMBEDINFO* optional
);
ccall((:TTEmbedFont, "t2embed.dll"), stdcall, Int32,
      (Ptr{Cvoid}, UInt32, UInt32, Ptr{UInt32}, Ptr{UInt32}, Ptr{Cvoid}, Ptr{Cvoid}, Ptr{UInt16}, UInt16, UInt16, Ptr{TTEMBEDINFO}),
      hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
# hDC : HDC -> Ptr{Cvoid}
# ulFlags : TTEMBED_FLAGS -> UInt32
# ulCharSet : EMBED_FONT_CHARSET -> UInt32
# pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> Ptr{UInt32}
# pulStatus : DWORD* out -> Ptr{UInt32}
# lpfnWriteToStream : WRITEEMBEDPROC -> Ptr{Cvoid}
# lpvWriteStream : void* -> Ptr{Cvoid}
# pusCharCodeSet : WORD* -> Ptr{UInt16}
# usCharCodeCount : WORD -> UInt16
# usLanguage : WORD -> UInt16
# pTTEmbedInfo : TTEMBEDINFO* optional -> Ptr{TTEMBEDINFO}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
int32_t TTEmbedFont(
    void* hDC,
    uint32_t ulFlags,
    uint32_t ulCharSet,
    uint32_t* pulPrivStatus,
    uint32_t* pulStatus,
    void* lpfnWriteToStream,
    void* lpvWriteStream,
    uint16_t* pusCharCodeSet,
    uint16_t usCharCodeCount,
    uint16_t usLanguage,
    void* pTTEmbedInfo);
]]
local t2embed = ffi.load("t2embed")
-- t2embed.TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
-- hDC : HDC
-- ulFlags : TTEMBED_FLAGS
-- ulCharSet : EMBED_FONT_CHARSET
-- pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
-- pulStatus : DWORD* out
-- lpfnWriteToStream : WRITEEMBEDPROC
-- lpvWriteStream : void*
-- pusCharCodeSet : WORD*
-- usCharCodeCount : WORD
-- usLanguage : WORD
-- pTTEmbedInfo : TTEMBEDINFO* optional
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('t2embed.dll');
const TTEmbedFont = lib.func('__stdcall', 'TTEmbedFont', 'int32_t', ['void *', 'uint32_t', 'uint32_t', 'uint32_t *', 'uint32_t *', 'void *', 'void *', 'uint16_t *', 'uint16_t', 'uint16_t', 'void *']);
// TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
// hDC : HDC -> 'void *'
// ulFlags : TTEMBED_FLAGS -> 'uint32_t'
// ulCharSet : EMBED_FONT_CHARSET -> 'uint32_t'
// pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> 'uint32_t *'
// pulStatus : DWORD* out -> 'uint32_t *'
// lpfnWriteToStream : WRITEEMBEDPROC -> 'void *'
// lpvWriteStream : void* -> 'void *'
// pusCharCodeSet : WORD* -> 'uint16_t *'
// usCharCodeCount : WORD -> 'uint16_t'
// usLanguage : WORD -> 'uint16_t'
// pTTEmbedInfo : TTEMBEDINFO* optional -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
// コールバック(関数ポインタ)は koffi.proto/koffi.register で型を定義して渡す(素の void* では JS 関数を渡せない)。
const lib = Deno.dlopen("t2embed.dll", {
  TTEmbedFont: { parameters: ["pointer", "u32", "u32", "pointer", "pointer", "pointer", "pointer", "pointer", "u16", "u16", "pointer"], result: "i32" },
});
// lib.symbols.TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo)
// hDC : HDC -> "pointer"
// ulFlags : TTEMBED_FLAGS -> "u32"
// ulCharSet : EMBED_FONT_CHARSET -> "u32"
// pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "pointer"
// pulStatus : DWORD* out -> "pointer"
// lpfnWriteToStream : WRITEEMBEDPROC -> "pointer"
// lpvWriteStream : void* -> "pointer"
// pusCharCodeSet : WORD* -> "pointer"
// usCharCodeCount : WORD -> "u16"
// usLanguage : WORD -> "u16"
// pTTEmbedInfo : TTEMBEDINFO* optional -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int32_t TTEmbedFont(
    void* hDC,
    uint32_t ulFlags,
    uint32_t ulCharSet,
    uint32_t* pulPrivStatus,
    uint32_t* pulStatus,
    void* lpfnWriteToStream,
    void* lpvWriteStream,
    uint16_t* pusCharCodeSet,
    uint16_t usCharCodeCount,
    uint16_t usLanguage,
    void* pTTEmbedInfo);
C, "t2embed.dll");
// $ffi->TTEmbedFont(hDC, ulFlags, ulCharSet, pulPrivStatus, pulStatus, lpfnWriteToStream, lpvWriteStream, pusCharCodeSet, usCharCodeCount, usLanguage, pTTEmbedInfo);
// hDC : HDC
// ulFlags : TTEMBED_FLAGS
// ulCharSet : EMBED_FONT_CHARSET
// pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
// pulStatus : DWORD* out
// lpfnWriteToStream : WRITEEMBEDPROC
// lpvWriteStream : void*
// pusCharCodeSet : WORD*
// usCharCodeCount : WORD
// usLanguage : WORD
// pTTEmbedInfo : TTEMBEDINFO* optional
// 構造体/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 T2embed extends StdCallLibrary {
    T2embed INSTANCE = Native.load("t2embed", T2embed.class);
    int TTEmbedFont(
        Pointer hDC,   // HDC
        int ulFlags,   // TTEMBED_FLAGS
        int ulCharSet,   // EMBED_FONT_CHARSET
        IntByReference pulPrivStatus,   // EMBEDDED_FONT_PRIV_STATUS* out
        IntByReference pulStatus,   // DWORD* out
        Callback lpfnWriteToStream,   // WRITEEMBEDPROC
        Pointer lpvWriteStream,   // void*
        ShortByReference pusCharCodeSet,   // WORD*
        short usCharCodeCount,   // WORD
        short usLanguage,   // WORD
        Pointer pTTEmbedInfo   // TTEMBEDINFO* optional
    );
}
@[Link("t2embed")]
lib Libt2embed
  fun TTEmbedFont = TTEmbedFont(
    hDC : Void*,   # HDC
    ulFlags : UInt32,   # TTEMBED_FLAGS
    ulCharSet : UInt32,   # EMBED_FONT_CHARSET
    pulPrivStatus : UInt32*,   # EMBEDDED_FONT_PRIV_STATUS* out
    pulStatus : UInt32*,   # DWORD* out
    lpfnWriteToStream : Void*,   # WRITEEMBEDPROC
    lpvWriteStream : Void*,   # void*
    pusCharCodeSet : UInt16*,   # WORD*
    usCharCodeCount : UInt16,   # WORD
    usLanguage : UInt16,   # WORD
    pTTEmbedInfo : TTEMBEDINFO*   # TTEMBEDINFO* optional
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef TTEmbedFontNative = Int32 Function(Pointer<Void>, Uint32, Uint32, Pointer<Uint32>, Pointer<Uint32>, Pointer<Void>, Pointer<Void>, Pointer<Uint16>, Uint16, Uint16, Pointer<Void>);
typedef TTEmbedFontDart = int Function(Pointer<Void>, int, int, Pointer<Uint32>, Pointer<Uint32>, Pointer<Void>, Pointer<Void>, Pointer<Uint16>, int, int, Pointer<Void>);
final TTEmbedFont = DynamicLibrary.open('t2embed.dll')
    .lookupFunction<TTEmbedFontNative, TTEmbedFontDart>('TTEmbedFont');
// hDC : HDC -> Pointer<Void>
// ulFlags : TTEMBED_FLAGS -> Uint32
// ulCharSet : EMBED_FONT_CHARSET -> Uint32
// pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> Pointer<Uint32>
// pulStatus : DWORD* out -> Pointer<Uint32>
// lpfnWriteToStream : WRITEEMBEDPROC -> Pointer<Void>
// lpvWriteStream : void* -> Pointer<Void>
// pusCharCodeSet : WORD* -> Pointer<Uint16>
// usCharCodeCount : WORD -> Uint16
// usLanguage : WORD -> Uint16
// pTTEmbedInfo : TTEMBEDINFO* optional -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function TTEmbedFont(
  hDC: THandle;   // HDC
  ulFlags: DWORD;   // TTEMBED_FLAGS
  ulCharSet: DWORD;   // EMBED_FONT_CHARSET
  pulPrivStatus: Pointer;   // EMBEDDED_FONT_PRIV_STATUS* out
  pulStatus: Pointer;   // DWORD* out
  lpfnWriteToStream: Pointer;   // WRITEEMBEDPROC
  lpvWriteStream: Pointer;   // void*
  pusCharCodeSet: Pointer;   // WORD*
  usCharCodeCount: Word;   // WORD
  usLanguage: Word;   // WORD
  pTTEmbedInfo: Pointer   // TTEMBEDINFO* optional
): Integer; stdcall;
  external 't2embed.dll' name 'TTEmbedFont';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "TTEmbedFont"
  c_TTEmbedFont :: Ptr () -> Word32 -> Word32 -> Ptr Word32 -> Ptr Word32 -> Ptr () -> Ptr () -> Ptr Word16 -> Word16 -> Word16 -> Ptr () -> IO Int32
-- hDC : HDC -> Ptr ()
-- ulFlags : TTEMBED_FLAGS -> Word32
-- ulCharSet : EMBED_FONT_CHARSET -> Word32
-- pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> Ptr Word32
-- pulStatus : DWORD* out -> Ptr Word32
-- lpfnWriteToStream : WRITEEMBEDPROC -> Ptr ()
-- lpvWriteStream : void* -> Ptr ()
-- pusCharCodeSet : WORD* -> Ptr Word16
-- usCharCodeCount : WORD -> Word16
-- usLanguage : WORD -> Word16
-- pTTEmbedInfo : TTEMBEDINFO* optional -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let ttembedfont =
  foreign "TTEmbedFont"
    ((ptr void) @-> uint32_t @-> uint32_t @-> (ptr uint32_t) @-> (ptr uint32_t) @-> (ptr void) @-> (ptr void) @-> (ptr uint16_t) @-> uint16_t @-> uint16_t @-> (ptr void) @-> returning int32_t)
(* hDC : HDC -> (ptr void) *)
(* ulFlags : TTEMBED_FLAGS -> uint32_t *)
(* ulCharSet : EMBED_FONT_CHARSET -> uint32_t *)
(* pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> (ptr uint32_t) *)
(* pulStatus : DWORD* out -> (ptr uint32_t) *)
(* lpfnWriteToStream : WRITEEMBEDPROC -> (ptr void) *)
(* lpvWriteStream : void* -> (ptr void) *)
(* pusCharCodeSet : WORD* -> (ptr uint16_t) *)
(* usCharCodeCount : WORD -> uint16_t *)
(* usLanguage : WORD -> uint16_t *)
(* pTTEmbedInfo : TTEMBEDINFO* optional -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library t2embed (t "t2embed.dll"))
(cffi:use-foreign-library t2embed)

(cffi:defcfun ("TTEmbedFont" ttembed-font :convention :stdcall) :int32
  (h-dc :pointer)   ; HDC
  (ul-flags :uint32)   ; TTEMBED_FLAGS
  (ul-char-set :uint32)   ; EMBED_FONT_CHARSET
  (pul-priv-status :pointer)   ; EMBEDDED_FONT_PRIV_STATUS* out
  (pul-status :pointer)   ; DWORD* out
  (lpfn-write-to-stream :pointer)   ; WRITEEMBEDPROC
  (lpv-write-stream :pointer)   ; void*
  (pus-char-code-set :pointer)   ; WORD*
  (us-char-code-count :uint16)   ; WORD
  (us-language :uint16)   ; WORD
  (p-ttembed-info :pointer))   ; TTEMBEDINFO* optional
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $TTEmbedFont = Win32::API::More->new('t2embed',
    'int TTEmbedFont(HANDLE hDC, DWORD ulFlags, DWORD ulCharSet, LPVOID pulPrivStatus, LPVOID pulStatus, LPVOID lpfnWriteToStream, LPVOID lpvWriteStream, LPVOID pusCharCodeSet, WORD usCharCodeCount, WORD usLanguage, LPVOID pTTEmbedInfo)');
# my $ret = $TTEmbedFont->Call($hDC, $ulFlags, $ulCharSet, $pulPrivStatus, $pulStatus, $lpfnWriteToStream, $lpvWriteStream, $pusCharCodeSet, $usCharCodeCount, $usLanguage, $pTTEmbedInfo);
# hDC : HDC -> HANDLE
# ulFlags : TTEMBED_FLAGS -> DWORD
# ulCharSet : EMBED_FONT_CHARSET -> DWORD
# pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> LPVOID
# pulStatus : DWORD* out -> LPVOID
# lpfnWriteToStream : WRITEEMBEDPROC -> LPVOID
# lpvWriteStream : void* -> LPVOID
# pusCharCodeSet : WORD* -> LPVOID
# usCharCodeCount : WORD -> WORD
# usLanguage : WORD -> WORD
# pTTEmbedInfo : TTEMBEDINFO* optional -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。
# コールバック(関数ポインタ)は Perl sub を直接渡せません。Win32::API::Callback を使用してください。

関連項目

類似 API
公式の関連項目
使用する型