graxml-commit Mailing List for GraXML (Page 6)

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/graxml/Graphics/GraXMLBridge/src/atlantis/graxml3d/doc-files
In directory sc8-pr-cvs2.sourceforge.net:/tmp/cvs-serv30769/atlantis/graxml3d/doc-files

Added Files:
	Atlantis3D.html Atlantis3D.pdf StartGraXMLMenu.gif 
	WebStart.gif atlantisgraxml.gif collaboration.jpg deploy.jpg 
	tip_centerwindow.js tip_followscroll.js transparentpixel.gif 
	wz_dragdrop.js wz_tooltip.js 
Log Message:
reorganising, documentation updating

--- NEW FILE: tip_followscroll.js ---
/*
tip_followscroll.js	v. 1.1

The latest version is available at
http://www.walterzorn.com
or http://www.devira.com
or http://www.walterzorn.de

Initial author: Walter Zorn
Last modified: 21.6.2007

Extension for the tooltip library wz_tooltip.js.
Lets a "sticky" tooltip keep its position inside the clientarea if the window
is scrolled.
*/

// Here we define new global configuration variable(s) (as members of the
// predefined "config." class).
// From each of these config variables, wz_tooltip.js will automatically derive
// a command which can be passed to Tip() or TagToTip() in order to customize
// tooltips individually. These command names are just the config variable
// name(s) translated to uppercase,
// e.g. from config. FollowScroll a command FOLLOWSCROLL will automatically be
// created.

//===================	GLOBAL TOOPTIP CONFIGURATION	======================//
config. FollowScroll = false		// true or false - set to true if you want this to be the default behaviour
//=======	END OF TOOLTIP CONFIG, DO NOT CHANGE ANYTHING BELOW	==============//

// Create a new tt_Extension object (make sure that the name of that object,
// here fscrl, is unique amongst the extensions available for
// wz_tooltips.js):
var fscrl = new tt_Extension();

// Implement extension eventhandlers on which our extension should react
fscrl.OnShow = function()
{
	if(tt_aV[FOLLOWSCROLL])
	{
		// Permit FOLLOWSCROLL only if the tooltip is sticky
		if(tt_aV[STICKY])
		{
			var x = tt_x - tt_GetScrollX(), y = tt_y - tt_GetScrollY();

			if(tt_ie)
			{
				fscrl.MoveOnScrl.offX = x;
				fscrl.MoveOnScrl.offY = y;
				fscrl.AddRemEvtFncs(tt_AddEvtFnc);
			}
			else
			{
				tt_SetTipPos(x, y);
				tt_aElt[0].style.position = "fixed";
			}
			return true;
		}
		tt_aV[FOLLOWSCROLL] = false;
	}
	return false;
};
fscrl.OnHide = function()
{
	if(tt_aV[FOLLOWSCROLL])
	{
		if(tt_ie)
			fscrl.AddRemEvtFncs(tt_RemEvtFnc);
		else
			tt_aElt[0].style.position = "absolute";
	}
};
// Helper functions (encapsulate in the class to avoid conflicts with other
// extensions)
fscrl.MoveOnScrl = function()
{
	tt_SetTipPos(fscrl.MoveOnScrl.offX + tt_GetScrollX(), fscrl.MoveOnScrl.offY + tt_GetScrollY());
};
fscrl.AddRemEvtFncs = function(PAddRem)
{
	PAddRem(window, "resize", fscrl.MoveOnScrl);
	PAddRem(window, "scroll", fscrl.MoveOnScrl);
};

