Accede desde la web: freeanimationpower.org/tools/desktop/ — Pagina de descarga de FAP Desktop App.

https://youtu.be/_s8zxOe5YUk?si=NCxp1K3UFqJGM_ZY https://youtu.be/GbQypO28FkA?si=Y6gR7qx-lfghDtrN

Software de animacion 2D profesional — Motor hibrido vector + raster. Construido con C++20 y Qt 6.

Free Animation Power combina animacion cuadro-por-cuadro tradicional (estilo TVPaint) con capacidades vectoriales modernas en una sola aplicacion. Cada trazo puede renderizarse como pixeles (raster), como path vectorial, o como ambos simultaneamente.

flowchart TB
    subgraph UI["UI Layer - Qt 6 Widgets"]
        direction LR
        MainWindowV2
        CanvasWidgetV2
        TimelinePanelV2
        ToolboxPanelV2
        ColorPanelV2
        LayerPanelV2
        PropertyEditorV2
        OnionSkinPanel
        CanvasSizePanel
        AudioTrackWidget
        VideoTrackWidget
    end

    subgraph AppState["AppState - Central Hub"]
        Document
        ToolState
        AudioEngine
        RulerTool
        TweenEngine
        DeformationEngine
        ThumbnailCache
    end

    subgraph Engine["Engine Layer"]
        subgraph Brush["brush/"]
            BrushEngine
            BrushPreset
            ABRImporter
            PaperTexture
            PencilRetouch
            RulerTool
        end
        subgraph Raster["raster/"]
            RasterEngine
            RasterStroke
            RasterEffect
        end
        subgraph Vector["vector/"]
            VectorEngine
            VectorStroke
            BezierPath
        end
        subgraph Animation["animation/"]
            AudioEngine
            AudioFileDecoder
            VideoDecoder
            TweenEngine
            FrameThumbnailCache
        end
        subgraph Compositing["compositor + deformation"]
            Compositor
            NodeGraph
            DeformationMesh
            DeformationEngine
        end
    end

    subgraph Core["Core Data Model"]
        direction LR
        Document
        Sequence
        Layer
        UndoManager
        ToolState
        Types
    end

    subgraph Platform["Platform Layer"]
        direction LR
        IO["IO: DocumentManager, FileFormat, VideoExport, SVGExport"]
        Win32["Win32: FileAssociation"]
    end

    UI --> AppState
    AppState --> Engine
    Engine --> Core
    Core --> Platform

• RasterLayer — Buffer de pixeles ARGB32 con COW, origen variable, flag hasContent_
• VectorLayer — Coleccion de VectorStroke con BezierPath
• GroupLayer — Compuesto recursivo con blend modes y opacidad
• AudioLayer — Datos de audio (modelo, no subclase de Layer)
• CameraLayer — Transformaciones de camara

flowchart LR
    subgraph DATA["DATA DOMAIN - fuente de verdad"]
        pixelBuffer["pixelBuffer_ (por capa)"]
        strokeBuffer["strokeBuffer_ (stroke actual aislado)"]
    end

    subgraph DISPLAY["DISPLAY DOMAIN - lo que el usuario ve"]
        bgCache["backgroundCache_ (blanco + onion + capas + video)"]
        paintEvent["paintEvent QPainter (cache + stroke + grid + UI)"]
    end

    pixelBuffer -->|"commitStroke()"| bgCache
    strokeBuffer -->|"composite"| pixelBuffer
    bgCache --> paintEvent

• manifest.json — version, canvas, secuencias activas, viewport, markers
• timeline.json — frames, capas, audio, video por secuencia
• audio/track_N.ext — archivos de audio incrustados
• video/track_N.ext — archivos de video incrustados
• layers/S{seq}/frame_{f}/layer_{ll}.png + .json — pixeles + metadata

Caracteristicas: save atomico (.tmp → rename), deduplicacion de pixeles, audio/video embedding, backward compatible con v1/v2/v3 legacy.

Cada documento puede contener multiples secuencias independientes (como tracks en Premiere):

• Sequence 0 (track superior / visual top)
  • frames (mapa sparse: frame → GroupLayer)
  • keyframes [layer][frame]
  • UndoManager (100 entradas, aislado por secuencia)
  • playback state (currentFrame, fps, looping, playing)
  • Work Area (in/out points) + Duration
  • Markers estilo After Effects
  • Line Boil (efecto linea vibrante no destructivo)
