aboutsummaryrefslogtreecommitdiffstats
path: root/src/javax/media/j3d/NodeComponent.java
diff options
context:
space:
mode:
authorJulien Gouesse <[email protected]>2015-11-28 15:11:48 +0100
committerJulien Gouesse <[email protected]>2015-11-28 15:11:48 +0100
commitdbc98deea1884e44da2c74d6ea807253cdefa693 (patch)
tree29c3ee7dea82d7dd773d81f33f645dde67e43a17 /src/javax/media/j3d/NodeComponent.java
parent2c99f1329dc55bd496bce91b9aba956ecba3c67e (diff)
Relocate package prefix to org.jogamp.java3d
Diffstat (limited to 'src/javax/media/j3d/NodeComponent.java')
-rw-r--r--src/javax/media/j3d/NodeComponent.java308
1 files changed, 0 insertions, 308 deletions
diff --git a/src/javax/media/j3d/NodeComponent.java b/src/javax/media/j3d/NodeComponent.java
deleted file mode 100644
index fb0d0b5..0000000
--- a/src/javax/media/j3d/NodeComponent.java
+++ /dev/null
@@ -1,308 +0,0 @@
-/*
- * 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;
-import java.util.Hashtable;
-
-/**
- * NodeComponent is a common superclass for all scene graph node
- * component objects such as: Geometry, Appearance, Material, Texture, etc.
- *
- * <p>
- * For more information, see the
- * <a href="doc-files/intro.html">Introduction to the Java 3D API</a>.
- */
-public abstract class NodeComponent extends SceneGraphObject {
-
- // This is use for cloneTree only, set to false after the operation
- boolean forceDuplicate = false;
- /**
- * Constructs a NodeComponent object with default parameters.
- * The default values are as follows:
- * <ul>
- * duplicate on clone tree : false<br>
- * </ul>
- */
- public NodeComponent() {
- }
-
- /**
- * Sets this node's duplicateOnCloneTree value. The
- * <i>duplicateOnCloneTree</i> value is used to determine if NodeComponent
- * objects are to be duplicated or referenced during a
- * <code>cloneTree</code> operation. A value of <code>true</code> means
- * that this NodeComponent object should be duplicated, while a value
- * of <code>false</code> indicates that this NodeComponent object's
- * reference will be copied into the newly cloned object. This value
- * can be overriden via the <code>forceDuplicate</code> parameter of
- * the <code>cloneTree</code> method.
- * @param duplicate the value to set.
- * @see Node#cloneTree
- */
- public void setDuplicateOnCloneTree(boolean duplicate) {
- ((NodeComponentRetained)retained).setDuplicateOnCloneTree(duplicate);
- }
-
- /**
- * Returns this node's duplicateOnCloneTree value. The
- * <i>duplicateOnCloneTree</i> value is used to determine if NodeComponent
- * objects are to be duplicated or referenced during a
- * <code>cloneTree</code> operation. A value of <code>true</code> means
- * that this NodeComponent object should be duplicated, while a value
- * of <code>false</code> indicates that this NodeComponent object's
- * reference will be copied into the newly cloned object. This value
- * can be overriden via the <code>forceDuplicate</code> parameter of
- * the <code>cloneTree</code> method.
- * @return the value of this node's duplicateOnCloneTree
- * @see Node#cloneTree
- */
- public boolean getDuplicateOnCloneTree() {
- return ((NodeComponentRetained)retained).getDuplicateOnCloneTree();
- }
-
- /**
- * @deprecated As of Java 3D version 1.2, replaced by
- * <code>cloneNodeComponent(boolean forceDuplicate)</code>
- */
- public NodeComponent cloneNodeComponent() {
- throw new RuntimeException(J3dI18N.getString("NodeComponent0"));
- }
-
-
- /**
- * NOTE: Applications should <i>not</i> call this method directly.
- * It should only be called by the cloneNode method.
- *
- * @deprecated As of Java 3D version 1.2, replaced by
- * <code>duplicateNodeComponent(NodeComponent
- * originalNodeComponent, boolean forceDuplicate)</code>
- */
- public void duplicateNodeComponent(NodeComponent originalNodeComponent) {
- duplicateAttributes(originalNodeComponent,
- originalNodeComponent.forceDuplicate);
- }
-
- /**
- * Copies all node information from <code>originalNodeComponent</code> into
- * the current node component. This method is called from subclass of
- * <code>duplicateNodeComponent</code> method which is, in turn, called by the
- * <code>cloneNodeComponent</code> method.
- *
- * For any <i>NodeComponent</i> objects
- * contained by the object being duplicated, each <i>NodeComponent</i>
- * object's <code>duplicateOnCloneTree</code> value is used to determine
- * whether the <i>NodeComponent<i> should be duplicated in the new node
- * or if just a reference to the current node should be placed in the
- * new node. This flag can be overridden by setting the
- * <code>forceDuplicate</code> parameter in the <code>cloneTree</code>
- * method to <code>true</code>.
- *
- * @param originalNodeComponent the original node component to duplicate.
- */
- final void checkDuplicateNodeComponent(
- NodeComponent originalNodeComponent) {
-
- if (originalNodeComponent.nodeHashtable != null) {
- duplicateAttributes(originalNodeComponent,
- originalNodeComponent.forceDuplicate);
- } else {
- // user call cloneNodeComponent() or duplicateNodeComponent()
- // directly instead of via cloneTree()
- originalNodeComponent.nodeHashtable = new Hashtable();
- duplicateAttributes(originalNodeComponent,
- originalNodeComponent.forceDuplicate);
- originalNodeComponent.nodeHashtable = null;
- }
- }
-
- /**
- * Copies all node information from <code>originalNodeComponent</code>
- * into the current node. This method is called from the
- * <code>cloneNodeComponent</code> method which is, in turn, called
- * by the <code>cloneNode</code> method.
- * <br>
- * NOTE: Applications should <i>not</i> call this method directly.
- * It should only be called by the cloneNode method.
- *
- * @param originalNodeComponent the 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.
- *
- * @exception RestrictedAccessException if forceDuplicate is set and
- * this object is part of a compiled scenegraph
- *
- * @see NodeComponent#cloneNodeComponent
- * @see Node#cloneNode
- * @see Node#cloneTree
- *
- * @since Java 3D 1.2
- */
- public void duplicateNodeComponent(NodeComponent originalNodeComponent,
- boolean forceDuplicate) {
- originalNodeComponent.forceDuplicate = forceDuplicate;
- try {
- duplicateNodeComponent(originalNodeComponent);
- } catch (RuntimeException e) {
- originalNodeComponent.forceDuplicate = false;
- throw e;
- }
- originalNodeComponent.forceDuplicate = false;
- }
-
- /**
- * Used to create a new instance of a NodeComponent object. This
- * routine is called by <code>cloneNode</code> to duplicate the
- * current node. <br>
- *
- * <code>cloneNodeComponent</code> should be overridden by any user
- * subclassed <i>NodeComponent</i> objects. All subclasses must have their
- * <code>cloneNodeComponent</code>
- * method consist of the following lines:
- * <P><blockquote><pre>
- * public NodeComponent cloneNodeComponent(boolean forceDuplicate) {
- * UserNodeComponent unc = new UserNodeComponent();
- * unc.duplicateNodeComponent(this, forceDuplicate);
- * return unc;
- * }
- * </pre></blockquote>
- *
- * @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.
- *
- * @exception RestrictedAccessException if forceDuplicate is set and
- * this object is part of a compiled scenegraph
- *
- * @see NodeComponent#duplicateNodeComponent
- * @see Node#cloneNode
- * @see Node#cloneTree
- *
- * @since Java 3D 1.2
- */
- public NodeComponent cloneNodeComponent(boolean forceDuplicate) {
- // For backward compatibility !
- //
- // If user did not overwrite this procedure, it will fall back
- // to call cloneNodeComponent()
- // So for core API,
- // don't implement cloneNodeComponent(boolean forceDuplicate)
- // otherwise this prcedure will not call and the user
- // cloneNodeComponent() will not invoke.
- NodeComponent nc;
- this.forceDuplicate = forceDuplicate;
- try {
- nc = cloneNodeComponent();
- } catch (RuntimeException e) {
- this.forceDuplicate = false;
- throw e;
- }
- this.forceDuplicate = false;
- return nc;
- }
-
-
- /**
- * Copies all NodeComponent information from
- * <code>originalNode</code> into
- * the current node. This method is called from the
- * <code>cloneNode</code> method which is, in turn, called by the
- * <code>cloneTree</code> method.<P>
- *
- * @param originalNode 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 Group#cloneNode
- * @see Node#duplicateNode
- * @see Node#cloneTree
- * @see NodeComponent#setDuplicateOnCloneTree
- */
- void duplicateAttributes(NodeComponent originalNode,
- boolean forceDuplicate) {
-
- if (forceDuplicate && originalNode.isCompiled()) {
- throw new RestrictedAccessException(
- J3dI18N.getString("NodeComponent1"));
- }
-
- super.duplicateSceneGraphObject(originalNode);
- setDuplicateOnCloneTree(originalNode.getDuplicateOnCloneTree());
- }
-
- /**
- * Creates the retained mode NodeComponentRetained object that this
- * NodeComponent object will point to.
- */
- @Override
- void createRetained() {
- this.retained = new NodeComponentRetained();
- this.retained.setSource(this);
- }
-
- /**
- * This function is called from getNodeComponent() to see if any of
- * the sub-NodeComponents duplicateOnCloneTree flag is true.
- * If it is the case, current NodeComponent needs to
- * duplicate also even though current duplicateOnCloneTree flag is false.
- * This should be overwrite by NodeComponent which contains sub-NodeComponent.
- */
- boolean duplicateChild() {
- return getDuplicateOnCloneTree();
- }
-
- /*
- * @exception IllegalSharingException if this NodeComponent is live and
- * the specified image is being used by a Canvas3D as an off-screen buffer.
- *
- * @exception IllegalSharingException if this NodeComponent is
- * being used by an immediate mode context and
- * the specified image is being used by a Canvas3D as an off-screen buffer.
- */
- void validateImageIllegalSharing(ImageComponent image) {
- // Do illegal sharing check
- if(image != null) {
- ImageComponentRetained imageRetained = (ImageComponentRetained) image.retained;
- NodeComponentRetained ncRetained = (NodeComponentRetained)this.retained;
- if(imageRetained.getUsedByOffScreen()) {
- if(isLive()) {
- throw new IllegalSharingException(J3dI18N.getString("NodeComponent2"));
- }
- if(ncRetained.getInImmCtx()) {
- throw new IllegalSharingException(J3dI18N.getString("NodeComponent3"));
- }
- }
- }
- }
-
-}