DocumentatieDynamic Media Image Serving and Rendering API

req req

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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

debug
Voer opdrachten uit in de foutopsporingsmodus.
contents
Retourneer informatie over de objecten in het vignet.
img
Voer de opdrachten uit en retourneer de gerenderde afbeelding.
imageprops
Retourneert eigenschappen van het opgegeven vignet.
map
Retourneert afbeeldingskaartgegevens die zijn ingesloten in het vignet.
object
Voer de opdrachten uit en retourneer de gerenderde afbeelding die is gemaskeerd aan de huidige objectselectie.
props
Voer de opdrachten uit en retourneer de eigenschappen van de antwoordafbeelding.
userdata
Retourneert 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. De indeling van de antwoordgegevens en het type reactie 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 Eigenschappenvoor een beschrijving van de antwoordsyntaxis en reactie MIME type. Andere opdrachten in de aanvraag worden genegeerd. De volgende eigenschappen worden geretourneerd:

Eigenschap
Type
Beschrijving
image.expiration
Dubbel
attribute::Expiration of de standaardtijd om te leven.
image.height
Geheel
Hoogte volledige resolutie in pixels.
image.iccProfile
String
naam/beschrijving van het profiel dat aan dit vignet is gekoppeld.
image.embeddedIcProfile
Boolean
1 als het bijbehorende profiel is ingesloten in het vignet.
image.embedded PhotoshopPaths
Boolean
1 als het vignet padgegevens insluit.
image.modifier
String
attribute::Modifier of leeg als het geen catalogusitem is.
image.pixType
Enum
Pixeltype van de reactieafbeelding; kan 'CMYK', 'RGB' of 'BW' zijn (voor grijswaardenafbeeldingen).
image.printRes
Real
Standaardafdrukresolutie in dpi.
image.timeStamp
String
Wijzigingsdatum/-tijd (vanuit catalogus::TimeStamp of het vignetbestand).
image.width
Geheel
Breedte volledige resolutie in pixels.
vignet.name
String
Vignetnaam (naamreeks van het hoofdvignetobject).
vignette.res
Real
Maximale objectresolutie in eenheden met materiaalresolutie(doorgaans pixels/inch).
vignet.res.avg
Real
Gemiddelde objectresolutie in materiaalresolutie-eenheden (doorgaans pixels/inch materiaalresolutieh).
vignet.res.min
Real
Minimale objectresolutie in eenheden met materiaalresolutie(doorgaans pixels/inch).
vignet.version
Geheel
Versie 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 type response MIME is <text/xml> .

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

Elk <area> -element bevat de standaardkenmerken type= en coord= en een name= -kenmerk, waarmee de naam of het naampad van de vignetgroep wordt opgegeven. Er zijn meerdere <area> -elementen met dezelfde naam 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 om te worden opgenomen in de <area> -elementen. Als de groepskenmerken bijvoorbeeld map.href=http://www.scene7.com bevatten, bevat het bijbehorende <area> element href="http://www.scene7.com" .

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

object

Voert de opgegeven opdrachten uit en retourneert de gerenderde afbeelding die is gemaskeerd door de selectie van het resterende object (de groep of het object dat is geselecteerd met de laatste opdracht sel= of obj= in de aanvraag). Typisch gebruikt met een beeldformaat dat alpha steunt (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 Eigenschappenvoor een beschrijving van de antwoordsyntaxis en het type van reactie MIME. De standaardselectie is van toepassing, tenzij obj= of sel= ook wordt opgegeven (zie obj= ).

De volgende eigenschappen kunnen in de reactie worden opgenomen:

Eigenschap
Type
Beschrijving
image.bgc
String
Achtergrondkleur afbeelding beantwoorden.
image.height
Geheel
Hoogte van afbeelding reageren in pixels.
image.iccEmbed
Boolean
True if the ICC profile is embedded in the response image (see iccEmbed=).
image.iccProfile
String
Naam van snelkoppeling van het profiel dat is gekoppeld aan de antwoordafbeelding (zie icc=).
image.mask
Boolean
True if the response image includes alpha.
image.pathEmbed
Boolean
True als de antwoordafbeelding padgegevens bevat (zie pathEmbed=).
image.pixType
String
Afbeeldingstype Reageren, kan 'CMYK', 'RGB' of 'BW' zijn (voor grijswaardenafbeeldingen)
image.printRes
Real
Afdrukresolutie (dpi)
image.quality
Geheel getal, Boolean
JPEG-markering voor kwaliteit en chroom (zie qlt=)
image.type
String
MIME-type voor de antwoordafbeelding (zie fmt=).
image.width
Geheel
Breedte van afbeelding beantwoorden in pixels.
selection.attributes
String
Kenmerktekenreeks voor de huidige selectie.
selection.count
Geheel
Aantal objecten in de huidige selectie.
selection.ident
Geheel
Inspringingswaarde van de huidige selectie.
select selection.attributes ion.name
String
Pad met volledige naam van de huidige objectselectie.
selection.overlapping
Geheel
aantal overlappende objecten in de huidige selectie.
selection.renderable
Geheel
Aantal renderbare objecten in de huidige selectie.
selection.texturable
Geheel
Aantal tekstuele objecten in de huidige selectie.
selection.visible
Geheel
Huidige status van de huidige selectie tonen/verbergen.
selection.zorder
Geheel
De Z-volgorde van het eerste overlappende object in de huidige selectie.

userdata

Retourneert de inhoud van vignette::UserData . De server vervangt alle instanties van '??' in vignette::UserData door regelafsluiters ( <cr><lf> ). De reactie 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 geldig item voor een vignettoewijzing, of als de vignette::UserData leeg is, bevat de reactie alleen een regelafsluiter ( CR/LF ).

Eventuele andere opdrachten in de tekenreeks request worden genegeerd.

Eigenschappen section-e44092e190ff4f6380583e8ed6ea5b0b

Verzoek, opdracht. Kan overal in het verzoekkoord voorkomen.

Standaard section-00c593cbf1af4364b6b78812e6b93c64

Als de URL geen afbeeldingspad of wijzigingstoetsen bevat, geldt het volgende:

#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.

Anders, req=img

Zie ook section-f7a955525fb44ef2ae7cd7ede25a96c3

fmt=, attributen::ErrorImagePath, vignet::UserData, Eigenschappen

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49