Couleurs personnalisées#

Introduction#

Le robot de codage VEX AIM prend en charge l’utilisation de couleurs personnalisées pour le dessin, l’affichage et ses LED. Ces couleurs peuvent être créées à l’aide de valeurs RVB, de codes hexadécimaux ou de constantes prédéfinies. La fonctionnalité Couleurs personnalisées inclut des méthodes permettant de créer et de mettre à jour des objets couleur.

Vous trouverez ci-dessous la liste de toutes les méthodes :

Constructeurs – Créez un nouvel objet Color.

  • Color(value) – Accepte une constante prédéfinie, une chaîne hexadécimale ou un entier hexadécimal.

  • Color(r, g, b) – Crée une couleur en utilisant les valeurs rouge, verte et bleue.

Mutateurs – Mettre à jour un objet existant de couleur Color.

  • rgb – Met à jour une couleur en utilisant de nouvelles valeurs RGB.

  • hsv – Met à jour une couleur en utilisant la teinte, la saturation et la luminosité.

  • web – Met à jour une couleur en utilisant une chaîne de couleur hexadécimale web.

Création d’une couleur personnalisée#

Pour utiliser une couleur personnalisée, vous devez d’abord créer un objet Color en utilisant l’un des constructeurs suivants :

Hexadecimal Integer#

Crée une couleur à l’aide d’un entier hexadécimal à six chiffres.

Usage:
Color(value)

Paramètre

Description

value

Un entier à six chiffres au format hexadécimal (par exemple, 0xFFF700 pour jaune).

# Construct a yellow Color "yellow" using a
# hexadecimal value
yellow = Color(0xFFF700)

robot.screen.set_pen_color(yellow)
robot.screen.print("My Yellow")

RGB#

Crée une couleur à partir de valeurs distinctes de rouge, de vert et de bleu.

Usage:
Color(r, g, b)

Paramètre

Description

r

Un entier compris entre 0 et 255 représentant la composante rouge.

g

Un entier compris entre 0 et 255 représentant la composante verte.

b

Un entier compris entre 0 et 255 représentant la composante bleue.

# Construct a yellow Color "yellow" using
# RGB values
yellow = Color(255, 247, 0)

robot.screen.set_pen_color(yellow)
robot.screen.print("My Yellow")

Web Color#

Crée une couleur à partir d’une chaîne de couleurs web (code hexadécimal).

Usage:
Color(value)

Paramètre

Description

value

Une couleur web sous forme de chaîne (code hexadécimal) (par exemple, “#FFF700”).

# Construct a yellow Color "yellow" using a
# web string
yellow = Color("#FFF700")

robot.screen.set_pen_color(yellow)
robot.screen.print("My Yellow")

Predefined Color#

Crée une couleur à l’aide d’une constante prédéfinie Color.

Usage:
Color(value)

Paramètre

Description

value

Constante de couleur intégrée :

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
# Construct a yellow Color "yellow" using a
# predefined Color constant
yellow = Color(YELLOW)

robot.screen.set_pen_color(yellow)
robot.screen.print("My Yellow")

Mutateurs#

Ces méthodes mettent à jour la couleur d’un objet Color existant. Pour les utiliser, assignez une couleur Color à une variable lors de sa création, puis appelez la méthode sur cette variable pour modifier sa couleur.

rgb#

rgb met à jour la couleur d’un objet Color existant en utilisant les valeurs RGB.

Usage:
variable_name.rgb(r, g, b)

Paramètres

Description

r

Un entier compris entre 0 et 255 représentant la composante rouge de la couleur.

g

Un entier compris entre 0 et 255 représentant la composante verte de la couleur.

b

Un entier compris entre 0 et 255 représentant la composante bleue de la couleur.

# Create a custom teal color and set it as the pen color
robot_color = Color(50, 200, 180)
robot.screen.set_pen_color(robot_color)

# Draw a rectangle with the teal outline
robot.screen.draw_rectangle(30, 70, 80, 50)

# Draw another rectangle with a magenta outline
robot_color.rgb(170, 40, 150)
robot.screen.set_pen_color(robot_color)
robot.screen.draw_rectangle(130, 70, 80, 50)

hsv#

hsv met à jour la couleur d’un objet Color existant en utilisant les valeurs HSV.

Remarque : hsv ne peut être utilisé que pour modifier un objet Color déjà créé. Il ne peut pas être utilisé pour créer un nouvel objet Color.

Usage:
variable_name.hsv(h, s, v)

Paramètres

Description

h

Un entier compris entre 0 et 359 représentant la teinte de la couleur.

s

Un nombre flottant compris entre 0,0 et 1,0 représentant la saturation de la couleur.

v

Un nombre flottant compris entre 0,0 et 1,0 représentant la luminosité de la couleur.

# Create a custom teal color using RGB (HSV can't be used)
robot_color = Color(50, 200, 180)
robot.screen.set_pen_color(robot_color)

# Draw a rectangle with the teal outline
robot.screen.draw_rectangle(30, 70, 80, 50)

# Draw another rectangle with a magenta outline
robot_color.hsv(300, 0.75, 0.78)
robot.screen.set_pen_color(robot_color)
robot.screen.draw_rectangle(130, 70, 80, 50)

web#

web met à jour la couleur d’un objet Color existant en utilisant une couleur web (code hexadécimal).

Usage:
variable_name.web(value)

Paramètres

Description

value

Une couleur web sous forme de chaîne (code hexadécimal) (par exemple, “#FFF700”).

# Create a custom teal color and set it as the pen color
robot_color = Color("#32C8B6")
robot.screen.set_pen_color(robot_color)

# Draw a rectangle with the teal outline
robot.screen.draw_rectangle(30, 70, 80, 50)

# Draw another rectangle with the new magenta outline
robot_color.web("#AA2896")
robot.screen.set_pen_color(robot_color)
robot.screen.draw_rectangle(130, 70, 80, 50)