--- NEW FILE: Atlantis3D.pdf ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: wz_dragdrop.js ---
/* This notice must be untouched at all times.

wz_dragdrop.js	v. 4.89
The latest version is available at
http://www.walterzorn.com
or http://www.devira.com
or http://www.walterzorn.de

Copyright (c) 2002-2007 Walter Zorn. All rights reserved.
Created 26. 8. 2002 by Walter Zorn (Web: http://www.walterzorn.com )
Last modified: 28.6.2007

This DHTML & Drag&Drop Library adds Drag&Drop functionality
to the following types of html-elements:
- images, even if not positioned via layers,
  nor via stylesheets or any other kind of "hard-coding"
- relatively and absolutely positioned layers (DIV elements).
Moreover, it provides extended DHTML abilities.

[...1399 lines suppressed...]

/* my_ResizeFunc IS CALLED WHILE AN ITEM IS RESIZED
See the description of my_PickFunc above for what's accessible from here. */
function my_ResizeFunc()
{
	//window.status = 'dd.elements.' + dd.obj.name + '.w  = ' + dd.obj.w + '	 dd.elements.' + dd.obj.name + '.h = ' + dd.obj.h;
}

/* THIS ONE IS CALLED ONCE AN ITEM IS DROPPED
See the description of my_PickFunc for what's accessible from here.
Here may be investigated, for example, what's the name (dd.obj.name)
of the dropped item, and where (dd.obj.x, dd.obj.y) it has been dropped... */
function my_DropFunc()
{
}

