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

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parameter

Eingabe (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 zum Zoomen auf dem Image Rendering-Server optimierte Pryramidenvignette. Ausgehend von der Maximalgröße, die in den Feldern zur Bestimmung der Größe der Zielvignette festgelegt wird, werden in einer einzigen Vignettendatei Ansichten in verschiedenen Größen erstellt. Die Größe jeder weiteren Ansicht wird jedesmal halbiert, bis Höhe und Breite bei 128 x 128 Pixeln liegen.
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.
Scharfzeichnen 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.

Ausgabe (createVignettePublishFormatReturn)

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

Beispiele

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

Anforderung

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

Auf dieser Seite