The file library

The shelf every studio reads from and writes to, and the rules that decide what can be dropped where.

The File Library is the shared shelf. Anything one studio produces can be put there; any studio that understands the type can take it back out. It is reachable from the module rail, from View → File Library, from File → Open Library, and from the command palette.

The file library, empty: the scope toggles, the type filters, the recent column and the drop zone

The header carries the counts, n files · n B used, the two scope toggles, a cloud button, storage info, and Import.

What is in it#

Files are typed, and the type is what decides where they can go:

TypeComes from
Asset, ImageInkwell, Composer, imports
3D Mesh, 3D SceneSculpt, Retopo, Pigment, Render
AnimationAnimator
Particlethe particle editor
MapEngine
AudioPulse
MaterialMatter
Reference Boardthe reference board
Projecta whole exported project

Alongside the type, each file carries a source: Editor, Imported, Engine or Partner: a size, tags, and a sync status when cloud save is on.

Finding things#

  • Free-text search over names and tags.
  • A row of type icons: all, images, animations, particles, maps, meshes, scenes, audio, projects, references, module files, plus an advanced filter for source, date (today / this week / this month) and extension.
  • Two scope toggles in the header: Project (this project only, or all of them) and All Modules (or only what the studio you are in can open, usually the fastest filter of all).
  • Sorting: newest or oldest first, name A–Z or Z–A, size, or type.
  • Grid or list view.

With cloud save on, Load all cloud files pulls in what is stored remotely but not yet in this browser.

Getting things in#

Drag files onto the library, or use Import. Dropping directly onto a studio works too, and the library tells you in advance whether it will be accepted: Drop to import into Pigment, or Pigment can't receive files here.

When a file could be imported in more than one way: a PNG can be a texture, a stencil, an alpha or a reference, aukimi asks: Import into {module} as….

Getting things out#

Each file lists Can open in and Used in. Open with… sends it to a studio; if no studio understands the type you are told so rather than being given a broken import.

Sending work between studios directly#

The library is one route. The other is a direct send, and it is governed by a matrix of what each studio produces and what each accepts:

StudioProducesAccepts
Sculpthigh-poly meshhigh-poly mesh, retopo mesh, PBR material set
Retopoclean-topology meshhigh-poly mesh, retopo mesh
Pigmenttextured meshany mesh, PBR material set
Render3D sceneany mesh, 3D scene
MatterPBR material set, imageimage, pixel art, surface capture
Inkwellimage, surface captureimage, pixel art
Pixel Editorpixel artpixel art, image
Vectravector art, Vectra objectsvector art, image
Composercomposition, imagepixel art, vector art, image
Animatoranimation, 2D rigVectra objects, pixel art, image, any mesh, 2D rig
Fusionvideo projectimage, animation
Pulseaudio projectaudio project
Engine2D rigany mesh, 3D scene, pixel art, animation, PBR material set, 2D rig, video project, image, vector art, Vectra objects

Two consequences worth knowing:

  • The 3D pipeline is a chain, not a hub: Sculpt → Retopo → Pigment → Render, with Engine able to take a mesh at any stage of it.
  • Vectra → Engine sends structure, not a picture. A screen mock-up arrives as a HUD hierarchy the Engine can lay out and script, not as a flat image.

Base assets#

The library ships with a set of base assets, and files can be marked Verified: their integrity has been checked. A partner integration can sync its own files in; they appear with source Partner.

The clipboard#

Separate from the library, and above it in the rail: a cross-studio clipboard that carries typed content, not just pixels. Copy in one studio, paste in another, and aukimi negotiates the best representation the destination understands, that is what lets a Vectra shape land in Inkwell as vector rather than as a screenshot of itself.