createVignettePublishFormat

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

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parametri

Input (createVignettePublishFormatParam)

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

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 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 Specifica la larghezza in pixel di ciascuna miniatura risultante. Questa impostazione è facoltativa. Lascia zero per non creare alcun file di miniatura.
thumbWidth Frase codice 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 Specifica il carattere che separa il nome della vignettatura e il suffisso che ne indica la larghezza.
sizeSuffixSeparator Frase codice Specifica il carattere che separa il nome della vignettatura e il suffisso che ne indica la larghezza.
nitidezza Frase codice 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.
usmImporto Frase codice 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 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 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 Handle del formato di vignettatura creato.

Esempi

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.

Request Contents (Richiesta contenuto)

<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>

In questa pagina