webreader

type AnnotationBoundary struct {
	X      float64
	Y      float64
	Width  float64
	Height float64
}

type AnnotationInfo struct {
	Scope int
	// Page 是注解所在页面的全局索引。
	Page int
	// ID 是注解标识。
	ID string
	// Type 是注解类型，如 Link、Highlight、Stamp。
	Type string
	// Subtype 是注解子类型，未声明时为空。
	Subtype string
	// Creator 是创建注解的软件或用户，未声明时为空。
	Creator string
	// LastModDate 是最后修改日期（YYYY-MM-DD），未声明时为空。
	LastModDate string
	// Visible 表示注解是否可见，未声明时为 true。
	Visible bool
	// Remark 是注解备注，未声明时为空。
	Remark string
	// Boundary 是注解外观边界，未声明时为 nil。
	Boundary *AnnotationBoundary
	// URI 是链接注解的外部链接目标，非空时点击打开链接。
	URI string
	// TargetPage 是链接注解的跳转目标页全局索引，-1 表示没有页面目标。
	TargetPage int
	// Dest 是链接注解跳转目标的位置与缩放，nil 表示没有位置信息。
	Dest *OutlineDest
}

type AttachmentInfo struct {
	// Scope 是附件所属文档体的索引。
	Scope int
	// ID 是附件 ID。
	ID string
	// Name 是附件名称。
	Name string
	// Format 是附件格式，未声明时为空。
	Format string
	// Size 是附件声明的字节数，HasSize 为 false 时表示未声明。
	Size    int64
	HasSize bool
	// ActualSize 是附件在包中的实际字节数，0 表示未知或文件不存在。
	ActualSize int64
	// Usage 是附件用途，未声明时为空。
	Usage string
	// Visible 表示附件是否可见，未声明时为 true。
	Visible bool
	// Exists 表示附件文件是否存在于包中。
	Exists bool
}

type Bookmark struct {
	// Name 是书签名称。
	Name string
	// Page 是从 0 开始的目标页索引，-1 表示无法解析。
	Page int
	// Dest 是书签目标的位置与缩放。
	Dest *OutlineDest
}

type CertificateDetail struct {
	// Slot 是所属层级：印章或外层。
	Slot string
	// SlotKey 是层级的机器可读标识：seal 或 outer，用于导出证书。
	SlotKey string
	// Subject、Issuer 是证书主体与签发者。
	Subject string
	Issuer  string
	// CommonName、Organization、OrganizationalUnit、Country、Locality、Province 是证书主体字段。
	CommonName         string
	Organization       string
	OrganizationalUnit string
	Country            string
	Locality           string
	Province           string
	// SerialNumber 是证书序列号。
	SerialNumber string
	// NotBefore、NotAfter 是证书有效期（RFC3339）。
	NotBefore string
	NotAfter  string
	// PublicKey 是公钥算法名称。
	PublicKey string
	// Algorithm、SignatureFormat 是签名算法与编码格式。
	Algorithm       string
	SignatureFormat string
	// SignatureValid 表示该层签名通过公钥验证。
	SignatureValid bool
	// CertificateValid 表示证书在签名时间点有效。
	CertificateValid bool
	// TrustChecked、Trusted、TrustError 是证书链校验结果。
	TrustChecked bool
	Trusted      bool
	TrustError   string
	// RevocationChecked、RevocationStatus、RevocationError 是吊销校验结果。
	RevocationChecked bool
	RevocationStatus  string
	RevocationError   string
	// Error 是验证失败原因。
	Error string
}

type DocumentInfo struct {
	DocID        string
	Title        string
	Author       string
	Subject      string
	Abstract     string
	CreationDate string
	ModDate      string
	Creator      string
	Version      string
}

type DocumentStats struct {
	// Fonts 是声明字体的数量。
	Fonts int
	// Attachments 是附件数量。
	Attachments int
	// Media 是多媒资资源数量。
	Media int
	// AnnotationPages 是声明了注解的页面数量。
	AnnotationPages int
	// Signatures 是签名数量。
	Signatures int
}

