creator

type Action struct {
	// Event 是触发动作的事件类型。
	Event ActionEvent
	// Region 是动作触发区域，可选。
	Region *ActionRegion
	// URI 是外部 URI 动作目标，与其他动作目标互斥。
	URI *URIAction
	// Goto 是当前文档内的页面跳转目标，与其他动作目标互斥。
	Goto *GotoAction
	// GotoA 是文档附件跳转目标，与其他动作目标互斥。
	GotoA *GotoAAction
	// Sound 是声音播放目标，与其他动作目标互斥。
	Sound *SoundAction
	// Movie 是影片控制目标，与其他动作目标互斥。
	Movie *MovieAction
}

type ActionArea struct {
	// Start 是区域路径的起始点，单位为毫米。
	Start Point
	// Commands 是从 Start 开始的路径命令。
	Commands []RegionCommand
}

type ActionEvent string

type ActionRegion struct {
	// Areas 是动作触发区域中的路径列表。
	Areas []ActionArea
}

type Annotation struct {
	// ID 是注解标识。
	ID uint64
	// Type 是注解类型。
	Type string
	// Creator 是注解创建者。
	Creator string
	// LastModDate 是注解最后修改时间。
	LastModDate time.Time
	// Visible 指定注解是否可见；为空时使用默认值。
	Visible *bool
	// Subtype 是注解子类型。
	Subtype string
	// Print 指定注解是否随文档打印；为空时使用默认值。
	Print *bool
	// NoZoom 指定注解是否不随页面缩放。
	NoZoom bool
	// NoRotate 指定注解是否不随页面旋转。
	NoRotate bool
	// ReadOnly 指定注解是否只读。
	ReadOnly bool
	// ReadOnlyValue 用于显式写出 ReadOnly=false。为空时沿用 ReadOnly 的兼容行为。
	ReadOnlyValue *bool
	// Remark 是注解备注。
	Remark string
	// Parameters 是注解自定义参数。
	Parameters []AnnotationParameter
	// Boundary 是注解边界，单位为毫米。
	Boundary *Box
	// Items 是注解外观中的页面对象。
	Items []Item
}

type AnnotationPage struct {
	// Page 是从 0 开始的注解所属页面索引。
	Page int
	// Items 是该页面的注解列表。
	Items []Annotation
}

type AnnotationParameter struct {
	// Name 是注解参数名称。
	Name string
	// Value 是注解参数值。
	Value string
}

type Attachment struct {
	// ID 是附件标识。
	ID string
	// Name 是附件显示名称。
	Name string
	// Format 是附件格式或媒体类型。
	Format string
	// CreationDate 是附件创建时间。
	CreationDate time.Time
	// ModDate 是附件最后修改时间。
	ModDate time.Time
	// Visible 指定附件是否在阅读器中可见；为空时使用默认值。
	Visible *bool
	// Usage 描述附件用途。
	Usage string
	// Data 是附件的二进制数据。
	Data []byte
	// Source 是附件的惰性数据来源，优先于 Data。
	Source DataSource
	// FileName 是附件在 OFD 包内使用的文件名。
	FileName string
}

type AxialShading struct {
	// MapType 是渐变映射类型。
	MapType string
	// MapUnit 是渐变映射单位。
	MapUnit float64
	// Extend 指定渐变端点外的延展方式。
	Extend int
	// StartPoint 是渐变起点坐标。
	StartPoint string
	// EndPoint 是渐变终点坐标。
	EndPoint string
	// Segments 是按位置排列的颜色分段。
	Segments []ColorStop
}

type Bookmark struct {
	// Name 是书签名称。
	Name string
	// Goto 是书签指向的页面目标。
	Goto GotoAction
}

type Box struct {
	// X 是区域左上角的横坐标，单位为毫米。
	X float64
	// Y 是区域左上角的纵坐标，单位为毫米。
	Y float64
	// Width 是区域宽度，单位为毫米。
	Width float64
	// Height 是区域高度，单位为毫米。
	Height float64
}

type CGTransform struct {
	// CodePosition 是相对于文字对象的起始字符位置，从 0 开始。
	CodePosition int
	// CodeCount 是参与映射的字符数量。
	CodeCount int
	// GlyphCount 是映射生成的字形数量。
	GlyphCount int
	// Glyphs 是字形索引列表。
	Glyphs []int
}

type CTM [6]float64

type CaptionStyle struct {
	// Font 是字体资源名称。
	Font string
	// Size 是字号，单位为毫米。
	Size float64
	// Weight 是字重。
	Weight int
	// Italic 指定是否斜体。
	Italic bool
	// Align 是对齐方式：left/center/right。
	Align string
	// Color 是文字颜色。
	Color *Color
	// Gap 是说明文字与它所标注对象之间的间距，单位毫米，取正数。
	// 说明文字处在对象哪一侧由所在图元决定：表格表题在上，图片说明在下。
	Gap float64
}

type Clip struct {
	// Areas 是裁剪区域中的路径或文字区域列表。
	Areas []ClipArea
}

type ClipArea struct {
	// DrawParam 是区域引用的绘制参数名称。
	DrawParam string
	// CTM 是区域的坐标变换矩阵。
	CTM *CTM
	// Path 是路径裁剪区域；与 Text 二选一。
	Path *ClipPath
	// Text 是文字裁剪区域；与 Path 二选一。
	Text *ClipText
}

