需要
创建对象:
- 开发人员
- 用户
请求类型。 指定请求的数据类型。
req=debug|contents|img|imageprops|map|object|props|userdata|validate
调试 | 在调试模式下运行命令。 |
内容 | 返回有关晕影中对象的信息。 |
img | 运行命令并返回渲染的图像。 |
imageprops | 返回指定晕影的属性。 |
映射 | 返回晕影中嵌入的图像映射数据。 |
对象 | 运行命令并将蒙版的渲染图像返回到当前对象选择。 |
prop | 运行命令并返回回复图像的属性。 |
用户数据 | 返回晕影::UserData 的内容。 |
除非在详细说明中另有说明,否则服务器将返回MIME类型为<text/plain>的文本响应。
debug
执行指定的命令并返回渲染的图像。 如果发生错误,将返回错误和调试信息,而不是错误图像( attribute::ErrorImagePath
)。
contents
返回晕影中对象层次结构的XML表示形式,包括所选对象属性。 请求中的其他命令将被忽略。
img
执行指定的命令并返回渲染的图像。 回复数据格式和响应类型由fmt=
确定。
imageprops
返回在URL路径中指定的晕影文件或目录条目的所选属性。 有关回复语法和响应MIME类型的说明,请参阅属性。 请求中的其他命令将被忽略。 将返回以下属性:
属性 | 类型 | 说明 |
---|---|---|
image.expiration | 多次 | 属性::过期时间或默认生存时间。 |
image.height | 整型 | 以像素为单位的完整分辨率高度。 |
image.iccProfile | 字符串型 | 与此晕影关联的配置文件的名称/描述。 |
image.embeddedIccProfile | 布尔型 | 1(如果关联的配置文件嵌入在晕影中)。 |
image.embedded PhotoshopPaths | 布尔型 | 1(如果晕影嵌入了路径数据)。 |
image.modifier | 字符串型 | 属性::修饰符;如果不是目录条目,则为空。 |
image.pixTyp | 枚举 | 响应图像的像素类型;可以是“CMYK”、“RGB”或“BW”(适用于灰度图像)。 |
image.printRes | 实数 | 默认打印分辨率(以dpi为单位)。 |
image.timeStamp | 字符串型 | 修改日期/时间(来自目录::TimeStamp 或晕影文件)。 |
image.width | 整型 | 以像素为单位的完整分辨率宽度。 |
vignette.name | 字符串型 | 晕影名称(根晕影对象的名称字符串)。 |
晕影.res | 实数 | 以材料分辨率单位(通常为像素/英寸)为单位的最大对象分辨率。 |
vignette.res.avg | 实数 | 以材质分辨率单位表示的平均对象分辨率(通常为像素/inc 材质分辨率h)。 |
vignette.res.min | 实数 | 以材料分辨率单位(通常为像素/英寸)为单位的最小对象分辨率。 |
晕影版本 | 整型 | 晕影文件版本号。 |
map
返回晕影中包含的图像映射数据。 默认情况下,将返回所有最外部组的映射数据。 可以使用获取所有最内层的组的映射数据
req=map&groupLevel=-1
映射数据未缩放到wid=
或hei=
或以其他方式修改。 响应MIME类型为<text/xml>
。
响应数据由包含一组<area>
元素的<map>
元素组成,类似于HTML<AREA>
标记。
每个<area>
元素都包含标准type=
和coord=
属性,以及指定晕影组名称或名称路径的name=
属性。 如果相应对象组的掩码具有不连续的区域,则存在多个同名的<area>
元素。
除了默认属性之外,如果已经创作,晕影还可以定义其他属性。 此类自定义属性被定义为对象组属性。 自定义属性的名称必须以map
开头,才能包含在<area>
元素中。 例如,如果组属性包括map.href=http://www.scene7.com
,则相应的<area>
元素包括href="http://www.scene7.com"
。
如果晕影不包含映射数据,则返回具有空<map>
元素的XML文档。
object
执行指定的命令并返回被剩余对象选择(请求中用最后sel=
或obj=
命令选择的组或对象)遮罩的渲染图像。 通常与支持Alpha的图像格式一起使用(请参阅fmt=)。 如果使用的图像格式不支持alpha,则蒙版外部的区域为黑色。
props
执行指定的命令并返回晕影属性和组或对象属性,而不是渲染的图像。 有关回复语法和响应MIME类型的说明,请参阅属性。 除非同时指定obj=
或sel=
,否则将应用默认选择(请参阅obj=
)。
响应中可能包含以下属性:
属性 | 类型 | 说明 |
---|---|---|
image.bgc | 字符串型 | 回复图像背景颜色。 |
image.height | 整型 | 回复图像高度(像素)。 |
image.iccEmbed | 布尔型 | 如果ICC配置文件嵌入到回复图像中,则为True(请参阅 iccEmbed=)。 |
image.iccProfile | 字符串型 | 与回复图像关联的配置文件的快捷方式名称(请参阅 icc=)。 |
image.mask | 布尔型 | 如果回复图像包含Alpha,则为True。 |
image.pathEmbed | 布尔型 | 如果回复图像包含路径数据,则为True(请参阅 pathEmbed=)。 |
image.pixTyp | 字符串型 | 回复图像类型,可以是“CMYK”、“RGB”或“BW”(用于灰度图像) |
image.printRes | 实数 | 打印分辨率(dpi) |
image.quality | 整数,布尔值 | JPEG质量和色度标志(请参阅 qlt=) |
image.type | 字符串型 | 回复图像的MIME类型(请参阅 fmt=)。 |
image.width | 整型 | 回复图像宽度(像素)。 |
选择。属性 | 字符串型 | 当前选择的属性字符串。 |
选择。计数 | 整型 | 当前选定内容中的对象数。 |
选择。缩进 | 整型 | 当前选定内容的缩进值。 |
选择选择。属性ion.name | 字符串型 | 当前对象选择的全名路径。 |
选择。重叠 | 整型 | 当前选定内容中的重叠对象数。 |
选择。可呈现 | 整型 | 当前选区中可呈现对象的数量。 |
选择。可纹理 | 整型 | 当前选定内容中的可纹理对象数。 |
选择。可见 | 整型 | 当前显示/隐藏当前选择的状态。 |
选择.zorder | 整型 | 当前选择中第一个重叠对象的Z顺序值。 |
userdata
返回vignette::UserData
的内容。 服务器将vignette::UserData
中所有出现的'??'
替换为行终止符(<cr><lf>
)。 在响应MIME类型设置为<text/plain>的情况下,将回复格式化为文本数据。
如果URL路径中指定的对象未解析为有效的晕影映射条目,或者vignette::UserData
为空,则回复仅包含行终止符(CR/LF
)。
请求字符串中的任何其他命令都将被忽略。
属性
请求命令。 可能出现在请求字符串中的任何位置。
默认
如果URL不包含图像路径或修改符,则:
#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.