> ## Documentation Index
> Fetch the complete documentation index at: https://make.edicus.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 예약 개체 이름과 페이지 영역

> 개체 이름으로 동작이 정해지는 Image, none, PageInfo 개체와 그 밖의 예약 이름 전체

레이어 이름이 개체 종류를 정한다면, 예약 이름은 같은 레이어 안에서 개체 하나의 역할을 정합니다. `Cell` 레이어의 `Image`는 기본 사진을 남기고, `PageInfo` 레이어의 `RenderBound`는 렌더링 영역이 됩니다.

## 배우는 것

* 개체 이름을 붙이는 방법과 주의할 점
* 사진 칸과 바탕의 예약 이름
* `PageInfo` 개체 이름 전체

## 개체 이름 붙이기

**레이어** 패널에서 레이어를 펼치고 개체 이름을 천천히 두 번 클릭해 바꿉니다. 개체 이름에도 `@` 뒤에 [어노테이션](/docs/templates/annotations)을 붙일 수 있고, 예약 이름 판단은 `@` 앞부분으로 합니다.

* 레이어 패널에 `<사각형>`, `<그룹>`처럼 꺾쇠로 보이는 이름은 InDesign 기본 이름이라 이름이 없는 것으로 읽습니다. 꺾쇠를 직접 입력하지 않습니다.
* `#`으로 시작하는 이름은 변수입니다. [변수와 데이터 병합](/docs/templates/variables)을 보세요.
* 대소문자 규칙은 이름마다 다릅니다. 아래 표에 적힌 철자 그대로 씁니다. 규칙 모음과 틀렸을 때의 증상은 [흔한 실수와 증상](/docs/templates/layers#흔한-실수와-증상)에 있습니다.

## 사진 칸

`Cell` 레이어에서 씁니다.

| 개체 이름 | 대소문자 | 동작 |
| - | - | - |
| `Image` | 구분 안 함 | 프레임에 넣어 둔 이미지를 기본 사진으로 남깁니다. 이 이름이 없으면 넣어 둔 이미지는 버리고 빈 사진 칸이 됩니다. 사용자는 기본 사진을 바꾸거나 지울 수 있고, 바꾸지 않으면 기본 사진이 인쇄됩니다 |
| `mask` | 구분 안 함 | 사각형 프레임이면 프레임의 모습을 그림으로 캡처해 사진을 그 모양대로 가리는 마스크로 씁니다. 사각형이 아닌 프레임은 이 이름 없이도 외곽선 모양으로 사진을 자릅니다 |
| `frame` | 구분 안 함 | 그룹 안에서 사진이 들어갈 자리를 표시합니다. 아래 컴포지트 사진 칸에 씁니다 |

`Cell-PNG` 레이어에 둔 `Image`는 JPG 대신 PNG로 내보내 투명도를 살립니다.

### 컴포지트 사진 칸

액자처럼 사진 위아래에 장식이 붙은 사진 칸은 그룹으로 만듭니다.

1. 사진이 들어갈 프레임을 그리고 이름을 `frame`으로 짓습니다. 이름 대신 채움 견본을 `c0m0y0k50`이라는 이름의 견본으로 칠해도 됩니다.
2. 장식 이미지를 넣은 프레임을 그 위나 아래에 겹칩니다.
3. 모두 선택해 그룹으로 묶고 `Cell` 레이어에 둡니다.

`frame`보다 아래에 쌓인 장식은 사진 밑에, 위에 쌓인 장식은 사진 위에 그려집니다. 사용자는 사진만 바꿀 수 있고 장식은 사진 칸과 함께 움직입니다. 사진 자리 개체의 이름을 `frame` 대신 `Image`로 하고 이미지를 넣어 두면 기본 사진도 함께 남습니다.

### InDesign 효과의 변환

| InDesign 설정 | 사진 칸에서 |
| - | - |
| 둥근 모서리 | 모서리 반경으로 바뀝니다. 왼쪽 위 모서리 값만 읽고 0.9배로 줄입니다 |
| 획 | 테두리 색과 두께로 바뀝니다 |
| 그림자, 내부 그림자 | 바깥, 안쪽 그림자로 바뀝니다 |
| 그레이디언트 페더 | 사진 가장자리를 흐리는 마스크로 바뀝니다 |

## 바탕

`Background` 레이어에서 씁니다. `Background` 레이어가 없으면 흰 바탕을 만듭니다.

| 개체 이름 | 대소문자 | 편집기에서 | 렌더링에서 |
| - | - | - | - |
| `none` | 소문자만 | 바탕을 그리지 않고 페이지 테두리 그림자도 없앱니다 | 빠집니다 |
| `transparent` | 소문자만 | 투명을 뜻하는 체크무늬로 보입니다 | 빠집니다 |
| `white` | 소문자만 | 흰 바탕입니다 | 흰색(CMYK 0, 0, 0, 0)으로 인쇄됩니다 |
| `color`로 시작하는 이름 | 소문자만 | 사각형이 페이지보다 작아도 그 채움 색을 바탕색으로 씁니다 | 그 색으로 인쇄됩니다 |

이름이 없을 때는 이렇게 처리합니다.

* 페이지(재단선 기준)를 다 덮는 사각형 하나뿐이면 그 채움 색이 바탕색이 됩니다.
* 그 밖의 경우(작은 사각형, 그림, 여러 개체)는 `Background` 레이어 전체를 JPG 한 장으로 합쳐 바탕 그림으로 씁니다.

어느 경우든 바탕의 크기는 페이지와 도련을 합친 크기로 맞춥니다. 상품 설정의 바탕 고정값이 켜져 있으면 템플릿 바탕을 덮어씁니다. 막으려면 `Background@fix_bg=false`를 씁니다. 배경 탭은 [레이아웃과 배경](/docs/products/layout-background)을 보세요.

## PageInfo

`PageInfo` 레이어에 사각형이나 패스를 넣고 아래 이름을 붙입니다. 이 개체는 화면에 그려지지 않고 페이지 속성이 됩니다. 이름은 대소문자를 구분합니다.

<Warning>
  익스포터는 개체의 회전을 0도로 돌린 상태에서 위치와 모양을 읽습니다. 회전한 사각형이나 선은 회전값이 무시되므로, 기울어진 영역이 필요하면 회전 대신 패스 자체를 그 모양으로 그립니다.
</Warning>

### 여백

| 개체 이름 | 동작 |
| - | - |
| `CutMargin` | 사각형 바깥과 페이지 가장자리 사이 거리를 재단 여백으로 씁니다. 개체가 이 선을 넘으면 경고 표시가 뜹니다. 상품 사이즈의 재단 여백보다 우선합니다 |
| `InnerMargin` | 같은 방식으로 안전 여백을 만듭니다. 상품 사이즈의 안전 여백보다 우선합니다 |
| `PageMargin` | 스티컷 상품의 페이지 여백입니다. 상품의 스티컷 페이지 여백보다 우선합니다 |

세 여백은 1mm 단위로 반올림됩니다.

### 영역

| 개체 이름 | 동작 |
| - | - |
| `RenderBound` | 렌더링할 사각 영역입니다. 없으면 도련을 포함한 페이지 전체를 렌더링합니다 |
| `FitBound` | 레이아웃 탭으로 다른 디자인을 적용할 때 내용을 맞추는 기준 영역입니다. 없으면 `RenderBound`, 그것도 없으면 페이지 전체를 씁니다 |
| `ClipBound` | 편집기가 만드는 저장 썸네일을 이 사각형으로 자릅니다 |
| `GroupBound` | PDF 렌더링에서 인쇄 판을 이 사각형으로 자릅니다 |
| `EmbedBound` | `Embed` 칸에 다른 페이지를 넣을 때 그 페이지에서 보여 줄 영역입니다 |
| `AlignBound`, `PositionBound` | 사용자가 추가한 사진이나 그림을 놓고 정렬하는 기준 영역입니다 |
| `BoxBound` | 크기를 고르는 상품에서 크기 변경의 기준 상자입니다 |
| `Bound=Fit-Render-ClipPath` | 개체 하나로 여러 영역을 한 번에 지정합니다. 개체 이름에서는 `=`와 `-`로 잇습니다. 같은 일을 레이어 이름으로 할 때는 `Bound@Fit+Render+ClipPath`처럼 `@`와 `+`로 잇습니다. 코드가 두 표기를 따로 읽으므로 섞어 쓰지 않습니다 |

### 클리핑과 페이지 모양

렌더링 열의 PDF2는 PDF를 만드는 신규 렌더링 방식이고, 기존 PDF는 그 전 방식입니다. 어느 방식을 쓰는지는 렌더링 설정이 정합니다.

| 개체 이름 | 편집기에서 | 렌더링에서 |
| - | - | - |
| `ClipPath` | 일반 개체를 이 패스 안으로 자릅니다. `Background`는 `@clip=true`일 때만 자릅니다 | 인쇄 이미지를 이 패스 안으로 자릅니다. 후가공 판은 자르지 않습니다(PDF2에서는 `preclip`이 없는 `White`도 함께 잘립니다) |
| `PageMask` | 패스 바깥을 덮어 페이지가 이 모양으로 보이고, 바탕을 이 모양으로 자릅니다 | `ClipPath`가 없으면 이미지 렌더링과 PDF2 렌더링에서 이 패스로 자릅니다. PDF2에서는 렌더 옵션 `control-feature`로 끌 수 있습니다. 기존 PDF 렌더링에서는 자르지 않습니다 |
| `HidePath` | 아무것도 선택하지 않았을 때만 `ClipPath` 대신 이 패스로 자릅니다 | 쓰지 않습니다 |
| `ClipPathUser` | 템플릿 개체는 두고 사용자가 추가한 개체만 자릅니다. `ClipPath`가 있으면 쓰지 않습니다 | 쓰지 않습니다 |
| `GroupPath` | 쓰지 않습니다 | 기존 PDF 렌더링에서 모든 판을 이 패스로 자릅니다. `GroupBound`보다 우선합니다 |

`ClipPath` 소문자 `clipPath`, `HidePath` 소문자 `hidePath`도 같은 이름으로 읽습니다. 구멍이 있는 영역은 복합 패스로 그립니다.

### 스티컷

| 개체 이름 | 동작 |
| - | - |
| `SticutShapePath`, `SticutBoundPath`, `SticutOuterPath` | 스티컷 칼선의 모양, 경계, 바깥 영역입니다 |
| `SticutExcludePath` | 칼선 계산에서 뺄 영역입니다 |
| `SticutDrillPath`, `SticutDrillClipPath` | 구멍 위치와 구멍 주변 클리핑입니다 |
| `SticutPage` | 스티컷 페이지로 표시합니다 |

설정은 [스티컷 상품](/docs/products/sticut)을 보세요.

### 페이지 동작

| 개체 이름 | 동작 |
| - | - |
| `Uneditable` | 그 페이지를 편집할 수 없게 하고 안내 문구를 보여 줍니다 |
| `Unadjustable` | 스토리보드에서 그 페이지의 추가, 복제, 삭제 메뉴를 숨깁니다 |
| `Unrenderable` | 그 페이지를 렌더링에서 뺍니다 |
| `NoBackground`, `Background=None` | 바탕을 `none`으로 바꿉니다 |
| `TransparentBackground`, `Background=Transparent` | 바탕을 `transparent`로 바꿉니다 |
| `PageCode=값` | 같은 코드의 페이지를 한 벌로 묶습니다. 첫 코드의 페이지만 문서에 남고 나머지 벌은 교체용으로 보관됩니다 |
| `EffectiveArea=값` | 디자인이 페이지를 덮는 비율을 계산할 때 기준 면적(mm²)입니다 |
| `GhostWindow@left=true,right=true,top=true,bottom=true` | 머그컵처럼 이어지는 상품에서 사진과 그림이 반대쪽에 이어 보이게 합니다 |
| `EnablePattern@seamless=horz` | 패턴 탭의 이음새 방향입니다. `horz`, `vert`, `all`, `none` 중 고릅니다 |
| `DimBox@padding=2/2/2/2,line=1/1/1/1` | 편집과 미리보기에서 바깥을 어둡게 가린 영역입니다. 값은 왼쪽/위/오른쪽/아래 순서입니다 |
| `SafeBox@padding=2/2/2/2,line=1/1/1/1` | 편집 화면에 안전 영역 테두리를 그립니다 |
| `PositionHint=left/top` | 레이아웃 탭으로 크기가 다른 페이지에 적용할 때 맞출 기준입니다 |
| `DPStyle=값`, `PageTitle=값` | 레이아웃과 배경 리소스로 올릴 때의 표시 형식과 제목입니다 |

## 그 밖의 예약 이름

| 레이어 | 개체 이름 | 동작 |
| - | - | - |
| `Embed` | `page-번호` | 그 번호(0부터 셈)의 페이지 축소본을 보여 줍니다 |
| `DocInfo` | `DocType=define` | 정의 문서로 표시합니다 |
| `Select` | `RenderBound`, `Guide` | 선택지별 렌더 영역과 가이드입니다 |
| `Label` | `키=값` | `Select` 선택지의 표시 이름입니다 |
| `Sticker`, `Path` | `fill` | 책 표지에서 개체 중심이 책등 폭 안에 있고 폭이 책등 폭 이하이면 책등 채우기 개체가 됩니다. 정확히 `fill`이어야 하고 `fill@...`처럼 뒤에 붙이면 인식하지 않습니다. 레이어로 지정하는 방법은 [어노테이션](/docs/templates/annotations#책등-채우기)을 보세요 |
| `PageCaption` | `ko_이름` | 스토리보드 페이지 이름입니다. [페이지와 상위 페이지(마스터)](/docs/templates/pages)를 보세요 |
| `DataRule` | `변수id@속성=개수:값/개수:값` | [변수와 데이터 병합](/docs/templates/variables)을 보세요 |
| `CalendarBox`와 달력 레이어 | `DAY_TEXT`, `DAY^G`, `^`가 든 이름 | [달력 상품](/docs/products/calendar)을 보세요 |

## 됐는지 확인

<Check>
  **Demo**에서 개체를 가장자리로 옮겼을 때 `CutMargin` 위치에서 경고가 뜨면 여백이 적용된 것입니다. Demo는 사진을 올릴 수 없으므로, 큰 사진이 `ClipPath` 밖으로 나오지 않는지와 `RenderBound` 크기는 [테스트 주문과 렌더링](/docs/templates/test-render)의 Test Order로 확인합니다.
</Check>

## 다음 단계

<Columns cols={2}>
  <Card title="스마트폰 케이스 예제" icon="mobile" href="/docs/templates/phone-case">
    `Guide`, `ClipPath`, `RenderBound`를 한 템플릿에서 함께 씁니다.
  </Card>

  <Card title="어노테이션" icon="at" href="/docs/templates/annotations">
    레이어와 개체 이름 뒤에 붙이는 설정 전체입니다.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.