DocumentazioneAPI del sistema di produzione delle immagini Dynamic Media

createVignettePublishFormat createvignettepublishformat

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore
  • Amministratore

Crea un nuovo formato di pubblicazione per una vignettatura.

I formati di vignettatura specificano le dimensioni delle vignettature pubblicate e delle relative miniature, nonché i livelli di zoom, i parametri di nitidezza e la versione del formato di file per le vignettature prodotte da vignettature primarie pubblicate su un server Image Rendering da IPS.

Le versioni più recenti del server Image Rendering supportano le vignettature piramidali, eliminando la necessità di definire formati di vignettatura specifici per la pubblicazione.

Tipi di utenti autorizzati section-f5c563e3695c4dba8df41e2a965aace7

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parametri section-3a368186ec1d4005bca056fc9d9bacc7

Input (createVignettePublishFormatParam)

Nome
Tipo
Obbligatorio
Descrizione
companyHandle
xsd:string
Sì
Gestisci l’azienda a cui appartiene la vignettatura.
nome
Frase codice di
Sì
Nome per identificare il formato di pubblicazione vignettatura.
targetWidth
Frase codice di
Sì

Specifica la larghezza di destinazione della visualizzazione vignettatura risultante, in pixel.

Utilizzare zero in modo che la vignettatura di output abbia le stesse dimensioni della vignettatura principale.

targetHeight
Frase codice di
Sì
Crea una vignettatura piramidale ottimizzata per lo zoom sul server Image Rendering. Partendo dalla dimensione massima, impostata dai campi Dimensione vignettatura di destinazione, vengono create visualizzazioni con più dimensioni in un singolo file di output vignettatura. Ogni dimensione di visualizzazione successiva viene dimezzata fino a raggiungere valori di larghezza e altezza compresi tra 128x128 pixel.
createPyramid
Frase codice di
Sì
Specifica la larghezza in pixel di ciascuna miniatura risultante. Questa impostazione è facoltativa. Lascia zero per non creare alcun file di miniatura.
larghezza miniature
Frase codice di
Sì
Specifica il formato di file per le vignettature pubblicate. Considerata una nuova versione di Image Authoring e una precedente versione di Image Rendering Server, è necessario specificare una versione di vignettatura che il server ImageRendering possa leggere. Se specificate una versione successiva, il server Image Rendering non sarà in grado di leggere le vignettature pubblicate. Impostate questo valore su zero per pubblicare le vignettature all'ultima versione.
saveAsVersion
Frase codice di
Sì
Specifica il carattere che separa il nome della vignettatura e il suffisso che ne indica la larghezza.
sizeSuffixSeparator
Frase codice di
Sì
Specifica il carattere che separa il nome della vignettatura e il suffisso che ne indica la larghezza.
nitidezza
Frase codice di
No
Aumenta la nitidezza dell'immagine di visualizzazione principale per ogni dimensione di vignettatura con effetto di contrasto in grado di compensare l'effetto sfuocato quando i vignettatori vengono ridimensionati.
usmAmount
Frase codice di
Sì
Il mascheramento digitale è un modo flessibile e potente per aumentare la nitidezza, soprattutto nelle immagini digitalizzate. Questa opzione consente di controllare la grandezza di ciascuna sovrascrittura (la quantità di luce e di oscurità che i bordi diventano).
usmRadius
Frase codice di
Sì
Influisce sulla dimensione degli spigoli da aumentare o sulla larghezza dei bordi, quindi un raggio più piccolo migliora i dettagli di scala più piccola. Valori di raggio più alti possono causare aloni sui bordi. I dettagli fini richiedono un raggio più piccolo, in quanto vengono persi piccoli dettagli della stessa dimensione o più piccoli del raggio.
usmThreshold
Frase codice di
Sì
Controlla la variazione minima della luminosità da rendere più nitida o la distanza tra i valori tonali adiacenti prima che il filtro funzioni. Questa impostazione consente di rendere più nitidi i bordi pronunciati lasciando invariati quelli più sottili. L'intervallo consentito di soglia compreso tra 0 e 255.

Output (createVignettePublishFormatReturn)

Nome
Tipo
Obbligatorio
Descrizione
vignetteFormatHandle
xsd:string
Sì
Handle del formato di vignettatura creato.

Esempi section-0564752d439642b9bb8de2903db6de1e

Questo codice crea il formato di pubblicazione vignettatura. La richiesta di creazione specifica un nome, una larghezza e un'altezza di destinazione e altri valori richiesti.

Richiesta

<createVignettePublishFormatParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <name>APIcreateVignettePublishFormat1</name>
   <targetWidth>1200</<targetWidth>
   <targetHeight>800</targetHeight>
   <createPyramid>true</createPyramid>
   <thumbWidth>400</thumbWidth>
   <saveAsVersion>0</saveAsVersion>
   <sizeSuffixSeparator>-</sizeSuffixSeparator>
   <sharpen>50</sharpen>
   <usmAmount>230.0</usmAmount>
   <usmRadius>1.1</usmRadius>
   <usmThreshold>130</usmThreshold>
</createVignettePublishFormatParam>

Risposta

<createVignettePublishFormatReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <vignetteFormatHandle>v|21|282</vignetteFormatHandle>
</createVignettePublishFormatReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681