Camera.setMode()

Disponibilidad

Flash Player 6.

Sintaxis

active_cam.setMode(width, height, fps [,favorSize])

Parámetros

width Anchura de captura solicitada, expresada en píxeles. El valor predeterminado es 160.

height Altura de captura solicitada, expresada en píxeles. El valor predeterminado es 120.

fps Velocidad solicitada a la que la cámara debería capturar datos, expresada en fotogramas por segundo. El valor predeterminado es 15.

favorSize Opcional: valor booleano que especifica cómo manipular la anchura, la altura y la velocidad de fotogramas, si la cámara no tiene un modo nativo que cumpla los requisitos especificados. El valor predeterminado es true, lo que significa que se da prioridad a mantener el tamaño de captura; si se utiliza este parámetro, se selecciona el modo que más se acerca a los valores de width y height, aun cuando hacerlo afecte negativamente al rendimiento mediante la reducción de la velocidad de fotogramas. Para optimizar la velocidad de fotogramas a expensas de la altura y la anchura, pase false para el parámetro favorSize.

Valor devuelto

Ninguno.

Descripción

Método; establece el modo de captura de la cámara en el modo nativo que mejor cumple los requisitos especificados. Si la cámara no tiene ningún modo nativo que coincida con todos los parámetros pasados, Flash selecciona el modo de captura que mejor sintetice el modo solicitado. Esta manipulación puede implicar el recorte de la imagen y la eliminación de fotogramas.

De forma predeterminada, Flash elimina fotogramas según sea necesario para mantener el tamaño de la imagen. Para minimizar el número de fotogramas que se eliminan, aun cuando ello signifique reducir el tamaño de la imagen, pase false para el parámetro favorSize.

Si selecciona un modo nativo, Flash intenta mantener la proporción solicitada siempre que sea posible. Por ejemplo, si emite el comando active_cam.setMode(400,400,30), y los valores de anchura y altura máxima disponibles en la cámara son 320 y 288, Flash establece la altura y la anchura en 288. Al establecer ambas propiedades en el mismo valor, Flash mantiene la proporción 1:1 solicitada.

Para determinar los valores que se asignan a estas propiedades una vez que Flash haya seleccionado el modo que más se acerque a los valores solicitados, utilice Camera.width, Camera.height y Camera.fps.

Ejemplo

En el ejemplo siguiente se establece la anchura, la altura y la velocidad en fps en función de los datos especificados por el usuario si el usuario hace clic en el botón. El parámetro opcional favorSize no se incluye, porque el valor predeterminado, true, proporcionará los valores más cercanos a las preferencias del usuario sin sacrificar por ello la calidad de la imagen, aunque en ese caso sí es posible que se sacrifique la velocidad de fps. A continuación, se actualiza la interfaz de usuario con la nueva configuración.

on (press)
{
  // Establecer la anchura, la altura y la velocidad de fps en los valores especificados por el usuario.
  _root.myCam.setMode(txt_width, my_txt._height, txt_fps);
  
  // Actualizar los campos de texto del usuario con la nueva configuración.
  _root.txt_width = myCam.width;
  _root.txt_height = myCam.height;
  _root.txt_fps = myCam.fps;
}

Véase también

Camera.currentFps, Camera.fps, Camera.height, Camera.width