Panda Manual > Files

Files

Panda keeps your work in its own .pan files, brings models in with Import, and writes the files your program (or another 3D program) uses with Export As. Keep the .pan as your master copy and export from it whenever it changes.


The formats at a glance
FormatWhat it's forHow
.panYour work: everything Panda knows, texture included.Open, Save, Save As
.bb3dBambooBasic's mesh file, for b2dLoadMesh. Animation as frames.Import, Export As
.glb / .gltfglTF, the common 3D format: Blender, online model sites, game engines.Import (both), Export As (.glb)
.bamBambooBasic code: the model as an include file. See BambooBasic Code Export.Export As

New, Open, Save: .pan files
New Ctrl+NAn empty model.
Open... Ctrl+OOpens a .pan.
Save Ctrl+SSaves to the .pan you opened. A model that hasn't been saved as a .pan yet (a new or imported one) asks for a name, as Save As.
Save As... Ctrl+Shift+SSaves under a new name. .pan is added if you leave it off.

A .pan keeps everything, exactly: every frame, all the faces with their corners, texture coordinates, colours and groups, the colour list, the group names (and which are hidden), the clips, the skeleton with its keys and which vertex follows which joint - and the texture itself, inside the file. One .pan is the whole model; you can move it anywhere without its picture. It's compressed, so it's small.

A model with a skeleton always opens in the rest pose (Animate off). A .pan made by a newer Panda than yours won't open - get the latest BambooBasic.


Import: .bb3d and .glb

File > Import (Ctrl+Shift+I) brings in a .bb3d, .glb or .gltf. The imported model is a new, unsaved model: the title shows (from duck.glb), and Save asks for a .pan name - Panda never writes over the file you imported. The status bar (and, for notes, a message box) says what came in.

A .bb3d A .glb or .gltf
Keep the SkeletonThe joints come in, and each animation becomes a clip with a key on every frame, so you can go on animating it in Panda. Panda gives each vertex one joint (the one that moved it most), so where the original shared a vertex between joints, elbows and knees bend a little more stiffly. Any morph targets are left out.
Bake into FramesThe animation exactly as it was (worked out the same way as the IDE's Mesh Converter), as pose frames, without the skeleton. Choose this for soft, squashy models, or when you just want to use the animation, not change it.
CancelNothing is imported.

Only the file's first skeleton is used.


Export As

File > Export As... (Ctrl+E) opens the Export As window:

Format.bb3d, .glb or .bam (BambooBasic code). It starts on the one you used last.
Model nameThe file name (without the ending). Characters a file name can't have become _. For code, it's also how every name in the code starts. The line underneath shows the exact file name.
Save inThe folder - type it, or Browse. It starts in the last export's folder (or the model's).
BambooBasic codeOnly for .bam: Animation, Default Model Controls and Data. See BambooBasic Code Export.

Click Export. If the file is already there, Panda asks before replacing it. The status bar says what was written, with any notes.

Export Again (Ctrl+Shift+E) writes the same file again with the same choices - the menu shows its name. Change the model, Export Again, run your program: that's the everyday round trip. (Export choices are remembered until you close Panda.)


What goes into a .bb3d
What goes into a .glb
Facing the same way everywhere

Panda and BambooBasic use left-handed directions: X right, Y up, Z away, with a model facing -Z, towards the Front view and the camera. glTF (Blender and the rest) is right-handed, with a model's front facing +Z. Panda converts between them whenever a .glb comes in or goes out - so a model faces front in Panda, in your BambooBasic program, and in Blender. You don't have to do anything. (The IDE's Mesh Converter does the same.)


Panda and Blender
Recent files, dropping files, unsaved changes
When something goes wrong
"This isn't a Panda model (.pan) file."The file isn't a .pan (or it's been renamed). Use Import for .bb3d and .glb.
"This .pan was made by a newer Panda."Update BambooBasic.
"The file is damaged ..."The file is cut short or corrupted; try a backup.
"Can't write the file (is it open somewhere else, or read-only?)."Close the file in other programs, or save somewhere else.
"The file has no triangle meshes in it."The .glb holds no model (only a camera or lights, say), or only lines and points.
"Texture ... wasn't found next to it."Put the .bb3d's picture next to it, or load a texture on the Materials tab.

< Joints   |   Contents   |   BambooBasic Code Export >