NAME

       ctmviewer - 3D viewer for models of various file formats

SYNOPSIS

       ctmviewer [modelfile [texturefile]]

DESCRIPTION

       ctmviewer is a 3D file viewer that can load, show and save 3D model files in several different formats.

       The  program displays an interactive 3D view of the model, which can be operated with the mouse (e.g. for
       rotating and zooming).

       If the selected model file contains texture coordinate information, it is possible to  specify  which  2D
       image  file  to  use  as  a texture with the additional texturefile argument. If no texture file is given
       (either by the 3D model file, or by the texturefile argument), a standard 2D grid is used as a texture.

GUI OPERATIONS

       In addition to the command line arguments, ctmviewer offers several operations that can be performed from
       the 3D GUI display. For help, press the F1 key.

   Loading and Saving
       It  is possible to load and save 3D model files from the program by either using the buttons in the upper
       left corner of the 3D display, or by using the keyboard shortcuts CTRL+O (open) and CTRL+S (save).

       It is also possible to load a texture file from the program by using the Open Texture button.

   Rendering
       To toggle between a normal filled surface view (default) and a wire frame view, press the 'w' key.

   Camera Control
       By holding down the left mouse button and moving the mouse, the camera is rotated around the 3D model.

       By holding down the right mouse button and moving the mouse, the camera will pan left/right and up/down.

       By holding down the middle mouse button and moving the mouse, the camera will zoom in and out. It is also
       possible to use the mouse wheel (not supported on all systems) or the +/- keys to zoom in and out.

       Double click the left mouse button on a point on the model to focus the camera on that point.

       Press the 'f' key to fit the model into the screen view (re-center and re-zoom).

       Press  the  'y'  key  to  change the camera up direction to the Y axis (may be necessary if the model was
       designed in or for an environment where the Y axis is considered the up direction).

       Press the 'z' key to change the camera up direction to the Z axis (default).

FILE FORMATS

       The following 3D model file formats are supported:  OpenCTM  (.ctm),  Stanford  triangle  format  (.ply),
       Stereolitography  (.stl),  3D  Studio  (.3ds),  COLLADA  1.4/1.5  (.dae), Wavefront geometry file (.obj),
       LightWave object (.lwo), Geomview object file format (.off), VRML 2.0 - export only (.wrl).

       The following 2D image file formats are supported (texture): JPEG (.jpg), PNG (.png).

AVAILABILITY

       ctmviewer is designed to be portable, and is available for several different systems, including (but  not
       limited to): Windows, Mac OS X (10.3+), Linux and OpenSolaris.

       ctmviewer  uses  OpenGL  for  its  accelerated  3D  display.  When the OpenGL implementation supports it,
       ctmviewer will use per pixel Phong shading for improved visual appearance. Otherwise ctmviewer will  fall
       back to classic per vertex shading.

SEE ALSO

       ctmconv(1)

                                                                                                    ctmviewer(1)