DocumentatieDynamic Media Image Production System API

createVignetPublishFormat createvignettepublishformat

Last update: Tue Mar 08 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Developer
  • Admin

Hiermee maakt u een nieuwe publicatie-indeling voor een vignet.

Vignetformaten specificeren de grootte van gepubliceerde vignettes en hun duimnagels, evenals gezoemniveaus, verscherpende parameters, en de dossierformaatversie voor vignetten die van primaire vignetten worden geproduceerd die aan een Beeld teruggevend server van IPS worden gepubliceerd.

Nieuwere versies van de server voor het renderen van afbeeldingen kunnen piramidevignetten ondersteunen, waardoor het niet nodig is specifieke grootten voor vignetten voor publicatie te definiëren.

Geautoriseerde gebruikerstypen section-f5c563e3695c4dba8df41e2a965aace7

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parameters section-3a368186ec1d4005bca056fc9d9bacc7

Input (createVignetPublishFormatParam)

Naam
Type
Vereist
Beschrijving
companyHandle
xsd:tekenreeks
Ja
Handgreep aan het bedrijf het vignet tot behoort.
name
Codewoordgroep
Ja
Naam om de indeling voor het publiceren van het vignet te identificeren.
targetWidth
Codewoordgroep
Ja

Geeft de doelbreedte van de resulterende vignetweergave op in pixels.

Gebruik nul, zodat het uitvoervignet dezelfde grootte heeft als het primaire vignet.

targetHeight
Codewoordgroep
Ja
Hiermee maakt u een piramidevignet dat is geoptimaliseerd voor zoomen op de server voor het renderen van afbeeldingen. Vanaf de maximale grootte, ingesteld door de velden Doelgrootte vignet, maakt dit meerdere grootteweergaven in één vignetuitvoerbestand. Elke volgende weergavegrootte wordt gehalveerd totdat de breedte en hoogte binnen 128 x 128 pixels liggen.
createPyramid
Codewoordgroep
Ja
Geeft de breedte van elke resulterende miniatuur in pixels aan. Deze instelling is optioneel. Geen miniatuurbestand gebruiken als nul.
thumbWidth
Codewoordgroep
Ja
Hier geeft u de bestandsindeling voor de gepubliceerde vignetten op. Op basis van een nieuwe versie van Image Authoring en een oudere versie van de Image Rendering Server moet u een vignetversie opgeven die uw ImageRendering Server kan lezen. Als u een hogere versie opgeeft, kan de server voor het renderen van afbeeldingen de gepubliceerde vignetten niet lezen. Stel dit in op nul om vignetten te publiceren in de meest recente versie.
saveAsVersion
Codewoordgroep
Ja
Hiermee geeft u het teken op dat wordt gescheiden door de naam van het vignet en het achtervoegsel dat de breedte aangeeft.
sizeSuffixSeparator
Codewoordgroep
Ja
Hiermee geeft u het teken op dat wordt gescheiden door de naam van het vignet en het achtervoegsel dat de breedte aangeeft.
verscherpen
Codewoordgroep
Nee
Hiermee past u verscherping toe op de hoofdafbeelding van de weergave voor elke verscherping van het vignet, waardoor vervaging kan worden gecompenseerd wanneer de vignetters worden geschaald.
usmAmount
Codewoordgroep
Ja
Digitaal onscherp maskeren is een flexibele en krachtige manier om de scherpte te verhogen, vooral in gescande afbeeldingen. Hiermee bepaalt u de grootte van elke overschrijding (hoeveel donkerder en licht de randen worden).
usmRadius
Codewoordgroep
Ja
Heeft invloed op de grootte van de randen die moeten worden vergroot of op de breedte van de randranden, zodat een kleiner radium de details op kleinere schaal verbetert. Hogere straalwaarden kunnen halo's aan de randen veroorzaken. Voor fijne details is een kleinere straal nodig, omdat kleine details van dezelfde grootte of kleiner dan de straal verloren gaan.
usmThreshold
Codewoordgroep
Ja
Hiermee bepaalt u de minimale helderheidswijziging die moet worden verscherpt of de afstand tussen aangrenzende toonwaarden voordat het filter werkt. Met deze instelling kunt u scherpere randen verscherpen terwijl u subtielere randen ongewijzigd laat. Het toegestane bereik van de drempelwaarde 0 tot en met 255.

Output (createVignetPublishFormatReturn)

Naam
Type
Vereist
Beschrijving
vignetteFormatHandle
xsd:string
Ja
De handgreep naar de gemaakte vignetindeling.

Voorbeelden section-0564752d439642b9bb8de2903db6de1e

Met deze code maakt u een vignetpublicatie-indeling. In de aanmaakaanvraag worden een naam, doelbreedte en -hoogte en andere vereiste waarden opgegeven.

Verzoek

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

Antwoord

<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