MovieClip.setMask()

Disponibilidad

Flash Player 6.

Sintaxis

my_mc.setMask(mask_mc)

Parámetros

my_mc Nombre de instancia del clip de película que se va a enmascarar.

mask_mc Nombre de instancia del clip de película que se va a enmascarar.

Valor devuelto

Ninguno.

Descripción

Método; convierte el clip de película del parámetro mask_mc en una máscara que revela el clip de película especificado por el parámetro my_mc.

Este método permite que los clips de película de varios fotogramas con contenido complejo y de varias capas actúen como máscaras. Puede activar o desactivar las máscaras en tiempo de ejecución. Sin embargo, no puede utilizar la misma máscara para varias máscaras (lo cual es posible con el uso de capas de máscara). Si dispone de fuentes de dispositivo en un clip de película con máscara, dichas fuentes se dibujarán pero no se enmascararán. No es posible establecer que un clip de película sea su propia máscara, por ejemplo, my_mc.setMask(my_mc).

Si crea una capa de máscara que contenga un clip de película y, a continuación, le aplica el método setMask(), la llamada a setMask() tiene prioridad y, por lo tanto, es irreversible. Por ejemplo, puede tener un clip de película en una capa de máscara denominada UIMask que enmascara otra capa que contiene un clip de película denominado UIMaskee. Si, durante la reproducción del archivo SWF, llama a UIMask.setMask(UIMaskee), a partir de ese momento, UIMask quedará enmascarado por UIMaskee.

Para cancelar una máscara creada con ActionScript, pase el valor null al método setMask(). El código siguiente cancela la máscara sin que afecte a la capa de máscara de la línea de tiempo.

UIMask.setMask(null);

Ejemplo

El código siguiente utiliza el clip de película circleMask_mc para enmascarar el clip de película theMaskee_mc.

theMaskee_mc.setMask(circleMask_mc);