---
name: "MLV_shape.h"
section: "3"
platform: "linux"
package: "libmlv3-dev"
version: "3.1.0-8"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/MLV_shape.h"
---

# MLV\_shape.h(3)

Ce fichier définit tout les prototypes des fonctions permettant de dessiner des figures.

## NAME

MLV\_shape.h - Ce fichier définit tout les prototypes des fonctions permettant de dessiner des figures.

## SYNOPSIS

### Fonctions

void **MLV\_draw\_circle** (int x, int y, int radius, **MLV\_Color** color)\
 Dessine un cercle à une position et un rayon spécifiés en paramètres.  void **MLV\_draw\_filled\_circle** (int x, int y, int radius, **MLV\_Color** color)\
 Dessine un disque plein dont le centre et le rayon sont passés en paramètres.  void **MLV\_draw\_ellipse** (int x, int y, int radius\_x, int radius\_y, **MLV\_Color** color)\
 Dessine une ellipse.  void **MLV\_draw\_filled\_ellipse** (int x, int y, int radius\_x, int radius\_y, **MLV\_Color** color)\
 Dessine une ellipse pleine.  void **MLV\_draw\_polygon** (const int \*vx, const int \*vy, int nb\_points, **MLV\_Color** color)\
 Dessine un polygone à partir d'une liste de sommets.  void **MLV\_draw\_triangle** (int ax, int ay, int bx, int by, int cx, int cy, **MLV\_Color** color)\
 Dessine un triangle (vide).  void **MLV\_draw\_filled\_polygon** (const int \*vx, const int \*vy, int nb\_points, **MLV\_Color** color)\
 Dessine un polygone plein à partir d'une liste de sommets.  void **MLV\_draw\_filled\_triangle** (int ax, int ay, int bx, int by, int cx, int cy, **MLV\_Color** color)\
 Dessine un triangle plein.  void **MLV\_draw\_bezier\_curve** (const int \*vx, const int \*vy, int nb\_points, **MLV\_Color** color)\
 Dessine une courbe de Bézier à partir d'une liste de sommets.  void **MLV\_draw\_rectangle** (int x, int y, int width, int height, **MLV\_Color** color)\
 Dessine un rectangle dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres.  void **MLV\_draw\_filled\_rectangle** (int x, int y, int width, int height, **MLV\_Color** color)\
 Dessine un rectangle plein dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres.  void **MLV\_draw\_line** (int x1, int y1, int x2, int y2, **MLV\_Color** color)\
 Dessine une ligne.  void **MLV\_draw\_pixel** (int x, int y, **MLV\_Color** color)\
 Dessine un pixel dont les coordonnées sont passées en paramètres.  void **MLV\_draw\_point** (int x, int y, **MLV\_Color** color)\
 Dessine un point dont les coordonnées sont passées en paramètres. Cette fonction est identique à MLV\_draw\_pixel.  void **MLV\_draw\_circle\_on\_image** (int x, int y, int radius, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un cercle à une position et un rayon spécifiés en paramètres dans une image.  void **MLV\_draw\_filled\_circle\_on\_image** (int x, int y, int radius, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un disque plein dont le centre et le rayon sont passés en parametres dans une image.  void **MLV\_draw\_ellipse\_on\_image** (int x, int y, int radius\_x, int radius\_y, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine une ellipse dans une image.  void **MLV\_draw\_filled\_ellipse\_on\_image** (int x, int y, int radius\_x, int radius\_y, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine une ellipse pleine dans une image.  void **MLV\_draw\_polygon\_on\_image** (const int \*vx, const int \*vy, int nb\_points, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un polygone à partir d'une liste de sommets dans une image.  void **MLV\_draw\_triangle\_on\_image** (int ax, int ay, int bx, int by, int cx, int cy, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un triangle (vide) sur une image passée en paramètre.  void **MLV\_draw\_filled\_polygon\_on\_image** (const int \*vx, const int \*vy, int nb\_points, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un polygone plein à partir d'une liste de sommets dans une image.  void **MLV\_draw\_filled\_triangle\_on\_image** (int ax, int ay, int bx, int by, int cx, int cy, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un triangle plein sur une image passée en paramètre.  void **MLV\_draw\_bezier\_curve\_on\_image** (const int \*vx, const int \*vy, int nb\_points, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine une courbe de Bézier à partir d'une liste de sommets dans une image.  void **MLV\_draw\_rectangle\_on\_image** (int x, int y, int width, int height, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un rectangle dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres dans une image.  void **MLV\_draw\_filled\_rectangle\_on\_image** (int x, int y, int width, int height, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un rectangle plein dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres dans une image.  void **MLV\_draw\_line\_on\_image** (int x1, int y1, int x2, int y2, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine une ligne dans une image.  void **MLV\_draw\_pixel\_on\_image** (int x, int y, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un pixel dont les coordonnées sont passées en paramètres dans une image.  void **MLV\_draw\_point\_on\_image** (int x, int y, **MLV\_Color** color, **MLV\_Image** \*image)\
 Dessine un point dont les coordonnées sont passées en paramètres. Cette fonction est identique à MLV\_draw\_pixel dans une image.

## Description détaillée

Ce fichier définit tout les prototypes des fonctions permettant de dessiner des figures.

**Auteur**

Adrien Boussicault

Marc Zipstein

## Documentation des fonctions

### void MLV\_draw\_bezier\_curve (const int \* vx, const int \* vy, int nb\_points, MLV\_Color color)

Dessine une courbe de Bézier à partir d'une liste de sommets.

**Paramètres**

*vx* La liste des coordonnées en X des différents sommets de la courbe. \
 *vy* La liste des coordonnées en Y des différents sommets de la courbe. \
 *nb\_points* Le nombre de sommets disponibles pour dessiner la courbe de Bézier. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_bezier\_curve\_on\_image (const int \* vx, const int \* vy, int nb\_points, MLV\_Color color, MLV\_Image \* image)

Dessine une courbe de Bézier à partir d'une liste de sommets dans une image.

**Paramètres**

*vx* La liste des coordonnées en X des différents sommets de la courbe. \
 *vy* La liste des coordonnées en Y des différents sommets de la courbe. \
 *nb\_points* Le nombre de sommets disponibles pour dessiner la courbe de Bézier. \
 *color* La couleur du tracé. \
 *image* image dans laquelle la figure est dessinée

### void MLV\_draw\_circle (int x, int y, int radius, MLV\_Color color)

Dessine un cercle à une position et un rayon spécifiés en paramètres.

**Paramètres**

*x* La coordonnée en X du centre. \
 *y* La coordonnée en Y du centre. \
 *radius* Le rayon du cercle. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**, et **beginner/05\_mouse.c**.

### void MLV\_draw\_circle\_on\_image (int x, int y, int radius, MLV\_Color color, MLV\_Image \* image)

Dessine un cercle à une position et un rayon spécifiés en paramètres dans une image.

**Paramètres**

*x* La coordonnée en X du centre. \
 *y* La coordonnée en Y du centre. \
 *radius* Le rayon du cercle. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_ellipse (int x, int y, int radius\_x, int radius\_y, MLV\_Color color)

Dessine une ellipse.

**Paramètres**

*x* La coordonnée en X du centre de l'ellipse. \
 *y* La coordonnée en Y du centre de l'ellipse. \
 *radius\_x* Le rayon en X de l'ellipse. \
 *radius\_y* Le rayon en Y de l'ellipse. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_ellipse\_on\_image (int x, int y, int radius\_x, int radius\_y, MLV\_Color color, MLV\_Image \* image)

Dessine une ellipse dans une image.

**Paramètres**

*x* La coordonnée en X du centre de l'ellipse. \
 *y* La coordonnée en Y du centre de l'ellipse. \
 *radius\_x* Le rayon en X de l'ellipse. \
 *radius\_y* Le rayon en Y de l'ellipse. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_filled\_circle (int x, int y, int radius, MLV\_Color color)

Dessine un disque plein dont le centre et le rayon sont passés en paramètres.

**Paramètres**

*x* La coordonnée en X du centre. \
 *y* La coordonnée en Y du centre. \
 *radius* Le rayon du cercle. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_filled\_circle\_on\_image (int x, int y, int radius, MLV\_Color color, MLV\_Image \* image)

Dessine un disque plein dont le centre et le rayon sont passés en parametres dans une image.

**Paramètres**

*x* La coordonnée en X du centre. \
 *y* La coordonnée en Y du centre. \
 *radius* Le rayon du cercle. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_filled\_ellipse (int x, int y, int radius\_x, int radius\_y, MLV\_Color color)

Dessine une ellipse pleine.

**Paramètres**

*x* La coordonnée en X du centre de l'ellipse. \
 *y* La coordonnée en Y du centre de l'ellipse. \
 *radius\_x* Le rayon en X de l'ellipse. \
 *radius\_y* Le rayon en Y de l'ellipse. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_filled\_ellipse\_on\_image (int x, int y, int radius\_x, int radius\_y, MLV\_Color color, MLV\_Image \* image)

Dessine une ellipse pleine dans une image.

**Paramètres**

*x* La coordonnée en X du centre de l'ellipse. \
 *y* La coordonnée en Y du centre de l'ellipse. \
 *radius\_x* Le rayon en X de l'ellipse. \
 *radius\_y* Le rayon en Y de l'ellipse. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_filled\_polygon (const int \* vx, const int \* vy, int nb\_points, MLV\_Color color)

Dessine un polygone plein à partir d'une liste de sommets.

**Paramètres**

*vx* La liste des coordonnées en X des différents sommets du polygone. \
 *vy* La liste des coordonnées en Y des différents sommets du polygone. \
 *nb\_points* Le nombre de sommets du polygone. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_filled\_polygon\_on\_image (const int \* vx, const int \* vy, int nb\_points, MLV\_Color color, MLV\_Image \* image)

Dessine un polygone plein à partir d'une liste de sommets dans une image.

**Paramètres**

*vx* La liste des coordonnées en X des différents sommets du polygone. \
 *vy* La liste des coordonnées en Y des différents sommets du polygone. \
 *nb\_points* Le nombre de sommets du polygone. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.\
 *vx* La liste des coordonnées en X des différents sommets du polygone. \
 *vy* La liste des coordonnées en Y des différents sommets du polygone. \
 *nb\_points* Le nombre de sommets du polygone. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée

### void MLV\_draw\_filled\_rectangle (int x, int y, int width, int height, MLV\_Color color)

Dessine un rectangle plein dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres.

**Paramètres**

*x* La coordonnée en X du sommet Nord-Ouest du rectangle. \
 *y* La coordonnée en Y du sommet Nord-Ouest du rectangle. \
 *width* La largeur du rectangle. \
 *height* La hauteur du rectangle. \
 *color* La couleur du tracé.

**Exemples** **advanced/09\_animation.c**, **beginner/02\_shapes.c**, **beginner/09\_colors.c**, **medium/06\_colors.c**, et **medium/09\_keyboard\_accents.c**.

### void MLV\_draw\_filled\_rectangle\_on\_image (int x, int y, int width, int height, MLV\_Color color, MLV\_Image \* image)

Dessine un rectangle plein dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres dans une image.

**Paramètres**

*x* La coordonnée en X du sommet Nord-Ouest du rectangle. \
 *y* La coordonnée en Y du sommet Nord-Ouest du rectangle. \
 *width* La largeur du rectangle. \
 *height* La hauteur du rectangle. \
 *color* La couleur du rectangle. \
 *image* L'image dans laquelle la figure est dessinée.

**Exemples** **advanced/08\_zone\_click.c**.

### void MLV\_draw\_filled\_triangle (int ax, int ay, int bx, int by, int cx, int cy, MLV\_Color color)

Dessine un triangle plein.

**Paramètres**

*ax* La coordonnée en X du premier point du triangle. \
 *ay* La coordonnée en Y dy premier point du traingle. \
 *bx* La coordonnée en X du deuxième point du triangle. \
 *by* La coordonnée en Y dy deuxième point du traingle. \
 *cx* La coordonnée en X du troisième point du triangle. \
 *cy* La coordonnée en Y dy troisième point du traingle. \
 *color* La couleur du triangle.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_filled\_triangle\_on\_image (int ax, int ay, int bx, int by, int cx, int cy, MLV\_Color color, MLV\_Image \* image)

Dessine un triangle plein sur une image passée en paramètre.

**Paramètres**

*ax* La coordonnée en X du premier point du triangle. \
 *ay* La coordonnée en Y dy premier point du traingle. \
 *bx* La coordonnée en X du deuxième point du triangle. \
 *by* La coordonnée en Y dy deuxième point du traingle. \
 *cx* La coordonnée en X du troisième point du triangle. \
 *cy* La coordonnée en Y dy troisième point du traingle. \
 *color* La couleur du triangle. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_line (int x1, int y1, int x2, int y2, MLV\_Color color)

Dessine une ligne.

**Paramètres**

*x1* La coordonnée en X de la première extrémité de la ligne. \
 *y1* La coordonnée en Y de la première extrémité de la ligne. \
 *x2* La coordonnée en X de la deuxième extrémité de la ligne. \
 *y2* La coordonnée en Y de la deuxième extrémité de la ligne. \
 *color* La couleur du tracé.

**Exemples** **advanced/01\_texts\_and\_boxes.c**, **beginner/02\_shapes.c**, et **medium/06\_colors.c**.

### void MLV\_draw\_line\_on\_image (int x1, int y1, int x2, int y2, MLV\_Color color, MLV\_Image \* image)

Dessine une ligne dans une image.

**Paramètres**

*x1* La coordonnée en X de la première extrémité de la ligne. \
 *y1* La coordonnée en Y de la première extrémité de la ligne. \
 *x2* La coordonnée en X de la deuxième extrémité de la ligne. \
 *y2* La coordonnée en Y de la deuxième extrémité de la ligne. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_pixel (int x, int y, MLV\_Color color)

Dessine un pixel dont les coordonnées sont passées en paramètres.

**Paramètres**

*x* La coordonnée en X du pixel. \
 *y* La coordonnée en Y du pixel. \
 *color* La couleur du tracé.

### void MLV\_draw\_pixel\_on\_image (int x, int y, MLV\_Color color, MLV\_Image \* image)

Dessine un pixel dont les coordonnées sont passées en paramètres dans une image.

**Paramètres**

*x* Coordonnée en X du pixel \
 *y* Coordonnée en Y du pixel \
 *color* Couleur du tracé \
 *image* image dans laquelle la figure est dessinée

### void MLV\_draw\_point (int x, int y, MLV\_Color color)

Dessine un point dont les coordonnées sont passées en paramètres. Cette fonction est identique à MLV\_draw\_pixel.

**Paramètres**

*x* La coordonnée en X du point. \
 *y* La coordonnée en Y du point. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**, et **medium/06\_colors.c**.

### void MLV\_draw\_point\_on\_image (int x, int y, MLV\_Color color, MLV\_Image \* image)

Dessine un point dont les coordonnées sont passées en paramètres. Cette fonction est identique à MLV\_draw\_pixel dans une image.

**Paramètres**

*x* La coordonnée en X du point. \
 *y* La coordonnée en Y du point. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_polygon (const int \* vx, const int \* vy, int nb\_points, MLV\_Color color)

Dessine un polygone à partir d'une liste de sommets.

**Paramètres**

*vx* La liste des coordonnées en X des différents sommets du polygone. \
 *vy* La liste des coordonnées en Y des différents sommets du polygone. \
 *nb\_points* Le nombre de sommets du polygone. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_polygon\_on\_image (const int \* vx, const int \* vy, int nb\_points, MLV\_Color color, MLV\_Image \* image)

Dessine un polygone à partir d'une liste de sommets dans une image.

**Paramètres**

*vx* La liste des coordonnées en X des différents sommets du polygone. \
 *vy* La liste des coordonnées en Y des différents sommets du polygone. \
 *nb\_points* Le nombre de sommets du polygone. \
 *color* La couleur du tracé. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_rectangle (int x, int y, int width, int height, MLV\_Color color)

Dessine un rectangle dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres.

**Paramètres**

*x* La coordonnée en X du sommet Nord-Ouest du rectangle. \
 *y* La coordonnée en Y du sommet Nord-Ouest du rectangle. \
 *width* La largeur du rectangle. \
 *height* La hauteur du rectangle. \
 *color* La couleur du tracé.

**Exemples** **beginner/02\_shapes.c**, et **medium/08\_full\_screen.c**.

### void MLV\_draw\_rectangle\_on\_image (int x, int y, int width, int height, MLV\_Color color, MLV\_Image \* image)

Dessine un rectangle dont la taille, la couleur et la position du sommet Nord-Ouest sont données en paramètres dans une image.

**Paramètres**

*x* La coordonnée en X du sommet Nord-Ouest du rectangle. \
 *y* La coordonnée en Y du sommet Nord-Ouest du rectangle. \
 *width* La largeur du rectangle. \
 *height* La hauteur du rectangle. \
 *color* La couleur du rectangle. \
 *image* L'image dans laquelle la figure est dessinée .\
 *x* La coordonnée en X du sommet Nord-Ouest du rectangle. \
 *y* La coordonnée en Y du sommet Nord-Ouest du rectangle. \
 *width* La largeur du rectangle. \
 *height* La hauteur du rectangle. \
 *color* La couleur du rectangle. \
 *image* L'image dans laquelle la figure est dessinée.

### void MLV\_draw\_triangle (int ax, int ay, int bx, int by, int cx, int cy, MLV\_Color color)

Dessine un triangle (vide).

**Paramètres**

*ax* La coordonnée en X du premier point du triangle. \
 *ay* La coordonnée en Y dy premier point du traingle. \
 *bx* La coordonnée en X du deuxième point du triangle. \
 *by* La coordonnée en Y dy deuxième point du traingle. \
 *cx* La coordonnée en X du troisième point du triangle. \
 *cy* La coordonnée en Y dy troisième point du traingle. \
 *color* La couleur du triangle.

**Exemples** **beginner/02\_shapes.c**.

### void MLV\_draw\_triangle\_on\_image (int ax, int ay, int bx, int by, int cx, int cy, MLV\_Color color, MLV\_Image \* image)

Dessine un triangle (vide) sur une image passée en paramètre.

**Paramètres**

*ax* La coordonnée en X du premier point du triangle. \
 *ay* La coordonnée en Y dy premier point du traingle. \
 *bx* La coordonnée en X du deuxième point du triangle. \
 *by* La coordonnée en Y dy deuxième point du traingle. \
 *cx* La coordonnée en X du troisième point du triangle. \
 *cy* La coordonnée en Y dy troisième point du traingle. \
 *color* La couleur du triangle. \
 *image* L'image dans laquelle la figure est dessinée.

## Auteur

Généré automatiquement par Doxygen pour MLV-3.1.0 à partir du code source.