type ClipPath struct {
	// Boundary 是路径边界，单位为毫米，且为必填项。
	Boundary Box
	// Name 是路径名称。
	Name string
	// Visible 指定路径是否可见；为空时使用默认值。
	Visible *bool
	// CTM 是路径的坐标变换矩阵。
	CTM *CTM
	// Data 是 OFD 缩略路径语法内容。
	Data string
	// Stroke 指定路径是否描边。
	Stroke bool
	// StrokeSet 指定是否显式设置 Stroke。
	StrokeSet *bool
	// Fill 指定路径是否填充。
	Fill bool
	// Rule 是路径填充规则。
	Rule string
	// LineWidth 是描边线宽，单位为毫米。
	LineWidth float64
	// Cap 是描边端点样式。
	Cap string
	// Join 是描边连接样式。
	Join string
	// MiterLimit 是斜接连接的长度限制。
	MiterLimit float64
	// DashOffset 是虚线起始偏移量，单位为毫米。
	DashOffset float64
	// DashPattern 是虚线长度与间隔组成的序列，单位为毫米。
	DashPattern []float64
	// Alpha 是路径整体透明度，取值范围为 0 到 255。
	Alpha *uint8
	// StrokeColor 是路径描边颜色。
	StrokeColor *Color
	// FillColor 是路径填充颜色。
	FillColor *Color
}

type ClipText struct {
	// Boundary 是文字裁剪区域边界，单位为毫米。
	Boundary Box
	// CTM 是文字的坐标变换矩阵。
	CTM *CTM
	// Font 是字体资源名称；为空时使用 SimSun。
	Font string
	// Size 是字号，单位为毫米。
	Size float64
	// Value 是裁剪文字内容。
	Value string
	// TextCodes 是文字分段及其定位信息。
	TextCodes []TextCode
	// Stroke 指定文字是否描边。
	Stroke bool
	// Fill 指定文字是否填充；为空时使用默认值。
	Fill *bool
	// HScale 是文字水平方向的缩放比例。
	HScale float64
	// ReadDirection 是文字阅读方向。
	ReadDirection int
	// CharDirection 是字符排列方向。
	CharDirection int
	// Weight 是文字字重。
	Weight int
	// Italic 指定文字是否使用斜体。
	Italic bool
	// FillColor 是文字填充颜色。
	FillColor *Color
	// StrokeColor 是文字描边颜色。
	StrokeColor *Color
}

type Clips struct {
	// Items 是裁剪区域定义列表。
	Items []Clip
	// TransFlag 指定裁剪区域是否应用图元自身的 CTM。缺省（nil）时按规范取
	// true，即裁剪路径坐标处于图元 CTM 之前坐标系；裁剪路径已经是图元局部
	// 毫米坐标时必须显式设为 false，否则阅读器会把 CTM 再叠加一次，把裁剪区
	// 放大 CTM 倍。OFD 规范与现有测试文档中的裁剪区都显式写 false。
	TransFlag *bool
}

type Color struct {
	// R 是 RGB 红色分量，取值范围为 0 到 255。
	R uint8
	// G 是 RGB 绿色分量，取值范围为 0 到 255。
	G uint8
	// B 是 RGB 蓝色分量，取值范围为 0 到 255。
	B uint8
	// Components 是当前颜色空间中的颜色分量。
	Components []int
	// ColorSpace 是引用的颜色空间资源 ID。
	ColorSpace uint64
	// Index 是颜色空间调色板索引；为空时使用 Components。
	Index *int
	// Alpha 是颜色透明度，取值范围为 0 到 255。
	Alpha *uint8
	// Axial 是轴向渐变配置。
	Axial *AxialShading
	// Radial 是径向渐变配置。
	Radial *RadialShading
	// Gouraud 是三角网格渐变配置。
	Gouraud *GouraudShading
	// LaGouraud 是四边形网格渐变配置。
	LaGouraud *LaGouraudShading
	// Pattern 是平铺图案填充配置。
	Pattern *Pattern
}

type ColorSpace struct {
	// ID 是颜色空间资源标识。
	ID uint64
	// Type 是颜色空间类型。
	Type string
	// BitsPerComponent 是每个颜色分量的位数。
	BitsPerComponent int
	// Profile 是颜色配置文件名称或标识。
	Profile string
	// ProfileData 是颜色配置文件的二进制数据。
	ProfileData []byte
	// Palette 是调色板颜色列表。
	Palette []string
}

type ColorStop struct {
	// Position 是渐变位置，通常取值范围为 0 到 1。PositionSet 为假时表示省略。
	Position float64
	// PositionSet 表示 Position 是否显式给出。省略时不写出 XML 属性。
	PositionSet bool
	// Color 是该位置对应的颜色。
	Color Color
}

type Composite struct {
	// X 是复合图元左上角的横坐标，单位为毫米。
	X float64
	// Y 是复合图元左上角的纵坐标，单位为毫米。
	Y float64
	// Width 是复合图元宽度，单位为毫米。
	Width float64
	// Height 是复合图元高度，单位为毫米。
	Height float64
	// ResourceID 是引用的复合图元资源 ID。
	ResourceID uint64
	// Name 是复合图元名称。
	Name string
	// Visible 指定复合图元是否可见；为空时使用默认值。
	Visible *bool
	// DrawParam 是复合图元引用的绘制参数名称。
	DrawParam string
	// Actions 是复合图元对象的动作。
	Actions []Action
	// CTM 是复合图元的坐标变换矩阵。
	CTM *CTM
	// Clips 是复合图元使用的裁剪区域。
	Clips *Clips
}

type CompositeGraphicUnit struct {
	// ID 是复合图元资源标识，且必须在文档资源中唯一。
	ID uint64
	// Width 是复合图元宽度，单位为毫米。
	Width float64
	// Height 是复合图元高度，单位为毫米。
	Height float64
	// Thumbnail 是复合图元缩略图资源 ID。
	Thumbnail uint64
	// Substitution 是替代复合图元资源 ID。
	Substitution uint64
	// Items 是复合图元内部对象，顺序即绘制顺序。
	Items []Item
}

type CompressionMode string

