createVignettePublishFormat createvignettepublishformat

Erstellt ein neues Veröffentlichungsformat für eine Vignette.

Vignettenformate geben die Größe veröffentlichter Vignetten und deren Miniaturansichten sowie Zoomstufen, Scharfzeichnungsparameter und die Dateiformatversion für Vignetten an, die aus primären Vignetten erzeugt werden, die von IPS auf einem Image Rendering-Server veröffentlicht werden.

Neuere Image Rendering-Serverversionen unterstützen Pyramid-Vignetten, sodass keine spezifischen Vignettenformatgrößen für die Veröffentlichung definiert werden müssen.

Autorisierte Benutzertypen section-f5c563e3695c4dba8df41e2a965aace7

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parameter section-3a368186ec1d4005bca056fc9d9bacc7

Input (createVignettePublishFormatParam)

Name
Typ
Erforderlich
Beschreibung
companyHandle
xsd:string
Ja
Handle mit dem Unternehmen, zu dem die Vignette gehört.
name
Codeausdruck
Ja
Name zur Identifizierung des Vignettenveröffentlichungsformats.
targetWidth
Codeausdruck
Ja

Gibt die Zielbreite der resultierenden Vignettenansicht in Pixel an.

Verwenden Sie null, damit die Ausgabemignette dieselbe Größe wie die primäre Vignette hat.

targetHeight
Codeausdruck
Ja
Erstellt eine Pyramidenvignette, die für das Zoomen auf dem Image Rendering-Server optimiert ist. Beginnend mit der Maximalgröße, die durch die Felder für die Vignettengröße der Zielgruppe festgelegt wird, erstellt dies Ansichten mit mehreren Größen in einer Vignettenausgabedatei. Jede nachfolgende Anzeigegröße wird um die Hälfte reduziert, bis die Breite und Höhe 128 x 128 Pixel beträgt.
createPyramid
Codeausdruck
Ja
Gibt die Breite jeder resultierenden Miniaturansicht in Pixel an. Diese Einstellung ist optional. Lassen Sie den Wert null für keine Miniaturansicht-Datei.
thumbWidth
Codeausdruck
Ja
Gibt das Dateiformat für die veröffentlichten Vignetten an. Bei einer neuen Version von Image Authoring und einer älteren Version des Image Rendering Server müssen Sie eine Vignettenversion angeben, die Ihr ImageRendering Server lesen kann. Wenn Sie eine höhere Version angeben, kann der Image Rendering-Server die veröffentlichten Vignetten nicht lesen. Auf null setzen, um Vignetten in der neuesten Version zu veröffentlichen.
saveAsVersion
Codeausdruck
Ja
Gibt das Zeichen an, das den Vignettennamen und das Suffix trennt und die Breite angibt.
sizeSuffixSeparator
Codeausdruck
Ja
Gibt das Zeichen an, das den Vignettennamen und das Suffix trennt und die Breite angibt.
sharpen
Codeausdruck
Nein
Wendet die Scharfzeichnung auf das Hauptansichtsbild für jede Veröffentlichungsvignettengröße an. Das Scharfzeichnen kann die Weichzeichnung bei der Skalierung der Vignetten kompensieren.
usmAmount
Codeausdruck
Ja
Die digitale Unschärfemaske ist eine flexible und leistungsstarke Methode, um die Schärfe zu erhöhen, insbesondere bei gescannten Bildern. Dies steuert die Größe jedes Überschießens (wie viel dunkler und leichter die Kantengrenzen werden).
usmRadius
Codeausdruck
Ja
Hat Auswirkungen auf die Größe der zu verbessernden Kanten oder die Breite der Kantenrimen, sodass ein kleineres Radium die Detailschärfe vergrößert. Höhere Radiuswerte können Halos an den Kanten verursachen. Für feine Details ist ein kleinerer Radius erforderlich, da winzige Details derselben Größe oder kleiner als der Radius verloren gehen.
usmThreshold
Codeausdruck
Ja
Steuert die minimale Helligkeitsänderung, die scharfgezeichnet werden soll, oder die Entfernung zwischen benachbarten Tonwerten, bevor der Filter funktioniert. Mit dieser Einstellung können ausgeprägtere Kanten scharfgezeichnet werden, während feinere Kanten unberührt bleiben. Der zulässige Bereich von 0 bis 255.

Output (createVignettePublishFormatReturn)

Name
Typ
Erforderlich
Beschreibung
vignetteFormatHandle
xsd:string
Ja
Der Handle zum erstellten Vignettenformat.

Beispiele section-0564752d439642b9bb8de2903db6de1e

Dieser Code erstellt das Vignettenveröffentlichungsformat. Die Erstellungsanfrage gibt einen Namen, eine Zielbreite und -höhe sowie andere erforderliche Werte an.

Anfrage

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

Antwort

<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