> ## 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.

# 화이트 레이어

> 투명 소재나 유색 소재에 인쇄할 때 쓰는 화이트 레이어를 렌더 옵션으로 만드는 방법

아크릴이나 투명 필름에 컬러 잉크만 찍으면 색이 비쳐 흐려집니다. 그래서 그림 밑에 흰 잉크를 먼저 까는데, 이 흰 잉크 판을 **화이트 레이어**라고 합니다. Edicus는 렌더링할 때 사용자 디자인에서 화이트 레이어를 자동으로 만들 수 있습니다.

## 배우는 것

* 화이트 레이어를 만드는 렌더 엔티티 세 가지와 필드의 뜻
* 렌더 포맷마다 화이트가 만들어지는 방식
* 화이트 외곽의 흰 테두리를 줄이는 엣지 컷

## 왜 필요한가

화이트는 디자인과 정확히 겹쳐야 합니다. 조금이라도 크면 그림 밖으로 흰 테두리가 비치고, 작으면 가장자리 색이 비칩니다. 사람이 주문마다 화이트 판을 그리지 않도록 렌더 옵션에 규칙을 정해 두고 자동으로 만듭니다.

## 직접 해보기

[렌더 옵션](/docs/products/render-options#화면-사용법)에서 해당 `ps_code`에 엔티티를 더합니다.

1. `gen-white-layer`: 화이트를 만들지와 배경을 포함할지 정합니다. 전역 옵션에는 넣을 수 없으므로 화이트가 필요한 `ps_code`마다 넣습니다.
2. `pdf-white-control`: 화이트의 색, 별색 이름, 해상도, 엣지 컷을 정합니다. 전역 옵션(`0000@prepress`)에 넣어 모든 상품에 같이 쓸 수 있습니다. 다만 그 `ps_code`에 `gen-white-layer`가 없으면 이 엔티티는 읽히지 않습니다.
3. `pdf-white-control2`: PDF2에서 반투명 영역을 채우는 정도만 따로 정합니다. 필요할 때만 넣습니다.

## 렌더 포맷별 동작

화이트는 프리프레스 **Template Render Format**에 따라 다르게 만들어집니다. 렌더 포맷은 [렌더 옵션](/docs/products/render-options#렌더-포맷)을 보세요.

| 포맷 | 만들어지는 방식 | `pdf-white-control` |
| - | - | - |
| PDF2 | 페이지마다 화이트 모양을 이미지로 만들고, 그 모양대로 화이트 색을 칠해 `White` 레이어에 넣습니다 | 모든 필드 적용 |
| PDF | 같은 방식이지만 `outline`이면 벡터 개체의 화이트를 벡터로 만듭니다 | `triple-white`, `alpha-adjust`, `erode` 값 제외 |
| SVG 계열 | `White` 레이어를 검은색 실루엣 파일로 따로 냅니다 | 읽지 않습니다 |

`White` 레이어는 PDF2와 PDF에서 프리프레스 **Post Layering**(또는 [`pdf-file-control`](/docs/products/render-output#pdf-file-control))에 따라 별도 파일(`content-White.pdf` 등), 같은 PDF 안의 레이어, 별도 페이지 중 하나로 나옵니다.

화이트는 디자인의 투명도를 기준으로 만듭니다. 완전히 투명하지 않은 픽셀에는 모두 화이트가 깔립니다. 체크무늬를 그려 넣어 투명해 보이기만 하는 PNG는 이미지 전체에 화이트가 생기므로, 실제 투명 배경 PNG를 써야 합니다.

<Note>
  PDF2는 화이트를 [`assemble-page`](/docs/products/render-options#assemble-page)나 [`grid-page`](/docs/products/render-options#grid-page)로 묶기 전의 원래 페이지 단위로 만들고, 페이지와 함께 배치합니다. 템플릿 페이지에 이미 `White` 레이어가 있으면 그 페이지는 자동 화이트를 만들지 않습니다.
</Note>

## gen-white-layer

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `mode` | `mode` | `none` | `default`로 두어야 화이트를 만듭니다. `none`이면 다른 화이트 엔티티가 있어도 화이트가 생기지 않습니다 |
| `render-layer-has-background` | `renderHasBackground` | 꺼짐 | 배경을 다루는 스위치입니다. 켜야 아래 두 스위치가 화면에 보입니다. 아래 표를 보세요 |
| `render-[#ffffff]-background` | `renderWhiteBackground` | 꺼짐 | 흰색(`#ffffff`) 단색 배경을 컬러 출력에 남길지입니다 |
| `white-layer-has-background` | `whiteHasBackground` | 꺼짐 | 배경 영역에도 화이트를 깔지입니다 |
| `exclude-page` | `excludePage` | 없음 | PDF2 전용. 화이트를 만들지 않을 페이지 번호입니다. `0`부터 세는 원래 페이지 번호를 `0,3`처럼 쉼표로 적습니다. `1-3` 같은 범위는 쓸 수 없습니다 |

### 배경 스위치 세 개

| 결과 | PDF2 | PDF, SVG 계열 |
| - | - | - |
| 컬러 출력의 배경 | 항상 나옵니다 | SVG 계열은 `render-layer-has-background`가 꺼져 있으면 배경을 빼고 출력합니다. PDF는 항상 나옵니다 |
| 흰색 단색 배경 | `render-[#ffffff]-background`가 꺼져 있으면 컬러 출력에서 뺍니다 | `render-layer-has-background`가 켜져 있고 `render-[#ffffff]-background`가 꺼져 있으면 뺍니다 |
| 배경 영역의 화이트 | `render-layer-has-background`와 `white-layer-has-background`가 모두 켜져 있을 때만 깝니다 | 두 스위치가 모두 켜져 있으면 깝니다. 흰색 단색 배경은 `render-[#ffffff]-background`만 켜져 있어도 깝니다 |

<Tip>
  투명 아크릴처럼 배경이 비쳐야 하는 상품은 세 스위치를 모두 끕니다. 배경까지 흰 판을 깔아야 하는 유색 소재는 `render-layer-has-background`와 `white-layer-has-background`를 켭니다.
</Tip>

PDF2에서는 `gen-white-layer`가 있기만 하면 `mode`가 `none`이어도 흰색 단색 배경을 빼는 규칙이 적용됩니다.

## pdf-white-control

`gen-white-layer`가 있어야 읽힙니다.

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `type` | `type` | `default` | 아래 표를 보세요 |
| `color-mode` | `colorMode` | `process` | `process`는 화이트를 CMYK 값으로, `spot`은 별색(인쇄기가 별도 잉크로 찍는 이름 붙은 색)으로 칠합니다 |
| `spot-name` | `spotName` | `white` | `spot`일 때 보입니다. 이름은 자유이며(예: `SPOT_1`), 인쇄 장비와 RIP(인쇄용 변환 소프트웨어)이 화이트로 알아보는 이름을 넣습니다 |
| `color-hex` | `colorHex` | `#000000` | 화면 표시용 RGB 색입니다. CMYK 값이 없을 때만 대신 쓰입니다 |
| `C` `M` `Y` `K` | `colorCMYK` | `0,0,0,0` | `process`면 화이트를 칠할 CMYK 값(0\~100), `spot`이면 별색의 대체 표시 색입니다 |
| `overprint` | `overprint` | 켜짐 | 화이트에 오버프린트(아래 색을 지우지 않고 겹쳐 찍기)를 겁니다. 끄면 화이트가 겹친 자리의 컬러가 화면과 출력에서 지워질 수 있습니다 |
| `multiply` | `multiply` | `2` | 화이트 이미지를 300dpi의 몇 배로 만들지입니다. 클수록 외곽선이 매끄럽고 렌더링이 느려집니다 |
| `alpha-adjust` | `alphaAdjust` | 없음 | PDF2에서 `edge-cut`이 켜져 있을 때만 씁니다. 아래 `pdf-white-control2`와 같습니다 |
| `edge-cut` | `edgeCut` | 꺼짐 | 켜면 화이트를 원본보다 조금 작게 만듭니다. 아래를 보세요 |
| `double-white`, `triple-white` | `doubleWhite`, `tripleWhite` | 꺼짐 | 같은 화이트 판을 두 번, 세 번 찍습니다. 판마다 `spot-name-2`(`white2`), `spot-name-3`(`white3`)과 색을 따로 정합니다. 같은 화이트 모양을 1번, 2번, 3번 별색 순서로 겹쳐 칠합니다. `triple-white`는 PDF2 전용입니다 |

<Warning>
  기본값 `process`와 `0,0,0,0`은 잉크가 없는 색이라 그대로 두면 화이트 판이 비어 보입니다. 보통 `spot`으로 두고 인쇄소가 정한 별색 이름을 넣습니다. `double-white`를 `process`로 쓰면 둘째 판도 첫째 판의 CMYK 값으로 칠해집니다.
</Warning>

### type: 벡터와 래스터

| 값 | PDF | PDF2 |
| - | - | - |
| `default` | 벡터와 래스터(픽셀 이미지) 개체 모두 이미지 화이트 | 이미지 화이트 |
| `outline` | 벡터 개체는 개체마다 떨어진 벡터 화이트, 래스터 개체는 한 덩어리 이미지 화이트 | `default`와 같습니다 |

## edge-cut: 흰 테두리 줄이기

래스터 이미지는 가장자리가 앤티앨리어싱(계단 현상을 줄이려고 경계를 반투명하게 그리는 처리)으로 반투명합니다. 화이트를 원본과 1:1로 만들면 이 반투명한 가장자리 밑으로 흰 테두리가 군데군데 비칩니다. `edge-cut`은 화이트의 가장자리를 깎아 이를 막습니다. PDF2와 PDF에서만 동작합니다.

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `cut-mode` | `edgeCutMode` | `default` | `type`이 `outline`이면 보이지 않습니다. `default`는 모든 개체에, `hybrid`는 래스터 개체에만 적용합니다. `hybrid`는 PDF에서만 구분되고 PDF2는 `default`와 같습니다 |
| `cut-value` | `edgeCutValue` | `erode-0.1` | 깎는 방식과 정도입니다. 아래 표를 보세요 |
| `cut-level` | `edgeCutLevel` | `90` | 렌더링에 쓰이지 않습니다 |

| `cut-value` | 동작 |
| - | - |
| `none` | 완전히 불투명한 픽셀만 남기고 반투명 픽셀을 모두 지웁니다 |
| `erode-0.1` \~ `erode-0.5` | PDF2 전용. 화이트 외곽을 숫자만큼(mm) 고르게 깎습니다. PDF에서는 `none`과 같습니다 |
| `soft-1` \~ `soft-4` | 반투명 픽셀의 화이트 농도를 곡선으로 낮춥니다. 숫자가 클수록 많이 낮춥니다 |
| `hard-1`, `hard-2` | 반투명 픽셀의 화이트 농도를 1/2, 1/4로 낮춥니다. 완전히 불투명한 픽셀은 그대로라 외곽이 깎이지는 않습니다 |
| `shrink-95` \~ `shrink-50` | 원본 불투명도가 숫자(%)를 넘는 픽셀만 화이트로 남깁니다. 숫자가 클수록 많이 깎입니다 |

<Tip>
  처음에는 `erode-0.1`이나 `shrink-50`처럼 약한 값으로 테스트 렌더를 보고 조금씩 올리세요. 너무 세게 깎으면 가장자리 색이 비칩니다.
</Tip>

## pdf-white-control2

PDF2 전용이며 `pdf-white-control`과 함께 넣어야 합니다. 이 엔티티가 있으면 `pdf-white-control`의 `alpha-adjust` 대신 이 값을 씁니다.

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `alpha-adjust` | `alphaAdjust` | `5` | `edge-cut`이 켜져 있을 때, 그림 가장자리에서 이 픽셀 수보다 안쪽에 있는 반투명 영역을 완전한 화이트로 채웁니다. 가장자리 띠는 그대로 두므로 그림자나 반투명 효과 밑이 비어 보이는 것을 막습니다 |

## 편집기에서 화이트 고르기

사용자가 편집기에서 화이트를 넣을 개체를 고르게 하는 설정은 상품 설정에 있습니다. [자산: 스티커, 도형, 컷아웃, 패턴, 박, 레이어](/docs/products/assets)의 `white-select`를 보세요. 사용자가 화이트를 뺀 개체는 `gen-white-layer`가 화이트를 만들 때 건너뜁니다.

## 됐는지 확인

<Check>
  [테스트 주문과 렌더링](/docs/templates/test-render)으로 받은 PDF를 분판 미리보기로 열어, 화이트가 정한 별색 이름으로 분리돼 있고 그림 밖으로 흰 테두리가 비치지 않으면 됩니다.
</Check>

## 다음 단계

<Columns cols={2}>
  <Card title="스티컷 상품" icon="scissors" href="/docs/products/sticut">
    키링, 스탠드, 스마트톡처럼 그림 모양대로 자르는 상품을 설정합니다.
  </Card>

  <Card title="렌더 옵션" icon="print" href="/docs/products/render-options">
    다른 렌더 엔티티를 봅니다.
  </Card>
</Columns>


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