RomRaider

TODO:

1) Remove ugly background image.
2) Investigate lightweight canvas.
3) Keyboard rotation.

Completed:
none....

<><><><><><><><>
Brief overview :
<><><><><><><><>
Graph3dj provides an interractive 3d environment to alter and view 3d data.

<><><><><><><><><><><><>
Basic features include :
<><><><><><><><><><><><>
-Graph Rotation via mouse
-Graph translation via mouse
-Cell selection and value changes by replacing or incrementing
-Data smoothing via least squares and chebyshev polynomials
-Registering listeners for graph cell state changes
-Color scaling
-Multiple renderings (Flatface 3D, Simple 3D)

<><><><><><><><><><><><><>
Controls & Functionality :
<><><><><><><><><><><><><>

***********
Usage intro
***********
A typical graph session has the following simple flow
1) Orient graph to your liking
2) Select cells that you wish to change
3) Apply change
4) Press F1 or F2 to select different renderings. Not all data renderings are user interractive.

**************************
Orientation, changing view
**************************
-Mouse wheel rotate zoom in & out.
-Right mouse click for drag translation of entire graph.
-Left mouse click rotate of graph.
-Left & Right mouse click, then moving mouse up and down to zoom in and out.


************************************************
Shift key held, adding to list of selected cells
************************************************
(Selected items turn grey)
-Single click on a unselected cell to add to selected list
-Single click on a selected cell to remove from selected list
-Double click on a cell to draw a diagonally bounded rectangle starting with previously selected cell


********************************************
CTRL key held, changing cell values directly
********************************************
(Assumed all currently selected cells will have their values changed simultaneously)
-Pressing CTRL key puts graph into data reception mode.
-Hold CTRL, enter in desired double number (ie 12.1) to put number into value scratch pad
-While still holding CTRL, press one of the following keys
**-> 'r', to replace all selected cells values with entered number
**-> 'i', to increment all selected cells values with entered number


******************************************
Numerical interpolation, ie data smoothing
******************************************
NOTE: Data smoothing can only be applied to groups of cells with one dimension greater than or equal to 3
ie 3x1, 1x4, 3x3, 4x9 etc

NOTE: Multiple groups can be interpolated at once

Preconditions: groups of desired cells are selected

Usage:
- Pressing '<' will interpolate in the x (left to right) direction
- Pressing '>' will interpolate in the z (into monitor) direction
- Pressing '/' will do a best effort 2D interpolation (most common used)


**********************
Undoing a value change
**********************
-Of any groups of selected cells, given they have had a prior value, pressing 'u' will flip their data to the old value.
-Pressing 'u' twice will toggle between the old and current value




<><><><><><><><><><><><><>
MISC:
<><><><><><><><><><><><><>

**************
Supported OS's
**************
Linux OpenGL rendering is supported.
Windows OpenGL rendering is supported.


**************
Supported JVMs
**************
Only Sun Microsystems JVM Version 1.5.0_07-b03 has been verified to work with Graph3Dj.






-------------------------------------------------
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Known Issues
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-------------------------------------------------
-Java3d over most VNC implementations will show a blank JFrame.
-You MUST have up to date graphics drivers that support OpenGL 1.2
-Though I'm working on streamlining the 3d portion, much memory is still needed to avoid out of memory errors.
*Expect ~200 megs of usage.
*Expect possible memory leaks as this is based off of beta quality Java3d releases.
-There are some problems with cell selection.
-Numerical interpolation can take some time on slower machines.

I like it! I can go ahead and add you to the SVN repo, what is your SF.net username?

it'd be nice. although, I prolly won't use it. them graphs confuse me

I would like to see more of this.

Looks neat but everything kind of runs togethor .. . .and values are hard to read.

good work none the less!

Tgui

I'm pretty easy to track on the net.

thanks!

I have the same complaints, give me time.

Ok, I gave you SVN permissions. Are you interested in adding that to RomRaider? I'm not exactly sure what the best way to implement it would be but if you have an idea (or someone else does) shoot!

Thanks!

I can integrate when I feel the graph is worthy of addition. I'll have to modify your table code and add listeners etc... I'll do a test run integration in a couple weeks to see how many toes were stepped on. This should be a fairly modular addition.

-Eric-

I like the way the values are in the cells and although some aren't readable in the screenshot, if it is rotatable with a mouse then that should be OK.

Now it is for sure. I mean *cough* bump *cough*

New picture added, no test program available yet. bumpage

I am a huge user of graphing. Sometimes you can't hit every single point on a calibration and graphs help to visually configure that middle point. Some notes (sorry for being critical!).

1) The background needs to be plain. The RomRaider logo needs to go because it distracts from the actual data.

2) I'm not a fan of the squares at all. Lines. Lines. Lines. Why? Squares don't show the real picture. The ECU doesn't use squares. It uses POINTS and has a nice flowing curve between the points. It does it's own interpolation. Using squares doesn't truly represent what values the ECU will be using. The way that ECUEdit, EcuTek, and StreetTUNER do is far superior to the squares that you are using. I can name MANY other tuning programs that do it this way also - hydra, motec, accel, etc. Squares aren't used for a reason.

3) I like the idea of showing the value in the square. However, if showing the value is the reason for using squares then do a 'popup' hover value instead so that the squares can be ditched.

4) Clicking and Dragging the points would be awesome. I have used this feature in other tuning programs a lot. It is extremely helpful to be able to view the graph, click/hold a point, and drag it to where you want it. This will change the actual value in the table to match what you just made it on the graph. It is super cool and very helpful for that extra special black magic that we need to do.

Sorry for sounding critical. I'm actually really positive about this and very excited to see progress on graphing.

All sounded like good points to me!

Thanks for your input.

1) The background is user definable. A solid color can be chosen.

2 & 3 & 4) Please read further in the main post. This is NOT just a graph I think you misuderstood the purpose of this RomRaider addition. This whole graph is user interractive. All cells are selectable, in groups or otherwise. Selected cells can have their values modified. Graph can be rotated to see the contours. I'm working on smoothing algorithms etc to modify the data also.

I'm shooting for 3d rendering and map editing all in one. It saves screen realestate on smaller laptop screens. That and it kind of follows the way I think... all crazy like.


I'll re-post the Readme.txt information.

-Eric-

How long do you think it will be before there is something to tinker with?