req

Laatst bijgewerkt: 4 november 2023
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
  • Gebruiker

Type aanvraag. Hier geeft u het type gevraagde gegevens op.

req=debug|contents|img|imageprops|map|object|props|userdata|validate

foutopsporingVoer opdrachten uit in de foutopsporingsmodus.
inhoudRetourneer informatie over de objecten in het vignet.
imgVoer de opdrachten uit en retourneer de gerenderde afbeelding.
imagepropsRetourneert eigenschappen van het opgegeven vignet.
mapRetourneert afbeeldingskaartgegevens die zijn ingesloten in het vignet.
objectVoer de opdrachten uit en retourneer de gerenderde afbeelding die is gemaskeerd aan de huidige objectselectie.
propsVoer de opdrachten uit en retourneer de eigenschappen van de antwoordafbeelding.
gebruikersgegevensRetourneert de inhoud van vignet::UserData .

Tenzij anders vermeld in de gedetailleerde beschrijvingen, retourneert de server tekstreacties met het MIME-type <text plain="">.

debug

Voert de opgegeven opdrachten uit en retourneert de gerenderde afbeelding. Als er een fout optreedt, worden de fout- en foutopsporingsgegevens geretourneerd in plaats van de foutafbeelding ( attribute::ErrorImagePath).

contents

Retourneert een XML-representatie van de objecthiërarchie in het vignet, inclusief geselecteerde objectkenmerken. Andere opdrachten in de aanvraag worden genegeerd.

img

Voert de opgegeven opdrachten uit en retourneert de gerenderde afbeelding. Het formaat en het type reactie van antwoordgegevens worden bepaald door fmt=.

imageprops

Hiermee worden de geselecteerde eigenschappen geretourneerd van het vignetbestand of de catalogusvermelding die is opgegeven in het URL-pad. Zie Eigenschappen voor een beschrijving van de antwoordsyntaxis en het MIME-type reactie. Andere opdrachten in de aanvraag worden genegeerd. De volgende eigenschappen worden geretourneerd:

EigenschapTypeBeschrijving
image.expirationDubbelkenmerk::Expiration of de standaardtijd om te leven.
image.heightGeheelHoogte volledige resolutie in pixels.
image.iccProfileStringnaam/beschrijving van het profiel dat aan dit vignet is gekoppeld.
image.embeddedIccProfileBoolean1 als het bijbehorende profiel is ingesloten in het vignet.
image.embedded PhotoshopPathsBoolean1 als het vignet padgegevens insluit.
image.modifierStringkenmerk:Modifier of leeg als er geen item uit de catalogus is.
image.pixTypeEnumPixeltype van de reactieafbeelding; kan 'CMYK', 'RGB' of 'BW' zijn (voor grijswaardenafbeeldingen).
image.printResRealStandaardafdrukresolutie in dpi.
image.timeStampStringWijzigingsdatum/-tijd (van catalogus::TimeStamp of het vignetbestand).
image.widthGeheelBreedte volledige resolutie in pixels.
vignet.nameStringVignetnaam (naamreeks van het hoofdvignetobject).
vignet.resRealMaximale objectresolutie in materiaalresolutieeenheden (doorgaans pixels/inch).
vignet.res.avgRealGemiddelde objectresolutie in materiaalresolutieeenheden (doorgaans pixels/inch) materiaalresolutieh).
vignet.res.minRealMinimale objectresolutie in materiaalresolutieeenheden (doorgaans pixels/inch).
vignet.versionGeheelVersie van vignetbestand.

map

Retourneert de afbeeldingskaartgegevens die in het vignet zijn opgenomen. Standaard worden de kaartgegevens voor alle buitenste groepen geretourneerd. De kaartgegevens voor alle binnenste groepen kunnen worden verkregen met

req=map&groupLevel=-1

De kaartgegevens worden niet geschaald naar wid= of hei= of anderszins gewijzigd. Het MIME-type reactie is <text/xml>.

De responsgegevens bestaan uit een <map> element met een set <area> elementen, vergelijkbaar met de HTML <AREA> -tag.