type CreateOptions struct {
	Compression CompressionMode
	// CompressionLevel 是 DEFLATE 压缩级别，0 使用默认级别 5，显式范围
	// 1（最快）到 9（最紧凑）。仅对实际使用 Deflate 的条目生效，
	// CompressionStore 或自动选择 Store 的条目不受影响。
	CompressionLevel      int
	Deterministic         bool
	PreserveEmbeddedFonts bool
	// CompleteTextCodeDeltas 按字体度量自动补全缺失的 DeltaX 和 DeltaY。
	CompleteTextCodeDeltas bool
	// DocType 是 OFD.xml 根节点 DocType 属性的取值，留空时使用基础 profile
	// spec.DocTypeOFD。除基础 profile 外，GB/T 42133—2022（档案长期保存，
	// "OFD-A"）与 GB/T 48666-2026（电子病历，"OFD-H"）分别收紧了 DocType
	// 取值，生成对应文件时须显式设置。
	DocType string
}

type CustomData struct {
	// Name 是自定义元数据名称。
	Name string
	// Value 是自定义元数据值。
	Value string
}

type CustomTag struct {
	// NameSpace 是自定义标签的命名空间。
	NameSpace string
	// Schema 是标签模式文件的二进制数据。
	Schema []byte
	// SchemaName 是模式文件在包内的文件名。
	SchemaName string
	// Data 是自定义标签数据文件的二进制数据。
	Data []byte
	// DataName 是数据文件在包内的文件名。
	DataName string
}

type DataSource interface {
	// Open 返回从头读取资源的 ReadCloser，调用方负责关闭。
	Open() (io.ReadCloser, error)
	// Size 返回资源字节数；未知时返回负数。
	Size() int64
}

type Document struct {
	// ID 是文档标识。
	ID string
	// Title 是文档标题。
	Title string
	// Author 是文档作者。
	Author string
	// Subject 是文档主题。
	Subject string
	// Abstract 是文档摘要。
	Abstract string
	// DocUsage 描述文档用途。
	DocUsage string
	// Cover 是封面图像在包内的文件名或引用名。
	Cover string
	// CoverData 是封面图像的二进制数据。
	CoverData []byte
	// CoverSource 是封面图像的惰性数据来源，优先于 CoverData。
	CoverSource DataSource
	// CoverName 是封面图像写入包时使用的文件名。
	CoverName string
	// Keywords 是文档关键字列表。
	Keywords []string
	// CustomDatas 是文档自定义元数据。
	CustomDatas []CustomData
	// Creator 是创建文档的软件名称。
	Creator string
	// CreatorVersion 是创建软件的版本。
	CreatorVersion string
	// CreationDate 是文档创建时间。
	CreationDate time.Time
	// ModDate 是文档最后修改时间。
	ModDate time.Time
	// PageSize 是文档默认页面尺寸，单位为毫米。
	PageSize PageSize
	// Area 是文档默认页面区域设置。
	Area *PageArea
	// DrawParams 是文档级绘制参数资源。
	DrawParams []DrawParam
	// Fonts 是文档字体资源。
	Fonts []Font
	// ColorSpaces 是文档颜色空间资源。
	ColorSpaces []ColorSpace
	// DefaultCS 是默认颜色空间的资源 ID。
	DefaultCS uint64
	// PublicRes 是文档公共资源文件。
	PublicRes []PublicResource
	// Media 是文档级多媒体资源。
	Media []Media
	// Composites 是文档级复合图元资源。
	Composites []CompositeGraphicUnit
	// Pages 是文档页面，切片索引即页面索引。
	Pages []Page
	// Templates 是文档模板页资源。
	Templates []TemplatePage
	// Actions 是文档级动作。
	Actions []Action
	// Outlines 是文档大纲。
	Outlines []Outline
	// Permissions 是文档权限设置。
	Permissions *Permissions
	// Preferences 是阅读器显示偏好设置。
	Preferences *ViewPreferences
	// Bookmarks 是文档书签。
	Bookmarks []Bookmark
	// Annotations 是按页面组织的注解集合。
	Annotations []AnnotationPage
	// Attachments 是文档附件。
	Attachments []Attachment
	// CustomTags 是文档自定义标签资源。
	CustomTags []CustomTag
	// Extensions 是文档扩展信息。
	Extensions []Extension
	// Signatures 是文档签名清单。
	Signatures []Signature
	// Versions 是文档版本清单。
	Versions []DocumentVersion
}

type DocumentVersion struct {
	// ID 是文档版本标识。
	ID string
	// Index 是版本在版本清单中的索引。
	Index int
	// Current 指定该版本是否为当前版本。
	Current bool
	// Version 是该版本适用的 OFD 格式版本，如 "1.0"。
	Version string
	// Name 是版本显示名称。
	Name string
	// CreationDate 是版本创建时间。
	CreationDate time.Time
	// Files 是该版本包含的文件清单。
	Files []VersionFile
	// DocRoot 是版本文档根文件的二进制数据。
	DocRoot []byte
	// DocRootName 是文档根文件在包内的文件名。
	DocRootName string
}

type DrawParam struct {
	// Name 是绘制参数资源名称。
	Name string
	// Relative 是继承来源绘制参数的 Name。
	Relative string
	// LineWidth 是线宽，单位为毫米。
	LineWidth float64
	// Join 是路径连接处的连接样式。
	Join string
	// Cap 是路径端点的端点样式。
	Cap string
	// DashOffset 是虚线起始偏移量，单位为毫米。
	DashOffset float64
	// DashPattern 是虚线长度与间隔组成的序列，单位为毫米。
	DashPattern []float64
	// MiterLimit 是斜接连接的长度限制。
	MiterLimit float64
	// FillColor 是填充颜色。
	FillColor *Color
	// StrokeColor 是描边颜色。
	StrokeColor *Color
}

type Extension struct {
	// AppName 是扩展应用名称。
	AppName string
	// Company 是扩展提供方名称。
	Company string
	// AppVersion 是扩展应用版本。
	AppVersion string
	// Date 是扩展信息的日期。
	Date time.Time
	// RefID 是扩展引用的资源或对象标识。
	RefID uint64
	// Properties 是扩展的键值属性。
	Properties []ExtensionProperty
	// Data 是扩展数据的文本内容。
	Data string
	// DataXML 是 Data 元素中的原始 XML 内容。设置后会作为子元素写入，
	// 与 Data 互斥；Data 适合只需要文本内容的扩展。
	DataXML []byte
	// DataFile 是扩展外部数据文件的二进制内容。
	DataFile []byte
	// DataFileSource 是扩展外部数据文件的惰性数据来源，优先于 DataFile。
	DataFileSource DataSource
	// DataName 是外部数据文件在包内的文件名。
	DataName string
}

