DocumentaçãoAPI de disponibilização e renderização de imagens do Dynamic Media

solic req

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined

Tipo de solicitação. Especifica o tipo de dados solicitados.

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

depuração
Execute comandos no modo de depuração.
conteúdo
Retornar informações sobre os objetos na vinheta.
img
Execute comandos e retorne a imagem renderizada.
imageprops
Retorna as propriedades da vinheta especificada.
mapa
Retorna os dados do mapa de imagem incorporados na vinheta.
objeto
Execute comandos e retorne a imagem renderizada mascarada para a seleção de objeto atual.
propriedades
Execute comandos e retorne propriedades da imagem de resposta.
userdata
Retorna o conteúdo da vinheta::DadosUsuário .

A menos que seja observado de outra forma nas descrições detalhadas, o servidor retorna respostas de texto com o tipo MIME <text/plain>.

debug

Executa os comandos especificados e retorna a imagem renderizada. Se ocorrer um erro, as informações de erro e depuração serão retornadas em vez da imagem de erro ( attribute::ErrorImagePath).

contents

Retorna uma representação XML da hierarquia de objetos na vinheta, incluindo atributos de objetos selecionados. Outros comandos na solicitação são ignorados.

img

Executa os comandos especificados e retorna a imagem renderizada. O formato de dados de resposta e o tipo de resposta são determinados por fmt=.

imageprops

Retorna as propriedades selecionadas do arquivo de vinheta ou da entrada de catálogo especificada no caminho do URL. Consulte Propriedades para obter uma descrição da sintaxe de resposta e do tipo MIME de resposta. Outros comandos na solicitação são ignorados. As seguintes propriedades são retornadas:

Propriedade
Tipo
Descrição
image.expiration
Duplo
atributo::Expiration ou a hora padrão de vida.
image.height
Integer
Altura total da resolução em pixels.
image.iccProfile
String
nome/descrição do perfil associado a esta vinheta.
image.embeddedIccProfile
Booleano
1 se o perfil associado estiver incorporado na vinheta.
image.embedded PhotoshopPaths
Booleano
1 se a vinheta incorporar dados de caminho.
image.modifier
String
atributo::Modificador ou vazio se não for uma entrada de catálogo.
image.pixType
Enum
Tipo de pixel da imagem de resposta; pode ser 'CMYK', 'RGB' ou 'BW' (para imagens em tons de cinza).
image.printRes
Real
Resolução de impressão padrão em dpi.
image.timeStamp
String
Data/hora de modificação (do catálogo::TimeStamp ou do arquivo de vinheta).
image.width
Integer
Largura total da resolução em pixels.
vignette.name
String
Nome da vinheta (string de nome do objeto de vinheta raiz).
vignette.res
Real
Resolução máxima do objeto em unidades de resolução de material(normalmente pixels/polegada).
vignette.res.avg
Real
Resolução média do objeto em unidades de resolução de material(normalmente pixels/inc resolução de materialh).
vignette.res.min
Real
Resolução mínima do objeto em resolução do materialunidades (normalmente pixels/polegada).
vignette.version
Integer
Número da versão do arquivo de vinheta.

map

Retorna os dados do mapa de imagem incluídos na vinheta. Por padrão, os dados do mapa de todos os grupos mais externos são retornados. Os dados do mapa de todos os grupos internos podem ser obtidos com

req=map&groupLevel=-1

Os dados do mapa não estão dimensionados para wid= ou hei= ou modificados de outra forma. O tipo MIME de resposta é <text/xml>.

Os dados de resposta consistem em um elemento <map> contendo um conjunto de elementos <area>, semelhante à marca HTML <AREA>.

Cada elemento <area> inclui os atributos type= e coord= padrão e um atributo name=, especificando o nome do grupo de vinhetas ou o caminho do nome. Vários elementos <area> com o mesmo nome estarão presentes se as máscaras do grupo de objetos correspondente tiverem regiões descontínuas.

