> ## 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 Manager **상품 설정**의 **자산** 그룹을 다룹니다. 같은 그룹의 **재단(스티컷)** 줄은 [스티컷 상품](/docs/products/sticut)에 있습니다.

## 배우는 것

* 스티커 목록과 도형 도구를 정하는 방법
* 컷아웃 탭과 배경 제거 기능을 여는 방법
* 자유 패턴을 쓰는 방법
* 박을 쓰는 상품에서 박 종류 수를 검사하는 방법
* 레이어 표시와 화이트 선택 도구를 여는 방법

저장 키는 모두 `template_option` 아래에 있습니다. 기본값은 Manager에서 새 상품을 만들 때의 값입니다. UI 이름은 **데스크톱**, `mobile: true`로 띄우는 **기존 모바일 UI**, `mobile: 'm2'`로 띄우는 **신규 모바일 UI**로 씁니다. lite 편집기([용어집](/docs/reference/glossary#lite-편집기))는 이 페이지의 항목 중 `layer-ui`만 읽습니다.

## 스티커 · 도형

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `sticker-group` | `stickerGroup` | `default` | 스티커 탭에 보일 스티커 그룹입니다. 파트너의 `sticker-manage`가 `category`일 때만 쓰입니다. 아래를 보세요 |
| `shape-fill-ui` | `shapeFillUI` | 꺼짐 | 데스크톱 도형 툴바의 채우기 색 선택에 **색 없음**을 넣어 속이 빈 도형을 만들 수 있게 합니다 |
| `no-shape` | `noShape` | 꺼짐 | 데스크톱 스티커 탭의 도형 목록과 기존 모바일 UI의 도형 추가를 숨깁니다. 신규 모바일 UI는 이 값을 읽지 않습니다 |
| `shape-thick` | `shapeThick` | `default` | 새로 넣는 도형의 테두리 두께입니다. `default`는 1mm, `0`은 테두리 없음입니다 |
| `no-rsc-api` | `noCustomApi` | 꺼짐 | 파트너가 리소스를 커스텀 API로 관리하더라도 이 상품은 템플릿, 레이아웃, 배경, 스티커 목록을 Edicus 리소스 서버에서 받습니다 |
| `as-cell` | `stickerAsCell` | 꺼짐 | 스티커 탭에서 고른 그림을 스티커가 아니라 사진 칸으로 넣습니다. 넣은 뒤에는 사진처럼 자르고 바꿀 수 있습니다 |

`sticker-group`이 쓰이려면 먼저 [Customize 동작 설정](/docs/products/customize-config#asset-settings)의 **Asset Settings**에서 `sticker-manage`가 `category`여야 합니다. 기본값 `none`이면 스티커 탭이 카테고리 없이 공개 스티커 전체를 보여 주고, 이 값은 무시됩니다.

`category`일 때 편집기는 이 그룹 코드로 스티커 카테고리와 목록을 불러옵니다. 그룹은 Sticker 메뉴에서 만듭니다. [스티커·패턴·디자인 관리](/docs/products/stickers)를 보세요. 파트너가 커스텀 리소스 API를 쓰고 `no-rsc-api`가 꺼져 있으면, 편집기는 그룹과 관계없이 그 API에서 목록을 받습니다.

* [사이즈 고급 옵션](/docs/products/size-options#product-override)의 product override(`Sticker Group`)로 사이즈마다 다른 그룹을 쓸 수 있습니다.
* 박이나 단일 색 팔레트를 엄격하게 쓰는 상품은 `shape-thick`과 관계없이 새 도형의 테두리를 두지 않습니다.
* 띄울 때 `option_string`에 `prodinfo_stickerAsCell=true`를 주면 `as-cell`을 켤 수 있습니다.

## 컷아웃

**컷아웃** 줄은 **탭 구성**의 `cutout-tab`을 켜야 열립니다. 파트너 권한에 따라 잠금으로 표시될 수 있습니다. 컷아웃 탭은 데스크톱 UI에 있습니다.

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `cutout-tab-mode` | `cutoutTabMode` | `default` | 컷아웃 탭에 보일 업로드 버튼입니다. 아래 표를 보세요 |
| `as-image` | `cutoutAsImage` | 꺼짐 | 탭 버튼의 이름과 아이콘을 **컷아웃** 대신 **이미지**로 보여 줍니다. 기능은 같습니다 |

| `cutout-tab-mode` | 버튼 |
| - | - |
| `default` | **자를 사진 가져오기**. JPEG 사진을 올려 오려 낼 영역을 직접 다듬습니다 |
| `import-png-only` | **이미지 불러오기 (PNG,JPG)**. 투명 배경 PNG를 그대로 컷아웃으로 올립니다. 버튼 이름과 달리 PNG만 받습니다 |
| `import-png-with` | 위 두 버튼을 모두 보여 줍니다 |

### cutout-api

화면에서는 **재단(스티컷)** 줄에 있는 `cutout-api`(`apiInfo.cutoutSticut`, 기본값 꺼짐)가 사진 배경 제거(AI 누끼) 기능을 켭니다. 파트너에 배경 제거 API가 연결돼 있고 사용 중일 때만 동작합니다. 연결된 API가 없으면 켜도 버튼이 생기지 않습니다.

* 데스크톱과 기존 모바일 사진 탭에 **배경 제거하기** 버튼이 생깁니다. 스티컷 상품이 아니어도 보입니다. 신규 모바일 UI 사진 탭에는 이 버튼이 없습니다.
* 스티컷 상품이면 스티컷 플러그인에도 배경 제거 기능을 넘깁니다.
* 버튼의 파일 선택 창은 JPEG만 보여 줍니다.
* 결과 화면에서 **마스크 보기**와 **이미지 보기**를 번갈아 결과를 확인하고, 필요하면 **보정하기**로 다듬은 뒤 적용합니다.

배경 탭의 `remove-bg`와는 다른 기능입니다. `remove-bg`는 배경 탭에서 페이지 배경을 지우는 버튼이며 [레이아웃과 배경](/docs/products/layout-background)에 있습니다.

## 패턴

**패턴** 줄은 파트너 권한에 따라 잠금으로 표시될 수 있습니다. 배경 탭의 패턴 그룹은 [레이아웃과 배경](/docs/products/layout-background)에 있습니다.

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `pattern-mode` | `patternMode` | `none` | `free-item`이면 자유 패턴을 씁니다. 아래를 보세요 |
| `initial-size` | `patternSize` | `default` | 자유 패턴을 처음 만들 때의 크기입니다. `free-item`일 때 열립니다 |
| `pattern-pos` | `patternPos` | `default` | 자유 패턴을 넣을 위치입니다. `free-item`일 때 열립니다 |

`free-item`으로 두면, 데스크톱과 모바일 캔버스에서 스티커, 그림, 글상자, 사진 칸을 하나 선택했을 때 **자유 패턴 만들기** 버튼이 보입니다. 누르면 선택한 개체를 무늬로 반복하는 패턴 개체를 만듭니다. 이 패턴은 옮기고 크기를 바꿀 수 있습니다. 마스킹테이프처럼 페이지 전체를 무늬로 채우는 상품에서는 이 버튼 대신 **배경 패턴 만들기**가 보입니다.

| `initial-size` | 처음 크기 |
| - | - |
| `default` | 페이지의 작업 영역 전체 |
| `render-size` | 페이지의 출력 영역 전체 |
| `fit-size` | 편집기는 따로 처리하지 않습니다. `default`와 같습니다 |
| `object-size` | 작업 영역의 60% 크기로 가운데에 |

| `pattern-pos` | 위치 |
| - | - |
| `default` | 다른 개체를 넣을 때와 같은 순서 자리 |
| `top` | 맨 위 |

## 박(호일)

박은 금박, 은박처럼 잉크 대신 박을 찍는 후가공입니다. 박 종류는 Palette 메뉴의 팔레트에 정의합니다. 박 종류가 하나 이상 있는 팔레트만 `foil-code` 목록에 나옵니다. 팔레트 만드는 방법은 [팔레트](/docs/products/palettes)에 있습니다.

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `foil-code` | `foilCode` | `none` | 이 상품에서 쓸 박 팔레트입니다. `none`이면 박을 쓰지 않습니다 |
| `foil-mode` | `foilMode` | `default` | `strict`면 새 개체에 박이 자동으로 걸리고 박을 해제할 수 없습니다. 아래를 보세요 |
| `foil-check` | `foilCheck` | `none` | `1-page`면 박을 한 페이지에만 쓰게 합니다. `foil-code`가 `none`이 아닐 때 열립니다 |
| `foil-max` | `foilMax` | `0` | 쓸 수 있는 박 종류의 최대 개수입니다. `0`이면 검사하지 않습니다. `foil-code`가 `none`이 아닐 때 열립니다 |
| `foil-min` | `foilMin` | `0` | 써야 하는 박 종류의 최소 개수입니다. `0`이면 검사하지 않습니다. `foil-code`가 `none`이 아닐 때 열립니다 |
| `foil-ui-style` | `foilUIStyle` | `default` | 박을 고르는 UI 위치입니다. `default`는 개체 툴바, `float`는 데스크톱 캔버스 아래의 떠 있는 선택 창입니다. `foil-code`가 `none`이 아닐 때 열립니다 |

### 편집기에서 바뀌는 것

* 편집기가 팔레트를 불러와 박 종류가 있으면 박 기능이 켜집니다. 사진 칸, 글상자, 패스 글자, 스티커, 그림, 도형을 선택하면 박을 고를 수 있습니다. 신규 모바일 UI와 기존 모바일 UI도 사진 칸에서 박을 고릅니다.
* 박 기능이 켜진 상품은 데스크톱 사진 칸 툴바에서 테두리 도구가 사라집니다.
* `foil-mode`가 `strict`면 새로 넣는 사진 칸, 글상자, 스티커, 그림, 도형에 박이 자동으로 걸리고, 박 선택 목록에서 **선택 해제**가 빠져 박을 해제할 수 없습니다. 이 항목 이름은 데스크톱, 기존 모바일 UI, 신규 모바일 UI 모두 **선택 해제**입니다. 다른 박으로 바꾸는 것만 됩니다. 자동으로 거는 박은 문서에서 가장 많이 쓴 박이고, 아직 쓴 박이 없으면 팔레트의 첫 번째 박입니다. 새 도형은 테두리 없이 만들어집니다.
* 박을 고른 결과 종류 수가 `foil-max`를 넘으면 바로 안내창을 띄웁니다. 박은 그대로 적용되고, 완료할 때 다시 검사합니다.
* `foil-code`와 `foil-mode`는 [사이즈 고급 옵션](/docs/products/size-options#product-override)의 product override(`Foil Code`, `Foil Mode`)와 edicus options로 사이즈마다 바꿀 수 있습니다.

### 완료할 때의 검사

사용자가 편집을 마치고 완료 버튼을 누르면 편집기가 문서를 검사합니다. 숨긴 개체는 세지 않습니다. 검사에 걸리면 안내창을 띄우고 완료를 멈춥니다. 모든 UI에서 같습니다.

| 설정 | 무엇을 세는가 | 안내 |
| - | - | - |
| `foil-check: 1-page` | 박을 쓴 페이지 수가 2 이상인지 | "○○ 레이어는 1페이지에만 사용될 수 있습니다" |
| `foil-max` | 쓴 박 종류 수가 최대보다 많은지 | "○○ 종류 최대 N개를 초과해 저장할 수 없습니다" |
| `foil-min` | 쓴 박 종류 수가 최소보다 적은지 | "○○ 종류를 N개 이상으로 편집해 주세요" |

안내의 ○○ 자리에는 팔레트에 적은 안내용 이름이 들어가고, 없으면 팔레트 표시 이름이 들어갑니다. 박 종류 수는 같은 박을 여러 개체에 써도 하나로 셉니다.

## 레이어

| 화면 이름 | 저장 키 | 기본값 | 설명 |
| - | - | - | - |
| `layer-ui` | `layerUI` | 꺼짐 | 데스크톱 캔버스에 레이어 상자를 보여 줍니다. **Print**(일반 인쇄)와 문서에 쓰인 후가공 레이어(박 등) 목록이 나오고, 체크를 풀면 그 레이어를 화면에서 잠시 숨깁니다 |
| `preview` | `layerPreview` | 꺼짐 | 미리보기 창에도 같은 레이어 목록을 보여 줍니다 |
| `make-white` | `makeWhiteLayer` | 꺼짐 | 편집기와 렌더는 이 값을 읽지 않습니다. 파트너 권한에 따라 잠금으로 표시될 수 있습니다 |
| `surface-stack` | `useSurfaceStack` | 꺼짐 | 사이즈의 surface stack 설정을 씁니다. 아래를 보세요 |
| `white-select` | `whiteSelectUI` | 꺼짐 | 개체 하나를 선택하면 화이트를 깔지 고르는 도구를 보여 줍니다. 아래를 보세요 |

후가공 레이어 이름은 템플릿의 레이어 이름으로 정합니다. [레이어 이름과 개체 종류](/docs/templates/layers)를 보세요.

### surface-stack

`surface-stack`을 켜고 [사이즈 고급 옵션](/docs/products/size-options#surface-stack)의 surface-stack 종류를 `default`로 두면, 편집기는 그 설정의 첫 번째 구성을 씁니다.

* 새 프로젝트의 페이지 수를 구성의 `pageSettings` 항목 수에 맞춥니다.
* 아크릴 스탠드처럼 앞뒷면이 있는 스티컷 상품은 이 구성으로 뒷면 페이지와 좌우 반전을 정하고, 메인 페이지(`mainPageIndex`)에 스티컷을 만듭니다.
* 사이즈 미리보기 종류가 `surface-stack`이면 이 구성으로 겹쳐 본 미리보기를 보여 줍니다.

### white-select

화이트는 투명 소재 밑에 까는 흰 잉크입니다. `white-select`를 켜면 데스크톱과 기존 모바일 캔버스에 화이트 선택 상자가, 신규 모바일 UI에는 **화이트** 도구 버튼이 생깁니다. 사용자는 개체마다 화이트를 깔지 고릅니다. 편집기는 페이지마다 화이트를 까는 개체와 빼는 개체의 수를 세어, 저장할 때 보고하는 페이지 정보에 담습니다. 이 도구를 켜면 스티컷 그림도 선택해서 고를 수 있습니다.

* [사이즈 고급 옵션](/docs/products/size-options#product-override)의 product override(`White Select`)로 사이즈마다 바꿀 수 있습니다.
* 띄울 때 `option_string`에 `white_select=true`나 `white_select=false`를 주면 덮어씁니다.

### 렌더에서 화이트 선택이 쓰이는 방식

화이트 판은 편집기가 아니라 렌더가 만듭니다. 렌더가 렌더 옵션의 `gen-white-layer`로 `White` 레이어를 만들 때 사용자가 화이트를 뺀 개체는 건너뜁니다. 렌더 포맷(PDF2, PDF, SVG 계열)과 관계없이 같습니다. 그래서 `white-select`는 렌더 옵션으로 화이트 판을 만드는 상품에서만 결과가 달라집니다. 설정 방법은 [화이트 레이어](/docs/products/white-layer)를 보세요.

## 됐는지 확인

<Check>
  1. `sticker-group`을 쓴다면 먼저 [Customize 동작 설정](/docs/products/customize-config#asset-settings)의 `sticker-manage`가 `category`인지 봅니다.
  2. 상품을 **Update**로 저장하고 Manager **Resource**에서 이 상품의 템플릿을 고른 뒤 **Demo**로 엽니다. 스티커 탭에 고른 그룹의 카테고리가 보이면 됩니다.
  3. 박 상품은 [테스트 주문과 렌더링](/docs/templates/test-render)의 **Test Order**로 엽니다. Demo는 저장할 수 없기 때문입니다. 박을 `foil-max`보다 많은 종류로 쓴 뒤 완료를 눌러 안내가 뜨면 됩니다.
  4. 화이트 선택은 Test Order로 주문을 만들어 렌더링한 뒤, 화이트를 뺀 개체 밑에 화이트가 없는지 봅니다.
</Check>

## 다음 단계

<Columns cols={2}>
  <Card title="스티컷 상품" icon="scissors" href="/docs/products/sticut">
    그림 모양대로 자르는 상품을 설정합니다.
  </Card>

  <Card title="화이트 레이어" icon="layer-group" href="/docs/products/white-layer">
    투명 소재에 쓰는 화이트를 렌더 옵션으로 만듭니다.
  </Card>
</Columns>


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