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,154 @@
+/***
+
+  Oak - Non-Linear Video Editor
+  Copyright (C) 2026 Oak 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_MARKERHANDLE_H
+#define OAK_MARKERHANDLE_H
+
+#include <olive/core/core.h>
+
+#include <QByteArray>
+#include <QString>
+
+#include "oakengine/timeline.h"
+
+namespace olive
+{
+
+class TimelineMarker;
+class TimelineMarkerList;
+
+using olive::core::Rational;
+using olive::core::TimeRange;
+
+/**
+ * @brief Facade accessors for marker pointers held by the ruler/scrollbar
+ * widgets.
+ *
+ * The widgets keep olive::TimelineMarker* / olive::TimelineMarkerList* as
+ * opaque identity pointers (selection, drawing, hit-testing). All engine
+ * data and mutations go through the liboakengine C ABI
+ * (oakengine/timeline.h); the pointer itself is only a handle. Marker
+ * times are rational seconds (num/den pairs), not frame timestamps.
+ */
+
+inline OakEngineMarker *markerhandle(TimelineMarker *marker)
+{
+	return reinterpret_cast<OakEngineMarker *>(marker);
+}
+
+inline const OakEngineMarker *markerhandle(const TimelineMarker *marker)
+{
+	return reinterpret_cast<const OakEngineMarker *>(marker);
+}
+
+inline TimelineMarker *markerhandle(OakEngineMarker *marker)
+{
+	return reinterpret_cast<TimelineMarker *>(marker);
+}
+
+inline OakEngineMarkerList *markerlisthandle(TimelineMarkerList *list)
+{
+	return reinterpret_cast<OakEngineMarkerList *>(list);
+}
+
+inline const OakEngineMarkerList *markerlisthandle(
+	const TimelineMarkerList *list)
+{
+	return reinterpret_cast<const OakEngineMarkerList *>(list);
+}
+
+inline TimeRange marker_time(const TimelineMarker *marker)
+{
+	int64_t in_num = 0, in_den = 1, out_num = 0, out_den = 1;
+	oakengine_marker_get_time(markerhandle(marker), &in_num, &in_den,
+							  &out_num, &out_den);
+	return TimeRange(Rational(int(in_num), int(in_den)),
+					 Rational(int(out_num), int(out_den)));
+}
+
+inline QString marker_name(const TimelineMarker *marker)
+{
+	const int size =
+		oakengine_marker_get_name(markerhandle(marker), nullptr, 0);
+	QByteArray buf(size + 1, '\0');
+	oakengine_marker_get_name(markerhandle(marker), buf.data(),
+							  int(buf.size()));
+	return QString::fromUtf8(buf.constData());
+}
+
+inline int marker_color(const TimelineMarker *marker)
+{
+	return oakengine_marker_get_color(markerhandle(marker));
+}
+
+inline bool marker_has_sibling_at_time(const TimelineMarker *marker,
+									   const Rational &time)
+{
+	return oakengine_marker_has_sibling_at_time(
+			   markerhandle(marker), time.numerator(), time.denominator()) != 0;
+}
+
+inline void marker_set_time_live(TimelineMarker *marker,
+								 const TimeRange &range)
+{
+	oakengine_marker_set_time_live(
+		markerhandle(marker), range.in().numerator(), range.in().denominator(),
+		range.out().numerator(), range.out().denominator());
+}
+
+/**
+ * @brief ADL customization points for
+ * TimeBasedViewSelectionManager<TimelineMarker>.
+ *
+ * The selection manager template calls these unqualified; these overloads
+ * route marker access through the facade (see
+ * widget/keyframeview/keyframehandle.h for the NodeKeyframe equivalent).
+ * selection_time_target_parent() is intentionally not overloaded: the
+ * generic template in timebasedviewselectionmanager.h works for markers
+ * and marker drags never pass a time target.
+ */
+inline Rational selection_time(TimelineMarker *marker)
+{
+	return marker_time(marker).in();
+}
+
+inline Rational selection_time_end(TimelineMarker *marker)
+{
+	return marker_time(marker).out();
+}
+
+inline void selection_set_time(TimelineMarker *marker, const Rational &time)
+{
+	// Move the in-point keeping the range length (was
+	// TimelineMarker::set_time(const Rational &))
+	const TimeRange range = marker_time(marker);
+	const Rational length = range.out() - range.in();
+	marker_set_time_live(marker, TimeRange(time, time + length));
+}
+
+inline bool selection_has_sibling_at_time(TimelineMarker *marker,
+										  const Rational &time)
+{
+	return marker_has_sibling_at_time(marker, time);
+}
+
+} // namespace olive
+
+#endif // OAK_MARKERHANDLE_H