feat(app): multicam panel with live angle grid, switching, timeline enable

- New MulticamPanel: rows/cols angle grid with the current angle highlighted, click-to-switch, 1-9 switch-and-split and cmd-1-9 switch-only shortcuts (focused-panel routed), deferred switch queue during playback. - src/oakui/multicam.rs: clip->connected-sequence resolution, multicam state detection (selection then playhead fallbacks), per-angle frame requests rendered through the process backend into an LRU cache. - Timeline clip context menu Multi-Cam checkable item wired to oaktimeline::multicam enable/disable with undo. - Engine trait extended (real + mock); mock drives the real command path with synthesized angle frames.
2026-08-18 21:40:00 +08:00
parent cad1d93544
commit cf459d7e4c
132 changed files with 2276 additions and 422 deletions
@@ -0,0 +1,84 @@
+/***
+
+  Oak Video Editor - 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_EDITOR_RENDER_COPIER_H
+#define OAK_EDITOR_RENDER_COPIER_H
+
+#include "node/node.h"
+#include "node/project.h"
+#include "render/error.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Reference-counted handle to a project copier
+ *        (olive::ProjectCopier): deep-copies a project graph for
+ *        background processing (export/precache).
+ *
+ * By-value handle (shared_ptr semantics, see oakcommon's
+ * common/handle.h): oakrender_project_copier_create() returns a handle
+ * with reference count 1; release it with
+ * oakrender_project_copier_free().
+ */
+typedef struct OakRenderProjectCopier {
+	void *ctx; /**< Opaque pointer to the reference-counted object. */
+	void (*addref)(void *ctx); /**< Atomically increments the count. */
+	void (*release)(void *ctx); /**< Decrements the count, destroys at 0. */
+	uint32_t abi_version; /**< OAKRENDER_ABI_VERSION. */
+} OakRenderProjectCopier;
+
+/**
+ * @brief Create a copier. The copy is built by
+ *        oakrender_project_copier_set_project().
+ *
+ * @return Copier handle with reference count 1; ctx is NULL on
+ *         allocation failure.
+ */
+OakRenderProjectCopier oakrender_project_copier_create(void);
+
+/**
+ * @brief Release one reference to a copier; the final release frees the
+ * copier AND its copied project. NULL / empty-handle no-op; clears
+ * copier->ctx after releasing.
+ */
+void oakrender_project_copier_free(OakRenderProjectCopier *copier);
+
+/** @brief (Re)build the copy from `project` (borrowed handle). */
+int oakrender_project_copier_set_project(OakRenderProjectCopier copier,
+										 OakNodeProject project);
+
+/** @brief The copied counterpart of an original node (borrowed handle;
+ *        freeing it only releases the handle box), empty handle when the
+ *        node is not in the copied project. */
+OakNodeNode oakrender_project_copier_get_copy(
+	OakRenderProjectCopier copier, OakNodeNode original);
+
+/** @brief The copied project (borrowed handle; freeing it only releases
+ *        the handle box). */
+OakNodeProject oakrender_project_copier_get_copied_project(
+	OakRenderProjectCopier copier);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif //OAK_EDITOR_RENDER_COPIER_H