Óptico#
Inicializando la clase óptica#
Un sensor óptico se crea utilizando el siguiente constructor:
Óptico(puerto)
Este constructor utiliza un parámetro:
Parámetro |
Descripción |
---|---|
|
Un Puerto inteligente válido al que está conectado el sensor óptico. |
# Construct an Optical Sensor "optical" with the
# Optical class.
optical = Optical(Ports.PORT1)
Este objeto “óptico” se utilizará en todos los ejemplos posteriores a lo largo de esta documentación de API cuando se haga referencia a los métodos de la clase Optical.
Métodos de clase#
hue()#
El método hue()
devuelve el valor del tono detectado por el sensor óptico.
Devuelve: El valor del tono detectado por el sensor óptico como un flotante en el rango 0 - 359,99.
# Set a variable hue, to the value of the hue detected by
# the Optical Sensor.
hue = optical.hue()
brightness()#
El método brightness(readraw)
devuelve el brillo detectado por el sensor óptico.
Parámetros |
Descripción |
---|---|
leer dibujo |
Opcional. Un valor booleano para leer datos de brillo sin procesar en lugar de porcentaje. |
Devuelve: El brillo detectado por el sensor óptico como un flotante en el rango 0 - 100%.
# Set a variable brightness, to the value of the brightness
# detected by the Optical Sensor.
brightness = optical.brightness()
# Print the brightness detected by the Optical Sensor to
# the Brain's screen.
brain.screen.print(brightness)
color()#
El método color()
devuelve el color detectado por el sensor óptico.
Devuelve: El color detectado por el sensor óptico como una instancia de la clase de color.
# Set a variable, color, to the color detected by the
# Optical Sensor.
color = optical.color()
# Print the color detected by the Optical Sensor to the
# Brain's screen.
brain.screen.print(color)
is_near_object()#
El método is_near_object()
verifica si el sensor óptico detecta un objeto cercano.
Devuelve: «Verdadero» si se detecta un objeto cercano. «Falso» si no se detecta ninguno.
# If an object is detected yb the Optical Sensor, print "near object".
if optical.is_near_object():
brain.screen.print("near object")
set_light()#
El método set_light(value)
establece el LED del sensor óptico en encendido o apagado.
Parámetros |
Descripción |
---|---|
valor |
El estado para configurar la luz o el porcentaje de energía en el rango 0 - 100. |
Devoluciones: Ninguna.
# Turn on led with previous intensity.
optical.set_light(LedStateType.ON)
# Turn on led with new intensity.
optical.set_light(65)
set_light_power()#
El método set_light_power(value)
establece la potencia de la luz del LED del sensor óptico.
Parámetros |
Descripción |
---|---|
valor |
El nivel de potencia para configurar la luz de 0 a 100 como porcentaje. |
Devoluciones: Ninguna.
# Set the light power to 50 percent.
optical.set_light_power(50)
integration_time()#
El método integration_time(value)
establece el LED del sensor óptico a la potencia solicitada.
Parámetros |
Descripción |
---|---|
valor |
Opcional. El tiempo de integración en milisegundos de 5 a 700. |
Devoluciones: Ninguna.
# Set the integration time to 50 milliseconds.
optical.integration_time(50)
rgb()#
El método rgb(raw)
devuelve el valor RGB del sensor óptico.
Parámetros |
Descripción |
---|---|
crudo |
Opcional. Un valor booleano para determinar si devuelve valores sin procesar o procesados. |
Devuelve: Una tupla con valores de rojo, verde, azul y brillo.
# Get the RGB value of the Optical Sensor.
rgb = optical.rgb()
object_detect_threshold()#
El método object_detect_threshold(value)
establece el umbral de detección de objetos.
Parámetros |
Descripción |
---|---|
valor |
Un número en el rango 0 - 255. Un valor de 0 solo devolverá el valor actual. |
Devuelve: El valor actual del umbral de detección de objetos.
# Set the object detection threshold to 100.
optical.value = object_detect_threshold(100)
gesture_enable()#
El método gesture_enable()
habilita el modo gestos.
Un gesto es el movimiento de un objeto detectado por el sensor óptico. Por lo tanto, si un objeto se mueve hacia arriba en el campo de visión del sensor óptico, se trata de un gesto hacia arriba. Por otro lado, si un objeto se mueve hacia abajo, se trata de un gesto hacia abajo. Lo mismo ocurre con los gestos izquierda y derecha.
Devoluciones: Ninguna.
gesture_disable()#
El método gesture_disable()
deshabilita el modo gestos.
Un gesto es el movimiento de un objeto detectado por el sensor óptico. Por lo tanto, si un objeto se mueve hacia arriba en el campo de visión del sensor óptico, se trata de un gesto hacia arriba. Por otro lado, si un objeto se mueve hacia abajo, se trata de un gesto hacia abajo. Lo mismo ocurre con los gestos izquierda y derecha.
Devoluciones: Ninguna.
get_gesture()#
El método get_gesture(newobject)
devuelve el gesto detectado por el sensor óptico.
Un gesto es el movimiento de un objeto detectado por el sensor óptico. Por lo tanto, si un objeto se mueve hacia arriba en el campo de visión del sensor óptico, se trata de un gesto hacia arriba. Por otro lado, si un objeto se mueve hacia abajo, se trata de un gesto hacia abajo. Lo mismo ocurre con los gestos izquierda y derecha.
Parámetros |
Descripción |
---|---|
nuevo objeto |
Opcional. Un valor booleano que determina si se debe crear o no un nuevo objeto Gesto. |
Devuelve: Un objeto con los últimos datos del gesto.
object_detected()#
El método object_detected(callback, arg)
registra una función de devolución de llamada cuando se detecta un objeto.
Parámetros |
Descripción |
---|---|
llamar de vuelta |
La función de devolución de llamada que se llamará cuando se detecte un objeto. |
arg |
Opcional. Una tupla de argumentos para pasar a la función de devolución de llamada. |
Devuelve: Una instancia de la clase Event.
# Define a function detected().
def detected():
# The Brain will print that an object was detected on
# the Brain's screen.
brain.screen.print("object detected")
# Run detected when the Optical Sensor detects an object.
optical.object_detected(detected)
object_lost()#
El método object_lost(callback, arg)
registra una función de devolución de llamada para cuando se pierde un objeto.
Parámetros |
Descripción |
---|---|
llamar de vuelta |
La función de devolución de llamada que se llamará cuando se pierda un objeto. |
arg |
Opcional. Una tupla de argumentos para pasar a la función de devolución de llamada. |
Devuelve: Una instancia de la clase Event.
# Define a function lost().
def lost():
# The Brain will print that an object was lost on the
# Brain's screen.
brain.screen.print("object lost")
# Run lost when the Optical Sensor loses an object.
optical.object_lost(lost)
gesture_up()#
El método gesture_up(callback, arg)
registra una función de devolución de llamada cuando se detecta un gesto hacia arriba.
Un gesto es el movimiento de un objeto detectado por el sensor óptico. Por lo tanto, si un objeto se mueve hacia arriba en el campo de visión del sensor óptico, se trata de un gesto hacia arriba. Por otro lado, si un objeto se mueve hacia abajo, se trata de un gesto hacia abajo. Lo mismo ocurre con los gestos izquierda y derecha.
Parámetros |
Descripción |
---|---|
llamar de vuelta |
La función de devolución de llamada que se llamará cuando se detecte un gesto hacia arriba. |
arg |
Opcional. Una tupla de argumentos para pasar a la función de devolución de llamada. |
Devoluciones: Ninguna.
# Define a function detect_gesture_up()
def detect_gesture_up():
# The Brain will print that the up gesture was detected
# on the Brain's screen.
brain.screen.print("gesture up detected")
# Run detect_gesture_up when the Optical Sensor detects
# an upward gesture.
optical.gesture_up(detect_gesture_up)
gesture_down()#
El método gesture_down(callback, arg)
registra una función de devolución de llamada cuando se detecta un gesto hacia abajo.
Un gesto es el movimiento de un objeto detectado por el sensor óptico. Por lo tanto, si un objeto se mueve hacia arriba en el campo de visión del sensor óptico, se trata de un gesto hacia arriba. Por otro lado, si un objeto se mueve hacia abajo, se trata de un gesto hacia abajo. Lo mismo ocurre con los gestos izquierda y derecha.
Parámetros |
Descripción |
---|---|
llamar de vuelta |
La función de devolución de llamada que se llamará cuando se detecte un gesto hacia abajo. |
arg |
Opcional. Una tupla de argumentos para pasar a la función de devolución de llamada. |
Devoluciones: Ninguna.
# Define a function detect_gesture_down().
def detect_gesture_down():
# The Brain will print that the down gesture was detected
# on the Brain's screen.
brain.screen.print("gesture down detected")
# Run detect_gesture_down when the Optical Sensor detects
# a downward gesture.
optical.gesture_down(detect_gesture_down)
gesture_left()#
El método gesture_left(callback, arg)
registra una función de devolución de llamada cuando se detecta un gesto hacia la izquierda.
Un gesto es el movimiento de un objeto detectado por el sensor óptico. Por lo tanto, si un objeto se mueve hacia arriba en el campo de visión del sensor óptico, se trata de un gesto hacia arriba. Por otro lado, si un objeto se mueve hacia abajo, se trata de un gesto hacia abajo. Lo mismo ocurre con los gestos izquierda y derecha.
Parámetros |
Descripción |
---|---|
llamar de vuelta |
La función de devolución de llamada que se llamará cuando se detecte un gesto hacia la izquierda. |
arg |
Opcional. Una tupla de argumentos para pasar a la función de devolución de llamada. |
Devoluciones: Ninguna.
# Define a function detect_gesture_left().
def detect_gesture_left():
# The Brain will print that the left gesture was detected
# on the Brain's screen.
brain.screen.print("gesture left detected")
# Run detect_gesture_left when the Optical Sensor detects
# a leftward gesture.
optical.gesture_left(detect_gesture_left)
gesture_right()#
El método gesture_right(callback, arg)
registra una función de devolución de llamada cuando se detecta un gesto hacia la derecha.
Un gesto es el movimiento de un objeto detectado por el sensor óptico. Por lo tanto, si un objeto se mueve hacia arriba en el campo de visión del sensor óptico, se trata de un gesto hacia arriba. Por otro lado, si un objeto se mueve hacia abajo, se trata de un gesto hacia abajo. Lo mismo ocurre con los gestos izquierda y derecha.
Parámetros |
Descripción |
---|---|
llamar de vuelta |
La función de devolución de llamada que se llamará cuando se detecte un gesto hacia la derecha. |
arg |
Opcional. Una tupla de argumentos para pasar a la función de devolución de llamada. |
Devoluciones: Ninguna.
# Define a function detect_gesture_right()
def detect_gesture_right():
# The Brain will print that the right gesture was
# detected on the Brain's screen.
brain.screen.print("gesture right detected")
# Run detect_gesture_right when the Optical Sensor detects
# a rightward gesture.
optical.gesture_right(detect_gesture_right)
installed()#
El método installed()
verifica si el sensor óptico está conectado.
Devuelve: «Verdadero» si el sensor óptico está conectado. «Falso» si no lo está.
timestamp()#
El método timestamp()
devuelve la marca de tiempo del último paquete de estado recibido del sensor óptico.
Devuelve: La marca de tiempo del último paquete de estado recibido en milisegundos.