ESP: The Engineering Sketch Pad 
				Revision 1.05


Overview

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

ESP, the Engineering Sketch Pad, which 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.5 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.6 is recommended 
because there are SBO robustness problems at 6.5.3 and 6.5.4, so currently ESP 
works best with 6.5.2 if you are going to use 6.5. OpenCASCADE 6.7.0 displays 
problems in mapping attributes after using SBOs, so it is NOT recommended.
6.7.1 does not have this issue, but the SBOs functionality is not as good.
Note that the "hollow" operation does not apparently work using the various
Windows prebuilt versions, including at 6.6.0.

	At this site you will find the following recommended prebuilt versions:
OCC660lin64.tgz		LINUX 64bit OpenCASCADE at Rev 6.6.0	 
OCC660osx.tgz		MAC OSX 32 and 64bit versions of OpenCASCADE Rev 6.6.0
OCC660win32.exe		WIN32 OpenCASCADE at Rev 6.6.0 (from OpenCASCADE)
OCE-0.14.1-Win-MSVC2010.zip
			WIN32 & WIN64 OCE for Visual Studio 2010 (6.6.0)
OCE-0.14.1-Win-MSVC2012.zip
			WIN32 & WIN64 OCE for Visual Studio 2012 (6.6.0)

	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.