> ## 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.
# 렌더 옵션
> 주문된 프로젝트를 인쇄용 파일로 만들 때의 처리를 ps_code마다 정하는 렌더 엔티티 레퍼런스
편집기에서 보이는 모양과 인쇄소에 넘길 파일의 모양이 다를 때가 있습니다. 접이식 카드는 읽는 순서대로 편집하지만 인쇄는 펼친 면으로 해야 하고, 포토카드는 한 장씩 편집하지만 큰 종이에 모아 찍습니다. 이 변환을 정하는 것이 **렌더 옵션**입니다. 렌더 옵션은 처리 단계 하나하나인 **엔티티**를 모아 둔 것이고, Edicus Prepress(이하 프리프레스)가 주문을 렌더링할 때 읽습니다. 프리프레스는 파트너의 생산 담당 PC에서 돌리는 Windows 앱입니다.
엔티티가 적용되는지는 프리프레스의 **렌더 포맷**(PDF2, PDF, SVG 같은 결과 파일 형식과 렌더링 엔진. PDF2는 새 PDF 엔진입니다)에 달려 있습니다. 먼저 생산 담당자에게 운영 포맷을 확인하고, [엔티티 목록](#엔티티-목록)에서 그 포맷 열만 보세요.
## 배우는 것
* **Render** 화면에서 렌더 옵션을 만들고 고치는 방법
* 주문에 어떤 렌더 옵션이 적용되는지 정하는 규칙
* 렌더 포맷마다 적용되는 엔티티와 엔티티별 필드의 의미
## 상품 설정과 무엇이 다른가
| | 상품 설정 | 렌더 옵션 |
| - | - | - |
| 쓰이는 때 | 사용자가 편집기를 띄울 때 | 확정 주문 뒤 프리프레스가 인쇄용 파일을 만들 때 |
| 단위 | 상품과 사이즈 | `ps_code`(사이즈 코드@상품 코드) |
| 화면 | **Product** | **Render** |
| 보이는 역할 | 파트너 관리자 계정(partner-admin) | 파트너 관리자 계정(partner-admin), 주문 담당 계정(partner-operator) |
렌더 옵션은 변환이 필요한 `ps_code`에만 만듭니다. 렌더 옵션이 없으면 프리프레스는 편집기 페이지를 그대로 출력합니다.
## 화면 사용법
왼쪽 메뉴의 **Render**를 누르면 **Render Option** 목록이 열립니다. 목록 옆 숫자는 엔티티 개수입니다.
툴바의 **Add**를 누르고 **Category**, **Product**, **Size**를 고른 뒤 **New**를 누릅니다. **Size**에서 `all`을 고르면 그 상품의 모든 사이즈에 적용되는 `all@상품코드` 옵션이 됩니다. 이미 있는 `ps_code`는 **New**가 비활성화됩니다. 기존 옵션을 복사하려면 **Copy from Base Render Option**에 체크하고 **base psCode**를 고릅니다.
**Add Entity**에서 엔티티 종류를 고르고 **Add**를 누릅니다. 같은 종류는 한 옵션에 하나만 넣을 수 있습니다. 엔티티는 종류 순서대로 자동 정렬됩니다. 엔티티 이름 옆의 닫기 아이콘을 누르면 그 엔티티가 지워집니다.
**Update**를 눌러야 저장됩니다. **Delete**는 선택한 렌더 옵션 전체를 지웁니다.
**Help**는 상품 설정 도움말을 엽니다. 렌더 옵션 설명은 들어 있지 않습니다.
### 전역 옵션
**Category**에서 **Prepress Global Option**을 고르면 `0000@prepress` 옵션을 만듭니다. 파트너의 모든 주문에 적용되는 기본값입니다. 전역 옵션에는 `call-front`, `pdf-white-control`, `pdf-white-control2`, `pdf-image-control`, `pdf-file-control`, `sticut-control`, `image-dpi-limit`, `add-job-statement`만 넣을 수 있습니다.
`call-front`는 전역 옵션 전용입니다. `enable`(기본 꺼짐)을 켜면 `prod-codes`(`prodCodes`, **Add Code**로 추가)에 든 상품의 주문을 렌더링하기 전에 파트너 서버를 호출합니다. `fail-case`(`failCase`)가 `pass`(기본)면 호출이 실패해도 렌더링하고, `error`면 렌더링을 실패로 끝냅니다. 이 엔티티는 프리프레스 **Work Settings**의 **Etc** 탭 **Callfront URL**이 비어 있으면 동작하지 않습니다. 호출 body는 `project_id`, `order_id`, `prod_code`, `size_code`, `oem_info`(OEM 주문이 아니면 비어 있음)입니다. 응답 JSON의 `commands`에 `control-unlayers` 명령을 담으면 그 주문에서 뺄 후가공 레이어를 바꿀 수 있습니다.
## 적용 규칙
```mermaid theme={null}
flowchart LR
A["템플릿 옵션 문자열이 만든 엔티티"] --> D["최종 엔티티"]
B["사이즈코드@상품코드"] --> D
C["all@상품코드"] --> D
E["0000@prepress"] --> D
```
* `ps_code`는 정확히 일치해야 합니다. 와일드카드는 `all@상품코드` 하나뿐입니다.
* 같은 종류의 엔티티가 여러 곳에 있으면 템플릿이 만든 엔티티, 사이즈 옵션, `all` 옵션, 전역 옵션 순으로 앞의 것이 이깁니다. 겹치지 않는 엔티티는 모두 합쳐집니다.
* `all@상품코드`와 사이즈 옵션은 엔티티 단위로 합쳐집니다. 예를 들어 `all`에 `grid-page`가 있으면 사이즈 옵션에서 그 엔티티를 끌 수 없고, 같은 종류를 넣어 값을 바꿀 수만 있습니다. 일부 사이즈만 빼야 하면 `all` 대신 사이즈마다 옵션을 만듭니다.
* [사진인화 상품](/docs/products/photo-print)에는 전역 옵션이 적용되지 않습니다.
* 엔티티를 바꾼 뒤 **Update**를 누르지 않으면 프리프레스에 반영되지 않습니다. 프리프레스는 저장된 옵션을 바로 읽습니다.
* `Null` 엔티티는 새 옵션에 자동으로 들어가는 빈 자리입니다. 화면에 보이지 않고 렌더링에 영향이 없습니다.
## 렌더 포맷
프리프레스 **Render Settings**의 **Template Render Format**(기본 `SVG`)이나 **Product Setting**의 상품별 **Render Format**에 따라 렌더링 엔진이 다르고, 엔진마다 읽는 엔티티가 다릅니다. PDF2는 가장 많은 엔티티를 지원하는 새 PDF 엔진이고 PDF는 이전 엔진입니다. 아래 표의 **SVG 계열**은 SVG, PNG, JPG와 IPDF(JPG로 렌더링한 뒤 PDF로 묶는 포맷)입니다. IPDF는 `grid-page`와 `pdf-meta-control`을 PDF로 묶는 단계에서 적용합니다.
## 엔티티 목록
| 엔티티 | 하는 일 | PDF2 | PDF | SVG 계열 |
| - | - | - | - | - |
| [`cover-outer-margin`](#cover-outer-margin과-content-outer-margin) | 표지 바깥에 여백과 재단 보조선을 붙입니다 | O | O | O |
| [`content-outer-margin`](#cover-outer-margin과-content-outer-margin) | 내지 바깥에 여백과 재단 보조선을 붙입니다 | O | O | O |
| [`cover-fixed-size`](#cover-fixed-size와-content-fixed-size) | 표지를 정한 용지 크기 가운데에 놓습니다 | O | O | O |
| [`content-fixed-size`](#cover-fixed-size와-content-fixed-size) | 내지를 정한 용지 크기 안에 놓습니다 | O | O | O |
| [`split-page`](#split-page) | 펼침면을 두 쪽으로 나눕니다 | O | O | O |
| [`orient-page`](#orient-page) | 페이지를 회전하거나 뒤집습니다 | O | | O |
| [`assemble-page`](#assemble-page) | 여러 페이지를 한 면에 붙입니다 | O | O | |
| [`grid-page`](#grid-page) | 페이지를 큰 대지에 격자로 배열합니다 | O | O | IPDF |
| [`tile-page`](#tile-page) | 한 페이지를 대지에 반복 배열합니다 | O | | |
| [`sticut-control`](#sticut-control) | 칼선 밖 인쇄를 잘라 냅니다 | O | | |
| [`gen-white-layer` 외 2종](/docs/products/white-layer) | 화이트 레이어를 만듭니다 | O | O | O |
| [`pdf-file-control`](/docs/products/render-output#pdf-file-control) | PDF 파일과 레이어 분리 방식을 정합니다 | O | | |
| [`pdf-meta-control`](/docs/products/render-output#pdf-meta-control) | PDF 트림박스와 블리드박스를 넣습니다 | O | O | IPDF |
| [`pdf-image-control`](/docs/products/render-output#pdf-image-control) | 이미지 색 공간과 ICC 프로파일을 정합니다 | O | | |
| [`image-dpi-limit`](/docs/products/render-output#image-dpi-limit) | 이미지 해상도 상한을 둡니다 | O | O | O |
| [`add-page-meta`, `add-page-meta-cover`](/docs/products/render-output#add-page-meta와-add-page-meta-cover) | 페이지 가장자리에 주문 정보 글자를 넣습니다 | O | O | O |
| [`add-job-statement`](/docs/products/render-output#add-job-statement) | 작업지시서 페이지를 앞에 넣습니다 | O | | |
| [`additional-page`](/docs/products/render-output#additional-page) | 템플릿 페이지를 맨 뒤에 덧붙입니다 | O | O | O |
| [`add-postlayer-to-page`](#add-postlayer-to-page) | 페이지 테두리 사각형을 후가공 레이어로 넣습니다 | O | | |
| [`control-feature`](#control-feature) | 페이지 마스크를 끕니다 | O | | O |
| [`redirect-render-layer`](#redirect-render-layer) | 렌더 결과를 다른 레이어로 보냅니다 | | | O |
| [`background-control`](#background-control) | 배경을 별도 레이어로 뺍니다 | | | O |
| [`foil-layer-control`](#foil-layer-control) | 박 레이어를 벡터로 바꿉니다 | | | O |
| [`generate-tn`](/docs/products/render-output#generate-tn) | 페이지 썸네일 PNG를 만듭니다 | O | | |
| [`jpg-control`](/docs/products/render-output#jpg-control) | JPG에 sRGB 프로파일을 넣습니다 | | | JPG |
| [`merge-page-info`](/docs/products/render-output#merge-page-info) | SVG 결과 목록을 한 페이지로 합칩니다 | | | SVG |
| [`capture-control`](/docs/products/render-output#capture-control) | 상품별로 캡처(페이지 이미지를 만들어 **Capture Snapshot URL**로 보내는 기능) 여부를 정합니다 | | O | O |
| [`print-to-pdf`, `bypass-image`](/docs/products/render-output#사진인화-상품-엔티티) | 사진인화 상품 전용 | | | |
| `control-output` | 일부 파트너 전용 출력 형식입니다 | | | O |
| [`add-bar-code`](#add-bar-code) | 현재 렌더에서 동작하지 않으므로 넣지 않습니다. 파트너 권한에 따라 잠금으로 표시될 수 있습니다 | | | O |
| `postlayer-color-control`, `remove-layer` | 렌더링에 쓰이지 않습니다 | | | |
## 크기와 여백
### cover-outer-margin과 content-outer-margin
`cover-outer-margin`은 `cover` 페이지, `content-outer-margin`은 `content` 페이지에 적용됩니다. 단위는 모두 mm입니다.
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `mode` | `mode` | `default` | `content-outer-margin`만 있습니다. `default`는 `width`, `height`로 좌우와 위아래를 같게, `L-T-R-B`(`ltrb`)는 `left` `top` `right` `bottom`을 따로 정합니다 |
| `width`, `height` | `width_mm`, `height_mm` | `0` | 좌우 각각, 위아래 각각 붙일 여백입니다 |
| `support-line` | `supportLine` | `none` | `default`면 여백에 재단 보조선(재단 위치를 알리는 짧은 선)을 그립니다. 선 길이는 프리프레스 **Support Line Length**를 따릅니다 |
| `cut-margin` | `cutMargin_mm` | `0` | `support-line`이 `default`일 때만 보입니다. 도련(재단 오차를 위해 판형 밖으로 더 그린 영역)의 폭만큼 보조선을 안쪽으로 들입니다. 표지는 `3`, `3,5`(좌우,위아래), `3,5,3,5`(왼,위,오른,아래)로 쓸 수 있습니다 |
| `miso-margin` | `misoMargin_mm` | `0` | 표지 전용. 책등 양옆에 이 거리만큼 떨어진 보조선을 더 그립니다. 책등 폭이 있을 때만 그려집니다 |
| `fiil-paper`(화면 표기 그대로입니다) | `fillPaper` | 꺼짐 | 표지 전용, PDF2 전용. 단색 배경이나 표지용 배경 이미지를 여백까지 채웁니다 |
| `center_h` | `center_h` | 꺼짐 | 내지 전용. 가운데에 세로 보조선을 더 그립니다 |
### cover-fixed-size와 content-fixed-size
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `width`, `height` | `width_mm`, `height_mm` | `0` | 결과 용지 크기(mm)입니다. 표지는 항상 가운데에 놓입니다 |
| `position` | `position` | `center` | 내지 전용. `center`, `left`, `top`, `right`, `bottom`, `left-top`, `right-top`, `left-bottom`, `right-bottom` 중 내지를 붙일 위치입니다 |
| `offset_x`, `offset_y` | `offset_x`, `offset_y` | `0` | 내지 전용. 내지를 오른쪽과 아래로 더 옮깁니다(mm). PDF2는 가운데 정렬된 축에만 적용합니다 |
같은 페이지에 fixed-size와 outer-margin을 함께 넣지 마세요. PDF와 SVG 계열은 fixed-size만 적용하고, PDF2는 둘을 차례로 적용합니다. PDF2에서 `position`의 `bottom` 계열 값은 내지를 용지 위쪽 밖으로 보내므로 쓰지 않습니다.
### split-page
펼침면 한 장을 두 페이지로 나눠 출력합니다. 표지는 나누지 않습니다.
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `direction` | `direction` | `horizontal` | `horizontal`은 좌우로, `vertical`은 위아래로 나눕니다. PDF2는 항상 좌우로 나눕니다 |
| `target` | `target` | `content` | 나눌 페이지 종류입니다. 선택지는 `content` 하나입니다 |
| `split-margin` | `split_margin` | `0` | 나눈 쪽마다 경계 너머로 더 담을 폭(mm)입니다. PDF2에서 `0`이면 `content-outer-margin`의 `cut-margin`을 씁니다 |
### orient-page
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `type` | `type` | `default` | `default`는 모든 페이지에 `orientation`을, `sequence`는 페이지마다 다른 값을 씁니다 |
| `orientation` | `orientation` | `0` | `0`·`1` 그대로, `2` 좌우 반전, `3` 180도, `4` 상하 반전, `6` 90도, `8` 270도, `5`·`7` 반전 후 회전입니다. PDF2는 `5`·`7`을 반전 없이 270도로 돌립니다 |
| `sequence` | `sequence` | 없음 | SVG 계열 전용. `1,3`처럼 쉼표로 적은 값을 페이지 순서대로 돌려 씁니다 |
PDF2에서 `orient-page`는 `grid-page`, `tile-page`, `assemble-page`가 없을 때만 적용됩니다.
## 페이지 배치
PDF2는 `grid-page`, `tile-page`, `assemble-page`, `orient-page` 중 이 순서로 먼저 있는 하나만 적용합니다. PDF는 `assemble-page`, `split-page`, `grid-page` 중 하나만 적용합니다.
### assemble-page
편집기에서는 읽는 순서대로 페이지를 보여 주고, 렌더링할 때 생산용 배치로 다시 묶습니다. PDF2와 PDF에서만 동작합니다.
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `direction` | `direction` | `horizontal` | 페이지를 이어 붙일 방향입니다. `horizontal`(가로), `vertical`(세로) |
| `grouping-type` | `groupingType` | `[[2,0],[1]]` | 묶는 규칙입니다. 아래 표를 보세요 |
| `custom-rule` | `customRule` | 없음 | `grouping-type`이 `custom`일 때 쓰는 배열입니다 |
| `label-type` | `labelType` | `none` | PDF2 전용. `top`이면 붙인 페이지마다 라벨 띠를 넣습니다. 가로로 붙이면 위에, 세로로 붙이면 왼쪽에 붙습니다 |
| `label-thickness` | `labelThickness` | `0` | 라벨 띠 두께(mm)입니다 |
| `label-texts` | `labelTexts` | 없음 | `/`로 나눈 라벨 글자입니다. 비우거나 모자라면 페이지 순번(`0`부터)이 들어갑니다 |
묶음 배열 읽는 법:
* 페이지 번호는 `0`부터 셉니다. 안쪽 대괄호 하나가 결과물의 한 페이지입니다.
* 번호 뒤 `@R`은 그 페이지를 180도 돌리고, `@M`은 좌우로 뒤집습니다. `@`가 붙은 번호는 따옴표로 감쌉니다. 예: `[["0@R",1]]`
| 선택지 | 배열 | 쓰임 |
| - | - | - |
| `2H-CARD` | `[[2,0],[1]]` | 가로형 접이식 카드. `direction`은 `horizontal` |
| `2V-CARD` | `[["2@R",0],[1]]` | 세로형 접이식 카드 |
| `3H-CARD` | `[[3,1,0],[2]]` | 가로형 3단 카드 |
| `3V-CARD` | `[[3,"1@R",0],[2]]` | 세로형 3단 카드 |
| `2` | `[[0,1]]` | 두 페이지를 한 면에 |
| `2-MIRROR` | `[[0,"0@M"]]` | 같은 그림을 뒤집어 앞뒤로 붙이는 상품(아크릴 키링 등) |
`2-MIRROR`는 렌더 단계에서 첫 페이지를 반전해 붙이고, [스티컷 상품](/docs/products/sticut)의 뒷면 모드 `mirror`는 편집기가 반전한 뒷면 페이지를 문서에 직접 만듭니다. 둘을 함께 쓰지 않습니다.
`2H-CARD`는 결과물이 두 페이지입니다. 첫 페이지는 편집기의 2번과 0번 페이지를 가로로 붙인 것이고, 둘째 페이지는 1번 페이지 그대로입니다.
### grid-page
여러 페이지를 큰 대지(실제로 인쇄하는 종이)에 격자로 배열합니다. 길이 단위는 mm입니다. 포토카드 설정은 [포토카드](/docs/products/photocard)를 보세요.
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `dim_x`, `dim_y` | `dim_x`, `dim_y` | `3`, `8` | 대지 한 장의 가로, 세로 칸 수입니다 |
| `dim_max` | `dim_max` | `0` | 이 개수가 차면 다음 대지로 넘어갑니다. `0`이면 `dim_x`×`dim_y` |
| `page_w`, `page_h` | `page_w`, `page_h` | `316`, `464` | 대지 크기입니다 |
| `offset_x`, `offset_y` | `offset_x`, `offset_y` | `10`, `10` | 첫 칸의 왼쪽 위 좌표입니다 |
| `adv_x`, `adv_y` | `advance_x`, `advance_y` | `10`, `10` | 이웃 칸 시작점 사이의 거리입니다. 칸 사이 빈 간격이 아닙니다 |
| `rotate` | `rotate` | `0` | 칸 안의 페이지를 `0`, `90`, `180`, `270`도 돌립니다 |
| `bg-rsc` | `use_bg` | 꺼짐 | PDF 전용. 켜면 `template-uri` 템플릿 페이지를 대지 배경으로 깝니다. PDF2는 무시합니다 |
| `template-uri` | `template_uri` | 없음 | 배경 템플릿의 `resUri`입니다. **Resource** 상세의 `resUri` 칸에서 복사합니다 |
| `double-side` | `double_side` | 꺼짐 | 앞뒤가 번갈아 오는 페이지를 앞면 대지와 뒷면 대지로 나눠 같은 칸에 놓습니다 |
| `mirror` | `mirror` | `none` | `odd-h`면 둘째, 넷째 대지의 열 순서를 좌우로 뒤집어 양면 인쇄 때 앞뒤가 맞게 합니다 |
| `show-border` | `show_border` | 꺼짐 | PDF2에서 `add-job-statement`가 있을 때만. 칸마다 회색 테두리를 그립니다 |
| `job-statement-x`, `-y` | `job_statement_x`, `_y` | `0` | 같은 조건에서 작업지시서를 첫 대지의 이 좌표에 놓습니다 |
| `marker-type` | `marker_type` | `none` | 자동 재단기용 맞춤 표시입니다. `UNICutter`는 왼쪽 가장자리 막대, `iECHO`는 네 모서리 원입니다 |
| `marker-param` | `marker_param` | 없음 | 표시 크기(mm)입니다. `offset=0,length=10,thickness=2`(UNICutter), `offset_x=6,offset_y=13,radius=5.9,stroke=0.1`(iECHO)이 기본값입니다 |
### tile-page
PDF2 전용입니다. 페이지마다 대지 한 장을 만들고 그 페이지를 `dim_x`×`dim_y`칸(`dim_max`가 있으면 그 개수)에 반복해 놓습니다. 필드의 뜻과 기본값은 `grid-page`의 같은 이름 필드와 같습니다.
## 칼선과 후가공
### sticut-control
PDF2 전용입니다. 스티컷(그림 모양대로 자르는 상품)의 칼선 밖으로 나간 인쇄 내용을 잘라 냅니다. 같은 `ps_code`에 `content-outer-margin`이나 `content-fixed-size`가 있으면 내지에, `cover-outer-margin`이나 `cover-fixed-size`가 있으면 표지에 적용되지 않습니다. 상품 설정은 [스티컷 상품](/docs/products/sticut)을 보세요.
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `cut-adjust` | `cutAdjust` | `none` | `none`은 자르지 않습니다. `bounding-box`(`rect`)는 칼선을 감싸는 사각형 밖을, `cut-path`(`path`)는 칼선 모양 밖을 잘라 냅니다 |
| `cut-margin` | `cutMargin_mm` | `0` | 자르는 경계를 칼선 바깥으로 이만큼(mm) 넓혀 도련을 남깁니다 |
### add-postlayer-to-page
PDF2 전용입니다. 각 페이지 테두리에 0.3528mm(1pt) 선 사각형을 그려 후가공 레이어로 넣습니다.
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `postlayer` | `postlayer` | `Cut` | 넣을 레이어 이름입니다. `Cut`(칼선), `KissCut`(반칼선)처럼 템플릿 레이어 이름을 씁니다 |
| `margin-mm` | `margin_mm` | `0` | 사각형을 페이지 안쪽으로 들이는 거리(mm)입니다 |
| `cmyk` | `color_cmyk` | `0,0,0,100` | 선 색의 C,M,Y,K 값입니다 |
### foil-layer-control
SVG 계열 전용입니다. 박(금박 같은 후가공) 레이어를 이미지로 그린 뒤 윤곽을 따 벡터 SVG로 바꿉니다.
| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `draw-type` | `draw_type` | `stroke` | `stroke`는 윤곽선만, `fill`은 채운 모양을 만듭니다 |
| `color-hex` | `color_hex` | `#EC008B` | 벡터의 색입니다 |
| `color-cmyk` | `color_cmyk` | 없음 | 렌더링에 쓰이지 않습니다 |
| `max-density`, `min-density`, `buffer-size` | `max_density`, `min_density`, `target_buffer_size` | `600`, `150`, `15000` | 윤곽을 딸 때의 해상도입니다. 긴 변이 약 `buffer-size` 픽셀이 되게 계산한 값을 두 밀도 사이로 제한합니다 |
### redirect-render-layer
SVG 계열 전용입니다. `mode`(기본 `default`)가 `default`면 렌더 결과를 `target-layer`(기본 `Custom`) 이름의 단색(`solid-color`, 기본 `#000000`) 레이어로 만듭니다. `skip-bg`(`skipBackground`, 기본 켜짐)를 켜면 배경은 빼고 만듭니다. `attach-as-layer`는 둘째 페이지부터를 첫 페이지의 `target-layer` 레이어로 붙이고, `change-as-layer`는 렌더 결과의 레이어 이름만 `target-layer`로 바꿉니다. 화이트 엔티티와 함께 쓰지 않습니다.
### background-control
SVG 계열 전용입니다. 배경을 `background` 레이어로 따로 출력합니다. `type`은 `layer` 하나, `clipping`은 `none`(그대로), `cut`(칼선 모양에 `offset`mm 여유를 더해 자름), `foreground`(전경 모양대로 자름)입니다. `case`를 `transparent`로 두면 `clipping`을 무시하고 배경을 그대로 출력합니다.
### add-bar-code
SVG 계열 전용이며 파트너 권한에 따라 잠금으로 표시될 수 있습니다. 설계상으로는 [사이즈 옵션](/docs/products/size-options#barcode)의 바코드 위치와 크기에, 내용은 `code`(생산 변수 사용 가능)로 표지에 바코드를 그리는 엔티티입니다. 그러나 현재 렌더는 이 엔티티로 바코드를 인쇄 파일에 넣지 못하므로 이 엔티티를 넣지 않습니다. 바코드 위치가 필요하면 렌더 결과 정보의 `barcode_info`를 받아 인쇄 공정에서 씁니다. `barcode_info`는 [`cover-fixed-size`](#cover-fixed-size와-content-fixed-size)가 있는 표지를 렌더링할 때만 계산됩니다. 자세한 내용은 [사이즈 옵션](/docs/products/size-options#barcode)을 보세요.
### control-feature
PDF2와 SVG 계열에서 `no-pagemask`(`disable_pagemask`, 기본 꺼짐)를 켜면 템플릿의 페이지 마스크(페이지 모양대로 자르는 경로)를 쓰지 않고 페이지 사각형으로만 자릅니다.
## 됐는지 확인
렌더 옵션은 편집기에서 보이지 않습니다. [테스트 주문과 렌더링](/docs/templates/test-render)으로 결과 파일을 받아 확인합니다. PDF 분리 방식과 표시 엔티티는 [렌더 출력 옵션](/docs/products/render-output)에 있습니다.
운영에서 쓸 **Template Render Format**으로 렌더링한 결과가 엔티티에서 정한 크기, 배치, 레이어로 나오면 됩니다.
## 다음 단계
투명 소재 인쇄에 쓰는 화이트를 설정합니다.
PDF 분리 방식, 색 공간, 주문 정보 표시, 부가 페이지를 정합니다.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.