Tracé des arcs et des cercles

Avec Cairo, on utilise la même fonction pour tracer des arcs, des cercles ou des ellipses : Cairo::Context::arc(). Cette fonction prend cinq paramètres. Les deux premiers sont les coordonnées du centre de l'arc, le troisième est le rayon et les deux derniers définissent l'angle de début et l'angle de fin de l'arc. Tous les angles sont définis en radians ; ainsi, tracer un cercle est identique au fait de tracer un arc de 0 à 2π radians. L'angle 0 est dans le sens positif des X (dans l'espace utilisateur). L'angle de π/2 radians (90 degrés) est dans le sens positif des Y (dans l'espace utilisateur). Les angles vont croissant en allant de l'axe des X vers l'axe des Y. Ainsi, avec la matrice de transformation par défaut, les angles croissent en tournant dans le sens des aiguilles d'une montre.

Pour tracer une ellipse, vous graduez la matrice de transformation de façon différente dans le sens des X et dans le sens des Y. Par exemple, pour tracer une ellipse dans la boîte définie par x, y, width, height : 

context->save();
context->translate(x, y);
context->scale(width / 2.0, height / 2.0);
context->arc(0.0, 0.0, 1.0, 0.0, 2 * M_PI);
context->restore();
Notez que ceci est en contradiction avec la directive de la documentation officielle Cairo, mais cela semble fonctionner correctement.

XVII.IV.I. Exemple

Voici un exemple de programme simple traçant un arc, un cercle et une ellipse sur une zone de dessin.

Figure XVII.4 Zone de dessin ‑ Arcs

Code source

File: myarea.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLE_MYAREA_H
#define GTKMM_EXAMPLE_MYAREA_H

#include <gtkmm/drawingarea.h>

class MyArea : public Gtk::DrawingArea
{
public:
  MyArea();
  virtual ~MyArea();

protected:
  //Override default signal handler:
  virtual bool on_draw(const Cairo::RefPtr<Cairo::Context>& cr);
};

#endif // GTKMM_EXAMPLE_MYAREA_H

File: myarea.cc (For use with gtkmm 3, not gtkmm 2) 

#include "myarea.h"
#include <cairomm/context.h>
#include <cmath>

MyArea::MyArea()
{
}

MyArea::~MyArea()
{
}

bool MyArea::on_draw(const Cairo::RefPtr<Cairo::Context>& cr)
{
  // This is where we draw on the window
  Gtk::Allocation allocation = get_allocation();
  const int width = allocation.get_width();
  const int height = allocation.get_height();
  const int lesser = MIN(width, height);

  // coordinates for the center of the window
  int xc, yc;
  xc = width / 2;
  yc = height / 2;

  cr->set_line_width(lesser * 0.02);  // outline thickness changes
                                      // with window size

  // first draw a simple unclosed arc
  cr->save();
  cr->arc(width / 3.0, height / 4.0, lesser / 4.0, -(M_PI / 5.0), M_PI);
  cr->close_path();   // line back to start point
  cr->set_source_rgb(0.0, 0.8, 0.0);
  cr->fill_preserve();
  cr->restore();  // back to opaque black
  cr->stroke();   // outline it

  // now draw a circle
  cr->save();
  cr->arc(xc, yc, lesser / 4.0, 0.0, 2.0 * M_PI); // full circle
  cr->set_source_rgba(0.0, 0.0, 0.8, 0.6);    // partially translucent
  cr->fill_preserve();
  cr->restore();  // back to opaque black
  cr->stroke();

  // and finally an ellipse
  double ex, ey, ew, eh;
  // center of ellipse
  ex = xc;
  ey = 3.0 * height / 4.0;
  // ellipse dimensions
  ew = 3.0 * width / 4.0;
  eh = height / 3.0;

  cr->save();

  cr->translate(ex, ey);  // make (ex, ey) == (0, 0)
  cr->scale(ew / 2.0, eh / 2.0);  // for width: ew / 2.0 == 1.0
                                  // for height: eh / 2.0 == 1.0

  cr->arc(0.0, 0.0, 1.0, 0.0, 2 * M_PI);  // 'circle' centered at (0, 0)
                                          // with 'radius' of 1.0

  cr->set_source_rgba(0.8, 0.0, 0.0, 0.7);
  cr->fill_preserve();
  cr->restore();  // back to opaque black
  cr->stroke();

  return true;
}

File: main.cc (For use with gtkmm 3, not gtkmm 2) 

#include "myarea.h"
#include <gtkmm/main.h>
#include <gtkmm/window.h>

int main(int argc, char** argv)
{
   Gtk::Main kit(argc, argv);

   Gtk::Window win;
   win.set_title("DrawingArea");

   MyArea area;
   win.add(area);
   area.show();

   Gtk::Main::run(win);

   return 0;
}

Il y a deux choses à noter concernant cet exemple de code. À nouveau, la seule différence entre cet exemple et les précédents se situe dans la fonction on_expose_event() ; nous limitons donc nos remarques à cette fonction. En outre, la première partie de la fonction est pratiquement identique aux exemples précédents, nous ne la commentons donc pas.

Notez que dans ce cas, nous avons pratiquement tout exprimé en termes de hauteur et de largeur de la fenêtre, y compris la largeur des lignes. En raison de cela, quand vous redimensionnez la fenêtre, tous les objets se mettent à l'échelle. Également, il y a trois parties concernant les tracés dans la fonction et chacune est entourée avec une paire save()/restore() pour revenir à un état bien défini après chaque tracé.

La partie concernant le tracé de l'arc comporte une nouvelle fonction : close_path(). Cette fonction a pour effet de provoquer le tracé d'une droite entre le point de fin et de début du tracé. Il y a toutefois une différence significative entre l'appel de close_path() et le tracé à la main d'une ligne jusqu'au point de départ. Si vous utilisez close_path(), les lignes seront proprement jointes. Si vous utilisez line_to() à la place, les lignes se rejoindront, mais Cairo ne fera rien de spécial pour les joindre.

Tracé en sens inverse des aiguilles d'une montre

La fonction Cairo::Context::arc_negative() est identique à Cairo::Context::arc() mais les angles tournent dans le sens opposé.

Tracé de courbes Tracé de textes

À propos