V2.0.0

include/tahgibu/frame.h

@@ -0,0 +1,36 @@
+/* Fotogramas. Todas las operaciones que modifican se pueden deshacer y
+ * fallan con TGB_ERR_STATE si hay una sesión de edición abierta. */
+#ifndef TAHGIBU_FRAME_H
+#define TAHGIBU_FRAME_H
+
+#include "tahgibu/document.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+size_t tgb_frame_count(const tgb_document *doc);
+uint32_t tgb_frame_id(const tgb_document *doc, size_t index);          /* 0 si fuera de rango */
+tgb_status tgb_frame_index_of(const tgb_document *doc, uint32_t id, size_t *out_index);
+uint32_t tgb_frame_duration_ms(const tgb_document *doc, size_t index);
+
+/* index == count añade al final. Devuelve el id del nuevo fotograma. */
+tgb_status tgb_frame_add(tgb_document *doc, size_t index, uint32_t *out_id);
+/* Duplica y coloca la copia justo después (comparte memoria hasta editarla). */
+tgb_status tgb_frame_duplicate(tgb_document *doc, size_t index, uint32_t *out_id);
+tgb_status tgb_frame_delete(tgb_document *doc, size_t index);          /* nunca el último */
+tgb_status tgb_frame_move(tgb_document *doc, size_t from, size_t to);
+tgb_status tgb_frame_set_duration(tgb_document *doc, size_t index, uint32_t ms);
+
+/* Portapapeles de fotogramas (vive en el contexto). Pegar exige mismas
+ * dimensiones; las capas se emparejan por posición (las sobrantes se ignoran). */
+tgb_status tgb_frame_copy(tgb_document *doc, size_t index);
+tgb_status tgb_frame_paste(tgb_document *doc, size_t index, uint32_t *out_id);
+
+/* Celda de un fotograma/capa. NULL = celda vacía (transparente). Solo lectura. */
+const tgb_canvas *tgb_frame_cel(const tgb_document *doc, size_t frame_index, size_t layer_index);
+
+#ifdef __cplusplus
+}
+#endif
+#endif