948004eed1
源码注释： - 为 ~60 个 Swift 文件补充缺失的 doc comment（file header、类型、属性、方法） - 修正 4 处错误注释：翻页模式数量、搜索行为描述、手势识别器描述、悬空文档块 文档维护： - 删除重复文档：WXRead/读书EPUB阅读器实现架构.md（与微信读书版完全一致） - 合并重叠文档：阅读器规划.md → 阅读器功能开发计划.md（单一真值） - 修正过时内容：所有文档中"四种翻页模式"→"三种"，移除 horizontalCoverScroll - 更新架构图：补齐 EPUBUI/ReaderController、Paging/、Typesetter/ 等子目录 - 更新 index.md 索引：新增开发计划和架构对比文档引用
52 lines
1.7 KiB
Swift
52 lines
1.7 KiB
Swift
// RDEPUBTextPaginationInterfaces.swift
|
||
// EPUB 分页接口定义，包括断页决策、章节数页和页面帧构建协议。
|
||
|
||
import Foundation
|
||
import UIKit
|
||
|
||
// MARK: - 分页接口定义
|
||
|
||
/// 单次断页决策，记录断页位置、原因及诊断信息。
|
||
struct RDEPUBPageBreakDecision {
|
||
/// 本页在富文本中的字符范围
|
||
var range: NSRange
|
||
/// 断页原因
|
||
var reason: RDEPUBTextPageBreakReason
|
||
/// 分页过程中的诊断日志
|
||
var diagnostics: [String]
|
||
}
|
||
|
||
/// 章节页数计算接口，将富文本按页面尺寸拆分为断页决策序列。
|
||
protocol RDEPUBChapterPageCounting {
|
||
/// 计算章节中每页的断页位置。
|
||
/// - Parameters:
|
||
/// - attributedString: 章节富文本
|
||
/// - pageSize: 页面尺寸
|
||
/// - config: 排版配置
|
||
/// - fragmentOffsets: fragment 锚点偏移映射
|
||
/// - Returns: 断页决策数组，每个元素对应一页
|
||
func pageRanges(
|
||
for attributedString: NSAttributedString,
|
||
pageSize: CGSize,
|
||
config: RDEPUBTextLayoutConfig,
|
||
fragmentOffsets: [String: Int]
|
||
) -> [RDEPUBPageBreakDecision]
|
||
}
|
||
|
||
/// 页面帧构建接口，将富文本转换为可渲染的页面帧数组。
|
||
protocol RDEPUBPageFrameBuilding {
|
||
/// 将富文本构建为页面帧数组。
|
||
/// - Parameters:
|
||
/// - attributedString: 待分页的富文本
|
||
/// - pageSize: 页面尺寸
|
||
/// - config: 排版配置
|
||
/// - fragmentOffsets: fragment 锚点偏移映射
|
||
/// - Returns: 页面帧数组
|
||
func makeFrames(
|
||
attributedString: NSAttributedString,
|
||
pageSize: CGSize,
|
||
config: RDEPUBTextLayoutConfig,
|
||
fragmentOffsets: [String: Int]
|
||
) -> [RDEPUBTextLayoutFrame]
|
||
}
|