ホーム › Graphics.Gdi › TTPOLYCURVE

TTPOLYCURVE

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 12 バイト / x86: 12 バイト

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

フィールド

型

サイズ

x64

x86

説明

wType

WORD

この構造体が表す曲線の種類です。このメンバーには次のいずれかの値を指定できます。

値	意味
TT_PRIM_LINE	曲線はポリラインです。
TT_PRIM_QSPLINE	曲線は 2 次ベジェスプラインです。
TT_PRIM_CSPLINE	曲線は 3 次ベジェスプラインです。

cpfx

WORD

配列に含まれる POINTFX 構造体の数です。

apfx

POINTFX

ポリラインまたはベジェスプラインを定義する POINTFX 構造体の配列を指定します。

公式ドキュメント

TTPOLYCURVE 構造体は、TrueType 文字のアウトラインを構成する曲線に関する情報を格納します。

解説(Remarks)

アプリケーションが GetGlyphOutline 関数を呼び出すと、TrueType 文字のグリフアウトラインが TTPOLYGONHEADER 構造体として返され、それに続いてグリフを表すために必要な数だけ TTPOLYCURVE 構造体が返されます。すべての点は POINTFX 構造体として返され、相対的な移動量ではなく絶対位置を表します。TTPOLYGONHEADER 構造体の pfxStart メンバーで指定される開始点は、輪郭のアウトラインが始まる点です。それに続く TTPOLYCURVE 構造体は、ポリラインレコードまたはスプラインレコードのいずれかです。

ポリラインレコードは一連の点であり、それらの点を結ぶ線が文字のアウトラインを表します。スプラインレコードは、TrueType で使用される 2 次曲線 (すなわち 2 次 B スプライン) を表します。

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

各言語での定義

#include <windows.h>

// FIXED  (x64 4 / x86 4 バイト)
typedef struct FIXED {
    WORD fract;
    SHORT value;
} FIXED;

// POINTFX  (x64 8 / x86 8 バイト)
typedef struct POINTFX {
    FIXED x;
    FIXED y;
} POINTFX;

// TTPOLYCURVE  (x64 12 / x86 12 バイト)
typedef struct TTPOLYCURVE {
    WORD wType;
    WORD cpfx;
    POINTFX apfx[1];
} TTPOLYCURVE;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FIXED
{
    public ushort fract;
    public short value;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct POINTFX
{
    public FIXED x;
    public FIXED y;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TTPOLYCURVE
{
    public ushort wType;
    public ushort cpfx;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public POINTFX[] apfx;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FIXED
    Public fract As UShort
    Public value As Short
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure POINTFX
    Public x As FIXED
    Public y As FIXED
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TTPOLYCURVE
    Public wType As UShort
    Public cpfx As UShort
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public apfx() As POINTFX
End Structure

import ctypes
from ctypes import wintypes

class FIXED(ctypes.Structure):
    _fields_ = [
        ("fract", ctypes.c_ushort),
        ("value", ctypes.c_short),
    ]

class POINTFX(ctypes.Structure):
    _fields_ = [
        ("x", FIXED),
        ("y", FIXED),
    ]

class TTPOLYCURVE(ctypes.Structure):
    _fields_ = [
        ("wType", ctypes.c_ushort),
        ("cpfx", ctypes.c_ushort),
        ("apfx", POINTFX * 1),
    ]

#[repr(C)]
pub struct FIXED {
    pub fract: u16,
    pub value: i16,
}

#[repr(C)]
pub struct POINTFX {
    pub x: FIXED,
    pub y: FIXED,
}

#[repr(C)]
pub struct TTPOLYCURVE {
    pub wType: u16,
    pub cpfx: u16,
    pub apfx: [POINTFX; 1],
}

import "golang.org/x/sys/windows"

type FIXED struct {
	fract uint16
	value int16
}

type POINTFX struct {
	x FIXED
	y FIXED
}

type TTPOLYCURVE struct {
	wType uint16
	cpfx uint16
	apfx [1]POINTFX
}

type
  FIXED = record
    fract: Word;
    value: Smallint;
  end;

  POINTFX = record
    x: FIXED;
    y: FIXED;
  end;

  TTPOLYCURVE = record
    wType: Word;
    cpfx: Word;
    apfx: array[0..0] of POINTFX;
  end;

const FIXED = extern struct {
    fract: u16,
    value: i16,
};

const POINTFX = extern struct {
    x: FIXED,
    y: FIXED,
};

const TTPOLYCURVE = extern struct {
    wType: u16,
    cpfx: u16,
    apfx: [1]POINTFX,
};

type
  FIXED {.bycopy.} = object
    fract: uint16
    value: int16

  POINTFX {.bycopy.} = object
    x: FIXED
    y: FIXED

  TTPOLYCURVE {.bycopy.} = object
    wType: uint16
    cpfx: uint16
    apfx: array[1, POINTFX]

struct FIXED
{
    ushort fract;
    short value;
}

struct POINTFX
{
    FIXED x;
    FIXED y;
}

struct TTPOLYCURVE
{
    ushort wType;
    ushort cpfx;
    POINTFX[1] apfx;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; TTPOLYCURVE サイズ: 12 バイト(x64)
dim st, 3    ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; wType : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; cpfx : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; apfx : POINTFX (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FIXED
    #field short fract
    #field short value
#endstruct

#defstruct global POINTFX
    #field FIXED x
    #field FIXED y
#endstruct

#defstruct global TTPOLYCURVE
    #field short wType
    #field short cpfx
    #field POINTFX apfx 1
#endstruct

stdim st, TTPOLYCURVE        ; NSTRUCT 変数を確保
st->wType = 100
mes "wType=" + st->wType