óptico#

Inicializando la clase óptica #

Un sensor óptico se crea utilizando el siguiente constructor:

El constructor «óptico» crea un objeto óptico.

Parámetro	Descripción
`puerto`	Un Puerto inteligente válido al que está conectado el sensor óptico.

// Construct an Optical Sensor "Optical" with the
// optical class.
optical Optical = optical(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 clase óptica.

Métodos de clase #

matiz()#

El método hue() devuelve el valor del tono detectado por el sensor óptico.

Devuelve: Un doble que representa 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.
double hue = Optical.hue();

brillo()#

El método brightness(bRaw) devuelve el brillo detectado por el sensor óptico.

Parámetros	Descripción
Brazo	Un valor booleano para leer datos de brillo sin procesar en lugar de porcentajes. El valor predeterminado es `false`.

Devuelve: Un doble que representa 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.    
double 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 color.

// Set a variable, detectColor, to the color detected by the
// Optical Sensor.
color detectColor = Optical.color();

// Print the color detected by the Optical Sensor
// to the Brain's screen.
Brain.Screen.print(detectColor);

isNearObject()#

El método isNearObject() regresa si el sensor óptico detecta un objeto cercano.

Devuelve: true si se detecta un objeto cercano. false si no se detecta ninguno.

// If an object is detected yb the Optical Sensor, print
// "near object".
if (Optical.isNearObject()){
  Brain.Screen.print("near object");
}

establecerLuz()#

El método setLight(value) establece el LED del sensor óptico en encendido o apagado.

Parámetros	Descripción
valor	Un ledStateType válido.

Devoluciones: Ninguna.

// Turn on LED with previous intensity.
Optical.setLight(ledState::on);

establecerPotenciaDeLuz()#

El método setLightPower(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.
unidades	La única unidad válida para la reflectividad es el “porcentaje”.

Devoluciones: Ninguna.

// Set the light power to 50 percent.
Optical.setLightPower(50, percent);

tiempoDeIntegración()#

Este método se llama de las siguientes maneras:

El método integrationTime(value) establece el tiempo de integración del sensor óptico.

Parámetros	Descripción
valor	El tiempo de integración en milisegundos de 5 a 700.

Devoluciones: Ninguna.

// Set the integration time to 50 milliseconds.
Optical.integrationTime(50);

El método integrationTime() obtiene el tiempo de integración del sensor óptico.

Devuelve: Un doble que representa el tiempo de integración del sensor óptico.

// Get the Optical Sensor's integration time.
double intTime = Optical.integrationTime();

obtenerRgb()#

El método getRgb(raw) devuelve el valor RGB del sensor óptico.

Parámetros	Descripción
crudo	Un valor booleano para determinar si se devuelven valores sin procesar o procesados. El valor predeterminado es `true`.

Devuelve: Una tupla con valores de rojo, verde, azul y brillo.

// Get the RGB value of the Optical Sensor.
optical::rgbc value = Optical.rgb();

objetoDetecciónUmbral()#

El método objectDetectThreshold(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.
int value = Optical.objectDetectThreshold(100);

gestoHabilitar()#

El método gestureEnable() habilita el modo de 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.

gestoDeshabilitar()#

El método gestureDisable() deshabilita el modo gestos.

Devoluciones: Ninguna.

obtenerGesto()#

El método getGesture() devuelve el gesto detectado por el sensor óptico.

Devuelve: Un objeto óptico::gesto con los últimos datos de detección de gestos.

objetoDetectado()#

El método objectDetected(callback) 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.

Devoluciones: Ninguna.

// Define the detected function with a void return type,
// showing it doesn't return a value.
void detected() {
  // The Brain will print that the Optical Sensor detected
  // an object to the Brain's screen.
  Brain.Screen.print("object detected");
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Run detected when the Optical Sensor detects an object.
  Optical.objectDetected(detected);
}

objetoPerdido()#

El método objectLost(callback) 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.

Devoluciones: Ninguna.

// Define the lost function with a void return type,
// showing it doesn't return a value.
void lost() {
  // The Brain will print that the Optical Sensor lost an
  // object to the Brain's screen.
  Brain.Screen.print("object lost");
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Run lost when the Optical Sensor loses an object.
  Optical.objectLost(lost);
}

gestoArriba()#

El método gestureUp(callback) registra una función de devolución de llamada cuando se detecta un gesto hacia arriba.

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.

Devoluciones: Ninguna.

gestoAbajo()#

El método gestureDown(callback) registra una función de devolución de llamada cuando se detecta un gesto hacia abajo.

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.

Devoluciones: Ninguna.

gestoIzquierda()#

El método gestureLeft(callback) registra una función de devolución de llamada cuando se detecta un gesto hacia la izquierda.

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.

Devoluciones: Ninguna.

gestoDerecha()#

El método gestureRight(callback) registra una función de devolución de llamada cuando se detecta un gesto hacia la 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.

Devoluciones: Ninguna.

marca de tiempo()#

El método timestamp() solicita la marca de tiempo del último paquete de estado recibido del sensor óptico.

Devuelve: Marca de tiempo del último paquete de estado como un entero de 32 bits sin signo en milisegundos.

instalado()#

El método installed() verifica si el sensor óptico está conectado.

Devuelve: true si el sensor óptico está conectado. false si no lo está.