TTLoadEmbeddedFont

関数

埋め込まれたTrueTypeフォントをストリームから読み込んで使用可能にする。

DLLt2embed.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

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

INT TTLoadEmbeddedFont(
    HANDLE* phFontReference,
    DWORD ulFlags,
    EMBEDDED_FONT_PRIV_STATUS* pulPrivStatus,
    FONT_LICENSE_PRIVS ulPrivs,
    TTLOAD_EMBEDDED_FONT_STATUS* pulStatus,
    READEMBEDPROC lpfnReadFromStream,
    void* lpvReadStream,
    LPWSTR szWinFamilyName,   // optional
    LPSTR szMacFamilyName,   // optional
    TTLOADINFO* pTTLoadInfo   // optional
);

パラメーター

名前	型	方向
phFontReference	HANDLE*	out
ulFlags	DWORD	in
pulPrivStatus	EMBEDDED_FONT_PRIV_STATUS*	out
ulPrivs	FONT_LICENSE_PRIVS	in
pulStatus	TTLOAD_EMBEDDED_FONT_STATUS*	out
lpfnReadFromStream	READEMBEDPROC	in
lpvReadStream	void*	in
szWinFamilyName	LPWSTR	inoptional
szMacFamilyName	LPSTR	inoptional
pTTLoadInfo	TTLOADINFO*	inoptional

戻り値の型: INT

各言語での呼び出し定義

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

INT TTLoadEmbeddedFont(
    HANDLE* phFontReference,
    DWORD ulFlags,
    EMBEDDED_FONT_PRIV_STATUS* pulPrivStatus,
    FONT_LICENSE_PRIVS ulPrivs,
    TTLOAD_EMBEDDED_FONT_STATUS* pulStatus,
    READEMBEDPROC lpfnReadFromStream,
    void* lpvReadStream,
    LPWSTR szWinFamilyName,   // optional
    LPSTR szMacFamilyName,   // optional
    TTLOADINFO* pTTLoadInfo   // optional
);

[DllImport("t2embed.dll", ExactSpelling = true)]
static extern int TTLoadEmbeddedFont(
    IntPtr phFontReference,   // HANDLE* out
    uint ulFlags,   // DWORD
    out uint pulPrivStatus,   // EMBEDDED_FONT_PRIV_STATUS* out
    uint ulPrivs,   // FONT_LICENSE_PRIVS
    out uint pulStatus,   // TTLOAD_EMBEDDED_FONT_STATUS* out
    IntPtr lpfnReadFromStream,   // READEMBEDPROC
    IntPtr lpvReadStream,   // void*
    [MarshalAs(UnmanagedType.LPWStr)] string szWinFamilyName,   // LPWSTR optional
    [MarshalAs(UnmanagedType.LPStr)] string szMacFamilyName,   // LPSTR optional
    IntPtr pTTLoadInfo   // TTLOADINFO* optional
);

<DllImport("t2embed.dll", ExactSpelling:=True)>
Public Shared Function TTLoadEmbeddedFont(
    phFontReference As IntPtr,   ' HANDLE* out
    ulFlags As UInteger,   ' DWORD
    <Out> ByRef pulPrivStatus As UInteger,   ' EMBEDDED_FONT_PRIV_STATUS* out
    ulPrivs As UInteger,   ' FONT_LICENSE_PRIVS
    <Out> ByRef pulStatus As UInteger,   ' TTLOAD_EMBEDDED_FONT_STATUS* out
    lpfnReadFromStream As IntPtr,   ' READEMBEDPROC
    lpvReadStream As IntPtr,   ' void*
    <MarshalAs(UnmanagedType.LPWStr)> szWinFamilyName As String,   ' LPWSTR optional
    <MarshalAs(UnmanagedType.LPStr)> szMacFamilyName As String,   ' LPSTR optional
    pTTLoadInfo As IntPtr   ' TTLOADINFO* optional
) As Integer
End Function