type ExtensionProperty struct {
	// Name 是扩展属性名称。
	Name string
	// Type 是扩展属性类型。
	Type string
	// Value 是扩展属性值。
	Value string
}

type Figure struct {
	// X、Y 是图块左上角坐标，单位毫米。
	X float64
	Y float64
	// Width 是图块宽度，也是图片与说明文字对齐的参照框，单位毫米。
	// 为 0 时图块宽度等于图片实际宽度，居中与居右都退化为无操作。
	Width float64
	// Align 是图片与说明文字共用的水平对齐：left / center / right。
	Align string

	// Image 承载图片数据与外观（边框、透明度、裁剪等）。其中的 X、Y、Width、
	// Height 由 Figure 统一决定，展开时会被覆盖。
	Image Image
	// ImageWidth 是图片宽度，单位毫米；为 0 表示不指定。
	// ImageFillWidth 为真时 ImageWidth 按图块宽度的比例解释（0.5 即一半）。
	ImageWidth float64
	// ImageFillWidth 为真时 ImageWidth 按图块宽度的比例解释。
	ImageFillWidth bool
	// ImageHeight 是图片高度，单位毫米；为 0 时按图片原始比例推出。
	ImageHeight float64
	// Fit 是图片在给定尺寸内的适配方式：
	// "contain"（默认）保持原始比例，两个尺寸都给时按小的比例缩放；
	// "stretch" 拉伸填满，此时两个尺寸都必须给。
	Fit string

	// Caption 是图片下方的说明文字，如 "图 3 营收走势"。留空不画说明。
	Caption string
	// CaptionStyle 是说明文字样式；Gap 指定说明与图片底边的间距，
	// 为 0 时用 defaultCaptionGap。
	CaptionStyle *CaptionStyle
}

type Font struct {
	// Name 是字体资源名称，必须与文字对象的 Font 值一致。
	Name string
	// FamilyName 是字体族名称。
	FamilyName string
	// Charset 是字体字符集标识。
	Charset string
	// Italic 指定字体是否为斜体。
	Italic bool
	// Bold 指定字体是否为粗体。
	Bold bool
	// Serif 指定字体是否为衬线字体。
	Serif bool
	// FixedWidth 指定字体是否为等宽字体。
	FixedWidth bool
	// Format 是字体数据格式。
	Format string
	// Data 是嵌入字体的二进制数据。
	Data []byte
	// Source 是嵌入字体的惰性数据来源，优先于 Data。
	// 默认的子集化需要完整字体字节，会在子集化时逐字体读取并物化来源。
	Source DataSource
}

type GotoAAction struct {
	// AttachID 是目标附件标识。
	AttachID string
	// NewWindow 指定是否在新窗口打开附件；为空时使用默认值。
	NewWindow *bool
}

type GotoAction struct {
	// Page 是从 0 开始的目标页面索引。
	Page int
	// Bookmark 是目标书签名称。
	Bookmark string
	// Type 是页面适配方式；为空时使用 Fit。
	Type string
	// Left 是目标视图左边界，单位为毫米。
	Left *float64
	// Top 是目标视图上边界，单位为毫米。
	Top *float64
	// Right 是目标视图右边界，单位为毫米。
	Right *float64
	// Bottom 是目标视图下边界，单位为毫米。
	Bottom *float64
	// Zoom 是目标视图缩放比例。
	Zoom *float64
}

type GouraudPoint struct {
	// X 是控制点横坐标，单位为毫米。
	X float64
	// Y 是控制点纵坐标，单位为毫米。
	Y float64
	// EdgeFlag 是控制点所在网格的方向标志，决定本点如何与前一个三角形衔接。
	// 设前一个三角形为 (V0,V1,V2)，取值含义见 GB/T 33190 图 40：
	//
	//	0：本点与随后两点另起一个三角形，与前一个三角形无共享边。
	//	1：本点复用 V1-V2 边，两个三角形拼成四边形。
	//	2：本点复用 V0-V2 边，两个三角形拼成四边形。
	//
	// 缺省为 0。只有 1、2 会产生共享边从而拼成连续网格。规范未定义 3，
	// 部分阅读器按 PDF 语义复用 V0-V1 边做兼容处理。
	EdgeFlag int
	// Color 是控制点颜色。
	Color Color
}

type GouraudShading struct {
	// Extend 指定网格边界外的延展方式。
	Extend int
	// Points 是三角网格控制点列表。
	Points []GouraudPoint
	// BackColor 是网格背景颜色。
	BackColor *Color
}

type Image struct {
	// X 是图片对象左上角的横坐标，单位为毫米。
	X float64
	// Y 是图片对象左上角的纵坐标，单位为毫米。
	Y float64
	// Width 是图片对象宽度，单位为毫米。
	Width float64
	// Height 是图片对象高度，单位为毫米。
	Height float64
	// Data 是图片的二进制数据。
	Data []byte
	// Source 是图片的惰性数据来源，优先于 Data。
	Source DataSource
	// ResourceID 是引用的图片资源 ID。
	ResourceID uint64
	// Substitution 是替代图片资源 ID。
	Substitution uint64
	// ImageMask 是图片蒙版资源 ID。
	ImageMask uint64
	// Format 是图片格式，如 PNG 或 JPEG。
	Format string
	// Name 是图片名称。
	Name string
	// Visible 指定图片是否可见；为空时使用默认值。
	Visible *bool
	// LineWidth 是图片边框线宽，单位为毫米。
	LineWidth float64
	// Cap 是图片边框端点样式。
	Cap string
	// Join 是图片边框连接样式。
	Join string
	// MiterLimit 是图片边框斜接连接的长度限制。
	MiterLimit float64
	// DashOffset 是图片边框虚线起始偏移量，单位为毫米。
	DashOffset float64
	// DashPattern 是图片边框虚线长度与间隔序列，单位为毫米。
	DashPattern []float64
	// Alpha 是图片整体透明度，取值范围为 0 到 255。
	Alpha *uint8
	// DrawParam 是图片引用的绘制参数名称。
	DrawParam string
	// Actions 是图片对象的动作。
	Actions []Action
	// CTM 是图片对象的坐标变换矩阵。
	CTM *CTM
	// Clips 是图片对象使用的裁剪区域。
	Clips *Clips
	// Border 是图片边框样式。
	Border *ImageBorder
}

