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,126 @@
+/***
+
+  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_TASK_PROJECT_H
+#define OAK_EDITOR_TASK_PROJECT_H
+
+#include "codec/encoder.h"
+#include "node/colormanager.h"
+#include "node/footage.h"
+#include "node/node.h"
+#include "node/project.h"
+#include "node/sequence.h"
+#include "task/task.h"
+#include "undo/undocommand.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Project task factories and result accessors (M8 §2.2).
+ */
+
+/** @brief olive::ProjectLoadTask. Empty handle (ctx == NULL) on
+ *        failure. */
+OakTaskTask oaktask_create_project_load(const char *filename);
+
+/** @brief Take the loaded project (ownership transfer). Empty handle
+ *        (ctx == NULL) when the task has not succeeded or the project was
+ *        already taken. */
+OakNodeProject oaktask_load_take_project(OakTaskTask t);
+
+/** @brief olive::ProjectSaveTask. `filename_or_NULL` overrides the
+ *        project's own filename. `project` is borrowed by the task. */
+OakTaskTask oaktask_create_project_save(OakNodeProject project,
+										const char *filename_or_NULL,
+										int use_compression);
+
+/** @brief olive::ProjectImportTask. `folder`/`project` are borrowed by
+ *        the task. */
+OakTaskTask oaktask_create_project_import(OakNodeFolder folder,
+										  OakNodeProject project,
+										  const char *const *urls,
+										  int url_count);
+
+/** @brief Take the import's undo command (ownership transfer). */
+OakUndoCommand oaktask_import_take_command(OakTaskTask t);
+
+int oaktask_import_footage_count(OakTaskTask t);
+
+/** @brief Footage handle at index (addref'd; release with
+ *        handle.release(handle.ctx) - box only, the project owns the
+ *        footage). Empty handle when out of range. */
+OakNodeFootage oaktask_import_footage_at(OakTaskTask t, int index);
+
+int oaktask_import_invalid_count(OakTaskTask t);
+
+/** @brief Invalid filename at index (two-stage). */
+int oaktask_import_invalid_at(OakTaskTask t, int index, char *buf,
+							 int buf_size);
+
+/** @brief olive::LoadOTIOTask. Empty handle (ctx == NULL) on failure. */
+OakTaskTask oaktask_create_project_load_otio(const char *filename);
+
+/** @brief Take the loaded project (ownership transfer). Empty handle
+ *        (ctx == NULL) when the task has not succeeded or the project was
+ *        already taken. */
+OakNodeProject oaktask_load_otio_take_project(OakTaskTask t);
+
+/** @brief olive::SaveOTIOTask. `project` is borrowed by the task. */
+OakTaskTask oaktask_create_project_save_otio(OakNodeProject project,
+											 const char *filename);
+
+/**
+ * @brief OTIO import confirmation callback (facade concern; default
+ *        accepts everything). Return non-zero to accept.
+ */
+typedef int (*oaktask_otio_import_confirm_fn)(
+	const char *const *sequence_names, int count, void *userdata);
+void oaktask_load_otio_set_confirm_cb(oaktask_otio_import_confirm_fn fn,
+									  void *userdata);
+
+/** @brief olive::PreCacheTask. `footage`/`sequence` are borrowed by the
+ *        task. */
+OakTaskTask oaktask_create_precache(OakNodeFootage footage, int index,
+									OakNodeSequence sequence);
+
+/** @brief olive::ExportTask (params POD from codec/encoder.h).
+ *        `viewer`/`color_manager` are borrowed by the task. */
+OakTaskTask oaktask_create_export(OakNodeNode viewer,
+								  OakNodeColorManager color_manager,
+								  const oakcodec_encoding_params *params);
+
+/**
+ * @brief Image-sequence confirmation callback (facade/UI concern;
+ *        olive::ProjectImportTask::set_image_sequence_confirm_callback).
+ *        Return non-zero to treat numbered stills as a sequence.
+ *        Default (no callback): not a sequence.
+ */
+typedef int (*oaktask_image_sequence_confirm_fn)(const char *filename,
+												 void *userdata);
+void oaktask_import_set_image_sequence_confirm_cb(
+	oaktask_image_sequence_confirm_fn fn, void *userdata);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif //OAK_EDITOR_TASK_PROJECT_H