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)