01: /*
02: * $RCSfile: LocaleFactory.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:44 $
42: * $State: Exp $
43: */
44:
45: package com.sun.j3d.utils.universe;
46:
47: import javax.media.j3d.Locale;
48: import javax.media.j3d.HiResCoord;
49: import javax.media.j3d.VirtualUniverse;
50:
51: /**
52: * This interface defines a factory for creating Locale objects in a
53: * SimpleUniverse. Implementations of the createLocale methods in
54: * this interface should construct a new Locale object from the
55: * specified parameters. This class is used by the SimpleUniverse
56: * class to construct the default Locale used to hold the view and
57: * content branch graphs.
58: *
59: * @see Locale
60: * @see ConfiguredUniverse
61: * @see SimpleUniverse
62: *
63: * @since Java 3D 1.3
64: */
65: public interface LocaleFactory {
66: /**
67: * Creates a new Locale object at the specified high resolution
68: * coordinate in the specified universe.
69: *
70: * @param universe the VirtualUniverse in which to create the Locale
71: * @param hiRes the high resolution coordinate that defines the origin
72: * of the Locale
73: */
74: public Locale createLocale(VirtualUniverse universe,
75: HiResCoord hiRes);
76:
77: /**
78: * Creates a new Locale object at (0, 0, 0) in the specified universe.
79: *
80: * @param universe the VirtualUniverse in which to create the Locale
81: */
82: public Locale createLocale(VirtualUniverse universe);
83: }
|