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
|
/*
* Copyright 1997-2008 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
* CA 95054 USA or visit www.sun.com if you need additional information or
* have any questions.
*
*/
package javax.media.j3d;
/**
* A 2D array of depth (Z) values in floating point format in the range [0,1].
* A value of 0.0 indicates the closest Z value to the user while a value of
* 1.0 indicates the farthest Z value.
*/
public class DepthComponentFloat extends DepthComponent {
/**
* Package scope defualt constructor used by cloneNodeComponent
*/
DepthComponentFloat() {
}
/**
* Constructs a new floating-point depth (z-buffer) component object with
* the specified width and height.
* @param width the width of the array of depth values
* @param height the height of the array of depth values
*/
public DepthComponentFloat(int width, int height) {
((DepthComponentFloatRetained)this.retained).initialize(width, height);
}
/**
* Copies the specified depth data to this object.
* @param depthData array of floats containing the depth data
* @exception RestrictedAccessException if the method is called
* when this object is part of live or compiled scene graph.
*/
public void setDepthData(float[] depthData) {
checkForLiveOrCompiled();
((DepthComponentFloatRetained)this.retained).setDepthData(depthData);
}
/**
* Copies the depth data from this object to the specified array.
* The array must be large enough to hold all of the floats.
* @param depthData array of floats that will receive a copy of
* the depth data
* @exception CapabilityNotSetException if appropriate capability is
* not set and this object is part of live or compiled scene graph
*/
public void getDepthData(float[] depthData) {
if (isLiveOrCompiled())
if (!this.getCapability(DepthComponent.ALLOW_DATA_READ))
throw new CapabilityNotSetException(J3dI18N.getString("DepthComponentFloat0"));
((DepthComponentFloatRetained)this.retained).getDepthData(depthData);
}
/**
* Creates a retained mode DepthComponentFloatRetained object that this
* DepthComponentFloat component object will point to.
*/
@Override
void createRetained() {
this.retained = new DepthComponentFloatRetained();
this.retained.setSource(this);
}
/**
* @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
*/
@Override
public NodeComponent cloneNodeComponent() {
DepthComponentFloatRetained rt = (DepthComponentFloatRetained) retained;
DepthComponentFloat d = new DepthComponentFloat(rt.width,
rt.height);
d.duplicateNodeComponent(this);
return d;
}
/**
* Copies all node information from <code>originalNodeComponent</code> into
* the current node. This method is called from the
* <code>duplicateNode</code> method. This routine does
* the actual duplication of all "local data" (any data defined in
* this object).
*
* @param originalNodeComponent the original node to duplicate.
* @param forceDuplicate when set to <code>true</code>, causes the
* <code>duplicateOnCloneTree</code> flag to be ignored. When
* <code>false</code>, the value of each node's
* <code>duplicateOnCloneTree</code> variable determines whether
* NodeComponent data is duplicated or copied.
*
* @see Node#cloneTree
* @see NodeComponent#setDuplicateOnCloneTree
*/
@Override
void duplicateAttributes(NodeComponent originalNodeComponent,
boolean forceDuplicate) {
super.duplicateAttributes(originalNodeComponent,
forceDuplicate);
// width, height is copied in cloneNode before
int len = getWidth()*getHeight();
float f[] = new float[len];
((DepthComponentFloatRetained) originalNodeComponent.retained).getDepthData(f);
((DepthComponentFloatRetained) retained).setDepthData(f);
}
}
|