type ImageBorder struct {
	// LineWidth 是边框线宽，单位为毫米。
	LineWidth float64
	// HorizontalRadius 是水平圆角半径，单位为毫米。
	HorizontalRadius float64
	// VerticalRadius 是垂直圆角半径，单位为毫米。
	VerticalRadius float64
	// DashOffset 是虚线起始偏移量，单位为毫米。
	DashOffset float64
	// DashPattern 是虚线长度与间隔组成的序列，单位为毫米。
	DashPattern []float64
	// Color 是边框颜色。
	Color *Color
}

type Item interface {
	// contains filtered or unexported methods
}

type LaGouraudPoint struct {
	// X 是控制点横坐标，单位为毫米。
	X float64
	// Y 是控制点纵坐标，单位为毫米。
	Y float64
	// Color 是控制点颜色。
	Color Color
}

type LaGouraudShading struct {
	// VerticesPerRow 是每行顶点数量。
	VerticesPerRow int
	// Extend 指定网格边界外的延展方式。
	Extend int
	// Points 是四边形网格控制点列表。
	Points []LaGouraudPoint
	// BackColor 是网格背景颜色。
	BackColor *Color
}

type Layer struct {
	// Type 是图层类型。
	Type string
	// DrawParam 是图层引用的绘制参数名称。
	DrawParam string
	// Items 是图层中的页面对象，顺序即绘制顺序。
	Items []Item
}

type LimitWriter struct {
	// contains filtered or unexported fields
}

type Limits struct {
	// MaxEntries 是允许搬运的最大条目数，0 表示默认 10000。
	MaxEntries int
	// MaxEntryBytes 是单个条目解压后的最大字节数，0 表示默认 64MB。
	MaxEntryBytes int64
	// MaxTotalBytes 是所有条目解压后的总字节上限，0 表示默认 512MB。
	MaxTotalBytes int64
}

type Media struct {
	// ID 是多媒体资源标识。
	ID uint64
	// Type 是媒体类型，如图片、音频或视频。
	Type string
	// Format 是媒体编码格式。
	Format string
	// Data 是媒体的二进制数据。
	Data []byte
	// Source 是媒体的惰性数据来源，优先于 Data。
	Source DataSource
	// Name 是媒体文件在包内的文件名。
	Name string
}

type MovieAction struct {
	// ResourceID 是影片资源 ID。
	ResourceID uint64
	// Operator 是影片控制操作。
	Operator string
}

type Outline struct {
	// Title 是大纲项标题。
	Title string
	// Count 是子项数量或展开状态相关的计数值。
	Count *int
	// Expanded 指定大纲项是否展开；为空时使用默认值。
	Expanded *bool
	// Actions 是大纲项的跳转动作。
	Actions []Action
	// Children 是嵌套的大纲项。
	Children []Outline
}

type Page struct {
	// Area 是页面区域设置。
	Area *PageArea
	// Resources 是页面专属资源文件。
	Resources []PageResource
	// Templates 是页面引用的模板页。
	Templates []TemplateRef
	// LayerType 是页面默认图层类型。
	LayerType string
	// Items 是按绘制顺序排列的页面对象。
	Items []Item
	// Layers 是页面图层，切片顺序即绘制顺序。
	Layers []Layer
	// Actions 是页面动作。
	Actions []Action
}

type PageArea struct {
	// PhysicalBox 是页面物理边界；为空时使用文档页面尺寸。
	PhysicalBox *Box
	// ApplicationBox 是应用程序可用的页面区域。
	ApplicationBox *Box
	// ContentBox 是页面内容的布局区域。
	ContentBox *Box
	// BleedBox 是包含出血范围的页面区域。
	BleedBox *Box
}

type PageBlock struct {
	// Items 是容器中的页面对象，顺序即绘制顺序。
	Items []Item
}

type PageImage struct {
	// ID 是图片资源标识，且必须在文档内唯一。
	ID uint64
	// Format 是图片格式，如 PNG 或 JPEG。
	Format string
	// Data 是图片的二进制数据。
	Data []byte
	// Source 是图片的惰性数据来源，优先于 Data。
	Source DataSource
	// Name 是图片在包内的文件名。
	Name string
}

type PageProvider interface {
	// PageCount 返回文档页面总数。
	PageCount() int
	// PageAt 返回从 0 开始的第 index 页。
	PageAt(index int) (Page, error)
}

type PageResource struct {
	// Images 是页面图片资源的快捷配置。
	Images []PageImage
	// Data 是完整的 OFD Res XML。用于页面专属的颜色空间、字体、绘制参数、
	// 多媒体或复合图元等资源；设置后不能同时设置 Images。
	Data []byte
	// Files 是 Data 中引用的、相对于 PageRes XML 所在目录的二进制文件。
	Files []PageResourceFile
}

type PageResourceFile struct {
	// Path 是相对于页面资源 XML 所在目录的文件路径。
	Path string
	// Data 是文件的二进制数据。
	Data []byte
	// Source 是文件的惰性数据来源，优先于 Data。
	Source DataSource
}

