Win32 API 日本語リファレンス
ホーム › Devices.Display › EngPlgBlt

EngPlgBlt

関数
平行四辺形への変換を伴うブロック転送を行う。
DLLGDI32.dll呼出規約winapi対応OSWindows 2000 以降
📘 Microsoft Learn (日本語) · English

シグネチャ

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

BOOL EngPlgBlt(
    SURFOBJ* psoTrg,
    SURFOBJ* psoSrc,
    SURFOBJ* psoMsk,
    CLIPOBJ* pco,
    XLATEOBJ* pxlo,
    COLORADJUSTMENT* pca,
    POINTL* pptlBrushOrg,
    POINTFIX* pptfx,
    RECTL* prcl,
    POINTL* pptl,
    DWORD iMode
);

パラメーター

名前型方向説明
psoTrgSURFOBJ*inout描画先のサーフェスを記述する SURFOBJ 構造体へのポインターです。
psoSrcSURFOBJ*inoutビットブロック転送操作の転送元サーフェスを記述する SURFOBJ 構造体へのポインターです。
psoMskSURFOBJ*inout

転送元のマスクを表す、省略可能な SURFOBJ 構造体へのポインターです。これはロジックマップ、すなわち 1 ピクセルあたり 1 ビットを持つビットマップによって定義されます。

このマスクは、コピーされる転送元の範囲を制限します。マスクには 0xCCAA という暗黙の rop4 があり、これはマスクが 1 の箇所では転送元をコピーし、マスクが 0 の箇所では描画先をそのままにすることを意味します。

このパラメーターが NULL の場合、暗黙の rop4 は 0xCCCC となり、転送元矩形の全域で転送元をコピーすることを意味します。

マスクは常に関連する転送元を含むのに十分な大きさであるため、タイリングは不要です。

pcoCLIPOBJ*inout

変更対象となる描画先の範囲を制限する CLIPOBJ 構造体へのポインターです。GDI 関数はクリップ領域を矩形の集合として列挙します。

GDI は可能な限りクリッピングを簡略化します。DrvBitBlt 関数とは異なり、EngPlgBlt は単一のクリッピング矩形で呼び出される場合があります。これにより、出力をクリッピングする際の丸め誤差が防止されます。

pxloXLATEOBJ*inout

転送元サーフェスと描画先サーフェスの間でカラーインデックスをどのように変換するかを定義する XLATEOBJ 構造体へのポインターです。この XLATEOBJ 構造体に問い合わせることで、任意の転送元インデックスに対する RGB カラーを取得できます。

カラーを補間するためには、高品質な回転ビットブロック転送が必要です。

pcaCOLORADJUSTMENT*inoutビットを拡大する前に転送元ビットマップへ適用するカラー調整値を定義する COLORADJUSTMENT 構造体へのポインターです。詳細については、Microsoft Windows SDK のドキュメントを参照してください。
pptlBrushOrgPOINTL*inoutハーフトーンブラシの原点を指定する POINTL 構造体へのポインターです。ハーフトーンブラシを使用するドライバーは、ブラシパターンの左上ピクセルをデバイスサーフェス上のこの点に合わせる必要があります。
pptfxPOINTFIX*inout

描画先サーフェス上の平行四辺形を定義する 3 つの POINTFIX 構造体へのポインターです。4 番目の暗黙の頂点は D = B + C − A として与えられます。このデータ型の説明については、GDI Data Types を参照してください。

EngPlgBlt は、A、B、C が同一直線上にある状態で呼び出されることはありません。

prclRECTL*inout転送元サーフェスの座標系で、コピー対象の範囲を定義する RECTL 構造体へのポインターです。転送元矩形の各点は正しく順序付けられています。EngPlgBlt に空の転送元矩形が渡されることはありません。
pptlPOINTL*inout指定されたマスク内のどのピクセルが転送元矩形の左上ピクセルに対応するかを指定する POINTL 構造体へのポインターです。psoMsk が NULL の場合、このパラメーターは無視されます。
iModeDWORDin

転送元ピクセルをどのように組み合わせて出力ピクセルを得るかを定義します。このパラメーターには、次のいずれかの値を指定できます。

