01: /*
02: * $RCSfile: IllegalSharingException.java,v $
03: *
04: * Copyright 1997-2008 Sun Microsystems, Inc. All Rights Reserved.
05: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
06: *
07: * This code is free software; you can redistribute it and/or modify it
08: * under the terms of the GNU General Public License version 2 only, as
09: * published by the Free Software Foundation. Sun designates this
10: * particular file as subject to the "Classpath" exception as provided
11: * by Sun in the LICENSE file that accompanied this code.
12: *
13: * This code is distributed in the hope that it will be useful, but WITHOUT
14: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16: * version 2 for more details (a copy is included in the LICENSE file that
17: * accompanied this code).
18: *
19: * You should have received a copy of the GNU General Public License version
20: * 2 along with this work; if not, write to the Free Software Foundation,
21: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
22: *
23: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
24: * CA 95054 USA or visit www.sun.com if you need additional information or
25: * have any questions.
26: *
27: * $Revision: 1.5 $
28: * $Date: 2008/02/28 20:17:23 $
29: * $State: Exp $
30: */
31:
32: package javax.media.j3d;
33:
34: /**
35: * Indicates an illegal attempt to share a scene graph object. For example,
36: * the following are illegal:
37: * <UL>
38: * <LI>referencing a shared subgraph in more than one virtual universe</LI>
39: * <LI>using the same node both in the scene graph and in an
40: * immediate mode graphics context</LI>
41: * <LI>including any of the following unsupported types of leaf node within a shared subgraph:</LI>
42: * <UL>
43: * <LI>AlternateAppearance</LI>
44: * <LI>Background</LI>
45: * <LI>Behavior</LI>
46: * <LI>BoundingLeaf</LI>
47: * <LI>Clip</LI>
48: * <LI>Fog</LI>
49: * <LI>ModelClip</LI>
50: * <LI>Soundscape</LI>
51: * <LI>ViewPlatform</LI>
52: * </UL>
53: * <LI>referencing a BranchGroup node in more than one of the following
54: * ways:</LI>
55: * <UL>
56: * <LI>attaching it to a (single) Locale</LI>
57: * <LI>adding it as a child of a Group Node within the scene graph</LI>
58: * <LI>referencing it from a (single) Background Leaf Node as
59: * background geometry</LI>
60: * </UL>
61: * </UL>
62: */
63: public class IllegalSharingException extends IllegalSceneGraphException {
64:
65: /**
66: * Create the exception object with default values.
67: */
68: public IllegalSharingException() {
69: }
70:
71: /**
72: * Create the exception object that outputs message.
73: * @param str the message string to be output.
74: */
75: public IllegalSharingException(String str) {
76: super(str);
77: }
78:
79: }
|