136 lines
5.6 KiB
Swift
136 lines
5.6 KiB
Swift
import UIKit
|
||
|
||
// MARK: - 文本渲染引擎
|
||
|
||
/// EPUB 文本渲染引擎枚举
|
||
/// 定义了当前支持的文本渲染方式，未来可扩展为多引擎选择
|
||
public enum RDEPUBTextRenderingEngine: Equatable {
|
||
/// 基于 DTCoreText 的渲染引擎，将 HTML/CSS 转换为 NSAttributedString
|
||
case dtCoreText
|
||
}
|
||
|
||
// MARK: - 阅读器配置
|
||
|
||
/// EPUB 阅读器的完整配置结构体
|
||
/// 作为 EPUBUI 层的入口配置，控制阅读器的外观、行为和功能开关
|
||
/// 调用方在创建 RDEPUBReaderController 前可自定义此配置
|
||
public struct RDEPUBReaderConfiguration: Equatable {
|
||
// MARK: 阅读排版参数
|
||
|
||
/// 正文字号（单位：pt），默认 15
|
||
public var fontSize: CGFloat
|
||
/// 行距倍数，默认 1.6（即行距为字号的 1.6 倍）
|
||
public var lineHeightMultiple: CGFloat
|
||
/// 栏数，默认单栏
|
||
public var numberOfColumns: Int
|
||
/// 栏间距，默认 20pt
|
||
public var columnGap: CGFloat
|
||
/// 翻页显示模式：.pageCurl（仿真翻页）或 .scroll（滚动阅读）
|
||
public var displayType: RDReaderView.DisplayType
|
||
/// 横屏时是否启用双页显示，默认开启
|
||
public var landscapeDualPageEnabled: Bool
|
||
|
||
// MARK: UI 功能开关
|
||
|
||
/// 是否显示目录入口，默认开启
|
||
public var showsTableOfContents: Bool
|
||
/// 是否允许文本高亮功能，默认开启
|
||
public var allowsHighlights: Bool
|
||
/// 是否显示设置面板入口，默认开启
|
||
public var showsSettingsPanel: Bool
|
||
|
||
// MARK: 内容内边距
|
||
|
||
/// 流式排版（reflowable）内容的内边距，上下 40pt、左右 16pt
|
||
public var reflowableContentInsets: UIEdgeInsets
|
||
/// 固定布局（fixed layout）内容的内边距，默认为零
|
||
public var fixedContentInset: UIEdgeInsets
|
||
|
||
// MARK: 主题与布局
|
||
|
||
/// 当前阅读主题（浅色/深色/护眼等），默认 .light
|
||
public var theme: RDEPUBReaderTheme
|
||
/// 固定布局的适配模式：按页适配或按宽度适配
|
||
public var fixedLayoutFit: RDEPUBFixedLayoutFit
|
||
/// 固定布局的跨页模式：自动/单页/双页
|
||
public var fixedLayoutSpreadMode: RDEPUBFixedLayoutSpreadMode
|
||
/// 文本渲染引擎，默认使用 DTCoreText
|
||
public var textRenderingEngine: RDEPUBTextRenderingEngine
|
||
|
||
// MARK: 初始化
|
||
|
||
/// 创建阅读器配置，所有参数均提供合理的默认值
|
||
/// - Parameters:
|
||
/// - fontSize: 正文字号，默认 15pt
|
||
/// - lineHeightMultiple: 行距倍数，默认 1.6
|
||
/// - displayType: 翻页模式，默认 .pageCurl
|
||
/// - landscapeDualPageEnabled: 横屏双页，默认 true
|
||
/// - showsTableOfContents: 显示目录入口，默认 true
|
||
/// - allowsHighlights: 允许高亮，默认 true
|
||
/// - showsSettingsPanel: 显示设置面板，默认 true
|
||
/// - reflowableContentInsets: 流式排版内边距
|
||
/// - fixedContentInset: 固定布局内边距
|
||
/// - theme: 阅读主题，默认 .light
|
||
/// - fixedLayoutFit: 固定布局适配模式
|
||
/// - fixedLayoutSpreadMode: 固定布局跨页模式
|
||
/// - textRenderingEngine: 文本渲染引擎
|
||
public init(
|
||
fontSize: CGFloat = 15,
|
||
lineHeightMultiple: CGFloat = 1.6,
|
||
numberOfColumns: Int = 1,
|
||
columnGap: CGFloat = 20,
|
||
displayType: RDReaderView.DisplayType = .pageCurl,
|
||
landscapeDualPageEnabled: Bool = true,
|
||
showsTableOfContents: Bool = true,
|
||
allowsHighlights: Bool = true,
|
||
showsSettingsPanel: Bool = true,
|
||
reflowableContentInsets: UIEdgeInsets = UIEdgeInsets(top: 40, left: 16, bottom: 40, right: 16),
|
||
fixedContentInset: UIEdgeInsets = .zero,
|
||
theme: RDEPUBReaderTheme = .light,
|
||
fixedLayoutFit: RDEPUBFixedLayoutFit = .page,
|
||
fixedLayoutSpreadMode: RDEPUBFixedLayoutSpreadMode = .automatic,
|
||
textRenderingEngine: RDEPUBTextRenderingEngine = .dtCoreText
|
||
) {
|
||
self.fontSize = fontSize
|
||
self.lineHeightMultiple = lineHeightMultiple
|
||
self.numberOfColumns = max(1, numberOfColumns)
|
||
self.columnGap = max(0, columnGap)
|
||
self.displayType = displayType
|
||
self.landscapeDualPageEnabled = landscapeDualPageEnabled
|
||
self.showsTableOfContents = showsTableOfContents
|
||
self.allowsHighlights = allowsHighlights
|
||
self.showsSettingsPanel = showsSettingsPanel
|
||
self.reflowableContentInsets = reflowableContentInsets
|
||
self.fixedContentInset = fixedContentInset
|
||
self.theme = theme
|
||
self.fixedLayoutFit = fixedLayoutFit
|
||
self.fixedLayoutSpreadMode = fixedLayoutSpreadMode
|
||
self.textRenderingEngine = textRenderingEngine
|
||
}
|
||
|
||
/// 默认配置实例，使用所有参数的默认值
|
||
public static let `default` = RDEPUBReaderConfiguration()
|
||
}
|
||
|
||
// MARK: - 配置转换
|
||
|
||
extension RDEPUBReaderConfiguration {
|
||
/// 将用户可见的配置转换为底层排版引擎所需的 RDEPUBPreferences
|
||
/// - Returns: 排版偏好设置实例，供 Core 层的渲染管道使用
|
||
func makePreferences() -> RDEPUBPreferences {
|
||
RDEPUBPreferences(
|
||
fontSize: fontSize,
|
||
lineHeightMultiple: lineHeightMultiple,
|
||
reflowableContentInsets: reflowableContentInsets,
|
||
fixedContentInset: fixedContentInset,
|
||
numberOfColumns: numberOfColumns,
|
||
columnGap: columnGap,
|
||
themeBackgroundColor: theme.themeBackgroundColorCSS,
|
||
themeTextColor: theme.themeTextColorCSS,
|
||
fixedBackgroundColor: theme.themeBackgroundColorCSS,
|
||
fixedLayoutFit: fixedLayoutFit,
|
||
fixedLayoutSpreadMode: fixedLayoutSpreadMode
|
||
)
|
||
}
|
||
}
|