# taclab/to-po-iesis architecture

> Architecture diagram of the GitHub repository taclab/to-po-iesis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/taclab/to-po-iesis
- Repository: https://github.com/taclab/to-po-iesis

## Overview

##### Project type and purpose
- This is a client-side interactive artwork built in ActionScript 3, delivered as Flash SWF files and embedded in HTML.
- Its goal is to let users manipulate text and maps with animated transitions and audio, using mouse input to drive poetic/cartographic interactions.

##### File structure
- Top-level directories:
- assets/ – multimedia (audio, video, PDF) and screenshots
- build/ – compiled SWFs, HTML wrappers, MP3s and background images
- src/ – ActionScript 3 source code
- In src/:
- gs/ – the GreenSock Tweening Engine (TweenLite, TweenMax, easing classes, plugins, utils)
- net/carto/ – custom modules for map masks and text effects (PuzzleCarte.as, poetryTextField.as, etc.)
- build/index.html & build/topoiesis.html use swfobject.js to embed the SWF
- No server or backend components — everything runs in the browser’s Flash Player.

##### README
- Confirms use of animations, map masking, sound playback, and mouse-driven text manipulation.
- Credits and publication details; no mention of additional services or data sources.

##### Detail but not overthinking
- Every essential architectural element: user events, code modules, runtime, assets.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User and Browser
    User["User"]:::actor
    Browser["Web Browser"]:::runtime
    User --> Browser

    %% Embedding Layer
    subgraph "Embedding Layer" 
        direction TB
        HTML1["build/index.html"]:::embed
        HTML2["build/topoiesis.html"]:::embed
        SwfObj["swfobject.js"]:::third
    end
    Browser --> HTML1
    Browser --> HTML2
    HTML1 --> SwfObj
    HTML2 --> SwfObj

    %% Flash Runtime and SWFs
    Flash["Flash Player Runtime"]:::runtime
    subgraph "SWF Files"
        direction TB
        Preloader["Preloader.swf"]:::runtime
        CoreSWF["RC6.swf"]:::runtime
    end
    SwfObj --> Flash
    Flash --> Preloader
    Preloader --> CoreSWF

    %% Code Modules
    subgraph "Code Modules"
        direction TB
        subgraph "GreenSock Core Modules" 
            direction TB
            TL["TweenLite.as"]:::third
            TM["TweenMax.as"]:::third
            OM["OverwriteManager.as"]:::third
            TG["TweenGroup.as"]:::third
        end
        subgraph "GreenSock Easing Functions"
            direction TB
            Easing["src/gs/easing/*.as"]:::third
        end
        subgraph "GreenSock Plugins & Events"
            direction TB
            Plugins["src/gs/plugins & events/*.as"]:::third
        end
        subgraph "GreenSock Utility Tween Classes"
            direction TB
            Utils["src/gs/utils/tween/*.as"]:::third
        end
        subgraph "Custom net.carto Modules"
            direction TB
            Puzzle["PuzzleCarte.as"]:::custom
            Poetry["poetryTextField.as"]:::custom
            Letters["TextFieldLetters.as"]:::custom
            TweenL["TweenLetters.as"]:::custom
            MouseTL["TweenLettersMouse.as"]:::custom
            SonBande["SonBande.as"]:::custom
        end
    end
    CoreSWF --> TL
    CoreSWF --> TM
    CoreSWF --> OM
    CoreSWF --> TG
    CoreSWF --> Easing
    CoreSWF --> Plugins
    CoreSWF --> Utils
    CoreSWF --> Puzzle
    CoreSWF --> Poetry
    CoreSWF --> Letters
    CoreSWF --> TweenL
    CoreSWF --> MouseTL
    CoreSWF --> SonBande

    %% Assets & Media
    subgraph "Assets & Media"
        direction TB
        RawAssets["assets/"]:::asset
        BuildAudio["build/*.mp3 & build/img/"]:::asset
    end
    Preloader --> RawAssets
    Preloader --> BuildAudio

    %% Event and Animation Flow
    User -->|mouse events| CoreSWF
    CoreSWF -->|load assets| RawAssets
    CoreSWF -->|play audio| BuildAudio
    CoreSWF -->|dispatch events| Puzzle
    Puzzle -->|calls Tween APIs| TL
    Puzzle -->|calls Tween APIs| TM
    Poetry -->|calls Tween APIs| TL
    Letters -->|calls Tween APIs| TM
    TweenL -->|calls Tween APIs| TG
    MouseTL -->|calls Tween APIs| OM
    SonBande -->|dispatch sound| BuildAudio
    TL -->|animates| CoreSWF
    TM -->|animates| CoreSWF

    CoreSWF -->|renders| User

    %% Click Events
    click HTML1 "https://github.com/taclab/to-po-iesis/blob/main/build/index.html"
    click HTML2 "https://github.com/taclab/to-po-iesis/blob/main/build/topoiesis.html"
    click SwfObj "https://github.com/taclab/to-po-iesis/blob/main/build/js/swfobject.js"
    click Preloader "https://github.com/taclab/to-po-iesis/blob/main/build/Preloader.swf"
    click CoreSWF "https://github.com/taclab/to-po-iesis/blob/main/build/RC6.swf"
    click TL "https://github.com/taclab/to-po-iesis/blob/main/src/gs/TweenLite.as"
    click TM "https://github.com/taclab/to-po-iesis/blob/main/src/gs/TweenMax.as"
    click OM "https://github.com/taclab/to-po-iesis/blob/main/src/gs/OverwriteManager.as"
    click TG "https://github.com/taclab/to-po-iesis/blob/main/src/gs/TweenGroup.as"
    click Easing "https://github.com/taclab/to-po-iesis/tree/main/src/gs/easing"
    click Plugins "https://github.com/taclab/to-po-iesis/tree/main/src/gs/plugins"
    click Utils "https://github.com/taclab/to-po-iesis/tree/main/src/gs/utils/tween"
    click Puzzle "https://github.com/taclab/to-po-iesis/blob/main/src/net/carto/PuzzleCarte.as"
    click Poetry "https://github.com/taclab/to-po-iesis/blob/main/src/net/carto/poetryTextField.as"
    click Letters "https://github.com/taclab/to-po-iesis/blob/main/src/net/carto/TextFieldLetters.as"
    click TweenL "https://github.com/taclab/to-po-iesis/blob/main/src/net/carto/TweenLetters.as"
    click MouseTL "https://github.com/taclab/to-po-iesis/blob/main/src/net/carto/TweenLettersMouse.as"
    click SonBande "https://github.com/taclab/to-po-iesis/blob/main/src/net/carto/SonBande.as"
    click RawAssets "https://github.com/taclab/to-po-iesis/tree/main/assets/"

    %% Styles
    classDef actor fill:#white,stroke:#000,stroke-width:1px
    classDef runtime fill:#ddd,stroke:#555,stroke-width:1px
    classDef embed fill:#bbb,stroke:#444,stroke-width:1px
    classDef third fill:#9ad0f5,stroke:#036,stroke-width:1px
    classDef custom fill:#b5e7a0,stroke:#2d582d,stroke-width:1px
    classDef asset fill:#f5c27a,stroke:#a64d00,stroke-width:1px
```
