req

마지막 업데이트: 2024년 7월 22일
  • 주제:

작성 대상:

  • 개발자
  • 사용자

요청 유형. 요청한 데이터 형식을 지정합니다.

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

디버그디버그 모드에서 명령을 실행합니다.
콘텐츠비네팅에 있는 개체에 대한 정보를 반환합니다.
명령을 실행하고 렌더링된 이미지를 반환합니다.
imageprops지정된 비네팅의 속성을 반환합니다.
맵비네팅에 포함된 이미지 맵 데이터를 반환합니다.
개체명령을 실행하고 현재 개체 선택에 마스킹된 렌더링된 이미지를 반환합니다.
prop명령을 실행하고 응답 이미지의 속성을 반환합니다.
사용자 데이터비네팅::UserData 의 내용을 반환합니다.

자세한 설명에 별도로 명시되지 않는 한, 서버는 MIME 유형 <text/plain>으로 텍스트 응답을 반환합니다.

debug

지정된 명령을 실행하고 렌더링된 이미지를 반환합니다. 오류가 발생하면 오류 이미지(attribute::ErrorImagePath) 대신 오류 및 디버그 정보가 반환됩니다.

contents

선택한 객체 속성을 포함하여 비네팅에서 객체 계층의 XML 표현을 반환합니다. 요청의 다른 명령은 무시됩니다.

img

지정된 명령을 실행하고 렌더링된 이미지를 반환합니다. 응답 데이터 형식 및 응답 형식은 fmt=에 의해 결정됩니다.

imageprops

URL 경로에 지정된 비네팅 파일 또는 카탈로그 항목의 선택한 속성을 반환합니다. 응답 구문 및 응답 MIME 유형에 대한 설명은 속성을 참조하십시오. 요청의 다른 명령은 무시됩니다. 다음 속성이 반환됩니다.

속성유형설명
이미지.만료Double특성::Expiration 또는 기본 TTL(Time to Live).
image.height정수픽셀 단위 전체 해상도 높이입니다.
image.iccProfile문자열이 비네팅과 연결된 프로필의 이름/설명입니다.
image.embeddedIccProfile부울연결된 프로필이 비네팅에 포함된 경우 1.
image.embedded PhotoshopPaths부울비네팅이 경로 데이터를 임베드하는 경우 1.
image.modifier문자열attribute::Modifier 또는 카탈로그 항목이 아닌 경우 비어 있음.
image.pixType열거형응답 이미지의 픽셀 유형. 'CMYK', 'RGB' 또는 'BW'(회색 음영 이미지의 경우)일 수 있습니다.
image.printRes실제기본 인쇄 해상도(dpi)입니다.
image.timeStamp문자열수정 날짜/시간( 카탈로그::TimeStamp 또는 비네팅 파일).
image.width정수전체 해상도 너비(픽셀 단위).
비네팅.이름문자열비네팅 이름(루트 비네팅 오브젝트의 이름 문자열)
비네팅.res실제최대 개체 해상도( 재질 해상도단위)입니다(일반적으로 픽셀/인치).
비네팅.res.avg실제재질 해상도단위의 평균 개체 해상도(일반적으로 픽셀/inc 재질 해상도h)입니다.
비네팅.res.min실제최소 개체 해상도( 재질 해상도단위)입니다(일반적으로 픽셀/인치).
비네팅.버전정수비네팅 파일 버전 번호입니다.

map

비네팅에 포함된 이미지 맵 데이터를 반환합니다. 기본적으로 모든 가장 바깥쪽 그룹에 대한 맵 데이터가 반환됩니다. 모든 가장 안쪽 그룹에 대한 맵 데이터는

req=map&groupLevel=-1

맵 데이터의 크기가 wid= 또는 hei=(으)로 조정되거나 수정되지 않았습니다. 응답 MIME 형식은 <text/xml>입니다.

응답 데이터는 HTML <AREA> 태그와 유사한 <area> 요소 집합을 포함하는 <map> 요소로 구성됩니다.

