01: /*
02: * $RCSfile: SceneGraphObjectReferenceControl.java,v $
03: *
04: * Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
05: *
06: * Redistribution and use in source and binary forms, with or without
07: * modification, are permitted provided that the following conditions
08: * are met:
09: *
10: * - Redistribution of source code must retain the above copyright
11: * notice, this list of conditions and the following disclaimer.
12: *
13: * - Redistribution in binary form must reproduce the above copyright
14: * notice, this list of conditions and the following disclaimer in
15: * the documentation and/or other materials provided with the
16: * distribution.
17: *
18: * Neither the name of Sun Microsystems, Inc. or the names of
19: * contributors may be used to endorse or promote products derived
20: * from this software without specific prior written permission.
21: *
22: * This software is provided "AS IS," without a warranty of any
23: * kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
24: * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
25: * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
26: * EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
27: * NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
28: * USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
29: * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
30: * ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
31: * CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
32: * REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
33: * INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
34: * POSSIBILITY OF SUCH DAMAGES.
35: *
36: * You acknowledge that this software is not designed, licensed or
37: * intended for use in the design, construction, operation or
38: * maintenance of any nuclear facility.
39: *
40: * $Revision: 1.4 $
41: * $Date: 2007/02/09 17:20:27 $
42: * $State: Exp $
43: */
44:
45: package com.sun.j3d.utils.scenegraph.io;
46:
47: /**
48: * Provides and resolves references to SceneGraphObjects to enable
49: * persistant references in user defined SceneGraphObjects implementing
50: * the SceneGraphIO interface.
51: */
52: public interface SceneGraphObjectReferenceControl {
53:
54: /**
55: * Add a reference to the scenegraph object specified and return
56: * the nodeID for the object
57: *
58: * Use only during the save cycle
59: */
60: public int addReference(javax.media.j3d.SceneGraphObject object);
61:
62: /**
63: * Given a nodeID return the corresponding scene graph object.
64: *
65: * Use only during the load cycle
66: */
67: public javax.media.j3d.SceneGraphObject resolveReference(int nodeID);
68: }
|