type FontInfo struct {
	// ID 是字体在所属文档内的标识。
	ID uint64
	// Scope 是字体所属文档体的索引，与 ID 一起唯一标识一个字体。
	Scope int
	// Name 是 OFD 声明的字体名称（FontName）。
	Name string
	// Family 是字体族名称（FamilyName），可能为空。
	Family string
	// Bold、Italic 表示字体声明为粗体或斜体。
	Bold   bool
	Italic bool
	// Serif 表示衬线字体，FixedWidth 表示等宽字体。
	Serif      bool
	FixedWidth bool
	// Format 是嵌入字体文件的格式（如 ttf、otf），无嵌入时为空。
	Format string
	// Embedded 表示文档是否内嵌了字体文件。
	Embedded bool
}

type FontRef struct {
	// Scope 是字体所属文档体的索引。
	Scope int
	// ID 是字体在所属文档内的标识。
	ID uint64
}

type FontResource struct {
	ID     uint64
	Family string
	Name   string
	Bold   bool
	Italic bool
	Format string
	Data   []byte
}

type FontSource struct {
	Family string
	Name   string
	Weight int
	Italic bool
	Data   []byte
}

type FontUsage struct {
	// Pages 是使用该字体的页面索引，升序排列。
	Pages []int
	// Scanned 是实际扫描的页数。
	Scanned int
	// Truncated 表示因达到扫描页数或结果数量上限而提前结束，结果可能不完整。
	Truncated bool
}

type FontUsageOptions struct {
	// MaxScan 是最多扫描的页数，0 使用默认值 maxFontUsageScan，上限为 maxFontUsageScanHard。
	MaxScan int
	// MaxPages 是每个字体最多返回的页面数，0 使用默认值 maxFontUsagePages，上限为 maxFontUsagePagesHard。
	MaxPages int
}

type FontUsageReport struct {
	// Fonts 按字体 ID 升序排列。
	Fonts []FontUsageSummary
	// Scanned 是实际扫描的页数。
	Scanned int
	// Truncated 表示因扫描页数或单个字体结果数量上限而可能不完整。
	Truncated bool
}

type FontUsageSummary struct {
	// Scope 是字体所属文档体的索引。
	Scope int
	// ID 是字体在所属文档内的标识。
	ID uint64
	// Pages 是使用该字体的页面索引，升序排列，最多 maxFontUsagePages 个。
	Pages []int
}

type Glyph struct {
	Text   string
	X      float64
	Y      float64
	Width  float64
	Height float64
	Angle  float64
}

type MediaInfo struct {
	// Scope 是资源所属文档体的索引。
	Scope int
	// ID 是多媒体资源标识。
	ID uint64
	// Name 是资源文件名，未解析时为空。
	Name string
	// Type 是多媒体类型，通常为 Image、Audio 或 Video。
	Type string
	// Format 是多媒体格式，未声明时为空。
	Format string
	// Size 是资源在包中的实际字节数，0 表示未知或文件不存在。
	Size int64
	// Exists 表示资源文件是否存在于包中。
	Exists bool
}

type OpenOptions struct {
	// PageCacheCapacity 是页面缓存最多保留的页面数量，0 表示使用默认值。
	PageCacheCapacity int
	// PageCacheBytes 是页面缓存允许使用的估算最大字节数，0 表示使用默认值。
	PageCacheBytes int64
}

type OutlineDest struct {
	// Type 是目标类型，如 XYZ、Fit、FitH、FitV、FitR。
	Type string
	// Left、Top、Right、Bottom 是目标视图的边界。
	Left   *float64
	Top    *float64
	Right  *float64
	Bottom *float64
	// Zoom 是目标缩放比例。
	Zoom *float64
}

type OutlineNode struct {
	// Title 是大纲项标题。
	Title string
	// Page 是从 0 开始的目标页索引，-1 表示没有可跳转目标。
	Page int
	// URI 是外部链接目标，非空时点击打开链接。
	URI string
	// Dest 是页面跳转目标的位置与缩放，nil 表示没有位置信息。
	Dest *OutlineDest
	// Expanded 是文档声明的是否默认展开子项，nil 表示未声明。
	Expanded *bool
	// Children 是子大纲项。
	Children []OutlineNode
}

