watermark

type Image struct {
	// Data 是图片字节（如 PNG）。设置了 Opacity 时仅支持 PNG，并按不透明度
	// 烘焙进图片自身的 alpha 通道后嵌入。
	Data []byte
	// Format 是 DocumentRes.xml 的 Format 属性值（如 "PNG"、"JPEG"），空值默认 "PNG"。
	Format string
	// Width 是单张图片显示宽度（毫米），0 使用默认值 40。
	Width float64
	// Height 是单张图片显示高度（毫米），0 时按图片像素宽高比推算。
	Height float64
	// Layout 指定水印在页面上的布局方式，默认 LayoutManual。
	Layout TextLayout
	// Opacity 是整体不透明度（0 到 255），设置后烘焙进 PNG 的 alpha 通道。
	Opacity *uint8
}

type ImageOptions struct {
	// ID 是首个图片对象 ID；平铺时自增。0 使用默认值 1。
	ID uint64
	// ImageID 是被引用的媒体资源 ID，必填。
	ImageID uint64
	// Boundary 是布局区域（平铺/居中计算使用）；零尺寸时使用整页 A4 边界。
	Boundary creator.Box
	// Width 是单张图片显示宽度（毫米）；0 使用默认值 40。
	Width float64
	// Height 是单张图片显示高度（毫米）；0 时按 Aspect 推算。
	Height float64
	// Aspect 是图片宽高比（宽/高）；Height 为 0 且 Aspect 为 0 时按正方形处理。
	Aspect float64
	// X、Y 是布局偏移。LayoutManual 时是单张图片的起始位置；
	// 平铺/居中模式下作为相对计算位置的偏移。
	X, Y float64
	// Gap 是平铺行列间距（毫米）；0 使用默认值 5。
	Gap float64
	// Layout 指定布局方式，默认 LayoutManual。
	Layout TextLayout
}

type Options struct {
	replace.Options

	// SkipPermissionsCheck 跳过文档级水印权限检查（Permissions/Watermark=false 时默认拒绝）。
	SkipPermissionsCheck bool
	// SkipReadOnlyCheck 跳过只读检查（ReadOnly 缺省或为 true 的水印默认拒绝 Replace/Remove）。
	SkipReadOnlyCheck bool
}

type Target struct {
	// Document 是文档体下标，-1 表示全部文档体，0 表示第一个文档体。
	Document int
	// Pages 是页面下标列表，相对于 Document.xml 的 <Pages> 顺序；空表示全部页面。
	Pages []int
	// MatchIDs 是仅匹配的注解 ID；Replace/Remove 使用，空表示匹配全部水印注解。
	MatchIDs []uint64
}

type TextLayout int

type TextOptions struct {
	// ID 是文本对象 ID；0 使用默认值 1。
	ID uint64
	// Font 是 Font 属性值（字体 ID 或名称）；空使用 "0"。
	Font string
	// Size 是字号；0 使用默认值 9。
	Size float64
	// Text 是 TextCode 内容，必填。
	Text string
	// X、Y 是布局偏移。LayoutManual 时就是文字起始位置；
	// 平铺/居中模式下作为相对计算位置的偏移。
	X, Y float64
	// Boundary 是布局区域（平铺/居中计算使用）；零尺寸时使用整页 A4 边界。
	Boundary creator.Box
	// CTM 是文本对象变换矩阵；零值表示不输出 CTM。
	CTM [6]float64
	// Color 是 FillColor；nil 时不输出 FillColor。
	Color *creator.Color
	// Fill 指定是否填充；nil 时不输出 Fill 属性。
	Fill *bool
	// Opacity 是整体不透明度（Alpha 属性），取值范围 0 到 255；nil 时不输出。
	Opacity *uint8
	// Layout 指定布局方式，默认 LayoutManual。
	Layout TextLayout
	// Rotation 是文字旋转角度（度），正值在屏幕上为顺时针（左边往上、右边向下），
	// 绕每个文本实例自身中心倾斜、位置不偏移。与 CTM 同时指定时以 CTM 为准。
	Rotation float64
	// LineGap 是平铺行间距（毫米）；0 使用默认值 size*0.6。
	LineGap float64
	// ColumnGap 是平铺列间距（毫米）；0 使用默认值 size*0.6。
	ColumnGap float64
}

type Watermark struct {
	// ID 是注解 ID，0 表示自动分配（取文档最大对象标识与页面内既有注解 ID 之后的空闲值）。
	ID uint64
	// Creator 是创建者名称，空值使用默认名称。
	Creator string
	// LastModDate 是最后修改日期，零值使用当天。
	LastModDate time.Time
	// Visible 指定注解是否可见；空值按 XSD 默认 true。
	Visible *bool
	// Subtype 是注解子类型。
	Subtype string
	// Print 指定是否随文档打印；空值按 XSD 默认 true。
	Print *bool
	// NoZoom 指定注解不随页面缩放。
	NoZoom bool
	// NoRotate 指定注解不随页面旋转。
	NoRotate bool
	// ReadOnly 指定注解为只读；空值按 XSD 默认 true。
	ReadOnly *bool
	// Remark 是注解备注。
	Remark string
	// Parameters 是注解自定义参数。
	Parameters []creator.AnnotationParameter
	// Boundary 是注解外观边界（毫米），为空时 `<Appearance>` 不写 Boundary 属性。
	Boundary *creator.Box
	// Appearance 是 `<Appearance>` 内容（页面对象片段）的原始 XML；为空时外观为空元素。
	// 设置了 Image 时本字段被忽略，外观由引擎根据图片资源自动生成。
	Appearance []byte
	// Image 指定图片水印：引擎会把图片写入文档资源、注册到 DocumentRes.xml，
	// 并按布局方式生成 ImageObject 外观。设置后忽略 Appearance。
	Image *Image
}