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	Sì	Gestisci l’azienda a cui appartiene la vignettatura.
nome	Frase codice	Sì	Nome per identificare il formato di pubblicazione vignettatura.
targetWidth	Frase codice	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	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	Sì	Specifica la larghezza in pixel di ciascuna miniatura risultante. Questa impostazione è facoltativa. Lascia zero per non creare alcun file di miniatura.
thumbWidth	Frase codice	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	Sì	Specifica il carattere che separa il nome della vignettatura e il suffisso che ne indica la larghezza.
sizeSuffixSeparator	Frase codice	Sì	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	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	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	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

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>