DocumentatieDynamic Media Image Production System API

createVignetPublishFormat

Laatst bijgewerkt: 8 maart 2022
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
  • Beheerder

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

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parameters

Input (createVignetPublishFormatParam)

NaamTypeVereistBeschrijving
companyHandlexsd:tekenreeksJaHandgreep aan het bedrijf het vignet tot behoort.
nameCodewoordgroepJaNaam om de indeling voor het publiceren van het vignet te identificeren.
targetWidthCodewoordgroepJa

Geeft de doelbreedte van de resulterende vignetweergave op in pixels.

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

targetHeightCodewoordgroepJaHiermee 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.
createPyramidCodewoordgroepJaGeeft de breedte van elke resulterende miniatuur in pixels aan. Deze instelling is optioneel. Geen miniatuurbestand gebruiken als nul.
thumbWidthCodewoordgroepJaHier 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.
saveAsVersionCodewoordgroepJaHiermee geeft u het teken op dat wordt gescheiden door de naam van het vignet en het achtervoegsel dat de breedte aangeeft.
sizeSuffixSeparatorCodewoordgroepJaHiermee geeft u het teken op dat wordt gescheiden door de naam van het vignet en het achtervoegsel dat de breedte aangeeft.
verscherpenCodewoordgroepNeeHiermee 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.
usmAmountCodewoordgroepJaDigitaal 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).
usmRadiusCodewoordgroepJaHeeft 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.
usmThresholdCodewoordgroepJaHiermee 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)

NaamTypeVereistBeschrijving
vignetteFormatHandlexsd:stringJaDe handgreep naar de gemaakte vignetindeling.

Voorbeelden

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