値 意味
BLACKONWHITE 縮小ビットブロック転送では、ピクセルを AND 演算で組み合わせます。拡大ビットブロック転送では、ピクセルを複製します。
COLORONCOLOR 縮小ビットブロック転送では、ピクセルを組み合わせる必要がないように十分な数のピクセルを無視します。拡大ビットブロック転送では、ピクセルを複製します。
HALFTONE ドライバーは、出力サーフェス内のピクセルのグループを使用して、入力のカラーまたはグレーレベルを可能な限り正確に近似できます。
WHITEONBLACK 縮小ビットブロック転送では、ピクセルを OR 演算で組み合わせます。拡大ビットブロック転送では、ピクセルを複製します。

WHITEONBLACK、BLACKONWHITE、COLORONCOLOR の各手法は単純であり、古いアプリケーションとの互換性を提供しますが、カラーサーフェスに対して最良の見た目の結果を生成するものではありません。

戻り値の型: BOOL

公式ドキュメント

EngPlgBlt 関数は、GDI に回転を伴うビットブロック転送を実行させます。

戻り値

関数が成功した場合、戻り値は TRUE です。それ以外の場合は FALSE となり、エラーコードが報告されます。

解説(Remarks)

EngPlgBlt は特定の種類の回転のみを実行します。

この関数は、prcl で定義された矩形から任意の平行四辺形へのビットブロック転送を実行します。平行四辺形は pptfx によって定義され、これは 3 つの点の配列を指します。

prcl の転送元矩形は、その角が与えられた整数座標から (-0.5,-0.5) だけずれた幾何学的な矩形と見なされます。これは EngStretchBlt の転送元矩形と正確に一致します。転送元矩形は常に正しく順序付けられています。

転送元矩形の左上の角は最初の点 A にマッピングされます。転送元矩形の右上の角は 2 番目の点 B にマッピングされます。転送元矩形の左下の角は 3 番目の点 C にマッピングされます。転送元矩形の右下の角は、与えられた 3 つの点をベクトルとして扱い、次の計算を行うことで定義される平行四辺形内の暗黙の点にマッピングされます。

D = B + C - A

ストレッチ blit は平行四辺形 blit として正確に表現できますが、その場合、描画先に与えられる座標は 5 で割り切れる値になることに注意してください。

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

各言語での呼び出し定義

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

