설명서Dynamic Media 이미지 제공 및 렌더링 API

클립 경로

마지막 업데이트: 2025년 8월 15일
  • 주제:

작성 대상:

  • 개발자
  • 사용자

레이어 클립 패스. 현재 레이어의 클립 경로를 지정합니다.

clipPath= *pathDefinition*

clipPathE= *pathName**[, *pathName*]

pathDefinition경로 데이터.
pathName레이어 소스 이미지에 포함된 경로 이름(ASCII만 해당).

clipPath=에 의해 정의된 영역 밖에 있는 레이어의 모든 부분이 투명하게 렌더링됩니다.

*pathName*은(는) 레이어 원본 이미지에 포함된 경로 이름입니다. 이미지 내용과의 상대 정렬을 유지하기 위해 경로가 자동으로 변형됩니다. 두 개 이상의 *pathName*을(를) 지정하면 서버에서 이미지를 이러한 경로의 교차 지점으로 클리핑합니다. 원본 이미지에서 찾을 수 없는 *pathName*은(는) 무시됩니다.

노트
*pathName*에는 ASCII 문자열만 지원됩니다.

*pathDefinition*에서 레이어 픽셀 좌표에 명시적 경로 데이터를 지정할 수 있습니다.

size=이(가) 지정되고 0,0이(가) 아닌 경우 레이어가 적용됩니다. 이 경우 경로 좌표는 레이어 사각형의 왼쪽 위 모서리를 기준으로 하며 레이어는 origin= 또는 해당 기본값을 기준으로 배치됩니다. 레이어 사각형 외부의 패스의 모든 영역은 투명하게 유지됩니다.

단색 또는 텍스트 레이어에 size=을(를) 지정하지 않으면 패스의 크기를 결정하는 범위 내에서 레이어가 자체 크기 조정으로 간주됩니다. origin=을(를) 지정하지 않으면 기본적으로 경로 좌표 공간의 (0,0)이 됩니다. 이 워크플로우 프로세스를 사용하면 레이어 0의 원점을 기준으로 경로 좌표를 효과적으로 지정할 수 있습니다.

노트
scale=, rotate= 및 anchor= 명령은 자체 크기 조정 단색 레이어에 허용되지 않습니다.

*pathDefinition*에서는 값을 구분하기 위해 공백 대신 쉼표를 사용한다는 점을 제외하고 SVG d= 요소의 <path> 특성 값과 유사한 문자열을 사용할 수 있습니다. *pathDefinition*에는 하나 이상의 닫힌 루프 하위 경로가 포함될 수 있습니다.

*pathDefinition*에서는 다음 경로 명령이 지원됩니다.

명령이름설명
M x,y절대 이동x,y에서 새 하위 경로를 시작합니다.
m x,y상대 이동
L *{ x,y}절대 줄현재 위치에서 x,y로 선을 그립니다.
l *{ x,y}lineto 상대
C *{ x1,y1,x2,y2,x,y}절대 곡선화현재 위치에서 x,y로 베지어 곡선을 그립니다. x1,y1은 곡선 시작 부분의 제어점이고 x2,y2는 곡선 끝 부분의 제어점입니다.
c *{ x1,y1,x2,y2,x,y}상대 곡선
Z | zclosepath현재 서브패스를 직선으로 닫습니다.

대문자 명령은 좌표 값이 레이어 사각형의 왼쪽 위를 기준으로 절대 픽셀 위치에 있음을 나타냅니다. 픽셀 오프셋은 현재 위치를 기준으로 소문자 명령을 따릅니다.

'm' 또는 'M'은 항상 새 하위 경로를 시작합니다. 끝에 'Z' 또는 'z'가 지정되지 않은 경우 서브패스는 직선으로 자동으로 닫힙니다.

하위 경로가 상대 이동('m')으로 시작하면 다음 중 하나에 상대적입니다.

  • 'z' 또는 'Z'로 닫힌 경우 이전 하위 경로의 시작점.
  • 명시적으로 닫히지 않은 경우 이전 하위 경로의 끝점입니다.
  • 첫 번째 하위 경로인 경우 0,0.

속성

레이어 속성입니다. layer=comp인 경우 현재 레이어 또는 합성 이미지에 적용됩니다. 효과 레이어는 이를 무시합니다.

레이어 원본 이미지에 지정된 이름의 경로가 없거나 레이어 원본이 이미지가 아니면 한정자 clipPathE=이(가) 무시됩니다.

기본값

없음 - 레이어를 추가로 클리핑하지 않습니다.

참조

clipXpath= , textFlowPath= , extend=

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49