type PageSize struct {
	// Width 是页面宽度，单位为毫米。
	Width float64
	// Height 是页面高度，单位为毫米。
	Height float64
}

type Path struct {
	// X 是路径对象左上角的横坐标，单位为毫米。
	X float64
	// Y 是路径对象左上角的纵坐标，单位为毫米。
	Y float64
	// Width 是路径对象宽度，单位为毫米。
	Width float64
	// Height 是路径对象高度，单位为毫米。
	Height float64
	// Data 是 OFD 缩略路径语法内容。
	Data string
	// Stroke 指定路径是否描边。
	Stroke bool
	// StrokeSet 指定是否显式设置 Stroke。
	StrokeSet *bool
	// Fill 指定路径是否填充。
	Fill bool
	// Rule 是路径填充规则。
	Rule string
	// Name 是路径名称。
	Name string
	// Visible 指定路径是否可见；为空时使用默认值。
	Visible *bool
	// LineWidth 是描边线宽，单位为毫米。
	LineWidth float64
	// Cap 是描边端点样式。
	Cap string
	// Join 是描边连接样式。
	Join string
	// MiterLimit 是斜接连接的长度限制。
	MiterLimit float64
	// DashOffset 是虚线起始偏移量，单位为毫米。
	DashOffset float64
	// DashPattern 是虚线长度与间隔组成的序列，单位为毫米。
	DashPattern []float64
	// Alpha 是路径整体透明度，取值范围为 0 到 255。
	Alpha *uint8
	// DrawParam 是路径引用的绘制参数名称。
	DrawParam string
	// Actions 是路径对象的动作。
	Actions []Action
	// CTM 是路径对象的坐标变换矩阵。
	CTM *CTM
	// Clips 是路径对象使用的裁剪区域。
	Clips *Clips
	// StrokeColor 是路径描边颜色。
	StrokeColor *Color
	// FillColor 是路径填充颜色。
	FillColor *Color
}

type Pattern struct {
	// Width 是图案单元宽度，单位为毫米。
	Width float64
	// Height 是图案单元高度，单位为毫米。
	Height float64
	// XStep 是图案水平方向重复步长，单位为毫米。
	XStep float64
	// YStep 是图案垂直方向重复步长，单位为毫米。
	YStep float64
	// ReflectMethod 是图案重复时的镜像方式。
	ReflectMethod string
	// RelativeTo 是图案坐标相对于页面或对象的参考系。
	RelativeTo string
	// CTM 是图案单元的坐标变换矩阵。
	CTM *CTM
	// Thumbnail 是图案缩略图资源 ID。
	Thumbnail uint64
	// Items 是图案单元中的页面对象。
	Items []Item
	// Layers 是图案单元中的图层。
	Layers []Layer
	// contains filtered or unexported fields
}

type Permissions struct {
	// Edit 指定是否允许编辑文档内容。
	Edit *bool
	// Annot 指定是否允许添加或修改注解。
	Annot *bool
	// Export 指定是否允许导出文档内容。
	Export *bool
	// Signature 指定是否允许签名。
	Signature *bool
	// Watermark 指定是否允许添加或修改水印。
	Watermark *bool
	// PrintScreen 指定是否允许屏幕截图。
	PrintScreen *bool
	// Print 是打印权限及打印份数设置。
	Print *PrintSettings
	// ValidPeriod 是权限生效和失效时间范围。
	ValidPeriod *ValidPeriod
}

type Point struct {
	// X 是点的横坐标，单位为毫米。
	X float64
	// Y 是点的纵坐标，单位为毫米。
	Y float64
}

type PrintSettings struct {
	// Printable 指定是否允许打印。
	Printable bool
	// Copies 是允许打印的份数；为空时不限定份数。
	Copies *int
}

type PublicResource struct {
	// Name 是相对于 Doc_0 的公共资源 XML 文件名。
	Name string
	// Data 是 Res 根元素的 XML 内容。
	Data []byte
	// Files 是资源 XML 引用的包内文件。
	Files []PublicResourceFile
}

type PublicResourceFile struct {
	// Path 是相对于公共资源 XML 所在目录的文件路径。
	Path string
	// Data 是文件的二进制数据。
	Data []byte
	// Source 是文件的惰性数据来源，优先于 Data。
	Source DataSource
}

type RadialShading struct {
	// MapType 是渐变映射类型。
	MapType string
	// MapUnit 是渐变映射单位。
	MapUnit float64
	// Eccentricity 是径向渐变椭圆离心率。
	Eccentricity float64
	// Angle 是径向渐变旋转角度。
	Angle float64
	// StartPoint 是渐变起点坐标。
	StartPoint string
	// StartRadius 是渐变起始半径。
	StartRadius float64
	// EndPoint 是渐变终点坐标。
	EndPoint string
	// EndRadius 是渐变结束半径。
	EndRadius float64
	// Extend 指定渐变端点外的延展方式。
	Extend int
	// Segments 是按位置排列的颜色分段。
	Segments []ColorStop
}

type RegionArc struct {
	// SweepDirection 指定圆弧的扫描方向。
	SweepDirection bool
	// LargeArc 指定是否选择大于半圆的弧段。
	LargeArc bool
	// RotationAngle 是椭圆旋转角度。
	RotationAngle float64
	// EllipseSize 是椭圆的半轴尺寸，单位为毫米。
	EllipseSize Point
	// EndPoint 是圆弧终点，单位为毫米。
	EndPoint Point
}

type RegionClose struct{}

type RegionCommand interface {
	// contains filtered or unexported methods
}

type RegionCubicBezier struct {
	// Control1 是三次贝塞尔曲线的第一个控制点，单位为毫米。
	Control1 Point
	// Control2 是三次贝塞尔曲线的第二个控制点，单位为毫米。
	Control2 Point
	// End 是三次贝塞尔曲线的终点，单位为毫米。
	End Point
}

type RegionLine struct {
	// Point 是连接到的目标点，单位为毫米。
	Point Point
}

