Couleur#

Introduction #

Le capteur de couleur est un capteur optique qui permet à votre robot de détecter la présence d’un objet, de reconnaître des couleurs spécifiques et de renvoyer des données visuelles telles que la luminosité et la teinte.

Vous pouvez également régler la luminosité de la lumière interne du capteur. Ces outils sont idéaux pour les programmes qui doivent réagir en temps réel aux objets colorés, aux conditions d’éclairage ou aux données du capteur.

Cette page utilise color_1 comme exemple de nom de capteur de couleur. Remplacez-le par le nom que vous avez configuré, selon vos besoins.

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

Actions — Détecter les objets avec le capteur de couleur.

object_detected — Enregistre une fonction à appeler lorsqu’un objet est détecté.

Modificateurs — Modifient les voyants du capteur de couleur.

set_light — Met la LED du capteur de couleur allumée, éteinte ou à un niveau de luminosité défini.
set_light_power — Définit la luminosité de la LED du capteur de couleur.

Objets d’accès — Renvoient les données de l’objet via le capteur de couleur.

is_near_object — Renvoie si un objet se trouve à portée du capteur.
color — Renvoie le code hexadécimal de la couleur détectée.
brightness — Renvoie la luminosité détectée.
hue — Renvoie la valeur de teinte détectée.
installed — Indique si le capteur de couleur est connecté au cerveau.

Constructeurs — Initialisez et configurez manuellement un capteur de couleur.

ColorSensor — Crée un capteur de couleur.

Actes #

object_detected #

object_detected enregistre une fonction à appeler lorsque le capteur de couleur détecte un objet.

Usage:
color_1.object_detected(callback, args)

Paramètres	Description
`callback`	Une fonction qui est préalablement définie pour s’exécuter lorsque le capteur de couleur détecte un objet.
`args`	Facultatif. Un tuple contenant les arguments à transmettre à la fonction de rappel. Voir Fonctions avec paramètres pour plus d’informations.

Mutateurs #

set_light #

set_light active, désactive ou ajuste la luminosité de la LED du capteur de couleur à un niveau défini.

Usage:
color_1.set_light(value, units)

Paramètres	Description
`value`	Indique si la LED doit être allumée ou éteinte à l’aide de l’une des valeurs suivantes : `LedStateType.ON` — Régle la luminosité de la LED à 100 %. `LedStateType.OFF` — Régle la luminosité de la LED à 0 %. Il est également possible d’utiliser un pourcentage compris entre 0 et 100 pour régler la luminosité de la LED. La valeur 0 éteint la LED ; toute valeur supérieure à 0 l’allume à la luminosité correspondante.
`units`	Facultatif. L’unité qui représente la valeur de luminosité : `PERCENT`.

Paramètres

Description

value

Indique si la LED doit être allumée ou éteinte à l’aide de l’une des valeurs suivantes :

LedStateType.ON — Régle la luminosité de la LED à 100 %.
LedStateType.OFF — Régle la luminosité de la LED à 0 %.

Il est également possible d’utiliser un pourcentage compris entre 0 et 100 pour régler la luminosité de la LED. La valeur 0 éteint la LED ; toute valeur supérieure à 0 l’allume à la luminosité correspondante.

units

Facultatif. L’unité qui représente la valeur de luminosité : PERCENT.

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON)
    wait(0.5, SECONDS)
    color_1.set_light(LedStateType.OFF)
    wait(0.5, SECONDS)

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON, 75)
    wait(0.5, SECONDS)
    color_1.set_light(0)
    wait(0.5, SECONDS)

set_light_power #

set_light_power ajuste la luminosité de la LED du capteur de couleur. Si la LED n’est pas déjà allumée, cette méthode l’allumera également.

Usage:
color_1.set_light_power(value)

Paramètres	Description
`value`	La luminosité de la LED, exprimée en pourcentage, de 0 à 100. Une valeur de 0 éteint la LED.

# Turn the LED light on at different intensities
color_1.set_light_power(10)
wait(2, SECONDS)
color_1.set_light_power(100)

Getters #

is_near_object #

is_near_object is_near_object renvoie une valeur booléenne indiquant si le capteur de couleur se trouve à environ 57 millimètres (2,25 pouces) d’un objet. La détection dépendant de la lumière réfléchie, les surfaces sombres ou non réfléchissantes peuvent ne pas être détectées de manière fiable.

True — L’objet détecté se trouve à environ 57 millimètres.
False — L’objet détecté ne se trouve pas à moins de 57 millimètres environ.

Usage:
color_1.is_near_object()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

color #

La fonction color renvoie le code hexadécimal de la couleur détectée sous forme de chaîne de caractères au format « Couleur » suivi de deux zéros et de la valeur hexadécimale de la couleur.

Par exemple, la détection du rouge (#FF0000) renverrait « Couleur 00FF0000 ».

Usage:
color_1.color()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

# Display the currently detected hex value
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print(color_1.color())
    wait(0.5,SECONDS)

brightness #

La valeur brightness renvoie la luminosité de la couleur détectée, sous forme d’un entier compris entre 0 % et 100 %.

Un pourcentage plus élevé signifie que le capteur de couleur détecte plus de lumière. Un pourcentage plus faible signifie que le capteur de couleur détecte moins de lumière.

Usage:
color_1.brightness()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

# Display the currently detected brightness
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Brightness:")
    brain.screen.next_row()
    brain.screen.print(color_1.brightness())
    wait(0.5,SECONDS)

hue #

hue renvoie la valeur de teinte détectée sous forme de nombre flottant compris entre 0 et 359,99 degrés.

La teinte est une façon de décrire une couleur à l’aide de nombres sur un cercle chromatique, comme illustré ci-dessous.

Une roue chromatique circulaire affichant un spectre complet de teintes étiquetées avec des valeurs en degrés sur le périmètre, augmentant par incréments de 30 degrés de 0° en haut à 360°.

Usage:
color_1.hue()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

# Display the currently detected hue 
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Hue: ")
    brain.screen.print(color_1.hue())
    wait(0.5,SECONDS)

installed #

installed renvoie une valeur booléenne indiquant si le capteur de couleur est connecté au cerveau.

True — Le capteur de couleur est connecté au cerveau.
False — Le capteur de couleur n’est pas connecté au cerveau.

Usage:
color_1.installed()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

Constructeurs #

Les constructeurs sont utilisés pour créer manuellement ColorSensor , qui sont nécessaires pour configurer un capteur de couleur en dehors de VEXcode.

ColorSensor #

ColorSensor crée un capteur de couleur.

Usage:
color_1 = ColorSensor(smartport)

Paramètre	Description
`smartport`	Le port intelligent auquel le capteur de couleur est connecté est noté PORTx, où x représente le numéro du port.

# Create a Color Sensor object in Port 3
color_1 = ColorSensor(Ports.PORT3)