--- NEW FILE: StartGraXMLMenu.gif ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: deploy.jpg ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: wz_tooltip.js ---
/* This notice must be untouched at all times.

wz_tooltip.js	 v. 4.12

The latest version is available at
http://www.walterzorn.com
or http://www.devira.com
or http://www.walterzorn.de

Easy-to-use cross-browser tooltips.
Just include the script at the beginning of the <body> section, and invoke
Tip('Tooltip text') from within the desired HTML onmouseover eventhandlers.
No container DIV, no onmouseouts required.
By default, width of tooltips is automatically adapted to content.
Is even capable of dynamically converting arbitrary HTML elements to tooltips
[...1110 lines suppressed...]
		{
			eval(s + " = " + tt_aV.length);
			tt_aV[tt_aV.length] = null;
		}
	}
}
function tt_ExtCallFncs(arg, sFnc)
{
	var b = false;
	for(var i = tt_aExt.length; i;)
	{--i;
		var fnc = tt_aExt[i]["On" + sFnc];
		// Call the method the extension has defined for this event
		if(fnc && fnc(arg))
			b = true;
	}
	return b;
}

tt_Init();

--- NEW FILE: Atlantis3D.html ---
<html>
  <head>
    <title>GraXML Provides 3D View to Atlantis</title>
    </head>
  <body>

    <script type="text/javascript" src="wz_dragdrop.js"></script>
    <script type="text/javascript" src="wz_tooltip.js"></script>

    <span id="imgHelp"><p>You can drag this image with Mouse</p>
                       <p>You can resize this image with Shift+Mouse</p></span> 
    <span id="printPdf"><p>This page can't be printed directly,</p>
                           use its PDF version instead !</p></span> 

    <table><tr>
      <td width="30%"><img src="atlantisgraxml.gif" width="400" name="atlantisgraxml" onmouseover="TagToTip('imgHelp', BGCOLOR, '#FFFFFF', FONTCOLOR, '#000000', BORDERCOLOR, '#FF0000', BORDERWIDTH, 3)"></td>
      <td width="70%" align="center">
        <h1 align="center">GraXML Provides 3D View to Atlantis</h1>
        <p>Following many requests for a realistic 3D view in Atlantis,
          Atlantis-GraXML bridge has been created allowing Atlantis
          objects te be visualised in GraXML.</p>
        <p><a href="Atlantis3D.pdf" onmouseover="TagToTip('printPdf')">PDF version of this page.</a></td>
      </tr></table>
    <hr>

    <h2 align="center">How to Use</h2>

    <h3 align="center">Web Starting</h3>

    <table><tr>
      <td width="50%">
        <p>Atlantis with GraXML is available via Java WebStart. The only precondition
          for using it is Java 1.5 or 1.6 available on local machine. If Java is
          correctly installed, clicking on following link will install and
          start Atlantis+GraXML on local machine:
          <a href="http://www.hep.ucl.ac.uk/atlas/atlantis/webstart3d/atlantis3d.jnlp">Atlantis3D Web Start</a>.
          Web browser should accaept <code>.jnlp</code> extension and associate it with
          <code>javaws</code> command. If Web-based installation doesn't work (which means that Java is
          not correctly enabled with Web browser), Atlantis3D can be installed and started using
          following command:
          <code>javaws http://www.hep.ucl.ac.uk/atlas/atlantis/webstart3d/atlantis3d.jnlp</a>.</p>
          <p>Java Web Start will verify the local installation on every call. It will download
          new version of Atlantis3D when it is available. Status of Java Web Start applications
          can be verified by the Web Start manager which could be started using <code>javaws</code>
          (for Java 1.5) or <code>javaws -viewer</code> (for Java 1.6) command. On Linux, all
          Web Start applications are installed under <code>~/.java</code> directory.</p>
        <p>Atlantis3D works under all common distributions of Linux, MacOSX and MS.</p>
        </td>
      <td width="50%"><img src="WebStart.gif" width="400" name="WebStart" onmouseover="TagToTip('imgHelp', BGCOLOR, '#FFFFFF', FONTCOLOR, '#000000', BORDERCOLOR, '#FF0000', BORDERWIDTH, 3)"></td>
      </tr></table>

    <h3 align="center">Calling GraXML from Atlantis</h3>

    <table><tr>
      <td width="50%">
        <p>When GraXML is available, Atlantis RubberBand offers
          <em>Show in 3D window (InDet and Object data only)</em> item. When chosen, this selection will
          start GraXML window (unless it already runs) and send it all selected elements. They will
          be displayed in GraXML 3D canvas. All elements in GraXML will keep the same color as
          in Atlantis. All standard GraXML operations will be available
          (see <a href="http://cern.ch/hrivnac/Activities/Packages/GraXML/JavaDoc/net/hep/graphics/GraXML/doc-files/Guide.html#Help">GraXML Guide</a>
          for details).</p>
        <p>Any subsequent selection in Atlantis will send new elements to GraXML (and remove the old ones).
          <small>(Possibility to keep old elements can be allowed if requested.)</small></p>
        <p>GraXML window can be closed, which should not close main Atlantis window. However, some
          windowing systems with integrated OpenGL driver (used by GraXML) can close Atlantis
          window as well. Furthermore, any subsequent GraXML invocation within the same Atlantis session
          will not be functional <small>(this seems to be a problem in re-starting OpenGL)</small>.</p>
        <p>Following Atlantis objects are correctly available in GraXML:
          <ul>
            <li>S3D</li>
            <li>SiCluster</li>
            <li>STr <small>(simplified)</small></li>
            <li>InDetTrack <small>(only some descriptions)</small></li>
            <li>Jet</li>
            <li>BJet</li>
            <li>TauJet</li>
            <li>Electron</li>
            <li>Muon</li>
            <li>Photon</li>
            <li>ETmis</li>
            </ul></p>
        </td>
      <td width="50%"><img src="StartGraXMLMenu.gif" width="300" name="StartGraXMLMenu" onmouseover="TagToTip('imgHelp', BGCOLOR, '#FFFFFF', FONTCOLOR, '#000000', BORDERCOLOR, '#FF0000', BORDERWIDTH, 3)"></td>
      </tr></table>

    <h2 align="center">GraXML Architecture</h2>

    <table>
      <tr>
        <td width="50%">
          <p>
            GraXML 3D graphical browser is based on GraXML Framework. It uses <a href="https://java3d.dev.java.net/">Java3D</a> to visualise
            spacial objects, Java3D uses OpenGL for drawing.</p>
          <p>GraXML gets data in the form of <em>Generic Model</em>. It is <a href="https://jaxb.dev.java.net">JAXB</a> tree, classes
            of which are automaticaly generated from the XML Schema descrybing relevant data. That JAXB
            tree can be either assembled at run-time (as in case of Atlantis-GraXML package) or parsed from
            an XML file (conform to the XML Schema used to create the model). JAXB is part of Java distribution
            since Java 1.6. Currently, GraXML supports four <em>Generic Model</em>s: AGDD, GDML, JiveEvent and
            JiveGeometry.</p>
          <p>JAXB <em>Generic Model</em> is then converted to Java3D tree, called <em>Geometric Model</em>.
            This conversion is performed taking into account several parameters, the most important of which are
            <em>optimisation</em>, <em>quality</em> and <em>interactivity</em> levels. Java3D <em>Geometric Model</em>
            can then be directly visualised or further processed (dumped to VRML/X3D, converted to TGeo,...).</p>
          <p>More information about GraXML Architecture and usage instructions are available from its
            <a href="http://cern.ch/hrivnac/Activities/Packages/GraXML/JavaDoc/net/hep/graphics/GraXML/doc-files/Guide.html">Guide</a>.</p>
          </td>
        <td width="50%"><img src="http://cern.ch/hrivnac/Activities/Packages/GraXML/JavaDoc/net/hep/graphics/GraXML/doc-files/Packages.jpg" width="400" name="Packages" onmouseover="TagToTip('imgHelp', BGCOLOR, '#FFFFFF', FONTCOLOR, '#000000', BORDERCOLOR, '#FF0000', BORDERWIDTH, 3)"></td>
        </tr>
      </table>

    <h2 align="center">GraXMLBridge Architecture</h2>

    <table>
      <tr>
        <td width="50%">
          <p>There are three packages collaborating in the process:
            <ul>
              <li><code>atlantis.ASelection</code> creates (if necessary) <code>GraXMLBridge</code>
                and announces it new data. All this communication is performed
                by reflection so that there is no direct (compile-time) Atlantis dependence on GraXML.</li>
              <li><code>GraXMLBridge</code> requests new data from <code>atlantis.ASelection</code>
                and converts them into <em>JAXB</em> tree (called <em>Generic Model</em> in GraXML).</li>
              <li><code>GraXMLBridge</code> then creates <code>GraXML</code> (if it doesn't exist yet),
                sets its parameters (colors,...) and sends it a <em>JAXB</em> tree to be shown.</li>
              </ul>
            </p>
          </td>
        <td width="50%"><img src="collaboration.jpg" width="400" name="collaboration" onmouseover="TagToTip('imgHelp', BGCOLOR, '#FFFFFF', FONTCOLOR, '#000000', BORDERCOLOR, '#FF0000', BORDERWIDTH, 3)"></td>
        </tr>
      <tr>
        <td width="50%">
          <p>All packages are distributed using Java WebStart <code>*.jnlp</code> files.
            <em>Atlantis</em>, <em>Atlantis3D</em> and <em>GraXML</em> are directly
            callable, others just serve libraries.</p>
          </td>
        <td width="50%"><img src="deploy.jpg" width="400" name="deploy" onmouseover="TagToTip('imgHelp', BGCOLOR, '#FFFFFF', FONTCOLOR, '#000000', BORDERCOLOR, '#FF0000', BORDERWIDTH, 3)"></td>
        </tr>
      </table>

    <h2 align="center">Future</h2>

    <p>The most important effort in near-future should go to the support of all Atlantis
      data, event-like as well as geometry. So far, only a subset of Inner detector and kinematic
      objects are supported. There is a limited support for geometry, but this is today far from
      correct. The biggest problem here is to get the real 3D object' representation from Atlantis.
      Atlantis can easily give 2D in several projections, which is often not sufficient
      for complete 3D representation. That is in particular true for description of
      geometry.</p>
    <p>To convert Atlantis 2D projection to full 3D information, help from
      2D representation authors is urgently needed. 3D geometry description can be, in principle,
      obtained by dumping Atlas offline geometry (from Athena or Genat4) into AGDD or GDML
      (such possibility exists thanks to <a href="http://ivana.home.cern.ch/ivana/VGM.html">Virtual Geometric Model</a>).
      (Simplified) AGDD or GDML description can then be easily read into GraXML.</p>
    <p>Some Atlantis3D extensions can be quickly implemented if needed:
      <ul>
        <li><b>Direct connection from GraXML to Atlantis server:</b> GraXML can directly read Atlantis
          files. It would be very simple to give it a possibility to connect directly (i.e. without
          mediating Atlantis) to the Atlantis XML-RPC server.</li>
        <li><b>VRML/X3D/TGeo dump:</b> GraXML can dump its 3D content into VRML or X3D files. Those files
          can then be visualised using standard VRML browsers. It would
          be easy to  add VRML/X3D export possibility to Atlantis3D. Dumping to TGeo is currently only supported
          for AGDD Generic Model, its extension to Atlantis data would be a bit more complex.</li>
        <li><b>Callback:</b> GraXML receives data selected in Atlantis. As GraXML has a picking
          capability, it could send information about its selected objects back to Atlantis.</li>
        <li><b>Ray Tracing:</b> There is a possibility to export GraXML view into <em>PovRay</em> ray-tracing file format and
          process that file to produce photo-realistic pictures. That possbility can be added to
          Atlantis3D.</li>
        <li><b>XML Schema</b>: To enable creation of JAXB model, Atlantis XML DTDs has been
          converted into XML Schemas. That conversion has been so-far only done on a pragmatic
          way, i.e. only elements used in GraXML have been fully ported (with correct variable types,...).
          Full DTD can be converted (and maybe used within Atlantis itself).</li>
        </ul>
      </p>

    <hr>
    <h2 align="center">Links</h2>

    <p>
      <ul>
        <li><a href="http://cern.ch/hrivnac/Activities/Packages/GraXML">GraXML</a> Home</li>
          <ul>
            <li><a href="http://cern.ch/hrivnac/Activities/Packages/GraXML/JavaDoc/net/hep/graphics/GraXML/doc-files/Guide.html">Guide</a></li>
            <li><a href="https://sourceforge.net/projects/graxml">Sourceforge</a></li>
            <li><a href="http://hrivnac.web.cern.ch/hrivnac/Activities/2004/September/GraXML">CHEP'04 talk</a></li>
            </ul>
        <li><a href="http://cern.ch/atlantis">Atlantis</a></li>
        <li><a href="http://cern.ch/hrivnac/Activities/Packages/GraXMLBridge">GraXMLBridge</a></li>
        <li>Web Start:
          <ul>
            <li><a href="http://www.hep.ucl.ac.uk/atlas/atlantis/webstart/atlantis3.jnlp">Atlantis</a></li>
            <li><a href="http://www.hep.ucl.ac.uk/atlas/atlantis/webstart3d/atlantis3d.jnlp">Atlantis3D</a> (Atlantis with GraXML)</li>
            <li><a href="http://cern.ch/hrivnac/Activities/Packages/WebStart/GraXML/GraXML.jnlp">GraXML</a></li>
            </ul>
          </li>
        </ul>
      </p>

    <hr>
    <img width="0" height="0" src="http://cern.ch/hrivnac/cgi-bin/record.pl?page=Atlantis3D">
    <address>
      <a href="http://cern.ch/hrivnac">J.Hrivnac</a> (GraXML part) + <a href="">Z.Maxa</a> (Atlantis part), Jan'08
      </address>

    <script type="text/javascript" src="http://cern.ch/hrivnac/google-analytics1.js"/><script type="text/javascript" src="http://cern.ch/hrivnac/google-analytics2.js"/>

    <script type="text/javascript">
      <!--

      SET_DHTML("atlantisgraxml"+SCALABLE+TRANSPARENT,
                "WebStart"+SCALABLE+TRANSPARENT,
                "StartGraXMLMenu"+SCALABLE+TRANSPARENT,
                "Packages"+SCALABLE+TRANSPARENT,
                "collaboration"+SCALABLE+TRANSPARENT,
                "deploy"+SCALABLE+TRANSPARENT);
        //-->
      </script> 

    </body>
  </html>

--- NEW FILE: collaboration.jpg ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: WebStart.gif ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: tip_centerwindow.js ---
/*
tip_centerwindow.js  v. 1.2

The latest version is available at
http://www.walterzorn.com
or http://www.devira.com
or http://www.walterzorn.de

Initial author: Walter Zorn
Last modified: 23.6.2007

Extension for the tooltip library wz_tooltip.js.
Centers a sticky tooltip in the window's visible clientarea,
optionally even if the window is being scrolled or resized.
*/

