CASTLE-MODEL-VIEWER(1)

📦 version 5.2.0, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

okay bestie, welcome to the castle-model-viewer manual page 💖 it's a viewer for 3D and 2D models — think glTF, X3D, VRML and more. she does it all, no cap.

🌸 SYNOPSIS 🌸

castle-model-viewer [OPTION]... [FILE]

like, that's the whole vibe. options, then a file. iconic.

🦋 DESCRIPTION 🦋

castle-model-viewer is a viewer for 3D and 2D model formats supported by Castle Game Engine: glTF, X3D, VRML, MD3, OBJ, STL, Collada, Spine JSON, sprite sheets and more. so many formats. she's versatile like that 💅

she supports viewing the scene in the "Examine" mode, AND walking around in the virtual world with collision detection and gravity (yes, actual physics, we're not playing games here... well, okay, we kind of are 🎀).

so many 3D graphic effects are available, like mirrors, shadows, shaders. and we can also convert between some model formats, which is giving "two jobs, one girlboss" energy.

full documentation is available online at https://castle-engine.io/castle-model-viewer — go read it, it's the main character of docs fr fr.

💅 OPTIONS 💅

  • -h, --help — print the help message and dip. that's it, that's the whole job.
  • -v, --version — print the version number and exit. she's telling you who she is.
  • -H / --hide-extras — do NOT show anything extra (like status text, or toolbar, or bounding box) when the program starts. show only the loaded model. clean face, no makeup, still stunning ✨
  • --screenshot TIME IMAGE-FILE-NAME — take a screenshot of the loaded scene at the given TIME, and save it to IMAGE-FILE-NAME. you most definitely want to also pass a 3D model file at the command line, otherwise we'll just be making a screenshot of the default black scene. and like... a black rectangle is not the vibe 🖤
  • --screenshot-range TIME-BEGIN TIME-STEP FRAMES-COUNT FILE-NAME — take a FRAMES-COUNT number of screenshots, starting at TIME-BEGIN and stepping by TIME-STEP. save them all to a single movie file (like .avi) — and for that, ffmpeg must be installed and available on $PATH — or save them to a sequence of image files, in which case FILE-NAME must be specified like image@counter(4).png. it's giving cinematic 🔥
  • --viewpoint NAME — use the viewpoint with the given name or index as the initial one. especially useful for making a screenshot from a given viewpoint. angles matter, bestie 📸
  • (the flag line for this one literally got eaten by the manual, so I'm not out here inventing a name, okay) — use full-screen anti-aliasing. Argument AMOUNT is an integer >= 0. exact 0 means "no anti-aliasing", and that is the default. each successive integer generally makes the method one step better. especially useful to make a screenshot with anti-aliasing quality. smooth edges, smooth skin, same energy 💖
  • --audio-device DEVICE-NAME — choose a specific OpenAL audio device. you can see the available device names in the --help output, or in the "Preferences → Sound Device" menu. pick your fave 🎧
  • --no-sound — turn off sound. silence. a moment of peace. 🤫

🎀 WINDOW OPTIONS 🎀

  • --geometry WIDTHxHEIGHT<sign>XOFF<sign>YOFF — set the initial window size and/or position. you decide where she stands and how big she is 👑
  • --fullscreen — set the initial window size to cover the whole screen. take up ALL the space. main character behavior only 💅
  • --fullscreen-custom WIDTHxHEIGHT — try to resize the screen to WIDTHxHEIGHT, and then set the initial window size to cover the whole screen. custom, but make it fullscreen ✨
  • --display DISPLAY-NAME — use the given X display name. for the multi-display girlies 🖥️

🌈 RESOURCES 🌈

🫶 SEE ALSO 🫶

her sister. they're a duo, iykyk 💜

⭐ AUTHOR ⭐

Michalis Kamburelis — the legend herself. we stan 🥹

and that's the whole page, bestie! go load up a model and slay 💖

castle-model-viewer — version dated 2024-05-15. okay bye, love you, drink water 🌸🦋🎀

📦 where this page comes from