visión#
Inicializando la clase de visión#
Un sensor de visión se crea utilizando los siguientes constructores:
The vision
constructor creates a vision object in the specified port.
Parámetro |
Descripción |
---|---|
|
Un Puerto inteligente válido al que está conectado el sensor de visión. |
|
El ajuste de brillo para el sensor de visión, de 0 a 255. |
|
El nombre de uno o más objetos firma. |
// Create a new Signature "darkBlue" with the signature class.
vision::signature darkBlue = vision::signature(1, -3911, -3435, -3673,10879, 11421, 11150,2.5, 0);
// Create a new Vision Sensor "Vision1" with the vision class.
vision Vision1 = vision(PORT1, 50, darkBlue);
This Vision1
vision object and darkBlue
signature object will be used in all subsequent examples throughout this API documentation when referring to vision class methods.
Métodos de clase#
tomarInstantánea()#
The takeSnapshot(index, count)
method takes the current snapshot visible to the Vision sensor and detects the objects of a given signature, code, or signature id.
Antes de tomar una instantánea, debes configurar las firmas que el sensor de visión debe buscar.
Parámetros |
Descripción |
---|---|
índice |
Una firma, un código o una identificación de firma. |
contar |
Opcional. El número máximo de objetos a obtener. El valor predeterminado es 8. |
Devoluciones: Ninguna.
while (true) {
// Take a snapshot to check for detected objects.
Vision1.takeSnapshot(darkBlue);
// Clear the screen/reset so that we can display
// new information.
Brain.Screen.clearScreen();
Brain.Screen.setCursor(1, 1);
// If objects were found, print the location.
if (Vision1.objects[0].exists) {
Brain.Screen.print("Center X: %d", Vision1.largestObject.centerX);
} else {
Brain.Screen.print("no object");
}
wait(0.5, seconds);
}
objeto más grande#
The largestObject
property holds the largest object detected by the Vision sensor.
Luego podrá acceder a las siguientes propiedades de un objeto de visión.
Propiedades del objeto de visión |
Descripción |
---|---|
|
El identificador único del objeto. |
|
La coordenada x superior izquierda del objeto. |
|
La coordenada y superior izquierda del objeto. |
|
La coordenada x del centro del objeto. |
|
La coordenada y central del objeto. |
|
El ancho del objeto. |
|
La altura del objeto. |
|
El ángulo del objeto. |
|
Si la cámara Vision detecta el objeto o no. |
Devuelve: Un objeto de visión.
while (true) {
// Take a snapshot to check for detected objects.
Vision1.takeSnapshot(darkBlue);
// Clear the screen/reset so that we can display
// new information.
Brain.Screen.clearScreen();
Brain.Screen.setCursor(1, 1);
// If objects were found, print the location.
if (Vision1.objects[0].exists) {
Brain.Screen.print("Center X: %d", Vision1.largestObject.centerX);
} else {
Brain.Screen.print("no object");
}
wait(0.5, seconds);
}
objectCount#
The objectCount
property holds the number of objects detected in the latest snapshot taken by the Vision sensor.
Devuelve: La cantidad de objetos detectados por el sensor de visión.
while (true) {
// Take a snapshot to check for detected objects.
Vision1.takeSnapshot(darkBlue);
// Clear the screen/reset so that we can display
// new information.
Brain.Screen.clearScreen();
Brain.Screen.setCursor(1, 1);
// Print how many objects were detected.
Brain.Screen.print("object count: %d", Vision1.objectCount);
wait(0.5, seconds);
}
establecerModoLed()#
The setLedMode(mode)
method changes the mode of the LED on the Vision Sensor.
Parámetros |
Descripción |
---|---|
modo |
Modo LED. El modo automático controla el color del LED mediante el firmware del sensor de visión. El modo manual permite controlar el color del LED mediante el programa del usuario. |
Devuelve: Verdadero si la configuración se guardó correctamente. Falso si no.
obtenerLedMode()#
The getLedMode()
method returns the mode of the LED from the Vision Sensor.
Returns: An ledMode
that represents the current mode of the Vision Sensor LED.
establecerBrilloLed()#
The setLedBrightness(percent)
method changes the brightness of the LED on the Vision Sensor when LED is set to manual mode.
Parámetros |
Descripción |
---|---|
por ciento |
Porcentaje del brillo total del LED del sensor de visión en modo manual. Los valores van de 0 a 100. 0 = LED apagado. |
Returns: true
if the setting was successfully saved. false
if it was not.
obtenerBrilloLed()#
The getLedBrightnesstLedMode()
method returns the brightness of the LED from the Vision Sensor.
Devuelve: Un valor entre 0 y 100 que representa el brillo actual del LED del sensor de visión.
establecerColorLed()#
The setLedColor(red, green, blue)
method changes the color of the LED on the Vision Sensor when LED is set to manual mode.
Parámetros |
Descripción |
---|---|
rojo |
Un valor de 0 a 255 que representa la intensidad del color rojo del LED. |
verde |
Un valor de 0 a 255 que representa la intensidad del color verde del LED. |
azul |
Un valor de 0 a 255 que representa la intensidad del color azul del LED. |
Returns: true
if the setting was successfully saved.
obtenerColorLed()#
The getLedColor(red, green, blue)
method returns the color of the LED from the Vision Sensor.
Parámetros |
Descripción |
---|---|
rojo |
Una referencia a un valor para almacenar la intensidad del color rojo del LED. |
verde |
Una referencia a un valor para almacenar la intensidad del color verde del LED. |
azul |
Una referencia a un valor para almacenar la intensidad del color azul del LED. |
Returns: true
if the values were successfully received. false
if they were not.
marca de tiempo()#
The timestamp()
method requests the timestamp of the last received status packet from the Vision Sensor.
Devuelve: Marca de tiempo del último paquete de estado como un entero de 32 bits sin signo en milisegundos.
instalado()#
The installed()
method checks if the Vision Sensor is connected.
Returns: true
if the Vision Sensor is connected. false
if it is not.