diff options
| author | Kevin Rushforth <[email protected]> | 2006-01-24 01:26:29 +0000 |
|---|---|---|
| committer | Kevin Rushforth <[email protected]> | 2006-01-24 01:26:29 +0000 |
| commit | 9d7eff05ab6ff5b71b88cf77e9eabe63bcec5ac3 (patch) | |
| tree | f9042a1bcf92cbeffe62191a1e42bd7f4573aec3 /www/j3d1_4 | |
| parent | f880aef74ac2ed92fc24e5ecb7c683c1ea867cb7 (diff) | |
Obsolete pages; now point to Wiki
git-svn-id: https://svn.java.net/svn/j3d-core~svn/trunk@507 ba19aa83-45c5-6ac9-afd3-db810772062c
Diffstat (limited to 'www/j3d1_4')
| -rw-r--r-- | www/j3d1_4/api-changes.html | 306 | ||||
| -rw-r--r-- | www/j3d1_4/improvements.html | 66 | ||||
| -rw-r--r-- | www/j3d1_4/proposed-changes.html | 221 |
3 files changed, 17 insertions, 576 deletions
diff --git a/www/j3d1_4/api-changes.html b/www/j3d1_4/api-changes.html index 28a106d..4cdc828 100644 --- a/www/j3d1_4/api-changes.html +++ b/www/j3d1_4/api-changes.html @@ -1,310 +1,14 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> - -<!-- -/* - * $RCSfile$ - * - * Copyright (c) 2006 Sun Microsystems, Inc. All rights reserved. - * - * Use is subject to license terms. - * - * $Revision$ - * $Date$ - * $State$ - */ - --> - -<!-- -************************************************************************ -* -* NOTE: This file must be edited by hand to avoid Mozilla Composer -* putting all preformatted lines into a single line with "<br>" -* replacing ASCII newlines, making it impossible to do a meaningful -* "diff" operation. -* -************************************************************************ ---> - <html> <head> <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"> - <title>List of Proposed Java 3D 1.4 API Changes</title> + <title>Obsolete Page</title> </head> <body> -<h2>List of Proposed Java 3D<sup><font size="-2">TM</font></sup> -1.4 API Changes</h2> -<p>This document conatains a list of the proposed API changes to the -Java 3D<sup><font size="-2">TM</font></sup> 1.4 API -that deviate from the 1.3 API. -</p> -<p>Note: the most up-to-date version of -this list is in the <code>dev-1_4</code> branch of the -<code>docs/api-changes-1_4.txt</code> -file, which is updated to record the addition or deprecation of -any public or protected class, interface, field, constructor, or method -to the Java 3D API. -</p> -<p>No incompatible changes to the Java 3D 1.3 API are allowed.</p> -<pre> -I. New/deprecated fields, constructors, methods - - Canvas3D - -------- - New methods: - public boolean isShadingLanguageSupported(int shadingLanguage) - - - SceneGraphObject - ---------------- - New methods: - public void setName(String name) - public String getName() - - - GeometryArray (incomplete list) - ------------- - New fields: - public static final int ALLOW_VERTEX_ATTR_READ - public static final int ALLOW_VERTEX_ATTR_WRITE - public static final int VERTEX_ATTRIBUTES - - New constructors: - public GeometryArray(int vertexCount, - int vertexFormat, - int texCoordSetCount, - int[] texCoordSetMap, - int vertexAttrCount, - int[] vertexAttrSizes) - - New methods: - public int getVertexAttrCount() - public void getVertexAttrSizes(int[] vertexAttrSizes) - public void setVertexAttr(int vertexAttrNum, int index, - float[] vertexAttr) - public void setVertexAttr(int vertexAttrNum, int index, - Point2f vertexAttr) - public void setVertexAttr(int vertexAttrNum, int index, - Point3f vertexAttr) - public void setVertexAttr(int vertexAttrNum, int index, - Point4f vertexAttr) - public void setVertexAttrs(int vertexAttrNum, int index, - float[] vertexAttrs) - public void setVertexAttrs(int vertexAttrNum, int index, - Point2f[] vertexAttrs) - public void setVertexAttrs(int vertexAttrNum, int index, - Point3f[] vertexAttrs) - public void setVertexAttrs(int vertexAttrNum, int index, - Point4f[] vertexAttrs) - public void setVertexAttrs(int vertexAttrNum, int index, - float[] vertexAttrs, - int start, int length) - public void setVertexAttrs(int vertexAttrNum, int index, - Point2f[] vertexAttrs, - int start, int length) - public void setVertexAttrs(int vertexAttrNum, int index, - Point3f[] vertexAttrs, - int start, int length) - public void setVertexAttrs(int vertexAttrNum, int index, - Point4f[] vertexAttrs, - int start, int length) - public void getVertexAttr(int vertexAttrNum, int index, - float[] vertexAttr) - public void getVertexAttr(int vertexAttrNum, int index, - Point2f vertexAttr) - public void getVertexAttr(int vertexAttrNum, int index, - Point3f vertexAttr) - public void getVertexAttr(int vertexAttrNum, int index, - Point4f vertexAttr) - public void getVertexAttrs(int vertexAttrNum, int index, - float[] vertexAttrs) - public void getVertexAttrs(int vertexAttrNum, int index, - Point2f[] vertexAttrs) - public void getVertexAttrs(int vertexAttrNum, int index, - Point3f[] vertexAttrs) - public void getVertexAttrs(int vertexAttrNum, int index, - Point4f[] vertexAttrs) - public void setInitialVertexAttrIndex(int vertexAttrNum, - int initialVertexAttrIndex) - public int getInitialVertexAttrIndex(int vertexAttrNum) - public void setVertexAttrRefBuffer(int vertexAttrNum, J3DBuffer vertexAttrs) - public J3DBuffer getVertexAttrRefBuffer(int vertexAttrNum) - public void setVertexAttrRefFloat(int vertexAttrNum, float[] vertexAttrs) - public float[] getVertexAttrRefFloat(int vertexAttrNum) - - - TriangleArray - ------------- - New constructors: - public TriangleArray(int vertexCount, - int vertexFormat, - int texCoordSetCount, - int[] texCoordSetMap, - int vertexAttrCount, - int[] vertexAttrSizes) - - - Node - ---- - New fields: - public static final int ALLOW_PARENT_READ - public static final int ALLOW_LOCALE_READ - - New methods: - public Locale getLocale() - - - VirtualUniverse - --------------- - New methods: - public void addGraphStructureChangeListener(GraphStructureChangeListener listener) - public void removeGraphStructureChangeListener(GraphStructureChangeListener listener) - public void addShaderErrorListener(ShaderErrorListener listener) - public void removeShaderErrorListener(ShaderErrorListener listener) - - - Locale - ------ - New methods: - public PickInfo[] pickAll( int mode, int flags, PickShape pickShape ) - public PickInfo[] pickAllSorted( int mode, int flags, PickShape pickShape ) - public PickInfo pickClosest( int mode, int flags, PickShape pickShape ) - public PickInfo pickAny( int mode, int flags, PickShape pickShape ) - - - BranchGroup - ----------- - New methods: - public PickInfo[] pickAll( int mode, int flags, PickShape pickShape ) - public PickInfo[] pickAllSorted( int mode, int flags, PickShape pickShape ) - public PickInfo pickClosest( int mode, int flags, PickShape pickShape ) - public PickInfo pickAny( int mode, int flags, PickShape pickShape ) - - - Sensor - ------ - Deprecated fields: - public static final int PREDICT_NONE - public static final int PREDICT_NEXT_FRAME_TIME - public static final int NO_PREDICTOR - public static final int HEAD_PREDICTOR - public static final int HAND_PREDICTOR - - Deprecated methods: - public void setPredictor(int predictor) - public int getPredictor() - public void setPredictionPolicy(int policy) - public int getPredictionPolicy() - public void getRead(Transform3D read, long deltaT) - - - RenderingAttributes - ----------- - New fields: - public static final int ALLOW_DEPTH_TEST_FUNCTION_READ - public static final int ALLOW_DEPTH_TEST_FUNCTION_WRITE - - New constructors: - public RenderingAttributes(boolean depthBufferEnable, - boolean depthBufferWriteEnable, - int depthTestFunction, - float alphaTestValue, - int alphaTestFunction, - boolean visible, - boolean ignoreVertexColors, - boolean rasterOpEnable, - int rasterOp) - - New methods: - public void setDepthTestFunction(int function) - public int getDepthTestFunction() - - -II. Reparented classes - - NONE - - -III. New classes and interfaces (in javax.media.j3d) - - ShaderAppearance - ---------------- - public class ShaderAppearance extends Appearance - - ShaderAttributeSet - ------------------ - public class ShaderAttributeSet extends NodeComponent - - ShaderAttribute - --------------- - public abstract class ShaderAttribute extends NodeComponent - - ShaderAttributeBinding - ---------------------- - public class ShaderAttributeBinding extends ShaderAttribute - - ShaderAttributeObject - --------------------- - public abstract class ShaderAttributeObject extends ShaderAttribute - - ShaderAttributeValue - -------------------- - public class ShaderAttributeValue extends ShaderAttributeObject - - ShaderAttributeArray - -------------------- - public class ShaderAttributeArray extends ShaderAttributeObject - - Shader - ------ - public abstract class Shader extends NodeComponent - - SourceCodeShader - ---------------- - public class SourceCodeShader extends Shader - - ShaderProgram - ------------- - public abstract class ShaderProgram extends NodeComponent - - CgShaderProgram - --------------- - public class CgShaderProgram extends ShaderProgram - - GLSLShaderProgram - ----------------- - public class GLSLShaderProgram extends ShaderProgram - - ShaderError - ----------- - public class ShaderError extends Object - - ShaderErrorListener - ------------------- - public interface ShaderErrorListener - - GraphStructureChangeListener - ---------------------------- - public interface GraphStructureChangeListener - - PickInfo - -------- - public class PickInfo extends Object - - PickInfo.IntersectionInfo - ------------------------- - public class PickInfo.IntersectionInfo extends Object - - -IV. Deprecated classes and interfaces (in javax.media.j3d) - - CompressedGeometry - CompressedGeometryHeader - PickPoint - Morph -</pre> -<p><font color="gray">Page last updated — -$Date$ -</font></p> +<h2>Obsolete Page</h2> +<p>This page is obsolete. Click <a + href="http://wiki.java.net/bin/view/Javadesktop/Java3DRoadmap">here</a> +to go the Java 3D Roadmap page of the Java 3D Wiki.</p> </body> </html> diff --git a/www/j3d1_4/improvements.html b/www/j3d1_4/improvements.html index de58211..4cdc828 100644 --- a/www/j3d1_4/improvements.html +++ b/www/j3d1_4/improvements.html @@ -3,68 +3,12 @@ <head> <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"> - <title>Possible Java 3D 1.4 Improvements</title> + <title>Obsolete Page</title> </head> <body> -<h2>Possible Java 3D<sup><font size="-2">TM</font></sup> 1.4 -Improvements</h2> -<p>This page lists the possible improvements to the implementation -of Java 3D<sup><font size="-2">TM</font></sup> version 1.4 that do -not require API changes. Click on the following -link to see a description of the <a href="proposed-changes.html">proposed -Java 3D -1.4 API changes</a>. -</p> -<h4>List of possible improvements</h4> -<p>Here is a list of newly-filed issues that represent possible -improvements to Java 3D. This list is not prioritized, nor are any -of -these improvements guaranteed to be implemented. -</p> -<ul> - <li>Texture optimizations:</li> - <ul> - <li>Sub-texture image optimization (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=117">Issue 117</a>)</li> - <li>Native support for ABGR format (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=85">Issue 85</a>)</li> - <li>Use Pixel Buffer Objects (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=118">Issue 118</a>)</li> - <li>Use OpenGL automatic mipmap generation (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=126">Issue 126</a>)</li> - </ul> - <li>Geometry optimization:</li> - <ul> - <li>Use Vertex Buffer Objects (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=119">Issue 119</a>)</li> - </ul> - <li>SetLive/ ClearLive MT cleanup (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=120">Issue 120</a>)</li> - <li>Stop using finalize() to cleanup state (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=121">Issue 121</a>)</li> - <li>Collection class usage: (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=122">Issue 122</a>)</li> - <ul> - <li>Use Set versus List when appropriate</li> - <li>Use generic Collection rather than j3d-specific classes (e.g., -UnorderList)</li> - </ul> - <li>Eliminate memory free lists (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=123">Issue 123</a>)</li> - <li>Improve picking performance / reduce garbage generation (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=124">Issue 124</a>)</li> - <li>Optimize CanvasViewCache to eliminate redundant operations & -garbage generation (<a - href="https://java3d.dev.java.net/issues/show_bug.cgi?id=125">Issue 125</a>) - </li> -</ul> -<p>Note that these new issues are in addition to any other issues that -have been filed. For a complete list, <a - href="https://java3d.dev.java.net/issues/buglist.cgi?Submit+query=Submit+query&component=java3d&issue_status=NEW&issue_status=STARTED&issue_status=REOPENED">query -the list of issues</a>. -</p> -<p><font color="gray">Page last updated — -$Date$ -</font></p> +<h2>Obsolete Page</h2> +<p>This page is obsolete. Click <a + href="http://wiki.java.net/bin/view/Javadesktop/Java3DRoadmap">here</a> +to go the Java 3D Roadmap page of the Java 3D Wiki.</p> </body> </html> diff --git a/www/j3d1_4/proposed-changes.html b/www/j3d1_4/proposed-changes.html index 2109fdb..4cdc828 100644 --- a/www/j3d1_4/proposed-changes.html +++ b/www/j3d1_4/proposed-changes.html @@ -1,221 +1,14 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> - <meta http-equiv="content-type" - content="text/html; charset=ISO-8859-1"> - <title>Proposed Java 3D API Changes</title> + <meta content="text/html; charset=ISO-8859-1" + http-equiv="content-type"> + <title>Obsolete Page</title> </head> <body> -<h2>Proposed Java 3D<sup><font size="-2">TM</font></sup> API -Changes</h2> -<p>This page highlights the proposed changes to the 1.4 version of the -Java 3D<sup><font size="-2">TM</font></sup> API, and beyond. For a -list of new -classes methods, etc., see the <a href="api-changes.html">List of -Proposed Java 3D 1.4 API -Changes</a>. Click -<a href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/index.html">here</a> -for the -<a href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/index.html">latest -javadocs for the proposed 1.4 API</a> (built from the dev-1_4 branch). -A list of other <a href="improvements.html">possible improvements to -Java 3D version 1.4</a> is also available. -</p> -<table style="text-align: left; width: 100%;" border="0" cellspacing="4" - cellpadding="4"> - <tbody> - <tr> - <td - style="text-align: left; vertical-align: top; background-color: rgb(255, 255, 225); width: 60%;"> - <h3>1.4 Committed Features<br> - </h3> - <p>This list of high priority features will almost certainly make -it -into the 1.4 version of the Java 3D API.</p> - <div style="margin-left: 26px;">In Process:<br> - </div> - <ul> - <li><a href="shaders.html">Programmable -Shaders</a></li> - <li>Additional blending functions: <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/TransparencyAttributes.html#BLEND_SRC_COLOR"><code>BLEND_SRC_COLOR</code></a>, - <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/TransparencyAttributes.html#BLEND_ONE_MINUS_SRC_COLOR"><code>BLEND_ONE_MINUS_SRC_COLOR</code></a>, - <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/TransparencyAttributes.html#BLEND_DST_COLOR"><code>BLEND_DST_COLOR</code></a>, - <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/TransparencyAttributes.html#BLEND_ONE_MINUS_DST_COLOR"><code>BLEND_ONE_MINUS_DST_COLOR</code></a>.</li> - <li><a href="picking.html">Additional -core picking methods</a> (in -Locale and BranchGroup)</li> - <li><a href="stencil.html">Stencil -buffer</a><br> - </li> - </ul> - <div style="margin-left: 26px;">Completed:<br> - </div> - <ul> - <li><a href="graph-change-listener.html">Scene -graph structure change -listeners</a></li> - <li><a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/SceneGraphObject.html#setName%28java.lang.String%29">Name -string</a> for all scene graph objects: add public <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/SceneGraphObject.html#setName%28java.lang.String%29"><code>get/setName(String)</code></a> -to <code>SceneGraphObject</code> -class</li> - <li>New <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/Node.html#ALLOW_PARENT_READ"><code>ALLOW_PARENT_READ</code></a> -capability bit in <code>Node</code> -class that will allow <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/Node.html#getParent%28%29"><code>getParent()</code></a> -to be called on live/compiled scene graph</li> - <li>Ability to get the locale from a live node: add public <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/Node.html#getLocale%28%29"><code>getLocale()</code></a> -method and <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/Node.html#ALLOW_LOCALE_READ"><code>ALLOW_LOCALE_READ</code></a> -capability bit to <code>Node</code> -class</li> - <li>Add a new attribute for depth test function to -RenderingAttributes: public <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/RenderingAttributes.html#setDepthTestFunction%28int%29"><code>get/setDepthTestFunction(int function)</code></a> -methods that takes as values one of: <code>ALWAYS, NEVER, -EQUAL, NOT_EQUAL, LESS, LESS_OR_EQUAL, GREATER, GREATER_OR_EQUAL</code>. -The default value is <code>LESS_OR_EQUAL</code> for backward -compatibility.</li> - <li>Method to retrieve the geometry data from the tessellation -of a glyph in a 3D font: a public <a - href="http://download.java.net/media/java3d/javadoc/1.4.0-latest/javax/media/j3d/Font3D.html#getGlyphGeometry%28char%29"><code>GeometryArray getGlyphGeometry(char glyphCode)</code></a> -method in the <code>Font3D</code> class</li> - </ul> - <p>This is a list of features that we propose to <a - href="#Footnote_1">deprecate<sup>1</sup></a> in -the API.<br> - </p> - <ul> - <li><code>CompressedGeometry</code> class (no HW support, lack -of -industry -acceptance)</li> - <li>Sensor prediction (has never been implemented)<br> - </li> - <li><code>PickPoint</code> class (not fully implemented, cannot -be -used for -geometry-based picking; use PickBounds with -a -BoundingSphere that has a small radius)</li> - <li><code></code><code>Morph</code> node (expensive, picking -doesn't -work, -can be done -in a utility)</li> - </ul> - </td> - <td - style="text-align: left; vertical-align: top; background-color: rgb(235, 255, 235); width: 40%;" - colspan="1" rowspan="4"> - <h3>Other Features for 1.4, 1.5, ...<br> - </h3> - <p>This list of medium priority features is under discussion for -possible inclusion -into the 1.4 or 1.5 API (or beyond). </p> - <ul> - <li><a href="lightweight-canvas3d.html">Lightweight -Canvas3D (e.g., -JCanvas3D)</a>. <span style="color: rgb(204, 0, 0);">Note: this -feature -will not -happen -without an someone from the community volunteering -to drive it.</span></li> - </ul> - <span style="color: rgb(204, 0, 0);"></span> - <ul> - <li>Non-power-of-two textures</li> - <li>Point sprites</li> - <li><a href="vsg-op.html">Ability -for nested ViewSpecificGroup nodes -to replace the set of views</a><br> - </li> - <li>API support for retained alpha buffers</li> - <li>Ability to query properties from a <code>GraphicsConfiguration</code></li> - <li>Better support for off-screen configuration parameters -(e.g., an -attribute in <code>GraphicsConfigTemplate3D</code> indicating whether -the requested <code>GraphicsConfiguration</code> is used for on-screen -rendering, -off-screen rendering, or both)</li> - <li>Enhance <code>getLocalToVWorld()</code> to return a valid -result -for non-live graphs.</li> - <li>Additional texture formats: - <ul> - <li>NIO buffer support</li> - <li>Texture compression formats</li> - </ul> - </li> - </ul> - </td> - </tr> - <tr> - <td - style="text-align: left; vertical-align: top; background-color: rgb(255, 255, 203); width: 60%;"> - <h3>1.5 Proposed Major Features</h3> - <p>This list of high priority features is being seriously -considered for the 1.5 version of the Java 3D API.</p> - <ul> - <li><a href="render-texture.html">Render to texture</a></li> - <li><a href="multipass.html">Multipass rendering</a></li> - <li>Shadow map support</li> - </ul> - </td> - </tr> - <tr> - <td - style="text-align: left; vertical-align: top; background-color: rgb(255, 255, 182); width: 60%;"> - <h3>1.6 Possible Major Features</h3> - <p><span style="font-style: italic;">Not yet planned</span><br> - </p> - </td> - </tr> - <tr> - <td - style="text-align: left; vertical-align: top; background-color: rgb(255, 255, 164); width: 60%;"> - <h3><a name="Future_Features"></a>2.0 Possible Major Features</h3> - <p>Here is an unprioritized list of possible features under -consideration for a future 2.0 version of the Java 3D API. </p> - <ul> - <li>Extensibility: - <ul> - <li>Access to the native context (JOGL integration)</li> - <li>Geometry extensibility</li> - <li>Additional node types (e.g., haptic rendering)</li> - <li>Extensible geometry processing algorithms</li> - </ul> - </li> - <li>Plug-in capability - <ul> - <li>Rendering Device Interface (pluggable renderers)</li> - <li>Visibility structure</li> - </ul> - </li> - </ul> - </td> - </tr> - </tbody> -</table> -<p><small><a name="Footnote_1"></a>1 – Note that deprecated -features will not actually be removed. It -instead -reflects a decrease of emphasis on these features. While they should -continue -to function normally, no additional effort is likely to be put into -them (for example, compressed geometry will not be supported with -programmable shaders). This action paves the way to remove them from a -future major release (e.g., a 2.0 release).</small></p> -<p><font color="gray">Page last updated — -$Date$ -</font></p> +<h2>Obsolete Page</h2> +<p>This page is obsolete. Click <a + href="http://wiki.java.net/bin/view/Javadesktop/Java3DRoadmap">here</a> +to go the Java 3D Roadmap page of the Java 3D Wiki.</p> </body> </html> |