• Sequence 1 ...
• Sequence N (track inferior / fondo visual)

Cada secuencia tiene su propia pila undo, FPS, opacidad y bloqueo. Las secuencias se componen en orden (0 = top, N = fondo).

block-beta
    columns 3
    block:left:2
        columns 1
        ToolboxPanelV2
        OnionSkinPanel
    end
    block:center:5
        columns 1
        CanvasWidgetV2
    end
    block:right:2
        columns 1
        LayerPanelV2
        ColorPanelV2
        PropertyEditorV2
        CanvasSizePanel
    end

    space:9
    block:timeline:9
        columns 1
        TimelinePanelV2
    end

    ToolboxPanelV2 --> CanvasWidgetV2
    CanvasWidgetV2 --> TimelinePanelV2

Transport Bar:  [Play] [Stop] [Prev] [Next]  FPS [24]  [+ Track]
Ruler Widget:  ticks de frame + Work Area naranja + markers + playhead
QScrollArea:
  ├── SequenceTrackWidget[]  (nombre, opacidad, lock, celdas, line boil)
  ├── AudioTrackWidget[]     (waveform, mute, volumen, libre movimiento)
  ├── VideoTrackWidget[]     (thumbnails, opacidad, volumen)
  └── Stretch spacer
Horizontal ScrollBar:  scroll sincronizado entre tracks y ruler

Tableta grafica: Wacom, Huion, Xencelabs, XP-Pen. Presion modula tamano y opacidad. Deteccion automatica de borrador.

• 17 herramientas de dibujo con pipeline 4-buffer CPU
• Pinceles con presion, estabilizador, textura de papel, import ABR
• Timeline multi-secuencia con Work Area, marcadores, Line Boil, ocultacion no destructiva (+/-)
• Capas raster + vectoriales + grupo con 12 blend modes
• Audio tracks: import WAV/MP3/FLAC, waveform visual, playback sincronizado
• Video tracks: import MP4/MOV/WebM, thumbnails, cache LRU 50 frames, composicion sobre dibujo
• Onion skinning con frames previos/siguientes y opacidad configurable
• Undo/Redo por secuencia (profundidad 100, comandos compuestos)
• 8 docks desacoplables con tema oscuro (#252830 / #FF4800)
• Formato .fap v2 (ZIP binario, save atomico, audio/video embedding)
• Export: MP4 H.264, MOV QuickTime Alpha, WebM VP9 Alpha, GIF, SVG, PNG sequence
• File association en Windows (.fap registry + icono en EXE)
• 160 tests unitarios, todos pasando

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
.\build\Release\free-animation-power.exe

ctest --test-dir build

• CMake 3.20+
• Qt 6.5+ (Core, Gui, Widgets, Multimedia, Svg)
• FFmpeg (externo, para video/audio decode y export)
• C++20 compiler (MSVC 2022+, GCC 11+, Clang 14+)
• GoogleTest 1.14.0 (FetchContent automatico)

• Informe Tecnico Completo: INFORME_TECNICO_FREE ANIMATION POWER EXE.pdf — Documento completo de arquitectura C++20/Qt 6, pipeline de renderizado, sistema de herramientas y especificaciones tecnicas.

• docs/INFORME_ARQUITECTURA_V1.md — Informe completo de arquitectura (espanol)

• docs/architecture.md — Documento formal de arquitectura (ingles)

• docs/build-instructions.md — Instrucciones de compilacion

• AGENTS.md — Referencia tecnica para agentes AI

• CHANGELOG.md — Historial de versiones

• CONTEXT.md — Glosario de dominio

  https://youtu.be/FoRy9u4NZ0A?si=sCCUlMUCn-oHfqwT https://youtu.be/Xe-5OqXhCVU?si=ctjyuEl5iTDWuYDj https://youtu.be/mkac7WQXX7U?si=ZQMydQTFvAdiN1YY https://youtu.be/4-MJtsg9hvg?si=Iml6FL4e8angHKTM

Eduardo Fierro Duque

• Web: www.fierroduque.com
• LinkedIn: linkedin.com/in/eduardofierroduque

GNU General Public License v3.0 (GPLv3). Ver LICENSE.