1 /*
2  * $RCSfile: GeometryUpdater.java,v $
3  *
4  * Copyright 1999-2008 Sun Microsystems, Inc.  All Rights Reserved.
5  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6  *
7  * This code is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License version 2 only, as
9  * 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:22 $
29  * $State: Exp $
30  */
31 
32 package javax.media.j3d;
33 
34 
35 /**
36  * The GeometryUpdater interface is used in updating geometry data
37  * that is accessed by reference from a live or compiled GeometryArray
38  * object.  Applications that wish to modify such data must define a
39  * class that implements this interface.  An instance of that class is
40  * then passed to the <code>updateData</code> method of the
41  * GeometryArray object to be modified.
42  *
43  * @since Java 3D 1.2
44  */
45 
46 public interface GeometryUpdater {
47     /**
48      * Updates geometry data that is accessed by reference.
49      * This method is called by the updateData method of a
50      * GeometryArray object to effect
51      * safe updates to vertex data that
52      * is referenced by that object.  Applications that wish to modify
53      * such data must implement this method and perform all updates
54      * within it.
55      * <br>
56      * NOTE: Applications should <i>not</i> call this method directly.
57      *
58      * @param geometry the Geometry object being updated.
59      * @see GeometryArray#updateData
60      */
updateData(Geometry geometry)61     public void updateData(Geometry geometry);
62 }
63