Caminhos (GDI+)

Os caminhos são formados combinando linhas, retângulos e curvas simples. Lembre-se da visão geral do Vector Graphics que os seguintes blocos de construção básicos provaram ser os mais úteis para desenhar imagens.

• Linhas
• Retângulos
• Elipses
• Arcos
• Polígonos
• Splines cardeais
• Splines de Bézier

No Windows GDI+, o objeto GraphicsPath permite coletar uma sequência desses blocos de construção em uma única unidade. Toda a sequência de linhas, retângulos, polígonos e curvas pode ser desenhada com uma chamada para o método Graphics::D rawPath da classe Graphics. A ilustração a seguir mostra um caminho criado combinando uma linha, um arco, uma spline de Bézier e uma spline cardinal.

A classe GraphicsPath fornece os seguintes métodos para criar uma sequência de itens a serem desenhados: AddLine, AddRectangle, AddEllipse, AddArc, AddPolygon, AddCurve (para splines cardinal) e AddBezier. Cada um desses métodos está sobrecarregado; ou seja, cada método vem em várias variações com listas de parâmetros diferentes. Por exemplo, uma variação do método AddLine recebe quatro inteiros e outra variação do método AddLine recebe dois objetos Point.

Os métodos para adicionar linhas, retângulos e splines de Bézier a um caminho têm métodos complementares plurales que adicionam vários itens ao caminho em uma única chamada: AddLines, AddRectanglese AddBeziers. Além disso, o método AddCurve tem um método complementar, AddClosedCurve, que adiciona uma curva fechada ao caminho.

Para desenhar um caminho, você precisa de um objeto Graphics, um objetoPen e um objetoGraphicsPath. O objeto Graphics fornece o método Graphics::D rawPath e o objeto Pen armazena atributos do caminho, como largura e cor da linha. O objeto GraphicsPath armazena a sequência de linhas, retângulos e curvas que compõem o caminho. Os endereços do objeto Pen e do objeto GraphicsPath são passados como argumentos para o método Graphics::D rawPath. O exemplo a seguir desenha um caminho que consiste em uma linha, uma elipse e uma spline Bézier.

myGraphicsPath.AddLine(0, 0, 30, 20);
myGraphicsPath.AddEllipse(20, 20, 20, 40);
myGraphicsPath.AddBezier(30, 60, 70, 60, 50, 30, 100, 10);
myGraphics.DrawPath(&myPen, &myGraphicsPath);

A ilustração a seguir mostra o caminho.

de spline mais bezier

Além de adicionar linhas, retângulos e curvas a um caminho, você pode adicionar caminhos a um caminho. Isso permite que você combine caminhos existentes para formar caminhos grandes e complexos. O código a seguir adiciona graphicsPath1 e graphicsPath2 a myGraphicsPath. O segundo parâmetro do método GraphicsPath::AddPath especifica se o caminho adicionado está conectado ao caminho existente.

myGraphicsPath.AddPath(&graphicsPath1, FALSE);
myGraphicsPath.AddPath(&graphicsPath2, TRUE);

Há dois outros itens que você pode adicionar a um caminho: cadeias de caracteres e pizzas. Uma pizza é uma parte do interior de uma elipse. O exemplo a seguir cria um caminho de um arco, um spline cardinal, uma cadeia de caracteres e uma pizza.

myGraphicsPath.AddArc(0, 0, 30, 20, -90, 180);
myGraphicsPath.AddCurve(myPointArray, 3);
myGraphicsPath.AddString(L"a string in a path", 18, &myFontFamily, 
   0, 24, myPointF, &myStringFormat);
myGraphicsPath.AddPie(230, 10, 40, 40, 40, 110);
myGraphics.DrawPath(&myPen, &myGraphicsPath);

A ilustração a seguir mostra o caminho. Observe que um caminho não precisa ser conectado; o arco, o spline cardinal, a cadeia de caracteres e a pizza são separados.