DirectDraw 管理. [詳解]

#include <TnbDxDraw.h>

CDirectDraw の継承関係図

クラス
class	CSurface
	DirectDraw サーフェス管理. [詳解]

struct	TBuffer
	バッファ管理型. [詳解]

公開メンバ関数
	CDirectDraw (void)
	コンストラクタ [詳解]

bool	ClearBackbufferSurface (void)
	[描画] バックバッファクリア [詳解]

bool	Create (HWND hWnd, int bitsPixel=-1)
	[作成] 作成. [詳解]

CSurface	CreateWorkSurfase (int height, int width)

void	Destroy (void)
	[破棄] 破棄. [詳解]

bool	Flip (void)
	[処理] フィリップ. [詳解]

const SIZE &	GetBackbufferSize (void) const
	[取得] バックバッファサーフェスのサイズ取得. [詳解]

CSurface &	GetBackbufferSurface (void)
	[取得] バックバッファ取得. [詳解]

int	GetBitsPixel (void) const
	[取得] ピクセル BIT 数取得. [詳解]

const SIZE &	GetPrimarySize (void) const
	[取得] プライマリサーフェスのサイズ取得. [詳解]

bool	Redraw (void)
	[表示] 再表示. [詳解]

bool	SetFullScreenMode (bool isFull)
	[設定] フルスクリーンモード設定. [詳解]

void	SetOffset (int x, int y, int magnificX, int magnificY)
	[設定] オフセット設定. [詳解]

void	SetOffset (int x=0, int y=0, int magnific=1)
	[設定] オフセット設定. [詳解]

bool	SetSize (const SIZE &primarySize, const SIZE &backSize)
	[設定] サイズ設定. [詳解]

bool	SetSize (const SIZE &size)
	[設定] サイズ設定. [詳解]

void	WaitForVerticalBlank (void)
	[処理] 垂直同期待ち. [詳解]

	~CDirectDraw (void)
	デストラクタ [詳解]

詳解

DirectDraw 管理.

必要ファイル: TnbDxDraw.h
DirectX 7 以上の SDK も必要です。

日付: 09/07/23 新規作成; 10/02/16 SetOffset() で、X Y 別々の倍率を指定できるようにした。

TnbDxDraw.h の 55 行目に定義があります。

構築子と解体子

◆ CDirectDraw()

CDirectDraw ( void )

コンストラクタ

TnbDxDraw.h の 506 行目に定義があります。

◆ ~CDirectDraw()

~CDirectDraw ( void )

デストラクタ

TnbDxDraw.h の 519 行目に定義があります。

関数詳解

◆ ClearBackbufferSurface()

bool ClearBackbufferSurface ( void )

[描画] バックバッファクリア

覚え書き: 真っ黒にします。

戻り値

true	成功
false	失敗

TnbDxDraw.h の 802 行目に定義があります。

◆ Create()

bool Create	(	HWND	hWnd,
		int	bitsPixel = `-1`
	)

[作成] 作成.

DirectDraw を作成します。

覚え書き: SetSize() にて、先にサイズを指定しておく必要があります。

引数

hWnd	関連するウィンドウハンドル.
bitsPixel	１ピクセルのビット数。省略すると、現在のディスプレイの設定が使われます( GetBitsPixel() で得ることが可能 )。

戻り値

true	成功
false	失敗

TnbDxDraw.h の 591 行目に定義があります。

◆ CreateWorkSurfase()

CSurface CreateWorkSurfase	(	int	height,
		int	width
	)

TnbDxDraw.h の 820 行目に定義があります。

◆ Destroy()

void Destroy ( void )

[破棄] 破棄.

DirectDraw オブジェクトを破棄します。

覚え書き: 作成していなければ何もしません。

TnbDxDraw.h の 623 行目に定義があります。

◆ Flip()

bool Flip ( void )

[処理] フィリップ.

覚え書き: フルスクリーンモードとウィンドウモードで動作が異なります。
フルスクリーンモードの場合、バックサーフェスとプライマリサーフェスを入れ替えます。
ウィンドウモードの場合、バックサーフェスの画像をプライマリサーフェスにコピーします。

戻り値

true	成功
false	失敗

TnbDxDraw.h の 761 行目に定義があります。

◆ GetBackbufferSize()

const SIZE & GetBackbufferSize ( void ) const

[取得] バックバッファサーフェスのサイズ取得.

