clipPath

Caminho do clipe de camada. Especifica um caminho de recorte para a camada atual.

clipPath= *pathDefinition*

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

pathDefinition

Dados de caminho.

pathName

Nome do caminho incorporado na imagem de origem da camada (somente ASCII).

Qualquer parte da camada que esteja fora da área definida por clipPath= são tornados transparentes.

*pathName* é o nome de um caminho incorporado na imagem de origem da camada. O caminho é transformado automaticamente para manter o alinhamento relativo com o conteúdo da imagem. Se mais de um *pathName* for especificada, o servidor recortará a imagem na interseção desses caminhos. Qualquer *pathName* não encontrado na imagem de origem é ignorado.

OBSERVAÇÃO

Somente cadeias de caracteres ASCII são suportadas para *pathName*.

*pathDefinition* permite especificar dados de caminho explícitos em coordenadas de pixel da camada.

Se size= for especificada e não for 0,0, a camada será pré-dimensionada. Nesse caso, as coordenadas do caminho são relativas ao canto superior esquerdo do retângulo da camada e a camada é posicionada com base em origin= ou seu padrão. Todas as regiões do caminho fora do retângulo de camada permanecem transparentes.

Se size= não for especificada para uma camada de texto ou cor sólida, a camada será considerada autodimensionável com a extensão do caminho determinando seu tamanho. Se origin= não é especificado, o padrão é (0,0) do espaço de coordenadas do caminho. Isso permite que as coordenadas do caminho sejam especificadas de acordo com a origem da camada 0.

OBSERVAÇÃO

scale=, rotate=, e anchor= não são permitidos comandos para autodimensionar camadas de cores sólidas.

*pathDefinition* aceita uma string semelhante ao valor de d= atributo do SVG <path> elemento, exceto que são usadas vírgulas em vez de espaços para separar valores. *pathDefinition* pode incluir um ou mais subcaminhos de ciclo fechado.

Os seguintes comandos de caminho são compatíveis com o *pathDefinition*:

Comando Nome Descrição
M x,y

mover para absoluto

Iniciar um novo subcaminho em x,y.

m x,y

mover para relativo

L *{ x,y}

absoluto de lineto

Desenhe uma linha da posição atual para x,y.

l *{ x,y}

lineto relativo

C *{ x1,y1,x2,y2,x,y}

curveto absoluto

Desenhe uma curva de Bézier da posição atual para x,y. x1,y1 é o ponto de controle no início da curva e x2,y2 é o ponto de controle no final da curva.

c *{ x1,y1,x2,y2,x,y}

curveto relative

Z | z

closepath

Fechar o subcaminho atual com uma linha reta.

Comandos em maiúsculas indicam que os valores de coordenadas estão em posições absolutas de pixel (relativas ao canto superior esquerdo do retângulo da camada). Os deslocamentos de pixels seguem comandos em minúsculas em relação à posição atual.

'm' ou 'M' sempre inicia um novo subcaminho. Os subcaminhos são fechados automaticamente (com uma linha reta) se 'Z' ou 'z' não for especificado no final.

Se um subcaminho começar com um moveto relativo ('m'), ele será relativo a um dos seguintes:

  • O ponto inicial do subcaminho anterior, se ele foi fechado com 'z' ou 'Z'.
  • O ponto final do subcaminho anterior, se ele não foi fechado explicitamente.
  • 0,0, se este for o primeiro subcaminho.

Propriedades

Atributo de camada. Se aplica à camada atual ou à imagem composta layer=comp. As camadas de efeito o ignoram.

clipPathE= será ignorado se nenhum caminho com o nome especificado for encontrado na imagem de origem da camada, ou se a origem da camada não for uma imagem.

Padrão

Nenhum, para nenhum recorte adicional da camada.

Consulte também

clipXpath= , textFlowPath= , estender=

Nesta página