Elk <area> element bevat de standaard type= en coord= kenmerken en een name= -kenmerk, de naam of het naampad van de vignetgroep opgeven. Meerdere <area> elementen met dezelfde naam zijn aanwezig als de maskers van de overeenkomende objectgroep onderbroken gebieden hebben.

Naast de standaardkenmerken kunnen vignetten indien nodig aanvullende kenmerken definiëren. Dergelijke aangepaste kenmerken worden gedefinieerd als objectgroepkenmerken. De namen van aangepaste kenmerken moeten beginnen met map in de <area> elementen. Als de groepskenmerken bijvoorbeeld map.href=http://www.scene7.comde overeenkomstige <area> element include href="http://www.scene7.com".

Een XML-document met een lege <map> -element wordt geretourneerd als het vignet geen kaartgegevens bevat.

object

Hiermee worden de opgegeven opdrachten uitgevoerd en wordt de gerenderde afbeelding geretourneerd die is gemaskeerd door de selectie van het resterende object (de groep of het object dat is geselecteerd met de laatste sel= of obj= in de aanvraag). Wordt meestal gebruikt met een afbeeldingsindeling die alfa ondersteunt (zie fmt=). Als een afbeeldingsindeling wordt gebruikt die geen alfa ondersteunt, zijn de gebieden buiten het masker zwart.

props

Voert de opgegeven opdrachten uit en retourneert vigneteigenschappen en groep- of objecteigenschappen in plaats van de gerenderde afbeelding. Zie Eigenschappen voor een beschrijving van de antwoordsyntaxis en het MIME-type reactie. De standaardselectie is van toepassing tenzij obj= of sel= wordt ook opgegeven (zie obj=).

De volgende eigenschappen kunnen in de reactie worden opgenomen:

EigenschapTypeBeschrijving
image.bgcStringAchtergrondkleur afbeelding beantwoorden.
image.heightGeheelHoogte van afbeelding reageren in pixels.
image.iccEmbedBooleanTrue (waar) als het ICC-profiel is ingesloten in de antwoordafbeelding (zie iccEmbed=).
image.iccProfileStringNaam van snelkoppeling van het profiel dat is gekoppeld aan de antwoordafbeelding (zie icc=).
image.maskBooleanTrue if the response image includes alpha.
image.pathEmbedBooleanWaar (true) als de antwoordafbeelding padgegevens bevat (zie pathEmbed=).
image.pixTypeStringAfbeeldingstype Reageren, kan 'CMYK', 'RGB' of 'BW' zijn (voor grijswaardenafbeeldingen)
image.printResRealAfdrukresolutie (dpi)
image.qualityGeheel getal, BooleanJPEG-kwaliteit en chromamarkering (zie qlt=)
image.typeStringMIME-type voor de antwoordafbeelding (zie fmt=).
image.widthGeheelBreedte van afbeelding beantwoorden in pixels.
selection.attributesStringKenmerktekenreeks voor de huidige selectie.
selection.countGeheelAantal objecten in de huidige selectie.
selectie.incidentGeheelInspringingswaarde van de huidige selectie.
selecteren selection.attributes ion.nameStringPad met volledige naam van de huidige objectselectie.
selectie.overlappenGeheelaantal overlappende objecten in de huidige selectie.
selection.renderableGeheelAantal renderbare objecten in de huidige selectie.
selectie.tekentabelGeheelAantal tekstuele objecten in de huidige selectie.
selection.visibleGeheelHuidige status van de huidige selectie tonen/verbergen.
selection.zorderGeheelDe Z-volgorde van het eerste overlappende object in de huidige selectie.

userdata

Retourneert de inhoud van vignette::UserData. De server vervangt alle exemplaren van '??' in vignette::UserData met regeleinde ( <cr><lf>). Het antwoord is opgemaakt als tekstgegevens met het MIME-type van het antwoord ingesteld op <text plain="">.

Als het object dat is opgegeven in het URL-pad niet wordt omgezet in een geldige vignettoewijzingsvermelding, of als de waarde vignette::UserData is leeg, bevat het antwoord alleen een regelafsluiter ( CR/LF).

Eventuele andere opdrachten in de tekenreeks request worden genegeerd.