req
Creado para:
- Desarrollador
- Usuario
Tipo de solicitud. Especifica el tipo de datos solicitados.
req=debug|contents|img|imageprops|map|object|props|userdata|validate
depurar | Ejecute comandos en modo de depuración. |
contenido | Devuelve información sobre los objetos de la viñeta. |
img | Ejecute comandos y devuelva la imagen procesada. |
props de imagen | Devuelve las propiedades de la viñeta especificada. |
asignación | Devuelve datos de mapa de imagen incrustados en la viñeta. |
objeto | Ejecute comandos y devuelva la imagen procesada enmascarada a la selección de objeto actual. |
props | Ejecute comandos y devuelva propiedades de la imagen de respuesta. |
datos de usuario | Devuelve el contenido de la viñeta ::UserData . |
A menos que se indique lo contrario en las descripciones detalladas, el servidor devuelve respuestas de texto con tipo MIME <text/plain>.
debug
Ejecuta los comandos especificados y devuelve la imagen procesada. Si se produce un error, se devuelve información de error y de depuración en lugar de la imagen de error ( attribute::ErrorImagePath
).
contents
Devuelve una representación XML de la jerarquía de objetos de la viñeta, incluidos los atributos de objetos seleccionados. Otros comandos de la solicitud se ignoran.
img
Ejecuta los comandos especificados y devuelve la imagen procesada. El formato y el tipo de datos de respuesta están determinados por fmt=
.
imageprops
Devuelve las propiedades seleccionadas del archivo de viñeta o la entrada de catálogo especificada en la ruta de URL. Consulte Propiedades para obtener una descripción de la sintaxis de respuesta y el tipo MIME de respuesta. Otros comandos de la solicitud se ignoran. Se devuelven las siguientes propiedades:
Propiedad | Tipo | Descripción |
---|---|---|
image.expiration | Doble | atributo::Caducidad o tiempo de vida predeterminado. |
image.height | Entero | Altura de resolución completa en píxeles. |
image.iccProfile | Cadena | nombre/descripción del perfil asociado con esta viñeta. |
image.embeddedIccProfile | Sí/No | 1 si el perfil asociado está incrustado en la viñeta. |
image.embedded PhotoshopPaths | Sí/No | 1 si la viñeta incrusta los datos de ruta. |
image.modifier | Cadena | Atributo ::Modificador o vacío si no es una entrada de catálogo. |
image.pixType | Enumeración | Tipo de píxel de la imagen de respuesta; puede ser 'CMYK', 'RGB' o 'BW' (para imágenes en escala de grises). |
image.printRes | Real | Resolución de impresión predeterminada en ppp. |
image.timeStamp | Cadena | Fecha y hora de modificación (del catálogo ::TimeStamp o el archivo de viñeta). |
image.width | Entero | Ancho de resolución completa en píxeles. |
vignette.name | Cadena | Nombre de viñeta (cadena de nombre del objeto de viñeta raíz). |
viñeta.res | Real | Resolución de objeto máxima en unidades de resolución de material(normalmente píxeles/pulgada). |
vignette.res.avg | Real | Resolución media de objeto en unidades de resolución de material(normalmente píxeles/inc resolución de materialh). |
vignette.res.min | Real | Resolución mínima del objeto en resolución de materialunidades (normalmente píxeles/pulgada). |
viñeta.versión | Entero | Número de versión del archivo de viñeta. |
map
Devuelve los datos de mapa de imagen incluidos en la viñeta. De forma predeterminada, se devuelven los datos de asignación de todos los grupos exteriores. Los datos de asignación de todos los grupos más internos se pueden obtener con
req=map&groupLevel=-1
Los datos del mapa no se han escalado a wid=
o hei=
, ni se han modificado. El tipo MIME de respuesta es <text/xml>
.
Los datos de respuesta constan de un elemento <map>
que contiene un conjunto de elementos <area>
, similar a la etiqueta de HTML <AREA>
.
Cada elemento <area>
incluye los atributos estándar type=
y coord=
, así como un atributo name=
que especifica el nombre o la ruta de acceso del grupo de viñetas. Hay varios elementos <area>
con el mismo nombre si las máscaras del grupo de objetos correspondiente tienen regiones discontinuas.
Además de los atributos predeterminados, las viñetas pueden definir atributos adicionales si se crean. Estos atributos personalizados se definen como atributos de grupo de objetos. Los nombres de los atributos personalizados deben comenzar por map
para que se incluyan en los elementos <area>
. Por ejemplo, si los atributos del grupo incluyen map.href=http://www.scene7.com
, el elemento <area>
correspondiente incluye href="http://www.scene7.com"
.
Se devuelve un documento XML con un elemento <map>
vacío si la viñeta no incluye datos de asignación.
object
Ejecuta los comandos especificados y devuelve la imagen procesada enmascarada por la selección de objeto residual (el grupo u objeto seleccionado con el último comando sel=
o obj=
de la solicitud). Se suele usar con un formato de imagen que admite alfa (consulte fmt=). Si se utiliza un formato de imagen que no admite alfa, las áreas fuera de la máscara son de color negro.
props
Ejecuta los comandos especificados y devuelve propiedades de viñeta y propiedades de grupo u objeto, en lugar de la imagen procesada. Consulte Propiedades para obtener una descripción de la sintaxis de respuesta y el tipo MIME de respuesta. La selección predeterminada se aplica a menos que obj=
o sel=
también se especifiquen (consulte obj=
).
En la respuesta pueden incluirse las siguientes propiedades:
Propiedad | Tipo | Descripción |
---|---|---|
image.bgc | Cadena | Color de fondo de imagen de respuesta. |
image.height | Entero | Altura de la imagen de respuesta en píxeles. |
image.iccEmbed | Sí/No | True si el perfil ICC está incrustado en la imagen de respuesta (consulte iccEmbed=). |
image.iccProfile | Cadena | Nombre de acceso directo del perfil asociado con la imagen de respuesta (consulte icc=). |
image.mask | Sí/No | True si la imagen de respuesta incluye alfa. |
image.pathEmbed | Sí/No | True si la imagen de respuesta incluye datos de ruta de acceso (vea pathEmbed=). |
image.pixType | Cadena | El tipo de imagen de respuesta puede ser 'CMYK', 'RGB' o 'BW' (para imágenes en escala de grises) |
image.printRes | Real | Resolución de impresión (ppp) |
image.quality | Entero, booleano | calidad de JPEG e indicador de croma (consulte qlt=) |
image.type | Cadena | Tipo MIME para la imagen de respuesta (consulte fmt=). |
image.width | Entero | Ancho de la imagen de respuesta en píxeles. |
selection.attributes | Cadena | Cadena de atributos de la selección actual. |
selection.count | Entero | Número de objetos de la selección actual. |
selection.ident | Entero | Aplicar sangría al valor de la selección actual. |
selecciona selection.attributes ion.name | Cadena | Ruta de nombre completo de la selección de objeto actual. |
selection.overlapping | Entero | número de objetos de superposición en la selección actual. |
selection.renderable | Entero | Número de objetos procesables en la selección actual. |
selection.texturable | Entero | Número de objetos texturables de la selección actual. |
selection.visible | Entero | Estado actual de mostrar/ocultar de la selección actual. |
selection.zorder | Entero | Valor del orden Z del primer objeto de superposición de la selección actual. |
userdata
Devuelve el contenido de vignette::UserData
. El servidor reemplaza todas las ocurrencias de '??'
en vignette::UserData
con terminadores de línea ( <cr><lf>
). La respuesta tiene el formato de datos de texto con el tipo MIME de respuesta establecido en <text/plain>.
Si el objeto especificado en la ruta de acceso URL no se resuelve en una entrada de mapa de viñeta válida, o si vignette::UserData
está vacío, la respuesta solo contiene un terminador de línea ( CR/LF
).
Los demás comandos de la cadena de solicitud se omiten.
Propiedades
Solicitar comando. Puede producirse en cualquier lugar de la cadena de solicitud.
Predeterminado
Si la dirección URL no incluye una ruta de imagen o modificadores, haga lo siguiente:
#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.
De lo contrario, req=img
Véase también
fmt= , atributo::ErrorImagePath, viñeta::UserData, Propiedades