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

solic

Última atualização: 20 de julho de 2024
  • Tópicos:

Criado para:

  • Desenvolvedor
  • Usuário

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

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

depuraçãoExecute comandos no modo de depuração.
conteúdoRetornar informações sobre os objetos na vinheta.
imgExecute comandos e retorne a imagem renderizada.
imagepropsRetorna as propriedades da vinheta especificada.
mapaRetorna os dados do mapa de imagem incorporados na vinheta.
objetoExecute comandos e retorne a imagem renderizada mascarada para a seleção de objeto atual.
propriedadesExecute comandos e retorne propriedades da imagem de resposta.
userdataRetorna 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:

PropriedadeTipoDescrição
image.expirationDuploatributo::Expiration ou a hora padrão de vida.
image.heightIntegerAltura total da resolução em pixels.
image.iccProfileStringnome/descrição do perfil associado a esta vinheta.
image.embeddedIccProfileBooleano1 se o perfil associado estiver incorporado na vinheta.
image.embedded PhotoshopPathsBooleano1 se a vinheta incorporar dados de caminho.
image.modifierStringatributo::Modificador ou vazio se não for uma entrada de catálogo.
image.pixTypeEnumTipo de pixel da imagem de resposta; pode ser 'CMYK', 'RGB' ou 'BW' (para imagens em tons de cinza).
image.printResRealResolução de impressão padrão em dpi.
image.timeStampStringData/hora de modificação (do catálogo::TimeStamp ou do arquivo de vinheta).
image.widthIntegerLargura total da resolução em pixels.
vignette.nameStringNome da vinheta (string de nome do objeto de vinheta raiz).
vignette.resRealResolução máxima do objeto em unidades de resolução de material(normalmente pixels/polegada).
vignette.res.avgRealResolução média do objeto em unidades de resolução de material(normalmente pixels/inc resolução de materialh).
vignette.res.minRealResolução mínima do objeto em resolução do materialunidades (normalmente pixels/polegada).
vignette.versionIntegerNú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:

PropriedadeTipoDescrição
image.bgcStringCor de fundo da imagem de resposta.
image.heightIntegerAltura da imagem de resposta em pixels.
image.iccEmbedBooleanoVerdadeiro se o perfil ICC estiver inserido na imagem de resposta (consulte iccEmbed=).
image.iccProfileStringNome de atalho do perfil associado à imagem de resposta (consulte icc=).
image.maskBooleanoVerdadeiro se a imagem de resposta incluir alfa.
image.pathEmbedBooleanoTrue se a imagem de resposta incluir dados de caminho (consulte pathEmbed=).
image.pixTypeStringTipo de imagem de resposta, pode ser "CMYK", "RGB" ou "BW" (para imagens em tons de cinza)
image.printResRealResolução de impressão (dpi)
image.qualityInteiro, booleanoQualidade de JPEG e sinalizador de chroma (consulte qlt=)
image.typeStringTipo MIME para a imagem de resposta (consulte fmt=).
image.widthIntegerLargura da imagem de resposta em pixels.
selection.attributesStringString de atributos para a seleção atual.
selection.countIntegerNúmero de objetos na seleção atual.
selection.identIntegerValor de recuo da seleção atual.
selecione selection.attributes ion.nameStringCaminho do nome completo da seleção de objeto atual.
selection.overlappingIntegernúmero de objetos sobrepostos na seleção atual.
selection.renderableIntegerNúmero de objetos renderizáveis na seleção atual.
selection.texturableIntegerNúmero de objetos texturáveis na seleção atual.
selection.visibleIntegerStatus atual de mostrar/ocultar da seleção atual.
selection.zorderIntegerValor 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

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

Padrão

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

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

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