BOOL EngPlgBlt(
    SURFOBJ* psoTrg,
    SURFOBJ* psoSrc,
    SURFOBJ* psoMsk,
    CLIPOBJ* pco,
    XLATEOBJ* pxlo,
    COLORADJUSTMENT* pca,
    POINTL* pptlBrushOrg,
    POINTFIX* pptfx,
    RECTL* prcl,
    POINTL* pptl,
    DWORD iMode
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("GDI32.dll", ExactSpelling = true)]
static extern bool EngPlgBlt(
    IntPtr psoTrg,   // SURFOBJ* in/out
    IntPtr psoSrc,   // SURFOBJ* in/out
    IntPtr psoMsk,   // SURFOBJ* in/out
    IntPtr pco,   // CLIPOBJ* in/out
    IntPtr pxlo,   // XLATEOBJ* in/out
    IntPtr pca,   // COLORADJUSTMENT* in/out
    IntPtr pptlBrushOrg,   // POINTL* in/out
    IntPtr pptfx,   // POINTFIX* in/out
    IntPtr prcl,   // RECTL* in/out
    IntPtr pptl,   // POINTL* in/out
    uint iMode   // DWORD
);
<DllImport("GDI32.dll", ExactSpelling:=True)>
Public Shared Function EngPlgBlt(
    psoTrg As IntPtr,   ' SURFOBJ* in/out
    psoSrc As IntPtr,   ' SURFOBJ* in/out
    psoMsk As IntPtr,   ' SURFOBJ* in/out
    pco As IntPtr,   ' CLIPOBJ* in/out
    pxlo As IntPtr,   ' XLATEOBJ* in/out
    pca As IntPtr,   ' COLORADJUSTMENT* in/out
    pptlBrushOrg As IntPtr,   ' POINTL* in/out
    pptfx As IntPtr,   ' POINTFIX* in/out
    prcl As IntPtr,   ' RECTL* in/out
    pptl As IntPtr,   ' POINTL* in/out
    iMode As UInteger   ' DWORD
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function
' psoTrg : SURFOBJ* in/out
' psoSrc : SURFOBJ* in/out
' psoMsk : SURFOBJ* in/out
' pco : CLIPOBJ* in/out
' pxlo : XLATEOBJ* in/out
' pca : COLORADJUSTMENT* in/out
' pptlBrushOrg : POINTL* in/out
' pptfx : POINTFIX* in/out
' prcl : RECTL* in/out
' pptl : POINTL* in/out
' iMode : DWORD
Declare PtrSafe Function EngPlgBlt Lib "gdi32" ( _
    ByVal psoTrg As LongPtr, _
    ByVal psoSrc As LongPtr, _
    ByVal psoMsk As LongPtr, _
    ByVal pco As LongPtr, _
    ByVal pxlo As LongPtr, _
    ByVal pca As LongPtr, _
    ByVal pptlBrushOrg As LongPtr, _
    ByVal pptfx As LongPtr, _
    ByVal prcl As LongPtr, _
    ByVal pptl As LongPtr, _
    ByVal iMode As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

EngPlgBlt = ctypes.windll.gdi32.EngPlgBlt
EngPlgBlt.restype = wintypes.BOOL
EngPlgBlt.argtypes = [
    ctypes.c_void_p,  # psoTrg : SURFOBJ* in/out
    ctypes.c_void_p,  # psoSrc : SURFOBJ* in/out
    ctypes.c_void_p,  # psoMsk : SURFOBJ* in/out
    ctypes.c_void_p,  # pco : CLIPOBJ* in/out
    ctypes.c_void_p,  # pxlo : XLATEOBJ* in/out
    ctypes.c_void_p,  # pca : COLORADJUSTMENT* in/out
    ctypes.c_void_p,  # pptlBrushOrg : POINTL* in/out
    ctypes.c_void_p,  # pptfx : POINTFIX* in/out
    ctypes.c_void_p,  # prcl : RECTL* in/out
    ctypes.c_void_p,  # pptl : POINTL* in/out
    wintypes.DWORD,  # iMode : DWORD
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('GDI32.dll')
EngPlgBlt = Fiddle::Function.new(
  lib['EngPlgBlt'],
  [
    Fiddle::TYPE_VOIDP,  # psoTrg : SURFOBJ* in/out
    Fiddle::TYPE_VOIDP,  # psoSrc : SURFOBJ* in/out
    Fiddle::TYPE_VOIDP,  # psoMsk : SURFOBJ* in/out
    Fiddle::TYPE_VOIDP,  # pco : CLIPOBJ* in/out
    Fiddle::TYPE_VOIDP,  # pxlo : XLATEOBJ* in/out
    Fiddle::TYPE_VOIDP,  # pca : COLORADJUSTMENT* in/out
    Fiddle::TYPE_VOIDP,  # pptlBrushOrg : POINTL* in/out
    Fiddle::TYPE_VOIDP,  # pptfx : POINTFIX* in/out
    Fiddle::TYPE_VOIDP,  # prcl : RECTL* in/out
    Fiddle::TYPE_VOIDP,  # pptl : POINTL* in/out
    -Fiddle::TYPE_INT,  # iMode : DWORD
  ],
  Fiddle::TYPE_INT)
#[link(name = "gdi32")]
extern "system" {
    fn EngPlgBlt(
        psoTrg: *mut SURFOBJ,  // SURFOBJ* in/out
        psoSrc: *mut SURFOBJ,  // SURFOBJ* in/out
        psoMsk: *mut SURFOBJ,  // SURFOBJ* in/out
        pco: *mut CLIPOBJ,  // CLIPOBJ* in/out
        pxlo: *mut XLATEOBJ,  // XLATEOBJ* in/out
        pca: *mut COLORADJUSTMENT,  // COLORADJUSTMENT* in/out
        pptlBrushOrg: *mut POINTL,  // POINTL* in/out
        pptfx: *mut POINTFIX,  // POINTFIX* in/out
        prcl: *mut RECTL,  // RECTL* in/out
        pptl: *mut POINTL,  // POINTL* in/out
        iMode: u32  // DWORD
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("GDI32.dll")]
public static extern bool EngPlgBlt(IntPtr psoTrg, IntPtr psoSrc, IntPtr psoMsk, IntPtr pco, IntPtr pxlo, IntPtr pca, IntPtr pptlBrushOrg, IntPtr pptfx, IntPtr prcl, IntPtr pptl, uint iMode);
"@
$api = Add-Type -MemberDefinition $sig -Name 'GDI32_EngPlgBlt' -Namespace Win32 -PassThru
# $api::EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
#uselib "GDI32.dll"
#func global EngPlgBlt "EngPlgBlt" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; EngPlgBlt varptr(psoTrg), varptr(psoSrc), varptr(psoMsk), varptr(pco), varptr(pxlo), varptr(pca), varptr(pptlBrushOrg), varptr(pptfx), varptr(prcl), varptr(pptl), iMode   ; 戻り値は stat
; psoTrg : SURFOBJ* in/out -> "sptr"
; psoSrc : SURFOBJ* in/out -> "sptr"
; psoMsk : SURFOBJ* in/out -> "sptr"
; pco : CLIPOBJ* in/out -> "sptr"
; pxlo : XLATEOBJ* in/out -> "sptr"
; pca : COLORADJUSTMENT* in/out -> "sptr"
; pptlBrushOrg : POINTL* in/out -> "sptr"
; pptfx : POINTFIX* in/out -> "sptr"
; prcl : RECTL* in/out -> "sptr"
; pptl : POINTL* in/out -> "sptr"
; iMode : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数: 
#uselib "GDI32.dll"
#cfunc global EngPlgBlt "EngPlgBlt" var, var, var, var, var, var, var, var, var, var, int
; res = EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
; psoTrg : SURFOBJ* in/out -> "var"
; psoSrc : SURFOBJ* in/out -> "var"
; psoMsk : SURFOBJ* in/out -> "var"
; pco : CLIPOBJ* in/out -> "var"
; pxlo : XLATEOBJ* in/out -> "var"
; pca : COLORADJUSTMENT* in/out -> "var"
; pptlBrushOrg : POINTL* in/out -> "var"
; pptfx : POINTFIX* in/out -> "var"
; prcl : RECTL* in/out -> "var"
; pptl : POINTL* in/out -> "var"
; iMode : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数: 
; BOOL EngPlgBlt(SURFOBJ* psoTrg, SURFOBJ* psoSrc, SURFOBJ* psoMsk, CLIPOBJ* pco, XLATEOBJ* pxlo, COLORADJUSTMENT* pca, POINTL* pptlBrushOrg, POINTFIX* pptfx, RECTL* prcl, POINTL* pptl, DWORD iMode)
#uselib "GDI32.dll"
#cfunc global EngPlgBlt "EngPlgBlt" var, var, var, var, var, var, var, var, var, var, int
; res = EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
; psoTrg : SURFOBJ* in/out -> "var"
; psoSrc : SURFOBJ* in/out -> "var"
; psoMsk : SURFOBJ* in/out -> "var"
; pco : CLIPOBJ* in/out -> "var"
; pxlo : XLATEOBJ* in/out -> "var"
; pca : COLORADJUSTMENT* in/out -> "var"
; pptlBrushOrg : POINTL* in/out -> "var"
; pptfx : POINTFIX* in/out -> "var"
; prcl : RECTL* in/out -> "var"
; pptl : POINTL* in/out -> "var"
; iMode : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	gdi32 = windows.NewLazySystemDLL("GDI32.dll")
	procEngPlgBlt = gdi32.NewProc("EngPlgBlt")
)

// psoTrg (SURFOBJ* in/out), psoSrc (SURFOBJ* in/out), psoMsk (SURFOBJ* in/out), pco (CLIPOBJ* in/out), pxlo (XLATEOBJ* in/out), pca (COLORADJUSTMENT* in/out), pptlBrushOrg (POINTL* in/out), pptfx (POINTFIX* in/out), prcl (RECTL* in/out), pptl (POINTL* in/out), iMode (DWORD)
r1, _, err := procEngPlgBlt.Call(
	uintptr(psoTrg),
	uintptr(psoSrc),
	uintptr(psoMsk),
	uintptr(pco),
	uintptr(pxlo),
	uintptr(pca),
	uintptr(pptlBrushOrg),
	uintptr(pptfx),
	uintptr(prcl),
	uintptr(pptl),
	uintptr(iMode),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function EngPlgBlt(
  psoTrg: Pointer;   // SURFOBJ* in/out
  psoSrc: Pointer;   // SURFOBJ* in/out
  psoMsk: Pointer;   // SURFOBJ* in/out
  pco: Pointer;   // CLIPOBJ* in/out
  pxlo: Pointer;   // XLATEOBJ* in/out
  pca: Pointer;   // COLORADJUSTMENT* in/out
  pptlBrushOrg: Pointer;   // POINTL* in/out
  pptfx: Pointer;   // POINTFIX* in/out
  prcl: Pointer;   // RECTL* in/out
  pptl: Pointer;   // POINTL* in/out
  iMode: DWORD   // DWORD
): BOOL; stdcall;
  external 'GDI32.dll' name 'EngPlgBlt';
result := DllCall("GDI32\EngPlgBlt"
    , "Ptr", psoTrg   ; SURFOBJ* in/out
    , "Ptr", psoSrc   ; SURFOBJ* in/out
    , "Ptr", psoMsk   ; SURFOBJ* in/out
    , "Ptr", pco   ; CLIPOBJ* in/out
    , "Ptr", pxlo   ; XLATEOBJ* in/out
    , "Ptr", pca   ; COLORADJUSTMENT* in/out
    , "Ptr", pptlBrushOrg   ; POINTL* in/out
    , "Ptr", pptfx   ; POINTFIX* in/out
    , "Ptr", prcl   ; RECTL* in/out
    , "Ptr", pptl   ; POINTL* in/out
    , "UInt", iMode   ; DWORD
    , "Int")   ; return: BOOL
●EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode) = DLL("GDI32.dll", "bool EngPlgBlt(void*, void*, void*, void*, void*, void*, void*, void*, void*, void*, dword)")
# 呼び出し: EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
# psoTrg : SURFOBJ* in/out -> "void*"
# psoSrc : SURFOBJ* in/out -> "void*"
# psoMsk : SURFOBJ* in/out -> "void*"
# pco : CLIPOBJ* in/out -> "void*"
# pxlo : XLATEOBJ* in/out -> "void*"
# pca : COLORADJUSTMENT* in/out -> "void*"
# pptlBrushOrg : POINTL* in/out -> "void*"
# pptfx : POINTFIX* in/out -> "void*"
# prcl : RECTL* in/out -> "void*"
# pptl : POINTL* in/out -> "void*"
# iMode : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "gdi32" fn EngPlgBlt(
    psoTrg: [*c]SURFOBJ, // SURFOBJ* in/out
    psoSrc: [*c]SURFOBJ, // SURFOBJ* in/out
    psoMsk: [*c]SURFOBJ, // SURFOBJ* in/out
    pco: [*c]CLIPOBJ, // CLIPOBJ* in/out
    pxlo: [*c]XLATEOBJ, // XLATEOBJ* in/out
    pca: [*c]COLORADJUSTMENT, // COLORADJUSTMENT* in/out
    pptlBrushOrg: [*c]POINTL, // POINTL* in/out
    pptfx: [*c]POINTFIX, // POINTFIX* in/out
    prcl: [*c]RECTL, // RECTL* in/out
    pptl: [*c]POINTL, // POINTL* in/out
    iMode: u32 // DWORD
) callconv(std.os.windows.WINAPI) i32;
proc EngPlgBlt(
    psoTrg: ptr SURFOBJ,  # SURFOBJ* in/out
    psoSrc: ptr SURFOBJ,  # SURFOBJ* in/out
    psoMsk: ptr SURFOBJ,  # SURFOBJ* in/out
    pco: ptr CLIPOBJ,  # CLIPOBJ* in/out
    pxlo: ptr XLATEOBJ,  # XLATEOBJ* in/out
    pca: ptr COLORADJUSTMENT,  # COLORADJUSTMENT* in/out
    pptlBrushOrg: ptr POINTL,  # POINTL* in/out
    pptfx: ptr POINTFIX,  # POINTFIX* in/out
    prcl: ptr RECTL,  # RECTL* in/out
    pptl: ptr POINTL,  # POINTL* in/out
    iMode: uint32  # DWORD
): int32 {.importc: "EngPlgBlt", stdcall, dynlib: "GDI32.dll".}
pragma(lib, "gdi32");
extern(Windows)
int EngPlgBlt(
    SURFOBJ* psoTrg,   // SURFOBJ* in/out
    SURFOBJ* psoSrc,   // SURFOBJ* in/out
    SURFOBJ* psoMsk,   // SURFOBJ* in/out
    CLIPOBJ* pco,   // CLIPOBJ* in/out
    XLATEOBJ* pxlo,   // XLATEOBJ* in/out
    COLORADJUSTMENT* pca,   // COLORADJUSTMENT* in/out
    POINTL* pptlBrushOrg,   // POINTL* in/out
    POINTFIX* pptfx,   // POINTFIX* in/out
    RECTL* prcl,   // RECTL* in/out
    POINTL* pptl,   // POINTL* in/out
    uint iMode   // DWORD
);
ccall((:EngPlgBlt, "GDI32.dll"), stdcall, Int32,
      (Ptr{SURFOBJ}, Ptr{SURFOBJ}, Ptr{SURFOBJ}, Ptr{CLIPOBJ}, Ptr{XLATEOBJ}, Ptr{COLORADJUSTMENT}, Ptr{POINTL}, Ptr{POINTFIX}, Ptr{RECTL}, Ptr{POINTL}, UInt32),
      psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
# psoTrg : SURFOBJ* in/out -> Ptr{SURFOBJ}
# psoSrc : SURFOBJ* in/out -> Ptr{SURFOBJ}
# psoMsk : SURFOBJ* in/out -> Ptr{SURFOBJ}
# pco : CLIPOBJ* in/out -> Ptr{CLIPOBJ}
# pxlo : XLATEOBJ* in/out -> Ptr{XLATEOBJ}
# pca : COLORADJUSTMENT* in/out -> Ptr{COLORADJUSTMENT}
# pptlBrushOrg : POINTL* in/out -> Ptr{POINTL}
# pptfx : POINTFIX* in/out -> Ptr{POINTFIX}
# prcl : RECTL* in/out -> Ptr{RECTL}
# pptl : POINTL* in/out -> Ptr{POINTL}
# iMode : DWORD -> UInt32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
int32_t EngPlgBlt(
    void* psoTrg,
    void* psoSrc,
    void* psoMsk,
    void* pco,
    void* pxlo,
    void* pca,
    void* pptlBrushOrg,
    void* pptfx,
    void* prcl,
    void* pptl,
    uint32_t iMode);
]]
local gdi32 = ffi.load("gdi32")
-- gdi32.EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
-- psoTrg : SURFOBJ* in/out
-- psoSrc : SURFOBJ* in/out
-- psoMsk : SURFOBJ* in/out
-- pco : CLIPOBJ* in/out
-- pxlo : XLATEOBJ* in/out
-- pca : COLORADJUSTMENT* in/out
-- pptlBrushOrg : POINTL* in/out
-- pptfx : POINTFIX* in/out
-- prcl : RECTL* in/out
-- pptl : POINTL* in/out
-- iMode : DWORD
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('GDI32.dll');
const EngPlgBlt = lib.func('__stdcall', 'EngPlgBlt', 'int32_t', ['void *', 'void *', 'void *', 'void *', 'void *', 'void *', 'void *', 'void *', 'void *', 'void *', 'uint32_t']);
// EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
// psoTrg : SURFOBJ* in/out -> 'void *'
// psoSrc : SURFOBJ* in/out -> 'void *'
// psoMsk : SURFOBJ* in/out -> 'void *'
// pco : CLIPOBJ* in/out -> 'void *'
// pxlo : XLATEOBJ* in/out -> 'void *'
// pca : COLORADJUSTMENT* in/out -> 'void *'
// pptlBrushOrg : POINTL* in/out -> 'void *'
// pptfx : POINTFIX* in/out -> 'void *'
// prcl : RECTL* in/out -> 'void *'
// pptl : POINTL* in/out -> 'void *'
// iMode : DWORD -> 'uint32_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("GDI32.dll", {
  EngPlgBlt: { parameters: ["pointer", "pointer", "pointer", "pointer", "pointer", "pointer", "pointer", "pointer", "pointer", "pointer", "u32"], result: "i32" },
});
// lib.symbols.EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode)
// psoTrg : SURFOBJ* in/out -> "pointer"
// psoSrc : SURFOBJ* in/out -> "pointer"
// psoMsk : SURFOBJ* in/out -> "pointer"
// pco : CLIPOBJ* in/out -> "pointer"
// pxlo : XLATEOBJ* in/out -> "pointer"
// pca : COLORADJUSTMENT* in/out -> "pointer"
// pptlBrushOrg : POINTL* in/out -> "pointer"
// pptfx : POINTFIX* in/out -> "pointer"
// prcl : RECTL* in/out -> "pointer"
// pptl : POINTL* in/out -> "pointer"
// iMode : DWORD -> "u32"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int32_t EngPlgBlt(
    void* psoTrg,
    void* psoSrc,
    void* psoMsk,
    void* pco,
    void* pxlo,
    void* pca,
    void* pptlBrushOrg,
    void* pptfx,
    void* prcl,
    void* pptl,
    uint32_t iMode);
