# 워터마크

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

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

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.0.4`

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

---

#### Package metadata

```json
{
  "plugins": [
    {
      "client": "@univerjs/watermark",
      "facade": "@univerjs/watermark/facade"
    }
  ],
  "server": false
}
```

워터마크 기능은 웹 페이지나 애플리케이션을 위한 유연하고 안전한 워터마크 솔루션을 제공합니다. 개발자는 페이지에 텍스트 또는 이미지 워터마크를 동적으로 생성하여 콘텐츠의 무단 사용이나 유포를 방지할 수 있으며, 다양한 구성 옵션도 지원합니다.

> Interactive example: [Open the playground](/playground/docs/watermark)

## 플러그인 모드

### 설치

#### npm

```bash
npm install @univerjs/watermark
```

#### pnpm

```bash
pnpm add @univerjs/watermark
```

#### yarn

```bash
yarn add @univerjs/watermark
```

#### bun

```bash
bun add @univerjs/watermark
```

### 사용법

```typescript
import { UniverWatermarkPlugin } from '@univerjs/watermark' // [!code ++]

import '@univerjs/watermark/facade' // [!code ++]

const univer = new Univer({
  // ...
})

univer.registerPlugin(UniverWatermarkPlugin, { // [!code ++]
  textWatermarkSettings: { // [!code ++]
    content: 'Hello, Univer!', // [!code ++]
    fontSize: 36, // [!code ++]
  }, // [!code ++]
}) // [!code ++]
```

### 플러그인 및 구성

#### @univerjs/watermark

이 플러그인은 워터마크 기능의 핵심 구현을 제공합니다. 개발자가 애플리케이션에 텍스트 또는 이미지 워터마크를 추가할 수 있으며, 워터마크의 모양과 동작을 맞춤 설정할 수 있는 다양한 구성 옵션을 제공합니다. `UniverWatermarkPlugin` 플러그인을 제공합니다.

참고: [@univerjs/watermark](https://docs.univer.ai/ko-KR/reference/packages/plugins/univerjs/watermark.md)

## 프리셋 모드

워터마크는 프리셋을 제공하지 않지만 플러그인과 함께 사용할 수 있습니다.

### 설치

#### npm

```bash
npm install @univerjs/watermark
```

#### pnpm

```bash
pnpm add @univerjs/watermark
```

#### yarn

```bash
yarn add @univerjs/watermark
```

#### bun

```bash
bun add @univerjs/watermark
```

### 사용법

```typescript
import { UniverWatermarkPlugin } from '@univerjs/watermark' // [!code ++]

import '@univerjs/watermark/facade' // [!code ++]

const { univerAPI } = createUniver({
  // ...
  presets: [
    UniverDocsCorePreset(),
  ],
  plugins: [
    [UniverWatermarkPlugin, { // [!code ++]
      textWatermarkSettings: { // [!code ++]
        content: 'Hello, Univer!', // [!code ++]
        fontSize: 36, // [!code ++]
      }, // [!code ++]
    }], // [!code ++]
  ],
})
```

## Facade API

### 가져오기

> [!INFO: 플러그인 모드 참고 사항]
> 플러그인 모드에서만 Facade 패키지를 직접 가져와야 합니다. 프리셋 모드에는 해당 Facade 패키지가 이미 포함되어 있으므로 별도로 가져올 필요가 없습니다.

```typescript
import '@univerjs/watermark/facade'
```

### 워터마크 설정

```typescript
univerAPI.addWatermark('text', { content: 'hello', repeat: true })
```

### 워터마크 제거

```typescript
univerAPI.deleteWatermark()
```