ESP: The Engineering Sketch Pad 
				Revision 1.01


Overview

	This directory contains the source, makefiles, and sample input files 
for the following programs:

ESP, the Engineering Sketch Pad, is a solid-modeling, feature-based,
web-enabled system for creating, editing, manipulating, and building parametric 
geometry. It is built upon WebViewer and OpenCSM.

WebViewer is an interactive 3D visualization system for rendering geometries 
and performing scientific visualization. It uses a browser-server architecture 
for high-speed rendering in any modern browser that supports WebSockets and 
WebGL.

OpenCSM, the Open-source Constructive Solid Modeler, is a system for defining 
and manipulating models in terms of their feature tree and design parameters. 
It is built upon EGADS (and hence OpenCASCADE), but also supports some CAD 
systems directly via CAPRI (which is available commercially from CadNexus).

EGADS, the Engineering Geometry Aerospace Design System, is a relatively simple
and compact open-source, object-based API built on top of the extensive 
OpenCASCADE solid-modeling kernel. It has been designed to allow both top-down 
(solids-based) and bottom-up (entity-based) building of complex configurations.


Prerequisites

	The most significant prerequisite for this software is OpenCASCADE at 
release 6.3.0 or greater (which now includes the OpenCASCADE Community Edition).
This can be found at http://www.opencascade.org/getocc/download/loadocc or
https://github.com/tpaviot/oce. Prebuilt versions are available at these sites
for Windows using various versions of Visual Studio and for MAC OSX at 64-bits.
Any other configuration must be built from source (unless you are using a
Debian variant of LINUX, such as Ubuntu, where there are available prebuilt
packages as part of the LINUX distribution). Note that 6.5 is recommended but
there are SBO robustness problems at 6.5.3 and 6.5.4, so currently ESP works 
best with 6.5.2.

	At this site you will find the following prebuilt versions:
OCC652linux64.tgz:	LINUX 64bit OpenCASCADE at Rev 6.5.2
OCC652osx32.tgz		MAC OSX 32bit OpenCASCADE at Rev 6.5.2
OCC652win32.exe		WIN32 OpenCASCADE at Rev 6.5.2 (from OpenCASCADE)
OCEosx64.tgz		MAC OSX 64bit OpenCASCADE Community Edition (6.5.1)

	Another prerequisite is a WebGL/Websocket capable Browser. In general
these include Mozilla's FireFox (and SeaMonkey) and Google Chrome. Apple's 
Safari works at rev 6.0 (OSX 10.8) or greater. Note that there are some 
problems using Intel Graphics with some WebGL Browsers under Linux. Also, for 
LINUX "zlib" development is required.


Building ESP (and its sub-packages)

	After you have downloaded ESP.tgz (and any variant of OpenCASCADE that 
you need), expand ESP.tgz and carefully read EngSketchPad/README.txt. This file
explains the build and installation process for ESP, WebViewer, OpenCSM, and 
EGADS.