Welcome to Xj3D codebase.

This are notes for the 13 June 2003 dev release of Xj3D.

We have moved to the final file associations/MIME types
and parsing code to deal with the just changed file extensions. Note that all
VRML-encoded X3D files from this release onward now _must_ end in the .x3dv
extension. Anything ending in .wrl will automatically be assumed to be VRML97.


Since Last Dev Release:
-----------------------

  Anchors now pass conformance tests.  A few bugs fixed in this process.

  Dot product fixed ecmascript VrmlMatrix

  Initial binding of bindables now spec compliant.  Scripts which bind bindables
  during initialize will work right.

  Blank viewpoints not added to viewpoint list as spec recommendation

  Bug 58 fixed.  JavascriptScriptWrapper doesn't set the error reporter on the Context object
  before invoking the initialize method.

  Regression in last dev release fixed for Inlines and texture loading no working right.

  Bug 31 and 53 fixed.  Not getting all vrmlEvents using VrmlEventListener

  Tilt navigation restored to browser.

  Reload should work better in the browser.  World reloads are synched to the event model.

  Bug 19 fixed.  Routes need to type check


Major changes since M7:
-----------------------

  Background sky/ground color implemented completely.

  Cursor Shapes (including ability to custom defined them) is now provided
      within the infrastructure. These are used anywhere that Xj3D provides a
      canvas or higher abstraction of the viewing process. Setup immediately
      for the SAI/EAI and Xj3DBrowser in the apps directory.

  Files now correctly obey the file extensions when using the URL interface.
      For X3D VRML-encoded files, you now _must_ have the .x3dv file extension.
      The old .wrl file extension shall be only interpreted to mean VRML97
      files. We also have the new mime-types handleded too, but there's no
      content being served up from webservers using the new extension yet.

  Billboard functions correctly.

  Last of the createVrmlFromUrl architecture updates are debugged. The entire
      event model should work as advertised in the VRML97 spec now.


  DragSensors now implemented. Not all debugged though.

  Preliminary experimental binary format and infrastructure. Converter app to
     convert to it. No reader yet implemented.

  Complete new input device handling implementation. Now completely generic
      allowing anything from a mouse to joystick, to glove, to HMD to interact
      with the scene. Mouse and keyboard nav is provided.

Known Issues:
-------------

    General:
        Huge amounts of garbage generated internally within Java3D's picking
        subsystem using Cone-based objects for those using J3D1.3.0. Fixed for
	1.3.1FCS.

    ECMAScript: Due to a change in Rhino 1.5R4, a number of things broke in our
        code. The changes were an all-or-nothing afair. So we've decided to fix
	the code to work with 1.5R4-1. That means you will need to upgrade your
	copy of Rhino to this version.  As a result, the standalone print()
	method that some browsers support, is no longer supported by us. For your
	code to run, you must use Browser.println() instead.

    MovieTexture
        In order to work, you need to have JMF installed.

    AudioClip
        The Java3D audio capabilities are exceedingly bug-ridden. If you use
	anything before 1.3.1beta, you'll not hear any audio content.

    browser
        GeoVRML and UMEL local resolution not supported in pre-compiled code,
            you need to specify the local installation path in DIYBrowser.java
            and recompile.

License
-------
 This source is licensed under the GNU LGPL v2.1
 Please read http://www.gnu.org/copyleft/lesser.html for more information

 This software comes with the standard NO WARRANTY disclaimer for any
 purpose. Use it at your own risk. If there's a problem you get to fix it.