type RegionMove struct {
	// Point 是移动到的目标点，单位为毫米。
	Point Point
}

type RegionQuadraticBezier struct {
	// Control 是二次贝塞尔曲线的控制点，单位为毫米。
	Control Point
	// End 是二次贝塞尔曲线的终点，单位为毫米。
	End Point
}

type Signature struct {
	// ID 是签名标识。
	ID string
	// Type 是签名类型。
	Type string
	// ProviderName 是签名提供方名称。
	ProviderName string
	// ProviderVersion 是签名提供方版本。
	ProviderVersion string
	// Company 是签名方名称。
	Company string
	// Method 是签名方法标识。
	Method string
	// Date 是签名生成时间。
	Date time.Time
	// CheckMethod 是签名引用的摘要算法。
	CheckMethod string
	// References 是签名覆盖的文件摘要引用。
	References []SignatureReference
	// StampAnnots 是与签名关联的印章注解。
	StampAnnots []SignatureStamp
	// SealFile 是印章文件的二进制数据。
	SealFile []byte
	// SealSource 是印章文件的惰性数据来源，优先于 SealFile。
	SealSource DataSource
	// SealName 是印章文件在包内的文件名。
	SealName string
	// SignedValue 是签名值文件的二进制数据。
	SignedValue []byte
	// SignedValueSource 是签名值文件的惰性数据来源，优先于 SignedValue。
	SignedValueSource DataSource
	// SignedValueName 是签名值文件在包内的文件名。
	SignedValueName string
}

type SignatureMode string

type SignatureReference struct {
	// FileRef 是相对于签名 XML 文件的被签名文件路径。
	FileRef string
	// CheckValue 是被引用文件的摘要值。
	CheckValue []byte
}

type SignatureStamp struct {
	// ID 是印章标识。
	ID string
	// Page 是从 0 开始的盖章页面索引。
	Page int
	// Boundary 是印章在页面上的边界，单位为毫米。
	Boundary Box
	// Clip 是印章内容的裁剪区域，单位为毫米。
	Clip *Box
}

type SoundAction struct {
	// ResourceID 是声音资源 ID。
	ResourceID uint64
	// Volume 是播放音量，通常为百分比整数。
	Volume *int
	// Repeat 指定是否循环播放；为空时使用默认值。
	Repeat *bool
	// Synchronous 指定是否同步播放；为空时使用默认值。
	Synchronous *bool
}

type Table struct {
	// X 是表格左上角的横坐标，单位为毫米。
	X float64
	// Y 是表格左上角的纵坐标，单位为毫米。
	Y float64
	// Width 是表格总宽度，单位为毫米。
	Width float64
	// Rows 是表格的行，每行包含若干单元格。
	Rows []TableRow
	// ColumnWidths 是各列宽度（毫米），为空时均分 Width。
	ColumnWidths []float64
	// Style 是表格整体样式。
	Style TableStyle
	// HeaderRows 是表头行数，跨页时重复显示。
	HeaderRows int
	// Visible 指定表格是否可见。
	Visible *bool
	// DrawParam 是表格引用的绘制参数名称。
	DrawParam string
	// Caption 是表题文字，如 "表 13 文件属性"。
	Caption string
	// CaptionStyle 是表题样式。
	CaptionStyle *CaptionStyle
	// ContinuationCaption 是续表题文字，支持 {caption} 占位符。
	ContinuationCaption string
	// ContinuationCaptionStyle 是续表题样式。
	ContinuationCaptionStyle *CaptionStyle
}

type TableCell struct {
	// Value 是单元格文本内容。
	Value string
	// Font 是字体资源名称。
	Font string
	// Size 是字号，单位为毫米。
	Size float64
	// Weight 是字重。
	Weight int
	// Italic 指定是否斜体。
	Italic bool
	// Align 是文本对齐方式：left/center/right。
	Align string
	// ColSpan 是横向合并的列数。
	ColSpan int
	// RowSpan 是纵向合并的行数。
	RowSpan int
	// FirstLineIndent 是首行缩进，单位为毫米。
	FirstLineIndent float64
	// HangingIndent 是续行（第 2 行起）缩进，单位为毫米。
	HangingIndent float64
	// Format 指定单元格文本格式："text"（默认，纯文本）或 "markdown"。
	// markdown 解析行内语法（**粗体**、*斜体*、`代码`、~~删除线~~）与列表
	// （- 无序、1. 有序，按层级缩进）；源码里的换行一律断行，不按 Markdown
	// 正文的软换行约定折成空格。
	Format string
	// FillColor 是单元格背景色。
	FillColor *Color
	// Runs 是单元格内带样式的文字片段。非空时按片段逐段渲染，Value 与 Format
	// 都被忽略；两者与 Runs 同时设置会被校验拒绝，避免「设了却不生效」的静默分歧。
	//
	// 用途是把已经解析好的行内结构原样传进来，不必先拼成 markdown 源码再让创建器
	// 重新解析一遍——往返会出问题：正文里的 `*` `_` `[` 是普通字符，重新拼串再解析
	// 就会变成斜体或坏掉链接。
	Runs []TextRun
	// Actions 是单元格的点击动作，作用范围是整个单元格。
	//
	// 表格文字在落笔时按样式拆成多个文字对象，单元格级的动作会挂到其中每一个
	// 上：热区因此覆盖整格，与 PDF 表格里链接注解盖住单元格的做法一致。要让
	// 单元格里的某几段文字各自可点，得把动作写在那些文字对象上。
	Actions []Action
}

type TableRow struct {
	// Cells 是该行的单元格列表。
	Cells []TableCell
	// Height 是行高（毫米），为 0 时根据内容自动计算。
	Height float64
}