' phFontReference : HANDLE* out
' ulFlags : DWORD
' pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
' ulPrivs : FONT_LICENSE_PRIVS
' pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out
' lpfnReadFromStream : READEMBEDPROC
' lpvReadStream : void*
' szWinFamilyName : LPWSTR optional
' szMacFamilyName : LPSTR optional
' pTTLoadInfo : TTLOADINFO* optional
Declare PtrSafe Function TTLoadEmbeddedFont Lib "t2embed" ( _
    ByVal phFontReference As LongPtr, _
    ByVal ulFlags As Long, _
    ByRef pulPrivStatus As Long, _
    ByVal ulPrivs As Long, _
    ByRef pulStatus As Long, _
    ByVal lpfnReadFromStream As LongPtr, _
    ByVal lpvReadStream As LongPtr, _
    ByVal szWinFamilyName As LongPtr, _
    ByVal szMacFamilyName As String, _
    ByVal pTTLoadInfo As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

TTLoadEmbeddedFont = ctypes.windll.t2embed.TTLoadEmbeddedFont
TTLoadEmbeddedFont.restype = ctypes.c_int
TTLoadEmbeddedFont.argtypes = [
    ctypes.c_void_p,  # phFontReference : HANDLE* out
    wintypes.DWORD,  # ulFlags : DWORD
    ctypes.c_void_p,  # pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
    wintypes.DWORD,  # ulPrivs : FONT_LICENSE_PRIVS
    ctypes.c_void_p,  # pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out
    ctypes.c_void_p,  # lpfnReadFromStream : READEMBEDPROC
    ctypes.POINTER(None),  # lpvReadStream : void*
    wintypes.LPCWSTR,  # szWinFamilyName : LPWSTR optional
    wintypes.LPCSTR,  # szMacFamilyName : LPSTR optional
    ctypes.c_void_p,  # pTTLoadInfo : TTLOADINFO* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('t2embed.dll')
TTLoadEmbeddedFont = Fiddle::Function.new(
  lib['TTLoadEmbeddedFont'],
  [
    Fiddle::TYPE_VOIDP,  # phFontReference : HANDLE* out
    -Fiddle::TYPE_INT,  # ulFlags : DWORD
    Fiddle::TYPE_VOIDP,  # pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out
    -Fiddle::TYPE_INT,  # ulPrivs : FONT_LICENSE_PRIVS
    Fiddle::TYPE_VOIDP,  # pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out
    Fiddle::TYPE_VOIDP,  # lpfnReadFromStream : READEMBEDPROC
    Fiddle::TYPE_VOIDP,  # lpvReadStream : void*
    Fiddle::TYPE_VOIDP,  # szWinFamilyName : LPWSTR optional
    Fiddle::TYPE_VOIDP,  # szMacFamilyName : LPSTR optional
    Fiddle::TYPE_VOIDP,  # pTTLoadInfo : TTLOADINFO* optional
  ],
  Fiddle::TYPE_INT)

#[link(name = "t2embed")]
extern "system" {
    fn TTLoadEmbeddedFont(
        phFontReference: *mut *mut core::ffi::c_void,  // HANDLE* out
        ulFlags: u32,  // DWORD
        pulPrivStatus: *mut u32,  // EMBEDDED_FONT_PRIV_STATUS* out
        ulPrivs: u32,  // FONT_LICENSE_PRIVS
        pulStatus: *mut u32,  // TTLOAD_EMBEDDED_FONT_STATUS* out
        lpfnReadFromStream: *const core::ffi::c_void,  // READEMBEDPROC
        lpvReadStream: *mut (),  // void*
        szWinFamilyName: *mut u16,  // LPWSTR optional
        szMacFamilyName: *mut u8,  // LPSTR optional
        pTTLoadInfo: *mut TTLOADINFO  // TTLOADINFO* optional
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("t2embed.dll")]
public static extern int TTLoadEmbeddedFont(IntPtr phFontReference, uint ulFlags, out uint pulPrivStatus, uint ulPrivs, out uint pulStatus, IntPtr lpfnReadFromStream, IntPtr lpvReadStream, [MarshalAs(UnmanagedType.LPWStr)] string szWinFamilyName, [MarshalAs(UnmanagedType.LPStr)] string szMacFamilyName, IntPtr pTTLoadInfo);
"@
$api = Add-Type -MemberDefinition $sig -Name 't2embed_TTLoadEmbeddedFont' -Namespace Win32 -PassThru
# $api::TTLoadEmbeddedFont(phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, pTTLoadInfo)

#uselib "t2embed.dll"
#func global TTLoadEmbeddedFont "TTLoadEmbeddedFont" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; TTLoadEmbeddedFont phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, varptr(pTTLoadInfo)   ; 戻り値は stat
; phFontReference : HANDLE* out -> "sptr"
; ulFlags : DWORD -> "sptr"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "sptr"
; ulPrivs : FONT_LICENSE_PRIVS -> "sptr"
; pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out -> "sptr"
; lpfnReadFromStream : READEMBEDPROC -> "sptr"
; lpvReadStream : void* -> "sptr"
; szWinFamilyName : LPWSTR optional -> "sptr"
; szMacFamilyName : LPSTR optional -> "sptr"
; pTTLoadInfo : TTLOADINFO* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "t2embed.dll"
#cfunc global TTLoadEmbeddedFont "TTLoadEmbeddedFont" sptr, int, int, int, int, sptr, sptr, wstr, str, var
; res = TTLoadEmbeddedFont(phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, pTTLoadInfo)
; phFontReference : HANDLE* out -> "sptr"
; ulFlags : DWORD -> "int"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "int"
; ulPrivs : FONT_LICENSE_PRIVS -> "int"
; pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out -> "int"
; lpfnReadFromStream : READEMBEDPROC -> "sptr"
; lpvReadStream : void* -> "sptr"
; szWinFamilyName : LPWSTR optional -> "wstr"
; szMacFamilyName : LPSTR optional -> "str"
; pTTLoadInfo : TTLOADINFO* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "t2embed.dll"
#cfunc global TTLoadEmbeddedFont "TTLoadEmbeddedFont" sptr, int, int, int, int, sptr, sptr, wstr, str, sptr
; res = TTLoadEmbeddedFont(phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, varptr(pTTLoadInfo))
; phFontReference : HANDLE* out -> "sptr"
; ulFlags : DWORD -> "int"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "int"
; ulPrivs : FONT_LICENSE_PRIVS -> "int"
; pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out -> "int"
; lpfnReadFromStream : READEMBEDPROC -> "sptr"
; lpvReadStream : void* -> "sptr"
; szWinFamilyName : LPWSTR optional -> "wstr"
; szMacFamilyName : LPSTR optional -> "str"
; pTTLoadInfo : TTLOADINFO* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; INT TTLoadEmbeddedFont(HANDLE* phFontReference, DWORD ulFlags, EMBEDDED_FONT_PRIV_STATUS* pulPrivStatus, FONT_LICENSE_PRIVS ulPrivs, TTLOAD_EMBEDDED_FONT_STATUS* pulStatus, READEMBEDPROC lpfnReadFromStream, void* lpvReadStream, LPWSTR szWinFamilyName, LPSTR szMacFamilyName, TTLOADINFO* pTTLoadInfo)
#uselib "t2embed.dll"
#cfunc global TTLoadEmbeddedFont "TTLoadEmbeddedFont" intptr, int, int, int, int, intptr, intptr, wstr, str, var
; res = TTLoadEmbeddedFont(phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, pTTLoadInfo)
; phFontReference : HANDLE* out -> "intptr"
; ulFlags : DWORD -> "int"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "int"
; ulPrivs : FONT_LICENSE_PRIVS -> "int"
; pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out -> "int"
; lpfnReadFromStream : READEMBEDPROC -> "intptr"
; lpvReadStream : void* -> "intptr"
; szWinFamilyName : LPWSTR optional -> "wstr"
; szMacFamilyName : LPSTR optional -> "str"
; pTTLoadInfo : TTLOADINFO* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; INT TTLoadEmbeddedFont(HANDLE* phFontReference, DWORD ulFlags, EMBEDDED_FONT_PRIV_STATUS* pulPrivStatus, FONT_LICENSE_PRIVS ulPrivs, TTLOAD_EMBEDDED_FONT_STATUS* pulStatus, READEMBEDPROC lpfnReadFromStream, void* lpvReadStream, LPWSTR szWinFamilyName, LPSTR szMacFamilyName, TTLOADINFO* pTTLoadInfo)
#uselib "t2embed.dll"
#cfunc global TTLoadEmbeddedFont "TTLoadEmbeddedFont" intptr, int, int, int, int, intptr, intptr, wstr, str, intptr
; res = TTLoadEmbeddedFont(phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, varptr(pTTLoadInfo))
; phFontReference : HANDLE* out -> "intptr"
; ulFlags : DWORD -> "int"
; pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "int"
; ulPrivs : FONT_LICENSE_PRIVS -> "int"
; pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out -> "int"
; lpfnReadFromStream : READEMBEDPROC -> "intptr"
; lpvReadStream : void* -> "intptr"
; szWinFamilyName : LPWSTR optional -> "wstr"
; szMacFamilyName : LPSTR optional -> "str"
; pTTLoadInfo : TTLOADINFO* optional -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	t2embed = windows.NewLazySystemDLL("t2embed.dll")
	procTTLoadEmbeddedFont = t2embed.NewProc("TTLoadEmbeddedFont")
)

// phFontReference (HANDLE* out), ulFlags (DWORD), pulPrivStatus (EMBEDDED_FONT_PRIV_STATUS* out), ulPrivs (FONT_LICENSE_PRIVS), pulStatus (TTLOAD_EMBEDDED_FONT_STATUS* out), lpfnReadFromStream (READEMBEDPROC), lpvReadStream (void*), szWinFamilyName (LPWSTR optional), szMacFamilyName (LPSTR optional), pTTLoadInfo (TTLOADINFO* optional)
r1, _, err := procTTLoadEmbeddedFont.Call(
	uintptr(phFontReference),
	uintptr(ulFlags),
	uintptr(pulPrivStatus),
	uintptr(ulPrivs),
	uintptr(pulStatus),
	uintptr(lpfnReadFromStream),
	uintptr(lpvReadStream),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(szWinFamilyName))),
	uintptr(unsafe.Pointer(windows.BytePtrFromString(szMacFamilyName))),
	uintptr(pTTLoadInfo),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // INT

function TTLoadEmbeddedFont(
  phFontReference: Pointer;   // HANDLE* out
  ulFlags: DWORD;   // DWORD
  pulPrivStatus: Pointer;   // EMBEDDED_FONT_PRIV_STATUS* out
  ulPrivs: DWORD;   // FONT_LICENSE_PRIVS
  pulStatus: Pointer;   // TTLOAD_EMBEDDED_FONT_STATUS* out
  lpfnReadFromStream: Pointer;   // READEMBEDPROC
  lpvReadStream: Pointer;   // void*
  szWinFamilyName: PWideChar;   // LPWSTR optional
  szMacFamilyName: PAnsiChar;   // LPSTR optional
  pTTLoadInfo: Pointer   // TTLOADINFO* optional
): Integer; stdcall;
  external 't2embed.dll' name 'TTLoadEmbeddedFont';

result := DllCall("t2embed\TTLoadEmbeddedFont"
    , "Ptr", phFontReference   ; HANDLE* out
    , "UInt", ulFlags   ; DWORD
    , "Ptr", pulPrivStatus   ; EMBEDDED_FONT_PRIV_STATUS* out
    , "UInt", ulPrivs   ; FONT_LICENSE_PRIVS
    , "Ptr", pulStatus   ; TTLOAD_EMBEDDED_FONT_STATUS* out
    , "Ptr", lpfnReadFromStream   ; READEMBEDPROC
    , "Ptr", lpvReadStream   ; void*
    , "WStr", szWinFamilyName   ; LPWSTR optional
    , "AStr", szMacFamilyName   ; LPSTR optional
    , "Ptr", pTTLoadInfo   ; TTLOADINFO* optional
    , "Int")   ; return: INT

●TTLoadEmbeddedFont(phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, pTTLoadInfo) = DLL("t2embed.dll", "int TTLoadEmbeddedFont(void*, dword, void*, dword, void*, void*, void*, char*, char*, void*)")
# 呼び出し: TTLoadEmbeddedFont(phFontReference, ulFlags, pulPrivStatus, ulPrivs, pulStatus, lpfnReadFromStream, lpvReadStream, szWinFamilyName, szMacFamilyName, pTTLoadInfo)
# phFontReference : HANDLE* out -> "void*"
# ulFlags : DWORD -> "dword"
# pulPrivStatus : EMBEDDED_FONT_PRIV_STATUS* out -> "void*"
# ulPrivs : FONT_LICENSE_PRIVS -> "dword"
# pulStatus : TTLOAD_EMBEDDED_FONT_STATUS* out -> "void*"
# lpfnReadFromStream : READEMBEDPROC -> "void*"
# lpvReadStream : void* -> "void*"
# szWinFamilyName : LPWSTR optional -> "char*"
# szMacFamilyName : LPSTR optional -> "char*"
# pTTLoadInfo : TTLOADINFO* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。