注：当前项目为 Serverless Devs 应用，由于应用中会存在需要初始化才可运行的变量（例如应用部署地区、函数名等等），所以不推荐直接 Clone 本仓库到本地进行部署或直接复制 s.yaml 使用，强烈推荐通过 s init ${模版名称} 的方法或应用中心进行初始化，详情可参考部署 & 体验 。

start-pdf-watermark-v3 帮助文档

本案例将 PDF Watermark，这一方便且实用的工具，快速创建并部署到阿里云函数计算 FC。

• 😺 代码

前期准备

使用该项目，您需要有开通以下服务并拥有对应权限：

服务/业务	权限	相关文档
函数计算	AliyunFCFullAccess	帮助文档 计费文档

部署 & 体验

• 🔥 通过 Serverless 应用中心 ， 该应用。

• 通过 Serverless Devs Cli 进行部署：
  • 安装 Serverless Devs Cli 开发者工具 ，并进行授权信息配置 ；
  • 初始化项目：s init start-pdf-watermark-v3 -d start-pdf-watermark-v3
  • 进入项目，并进行项目部署：cd start-pdf-watermark-v3 && s deploy -y

案例介绍

本案例将 PyPDF2，这一广泛使用的 Python 库，快速创建并部署到阿里云函数计算 FC。

PyPDF2 使得处理PDF文件变得既简单又高效。通过这个库，用户可以执行多种对PDF文件的操作，包括读取、写入以及修改PDF。

通过 Serverless 开发平台，您只需要几步，就可以体验 PDF Watermark工具，并享受 Serverless 架构带来的降本提效的技术红利。

使用流程

查看部署的案例

项目部署完成，可以通过控制台进行测试：

1、部署成功后，从资源信息栏，找到对应函数资源，点击函数名称跳转到函数计算控制台，如： 2、在代码页签，单击测试函数右侧的图标，从下拉列表中选择配置测试参数，输入如下示例测试参数，然后单击确定。

{
    "pdf_file": "example.pdf",
    "mark_text": "AliyunFC",  
    "pagesize": [595.275590551181, 841.8897637795275], 
    "font": "Helvetica", 
    "font_size": 30, 
    "font_color": [0, 0, 0], 
    "rotate": 30, 
    "opacity": 0.1, 
    "density": [198.4251968503937, 283.46456692913387] 
}

参数	是否必填	描述
pdf_file	必填	pdf文件名称
mark_text	必填	水印文字， 如果给 PDF 加水印
pagesize	可选	默认是 A4 大小， (21cm, 29.7cm), 其中 1cm=28.346456692913385
font	可选	字体，默认为 Helvetica, 中文字体可选择为 zenhei 或 microhei
font_size	可选	字体的大小，默认为 30
font_color	可选	字体颜色，格式为 RGB， 默认为黑色
rotate	可选	旋转角度，默认为 0
opacity	可选	透明度，默认为 0.1， 1 表示不透明
density	可选	水印密度，水印文字间隔，默认是 [141.73228346456693, 141.73228346456693]，即（7cm, 10cm), 表示每个水印文字在横坐标和纵坐标的间隔分别是 7cm 和 10

3、单击测试函数，函数执行成功后，查看返回结果。

 upload to oss success!

如果您需要使用 SDK 调用这个函数， 可以参考 OpenAPI

生成带有水印的 example_out.pdf 示例，生成的 pdf 文件在和输入的 pdf 文件在相同的 OSS 目录中:

二次开发

您可以通过云端控制台的开发功能进行二次开发。如果您之前是在本地创建的项目案例，也可以在本地项目目录start-pdf-watermark-v3文件夹下，对项目进行二次开发。开发完成后，可以通过s deploy进行快速部署。

注意事项

开发者社区

您如果有关于错误的反馈或者未来的期待，您可以在 Serverless Devs repo Issues 中进行反馈和交流。如果您想要加入我们的讨论组或者了解 FC 组件的最新动态，您可以通过以下渠道进行：

微信公众号：serverless	微信小助手：xiaojiangwh	钉钉交流群：33947367