type OutlineTree struct {
	// PageMode 是文档声明的页面显示模式，例如 UseOutlines；为空表示未声明。
	PageMode string
	// Nodes 是顶层大纲项。
	Nodes []OutlineNode
	// Bookmarks 是文档书签列表。
	Bookmarks []Bookmark
}

type PageInfo struct {
	Index  int
	Width  float64
	Height float64
}

type PageLink struct {
	// Scope 是链接所属文档体的索引。
	Scope int
	// Page 是链接所在页面的全局索引。
	Page int
	// ID 是承载链接的图元标识，未声明时为空。
	ID string
	// Boundary 是图元边界（毫米）。
	Boundary AnnotationBoundary
	// URI 是外部链接目标，非空时点击打开链接。
	URI string
	// TargetPage 是跳转目标页全局索引，-1 表示没有页面目标。
	TargetPage int
	// Dest 是跳转目标的位置与缩放，nil 表示没有位置信息。
	Dest *OutlineDest
}

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

type Rect struct {
	X      float64
	Y      float64
	Width  float64
	Height float64
	Angle  float64
}

type RenderFormat string

type RenderOptions struct {
	DPI        float64
	Background color.Color
	Format     RenderFormat
}

type SearchResult struct {
	Page  int
	Run   int
	Text  string
	Start int
	End   int
	Rects []Rect
}

type SignatureInfo struct {
	// Scope 是签名所属文档体的索引。
	Scope int
	// ID 是签名标识。
	ID string
	// Provider、Company、Version 是签名提供者信息。
	Provider string
	Company  string
	Version  string
	// Method 是签名算法标识（通常是 OID），未声明时为空。
	Method string
	// Date 是签名时间，保留原始文本。
	Date string
	// HasDigest、DigestValid 和 DigestMethod 是摘要校验结果。
	HasDigest    bool
	DigestValid  bool
	DigestMethod string
	// HasVerification、Verified、Trusted、TrustChecked 是验签结果。
	HasVerification bool
	Verified        bool
	Trusted         bool
	TrustChecked    bool
	// VerificationError 是验签错误信息，无错误时为空。
	VerificationError string
	// Stamps 是签名关联的签章位置。
	Stamps []SignatureStamp
	// Certificates 是印章与外层两层的证书与验证明细。
	Certificates []CertificateDetail
	// References 是签名覆盖的文件引用及逐项摘要校验结果。
	References []SignatureReference
	// HasDataHash、DataHashMatch 是签名数据摘要（Signature.xml）校验结果。
	HasDataHash   bool
	DataHashMatch bool
}

type SignatureReference struct {
	// FileRef 是签名中声明的文件引用路径。
	FileRef string
	// Exists 表示引用的文件是否存在于包中。
	Exists bool
	// Match 表示摘要是否一致。
	Match bool
	// Error 是校验失败原因。
	Error string
}

type SignatureStamp struct {
	// Page 是签章所在页面的全局索引，-1 表示无法解析。
	Page int
	// ID 是签章标识。
	ID string
	// Boundary 是签章边界（毫米），未声明时为 nil。
	Boundary *AnnotationBoundary
	// HasSeal 表示是否提取到印章数据。
	HasSeal bool
	// SealType 是印章文件类型（如 png、jpg、ofd），无印章时为空。
	SealType string
}

type TextRun struct {
	Text   string
	X      float64
	Y      float64
	Width  float64
	Height float64
	// Scope 是文字所属文档体的索引，与 Font 一起唯一标识使用的字体。
	Scope         int
	Font          uint64
	Size          float64
	Weight        int
	ReadDirection int
	CharDirection int
	FontFamily    string
	Bold          bool
	Italic        bool
	Glyphs        []Glyph
}

type ViewPreferences struct {
	// PageLayout 是文档声明的页面布局方式，如 OneColumn、TwoPageL、TwoPageR。
	PageLayout string
	// ZoomMode 是文档声明的缩放模式，如 FitWidth、FitHeight、FitRect。
	ZoomMode string
	// Zoom 是文档声明的自定义缩放比例。
	Zoom *float64
}