---
name: coderwanfeng-add-text-watermark
description: "给 PDF 添加文字水印，支持自定义字体、字号、颜色、位置。当用户提到 PDF 文字水印、PDF 加水印 时使用。"
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "2f9fe847-85ef-4a11-b7bf-610a4b40063c"
  decimalai-version-id: "fc00e39d-6f81-4845-845e-e388b53f1a72"
  decimalai-version: "2"
  decimalai-body-sha256: "f1b4b4008958086575529583c27c9b9fe79fdb969b1f3ec909d949fe87a42cfd"
  decimalai-name: "coderwanfeng/add_text_watermark"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "documentation"
  decimalai-source: "https://app.decimal.ai/s/coderwanfeng-add-text-watermark@2/SKILL.md"
---
# add_text_watermark Skill

> 在 PDF 文档中添加文本水印

## 功能描述

向 PDF 文档添加文本水印，可自定义位置、字体、字号、颜色等参数。

## 所属分类

`office/skills/pdf/add_text_watermark/`

## 调用方式

```python
from skills.pdf import add_text_watermark

add_text_watermark(
    input_file='./test.pdf',
    point=(100, 200),
    text='python-office',
    output_file='./with_watermark.pdf',
    fontname='Helvetica',
    fontsize=12,
    color=(1, 0, 0)
)
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `input_file` | str | 否 | - | PDF 文件路径 |
| `point` | tuple | 否 | - | 水印位置坐标 |
| `text` | str | 否 | `'python-office'` | 水印文本内容 |
| `output_file` | str | 否 | `'./pdf_watermark.pdf'` | 输出 PDF 文件路径 |
| `fontname` | str | 否 | `'Helvetica'` | 字体名称 |
| `fontsize` | int | 否 | `12` | 字体大小 |
| `color` | tuple | 否 | `(1, 0, 0)` | 字体颜色（RGB） |

## 返回值

`None`

## 使用示例

```python
from skills.pdf import add_text_watermark
add_text_watermark(input_file='./report.pdf', text='机密文件')
```

## 视频教程

https://www.python4office.cn/python-office/popdf/%E8%AF%BE%E7%A8%8B/7-add_watermark

## 原始函数

`office.api.pdf.add_text_watermark`