// Here we define new global configuration variable(s) (as members of the
// predefined "config." class).
// From each of these config variables, wz_tooltip.js will automatically derive
// a command which can be passed to Tip() or TagToTip() in order to customize
// tooltips individually. These command names are just the config variable
// name(s) translated to uppercase,
// e.g. from config. CenterWindow a command CENTERWINDOW will automatically be
// created.

//===================  GLOBAL TOOPTIP CONFIGURATION  =========================//
config. CenterWindow = false	// true or false - set to true if you want this to be the default behaviour
config. CenterAlways = false	// true or false - recenter if window is resized or scrolled
//=======  END OF TOOLTIP CONFIG, DO NOT CHANGE ANYTHING BELOW  ==============//

// Create a new tt_Extension object (make sure that the name of that object,
// here ctrwnd, is unique amongst the extensions available for
// wz_tooltips.js):
var ctrwnd = new tt_Extension();

// Implement extension eventhandlers on which our extension should react
ctrwnd.OnLoadConfig = function()
{
	if(tt_aV[CENTERWINDOW])
	{
		// Permit CENTERWINDOW only if the tooltip is sticky
		if(tt_aV[STICKY])
		{
			if(tt_aV[CENTERALWAYS])
			{
				// IE doesn't support style.position "fixed"
				if(tt_ie)
					tt_AddEvtFnc(window, "scroll", Ctrwnd_DoCenter);
				else
					tt_aElt[0].style.position = "fixed";
				tt_AddEvtFnc(window, "resize", Ctrwnd_DoCenter);
			}
			return true;
		}
		tt_aV[CENTERWINDOW] = false;
	}
	return false;
};
// We react on the first OnMouseMove event to center the tip on that occasion
ctrwnd.OnMoveBefore = Ctrwnd_DoCenter;
ctrwnd.OnKill = function()
{
	if(tt_aV[CENTERWINDOW] && tt_aV[CENTERALWAYS])
	{
		tt_RemEvtFnc(window, "resize", Ctrwnd_DoCenter);
		if(tt_ie)
			tt_RemEvtFnc(window, "scroll", Ctrwnd_DoCenter);
		else
			tt_aElt[0].style.position = "absolute";
	}
	return false;
};
// Helper function
function Ctrwnd_DoCenter()
{
	if(tt_aV[CENTERWINDOW])
	{
		var x, y, dx, dy;

		// Here we use some functions and variables (tt_w, tt_h) which the
		// extension API of wz_tooltip.js provides for us
		if(tt_ie || !tt_aV[CENTERALWAYS])
		{
			dx = tt_GetScrollX();
			dy = tt_GetScrollY();
		}
		else
		{
			dx = 0;
			dy = 0;
		}
		// Position the tip, offset from the center by OFFSETX and OFFSETY
		x = (tt_GetClientW() - tt_w) / 2 + dx + tt_aV[OFFSETX];
		y = (tt_GetClientH() - tt_h) / 2 + dy + tt_aV[OFFSETY];
		tt_SetTipPos(x, y);
		return true;
	}
	return false;
}

--- NEW FILE: atlantisgraxml.gif ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: transparentpixel.gif ---
(This appears to be a binary file; contents omitted.)

2005	Jan	Feb	Mar (1)	Apr (5)	May (6)	Jun (2)	Jul	Aug (12)	Sep (32)	Oct (41)	Nov (16)	Dec (21)
2006	Jan (10)	Feb (10)	Mar (3)	Apr (3)	May (10)	Jun (12)	Jul	Aug	Sep (11)	Oct	Nov	Dec
2007	Jan (169)	Feb (17)	Mar	Apr	May	Jun	Jul	Aug	Sep (5)	Oct (100)	Nov (14)	Dec (10)
2008	Jan (37)	Feb (4)	Mar (10)	Apr (73)	May (22)	Jun (8)	Jul (2)	Aug	Sep	Oct	Nov	Dec

graxml-commit Mailing List for GraXML (Page 6)

graxml-commit — CVS commit notifications of GraXML