R7: pure C ABI display boundary + engine visibility closure

R7-A (Qwen 3.8 Max): oakengine/display.h rewritten to the POD contract from r7-pure-abi-plan.md - oak_video_params everywhere, opaque texture/frame handles with retain/free protocol (engine-heap control blocks), OakSharedBuffer refcounted wrapper for the QVariant playback path. All TexturePtr/FramePtr gone from app (47 sites). R7-B (Qwen 3.8 Max): liboakengine.so exports 3486 -> 19 C++ symbols (version script oakengine.ver: oakengine_* plus the documented oakgl/oakvulkan dlopen plugin ABI). oakengine-obj OBJECT library feeds both the shared lib and the test binaries (-rdynamic so dlopen'd backends resolve engine objects). Fix (Kimi K3): producer/consumer type mismatch - viewerdisplay unpacks OakSharedBufferPtr but viewer.cpp pushed raw void* handles, so no frame ever reached the display widget (all 5 vulkan viewer tests timed out with 'never received a texture'). Producers now wrap with oak_make_shared_frame / oak_make_shared_texture(retain). Verified: build 0 errors, ctest 45/45, nm U _ZN5olive = 0 in oak-editor/oak-render-worker/oak-cli, 19 exported C++ symbols in liboakengine.so (all documented plugin ABI).
2026-07-27 00:54:46 +08:00
parent 9b25772267
commit eb634b53ef
33 changed files with 1692 additions and 668 deletions
@@ -0,0 +1,71 @@
+/***
+
+  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_DISPLAYBUFFER_H
+#define OAK_DISPLAYBUFFER_H
+
+#include <memory>
+
+#include <QMetaType>
+#include <QVariant>
+
+#include "oakengine/display.h"
+
+namespace olive
+{
+
+/**
+ * @brief Refcounted wrapper around an opaque display handle (texture or frame).
+ *
+ * Stored inside QVariant for playback queue / set_image() path. The deleter
+ * calls the matching facade free function when the last shared_ptr copy dies.
+ */
+struct OakSharedBuffer {
+	void *handle = nullptr;
+	enum Type { k_texture, k_frame } type = k_frame;
+};
+
+using OakSharedBufferPtr = std::shared_ptr<OakSharedBuffer>;
+
+inline OakSharedBufferPtr oak_make_shared_texture(void *handle)
+{
+	return std::shared_ptr<OakSharedBuffer>(
+		new OakSharedBuffer{handle, OakSharedBuffer::k_texture},
+		[](OakSharedBuffer *b) {
+			oakengine_display_texture_free(b->handle);
+			delete b;
+		});
+}
+
+inline OakSharedBufferPtr oak_make_shared_frame(void *handle)
+{
+	return std::shared_ptr<OakSharedBuffer>(
+		new OakSharedBuffer{handle, OakSharedBuffer::k_frame},
+		[](OakSharedBuffer *b) {
+			oakengine_codec_frame_free(b->handle);
+			delete b;
+		});
+}
+
+} // namespace olive
+
+Q_DECLARE_METATYPE(olive::OakSharedBufferPtr)
+
+#endif // OAK_DISPLAYBUFFER_H