app: migrate all engine access to the C ABI facade (nm U _ZN5olive = 0)

Every app module now reaches liboakengine exclusively through oakengine_* C calls, EngineEventBridge subscriptions and app-side handle headers (cliphandle/keyframehandle/nodevaluehandle/oakvaluehelper). Direct C++ command construction, engine signal connect()s, and engine type usage in MOC-visible signatures are gone: 557 -> 0 undefined olive:: symbols in oak-editor.
2026-07-26 22:43:21 +08:00
parent f95590e924
commit 0aa5879f35
256 changed files with 12357 additions and 4044 deletions
@@ -0,0 +1,83 @@
+/*
+ * Oak Video Editor - Non-Linear Video Editor
+ * Copyright (C) 2025 Olive CE Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef OAK_HTMLAPP_H
+#define OAK_HTML_H
+
+#include <QTextDocument>
+#include <QTextFragment>
+#include <QXmlStreamReader>
+#include <QXmlStreamWriter>
+
+namespace olive
+{
+
+/**
+ * @brief Functions for converting HTML to QTextDocument and vice versa
+ *
+ * Qt does contain its own functions for this, however they have some limitations. Some things that
+ * we want to support (e.g. kerning/spacing and font stretch) are not implemented in Qt's
+ * QTextHtmlExporter and QTextHtmlParser. Additionally, since these functions are not part of Qt's
+ * public API, and make many references to other parts of Qt that are not part of the public API,
+ * there is no way to subclass or extend their functionality without forking Qt as a whole.
+ *
+ * Therefore, it became necessary to write a custom class for the conversion so that we can
+ * ensure support for the features we need.
+ *
+ * If someone wishes to extend this class for more feature support, feel free to open a pull
+ * request. But this is NOT intended to be an exhaustive HTML implementation, and is primarily
+ * designed to store rich text in a standard format for the purpose of text formatting for video.
+ */
+class Html {
+public:
+	static QString doc_to_html(const QTextDocument *doc);
+
+	static void html_to_doc(QTextDocument *doc, const QString &html);
+
+private:
+	static void write_block(QXmlStreamWriter *writer, const QTextBlock &block);
+
+	static void write_fragment(QXmlStreamWriter *writer,
+							  const QTextFragment &fragment);
+
+	static void write_css_property(QString *style, const QString &key,
+								 const QStringList &value);
+	static void write_css_property(QString *style, const QString &key,
+								 const QString &value)
+	{
+		write_css_property(style, key, QStringList({ value }));
+	}
+
+	static void write_char_format(QString *style, const QTextCharFormat &fmt);
+
+	static QTextCharFormat
+	read_char_format(const QXmlStreamAttributes &attributes);
+
+	static QTextBlockFormat
+	read_block_format(const QXmlStreamAttributes &attributes);
+
+	static void append_string_auto_space(QString *s, const QString &append);
+
+	static QMap<QString, QStringList> get_css_from_style(const QString &s);
+
+	static const QVector<QString> k_block_tags;
+};
+
+}
+
+#endif // OAK_HTML_H