C, "GDI32.dll");
// $ffi->EngPlgBlt(psoTrg, psoSrc, psoMsk, pco, pxlo, pca, pptlBrushOrg, pptfx, prcl, pptl, iMode);
// psoTrg : SURFOBJ* in/out
// psoSrc : SURFOBJ* in/out
// psoMsk : SURFOBJ* in/out
// pco : CLIPOBJ* in/out
// pxlo : XLATEOBJ* in/out
// pca : COLORADJUSTMENT* in/out
// pptlBrushOrg : POINTL* in/out
// pptfx : POINTFIX* in/out
// prcl : RECTL* in/out
// pptl : POINTL* in/out
// iMode : DWORD
// 構造体/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);
    boolean EngPlgBlt(
        Pointer psoTrg,   // SURFOBJ* in/out
        Pointer psoSrc,   // SURFOBJ* in/out
        Pointer psoMsk,   // SURFOBJ* in/out
        Pointer pco,   // CLIPOBJ* in/out
        Pointer pxlo,   // XLATEOBJ* in/out
        Pointer pca,   // COLORADJUSTMENT* in/out
        Pointer pptlBrushOrg,   // POINTL* in/out
        Pointer pptfx,   // POINTFIX* in/out
        Pointer prcl,   // RECTL* in/out
        Pointer pptl,   // POINTL* in/out
        int iMode   // DWORD
    );
}
@[Link("gdi32")]
lib LibGDI32
  fun EngPlgBlt = EngPlgBlt(
    psoTrg : SURFOBJ*,   # SURFOBJ* in/out
    psoSrc : SURFOBJ*,   # SURFOBJ* in/out
    psoMsk : SURFOBJ*,   # SURFOBJ* in/out
    pco : CLIPOBJ*,   # CLIPOBJ* in/out
    pxlo : XLATEOBJ*,   # XLATEOBJ* in/out
    pca : COLORADJUSTMENT*,   # COLORADJUSTMENT* in/out
    pptlBrushOrg : POINTL*,   # POINTL* in/out
    pptfx : POINTFIX*,   # POINTFIX* in/out
    prcl : RECTL*,   # RECTL* in/out
    pptl : POINTL*,   # POINTL* in/out
    iMode : UInt32   # DWORD
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef EngPlgBltNative = Int32 Function(Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Uint32);
typedef EngPlgBltDart = int Function(Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, int);
final EngPlgBlt = DynamicLibrary.open('GDI32.dll')
    .lookupFunction<EngPlgBltNative, EngPlgBltDart>('EngPlgBlt');
// psoTrg : SURFOBJ* in/out -> Pointer<Void>
// psoSrc : SURFOBJ* in/out -> Pointer<Void>
// psoMsk : SURFOBJ* in/out -> Pointer<Void>
// pco : CLIPOBJ* in/out -> Pointer<Void>
// pxlo : XLATEOBJ* in/out -> Pointer<Void>
// pca : COLORADJUSTMENT* in/out -> Pointer<Void>
// pptlBrushOrg : POINTL* in/out -> Pointer<Void>
// pptfx : POINTFIX* in/out -> Pointer<Void>
// prcl : RECTL* in/out -> Pointer<Void>
// pptl : POINTL* in/out -> Pointer<Void>
// iMode : DWORD -> Uint32
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function EngPlgBlt(
  psoTrg: Pointer;   // SURFOBJ* in/out
  psoSrc: Pointer;   // SURFOBJ* in/out
  psoMsk: Pointer;   // SURFOBJ* in/out
  pco: Pointer;   // CLIPOBJ* in/out
  pxlo: Pointer;   // XLATEOBJ* in/out
  pca: Pointer;   // COLORADJUSTMENT* in/out
  pptlBrushOrg: Pointer;   // POINTL* in/out
  pptfx: Pointer;   // POINTFIX* in/out
  prcl: Pointer;   // RECTL* in/out
  pptl: Pointer;   // POINTL* in/out
  iMode: DWORD   // DWORD
): BOOL; stdcall;
  external 'GDI32.dll' name 'EngPlgBlt';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "EngPlgBlt"
  c_EngPlgBlt :: Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Word32 -> IO CInt
-- psoTrg : SURFOBJ* in/out -> Ptr ()
-- psoSrc : SURFOBJ* in/out -> Ptr ()
-- psoMsk : SURFOBJ* in/out -> Ptr ()
-- pco : CLIPOBJ* in/out -> Ptr ()
-- pxlo : XLATEOBJ* in/out -> Ptr ()
-- pca : COLORADJUSTMENT* in/out -> Ptr ()
-- pptlBrushOrg : POINTL* in/out -> Ptr ()
-- pptfx : POINTFIX* in/out -> Ptr ()
-- prcl : RECTL* in/out -> Ptr ()
-- pptl : POINTL* in/out -> Ptr ()
-- iMode : DWORD -> Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let engplgblt =
  foreign "EngPlgBlt"
    ((ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> uint32_t @-> returning int32_t)
(* psoTrg : SURFOBJ* in/out -> (ptr void) *)
(* psoSrc : SURFOBJ* in/out -> (ptr void) *)
(* psoMsk : SURFOBJ* in/out -> (ptr void) *)
(* pco : CLIPOBJ* in/out -> (ptr void) *)
(* pxlo : XLATEOBJ* in/out -> (ptr void) *)
(* pca : COLORADJUSTMENT* in/out -> (ptr void) *)
(* pptlBrushOrg : POINTL* in/out -> (ptr void) *)
(* pptfx : POINTFIX* in/out -> (ptr void) *)
(* prcl : RECTL* in/out -> (ptr void) *)
(* pptl : POINTL* in/out -> (ptr void) *)
(* iMode : DWORD -> uint32_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library gdi32 (t "GDI32.dll"))
(cffi:use-foreign-library gdi32)

(cffi:defcfun ("EngPlgBlt" eng-plg-blt :convention :stdcall) :int32
  (pso-trg :pointer)   ; SURFOBJ* in/out
  (pso-src :pointer)   ; SURFOBJ* in/out
  (pso-msk :pointer)   ; SURFOBJ* in/out
  (pco :pointer)   ; CLIPOBJ* in/out
  (pxlo :pointer)   ; XLATEOBJ* in/out
  (pca :pointer)   ; COLORADJUSTMENT* in/out
  (pptl-brush-org :pointer)   ; POINTL* in/out
  (pptfx :pointer)   ; POINTFIX* in/out
  (prcl :pointer)   ; RECTL* in/out
  (pptl :pointer)   ; POINTL* in/out
  (i-mode :uint32))   ; DWORD
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $EngPlgBlt = Win32::API::More->new('GDI32',
    'BOOL EngPlgBlt(LPVOID psoTrg, LPVOID psoSrc, LPVOID psoMsk, LPVOID pco, LPVOID pxlo, LPVOID pca, LPVOID pptlBrushOrg, LPVOID pptfx, LPVOID prcl, LPVOID pptl, DWORD iMode)');
# my $ret = $EngPlgBlt->Call($psoTrg, $psoSrc, $psoMsk, $pco, $pxlo, $pca, $pptlBrushOrg, $pptfx, $prcl, $pptl, $iMode);
# psoTrg : SURFOBJ* in/out -> LPVOID
# psoSrc : SURFOBJ* in/out -> LPVOID
# psoMsk : SURFOBJ* in/out -> LPVOID
# pco : CLIPOBJ* in/out -> LPVOID
# pxlo : XLATEOBJ* in/out -> LPVOID
# pca : COLORADJUSTMENT* in/out -> LPVOID
# pptlBrushOrg : POINTL* in/out -> LPVOID
# pptfx : POINTFIX* in/out -> LPVOID
# prcl : RECTL* in/out -> LPVOID
# pptl : POINTL* in/out -> LPVOID
# iMode : DWORD -> DWORD
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

関連項目

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