Além dos atributos padrão, as vinhetas podem definir atributos adicionais, se criados. Esses atributos personalizados são definidos como atributos de grupo de objetos. Os nomes de atributos personalizados devem começar com map para serem incluídos nos elementos <area>. Por exemplo, se os atributos do grupo incluírem map.href=http://www.scene7.com, o elemento <area> correspondente incluirá href="http://www.scene7.com".

Um documento XML com um elemento <map> vazio será retornado se a vinheta não incluir dados de mapa.

object

Executa os comandos especificados e retorna a imagem renderizada mascarada pela seleção de objeto residual (o grupo ou objeto selecionado com o último comando sel= ou obj= na solicitação). Normalmente é usado com um formato de imagem que suporta alfa (veja fmt=). Se um formato de imagem que não suporte alfa for usado, as áreas fora da máscara ficarão pretas.

props

Executa os comandos especificados e retorna as propriedades da vinheta e do grupo ou objeto, em vez da imagem renderizada. Consulte Propriedades para obter uma descrição da sintaxe de resposta e do tipo MIME de resposta. A seleção padrão se aplica a menos que obj= ou sel= também seja especificado (consulte obj=).

As seguintes propriedades podem ser incluídas na resposta:

Propriedade
Tipo
Descrição
image.bgc
String
Cor de fundo da imagem de resposta.
image.height
Integer
Altura da imagem de resposta em pixels.
image.iccEmbed
Booleano
Verdadeiro se o perfil ICC estiver inserido na imagem de resposta (consulte iccEmbed=).
image.iccProfile
String
Nome de atalho do perfil associado à imagem de resposta (consulte icc=).
image.mask
Booleano
Verdadeiro se a imagem de resposta incluir alfa.
image.pathEmbed
Booleano
True se a imagem de resposta incluir dados de caminho (consulte pathEmbed=).
image.pixType
String
Tipo de imagem de resposta, pode ser "CMYK", "RGB" ou "BW" (para imagens em tons de cinza)
image.printRes
Real
Resolução de impressão (dpi)
image.quality
Inteiro, booleano
Qualidade de JPEG e sinalizador de chroma (consulte qlt=)
image.type
String
Tipo MIME para a imagem de resposta (consulte fmt=).
image.width
Integer
Largura da imagem de resposta em pixels.
selection.attributes
String
String de atributos para a seleção atual.
selection.count
Integer
Número de objetos na seleção atual.
selection.ident
Integer
Valor de recuo da seleção atual.
selecione selection.attributes ion.name
String
Caminho do nome completo da seleção de objeto atual.
selection.overlapping
Integer
número de objetos sobrepostos na seleção atual.
selection.renderable
Integer
Número de objetos renderizáveis na seleção atual.
selection.texturable
Integer
Número de objetos texturáveis na seleção atual.
selection.visible
Integer
Status atual de mostrar/ocultar da seleção atual.
selection.zorder
Integer
Valor da ordem Z do primeiro objeto de sobreposição na seleção atual.

userdata

Retorna o conteúdo de vignette::UserData. O servidor substitui todas as ocorrências de '??' em vignette::UserData por terminadores de linha ( <cr><lf>). A resposta é formatada como dados de texto com o tipo MIME de resposta definido como <text/plain>.

Se o objeto especificado no caminho da URL não for resolvido para uma entrada de mapa de vinheta válida ou se vignette::UserData estiver vazio, a resposta conterá apenas um terminador de linha ( CR/LF).

Quaisquer outros comandos na string de solicitação são ignorados.

Propriedades section-e44092e190ff4f6380583e8ed6ea5b0b

Comando Solicitar. Pode ocorrer em qualquer lugar na string de solicitação.

Padrão section-00c593cbf1af4364b6b78812e6b93c64

Se o URL não incluir um caminho de imagem ou modificadores, então:

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

Caso contrário, req=img

Consulte também section-f7a955525fb44ef2ae7cd7ede25a96c3

fmt= , attribute::ErrorImagePath, vignette::UserData, Properties

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