Mike-Solar
bad52feda3
- de-Qt all classes under src/common (std::string/vector/mutex, std::filesystem, expat-based XmlStreamReader/Writer) - add pure C ABI in include/common + src/common/c_api: opaque handles, init returns NULL on failure, free(NULL) is a no-op, out-params with negative OAKCOMMON_E_* error codes (include/common/error.h) - remove single-consumer classes from oakcommon (html, jobtime, otioutils, playbackaudioclock, tohex, util, avframeptr, crashpadinterface/crashpadutils, autoscroll, digit, range); their destinations are recorded in docs/zh/plans/riir/notes.md - add gtest suites under src/common/tests (127 cases), standalone build driver in src/common/standalone
83 lines
4.8 KiB
Markdown
83 lines
4.8 KiB
Markdown
# 记录项
|
||
|
||
## common
|
||
|
||
CancelableObject只在render和task处有🚰，移入对应模块。
|
||
|
||
## 从 oakcommon（src/common）移除的类（2026-08-05）
|
||
|
||
判据：不严重依赖 common 其他类，且只有一个非 common 模块使用它
|
||
（tests/gtest 不计入使用方）。以下类已从 `src/common/` 移除，
|
||
拆分时应放到对应模块：
|
||
|
||
| 类 | 唯一使用方 | 应放到 |
|
||
|---|---|---|
|
||
| `Html`（html.h/.cpp） | engine/node | oaknode（M3）。注意它依赖 common 的 xmlutils，迁移时需连同 XML 辅助或改为调用 oakcommon C API |
|
||
| `JobTime`（jobtime.h/.cpp） | engine/render | oakrender（M7） |
|
||
| `OTIOUtils`（otioutils.h） | engine/task | oaktask（M8） |
|
||
| `PlaybackAudioClock`（playbackaudioclock.h） | engine/audio | oakaudio（M6） |
|
||
| `to_hex`（tohex.h） | engine/node | oaknode（M3） |
|
||
| `mid()`（util.h） | engine/node | oaknode（M3） |
|
||
| `AVFramePtr`（avframeptr.h） | engine/render | oakrender（M7） |
|
||
| `CrashpadInterface`（crashpadinterface.h/.cpp） | app/main.cpp | app（crashhandler 相关） |
|
||
| crashpadutils.h | app/crashhandler | app/crashhandler |
|
||
| `AutoScroll`（autoscroll.h，oakutil shim） | app/dialog、app/widget | app |
|
||
| `digit.h`（oakutil shim） | app/dialog | app |
|
||
| `range.h`（oakutil shim） | app/widget | app |
|
||
|
||
另：`power.h`、`memorypool.h`、`threadsafemap.h` 当前没有任何
|
||
common 模块外的使用方（零用户），不满足移除判据，暂保留在
|
||
oakcommon；后续若确认无用途可直接删除。
|
||
|
||
## oakcommon 去Qt化的删除与语义变更（2026-08-05）
|
||
|
||
去Qt化过程中以下函数被删除或语义变化，迁移调用方时需注意：
|
||
|
||
- `CommandLineParser::print_help()`：不再自动读取
|
||
`QCoreApplication::applicationName()/applicationVersion()`，需先调
|
||
`set_app_info()`（C API：`oakcommon_commandlineparser_set_app_info`），
|
||
否则打印默认 `"oak"` + 空版本。
|
||
- `FileFunctions::get_unique_file_identifier`：哈希由 SHA-1 改为
|
||
FNV-1a 64-bit，旧缓存 key 全部失效（需一次重建）。
|
||
`get_configuration_location`/`get_application_path`/
|
||
`get_temp_file_path`/`get_auto_recovery_root` 的标准路径改为手写
|
||
平台实现，路径与原 Qt 版不同。`read_file_as_string(":/...")` 的
|
||
qrc 资源路径不再可用，shader 等资源调用方需改为磁盘路径或内嵌。
|
||
- xmlutils：`xml_read_next_start_element(reader, CancelAtom*)`
|
||
重载与 cancel_atom 参数删除（依赖 render/cancelatom.h），取消语义
|
||
由调用方在循环外自行检查；`XMLAttributeLoop` 宏删除，由
|
||
`XmlStreamReader::attributes()` + range-for 替代；
|
||
`QXmlStreamReader/Writer` 由基于 expat 的
|
||
`olive::XmlStreamReader/Writer` 替代（不支持 XML 命名空间）。
|
||
- `OIIOUtils::frame_to_buffer/buffer_to_frame`：未进 C API，C++ 侧签名
|
||
拍平为 `(const void *data, int64_t linesize_bytes, OIIO::ImageBuf *)`，
|
||
engine/codec/frame.cpp 迁移时传成员即可。`OakCommonPixelFormat` 枚举
|
||
目前定义在 include/common/ocioutils.h，oiioutils 复用，后续可抽成
|
||
独立的 include/common/pixelformat.h。
|
||
- `MemoryPool`：删除 QTimer 每 5 秒自动回收空 arena，改为公有
|
||
`clear_empty_arenas()` 由调用方周期调用；不再继承 QObject。
|
||
memorypool/threadsafemap 零使用方且为模板/多态基类，未包 C API。
|
||
- `debug_handler`：丢失 `QMessageLogContext`（文件/行号）参数（原实现
|
||
本就未用）；`qInstallMessageHandler` 无对应物。
|
||
- `Current::set_current_video_params/audio_params`：由按值拷贝改为持有
|
||
`std::shared_ptr<void>`（类型擦除），调用方需自行管理生命周期并用
|
||
`static_pointer_cast` 还原（调用点：olivehost.cpp、
|
||
timebasedwidget.cpp、plugin.cpp 等 6 处）。
|
||
- qtutils：engine 未使用的纯 UI 函数（`q_font_metrics_width`、
|
||
`create_horizontal/vertical_line`、`set_combo_box_data`、
|
||
`word_wrap_string`、`flip_control_and_shift_modifiers`、
|
||
`get_formatted_date_time`、`to_q_color`、`core::qHash`、
|
||
`Q_DECLARE_METATYPE` 宏组）未迁入 oakcommon，app 层继续用 Qt 版。
|
||
`ptr_to_value/value_to_ptr` 载体由 QVariant 改为 `uintptr_t`，
|
||
迁移时调用点需同步改（renderprocessor.cpp、rendermanager.cpp、
|
||
previewautocacher.cpp、src/capi/worker.cpp）。`get_parent_of_type`
|
||
依赖 C++ 模板+RTTI，未进 C API。
|
||
- define.h：删除 `MACRO_NAME_AS_STR`/`MACRO_VAL_AS_STR`/
|
||
`OLIVE_NS_CONST_ARG`/`OLIVE_NS_ARG`/`OLIVE_NS_RETURN_ARG`
|
||
（依赖 Qt QArgument，全仓无使用）。
|
||
- decibel.h：删除 `ALLOW_RETURNING_INFINITY` 编译开关分支（代码库
|
||
未定义该宏，行为不变）。
|
||
- `FFmpegUtils`：新增类内常量 `k_rgb_channel_count/k_rgba_channel_count`
|
||
（3/4）取代对 `VideoParams` 同名常量的引用，消除 common→render
|
||
反向依赖。
|