Panda Manual > Files
FilesPanda 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.
| Format | What it's for | How |
.pan | Your work: everything Panda knows, texture included. | Open, Save, Save As |
.bb3d | BambooBasic's mesh file, for
b2dLoadMesh. Animation as frames. | Import, Export As |
.glb / .gltf | glTF, the common 3D format: Blender, online model sites, game engines. | Import (both), Export As (.glb) |
.bam | BambooBasic code: the model as an include file. See BambooBasic Code Export. | Export As |
New Ctrl+N | An empty model. |
Open... Ctrl+O | Opens a .pan. |
Save Ctrl+S | Saves 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+S | Saves 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.
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.
.bb3d. If it isn't
there, the status bar says so..bb3d has no groups or joints, so the model comes in as one group,
Model..gltf.
Panda keeps one texture per model, so a model with several textures comes in with just one.| Keep the Skeleton | The 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 Frames | The 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. |
| Cancel | Nothing is imported. |
Only the file's first skeleton is used.
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 name | The 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 in | The folder - type it, or Browse. It starts in the last export's folder (or the model's). |
| BambooBasic code | Only 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.)
.bb3d: if it's already in the
export folder its name is used, otherwise Panda writes <model name>.png there..bb3d has no joints..pan for those).Colour 1, Colour 2 ...). Quads are split into two triangles, as glTF has no
quads.Animation, at 12
frames a second.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.)
.glb, and in Blender use File > Import >
glTF 2.0. A skeleton comes in as an armature with its bones and actions; pose frames as shape
keys with actions. The model faces Blender's front view..glb, then Import it in Panda. Blender writes its animation at its own frame rate (24 a
second unless you change it) and lists animations in alphabetical order, so the clips come back that
way - the movement is the same..pan opens, anything else is
imported../Panda yourmodel.pan on a command line (or dropping a file on
Panda) opens it straight away.| "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. |