# Canvas에 아이콘 그리기

- Human documentation: [https://docs.univer.ai/ko-KR/guides/icons/canvas](https://docs.univer.ai/ko-KR/guides/icons/canvas)

- Agent Markdown: [https://docs.univer.ai/ko-KR/guides/icons/canvas.md](https://docs.univer.ai/ko-KR/guides/icons/canvas.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.6.0`

- Source: [icons/canvas.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/icons/canvas.ko-KR.mdx)

---

`@univerjs/icons-svg` 1.48.0 이상에서 제공하는 `drawCanvasIcon`으로 Canvas 2D 컨텍스트에 기본 아이콘을 동기적으로 그릴 수 있습니다.

```package-install
npm install @univerjs/icons-svg
```

## 필터 아이콘 그리기

페이지에 캔버스 요소를 추가하고 요소가 생성된 후 다음 코드를 실행합니다.

```html
<canvas id="toolbar-icons" width="48" height="24"></canvas>
```

```ts
import { drawCanvasIcon } from '@univerjs/icons-svg'

const canvas = document.querySelector<HTMLCanvasElement>('#toolbar-icons')
const ctx = canvas?.getContext('2d')

if (ctx) {
  drawCanvasIcon(ctx, 'filter-applied-icon', 4, 4, 16, '#2563eb')
}
```

처음 두 숫자는 그리기 영역 왼쪽 위의 좌표이고, 세 번째는 정사각형 영역의 한 변 길이입니다. 모두 캔버스 좌표 단위를 사용합니다. 아이콘은 가로세로 비율을 유지하면서 영역 중앙에 배치됩니다.

## 아이콘 이름과 색상 선택

패키지가 내보내는 `CanvasIconName` 타입으로 지원하는 이름을 자동 완성할 수 있습니다. `filter-applied-icon`처럼 파일명에서 `.svg`를 뺀 이름을 사용합니다. 카탈로그의 SVG 중 일부가 Canvas를 지원합니다.

마지막 인수를 생략하면 SVG의 원래 색상이 유지됩니다. 색상 하나를 전달하면 기본색과 강조색이 함께 바뀝니다. 특정 색상만 바꾸려면 원래 SVG 색상을 키로 하는 객체를 전달합니다. 다음 예시는 별의 채워진 절반을 금색으로 바꿉니다.

```ts
if (ctx) {
  drawCanvasIcon(ctx, 'star-incomplete-double-icon', 28, 4, 16, { black: '#d97706' })
}
```

## Univer 장면 안에 아이콘 그리기

`@univerjs/engine-render`는 Canvas 아이콘을 장면 도형으로 그리는 `CanvasIconShape`를 내보냅니다. 생성자는 `(key, icon, props)`이며, `key`는 도형을 식별하고 `icon`은 `CanvasIconName`, `props`는 `IShapeProps`입니다. `scene.addObject(shape)`로 도형을 장면에 추가합니다.

```ts
import { CanvasIconShape, IRenderManagerService } from '@univerjs/engine-render'

// The unit whose scene should contain the icon.
const unitId = 'your-unit-id'
const render = univer.__getInjector().get(IRenderManagerService).getRenderUnitById(unitId)

if (render) {
  const shape = new CanvasIconShape('filter-icon', 'filter-applied-icon', {
    left: 24,
    top: 16,
    width: 16,
    height: 16,
    fill: '#2563eb',
  })

  render.scene.addObject(shape)
}
```

도형은 `Math.min(width, height)`를 아이콘 상자로 사용하고 나머지 공간에서 아이콘을 가운데 정렬합니다. 정사각형이 아닌 도형은 긴 축에 여백이 남습니다.
