DrawDibDraw

関数

DIB画像をデバイスコンテキストに描画する。

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

シグネチャ

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

BOOL DrawDibDraw(
    INT_PTR hdd,
    HDC hdc,
    INT xDst,
    INT yDst,
    INT dxDst,
    INT dyDst,
    BITMAPINFOHEADER* lpbi,   // optional
    void* lpBits,   // optional
    INT xSrc,
    INT ySrc,
    INT dxSrc,
    INT dySrc,
    DWORD wFlags
);

パラメーター

名前

型

方向

説明

hdd

INT_PTR

DrawDib DC へのハンドル。

hdc

HDC

DC へのハンドル。

xDst

INT

転送先矩形の左上隅の x 座標(MM_TEXT クライアント座標)。

yDst

INT

転送先矩形の左上隅の y 座標(MM_TEXT クライアント座標)。

dxDst

INT

転送先矩形の幅(MM_TEXT クライアント座標)。dxDst が −1 の場合はビットマップの幅が使用されます。

dyDst

INT

転送先矩形の高さ(MM_TEXT クライアント座標)。dyDst が −1 の場合はビットマップの高さが使用されます。

lpbi

BITMAPINFOHEADER*

inoptional

画像形式を含む BITMAPINFOHEADER 構造体へのポインター。DIB のカラーテーブルは BITMAPINFOHEADER 内の形式の後に続きます。biHeight メンバーは正の値でなければなりません。DrawDibDraw は上下反転した DIB を描画しません。

lpBits

void*

inoptional

ビットマップのビットを含むバッファーへのポインター。

xSrc

INT

転送元矩形の左上隅の x 座標(ピクセル単位)。座標 (0,0) はビットマップの左上隅を表します。

ySrc

INT

転送元矩形の左上隅の y 座標(ピクセル単位)。座標 (0,0) はビットマップの左上隅を表します。

dxSrc

INT

転送元矩形の幅(ピクセル単位)。

dySrc

INT

転送元矩形の高さ(ピクセル単位)。

wFlags

DWORD

描画に適用するフラグ。次の値が定義されています。

値	意味
DDF_BACKGROUNDPAL	描画に使用するパレットをバックグラウンドで実現し、実際に表示に使用されるパレットは変更しません。この値は DDF_SAME_HDC が設定されていない場合にのみ有効です。
DDF_DONTDRAW	現在の画像を展開しますが描画しません。このフラグは DDF_PREROLL フラグに優先します。
DDF_FULLSCREEN	サポートされていません。
DDF_HALFTONE	DIB のパレットにかかわらず、常に DIB を標準パレットにディザリングします。アプリケーションが DrawDibBegin 関数を使用する場合は、DrawDibDraw ではなく DrawDibBegin でこの値を設定してください。
DDF_HURRYUP	データを描画する必要がなく(つまり破棄してかまわず)、この情報を再呼び出しするために DDF_UPDATE が使用されません。DrawDib は、次のフレームの構築に必要な場合にのみこの値を確認します。それ以外の場合、この値は無視されます。この値は通常、ビデオとオーディオの同期に使用されます。データを同期する際、ドライバーが後続のフレームを展開するためにフレームをバッファリングする必要がある場合に備えて、アプリケーションはこの値を指定して画像を送信する必要があります。
DDF_NOTKEYFRAME	DIB データがキーフレームではありません。
DDF_SAME_HDC	現在の DC ハンドルと、その DC に現在関連付けられているパレットを使用します。
DDF_SAME_DRAW	DrawDibDraw に現在の描画パラメーターを使用します。この値は、DrawDibDraw または DrawDibBegin の使用以降、lpbi、dxDst、dyDst、dxSrc、dySrc が変更されていない場合にのみ使用してください。DrawDibDraw は通常これらのパラメーターを確認し、変更されている場合は DrawDibBegin が描画のために DrawDib DC を準備します。このフラグは DDF_SAME_DIB および DDF_SAME_SIZE フラグに優先します。
DDF_UPDATE	最後にバッファリングされたビットマップを再描画します。この値で描画が失敗した場合、バッファリングされた画像が利用できないため、表示を更新する前に新しい画像を指定する必要があります。

戻り値の型: BOOL

公式ドキュメント

DrawDibDraw 関数は DIB を画面に描画します。

戻り値

成功した場合は TRUE を、それ以外の場合は FALSE を返します。

解説(Remarks)

DDF_DONTDRAW を指定すると、DrawDibDraw は画像を展開しますが表示しません。続いて DDF_UPDATE を指定して DrawDibDraw を呼び出すと、画像が表示されます。