type TableStyle struct {
	// HorizontalLines 控制是否绘制横线。
	HorizontalLines bool
	// VerticalLines 控制是否绘制竖线。
	VerticalLines bool
	// LineWidth 是内部线宽，单位为毫米。
	LineWidth float64
	// StrokeColor 是边框颜色。
	StrokeColor *Color
	// OuterLineWidth 是外框线宽，为 0 时使用 LineWidth。
	OuterLineWidth float64
	// HeaderLineWidth 是表头下方分隔线宽，为 0 时使用 LineWidth。
	HeaderLineWidth float64
	// OuterStrokeColor 是外框颜色，为空时使用 StrokeColor。
	OuterStrokeColor *Color
	// HeaderStrokeColor 是表头分隔线颜色，为空时使用 StrokeColor。
	HeaderStrokeColor *Color
	// HeaderFillColor 是表头背景色。
	HeaderFillColor *Color
	// HeaderFont 是表头字体资源名称。
	HeaderFont string
	// HeaderSize 是表头字号。
	HeaderSize float64
	// HeaderWeight 是表头字重。
	HeaderWeight int
	// StrikeColor 是 Markdown 删除线（~~删除~~）的颜色；为空时与表格边框同色。
	StrikeColor *Color
	// LinkColor 是 Markdown 行内链接（[文字](网址)）的文字颜色；为空时用默认链接蓝。
	LinkColor *Color
	// RuleColor 是 Markdown 分隔线（---）的颜色；为空时与表格边框同色。
	RuleColor *Color
	// CodeFont 是 Markdown 行内代码（`code`）使用的字体资源名称，
	// 为空时沿用单元格字体。
	CodeFont string
}

type TemplatePage struct {
	// ID 是模板页标识，且必须在文档内唯一。
	ID uint64
	// Name 是模板页名称。
	Name string
	// ZOrder 是模板页相对于页面内容的绘制顺序。
	ZOrder string
	// Area 是模板页区域设置。
	Area *PageArea
	// Items 是模板页中的页面对象。
	Items []Item
	// Layers 是模板页中的图层。
	Layers []Layer
}

type TemplateRef struct {
	// ID 是被引用模板页的标识。
	ID uint64
	// ZOrder 是模板页相对于页面内容的绘制顺序。
	ZOrder string
}

type Text struct {
	// X 是文字对象左上角的横坐标，单位为毫米。
	X float64
	// Y 是文字对象左上角的纵坐标，单位为毫米。
	Y float64
	// Width 是文字对象宽度，单位为毫米。
	Width float64
	// Height 是文字对象高度，单位为毫米。
	Height float64
	// Value 是文字内容。
	Value string
	// Font 是字体资源名称。
	Font string
	// Size 是字号，单位为毫米。
	Size float64
	// Visible 指定文字对象是否可见；为空时使用默认值。
	Visible *bool
	// Stroke 指定文字是否描边。
	Stroke bool
	// Fill 指定文字是否填充；为空时使用默认值。
	Fill *bool
	// HScale 是文字水平方向的缩放比例。
	HScale float64
	// ReadDirection 是文字阅读方向。
	ReadDirection int
	// CharDirection 是字符排列方向。
	CharDirection int
	// Weight 是文字字重。
	Weight int
	// Italic 指定文字是否使用斜体。
	Italic bool
	// DrawParam 是文字对象引用的绘制参数名称。
	DrawParam string
	// CTM 是文字对象的坐标变换矩阵。
	CTM *CTM
	// TextCodes 是文字分段及其定位信息。
	TextCodes []TextCode
	// CGTransforms 是字符到字形的映射关系。
	CGTransforms []CGTransform
	// Actions 是文字对象的动作。
	Actions []Action
	// Clips 是文字对象使用的裁剪区域。
	Clips *Clips
	// FillColor 是文字填充颜色。
	FillColor *Color
	// StrokeColor 是文字描边颜色。
	StrokeColor *Color
}

type TextCode struct {
	// Value 是该文字分段的内容，可为纯空白字符串，但不能是空字符串。
	Value string
	// X 是分段起始横坐标，单位为毫米；为空时沿用排版位置。
	X *float64
	// Y 是分段起始纵坐标，单位为毫米；为空时沿用排版位置。
	Y *float64
	// DeltaX 是各字符的横向位置增量，单位为毫米。
	DeltaX []float64
	// DeltaY 是各字符的纵向位置增量，单位为毫米。
	DeltaY []float64
}

type TextRun struct {
	// Text 是这一段的文字。
	Text string
	// Bold 为真时按粗体渲染。
	Bold bool
	// Italic 为真时按斜体渲染。
	Italic bool
	// Code 为真时用表格的 CodeFont 渲染。
	Code bool
	// Strike 为真时在文字中部画删除线。
	Strike bool
	// Href 是这一段的点击目标。非空时只有这一段可点，并按链接蓝着色；为空时沿用
	// 单元格的 Actions。
	Href string
}

type URIAction struct {
	// URI 是要访问的统一资源标识符。
	URI string
	// Base 是解析相对 URI 时使用的基础 URI。
	Base string
	// Target 是 URI 打开的目标窗口或框架。
	Target string
}

type ValidPeriod struct {
	// Start 是权限生效时间。
	Start time.Time
	// End 是权限失效时间。
	End time.Time
}

type VersionFile struct {
	// ID 是版本文件标识。
	ID string
	// Path 是相对于文档目录（Doc_0）的包内路径。
	Path string
}

type ViewPreferences struct {
	// PageMode 是文档打开时的页面导航模式。
	PageMode string
	// PageLayout 是文档打开时的页面布局模式。
	PageLayout string
	// TabDisplay 是阅读器标签页显示的标题来源。
	TabDisplay string
	// HideToolbar 指定是否隐藏工具栏；为空时使用默认值。
	HideToolbar *bool
	// HideMenubar 指定是否隐藏菜单栏；为空时使用默认值。
	HideMenubar *bool
	// HideWindowUI 指定是否隐藏窗口界面元素；为空时使用默认值。
	HideWindowUI *bool
	// ZoomMode 是文档打开时的缩放模式。
	ZoomMode string
	// Zoom 是自定义缩放比例。
	Zoom *float64
}