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
4.8 KiB
4.8 KiB
记录项
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 反向依赖。