req

Última actualización: 22 de julio de 2024
  • Temas:

Creado para:

  • Desarrollador
  • Usuario

Tipo de solicitud. Especifica el tipo de datos solicitados.

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

depurarEjecute comandos en modo de depuración.
contenidoDevuelve información sobre los objetos de la viñeta.
imgEjecute comandos y devuelva la imagen procesada.
props de imagenDevuelve las propiedades de la viñeta especificada.
asignaciónDevuelve datos de mapa de imagen incrustados en la viñeta.
objetoEjecute comandos y devuelva la imagen procesada enmascarada a la selección de objeto actual.
propsEjecute comandos y devuelva propiedades de la imagen de respuesta.
datos de usuarioDevuelve 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:

PropiedadTipoDescripción
image.expirationDobleatributo::Caducidad o tiempo de vida predeterminado.
image.heightEnteroAltura de resolución completa en píxeles.
image.iccProfileCadenanombre/descripción del perfil asociado con esta viñeta.
image.embeddedIccProfileSí/No1 si el perfil asociado está incrustado en la viñeta.
image.embedded PhotoshopPathsSí/No1 si la viñeta incrusta los datos de ruta.
image.modifierCadenaAtributo ::Modificador o vacío si no es una entrada de catálogo.
image.pixTypeEnumeraciónTipo de píxel de la imagen de respuesta; puede ser 'CMYK', 'RGB' o 'BW' (para imágenes en escala de grises).
image.printResRealResolución de impresión predeterminada en ppp.
image.timeStampCadenaFecha y hora de modificación (del catálogo ::TimeStamp o el archivo de viñeta).
image.widthEnteroAncho de resolución completa en píxeles.
vignette.nameCadenaNombre de viñeta (cadena de nombre del objeto de viñeta raíz).
viñeta.resRealResolución de objeto máxima en unidades de resolución de material(normalmente píxeles/pulgada).
vignette.res.avgRealResolución media de objeto en unidades de resolución de material(normalmente píxeles/inc resolución de materialh).
vignette.res.minRealResolución mínima del objeto en resolución de materialunidades (normalmente píxeles/pulgada).
viñeta.versiónEnteroNú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:

PropiedadTipoDescripción
image.bgcCadenaColor de fondo de imagen de respuesta.
image.heightEnteroAltura de la imagen de respuesta en píxeles.
image.iccEmbedSí/NoTrue si el perfil ICC está incrustado en la imagen de respuesta (consulte iccEmbed=).
image.iccProfileCadenaNombre de acceso directo del perfil asociado con la imagen de respuesta (consulte icc=).
image.maskSí/NoTrue si la imagen de respuesta incluye alfa.
image.pathEmbedSí/NoTrue si la imagen de respuesta incluye datos de ruta de acceso (vea pathEmbed=).
image.pixTypeCadenaEl tipo de imagen de respuesta puede ser 'CMYK', 'RGB' o 'BW' (para imágenes en escala de grises)
image.printResRealResolución de impresión (ppp)
image.qualityEntero, booleanocalidad de JPEG e indicador de croma (consulte qlt=)
image.typeCadenaTipo MIME para la imagen de respuesta (consulte fmt=).
image.widthEnteroAncho de la imagen de respuesta en píxeles.
selection.attributesCadenaCadena de atributos de la selección actual.
selection.countEnteroNúmero de objetos de la selección actual.
selection.identEnteroAplicar sangría al valor de la selección actual.
selecciona selection.attributes ion.nameCadenaRuta de nombre completo de la selección de objeto actual.
selection.overlappingEnteronúmero de objetos de superposición en la selección actual.
selection.renderableEnteroNúmero de objetos procesables en la selección actual.
selection.texturableEnteroNúmero de objetos texturables de la selección actual.
selection.visibleEnteroEstado actual de mostrar/ocultar de la selección actual.
selection.zorderEnteroValor 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.