グラフィックス コンテナー

グラフィックスの状態 (クリッピング領域、変換、品質設定) は Graphics オブジェクトに格納されます。 Windows GDI+ を使用すると、コンテナーを使用して Graphics オブジェクト内の状態の一部を一時的に置き換えたり拡張したりすることができます。 Graphics オブジェクトの Graphics::BeginContainer メソッドを呼び出してコンテナーを開始し、Graphics::EndContainer メソッドを呼び出してコンテナーを終了します。 Graphics::BeginContainer と Graphics::EndContainer の間で、Graphics オブジェクトに対して行った状態の変更はコンテナーに属し、Graphics オブジェクトの既存の状態は上書きされません。

次の例では、 Graphics オブジェクト内にコンテナーを作成します。 Graphics オブジェクトのワールド変換は右に 200 単位、コンテナーのワールド変換は 100 単位下の変換です。

myGraphics.TranslateTransform(200.0f, 0.0f);

myGraphicsContainer = myGraphics.BeginContainer();
   myGraphics.TranslateTransform(0.0f, 100.0f);
   myGraphics.DrawRectangle(&myPen, 0, 0, 50, 50);
myGraphics.EndContainer(myGraphicsContainer);

myGraphics.DrawRectangle(&myPen, 0, 0, 50, 50);

前の例では、Graphics::BeginContainer と Graphics::EndContainer の呼び出しの間に行われた ステートメントmyGraphics.DrawRectangle(&myPen, 0, 0, 50, 50)は、Graphics::EndContainer の呼び出し後に行われた同じステートメントとは異なる四角形を生成します。 水平方向の変換のみが、コンテナーの外部で行われた DrawRectangle 呼び出しに適用されます。 両方の変換 (200 単位の水平方向の翻訳と 100 単位の垂直方向の変換) は、コンテナー内で行われた Graphics::D rawRectangle 呼び出しに適用されます。 次の図は、2 つの四角形を示しています。

コンテナーは、コンテナー内で入れ子にすることができます。 次の例では、 Graphics オブジェクト内にコンテナーを作成し、最初のコンテナー内に別のコンテナーを作成します。 Graphics オブジェクトのワールド変換は、x 方向に 100 単位、y 方向に 80 単位の変換です。 最初のコンテナーのワールド変換は、30 度回転です。 2 番目のコンテナーのワールド変換は、x 方向の 2 倍のスケーリングです。 Graphics::D rawEllipse メソッドの呼び出しは、2 番目のコンテナー内で行われます。

myGraphics.TranslateTransform(100.0f, 80.0f, MatrixOrderAppend);

container1 = myGraphics.BeginContainer();
   myGraphics.RotateTransform(30.0f, MatrixOrderAppend);

   container2 = myGraphics.BeginContainer();
      myGraphics.ScaleTransform(2.0f, 1.0f);
      myGraphics.DrawEllipse(&myPen, -30, -20, 60, 40);
   myGraphics.EndContainer(container2);

myGraphics.EndContainer(container1);

次の図は省略記号を示しています。

3 つの変換はすべて、2 番目の (最も内側の) コンテナーで行われた Graphics::D rawEllipse 呼び出しに適用されることに注意してください。 また、変換の順序 (最初のスケール、次に回転、次に平行移動) にも注意してください。 最も内側の変換が最初に適用され、最も外側の変換が最後に適用されます。

Graphics オブジェクトのプロパティは、コンテナー内で設定できます (Graphics::BeginContainer と Graphics::EndContainer の呼び出しの間)。 たとえば、クリッピング領域はコンテナー内で設定できます。 コンテナー内で行われる描画は、そのコンテナーのクリッピング領域に制限され、外側のコンテナーのクリッピング領域と Graphics オブジェクト自体のクリッピング領域にも制限されます。

これまでに説明したプロパティ (ワールド変換とクリッピング領域) は、入れ子になったコンテナーによって結合されます。 その他のプロパティは、入れ子になったコンテナーに一時的に置き換えられます。 たとえば、コンテナー内でスムージング モードを SmoothingModeAntiAlias に設定した場合、そのコンテナー内で呼び出される描画メソッドはアンチエイリアス スムージング モードを使用しますが、 Graphics::EndContainer の後に呼び出された描画メソッドでは 、Graphics::BeginContainer の呼び出し前に配置されていたスムージング モードが使用されます。

Graphics オブジェクトとコンテナーのワールド変換を組み合わせる別の例として、目を描画し、一連の顔のさまざまな場所に配置するとします。 次の使用例は、座標系の原点を中心にして目を描画します。

