Read Me

 /* 
 * Copyright (C) 2006-2011 Daniel Cioi <dan.cioi@vrforcad.org>
 * 				
 * 				www.vrforcad.org
 * 
 *   This file is part of VRforCAD.
 *
 * VRforCAD is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * VRforCAD is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with VRforCAD.  If not, see <http://www.gnu.org/licenses/>.
 * 
 */

/**																	**/
1. Tested on...
2. Running the application;
3. ChangeLog;
4. MySQL database;

Also, there is a help on application's menu.
/**																	**/

1. The current version (1.0.4b01) is tested on OpenSuse 11.4 (OpenJDK 1.6.0_20, java3d 1.5.2) and Mac OS X 10.5.8 (SUN JDK 1.6.0_24-b07, java3d 1.5.2)).


2. Run the application on: 

	=> Linux: need root privileges for parallel port access; 
			(just when the application is used with 
			"SphereDevice" equipment)

	=> Windows: for WinXP is necesary to use "UserPort" 
			(gives usermode programs access to I/O Ports.)  

	=> Mac: to install java 6 for Mac, go to: http://www.apple.com/support/downloads/javaformacosx105update1.html
	to install java3d 1.5.1, go to: https://java3d.dev.java.net/binary-builds.html and get the java3d-1_5_1-macosx.zip
unpack it (also the j3d-jre.zip file) and from lib/ext folder and copy: j3dcore.jar j3dutils.jar vecmath.jar to /Library/Java/Extensions/ (you need root rights for this (to enable the root user see: http://support.apple.com/kb/HT1528)).
	Also, to access the hardware rendering you must install Java OpenGL (JOGL). For this, go to https://jogl.dev.java.net/ than chose Current release build, download and unzip the ogl-1.1.1-macosx-universal.zip file, copy from lib folder all files (gluegen-rt.jar jogl.jar libgluegen-rt.jnilib libjogl.jnilib libjogl_awt.jnilib libjogl_cg.jnilib) to /Library/Java/Extensions/
	In the /System/Library/Java/Extensions folder, rename (add _old to the files' name) the following files: j3dcore.jar j3dutils.jar vecmath.jar gluegen-rt.jar jogl.jar libgluegen-rt.jnilib libjogl.jnilib libjogl_awt.jnilib libjogl_cg.jnilib.
	To run the VRforCAD application, open a terminal and type (user): sh runVRforCAD_Mac.sh
	or make a link to java6  from terminal (root): ln -s /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Commands/java /usr/bin/java6
	and from a terminal (user): java6 -jar VRforCAD.jar

 	To use apache ant on Mac to build the project use: ant -buildfile build.xml all
	(without -buildfile option you may get the error: "Target "build.xml" does not exist in the project "VRforCAD".")
 

Use Apache Ant (Java-based build tool) to compile and run the application. 


 -> Compile and make the jar file (VRforCAD.jar)	: > ant
 -> Run the application			: > ant run				
 -> Make the installer (VRforCAD-install-1.x.x) 	: > ant install
 -> Make the server (VRforCAD-server-1.x.x)     	: > ant server
 -> Clean the temporary folders		: > ant clean
 -> Compile all and clean 			: > ant all 
 -> Compile all and clean on Mac OS X		: > ant -buildfile build.xml all

for network databases, a mysql server is required.



3. >>>>> VRforCAD ChangeLog <<<<<

*** version 1.0.4b01: ***
- code rework: better code design; split the application according to MVC pattern design, many other...
- added online http server (tomcat7, hibernate3, mysql5); The old mysql server will be reworked on next version.
- reworked the installer application (at the installation end should start the VRforCAD application).
- more functions; Assembly,    
- changed the config files.
- 


*** version 1.0.2: ***

- solve features on File menu.
- add cad file samples;
- solve a bug on load cad files;
- option to create the tables (with GUI or without GUI interaction) to save the cad models on a databases server (on another computer) for VRforCAD application; 
- Add VRforCAD-server (VRforCAD collaborative Work Server);
- Optimize the ScanFile class;
- tested succesfully > import a stl binary file with 1.048.788 vertices;
- add support to import STL BINARY file;



*** version 1.0.1: ***

The server for Collaborative Work Environment is under development.



4. For MySQL database: 
<Database databaseName="cadmodels" password="cadmodelspass" url="localhost" userName="cadmodels"/>

To make the sql tables:
CREATE TABLE `stl` (
  `id` int(11) NOT NULL auto_increment,
  `file_name` varchar(30) NOT NULL,
  `user_create` varchar(30) NOT NULL,
  `user_modify` varchar(30) NOT NULL,
  `version` int(11) NOT NULL,
  `file_content` longblob NOT NULL,
  `description` varchar(30) NOT NULL,
  PRIMARY KEY  (`id`)
)


CREATE TABLE `dxf` (
  `id` int(11) NOT NULL auto_increment,
  `file_name` varchar(30) NOT NULL,
  `user_create` varchar(30) NOT NULL,
  `user_modify` varchar(30) NOT NULL,
  `version` int(11) NOT NULL,
  `file_content` longblob NOT NULL,
  `description` varchar(30) NOT NULL,
  PRIMARY KEY  (`id`)
)

CREATE TABLE `vfc` (
  `id` int(11) NOT NULL auto_increment,
  `file_name` varchar(30) NOT NULL,
  `user_create` varchar(30) NOT NULL,
  `user_modify` varchar(30) NOT NULL,
  `version` int(11) NOT NULL,
  `file_content` longblob NOT NULL,
  `description` varchar(30) NOT NULL,
  PRIMARY KEY  (`id`)
)


CREATE TABLE `x3d` (
  `id` int(11) NOT NULL auto_increment,
  `file_name` varchar(30) NOT NULL,
  `user_create` varchar(30) NOT NULL,
  `user_modify` varchar(30) NOT NULL,
  `version` int(11) NOT NULL,
  `file_content` longblob NOT NULL,
  `description` varchar(30) NOT NULL,
  PRIMARY KEY  (`id`)
)