중첩 및 포함 요청

이미지 제공에서는 이미지 제공 요청의 무제한 중첩, 이미지 렌더링 요청의 포함, 외부 서버에서 검색된 이미지의 포함 등을 지원합니다. 이러한 메커니즘은 레이어 이미지 및 레이어 마스크만 지원합니다.

중첩 이미지 제공 요청

전체 이미지 제공 요청은에서 지정하여 레이어 소스로 사용할 수 있습니다. src= (또는 mask=) 다음 구문을 사용하는 명령입니다.

…&src=is( nestedRequest)&…

다음 is 토큰은 대/소문자를 구분합니다.

중첩 요청에는 서버 루트 경로가 포함되지 않아야 합니다(일반적으로). http:// *server*/is/image/').

사전 처리 규칙은 중첩 요청에 적용됩니다.

다음 명령은 중첩된 요청(요청 URL에서 또는 )에 지정될 때 무시됩니다 catalog::Modifier 또는 catalog::PostModifier):

• fmt=
• qlt=
• iccEmbed=
• printRes=
• quantize=
• req=
• bgc=

중첩된 요청의 결과 이미지에 마스크(알파) 데이터가 포함된 경우 레이어 마스크로 포함 레이어에 전달됩니다.

또한 무시됩니다. attribute::MaxPix및 attribute::DefaultPix 중첩된 요청에 적용되는 이미지 카탈로그의 수입니다.

중첩된 IS 요청의 이미지 결과는 다음을 포함하여 선택적으로 캐시할 수 있습니다. cache=on. 기본적으로 중간 데이터의 캐싱은 비활성화되어 있습니다. 적절한 기간 내에 중간 이미지를 다른 요청에서 재사용할 것으로 예상되는 경우에만 캐싱을 활성화해야 합니다. 표준 서버측 캐시 관리가 적용됩니다. 데이터는 무손실 형식으로 캐시됩니다.

포함된 이미지 렌더링 요청

서버에서 Dynamic Media 이미지 렌더링이 활성화되면 src=(또는 mask=) 명령에서 렌더링 요청을 지정하여 레이어 소스로 사용할 수 있습니다. 다음 구문을 사용합니다.

…&src=ir( *renderRequest*)&…

다음 ir 토큰은 대/소문자를 구분합니다.

renderRequest 는 HTTP 루트 경로를 제외한 일반적인 이미지 렌더링 요청입니다 http:// *server*/ir/render/.

중첩 요청에서 지정할 때 다음 이미지 렌더링 명령은 무시됩니다.

• fmt=
• qlt=
• icc=
• iccEmbed=
• printRes=
• req=

또한 무시됩니다. attribute::MaxPix 및 attribute::DefaultPix 중첩된 렌더링 요청에 적용되는 재질 카탈로그의 수입니다.

중첩된 IR 요청의 이미지 결과는 다음을 포함하여 선택적으로 캐시될 수 있습니다. cache=on. 기본적으로 중간 데이터의 캐싱은 비활성화되어 있습니다. 적절한 기간 내에 중간 이미지를 다른 요청에서 재사용할 것으로 예상되는 경우에만 캐싱을 활성화해야 합니다. 표준 서버측 캐시 관리가 적용됩니다. 데이터는 무손실 형식으로 캐시됩니다.

포함된 FXG 렌더링 요청

FXG 그래픽 렌더러(예: AGMServer)가 설치되고 이미지 제공에서 활성화되므로 FXG 요청을에서 지정하여 레이어 소스로 사용할 수 있습니다 src= (또는 mask=) 명령을 입력합니다. 다음 구문을 사용합니다.

…&src=fxg( renderRequest)&…

다음 fxg 토큰은 대/소문자를 구분합니다.

renderRequest 는 HTTP 루트 경로를 제외한 일반적인 FXG 렌더링 요청입니다. http:// *server*/agm/render/.

중첩 요청에서 지정할 때 다음 FXG 명령은 무시됩니다.

• fmt=
• qlt=
• icc=
• iccEmbed=
• cache=

외부 이미지 소스

