← Script Dock & Advanced Scripting  ·  Contents  ·  Modular Activation & Master Controls →

The Library dock is the nerve center for managing your creations. The library system allows you to organize your work into four main tabs, each designed to store a specific type of file. Understanding what is encapsulated in each category is crucial for organizing your presets in a modular way.

Saving a Surface captures the mathematical definition and the base visual style of your 3D/4D object. It is ideal for storing pure geometry without linking it to a specific animation or texture.

• What it saves: The essential geometric elements such as parametric and implicit equations, custom GLSL surface scripts, explicit constraints (U, V, W), mathematical constants (A-F, S), U/V/W limits, grid resolution (Steps), 4D rotation state, and lighting configuration. It also stores the visual style of the object: the base surface color, its transparency, the render mode (Base/Phong/Wireframe) with the wireframe line density, and the framing — the 3D camera position and orientation, the projection mode and the field of view.
• Multi-mesh surfaces: When a script builds several meshes (//MESH_BEGIN), the per-mesh appearance you set with the Mesh selector in the Renderer dock is saved as well: color, transparency, light intensity, render mode and wireframe density, part by part. The parametric domain of a grid is saved too, whenever you set it from the u_a/u_b/v_a/v_b fields — and so is the separate domain of the All scope, which is stored on its own so that both levels come back as you left them. Only the parts you actually customized are written; a part left inheriting the global style — or the domain declared by its //MESH_BEGIN section — stays that way on reload, together with the All/Mesh scope active when you saved.
• What it ignores: Textures, the background (both its color and any background texture), 3D/4D paths, and animation speeds. A Surface always loads over the default dark gray background; to store a scene complete with textures and background, save a Record instead.

Saving a Texture isolates the visual pattern or image. It can be applied interchangeably to the object's surface or the background.

• What it saves: The GLSL texture scripts or the absolute path of the loaded image, the two active colors in the interface (Color 1 and Color 2), and 2D transformations applied via mouse or 2D View (Zoom, Pan X/Y, Rotation).
• What it ignores: The 3D geometry it is mapped onto. You can safely load a saved texture onto any new surface.

The Sounds tab stores audio configurations, which can be procedural mathematical synths or based on external files.

• What it saves: Purely procedural audio scripts (using the //SYNTH: directive) or absolute paths to local audio files (//MUSIC: directive).
• How to use it: By right-clicking a sound in the tree and selecting "Add to Current Script" (or simply by single-clicking the item), the audio directive will be automatically injected into the active script, seamlessly merging the sound with your graphics.

A Record save is an absolute and complete snapshot of your entire workspace. It is the most powerful format, designed for animations and final renders.

• What it saves: Absolutely everything. The surface geometry in a complete composite form, customized colors, applied textures (both surface and background), active sounds, all mathematical constants, 4D lighting configuration, 3D/4D path tracking data, and all continuous rotation speeds (Spin, Nutation, Precession, Omega, Phi, Psi).
• Camera and Observer: It perfectly immortalizes the exact position of the 3D camera (the zoom and orbital rotation you set with the mouse) and the distance of the 4D Observer (P+/P-). When you reopen a Record, the framing and audio will resume exactly as you left them, while the animation restarts from the beginning.

• Smart Saving: By clicking the Save button in the Script dock, the program will automatically understand whether you are working on a Surface, a Texture, or a Sound based on the "Mode" button, and will prompt you with the correct format.
• Context Menu: By right-clicking in an empty spot within the Library tree, you can use "Save ... Here" to save a new file directly into that specific folder. You can also create folders, copy, cut, paste, and delete items directly from the interface via the context menu.
• Drag & Drop: You can drag files and folders between the various branches to reorganize your collection; the file system will physically update in real-time.

The application includes a built-in library of presets to help you get started. To ensure the software remains lightweight and fast to download, the media files within these presets are carefully managed:

• Textures: The included texture presets consist primarily of procedural JSON scripts. While standard image files are perfectly supported and included, their number is strictly limited to avoid bloating the application's overall file size.
• Sounds: Similarly, sound presets rely mostly on procedural audio scripts. A select few standard audio files (such as .wav) are included, but they are also kept to a minimum to conserve space and maintain high performance.

← Script Dock & Advanced Scripting  ·  Contents  ·  Modular Activation & Master Controls →