feat(文件归并): 归并同类文件清理辅助代码

ofdgo_structure_target.go

@@ -29,6 +29,13 @@ type structureVisitor struct {
 	boundsOnly bool
 }
 
+// structureObjectVisitor 收集页面、复合图元及注释外观标识，绑定校验不解码字体、图片或裁剪
+type structureObjectVisitor struct {
+	objects     map[string]bool
+	targets     []StructureTarget
+	listTargets bool
+}
+
 // BeginObject 记录当前图元的标引目标，使复合图元引用覆盖其成员
 // 入参: object 页面图元
 // 返回: bool 是否需要配对结束通知
@@ -120,3 +127,89 @@ func (v *structureVisitor) DrawObject(object *GraphicObject, state RenderState)
 // 入参: stamp 签章外观
 // 返回: error 取消错误
 func (v *structureVisitor) DrawStamp(stamp Stamp) error { return v.ctx.Err() }
+
+// StructureObjects 列出指定页可绑定的图元及原文，包含模板、隐藏内容、复合图元成员和注释外观
+// 不解码字体和图片，返回顺序遵循页面遍历顺序，同一标识仅列出一次
+// 入参: page 从0开始的页面索引
+// 返回: []StructureTarget 候选图元，不计算Bounds, error 页面或遍历错误
+func (r *Renderer) StructureObjects(page int) ([]StructureTarget, error) {
+	return r.StructureObjectsContext(context.Background(), page)
+}
+
+// StructureObjectsContext 列出页面绑定候选，读取或遍历取消时不返回部分结果，不改变渲染选项
+// 入参: ctx 取消上下文, page 从0开始的页面索引
+// 返回: []StructureTarget 候选图元，不计算Bounds, error 页面读取、遍历或取消错误
+func (r *Renderer) StructureObjectsContext(ctx context.Context, page int) ([]StructureTarget, error) {
+	content, err := r.Reader.PageContentByIndexContext(ctx, page)
+	if err != nil {
+		return nil, err
+	}
+	visitor := &structureObjectVisitor{objects: make(map[string]bool), listTargets: true}
+	view := *r
+	view.RenderAnnotations = true
+	view.pageContext = ctx
+	if err := view.WalkPage(content, visitor); err != nil {
+		return nil, err
+	}
+	for i := range visitor.targets {
+		if err := ctx.Err(); err != nil {
+			return nil, err
+		}
+		visitor.targets[i].Page, visitor.targets[i].PageID = page+1, content.ID
+	}
+	if err := ctx.Err(); err != nil {
+		return nil, err
+	}
+	return visitor.targets, nil
+}
+
+// BeginObject 登记图元标识，不创建分组状态
+// 入参: object 页面图元
+// 返回: bool 始终为false
+func (v *structureObjectVisitor) BeginObject(object *GraphicObject) bool {
+	id := editorResourceID(editorObjectID(*object))
+	if id != "" && !v.objects[id] {
+		v.objects[id] = true
+		if !v.listTargets {
+			return false
+		}
+		target := StructureTarget{ID: id}
+		if object.Type == "TextObject" {
+			target.Text = object.TextObject.Text()
+		}
+		v.targets = append(v.targets, target)
+	}
+	return false
+}
+
+// EndObject 满足分组访问接口，不维护分组栈
+func (v *structureObjectVisitor) EndObject() {}
+
+// BeginAnnotation 不将注释容器编号作为图元标识
+// 入参: id 注解标识
+// 返回: bool 始终为false
+func (v *structureObjectVisitor) BeginAnnotation(id string) bool { return false }
+
+// SkipObjects 不依赖图元序号
+// 入参: count 跳过数量
+func (v *structureObjectVisitor) SkipObjects(count int) {}
+
+// IncludeHidden 允许绑定隐藏图元
+// 返回: bool 始终为true
+func (v *structureObjectVisitor) IncludeHidden() bool { return true }
+
+// SkipClips 绑定校验不需要裁剪轮廓
+// 返回: bool 始终为true
+func (v *structureObjectVisitor) SkipClips() bool { return true }
+
+// DrawObject 不绘制图元，标识已由BeginObject登记
+// 入参: object 页面图元, state 继承状态
+// 返回: error 始终为nil
+func (v *structureObjectVisitor) DrawObject(object *GraphicObject, state RenderState) error {
+	return nil
+}
+
+// DrawStamp 不将签章外观作为正文绑定目标
+// 入参: stamp 签章外观
+// 返回: error 始终为nil
+func (v *structureObjectVisitor) DrawStamp(stamp Stamp) error { return nil }