Sensor de color#

Introducción#

El sensor de color es un sensor óptico que detecta colores de superficies, mide los niveles de luz y detecta objetos cercanos. Incorpora un LED para iluminar las superficies y lograr una detección más precisa.

A continuación se muestra una lista de todos los métodos:

Métodos

Métodos: Detecta color, niveles de luz, objetos cercanos y controla el LED incorporado.

  • hue – Devuelve el valor de tono detectado como un flotante de 0 a 359,99 grados.

  • brillo – Devuelve el brillo detectado como un porcentaje.

  • color – Devuelve el código hexadecimal del color detectado como una cadena.

  • is_near_object – Devuelve si un objeto está dentro del alcance del sensor.

  • set_light – Enciende, apaga o establece el LED del sensor de color en un nivel de brillo establecido.

  • set_light_power – Establece el brillo del LED del sensor de color.

  • instalado – Devuelve si el sensor de color está conectado al cerebro.

Constructores: inicializan y configuran manualmente un sensor de color.

matiz#

hue devuelve el valor de tono detectado como un flotante en el rango de 0 a 359,99 grados.

Uso:
hue()

Parámetros

Descripción

Este método no tiene parámetros.

# Display the currently detected hue of the sensor
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)

brillo#

brightness devuelve el brillo detectado como un porcentaje.

Uso:
brillo()

Parámetros

Descripción

Este método no tiene parámetros.

# 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)

color#

color devuelve el código hexadecimal del color detectado como una cadena con el formato “Color”, seguida de dos ceros y el valor hexadecimal del color. Por ejemplo, al detectar rojo (#FF0000), se devolvería “Color 00FF0000”.

Uso:
color()

Parámetros

Descripción

Este método no tiene parámetros.

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

está_cerca_del_objeto#

is_near_object devuelve un valor booleano que indica si el sensor de color se encuentra a aproximadamente 57 milímetros (2,25 pulgadas) de un objeto. La detección depende de la luz reflejada, por lo que las superficies oscuras o no reflectantes podrían no detectarse con fiabilidad.

  • Verdadero: el objeto detectado se encuentra aproximadamente a 57 milímetros.

  • Falso: El objeto detectado no está dentro de aproximadamente 57 milímetros.

Uso:
is_near_object()

Parámetros

Descripción

Este método no tiene parámetros.

# Stop driving when the Color Sensor is near an object
while True:
    if color_1.is_near_object():
        drivetrain.stop()
    else:
        drivetrain.drive(FORWARD)

establecer_luz#

set_light enciende o apaga el LED del sensor de color.

Uso:
set_light(valor, unidades)

Parámetros

Descripción

valor

Especifica si se enciende o apaga el LED mediante una de las siguientes opciones:

  • LedStateType.ON: establece el brillo del LED al 100 %.
  • LedStateType.OFF: establece el brillo del LED al 0 %.
Como alternativa, se puede usar un porcentaje de 0 a 100 para establecer el brillo del LED. Un valor de 0 apaga el LED; cualquier valor superior a 0 lo enciende con ese brillo.

unidades

Opcional. La unidad que representa el valor de brillo: PORCENTAJE.

# 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)

establecer_potencia_de_luz#

set_light_power establece el brillo del LED del sensor de color. Si el LED no está encendido, este método también lo encenderá.

Uso:
set_light_power(valor)

Parámetros

Descripción

valor

El brillo del LED como porcentaje de 0 a 100. Un valor de 0 apaga el LED.

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

instalado#

installed devuelve un valor booleano que indica si el sensor de color está conectado al cerebro.

  • Verdadero - El sensor de color está conectado al cerebro.

  • Falso - El sensor de color no está conectado al cerebro.

Uso:
installed()

Parámetros

Descripción

Este método no tiene parámetros.

# Display a message if the Color Sensor
# is installed.
if color_1.installed():
    brain.screen.print("Installed!")

Constructores#

Los constructores se utilizan para crear manualmente objetos ‘ColorSensor’, que son necesarios para configurar un sensor de color fuera de VEXcode.

Para los ejemplos siguientes, el sensor de color configurado se llamará “color_1” y se utilizará en todos los ejemplos posteriores en esta documentación de API cuando se haga referencia a los métodos de la clase “ColorSensor”.

Sensor de color#

ColorSensor crea un sensor de color.

Uso:
ColorSensor(puerto)

Parámetro

Descripción

puerto

A qué puerto inteligente está conectado el sensor de color se llama “PUERTO” seguido del número de puerto, que va del 1 al 12.

# Construct a Color Sensor "color_1" with the
# ColorSensor class.
color_1 = ColorSensor(Ports.PORT1)

while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print(color_1.color())
    wait(0.5,SECONDS)