OSGVIEWER(1)

💖 osgviewer(1) — 3D viewer for multiple file formats 💖

okay bestie, welcome to the osgviewer manual page, straight out of User Commands territory. this is the OpenSceneGraph viewer, and it's about to be your new main character. it opens 3D stuff. lots of 3D stuff. many formats. one icon. ✨

✨ NAME ✨

osgviewer — 3D viewer for multiple file formats.

like. it views 3D. multiple file formats. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

osgviewer [options] filename ...

you give it some options if you're feeling fancy, and then one or more *filename*s, and it does the thing. periodt.

👑 OPTIONS 👑

so here's the whole menu, no skips, no skimming, we are doing this properly 💅

• --COMPUTE_NEAR_FAR_MODE <mode> — pick how the viewer figures out near and far planes. your choices are DO_NOT_COMPUTE_NEAR_FAR, COMPUTE_NEAR_FAR_USING_BOUNDING_VOLUMES, or COMPUTE_NEAR_FAR_USING_PRIMITIVES.
• --CullDrawThreadPerContext — selects the CullDrawThreadPerContext threading model for the viewer. that's the model's name, take it or leave it 🧚
• --CullThreadPerCameraDrawThreadPerContext — selects the CullThreadPerCameraDrawThreadPerContext threading model for the viewer. yes it's a long one. it ate. 👑
• --DrawThreadPerContext — selects the DrawThreadPerContext threading model for the viewer.
• --NEAR_FAR_RATIO <float> — sets the ratio between the near and far planes. it must be greater than 0.0 but less than 1.0. that's a hard rule, not a suggestion. 🚨
• --SingleThreaded — selects the SingleThreaded threading model for the viewer. one thread, one dream.
• --accum-rgb — request a rgb accumulator buffer visual.
• --accum-rgba — request a rgb accumulator buffer visual. (yes, it says rgb here too, not rgba — that's literally what the page says, bestie, i'm not fixing it 💀)
• --borderless-window <x y w h> — set the position (x,y) and size (w,h) of a borderless viewer window. borderless = no chrome = pure vibes.
• --cc — request use of compile contexts and threads.
• --clear-color <color> — set the background color of the viewer, in the form "r,g,b[,a]".
• --dem <filename> — load an image/DEM and render it on a HeightField.
• --device <device-name> — add a named device to the viewer.
• --display <type> — one of MONITOR, POWERWALL, REALITY_CENTER, or HEAD_MOUNTED_DISPLAY.
• --enable-object-cache — enable caching of objects, images, etc.
• --gl-flags <mask> — set the hint of which GL flags projfile mask to use when creating graphics contexts.
• --gl-profile-mask <mask> — set the hint of which GL context profile mask to use when creating graphics contexts.
• --gl-version <major.minor> — set the hint of which GL version to use when creating graphics contexts.
• --help-all — display all command line, env vars and keyboard & mouse bindings. the whole lore drop 📚
• --help-env — display environmental variables available.
• --help-keys — display keyboard & mouse bindings available.
• --image <filename> — load an image and render it on a quad.
• --implicit-buffer-attachment-render-mask — OFF | DEFAULT | [~]COLOR | [~]DEPTH | [~]STENCIL. substitutes missing buffer attachments for the render FBO.
• --implicit-buffer-attachment-resolve-mask — OFF | DEFAULT | [~]COLOR | [~]DEPTH | [~]STENCIL. substitutes missing buffer attachments for the resolve FBO.
• --keystone <filename> — specify a keystone file to be used by the viewer for keystone correction.
• --keystone-off — set the keystone hint to false.
• --keystone-on — set the keystone hint to true to tell the viewer to do keystone correction.
• --login <url> <username> <password> — provide authentication information for http file access. three whole arguments, no cap 🔐
• --menubar-behavior <behavior> — set the menubar behavior, one of AUTO_HIDE, FORCE_HIDE, or FORCE_SHOW.
• --rgba — request a RGBA color buffer visual.
• --run-continuous — set the run method's frame rate management to rendering frames continuously. go go go 🔥
• --run-max-frame-rate — set the run method's maximum permissible frame rate. 0.0 is the default, and it switches frame rate capping off.
• --run-on-demand — set the run method's frame rate management to only rendering frames when required. chill mode 🌸
• --samples <num> — request a multisample visual.
• --screen <num> — set the screen to use when multiple screens are present.
• --serialize-draw <mode> — OFF | ON — set the serialization of draw dispatch.
• --speed <factor> — speed factor for animation playing (1 == normal speed).
• --stats — print out load and compile timing stats.
• --stencil — request a stencil buffer visual.
• --stereo — use the default stereo mode, which is ANAGLYPHIC if it isn't overridden by an environmental variable.
• --stereo <mode> — pick your stereo mode: ANAGLYPHIC | QUAD_BUFFER | HORIZONTAL_SPLIT | VERTICAL_SPLIT | LEFT_EYE | RIGHT_EYE | HORIZONTAL_INTERLACE | VERTICAL_INTERLACE | CHECKERBOARD | ON | OFF. the way there are so many options… obsessed 😭
• --swap-method <method> — DEFAULT | EXCHANGE | COPY | UNDEFINED. select the preferred swap method.
• --sync — enable sync of swap buffers.
• --window <x y w h> — set the position (x,y) and size (w,h) of the viewer window.
• -O <option_string> — provide an option string to reader/writers used to load databases.
• -e <extension> — load the plugin associated with handling files with the specified extension.
• -h or --help — display command line parameters.
• -l <library> — load the plugin.
• -p <filename> — play the specified camera path animation file, previously saved with the 'z' key.

and that's the whole page, start to finish, nothing left behind 🫶

little reminder: this page is from OpenSceneGraph, dated September 2019. keep it close, bestie, it's iconic. 💜

✨ go view some 3D, you absolute legend ✨