戻り値: サイズ

TnbDxDraw.h の 647 行目に定義があります。

◆ GetBackbufferSurface()

CSurface & GetBackbufferSurface ( void )

[取得] バックバッファ取得.

戻り値: バックバッファの参照.

TnbDxDraw.h の 815 行目に定義があります。

◆ GetBitsPixel()

int GetBitsPixel ( void ) const

[取得] ピクセル BIT 数取得.

覚え書き: Create() 前は、システムの値、 Create() 後は、 DirectDraw から値を得ています。

戻り値

マイナス	エラー。
０以上	成功。値は、１ピクセルの BIT 数です。

TnbDxDraw.h の 658 行目に定義があります。

◆ GetPrimarySize()

const SIZE & GetPrimarySize ( void ) const

[取得] プライマリサーフェスのサイズ取得.

戻り値: サイズ

TnbDxDraw.h の 638 行目に定義があります。

◆ Redraw()

bool Redraw ( void )

[表示] 再表示.

覚え書き: ウィンドウモードの場合のみ、再表示を行います。通常、 WM_PAINT 時にコールします。; フルスクリーンモードの場合、何もしません。

戻り値

true	成功
false	失敗。フルスクリーンモードの場合も false が返ります。

TnbDxDraw.h の 734 行目に定義があります。

◆ SetFullScreenMode()

bool SetFullScreenMode ( bool isFull )

[設定] フルスクリーンモード設定.

フルスクリーンモードとウィンドウモードを切替えます。

覚え書き: 初期状態ではウィンドウモードです。; Create() 前でも後でも機能します。

引数

isFull true を指定するとフルスクリーンモード。 false を指定するとウィンドウモードになります。

戻り値

true	成功
false	失敗

TnbDxDraw.h の 533 行目に定義があります。

◆ SetOffset() [1/2]

void SetOffset	(	int	x,
		int	y,
		int	magnificX,
		int	magnificY
	)

[設定] オフセット設定.

ウィンドウモード時に、表示するオフセットを指定できます。

覚え書き: オフセット設定後、再表示します。

引数

x	X オフセット。
y	Y オフセット。
magnificX	X 倍率。
magnificY	Y 倍率。

TnbDxDraw.h の 688 行目に定義があります。

◆ SetOffset() [2/2]

void SetOffset	(	int	x = `0`,
		int	y = `0`,
		int	magnific = `1`
	)

[設定] オフセット設定.

ウィンドウモード時に、表示するオフセットを指定できます。

覚え書き: オフセット設定後、再表示します。

引数

x	X オフセット。
y	Y オフセット。
magnific	倍率。

TnbDxDraw.h の 713 行目に定義があります。

◆ SetSize() [1/2]

bool SetSize	(	const SIZE &	primarySize,
		const SIZE &	backSize
	)

[設定] サイズ設定.

プライマリサーフェスとバックバッファサーフェスのサイズを設定します。

覚え書き: Create() 後でも機能します。

引数

primarySize	プライマリサーフェスのサイズ
backSize	バックバッファサーフェスのサイズ。

戻り値

true	成功
false	失敗

TnbDxDraw.h の 570 行目に定義があります。

◆ SetSize() [2/2]

bool SetSize ( const SIZE & size )

[設定] サイズ設定.

プライマリサーフェスとバックバッファサーフェスのサイズを設定します。

覚え書き: Create() 後でも機能します。

引数

size	プライマリサーフェスとバックバッファサーフェスのサイズ。

戻り値

true	成功
false	失敗

TnbDxDraw.h の 556 行目に定義があります。

◆ WaitForVerticalBlank()

void WaitForVerticalBlank ( void )

[処理] 垂直同期待ち.

TnbDxDraw.h の 788 行目に定義があります。

クラス

公開メンバ関数

詳解

構築子と解体子

◆ CDirectDraw()

◆ ~CDirectDraw()

関数詳解

◆ ClearBackbufferSurface()

◆ Create()

◆ CreateWorkSurfase()

◆ Destroy()

◆ Flip()

◆ GetBackbufferSize()

◆ GetBackbufferSurface()

◆ GetBitsPixel()

◆ GetPrimarySize()

◆ Redraw()

◆ SetFullScreenMode()

◆ SetOffset() [1/2]

◆ SetOffset() [2/2]

◆ SetSize() [1/2]

◆ SetSize() [2/2]

◆ WaitForVerticalBlank()