DokumentationDynamic Media Image Production System-API

updateVignettePublishFormat updatevignettepublishformat

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • Admin

Aktualisiert die Einstellungen für das Vignettenveröffentlichungsformat.

Autorisierte Benutzertypen section-2f2ad136d2884dc9bfef6da008196ed0

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parameter section-8c7ba8d2bce14071b21fccb11f44749f

Input (updateVignettePublishFormatParam)

Name
Typ
Erforderlich
Beschreibung
companyHandle
xsd:string
Ja
Handle des Unternehmens.
vignetteFormatHandle
xsd:string
Ja
Handle im Publish-Format.
name
xsd:string
Nein
Publish-Formatname.
targetWidth
xsd:int
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
xsd:int
Ja
Gibt die Zielhöhe der resultierenden Vignettenansicht in Pixel an. Verwenden Sie null, damit die Ausgabemignette dieselbe Größe wie die primäre Vignette hat.
createPyramid
xsd:boolean
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.
thumbWidth
xsd:int
Ja
Gibt die Breite jeder resultierenden Miniaturansicht in Pixel an. Diese Einstellung ist optional. Lassen Sie den Wert null für keine Miniaturansicht-Datei.
saveAsVersion
xsd:int
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.
sizeSuffixSeparator
xsd:string
Ja
Gibt das Zeichen an, das den Vignettennamen und das Suffix mit seiner Breite trennt.
Scharfzeichnen
xsd:int
Nein
Wendet die Scharfzeichnung auf das Hauptansichtsbild für jede Veröffentlichungsvignettengröße an. Durch Scharfzeichnen können bei Skalierung der Vignetten verschwommene Stellen kompensiert werden.
usmAmount
xsd:double
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 heller die Kantengrenzen werden).
usmRadius
xsd:double
Ja
Betrifft die Größe der zu verbessernden Kanten oder die Breite der Kantenrimen, sodass ein kleinerer Radius die Detailgenauigkeit 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
xsd:int
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 Schwellenwert beträgt 0 bis 255.

Ausgabe (updateVignettePublishFormatReturn)

Name
Typ
Erforderlich
Beschreibung
vignetteFormatHandle
xsd:string
Ja
Zum aktualisierten Vignetten-Veröffentlichungsformat wechseln.

Beispiel section-fcba4bf2b7264786a676e315a35dbe43

Dieses Codebeispiel aktualisiert ein Vignetten-Veröffentlichungsformat und gibt den Handle in das aktualisierte Format zurück.

Anfrage

<updateVignettePublishFormatParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <vignetteFormatHandle>v|21|283</vignetteFormatHandle>
   <name>APIcreateVignettePublishFormat2</name>
   <targetWidth>1000</targetWidth>
   <targetHeight>800</targetHeight>
   <createPyramid>false</createPyramid>
   <thumbWidth>100</thumbWidth>
   <saveAsVersion>0</saveAsVersion>
   <sizeSuffixSeparator>-</sizeSuffixSeparator>
   <sharpen>50</sharpen>
   <usmAmount>240.0</usmAmount>
   <usmRadius>3.1</usmRadius>
   <usmThreshold>150</usmThreshold>
</updateVignettePublishFormatParam>

Antwort

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