각 <area> 요소에는 표준 type= 및 coord= 특성과 비네팅 그룹 이름 또는 이름 경로를 지정하는 name= 특성이 포함되어 있습니다. 해당 개체 그룹의 마스크에 불연속 영역이 있는 경우 이름이 같은 여러 <area> 요소가 있습니다.

비네팅은 기본 속성 외에도 작성된 경우 추가 속성을 정의할 수 있습니다. 이러한 사용자 지정 속성을 객체 그룹 속성으로 정의합니다. 사용자 지정 특성의 이름은 map(으)로 시작해야 <area> 요소에 포함될 수 있습니다. 예를 들어 그룹 특성에 map.href=http://www.scene7.com이(가) 포함된 경우 해당 <area> 요소에 href="http://www.scene7.com"이(가) 포함됩니다.

비네팅에 맵 데이터가 포함되지 않으면 빈 <map> 요소가 있는 XML 문서가 반환됩니다.

object

지정된 명령을 실행하고 나머지 개체 선택(요청에서 마지막 sel= 또는 obj= 명령으로 선택한 그룹 또는 개체)으로 마스크된 렌더링된 이미지를 반환합니다. 일반적으로 알파를 지원하는 이미지 형식과 함께 사용됩니다(fmt= 참조). 알파를 지원하지 않는 이미지 형식을 사용하는 경우 마스크 외부의 영역은 검정색입니다.

props

지정된 명령을 실행하고 렌더링된 이미지가 아닌 비네팅 속성 및 그룹 또는 개체 속성을 반환합니다. 응답 구문 및 응답 MIME 유형에 대한 설명은 속성을 참조하십시오. obj= 또는 sel=도 지정되지 않는 한 기본 선택이 적용됩니다(obj= 참조).

다음 속성이 응답에 포함될 수 있습니다.

속성유형설명
image.bgc문자열응답 이미지 배경색입니다.
image.height정수응답 이미지 높이(픽셀 단위).
image.iccEmbed부울ICC 프로필이 응답 이미지에 포함된 경우 True입니다( iccEmbed=참조).
image.iccProfile문자열응답 이미지와 연결된 프로필의 바로 가기 이름( icc=참조).
image.mask부울응답 이미지에 알파가 포함되어 있으면 True입니다.
image.pathEmbed부울응답 이미지에 경로 데이터가 포함된 경우 True입니다( pathEmbed=참조).
image.pixType문자열응답 이미지 형식이며 'CMYK', 'RGB' 또는 'BW'(회색 음영 이미지의 경우)일 수 있습니다.
image.printRes실제인쇄 해상도(dpi)
image.quality정수, 부울JPEG 품질 및 크로마 플래그( qlt=참조)
image.type문자열응답 이미지에 대한 MIME 유형( fmt=참조).
image.width정수응답 이미지 너비(픽셀 단위).
selection.attributes문자열현재 선택 항목에 대한 속성 문자열입니다.
selection.count정수현재 선택 항목의 개체 수입니다.
selection.ident정수현재 선택 영역의 값을 들여씁니다.
선택 selection.attributes ion.name문자열현재 개체 선택 항목의 전체 이름 경로입니다.
선택.중복정수현재 선택 영역의 겹치는 오브젝트 수입니다.
선택.렌더링 가능정수현재 선택 항목의 렌더링 가능한 개체 수입니다.
selection.texturable정수현재 선택 영역의 텍스트 가능 개체 수입니다.
선택.표시정수현재 선택 항목의 현재 표시/숨기기 상태입니다.
selection.zorder정수현재 선택 영역에 있는 첫 번째 오버랩 오브젝트의 Z 순서 값입니다.

userdata

vignette::UserData의 내용을 반환합니다. 서버에서 vignette::UserData의 모든 '??'을(를) 줄 종결자(<cr><lf>)로 바꿉니다. 응답 MIME 유형이 <text/plain>으로 설정된 텍스트 데이터로 응답의 형식이 지정됩니다.

URL 경로에 지정된 개체가 유효한 비네팅 맵 항목으로 확인되지 않거나 vignette::UserData이(가) 비어 있는 경우 응답에는 줄 종결자(CR/LF)만 포함됩니다.

요청 문자열의 다른 모든 명령은 무시됩니다.