void DrawEye(Graphics* pGraphics)
{
   GraphicsContainer eyeContainer;
   
   eyeContainer = pGraphics->BeginContainer();

      Pen myBlackPen(Color(255, 0, 0, 0));
      SolidBrush myGreenBrush(Color(255, 0, 128, 0));
      SolidBrush myBlackBrush(Color(255, 0, 0, 0));

      GraphicsPath myTopPath;
      myTopPath.AddEllipse(-30, -50, 60, 60);

      GraphicsPath myBottomPath;
      myBottomPath.AddEllipse(-30, -10, 60, 60);

      Region myTopRegion(&myTopPath);
      Region myBottomRegion(&myBottomPath);

      // Draw the outline of the eye.
      // The outline of the eye consists of two ellipses.
      // The top ellipse is clipped by the bottom ellipse, and
      // the bottom ellipse is clipped by the top ellipse.
      pGraphics->SetClip(&myTopRegion);
      pGraphics->DrawPath(&myBlackPen, &myBottomPath);
      pGraphics->SetClip(&myBottomRegion);
      pGraphics->DrawPath(&myBlackPen, &myTopPath);

      // Fill the iris.
      // The iris is clipped by the bottom ellipse.
      pGraphics->FillEllipse(&myGreenBrush, -10, -15, 20, 22);

      // Fill the pupil.
      pGraphics->FillEllipse(&myBlackBrush, -3, -7, 6, 9);

   pGraphics->EndContainer(eyeContainer);
}

次の図は、目と座標軸を示しています。

前の例で定義した DrawEye 関数は 、Graphics オブジェクトのアドレスを受け取り、その Graphics オブジェクト内にコンテナーをすぐに作成します。 このコンテナーは、DrawEye 関数の実行中に行われたプロパティ設定から DrawEye 関数を呼び出すコードを分離します。 たとえば、DrawEye 関数のコードは Graphics オブジェクトのクリッピング領域を設定しますが、DrawEye が呼び出し元ルーチンにコントロールを返すと、クリッピング領域は DrawEye の呼び出し前と同じになります。

次の例では、3 つの楕円 (顔) を描画し、それぞれに目が入っています。

// Draw an ellipse with center at (100, 100).
myGraphics.TranslateTransform(100.0f, 100.0f);
myGraphics.DrawEllipse(&myBlackPen, -40, -60, 80, 120);

// Draw the eye at the center of the ellipse.
DrawEye(&myGraphics);

// Draw an ellipse with center at 200, 100.
myGraphics.TranslateTransform(100.0f, 0.0f, MatrixOrderAppend);
myGraphics.DrawEllipse(&myBlackPen, -40, -60, 80, 120);

// Rotate the eye 40 degrees, and draw it 30 units above
// the center of the ellipse.
myGraphicsContainer = myGraphics.BeginContainer();
   myGraphics.RotateTransform(-40.0f);
   myGraphics.TranslateTransform(0.0f, -30.0f, MatrixOrderAppend);
   DrawEye(&myGraphics);
myGraphics.EndContainer(myGraphicsContainer);

// Draw a ellipse with center at (300.0f, 100.0f).
myGraphics.TranslateTransform(100.0f, 0.0f, MatrixOrderAppend);
myGraphics.DrawEllipse(&myBlackPen, -40, -60, 80, 120);

// Stretch and rotate the eye, and draw it at the 
// center of the ellipse.
myGraphicsContainer = myGraphics.BeginContainer();
   myGraphics.ScaleTransform(2.0f, 1.5f);
   myGraphics.RotateTransform(45.0f, MatrixOrderAppend);
   DrawEye(&myGraphics);
myGraphics.EndContainer(myGraphicsContainer);

次の図は、3 つの省略記号を示しています。

前の例では、すべての楕円が 呼び出し DrawEllipse(&myBlackPen, -40, -60, 80, 120)で描画され、座標系の原点を中心に楕円が描画されます。 省略記号は、 Graphics オブジェクトのワールド変換を設定することで、クライアント領域の左上隅から移動します。 ステートメントでは、最初の楕円の中央が (100、100) になります。 ステートメントを使用すると、2 番目の楕円の中心が 1 番目の楕円の中心の右側に 100 単位になります。 同様に、3 番目の楕円の中心は、2 番目の楕円の中心の右側に 100 単位です。

前の例のコンテナーを使用して、特定の楕円の中心を基準にして目を変換します。 最初の目は、変換なしで楕円の中心に描画されるため、DrawEye 呼び出しはコンテナー内にありません。 2 番目の目は 40 度回転し、楕円の中心から 30 単位上に描画されるため、DrawEye 関数と変換を設定するメソッドはコンテナー内で呼び出されます。 3 番目の目は、楕円の中心に引き伸ばされ、回転して描画されます。 2 番目の目と同様に、DrawEye 関数と変換を設定するメソッドはコンテナー内で呼び出されます。