précédent | suivant | table des matières

Graphics2D

Graphics2D est une classe qui étend les possibilités de dessin de la classe Graphicsen 2 dimensions.

Le tutoriel de SUN. (démonstration)

Transformations

Les transformations possibles avec Graphics2D sont représentées par des instances de la classe AffineTransform :

• Transformations euclidiennes : conservent les distances et les angles
  • translation : static AffineTransform getTranslateInstance(double tx, double ty) 
  • rotation : static AffineTransform getRotateInstance(double theta) : rotation theta autour de l'origine et   static AffineTransform getRotateInstance(double theta, double x, double y) : rotation de theta autour du point x, y. L'angle est exprimé en radians.
• Homothéties : changement d’échelle par rapport à l'origine, en x et/ou y. static AffineTransform getScaleInstance(double sx, double sy) 
• Cisaillement : on étire suivant l'axe des x et/ou y. static AffineTransform getShearInstance(double shx, double shy) 

AffineTransform at;
at = AffineTransform.getTranslateInstance(depX, depY);
at.concatenate(AffineTransform.getRotateInstance(rotation));
at.concatenate(AffineTransform.getScaleInstance(scaleX, scaleY));
at.concatenate(AffineTransform.getShearInstance(shearX, shearY));
g2.transform(at);

La combinaison des différentes transformation crée une matrice (3×3) telle que les nouvelles coordonnées x' et y' sont obtenues à partir des anciennes x et y de la façon suivante :

Les différentes transformations sont représentées par les matrices :

Translation	Rotation
Homothétie	Cisaillement

La composition de plusieurs transformations se traduit par une multiplication de matrices.

Quelques méthodes de la classe AffineTransform :

void concatenate(AffineTransform tx)

AffineTransform createInverse() 

Shape createTransformedShape(Shape s)

double getDeterminant()

void getMatrix(double[] flatmatrix)

double getScaleX()

double getScaleY()

double getShearX()

double getShearY()

double getTranslateX()

double getTranslateY()

int getType()

void rotate(double theta)

void rotate(double theta, double x, double y)

void scale(double sx, double sy)

void shear(double shx, double shy)

void translate(double tx, double ty) 

void setToIdentity()

void setToRotation(double theta) 

void setToScale(double sx, double sy)

void setToShear(double shx, double shy)

void setToTranslation(double tx, double ty) 

Traits

La classe BasicStroke implémente les fonctionnalités de bases nécessaires au dessin d'un trait.

• La largeur du stylo qui tire le trait mesurée en pixels perpendiculairement au tracé.

terminaison du trait (end caps) : la décoration appliquée à la fin d'un trait ou d'un tiret.

• jointure de deux traits dans une forme (line joins) : la décoration appliquée à la jonction de deux traits. 

JOIN_BEVEL	JOIN_MITER	JOIN_ROUND

• miter limit : dans le cas d'une jonction JOIN_MITER, si la limite est dépassée, c'est à dire si la longueur du joint est plus grande que miter limit * width/2, on utilise un JOIN_BEVEL.
• attributs de pointillé qui indiquent comment est dessiné le pointillé. Les traits sont tirés en respectant les terminaisons et jointures définies précédemment.
  • dash array : contient un nombre pair de float qui indiquent alternativement la taille du trait, puis la taille de l'espace qui suit le trait.
  • dash phase : indique à partir d'où on commence pour tirer le trait en pointillé.

dash array {10, 10}, dash phase 0	dash array {10, 5, 5, 5}, dash phase 0	dash array {10, 5, 5, 5}, dash phase 7

Les constructeurs de BasicStroke sont :

BasicStroke()

BasicStroke(float largeur)

BasicStroke(float largeur, int cap, int join)

BasicStroke(float largeur, int cap, int join, 
            float miterLimit)

BasicStroke(float largeur, int cap, int join, 
            float miterLimit, float[] dashA, float dashP)

Remplissage

Les formes peuvent être remplies avec une couleur, un gradient de couleurs, ou une texture. La méthode setPaint(Paint p) de Graphics2D permet de configurer la façon dont vont être remplies les forme :

1. Color : les formes sont remplies avec une couleur uniforme.
2. GradientPaint : les formes sont remplies avec un gradient de couleurs, cyclique ou non.
3. TexturePaint : les formes sont remplies avec une texture.

Les constructeurs de GradientPaint sont :

GradientPaint(Point2D pt1, Color c1, Point2D pt2, Color c2)

GradientPaint(Point2D pt1, Color c1, Point2D pt2, Color c2,
              boolean cyclic)

GradientPaint(float x1, float y1, Color c1, 
              float x2, float y2, Color c2)

