DocumentazioneAPI di server e rendering immagini Dynamic Medie

clipPath

Ultimo aggiornamento: 20 luglio 2024
  • Argomenti:

Creato per:

  • Sviluppatore
  • Utente

Tracciato clip livello. Specifica un tracciato di ritaglio per il livello corrente.

clipPath= *pathDefinition*

clipPathE= *nomePercorso**[, *nomePercorso*]

definizione percorsoDati percorso.
nomePercorsoNome del percorso incorporato nell'immagine sorgente del livello (solo ASCII).

Tutte le parti del livello che non rientrano nell'area definita da clipPath= sono rese trasparenti.

*nomePercorso* è il nome di un percorso incorporato nell'immagine di origine del livello. Il percorso viene trasformato automaticamente per mantenere l'allineamento relativo con il contenuto dell'immagine. Se sono specificati più percorsi *pathName*, il server ritaglia l'immagine all'intersezione di tali percorsi. Qualsiasi *pathName* non trovato nell'immagine di origine viene ignorato.

NOTA
Per *pathName* sono supportate solo stringhe ASCII.

*pathDefinition* consente di specificare dati di percorso espliciti in coordinate pixel del livello.

Se si specifica size= e non 0,0, il livello viene ridimensionato. In questo caso, le coordinate del tracciato sono relative all'angolo superiore sinistro del rettangolo del livello e il livello è posizionato in base a origin= o al suo valore predefinito. Qualsiasi area del tracciato all'esterno del rettangolo di livello rimane trasparente.

Se size= non è specificato per un colore a tinta unita o per un livello di testo, il livello viene considerato di dimensionamento automatico e l'estensione del percorso ne determina la dimensione. Se origin= non è specificato, per impostazione predefinita viene utilizzato (0,0) dello spazio delle coordinate del percorso. Questo processo di flusso di lavoro consente di specificare le coordinate del tracciato rispetto all'origine del livello 0.

NOTA
I comandi scale=, rotate= e anchor= non sono consentiti per i livelli a tinta unita con ridimensionamento automatico.

*pathDefinition* accetta una stringa simile al valore dell'attributo d= dell'elemento SVG <path>, con la differenza che vengono utilizzate virgole anziché spazi per separare i valori. *pathDefinition* può includere uno o più percorsi secondari a loop chiuso.

I seguenti comandi di percorso sono supportati in *pathDefinition*:

ComandoNomeDescrizione
M x,ysposta in assolutoAvvia un nuovo percorso secondario da x,y.
m x,ypassa a relativo
L *{ x,y}lineto assolutoDisegnare una linea dalla posizione corrente a x,y.
l *{ x,y}lineto relativo
C *{ x1,y1,x2,y2,x,y}assoluto curvatoDisegnate una curva di Bezier dalla posizione corrente a x,y. x1,y1 è il punto di controllo all'inizio della curva e x2,y2 è il punto di controllo alla fine della curva.
c *{ x1,y1,x2,y2,x,y}curveto relativo
Z | zclosepathChiudete il sottotracciato corrente con una linea retta.

I comandi in maiuscolo indicano che i valori delle coordinate sono in posizioni pixel assolute (relative all'angolo superiore sinistro del rettangolo del livello). Gli offset pixel seguono i comandi minuscoli relativi alla posizione corrente.

'm' o 'M' avvia sempre un nuovo percorso secondario. I sottopercorsi vengono chiusi automaticamente (con una linea retta) se 'Z' o 'z' non è specificato alla fine.

Se un percorso secondario inizia con un movimento relativo ("m"), è relativo a uno dei seguenti elementi:

  • Punto iniziale del percorso secondario precedente, se è stato chiuso con 'z' o 'Z'.
  • Punto finale del percorso secondario precedente, se non è stato chiuso in modo esplicito.
  • 0,0, se si tratta del primo sottopercorso.

Proprietà

Attributo livello. Si applica al livello corrente o all'immagine composita se layer=comp. I livelli degli effetti lo ignorano.

Il modificatore clipPathE= viene ignorato se nell'immagine di origine del livello non viene trovato alcun percorso con il nome specificato o se l'origine del livello non è un'immagine.

Predefinito

Nessuno, per non ritagliare ulteriormente il livello.

Consultate anche

clipXpath= , textFlowPath= , extend=

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49