1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="content-type">
<title>Java 3D 1.4 Change Log</title>
</head>
<body>
<h1>Java 3D API version 1.4 Change Log</h1>
<p>Here are the proposed changes for Java 3D version 1.4. These
proposed changes are a results of discussion and collaboration with the
Java 3D community on java.net (see
<a href="https://java3d.dev.java.net">https://java3d.dev.java.net</a>).
They are already part of daily and periodic stable builds available on
java.net.</p>
<h2>I. Proposed Changes</h2>
<p><br>
</p>
<h2>II. Accepted Changes</h2>
<p>Here is the list of accepted changes for the Java 3D 1.4 API:<br>
</p>
<ol>
<li><a href="#Programmable_shader_support">Programmable shader support</a></li>
<li><a href="#Default_values">Default values for read capability bits</a></li>
<li><a href="#Picking">Picking</a></li>
<li><a href="#Stencil">Stencil</a></li>
<li><a href="#Rendering_attributes">Rendering attributes</a></li>
<li><a href="#Other_minor_features">Other minor features</a></li>
<li><a href="#Deprecated_API">Deprecated API</a><br>
</li>
</ol>
<p>For a complete description of these changes, please see the
proposed API specification (javadoc) for the 1.4 version of the
Java 3D API.
</p>
<h3><a name="Programmable_shader_support"></a>1. Programmable shader
support<br>
</h3>
<p>We propose to add programmable shader support to Java 3D 1.4.
This is
the primary new feature of this release.<br>
</p>
<p>The following new classes and interfaces are added in
the <code>javax.media.j3d</code> package:<br>
</p>
<ul>
<code>public class <span style="font-weight: bold;">ShaderAppearance</span>
extends Appearance<br>
public class <span style="font-weight: bold;">ShaderAttributeSet</span>
extends
NodeComponent<br>
public abstract class <span style="font-weight: bold;">ShaderAttribute</span>
extends
NodeComponent<br>
public class <span style="font-weight: bold;">ShaderAttributeBinding</span>
extends
ShaderAttribute<br>
public abstract class <span style="font-weight: bold;">ShaderAttributeObject</span>
extends ShaderAttribute<br>
public class <span style="font-weight: bold;">ShaderAttributeValue</span>
extends
ShaderAttributeObject<br>
public class <span style="font-weight: bold;">ShaderAttributeArray</span>
extends
ShaderAttributeObject<br>
public abstract class <span style="font-weight: bold;">Shader</span>
extends
NodeComponent<br>
public class <span style="font-weight: bold;">SourceCodeShader</span>
extends Shader<br>
public abstract class <span style="font-weight: bold;">ShaderProgram</span>
extends
NodeComponent<br>
public class <span style="font-weight: bold;">CgShaderProgram</span>
extends
ShaderProgram<br>
public class <span style="font-weight: bold;">GLSLShaderProgram</span>
extends
ShaderProgram<br>
public class <span style="font-weight: bold;">ShaderError</span>
extends Object<br>
public interface <span style="font-weight: bold;">ShaderErrorListener</span><br>
<br>
</code>
</ul>
<p>The following new classes are added in the
<code>javax.vecmath</code> package:<br>
</p>
<ul>
<code>public abstract class <span style="font-weight: bold;">Tuple2i</span>
implements Serializable, Cloneable<br>
public class <span style="font-weight: bold;">Point2i</span> extends
Tuple2i<br>
</code>
</ul>
<p>The following new fields, constructors, and methods are added to
existing classes:<br>
</p>
<ul>
<code><span style="font-weight: bold; text-decoration: underline;">Canvas3D</span><br>
New method:<br>
public boolean isShadingLanguageSupported(int
shadingLanguage)<br>
<br>
</code><code><span
style="font-weight: bold; text-decoration: underline;">VirtualUniverse</span><br>
New methods:<br>
public void
addShaderErrorListener(ShaderErrorListener listener)<br>
public void
removeShaderErrorListener(ShaderErrorListener listener)<br>
<br>
</code><code></code><code><span
style="font-weight: bold; text-decoration: underline;">GeometryArray</span><br>
New fields:<br>
public static final int ALLOW_VERTEX_ATTR_READ<br>
public static final int ALLOW_VERTEX_ATTR_WRITE<br>
public static final int VERTEX_ATTRIBUTES<br>
<br>
New constructor:<br>
public GeometryArray(... int
vertexAttrCount, int[]
vertexAttrSizes)<br>
<br>
New methods:<br>
public int getVertexAttrCount()<br>
public void getVertexAttrSizes(int[]
vertexAttrSizes)<br>
public void setVertexAttr(int vertexAttrNum,
int index, float[]
vertexAttr)<br>
public void setVertexAttr(int vertexAttrNum,
int index, Point2f
vertexAttr)<br>
public void setVertexAttr(int vertexAttrNum,
int index, Point3f
vertexAttr)<br>
public void setVertexAttr(int vertexAttrNum,
int index, Point4f
vertexAttr)<br>
public void setVertexAttrs(int vertexAttrNum,
int index, float[]
vertexAttrs)<br>
public void setVertexAttrs(int vertexAttrNum,
int index, Point2f[]
vertexAttrs)<br>
public void setVertexAttrs(int vertexAttrNum,
int index, Point3f[]
vertexAttrs)<br>
public void setVertexAttrs(int vertexAttrNum,
int index, Point4f[]
vertexAttrs)<br>
public void setVertexAttrs(int vertexAttrNum,
int index,<br>
float[]
vertexAttrs, int
start, int length)<br>
public void setVertexAttrs(int vertexAttrNum,
int index,<br>
Point2f[]
vertexAttrs, int
start, int length)<br>
public void setVertexAttrs(int vertexAttrNum,
int index,<br>
Point3f[]
vertexAttrs, int
start, int length)<br>
public void setVertexAttrs(int vertexAttrNum,
int index,<br>
Point4f[]
vertexAttrs, int
start, int length)<br>
public void getVertexAttr(int vertexAttrNum,
int index, float[]
vertexAttr)<br>
public void getVertexAttr(int vertexAttrNum,
int index, Point2f
vertexAttr)<br>
public void getVertexAttr(int vertexAttrNum,
int index, Point3f
vertexAttr)<br>
public void getVertexAttr(int vertexAttrNum,
int index, Point4f
vertexAttr)<br>
public void getVertexAttrs(int vertexAttrNum,
int index, float[]
vertexAttrs)<br>
public void getVertexAttrs(int vertexAttrNum,
int index, Point2f[]
vertexAttrs)<br>
public void getVertexAttrs(int vertexAttrNum,
int index, Point3f[]
vertexAttrs)<br>
public void getVertexAttrs(int vertexAttrNum,
int index, Point4f[]
vertexAttrs)<br>
public void setInitialVertexAttrIndex(int
vertexAttrNum, int
initialVertexAttrIndex)<br>
public int getInitialVertexAttrIndex(int
vertexAttrNum)<br>
public void setVertexAttrRefBuffer(int
vertexAttrNum, J3DBuffer vertexAttrs)<br>
public J3DBuffer getVertexAttrRefBuffer(int
vertexAttrNum)<br>
public void setVertexAttrRefFloat(int
vertexAttrNum, float[] vertexAttrs)<br>
public float[] getVertexAttrRefFloat(int
vertexAttrNum)<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedGeometryArray</span><br>
New fields:<br>
public static final int
ALLOW_VERTEX_ATTR_INDEX_READ<br>
public static final int
ALLOW_VERTEX_ATTR_INDEX_WRITE<br>
<br>
New constructor:<br>
public IndexedGeometryArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
New methods:<br>
public void setInitialVertexAttrIndex(int
vertexAttrNum, int
initialVertexAttrIndex)<br>
public void setVertexAttrIndex(int
vertexAttrNum, int
index, int
vertexAttrIndex)<br>
public void setVertexAttrIndices(int
vertexAttrNum, int
index, int[]
vertexAttrIndices)<br>
public int getVertexAttrIndex(int
vertexAttrNum, int index)<br>
public void getVertexAttrIndices(int
vertexAttrNum, int
index, int[]
vertexAttrIndices)<br>
<br>
</code>
</ul>
<p>The following new constructors are added to
existing GeometryArray subclasses:</p>
<ul>
<code> <span style="font-weight: bold; text-decoration: underline;">PointArray</span><br>
public PointArray(... int vertexAttrCount,
int[] vertexAttrSizes)<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">LineArray</span><br>
public LineArray(... int vertexAttrCount, int[]
vertexAttrSizes)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">TriangleArray</span><br>
public TriangleArray(... int vertexAttrCount,
int[] vertexAttrSizes)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">QuadArray</span><br>
public QuadArray(... int vertexAttrCount, int[]
vertexAttrSizes)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">GeometryStripArray</span><br>
public GeometryStripArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">LineStripArray</span><br>
public LineStripArray(... int vertexAttrCount,
int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">TriangleStripArray</span><br>
public TriangleStripArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="text-decoration: underline; font-weight: bold;">TriangleFanArray</span><br>
public TriangleFanArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedPointArray</span><br>
public IndexedPointArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedLineArray</span><br>
public IndexedLineArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedTriangleArray</span><br>
public IndexedTriangleArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedQuadArray</span><br>
public IndexedQuadArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedGeometryStripArray</span><br>
public IndexedGeometryStripArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedLineStripArray</span><br>
public IndexedLineStripArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">IndexedTriangleStripArray</span><br>
public IndexedTriangleStripArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
<br>
<br>
<span style="text-decoration: underline; font-weight: bold;">IndexedTriangleFanArray</span><br>
public IndexedTriangleFanArray(... int
vertexAttrCount, int[] vertexAttrSizes ...)<br>
</code>
</ul>
<p><br>
</p>
<h3><a name="Default_values"></a>2. Default values for read capability
bits<br>
</h3>
<p>Capability bits control whether data in a Java 3D scene graph
object
may be read or written when it is part of a live or compiled subgraph.
We propose to change the default value for all read capability bits to
true, meaning that all attributes may be read by default (the default
value for all write capability bits will remain false, meaning that no
attributes may be written by default). Note that read capability bits
are defined as those capability bits of the form <code>ALLOW_*_READ</code>,
plus the <code>ALLOW_INTERSECT</code> capability bit.<br>
</p>
<code></code>
<p><br>
</p>
<h3><a name="Picking"></a>3. Picking<br>
</h3>
<p>We propose to add a new PickInfo class (with an inner class to hold
intersection information), and new core picking methods that return
objects of this new class type.<br>
</p>
<p>New Classes:<br>
</p>
<ul>
<code><span style="font-weight: bold; text-decoration: underline;"></span>public
class <span style="font-weight: bold;">PickInfo</span> extends Object<br>
public class <span style="font-weight: bold;">PickInfo.IntersectionInfo</span>
extends
Object<br>
</code>
</ul>
<p>New methods:<br>
</p>
<ul>
<code><span style="font-weight: bold; text-decoration: underline;">Locale</span><br>
public PickInfo[] pickAll( int mode, int flags,
PickShape pickShape )<br>
public PickInfo[] pickAllSorted( int mode, int
flags, PickShape pickShape )<br>
public PickInfo pickClosest( int mode, int
flags, PickShape pickShape )<br>
public PickInfo pickAny( int mode, int flags,
PickShape pickShape )<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">BranchGroup</span><br>
public PickInfo[] pickAll( int mode, int flags,
PickShape pickShape )<br>
public PickInfo[] pickAllSorted( int mode, int
flags, PickShape pickShape )<br>
public PickInfo pickClosest( int mode, int
flags, PickShape pickShape )<br>
public PickInfo pickAny( int mode, int flags,
PickShape pickShape )</code>
</ul>
<p><br>
</p>
<h3><a name="Stencil"></a>4. Stencil<br>
</h3>
<p>We propose new stencil functionality. Here are the proposed new
fields and methods:<br>
</p>
<ul>
<code> </code><code><span
style="font-weight: bold; text-decoration: underline;">RenderingAttributes</span><br>
New fields:<br>
</code><code> public static final int
ALLOW_STENCIL_ATTRIBUTES_READ<br>
public static final int
ALLOW_STENCIL_ATTRIBUTES_WRITE<br>
</code><code> public static final int STENCIL_KEEP<br>
public static final int STENCIL_ZERO<br>
public static final int STENCIL_REPLACE<br>
public static final int STENCIL_INCR<br>
public static final int STENCIL_DECR<br>
public static final int STENCIL_INVERT<br>
<br>
New methods:<br>
public void setStencilEnable(boolean enable)<br>
public boolean getStencilEnable()<br>
public void setStencilOp(int failOp, int
zFailOp, int zPassOp)<br>
public void setStencilOp(int[] stencilOps)<br>
public void getStencilOp(int[] stencilOps)<br>
public void setStencilFunction(int function,
int refValue, int compareMask)<br>
public void setStencilFunction(int[] params)<br>
public void getStencilFunction(int[] params)<br>
public void setStencilWriteMask(int mask)<br>
public int getStencilWriteMask()<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">GraphicsConfigTemplate3D</span><br>
New methods:<br>
public void setStencilSize(int value)<br>
public int getStencilSize()<br>
</code>
</ul>
<p><br>
</p>
<h3><a name="Rendering_attributes"></a>5. Rendering attributes<br>
</h3>
<p>We propose to add new rendering attributes/modes to enable
applications to specify the depth test function, additional raster
operations, and additional blending modes. The new fields and methods
are as follows:<br>
</p>
<ul>
<code> <span style="text-decoration: underline; font-weight: bold;">RenderingAttributes</span><br>
New fields:<br>
public static final int
ALLOW_DEPTH_TEST_FUNCTION_READ<br>
public static final int
ALLOW_DEPTH_TEST_FUNCTION_WRITE<br>
public static final int ROP_CLEAR<br>
public static final int ROP_AND<br>
public static final int ROP_AND_REVERSE<br>
public static final int ROP_AND_INVERTED<br>
public static final int ROP_NOOP<br>
public static final int ROP_OR<br>
public static final int ROP_NOR<br>
public static final int ROP_EQUIV<br>
public static final int ROP_INVERT<br>
public static final int ROP_OR_REVERSE<br>
public static final int ROP_COPY_INVERTED<br>
public static final int ROP_OR_INVERTED<br>
public static final int ROP_NAND<br>
public static final int ROP_SET<br>
<br>
New methods:<br>
</code><code> public void setDepthTestFunction(int
function)<br>
public int getDepthTestFunction()<br>
</code><br>
<code></code><code><span
style="font-weight: bold; text-decoration: underline;">TransparencyAttributes</span><br>
New fields:<br>
public static final int BLEND_DST_COLOR<br>
public static final int
BLEND_ONE_MINUS_DST_COLOR<br>
public static final int BLEND_SRC_COLOR<br>
public static final int
BLEND_ONE_MINUS_SRC_COLOR<br>
</code>
</ul>
<p><br>
</p>
<h3><a name="Other_minor_features"></a>6. Other minor features<br>
</h3>
<p>We propose to add the following new features: a name for all scene
graph objects; the ability to get the Locale or parent from a live or
compiled scene graph, a scene graph structure change listener, and a
method to get the tessellated glyph geometry for a character in a 3D
font.
</p>
<p>The following new class has been added:</p>
<ul>
<code>public interface <span style="font-weight: bold;">GraphStructureChangeListener</span><br>
</code>
</ul>
<p>The new fields and methods are as follows:</p>
<ul>
<code> <span style="font-weight: bold; text-decoration: underline;">VirtualUniverse</span><br>
New methods:<br>
public void
addGraphStructureChangeListener(GraphStructureChangeListener listener)<br>
public void
removeGraphStructureChangeListener(GraphStructureChangeListener
listener)<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">SceneGraphObject</span><br>
New methods:<br>
public void setName(String name)<br>
public String getName()<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">Node</span><br>
New fields:<br>
public static final int ALLOW_PARENT_READ<br>
public static final int ALLOW_LOCALE_READ<br>
<br>
New methods:<br>
public Locale getLocale()<br>
<br>
<br>
<span style="font-weight: bold; text-decoration: underline;">Font3D</span><br>
New methods:<br>
public GeometryArray getGlyphGeometry(char c)<br>
</code>
</ul>
<p><br>
</p>
<h3><a name="Deprecated_API"></a>7. Deprecated API<br>
</h3>
<p>We propose to deprecate the following classes:</p>
<ul>
<code> <span style="font-weight: bold;">CompressedGeometry</span><br>
<span style="font-weight: bold;">CompressedGeometryHeader</span><br>
<span style="font-weight: bold;">PickPoint</span><br>
<span style="font-weight: bold;">Morph</span><br>
</code>
</ul>
<p>We propose to deprecate the following fields and methods:</p>
<ul>
<code> <span style="font-weight: bold; text-decoration: underline;">Sensor</span><br>
Deprecated fields:<br>
public static final int PREDICT_NONE<br>
public static final int PREDICT_NEXT_FRAME_TIME<br>
public static final int NO_PREDICTOR<br>
public static final int HEAD_PREDICTOR<br>
public static final int HAND_PREDICTOR<br>
<br>
Deprecated methods:<br>
public void setPredictor(int predictor)<br>
public int getPredictor()<br>
public void setPredictionPolicy(int policy)<br>
public int getPredictionPolicy()<br>
public void getRead(Transform3D read, long
deltaT)<br>
</code>
</ul>
<p><br>
</p>
<h2>III. Deferred Changes</h2>
<p><br>
</p>
</body>
</html>
|