GradientPaint(float x1, float y1, Color c1, 
              float x2, float y2, Color c2, boolean cyclic)

Une texture est crée en répétant une image.

TexturePaint(BufferedImage img, Rectangle2D r)

Formes

Les formes de Graphics2D implémentent l'interface Shape. Une forme a les fonctionnalités suivantes :

boolean contains(double x, double y)

boolean contains( double x, double y,
	     double l,  double h)

boolean contains(Point2D p)

boolean contains( Rectangle2D r)

Rectangle getBounds()

Rectangle2D getBounds2D()

PathIterator getPathIterator(AffineTransform t)

PathIterator getPathIterator(AffineTransform t,
	     double f)

boolean instersects(double x, double y, 
	     double l, double h)

boolean instersects(Recrtangle2D r)

• Arc2D : permet de dessiner un arc, défini par un rectangle circonscrit, un angle de départ, un angle, et un type de fermeture : OPEN, CHORD, PIE . Les angles sont en °.
• Ellipse2D : permet de dessiner une ellipse définie par son rectangle circonscrit.
• Rectangle2D : permet de dessiner un rectangle. On peut ajouter des points, ou des rectangles à un rectangle : celui-ci est alors agrandi de façon à contenir le point ou le rectangle ajouté.
• RoundRectangle2D : permet de dessiner un recatngle aux coins arrondis.
• Area : est une classe qui permet de construire des formes géométrique à partir d'autres formes géométriques, par addition (union), soustraction, intersection, et ou exclusif.
• Line2D : permet de tracer une ligne. Des méthodes permettent de savoir si une ligne coupe une autre ligne, de connaître la distance d'un point P à une ligne (distance de P au point de la ligne qui est le plus près de P), de connaître la position d'un point par rapport à au segment, de connaître les points de départ et d'arrivée du segment.
• GeneralPath : un objet de cette classe est un ensemble de lignes droites, de courbes quadratiques,  de courbes cubiques,  et d'instances de GeneralPath.  L'intérieur de la forme est déterminé par : 
  • EVEN_ODD : les régions alternent entre intérieur et extérieur lorsqu'on va d'un point extérieur vers un point intérieur.
  • NON_ZERO : soit une demi-droite infinie partant du point P. Supposons un sens à la forme définie par le GeneralPath. Si le nombre d'intersections de la demi-droite avec la forme, de la gauche vers la droite est égal au nombre d'intersections de la demi-droite avec la forme de la gauche vers la droite, alors le point est à l'extérieur, sinon il est à l'intérieur.
• CubicCurve2D : dessine une courbe de Bézier de degré 3,  données par 4 points.
• QuadCurve2D : dessine une courbe de Bézier de degré 2,  données par 3 points.

Composition

Il y a 8 modes de composition de l'image  avec l'image déjà construite.  On crée un Composite à l'aide de la méthode de classe AlphaComposite : getInstance avec 2 paramètres :

• la règle : une des valeurs 
  • CLEAR : la source et la destination sont totalement transparentes.
  • SRC : la source est copié sur la destination qui n'est pas utilisée dans l'image obtenue.
  • SRC_ATOP : seule la partie qui recouvre la destination est affichée par dessus la destination.
  • SRC_IN : seule la partie qui recouvre la destination est affichée comme un SRC
  • SRC_OUT : seule la partie en dehors de la destination est affichée, la partie destination est "clearée".
  • SRC_OVER : la source est affichée par dessus la destination.
  • DST : la destination n'est pas modifiée.
  • DST_ATOP : la partie de la destination qui est dans la source est composée avec la source et remplace la destination.
  • DST_IN : la partie de la destination qui est dans la source remplace la source
  • DST_OUT : la partie de la destination qui n'est pas dans la source remplace la destination.
  • DST_OVER : la destination est affichée par dessus la source.
  • XOR : la source et la destination sont combinées par un XOR.
• la transparence : un float de 0 à 1.

Exemple :

g2.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER, 0.5F));

Rendu

La qualité du rendu des dessins peut être améliorée en invoquant la méthode setRenderingHint() du contexte graphique qui permet de paramétrer différentes options comme l'anti-crénelage, le rendu des couleurs, le dithering, ... L'antialiasing (ou anti-crénelage) a pour but d'atténuer les effets crénelés d'une image ou d'un texte grâce au lissage des pixels en bordure des zones contrastées (par interpolation des couleurs). On crée ainsi des zones de transition plus douces qui améliorent le rendu visuel du graphique.

Crénelé Lissé

Exemple : pour lisser les dessins et les texte on écrira :

g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON );
g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON);

Et pour laisser le crénelage :

g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_OFF );
g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_OFF );

haut de la page