이미지 제공은 외부 HTTP 서버의 소스 이미지에 대한 액세스를 지원합니다.

에 대한 외부 URL을 지정하려면 src= 또는 mask= 외래 URL 또는 URL 조각은 괄호로 묶어 구분하십시오.

…&src=( foreignUrl)&…

중요 구분 기호 문자( '(',')') 및 명령 구분 기호 문자( '?', '&', '='중첩된 요청 내에서 는 HTTP 인코딩이 아니어야 합니다. 사실상, 임베드된 요청들은 외부(임베딩) 요청과 동일하게 인코딩되어야 한다.

전체 절대 URL(다음의 경우) attribute::AllowDirectUrls 가 설정됨)이고, 상대 URL입니다 attribute::RootUrl 허용됩니다. 절대 URL이 포함되고 속성이 다음과 같은 경우 오류가 발생합니다. AllowDirectUrls 은 0이거나, 상대 URL이 지정된 경우 이고 attribute::RootUrl 은(는) 비어 있습니다.

요청 URL의 경로 구성 요소에 외부 URL을 직접 지정할 수는 없지만, 상대 경로를 절대 URL로 변환하는 전처리 규칙을 설정할 수 있습니다(아래 예 참조).

외부 이미지는 HTTP 응답에 포함된 캐싱 헤더에 따라 서버에 의해 캐시됩니다. 둘 다 ETag Last-Modified HTTP 응답 헤더가 없으면 응답이 캐시되지 않습니다. 이 경우 이미지 제공이 모든 액세스에서 이미지를 다시 가져오고 유효성을 다시 검사해야 하므로 동일한 외부 이미지에 대한 반복 액세스의 성능이 저하될 수 있습니다.

이 메커니즘은 구성 요소당 16비트가 있는 소스 이미지를 제외하고 이미지 변환 (IC) 유틸리티에서 지원하는 것과 동일한 이미지 파일 형식을 지원합니다.

제한 사항

중첩/임베드된 요청으로 생성된 이미지의 크기는 일반적으로 자동으로 최적화됩니다. 중첩된 요청 이미지 캐싱이 활성화되면 중첩된 이미지의 정확한 크기를 지정하여 점진적인 성능 향상을 실현할 수 있으므로 캐시 항목을 재사용할 때 더 이상의 확장이 필요하지 않습니다.

중요 이미지 제공에서는 중첩 요청이나 포함된 요청의 이중 인코딩을 지원하지 않습니다. 중첩된 요청과 포함된 요청은 단순 요청과 마찬가지로 HTTP 인코딩이 적용되어야 합니다.

예제

캐싱을 사용한 계층화 템플릿:

중첩을 사용하여 레이어 템플릿에 캐싱을 추가합니다. 제한된 수의 배경 이미지가 고도로 가변적인 텍스트로 오버레이됩니다. 초기 템플릿 문자열은 다음과 같습니다.

layer=0&src=$img$&size=300,300&layer=1&text=$txt$

약간의 수정 사항으로 레이어 0 이미지의 크기를 미리 조정하고 지속적으로 캐시하여 서버 로드를 줄일 수 있습니다.

layer=0&src=is(?src=$img$&size=300,300&cache=on)&layer=1&text=$txt$

Dynamic Media 이미지 렌더링에 대한 요청 포함

에 저장된 템플릿 사용 myCatalog/myTemplate: Dynamic Media 이미지 렌더링을 사용하여 템플릿의 레이어2에 대한 이미지를 생성합니다.

http://server/is/image/myCatalog/myTemplate?layer=2&src=ir(myRenderCatalog/myRenderObject?id=myIdValue&sel=group&src=is(myCatalog/myTexture1?res=30)&res=30)&wid=300

중첩된 중괄호를 확인합니다. 이미지 렌더링 요청은 반복 가능한 텍스처를 검색하도록 이미지 서비스 제공에 대한 호출을 임베드합니다.

참조

src= , 마스크=, 요청 전처리, 이미지 렌더링 참조, 템플릿, 이미지 서비스 제공 유틸리티