Capteur optique#

Introduction #

Le capteur optique V5 détecte la couleur, la luminosité et la présence des objets environnants grâce à la combinaison d’un capteur de couleur RVB et d’un capteur de proximité. Il peut également utiliser sa LED intégrée pour éclairer les objets et ainsi améliorer la précision de la détection.

Le capteur optique VEX V5.

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

Vous trouverez ci-dessous une liste des méthodes disponibles :

set_light – Allume ou éteint la LED du capteur optique.
set_light_power – Définit le niveau de puissance lumineuse du capteur optique.
is_near_object – Renvoie si le capteur optique détecte un objet à portée.
color – Renvoie la couleur détectée par le capteur optique.
brightness – Renvoie la quantité de lumière réfléchie par l’objet.
hue – Renvoie la teinte détectée par le capteur optique.
object_detected – Enregistre une fonction à appeler lorsque le capteur optique détecte un objet.
object_lost – Enregistre une fonction à appeler lorsque le capteur optique perd un objet.

Constructeur – Initialiser manuellement un capteur optique.

Optical – Crée un capteur optique.

allumer #

La commande set_light active ou désactive la LED du capteur optique. Cela peut contribuer à améliorer la précision du capteur lors de la détection des couleurs.

Usage:
optical_sensor.set_light(state)

Paramètres	Description
État	Permet d’allumer ou d’éteindre la LED. `LEDStateType.ON` allume la lumière à 100 % luminosité. `LEDStateType.OFF` l’éteint.

# Turn on the sensor's LED
optical_sensor.set_light(LEDStateType.ON)

régler_la_puissance_de_l’éclairage #

set_light_power ajuste la luminosité de la LED du capteur optique. Cette lumière permet au capteur optique de détecter plus clairement les objets et les couleurs.

Si la lumière du capteur optique est éteinte, régler la puissance de la lumière au-dessus de 0 % l’allumera.

Si le voyant du capteur optique est allumé, régler la puissance de l’éclairage à 0 % éteindra la lumière.

Un pourcentage plus élevé rend la lumière plus intense. Un pourcentage plus faible rend la lumière plus faible.

Usage:
optical_sensor.set_light_power(percent, units)

Paramètres	Description
pour cent	La luminosité à régler pour la LED, exprimée en nombre entier.
unités	Facultatif. Unité de luminosité : `PERCENT`

# Turn on the sensor's light at half brightness
optical_sensor.set_light_power(50, PERCENT)

est_proche_objet #

is_near_object renvoie une valeur booléenne indiquant si le capteur optique détecte ou non un objet à portée.

True – Le capteur optique détecte un objet.
False – Le capteur optique ne détecte aucun objet.

Usage:
optical_sensor.is_near_object()

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

# Drive forward until an object is found
drivetrain.drive(FORWARD)
while not optical_sensor.is_near_object():
  pass
drivetrain.stop()

couleur #

La fonction color renvoie une instance d’une Color class, basée sur la valeur de teinte détectée. Ces instances peuvent être comparées à des objets Color prédéfinis pour créer des instructions conditionnelles.

Les couleurs possibles sont :

Color.BLACK
Color.WHITE
Color.RED - Une valeur de teinte comprise entre 340° et 20°
Color.GREEN - Une valeur de teinte comprise entre 80° et 140°
Color.BLUE - Une valeur de teinte comprise entre 200° et 240°
Color.YELLOW - Une valeur de teinte comprise entre 40° et 60°
Color.ORANGE - Une valeur de teinte comprise entre 20° et 40°
Color.PURPLE - Une valeur de teinte comprise entre 240° et 280°
Color.CYAN - Une valeur de teinte comprise entre 140° et 200°

Remarque : Le capteur optique recherche des plages de teintes correspondant à la couleur spécifiée. Pour détecter des plages de teintes spécifiques, voir hue.

Usage:
optical_sensor.color()

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

# Drive forward until red is found
drivetrain.drive(FORWARD)
while not optical_sensor.color() == Color.RED:
  pass
drivetrain.stop()

luminosité #

brightness renvoie la quantité de lumière réfléchie par l’objet sous forme décimale (float) représentant un pourcentage.

Un pourcentage plus élevé signifie qu’une plus grande quantité de lumière est réfléchie vers le capteur optique. Un pourcentage plus faible signifie qu’une moindre quantité de lumière est réfléchie.

Usage:
optical_sensor.brightness()

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

teinte #

hue renvoie la valeur de teinte de la couleur détectée sous forme décimale (float) de 0 à 359.

La teinte est une façon de décrire une couleur à l’aide de nombres sur un cercle chromatique.

La roue chromatique VEX montrant les degrés de couleur autour d'un cercle, le rouge étant à 0 degré et passant par l'arc-en-ciel à mesure que la valeur augmente.

Usage: optical_sensor.hue()

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

# Look for the color pink using hue
while True:
  brain.screen.clear_screen()
  brain.screen.set_cursor(1, 1)

  if 300 < optical_sensor.hue() < 359:
    brain.screen.print("This is pink!")
  else:
    brain.screen.print("No pink detected!")

objet_détecté #

object_detected enregistre une fonction à appeler chaque fois que le capteur optique détecte un nouvel objet.

Usage:
optical_sensor.object_detected(callback, arg)

Paramètres	Description
`callback`	Une fonction précédemment définie qui s’exécute lorsque le capteur optique détecte un nouvel objet.
`arg`	Facultatif. Un tuple contenant les arguments à transmettre à la fonction de rappel. Voir Utilisation des fonctions avec paramètres pour plus d’informations.

def my_function():
  brain.screen.print("Optical Sensor detected an object")

# Call my_function whenever optical_sensor detects an object
optical_sensor.object_detected(my_function)

objet_perdu #

object_lost enregistre une fonction à appeler chaque fois que le capteur optique perd un objet détecté.

Usage:
optical_sensor.object_lost(callback, arg)

Paramètres	Description
`callback`	Une fonction définie précédemment qui s’exécute lorsque le capteur optique perd un objet détecté.
`arg`	Facultatif. Un tuple contenant les arguments à transmettre à la fonction de rappel. Voir Utilisation des fonctions avec paramètres pour plus d’informations.

def my_function():
  brain.screen.print("Optical Sensor lost an object")

# Call my_function whenever optical_sensor loses an object
optical_sensor.object_lost(my_function)

Constructeur #

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

Optical #

Optical crée un capteur optique.

Usage:
Optical(smartport)

Paramètre	Description
`smartport`	Le port intelligent auquel le capteur optique est connecté est indiqué sous la forme `Ports.PORTx` , où x représente le numéro du port.

# Create an Optical Sensor in Port 10
optical_sensor = Optical(Ports.PORT10)