TextureBrush::GetTransform メソッド (gdiplusbrush.h)

  • [アーティクル]

TextureBrush::GetTransform メソッドは、このテクスチャ ブラシの変換マトリックスを取得します。

構文

Status GetTransform(
  [out] Matrix *matrix
);

パラメーター

[out] matrix

種類: マトリックス*

変換行列を受け取る Matrix オブジェクトへのポインター。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

TextureBrush オブジェクトは、任意のアフィン変換を格納できる変換行列を保持します。 テクスチャ ブラシを使用して領域を塗りつぶすと、GDI+ はブラシの変換マトリックスに従ってブラシのイメージを変換し、領域を塗りつぶします。 変換されたイメージは、レンダリング中にのみ存在します。 TextureBrush オブジェクトに格納されているイメージは変換されません。 たとえば、 someTextureBrush.ScaleTransform(3) を呼び出し、 someTextureBrush で領域を塗りつぶすとします。 領域を塗りつぶすとブラシのイメージの幅は 3 倍になりますが、 someTextureBrush に格納されているイメージは変更されません。

例

次の例では、テクスチャ ブラシを作成し、ブラシの変換を設定します。 次に、このコードはブラシの変換マトリックスを取得し、要素の検査または使用に進みます。

VOID Example_GetTransform(HDC hdc)
{
   Graphics graphics(hdc);
  
   // Create a texture brush, and set its transform.
   Image image(L"marble.jpg");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 2);

   // Obtain information about the texture brush.
   Matrix matrix;
   REAL elements[6];

   textureBrush.GetTransform(&matrix);
   matrix.GetElements(elements);

   for(INT j = 0; j <=5; ++j)
   {
      // Inspect or use the value in elements[j].
   }
}

要件

   
サポートされている最小のクライアント Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー gdiplusbrush.h (Gdiplus.h を含む)
Library Gdiplus.lib
[DLL] Gdiplus.dll

関連項目

ブラシと図形の塗りつぶし

座標系と変換

イメージ テクスチャで図形を塗りつぶす

マトリックス

Texturebrush

TextureBrush::ResetTransform

TextureBrush::SetTransform

変換