MESHTOOL/OGFVIEWER for IBM OS/2 README, FAQ [201207xx]


0. WHAT IS IT?


OGFVIEWER/MESHTOOL - crossplatform utilities toolkit for viewing, conversion 3d-models of gaming engines X-Ray (GSC S.T.A.L.K.E.R. series) and also MSH (Orion engine v1 MSH - Stalin Subway, Red Veil), Autodesk 3DStudio MAX 3DS (via external LIB3DS.DLL, partially done).

Note that in OGFViewer assumes metric coordinate system. For Orion engine v1 models (which are in centimeters) rescaling is used.

Used engines: WarpMesaGL, IBM OpenGL 1.0, IBM OpenGL 1.1 Gold, Scitech SNAP MGL 6.0 (based on OpenGL 1.5 spec).


1. SYSTEM REQUIREMENTS


* to make OGFVIEWER work in OS/2 v3, copy these OpenGL 1.0 DLLs from here: service.boulder.ibm.com) or Warp4 installation to {root}/OS2/DLL directory of your OS/2 v3 PC:

GLUT.DLL
LIBAUX.DLL
LIBTK.DLL
OPENGL.DLL
RASTER.DLL

OS/2 v3 is incompatibe with any version of IBM OpenGL 1.1 Gold


2. VERSION DIFFERENCES


In base version, object moves over (0:0:0). In alternate version, free camera moves over scene.
All versions built in OpenWatcom 1.9.

IBM OS/2, IBM/MS DOS:

MESHTOOL\OS2\3dsply10.exe - AutoDesk 3DS Viewer, OS/2 GLUT+OpenGL 1.0 Console version.
MESHTOOL\OS2\3dsply11.exe - AutoDesk 3DS Viewer, OS/2 GLUT+OpenGL 1.1 Console version.
MESHTOOL\OS2\MeshConv.exe - models converter, Console version.

MESHTOOL\OS2\GL10\ogf_tk.exe - OS/2 LIBTK+OpenGL 1.0 Console version.
MESHTOOL\OS2\GL10\ogf_tka.exe - OS/2 LIBTK+OpenGL 1.0 Console version (alternative controls, for levels).
MESHTOOL\OS2\GL10\ogf_glut.exe - OS/2 GLUT+OpenGL 1.0 Console version.
MESHTOOL\OS2\GL10\ogf_gluta.exe - OS/2 GLUT+OpenGL 1.0 Console version (alternative controls, for levels).
MESHTOOL\OS2\GL10\ogf_os2.exe - OS/2 PGL+OpenGL 1.0 Console version.
MESHTOOL\OS2\GL10\ogf_os2a.exe - OS/2 PGL+OpenGL 1.0 Console version (alternative controls, for levels).
MESHTOOL\OS2\GL10\ogfcons.exe - OS/2 LIBAUX+OpenGL 1.0 Console version.
MESHTOOL\OS2\GL10\ogfconsa.exe - OS/2 LIBAUX+OpenGL 1.0 Console version (alternative controls, for levels).

MESHTOOL\OS2\GL11\ogf_tk.exe - OS/2 LIBTK+OpenGL 1.1 Console version.
MESHTOOL\OS2\GL11\ogf_tka.exe - OS/2 LIBTK+OpenGL 1.1 Console version (alternative controls, for levels).
MESHTOOL\OS2\GL11\ogf_glut.exe - OS/2 GLUT+OpenGL 1.1 Console version.
MESHTOOL\OS2\GL11\ogf_gluta.exe - OS/2 GLUT+OpenGL 1.1 Console version (alternative controls, for levels).
MESHTOOL\OS2\GL11\ogf_os2.exe - OS/2 PGL+OpenGL 1.1 Console version.
MESHTOOL\OS2\GL11\ogf_os2a.exe - OS/2 PGL+OpenGL 1.1 Console version (alternative controls, for levels).
MESHTOOL\OS2\GL11\ogfcons.exe - OS/2 LIBAUX+OpenGL 1.1 Console version.
MESHTOOL\OS2\GL11\ogfconsa.exe - OS/2 LIBAUX+OpenGL 1.1 Console version (alternative controls, for levels).

MESHTOOL\OS2\WMGL\ogf_glut.exe - OS/2 GLUT+WarpMesaGL Console version.
MESHTOOL\OS2\WMGL\ogf_gluta.exe - OS/2 GLUT+WarpMesaGL Console version (alternative controls, for levels).

MESHTOOL\OS2\SNAP\ogf_glut.exe - OS/2 GLUT+SnapGL Console version.
MESHTOOL\OS2\SNAP\ogf_gluta.exe - OS/2 GLUT+SnapGL Console version (alternative controls, for levels).
MESHTOOL\OS2\SNAP\ogf_snap.exe - OS/2 MESA3D+SnapGL Console version.
MESHTOOL\OS2\SNAP\ogf_snapa.exe - OS/2 MESA3D+SnapGL Console version (alternative controls, for levels).

MESHTOOL\DOS32\ogfdos.exe - DOS32 Console version (Allegro engine, CPU optimized).
MESHTOOL\DOS32\ogfdosi.exe - DOS32 Console version (Allegro engine, FPU optimized).
MESHTOOL\DOS32\ogfdosf.exe - DOS32 Console version (Allegro engine, CPU optimized, fixed math).
MESHTOOL\DOS32\ogfdosif.exe - DOS32 Console version (Allegro engine, FPU optimized, fixed math).

MESHTOOL\DOS16\ogfdos*.exe - DOS16 Console version(s) (ANM demo recorder).
MESHTOOL\DOS16\ogfply*.exe - DOS16 Console version(s) (ANM demo record player).

+++

MESHTOOL\REF\MESH.TXT - Orion engine v1 MSH format datasheet
MESHTOOL\REF\OGF3.H - xray ogf v.3 datasheet
MESHTOOL\REF\OGF4.H - xray ogf v.4 datasheet
MESHTOOL\REF\OBJECT.H - xray object datasheet
MESHTOOL\SAMPLES - model samples
MESHTOOL\SKY\ - skybox textures for PROMO-version (files sky?.dds place in textures\sky)
MESHTOOL\FAQ.HTM - FAQ & README (HTML)
MESHTOOL\READMEOS2.HTM - FAQ & README for OS/2 (HTML)

3. KEYBOARD, MOUSE CONTROLS


All versions

Base Console-version (ogf_glut.exe, ogf_os2.exe, ogf_tk.exe, ogfcons.exe, ogf_snap.exe)

Alternate Console-version (ogf_gluta*.exe, ogf_os2a*.exe, ogf_tka*.exe, ogfconsa*.exe, ogf_snapa*.exe)


4. NOTES, BUGS



2012.07.xx