DrawDib DC にオフスクリーンバッファーが指定されていない場合、DDF_DONTDRAW を指定するとフレームは直ちに画面に描画されます。続いて DDF_UPDATE を指定して DrawDibDraw を呼び出すと失敗します。

DDF_UPDATE と DDF_DONTDRAW は設定するタイミングが異なりますが、組み合わせて使用することでオフスクリーンで合成画像を作成できます。オフスクリーン画像が完成したら、DrawDibDraw を呼び出して画像を表示できます。

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

各言語での呼び出し定義

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

BOOL DrawDibDraw(
    INT_PTR hdd,
    HDC hdc,
    INT xDst,
    INT yDst,
    INT dxDst,
    INT dyDst,
    BITMAPINFOHEADER* lpbi,   // optional
    void* lpBits,   // optional
    INT xSrc,
    INT ySrc,
    INT dxSrc,
    INT dySrc,
    DWORD wFlags
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MSVFW32.dll", ExactSpelling = true)]
static extern bool DrawDibDraw(
    IntPtr hdd,   // INT_PTR
    IntPtr hdc,   // HDC
    int xDst,   // INT
    int yDst,   // INT
    int dxDst,   // INT
    int dyDst,   // INT
    IntPtr lpbi,   // BITMAPINFOHEADER* optional
    IntPtr lpBits,   // void* optional
    int xSrc,   // INT
    int ySrc,   // INT
    int dxSrc,   // INT
    int dySrc,   // INT
    uint wFlags   // DWORD
);

<DllImport("MSVFW32.dll", ExactSpelling:=True)>
Public Shared Function DrawDibDraw(
    hdd As IntPtr,   ' INT_PTR
    hdc As IntPtr,   ' HDC
    xDst As Integer,   ' INT
    yDst As Integer,   ' INT
    dxDst As Integer,   ' INT
    dyDst As Integer,   ' INT
    lpbi As IntPtr,   ' BITMAPINFOHEADER* optional
    lpBits As IntPtr,   ' void* optional
    xSrc As Integer,   ' INT
    ySrc As Integer,   ' INT
    dxSrc As Integer,   ' INT
    dySrc As Integer,   ' INT
    wFlags As UInteger   ' DWORD
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' hdd : INT_PTR
' hdc : HDC
' xDst : INT
' yDst : INT
' dxDst : INT
' dyDst : INT
' lpbi : BITMAPINFOHEADER* optional
' lpBits : void* optional
' xSrc : INT
' ySrc : INT
' dxSrc : INT
' dySrc : INT
' wFlags : DWORD
Declare PtrSafe Function DrawDibDraw Lib "msvfw32" ( _
    ByVal hdd As LongPtr, _
    ByVal hdc As LongPtr, _
    ByVal xDst As Long, _
    ByVal yDst As Long, _
    ByVal dxDst As Long, _
    ByVal dyDst As Long, _
    ByVal lpbi As LongPtr, _
    ByVal lpBits As LongPtr, _
    ByVal xSrc As Long, _
    ByVal ySrc As Long, _
    ByVal dxSrc As Long, _
    ByVal dySrc As Long, _
    ByVal wFlags As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DrawDibDraw = ctypes.windll.msvfw32.DrawDibDraw
DrawDibDraw.restype = wintypes.BOOL
DrawDibDraw.argtypes = [
    ctypes.c_ssize_t,  # hdd : INT_PTR
    wintypes.HANDLE,  # hdc : HDC
    ctypes.c_int,  # xDst : INT
    ctypes.c_int,  # yDst : INT
    ctypes.c_int,  # dxDst : INT
    ctypes.c_int,  # dyDst : INT
    ctypes.c_void_p,  # lpbi : BITMAPINFOHEADER* optional
    ctypes.POINTER(None),  # lpBits : void* optional
    ctypes.c_int,  # xSrc : INT
    ctypes.c_int,  # ySrc : INT
    ctypes.c_int,  # dxSrc : INT
    ctypes.c_int,  # dySrc : INT
    wintypes.DWORD,  # wFlags : DWORD
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MSVFW32.dll')
DrawDibDraw = Fiddle::Function.new(
  lib['DrawDibDraw'],
  [
    Fiddle::TYPE_INTPTR_T,  # hdd : INT_PTR
    Fiddle::TYPE_VOIDP,  # hdc : HDC
    Fiddle::TYPE_INT,  # xDst : INT
    Fiddle::TYPE_INT,  # yDst : INT
    Fiddle::TYPE_INT,  # dxDst : INT
    Fiddle::TYPE_INT,  # dyDst : INT
    Fiddle::TYPE_VOIDP,  # lpbi : BITMAPINFOHEADER* optional
    Fiddle::TYPE_VOIDP,  # lpBits : void* optional
    Fiddle::TYPE_INT,  # xSrc : INT
    Fiddle::TYPE_INT,  # ySrc : INT
    Fiddle::TYPE_INT,  # dxSrc : INT
    Fiddle::TYPE_INT,  # dySrc : INT
    -Fiddle::TYPE_INT,  # wFlags : DWORD
  ],
  Fiddle::TYPE_INT)

#[link(name = "msvfw32")]
extern "system" {
    fn DrawDibDraw(
        hdd: isize,  // INT_PTR
        hdc: *mut core::ffi::c_void,  // HDC
        xDst: i32,  // INT
        yDst: i32,  // INT
        dxDst: i32,  // INT
        dyDst: i32,  // INT
        lpbi: *mut BITMAPINFOHEADER,  // BITMAPINFOHEADER* optional
        lpBits: *mut (),  // void* optional
        xSrc: i32,  // INT
        ySrc: i32,  // INT
        dxSrc: i32,  // INT
        dySrc: i32,  // INT
        wFlags: u32  // DWORD
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MSVFW32.dll")]
public static extern bool DrawDibDraw(IntPtr hdd, IntPtr hdc, int xDst, int yDst, int dxDst, int dyDst, IntPtr lpbi, IntPtr lpBits, int xSrc, int ySrc, int dxSrc, int dySrc, uint wFlags);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MSVFW32_DrawDibDraw' -Namespace Win32 -PassThru
# $api::DrawDibDraw(hdd, hdc, xDst, yDst, dxDst, dyDst, lpbi, lpBits, xSrc, ySrc, dxSrc, dySrc, wFlags)

#uselib "MSVFW32.dll"
#func global DrawDibDraw "DrawDibDraw" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; DrawDibDraw hdd, hdc, xDst, yDst, dxDst, dyDst, varptr(lpbi), lpBits, xSrc, ySrc, dxSrc, dySrc, wFlags   ; 戻り値は stat
; hdd : INT_PTR -> "sptr"
; hdc : HDC -> "sptr"
; xDst : INT -> "sptr"
; yDst : INT -> "sptr"
; dxDst : INT -> "sptr"
; dyDst : INT -> "sptr"
; lpbi : BITMAPINFOHEADER* optional -> "sptr"
; lpBits : void* optional -> "sptr"
; xSrc : INT -> "sptr"
; ySrc : INT -> "sptr"
; dxSrc : INT -> "sptr"
; dySrc : INT -> "sptr"
; wFlags : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MSVFW32.dll"
#cfunc global DrawDibDraw "DrawDibDraw" sptr, sptr, int, int, int, int, var, sptr, int, int, int, int, int
; res = DrawDibDraw(hdd, hdc, xDst, yDst, dxDst, dyDst, lpbi, lpBits, xSrc, ySrc, dxSrc, dySrc, wFlags)
; hdd : INT_PTR -> "sptr"
; hdc : HDC -> "sptr"
; xDst : INT -> "int"
; yDst : INT -> "int"
; dxDst : INT -> "int"
; dyDst : INT -> "int"
; lpbi : BITMAPINFOHEADER* optional -> "var"
; lpBits : void* optional -> "sptr"
; xSrc : INT -> "int"
; ySrc : INT -> "int"
; dxSrc : INT -> "int"
; dySrc : INT -> "int"
; wFlags : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MSVFW32.dll"
#cfunc global DrawDibDraw "DrawDibDraw" sptr, sptr, int, int, int, int, sptr, sptr, int, int, int, int, int
; res = DrawDibDraw(hdd, hdc, xDst, yDst, dxDst, dyDst, varptr(lpbi), lpBits, xSrc, ySrc, dxSrc, dySrc, wFlags)
; hdd : INT_PTR -> "sptr"
; hdc : HDC -> "sptr"
; xDst : INT -> "int"
; yDst : INT -> "int"
; dxDst : INT -> "int"
; dyDst : INT -> "int"
; lpbi : BITMAPINFOHEADER* optional -> "sptr"
; lpBits : void* optional -> "sptr"
; xSrc : INT -> "int"
; ySrc : INT -> "int"
; dxSrc : INT -> "int"
; dySrc : INT -> "int"
; wFlags : DWORD -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。