SVG 지원 svg-support

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자
사용자

이미지 제공은 확장 가능한 벡터 그래픽(SVG) 파일을 소스 데이터로 지원합니다. SVG 1.1을 준수해야 합니다.

이미지 제공에서는 정적 SVG 콘텐츠만 인식합니다. 애니메이션, 스크립팅 및 기타 대화형 콘텐츠는 지원되지 않습니다.

이미지 파일이 허용되는 모든 위치에 SVG을 지정할 수 있습니다(URL 경로, src= 및 mask=). SVG 파일의 내용이 래스터화된 후에는 이미지처럼 처리됩니다.

이미지와 유사하게 SVG 파일은 이미지 카탈로그 항목 또는 상대 파일 경로로 지정할 수 있습니다.

대체 변수 section-83b149f13f244193901df39b204c975b

$ *var*$ 대체 변수는 값 문자열 <text> 요소 및 모든 요소 특성의 SVG 파일에 포함될 수 있습니다.

포함된 이미지 제공 요청의 쿼리 부분에 있는 중요한 변수는 직접 대체되지 않습니다. 대신 사용 가능한 모든 변수 정의가 요청에 추가되므로 요청을 구문 분석할 때 이미지 제공에서 변수를 대체할 수 있습니다.

자세한 내용은 대체 변수를 참조하십시오.

이미지 참조 section-a7680f9e6aca4b1a83560637cc9fac66

<image> 요소를 사용하여 SVG에 이미지를 삽입할 수 있습니다. <image> 요소의 xlink::href 특성에서 참조하는 이미지는 올바른 이미지 제공 요청이어야 합니다. 외래 URL은 허용되지 않습니다.

http://(으)로 시작하는 전체 이미지 제공 요청 또는 /is/image(으)로 시작하는 상대 URL을 지정하십시오. 전체 HTTP 경로를 지정하면 상대 형식으로 변환하기 위해 경로에서 도메인 이름이 제거됩니다. 전체 HTTP 경로를 사용하면 타사 SVG 렌더러로 파일을 미리 볼 수 있으므로 이점이 있을 수 있습니다.

NOTE

이 이미지 제공 릴리스에서 이미지 렌더링에 대한 지원은 제한됩니다. 기존 이미지 제공 레이어 및 템플릿 메커니즘이 원하는 결과를 얻기에 부족한 경우에만 SVG 내에서 이미지를 참조하는 것을 사용해야 합니다. 어떠한 상황에서도 다중 이미지 합성물을 생성하기 위해 SVG을 사용해서는 안 된다.

NOTE

현재 SVG에 포함된 이미지의 크기가 자동으로 조정되지 않습니다. 모든 이미지 href에 원하는 이미지 크기(예: wid=)를 설정하는 데 필요한 이미지 제공 명령이 포함되어 있는지 확인하십시오. 이미지 크기를 명시적으로 설정하지 않으면 attribute::DefaultPix이(가) 적용됩니다.

색상 관리 section-ea76e2bc4e1842638aa97a2d470c8a68

SVG 파일에 포함되고 대체 변수를 통해 SVG 템플릿에 전달되는 모든 색상 값은 sRgb 색상 공간에 있는 것으로 간주됩니다.

이미지가 SVG에 임베드되면 색상 변환이 수행되지 않습니다. 색상이 충실하도록 모든 포함된 이미지 요청에 대해 icc=sRgb을(를) 지정해야 합니다.

래스터화 후 SVG 이미지는 다른 이미지와 마찬가지로 색상 관리에 참여합니다.

예 section-036cdd45abd449849ee00a8f21788c28

다음 SVG 템플릿은 이미지 참조와 변수의 사용을 보여 줍니다.

<?xml version="1.0" standalone="no"?> <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd"> <svg width="500" height="500"> <image x="50" y="50" width="400" height="400" xlink:href="/is/image?src=$img$&wid=300&hei=400"/> <text x="150" y="400" style="font-size:$pts$; fill:$color$"> Title: $txt$ </text> </svg>

이 SVG 템플릿은 다음과 같이 사용할 수 있습니다.

http://server/is/image/mySvgTemplate.svg?$txt=Svg%20Template%20Test&$img=myImage.tif&$color=red&$pts=40&qlt=95

제한 사항 section-daa5eccd07204aaf993be41e87822d54

SVG 파일은 독립 실행형이어야 하며 이미지 제공 또는 이미지 렌더링 요청에서 참조되는 외부 이미지를 제외하고 보조 파일 또는 리소스를 참조해서는 안 됩니다(위 참조).

정적 콘텐츠만 렌더링됩니다. 애니메이션, 버튼 등의 대화형 기능. 가 있을 수 있지만 예상대로 렌더링되지 않을 수 있습니다.

ICC 프로파일 기반 색상 사양은 현재 지원되지 않습니다.

<script>개 요소가 있을 수 있지만 항상 무시됩니다.

참조 section-901dd1775fd24154a766dcfbe5032b67

src= , mask=, SVG 1.1 사양

recommendation-more-help

a26166cd-f2f4-45ce-996d-96a0f0d6cf49