clipPath

Última actualización: 2023-09-01

Temas:
Dynamic Media Classic
Ver más sobre este tema
SDK/API
Ver más sobre este tema

Creado para:
Developer

User

Ruta de clip de capa. Especifica un trazado de recorte para la capa actual.

clipPath= *pathDefinition*

clipPathE= *pathName**[, *pathName*]

pathDefinition	Path data.
pathName	Nombre de la ruta incrustada en la imagen de origen de la capa (solo ASCII).

Cualquier parte de la capa que se encuentre fuera del área definida por clipPath= son transparentes.

*pathName* es el nombre de un trazado incrustado en la imagen de origen de la capa. La ruta se transforma automáticamente para mantener la alineación relativa con el contenido de la imagen. Si hay más de uno *pathName* se especifica, el servidor recorta la imagen a la intersección de estas rutas. Cualquiera *pathName* no encontrado en la imagen de origen se ignora.

NOTA

Solo se admiten cadenas ASCII para *pathName*.

*pathDefinition* permite especificar datos de ruta explícitos en coordenadas de píxel de capa.

If size= se especifica y no 0,0, la capa está presionada. En este caso, las coordenadas de trazado son relativas a la esquina superior izquierda del rectángulo de capa y la capa se coloca basándose en origin= o su valor predeterminado. Cualquier región del trazado fuera del rectángulo de capa permanecerá transparente.

If size= no se ha especificado para una capa de texto o color sólido, la capa se considera de tamaño propio con la extensión del trazado que determina su tamaño. If origin= no se ha especificado, el valor por defecto es (0,0) del espacio de coordenadas de trazado. Este proceso de flujo de trabajo permite especificar de forma eficaz las coordenadas de ruta en relación con el origen de la capa 0.

NOTA

scale=, rotate=, y anchor= no se permiten comandos para capas de color sólido de tamaño propio.

*pathDefinition* acepta una cadena similar al valor de d= atributo del SVG <path> , excepto que se utilizan comas en lugar de espacios para separar valores. *pathDefinition* puede incluir una o más subrutas de bucle cerrado.

Los siguientes comandos de ruta son compatibles con *pathDefinition*:

Comando	Nombre	Descripción
M x,y	moverla a absoluta	Iniciar una nueva subruta en x,y.
m x,y	mover a relativo
L *{ x,y}	línea a absoluta	Dibuja una línea desde la posición actual a x,y.
l *{ x,y}	línea a relativa
C *{ x1,y1,x2,y2,x,y}	curvatura absoluta	Dibujar una curva Bézier desde la posición actual hasta x,y. x1,y1 es el punto de control al principio de la curva y x2,y2 es el punto de control al final de la curva.
c *{ x1,y1,x2,y2,x,y}	curva relativa
Z \| z	closepath	Cierre el subtrazado actual con una línea recta.

Los comandos en mayúsculas indican que los valores de coordenadas están en posiciones absolutas de píxeles (en relación con la parte superior izquierda del rectángulo de capa). Los desplazamientos de píxeles siguen comandos en minúsculas en relación con la posición actual.

'm' o 'M' siempre inicia una nueva subruta. Los subtrazados se cierran automáticamente (con una línea recta) si 'Z' o 'z' no se especifican al final.

Si una subruta comienza con un movimiento relativo ('m'), es relativa a una de las siguientes opciones:

El punto de partida de la subruta anterior, si se cerró con "z" o "Z".
El punto final de la subruta anterior, si no se cerró explícitamente.
0,0, si es el primer subtrazado.

Propiedades

Atributo de capa. Se aplica a la capa actual o a la imagen compuesta si layer=comp. Las capas de efectos lo ignoran.

El modificador clipPathE= se ignora si no se encuentra ninguna ruta con el nombre especificado en la imagen de origen de la capa o si el origen de la capa no es una imagen.