CRenderTarget クラス

[アーティクル]
10/12/2023

ID2D1RenderTarget のラッパー。

構文

class CRenderTarget : public CObject;

メンバー

パブリックコンストラクター

名前	説明
CRenderTarget::CRenderTarget	CRenderTarget オブジェクトを構築します。
CRenderTarget::~CRenderTarget	デストラクター。レンダーターゲットオブジェクトが破棄されるときに呼び出されます。

パブリックメソッド

名前	説明
CRenderTarget::Attach	既存のレンダーターゲットインターフェイスをオブジェクトにアタッチします
CRenderTarget::BeginDraw	このレンダーターゲットでの描画を開始します。
CRenderTarget::Clear	指定した色の描画領域をクリアします。
CRenderTarget::COLORREF_TO_D2DCOLOR	GDI の色とアルファ値をD2D1_COLOR_F オブジェクトに変換します。
CRenderTarget::CreateCompatibleRenderTarget	現在のレンダーターゲットと互換性のある中間オフスクリーン描画中に使用する新しいビットマップレンダーターゲットを作成します。
CRenderTarget::D estroy	1 つ以上のリソースを削除します
CRenderTarget::D etach	レンダーターゲットインターフェイスをオブジェクトからデタッチします。
CRenderTarget::D rawBitmap	指定した IDWriteTextLayout オブジェクトによって記述された書式設定されたテキストを描画します。
CRenderTarget::D rawEllipse	指定したストロークスタイルを使用して、指定した楕円のアウトラインを描画します。
CRenderTarget::D rawGeometry	指定したストロークスタイルを使用して、指定したジオメトリのアウトラインを描画します。
CRenderTarget::D rawGlyphRun	指定したグリフを描画します。
CRenderTarget::D rawLine	指定したストロークスタイルを使用して、指定した点間に線を描画します。
CRenderTarget::D rawRectangle	指定した寸法とストロークスタイルを持つ四角形のアウトラインを描画します。
CRenderTarget::D rawRoundedRectangle	指定したストロークスタイルを使用して、指定した丸い四角形のアウトラインを描画します。
CRenderTarget::D rawText	IDWriteTextFormat オブジェクトによって提供される書式情報を使用して、指定したテキストを描画します。
CRenderTarget::D rawTextLayout	指定した IDWriteTextLayout オブジェクトによって記述された書式設定されたテキストを描画します。
CRenderTarget::EndDraw	レンダーターゲットに対する描画操作を終了し、現在のエラー状態と関連するタグを示します。
CRenderTarget::FillEllipse	指定した楕円の内部を塗りつぶします。
CRenderTarget::FillGeometry	指定したジオメトリの内部を塗りつぶします。
CRenderTarget::FillMesh	指定したメッシュの内部を塗りつぶします。
CRenderTarget::FillOpacityMask	指定したビットマップで記述された不透明度マスクをブラシに適用し、そのブラシを使用してレンダーターゲットの領域を描画します。
CRenderTarget::FillRectangle	指定した四角形の内部を塗りつぶします。
CRenderTarget::FillRoundedRectangle	指定した丸い四角形の内部を塗りつぶします。
CRenderTarget::Flush	保留中のすべての描画コマンドを実行します。
CRenderTarget::GetAntialiasMode	非テキスト描画操作の現在のアンチエイリアシングモードを取得します。
CRenderTarget::GetDpi	レンダーターゲットのドット/インチ (DPI) を返します。
CRenderTarget::GetMaximumBitmapSize	レンダーターゲットでサポートされている 1 つのビットマップディメンションの最大サイズ (デバイス依存単位 (ピクセル単位) を取得します。
CRenderTarget::GetPixelFormat	レンダーターゲットのピクセル形式とアルファモードを取得します。
CRenderTarget::GetPixelSize	レンダーターゲットのサイズをデバイスピクセル単位で返します。
CRenderTarget::GetRenderTarget	ID2D1RenderTarget インターフェイスを返します。
CRenderTarget::GetSize	レンダーターゲットのサイズをデバイスに依存しないピクセル単位で返します。
CRenderTarget::GetTags	後続の描画操作のラベルを取得します。
CRenderTarget::GetTextAntialiasMode	テキストおよびグリフ描画操作の現在のアンチエイリアシングモードを取得します。
CRenderTarget::GetTextRenderingParams	レンダーターゲットの現在のテキストレンダリングオプションを取得します。
CRenderTarget::GetTransform	指定した変換をレンダーターゲットに適用し、既存の変換を置き換えます。それ以降のすべての描画操作は、変換された空間で行われます。
CRenderTarget::IsSupported	レンダーターゲットが指定したプロパティをサポートしているかどうかを示します
CRenderTarget::IsValid	リソースの有効性を確認します
CRenderTarget::P opAxisAlignedClip	レンダーターゲットから最後に軸にアラインされたクリップを削除します。このメソッドが呼び出されると、クリップは後続の描画操作に適用されなくなります。
CRenderTarget::P opLayer	最後の PushLayer 呼び出しで指定されたレイヤーへの描画操作のリダイレクトを停止します。
CRenderTarget::P ushAxisAlignedClip	レンダーターゲットから最後に軸にアラインされたクリップを削除します。このメソッドが呼び出されると、クリップは後続の描画操作に適用されなくなります。
CRenderTarget::P ushLayer	指定したレイヤーをレンダーターゲットに追加して、PopLayer が呼び出されるまで後続のすべての描画操作を受け取るようにします。
CRenderTarget::RestoreDrawingState	レンダーターゲットの描画状態を、指定した ID2D1DrawingStateBlock の状態に設定します。
CRenderTarget::SaveDrawingState	現在の描画状態を指定した ID2D1DrawingStateBlock に保存します。
CRenderTarget::SetAntialiasMode	レンダーターゲットのアンチエイリアシングモードを設定します。アンチエイリアシングモードは、テキストおよびグリフ描画操作を除く、後続のすべての描画操作に適用されます。
CRenderTarget::SetDpi	レンダーターゲットのドット/インチ (DPI) を設定します。
CRenderTarget::SetTags	後続の描画操作のラベルを指定します。
CRenderTarget::SetTextAntialiasMode	後続のテキストおよびグリフ描画操作に使用するアンチエイリアシングモードを指定します。
CRenderTarget::SetTextRenderingParams	後続のすべてのテキストおよびグリフ描画操作に適用するテキストレンダリングオプションを指定します。
CRenderTarget::SetTransform	過負荷です。指定した変換をレンダーターゲットに適用し、既存の変換を置き換えます。それ以降のすべての描画操作は、変換された空間で行われます。

保護メソッド

名前	説明
CRenderTarget::VerifyResource	CD2DResource オブジェクトの有効性を確認します。は、まだ存在していない場合はオブジェクトを作成します。

パブリック演算子

名前	説明
CRenderTarget::operator ID2D1RenderTarget*	ID2D1RenderTarget インターフェイスを返します。

プロテクトデータメンバー

名前	説明
CRenderTarget::m_lstResources	CD2DResource オブジェクトへのポインターの一覧。
CRenderTarget::m_pRenderTarget	ID2D1RenderTarget オブジェクトへのポインター。
CRenderTarget::m_pTextFormatDefault	既定のテキスト形式を含む CD2DTextFormat オブジェクトへのポインター。

継承階層

CObject

CRenderTarget

要件

Header: afxrendertarget.h

CRenderTarget::~CRenderTarget

デストラクター。レンダーターゲットオブジェクトが破棄されるときに呼び出されます。

virtual ~CRenderTarget();

CRenderTarget::Attach

既存のレンダーターゲットインターフェイスをオブジェクトにアタッチします

void Attach(ID2D1RenderTarget* pRenderTarget);

パラメーター

pRenderTarget
既存のレンダーターゲットインターフェイス。 NULL にすることはできません

CRenderTarget::BeginDraw

このレンダーターゲットでの描画を開始します。

void BeginDraw();

CRenderTarget::Clear

指定した色の描画領域をクリアします。

void Clear(D2D1_COLOR_F color);

パラメーター

color
描画領域をクリアする色。

CRenderTarget::COLORREF_TO_D2DCOLOR

GDI の色とアルファ値をD2D1_COLOR_F オブジェクトに変換します。

static D2D1_COLOR_F COLORREF_TO_D2DCOLOR(
    COLORREF color,
    int nAlpha = 255);

パラメーター

color
RGB 値。

nAlpha

戻り値

D2D1_COLOR_F値。

CRenderTarget::CreateCompatibleRenderTarget

現在のレンダーターゲットと互換性のある中間オフスクリーン描画中に使用する新しいビットマップレンダーターゲットを作成します。

BOOL CreateCompatibleRenderTarget(
    CBitmapRenderTarget& bitmapTarget,
    CD2DSizeF sizeDesired = CD2DSizeF(0., 0.),
    CD2DSizeU sizePixelDesired = CD2DSizeU(0, 0),
    D2D1_PIXEL_FORMAT* desiredFormat = NULL,
    D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options = D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS_NONE);

パラメーター

bitmapTarget
このメソッドから制御が戻るときに、新しいビットマップレンダーターゲットへのポインターのアドレスが格納されます。このパラメーターは初期化せずに渡されます。

sizeDesired
元のレンダーターゲットと異なる必要がある場合は、デバイスに依存しないピクセル単位の新しいレンダーターゲットの目的のサイズ(NULL)。詳細については、「解説」を参照してください。

sizePixelDesired
元のレンダーターゲットと異なる必要がある場合は、新しいレンダーターゲットの目的のサイズ (ピクセル単位)。詳細については、「解説」を参照してください。

desiredFormat
新しいレンダーターゲットの目的のピクセル形式とアルファモード(NULL)。ピクセル形式が DXGI_FORMAT_UNKNOWN に設定されている場合、またはこのパラメーターが null の場合、新しいレンダーターゲットは元のレンダーターゲットと同じピクセル形式を使用します。アルファモードがD2D1_ALPHA_MODE_UNKNOWNまたはこのパラメーターが NULL の場合、新しいレンダーターゲットのアルファモードは既定でD2D1_ALPHA_MODE_PREMULTIPLIEDされます。サポートされているピクセル形式の詳細については、「サポートされているピクセルフォーマットとアルファモード」を参照してください。

options
新しいレンダーターゲットが GDI と互換性を持つ必要があるかどうかを指定する値。

戻り値

メソッドが成功すると、TRUE が返されます。それ以外の場合、FALSE を返します。

CRenderTarget::CRenderTarget

CRenderTarget オブジェクトを構築します。

CRenderTarget();

CRenderTarget::D estroy

1 つ以上のリソースを削除します

BOOL Destroy(BOOL bDeleteResources = TRUE);

パラメーター

bDeleteResources
bDeleteResources が TRUE の場合、m_lstResourcesにあるすべてのリソースは自動的に破棄されます。

戻り値

メソッドが成功すると、TRUE が返されます。それ以外の場合は FALSE を返します。

CRenderTarget::D etach

レンダーターゲットインターフェイスをオブジェクトからデタッチします。

ID2D1RenderTarget* Detach ();

戻り値

デタッチされたレンダーターゲットインターフェイスへのポインター。

CRenderTarget::D rawBitmap

指定した IDWriteTextLayout オブジェクトによって記述された書式設定されたテキストを描画します。

void DrawBitmap(
    CD2DBitmap* pBitmap,
    const CD2DRectF& rectDest,
    float fOpacity = 1.0,
    D2D1_BITMAP_INTERPOLATION_MODE interpolationMode = D2D1_BITMAP_INTERPOLATION_MODE_LINEAR,
    const CD2DRectF* pRectSrc = NULL);

パラメーター

pBitmap
レンダリングするビットマップ。

rectDest
ビットマップが描画される領域のサイズと位置 (レンダーターゲットの座標空間内のデバイスに依存しないピクセル単位)。四角形の順序が整っていない場合、何も描画されませんが、レンダーターゲットはエラー状態になりません。

fOpacity
ビットマップに適用する不透明度の値を指定する 0.0f ~ 1.0f の値。この値は、ビットマップの内容のアルファ値に対して乗算されます。

interpolationMode
ビットマップが描画操作によって拡大縮小または回転される場合に使用する補間モード。

pRectSrc
描画するビットマップ内の領域のサイズと位置 (ビットマップの座標空間内のデバイスに依存しないピクセル単位)。

CRenderTarget::D rawEllipse

指定したストロークスタイルを使用して、指定した楕円のアウトラインを描画します。

void DrawEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

パラメーター

楕円
描画する楕円の位置と半径 (デバイスに依存しないピクセル単位)。

pBrush
楕円の輪郭の描画に使用するブラシ。

fStrokeWidth
楕円のストロークの太さ。ストロークは楕円のアウトラインの中央に配置されます。

strokeStyle
楕円のアウトラインに適用するストロークのスタイル。塗りつぶす場合は NULL。

CRenderTarget::D rawGeometry

指定したストロークスタイルを使用して、指定したジオメトリのアウトラインを描画します。

void DrawGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

パラメーター

pGeometry
描画するジオメトリ。

pBrush
ジオメトリのストロークを描画するために使用されるブラシ。

fStrokeWidth
ジオメトリのストロークの太さ。ストロークはジオメトリのアウトラインの中央に配置されます。

strokeStyle
ジオメトリのアウトラインに適用するストロークのスタイル。ソリッドストロークを描画する場合は NULL。

CRenderTarget::D rawGlyphRun

指定したグリフを描画します。

void DrawGlyphRun(
    const CD2DPointF& ptBaseLineOrigin,
    const DWRITE_GLYPH_RUN& glyphRun,
    CD2DBrush* pForegroundBrush,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

パラメーター

ptBaseLineOrigin
グリフのベースラインの原点 (デバイスに依存しないピクセル単位)。

glyphRun
レンダリングするグリフ。

pForegroundBrush
指定したグリフの描画に使用するブラシ。

measuringMode
書式設定時にグリフメトリックを使用してテキストを測定する方法を示す値。既定値は DWRITE_MEASURING_MODE_NATURAL です。

CRenderTarget::D rawLine

指定したストロークスタイルを使用して、指定した点間に線を描画します。

void DrawLine(
    const CD2DPointF& ptFrom,
    const CD2DPointF& ptTo,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

パラメーター

ptFrom
デバイスに依存しないピクセル単位での行の始点。

ptTo
デバイスに依存しないピクセル単位の線の終点。

pBrush
線のストロークを描画するために使用されるブラシ。

fStrokeWidth
ストロークの幅を指定する 0.0f 以上の値。このパラメーターが指定されていない場合、既定値は 1.0f になります。ストロークは線の中央に配置されます。

strokeStyle
塗りつぶすストロークのスタイル。実線を塗りつぶす場合は NULL。

CRenderTarget::D rawRectangle

指定した寸法とストロークスタイルを持つ四角形のアウトラインを描画します。

void DrawRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

パラメーター

長方形
描画する四角形の寸法 (デバイスに依存しないピクセル単位)

pBrush
四角形のストロークを描画するために使用されるブラシ

fStrokeWidth
四角形のストロークの幅を指定する 0.0f 以上の値。ストロークは四角形のアウトラインの中央に配置されます。

strokeStyle
塗りつぶすストロークのスタイル。塗りつぶす場合は NULL。

CRenderTarget::D rawRoundedRectangle

指定したストロークスタイルを使用して、指定した丸い四角形のアウトラインを描画します。

void DrawRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush,
    FLOAT fStrokeWidth = 1.0,
    ID2D1StrokeStyle* strokeStyle = NULL);

パラメーター

rectRounded
描画する丸い四角形の寸法 (デバイスに依存しないピクセル単位)。

pBrush
丸い四角形の輪郭を塗りつぶすために使用するブラシ。

fStrokeWidth
丸い四角形のストロークの幅。ストロークは、丸い四角形のアウトラインの中央に配置されます。既定値は 1.0f です。

strokeStyle
丸い四角形のストロークのスタイル。塗りつぶす場合は NULL。既定値は NULL です。

CRenderTarget::D rawText

IDWriteTextFormat オブジェクトによって提供される書式情報を使用して、指定したテキストを描画します。

void DrawText(
    const CString& strText,
    const CD2DRectF& rectangle,
    CD2DBrush* pForegroundBrush,
    CD2DTextFormat* textFormat = NULL,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE,
    DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL);

パラメーター

strText
描画する Unicode 文字の配列へのポインター。

長方形
テキストが描画される領域のサイズと位置。

pForegroundBrush
テキストの描画に使用するブラシ。

textFormat
フォント、フォントサイズ、フロー方向など、描画するテキストの書式設定の詳細を記述するオブジェクト。

options
テキストをピクセル境界にスナップするかどうか、およびテキストをレイアウト四角形にクリップするかどうかを示す値。既定値は D2D1_DRAW_TEXT_OPTIONS_NONE です。これは、テキストをピクセル境界にスナップし、レイアウト四角形にクリップしないことを示します。

measuringMode
書式設定時にグリフメトリックを使用してテキストを測定する方法を示す値。既定値は DWRITE_MEASURING_MODE_NATURAL です。

CRenderTarget::D rawTextLayout

指定した IDWriteTextLayout オブジェクトによって記述された書式設定されたテキストを描画します。

void DrawTextLayout(
    const CD2DPointF& ptOrigin,
    CD2DTextLayout* textLayout,
    CD2DBrush* pBrushForeground,
    D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE);

パラメーター

ptOrigin
textLayout によって記述されたテキストの左上隅が描画される、デバイスに依存しないピクセルで記述されたポイント。

textLayout
描画する書式設定されたテキスト。 ID2D1Resource から継承されない描画効果は無視されます。ブラシではない ID2D1Resource を継承する描画効果がある場合、このメソッドは失敗し、レンダーターゲットはエラー状態になります。

pBrushForeground
描画効果としてまだ関連付けられていない textLayout 内のテキストを描画するために使用されるブラシ (IDWriteTextLayout::SetDrawingEffect メソッドで指定)。

CRenderTarget::EndDraw

レンダーターゲットに対する描画操作を終了し、現在のエラー状態と関連するタグを示します。

HRESULT EndDraw();

戻り値

メソッドが成功した場合は、S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

CRenderTarget::FillEllipse

指定した楕円の内部を塗りつぶします。

void FillEllipse(
    const CD2DEllipse& ellipse,
    CD2DBrush* pBrush);

パラメーター

楕円
描画する楕円の位置と半径 (デバイスに依存しないピクセル単位)。

pBrush
楕円の内部を塗りつぶすために使用するブラシ。

CRenderTarget::FillGeometry

指定したジオメトリの内部を塗りつぶします。

void FillGeometry(
    CD2DGeometry* pGeometry,
    CD2DBrush* pBrush,
    CD2DBrush* pOpacityBrush = NULL);

パラメーター

pGeometry
ペイントするジオメトリ。

pBrush
ジオメトリの内部を描画するために使用されるブラシ。

pOpacityBrush
ジオメトリに適用する不透明度マスク。不透明度マスクがない場合は NULL。不透明度マスク (opacityBrush パラメーター) を指定する場合、ブラシは ID2D1BitmapBrush で、x 拡張モードと y 拡張モードをD2D1_EXTEND_MODE_CLAMPに設定する必要があります。詳細については、「解説」を参照してください。

CRenderTarget::FillMesh

指定したメッシュの内部を塗りつぶします。

void FillMesh(
    CD2DMesh* pMesh,
    CD2DBrush* pBrush);

パラメーター

pMesh
ペイントするメッシュ。

pBrush
メッシュの描画に使用するブラシ。

CRenderTarget::FillOpacityMask

指定したビットマップで記述された不透明度マスクをブラシに適用し、そのブラシを使用してレンダーターゲットの領域を描画します。

void FillOpacityMask(
    CD2DBitmap* pOpacityMask,
    CD2DBrush* pBrush,
    D2D1_OPACITY_MASK_CONTENT content,
    const CD2DRectF& rectDest,
    const CD2DRectF& rectSrc);

パラメーター

pOpacityMask
描画する楕円の位置と半径 (デバイスに依存しないピクセル単位)。

pBrush
destinationRectangle で指定されたレンダーターゲットの領域を描画するために使用されるブラシ。

content
不透明度マスクに含まれるコンテンツの種類。この値は、不透明度マスクがブレンドされる色空間を決定するために使用されます。

rectDest
描画するレンダーターゲットの領域 (デバイスに依存しないピクセル単位)。

rectSrc
不透明度マスクとして使用するビットマップの領域 (デバイスに依存しないピクセル単位)。

CRenderTarget::FillRectangle

指定した四角形の内部を塗りつぶします。

void FillRectangle(
    const CD2DRectF& rectangle,
    CD2DBrush* pBrush);

パラメーター

長方形
描画する四角形の寸法 (デバイスに依存しないピクセル単位)。

pBrush
四角形の内部を塗りつぶすために使用するブラシ。

CRenderTarget::FillRoundedRectangle

指定した丸い四角形の内部を塗りつぶします。

void FillRoundedRectangle(
    const CD2DRoundedRect& rectRounded,
    CD2DBrush* pBrush);

パラメーター

rectRounded
描画する丸い四角形の寸法 (デバイスに依存しないピクセル単位)。

pBrush
丸い四角形の内部を塗りつぶすために使用するブラシ。

CRenderTarget::Flush

保留中のすべての描画コマンドを実行します。

void Flush(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL);

パラメーター

tag1
エラーの原因となった描画操作のタグ、またはエラーが発生しなかった場合は 0 を含みます。このパラメーターは初期化せずに渡されます。

tag2
エラーの原因となった描画操作のタグ、またはエラーが発生しなかった場合は 0 を含みます。このパラメーターは初期化せずに渡されます。

CRenderTarget::GetAntialiasMode

非テキスト描画操作の現在のアンチエイリアシングモードを取得します。

D2D1_ANTIALIAS_MODE GetAntialiasMode() const;

戻り値

非テキスト描画操作の現在のアンチエイリアシングモード。

CRenderTarget::GetDpi

レンダーターゲットのドット/インチ (DPI) を返します。

CD2DSizeF GetDpi() const;

戻り値

レンダーターゲットのドット/インチ (DPI)。

CRenderTarget::GetMaximumBitmapSize

レンダーターゲットでサポートされている 1 つのビットマップディメンションの最大サイズ (デバイス依存単位 (ピクセル単位) を取得します。

UINT32 GetMaximumBitmapSize() const;

戻り値

レンダーターゲットでサポートされている 1 つのビットマップディメンションの最大サイズ (ピクセル単位)

CRenderTarget::GetPixelFormat

レンダーターゲットのピクセル形式とアルファモードを取得します。

D2D1_PIXEL_FORMAT GetPixelFormat() const;

戻り値

レンダーターゲットのピクセル形式とアルファモード

CRenderTarget::GetPixelSize

レンダーターゲットのサイズをデバイスピクセル単位で返します。

CD2DSizeU GetPixelSize() const;

戻り値

レンダーターゲットのサイズ (デバイスピクセル単位)

CRenderTarget::GetRenderTarget

ID2D1RenderTarget インターフェイスを返します。

ID2D1RenderTarget* GetRenderTarget();

戻り値

ID2D1RenderTarget インターフェイスへのポインター。オブジェクトがまだ初期化されていない場合は NULL。

CRenderTarget::GetSize

レンダーターゲットのサイズをデバイスに依存しないピクセル単位で返します。

CD2DSizeF GetSize() const;

戻り値

レンダーターゲットの現在のサイズ (デバイスに依存しないピクセル単位)

CRenderTarget::GetTags

後続の描画操作のラベルを取得します。

void GetTags(
    D2D1_TAG* tag1 = NULL,
    D2D1_TAG* tag2 = NULL) const;

パラメーター

tag1
後続の描画操作の最初のラベルが含まれます。このパラメーターは初期化せずに渡されます。 NULL が指定されている場合、このパラメーターの値は取得されません。

tag2
後続の描画操作の 2 番目のラベルが含まれています。このパラメーターは初期化せずに渡されます。 NULL が指定されている場合、このパラメーターの値は取得されません。

CRenderTarget::GetTextAntialiasMode

テキストおよびグリフ描画操作の現在のアンチエイリアシングモードを取得します。

D2D1_TEXT_ANTIALIAS_MODE GetTextAntialiasMode() const;

戻り値

テキストおよびグリフ描画操作の現在のアンチエイリアシングモード。

CRenderTarget::GetTextRenderingParams

レンダーターゲットの現在のテキストレンダリングオプションを取得します。

void GetTextRenderingParams(IDWriteRenderingParams** textRenderingParams);

パラメーター

textRenderingParams
このメソッドが返されると、textRenderingParamscontains はレンダーターゲットの現在のテキストレンダリングオプションへのポインターのアドレスを格納します。

CRenderTarget::GetTransform

レンダーターゲットの現在の変換を取得します。

void GetTransform(D2D1_MATRIX_3X2_F* transform);

パラメーター

transform
これが返されると、レンダーターゲットの現在の変換が格納されます。このパラメーターは初期化せずに渡されます。

CRenderTarget::IsSupported

レンダーターゲットが指定したプロパティをサポートしているかどうかを示します

BOOL IsSupported(const D2D1_RENDER_TARGET_PROPERTIES& renderTargetProperties) const;

パラメーター

renderTargetProperties
テストするレンダーターゲットプロパティ

戻り値

指定したレンダーターゲットプロパティがこのレンダーターゲットでサポートされている場合は TRUE。それ以外の場合は FALSE

CRenderTarget::IsValid

リソースの有効性を確認します

BOOL IsValid() const;

戻り値

リソースが有効な場合は TRUE。それ以外の場合は FALSE。

CRenderTarget::m_lstResources

CD2DResource オブジェクトへのポインターの一覧。

CObList m_lstResources;

CRenderTarget::m_pRenderTarget

ID2D1RenderTarget オブジェクトへのポインター。

ID2D1RenderTarget* m_pRenderTarget;

CRenderTarget::m_pTextFormatDefault

既定のテキスト形式を含む CD2DTextFormat オブジェクトへのポインター。

CD2DTextFormat* m_pTextFormatDefault;

CRenderTarget::operator ID2D1RenderTarget*

ID2D1RenderTarget インターフェイスを返します。

operator ID2D1RenderTarget*();

戻り値

ID2D1RenderTarget インターフェイスへのポインター。オブジェクトがまだ初期化されていない場合は NULL。

CRenderTarget::P opAxisAlignedClip

レンダーターゲットから最後に軸にアラインされたクリップを削除します。このメソッドが呼び出されると、クリップは後続の描画操作に適用されなくなります。

void PopAxisAlignedClip();

CRenderTarget::P opLayer

最後の PushLayer 呼び出しで指定されたレイヤーへの描画操作のリダイレクトを停止します。

void PopLayer();

CRenderTarget::P ushAxisAlignedClip

void PushAxisAlignedClip(
    const CD2DRectF& rectClip,
    D2D1_ANTIALIAS_MODE mode = D2D1_ANTIALIAS_MODE_PER_PRIMITIVE);

パラメーター

rectClip
クリッピング領域のサイズと位置 (デバイスに依存しないピクセル単位)。

mode
サブピクセル境界を持つクリップ四角形のエッジを描画し、クリップをシーンコンテンツとブレンドするために使用されるアンチエイリアシングモード。ブレンドは、PopAxisAlignedClip メソッドが呼び出されたときに 1 回実行され、レイヤー内の各プリミティブには適用されません。

CRenderTarget::P ushLayer

指定したレイヤーをレンダーターゲットに追加して、PopLayer が呼び出されるまで後続のすべての描画操作を受け取るようにします。

void PushLayer(
    const D2D1_LAYER_PARAMETERS& layerParameters,
    CD2DLayer& layer);

パラメーター

layerParameters
レイヤーのコンテンツ境界、ジオメトリックマスク、不透明度、不透明度マスク、アンチエイリアシングオプション。

層
後続の描画操作を受け取るレイヤー。

CRenderTarget::RestoreDrawingState

レンダーターゲットの描画状態を、指定した ID2D1DrawingStateBlock の状態に設定します。

void RestoreDrawingState(ID2D1DrawingStateBlock& drawingStateBlock);

パラメーター

drawingStateBlock
レンダーターゲットの新しい描画状態。

CRenderTarget::SaveDrawingState

現在の描画状態を指定した ID2D1DrawingStateBlock に保存します。

void SaveDrawingState(ID2D1DrawingStateBlock& drawingStateBlock) const;

パラメーター

drawingStateBlock
このメソッドから制御が戻るときに、レンダーターゲットの現在の描画状態が格納されます。このパラメーターは、メソッドに渡す前に初期化する必要があります。

CRenderTarget::SetAntialiasMode

レンダーターゲットのアンチエイリアシングモードを設定します。アンチエイリアシングモードは、テキストおよびグリフ描画操作を除く、後続のすべての描画操作に適用されます。

void SetAntialiasMode(D2D1_ANTIALIAS_MODE antialiasMode);

パラメーター

antialiasMode
今後の描画操作用のアンチエイリアシングモード。

CRenderTarget::SetDpi

レンダーターゲットのドット/インチ (DPI) を設定します。

void SetDpi(const CD2DSizeF& sizeDPI);

パラメーター

sizeDPI
レンダーターゲットの水平/垂直DPI を指定する 0 以上の値。

CRenderTarget::SetTags

後続の描画操作のラベルを指定します。

void SetTags(
    D2D1_TAG tag1,
    D2D1_TAG tag2);

パラメーター

tag1
後続の描画操作に適用するラベル。

tag2
後続の描画操作に適用するラベル。

CRenderTarget::SetTextAntialiasMode

後続のテキストおよびグリフ描画操作に使用するアンチエイリアシングモードを指定します。

void SetTextAntialiasMode(D2D1_TEXT_ANTIALIAS_MODE textAntialiasMode);

パラメーター

textAntialiasMode
後続のテキストおよびグリフ描画操作に使用するアンチエイリアシングモード。

CRenderTarget::SetTextRenderingParams

後続のすべてのテキストおよびグリフ描画操作に適用するテキストレンダリングオプションを指定します。

void SetTextRenderingParams(IDWriteRenderingParams* textRenderingParams = NULL);

パラメーター

textRenderingParams
後続のすべてのテキストおよびグリフ描画操作に適用されるテキストレンダリングオプション。現在のテキストレンダリングオプションをクリアする場合は NULL。

CRenderTarget::SetTransform

指定した変換をレンダーターゲットに適用し、既存の変換を置き換えます。それ以降のすべての描画操作は、変換された空間で行われます。

void SetTransform(const D2D1_MATRIX_3X2_F* transform);
void SetTransform(const D2D1_MATRIX_3X2_F& transform);

パラメーター

transform
レンダーターゲットに適用する変換。

CRenderTarget::VerifyResource

CD2DResource オブジェクトの有効性を確認します。は、まだ存在していない場合はオブジェクトを作成します。

BOOL VerifyResource(CD2DResource* pResource);

パラメーター

pResource
CD2DResource オブジェクトへのポインター。

戻り値

TRUE は有効な場合はオブジェクトです。それ以外の場合は FALSE。

次の方法で共有

CRenderTarget クラス

構文

メンバー

パブリック コンストラクター

パブリック メソッド

保護メソッド

パブリック演算子

プロテクト データ メンバー

継承階層

要件

CRenderTarget::~CRenderTarget

CRenderTarget::Attach

パラメーター

CRenderTarget::BeginDraw

CRenderTarget::Clear

パラメーター

CRenderTarget::COLORREF_TO_D2DCOLOR

パラメーター

戻り値

CRenderTarget::CreateCompatibleRenderTarget

パラメーター

戻り値

CRenderTarget::CRenderTarget

CRenderTarget::D estroy

パラメーター

戻り値

CRenderTarget::D etach

戻り値

CRenderTarget::D rawBitmap

パラメーター

CRenderTarget::D rawEllipse

パラメーター

CRenderTarget::D rawGeometry

パラメーター

CRenderTarget::D rawGlyphRun

パラメーター

CRenderTarget::D rawLine

パラメーター

CRenderTarget::D rawRectangle

パラメーター

CRenderTarget::D rawRoundedRectangle

パラメーター

CRenderTarget::D rawText

パラメーター

CRenderTarget::D rawTextLayout

パラメーター

CRenderTarget::EndDraw

戻り値

CRenderTarget::FillEllipse

パラメーター

CRenderTarget::FillGeometry

パラメーター

CRenderTarget::FillMesh

パラメーター

CRenderTarget::FillOpacityMask

パラメーター

CRenderTarget::FillRectangle

パラメーター

CRenderTarget::FillRoundedRectangle

パラメーター

CRenderTarget::Flush

パラメーター

CRenderTarget::GetAntialiasMode

戻り値

CRenderTarget::GetDpi

戻り値

CRenderTarget::GetMaximumBitmapSize

戻り値

CRenderTarget::GetPixelFormat

戻り値

CRenderTarget::GetPixelSize

戻り値

CRenderTarget::GetRenderTarget

戻り値

CRenderTarget::GetSize

戻り値

CRenderTarget::GetTags

パラメーター

CRenderTarget::GetTextAntialiasMode

パブリックコンストラクター

パブリックメソッド

プロテクトデータメンバー