Copyright 1996-2008 Sun Microsystems, Inc. All rights reserved. +Use is subject to license terms. +
+This javadoc-generated API documentation is not an +official API specification. This documentation may contain references to +Java and Java 3D, both of which are trademarks of Sun Microsystems, Inc. +Any reference to these and other trademarks of Sun Microsystems are +for explanatory purposes only. Their use does impart any rights beyond +those listed in the source code license. In particular, Sun Microsystems +retains all intellectual property and trademark rights as described in +the proprietary rights notice in the COPYRIGHT.txt file. +
+ + diff --git a/j3d-core/LICENSE.txt b/j3d-core/LICENSE.txt new file mode 100644 index 0000000..eeab58c --- /dev/null +++ b/j3d-core/LICENSE.txt @@ -0,0 +1,347 @@ +The GNU General Public License (GPL) + +Version 2, June 1991 + +Copyright (C) 1989, 1991 Free Software Foundation, Inc. +59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +Everyone is permitted to copy and distribute verbatim copies of this license +document, but changing it is not allowed. + +Preamble + +The licenses for most software are designed to take away your freedom to share +and change it. By contrast, the GNU General Public License is intended to +guarantee your freedom to share and change free software--to make sure the +software is free for all its users. This General Public License applies to +most of the Free Software Foundation's software and to any other program whose +authors commit to using it. (Some other Free Software Foundation software is +covered by the GNU Library General Public License instead.) You can apply it to +your programs, too. + +When we speak of free software, we are referring to freedom, not price. Our +General Public Licenses are designed to make sure that you have the freedom to +distribute copies of free software (and charge for this service if you wish), +that you receive source code or can get it if you want it, that you can change +the software or use pieces of it in new free programs; and that you know you +can do these things. + +To protect your rights, we need to make restrictions that forbid anyone to deny +you these rights or to ask you to surrender the rights. These restrictions +translate to certain responsibilities for you if you distribute copies of the +software, or if you modify it. + +For example, if you distribute copies of such a program, whether gratis or for +a fee, you must give the recipients all the rights that you have. You must +make sure that they, too, receive or can get the source code. And you must +show them these terms so they know their rights. + +We protect your rights with two steps: (1) copyright the software, and (2) +offer you this license which gives you legal permission to copy, distribute +and/or modify the software. + +Also, for each author's protection and ours, we want to make certain that +everyone understands that there is no warranty for this free software. If the +software is modified by someone else and passed on, we want its recipients to +know that what they have is not the original, so that any problems introduced +by others will not reflect on the original authors' reputations. + +Finally, any free program is threatened constantly by software patents. We +wish to avoid the danger that redistributors of a free program will +individually obtain patent licenses, in effect making the program proprietary. +To prevent this, we have made it clear that any patent must be licensed for +everyone's free use or not licensed at all. + +The precise terms and conditions for copying, distribution and modification +follow. + +TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + +0. This License applies to any program or other work which contains a notice +placed by the copyright holder saying it may be distributed under the terms of +this General Public License. The "Program", below, refers to any such program +or work, and a "work based on the Program" means either the Program or any +derivative work under copyright law: that is to say, a work containing the +Program or a portion of it, either verbatim or with modifications and/or +translated into another language. (Hereinafter, translation is included +without limitation in the term "modification".) Each licensee is addressed as +"you". + +Activities other than copying, distribution and modification are not covered by +this License; they are outside its scope. The act of running the Program is +not restricted, and the output from the Program is covered only if its contents +constitute a work based on the Program (independent of having been made by +running the Program). Whether that is true depends on what the Program does. + +1. You may copy and distribute verbatim copies of the Program's source code as +you receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice and +disclaimer of warranty; keep intact all the notices that refer to this License +and to the absence of any warranty; and give any other recipients of the +Program a copy of this License along with the Program. + +You may charge a fee for the physical act of transferring a copy, and you may +at your option offer warranty protection in exchange for a fee. + +2. You may modify your copy or copies of the Program or any portion of it, thus +forming a work based on the Program, and copy and distribute such modifications +or work under the terms of Section 1 above, provided that you also meet all of +these conditions: + + a) You must cause the modified files to carry prominent notices stating + that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in whole or + in part contains or is derived from the Program or any part thereof, to be + licensed as a whole at no charge to all third parties under the terms of + this License. + + c) If the modified program normally reads commands interactively when run, + you must cause it, when started running for such interactive use in the + most ordinary way, to print or display an announcement including an + appropriate copyright notice and a notice that there is no warranty (or + else, saying that you provide a warranty) and that users may redistribute + the program under these conditions, and telling the user how to view a copy + of this License. (Exception: if the Program itself is interactive but does + not normally print such an announcement, your work based on the Program is + not required to print an announcement.) + +These requirements apply to the modified work as a whole. If identifiable +sections of that work are not derived from the Program, and can be reasonably +considered independent and separate works in themselves, then this License, and +its terms, do not apply to those sections when you distribute them as separate +works. But when you distribute the same sections as part of a whole which is a +work based on the Program, the distribution of the whole must be on the terms +of this License, whose permissions for other licensees extend to the entire +whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest your +rights to work written entirely by you; rather, the intent is to exercise the +right to control the distribution of derivative or collective works based on +the Program. + +In addition, mere aggregation of another work not based on the Program with the +Program (or with a work based on the Program) on a volume of a storage or +distribution medium does not bring the other work under the scope of this +License. + +3. You may copy and distribute the Program (or a work based on it, under +Section 2) in object code or executable form under the terms of Sections 1 and +2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable source + code, which must be distributed under the terms of Sections 1 and 2 above + on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three years, to + give any third party, for a charge no more than your cost of physically + performing source distribution, a complete machine-readable copy of the + corresponding source code, to be distributed under the terms of Sections 1 + and 2 above on a medium customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer to + distribute corresponding source code. (This alternative is allowed only + for noncommercial distribution and only if you received the program in + object code or executable form with such an offer, in accord with + Subsection b above.) + +The source code for a work means the preferred form of the work for making +modifications to it. For an executable work, complete source code means all +the source code for all modules it contains, plus any associated interface +definition files, plus the scripts used to control compilation and installation +of the executable. However, as a special exception, the source code +distributed need not include anything that is normally distributed (in either +source or binary form) with the major components (compiler, kernel, and so on) +of the operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the source +code from the same place counts as distribution of the source code, even though +third parties are not compelled to copy the source along with the object code. + +4. You may not copy, modify, sublicense, or distribute the Program except as +expressly provided under this License. Any attempt otherwise to copy, modify, +sublicense or distribute the Program is void, and will automatically terminate +your rights under this License. However, parties who have received copies, or +rights, from you under this License will not have their licenses terminated so +long as such parties remain in full compliance. + +5. You are not required to accept this License, since you have not signed it. +However, nothing else grants you permission to modify or distribute the Program +or its derivative works. These actions are prohibited by law if you do not +accept this License. Therefore, by modifying or distributing the Program (or +any work based on the Program), you indicate your acceptance of this License to +do so, and all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + +6. Each time you redistribute the Program (or any work based on the Program), +the recipient automatically receives a license from the original licensor to +copy, distribute or modify the Program subject to these terms and conditions. +You may not impose any further restrictions on the recipients' exercise of the +rights granted herein. You are not responsible for enforcing compliance by +third parties to this License. + +7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), conditions +are imposed on you (whether by court order, agreement or otherwise) that +contradict the conditions of this License, they do not excuse you from the +conditions of this License. If you cannot distribute so as to satisfy +simultaneously your obligations under this License and any other pertinent +obligations, then as a consequence you may not distribute the Program at all. +For example, if a patent license would not permit royalty-free redistribution +of the Program by all those who receive copies directly or indirectly through +you, then the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply and +the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any patents or +other property right claims or to contest validity of any such claims; this +section has the sole purpose of protecting the integrity of the free software +distribution system, which is implemented by public license practices. Many +people have made generous contributions to the wide range of software +distributed through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing to +distribute software through any other system and a licensee cannot impose that +choice. + +This section is intended to make thoroughly clear what is believed to be a +consequence of the rest of this License. + +8. If the distribution and/or use of the Program is restricted in certain +countries either by patents or by copyrighted interfaces, the original +copyright holder who places the Program under this License may add an explicit +geographical distribution limitation excluding those countries, so that +distribution is permitted only in or among countries not thus excluded. In +such case, this License incorporates the limitation as if written in the body +of this License. + +9. The Free Software Foundation may publish revised and/or new versions of the +General Public License from time to time. Such new versions will be similar in +spirit to the present version, but may differ in detail to address new problems +or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any later +version", you have the option of following the terms and conditions either of +that version or of any later version published by the Free Software Foundation. +If the Program does not specify a version number of this License, you may +choose any version ever published by the Free Software Foundation. + +10. If you wish to incorporate parts of the Program into other free programs +whose distribution conditions are different, write to the author to ask for +permission. For software which is copyrighted by the Free Software Foundation, +write to the Free Software Foundation; we sometimes make exceptions for this. +Our decision will be guided by the two goals of preserving the free status of +all derivatives of our free software and of promoting the sharing and reuse of +software generally. + +NO WARRANTY + +11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR +THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE +STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE +PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND +PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, +YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL +ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE +PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR +INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA +BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER +OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + +END OF TERMS AND CONDITIONS + +How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest possible +use to the public, the best way to achieve this is to make it free software +which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest to attach +them to the start of each source file to most effectively convey the exclusion +of warranty; and each file should have at least the "copyright" line and a +pointer to where the full notice is found. + + One line to give the program's name and a brief idea of what it does. + + Copyright (C)+
To
+build the 3D packages, you must checkout the following three
+CVS
+repositories:
+
These three top-level directories must be named exactly as
+shown above and they must be sibling directories. To ensure this, run
+the cvs checkout command for each of the respositories from the same
+parent
+directory. For example:
+
cd <cvs-root-dir>cvs checkout vecmathcvs checkout j3d-corecvs checkout j3d-core-utils
+NOTE: you must first build the javax.vecmath package before building
+the javax.media.j3d and com.sun.j3d.* packages. See the README-build.html file in the
+"vecmath" directory for instructions.
+
+
The
+following operating environments have been tested:
+
The following software must be installed:
+
Before +you start building, your PATH must include the +following directories: +
+The default target, jar-opt, creates an optimized jar files +and native libraries. +
+On Amd64 platform an OutOfMemoryError can be seen. In this case set
+the environment variable ANT_OPTS to -Xmx256m.
+
Steps: +
+ cd <cvs-root-dir>/j3d-core
+ant
+The above steps build both the Java and native code for +javax.media.j3d and com.sun.j3d.* +packages. +
+The build will be placed in j3d-core/build/<platform>/opt
+where <platform> is determined from the ant
+echo command:
+
ant echo
+The default compiler for native code compilation is set to "gcc".
+This
+value is set in the build.properties
+file located
+in the j3d-core directory. The compiler property is "build.comp".
+
On a Solaris platform with Forte compiler installed,
+build.comp
+can be set to "forte". On a Windows platform installed Visual C++,
+build.properties
+can be set to "vc".
+
NOTE: For Windows platform only, the property "build.rend" in
+build.properties can be modified to use "d3d" (Direct3D API for
+rendering) besides the default value "ogl".
+
NOTE: You can also modify the properties via command-line options to
+ant,
+for example, "ant -Dbuild.comp=vc"
+
Please refer to README-build.html in
+j3d-examples for
+details
+on building and running the 3D example programs.
+
+ * Developers are strongly encouraged to do the following whenever they + * modify the 3D graphics API for the Java platform: + * + *
+ * The tags of the form @STRING@ are populated by ant when the project is built + * + * @see VirtualUniverse#getProperties + */ +class VersionInfo extends Object { + /** + * Developer who has modified the 3D graphics API for the Java platform. + * This string should be modified to indicate the name of the + * individual(s) or organization(s) who modified the code. + */ + private static final String VENDOR_DEVELOPER = null; + + + /** + * An optional string appended to the end of the version string, + * after the time stamp. A space will be automatically prepended + * to this string. This string should be null if no dev string is + * desired. + */ + private static final String VERSION_DEV_STRING = null; + + // ------------------------------------------------------------------- + // ------------------------------------------------------------------- + // END OF DEVELOPER-MODIFIABLE PARAMETERS + // ------------------------------------------------------------------- + // ------------------------------------------------------------------- + + + // ------------------------------------------------------------------- + // The following set of constants should not be modified by developers. + // ------------------------------------------------------------------- + + /** + * Constant that indicates whether or not this is a debug build. + */ + static final boolean isDebug = @IS_DEBUG@; + + /** + * This static final variable is used to enable debugging and + * assertion checking during the development phase of a particular + * version of 3D graphics API for the Java platform. It is disabled + * for "opt" production builds (beta, release candidate, fcs, and + * patch builds). It is enabled for all "debug" builds and for daily + * and stable "opt" builds. + * + *
+ * This parameter is controlled by ant via the build.xml file. The + * default value is true. + */ + static final boolean isDevPhase = @IS_DEV_PHASE@; + + /** + * This static final variable is used indicate a production + * (beta, release candidate, fcs, or patch) build. + *
+ * This parameter is controlled by ant via the build.xml file. The + * default value is false. + */ + static final boolean isProduction = @IS_PRODUCTION@; + + /** + * If this flag is set to true, the verbose buildtime string + * will be appended to the version string) + *
+ * This parameter is controlled by ant via the build.xml file. The
+ * default value is true.
+ */
+ private static final boolean useVerboseBuildTime = @USE_VERBOSE_BUILDTIME@;
+
+ /**
+ * String identifying the type of build, one of:
+ * "daily", "stable", "beta", "fcs", or "patch". The default value
+ * is "daily".
+ */
+ private static final String BUILD_TYPE = "@BUILD_TYPE@";
+
+ /**
+ * String identifying the build number in the format
+ * "buildNN", where "NN" is the sequential build number, for
+ * example, build47. This string contain only letters and
+ * numbers, It must not contain any other characters or spaces.
+ *
+ * For production builds, this string appears parenthetically,
+ * after the first space.
+ */
+ private static final String VERSION_BUILD = "@VERSION_BUILD@";
+
+ /**
+ * String identifying the particular build of the 3D API, for
+ * example, "-beta1", "-build47", "-rc1", "_01", etc. Note that
+ * this includes the leading dash or underscore. It will typically
+ * be empty for FCS builds. This string may only contain letters,
+ * numbers, periods, dashes, or underscores. It must not contain
+ * any other characters or spaces.
+ *
+ * This us used as part of the j3d.version that appears before the
+ * optional first space.
+ */
+ private static final String VERSION_SUFFIX = "@VERSION_SUFFIX@";
+
+ /**
+ * Date stamp
+ *
+ * This is only used for daily builds.
+ */
+ private static final String BUILDTIME = "@BUILDTIME@";
+
+ /**
+ * Specification version (major and minor version only). This
+ * string must not be modified by developers.
+ */
+ private static final String SPECIFICATION_VERSION = "1.5";
+
+ /**
+ * Specification vendor.
+ */
+ private static final String SPECIFICATION_VENDOR = "@SPEC_VENDOR@";
+
+ /**
+ * Primary implementation vendor.
+ */
+ private static final String VENDOR_PRIMARY = "@IMPL_VENDOR@";
+
+ /**
+ * Base version number. This is the major.minor.subminor version
+ * number. Version qualifiers are specified separately. The
+ * major and minor version must be the same as the specification
+ * version.
+ */
+ private static final String VERSION_BASE = "@VERSION_BASE@";
+
+ /**
+ * Boolean flag indicating that the version of the 3D API is
+ * experimental. This must not be modified by developers.
+ * All non-official builds must contain the string
+ * Here are the proposed changes for Java 3D version 1.4. These
+proposed changes are a results of discussion and collaboration with the
+Java 3D community on java.net (see
+https://java3d.dev.java.net).
+They are already part of daily and periodic stable builds available on
+java.net. Here is the list of accepted changes for the Java 3D 1.4 API: For a complete description of these changes, please see the
+proposed API specification (javadoc) for the 1.4 version of the
+Java 3D API.
+ We propose to add programmable shader support to Java 3D 1.4.
+This is
+the primary new feature of this release. The following new classes and interfaces are added in
+the The following new classes are added in the
+ The following new fields, constructors, and methods are added to
+existing classes: The following new constructors are added to
+existing GeometryArray subclasses: Capability bits control whether data in a Java 3D scene graph
+object
+may be read or written when it is part of a live or compiled subgraph.
+We propose to change the default value for all read capability bits to
+true, meaning that all attributes may be read by default (the default
+value for all write capability bits will remain false, meaning that no
+attributes may be written by default). Note that read capability bits
+are defined as those capability bits of the form We propose to add a new PickInfo class (with an inner class to hold
+intersection information), and new core picking methods that return
+objects of this new class type. New Classes: New methods: We propose new stencil functionality. Here are the proposed new
+fields and methods: We propose to add new rendering attributes/modes to enable
+applications to specify the depth test function, additional raster
+operations, and additional blending modes. The new fields and methods
+are as follows: We propose to add the following new features: a name for all scene
+graph objects; the ability to get the Locale or parent from a live or
+compiled scene graph, a scene graph structure change listener, and a
+method to get the tessellated glyph geometry for a character in a 3D
+font.
+ The following new class has been added: The new fields and methods are as follows: We propose to deprecate the following classes: We propose to deprecate the following fields and methods: Here are the proposed changes for Java 3D version 1.5. These
+proposed changes are a results of discussion and collaboration with the
+Java 3D community on java.net (see
+https://java3d.dev.java.net).
+They are already part of daily and periodic stable builds available on
+java.net. Here is the list of proposed changes for the Java 3D 1.5 API: For a complete description of these changes, please see the
+proposed API specification (javadoc) for the 1.5 version of the
+Java 3D API.
+ We propose to add non-power-of-two textures to Java 3D 1.5.
+Currently, the width, height, and depth of all textures must be an
+exact power of two. Most graphics cards now support non-power-of-two
+textures, so we propose to allow this in Java 3D. Since not all
+graphics drivers support this feature, we will add a new
+ We propose to create a new javax.media.j3d.NioImageBuffer class, a
+wrapper for an image whose DataBuffer
+is specified via an appropriate subclass of java.nio.Buffer:
+ByteBuffer or IntBuffer,
+depending on the type of image. When using IntBuffer,
+the byte order of the buffer must match the native byte order of the
+underlying platform.
+ New public classes: New constructors and methods: We propose to add support for setting the coordinate indices
+of IndexedGeometryArray objects "by-reference". Currently, the
+coordinate indices array is
+set "by-copy" even for by-reference geometry, resulting in excessive
+memory usage. Though the
+excess memory usage is temporary, since it happens only at the time
+of creating an internal copy of the user-specified indices array,
+nevertheless it can turn out to be of significant concern especially
+for very large geometries or for dynamically changing geometry. The
+fact that the
+graphics drivers have long supported this feature makes the
+incorporation of this feature attractive, as
+it entails no special hardware support. New fields and methods: We propose to add a rendering error class and error listener
+interface that applications can use to detect rendering errors that are
+caught by the Java 3D rendering system. The default error listener, if
+no user-specified error listeners are added, prints out the error
+message and exits. The following new classes and interfaces are proposed: The following new methods are proposed: We propose to add accessors and mutators to all vecmath classes with
+publicly accessible fields. This follows the bean pattern, and allows
+these classes to be read and written by bean-aware tools, for example,
+the XMLEncoder. The following
+classes need public accessors and mutators (e.g., setX(), getX(),
+setY(), and so forth): We propose to deprecate the following fields and methods relating to
+the obsolete texture functionality.
+
+ This software is licensed by Sun, as specified in the LICENSE-Java3D-v1_4_0.txt
+file. You
+must only use this software in accordance with the terms under which
+the
+code is licensed. The 1.4.0 version of the Java 3DTM
+API runs on JDK version 1.4.2 and higher. It has been released for
+the Solaris, Linux, and Windows operating
+environments. See the release
+notes
+for more information. This release of Java 3D runs on JDK version 1.4.2 and
+higher.
+To install this build, chdir to the "jre" directory within the jdk
+and execute the self-extracting binary that you downloaded. For
+example, if you are running on a Linux/x86 platform and your JDK is
+installed
+in /usr/java/jdk1.5.0_06, you would install Java 3D as follows:
+ You may need to be "root" to do this on Linux. This release of Java 3D runs on JDK version 1.4.2 and
+higher (JDK 1.5.0 or higher for Solaris/x86).
+To install this build, chdir to the "jre" directory within the jdk
+and execute the self-extracting binary that you downloaded. For
+example, if you are running on a Solaris/x86 platform (including amd64)
+and your JDK is
+installed
+in /usr/java/jdk1.5.0_06, you would install Java 3D as follows:
+ You may need to be "root" to do this on Solaris.
+This release of Java 3D runs on JDK version 1.4.2 and
+higher. To install
+this build, execute the binary installer that you downloaded, by
+double-clicking on the java3d-1_4_0-windows-i586.exe icon. Alternatively, you can download the java3d-1_4_0-windows-i586.zip
+file and manually install
+the
+necessary files into your JRE. In this case, unzip the file, and follow
+the instructions in the unzipped README.txt file. This software is licensed by Sun, as specified in the LICENSE-Java3D-v1_4_0.txt
+file. You
+must only use this software in accordance with the terms under which
+the
+code is licensed. The 1.4.0 version of the Java 3DTM
+API for Windows/XP and Windows 2000 runs on JDK version 1.4.2 and
+higher. See the release
+notes
+for more information. NOTE: This zip
+bundle is intended for expert users who do not want to use the
+automated installer. Most users will want to download and install the
+java3d-1_4_0-windows-i586.exe file instead. To manually install this build, do the following: This file contains important release information for users of
+the
+Java 3DTM API, version
+1.4.0.
+ NOTE: We recommend that you uninstall all previous versions of Java 3D before
+installing this version.
+ The 1.4.0 version of the Java 3D API has been released
+for
+Solaris (both sparc and x86), Linux (both x86 and amd64), and Windows
+(32-bit).
+
+The 1.4.0 version of Java 3D for Solaris/SPARC requires the
+following:
+
+The 1.4.0 version of Java 3D for Solaris/x86 requires the
+following:
+ The 1.4.0 version of Java 3D for Linux (x86 or amd64)
+requires
+the
+following: The 1.4.0 version of Java 3D for Windows 2000, and
+Windows/XP (32-bit)
+requires the following: Thw following new features have been added to the 1.4 version of the
+Java 3D API. Please refer to the API
+documentation, or the JSR-926
+change log for more information. The following system properties were added in Java 3D 1.4.0: For the latest information on Java 3D, see the main Java 3D project page
+on
+java.net. Click here
+for a list of open issues. This software is licensed by Sun, as specified in the LICENSE-Java3D-v1_5_0.txt
+file. You
+must only use this software in accordance with the terms under which
+the
+code is licensed. The 1.5.0 version of the Java 3DTM
+API runs on JDK version 1.5.0 and higher. It has been released for
+the Solaris, Linux, Windows, and Mac OS X
+operating
+environments. See the release
+notes
+for more information. This release of Java 3D runs on JDK version 1.5.0 and
+higher.
+To install this build, chdir to the "jre" directory within the jdk
+and execute the self-extracting binary that you downloaded. For
+example, if you are running on a Linux/x86 platform and your JDK is
+installed
+in /usr/java/jdk1.5.0_08, you would install Java 3D as follows:
+ You may need to be "root" to do this on Linux. This release of Java 3D runs on JDK version 1.5.0 and
+higher.
+To install this build, chdir to the "jre" directory within the jdk
+and execute the self-extracting binary that you downloaded. For
+example, if you are running on a Solaris/x86 platform (including amd64)
+and your JDK is
+installed
+in /usr/java/jdk1.5.0_08, you would install Java 3D as follows:
+ You may need to be "root" to do this on Solaris.
+This release of Java 3D runs on JDK version 1.5.0 and
+higher. To install
+this build, execute the binary installer that you downloaded, by
+double-clicking on the java3d-1_5_0-windows-i586.exe (or
+java3d-1_5_0-windows-amd64.exe) icon. Alternatively, you can download the
+java3d-1_5_0-windows-i586.zip
+file and manually install
+the
+necessary files into your JRE. In this case, unzip the file, and follow
+the instructions in the unzipped README.txt file. This software is licensed by Sun, as specified in the LICENSE-Java3D-v1_5_0.txt
+file. You
+must only use this software in accordance with the terms under which
+the
+code is licensed. The 1.5.0 version of the Java 3DTM
+API for Windows/XP and Windows 2000 runs on JDK version 1.5.0 and
+higher. NOTE: This zip
+bundle is intended for expert users who do not want to use the
+automated installer. Most users will want to download and install the
+java3d-1_5_0-windows-i586.exe file instead. To manually install this build, do the following:
+ The 1.5.0 version of the Java 3DTM
+API for Linux or Solaris runs on JDK version 1.5.0 and
+higher. To manually install this build, do the following: This file contains important release information for users of
+the
+Java 3DTM API, version
+1.5.0.
+ NOTE: We recommend that you uninstall all previous versions of Java 3D before
+installing this version.
+ The 1.5.0 version of the Java 3D API has been released
+for
+Solaris (both sparc and x86/amd64), Linux (both x86 and amd64), Windows
+(both x86 and amd64), and
+Mac OS X (both PPC and x86).
+
+The 1.5.0 version of Java 3D for Solaris SPARC requires the
+following:
+
+The 1.5.0 version of Java 3D for Solaris x86/amd64 requires
+the
+following:
+ The 1.5.0 version of Java 3D for Linux (x86 or amd64)
+requires
+the
+following: The 1.5.0 version of Java 3D for Windows 2000, and
+Windows/XP (x86 or amd64)
+requires the following: The 1.5.0 version of Java 3D for Mac OS X (PPC or x86)
+requires the following: A JOGL rendering pipeline, as described
+in issue
+229, is now
+available on all supported platforms, including Apple Mac
+OS X (x86 or PPC). The easiest way to run Java 3D applications
+using the JOGL
+pipeline is via Java Webstart from your browser (with no setup
+required).
+Click here to run
+a Java 3D example program from your browser via the
+JOGL pipeline. These
+examples will use JOGL on Mac OS X and the native OpenGL pipeline on
+all
+other platforms. The JOGL renderer is the default on Mac OS X.
+You can select the JOGL renderer on other platforms by setting the " You will need to download
+JOGL
+and install it into the JRE along with the Java 3D jar files (or
+include it in your PATH/CLASSPATH). For the latest information on Java 3D, see the main Java 3D project page
+on
+java.net. Click here
+for a list of open issues. This software is licensed by Sun, as specified in the LICENSE-Java3D-v1_5_1.txt
+file. You
+must only use this software in accordance with the terms under which
+the
+code is licensed. The 1.5.1 version of the Java 3DTM
+API runs on JDK version 1.5.0 and higher. It has been released for
+the Solaris, Linux, Windows,
+and Mac OS X
+operating
+environments. See the release
+notes
+for more information. This release of Java 3D runs on JDK version 1.5.0 and
+higher.
+To install this build, chdir to the "jre" directory within the jdk
+and execute the self-extracting binary that you downloaded. For
+example, if you are running on a Linux/x86 platform and your JDK is
+installed
+in /usr/java/jdk1.6.0_01, you would install Java 3D as
+follows:
+ You may need to be "root" to do this on Linux. This release of Java 3D runs on JDK version 1.5.0 and
+higher.
+To install this build, chdir to the "jre" directory within the jdk
+and execute the self-extracting binary that you downloaded. For
+example, if you are running on a Solaris/x86 platform (including amd64)
+and your JDK is
+installed
+in /usr/java/jdk1.6.0_01, you would install Java 3D as
+follows:
+ You may need to be "root" to do this on Solaris.
+This release of Java 3D runs on JDK version 1.5.0 and
+higher. To install
+this build, execute the binary installer that you downloaded, by
+double-clicking on the java3d-1_5_1-windows-i586.exe (or
+java3d-1_5_1-windows-amd64.exe) icon. Alternatively, you can download the
+java3d-1_5_1-windows-i586.zip
+file and manually install
+the
+necessary files into your JRE. In this case, unzip the file, and follow
+the instructions in the unzipped README.txt file. This software is licensed by Sun, as specified in the LICENSE-Java3D-v1_5_1.txt
+file. You
+must only use this software in accordance with the terms under which
+the
+code is licensed. The 1.5.1 version of the Java 3DTM
+API for Windows/XP and Windows 2000 runs on JDK version 1.5.0 and
+higher. NOTE:
+This zip
+bundle is intended for expert users who do not want to use the
+automated installer. Most users will want to download and install the
+java3d-1_5_1-windows-i586.exe file instead. To manually install this build, do the following:
+ The 1.5.1 version of the Java 3DTM
+API for Linux or Solaris runs on JDK version 1.5.0 and
+higher. To manually install this build, do the following: This file contains important release information for users of
+the
+Java 3DTM
+API, version
+1.5.1.
+ NOTE: We
+recommend that you uninstall
+all previous
+versions of Java 3D before
+installing this version.
+ The 1.5.1 version of the Java 3D API has been
+released
+for
+Solaris (both sparc and x86/amd64), Linux (both x86 and amd64), Windows
+(both x86 and amd64), and
+Mac OS X (both PPC and x86).
+
+The 1.5.1 version of Java 3D for Solaris SPARC requires
+the
+following:
+
+The 1.5.1 version of Java 3D for Solaris x86/amd64
+requires
+the
+following:
+ The 1.5.1 version of Java 3D for Linux (x86 or
+amd64)
+requires
+the
+following: The 1.5.1 version of Java 3D for Windows 2000,
+Windows XP (x86 or amd64), or Windows Vista
+requires the following: The 1.5.1 version of Java 3D for Mac OS X (PPC
+or x86)
+requires the following: A JOGL rendering pipeline, as described
+in issue
+229, is now
+available on all supported platforms, including Apple Mac
+OS X (x86 or PPC). The easiest way to run Java 3D applications
+using the JOGL
+pipeline is via Java Webstart from your browser (with no setup
+required).
+Click here
+to run
+a Java 3D example program from your browser via the
+JOGL pipeline. These
+examples will use JOGL on Mac OS X and the native OpenGL pipeline on
+all
+other platforms. The JOGL renderer is the default on Mac OS X.
+You can select the JOGL renderer on other platforms by setting the " You will need to download
+JOGL
+and install it into the JRE along with the Java 3D jar files
+(or
+include it in your PATH/CLASSPATH). NOTE: You must install both Java 3D and
+JOGL into the JRE,
+or else you must install neither Java 3D nor JOGL
+into the
+JRE. If you install Java 3D into the JRE and put JOGL on your
+CLASSPATH, the JoglPipeline will fail to find the JOGL classes. For the latest information on Java 3D, see the main Java 3D
+project page
+on
+java.net. Click here
+for a list of open issues. This software is licensed by Sun, as specified in the
+LICENSE-Java3D-v1_5_2.txt
+file. You must only use this software in accordance with the terms
+under which the code is licensed.
+ The 1.5.2 version of the Java 3DTM
+API runs on JDK version
+1.5.0 and higher. It has been released for the Windows, Linux,
+Solaris, and Mac OS X operating environments. See the
+release
+notes for more information.
+ Developers who wish to develop an application using the Java 3D API
+are encouraged to download the j3d-1_5_2-XXX.zip file for
+their platform, and manually install the necessary files into a
+directory on their local disk. To do this, unzip the downloaded file,
+and follow the instructions in the unzipped README.txt file.
+ Alternatively, you can run the installer as shown below, keeping in
+mind that it is not recommended to install the j3d jar files and
+native libraries directly into the JRE.
+ To install the Java 3D API on Windows, download the binary
+installer and then execute it, by double-clicking on the
+j3d-1_5_2-windows-i586.exe (or j3d-1_5_2-windows-amd64.exe)
+icon.
+ To install the Java 3D API on Linux or Solaris, download the
+self-extracting binary file, chdir to the desired directory, and then
+execute it. For example, on a 32-bit Linux system:
+ After doing this, you will need to modify your CLASSPATH
+environment variable to include the full paths to j3dcore.jar,
+j3dutils.jar, and vecmath.jar. For example:
+ Then modify your LD_LIBRARY_PATH environment variable to contain the
+full path to the "lib/ARCH" directory. For example, on 32-bit Linux:
+ No installer is available for the Mac OS X operating environment.
+You will need to download the j3d-1_5_2-macosx.zip file, unzip it,
+and follow the instructions in the unzipped README.txt file.
+ This software is licensed by Sun, as specified in the
+LICENSE-Java3D-v1_5_2.txt
+file. You must only use this software in accordance with the terms
+under which the code is licensed.
+ The 1.5.2 version of the
+Java 3DTM
+API runs on JDK version 1.5.0 and higher. It has been released
+for the Windows, Linux,
+Solaris,
+and Mac OS X
+operating environments.
+ NOTE: Installing the j3d jars and native libs into the "ext"
+directory of the JRE is discouraged, especially on
+Mac OS X
+where JOGL is used as the rendering engine. Doing so can cause
+conflicts with third-party applications launched via Java Web Start,
+and causes confusion later when upgrading the distribution.
+ The 1.5.2 release of the Java 3D API for Windows 2000, Windows
+XP (x86 or amd64), and Windows Vista runs on JDK version 1.5.0 and
+higher. To manually install this release, do the following:
+ At this point your Java installation should be able to see
+the j3d class files. Users of IDEs such as NetBeans and Eclipse should
+consult the IDE's documentation to see how to add jar files and native
+libraries to their current project. The 1.5.2 release of the Java 3D API
+for Linux or Solaris runs on JDK version 1.5.0 and
+higher. To manually install this release, do the following: At this point your Java installation should be able to see
+the j3d class files. Users of IDEs such as NetBeans and Eclipse should
+consult the IDE's documentation to see how to add jar files and native
+libraries to their current project.
+ The 1.5.2 release of the Java 3D API
+for Mac OS X runs on JDK version 1.5.0 and
+higher. To manually install this release, do the following: At this point your Java installation should be able to see
+the j3d and jogl class files. Users of IDEs such as NetBeans and
+Eclipse should
+consult the IDE's documentation to see how to add jar files and native
+libraries to their current project. This file contains important release information for users of
+the
+Java 3DTM API, version
+1.5.2.
+ NOTE: We recommend that you uninstall all previous versions of Java 3D before
+installing this version.
+ The 1.5.2 version of the Java 3D API has been released
+for
+Solaris (both sparc and x86/amd64), Linux (both x86 and amd64), Windows
+(both x86 and amd64), and
+Mac OS X (both PPC and x86).
+
+The 1.5.2 version of Java 3D for Solaris SPARC requires the
+following:
+
+The 1.5.2 version of Java 3D for Solaris x86/amd64 requires
+the
+following:
+ The 1.5.2 version of Java 3D for Linux (x86 or amd64)
+requires
+the
+following: The 1.5.2 version of Java 3D for Windows 2000,
+Windows XP (x86 or amd64), or Windows Vista
+requires the following: The 1.5.2 version of Java 3D for Mac OS X (PPC or x86)
+requires the following: A JOGL rendering pipeline, as described
+in issue
+229, is now
+available on all supported platforms, including Apple Mac OS X
+(x86 or PPC). The easiest way to run Java 3D applications
+using the JOGL
+pipeline is via Java Webstart from your browser (with no setup
+required).
+Click here to run
+a Java 3D example program from your browser via the
+JOGL pipeline. These
+examples will use JOGL on Mac OS X and the native OpenGL pipeline on
+all
+other platforms. The JOGL renderer is the default on Mac OS X.
+You can select the JOGL renderer on other platforms by setting the " You will need to download
+JOGL
+and include it in your PATH/CLASSPATH along with the Java 3D jar files. NOTE: Installing the j3d or jogl jars and native libs into the "ext"
+directory of the JRE is strongly discouraged. Doing so can cause
+conflicts with third-party applications launched via Java Web Start,
+and causes confusion later when upgrading the distribution.
+ For the latest information on Java 3D, see the main Java 3D project page
+on
+java.net. Click here
+for a list of open issues. This software is licensed by Sun, as specified in the
+LICENSE-GPLv2.txt file. You must only
+use this software in accordance with the terms under which the code is
+licensed.
+ The 1.5.2-beta2 version of the j3d package runs on JDK version
+1.5.0 and higher. It has been released for the Windows, Linux,
+Solaris, and Mac OS X operating environments. See the
+release
+notes for more information.
+ Developers who wish to develop an application using the j3d package
+are encouraged to download the j3d-1_5_2-beta2-XXX.zip file for
+their platform, and manually install the necessary files into a
+directory on their local disk. To do this, unzip the downloaded file,
+and follow the instructions in the unzipped README.txt file.
+ Alternatively, you can run the installer as shown below, keeping in
+mind that it is not recommended to install the j3d jar files and
+native libraries directly into the JRE.
+ To install the j3d package on Windows, download the binary
+installer and then execute it, by double-clicking on the
+j3d-1_5_2-beta2-windows-i586.exe (or j3d-1_5_2-beta2-windows-amd64.exe)
+icon.
+ To install the j3d package on Linux or Solaris, download the
+self-extracting binary file, chdir to the desired directory, and then
+execute it. For example, on a 32-bit Linux system:
+ After doing this, you will need to modify your CLASSPATH
+environment variable to include the full paths to j3dcore.jar,
+j3dutils.jar, and vecmath.jar. For example:
+ Then modify your LD_LIBRARY_PATH environment variable to contain the
+full path to the "lib/ARCH" directory. For example, on 32-bit Linux:
+ No installer is available for the Mac OS X operating environment.
+You will need to download the j3d-1_5_2-beta2-macosx.zip file, unzip it,
+and follow the instructions in the unzipped README.txt file.
+ This software is licensed by Sun, as specified in the
+LICENSE-GPLv2.txt
+file. You
+must only use this software in accordance with the terms under which
+the code is licensed.
+ The 1.5.2-XXX pre-release version of 3D graphics API for the
+Java
+platform runs on JDK version 1.5.0 and higher. It has been released
+for the Windows, Linux,
+Solaris,
+and Mac OS X
+operating environments.
+ NOTE: Installing the j3d jars and native libs into the "ext"
+directory of the JRE is discouraged, especially on
+Mac OS X
+where JOGL is used as the rendering engine. Doing so can cause
+conflicts with third-party applications launched via Java Web Start,
+and causes confusion later when upgrading the distribution.
+ The 1.5.2 pre-release version of 3D graphics API for the Java
+platform for Windows 2000, Windows XP (x86 or amd64), and Windows
+Vista runs on JDK version 1.5.0 and
+higher. To manually install this build, do the following:
+ At this point your Java installation should be able to see
+the j3d class files. Users of IDEs such as NetBeans and Eclipse should
+consult the IDE's documentation to see how to add jar files and native
+libraries to their current project. The 1.5.2 pre-release version of 3D graphics API for the Java
+platform
+for Linux or Solaris runs on JDK version 1.5.0 and
+higher. To manually install this build, do the following: At this point your Java installation should be able to see
+the j3d class files. Users of IDEs such as NetBeans and Eclipse should
+consult the IDE's documentation to see how to add jar files and native
+libraries to their current project.
+ The 1.5.2 pre-release version of 3D graphics API for the Java
+platform
+for Mac OS X runs on JDK version 1.5.0 and
+higher. To manually install this build, do the following: At this point your Java installation should be able to see
+the j3d and jogl class files. Users of IDEs such as NetBeans and
+Eclipse should
+consult the IDE's documentation to see how to add jar files and native
+libraries to their current project. This file contains important release information for users of
+the
+Java 3DTM API, version
+1.5.2-beta2.
+ NOTE: We recommend that you uninstall all previous versions of Java 3D before
+installing this version.
+ The 1.5.2-beta2 version of the Java 3D API has been released
+for
+Solaris (both sparc and x86/amd64), Linux (both x86 and amd64), Windows
+(both x86 and amd64), and
+Mac OS X (both PPC and x86).
+
+The 1.5.2-beta2 version of Java 3D for Solaris SPARC requires the
+following:
+
+The 1.5.2-beta2 version of Java 3D for Solaris x86/amd64 requires
+the
+following:
+ The 1.5.2-beta2 version of Java 3D for Linux (x86 or amd64)
+requires
+the
+following: The 1.5.2-beta2 version of Java 3D for Windows 2000,
+Windows XP (x86 or amd64), or Windows Vista
+requires the following: The 1.5.2-beta2 version of Java 3D for Mac OS X (PPC or x86)
+requires the following: A JOGL rendering pipeline, as described
+in issue
+229, is now
+available on all supported platforms, including Apple Mac OS X
+(x86 or PPC). The easiest way to run Java 3D applications
+using the JOGL
+pipeline is via Java Webstart from your browser (with no setup
+required).
+Click here to run
+a Java 3D example program from your browser via the
+JOGL pipeline. These
+examples will use JOGL on Mac OS X and the native OpenGL pipeline on
+all
+other platforms. The JOGL renderer is the default on Mac OS X.
+You can select the JOGL renderer on other platforms by setting the " You will need to download
+JOGL
+and include it in your PATH/CLASSPATH along with the Java 3D jar files. NOTE: Installing the j3d or jogl jars and native libs into the "ext"
+directory of the JRE is strongly discouraged. Doing so can cause
+conflicts with third-party applications launched via Java Web Start,
+and causes confusion later when upgrading the distribution.
+ For the latest information on Java 3D, see the main Java 3D project page
+on
+java.net. Click here
+for a list of open issues.
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * An AlternateAppearance node affects Shape3D and Morph nodes by
+ * overriding their appearance component with the appearance
+ * component in this AlternateAppearance node. Only those Shape3D and
+ * Morph nodes that explicitly allow their appearance to be
+ * overridden are affected. The AlternateAppearance node has no
+ * effect on Shape3D and Morph nodes that do not allow their
+ * appearance to be overridden.
+ *
+ *
+ * If the regions of influence of multiple AlternateAppearance nodes
+ * overlap, the Java 3D system will choose a single alternate
+ * appearance for those objects that lie in the intersection. This is
+ * done in an implementation-dependent manner, but in general, the
+ * AlternateAppearance node that is "closest" to the object is chosen.
+ *
+ * @since Java 3D 1.2
+ */
+
+public class AlternateAppearance extends Leaf {
+ /**
+ * Specifies that this AlternateAppearance node allows read access to its
+ * influencing bounds and bounds leaf information.
+ */
+ public static final int ALLOW_INFLUENCING_BOUNDS_READ =
+ CapabilityBits.ALTERNATE_APPEARANCE_ALLOW_INFLUENCING_BOUNDS_READ;
+
+ /**
+ * Specifies that this AlternateAppearance node allows write access to its
+ * influencing bounds and bounds leaf information.
+ */
+ public static final int ALLOW_INFLUENCING_BOUNDS_WRITE =
+ CapabilityBits.ALTERNATE_APPEARANCE_ALLOW_INFLUENCING_BOUNDS_WRITE;
+
+ /**
+ * Specifies that this AlternateAppearance node allows read access to
+ * its appearance information.
+ */
+ public static final int ALLOW_APPEARANCE_READ =
+ CapabilityBits.ALTERNATE_APPEARANCE_ALLOW_APPEARANCE_READ;
+
+ /**
+ * Specifies that this AlternateAppearance node allows write access to
+ * its appearance information.
+ * information.
+ */
+ public static final int ALLOW_APPEARANCE_WRITE =
+ CapabilityBits.ALTERNATE_APPEARANCE_ALLOW_APPEARANCE_WRITE;
+
+ /**
+ * Specifies that this AlternateAppearance node allows read access
+ * to its scope information at runtime.
+ */
+ public static final int ALLOW_SCOPE_READ =
+ CapabilityBits.ALTERNATE_APPEARANCE_ALLOW_SCOPE_READ;
+
+ /**
+ * Specifies that this AlternateAppearance node allows write access
+ * to its scope information at runtime.
+ */
+ public static final int ALLOW_SCOPE_WRITE =
+ CapabilityBits.ALTERNATE_APPEARANCE_ALLOW_SCOPE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_INFLUENCING_BOUNDS_READ,
+ ALLOW_APPEARANCE_READ,
+ ALLOW_SCOPE_READ
+ };
+
+ /**
+ * Constructs an AlternateAppearance node with default
+ * parameters. The default values are as follows:
+ *
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+// * NOTE: Applications should not call this method directly.
+// * It should only be called by the cloneTree method.
+// *
+// * @param referenceTable a NodeReferenceTableObject that contains the
+// *
+ * For more information on Java 3D lighting, see the class description
+ * for Light.
+ *
+ */
+
+public class AmbientLight extends Light {
+ /**
+ * Constructs and initializes an ambient light using default parameters.
+ */
+ public AmbientLight() {
+ }
+
+
+ /**
+ * Constructs and initializes an ambient light using the specified
+ * parameters.
+ * @param color the color of the light source.
+ */
+ public AmbientLight(Color3f color) {
+ super(color);
+ }
+
+
+ /**
+ * Constructs and initializes an ambient light using the specified
+ * parameters.
+ * @param lightOn flag indicating whether this light is on or off.
+ * @param color the color of the light source.
+ */
+ public AmbientLight(boolean lightOn, Color3f color) {
+ super(lightOn, color);
+ }
+
+ /**
+ * Creates the retained mode AmbientLightRetained object that this
+ * AmbientLight component object will point to.
+ */
+ void createRetained() {
+ this.retained = new AmbientLightRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * Applications must not set individual texture component objects
+ * (texture, textureAttributes, or texCoordGeneration) and
+ * the texture unit state array in the same Appearance object.
+ * Doing so will result in an exception being thrown.
+ *
+ * @param texture object that specifies the desired texture
+ * map and texture parameters
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the specified texture
+ * object is non-null and the texture unit state array in this
+ * appearance object is already non-null.
+ *
+ * @exception IllegalSharingException if this Appearance is live and
+ * the specified texture refers to an ImageComponent2D that is being used
+ * by a Canvas3D as an off-screen buffer.
+ *
+ * @exception IllegalSharingException if this Appearance is
+ * being used by an immediate mode context and
+ * the specified texture refers to an ImageComponent2D that is being used
+ * by a Canvas3D as an off-screen buffer.
+ */
+ public void setTexture(Texture texture) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_TEXTURE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance2"));
+
+ // Do illegal sharing check
+ if(texture != null) {
+ ImageComponent[] images = ((TextureRetained)(texture.retained)).getImages();
+ if(images != null) {
+ for(int i=0; i
+ * Applications must not set individual texture component objects
+ * (texture, textureAttributes, or texCoordGeneration) and
+ * the texture unit state array in the same Appearance object.
+ * Doing so will result in an exception being thrown.
+ *
+ * @param texCoordGeneration object that specifies the texture coordinate
+ * generation parameters
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the specified texCoordGeneration
+ * object is non-null and the texture unit state array in this
+ * appearance object is already non-null.
+ */
+ public void setTexCoordGeneration(TexCoordGeneration texCoordGeneration) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_TEXGEN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance18"));
+ ((AppearanceRetained)this.retained).setTexCoordGeneration(texCoordGeneration);
+ }
+
+ /**
+ * Retrieves the current texCoordGeneration object.
+ * @return the texCoordGeneration object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public TexCoordGeneration getTexCoordGeneration() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_TEXGEN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance19"));
+ return ((AppearanceRetained)this.retained).getTexCoordGeneration();
+ }
+
+ /**
+ * Sets the texture unit state array for this appearance object to the
+ * specified array. A shallow copy of the array of references to
+ * the TextureUnitState objects is made. If the specified array
+ * is null or if the length of the array is 0, multi-texture is
+ * disabled. Within the array, a null TextureUnitState element
+ * disables the corresponding texture unit.
+ *
+ *
+ * Applications must not set individual texture component objects
+ * (texture, textureAttributes, or texCoordGeneration) and
+ * the texture unit state array in the same Appearance object.
+ * Doing so will result in an exception being thrown.
+ *
+ * @param stateArray array of TextureUnitState objects that
+ * specify the desired texture state for each unit. The length of
+ * this array specifies the maximum number of texture units that
+ * will be used by this appearance object. The texture units are
+ * numbered from
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to
+ * AudioDevice Interface
+ *
+ *
+ * The AudioDevice object interface specifies an abstract input device
+ * that creators of Java3D class libraries would implement for a particular
+ * device. Java3D's uses several methods to interact with specific devices.
+ * Since all audio devices implement this consistent interface, the user
+ * could have a portable means of initialize, set particular audio device
+ * elements and query generic characteristics for any audio device.
+ *
+ *Initialization
+ *
+ * Audio Playback Type
+ *
+ * Distance to Speaker
+ *
+ * Angular Offset of Speakers
+ *
+ * Device Driver Specific Data
+ *
+ * Instantiating and Registering a New Device
+ *
+ *
+ * The API for instantiating devices is site-specific, but it consists of
+ * a device object with a constructor and at least all of the methods
+ * specified in the AudioDevice interface.
+ *
+ * Once instantiated, the browser or application must register the device
+ * with the Java3D sound scheduler by associating this device with a
+ * PhysicalEnvironment. The setAudioDevice method introduces new devices
+ * to the Java3D environment and the allAudioDevices method produces an
+ * enumeration that allows examining all available devices within a Java3D
+ * environment. See PhysicalEnvironment class for more details.
+ * General Rules for calling AudioDevice methods:
+ * It is illegal for an application to call any non-query AudioDevice method
+ * if the AudioDevice is created then explicitly assigned to a
+ * PhysicalEnvironment using PhysicalEnvironment.setAudioDevice();
+ * When either PhysicalEnvironment.setAudioDevice() is called - including
+ * when implicitly called by SimpleUniverse.getViewer().createAudioDevice()
+ * - the Core creates a SoundScheduler thread which makes calls to
+ * the AudioDevice.
+ *
+ * If an application creates it's own instance of an AudioDevice and
+ * initializes it directly, rather than using PhysicalEnvironment.
+ * setAudioDevice(), that application may make any AudioDevice3D methods calls
+ * without fear of the Java 3D Core also trying to control the AudioDevice.
+ * Under this condition it is safe to call AudioDevice non-query methods.
+ */
+
+public interface AudioDevice {
+
+ /** *************
+ *
+ * Constants
+ *
+ ****************/
+ /**
+ * Audio Playback Types
+ *
+ * Types of audio output device Java3D sound is played over:
+ * Headphones, MONO_SPEAKER, STEREO_SPEAKERS
+ */
+ /**
+ * Choosing Headphones as the audio playback type
+ * specifies that the audio playback will be through stereo headphones.
+ */
+ public static final int HEADPHONES = 0;
+
+ /**
+ * Choosing a
+ * single near-field monoaural speaker
+ * as the audio playback type
+ * specifies that the audio playback will be through a single speaker
+ * some supplied distance away from the listener.
+ */
+ public static final int MONO_SPEAKER = 1;
+
+ /**
+ * Choosing a
+ * two near-field stereo speakers
+ * as the audio playback type
+ * specifies that the audio playback will be through stereo speakers
+ * some supplied distance away from, and at some given angle to
+ * the listener.
+ */
+ public static final int STEREO_SPEAKERS = 2;
+
+ /**
+ * Initialize the audio device.
+ * Exactly what occurs during initialization is implementation dependent.
+ * This method provides explicit control by the user over when this
+ * initialization occurs.
+ * Initialization must be initiated before any other AudioDevice
+ * methods are called.
+ * @return true if initialization was successful without errors
+ */
+ public abstract boolean initialize();
+
+ /**
+ * Code to close the device and release resources.
+ * @return true if close of device was successful without errors
+ */
+ public abstract boolean close();
+
+ /**
+ * Set Type of Audio Playback physical transducer(s) sound is output to.
+ * Valid types are HEADPHONES, MONO_SPEAKER, STEREO_SPEAKERS
+ * @param type audio playback type
+ */
+ public abstract void setAudioPlaybackType(int type);
+
+ /**
+ * Get Type of Audio Playback Output Device.
+ * @return audio playback type
+ */
+ public abstract int getAudioPlaybackType();
+
+ /**
+ * Set Distance from interaural mid-point between Ears to a Speaker.
+ * @param distance from interaural midpoint between the ears to closest speaker
+ */
+ public abstract void setCenterEarToSpeaker(float distance);
+
+ /**
+ * Get Distance from interaural mid-point between Ears to a Speaker.
+ * @return distance from interaural midpoint between the ears to closest speaker
+ */
+ public abstract float getCenterEarToSpeaker();
+
+ /**
+ * Set Angle Offset (in radians) To Speaker.
+ * @param angle in radians from head Z axis and vector from center ear to speaker
+ */
+ public abstract void setAngleOffsetToSpeaker(float angle);
+
+ /**
+ * Get Angle Offset (in radians) To Speaker.
+ * @return angle in radians from head Z axis and vector from center ear to speaker
+ */
+ public abstract float getAngleOffsetToSpeaker();
+
+ /**
+ * Query total number of channels available for sound rendering
+ * for this audio device. This returns the maximum number of channels
+ * available for Java3D sound rendering for all sound sources.
+ * @return total number of channels that can be used for this audio device
+ */
+ public abstract int getTotalChannels();
+
+ /**
+ * Query number of channels currently available for use.
+ * During rendering, when sound nodes are playing, this method returns the
+ * number of channels still available to Java3D for rendering additional
+ * sound nodes.
+ * @return total number of channels current available
+ */
+ public abstract int getChannelsAvailable();
+
+ /**
+ * Query number of channels that are used, or would be used to render
+ * a particular sound node. This method returns the number of channels
+ * needed to render a particular Sound node. The return value is the same
+ * no matter if the Sound is currently active and enabled (being played) or
+ * is inactive.
+ * @return number of channels a particular Sound node is using or would used
+ * if enabled and activated (rendered).
+ */
+ public abstract int getChannelsUsedForSound(Sound node);
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AudioDevice3D.java b/j3d-core/src/classes/share/javax/media/j3d/AudioDevice3D.java
new file mode 100644
index 0000000..4a01fb0
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AudioDevice3D.java
@@ -0,0 +1,534 @@
+/*
+ * $RCSfile: AudioDevice3D.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+
+
+/**
+ * The AudioDevice3D class defines a 3D audio device that is used to set
+ * sound and aural attributes.
+ *
+ * After the application chooses the AudioDevice3D that Java3D sound
+ * is to be rendered on, the Java 3D Sound Scheduler will call these
+ * methods for all active sounds to render them on the audio device.
+ *
+ * The intent is for this interface to be implemented by AudioDevice Driver
+ * developers using a software or hardware sound engine of their choice.
+ *
+ * Methods in this interface provide the Java3D Core a generic way to
+ * set and query the audio device the application has chosen audio rendering
+ * to be performed on. Methods in this interface include:
+ *
+ * Start, stop, pause, unpause, mute, and unmute of sample on the device.
+ *
+ * Set parameters for each sample corresponding to the fields in the
+ * Sound node.
+ *
+ * Set the current active aural parameters that affect all positional samples.
+ *
+ * Sound Types
+ *
+ * Sound types match the Sound node classes defined for Java 3D core
+ * for BackgroundSound, PointSound, and ConeSound. The type of sound
+ * a sample is loaded as determines which methods affect it.
+ *
+ *
+ * Sound Data Types
+ *
+ * Samples can be processed as streaming or buffered data.
+ * Fully spatializing sound sources may require data to be buffered.
+ *
+ */
+
+public interface AudioDevice3D extends AudioDevice {
+
+ /**
+ * Specifies the sound type as background sound.
+ */
+ public static final int BACKGROUND_SOUND = 1;
+
+ /**
+ * Specifies the sound type as point sound.
+ */
+ public static final int POINT_SOUND = 2;
+
+ /**
+ * Specifies the sound type as cone sound.
+ */
+
+ public static final int CONE_SOUND = 3;
+
+ /**
+ * Sound data specified as Streaming is not copied by the AudioDevice
+ * driver implementation. It is up to the application to ensure that
+ * this data is continuously accessible during sound rendering.
+ * Furthermore, full sound spatialization may not be possible, for
+ * all AudioDevice3D implementations on unbuffered sound data.
+ */
+ public static final int STREAMING_AUDIO_DATA = 1;
+ /**
+ * Sound data specified as Buffered is copied by the AudioDevice
+ * driver implementation.
+ */
+ public static final int BUFFERED_AUDIO_DATA = 2;
+
+
+ /**
+ * Accepts a reference to the current View.
+ * Passes reference to current View Object. The PhysicalEnvironment
+ * parameters (with playback type and speaker placement), and the
+ * PhysicalBody parameters (position/orientation of ears)
+ * can be obtained from this object, and the transformations to/from
+ * ViewPlatform coordinate (space the listener's head is in) and
+ * Virtual World coordinates (space sounds are in).
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param reference the current View
+ */
+ public abstract void setView(View reference);
+
+ /**
+ * Accepts a reference to the MediaContainer
+ * which contains a reference to sound data and information about the
+ * type of data it is. A "sound type" input parameter denotes if the
+ * Java 3D sound associated with this sample is a Background, Point, or
+ * Cone Sound node.
+ * Depending on the type of MediaContainer the sound data is and on the
+ * implementation of the AudioDevice used, sound data preparation could
+ * consist of opening, attaching, or loading sound data into the device.
+ * Unless the cached flag is true, this sound data should NOT be copied,
+ * if possible, into host or device memory.
+ *
+ * Once this preparation is complete for the sound sample, an AudioDevice
+ * specific index, used to reference the sample in future method calls,
+ * is returned. All the rest of the methods described below require
+ * this index as a parameter.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param soundType defines the type of Sound Node: Background, Point, and
+ * Cone
+ * @param soundData reference to MediaContainer sound data and cached flag
+ * @return device specific sample index used for referencing this sound
+ */
+ public abstract int prepareSound(int soundType, MediaContainer soundData);
+
+ /**
+ * Requests that the AudioDevice free all
+ * resources associated with sample with index id.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ */
+ public abstract void clearSound(int index);
+
+ /**
+ * Returns the duration in milliseconds of the sound sample,
+ * if this information can be determined.
+ * For non-cached
+ * streams, this method returns Sound.DURATION_UNKNOWN.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @return sound duration in milliseconds if this can be determined,
+ * otherwise (for non-cached streams) Sound.DURATION_UNKNOWN is returned
+ */
+ public abstract long getSampleDuration(int index);
+
+ /**
+ *
+ * Retrieves the number of channels (on executing audio device) that
+ * this sound is using, if it is playing, or is expected to use
+ * if it were begun to be played. This form of this method takes the
+ * sound's current state (including whether it is muted or unmuted)
+ * into account.
+ *
+ * For some AudioDevice3D implementations:
+ *
+ * A single sound could be rendered using multiple samples, each taking
+ * up mixer channels.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @return number of channels used by sound if it were playing
+ */
+ public abstract int getNumberOfChannelsUsed(int index);
+
+ /**
+ *
+ * Retrieves the number of channels (on executing audio device) that
+ * this sound is using, if it is playing, or is projected to use if
+ * it were to be started playing. Rather than using the actual current
+ * muted/unmuted state of the sound, the muted parameter is used in
+ * making the determination.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param muted flag to use as the current muted state ignoring current
+ * mute state
+ * @return number of channels used by sound if it were playing
+ */
+ public abstract int getNumberOfChannelsUsed(int index, boolean muted);
+
+ /**
+ * Begins a sound playing on the AudioDevice.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @return flag denoting if sample was started; 1 if true, 0 if false
+ */
+ public abstract int startSample(int index);
+
+ /**
+ * Returns the system time of when the sound
+ * was last "started". Note that this start time will be as accurate
+ * as the AudioDevice implementation can make it - but that it is not
+ * guaranteed to be exact.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @return system time in milliseconds of the last time sound was started
+ */
+ public abstract long getStartTime(int index);
+
+ /**
+ * Stops the sound on the AudioDevice.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * associated with sound data to be played
+ * @return flag denoting if sample was stopped; 1 if true, 0 if false
+ */
+ public abstract int stopSample(int index);
+
+ /**
+ * Sets the overall gain scale factor applied to data associated with this
+ * source to increase or decrease its overall amplitude.
+ * The gain scale factor value passed into this method is the combined value
+ * of the Sound node's Initial Gain and the current AuralAttribute Gain
+ * scale factors.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param scaleFactor amplitude (gain) scale factor
+ */
+ public abstract void setSampleGain(int index, float scaleFactor);
+
+ /**
+ * Sets a sound's loop count.
+ * A full description of this parameter and how it is used is in
+ * the documentation for Sound.setLoop.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param count number of times sound is looped during play
+ * @see Sound#setLoop
+ */
+ public abstract void setLoop(int index, int count);
+
+ /**
+ * Passes a reference to the concatenated transformation to be applied to
+ * local sound position and direction parameters.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param trans transformation matrix applied to local coordinate parameters
+ */
+ public abstract void setVworldXfrm(int index, Transform3D trans);
+
+
+ /**
+ * Sets this sound's location (in Local coordinates) from specified
+ * Point. The form of the position parameter matches those of the PointSound
+ * method of the same name.
+ * A full description of this parameter and how it is used is in
+ * the documentation for PointSound class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param position location of Point or Cone Sound in Virtual World
+ * coordinates
+ * @see PointSound#setPosition(float x, float y, float z)
+ * @see PointSound#setPosition(Point3f position)
+ */
+ public abstract void setPosition(int index, Point3d position);
+
+ /**
+ * Sets this sound's distance gain elliptical attenuation (not
+ * including filter cutoff frequency) by defining corresponding
+ * arrays containing distances from the sound's origin and gain
+ * scale factors applied to all active positional sounds.
+ * Gain scale factor is applied to sound based on the distance
+ * the listener
+ * is from sound source.
+ * These attenuation parameters are ignored for BackgroundSound nodes.
+ * The back attenuation parameter is ignored for PointSound nodes.
+ *
+ * The form of the attenuation parameters match that of the ConeSound method
+ * of the same name.
+ * A full description of this parameter and how it is used is in
+ * the documentation for ConeSound class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param frontDistance defines an array of distance along positive axis
+ * through which ellipses pass
+ * @param frontAttenuationScaleFactor gain scale factors
+ * @param backDistance defines an array of distance along the negative axis
+ * through which ellipses pass
+ * @param backAttenuationScaleFactor gain scale factors
+ * @see ConeSound#setDistanceGain(float[] frontDistance, float[] frontGain,
+ * float[] backDistance, float[] backGain)
+ * @see ConeSound#setDistanceGain(Point2f[] frontAttenuation,
+ * Point2f[] backAttenuation)
+ */
+ public abstract void setDistanceGain(int index,
+ double[] frontDistance, float[] frontAttenuationScaleFactor,
+ double[] backDistance, float[] backAttenuationScaleFactor);
+ /**
+ * Sets this sound's direction from the local coordinate vector provided.
+ * The form of the direction parameter matches that of the ConeSound method
+ * of the same name.
+ * A full description of this parameter and how it is used is in
+ * the documentation for the ConeSound class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param direction the new direction vector in local coordinates
+ * @see ConeSound#setDirection(float x, float y, float z)
+ * @see ConeSound#setDirection(Vector3f direction)
+ */
+ public abstract void setDirection(int index, Vector3d direction);
+
+ /**
+ * Sets this sound's angular gain attenuation (including filter)
+ * by defining corresponding arrays containing angular offsets from
+ * the sound's axis, gain scale factors, and frequency cutoff applied
+ * to all active directional sounds.
+ * Gain scale factor is applied to sound based on the angle between the
+ * sound's axis and the ray from the sound source origin to the listener.
+ * The form of the attenuation parameter matches that of the ConeSound
+ * method of the same name.
+ * A full description of this parameter and how it is used is in
+ * the documentation for the ConeSound class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ * @param filterType describes type (if any) of filtering defined by attenuation
+ * @param angle array containing angular distances from sound axis
+ * @param attenuationScaleFactor array containing gain scale factor
+ * @param filterCutoff array containing filter cutoff frequencies.
+ * The filter values for each tuples can be set to Sound.NO_FILTER.
+ * @see ConeSound#setAngularAttenuation(float[] distance, float[] gain,
+ * float[] filter)
+ * @see ConeSound#setAngularAttenuation(Point3f[] attenuation)
+ * @see ConeSound#setAngularAttenuation(Point2f[] attenuation)
+ */
+ public abstract void setAngularAttenuation(int index, int filterType,
+ double[] angle, float[] attenuationScaleFactor, float[] filterCutoff);
+
+ /**
+ * Changes the speed of sound factor.
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param rolloff atmospheric gain scale factor (changing speed of sound)
+ * @see AuralAttributes#setRolloff
+ */
+ public abstract void setRolloff(float rolloff);
+
+ /**
+ * Sets the Reflective Coefficient scale factor applied to distinct
+ * low-order early reflections of sound off the surfaces in the region
+ * defined by the current listening region.
+ *
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param coefficient reflection/absorption factor applied to reverb
+ * @see AuralAttributes#setReflectionCoefficient
+ */
+ public abstract void setReflectionCoefficient(float coefficient);
+
+ /**
+ * Sets the reverberation delay time.
+ * In this form, while reverberation is being rendered, the parameter
+ * specifies the delay time between each order of late reflections
+ * explicitly given in milliseconds.
+ * A value for delay time of 0.0 disables
+ * reverberation.
+ *
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param reverbDelay time between each order of late reflection
+ * @see AuralAttributes#setReverbDelay(float reverbDelay)
+ */
+ public abstract void setReverbDelay(float reverbDelay);
+
+ /**
+ * Sets the reverberation order of reflections.
+ * The reverbOrder parameter specifies the number of times reflections are added to
+ * reverberation being calculated. A value of -1 specifies an unbounded
+ * number of reverberations.
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param reverbOrder number of times reflections added to reverb signal
+ * @see AuralAttributes#setReverbOrder
+ */
+ public abstract void setReverbOrder(int reverbOrder);
+
+ /**
+ * Sets Distance Filter corresponding arrays containing distances and
+ * frequency cutoff applied to all active positional sounds.
+ * Gain scale factor is applied to sound based on the distance the listener
+ * is from the sound source.
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param filterType denotes the type of filtering to be applied
+ * @param distance array of offset distances from sound origin
+ * @param filterCutoff array of frequency cutoff
+ * @see AuralAttributes#setDistanceFilter(float[] distance,
+ * float[] frequencyCutoff)
+ * @see AuralAttributes#setDistanceFilter(Point2f[] attenuation)
+ */
+ public abstract void setDistanceFilter(int filterType,
+ double[] distance, float[] filterCutoff);
+
+ /**
+ * Specifies a scale factor applied to the frequency (or
+ * wavelength). A value less than 1.0 will result of slowing the playback
+ * rate of the sample. A value greater than 1.0 will increase the playback
+ * rate.
+ * This parameter is also used to expand or contract the usual
+ * frequency shift applied to the sound source due to Doppler effect
+ * calculations. Valid values are >= 0.0.
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param frequencyScaleFactor factor applied to change of frequency
+ * @see AuralAttributes#setFrequencyScaleFactor
+ */
+ public abstract void setFrequencyScaleFactor(float frequencyScaleFactor);
+
+ /**
+ * Sets the Velocity scale factor applied during Doppler Effect calculation.
+ * This parameter specifies a scale factor applied to the velocity of sound
+ * relative to the listener's position and movement in relation to the sound's
+ * position and movement. This scale factor is multipled by the calculated
+ * velocity portion of the Doppler effect equation used during sound rendering.
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param velocityScaleFactor applied to velocity of sound in relation
+ * to listener
+ * @see AuralAttributes#setVelocityScaleFactor
+ */
+ public abstract void setVelocityScaleFactor(float velocityScaleFactor);
+
+ /**
+ * Makes the sample 'play silently'.
+ * This method implements (as efficiently as possible) the muting
+ * of a playing sound sample. Ideally this is implemented by
+ * stopping a sample and freeing channel resources (rather than
+ * just setting the gain of the sample to zero).
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ */
+ public abstract void muteSample(int index);
+
+ /**
+ * Makes a silently playing sample audible.
+ * In the ideal, this restarts a muted sample by offset from the
+ * beginning by the number of milliseconds since the time the sample
+ * began playing (rather than setting gain to current non-zero gain).
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ */
+ public abstract void unmuteSample(int index);
+
+ /**
+ * Temporarily stops a cached sample from playing without resetting the
+ * sample's current pointer back to the beginning of the sound data so
+ * that it can be unpaused at a later time from the same location in the
+ * sample when the pause was initiated. Pausing a streaming, non-cached
+ * sound sample will be treated as a mute.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ */
+ public abstract void pauseSample(int index);
+
+ /**
+ * Restarts the paused sample from the location in the sample where
+ * paused.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ */
+ public abstract void unpauseSample(int index);
+
+ /**
+ *
+ * Explicitly updates a Sample.
+ * This method is called when a Sound is to be explicitly updated.
+ * It is only called when all a sounds parameters are known to have
+ * been passed to the audio device. In this way, an implementation
+ * can choose to perform lazy-evaluation of a sample, rather than
+ * updating the rendering state of the sample after every individual
+ * parameter changed.
+ * This method can be left as a null method if the implementor so chooses.
+ *
+ * This method should only be called by Java3D Core and NOT by any application.
+ * @param index device specific reference number to device driver sample
+ */
+ public abstract void updateSample(int index);
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AudioDevice3DL2.java b/j3d-core/src/classes/share/javax/media/j3d/AudioDevice3DL2.java
new file mode 100644
index 0000000..caa5c72
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AudioDevice3DL2.java
@@ -0,0 +1,324 @@
+/*
+ * $RCSfile: AudioDevice3DL2.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+/**
+ * Extends AudioDevice3D to include reverb and environmental audio parameters
+ * that are defined in the MIDI Manufactures' Association Interactive Audio
+ * Special Interest Group (MMA IASIG) Level 2 Specification.
+ *
+ * The reverberation methods of AudioDevice3DL2 interface augment the
+ * reverberation methods defined in AudioDevice3D.
+ *
+ * The intent is for this interface to be implemented by AudioDevice Driver
+ * developers using a software or hardware sound engine of their choice.
+ *
+ * Methods in this interface provide the Java3D Core a generic way to
+ * set and query the audio device the application has chosen audio rendering
+ * to be performed on.
+ *
+ * The non-query methods of this interface should only be called by
+ * an application if the AudioDevice instance
+ * is not referenced by any PhysicalEnvironment
+ * explicitly with .setAudioDevice() or implicitly through Universe
+ * utility method in which case these are called by Core Java 3D
+ * Sound classes and Sound Scheduler thread(s).
+ *
+ * After the application chooses the AudioDevice3DL2 implementation
+ * that Java3D sound is to be rendered on, the Java 3D Sound Scheduler
+ * will call these methods for all active sounds to render them on the
+ * audio device.
+ *
+ * The AudioDevice3DL2 methods should not be call by any application if the
+ * audio device is associated with a Physical Environment and thus used by
+ * Java3D Core.
+ *
+ * Filtering for this extended AudioDevice interface is defined uniformly as
+ * a simple low-pass filter defined by a cutoff frequency. This will allow the
+ * same type of high-frequency attenuation that the MMA IASIG Level 2 filtering
+ * model with its 'reference frequency' and 'attenuation ratio' parameters
+ * affords. Use of a cutoff frequency is consistent with the filtering type
+ * for distance and angular attenuation for ConeSound and AuralAttributes.
+ * The filter methods will likely be overloaded in some future extension of this
+ * interface.
+ *
+ * @see Sound
+ * @see AuralAttributes
+ * @see AudioDevice3D
+ * @since Java 3D 1.3
+ */
+
+public interface AudioDevice3DL2 extends AudioDevice3D {
+
+ /**
+ * Pause audio device engine (thread/server) without closing the device.
+ * Causes all cached sounds to be paused and all streaming sounds to be
+ * stopped.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * This method will be implicitly called when View (associated with this
+ * device) is deactivated.
+ */
+ public abstract void pause();
+
+ /**
+ * Resumes audio device engine (if previously paused) without reinitializing
+ * the device.
+ * Causes all paused cached sounds to be resumed and all streaming sounds
+ * restarted.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * This method will be implicitly called when View (associated with this
+ * device) is actived.
+ */
+ public abstract void resume();
+
+ /**
+ * Set overall gain control of all sounds playing on the audio device.
+ * Default: 1.0f = no attenuation.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * @param scaleFactor scale factor applied to calculated amplitudes for
+ * all sounds playing on this device
+ */
+ public abstract void setGain(float scaleFactor);
+
+ /**
+ * Set scale factor applied to sample playback rate for a particular sound
+ * associated with the audio device.
+ * Changing the device sample rate affects both the pitch and speed.
+ * This scale factor is applied to ALL sound types.
+ * Changes (scales) the playback rate of a sound independent of
+ * Doppler rate changes.
+ * Default: 1.0f = original sample rate is unchanged
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * @param sampleId device specific reference number to device driver sample
+ * @param scaleFactor non-negative factor applied to calculated
+ * amplitudes for all sounds playing on this device
+ */
+ public abstract void setRateScaleFactor(int sampleId, float scaleFactor);
+
+
+ /**
+ * Set late reflection (referred to as 'reverb') attenuation.
+ * This scale factor is applied to iterative, indistinguishable
+ * late reflections that constitute the tail of reverberated sound in
+ * the aural environment.
+ * This parameter, along with the early reflection coefficient, defines
+ * the reflective/absorptive characteristic of the surfaces in the
+ * current listening region.
+ * A coefficient value of 0 disables reverberation.
+ * Valid values of parameters range from 0.0 to 1.0.
+ * Default: 0.0f.
+ *
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * @param coefficient late reflection attenuation factor
+ * @see AuralAttributes#setReverbCoefficient
+ */
+ public abstract void setReverbCoefficient(float coefficient);
+
+
+ /**
+ * Sets the early reflection delay time.
+ * In this form, the parameter specifies the delay time between each order
+ * of reflection (while reverberation is being rendered) explicitly given
+ * in milliseconds.
+ * Valid values are non-negative floats.
+ * There may be limitations imposed by the device on how small or large this
+ * value can be made.
+ * A value of 0.0 would result in early reflections being added as soon as
+ * possible after the sound begins.
+ * Default = 20.0 milliseconds.
+ *
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * @param reflectionDelay time between each order of early reflection
+ * @see AuralAttributes#setReflectionDelay
+ */
+ public abstract void setReflectionDelay(float reflectionDelay);
+
+ /**
+ * Set reverb decay time.
+ * Defines the reverberation decay curve.
+ * Default: 1000.0 milliseconds.
+ *
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * @param time decay time in milliseconds
+ * @see AuralAttributes#setDecayTime
+ */
+ public abstract void setDecayTime(float time);
+
+ /**
+ * Set reverb decay filter.
+ * This provides for frequencies above the given cutoff frequency to be
+ * attenuated during reverb decay at a different rate than frequencies
+ * below this value. Thus, defining a different reverb decay curve for
+ * frequencies above the cutoff value.
+ * Default: 1.0 decay is uniform for all frequencies.
+ *
+ * There is no corresponding Core AuralAttributes method at this time.
+ * Until high frequency attenuation is supported by new Core API,
+ * this will be set by the Core with the value 1.0.
+ * It is highly recommended that this method should NOT be
+ * called by any application if the audio device is associated with
+ * a Physical Environment used by Java3D Core.
+ * @param frequencyCutoff value of frequencies in Hertz above which a
+ * low-pass filter is applied.
+ * @see AuralAttributes#setDecayFilter
+ */
+ public abstract void setDecayFilter(float frequencyCutoff);
+
+ /**
+ * Set reverb diffusion.
+ * This defines the echo dispersement (also referred to as 'echo density').
+ * The value of this reverb parameter is expressed as a percent of the
+ * audio device's minimum-to-maximum values.
+ * Default: 1.0f - maximum diffusion on device.
+ *
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * @param diffusion percentage expressed within the range of 0.0 and 1.0
+ * @see AuralAttributes#setDiffusion
+ */
+ public abstract void setDiffusion(float diffusion);
+
+ /**
+ * Set reverb density.
+ * This defines the modal density (also referred to as 'spectral
+ * coloration').
+ * The value of this parameter is expressed as a percent of the audio
+ * device's minimum-to-maximum values for this reverb parameter.
+ * Default: 1.0f - maximum density on device.
+ *
+ * A full description of this parameter and how it is used is in
+ * the documentation for the AuralAttributes class.
+ *
+ * This method should NOT be called by any application if the audio device
+ * is associated with a Physical Environment used by Java3D Core.
+ * @param density reverb density expressed as a percentage,
+ * within the range of 0.0 and 1.0
+ * @see AuralAttributes#setDensity
+ */
+ public abstract void setDensity(float density);
+
+
+ /**
+ * Set the obstruction gain control. This method allows for attenuating
+ * sound waves traveling between the sound source and the listener
+ * obstructed by objects. Direct sound signals/waves for obstructed sound
+ * source are attenuated but not indirect (reflected) waves.
+ * Default: 1.0 - gain is not attenuated; obstruction is not occurring.
+ *
+ * There is no corresponding Core AuralAttributes method at this time.
+ * Even so, this method should NOT be called by any application if the
+ * audio device is associated with a Physical Environment used by Java3D
+ * Core.
+ * @param sampleId device specific reference number to device driver sample
+ * @param scaleFactor non-negative factor applied to direct sound gain
+ */
+ public abstract void setObstructionGain(int sampleId, float scaleFactor);
+
+ /**
+ * Set the obstruction filter control.
+ * This provides for frequencies above the given cutoff frequency
+ * to be attenuated, during while the gain of an obstruction signal
+ * is being calculated, at a different rate than frequencies
+ * below this value.
+ * Default: 1.0 - filtering is uniform for all frequencies.
+ *
+ * There is no corresponding Core AuralAttributes method at this time.
+ * Until high frequency attenuation is supported by new Core API
+ * this will be set by the Core with the value 1.0.
+ * It is highly recommended that this method should NOT be
+ * called by any application if the audio device is associated with
+ * a Physical Environment used by Java3D Core.
+ * @param frequencyCutoff value of frequencies in Hertz above which a
+ * low-pass filter is applied.
+ */
+
+ public abstract void setObstructionFilter(int sampleId, float frequencyCutoff);
+
+ /**
+ * Set the occlusion gain control. This method allows for attenuating
+ * sound waves traveling between the sound source and the listener
+ * occluded by objects. Both direct and indirect sound signals/waves
+ * for occluded sound sources are attenuated.
+ * Default: 1.0 - gain is not attenuated; occlusion is not occurring.
+ *
+ * There is no corresponding Core AuralAttributes method at this time.
+ * Even so, this method should NOT be called by any application if the
+ * audio device is associated with a Physical Environment used by Java3D
+ * Core.
+ * @param sampleId device specific reference number to device driver sample
+ * @param scaleFactor non-negative factor applied to direct sound gain
+ */
+ public abstract void setOcclusionGain(int sampleId, float scaleFactor);
+
+ /**
+ * Set the occlusion filter control.
+ * This provides for frequencies above the given cutoff frequency
+ * to be attenuated, during while the gain of an occluded signal
+ * is being calculated, at a different rate than frequencies below
+ * this value.
+ * Default: 1.0 - filtering is uniform for all frequencies.
+ *
+ * There is no corresponding Core AuralAttributes method at this time.
+ * Until high frequency attenuation is supported by new Core API
+ * this will be set by the Core with the value 1.0.
+ * It is highly recommended that this method should NOT be
+ * called by any application if the audio device is associated with
+ * a Physical Environment used by Java3D Core.
+ * @param frequencyCutoff value of frequencies in Hertz above which a
+ * low-pass filter is applied.
+ */
+ public abstract void setOcclusionFilter(int sampleId, float frequencyCutoff);
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AudioDeviceEnumerator.java b/j3d-core/src/classes/share/javax/media/j3d/AudioDeviceEnumerator.java
new file mode 100644
index 0000000..ed8fb66
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AudioDeviceEnumerator.java
@@ -0,0 +1,86 @@
+/*
+ * $RCSfile: AudioDeviceEnumerator.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Enumeration;
+import java.util.NoSuchElementException;
+
+/**
+ * The class that enumerates all AudioDevices defined in the environment
+ *
+ * An AudioDeviceEnumerator generates the audio devices defined with the
+ * execution environment of the currently running Java 3D application.
+ */
+
+class AudioDeviceEnumerator implements Enumeration {
+
+ boolean endOfList; // NOTE: list length always equals one or zero
+ AudioDevice device;
+
+ AudioDeviceEnumerator(PhysicalEnvironment physicalEnvironment) {
+ device = physicalEnvironment.getAudioDevice();
+ if(device == null)
+ endOfList = true;
+ else
+ endOfList = false;
+ }
+
+ void reset() {
+ if(device != null)
+ endOfList = false;
+ }
+
+
+ /**
+ * Query that tells whether the enumerator has more elements
+ * @return true if the enumerator has more elements, false otherwise
+ */
+ public boolean hasMoreElements() {
+ if(endOfList == false)
+ return true;
+ else
+ return false;
+ }
+
+ /**
+ * Return the next element in the enumerators
+ * @return the next element in this enumerator
+ */
+ public Object nextElement() {
+ if (this.hasMoreElements()) {
+ endOfList = true;
+ return ((Object) device);
+ } else {
+ throw new NoSuchElementException(J3dI18N.getString("AudioDeviceEnumerator0"));
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AuralAttributes.java b/j3d-core/src/classes/share/javax/media/j3d/AuralAttributes.java
new file mode 100644
index 0000000..02d82b2
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AuralAttributes.java
@@ -0,0 +1,1309 @@
+/*
+ * $RCSfile: AuralAttributes.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Point2f;
+
+/**
+ * The AuralAttributes object is a component object of a Soundscape node that
+ * defines environmental audio parameters that affect sound rendering. These
+ * attributes include gain scale factor, atmospheric rolloff, and parameters
+ * controlling reverberation, distance frequency filtering, and velocity-based
+ * Doppler effect.
+ *
+ * Attribute Gain
+ *
+ * Attribute Gain Rolloff
+ *
+ * Auralization
+ *
+ * In Java3D's model for auralization there are several parameters
+ * that approximate sound reflection and reverberation for a particular
+ * listening space:
+ *
+ * Reflection Coefficient
+ *
+ * Reflection Delay
+ *
+ * Reverberation Coefficient
+ *
+ * Reverberation Delay
+ *
+ * Reverberation Bounds
+ *
+ * Reverberation Order
+ *
+ * Decay Time
+ *
+ * Decay Filter
+ *
+ * Reverberation Diffusion
+ *
+ * Reverberation Density
+ *
+ * Distance Filter
+ *
+ * If the distance from the listener to the sound source is less than the
+ * first distance in the array, the first filter is applied to the sound
+ * source. This creates a spherical region around the listener within
+ * which a sound is uniformly attenuated by the first filter in the array.
+ * If the distance from the listener to the sound source is greater than
+ * the last distance in the array, the last filter is applied to the sound
+ * source.
+ *
+ * Distance elements in these array of pairs is a monotonically-increasing
+ * set of floating point numbers measured from the location of the sound
+ * source. FrequencyCutoff elements in this list of pairs can be any
+ * positive float. While for most applications this list of values will
+ * usually be monotonically-decreasing, they do not have to be.
+ *
+ * The getDistanceFilterLength method returns the length of the distance filter
+ * arrays. Arrays passed into getDistanceFilter methods should all be at
+ * least this size.
+ * Doppler Effect Model
+ *
+ * The FrequencyScaleFactor can be used to increase or reduce the change
+ * of frequency associated with normal Doppler calculation, or to shift
+ * the pitch of the sound directly if Doppler effect is disabled.
+ * Values must be > zero for sounds to be heard. If the value is zero,
+ * sounds affected by this AuralAttribute object are paused.
+ *
+ * To simulate Doppler effect, the relative velocity (change in
+ * distance in the local coordinate system between the sound source and
+ * the listener over time, in meters per second) is calculated. This
+ * calculated velocity is multipled by the given VelocityScaleFactor.
+ * Values must be >= zero. If is a scale factor value of zero is given,
+ * Doppler effect is not calculated or applied to sound.
+ * The set of nodes that can be added to a BranchGroup associated with
+ * a Background node is limited. All Group nodes except
+ * ViewSpecificGroup are legal in a background geometry branch
+ * graph. The only Leaf nodes that are legal are Shape3D (except
+ * OrientedShape3D), Morph, Light, and Fog. The presence of any other
+ * Leaf node, including OrientedShape3D, or of a ViewSpecificGroup
+ * node will cause an IllegalSceneGraphException to be thrown. Note
+ * that Link nodes are not allowed; a background geometry branch graph
+ * must not reference shared subgraphs. NodeComponent objects can be
+ * shared between background branches and ordinary (non-background)
+ * branches or among different background branches, however.
+ *
+ *
+ * Light and Fog nodes in a background geometry branch graph do not
+ * affect nodes outside of the background geometry branch graph, and
+ * vice versa. Light and Fog nodes that appear in a background
+ * geometry branch graph must not be hierarchically scoped to any
+ * group node outside of that background geometry branch graph.
+ * Conversely, Light and Fog nodes that appear outside of a particular
+ * background geometry branch graph must not be hierarchically scoped
+ * to any group node in that background geometry branch graph. Any
+ * attempt to do so will be ignored.
+ *
+ *
+ * The influencing bounds of any Light or Fog node in a background
+ * geometry branch graph is effectively infinite (meaning that all
+ * lights can affect all geometry objects nodes within the background
+ * geometry graph, and that an arbitrary fog is selected). An
+ * application wishing to limit the scope of a Light or Fog node must
+ * use hierarchical scoping.
+ *
+ *
+ * Picking and collision is ignored for nodes inside a background
+ * geometry branch graph.
+ */
+public class Background extends Leaf {
+ /**
+ * Specifies that the Background allows read access to its application
+ * bounds and bounding leaf at runtime.
+ */
+ public static final int
+ ALLOW_APPLICATION_BOUNDS_READ = CapabilityBits.BACKGROUND_ALLOW_APPLICATION_BOUNDS_READ;
+
+ /**
+ * Specifies that the Background allows write access to its application
+ * bounds and bounding leaf at runtime.
+ */
+ public static final int
+ ALLOW_APPLICATION_BOUNDS_WRITE = CapabilityBits.BACKGROUND_ALLOW_APPLICATION_BOUNDS_WRITE;
+
+ /**
+ * Specifies that the Background allows read access to its image
+ * at runtime.
+ */
+ public static final int
+ ALLOW_IMAGE_READ = CapabilityBits.BACKGROUND_ALLOW_IMAGE_READ;
+
+ /**
+ * Specifies that the Background allows write access to its image
+ * at runtime.
+ */
+ public static final int
+ ALLOW_IMAGE_WRITE = CapabilityBits.BACKGROUND_ALLOW_IMAGE_WRITE;
+
+ /**
+ * Specifies that the Background allows read access to its color
+ * at runtime.
+ */
+ public static final int
+ ALLOW_COLOR_READ = CapabilityBits.BACKGROUND_ALLOW_COLOR_READ;
+
+ /**
+ * Specifies that the Background allows write access to its color
+ * at runtime.
+ */
+ public static final int
+ ALLOW_COLOR_WRITE = CapabilityBits.BACKGROUND_ALLOW_COLOR_WRITE;
+
+ /**
+ * Specifies that the Background allows read access to its
+ * background geometry at runtime.
+ */
+ public static final int
+ ALLOW_GEOMETRY_READ = CapabilityBits.BACKGROUND_ALLOW_GEOMETRY_READ;
+
+ /**
+ * Specifies that the Background allows write access to its
+ * background geometry at runtime.
+ */
+ public static final int
+ ALLOW_GEOMETRY_WRITE = CapabilityBits.BACKGROUND_ALLOW_GEOMETRY_WRITE;
+
+ /**
+ * Specifies that the Background allows read access to its image
+ * scale mode at runtime.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int ALLOW_IMAGE_SCALE_MODE_READ =
+ CapabilityBits.BACKGROUND_ALLOW_IMAGE_SCALE_MODE_READ;
+
+ /**
+ * Specifies that the Background allows write access to its image
+ * scale mode at runtime.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int ALLOW_IMAGE_SCALE_MODE_WRITE =
+ CapabilityBits.BACKGROUND_ALLOW_IMAGE_SCALE_MODE_WRITE;
+
+
+ /**
+ * Indicates that no scaling of the background image is done. The
+ * image will be drawn in its actual size. If the window is
+ * smaller than the image, the image will be clipped. If the
+ * window is larger than the image, the portion of the window not
+ * filled by the image will be filled with the background color.
+ * In all cases, the upper left corner of the image is anchored at
+ * the upper-left corner of the window.
+ * This is the default mode.
+ *
+ * @see #setImageScaleMode
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int SCALE_NONE = 0;
+
+ /**
+ * Indicates that the background image is uniformly scaled to fit
+ * the window such that the entire image is visible. The image is
+ * scaled by the smaller of
+ * For any
+ *
+ * @param originalNode the original node to duplicate
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ * For any
+ * The scheduling region defines a spatial volume that serves
+ * to enable the scheduling of Behavior nodes. A Behavior node is
+ * active (can receive stimuli) whenever an active ViewPlatform's
+ * activation volume intersects a Behavior object's scheduling
+ * region. Only active behaviors can receive stimuli.
+ *
+ *
+ * The scheduling interval defines a partial order of execution
+ * for behaviors that wake up in response to the same wakeup condition
+ * (that is, those behaviors that are processed at the same "time").
+ * Given a set of behaviors whose wakeup conditions are satisfied at
+ * the same time, the behavior scheduler will execute all behaviors in
+ * a lower scheduling interval before executing any behavior in a
+ * higher scheduling interval. Within a scheduling interval,
+ * behaviors can be executed in any order, or in parallel. Note that
+ * this partial ordering is only guaranteed for those behaviors that
+ * wake up at the same time in response to the same wakeup condition,
+ * for example, the set of behaviors that wake up every frame in
+ * response to a WakeupOnElapsedFrames(0) wakeup condition.
+ *
+ *
+ * The
+ * The
+ * Code Structure
+ *
+ * When the Java 3D behavior scheduler invokes a Behavior object's
+ * processStimulus method, that method may perform any computation it
+ * wishes. Usually, it will change its internal state and specify its
+ * new wakeup conditions. Most probably, it will manipulate scene
+ * graph elements. However, the behavior code can only change those
+ * aspects of a scene graph element permitted by the capabilities
+ * associated with that scene graph element. A scene graph's
+ * capabilities restrict behavioral manipulation to those
+ * manipulations explicitly allowed.
+ *
+ *
+ * The application must provide the Behavior object with references to
+ * those scene graph elements that the Behavior object will
+ * manipulate. The application provides those references as arguments
+ * to the behavior's constructor when it creates the Behavior
+ * object. Alternatively, the Behavior object itself can obtain access
+ * to the relevant scene graph elements either when Java 3D invokes
+ * its initialize method or each time Java 3D invokes its
+ * processStimulus method.
+ *
+ *
+ * Behavior methods have a very rigid structure. Java 3D assumes that
+ * they always run to completion (if needed, they can spawn
+ * threads). Each method's basic structure consists of the following:
+ *
+ *
+ *
+ * WakeupCondition Object
+ *
+ * A WakeupCondition object is an abstract class specialized to
+ * fourteen different WakeupCriterion objects and to four combining
+ * objects containing multiple WakeupCriterion objects. A Behavior
+ * node provides the Java 3D behavior scheduler with a WakeupCondition
+ * object. When that object's WakeupCondition has been satisfied, the
+ * behavior scheduler hands that same WakeupCondition back to the
+ * Behavior via an enumeration.
+ *
+ *
+ * WakeupCriterion Object
+ *
+ * Java 3D provides a rich set of wakeup criteria that Behavior
+ * objects can use in specifying a complex WakeupCondition. These
+ * wakeup criteria can cause Java 3D's behavior scheduler to invoke a
+ * behavior's processStimulus method whenever
+ *
+ *
+ * A Behavior object constructs a WakeupCriterion by constructing the
+ * appropriate criterion object. The Behavior object must provide the
+ * appropriate arguments (usually a reference to some scene graph
+ * object and possibly a region of interest). Thus, to specify a
+ * WakeupOnViewPlatformEntry, a behavior would specify the region that
+ * will cause the behavior to execute if an active ViewPlatform enters it.
+ *
+ *
+ * Note that a unique WakeupCriterion object must be used with each
+ * instance of a Behavior. Sharing wakeup criteria among different
+ * instances of a Behavior is illegal.
+ *
+ *
+ * Additional Information
+ *
+ * For more information, see the
+ * Introduction to the Java 3D API and
+ * Behaviors and Interpolators
+ * documents.
+ *
+ * @see WakeupCondition
+ */
+
+public abstract class Behavior extends Leaf {
+
+ /**
+ * Constructs a Behavior node with default parameters. The default
+ * values are as follows:
+ *
+ * This feature allows applications to send arbitrary events into the
+ * behavior scheduler stream. It can be used as a notification scheme
+ * for communicating events to behaviors in the system.
+ *
+ *
+ * @param originalNode the original node to duplicate
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ * If the alignment mode is ROTATE_ABOUT_AXIS, the rotation will be
+ * around the specified axis. If the alignment mode is
+ * ROTATE_ABOUT_POINT, the rotation will be about the specified
+ * point, with an additional rotation to align the +y axis of the
+ * TransformGroup with the +y axis in the View.
+ *
+ *
+ * Note that in a multiple View system, the alignment is done to
+ * the primary View only.
+ *
+ *
+ * Billboard nodes are ideal for drawing screen aligned-text or
+ * for drawing roughly-symmetrical objects. A typical use might
+ * consist of a quadrilateral that contains a texture of a tree.
+ *
+ * @see OrientedShape3D
+ */
+public class Billboard extends Behavior {
+ /**
+ * Specifies that rotation should be about the specified axis.
+ */
+ public static final int ROTATE_ABOUT_AXIS = 0;
+
+ /**
+ * Specifies that rotation should be about the specified point and
+ * that the children's Y-axis should match the view object's Y-axis.
+ */
+ public static final int ROTATE_ABOUT_POINT = 1;
+
+ // Wakeup condition for Billboard node
+ WakeupOnElapsedFrames wakeupFrame = new WakeupOnElapsedFrames(0, true);
+
+
+ // Specifies the billboard's mode of operation. One of ROTATE_AXIAL,
+ // ROTATE_POINT_VIEW, or ROTATE_POINT_WORLD.
+ int mode = ROTATE_ABOUT_AXIS;
+
+ // Axis about which to rotate.
+ Vector3f axis = new Vector3f(0.0f, 1.0f, 0.0f);
+ Point3f rotationPoint = new Point3f(0.0f, 0.0f, 1.0f);
+ private Vector3d nAxis = new Vector3d(0.0, 1.0, 0.0); // normalized axis
+
+ // TransformGroup to operate on.
+ TransformGroup tg = null;
+
+
+ // reused temporaries
+ private Point3d viewPosition = new Point3d();
+ private Point3d yUpPoint = new Point3d();
+
+ private Vector3d eyeVec = new Vector3d();
+ private Vector3d yUp = new Vector3d();
+ private Vector3d zAxis = new Vector3d();
+ private Vector3d yAxis = new Vector3d();
+ private Vector3d vector = new Vector3d();
+
+ private AxisAngle4d aa = new AxisAngle4d();
+
+ static final double EPSILON = 1.0e-6;
+
+ /**
+ * Constructs a Billboard node with default parameters.
+ * The default values are as follows:
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ * This allows an application to specify a bounding region in one coordinate system
+ * (the local coordinate system of the BoundingLeaf node) other than the local
+ * coordinate system of the node that references the bounds. For an example of how
+ * this might be used, consider a closed room with a number of track lights. Each
+ * light can move independent of the other lights and, as such, needs its own local
+ * coordinate system. However, the bounding volume is used by all the lights in the
+ * boundary of the room, which doesn't move when the lights move. In this example,
+ * the BoundingLeaf node allows the bounding region to be defined in the local
+ * coordinate system of the room, rather than in the local coordinate system of a
+ * particular light. All lights can then share this single bounding volume.
+ */
+public class BoundingLeaf extends Leaf {
+ /**
+ * Specifies that this BoundingLeaf node allows read access to its
+ * bounding region object.
+ */
+ public static final int
+ ALLOW_REGION_READ = CapabilityBits.BOUNDING_LEAF_ALLOW_REGION_READ;
+
+ /**
+ * Specifies that this BoundingLeaf node allows write access to its
+ * bounding region object.
+ */
+ public static final int
+ ALLOW_REGION_WRITE = CapabilityBits.BOUNDING_LEAF_ALLOW_REGION_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_REGION_READ
+ };
+
+ /**
+ * Constructs a BoundingLeaf node with a null (empty) bounding region.
+ */
+ public BoundingLeaf() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((BoundingLeafRetained)this.retained).createBoundingLeaf();
+ }
+
+ /**
+ * Constructs a BoundingLeaf node with the specified bounding region.
+ * @param region the bounding region of this leaf node
+ */
+ public BoundingLeaf(Bounds region) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((BoundingLeafRetained)this.retained).createBoundingLeaf();
+ ((BoundingLeafRetained)this.retained).initRegion(region);
+ }
+
+ /**
+ * Sets this BoundingLeaf node's bounding region.
+ * @param region the bounding region of this leaf node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setRegion(Bounds region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_REGION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("BoundingLeaf0"));
+
+ if (isLive())
+ ((BoundingLeafRetained)this.retained).setRegion(region);
+ else
+ ((BoundingLeafRetained)this.retained).initRegion(region);
+ }
+
+ /**
+ * Retrieves this BoundingLeaf's bounding region.
+ * @return the bounding region of this leaf node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getRegion() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_REGION_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("BoundingLeaf1"));
+
+ return ((BoundingLeafRetained)this.retained).getRegion();
+ }
+
+ /**
+ * Creates the BoundingLeafRetained object that this
+ * BoundingLeaf object will point to.
+ */
+ void createRetained() {
+ this.retained = new BoundingLeafRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * Each plane in the BoundingPolytope specifies a half-space defined
+ * by the equation:
+ *
+ *
+ *
+ * Because all Canvas3D objects contain a
+ * reference to a Screen3D object and because Screen3D objects define
+ * the size of a pixel in physical units, Java 3D can convert a Canvas3D
+ * size in pixels to a physical world size in meters. It can also
+ * determine the Canvas3D's position and orientation in the
+ * physical world.
+ *
+ * On-screen Rendering vs. Off-screen Rendering
+ *
+ * The Canvas3D class is used either for on-screen rendering or
+ * off-screen rendering.
+ * On-screen Canvas3Ds are added to AWT or Swing Container objects
+ * like any other canvas. Java 3D automatically and continuously
+ * renders to all on-screen canvases that are attached to an active
+ * View object. On-screen Canvas3Ds can be either single or double
+ * buffered and they can be either stereo or monoscopic.
+ *
+ * Off-screen Canvas3Ds must not be added to any Container. Java 3D
+ * renders to off-screen canvases in response to the
+ *
+ * The setOffScreenBuffer method sets the off-screen buffer for this
+ * Canvas3D. The specified image is written into by the Java 3D renderer.
+ * The size of the specified ImageComponent determines the size, in
+ * pixels, of this Canvas3D - the size inherited from Component is
+ * ignored. Note that the size, physical width, and physical height of the
+ * associated Screen3D must be set
+ * explicitly prior to rendering. Failure to do so will result in an
+ * exception.
+ *
+ * The getOffScreenBuffer method retrieves the off-screen
+ * buffer for this Canvas3D.
+ *
+ * The renderOffScreenBuffer method schedules the rendering of a frame
+ * into this Canvas3D's off-screen buffer. The rendering is done from
+ * the point of view of the View object to which this Canvas3D has been
+ * added. No rendering is performed if this Canvas3D object has not been
+ * added to an active View. This method does not wait for the rendering
+ * to actually happen. An application that wishes to know when the
+ * rendering is complete must either subclass Canvas3D and
+ * override the postSwap method, or call waitForOffScreenRendering.
+ *
+ * The setOfScreenLocation methods set the location of this off-screen
+ * Canvas3D. The location is the upper-left corner of the Canvas3D
+ * relative to the upper-left corner of the corresponding off-screen
+ * Screen3D. The function of these methods is similar to that of
+ * Component.setLocation for on-screen Canvas3D objects. The default
+ * location is (0,0).
+ *
+ * Accessing and Modifying an Eye's Image Plate Position
+ *
+ * A Canvas3D object provides sophisticated applications with access
+ * to the eye's position information in head-tracked, room-mounted
+ * runtime environments. It also allows applications to manipulate
+ * the position of an eye relative to an image plate in non-head-tracked
+ * runtime environments.
+ *
+ * The setLeftManualEyeInImagePlate and setRightManualEyeInImagePlate
+ * methods set the position of the manual left and right eyes in image
+ * plate coordinates. These values determine eye placement when a head
+ * tracker is not in use and the application is directly controlling the
+ * eye position in image plate coordinates. In head-tracked mode or
+ * when the windowEyepointPolicy is RELATIVE_TO_FIELD_OF_VIEW or
+ * RELATIVE_TO_COEXISTENCE, this
+ * value is ignored. When the windowEyepointPolicy is RELATIVE_TO_WINDOW,
+ * only the Z value is used.
+ *
+ * The getLeftEyeInImagePlate, getRightEyeInImagePlate, and
+ * getCenterEyeInImagePlate methods retrieve the actual position of the
+ * left eye, right eye, and center eye in image plate coordinates and
+ * copy that value into the object provided. The center eye is the
+ * fictional eye half-way between the left and right eye. These three
+ * values are a function of the windowEyepointPolicy, the tracking
+ * enable flag, and the manual left, right, and center eye positions.
+ *
+ * Monoscopic View Policy
+ *
+ * The setMonoscopicViewPolicy and getMonoscopicViewPolicy methods
+ * set and retrieve the policy regarding how Java 3D generates monoscopic
+ * view. If the policy is set to View.LEFT_EYE_VIEW, the view generated
+ * corresponds to the view as seen from the left eye. If set to
+ * View.RIGHT_EYE_VIEW, the view generated corresponds to the view as
+ * seen from the right eye. If set to View.CYCLOPEAN_EYE_VIEW, the view
+ * generated corresponds to the view as seen from the "center eye," the
+ * fictional eye half-way between the left and right eye. The default
+ * monoscopic view policy is View.CYCLOPEAN_EYE_VIEW.
+ *
+ * Immediate Mode Rendering
+ *
+ * Pure immediate-mode rendering provides for those applications and
+ * applets that do not want Java 3D to do any automatic rendering of
+ * the scene graph. Such applications may not even wish to build a
+ * scene graph to represent their graphical data. However, they use
+ * Java 3D's attribute objects to set graphics state and Java 3D's
+ * geometric objects to render geometry.
+ *
+ * A pure immediate mode application must create a minimal set of
+ * Java 3D objects before rendering. In addition to a Canvas3D object,
+ * the application must create a View object, with its associated
+ * PhysicalBody and PhysicalEnvironment objects, and the following
+ * scene graph elements: a VirtualUniverse object, a high-resolution
+ * Locale object, a BranchGroup node object, a TransformGroup node
+ * object with associated transform, and a ViewPlatform
+ * leaf node object that defines the position and orientation within
+ * the virtual universe that generates the view.
+ *
+ * In immediate mode, all rendering is done completely under user
+ * control. It is necessary for the user to clear the 3D canvas,
+ * render all geometry, and swap the buffers. Additionally,
+ * rendering the right and left eye for stereo viewing becomes the
+ * sole responsibility of the application. In pure immediate mode,
+ * the user must stop the Java 3D renderer, via the
+ * Canvas3D object
+ * Other Canvas3D methods related to immediate mode rendering are:
+ *
+ *
+ *
+ *
+ * Mixed Mode Rendering
+ *
+ * Mixing immediate mode and retained or compiled-retained mode
+ * requires more structure than pure immediate mode. In mixed mode,
+ * the Java 3D renderer is running continuously, rendering the scene
+ * graph into the canvas.
+ *
+ *
+ * Canvas3D methods related to mixed mode rendering are:
+ *
+ *
+ *
+ *
+ *
+ *
+ * The above callback methods are called by the Java 3D rendering system
+ * and should not be called by an application directly.
+ *
+ *
+ * The basic Java 3D stereo rendering loop,
+ * executed for each Canvas3D, is as follows:
+ *
+ * The basic Java 3D monoscopic rendering loop is as follows:
+ *
+ * In both cases, the entire loop, beginning with clearing the canvas
+ * and ending with swapping the buffers, defines a frame. The application
+ * is given the opportunity to render immediate-mode geometry at any of
+ * the clearly identified spots in the rendering loop. A user specifies
+ * his or her own rendering methods by extending the Canvas3D class and
+ * overriding the preRender, postRender, postSwap, and/or renderField
+ * methods.
+ * Updates to live Geometry, Texture, and ImageComponent objects
+ * in the scene graph are not allowed from any of these callback
+ * methods.
+ *
+ *
+ * Serialization
+ *
+ * Canvas3D does not support serialization. An attempt to
+ * serialize a Canvas3D object will result in an
+ * UnsupportedOperationException being thrown.
+ *
+ *
+ * Additional Information
+ *
+ * For more information, see the
+ * Introduction to the Java 3D API and
+ * View Model
+ * documents.
+ *
+ * @see Screen3D
+ * @see View
+ * @see GraphicsContext3D
+ */
+public class Canvas3D extends Canvas {
+ /**
+ * Specifies the left field of a field-sequential stereo rendering loop.
+ * A left field always precedes a right field.
+ */
+ public static final int FIELD_LEFT = 0;
+
+ /**
+ * Specifies the right field of a field-sequential stereo rendering loop.
+ * A right field always follows a left field.
+ */
+ public static final int FIELD_RIGHT = 1;
+
+ /**
+ * Specifies a single-field rendering loop.
+ */
+ public static final int FIELD_ALL = 2;
+
+ //
+ // The following constants are bit masks to specify which of the node
+ // components are dirty and need updates.
+ //
+ // Values for the geometryType field.
+ static final int POLYGONATTRS_DIRTY = 0x01;
+ static final int LINEATTRS_DIRTY = 0x02;
+ static final int POINTATTRS_DIRTY = 0x04;
+ static final int MATERIAL_DIRTY = 0x08;
+ static final int TRANSPARENCYATTRS_DIRTY = 0x10;
+ static final int COLORINGATTRS_DIRTY = 0x20;
+
+ // Values for lightbin, env set, texture, texture setting etc.
+ static final int LIGHTBIN_DIRTY = 0x40;
+ static final int LIGHTENABLES_DIRTY = 0x80;
+ static final int AMBIENTLIGHT_DIRTY = 0x100;
+ static final int ATTRIBUTEBIN_DIRTY = 0x200;
+ static final int TEXTUREBIN_DIRTY = 0x400;
+ static final int TEXTUREATTRIBUTES_DIRTY = 0x800;
+ static final int RENDERMOLECULE_DIRTY = 0x1000;
+ static final int FOG_DIRTY = 0x2000;
+ static final int MODELCLIP_DIRTY = 0x4000;
+ static final int VIEW_MATRIX_DIRTY = 0x8000;
+ // static final int SHADER_DIRTY = 0x10000; Not ready for this yet -- JADA
+
+ // Use to notify D3D Canvas when window change
+ static final int RESIZE = 1;
+ static final int TOGGLEFULLSCREEN = 2;
+ static final int NOCHANGE = 0;
+ static final int RESETSURFACE = 1;
+ static final int RECREATEDDRAW = 2;
+
+ //
+ // Flag that indicates whether this Canvas3D is an off-screen Canvas3D
+ //
+ boolean offScreen = false;
+
+ //
+ // Issue 131: Flag that indicates whether this Canvas3D is a manually
+ // rendered Canvas3D (versus an automatically rendered Canvas3D).
+ //
+ // NOTE: manualRendering only applies to off-screen Canvas3Ds at this time.
+ // We have no plans to ever change this, but if we do, it might be necessary
+ // to determine which, if any, of the uses of "manualRendering" should be
+ // changed to "manualRendering&&offScreen"
+ //
+ boolean manualRendering = false;
+
+ // user specified offScreen Canvas location
+ Point offScreenCanvasLoc;
+
+ // user specified offScreen Canvas dimension
+ Dimension offScreenCanvasSize;
+
+ //
+ // Flag that indicates whether off-screen rendering is in progress or not
+ //
+ volatile boolean offScreenRendering = false;
+
+ //
+ // Flag that indicates we are waiting for an off-screen buffer to be
+ // created or destroyed by the Renderer.
+ //
+ volatile boolean offScreenBufferPending = false;
+
+ //
+ // ImageComponent used for off-screen rendering
+ //
+ ImageComponent2D offScreenBuffer = null;
+
+ // flag that indicates whether this canvas will use shared context
+ boolean useSharedCtx = true;
+
+ //
+ // Read-only flag that indicates whether stereo is supported for this
+ // canvas. This is always false for off-screen canvases.
+ //
+ boolean stereoAvailable;
+
+ //
+ // Flag to enable stereo rendering, if allowed by the
+ // stereoAvailable flag.
+ //
+ boolean stereoEnable = true;
+
+ //
+ // This flag is set when stereo mode is both enabled and
+ // available. Code that looks at stereo mode should use this
+ // flag.
+ //
+ boolean useStereo;
+
+ // Indicate whether it is left or right stereo pass currently
+ boolean rightStereoPass = false;
+
+ //
+ // Specifies how Java 3D generates monoscopic view
+ // (LEFT_EYE_VIEW, RIGHT_EYE_VIEW, or CYCLOPEAN_EYE_VIEW).
+ //
+ int monoscopicViewPolicy = View.CYCLOPEAN_EYE_VIEW;
+
+ // User requested stencil size
+ int requestedStencilSize;
+
+ // Actual stencil size return for this canvas
+ int actualStencilSize;
+
+ // True if stencil buffer is available for user
+ boolean userStencilAvailable;
+
+ // True if stencil buffer is available for system ( decal )
+ boolean systemStencilAvailable;
+
+ //
+ // Read-only flag that indicates whether double buffering is supported
+ // for this canvas. This is always false for off-screen canvases.
+ //
+ boolean doubleBufferAvailable;
+
+ //
+ // Flag to enable double buffered rendering, if allowed by the
+ // doubleBufferAvailable flag.
+ //
+ boolean doubleBufferEnable = true;
+
+ //
+ // This flag is set when doubleBuffering is both enabled and
+ // available Code that enables or disables double buffering should
+ // use this flag.
+ //
+ boolean useDoubleBuffer;
+
+ //
+ // Read-only flag that indicates whether scene antialiasing
+ // is supported for this canvas.
+ //
+ boolean sceneAntialiasingAvailable;
+ boolean sceneAntialiasingMultiSamplesAvailable;
+
+ // Use to see whether antialiasing is already set
+ boolean antialiasingSet = false;
+
+ //
+ // Read-only flag that indicates the size of the texture color
+ // table for this canvas. A value of 0 indicates that the texture
+ // color table is not supported.
+ //
+ int textureColorTableSize;
+
+ // number of active/enabled texture unit
+ int numActiveTexUnit = 0;
+
+ // index iof last enabled texture unit
+ int lastActiveTexUnit = -1;
+
+ // True if shadingLanguage is supported, otherwise false.
+ boolean shadingLanguageGLSL = false;
+ boolean shadingLanguageCg = false;
+
+ // Query properties
+ J3dQueryProps queryProps;
+
+ // Flag indicating a fatal rendering error of some sort
+ private boolean fatalError = false;
+
+ //
+ // The positions of the manual left and right eyes in image-plate
+ // coordinates.
+ // By default, we will use the center of the screen for X and Y values
+ // (X values are adjusted for default eye separation), and
+ // 0.4572 meters (18 inches) for the Z value.
+ // These match defaults elsewhere in the system.
+ //
+ Point3d leftManualEyeInImagePlate = new Point3d(0.142, 0.135, 0.4572);
+ Point3d rightManualEyeInImagePlate = new Point3d(0.208, 0.135, 0.4572);
+
+ //
+ // View that is attached to this Canvas3D.
+ //
+ View view = null;
+
+ // View waiting to be set
+ View pendingView;
+
+ //
+ // View cache for this canvas and its associated view.
+ //
+ CanvasViewCache canvasViewCache = null;
+
+ // Issue 109: View cache for this canvas, for computing view frustum planes
+ CanvasViewCache canvasViewCacheFrustum = null;
+
+ // Since multiple renderAtomListInfo, share the same vecBounds
+ // we want to do the intersection test only once per renderAtom
+ // this flag is set to true after the first intersect and set to
+ // false during checkForCompaction in renderBin
+ boolean raIsVisible = false;
+
+ RenderAtom ra = null;
+
+ // Stereo related field has changed.
+ static final int STEREO_DIRTY = 0x01;
+ // MonoscopicViewPolicy field has changed.
+ static final int MONOSCOPIC_VIEW_POLICY_DIRTY = 0x02;
+ // Left/right eye in image plate field has changed.
+ static final int EYE_IN_IMAGE_PLATE_DIRTY = 0x04;
+ // Canvas has moved/resized.
+ static final int MOVED_OR_RESIZED_DIRTY = 0x08;
+
+ // Canvas Background changed (this may affect doInfinite flag)
+ static final int BACKGROUND_DIRTY = 0x10;
+
+ // Canvas Background Image changed
+ static final int BACKGROUND_IMAGE_DIRTY = 0x20;
+
+
+ // Mask that indicates this Canvas view dependence info. has changed,
+ // and CanvasViewCache may need to recompute the final view matries.
+ static final int VIEW_INFO_DIRTY = (STEREO_DIRTY |
+ MONOSCOPIC_VIEW_POLICY_DIRTY |
+ EYE_IN_IMAGE_PLATE_DIRTY |
+ MOVED_OR_RESIZED_DIRTY |
+ BACKGROUND_DIRTY |
+ BACKGROUND_IMAGE_DIRTY);
+
+ // Issue 163: Array of dirty bits is used because the Renderer and
+ // RenderBin run asynchronously. Now that they each have a separate
+ // instance of CanvasViewCache (due to the fix for Issue 109), they
+ // need separate dirty bits. Array element 0 is used for the Renderer and
+ // element 1 is used for the RenderBin.
+ static final int RENDERER_DIRTY_IDX = 0;
+ static final int RENDER_BIN_DIRTY_IDX = 1;
+ int[] cvDirtyMask = new int[2];
+
+ // This boolean informs the J3DGraphics2DImpl that the window is resized
+ boolean resizeGraphics2D = true;
+ //
+ // This boolean allows an application to start and stop the render
+ // loop on this canvas.
+ //
+ volatile boolean isRunning = true;
+
+ // This is used by MasterControl only. MC relay on this in a
+ // single loop to set renderer thread. During this time,
+ // the isRunningStatus can't change by user thread.
+ volatile boolean isRunningStatus = true;
+
+ // This is true when the canvas is ready to be rendered into
+ boolean active = false;
+
+ // This is true when the canvas is visible
+ boolean visible = false;
+
+ // This is true if context need to recreate
+ boolean ctxReset = true;
+
+ // The Screen3D that corresponds to this Canvas3D
+ Screen3D screen = null;
+
+ // Flag to indicate that image is render completely
+ // so swap is valid.
+ boolean imageReady = false;
+
+
+ //
+ // The current fog enable state
+ //
+ int fogOn = 0;
+
+ // The 3D Graphics context used for immediate mode rendering
+ // into this canvas.
+ GraphicsContext3D graphicsContext3D = null;
+ boolean waiting = false;
+ boolean swapDone = false;
+
+ GraphicsConfiguration graphicsConfiguration;
+
+ // The Java 3D Graphics2D object used for Java2D/AWT rendering
+ // into this Canvas3D
+ J3DGraphics2DImpl graphics2D = null;
+
+ // Lock used to synchronize the creation of the 2D and 3D
+ // graphics context objects
+ Object gfxCreationLock = new Object();
+
+ // The source of the currently loaded localToVWorld for this Canvas3D
+ // (used to only update the model matrix when it changes)
+ // Transform3D localToVWorldSrc = null;
+
+ // The current vworldToEc Transform
+ Transform3D vworldToEc = new Transform3D();
+
+ // The view transform (VPC to EC) for the current eye.
+ // NOTE that this is *read-only*
+ Transform3D vpcToEc;
+
+ // Opaque object representing the underlying drawable (window). This
+ // is defined by the Pipeline.
+ Drawable drawable = null;
+
+ // fbConfig is a pointer to the fbConfig object that is associated with
+ // the GraphicsConfiguration object used to create this Canvas.
+ //
+ // For Unix : Fix for issue 20.
+ // The fbConfig is only used when running X11. It contains a pointer
+ // to the native GLXFBConfig structure list, since in some cases the visual id
+ // alone isn't sufficient for the native OpenGL renderer (e.g., when using
+ // Solaris OpenGL with Xinerama mode disabled).
+ //
+ // For Windows : Fix for issue 76. This is use as a holder of the
+ // PixelFormat structure ( see also gldef.h ) to allow value such
+ // as offScreen's pixelformat, and ARB function pointers to be stored.
+ long fbConfig = 0;
+
+ // offScreenBufferInfo is a pointer to additional information about the
+ // offScreenBuffer in this Canvas.
+ //
+ // For Windows : Fix for issue 76.
+ long offScreenBufferInfo = 0;
+
+ // graphicsConfigTable is a static hashtable which allows getBestConfiguration()
+ // in NativeConfigTemplate3D to map a GraphicsConfiguration to the pointer
+ // to the actual GLXFBConfig that glXChooseFBConfig() returns. The Canvas3D
+ // doesn't exist at the time getBestConfiguration() is called, and
+ // X11GraphicsConfig neither maintains this pointer nor provides a public
+ // constructor to allow Java 3D to extend it.
+ static Hashtable
+ * NOTE: Applications should not call this method.
+ */
+ public void preRender() {
+ // Do nothing; the user overrides this to cause some action
+ }
+
+ /**
+ * This routine is called by the Java 3D rendering loop after completing
+ * all rendering to the canvas for this frame and before the buffer swap.
+ * Applications that wish to perform operations in the rendering loop,
+ * following any actual rendering may override this function.
+ *
+ *
+ * Updates to live Geometry, Texture, and ImageComponent objects
+ * in the scene graph are not allowed from this method.
+ *
+ *
+ * NOTE: Applications should not call this method.
+ */
+ public void postRender() {
+ // Do nothing; the user overrides this to cause some action
+ }
+
+ /**
+ * This routine is called by the Java 3D rendering loop after completing
+ * all rendering to the canvas, and all other canvases associated with
+ * this view, for this frame following the buffer swap.
+ * Applications that wish to perform operations at the very
+ * end of the rendering loop may override this function.
+ * In off-screen mode, all rendering is copied to the off-screen
+ * buffer before this method is called.
+ *
+ *
+ * Updates to live Geometry, Texture, and ImageComponent objects
+ * in the scene graph are not allowed from this method.
+ *
+ *
+ * NOTE: Applications should not call this method.
+ */
+ public void postSwap() {
+ // Do nothing; the user overrides this to cause some action
+ }
+
+ /**
+ * This routine is called by the Java 3D rendering loop during the
+ * execution of the rendering loop. It is called once for each
+ * field (i.e., once per frame on
+ * a mono system or once each for the right eye and left eye on a
+ * two-pass stereo system. This is intended for use by applications that
+ * want to mix retained/compiled-retained mode rendering with some
+ * immediate mode rendering. Applications that wish to perform
+ * operations during the rendering loop, may override this
+ * function.
+ *
+ *
+ * Updates to live Geometry, Texture, and ImageComponent objects
+ * in the scene graph are not allowed from this method.
+ *
+ *
+ * NOTE: Applications should not call this method.
+ *
+ *
+ * @param fieldDesc field description, one of: FIELD_LEFT, FIELD_RIGHT or
+ * FIELD_ALL. Applications that wish to work correctly in stereo mode
+ * should render the same image for both FIELD_LEFT and FIELD_RIGHT calls.
+ * If Java 3D calls the renderer with FIELD_ALL then the immediate mode
+ * rendering only needs to be done once.
+ */
+ public void renderField(int fieldDesc) {
+ // Do nothing; the user overrides this to cause some action
+ }
+
+ /**
+ * Stop the Java 3D renderer on this Canvas3D object. If the
+ * Java 3D renderer is currently running, the rendering will be
+ * synchronized before being stopped. No further rendering will be done
+ * to this canvas by Java 3D until the renderer is started again.
+ * In pure immediate mode this method should be called prior to adding
+ * this canvas to an active View object.
+ *
+ * @exception IllegalStateException if this Canvas3D is in
+ * off-screen mode.
+ */
+ public final void stopRenderer() {
+ // Issue 131: renderer can't be stopped only if it is an offscreen,
+ // manual canvas. Otherwise, it has to be seen as an onscreen canvas.
+ if (manualRendering)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D14"));
+
+ if (isRunning) {
+ VirtualUniverse.mc.postRequest(MasterControl.STOP_RENDERER, this);
+ isRunning = false;
+ }
+ }
+
+
+ /**
+ * Start the Java 3D renderer on this Canvas3D object. If the
+ * Java 3D renderer is not currently running, any rendering to other
+ * Canvas3D objects sharing the same View will be synchronized before this
+ * Canvas3D's renderer is (re)started. When a Canvas3D is created, it is
+ * initially marked as being started. This means that as soon as the
+ * Canvas3D is added to an active View object, the rendering loop will
+ * render the scene graph to the canvas.
+ */
+ public final void startRenderer() {
+ // Issue 260 : ignore attempt to start renderer if fatal error
+ if (fatalError) {
+ return;
+ }
+
+ if (!isRunning) {
+ VirtualUniverse.mc.postRequest(MasterControl.START_RENDERER, this);
+ isRunning = true;
+ redraw();
+ }
+ }
+
+ /**
+ * Retrieves the state of the renderer for this Canvas3D object.
+ * @return the state of the renderer
+ *
+ * @since Java 3D 1.2
+ */
+ public final boolean isRendererRunning() {
+ return isRunning;
+ }
+
+ // Returns the state of the fatal error flag
+ boolean isFatalError() {
+ return fatalError;
+ }
+
+ // Sets the fatal error flag to true; stop the renderer for this canvas
+ void setFatalError() {
+ fatalError = true;
+
+ if (isRunning) {
+ isRunning = false;
+
+ if (!manualRendering) {
+ VirtualUniverse.mc.postRequest(MasterControl.STOP_RENDERER, this);
+ }
+ }
+ }
+
+
+ /**
+ * Retrieves a flag indicating whether this Canvas3D is an
+ * off-screen canvas.
+ *
+ * @return
+ * NOTE: the size, physical width, and physical height of the associated
+ * Screen3D must be set explicitly prior to rendering.
+ * Failure to do so will result in an exception.
+ *
+ *
+ * @param buffer the image component that will be rendered into by
+ * subsequent calls to renderOffScreenBuffer. The image component must not
+ * be part of a live scene graph, nor may it subsequently be made part of a
+ * live scene graph while being used as an off-screen buffer; an
+ * IllegalSharingException is thrown in such cases. The buffer may be null,
+ * indicating that the previous off-screen buffer is released without a new
+ * buffer being set.
+ *
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode.
+ *
+ * @exception RestrictedAccessException if an off-screen rendering
+ * is in process for this Canvas3D.
+ *
+ * @exception IllegalSharingException if the specified ImageComponent2D
+ * is part of a live scene graph
+ *
+ * @exception IllegalSharingException if the specified ImageComponent2D is
+ * being used by an immediate mode context, or by another Canvas3D as
+ * an off-screen buffer.
+ *
+ * @exception IllegalArgumentException if the image class of the specified
+ * ImageComponent2D is not ImageClass.BUFFERED_IMAGE.
+ *
+ * @exception IllegalArgumentException if the specified
+ * ImageComponent2D is in by-reference mode and its
+ * RenderedImage is null.
+ *
+ * @exception IllegalArgumentException if the ImageComponent2D format
+ * is not a 3-component format (e.g., FORMAT_RGB)
+ * or a 4-component format (e.g., FORMAT_RGBA).
+ *
+ * @see #renderOffScreenBuffer
+ * @see Screen3D#setSize(int, int)
+ * @see Screen3D#setSize(Dimension)
+ * @see Screen3D#setPhysicalScreenWidth
+ * @see Screen3D#setPhysicalScreenHeight
+ *
+ * @since Java 3D 1.2
+ */
+ public void setOffScreenBuffer(ImageComponent2D buffer) {
+ int width, height;
+ boolean freeCanvasId = false;
+
+ if (!offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+
+ if (offScreenRendering)
+ throw new RestrictedAccessException(J3dI18N.getString("Canvas3D2"));
+
+ // Check that offScreenBufferPending is not already set
+ J3dDebug.doAssert(!offScreenBufferPending, "!offScreenBufferPending");
+
+ if (offScreenBuffer != null && offScreenBuffer != buffer) {
+ ImageComponent2DRetained i2dRetained =
+ (ImageComponent2DRetained)offScreenBuffer.retained;
+ i2dRetained.setUsedByOffScreen(false);
+ }
+
+ if (buffer != null) {
+ ImageComponent2DRetained bufferRetained =
+ (ImageComponent2DRetained)buffer.retained;
+
+ if (bufferRetained.byReference &&
+ !(bufferRetained.getRefImage(0) instanceof BufferedImage)) {
+
+ throw new IllegalArgumentException(J3dI18N.getString("Canvas3D15"));
+ }
+
+ if (bufferRetained.getNumberOfComponents() < 3 ) {
+ throw new IllegalArgumentException(J3dI18N.getString("Canvas3D16"));
+ }
+
+ if (buffer.isLive()) {
+ throw new IllegalSharingException(J3dI18N.getString("Canvas3D26"));
+ }
+
+ if (bufferRetained.getInImmCtx()) {
+ throw new IllegalSharingException(J3dI18N.getString("Canvas3D27"));
+ }
+
+ if (buffer != offScreenBuffer && bufferRetained.getUsedByOffScreen()) {
+ throw new IllegalSharingException(J3dI18N.getString("Canvas3D28"));
+ }
+
+ bufferRetained.setUsedByOffScreen(true);
+
+ width = bufferRetained.width;
+ height = bufferRetained.height;
+
+ // Issues 347, 348 - assign a canvasId for off-screen Canvas3D
+ if (manualRendering) {
+ sendAllocateCanvasId();
+ }
+ }
+ else {
+ width = height = 0;
+
+ // Issues 347, 348 - release canvasId for off-screen Canvas3D
+ if (manualRendering) {
+ freeCanvasId = true;
+ }
+ }
+
+ if ((offScreenCanvasSize.width != width) ||
+ (offScreenCanvasSize.height != height)) {
+
+ if (drawable != null) {
+ // Fix for Issue 18 and Issue 175
+ // Will do destroyOffScreenBuffer in the Renderer thread.
+ sendDestroyCtxAndOffScreenBuffer();
+ drawable = null;
+ }
+ // Issue 396. Since context is invalid here, we should set it to null.
+ ctx = null;
+
+ // set the canvas dimension according to the buffer dimension
+ offScreenCanvasSize.setSize(width, height);
+ this.setSize(offScreenCanvasSize);
+
+ if (width > 0 && height > 0) {
+ sendCreateOffScreenBuffer();
+ }
+
+ }
+ else if (ctx != null) {
+ removeCtx();
+ }
+
+ if (freeCanvasId) {
+ sendFreeCanvasId();
+ }
+
+ offScreenBuffer = buffer;
+
+ synchronized(dirtyMaskLock) {
+ cvDirtyMask[0] |= MOVED_OR_RESIZED_DIRTY;
+ cvDirtyMask[1] |= MOVED_OR_RESIZED_DIRTY;
+ }
+ }
+
+ /**
+ * Retrieves the off-screen buffer for this Canvas3D.
+ *
+ * @return the current off-screen buffer for this Canvas3D.
+ *
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public ImageComponent2D getOffScreenBuffer() {
+
+ if (!offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+
+ return (offScreenBuffer);
+ }
+
+
+ /**
+ * Schedules the rendering of a frame into this Canvas3D's
+ * off-screen buffer. The rendering is done from the point of
+ * view of the View object to which this Canvas3D has been added.
+ * No rendering is performed if this Canvas3D object has not been
+ * added to an active View. This method does not wait for the rendering
+ * to actually happen. An application that wishes to know when
+ * the rendering is complete must either subclass Canvas3D and
+ * override the
+ * NOTE: for backward compatibility with Java 3D 1.1, if this
+ * attribute is set to its default value of
+ * View.CYCLOPEAN_EYE_VIEW, the monoscopic view policy in the
+ * View object will be used. An application should not use both
+ * the deprecated View method and this Canvas3D method at the same
+ * time.
+ * @param policy one of View.LEFT_EYE_VIEW, View.RIGHT_EYE_VIEW, or
+ * View.CYCLOPEAN_EYE_VIEW.
+ *
+ * @exception IllegalStateException if the specified
+ * policy is CYCLOPEAN_EYE_VIEW, the canvas is a stereo canvas,
+ * and the viewPolicy for the associated view is HMD_VIEW
+ *
+ * @since Java 3D 1.2
+ */
+ public void setMonoscopicViewPolicy(int policy) {
+
+
+ if((view !=null) && (view.viewPolicy == View.HMD_VIEW) &&
+ (monoscopicViewPolicy == View.CYCLOPEAN_EYE_VIEW) &&
+ (!useStereo)) {
+ throw new
+ IllegalStateException(J3dI18N.getString("View31"));
+ }
+
+ monoscopicViewPolicy = policy;
+ synchronized(dirtyMaskLock) {
+ cvDirtyMask[0] |= MONOSCOPIC_VIEW_POLICY_DIRTY;
+ cvDirtyMask[1] |= MONOSCOPIC_VIEW_POLICY_DIRTY;
+ }
+ redraw();
+ }
+
+
+ /**
+ * Returns policy on how Java 3D generates monoscopic view.
+ * @return policy one of View.LEFT_EYE_VIEW, View.RIGHT_EYE_VIEW or
+ * View.CYCLOPEAN_EYE_VIEW.
+ *
+ * @since Java 3D 1.2
+ */
+ public int getMonoscopicViewPolicy() {
+ return this.monoscopicViewPolicy;
+ }
+
+
+ /**
+ * Returns a status flag indicating whether or not double
+ * buffering is available.
+ * This is equivalent to:
+ *
+ * The currently defined keys are:
+ *
+ *
+ *
+ * The descriptions of the values returned for each key are as follows:
+ *
+ *
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ * Color
+ *
+ * The
+ * There are two variations on the
+ * Shading Model
+ *
+ * The
+ *
+ *
+ *
+ *
+ *
+ * All instance data is declared public and no get or set methods are
+ * provided.
+ *
+ * @see CompressedGeometry
+ *
+ * @deprecated As of Java 3D version 1.4.
+ */
+public class CompressedGeometryHeader extends Object {
+
+ /**
+ * bufferType: compressed geometry is made up of individual points.
+ */
+ public static final int POINT_BUFFER = 0 ;
+
+ /**
+ * bufferType: compressed geometry is made up of line segments.
+ */
+ public static final int LINE_BUFFER = 1 ;
+
+ /**
+ * bufferType: compressed geometry is made up of triangles.
+ */
+ public static final int TRIANGLE_BUFFER = 2 ;
+
+ // Valid values for the bufferDataPresent field.
+
+ /**
+ * bufferDataPresent: bit indicating that normal information is
+ * bundled with the vertices in the compressed geometry buffer.
+ */
+ public static final int NORMAL_IN_BUFFER = 1 ;
+
+ /**
+ * bufferDataPresent: bit indicating that RGB color information is
+ * bundled with the vertices in the compressed geometry buffer.
+ */
+ public static final int COLOR_IN_BUFFER = 2 ;
+
+ /**
+ * bufferDataPresent: bit indicating that alpha information is
+ * bundled with the vertices in the compressed geometry buffer.
+ */
+ public static final int ALPHA_IN_BUFFER = 4 ;
+
+ /**
+ * The major version number for the compressed geometry format that
+ * was used to compress the geometry.
+ * If the version number of compressed geometry is incompatible
+ * with the supported version of compressed geometry in the
+ * current version of Java 3D, the compressed geometry obejct will
+ * not be rendered.
+ *
+ * @see Canvas3D#queryProperties
+ */
+ public int majorVersionNumber ;
+
+ /**
+ * The minor version number for the compressed geometry format that
+ * was used to compress the geometry.
+ * If the version number of compressed geometry is incompatible
+ * with the supported version of compressed geometry in the
+ * current version of Java 3D, the compressed geometry obejct will
+ * not be rendered.
+ *
+ * @see Canvas3D#queryProperties
+ */
+ public int minorVersionNumber ;
+
+ /**
+ * The minor-minor version number for the compressed geometry format
+ * that was used to compress the geometry.
+ * If the version number of compressed geometry is incompatible
+ * with the supported version of compressed geometry in the
+ * current version of Java 3D, the compressed geometry obejct will
+ * not be rendered.
+ *
+ * @see Canvas3D#queryProperties
+ */
+ public int minorMinorVersionNumber ;
+
+ /**
+ * Describes the type of data in the compressed geometry buffer.
+ * Only one type may be present in any given compressed geometry
+ * buffer.
+ */
+ public int bufferType ;
+
+ /**
+ * Contains bits indicating what data is bundled with the vertices in the
+ * compressed geometry buffer. If this data is not present (e.g. color)
+ * then this info will be inherited from the Appearance node.
+ */
+ public int bufferDataPresent ;
+
+ /**
+ * Size of the compressed geometry in bytes.
+ */
+ public int size ;
+
+ /**
+ * Offset in bytes of the start of the compressed geometry from the
+ * beginning of the compressed geometry byte array passed to the
+ * CompressedGeometry constructor.
+ *
+ * If the CompressedGeometry is created with reference access semantics,
+ * then this allow external compressors or file readers to embed several
+ * blocks of compressed geometry in a single large byte array, possibly
+ * interspersed with metadata that is not specific to Java 3D, without
+ * having to copy each block to a separate byte array.
+ *
+ * If the CompressedGeometry is created with copy access semantics, then
+ *
+ * Distance Gain attuation
+ *
+ * Use PointSound setDistanceGain() method to set the front distance
+ * attenuation array separate from the back distance attenuation array.
+ * A front distance attenuation array defines monotonically-increasing
+ * distances from the sound source origin along the position direction
+ * vector. A back distance attenuation array (if given) defines
+ * monotonically-increasing distances from the sound source origin along the
+ * negative direction vector. The two arrays must be of the same length.
+ * The backDistance[i] gain values must be less than or equal to
+ * the frontDistance[i] gain values.
+ *
+ * Gain scale factors are associated with distances from the listener to
+ * the sound source via an array of (distance, gain-scale-factor) pairs.
+ * The gain scale factor applied to the sound source is the linear
+ * interpolated gain value between the distance value range that includes
+ * the current distance from the listener to the sound source.
+ *
+ * The getDistanceGainLength method defined for PointSound returns the length
+ * of the all distance gain attenuation arrays, including the back distance
+ * gain arrays. Arrays passed into getDistanceGain methods should all
+ * be at least this size.
+ *
+ * Direction Methods
+ *
+ * Angular Attenuation
+ *
+ * This attenuation is defined
+ * as a triple of (angular distance, gain-scale-factor, filter). The
+ * distance is measured as the angle in radians between the ConeSound's
+ * direction vector and the vector from the sound source position to the
+ * listener. Both the gain scale factor and filter applied to the sound
+ * source is the linear interpolation of values between the distance value
+ * range that includes the angular distance from the sound source axis.
+ *
+ * If this is not set, no angular gain attenuation or filtering is performed
+ * (equivalent to using an angular gain scale factor of 1.0 and an angular
+ * filter of Sound.NO_FILTER for all distances).
+ *
+ * If angular distance from the listener-sound-position vector and a sound's
+ * direction vector is less than the first distance in the array, only the first
+ * gain scale factor and first filter are applied to the sound source.
+ * This creates a conical region around the listener within which the sound
+ * is uniformly attenuated by first gain and first filter in the array.
+ *
+ * If the distance from the listener-sound-position vector and the sound's
+ * direction vector is greater than the last distance in the array, the last gain
+ * scale factor and last filter are applied to the sound source.
+ *
+ * Distance elements in this array of points is a monotonically-increasing
+ * set of floating point numbers measured from 0 to p radians. Gain scale
+ * factors elements in this list of points can be any positive floating
+ * point numbers. While for most applications this list of gain scale
+ * factors will usually be monotonically-decreasing, they do not have to be.
+ * The filter (for now) is a single simple frequency cutoff value.
+ *
+ * The getAngularAttenuationArrayLength method returns the length of the angular
+ * attenuation arrays. Arrays passed into getAngularAttenuation methods
+ * should all be at least this size.
+ *
+ * Unlike the single distance gain attenuation array for PointSounds which
+ * define spherical areas about the sound source between which gains are
+ * linearly interpolated, this directed ConeSound can have two distance gain
+ * attenuation arrays that define ellipsoidal attenuation areas. See the
+ * setDistanceGain PointSound method for details on how the separate distance
+ * and distanceGain arrays are interpreted.
+ *
+ * The ConeSound's direction vector and angular measurements are defined in
+ * the local coordinate system of the node.
+ * @param soundData sound source data associated with this node
+ * @param initialGain amplitude scale factor applied to sound
+ * @param loopCount number of times sound is looped
+ * @param release flag denoting playing sound to end
+ * @param continuous denotes that sound silently plays when disabled
+ * @param enable sound switched on/off
+ * @param region scheduling bounds
+ * @param priority playback ranking value
+ * @param position 3D location of source
+ * @param frontDistanceAttenuation array of (distance,gain) pairs controlling
+ * attenuation values along the positive direction axis
+ * @param backDistanceAttenuation array of (distance,gain) pairs controlling
+ * attenuation values along the negative direction axis
+ * @param direction vector defining cones' axii
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ int loopCount,
+ boolean release,
+ boolean continuous,
+ boolean enable,
+ Bounds region,
+ float priority,
+ Point3f position,
+ Point2f[] frontDistanceAttenuation,
+ Point2f[] backDistanceAttenuation,
+ Vector3f direction) {
+
+ super(soundData, initialGain, loopCount, release, continuous, enable,
+ region, priority, position, frontDistanceAttenuation );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setBackDistanceGain(
+ backDistanceAttenuation);
+ ((ConeSoundRetained)this.retained).setDirection(direction);
+ }
+
+ /**
+ * Constructs a ConeSound node object using the provided parameter values.
+ * This form uses individual float parameters for the elements of the
+ * position, direction, and two distance attenuation arrays.
+ * Unlike the single distance gain attenuation array for PointSounds, which
+ * define spherical areas about the sound source between which gains are
+ * linearly interpolated, this directed ConeSound can have two distance
+ * gain attenuation arrays that define ellipsoidal attenuation areas.
+ * See the setDistanceGain PointSound method for details on how the
+ * separate distance and distanceGain arrays are interpreted.
+ * The ConeSound's direction vector and angular measurements are defined
+ * in the local coordinate system of the node.
+ * @param soundData sound source data associated with this node
+ * @param initialGain amplitude scale factor applied to sound
+ * @param loopCount number of times sound is looped
+ * @param release flag denoting playing sound to end
+ * @param continuous denotes that sound silently plays when disabled
+ * @param enable sound switched on/off
+ * @param region scheduling bounds
+ * @param priority playback ranking value
+ * @param posX x coordinate of location of source
+ * @param posY y coordinate of location of source
+ * @param posZ z coordinate of location of source
+ * @param frontDistance array of front distance values used for attenuation
+ * @param frontDistanceGain array of front gain scale factors used for attenuation
+ * @param backDistance array of back distance values used for attenuation
+ * @param backDistanceGain array of back gain scale factors used for attenuation
+ * @param dirX x coordinate cones' axii vector
+ * @param dirY y coordinate cones' axii vector
+ * @param dirZ z coordinate cones' axii vector
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ int loopCount,
+ boolean release,
+ boolean continuous,
+ boolean enable,
+ Bounds region,
+ float priority,
+ float posX, float posY, float posZ,
+ float[] frontDistance,
+ float[] frontDistanceGain,
+ float[] backDistance,
+ float[] backDistanceGain,
+ float dirX, float dirY, float dirZ ) {
+ super(soundData, initialGain, loopCount, release, continuous, enable,
+ region, priority, posX, posY, posZ,
+ frontDistance, frontDistanceGain );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setDirection(dirX, dirY, dirZ);
+ ((ConeSoundRetained)this.retained).setBackDistanceGain(
+ backDistance, backDistanceGain );
+ }
+
+ /**
+ * Constructs a ConeSound node object using all the provided PointSound
+ * parameter values, which include a single spherical distance attenuation
+ * array, but includes an angular attenuation array.
+ * This form uses points and vectors as input for its position, direction,
+ * single spherical distanceAttenuation array, and angularAttenuation array.
+ * It also accepts arrays of points for the distance attenuation and angular
+ * values. Each Point2f in the distanceAttenuation array contains a distance
+ * and a gain scale factor. Each Point3f in the angularAttenuation array
+ * contains an angular distance, a gain scale factor, and a filtering value
+ * (which is currently defined as a simple cutoff frequency).
+ * @param soundData sound source data associated with this node
+ * @param initialGain amplitude scale factor applied to sound
+ * @param loopCount number of times sound is looped
+ * @param release flag denoting playing sound to end
+ * @param continuous denotes that sound silently plays when disabled
+ * @param enable sound switched on/off
+ * @param region scheduling bounds
+ * @param priority playback ranking value
+ * @param position 3D location of source
+ * @param distanceAttenuation array of (distance,gain) pairs controlling
+ * attenuation values along the positive direction axis
+ * @param direction vector defining cones' axii
+ * @param angularAttenuation array of tuples defining angular gain/filtering
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ int loopCount,
+ boolean release,
+ boolean continuous,
+ boolean enable,
+ Bounds region,
+ float priority,
+ Point3f position,
+ Point2f[] distanceAttenuation,
+ Vector3f direction,
+ Point3f[] angularAttenuation ) {
+
+ super(soundData, initialGain, loopCount, release, continuous, enable,
+ region, priority, position, distanceAttenuation );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setDirection(direction);
+ ((ConeSoundRetained)this.retained).setAngularAttenuation(
+ angularAttenuation);
+ }
+
+ /**
+ * Constructs a ConeSound node object using all the provided PointSound
+ * parameter values, which include a single spherical distance attenuation
+ * array, but includes an angular attenuation array.
+ * This form uses individual float parameters for elements of position,
+ * direction, distanceAttenuation array, and angularAttenuation array.
+ * It also accepts separate arrays for the distance and gain scale factors
+ * components of distance attenuation, and separate arrays for the angular
+ * distance, angular gain, and filtering components of angular attenuation.
+ * See the setDistanceGain ConeSound method for details on how the separate
+ * distance and distanceGain arrays are interpreted. See the
+ * setAngularAttenuation ConeSound method for details on how the separate
+ * angularDistance, angularGain, and filter arrays are interpreted.
+ * @param soundData sound source data associated with this node
+ * @param initialGain amplitude scale factor applied to sound
+ * @param loopCount number of times sound is looped
+ * @param release flag denoting playing sound to end
+ * @param continuous denotes that sound silently plays when disabled
+ * @param enable sound switched on/off
+ * @param region scheduling bounds
+ * @param priority playback ranking value
+ * @param posX x coordinate of location of source
+ * @param posY y coordinate of location of source
+ * @param posZ z coordinate of location of source
+ * @param distance array of front distance values used for attenuation
+ * @param distanceGain array of front gain scale factors used for attenuation
+ * @param dirX x coordinate cones' axii vector
+ * @param dirY y coordinate cones' axii vector
+ * @param dirZ z coordinate cones' axii vector
+ * @param angle array of angle radians for angularAttenuation
+ * @param angularGain array of gain scale factors for angularAttenuation
+ * @param frequencyCutoff array of lowpass filter values in Hertz
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ int loopCount,
+ boolean release,
+ boolean continuous,
+ boolean enable,
+ Bounds region,
+ float priority,
+ float posX, float posY, float posZ,
+ float[] distance,
+ float[] distanceGain,
+ float dirX, float dirY, float dirZ,
+ float[] angle,
+ float[] angularGain,
+ float[] frequencyCutoff) {
+ super(soundData, initialGain, loopCount, release, continuous, enable,
+ region, priority, posX, posY, posZ,
+ distance, distanceGain );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setDirection(dirX, dirY, dirZ);
+ ((ConeSoundRetained)this.retained).setAngularAttenuation(angle,
+ angularGain, frequencyCutoff);
+ }
+
+ /**
+ * Constructs and initializes a new Cone Sound node explicitly setting all
+ * PointSound and ConeSound fields as arguments: the PointSound position,
+ * front and back distance attenuation Point2f array, and ConeSound
+ * direction vector and Point3f angular attenuation.
+ * @param soundData sound source data associated with this node
+ * @param initialGain amplitude scale factor applied to sound
+ * @param loopCount number of times sound is looped
+ * @param release flag denoting playing sound to end
+ * @param continuous denotes that sound silently plays when disabled
+ * @param enable sound switched on/off
+ * @param region scheduling bounds
+ * @param priority playback ranking value
+ * @param position 3D location of source
+ * @param frontDistanceAttenuation array of (distance,gain) pairs controlling
+ * attenuation values along the positive direction axis
+ * @param backDistanceAttenuation array of (distance,gain) pairs controlling
+ * attenuation values along the negative direction axis
+ * @param direction vector defining cones' axii
+ * @param angularAttenuation array of tuples defining angular gain/filtering
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ int loopCount,
+ boolean release,
+ boolean continuous,
+ boolean enable,
+ Bounds region,
+ float priority,
+ Point3f position,
+ Point2f[] frontDistanceAttenuation,
+ Point2f[] backDistanceAttenuation,
+ Vector3f direction,
+ Point3f[] angularAttenuation ) {
+
+ super(soundData, initialGain, loopCount, release, continuous, enable,
+ region, priority, position, frontDistanceAttenuation );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setBackDistanceGain(
+ backDistanceAttenuation);
+ ((ConeSoundRetained)this.retained).setDirection(direction);
+ ((ConeSoundRetained)this.retained).setAngularAttenuation(
+ angularAttenuation);
+ }
+
+ /**
+ * Constructs and initializes a new Cone Sound node explicitly setting all
+ * PointSound and ConeSound fields as arguments but all the vector and point
+ * arguments are broken into individual float array components.
+ * @param soundData sound source data associated with this node
+ * @param initialGain amplitude scale factor applied to sound
+ * @param loopCount number of times sound is looped
+ * @param release flag denoting playing sound to end
+ * @param continuous denotes that sound silently plays when disabled
+ * @param enable sound switched on/off
+ * @param region scheduling bounds
+ * @param priority playback ranking value
+ * @param posX x coordinate of location of source
+ * @param posY y coordinate of location of source
+ * @param posZ z coordinate of location of source
+ * @param frontDistance array of front distance values used for attenuation
+ * @param frontDistanceGain array of front gain scale factors used for attenuation
+ * @param backDistance array of back distance values used for attenuation
+ * @param backDistanceGain array of back gain scale factors used for attenuation
+ * @param dirX x coordinate cones' axii vector
+ * @param dirY y coordinate cones' axii vector
+ * @param dirZ z coordinate cones' axii vector
+ * @param angle array of angle radians for angularAttenuation
+ * @param angularGain array of gain scale factors for angularAttenuation
+ * @param frequencyCutoff array of lowpass filter values in Hertz
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ int loopCount,
+ boolean release,
+ boolean continuous,
+ boolean enable,
+ Bounds region,
+ float priority,
+ float posX, float posY, float posZ,
+ float[] frontDistance,
+ float[] frontDistanceGain,
+ float[] backDistance,
+ float[] backDistanceGain,
+ float dirX, float dirY, float dirZ,
+ float[] angle,
+ float[] angularGain,
+ float[] frequencyCutoff) {
+ super(soundData, initialGain, loopCount, release, continuous, enable,
+ region, priority, posX, posY, posZ,
+ frontDistance, frontDistanceGain );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setBackDistanceGain(
+ backDistance, backDistanceGain );
+ ((ConeSoundRetained)this.retained).setDirection(dirX, dirY, dirZ);
+ ((ConeSoundRetained)this.retained).setAngularAttenuation(angle,
+ angularGain, frequencyCutoff);
+ }
+
+ /**
+ * Creates the retained mode ConeSoundRetained object that this
+ * ConeSound object will point to.
+ */
+ void createRetained() {
+ this.retained = new ConeSoundRetained();
+ this.retained.setSource(this);
+ }
+
+ //
+ // OVERLOADED Sound methods
+ //
+ /**
+ * Sets this sound's distance gain elliptical attenuation -
+ * where gain scale factor is applied to sound based on distance listener
+ * is from sound source.
+ * @param frontAttenuation defined by pairs of (distance,gain-scale-factor)
+ * @param backAttenuation defined by pairs of (distance,gain-scale-factor)
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDistanceGain(Point2f[] frontAttenuation,
+ Point2f[] backAttenuation ) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_GAIN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound0"));
+
+ ((ConeSoundRetained)this.retained).setDistanceGain(frontAttenuation,
+ backAttenuation);
+ }
+
+ /**
+ * Sets this sound's distance gain attenuation as an array of Point2fs.
+ * @param frontDistance array of monotonically-increasing floats
+ * @param frontGain array of non-negative scale factors
+ * @param backDistance array of monotonically-increasing floats
+ * @param backGain array of non-negative scale factors
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDistanceGain(float[] frontDistance, float[] frontGain,
+ float[] backDistance, float[] backGain) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_GAIN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound0"));
+
+ ((ConeSoundRetained)this.retained).setDistanceGain(
+ frontDistance, frontGain, backDistance, backGain);
+ }
+
+ /**
+ * Sets this sound's back distance gain attenuation - where gain scale
+ * factor is applied to sound based on distance listener along the negative
+ * sound direction axis from sound source.
+ * @param attenuation defined by pairs of (distance,gain-scale-factor)
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setBackDistanceGain(Point2f[] attenuation) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_GAIN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound0"));
+
+ ((ConeSoundRetained)this.retained).setBackDistanceGain(attenuation);
+ }
+
+ /**
+ * Sets this sound's back distance gain attenuation as separate arrays.
+ * @param distance array of monotonically-increasing floats
+ * @param gain array of non-negative scale factors
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setBackDistanceGain(float[] distance, float[] gain) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_GAIN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound0"));
+
+ ((ConeSoundRetained)this.retained).setBackDistanceGain(distance, gain);
+ }
+
+ /**
+ * Gets this sound's elliptical distance attenuation. The
+ * attenuation values are copied into the specified arrays.
+ * The arrays must be large enough to hold all of the
+ * forward distances and backward distances attenuation values.
+ * The individual array elements must be allocated by the
+ * caller. The Point2f x,y values are defined as follows:
+ * x is the distance, y is the gain.
+ * @param frontAttenuation arrays containing forward distances
+ * attenuation pairs
+ * @param backAttenuation arrays containing backward distances
+ * attenuation pairs
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDistanceGain(Point2f[] frontAttenuation,
+ Point2f[] backAttenuation) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_GAIN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound2"));
+
+ ((ConeSoundRetained)this.retained).getDistanceGain(
+ frontAttenuation, backAttenuation);
+ }
+
+ /**
+ * Gets this sound's elliptical distance gain attenuation values in
+ * separate arrays. The arrays must be large enough to hold all
+ * of the values.
+ * @param frontDistance array of float distances along the sound axis
+ * @param frontGain array of non-negative scale factors associated with
+ * front distances
+ * @param backDistance array of float negative distances along the sound
+ * axis
+ * @param backGain array of non-negative scale factors associated with
+ * back distances
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDistanceGain(float[] frontDistance, float[] frontGain,
+ float[] backDistance, float[] backGain) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_GAIN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound10"));
+
+ ((ConeSoundRetained)this.retained).getDistanceGain(
+ frontDistance, frontGain, backDistance, backGain);
+ }
+
+ /**
+ * Sets this sound's direction from the vector provided.
+ * @param direction the new direction
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDirection(Vector3f direction) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DIRECTION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound3"));
+
+ ((ConeSoundRetained)this.retained).setDirection(direction);
+ }
+
+ /**
+ * Sets this sound's direction from the three values provided.
+ * @param x the new x direction
+ * @param y the new y direction
+ * @param z the new z direction
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDirection(float x, float y, float z) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DIRECTION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound3"));
+
+ ((ConeSoundRetained)this.retained).setDirection(x,y,z);
+ }
+
+ /**
+ * Retrieves this sound's direction and places it in the
+ * vector provided.
+ * @param direction axis of cones; 'direction' of sound
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDirection(Vector3f direction) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DIRECTION_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound5"));
+
+ ((ConeSoundRetained)this.retained).getDirection(direction);
+ }
+
+ /**
+ * Sets this sound's angular gain attenuation (not including filter).
+ * In this form of setAngularAttenuation, only the angular distances
+ * and angular gain scale factors pairs are given. The filter values for
+ * these tuples are implicitly set to Sound.NO_FILTER.
+ * @param attenuation array containing angular distance and gain
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAngularAttenuation(Point2f[] attenuation) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_ANGULAR_ATTENUATION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound6"));
+
+ ((ConeSoundRetained)this.retained).setAngularAttenuation(attenuation);
+ }
+
+ /**
+ * In the second form of setAngularAttenuation, an array of all three values
+ * is supplied.
+ * @param attenuation array containing angular distance, gain, and filter
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAngularAttenuation(Point3f[] attenuation) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_ANGULAR_ATTENUATION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound6"));
+
+ ((ConeSoundRetained)this.retained).setAngularAttenuation(attenuation);
+ }
+
+ /**
+ * Sets angular attenuation including gain and filter using separate arrays.
+ * The third form of setAngularAttenuation accepts three separate arrays for
+ * these angular attenuation values. These arrays should be of the same
+ * length. If the angularGain or filtering array length is greater than
+ * angularDistance array length, the array elements beyond the length of
+ * the angularDistance array are ignored. If the angularGain or filtering
+ * array is shorter than the angularDistance array, the last value of the
+ * short array is repeated to fill an array of length equal to
+ * angularDistance array.
+ * @param distance array containing angular distance
+ * @param gain array containing angular gain attenuation
+ * @param filter array containing angular low-pass frequency cutoff values
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAngularAttenuation(float[] distance, float[] gain,
+ float[] filter) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_ANGULAR_ATTENUATION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound6"));
+
+ ((ConeSoundRetained)this.retained).setAngularAttenuation(distance,
+ gain, filter);
+ }
+
+ /**
+ * Retrieves angular attenuation array length.
+ * All arrays are forced to same size.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getAngularAttenuationLength() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_ANGULAR_ATTENUATION_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound9"));
+
+ return (((ConeSoundRetained)this.retained).getAngularAttenuationLength());
+ }
+
+ /**
+ * Copies the array of attenuation values from this sound, including
+ * gain and filter, into the specified array. The array must be
+ * large enough to hold all of the points. The individual array
+ * elements must be allocated by the caller. The Point3f x,y,z values
+ * are defined as follows: x is the angular distance, y is
+ * the angular gain attenuation, and z is the frequency
+ * cutoff.
+ * @param attenuation the array to receive the attenuation values
+ * applied to gain when listener is between cones
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getAngularAttenuation(Point3f[] attenuation) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_ANGULAR_ATTENUATION_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound9"));
+
+ ((ConeSoundRetained)this.retained).getAngularAttenuation(attenuation);
+ }
+
+ /**
+ * Copies the array of attenuation values from this sound,
+ * including gain and filter, into the separate arrays.
+ * The arrays must be large enough to hold all of the values.
+ * @param distance array containing angular distance
+ * @param gain array containing angular gain attenuation
+ * @param filter array containing angular low-pass frequency cutoff values
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getAngularAttenuation(float[] distance, float[] gain,
+ float[] filter) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_ANGULAR_ATTENUATION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ConeSound9"));
+
+ ((ConeSoundRetained)this.retained).getAngularAttenuation(distance,
+ gain, filter);
+ }
+
+ /**
+ * Creates a new instance of the node. This routine is called
+ * by
+ * For any
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * If dangling references are to be allowed during the cloneTree call,
+ *
+ * The first child, at index 0, defines the surface on top of which all
+ * other children are rendered. The geometry of this child must encompass
+ * all other children, otherwise incorrect rendering may result. The
+ * polygons contained within each of the children must be facing the same
+ * way. If the polygons defined by the first child are front facing, then
+ * all other surfaces should be front facing. In this case, the polygons
+ * are rendered in order. The renderer can use knowledge of the coplanar
+ * nature of the surfaces to avoid
+ * Z-buffer collisions. If the main surface is back facing then all other
+ * surfaces should be back facing, and need not be rendered (even if back
+ * face culling is disabled).
+ *
+ * Note that using the DecalGroup node does not guarantee that Z-buffer
+ * collisions are avoided. An implementation of Java 3D may fall back to
+ * treating DecalGroup node as an OrderedGroup node.
+ */
+public class DecalGroup extends OrderedGroup {
+
+ /**
+ * Constructs and initializes a new DecalGroup node object.
+ */
+ public DecalGroup() {
+ }
+
+
+ /**
+ * Creates the retained mode DecalGroupRetained object that this
+ * DecalGroup component object will point to.
+ */
+ void createRetained() {
+ this.retained = new DecalGroupRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ *
+ * Note that both the position and the array of distances are
+ * specified in the local coordinate system of this node.
+ */
+public class DistanceLOD extends LOD {
+
+ private double distances[];
+ private Point3f position = new Point3f(0.0f, 0.0f, 0.0f);
+
+ // variables for processStimulus
+ private Point3f center = new Point3f();
+ private Point3f viewPosition = new Point3f();
+
+ /**
+ * Constructs and initializes a DistanceLOD node with default values.
+ * Note that the default constructor creates a DistanceLOD object with
+ * a single distance value set to 0.0 and is, therefore, not useful.
+ */
+ public DistanceLOD() {
+ distances = new double[1];
+ distances[0] = 0.0;
+ }
+
+ /**
+ * Constructs and initializes a DistanceLOD node with the specified
+ * array of distances and a default position of (0,0,0).
+ * @param distances an array of values representing LOD cutoff distances
+ */
+ public DistanceLOD(float[] distances) {
+ this.distances = new double[distances.length];
+
+ for(int i=0;i
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * The fog blending factor, f, is computed as follows:
+ *
+ * where
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * If the regions of influence of multiple Fog nodes overlap, the
+ * Java 3D system will choose a single set of fog parameters for those
+ * objects that lie in the intersection. This is done in an
+ * implementation-dependent manner, but in general, the Fog node that
+ * is "closest" to the object is chosen.
+ */
+
+public abstract class Fog extends Leaf {
+ /**
+ * Specifies that this Fog node allows read access to its
+ * influencing bounds and bounds leaf information.
+ */
+ public static final int
+ ALLOW_INFLUENCING_BOUNDS_READ = CapabilityBits.FOG_ALLOW_INFLUENCING_BOUNDS_READ;
+
+ /**
+ * Specifies that this Fog node allows write access to its
+ * influencing bounds and bounds leaf information.
+ */
+ public static final int
+ ALLOW_INFLUENCING_BOUNDS_WRITE = CapabilityBits.FOG_ALLOW_INFLUENCING_BOUNDS_WRITE;
+
+ /**
+ * Specifies that this Fog node allows read access to its color
+ * information.
+ */
+ public static final int
+ ALLOW_COLOR_READ = CapabilityBits.FOG_ALLOW_COLOR_READ;
+
+ /**
+ * Specifies that this Fog node allows write access to its color
+ * information.
+ */
+ public static final int
+ ALLOW_COLOR_WRITE = CapabilityBits.FOG_ALLOW_COLOR_WRITE;
+
+ /**
+ * Specifies that this Fog node allows read access to its scope
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_SCOPE_READ = CapabilityBits.FOG_ALLOW_SCOPE_READ;
+
+ /**
+ * Specifies that this Fog node allows write access to its scope
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_SCOPE_WRITE = CapabilityBits.FOG_ALLOW_SCOPE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_INFLUENCING_BOUNDS_READ,
+ ALLOW_COLOR_READ,
+ ALLOW_SCOPE_READ
+ };
+
+ /**
+ * Constructs a Fog node with default parameters. The default
+ * values are as follows:
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ * A 3D Font consists of a Java 2D font, a tesellation tolerance,
+ * and an extrusion path. The extrusion
+ * path creates depth by describing how the edge of a glyph varies
+ * in the Z axis.
+ *
+ * The construction of a Text3D object requires a Font3D object.
+ * The Font3D object describes the style of the text, such as its
+ * depth. The text also needs other classes, such as java.awt.Font and
+ * FontExtrusion. The Font object describes the font name (Helvetica,
+ * Courier, etc.), the font style (bold, Italic, etc.), and point
+ * size. The FontExtrusion object extends Font3D by describing
+ * the extrusion path for the Font3D object (how the edge of the
+ * font glyph varies in the Z axis).
+ *
+ * To ensure correct rendering, the 2D Font object should be created
+ * with the default AffineTransform. The point size of the 2D font will
+ * be used as a rough measure of how fine a tesselation to use when
+ * creating the Font3D object: the larger the point size, in
+ * general, the finer the tesselation.
+ *
+ * Custom 3D fonts as well as methods to store 3D fonts
+ * to disk will be addressed in a future release.
+ *
+ * @see java.awt.Font
+ * @see FontExtrusion
+ * @see Text3D
+ */
+public class Font3D extends NodeComponent {
+
+ Font font;
+ double tessellationTolerance;
+ FontExtrusion fontExtrusion;
+ FontRenderContext frc;
+ // Used by triangulateGlyphs method to split contour data into islands.
+ final static float EPS = 0.000001f;
+
+ // Map glyph code to GeometryArrayRetained
+ Hashtable geomHash = new Hashtable(20);
+
+ /**
+ * Constructs a Font3D object from the specified Font and
+ * FontExtrusion objects, using the default value for the
+ * tessellation tolerance. The default value is as follows:
+ *
+ *
+ * The FontExtrusion object contains the extrusion path to use on
+ * the 2D Font glyphs. To ensure correct rendering the font must
+ * be created with the default AffineTransform. Passing null for
+ * the FontExtrusion parameter results in no extrusion being done.
+ *
+ * @param font the Java 2D font used to create the 3D font object
+ * @param extrudePath the extrusion path used to describe how
+ * the edge of the font varies along the Z axis
+ */
+ public Font3D(Font font, FontExtrusion extrudePath) {
+ this(font, 0.01, extrudePath);
+ }
+
+ /**
+ * Constructs a Font3D object from the specified Font and
+ * FontExtrusion objects, using the specified tessellation
+ * tolerance.
+ * The FontExtrusion object contains the extrusion path to use on
+ * the 2D Font glyphs. To ensure correct rendering, the font must
+ * be created with the default AffineTransform. Passing null for
+ * the FontExtrusion parameter results in no extrusion being done.
+ *
+ * @param font the Java 2D font used to create the 3D font object.
+ * @param tessellationTolerance the tessellation tolerance value
+ * used in tessellating the glyphs of the 2D Font.
+ * This corresponds to the
+ * The shape of the extrusion path is, by default, a straight line
+ * from 0.0 to 0.2 (known as a straight bevel). The shape may be
+ * modified via the extrusionShape parameter, a Shape object that
+ * describes the 3D contour of a Font3D object.
+ *
+ * User is responsible for data sanity and must make sure that
+ * extrusionShape does not cause intersection of adjacent glyphs
+ * or within single glyph. Else undefined output may be generated.
+ *
+ * @see java.awt.Font
+ * @see Font3D
+ */
+public class FontExtrusion extends Object {
+
+ // Default FontExtrusion is a straight line of length .2
+ float length = 0.2f;
+ Shape shape;
+ Point2f [] pnts;
+
+ double tessellationTolerance = 0.01;
+
+ /**
+ * Constructs a FontExtrusion object with default parameters. The
+ * default parameters are as follows:
+ *
+ *
+ *
+ * Each of these geometric types defines a visible object or set of
+ * objects. A Geometry object is used as a component object of a Shape3D
+ * leaf node.
+ *
+ */
+
+public abstract class Geometry extends NodeComponent {
+
+ /**
+ * Specifies that this Geometry allows intersect operation. This
+ * capability bit is set (true) by default for all Geometry objects.
+ */
+ public static final int
+ ALLOW_INTERSECT = CapabilityBits.GEOMETRY_ALLOW_INTERSECT;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_INTERSECT
+ };
+
+ /**
+ * Constructs a new Geometry object.
+ */
+ public Geometry() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GeometryArray.java b/j3d-core/src/classes/share/javax/media/j3d/GeometryArray.java
new file mode 100644
index 0000000..bd29d67
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GeometryArray.java
@@ -0,0 +1,7460 @@
+/*
+ * $RCSfile: GeometryArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+
+
+/**
+ * The GeometryArray object contains separate arrays of positional
+ * coordinates, colors, normals, texture coordinates, and vertex
+ * attributes that
+ * describe point, line, or polygon geometry. This class is extended
+ * to create the various primitive types (such as lines,
+ * triangle strips, etc.).
+ * Vertex data may be passed to this geometry array in one of two
+ * ways: by copying the data into the array using the existing
+ * methods, or by passing a reference to the data.
+ *
+ *
+ * All colors used in the geometry array object must be in the range [0.0,1.0].
+ * Values outside this range will cause undefined results.
+ * All normals used in the geometry array object must be unit length
+ * vectors. That is their geometric length must be 1.0. Normals that
+ * are not unit length vectors will cause undefined results.
+ *
+ * Note that the term coordinate, as used in the method names
+ * and method descriptions, actually refers to a set of x,
+ * y, and z coordinates representing the position of a
+ * single vertex. The term coordinates (plural) is used to
+ * indicate sets of x, y, and z coordinates for
+ * multiple vertices. This is somewhat at odds with the mathematical
+ * definition of a coordinate, but is used as a convenient shorthand.
+ * Similarly, the term texture coordinate is used to indicate a
+ * set of texture coordinates for a single vertex, while the term
+ * texture coordinates (plural) is used to indicate sets of
+ * texture coordinates for multiple vertices.
+ */
+
+public abstract class GeometryArray extends Geometry {
+
+ /**
+ * Specifies that this GeometryArray allows reading the array of
+ * coordinates.
+ */
+ public static final int
+ ALLOW_COORDINATE_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_COORDINATE_READ;
+
+ /**
+ * Specifies that this GeometryArray allows writing the array of
+ * coordinates.
+ */
+ public static final int
+ ALLOW_COORDINATE_WRITE = CapabilityBits.GEOMETRY_ARRAY_ALLOW_COORDINATE_WRITE;
+
+ /**
+ * Specifies that this GeometryArray allows reading the array of
+ * colors.
+ */
+ public static final int
+ ALLOW_COLOR_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_COLOR_READ;
+
+ /**
+ * Specifies that this GeometryArray allows writing the array of
+ * colors.
+ */
+ public static final int
+ ALLOW_COLOR_WRITE = CapabilityBits.GEOMETRY_ARRAY_ALLOW_COLOR_WRITE;
+
+ /**
+ * Specifies that this GeometryArray allows reading the array of
+ * normals.
+ */
+ public static final int
+ ALLOW_NORMAL_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_NORMAL_READ;
+
+ /**
+ * Specifies that this GeometryArray allows writing the array of
+ * normals.
+ */
+ public static final int
+ ALLOW_NORMAL_WRITE = CapabilityBits.GEOMETRY_ARRAY_ALLOW_NORMAL_WRITE;
+
+ /**
+ * Specifies that this GeometryArray allows reading the array of
+ * texture coordinates.
+ */
+ public static final int
+ ALLOW_TEXCOORD_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_TEXCOORD_READ;
+
+ /**
+ * Specifies that this GeometryArray allows writing the array of
+ * texture coordinates.
+ */
+ public static final int
+ ALLOW_TEXCOORD_WRITE = CapabilityBits.GEOMETRY_ARRAY_ALLOW_TEXCOORD_WRITE;
+
+ /**
+ * Specifies that this GeometryArray allows reading the array of
+ * vertex attributes.
+ *
+ * @since Java 3D 1.4
+ */
+ public static final int
+ ALLOW_VERTEX_ATTR_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_VERTEX_ATTR_READ;
+
+ /**
+ * Specifies that this GeometryArray allows writing the array of
+ * vertex attributes.
+ *
+ * @since Java 3D 1.4
+ */
+ public static final int
+ ALLOW_VERTEX_ATTR_WRITE = CapabilityBits.GEOMETRY_ARRAY_ALLOW_VERTEX_ATTR_WRITE;
+
+ /**
+ * Specifies that this GeometryArray allows reading the count or
+ * initial index information for this object.
+ */
+ public static final int
+ ALLOW_COUNT_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_COUNT_READ;
+
+ /**
+ * Specifies that this GeometryArray allows writing the count or
+ * initial index information for this object.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int
+ ALLOW_COUNT_WRITE = CapabilityBits.GEOMETRY_ARRAY_ALLOW_COUNT_WRITE;
+
+ /**
+ * Specifies that this GeometryArray allows reading the vertex format
+ * information for this object.
+ */
+ public static final int
+ ALLOW_FORMAT_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_FORMAT_READ;
+
+ /**
+ * Specifies that this GeometryArray allows reading the geometry
+ * data reference information for this object. This is only used in
+ * by-reference geometry mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int
+ ALLOW_REF_DATA_READ = CapabilityBits.GEOMETRY_ARRAY_ALLOW_REF_DATA_READ;
+
+ private static final int J3D_1_2_ALLOW_REF_DATA_READ =
+ CapabilityBits.J3D_1_2_GEOMETRY_ARRAY_ALLOW_REF_DATA_READ;
+
+ /**
+ * Specifies that this GeometryArray allows writing the geometry
+ * data reference information for this object. It also enables
+ * writing the referenced data itself, via the GeometryUpdater
+ * interface. This is only used in by-reference geometry mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int
+ ALLOW_REF_DATA_WRITE = CapabilityBits.GEOMETRY_ARRAY_ALLOW_REF_DATA_WRITE;
+
+ /**
+ * Specifies that this GeometryArray contains an array of coordinates.
+ * This bit must be set.
+ */
+ public static final int COORDINATES = 0x01;
+
+ /**
+ * Specifies that this GeometryArray contains an array of normals.
+ */
+ public static final int NORMALS = 0x02;
+
+ /**
+ * Specifies that this GeometryArray contains an array of colors.
+ */
+ static final int COLOR = 0x04;
+
+ /**
+ * Specifies that this GeometryArray's colors contain alpha.
+ */
+ static final int WITH_ALPHA = 0x08;
+
+ /**
+ * Specifies that this GeometryArray contains an array of colors without alpha.
+ */
+ public static final int COLOR_3 = COLOR;
+
+ /**
+ * Specifies that this GeometryArray contains an array of colors with alpha.
+ * This takes precedence over COLOR_3.
+ */
+ public static final int COLOR_4 = COLOR | WITH_ALPHA;
+
+ /**
+ * Specifies that this GeometryArray contains one or more arrays of
+ * 2D texture coordinates.
+ */
+ public static final int TEXTURE_COORDINATE_2 = 0x20;
+
+ /**
+ * Specifies that this GeometryArray contains one or more arrays of
+ * 3D texture coordinates.
+ * This takes precedence over TEXTURE_COORDINATE_2.
+ */
+ public static final int TEXTURE_COORDINATE_3 = 0x40;
+
+
+ /**
+ * Specifies that this GeometryArray contains one or more arrays of
+ * 4D texture coordinates.
+ * This takes precedence over TEXTURE_COORDINATE_2 and TEXTURE_COORDINATE_3.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int TEXTURE_COORDINATE_4 = 0x400;
+
+
+ static final int TEXTURE_COORDINATE = TEXTURE_COORDINATE_2 |
+ TEXTURE_COORDINATE_3 |
+ TEXTURE_COORDINATE_4;
+
+ /**
+ * Specifies that the position, color, normal, and texture coordinate
+ * data for this GeometryArray are accessed by reference.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int BY_REFERENCE = 0x80;
+
+
+ /**
+ * Specifies that the position, color, normal, and texture
+ * coordinate data for this GeometryArray are accessed via a single
+ * interleaved, floating-point array reference. All of the data
+ * values for each vertex are stored in consecutive memory
+ * locations. This flag is only valid in conjunction with the
+ *
+ *
+ * @exception IllegalArgumentException if vertexCount < 0
+ *
+ * @exception IllegalArgumentException if vertexFormat does not
+ * include
+ *
+ * @param vertexFormat a mask indicating which components are
+ * present in each vertex. This is specified as one or more
+ * individual flags that are bitwise "OR"ed together to describe
+ * the per-vertex data.
+ * The flags include:
+ *
+ * @param texCoordSetCount the number of texture coordinate sets
+ * in this GeometryArray object. If
+ *
+ *
+ * @param texCoordSetMap an array that maps texture coordinate
+ * sets to texture units. The array is indexed by texture unit
+ * number for each texture unit in the associated Appearance
+ * object. The values in the array specify the texture coordinate
+ * set within this GeometryArray object that maps to the
+ * corresponding texture
+ * unit. All elements within the array must be less than
+ *
+ *
+ *
+ * @exception IllegalArgumentException if vertexCount < 0
+ *
+ * @exception IllegalArgumentException if vertexFormat does not
+ * include
+ *
+ * @param vertexFormat a mask indicating which components are
+ * present in each vertex. This is specified as one or more
+ * individual flags that are bitwise "OR"ed together to describe
+ * the per-vertex data.
+ * The flags include:
+ *
+ * @param texCoordSetCount the number of texture coordinate sets
+ * in this GeometryArray object. If
+ *
+ *
+ * @param texCoordSetMap an array that maps texture coordinate
+ * sets to texture units. The array is indexed by texture unit
+ * number for each texture unit in the associated Appearance
+ * object. The values in the array specify the texture coordinate
+ * set within this GeometryArray object that maps to the
+ * corresponding texture
+ * unit. All elements within the array must be less than
+ *
+ *
+ *
+ * @param vertexAttrCount the number of vertex attributes
+ * in this GeometryArray object. If
+ *
+ * @param vertexAttrSizes is an array that specifes the size of
+ * each vertex attribute. Each element in the array specifies the
+ * number of components in the attribute, from 1 to 4. The length
+ * of the array must be equal to
+ *
+ * @exception IllegalArgumentException if vertexCount < 0
+ *
+ * @exception IllegalArgumentException if vertexFormat does not
+ * include
+ * This method may also be used to atomically set multiple
+ * references (for example, to coordinate and color arrays)
+ * or to atomically
+ * change multiple data values through the geometry data copying
+ * methods.
+ *
+ * @param updater object whose updateData callback method will be
+ * called to update the data referenced by this GeometryArray.
+ * @exception CapabilityNotSetException if the appropriate capability
+ * is not set, the vertex data mode is
+ * @exception IllegalArgumentException if any of the following are
+ * true:
+ *
+ * @exception ArrayIndexOutOfBoundsException if the geometry data format
+ * is
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not
+ * @exception IllegalArgumentException if either of the following are
+ * true:
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * the CoordRef array is non-null and:
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not
+ * @exception IllegalArgumentException if either of the following are
+ * true:
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * the ColorRef array is non-null and:
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not
+ * @exception IllegalArgumentException if either of the following are
+ * true:
+ *
+ * @exception ArrayIndexOutOfBoundsException if normals
+ * the NormalRef array is non-null and:
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not
+ * @exception IllegalArgumentException if either of the following are
+ * true:
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * the TexCoordRef array is non-null and:
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not
+ * @exception IllegalArgumentException if either of the following are
+ * true:
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * the VertexAttrRef array is non-null and:
+ *
+ * @exception ArrayIndexOutOfBoundsException if vertexAttrNum is
+ * out of range.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setInitialVertexAttrIndex(int vertexAttrNum,
+ int initialVertexAttrIndex) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_COUNT_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray90"));
+ }
+ }
+
+ if (initialVertexAttrIndex < 0) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray97"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+ }
+
+ if ((format & INTERLEAVED) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setInitialVertexAttrIndex(
+ vertexAttrNum, initialVertexAttrIndex);
+
+ // NOTE: the check for initialVertexAttrIndex + validVertexCount >
+ // vertexCount needs to be done in the retained method
+ }
+
+
+ /**
+ * Gets the initial vertex attribute index for the specified
+ * vertex attribute number for this GeometryArray object.
+ * This attribute is only used when the data mode for this
+ * geometry array object is
+ *
+ * @exception ArrayIndexOutOfBoundsException if the geometry data format
+ * is
+ * Note that the drawing methods in this class are not necessarily
+ * executed immediately. They may be buffered up for future
+ * execution. Applications must call the
+ *
+ * A single-buffered, pure-immediate mode application must explicitly
+ * call flush to ensure that the graphics will be rendered to the
+ * Canvas3D.
+ *
+ * @see Canvas3D#getGraphicsContext3D
+ */
+public class GraphicsContext3D extends Object {
+ /**
+ * Specifies that rendering is done to the left eye.
+ * @see #setStereoMode
+ * @since Java 3D 1.2
+ */
+ public static final int STEREO_LEFT = 0;
+
+ /**
+ * Specifies that rendering is done to the right eye.
+ * @see #setStereoMode
+ * @since Java 3D 1.2
+ */
+ public static final int STEREO_RIGHT = 1;
+
+ /**
+ * Specifies that rendering is done to both eyes. This is the
+ * default.
+ * @see #setStereoMode
+ * @since Java 3D 1.2
+ */
+ public static final int STEREO_BOTH = 2;
+
+
+ /**
+ * Canvas3D in which this GraphicsContext3D will render.
+ */
+ Canvas3D canvas3d = null;
+
+//
+// Graphics state
+//
+// current user specified graphics state
+ private Background uBackground = null;
+ private Fog uFog = null;
+ private Appearance uAppearance = null;
+ private Vector uLights = new Vector();
+ private HiResCoord uHiRes = new HiResCoord();
+ private Vector uSounds = new Vector();
+ private AuralAttributes uAuralAttributes = null;
+ private boolean uBufferOverride = false;
+ private boolean uFrontBufferRendering = false;
+ private int uStereoMode = STEREO_BOTH;
+ private ModelClip uModelClip = null;
+
+// Current rendering graphics state
+ // Current background
+ Background background = null;
+
+ // Background to use if background is null;
+ BackgroundRetained black = new BackgroundRetained();
+
+ // Current fog
+ Fog fog = null;
+
+ // Current modelClip
+ ModelClip modelClip = null;
+
+ // Current appearance object
+ Appearance appearance = null;
+
+ // default appearance retained object
+ AppearanceRetained defaultAppearanceRetained = new AppearanceRetained();
+
+ // The vector of lights
+ Vector lights = new Vector();
+
+ // Current High resolution coordinate
+ HiResCoord hiRes = new HiResCoord();
+
+ // Current modeling transform
+ Transform3D modelTransform = new Transform3D();
+ Transform3D identityTransform = new Transform3D();
+
+ Transform3D modelClipTransform = null;
+ Transform3D normalTransform = null;
+ boolean normalTransformNeedToUpdate = true;
+
+ // The vector of sounds
+ Vector sounds = new Vector();
+
+ // Current AuralAttributes state parameters
+ AuralAttributes auralAttributes = null;
+
+ // The render object associated with this context
+ LightSet ls = null;
+
+ // The current list of lights
+ LightRetained[] lightlist = null;
+
+ // Ambient lights
+ Color3f sceneAmbient = new Color3f(0.0f, 0.0f, 0.0f);
+
+ // The current number of lights, may be less than lightlist.length
+ int numLights = 0;
+
+ // Current composite transform: hi-res + modelTransform
+ Transform3D compTransform = new Transform3D();
+
+ // Draw transform: hi-res + modelTransform + view
+ Transform3D drawTransform = new Transform3D();
+
+ // The view transform (VPC to EC).
+ // NOTE that this is *read-only*
+ Transform3D vpcToEc;
+
+ // A boolean that indicates the lights have changed
+ boolean lightsChanged = false;
+
+ // A boolean that indicates the sounds have changed
+ // XXXX: the soundsChanged flag are set like lights methods set
+ // lightsChanged? but where is this supposed to be check???
+ // lightsChanged tested in 'draw'; but Sound are not processed
+ // in draw.
+ boolean soundsChanged = false;
+
+ // Buffer override flag; enables frontBufferRendering and stereoMode
+ // attributes.
+ boolean bufferOverride = false;
+
+ // Forces rendering to the front buffer (if bufferOverride is true)
+ boolean frontBufferRendering = false;
+
+ // Stereo mode for this buffer (if bufferOverride is true)
+ int stereoMode = STEREO_BOTH;
+
+ // Read Buffer for reading raster of color image
+ byte[] byteBuffer = new byte[1];
+
+ // Read Buffer for reading floating depth image
+ float[] floatBuffer = new float[1];
+
+ // Read Buffer for reading integer depth image
+ int[] intBuffer = new int[1];
+
+ /**
+ * The cached ColoringAttributes color value. It is
+ * 1.0, 1.0, 1.0 if there is no ColoringAttributes.
+ */
+ float red = 1.0f;
+ float green = 1.0f;
+ float blue = 1.0f;
+
+
+ /**
+ * Cached diffuse color value
+ */
+ float dRed = 1.0f;
+ float dGreen = 1.0f;
+ float dBlue = 1.0f;
+
+ /**
+ * The cached TransparencyAttributes transparency value. It is
+ * 0.0 if there is no TransparencyAttributes.
+ */
+ float alpha = 0.0f;
+
+ /**
+ * The cached visible flag for geometry.
+ */
+ boolean visible = true;
+
+ /**
+ * Cached values for polygonMode, line antialiasing, and point antialiasing
+ */
+ int polygonMode = PolygonAttributes.POLYGON_FILL;
+ boolean lineAA = false;
+ boolean pointAA = false;
+
+
+ /**
+ /**
+ * A boolean indicating whether or not lighting should be on.
+ */
+ boolean enableLighting = false;
+
+ private Appearance defaultAppearance = null;
+
+ private boolean geometryIsLocked = false;
+
+ private boolean ignoreVertexColors = false;
+
+ static final int CLEAR = 0;
+ static final int DRAW = 1;
+ static final int SWAP = 2;
+ static final int READ_RASTER = 3;
+ static final int SET_APPEARANCE = 4;
+ static final int SET_BACKGROUND = 5;
+ static final int SET_FOG = 6;
+ static final int SET_LIGHT = 7;
+ static final int INSERT_LIGHT = 8;
+ static final int REMOVE_LIGHT = 9;
+ static final int ADD_LIGHT = 10;
+ static final int SET_HI_RES = 11;
+ static final int SET_MODEL_TRANSFORM = 12;
+ static final int MULTIPLY_MODEL_TRANSFORM = 13;
+ static final int SET_SOUND = 14;
+ static final int INSERT_SOUND = 15;
+ static final int REMOVE_SOUND = 16;
+ static final int ADD_SOUND = 17;
+ static final int SET_AURAL_ATTRIBUTES = 18;
+ static final int SET_BUFFER_OVERRIDE = 19;
+ static final int SET_FRONT_BUFFER_RENDERING = 20;
+ static final int SET_STEREO_MODE = 21;
+ static final int FLUSH = 22;
+ static final int FLUSH2D = 23;
+ static final int DRAWANDFLUSH2D = 24;
+ static final int SET_MODELCLIP = 25;
+ static final int DISPOSE2D = 26;
+ static final int NCOMMANDS = 27; // needs to be incremented
+ // when a new command is to be
+ // added to the list
+
+ private static Integer[] commands = new Integer[NCOMMANDS];
+ private static Integer[] stereoModes = {
+ new Integer(STEREO_LEFT),
+ new Integer(STEREO_RIGHT),
+ new Integer(STEREO_BOTH)
+ };
+
+ // dirty bits
+ private static final int BUFFER_MODE = 0x1;
+ private int dirtyMask = 0;
+
+ // multi-texture
+ private int numActiveTexUnit = 0;
+ private int lastActiveTexUnitIndex = 0;
+
+ // for read raster
+ private volatile boolean readRasterReady = false;
+
+ // for runMonitor
+ private boolean gcReady = false;
+ private int waiting = 0;
+
+
+ /**
+ * Constructs and creates a GraphicsContext3D object with default
+ * values. Users do not call this directly, rather they get a
+ * graphics context from a Canvas3D.
+ */
+ GraphicsContext3D(Canvas3D canvas3d) {
+ this.canvas3d = canvas3d;
+ }
+
+ /**
+ * Gets the Canvas3D that created this GraphicsContext3D.
+ * @return the Canvas3D that created this GraphicsContext3D
+ */
+ public Canvas3D getCanvas3D() {
+ return this.canvas3d;
+ }
+
+//
+// Methods to set/get graphics state
+//
+
+ /**
+ * Sets the current Appearance object to the specified
+ * Appearance component object.
+ * The graphics context stores a reference to the specified
+ * Appearance object. This means that the application may modify
+ * individual appearance attributes by using the appropriate
+ * methods on the Appearance object.
+ * If the Appearance object is null, default values will be used
+ * for all appearance attributes - it is as if an
+ * Appearance node were created using the default constructor.
+ *
+ * @param appearance the new Appearance object
+ *
+ * @exception IllegalSharingException if the specified appearance refers
+ * to an ImageComponent2D that is being used by a Canvas3D as
+ * an off-screen buffer.
+ */
+ public void setAppearance(Appearance appearance) {
+
+ if(appearance == null) {
+ if(defaultAppearance == null) {
+ defaultAppearance = new Appearance();
+ }
+ appearance = defaultAppearance;
+ } else {
+ // Check whether any ImageComponent2D referred to by
+ // the new appearance is being used as an off-screen buffer and throw
+ // IllegalSharingException if it is.
+ TextureRetained texRetained;
+ ImageComponent[] images;
+ AppearanceRetained appRetained = (AppearanceRetained)appearance.retained;
+ if(appRetained.texture != null) {
+ assert (appRetained.texUnitState == null);
+ texRetained = appRetained.texture;
+ images = texRetained.getImages();
+ if(images != null) {
+ for(int i=0; i
+ * Note that this attribute has no effect if double buffering
+ * is disabled or is not available on the Canvas3D.
+ *
+ * @param frontBufferRendering the new front buffer rendering flag
+ *
+ * @see #setBufferOverride
+ *
+ * @since Java 3D 1.2
+ */
+ public void setFrontBufferRendering(boolean frontBufferRendering) {
+ uFrontBufferRendering = frontBufferRendering;
+ if ((canvas3d.view == null) ||
+ (canvas3d.view.universe == null) ||
+ (!canvas3d.view.active) ||
+ (Thread.currentThread() == canvas3d.screen.renderer)) {
+ doSetFrontBufferRendering(frontBufferRendering);
+ } else if (Thread.currentThread() ==
+ canvas3d.view.universe.behaviorScheduler) {
+ sendRenderMessage(false, GraphicsContext3D.SET_FRONT_BUFFER_RENDERING,
+ new Boolean(frontBufferRendering), null);
+ } else {
+ sendRenderMessage(true, GraphicsContext3D.SET_FRONT_BUFFER_RENDERING,
+ new Boolean(frontBufferRendering), null);
+ }
+ }
+
+ void doSetFrontBufferRendering(boolean frontBufferRendering) {
+ if (frontBufferRendering != this.frontBufferRendering) {
+ this.frontBufferRendering = frontBufferRendering;
+ dirtyMask |= BUFFER_MODE;
+ }
+ }
+
+
+ /**
+ * Returns the current front buffer rendering flag.
+ * @return true if front buffer rendering is enabled; otherwise,
+ * false is returned
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean getFrontBufferRendering() {
+ return uFrontBufferRendering;
+ }
+
+
+ /**
+ * Sets the stereo mode for immediate mode rendering. The
+ * parameter specifies which stereo buffer or buffers is rendered
+ * into. This attribute is only used when the
+ *
+ * Note that this attribute has no effect if stereo is disabled or
+ * is not available on the Canvas3D.
+ *
+ * @param stereoMode the new stereo mode
+ *
+ * @see #setBufferOverride
+ *
+ * @since Java 3D 1.2
+ */
+ public void setStereoMode(int stereoMode) {
+ uStereoMode = stereoMode;
+ if ((canvas3d.view == null) ||
+ (canvas3d.view.universe == null) ||
+ (!canvas3d.view.active) ||
+ (Thread.currentThread() == canvas3d.screen.renderer)) {
+ doSetStereoMode(stereoMode);
+ } else if (Thread.currentThread() ==
+ canvas3d.view.universe.behaviorScheduler) {
+ sendRenderMessage(false, GraphicsContext3D.SET_STEREO_MODE,
+ stereoModes[stereoMode], null);
+ } else {
+ sendRenderMessage(true, GraphicsContext3D.SET_STEREO_MODE,
+ stereoModes[stereoMode], null);
+ }
+ }
+
+ void doSetStereoMode(int stereoMode) {
+ if (stereoMode != this.stereoMode) {
+ this.stereoMode = stereoMode;
+ dirtyMask |= BUFFER_MODE;
+ }
+ }
+
+
+ /**
+ * Returns the current stereo mode.
+ * @return the stereo mode, one of
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * Java 3D uses integer arrays of length
+ * eight to define or extract a single 256-bit coordinate value.
+ * Java 3D interprets the integer at index 0 as the 32
+ * most-significant bits and the integer at index 7 as the 32
+ * least-significant bits.
+ */
+
+public class HiResCoord {
+ /**
+ * The eight-element array containing the high resolution coordinate's
+ * x value.
+ */
+ int x[];
+
+ /**
+ * The eight-element array containing the high resolution coordinate's
+ * y value.
+ */
+ int y[];
+
+ /**
+ * The eight-element array containing the high resolution coordinate's
+ * z value.
+ */
+ int z[];
+
+private double scales[] = {
+ 79228162514264337593543950336.0, // 2^96
+ 18446744073709551616.0, // 2^64
+ 4294967296.0, // 2^32
+ 1.0, // 2^0
+ 2.3283064365386962890625e-10, // 2^-32
+ 5.421010862427522170037264004349708557128906250000000000000000e-20, // 2^-64
+ 1.26217744835361888865876570445245796747713029617443680763244628906250e-29, // 2^-96
+ 2.938735877055718769921841343055614194546663891930218803771879265696043148636817932128906250e-39 };
+
+
+
+ /**
+ * Constructs and initializes a new HiResCoord using the values
+ * provided in the argument.
+ * The HiResCoord represents 768 bits of floating point 3-Space.
+ * @param X an eight element array specifying the x position
+ * @param Y an eight element array specifying the y position
+ * @param Z an eight element array specifying the z position
+ */
+ public HiResCoord(int[] X, int[] Y, int[] Z) {
+ int i;
+
+ this.x = new int[8];
+ this.y = new int[8];
+ this.z = new int[8];
+
+ for(i=0;i<8;i++) {
+ this.x[i] = X[i];
+ this.y[i] = Y[i];
+ this.z[i] = Z[i];
+ }
+
+ }
+
+ /**
+ * Constructs and initializes a new HiResCoord using the values
+ * provided in the argument.
+ * The HiResCoord represents 768 bits of floating point 3-Space.
+ * @param hc the HiResCoord to copy
+ */
+ public HiResCoord(HiResCoord hc) {
+ this.x = new int[8];
+ this.y = new int[8];
+ this.z = new int[8];
+
+ this.x[0] = hc.x[0];
+ this.y[0] = hc.y[0];
+ this.z[0] = hc.z[0];
+
+ this.x[1] = hc.x[1];
+ this.y[1] = hc.y[1];
+ this.z[1] = hc.z[1];
+
+ this.x[2] = hc.x[2];
+ this.y[2] = hc.y[2];
+ this.z[2] = hc.z[2];
+
+ this.x[3] = hc.x[3];
+ this.y[3] = hc.y[3];
+ this.z[3] = hc.z[3];
+
+ this.x[4] = hc.x[4];
+ this.y[4] = hc.y[4];
+ this.z[4] = hc.z[4];
+
+ this.x[5] = hc.x[5];
+ this.y[5] = hc.y[5];
+ this.z[5] = hc.z[5];
+
+ this.x[6] = hc.x[6];
+ this.y[6] = hc.y[6];
+ this.z[6] = hc.z[6];
+
+ this.x[7] = hc.x[7];
+ this.y[7] = hc.y[7];
+ this.z[7] = hc.z[7];
+ }
+
+ /**
+ * Constructs and initializes a new HiResCoord located at (0, 0, 0).
+ * The HiResCoord represents 768 bits of floating point 3-Space.
+ */
+ public HiResCoord() {
+ this.x = new int[8];
+ this.y = new int[8];
+ this.z = new int[8];
+ }
+
+ /**
+ * Sets this HiResCoord to the location specified by the
+ * parameters provided.
+ * @param X an eight-element array specifying the x position
+ * @param Y an eight-element array specifying the y position
+ * @param Z an eight-element array specifying the z position
+ */
+ public void setHiResCoord(int[] X, int[] Y, int[] Z) {
+ int i;
+
+ for(i=0;i<8;i++) {
+ this.x[i] = X[i];
+ this.y[i] = Y[i];
+ this.z[i] = Z[i];
+ }
+
+ }
+
+ /**
+ * Sets this HiResCoord to the location specified by the
+ * hires provided.
+ * @param hires the hires coordinate to copy
+ */
+ public void setHiResCoord(HiResCoord hires) {
+ this.x[0] = hires.x[0];
+ this.y[0] = hires.y[0];
+ this.z[0] = hires.z[0];
+
+ this.x[1] = hires.x[1];
+ this.y[1] = hires.y[1];
+ this.z[1] = hires.z[1];
+
+ this.x[2] = hires.x[2];
+ this.y[2] = hires.y[2];
+ this.z[2] = hires.z[2];
+
+ this.x[3] = hires.x[3];
+ this.y[3] = hires.y[3];
+ this.z[3] = hires.z[3];
+
+ this.x[4] = hires.x[4];
+ this.y[4] = hires.y[4];
+ this.z[4] = hires.z[4];
+
+ this.x[5] = hires.x[5];
+ this.y[5] = hires.y[5];
+ this.z[5] = hires.z[5];
+
+ this.x[6] = hires.x[6];
+ this.y[6] = hires.y[6];
+ this.z[6] = hires.z[6];
+
+ this.x[7] = hires.x[7];
+ this.y[7] = hires.y[7];
+ this.z[7] = hires.z[7];
+ }
+
+
+ /**
+ * Sets this HiResCoord's X value to that specified by the argument.
+ * @param X an eight-element array specifying the x position
+ */
+ public void setHiResCoordX(int[] X) {
+ this.x[0] = X[0];
+ this.x[1] = X[1];
+ this.x[2] = X[2];
+ this.x[3] = X[3];
+ this.x[4] = X[4];
+ this.x[5] = X[5];
+ this.x[6] = X[6];
+ this.x[7] = X[7];
+ }
+
+ /**
+ * Sets this HiResCoord's Y value to that specified by the argument.
+ * @param Y an eight-element array specifying the y position
+ */
+ public void setHiResCoordY(int[] Y) {
+ this.y[0] = Y[0];
+ this.y[1] = Y[1];
+ this.y[2] = Y[2];
+ this.y[3] = Y[3];
+ this.y[4] = Y[4];
+ this.y[5] = Y[5];
+ this.y[6] = Y[6];
+ this.y[7] = Y[7];
+ }
+
+ /**
+ * Sets this HiResCoord's Z value to that specified by the argument.
+ * @param Z an eight-element array specifying the z position
+ */
+ public void setHiResCoordZ(int[] Z) {
+ this.z[0] = Z[0];
+ this.z[1] = Z[1];
+ this.z[2] = Z[2];
+ this.z[3] = Z[3];
+ this.z[4] = Z[4];
+ this.z[5] = Z[5];
+ this.z[6] = Z[6];
+ this.z[7] = Z[7];
+ }
+
+ /**
+ * Retrieves this HiResCoord's location and saves the coordinates
+ * in the specified arrays. The arrays must be large enough
+ * to hold all of the ints.
+ * @param X an eight element array that will receive the x position
+ * @param Y an eight element array that will receive the y position
+ * @param Z an eight element array that will receive the z position
+ */
+ public void getHiResCoord(int[] X, int[] Y, int[] Z) {
+ X[0] = this.x[0];
+ X[1] = this.x[1];
+ X[2] = this.x[2];
+ X[3] = this.x[3];
+ X[4] = this.x[4];
+ X[5] = this.x[5];
+ X[6] = this.x[6];
+ X[7] = this.x[7];
+
+ Y[0] = this.y[0];
+ Y[1] = this.y[1];
+ Y[2] = this.y[2];
+ Y[3] = this.y[3];
+ Y[4] = this.y[4];
+ Y[5] = this.y[5];
+ Y[6] = this.y[6];
+ Y[7] = this.y[7];
+
+ Z[0] = this.z[0];
+ Z[1] = this.z[1];
+ Z[2] = this.z[2];
+ Z[3] = this.z[3];
+ Z[4] = this.z[4];
+ Z[5] = this.z[5];
+ Z[6] = this.z[6];
+ Z[7] = this.z[7];
+ }
+
+ /**
+ * Retrieves this HiResCoord's location and places it into the hires
+ * argument.
+ * @param hc the hires coordinate that will receive this node's location
+ */
+ public void getHiResCoord(HiResCoord hc) {
+ hc.x[0] = this.x[0];
+ hc.x[1] = this.x[1];
+ hc.x[2] = this.x[2];
+ hc.x[3] = this.x[3];
+ hc.x[4] = this.x[4];
+ hc.x[5] = this.x[5];
+ hc.x[6] = this.x[6];
+ hc.x[7] = this.x[7];
+
+ hc.y[0] = this.y[0];
+ hc.y[1] = this.y[1];
+ hc.y[2] = this.y[2];
+ hc.y[3] = this.y[3];
+ hc.y[4] = this.y[4];
+ hc.y[5] = this.y[5];
+ hc.y[6] = this.y[6];
+ hc.y[7] = this.y[7];
+
+ hc.z[0] = this.z[0];
+ hc.z[1] = this.z[1];
+ hc.z[2] = this.z[2];
+ hc.z[3] = this.z[3];
+ hc.z[4] = this.z[4];
+ hc.z[5] = this.z[5];
+ hc.z[6] = this.z[6];
+ hc.z[7] = this.z[7];
+ }
+
+ /**
+ * Retrieves this HiResCoord's X value and stores it in the specified
+ * array. The array must be large enough to hold all of the ints.
+ * @param X an eight-element array that will receive the x position
+ */
+ public void getHiResCoordX(int[] X) {
+ X[0] = this.x[0];
+ X[1] = this.x[1];
+ X[2] = this.x[2];
+ X[3] = this.x[3];
+ X[4] = this.x[4];
+ X[5] = this.x[5];
+ X[6] = this.x[6];
+ X[7] = this.x[7];
+ }
+
+ /**
+ * Retrieves this HiResCoord's Y value and stores it in the specified
+ * array. The array must be large enough to hold all of the ints.
+ * @param Y an eight-element array that will receive the y position
+ */
+ public void getHiResCoordY(int[] Y) {
+ Y[0] = this.y[0];
+ Y[1] = this.y[1];
+ Y[2] = this.y[2];
+ Y[3] = this.y[3];
+ Y[4] = this.y[4];
+ Y[5] = this.y[5];
+ Y[6] = this.y[6];
+ Y[7] = this.y[7];
+ }
+
+ /**
+ * Retrieves this HiResCoord's Z value and stores it in the specified
+ * array. The array must be large enough to hold all of the ints.
+ * @param Z an eight-element array that will receive the z position
+ */
+ public void getHiResCoordZ(int[] Z) {
+ Z[0] = this.z[0];
+ Z[1] = this.z[1];
+ Z[2] = this.z[2];
+ Z[3] = this.z[3];
+ Z[4] = this.z[4];
+ Z[5] = this.z[5];
+ Z[6] = this.z[6];
+ Z[7] = this.z[7];
+ }
+
+ /**
+ * Compares the specified HiResCoord to this HiResCoord.
+ * @param h1 the second HiResCoord
+ * @return true if equal, false if not equal
+ */
+ public boolean equals(HiResCoord h1) {
+ try {
+ return ((this.x[0] == h1.x[0])
+ && (this.x[1] == h1.x[1])
+ && (this.x[2] == h1.x[2])
+ && (this.x[3] == h1.x[3])
+ && (this.x[4] == h1.x[4])
+ && (this.x[5] == h1.x[5])
+ && (this.x[6] == h1.x[6])
+ && (this.x[7] == h1.x[7])
+ && (this.y[0] == h1.y[0])
+ && (this.y[1] == h1.y[1])
+ && (this.y[2] == h1.y[2])
+ && (this.y[3] == h1.y[3])
+ && (this.y[4] == h1.y[4])
+ && (this.y[5] == h1.y[5])
+ && (this.y[6] == h1.y[6])
+ && (this.y[7] == h1.y[7])
+ && (this.z[0] == h1.z[0])
+ && (this.z[1] == h1.z[1])
+ && (this.z[2] == h1.z[2])
+ && (this.z[3] == h1.z[3])
+ && (this.z[4] == h1.z[4])
+ && (this.z[5] == h1.z[5])
+ && (this.z[6] == h1.z[6])
+ && (this.z[7] == h1.z[7]));
+ }
+ catch (NullPointerException e2) {return false;}
+
+ }
+
+ /**
+ * Returns true if the Object o1 is of type HiResCoord and all of the
+ * data members of o1 are equal to the corresponding data members in
+ * this HiResCoord.
+ * @param o1 the second HiResCoord
+ * @return true if equal, false if not equal
+ */
+ public boolean equals(Object o1) {
+ try {
+ HiResCoord h1 = (HiResCoord)o1;
+ return ((this.x[0] == h1.x[0])
+ && (this.x[1] == h1.x[1])
+ && (this.x[2] == h1.x[2])
+ && (this.x[3] == h1.x[3])
+ && (this.x[4] == h1.x[4])
+ && (this.x[5] == h1.x[5])
+ && (this.x[6] == h1.x[6])
+ && (this.x[7] == h1.x[7])
+ && (this.y[0] == h1.y[0])
+ && (this.y[1] == h1.y[1])
+ && (this.y[2] == h1.y[2])
+ && (this.y[3] == h1.y[3])
+ && (this.y[4] == h1.y[4])
+ && (this.y[5] == h1.y[5])
+ && (this.y[6] == h1.y[6])
+ && (this.y[7] == h1.y[7])
+ && (this.z[0] == h1.z[0])
+ && (this.z[1] == h1.z[1])
+ && (this.z[2] == h1.z[2])
+ && (this.z[3] == h1.z[3])
+ && (this.z[4] == h1.z[4])
+ && (this.z[5] == h1.z[5])
+ && (this.z[6] == h1.z[6])
+ && (this.z[7] == h1.z[7]));
+ }
+ catch (NullPointerException e2) {return false;}
+ catch (ClassCastException e1) {return false;}
+
+
+ }
+ /**
+ * Adds two HiResCoords placing the results into this HiResCoord.
+ * @param h1 the first HiResCoord
+ * @param h2 the second HiResCoord
+ */
+ public void add(HiResCoord h1, HiResCoord h2) {
+ // needs to handle carry bits
+ // move to long, add, add in carry bit
+
+ hiResAdd( this, h1, h2 );
+
+ }
+
+ /**
+ * Subtracts two HiResCoords placing the results into this HiResCoord.
+ * @param h1 the first HiResCoord
+ * @param h2 the second HiResCoord
+ */
+ public void sub(HiResCoord h1, HiResCoord h2) {
+ HiResCoord tmpHc = new HiResCoord();
+
+ // negate via two's complement then add
+ //
+ hiResNegate( tmpHc, h2);
+ hiResAdd( this, h1, tmpHc);
+
+ }
+
+ /**
+ * Negates the specified HiResCoords and places the
+ * results into this HiResCoord.
+ * @param h1 the source HiResCoord
+ */
+ public void negate(HiResCoord h1) {
+
+ hiResNegate( this, h1);
+
+ }
+
+ /**
+ * Negates this HiResCoord
+ */
+ public void negate() {
+
+ hiResNegate( this, this );
+
+ }
+
+ /**
+ * Scales the specified HiResCoords by the specified value and
+ * places the results into this HiResCoord.
+ * @param scale the amount to scale the specified HiResCoord
+ * @param h1 the source HiResCoord
+ */
+ public void scale(int scale, HiResCoord h1) {
+ hiResScale( h1.x, this.x, scale);
+ hiResScale( h1.y, this.y, scale);
+ hiResScale( h1.z, this.z, scale);
+ }
+
+ /**
+ * Scales this HiResCoord by the specified value.
+ * @param scale the amount to scale the specified HiResCoord
+ */
+ public void scale(int scale) {
+ hiResScale( this.x, this.x, scale);
+ hiResScale( this.y, this.y, scale);
+ hiResScale( this.z, this.z, scale);
+ return;
+ }
+
+ /**
+ * Subtracts the specified HiResCoord from this HiResCoord
+ * placing the difference vector into the specified
+ * double-precision vector.
+ * @param h1 the HiResCoord to be subtracted from this
+ * @param v the vector that will receive the result
+ */
+ public void difference(HiResCoord h1, Vector3d v) {
+ // negate coord via two compliment, add, convert result to double
+ // by scaling each bit set appropriately
+
+ hiResDiff( this, h1, v);
+ return;
+ }
+
+ /**
+ * The floating point distance between the specified
+ * HiResCoord and this HiResCoord.
+ * @param h1 the second HiResCoord
+ */
+ public double distance(HiResCoord h1) {
+ Vector3d diff = new Vector3d();
+
+ hiResDiff( this, h1, diff);
+
+ return( Math.sqrt( diff.x*diff.x + diff.y*diff.y + diff.z*diff.z));
+ }
+
+ private void hiResNegate( HiResCoord ho, HiResCoord hi) {
+
+ negateCoord( ho.x, hi.x);
+ negateCoord( ho.y, hi.y);
+ negateCoord( ho.z, hi.z);
+
+ return;
+ }
+
+ private void negateCoord( int cout[], int cin[] ) {
+ int i;
+
+ for(i=0;i<8;i++) {
+ cout[i] = ~cin[i]; // take compliment of each
+ }
+
+ for(i=7;i>=0;i--) { // add one
+ if( cout[i] == 0xffffffff) {
+ cout[i] = 0;
+ } else {
+ cout[i] += 1;
+ break;
+ }
+ }
+ return;
+ }
+
+ private void hiResAdd(HiResCoord ho, HiResCoord h1, HiResCoord h2 ){
+ int i;
+ long tmp1, tmp2,carry;
+ long signMask = Integer.MAX_VALUE;
+ long signBit = 1;
+ signBit = signBit << 31;
+ long carryMask = 0x7fffffff;
+ carryMask = carryMask <<1;
+ carryMask += 1;
+
+
+ carry = 0;
+ for(i=7;i>0;i--) {
+ tmp1 = 0;
+ tmp1 = signMask & h1.x[i]; // mask off sign bit so will not get put in msb
+ if( h1.x[i] < 0 ) tmp1 |= signBit; // add sign bit back
+
+ tmp2 = 0;
+ tmp2 = signMask & h2.x[i]; // mask off sign bit so will not get put in msb
+ if( h2.x[i] < 0 ) tmp2 |= signBit; // add sign bit back
+
+ tmp2 = tmp2+tmp1 + carry;
+ carry = tmp2 >> 32; // get carry bits for next operation
+ ho.x[i] = (int)(tmp2 & carryMask); // mask off high bits
+ }
+ ho.x[0] = h1.x[0] + h2.x[0] + (int)carry;
+
+
+ carry = 0;
+ for(i=7;i>0;i--) {
+ tmp1 = 0;
+ tmp1 = signMask & h1.y[i]; // mask off sign bit so will not get put in msb
+ if( h1.y[i] < 0 ) tmp1 |= signBit; // add sign bit back
+
+ tmp2 = 0;
+ tmp2 = signMask & h2.y[i]; // mask off sign bit so will not get put in msb
+ if( h2.y[i] < 0 ) tmp2 |= signBit; // add sign bit back
+
+ tmp2 = tmp2+tmp1 + carry;
+ carry = tmp2 >> 32; // get carry bits for next operation
+ ho.y[i] = (int)(tmp2 & carryMask); // mask off high bits
+ }
+ ho.y[0] = h1.y[0] + h2.y[0] + (int)carry;
+
+ carry = 0;
+ for(i=7;i>0;i--) {
+ tmp1 = 0;
+ tmp1 = signMask & h1.z[i]; // mask off sign bit so will not get put in msb
+ if( h1.z[i] < 0 ) tmp1 |= signBit; // add sign bit back
+
+ tmp2 = 0;
+ tmp2 = signMask & h2.z[i]; // mask off sign bit so will not get put in msb
+ if( h2.z[i] < 0 ) tmp2 |= signBit; // add sign bit back
+
+ tmp2 = tmp2+tmp1 + carry;
+ carry = tmp2 >> 32; // get carry bits for next operation
+ ho.z[i] = (int)(tmp2 & carryMask); // mask off high bits
+ }
+ ho.z[0] = h1.z[0] + h2.z[0] + (int)carry;
+ return;
+ }
+
+ private void hiResScale( int tin[], int tout[], double scale) {
+ int i;
+ long tmp,carry;
+ int signMask = Integer.MAX_VALUE;
+ long carryMask = 0x7fffffff;
+ carryMask = carryMask <<1;
+ carryMask += 1;
+ long signBit = 1;
+ signBit = signBit << 31;
+
+ carry = 0;
+ for(i=7;i>0;i--) {
+ tmp = 0;
+ tmp = (long)(signMask & tin[i]); // mask off sign bit
+ if( tin[i] < 0 ) tmp |= signBit; // add sign bit back
+ tmp = (long)(tmp*scale + carry);
+ carry = tmp >> 32; // get carry bits for next operation
+ tout[i] = (int)(tmp & carryMask); // mask off high bits
+ }
+ tout[0] = (int)(tin[0]*scale + carry);
+ return;
+ }
+ private void hiResDiff( HiResCoord h1, HiResCoord h2, Vector3d diff) {
+ int i;
+ HiResCoord diffHi = new HiResCoord();
+ long value;
+ int coordSpace[] = new int[8];
+ int[] tempCoord;
+ int signMask = Integer.MAX_VALUE;
+ long signBit = 1;
+ signBit = signBit << 31;
+
+ // negate via two's complement then add
+ //
+ hiResNegate( diffHi, h2);
+ hiResAdd( diffHi, h1, diffHi);
+
+
+ if( diffHi.x[0] < 0 ) {
+ tempCoord = coordSpace;
+ negateCoord( tempCoord, diffHi.x );
+ } else {
+ tempCoord = diffHi.x;
+ }
+ diff.x = 0;
+ for(i=7;i>0;i--) {
+ value = (long)(tempCoord[i] & signMask);
+ if( tempCoord[i] < 0) value |= signBit;
+ diff.x += (double)(scales[i]*value);
+ }
+ diff.x += scales[0]*tempCoord[0];
+ if( diffHi.x[0] < 0 )diff.x = -diff.x;
+
+ if( diffHi.y[0] < 0 ) {
+ tempCoord = coordSpace;
+ negateCoord( tempCoord, diffHi.y );
+ } else {
+ tempCoord = diffHi.y;
+ }
+ diff.y = 0;
+ for(i=7;i>0;i--) {
+ value = (long)(tempCoord[i] & signMask);
+ if( tempCoord[i] < 0) value |= signBit;
+ diff.y += scales[i]*value;
+ }
+ diff.y += scales[0]*tempCoord[0];
+ if( diffHi.y[0] < 0 )diff.y = -diff.y;
+
+ if( diffHi.z[0] < 0 ) {
+ tempCoord = coordSpace;
+ negateCoord( tempCoord, diffHi.z );
+ } else {
+ tempCoord = diffHi.z;
+ }
+ diff.z = 0;
+ for(i=7;i>0;i--) {
+ value = (long)(tempCoord[i] & signMask);
+ if( tempCoord[i] < 0) value |= signBit;
+ diff.z += scales[i]*value;
+ }
+ diff.z += scales[0]*tempCoord[0];
+ if( diffHi.z[0] < 0 )diff.z = -diff.z;
+ return;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IllegalRenderingStateException.java b/j3d-core/src/classes/share/javax/media/j3d/IllegalRenderingStateException.java
new file mode 100644
index 0000000..a874796
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IllegalRenderingStateException.java
@@ -0,0 +1,54 @@
+/*
+ * $RCSfile: IllegalRenderingStateException.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Indicates an illegal state for rendering. This is typically some sort of
+ * resource or graphics device error encountered during rendering.
+ */
+public class IllegalRenderingStateException extends IllegalStateException {
+
+ /**
+ * Create the exception object with default values.
+ */
+ public IllegalRenderingStateException(){
+ }
+
+ /**
+ * Create the exception object that outputs message.
+ * @param str the message string to be output.
+ */
+ public IllegalRenderingStateException(String str){
+ super(str);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IllegalSceneGraphException.java b/j3d-core/src/classes/share/javax/media/j3d/IllegalSceneGraphException.java
new file mode 100644
index 0000000..a295d58
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IllegalSceneGraphException.java
@@ -0,0 +1,59 @@
+/*
+ * $RCSfile: IllegalSceneGraphException.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Indicates an illegal Java 3D scene graph.
+ * For example, the following is illegal:
+ *
+ * Image data may be passed to this ImageComponent object in
+ * one of two ways: by copying the image data into this object or by
+ * accessing the image data by reference.
+ *
+ *
+ *
+ * An image component object also specifies whether the orientation of
+ * its image data is "y-up" or "y-down" (the default). Y-up mode
+ * causes images to be interpreted as having their origin at the lower
+ * left (rather than the default upper left) of a texture or raster
+ * image with successive scan lines moving up. This is more
+ * consistent with texture mapping data onto a surface, and maps
+ * directly into the the way textures are used in OpenGL and other 3D
+ * APIs. Setting the
+ * Note that all color fields are treated as unsigned values, even though
+ * Java does not directly support unsigned variables. This means, for
+ * example, that an ImageComponent using a format of FORMAT_RGB5 can
+ * represent red, green, and blue values between 0 and 31, while an
+ * ImageComponent using a format of FORMAT_RGB8 can represent color
+ * values between 0 and 255. Even when byte values are used to create a
+ * RenderedImage with 8-bit color components, the resulting colors
+ * (bytes) are interpreted as if they were unsigned.
+ * Values greater than 127 can be assigned to a byte variable using a
+ * type cast. For example:
+ *
+ *
+ * // Set the image to the specified BufferedImage
+ * // Set the image to the specified RenderedImage
+ * As of Java 3D 1.5, an ImageComponent2D accepts an NioImageBuffer object
+ * as an alternative to a RenderedImage.
+ */
+
+public class ImageComponent2D extends ImageComponent {
+
+ // non-public, no parameter constructor
+ ImageComponent2D() {}
+
+ /**
+ * Constructs a 2D image component object using the specified
+ * format, width, and height. Default values are used for
+ * all other parameters. The default values are as follows:
+ *
+ * The image class is set to ImageClass.BUFFERED_IMAGE.
+ *
+ * @param image BufferedImage object containing the image.
+ * Its size must be the same as the current size of this
+ * ImageComponent2D object.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalArgumentException if the width and height of the
+ * specified image is not equal to the width and height of this
+ * ImageComponent object.
+ */
+ public void set(BufferedImage image) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_IMAGE_WRITE))
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("ImageComponent2D1"));
+ }
+
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Sets this image component to the specified RenderedImage
+ * object. If the data access mode is not by-reference, the
+ * RenderedImage data is copied into this object. If
+ * the data access mode is by-reference, a reference to the
+ * RenderedImage is saved, but the data is not necessarily
+ * copied.
+ *
+ * The image class is set to ImageClass.RENDERED_IMAGE if the the
+ * data access mode is by-reference and the specified
+ * RenderedImage is not an instance of BufferedImage. In all
+ * other cases, the image class is set to ImageClass.BUFFERED_IMAGE.
+ *
+ * @param image RenderedImage object containing the image.
+ * Its size must be the same as the current size of this
+ * ImageComponent2D object.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalArgumentException if the width and height of the
+ * specified image is not equal to the width and height of this
+ * ImageComponent object.
+ *
+ * @since Java 3D 1.2
+ */
+ public void set(RenderedImage image) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_IMAGE_WRITE))
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("ImageComponent2D1"));
+ }
+
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Sets this image component to the specified NioImageBuffer
+ * object. If the data access mode is not by-reference, the
+ * NioImageBuffer data is copied into this object. If
+ * the data access mode is by-reference, a reference to the
+ * NioImageBuffer is saved, but the data is not necessarily
+ * copied.
+ *
+ * The image class is set to ImageClass.NIO_IMAGE_BUFFER.
+ *
+ * @param image NioImageBuffer object containing the image.
+ * Its size must be the same as the current size of this
+ * ImageComponent2D object.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if this ImageComponent object
+ * is not yUp.
+ *
+ * @exception IllegalArgumentException if the width and height of the
+ * specified image is not equal to the width and height of this
+ * ImageComponent object.
+ *
+ * @exception IllegalArgumentException if the number of components in format
+ * does not match the number of components in image.
+ *
+ * @since Java 3D 1.5
+ */
+ public void set(NioImageBuffer image) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_IMAGE_WRITE)) {
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("ImageComponent2D1"));
+ }
+ }
+
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Retrieves the image from this ImageComponent2D object. If the
+ * data access mode is not by-reference, a copy of the image
+ * is made. If the data access mode is by-reference, the
+ * reference is returned.
+ *
+ * @return either a new BufferedImage object created from the data
+ * in this image component, or the BufferedImage object referenced
+ * by this image component.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the image class is not
+ * ImageClass.BUFFERED_IMAGE.
+ */
+ public BufferedImage getImage() {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ImageComponent.ALLOW_IMAGE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ImageComponent2D0"));
+ }
+
+ RenderedImage img = ((ImageComponent2DRetained)this.retained).getImage();
+
+ if ((img != null) && !(img instanceof BufferedImage)) {
+ throw new IllegalStateException(J3dI18N.getString("ImageComponent2D5"));
+ }
+ return (BufferedImage) img;
+
+ }
+
+ /**
+ * Retrieves the image from this ImageComponent2D object. If the
+ * data access mode is not by-reference, a copy of the image
+ * is made. If the data access mode is by-reference, the
+ * reference is returned.
+ *
+ * @return either a new RenderedImage object created from the data
+ * in this image component, or the RenderedImage object referenced
+ * by this image component.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the image class is not one of:
+ * ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.
+ *
+ * @since Java 3D 1.2
+ */
+ public RenderedImage getRenderedImage() {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ImageComponent.ALLOW_IMAGE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ImageComponent2D0"));
+ return ((ImageComponent2DRetained)this.retained).getImage();
+ }
+
+ /**
+ * Retrieves the image from this ImageComponent2D object. If the
+ * data access mode is not by-reference, a copy of the image
+ * is made. If the data access mode is by-reference, the
+ * reference is returned.
+ *
+ * @return either a new NioImageBuffer object created from the data
+ * in this image component, or the NioImageBuffer object referenced
+ * by this image component.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the image class is not
+ * ImageClass.NIO_IMAGE_BUFFER.
+ *
+ * @since Java 3D 1.5
+ */
+ public NioImageBuffer getNioImage() {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ImageComponent.ALLOW_IMAGE_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("ImageComponent2D0"));
+ }
+ }
+ return ((ImageComponent2DRetained)this.retained).getNioImage();
+
+ }
+
+
+ /**
+ * Modifies a contiguous subregion of the image component.
+ * Block of data of dimension (width * height)
+ * starting at the offset (srcX, srcY) of the specified
+ * RenderedImage object will be copied into the image component
+ * starting at the offset (dstX, dstY) of the ImageComponent2D object.
+ * The specified RenderedImage object must be of the same format as
+ * the current RenderedImage object in this image component.
+ * This method can only be used if the data access mode is
+ * by-copy. If it is by-reference, see updateData().
+ *
+ * @param image RenderedImage object containing the subimage.
+ * @param width width of the subregion.
+ * @param height height of the subregion.
+ * @param srcX starting X offset of the subregion in the
+ * specified image.
+ * @param srcY starting Y offset of the subregion in the
+ * specified image.
+ * @param dstX starting X offset of the subregion in the image
+ * component of this object.
+ * @param dstY starting Y offset of the subregion in the image
+ * component of this object.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data access mode is
+ *
+ * The data to be modified has to be within the boundary of the
+ * subregion
+ * specified by the offset (x, y) and the dimension (width*height).
+ * It is illegal to modify data outside this boundary.
+ * If any referenced data is modified outisde the updateData
+ * method, or any data outside the specified boundary is modified,
+ * the results are undefined.
+ *
+ * @param updater object whose updateData callback method will be
+ * called to update the data referenced by this ImageComponent2D object.
+ * @param x starting X offset of the subregion.
+ * @param y starting Y offset of the subregion.
+ * @param width width of the subregion.
+ * @param height height of the subregion.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability
+ * is not set, and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data access mode is
+ *
+ *
+ * // Set image 0 to the specified BufferedImage
+ * // Set image 0 to the specified RenderedImage
+ * The data to be modified has to be within the boundary of the
+ * subregion
+ * specified by the offset (x, y) and the dimension (width*height).
+ * It is illegal to modify data outside this boundary. If any
+ * referenced data is modified outside the updateData method, or
+ * any data outside the specified boundary is modified, the
+ * results are undefined.
+ *
+ * @param updater object whose updateData callback method will be
+ * called to update the data referenced by this ImageComponent3D object.
+ * @param index index of the image to be modified.
+ * The index must be less than the depth of this ImageComponent3D object.
+ * @param x starting X offset of the subregion.
+ * @param y starting Y offset of the subregion.
+ * @param width width of the subregion.
+ * @param height height of the subregion.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception IllegalStateException if the data access mode is
+ *
+ * Use the following code to iterate through an array.
+ *
+ *
+ * Note:
+ *
+ * Limitation:
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * An application obtains a J3D 2D graphics context object from the
+ * Canvas3D object that the application wishes to render into by using
+ * the getGraphics2D method. A new J3DGraphics2D object is created if
+ * one does not already exist.
+ *
+ *
+ * Note that the drawing methods in this class, including those
+ * inherited from Graphics2D, are not necessarily executed
+ * immediately. They may be buffered up for future execution.
+ * Applications must call the
+ * A single-buffered, pure-immediate mode application must explicitly
+ * call flush to ensure that the graphics will be rendered to the
+ * Canvas3D.
+ *
+ * @see Canvas3D#getGraphics2D
+ *
+ * @since Java 3D 1.2
+ */
+
+public abstract class J3DGraphics2D extends Graphics2D {
+
+ // Package scope contructor
+ J3DGraphics2D() {
+ }
+
+ /**
+ * This method is not supported. The only way to obtain a
+ * J3DGraphics2D is from the associated Canvas3D.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @see Canvas3D#getGraphics2D
+ */
+ public final Graphics create() {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported. The only way to obtain a
+ * J3DGraphics2D is from the associated Canvas3D.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @see Canvas3D#getGraphics2D
+ */
+ public final Graphics create(int x, int y, int width, int height) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported. Clearing a Canvas3D is done implicitly
+ * via a Background node in the scene graph or explicitly via the clear
+ * method in a 3D graphics context.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @see Background
+ * @see GraphicsContext3D#setBackground
+ * @see GraphicsContext3D#clear
+ */
+ public final void setBackground(Color color) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported. Clearing a Canvas3D is done implicitly
+ * via a Background node in the scene graph or explicitly via the clear
+ * method in a 3D graphics context.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @see Background
+ * @see GraphicsContext3D#getBackground
+ * @see GraphicsContext3D#clear
+ */
+ public final Color getBackground() {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported. Clearing a Canvas3D is done implicitly
+ * via a Background node in the scene graph or explicitly via the clear
+ * method in a 3D graphics context.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @see Background
+ * @see GraphicsContext3D#setBackground
+ * @see GraphicsContext3D#clear
+ */
+ public final void clearRect(int x, int y, int width, int height) {
+ throw new UnsupportedOperationException();
+ }
+
+
+ /**
+ * Flushes all previously executed rendering operations to the
+ * drawing buffer for this 2D graphics object.
+ *
+ * @param wait flag indicating whether or not to wait for the
+ * rendering to be complete before returning from this call.
+ */
+ public abstract void flush(boolean wait);
+
+ /**
+ * Draws the specified image and flushes the buffer. This is
+ * functionally equivalent to calling
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ * NOTE: Applications should not extend this class directly.
+ */
+
+public abstract class Leaf extends Node {
+
+ /**
+ * Construct and initialize the Leaf object.
+ */
+ public Leaf(){
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LeafRetained.java b/j3d-core/src/classes/share/javax/media/j3d/LeafRetained.java
new file mode 100644
index 0000000..e1d2f85
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LeafRetained.java
@@ -0,0 +1,67 @@
+/*
+ * $RCSfile: LeafRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+import java.util.Hashtable;
+
+import java.util.ArrayList;
+
+/**
+ * LeafRetained node.
+ */
+abstract class LeafRetained extends NodeRetained {
+
+ SwitchState switchState = null;
+
+ // temporary variable used during bounds computation, since
+ // multiple mirror shapes could be pointing to the same shape3D
+ boolean boundsDirty = false;
+
+ // Appicable only to the mirror object
+ void updateBoundingLeaf() {
+
+ }
+ protected Object clone(boolean forceDuplicate) {
+ return super.clone();
+ }
+
+ void updateMirrorObject(Object[] args) {
+ }
+
+ void updateTransformChange() {
+ }
+
+ void updateBounds() {
+ }
+
+ void getMirrorObjects(ArrayList l, HashKey k) {
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Light.java b/j3d-core/src/classes/share/javax/media/j3d/Light.java
new file mode 100644
index 0000000..474e29d
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Light.java
@@ -0,0 +1,731 @@
+/*
+ * $RCSfile: Light.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+import java.util.Enumeration;
+
+/**
+ * The Light leaf node is an abstract class that defines a set of
+ * parameters common to all
+ * types of light. These parameters include the light color, an enable
+ * flag, and a region of influence in which this Light node is active.
+ * A Light node also contains a list of Group nodes that specifies the
+ * hierarchical scope of this Light. If the scope list is empty,
+ * the Light node has universe scope: all nodes within the region of
+ * influence are affected by this Light node. If the scope list is
+ * non-empty, only those Leaf nodes under the Group nodes in the
+ * scope list are affected by this Light node (subject to the
+ * influencing bounds).
+ *
+ * The light in a scene may come from several light sources that can
+ * be individually defined. Some of the light in a scene may
+ * come from a specific direction, known as a directional light,
+ * from a specific position, known as a point light, or
+ * from no particular direction or source as with ambient light.
+ *
+ * Java 3D supports an arbitrary number of lights. However, the number
+ * of lights that can be active within the region of influence is
+ * implementation-dependent and cannot be defined here.
+ *
+ * Light Color
+ *
+ * The Java 3D lighting model approximates the way light works in
+ * the real world. Light is defined in terms of the red, green, and
+ * blue components that combine to create the light color. The
+ * three color components represent the amount of light emitted
+ * by the source.
+ *
+ * Each of the three colors is represented by a
+ * floating point value that ranges from 0.0 to 1.0. A combination
+ * of the three colors such as (1.0, 1.0, 1.0), representing
+ * the red, green, and blue color values respectively, creates a white
+ * light with maximum brightness. A combination such as (0.0, 0.0,
+ * 0.0) creates no light (black). Values between the minimum and
+ * maximum values of the range produce corresponding brightness
+ * and colors. For example, a combination of (0.5, 0.5, 0.5)
+ * produces a 50% grey light. A combination of (1.0, 1.0, 0.0),
+ * red and green but no blue, produces a yellow light.
+ *
+ * If a scene has multiple lights and all lights illuminate an object,
+ * the effect of the light on the object is the sum of the
+ * lights. For example, in a scene with two lights, if the first
+ * light emits (R1, G1, B1) and
+ * the second light emits (R2, G2,
+ * B2), the components are added together giving
+ * (R1+R2, G1+G2,
+ * B1+B2).
+ * If the sums of any of the color values is greater than 1.0,
+ * brighter than the maximum brightness permitted, the color value is
+ * clamped to 1.0.
+ *
+ * Material Colors
+ *
+ * In the Java 3D lighting model, the light sources have an effect
+ * on the scene only when there are object surfaces to absorb or
+ * reflect the light. Java 3D approximates an object's color
+ * by calculating the percentage of red, green, and blue light
+ * the object reflects. An object with a surface color of pure green
+ * absorbs all of the red and blue light that strikes it and
+ * reflects all of the green light. Viewing the object in a
+ * white light, the green color is reflected and you see a green
+ * object. However, if the green object is viewed in a red light,
+ * all of the red light is absorbed and the object appears black.
+ *
+ * The surface of each object in the scene has
+ * certain material properties that define how light affects its
+ * appearance. The object might reflect light in various ways,
+ * depending on the object's surface type. The object
+ * might even emit its own light. The Java 3D lighting model specifies
+ * these material properties as five independent components: emitted
+ * color, ambient color, diffuse color, specular color, and shininess.
+ * All of these properties are computed independently, then added
+ * together to define how the surface of the object appears under
+ * light (an exception is Ambient light, which does not contribute
+ * to specular reflection). The material properties are defined
+ * in the Material class.
+ *
+ * Influencing Bounds
+ *
+ * Since a scene may be quite large, as large as the universe for
+ * example, it is often reasonable to limit the influence of lighting
+ * to a region that is within viewing range. There is no reason
+ * to waste all that computing power on illuminating objects that
+ * are too far away to be viewed. In Java 3D, the influencing bounds
+ * is defined by a Bounds object or a BoundingLeaf object. It should
+ * be noted that a BoundingLeaf object overrides a Bounds object,
+ * should both objects be set.
+ *
+ * A Bounds object represents a convex, closed volume. Bounds
+ * defines three different types of containing
+ * volumes: an axis-aligned-box volume, a spherical volume, and a
+ * bounding polytope. A BoundingLeaf object also specifies a region
+ * of influence, but allows an application to specify a bounding
+ * region in one coordinate system (the local coordinate system of
+ * the BoundingLeaf node) other than the local coordinate
+ * system of the node that references the bounds (the Light).
+ *
+ * Limiting the Scope
+ *
+ * In addition to limiting the lighting calculations to a given
+ * region of a scene, lighting can also be limited to groups of
+ * nodes, defined by a Group object. This is known as "scoping."
+ * All nodes attached to a Group node define a list of scopes.
+ * Methods in the Light class permit the setting, addition, insertion,
+ * removal, and enumeration of nodes in the list of scopes.
+ *
+ * Two-sided Lighting of Polygons
+ *
+ * Java 3D performs lighting calculations for all polygons, whether
+ * they are front-facing or back-facing. Since most polygon objects
+ * are constructed with the front face in mind, the back-facing
+ * portion may not be correctly illuminated. For example, a sphere
+ * with part of the face cut away so you can see its inside.
+ * You might want to have the inside surface lit as well as the
+ * outside surface and you mught also want to define a different
+ * Material description to reduce shininess, specular color, etc.
+ *
+ * For more information, see the "Face culling" and "Back-facing
+ * normal flip" descriptions in the PolygonAttributes class
+ * description.
+ *
+ * Turning on the Lights
+ *
+ * Lighting needs to be explicitly enabled with the setEnable method
+ * or with the lightOn parameter in the constructor
+ * before any of the child light sources have any effect on illuminating
+ * the scene. The child lights may also be enabled or disabled individually.
+ *
+ * If lighting is not enabled, the current color of an
+ * object in the scene is simply mapped onto the object, and none of
+ * the lighting equations regarding Material properties, such as ambient
+ * color, diffuse color, specular color, and shininess, are performed.
+ * However, an object's emitted color, if specified and enabled, will
+ * still affect that object's appearance.
+ *
+ * To disable lighting, call setEnable with
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * If antialiasing is enabled, the lines are considered transparent
+ * for rendering purposes. They are rendered with all the other transparent
+ * objects and adhere to the other transparency settings such as the
+ * View transparency sorting policy and the View depth buffer freeze
+ * transparent enable.
+ *
+ *
+ * User-defined Line Patterns
+ *
+ * A user-defined line pattern is specified with a pattern mask and
+ * an optional scale factor.
+ *
+ * The Pattern Mask
+ *
+ * The pattern is specified
+ * using a 16-bit mask that specifies on and off segments. Bit 0 in
+ * the pattern mask corresponds to the first pixel of the line or line
+ * strip primitive. A value of 1 for a bit in the pattern mask indicates
+ * that the corresponding pixel is drawn, while a value of 0
+ * indicates that the corresponding pixel is not drawn. After all 16 bits
+ * in the pattern are used, the pattern is repeated.
+ *
+ * For example, a mask of 0x00ff defines a dashed line with a repeating
+ * pattern of 8 pixels on followed by 8 pixels off. A value of 0x0101
+ * defines a a dotted line with a repeating pattern of 1 pixel on and 7
+ * pixels off.
+ *
+ * The pattern continues around individual line segments of a line strip
+ * primitive. It is restarted at the beginning of each new line strip.
+ * For line array primitives, the pattern is restarted at the beginning
+ * of each line.
+ *
+ * The Scale Factor
+ *
+ * The pattern is multiplied by the scale factor such that each bit in
+ * the pattern mask corresponds to that many consecutive pixels.
+ * For example, a scale factor of 3 applied to a pattern mask of 0x001f
+ * would produce a repeating pattern of 15 pixels on followed by 33
+ * pixels off. The valid range for this attribute is [1,15]. Values
+ * outside this range are clamped.
+ *
+ * @see Appearance
+ * @see View
+ */
+public class LineAttributes extends NodeComponent {
+
+ /**
+ * Specifies that this LineAttributes object allows reading its
+ * line width information.
+ */
+ public static final int
+ ALLOW_WIDTH_READ = CapabilityBits.LINE_ATTRIBUTES_ALLOW_WIDTH_READ;
+
+ /**
+ * Specifies that this LineAttributes object allows writing its
+ * line width information.
+ */
+ public static final int
+ ALLOW_WIDTH_WRITE = CapabilityBits.LINE_ATTRIBUTES_ALLOW_WIDTH_WRITE;
+
+ /**
+ * Specifies that this LineAttributes object allows reading its
+ * line pattern information.
+ */
+ public static final int
+ ALLOW_PATTERN_READ = CapabilityBits.LINE_ATTRIBUTES_ALLOW_PATTERN_READ;
+
+ /**
+ * Specifies that this LineAttributes object allows writing its
+ * line pattern information.
+ */
+ public static final int
+ ALLOW_PATTERN_WRITE = CapabilityBits.LINE_ATTRIBUTES_ALLOW_PATTERN_WRITE;
+
+ /**
+ * Specifies that this LineAttributes object allows reading its
+ * line antialiasing flag.
+ */
+ public static final int
+ ALLOW_ANTIALIASING_READ = CapabilityBits.LINE_ATTRIBUTES_ALLOW_ANTIALIASING_READ;
+
+ /**
+ * Specifies that this LineAttributes object allows writing its
+ * line antialiasing flag.
+ */
+ public static final int
+ ALLOW_ANTIALIASING_WRITE = CapabilityBits.LINE_ATTRIBUTES_ALLOW_ANTIALIASING_WRITE;
+
+
+ /**
+ * Draw solid lines with no pattern.
+ * @see #setLinePattern
+ */
+ public static final int PATTERN_SOLID = 0;
+
+ /**
+ * Draw dashed lines. Ideally, these will be drawn with
+ * a repeating pattern of 8 pixels on and 8 pixels off.
+ * @see #setLinePattern
+ */
+ public static final int PATTERN_DASH = 1;
+
+ /**
+ * Draw dotted lines. Ideally, these will be drawn with
+ * a repeating pattern of 1 pixel on and 7 pixels off.
+ * @see #setLinePattern
+ */
+ public static final int PATTERN_DOT = 2;
+
+ /**
+ * Draw dashed-dotted lines. Ideally, these will be drawn with
+ * a repeating pattern of 7 pixels on, 4 pixels off, 1 pixel on,
+ * and 4 pixels off.
+ * @see #setLinePattern
+ */
+ public static final int PATTERN_DASH_DOT = 3;
+
+ /**
+ * Draw lines with a user-defined line pattern. The line pattern
+ * is specified with a pattern mask and scale factor.
+ * @see #setLinePattern
+ * @see #setPatternMask
+ * @see #setPatternScaleFactor
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int PATTERN_USER_DEFINED = 4;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_ANTIALIASING_READ,
+ ALLOW_PATTERN_READ,
+ ALLOW_WIDTH_READ
+ };
+
+ /**
+ * Constructs a LineAttributes object with default parameters.
+ * The default values are as follows:
+ *
+ * The pattern continues around individual line segments of a line
+ * strip primitive. It is restarted at the beginning of each new
+ * line strip. For line array primitives, the pattern is
+ * restarted at the beginning of each line.
+ * @param mask the new line pattern mask
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @see #setPatternScaleFactor
+ *
+ * @since Java 3D 1.2
+ */
+ public void setPatternMask(int mask) {
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_PATTERN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes8"));
+
+ if (isLive())
+ ((LineAttributesRetained)this.retained).setPatternMask(mask);
+ else
+ ((LineAttributesRetained)this.retained).initPatternMask(mask);
+ }
+
+
+ /**
+ * Retrieves the line pattern mask.
+ * @return the line pattern mask
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getPatternMask() {
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_PATTERN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes9"));
+
+ return ((LineAttributesRetained)this.retained).getPatternMask();
+ }
+
+
+ /**
+ * Sets the line pattern scale factor to the specified value.
+ * This is used in conjunction with the patternMask when the
+ * linePattern attribute is set to PATTERN_USER_DEFINED. The
+ * pattern is multiplied by the scale factor such that each bit in
+ * the pattern mask corresponds to that many consecutive pixels.
+ * For example, a scale factor of 3 applied to a pattern mask of
+ * 0x001f would produce a repeating pattern of 15 pixels on
+ * followed by 33 pixels off. The valid range for this attribute
+ * is [1,15]. Values outside this range are clamped.
+ * @param scaleFactor the new line pattern scale factor
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @see #setPatternMask
+ *
+ * @since Java 3D 1.2
+ */
+ public void setPatternScaleFactor(int scaleFactor) {
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_PATTERN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes10"));
+
+ if (isLive())
+ ((LineAttributesRetained)this.retained).setPatternScaleFactor(scaleFactor);
+ else
+ ((LineAttributesRetained)this.retained).initPatternScaleFactor(scaleFactor);
+ }
+
+
+ /**
+ * Retrieves the line pattern scale factor.
+ * @return the line pattern scale factor
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getPatternScaleFactor() {
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_PATTERN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes11"));
+
+ return ((LineAttributesRetained)this.retained).getPatternScaleFactor();
+ }
+
+
+ /**
+ * Enables or disables line antialiasing
+ * for this LineAttributes component object.
+ *
+ * If antialiasing is enabled, the lines are considered transparent
+ * for rendering purposes. They are rendered with all the other
+ * transparent objects and adhere to the other transparency settings
+ * such as the View transparency sorting policy and the View depth buffer
+ * freeze transparent enable.
+ *
+ * The front and back fog distances are defined in the local coordinate system of
+ * the node, but the actual fog equation will ideally take place in eye
+ * coordinates.
+ *
+ * The linear fog blending factor,
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * A Locale object defines methods to set and get its high-resolution
+ * coordinates, and methods to add, remove, and enumerate the branch
+ * graphs.
+ *
+ *
+ * For more information, see the
+ * Introduction to the Java 3D API and
+ * Scene Graph Superstructure
+ * documents.
+ *
+ * @see VirtualUniverse
+ * @see HiResCoord
+ * @see BranchGroup
+ */
+
+public class Locale extends Object {
+
+ /**
+ * The virtual universe that this Locale object is contained within.
+ */
+ VirtualUniverse universe;
+
+ /**
+ * The high resolution coordinate associated with this Locale object.
+ */
+ HiResCoord hiRes;
+
+ /**
+ * List of BranchGroup objects included in this Locale
+ */
+ Vector branchGroups = new Vector();
+
+ // locale's identifier
+ String nodeId = null;
+
+ /**
+ * Constructs and initializes a new high resolution Locale object
+ * located at (0, 0, 0).
+ * @param universe the virtual universe that will contain this
+ * Locale object
+ */
+ public Locale(VirtualUniverse universe) {
+ this.universe = universe;
+ this.universe.addLocale(this);
+ this.hiRes = new HiResCoord();
+ nodeId = universe.getNodeId();
+ }
+
+ /**
+ * Constructs and initializes a new high resolution Locale object
+ * from the parameters provided.
+ * @param universe the virtual universe that will contain this
+ * Locale object
+ * @param x an eight element array specifying the x position
+ * @param y an eight element array specifying the y position
+ * @param z an eight element array specifying the z position
+ */
+ public Locale(VirtualUniverse universe, int[] x, int[] y, int[] z) {
+ this.universe = universe;
+ this.universe.addLocale(this);
+ this.hiRes = new HiResCoord(x, y, z);
+ nodeId = universe.getNodeId();
+ }
+
+ /**
+ * Constructs and initializes a new high resolution Locale object
+ * at the location specified by the HiResCoord argument.
+ * @param universe the virtual universe that will contain this
+ * Locale object
+ * @param hiRes the HiRes coordinate to use in creating this Locale
+ */
+ public Locale(VirtualUniverse universe, HiResCoord hiRes) {
+ this.universe = universe;
+ this.universe.addLocale(this);
+ this.hiRes = new HiResCoord(hiRes);
+ nodeId = universe.getNodeId();
+ }
+
+ /**
+ * Retrieves the virtual universe within which this Locale object
+ * is contained. A null reference indicates that this
+ * Locale has been removed from its VirtualUniverse.
+ * @return the virtual universe within which this Locale object
+ * is contained.
+ */
+ public VirtualUniverse getVirtualUniverse() {
+ return universe;
+ }
+
+ /**
+ * Sets the HiRes coordinate of this Locale to the location
+ * specified by the parameters provided.
+ * @param x an eight element array specifying the x position
+ * @param y an eight element array specifying the y position
+ * @param z an eight element array specifying the z position
+ */
+ public void setHiRes(int[] x, int[] y, int[] z) {
+ this.hiRes.setHiResCoord(x, y, z);
+ }
+
+ /**
+ * Sets the HiRes coordinate of this Locale
+ * to the location specified by the HiRes argument.
+ * @param hiRes the HiRes coordinate specifying this node's new location
+ */
+ public void setHiRes(HiResCoord hiRes) {
+ this.hiRes.setHiResCoord(hiRes);
+ }
+
+ /**
+ * Returns this node's HiResCoord.
+ * @param hiRes a HiResCoord object that will receive the
+ * HiRes coordinate of this Locale node
+ */
+ public void getHiRes(HiResCoord hiRes) {
+ this.hiRes.getHiResCoord(hiRes);
+ }
+
+ /**
+ * Add a new branch graph rooted at BranchGroup to
+ * the list of branch graphs.
+ * @param branchGroup root of the branch graph to be added
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ * @exception MultipleParentException if the specified BranchGroup node
+ * is already live.
+ */
+ public void addBranchGraph(BranchGroup branchGroup){
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ // if the BranchGroup already has a parent, or has already been
+ // added to a locale, throw MultipleParentException
+ if ((((BranchGroupRetained)branchGroup.retained).parent != null) ||
+ (branchGroup.isLive())) {
+ throw new MultipleParentException(J3dI18N.getString("Locale0"));
+ }
+
+ universe.notifyStructureChangeListeners(true, this, branchGroup);
+ universe.resetWaitMCFlag();
+ synchronized (universe.sceneGraphLock) {
+ doAddBranchGraph(branchGroup);
+ universe.setLiveState.reset(this);
+ }
+ universe.waitForMC();
+ }
+
+ // The method that does the work once the lock is acquired.
+ void doAddBranchGraph(BranchGroup branchGroup) {
+ BranchGroupRetained bgr = (BranchGroupRetained)branchGroup.retained;
+ J3dMessage createMessage;
+ SetLiveState s = universe.setLiveState;
+
+ // bgr.setLocale(this);
+
+ // addElement needs to precede setLive or else any liveness checks
+ // in the initialize() call of a user behavior (ie, calling collision
+ // or picking constructor with a SceneGraphPath) will fail
+ // when SceneGraphPath.validate() attempts to verify that
+ // the proper Locale is associated with that SceneGraphPath
+ bgr.attachedToLocale = true;
+ branchGroups.addElement(branchGroup);
+ s.reset(this);
+ s.currentTransforms[0] = new Transform3D[2];
+ s.currentTransforms[0][0] = new Transform3D();
+ s.currentTransforms[0][1] = new Transform3D();
+ s.currentTransformsIndex[0] = new int[2];
+ s.currentTransformsIndex[0][0] = 0;
+ s.currentTransformsIndex[0][1] = 0;
+
+ s.localToVworld = s.currentTransforms;
+ s.localToVworldIndex = s.currentTransformsIndex;
+
+ s.branchGroupPaths = new ArrayList();
+ s.branchGroupPaths.add(new BranchGroupRetained[0]);
+
+ s.orderedPaths = new ArrayList(1);
+ s.orderedPaths.add(new OrderedPath());
+
+ s.switchStates = new ArrayList(1);
+ s.switchStates.add(new SwitchState(false));
+
+ bgr.setLive(s);
+
+ createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDER| J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.type = J3dMessage.ORDERED_GROUP_INSERTED;
+ createMessage.universe = universe;
+ createMessage.args[0] = s.ogList.toArray();
+ createMessage.args[1] = s.ogChildIdList.toArray();
+ createMessage.args[2] = s.ogOrderedIdList.toArray();
+ createMessage.args[3] = s.ogCIOList.toArray();
+ createMessage.args[4] = s.ogCIOTableList.toArray();
+
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.type = J3dMessage.VIEWSPECIFICGROUP_INIT;
+ createMessage.universe = universe;
+ createMessage.args[0] = s.changedViewGroup;
+ createMessage.args[1] = s.changedViewList;
+ createMessage.args[2] = s.keyList;
+ VirtualUniverse.mc.processMessage(createMessage);
+
+
+ createMessage = new J3dMessage();
+ createMessage.threads = s.notifyThreads;
+ createMessage.type = J3dMessage.INSERT_NODES;
+ createMessage.universe = universe;
+ createMessage.args[0] = s.nodeList.toArray();
+ createMessage.args[1] = null;
+ createMessage.args[2] = null;
+ if (s.viewScopedNodeList != null) {
+ createMessage.args[3] = s.viewScopedNodeList;
+ createMessage.args[4] = s.scopedNodesViewList;
+ }
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ int sz = s.behaviorNodes.size();
+ for (int i=0; i< sz; i++) {
+ BehaviorRetained b;
+ b = (BehaviorRetained)s.behaviorNodes.get(i);
+ b.executeInitialize();
+ }
+
+ createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_BEHAVIOR;
+ createMessage.type = J3dMessage.BEHAVIOR_ACTIVATE;
+ createMessage.universe = universe;
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ // Free up memory.
+ s.reset(null);
+ }
+
+ /**
+ * Removes a branch graph rooted at BranchGroup from
+ * the list of branch graphs.
+ * @param branchGroup root of the branch graph to be removed
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ * @exception CapabilityNotSetException if the ALLOW_DETACH capability is
+ * not set in the specified BranchGroup node.
+ */
+ public void removeBranchGraph(BranchGroup branchGroup){
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ if (! branchGroup.getCapability(BranchGroup.ALLOW_DETACH)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Locale1"));
+ }
+ universe.resetWaitMCFlag();
+ synchronized (universe.sceneGraphLock) {
+ doRemoveBranchGraph(branchGroup, null, 0);
+ universe.setLiveState.reset(this);
+ }
+ universe.waitForMC();
+ }
+
+
+ // Method to remove all branch graphs from this Locale and remove
+ // this Locale from the VirtualUniverse
+ void removeFromUniverse() {
+ if (branchGroups.size() > 0) {
+ universe.resetWaitMCFlag();
+ synchronized (universe.sceneGraphLock) {
+ // Make a copy of the branchGroups list so that we can safely
+ // iterate over it.
+ Object[] bg = branchGroups.toArray();
+ for (int i = 0; i < bg.length; i++) {
+ doRemoveBranchGraph((BranchGroup)bg[i], null, 0);
+ }
+ }
+ // Put after sceneGraphLock to prevent deadlock
+ universe.waitForMC();
+ }
+
+ // free nodeId
+ if (nodeId != null) {
+ universe.nodeIdFreeList.addElement(nodeId);
+ nodeId = null;
+ }
+
+ // Set universe pointer to null, indicating that this Locale
+ // has been removed from its universe
+ universe = null;
+ }
+
+
+ // The method that does the work once the lock is acquired.
+ void doRemoveBranchGraph(BranchGroup branchGroup,
+ J3dMessage messages[], int startIndex) {
+
+ BranchGroupRetained bgr = (BranchGroupRetained)branchGroup.retained;
+ J3dMessage destroyMessage;
+
+ if (!branchGroup.isLive())
+ return;
+ bgr.attachedToLocale = false;
+ branchGroups.removeElement(branchGroup);
+ universe.setLiveState.reset(this);
+ bgr.clearLive(universe.setLiveState);
+ bgr.setParent(null);
+ bgr.setLocale(null);
+
+ if (messages == null) {
+ destroyMessage = new J3dMessage();
+ } else {
+ destroyMessage = messages[startIndex++];
+ }
+ destroyMessage.threads = J3dThread.UPDATE_RENDER| J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ destroyMessage.type = J3dMessage.ORDERED_GROUP_REMOVED;
+ destroyMessage.universe = universe;
+ destroyMessage.args[0] = universe.setLiveState.ogList.toArray();
+ destroyMessage.args[1] = universe.setLiveState.ogChildIdList.toArray();
+ destroyMessage.args[3] = universe.setLiveState.ogCIOList.toArray();
+ destroyMessage.args[4] = universe.setLiveState.ogCIOTableList.toArray();
+
+ // Issue 312: We need to send the REMOVE_NODES message to the
+ // RenderingEnvironmentStructure before we send VIEWSPECIFICGROUP_CLEAR,
+ // since the latter clears the list of views that is referred to by
+ // scopedNodesViewList and used by removeNodes.
+ if (messages == null) {
+ VirtualUniverse.mc.processMessage(destroyMessage);
+ destroyMessage = new J3dMessage();
+ } else {
+ destroyMessage = messages[startIndex++];
+ }
+ destroyMessage.threads = universe.setLiveState.notifyThreads;
+ destroyMessage.type = J3dMessage.REMOVE_NODES;
+ destroyMessage.universe = universe;
+ destroyMessage.args[0] = universe.setLiveState.nodeList.toArray();
+ if (universe.setLiveState.viewScopedNodeList != null) {
+ destroyMessage.args[3] = universe.setLiveState.viewScopedNodeList;
+ destroyMessage.args[4] = universe.setLiveState.scopedNodesViewList;
+ }
+
+ if (messages == null) {
+ VirtualUniverse.mc.processMessage(destroyMessage);
+ destroyMessage = new J3dMessage();
+ } else {
+ destroyMessage = messages[startIndex++];
+ }
+ destroyMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ destroyMessage.type = J3dMessage.VIEWSPECIFICGROUP_CLEAR;
+ destroyMessage.universe = universe;
+ destroyMessage.args[0] = universe.setLiveState.changedViewGroup;
+ destroyMessage.args[1] = universe.setLiveState.keyList;
+
+ if (messages == null) {
+ VirtualUniverse.mc.processMessage(destroyMessage);
+ } else {
+ destroyMessage = messages[startIndex++];
+ }
+
+ if (universe.isEmpty()) {
+ VirtualUniverse.mc.postRequest(MasterControl.EMPTY_UNIVERSE,
+ universe);
+ }
+ universe.setLiveState.reset(null); // cleanup memory
+ universe.notifyStructureChangeListeners(false, this, branchGroup);
+ }
+
+ /**
+ * Replaces the branch graph rooted at oldGroup in the list of
+ * branch graphs with the branch graph rooted at
+ * newGroup.
+ * @param oldGroup root of the branch graph to be replaced.
+ * @param newGroup root of the branch graph that will replace the old
+ * branch graph.
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ * @exception CapabilityNotSetException if the ALLOW_DETACH capability is
+ * not set in the old BranchGroup node.
+ * @exception MultipleParentException if the new BranchGroup node
+ * is already live.
+ */
+ public void replaceBranchGraph(BranchGroup oldGroup,
+ BranchGroup newGroup){
+
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ if (! oldGroup.getCapability(BranchGroup.ALLOW_DETACH)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Locale1"));
+ }
+
+ if (((BranchGroupRetained)newGroup.retained).parent != null) {
+ throw new MultipleParentException(J3dI18N.getString("Locale3"));
+ }
+ universe.resetWaitMCFlag();
+ universe.notifyStructureChangeListeners(true, this, newGroup);
+ synchronized (universe.sceneGraphLock) {
+ doReplaceBranchGraph(oldGroup, newGroup);
+ universe.setLiveState.reset(this);
+ }
+ universe.notifyStructureChangeListeners(false, this, oldGroup);
+ universe.waitForMC();
+ }
+
+ // The method that does the work once the lock is acquired.
+ void doReplaceBranchGraph(BranchGroup oldGroup,
+ BranchGroup newGroup){
+ BranchGroupRetained obgr = (BranchGroupRetained)oldGroup.retained;
+ BranchGroupRetained nbgr = (BranchGroupRetained)newGroup.retained;
+ J3dMessage createMessage;
+ J3dMessage destroyMessage;
+
+
+ branchGroups.removeElement(oldGroup);
+ obgr.attachedToLocale = false;
+ universe.setLiveState.reset(this);
+ obgr.clearLive(universe.setLiveState);
+
+ destroyMessage = new J3dMessage();
+
+ destroyMessage.threads = J3dThread.UPDATE_RENDER| J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ destroyMessage.type = J3dMessage.ORDERED_GROUP_REMOVED;
+ destroyMessage.universe = universe;
+ destroyMessage.args[0] = universe.setLiveState.ogList.toArray();
+ destroyMessage.args[1] = universe.setLiveState.ogChildIdList.toArray();
+ destroyMessage.args[3] = universe.setLiveState.ogCIOList.toArray();
+ destroyMessage.args[4] = universe.setLiveState.ogCIOTableList.toArray();
+ VirtualUniverse.mc.processMessage(destroyMessage);
+
+ destroyMessage = new J3dMessage();
+ destroyMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ destroyMessage.type = J3dMessage.VIEWSPECIFICGROUP_CLEAR;
+ destroyMessage.universe = universe;
+ destroyMessage.args[0] = universe.setLiveState.changedViewGroup;
+ destroyMessage.args[1] = universe.setLiveState.keyList;
+ VirtualUniverse.mc.processMessage(destroyMessage);
+
+
+ destroyMessage = new J3dMessage();
+ destroyMessage.threads = universe.setLiveState.notifyThreads;
+ destroyMessage.type = J3dMessage.REMOVE_NODES;
+ destroyMessage.universe = universe;
+ destroyMessage.args[0] = universe.setLiveState.nodeList.toArray();
+ VirtualUniverse.mc.processMessage(destroyMessage);
+
+ branchGroups.addElement(newGroup);
+ nbgr.attachedToLocale = true;
+ universe.setLiveState.reset(this);
+ universe.setLiveState.currentTransforms[0] = new Transform3D[2];
+ universe.setLiveState.currentTransforms[0][0] = new Transform3D();
+ universe.setLiveState.currentTransforms[0][1] = new Transform3D();
+ universe.setLiveState.currentTransformsIndex[0] = new int[2];
+ universe.setLiveState.currentTransformsIndex[0][0] = 0;
+ universe.setLiveState.currentTransformsIndex[0][1] = 0;
+
+ universe.setLiveState.localToVworld =
+ universe.setLiveState.currentTransforms;
+ universe.setLiveState.localToVworldIndex =
+ universe.setLiveState.currentTransformsIndex;
+
+ universe.setLiveState.branchGroupPaths = new ArrayList();
+ universe.setLiveState.branchGroupPaths.add(new BranchGroupRetained[0]);
+
+ universe.setLiveState.orderedPaths = new ArrayList(1);
+ universe.setLiveState.orderedPaths.add(new OrderedPath());
+
+ universe.setLiveState.switchStates = new ArrayList(1);
+ universe.setLiveState.switchStates.add(new SwitchState(false));
+
+ nbgr.setLive(universe.setLiveState);
+
+
+ createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDER| J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.type = J3dMessage.ORDERED_GROUP_INSERTED;
+ createMessage.universe = universe;
+ createMessage.args[0] = universe.setLiveState.ogList.toArray();
+ createMessage.args[1] = universe.setLiveState.ogChildIdList.toArray();
+ createMessage.args[2] = universe.setLiveState.ogOrderedIdList.toArray();
+ createMessage.args[3] = universe.setLiveState.ogCIOList.toArray();
+ createMessage.args[4] = universe.setLiveState.ogCIOTableList.toArray();
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ // XXXX: make these two into one message
+ createMessage = new J3dMessage();
+ createMessage.threads = universe.setLiveState.notifyThreads;
+ createMessage.type = J3dMessage.INSERT_NODES;
+ createMessage.universe = universe;
+ createMessage.args[0] = universe.setLiveState.nodeList.toArray();
+ createMessage.args[1] = null;
+ createMessage.args[2] = null;
+ if (universe.setLiveState.viewScopedNodeList != null) {
+ createMessage.args[3] = universe.setLiveState.viewScopedNodeList;
+ createMessage.args[4] = universe.setLiveState.scopedNodesViewList;
+ }
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ Object behaviorNodes[] = universe.setLiveState.behaviorNodes.toArray();
+
+ if (universe.isEmpty()) {
+ VirtualUniverse.mc.postRequest(MasterControl.EMPTY_UNIVERSE,
+ universe);
+ }
+
+ for (int i=0; i< behaviorNodes.length; i++) {
+ ((BehaviorRetained) behaviorNodes[i]).executeInitialize();
+ }
+
+ createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_BEHAVIOR;
+ createMessage.type = J3dMessage.BEHAVIOR_ACTIVATE;
+ createMessage.universe = universe;
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ // Free up memory.
+ universe.setLiveState.reset(null);
+ }
+
+ /**
+ * Get number of branch graphs in this Locale.
+ * @return number of branch graphs in this Locale.
+ */
+ public int numBranchGraphs(){
+ return branchGroups.size();
+ }
+
+ /**
+ * Gets an Enumeration object of all branch graphs in this Locale.
+ * @return an Enumeration object of all branch graphs.
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ */
+ public Enumeration getAllBranchGraphs(){
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ return branchGroups.elements();
+ }
+
+
+ void validateModeFlagAndPickShape(int mode, int flags, PickShape pickShape) {
+
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ if((mode != PickInfo.PICK_BOUNDS) && (mode != PickInfo.PICK_GEOMETRY)) {
+
+ throw new IllegalArgumentException(J3dI18N.getString("Locale5"));
+ }
+
+ if((pickShape instanceof PickPoint) && (mode == PickInfo.PICK_GEOMETRY)) {
+ throw new IllegalArgumentException(J3dI18N.getString("Locale6"));
+ }
+
+ if(((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) &&
+ ((flags & PickInfo.ALL_GEOM_INFO) != 0)) {
+ throw new IllegalArgumentException(J3dI18N.getString("Locale7"));
+ }
+
+ if((mode == PickInfo.PICK_BOUNDS) &&
+ (((flags & (PickInfo.CLOSEST_GEOM_INFO |
+ PickInfo.ALL_GEOM_INFO |
+ PickInfo.CLOSEST_DISTANCE |
+ PickInfo.CLOSEST_INTERSECTION_POINT)) != 0))) {
+
+ throw new IllegalArgumentException(J3dI18N.getString("Locale8"));
+ }
+
+ if((pickShape instanceof PickBounds) &&
+ (((flags & (PickInfo.CLOSEST_GEOM_INFO |
+ PickInfo.ALL_GEOM_INFO |
+ PickInfo.CLOSEST_DISTANCE |
+ PickInfo.CLOSEST_INTERSECTION_POINT)) != 0))) {
+
+ throw new IllegalArgumentException(J3dI18N.getString("Locale9"));
+ }
+ }
+
+ /**
+ * Returns an array referencing all the items that are pickable below this
+ *
+ * The properties that can be set for a Material object are:
+ *
+ *
+ * @param originalNodeComponent the original node component to duplicate.
+ * @param forceDuplicate when set to
+ * A ModelClip node also contains a list of Group nodes that specifies the
+ * hierarchical scope of this ModelClip. If the scope list is empty, then
+ * the ModelClip node has universe scope: all nodes within the region of
+ * influence are affected by this ModelClip node. If the scope list is
+ * non-empty, then only those Leaf nodes under the Group nodes in the
+ * scope list are affected by this ModelClip node (subject to the
+ * influencing bounds).
+ *
+ * If the regions of influence of multiple ModelClip nodes overlap, the
+ * Java 3D system will choose a single set of model clip planes for those
+ * objects that lie in the intersection. This is done in an
+ * implementation-dependent manner, but in general, the ModelClip node that
+ * is "closest" to the object is chosen.
+ *
+ * The individual planes specify a half-space defined by the equation:
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param referenceTable a NodeReferenceTableObject that contains the
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * The following restrictions apply to each GeometryArray object
+ * in the specified array of GeometryArray objects:
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * For IndexedGeometryArray objects, the vertex arrays are morphed
+ * before the indexes are applied. Only the indexes in the
+ * first geometry array (geometry[0]) are used when rendering the
+ * geometry.
+ *
+ * @deprecated As of Java 3D version 1.4.
+ */
+
+public class Morph extends Leaf {
+
+ /**
+ * Specifies that the node allows read access to its geometry information.
+ */
+ public static final int
+ ALLOW_GEOMETRY_ARRAY_READ = CapabilityBits.MORPH_ALLOW_GEOMETRY_ARRAY_READ;
+
+ /**
+ * Specifies that the node allows write access to its geometry information.
+ */
+ public static final int
+ ALLOW_GEOMETRY_ARRAY_WRITE = CapabilityBits.MORPH_ALLOW_GEOMETRY_ARRAY_WRITE;
+
+ /**
+ * Specifies that the node allows read access to its appearance information.
+ */
+ public static final int
+ ALLOW_APPEARANCE_READ = CapabilityBits.MORPH_ALLOW_APPEARANCE_READ;
+
+ /**
+ * Specifies that the node allows write access to its appearance information.
+ */
+ public static final int
+ ALLOW_APPEARANCE_WRITE = CapabilityBits.MORPH_ALLOW_APPEARANCE_WRITE;
+
+ /**
+ * Specifies that the node allows read access to its morph
+ * weight vector.
+ */
+ public static final int
+ ALLOW_WEIGHTS_READ = CapabilityBits.MORPH_ALLOW_WEIGHTS_READ;
+
+ /**
+ * Specifies that the node allows write access to its morph
+ * weight vector.
+ */
+ public static final int
+ ALLOW_WEIGHTS_WRITE = CapabilityBits.MORPH_ALLOW_WEIGHTS_WRITE;
+
+ /**
+ * Specifies that the node allows reading its collision Bounds.
+ */
+ public static final int
+ ALLOW_COLLISION_BOUNDS_READ = CapabilityBits.MORPH_ALLOW_COLLISION_BOUNDS_READ;
+
+ /**
+ * Specifies the node allows writing its collision Bounds.
+ */
+ public static final int
+ ALLOW_COLLISION_BOUNDS_WRITE = CapabilityBits.MORPH_ALLOW_COLLISION_BOUNDS_WRITE;
+
+ /**
+ * Specifies that this node allows reading its appearance override
+ * enable flag.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int ALLOW_APPEARANCE_OVERRIDE_READ =
+ CapabilityBits.MORPH_ALLOW_APPEARANCE_OVERRIDE_READ;
+
+ /**
+ * Specifies that this node allows writing its appearance override
+ * enable flag.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int ALLOW_APPEARANCE_OVERRIDE_WRITE =
+ CapabilityBits.MORPH_ALLOW_APPEARANCE_OVERRIDE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_GEOMETRY_ARRAY_READ,
+ ALLOW_APPEARANCE_READ,
+ ALLOW_WEIGHTS_READ,
+ ALLOW_COLLISION_BOUNDS_READ,
+ ALLOW_APPEARANCE_OVERRIDE_READ
+ };
+
+ // non public default constructor
+ Morph() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs and initializes a Morph node with the specified array
+ * of GeometryArray objects. Default values are used for all other
+ * parameters as follows:
+ *
+ * A null appearance object specifies that default values are used
+ * for all appearance attributes.
+ *
+ * @param geometryArrays the geometry components of the morph;
+ * a null or zero-length array of GeometryArray objects is
+ * permitted, and specifies that no geometry is drawn. In this case,
+ * the array of weights is initialized to a zero-length array.
+ *
+ * @exception IllegalArgumentException if any of the specified
+ * geometry array objects differ from each other in any of the
+ * following ways:
+ *
+ *
+ * @exception IllegalArgumentException if the length of the
+ * specified array of geometry arrays is not equal to the length
+ * of this Morph node's current array of geometry arrays (and the
+ * current array's length is non-zero), or if any of the specified
+ * geometry array objects differ from each other in any of the
+ * following ways:
+ *
+ * For any
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * NOTE: Applications should not extend this class directly.
+ */
+public abstract class Node extends SceneGraphObject {
+
+ /**
+ * Specifies that this Node will be reported in the pick
+ * SceneGraphPath if a pick occurs. This capability is only
+ * specifiable for Group nodes; it is ignored for leaf nodes.
+ * The default for Group nodes is false. All interior nodes not
+ * needed for uniqueness in a SceneGraphPath that don't have
+ * ENABLE_PICK_REPORTING set to true will not be reported in the
+ * SceneGraphPath.
+ * @see SceneGraphPath
+ */
+ public static final int
+ ENABLE_PICK_REPORTING = CapabilityBits.NODE_ENABLE_PICK_REPORTING;
+
+ /**
+ * Specifies that this Node will be reported in the collision
+ * SceneGraphPath if a collision occurs. This capability is only
+ * specifiable for Group nodes; it is ignored for leaf nodes.
+ * The default for Group nodes is false. All interior nodes not
+ * needed for uniqueness in a SceneGraphPath that don't have
+ * ENABLE_COLLISION_REPORTING set to true will not be reported
+ * in the SceneGraphPath.
+ * @see SceneGraphPath
+ */
+ public static final int
+ ENABLE_COLLISION_REPORTING = CapabilityBits.NODE_ENABLE_COLLISION_REPORTING;
+
+ /**
+ * Specifies that this Node allows read access to its bounds
+ * information.
+ */
+ public static final int
+ ALLOW_BOUNDS_READ = CapabilityBits.NODE_ALLOW_BOUNDS_READ;
+
+ /**
+ * Specifies that this Node allows write access to its bounds
+ * information.
+ */
+ public static final int
+ ALLOW_BOUNDS_WRITE = CapabilityBits.NODE_ALLOW_BOUNDS_WRITE;
+
+ /**
+ * Specifies that this Node allows reading its pickability state.
+ */
+ public static final int
+ ALLOW_PICKABLE_READ = CapabilityBits.NODE_ALLOW_PICKABLE_READ;
+
+ /**
+ * Specifies that this Node allows write access its pickability state.
+ */
+ public static final int
+ ALLOW_PICKABLE_WRITE = CapabilityBits.NODE_ALLOW_PICKABLE_WRITE;
+
+ /**
+ * Specifies that this Node allows reading its collidability state.
+ */
+ public static final int
+ ALLOW_COLLIDABLE_READ = CapabilityBits.NODE_ALLOW_COLLIDABLE_READ;
+
+ /**
+ * Specifies that this Node allows write access its collidability state.
+ */
+ public static final int
+ ALLOW_COLLIDABLE_WRITE = CapabilityBits.NODE_ALLOW_COLLIDABLE_WRITE;
+
+ /**
+ * Specifies that this Node allows read access to its bounds
+ * auto compute information.
+ */
+ public static final int
+ ALLOW_AUTO_COMPUTE_BOUNDS_READ = CapabilityBits.NODE_ALLOW_AUTO_COMPUTE_BOUNDS_READ;
+
+ /**
+ * Specifies that this Node allows write access to its bounds
+ * auto compute information.
+ */
+ public static final int
+ ALLOW_AUTO_COMPUTE_BOUNDS_WRITE = CapabilityBits.NODE_ALLOW_AUTO_COMPUTE_BOUNDS_WRITE;
+
+ /**
+ * Specifies that this Node allows read access to its local
+ * coordinates to virtual world (Vworld) coordinates transform.
+ */
+ public static final int
+ ALLOW_LOCAL_TO_VWORLD_READ = CapabilityBits.NODE_ALLOW_LOCAL_TO_VWORLD_READ;
+
+ /**
+ * Specifies that this Node allows read access to its parent Group node.
+ *
+ * @since Java 3D 1.4
+ */
+ public static final int
+ ALLOW_PARENT_READ = CapabilityBits.NODE_ALLOW_PARENT_READ;
+
+ /**
+ * Specifies that this Node allows read access to its Locale.
+ *
+ * @since Java 3D 1.4
+ */
+ public static final int
+ ALLOW_LOCALE_READ = CapabilityBits.NODE_ALLOW_LOCALE_READ;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_BOUNDS_READ,
+ ALLOW_PICKABLE_READ,
+ ALLOW_COLLIDABLE_READ,
+ ALLOW_AUTO_COMPUTE_BOUNDS_READ,
+ ALLOW_LOCAL_TO_VWORLD_READ,
+ ALLOW_PARENT_READ,
+ ALLOW_LOCALE_READ
+ };
+
+ // for checking for cycles
+ private boolean visited = false;
+
+
+ /**
+ * Constructs a Node object with default parameters. The default
+ * values are as follows:
+ *
+ * For any
+ * For any NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * For more information, see the
+ * Introduction to the Java 3D API.
+ */
+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:
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ * During a
+ * A SceneGraphObject's
+ * When the child index order array is non-null, it must be the same
+ * length as the number of children. Every entry in the array must
+ * have a unique value between 0 and
+ * The child index order array only affects rendering. List
+ * operations that refer to a child by index, such as getChild(index),
+ * will not be altered by the entries in this array. They will get,
+ * enumerate, add, remove, etc., the children based on the actual
+ * index in the group node. However, some of the list operations,
+ * such as addChild, removeChild, etc., will update the child index
+ * order array as a result of their operation. For example,
+ * removeChild will remove the entry in the child index order array
+ * corresponding to the removed child's index and adjust the remaining
+ * entries accordingly. See the documentation for these methods for
+ * more details.
+ */
+
+public class OrderedGroup extends Group {
+
+ private boolean checkArr[] = null;
+
+ /**
+ * Specifies that this OrderedGroup node
+ * allows reading its child index order information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int ALLOW_CHILD_INDEX_ORDER_READ =
+ CapabilityBits.ORDERED_GROUP_ALLOW_CHILD_INDEX_ORDER_READ;
+
+ /**
+ * Specifies that this OrderedGroup node
+ * allows writing its child index order information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int ALLOW_CHILD_INDEX_ORDER_WRITE =
+ CapabilityBits.ORDERED_GROUP_ALLOW_CHILD_INDEX_ORDER_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_CHILD_INDEX_ORDER_READ
+ };
+
+ /**
+ * Constructs and initializes a new OrderedGroup node object.
+ * The childIndexOrder array is initialized to null, meaning
+ * that its children are rendered in increasing index order.
+ */
+ public OrderedGroup() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+
+ /**
+ * Sets the childIndexOrder array. If the specified array is
+ * null, this node's childIndexOrder array is set to null. Its
+ * children will then be rendered in increasing index order. If
+ * the specified array is not null, the entire array is copied to
+ * this node's childIndexOrder array. In this case, the length of
+ * the array must be equal to the number of children in this
+ * group, and every entry in the array must have a unique value
+ * between 0 and
+ * If the current child index order array is non-null, the array
+ * is increased in size by one element, and a new element
+ * containing the index of the new child is added to the end of
+ * the array. Thus, this new child will be rendered last.
+ *
+ * @param child the child to add to this node's list of children
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part
+ * of live
+ * or compiled scene graph and the child node being added is not
+ * a BranchGroup node
+ * @exception MultipleParentException if
+ * If the current child index order array is non-null, the element
+ * containing the removed child's index will be removed from the
+ * child index order array, and the array will be reduced in size
+ * by one element. If the child removed was not the last child in
+ * the Group, the values of the child index order array will be
+ * updated to reflect the indices that were renumbered. More
+ * formally, each child whose index in the Group node was greater
+ * than the removed element (before removal) will have its index
+ * decremented by one.
+ *
+ * @param index which child to remove. The
+ * If the current child index order array is non-null, the array
+ * is increased in size by one element, and a new element
+ * containing the index of the new child is added to the end of
+ * the array. Thus, this new child will be rendered last.
+ *
+ * @param branchGroup the branch group node to move to this node's list
+ * of children
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void moveTo(BranchGroup branchGroup) {
+ // Just call super -- the extra work is done by the retained class
+ super.moveTo(branchGroup);
+ }
+
+ /**
+ * Removes the specified child node from this group node's
+ * list of children.
+ * If the specified object is not in the list, the list is not modified.
+ *
+ *
+ * If the current child index order array is non-null, the element
+ * containing the removed child's index will be removed from the
+ * child index order array, and the array will be reduced in size
+ * by one element. If the child removed was not the last child in
+ * the Group, the values of the child index order array will be
+ * updated to reflect the indices that were renumbered. More
+ * formally, each child whose index in the Group node was greater
+ * than the removed element (before removal) will have its index
+ * decremented by one.
+ *
+ * @param child the child node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live or compiled scene graph and the child node being removed is not
+ * a BranchGroup node
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeChild(Node child) {
+ // Just call super -- the extra work is done by the retained class
+ super.removeChild(child);
+ }
+
+ /**
+ * Removes all children from this Group node.
+ *
+ *
+ * If the current child index order array is non-null, then it is set to
+ * a zero-length array (the empty set). Note that a zero-length
+ * child index order array is not the same as a null array in that
+ * as new elements are added, the child index order array will grow
+ * and will be used instead of the Group's natural child order.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live or compiled scene graph and any of the children being removed are
+ * not BranchGroup nodes
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeAllChildren() {
+ // Just call super -- the extra work is done by the retained class
+ super.removeAllChildren();
+ }
+
+
+ /**
+ * Creates the retained mode OrderedGroupRetained object that this
+ * OrderedGroup component object will point to.
+ */
+ void createRetained() {
+ this.retained = new OrderedGroupRetained();
+ this.retained.setSource(this);
+ }
+
+ void verifyAddStates(Node child) {
+
+ if (child instanceof SharedGroup) {
+ throw new IllegalArgumentException(J3dI18N.getString("Group2"));
+ }
+
+ if (isLiveOrCompiled()) {
+ if (! (child instanceof BranchGroup))
+ throw new RestrictedAccessException(J3dI18N.getString("Group12"));
+
+ if(!this.getCapability(ALLOW_CHILDREN_EXTEND))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group16"));
+ }
+ }
+
+ void verifyChildIndexOrderArray(int[] cIOArr, int plus) {
+
+ if (isLiveOrCompiled()) {
+
+ if(!this.getCapability(ALLOW_CHILD_INDEX_ORDER_WRITE))
+ throw new
+ CapabilityNotSetException(J3dI18N.getString("OrderedGroup4"));
+ }
+
+ if(cIOArr != null) {
+
+ if(cIOArr.length != (((GroupRetained)retained).children.size() + plus)) {
+ throw new
+ IllegalArgumentException(J3dI18N.getString("OrderedGroup0"));
+ }
+
+ if((checkArr == null) || (checkArr.length != cIOArr.length)) {
+ checkArr = new boolean[cIOArr.length];
+ }
+
+ Arrays.fill(checkArr, false);
+
+ for(int i=0; i
+ * OrientedShape3D is similar in functionality to the Billboard
+ * behavior, but OrientedShape3D nodes will orient themselves
+ * correctly for each view, and they can be used within a SharedGroup.
+ *
+ *
+ * If the alignment mode is ROTATE_ABOUT_AXIS, then the rotation will be
+ * around the specified axis. If the alignment mode is
+ * ROTATE_ABOUT_POINT, then the rotation will be about the specified
+ * point, with an additional rotation to align the +y axis of the
+ * TransformGroup with the +y axis in the View.
+ *
+ *
+ * If the constant scale enable flag is set, the object will be drawn
+ * the same size in absolute screen coordinates (meters), regardless
+ * of the following: any transforms above this OrientedShape3D node in
+ * the scene graph, the view scale, the window scale, or the effects
+ * of perspective correction. This is done by scaling the geometry
+ * about the local origin of this node, such that 1 unit in local
+ * coordinates is equal to the number of meters specified by this
+ * node's scale value. If the constant scale enable flag is set to
+ * false, then the scale is not used. The default scale is 1.0
+ * meters.
+ *
+ *
+ * OrientedShape3D nodes are ideal for drawing screen-aligned text or
+ * for drawing roughly-symmetrical objects. A typical use might
+ * consist of a quadrilateral that contains a texture of a tree.
+ *
+ *
+ * Note that in a multiple View system, picking and interestion test
+ * is done with the primary View only.
+ *
+ * @see Billboard
+ *
+ * @since Java 3D 1.2
+ */
+
+public class OrientedShape3D extends Shape3D {
+
+ /**
+ * Specifies that rotation should be about the specified axis.
+ * @see #setAlignmentMode
+ */
+ public static final int ROTATE_ABOUT_AXIS = 0;
+
+ /**
+ * Specifies that rotation should be about the specified point and
+ * that the children's Y-axis should match the view object's Y-axis.
+ * @see #setAlignmentMode
+ */
+ public static final int ROTATE_ABOUT_POINT = 1;
+
+ /**
+ * Specifies that no rotation is done. The OrientedShape3D will
+ * not be aligned to the view.
+ * @see #setAlignmentMode
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int ROTATE_NONE = 2;
+
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows reading its alignment mode information.
+ */
+ public static final int ALLOW_MODE_READ =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_MODE_READ;
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows writing its alignment mode information.
+ */
+ public static final int ALLOW_MODE_WRITE =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_MODE_WRITE;
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows reading its alignment axis information.
+ */
+ public static final int ALLOW_AXIS_READ =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_AXIS_READ;
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows writing its alignment axis information.
+ */
+ public static final int ALLOW_AXIS_WRITE =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_AXIS_WRITE;
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows reading its rotation point information.
+ */
+ public static final int ALLOW_POINT_READ =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_POINT_READ;
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows writing its rotation point information.
+ */
+ public static final int ALLOW_POINT_WRITE =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_POINT_WRITE;
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows reading its scale and constant scale enable information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int ALLOW_SCALE_READ =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_SCALE_READ;
+
+ /**
+ * Specifies that this OrientedShape3D node
+ * allows writing its scale and constant scale enable information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int ALLOW_SCALE_WRITE =
+ CapabilityBits.ORIENTED_SHAPE3D_ALLOW_SCALE_WRITE;
+
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_MODE_READ,
+ ALLOW_AXIS_READ,
+ ALLOW_POINT_READ,
+ ALLOW_SCALE_READ
+ };
+
+ /**
+ * Constructs an OrientedShape3D node with default parameters.
+ * The default values are as follows:
+ *
+ * For any
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to "experimental" as part of the release name that
+ * appears before the optional first space.
+ */
+ private static final boolean isExperimental = !isProduction;
+
+ /**
+ * The composite version string. This is composed in the static
+ * initializer for this class.
+ */
+ private static final String VERSION;
+
+ /**
+ * The composite vendor string. This is composed in the static
+ * initializer for this class.
+ */
+ private static final String VENDOR;
+
+ /**
+ * Verbose time and date stamp appended to the end of the version string.
+ * This is appended to the version string
+ * after the build identifier (and after the first space, which
+ * will automatically be added) and before the optional dev
+ * string. This string is only used for non-fcs builds.
+ */
+ private static final String BUILDTIME_VERBOSE = "@BUILDTIME_VERBOSE@";
+
+ private static boolean isNonEmpty(String str) {
+ if ((str == null) || (str.length() == 0)) {
+ return false;
+ }
+ else {
+ return true;
+ }
+ }
+
+ // The static initializer composes the version and vendor strings
+ static {
+ final boolean isPatchBuild = BUILD_TYPE.equals("patch");
+ final boolean isFcsBuild = BUILD_TYPE.equals("fcs");
+ final boolean isBetaBuild = BUILD_TYPE.equals("beta");
+ final boolean isStableBuild = BUILD_TYPE.equals("stable");
+ final boolean isDailyBuild = BUILD_TYPE.equals("daily");
+
+ // Assign the vendor by concatenating primary and developer
+ // vendor strings
+ String tmpVendor = VENDOR_PRIMARY;
+ if (isNonEmpty(VENDOR_DEVELOPER)) {
+ tmpVendor += " & " + VENDOR_DEVELOPER;
+ }
+
+ String tmpVersion = VERSION_BASE;
+ if (isNonEmpty(VERSION_SUFFIX)) {
+ if (isPatchBuild) {
+ tmpVersion += "_";
+ }
+ else {
+ tmpVersion += "-";
+ }
+ tmpVersion += VERSION_SUFFIX;
+ }
+
+ if (isDailyBuild && isNonEmpty(BUILDTIME)) {
+ tmpVersion += "-" + BUILDTIME;
+ }
+
+ if (isExperimental) {
+ tmpVersion += "-experimental";
+ }
+
+ // Append the optional fields that follow the first space
+
+ if (isProduction) {
+ if (isFcsBuild) {
+ tmpVersion += " fcs";
+ }
+ else if (isPatchBuild) {
+ tmpVersion += " fcs+patch";
+ }
+
+ if (isNonEmpty(VERSION_BUILD)) {
+ tmpVersion += " (" + VERSION_BUILD + ")";
+ }
+ }
+
+ if (useVerboseBuildTime && isNonEmpty(BUILDTIME_VERBOSE)) {
+ tmpVersion += " " + BUILDTIME_VERBOSE;
+ }
+
+ if (isNonEmpty(VERSION_DEV_STRING)) {
+ tmpVersion += " " + VERSION_DEV_STRING;
+ }
+
+ VERSION = tmpVersion;
+ VENDOR = tmpVendor;
+ }
+
+ /**
+ * Returns the specification version string.
+ * @return the specification version string
+ */
+ static String getSpecificationVersion() {
+ return SPECIFICATION_VERSION;
+ }
+
+ /**
+ * Returns the specification vendor string.
+ * @return the specification vendor string
+ */
+ static String getSpecificationVendor() {
+ return SPECIFICATION_VENDOR;
+ }
+
+
+ /**
+ * Returns the implementation version string.
+ * @return the implementation version string
+ */
+ static String getVersion() {
+ return VERSION;
+ }
+
+ /**
+ * Returns the implementation vendor string.
+ * @return the implementation vendor string
+ */
+ static String getVendor() {
+ return VENDOR;
+ }
+
+}
diff --git a/j3d-core/build-tools/genzip b/j3d-core/build-tools/genzip
new file mode 100644
index 0000000..85b0832
--- /dev/null
+++ b/j3d-core/build-tools/genzip
@@ -0,0 +1,54 @@
+#!/bin/sh
+
+# usage: genzip Java 3D API version 1.4 Change Log
+I. Proposed Changes
+
+II. Accepted Changes
+
+
+
+
+ 1. Programmable shader
+support
+
+
+javax.media.j3d package:
+
+
+public class ShaderAppearance
+extends Appearance
+
+public class ShaderAttributeSet
+extends
+NodeComponent
+public abstract class ShaderAttribute
+extends
+NodeComponent
+public class ShaderAttributeBinding
+extends
+ShaderAttribute
+public abstract class ShaderAttributeObject
+extends ShaderAttribute
+public class ShaderAttributeValue
+extends
+ShaderAttributeObject
+public class ShaderAttributeArray
+extends
+ShaderAttributeObject
+public abstract class Shader
+extends
+NodeComponent
+public class SourceCodeShader
+extends Shader
+public abstract class ShaderProgram
+extends
+NodeComponent
+public class CgShaderProgram
+extends
+ShaderProgram
+public class GLSLShaderProgram
+extends
+ShaderProgram
+public class ShaderError
+extends Object
+public interface ShaderErrorListener
+
+ javax.vecmath package:
+
+
+public abstract class Tuple2i
+implements Serializable, Cloneable
+
+public class Point2i extends
+Tuple2i
+
+
+
+Canvas3D
+New method:
+ public boolean isShadingLanguageSupported(int
+shadingLanguage)
+
+ VirtualUniverse
+New methods:
+ public void
+addShaderErrorListener(ShaderErrorListener listener)
+ public void
+removeShaderErrorListener(ShaderErrorListener listener)
+
+ GeometryArray
+
+New fields:
+ public static final int ALLOW_VERTEX_ATTR_READ
+ public static final int ALLOW_VERTEX_ATTR_WRITE
+ public static final int VERTEX_ATTRIBUTES
+
+New constructor:
+ public GeometryArray(... int
+vertexAttrCount, int[]
+vertexAttrSizes)
+
+New methods:
+ public int getVertexAttrCount()
+ public void getVertexAttrSizes(int[]
+vertexAttrSizes)
+ public void setVertexAttr(int vertexAttrNum,
+int index, float[]
+vertexAttr)
+ public void setVertexAttr(int vertexAttrNum,
+int index, Point2f
+vertexAttr)
+ public void setVertexAttr(int vertexAttrNum,
+int index, Point3f
+vertexAttr)
+ public void setVertexAttr(int vertexAttrNum,
+int index, Point4f
+vertexAttr)
+ public void setVertexAttrs(int vertexAttrNum,
+int index, float[]
+vertexAttrs)
+ public void setVertexAttrs(int vertexAttrNum,
+int index, Point2f[]
+vertexAttrs)
+ public void setVertexAttrs(int vertexAttrNum,
+int index, Point3f[]
+vertexAttrs)
+ public void setVertexAttrs(int vertexAttrNum,
+int index, Point4f[]
+vertexAttrs)
+ public void setVertexAttrs(int vertexAttrNum,
+int index,
+ float[]
+vertexAttrs, int
+start, int length)
+ public void setVertexAttrs(int vertexAttrNum,
+int index,
+ Point2f[]
+vertexAttrs, int
+start, int length)
+ public void setVertexAttrs(int vertexAttrNum,
+int index,
+ Point3f[]
+vertexAttrs, int
+start, int length)
+ public void setVertexAttrs(int vertexAttrNum,
+int index,
+ Point4f[]
+vertexAttrs, int
+start, int length)
+ public void getVertexAttr(int vertexAttrNum,
+int index, float[]
+vertexAttr)
+ public void getVertexAttr(int vertexAttrNum,
+int index, Point2f
+vertexAttr)
+ public void getVertexAttr(int vertexAttrNum,
+int index, Point3f
+vertexAttr)
+ public void getVertexAttr(int vertexAttrNum,
+int index, Point4f
+vertexAttr)
+ public void getVertexAttrs(int vertexAttrNum,
+int index, float[]
+vertexAttrs)
+ public void getVertexAttrs(int vertexAttrNum,
+int index, Point2f[]
+vertexAttrs)
+ public void getVertexAttrs(int vertexAttrNum,
+int index, Point3f[]
+vertexAttrs)
+ public void getVertexAttrs(int vertexAttrNum,
+int index, Point4f[]
+vertexAttrs)
+ public void setInitialVertexAttrIndex(int
+vertexAttrNum, int
+initialVertexAttrIndex)
+ public int getInitialVertexAttrIndex(int
+vertexAttrNum)
+ public void setVertexAttrRefBuffer(int
+vertexAttrNum, J3DBuffer vertexAttrs)
+ public J3DBuffer getVertexAttrRefBuffer(int
+vertexAttrNum)
+ public void setVertexAttrRefFloat(int
+vertexAttrNum, float[] vertexAttrs)
+ public float[] getVertexAttrRefFloat(int
+vertexAttrNum)
+
+ IndexedGeometryArray
+New fields:
+ public static final int
+ALLOW_VERTEX_ATTR_INDEX_READ
+ public static final int
+ALLOW_VERTEX_ATTR_INDEX_WRITE
+
+New constructor:
+ public IndexedGeometryArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+New methods:
+ public void setInitialVertexAttrIndex(int
+vertexAttrNum, int
+initialVertexAttrIndex)
+ public void setVertexAttrIndex(int
+vertexAttrNum, int
+index, int
+vertexAttrIndex)
+ public void setVertexAttrIndices(int
+vertexAttrNum, int
+index, int[]
+vertexAttrIndices)
+ public int getVertexAttrIndex(int
+vertexAttrNum, int index)
+ public void getVertexAttrIndices(int
+vertexAttrNum, int
+index, int[]
+vertexAttrIndices)
+
+
+
+ PointArray
+
+public PointArray(... int vertexAttrCount,
+int[] vertexAttrSizes)
+
+ LineArray
+public LineArray(... int vertexAttrCount, int[]
+vertexAttrSizes)
+
+
+ TriangleArray
+public TriangleArray(... int vertexAttrCount,
+int[] vertexAttrSizes)
+
+
+ QuadArray
+public QuadArray(... int vertexAttrCount, int[]
+vertexAttrSizes)
+
+
+ GeometryStripArray
+public GeometryStripArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ LineStripArray
+public LineStripArray(... int vertexAttrCount,
+int[] vertexAttrSizes ...)
+
+
+ TriangleStripArray
+public TriangleStripArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ TriangleFanArray
+public TriangleFanArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedPointArray
+public IndexedPointArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedLineArray
+public IndexedLineArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedTriangleArray
+public IndexedTriangleArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedQuadArray
+public IndexedQuadArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedGeometryStripArray
+public IndexedGeometryStripArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedLineStripArray
+public IndexedLineStripArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedTriangleStripArray
+public IndexedTriangleStripArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+
+ IndexedTriangleFanArray
+public IndexedTriangleFanArray(... int
+vertexAttrCount, int[] vertexAttrSizes ...)
+
+2. Default values for read capability
+bits
+
+ALLOW_*_READ,
+plus the ALLOW_INTERSECT capability bit.
+
+
+3. Picking
+
+
+
+
+
+public
+class PickInfo extends Object
+
+public class PickInfo.IntersectionInfo
+extends
+Object
+
+
+
+Locale
+
+public PickInfo[] pickAll( int mode, int flags,
+PickShape pickShape )
+public PickInfo[] pickAllSorted( int mode, int
+flags, PickShape pickShape )
+public PickInfo pickClosest( int mode, int
+flags, PickShape pickShape )
+public PickInfo pickAny( int mode, int flags,
+PickShape pickShape )
+
+
+ BranchGroup
+public PickInfo[] pickAll( int mode, int flags,
+PickShape pickShape )
+public PickInfo[] pickAllSorted( int mode, int
+flags, PickShape pickShape )
+public PickInfo pickClosest( int mode, int
+flags, PickShape pickShape )
+public PickInfo pickAny( int mode, int flags,
+PickShape pickShape )
+4. Stencil
+
+
+
+
+ RenderingAttributes
+New fields:
+ public static final int
+ALLOW_STENCIL_ATTRIBUTES_READ
+ public static final int
+ALLOW_STENCIL_ATTRIBUTES_WRITE
+ public static final int STENCIL_KEEP
+
+ public static final int STENCIL_ZERO
+ public static final int STENCIL_REPLACE
+ public static final int STENCIL_INCR
+ public static final int STENCIL_DECR
+ public static final int STENCIL_INVERT
+
+New methods:
+ public void setStencilEnable(boolean enable)
+ public boolean getStencilEnable()
+ public void setStencilOp(int failOp, int
+zFailOp, int zPassOp)
+ public void setStencilOp(int[] stencilOps)
+ public void getStencilOp(int[] stencilOps)
+ public void setStencilFunction(int function,
+int refValue, int compareMask)
+ public void setStencilFunction(int[] params)
+ public void getStencilFunction(int[] params)
+ public void setStencilWriteMask(int mask)
+ public int getStencilWriteMask()
+
+ GraphicsConfigTemplate3D
+New methods:
+ public void setStencilSize(int value)
+ public int getStencilSize()
+
+5. Rendering attributes
+
+
+
+
+ RenderingAttributes
+New fields:
+ public static final int
+ALLOW_DEPTH_TEST_FUNCTION_READ
+ public static final int
+ALLOW_DEPTH_TEST_FUNCTION_WRITE
+ public static final int ROP_CLEAR
+ public static final int ROP_AND
+ public static final int ROP_AND_REVERSE
+ public static final int ROP_AND_INVERTED
+ public static final int ROP_NOOP
+ public static final int ROP_OR
+ public static final int ROP_NOR
+ public static final int ROP_EQUIV
+ public static final int ROP_INVERT
+ public static final int ROP_OR_REVERSE
+ public static final int ROP_COPY_INVERTED
+ public static final int ROP_OR_INVERTED
+ public static final int ROP_NAND
+ public static final int ROP_SET
+
+New methods:
+ public void setDepthTestFunction(int
+function)
+ public int getDepthTestFunction()
+
+ TransparencyAttributes
+
+New fields:
+ public static final int BLEND_DST_COLOR
+ public static final int
+BLEND_ONE_MINUS_DST_COLOR
+ public static final int BLEND_SRC_COLOR
+ public static final int
+BLEND_ONE_MINUS_SRC_COLOR
+
+6. Other minor features
+
+
+
+public interface GraphStructureChangeListener
+
+
+
+ VirtualUniverse
+
+New methods:
+ public void
+addGraphStructureChangeListener(GraphStructureChangeListener listener)
+ public void
+removeGraphStructureChangeListener(GraphStructureChangeListener
+listener)
+
+
+ SceneGraphObject
+New methods:
+ public void setName(String name)
+ public String getName()
+
+
+ Node
+New fields:
+ public static final int ALLOW_PARENT_READ
+ public static final int ALLOW_LOCALE_READ
+
+New methods:
+ public Locale getLocale()
+
+
+ Font3D
+New methods:
+ public GeometryArray getGlyphGeometry(char c)
+
+7. Deprecated API
+
+
+
+ CompressedGeometry
+
+ CompressedGeometryHeader
+ PickPoint
+ Morph
+
+
+ Sensor
+
+Deprecated fields:
+ public static final int PREDICT_NONE
+ public static final int PREDICT_NEXT_FRAME_TIME
+ public static final int NO_PREDICTOR
+ public static final int HEAD_PREDICTOR
+ public static final int HAND_PREDICTOR
+
+Deprecated methods:
+ public void setPredictor(int predictor)
+ public int getPredictor()
+ public void setPredictionPolicy(int policy)
+ public int getPredictionPolicy()
+ public void getRead(Transform3D read, long
+deltaT)
+
+III. Deferred Changes
+
+Java 3D API version 1.5 Change Log
+I. Proposed Changes
+
+
+
+
+
+ 1. Non-power-of-two textures
+"textureNonPowerOfTwoAvailable" property to
+Canvas3D.queryProperties that will indicate whether or not
+non-power-of-two textures are supported. If this
+property is set to true, then non-power-of-two textures
+are rendered normally. If this property is set to false,
+then the graphics driver or card does not support non-power-of-two
+textures; texture mapping will be disabled if non-power-of-two
+textures are rendered on a Canvas3D that doesn't support them.
+
+2. NIO image buffer support for
+textures
+
+
+
+public
+class NioImageBuffer extends
+Object
+
+
+
+
+ImageComponent
+
+New enums:
+ public enum ImageClass {
+ BUFFERED_IMAGE,
+RENDERED_IMAGE, NIO_IMAGE_BUFFER
+ }
+
+New methods:
+ public ImageClass getImageClass()
+
+ ImageComponent2D
+New constructors:
+ public ImageComponent2D(int format,
+
+NioImageBuffer image,
+
+boolean byReference, boolean yUp)
+
+New methods:
+ public void set(NioImageBuffer image)
+ public NioImageBuffer getNioImage()
+
+ ImageComponent3D
+New constructors:
+ public ImageComponent3D(int format, NioImageBuffer[]
+images,
+
+boolean byReference, boolean yUp)
+
+New methods:
+ public void set(NioImageBuffer[] images)
+ public void set(int index, NioImageBuffer image)
+ public NioImageBuffer[] getNioImage()
+ public NioImageBuffer getNioImage(int index)
+
+3. By-reference support for geometry
+indices
+
+
+
+
+
+GeometryArray
+
+New fields:
+ public static final int BY_REFERENCE_INDICES
+
+ IndexedGeometryArray
+New methods:
+ public void setCoordIndicesRef(int
+coordIndices[])
+ public int[] getCoordIndicesRef()
+
+4. Rendering error listener
+
+
+
+public class RenderingError extends Object
+
+public interface RenderingErrorListener
+
+
+VirtualUniverse
+
+New methods:
+ public static void
+addRenderingErrorListener(RenderingErrorListener listener)
+ public static void
+removeRenderingErrorListener(RenderingErrorListener listener)
+
+5. Vecmath
+accessors/mutators
+
+
+
+Matrix3d
+
+Matrix3f
+Matrix4d
+Matrix4f
+Tuple2d
+Tuple2f
+Tuple2i
+Tuple3b
+Tuple3d
+Tuple3f
+Tuple3i
+Tuple4b
+Tuple4d
+Tuple4f
+Tuple4i
+
+6. Deprecated API
+
+
+Texture2D
+
+Deprecated fields:
+ public static final int ALLOW_DETAIL_TEXTURE_READ
+ public static final int LINEAR_DETAIL
+ public static final int LINEAR_DETAIL_RGB
+ public static final int LINEAR_DETAIL_ALPHA
+ public static final int DETAIL_ADD
+ public static final int DETAIL_MODULATE
+
+Deprecated methods:
+ public void setDetailImage(ImageComponent2D
+detailTexture)
+ public ImageComponent2D getDetailImage()
+ public void setDetailTextureMode(int mode)
+ public int getDetailTextureMode()
+ public void setDetailTextureLevel(int level)
+ public int getDetailTextureLevel()
+ public void setDetailTextureFunc(float[] lod,
+float[] pts)
+ public void setDetailTextureFunc(Point2f[] pts)
+ public int getDetailTextureFuncPointsCount()
+ public void getDetailTextureFunc(float[] lod,
+float[] pts)
+ public void getDetailTextureFunc(Point2f[] pts)
+
+ ImageComponent
+Deprecated methods:
+ public void setYUp(boolean yUp)
+
+II. Accepted Changes
+
+III. Deferred Changes
+
+Java 3DTM 1.4.0 Release
+Instructions for Installing Java 3D 1.4.0
+
+Linux
+
+cd /usr/java/jdk1.5.0_06/jre
+
+sh /path-to-download-files/java3d-1_4_0-linux-i586.bin
+
+Solaris
+
+cd /usr/java/jdk1.5.0_06/jre
+
+sh /path-to-download-files/java3d-1_4_0-solaris-x86.bin
+
+Windows
+
+Java 3DTM 1.4.0 Release
+Instructions for Unzipping Java 3D 1.4.0
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Java 3DTM 1.4.0 Release Notes
+
+ System Requirements
+(Solaris/Sparc, Solaris/x86,
+ Linux, Windows)
+
+ Changes Since 1.3.2
+ More Information
+System Requirements
+Solaris/Sparc
+
+
+pkginfo -l SUNWglrt". OpenGL for Solaris can be
+obtained at: http://www.sun.com/software/graphics/opengl/Solaris/x86
+
+
+
+ Linux
+
+
+
+
+
+ Windows
+
+
+
+
+
+
+ OpenGL version
+
+
+The (default) OpenGL renderer of Java 3D requires OpenGL 1.2 or
+later,
+available from your graphics card manufacturer.
+
+
+ DirectX version
+
+
+The (optional) DirectX renderer of Java 3D requires DirectX 9.0 or
+later, which is available from Microsoft at: http://www.microsoft.com/windows/directx/
+. The DirectX version of
+Java 3D is selected by setting the "
+j3d.rend" system
+property
+to "d3d",
+for example:
+
+
+ java -Dj3d.rend=d3d ClassName
+ Changes Since 1.3.2
+New Features
+
+
+
+
+
+ System Properties
+
+
+
+j3d.shadingLanguage – sets the shading language to
+use for programmable shaders. Supported values are: "GLSL" or "Cg". The
+default value is "GLSL".
+ j3d.simulatedMultiTexture – If this flag is set to
+true, simulation of multi-texturing will be done on systems that don't
+have sufficient texture units. The default value is false. This does
+not work with programmable shading, and will not be supported in 1.5.0.
+ Issues Fixed
+
+
+
+
+
+
+ Issue
+
+
+
+ Description
+
+
+
+ 17
+
+
+ DirectX GraphicsConfiguration Issue
+
+
+ 67
+
+ Transparency mode update didn't
+get reflected correctly
+
+
+ 78
+
+
+ Rendering stops if there's an exception in the EventDispatch
+
+
+ 100
+
+ Offscreen Capture crash JVM
+
+
+ 109
+
+ Frame Delays in Mixed Mode
+Rendering
+
+
+ 116
+
+ Handling of picking on
+OrientatedShape3D needs clarification
+
+
+ 117
+
+ Texture subimage is not
+optimized for large subimages
+
+
+ 124
+
+ Improve picking performance /
+reduce garbage generation
+
+
+ 127
+
+ Geometry Picking fails when
+Shapes use Color4
+
+
+ 129
+
+ NPE when removing an opaque
+object that used to be transparent
+
+
+ 132
+
+ BufferedImage getData slow,
+causing poor Yup perf with updateSubImage
+
+
+ 133
+
+ NullPointerException, PickCanvas
+with GEOMETRY_INTERSECT_INFO and BoundingPolytope
+
+
+ 134
+
+ Canvas3D memory leak
+
+
+ 135
+
+ Java3D 1.3.2+ using DirectX 9.0
+
+
+ 137
+
+ Add new depthTestFunction
+attribute
+
+
+ 138
+
+ Add method to retrieve
+tessellated geometry from 3D font
+
+
+ 139
+
+ add other rasterOp modes.
+
+
+ 140
+
+ Object Leak in PickResult
+
+
+ 141
+
+ DirectX 9.0c for Java3D 1.4,
+including shaders
+
+
+ 144
+
+ ExponentialFog blending factor
+depends on canvas size
+
+
+ 145
+
+ Add stencil buffer support
+
+
+ 146
+
+ Additional blending functions in
+TransparencyAttributes
+
+
+ 163
+
+ Regression in view frustum
+culling
+
+
+ 164
+
+ Cannot load j3dcore-ogl-cg.dll
+library in JRE bin directory
+
+
+ 167
+
+ Transform3D reports matrix with
+NaN to be affine
+
+
+ 169
+
+ TextureLoader should throw an
+exception instead of printing cryptic message to System.err
+
+
+ 170
+
+ TextureLoader should throw
+exception when loading image
+
+
+ 175
+
+ OffScreenRendering: Issue with
+Updating Texture Size from Behavior
+
+
+
+ 181
+
+ Performance regression:
+j3d.optimizeForSpace=false ignored for some geometry
+
+
+ 182
+
+ ShaderProgram not implemented
+for immediate mode rendering
+
+
+ 183
+
+ NPE if
+CLOSEST_INTERSECTION_POINT is only flag
+
+
+ 184
+
+ Illegal return value if flag
+NODE is omitted
+
+
+ 185
+
+ "Missing" essential methods in
+IntersectionInfo
+
+
+ 186
+
+ Using new Pick API with
+PickSegment often returns null
+
+
+ 187
+
+ NPE for new PickFast PickInfo
+when getting geometries
+
+
+ 195
+
+ Finish CgShader vertex
+attributes native methods
+
+
+ 196
+
+ Finish CgShader shader
+attributes native methods
+
+
+ 199
+
+ New Picking system only return 1
+result per geometry
+
+
+ 201
+
+ D3D :
+UnsatisfiedLinkError encountered with closing windows
+
+
+ 202
+
+ Need to upgrade to latest
+glext.h header file
+
+
+ 203
+
+ System.currentTimeMillis is too
+inaccurate on Windows for fine-grained timing
+
+
+ 207
+
+ Viewer.java throws exception
+with leading \n
+
+
+ 208
+
+ Sound nodes cannot be placed
+below Switch groups
+
+
+ 212
+
+ PureImmediate test fails to
+rotate
+
+
+ 217
+
+ Compile j3d with
+"-g:lines,source" to provide line numbers on stack traces
+
+
+
+223
+
+ JVM crashes when execute
+IndexedGeometryArray object with Texture coordinates
+ More Information
+
+
+Java 3DTM 1.5.0 Release
+Instructions for Installing Java 3D 1.5.0
+
+Linux
+
+cd /usr/java/jdk1.5.0_08/jre
+
+sh /path-to-download-files/java3d-1_5_0-linux-i586.bin
+
+Solaris
+
+cd /usr/java/jdk1.5.0_08/jre
+
+sh /path-to-download-files/java3d-1_5_0-solaris-x86.bin
+
+Windows
+
+
+Mac OS X
+No installer is currently available for the Mac OS X operating
+environment. You will need to download the
+java3d-1_5_0-macosx.zip
+file and manually install
+the
+necessary files into your JRE. After you unzip this file, follow
+the instructions in the unzipped README.txt file.
+
+
diff --git a/j3d-core/release-info/fcs-1_5_0/README-unzip.html b/j3d-core/release-info/fcs-1_5_0/README-unzip.html
new file mode 100644
index 0000000..be3b583
--- /dev/null
+++ b/j3d-core/release-info/fcs-1_5_0/README-unzip.html
@@ -0,0 +1,134 @@
+
+
+
+
+
+Java 3DTM 1.5.0 Release
+Instructions for Unzipping Java 3D 1.5.0 Release
+The 1.5.0 version of the
+Java 3DTM
+API runs on JDK version 1.5.0 and higher. It has been released for
+the Solaris, Linux, Windows, and Mac OS X
+operating
+environments.
+
+Windows
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Linux,
+Solaris, Mac OS X
+
+
+
+
+
+
+
+
+ cd /tmp
+ unzip java3d-1_5_0-*.zip
+
+This will create a
+"java3d-1_5_0-XXX" subdirectory in /tmp where the
+downloaded files can be found. The file you need for manual
+installation is "j3d-jre.zip".
+
+
+
+
+
+ cd /usr/java/jdk1.5.0_08/jre
+ unzip /tmp/java3d-1_5_0-*/j3d-jre.zip
+
+Verify that the j3dcore.jar, j3dutils.jar, and vecmath.jar files end up
+in
+"/usr/java/jdk1.5.0_08/jre/lib/ext"
+
+
+
diff --git a/j3d-core/release-info/fcs-1_5_0/README.html b/j3d-core/release-info/fcs-1_5_0/README.html
new file mode 100644
index 0000000..4ea4faf
--- /dev/null
+++ b/j3d-core/release-info/fcs-1_5_0/README.html
@@ -0,0 +1,806 @@
+
+
+
+
+
+ Java 3DTM 1.5.0
+Release Notes
+
+ System Requirements
+(Solaris Sparc, Solaris
+x86, Linux, Windows, Mac OS X)
+
+ Improvements in 1.5.0
+ JOGL Rendering Pipeline
+ More Information
+System Requirements
+Solaris Sparc
+
+
+pkginfo -l SUNWglrt". OpenGL for Solaris can be
+obtained at: http://www.sun.com/software/graphics/opengl/Solaris x86
+
+
+Linux
+
+
+
+
+Windows
+
+
+
+
+
+
+ OpenGL version
+
+
+The (default) OpenGL renderer of Java 3D requires OpenGL 1.3 or
+later,
+available from your graphics card manufacturer.
+
+
+ DirectX version
+
+
+The (optional) DirectX renderer of Java 3D requires
+DirectX 9.0 or
+later, which is available from Microsoft at: http://www.microsoft.com/windows/directx/
+. The DirectX version of
+Java 3D is selected by setting the "
+j3d.rend" system
+property
+to "d3d",
+for example:
+
+
+ java -Dj3d.rend=d3d ClassName
+ Mac OS X
+
+
+
+
+you can click
+here for a direct link to the download folder
+
+
+ Improvements in 1.5.0
+New Features / Enhancements
+
+
+
+
+ Issues Fixed in 1.5.0
+
+
+
+
+
+
+
+ Issue
+
+ Description
+
+
+ 40
+
+ Transparency color not correct
+on UCIO geometry and OffScreen canvas
+
+
+ 75
+
+ Memory leak in SetLiveState when
+branchGroup remove
+
+
+ 84
+
+ Rendering pauses after Canvas3D
+disposal until AWT event
+
+
+ 85
+
+ Optimize the downloading of ARGB
+textures
+
+
+ 92
+
+ ImageComponent2D.setSubImage()
+uses incorrect image sizes
+
+
+ 93
+
+ ImageComponent2D.setSubImage()
+does not correctly update the display
+
+
+ 113
+
+ NPE in updateAlphaInVertexData
+on multiple screens
+
+
+ 121
+
+ Stop using finalize() to clean
+up state
+
+
+ 123
+
+ Reduce or eliminate use of
+memory free lists
+
+
+ 131
+
+ Lightweight Canvas3D
+
+
+ 147
+
+ Need Windows/amd64 port of Java
+3D
+
+
+ 152
+
+ NPE in updateNodeComponent
+
+
+ 160
+
+ AlternateAppearance behaves
+defferently in J3D 1.3.2 comparing to J3D 1.3.1
+
+
+ 162
+
+ Textures are randomly incorrect
+in multi-screen mode with LG3D
+
+
+ 172
+
+ Texture.setImage fails to check
+ImageComponent sizes when not live
+
+
+ 180
+
+ Frame-dependent Large Texture
+Updates leads to OOM Exception
+
+
+ 194
+
+ Provide NIOBuffer texture
+components
+
+
+ 198
+
+ Need more shader example programs
+
+
+ 209
+
+ PolygonAttributes.isCompiled()
+returns false after the scenegraph's BranchGroup is compiled.
+
+
+ 216
+
+ J3DTimer should use
+clock_gettime on Linux
+
+
+ 219
+
+ Add support for Non Power of Two
+textures
+
+
+ 220
+
+ Matrix3d.set(AxisAngle4d) sets
+incorrectly if axis vector not normalized
+
+
+ 221
+
+ UnsatisfiedLinkError if shading
+language set to Cg on d3d
+
+
+ 224
+
+ NPE While Toggling Visibility
+
+
+ 225
+
+ BY_REF Support for
+CoordinateIndices To Reduce Memory Bloat
+
+
+ 227
+
+ Serialization problem with
+vecmath
+
+
+ 229
+
+ Need to implement JOGL renderer
+
+
+ 235
+
+ Null Pointer in AttributeBin
+
+
+ 238
+
+ Exception in thread
+J3D-MasterControl-1 when setting TextureUnitState to 0-length array
+
+
+ 240
+
+ Canvas3D.queryProperties reports
+stencil available even when it is not
+
+
+ 241
+
+ Texture3D by Reference Fails
+
+
+ 244
+
+ ClassCastException in
+Group.setChild
+
+
+ 245
+
+ Problem with
+ALLOW_RENDERING_ATTRIBUTES_WRITE in Appearance
+
+
+ 246
+
+ Move compressed geometry code
+from core to utils
+
+
+ 247
+
+ SHADER_ATTRIBUTE_TYPE_ERROR is
+fired when ShaderAttributeArray is used (OpenGL and GLSL shaders used)
+
+
+ 248
+
+ Wrong spec. on the setFlags()
+method of com.sun.j3d.utils.pickfast.PickTool
+
+
+ 249
+
+ NullpointerException in
+MasterControlThread when adding a Light
+
+
+ 251
+
+ Typo, in spec. PickTool.PickAny
+and PickTool.PickClosest return is wrong
+
+
+ 252
+
+ Offscreen Canvas3D/Screen3D
+error reporting (pbuffer allocation)
+
+
+ 253
+
+ Transform3D's incorrectly
+identified as Affine
+
+
+ 260
+
+ Obsolete graphics library
+version kills renderer thread, cannot be detected by app
+
+
+ 264
+
+ Behaviors that throw an Error
+cause the BehaviorScheduler to die
+
+
+ 266
+
+ Canvas3D should throw NPE by
+default for null graphicsConfig
+
+
+ 267
+
+ TextureLoader should autodetect
+alpha and colours
+
+
+ 268
+
+ Replace native
+getNumberOfProcessor() with pure Java equiv?
+
+
+ 269
+
+ GLSL on nVidia cards: Confict of
+a builtin vertex attribute (named gl_Normal) and a bound generic vertex
+attribute
+
+
+ 275
+
+ sleep for
+setMinimumFrameCycleTime should not hold lock
+
+
+ 279
+
+ Intermittent hang in
+MasterControl while running lg3d
+
+
+ 283
+
+ Add Eclipse plugin defs to
+manifest
+
+
+ 288
+
+ Objects in RenderBin free lists
+keep reference to user data
+
+
+ 295
+
+ Texture3D throws
+ArrayIndexOutOfBoundsException when scaleImage
+
+
+ 308
+
+ WakeupOnElapsedTime occasionally
+doesn't wake up on elapsed time
+
+
+ 311
+
+ Broken build for linux on ppc.
+
+
+ 312
+
+ Exception while detaching
+ModelClip from ViewSpecificGroup
+
+
+ 313
+
+ Geometry Stress Test results in
+OOM Error
+
+
+ 318
+
+ Cannot build on Itanium Linux
+
+
+ 320
+
+ Shader Appearance update is
+asynchronous to transform update
+
+
+ 321
+
+ bug in
+vecmath.Matrix3d.set(AxisAngle a1)
+
+
+ 323
+
+ Deprecate optional detail
+texture functionality
+
+
+ 324
+
+ Lockup Java3D program and throw
+exception using JOGL renderer
+
+
+ 325
+
+ This Tuple4d is epsilonEquals to
+all others: (NaN, NaN, NaN, NaN)
+
+
+ 326
+
+ PrintCanvas3D on JOGL pipeline
+crashes on Linux and Solaris
+
+
+ 327
+
+ javadoc for VIew class doesn't
+list correct clip policy defaults
+
+
+ 328
+
+ JOGL pipeline : Geometry fails
+to render in Cosmic Birdie
+
+
+ 331
+
+ Add .cvsignore file to root of
+vecmath.
+
+
+ 336
+
+ Unable to redraw when resizing
+using JOGL pipeline
+
+
+ 338
+
+ Bug in glPushAttrib usage in
+NativePipeline
+
+
+ 339
+
+ Java crashes when using GLSL
+shaders
+
+
+ 340
+
+ Resource leak in
+setOffScreenBuffer, NPE in JOGL pipeline
+
+
+ 341
+
+ Initializing audio device using
+Webstart throws ClassNotFoundException
+
+
+ 342
+
+ Raster.setDstOffset() set the
+destination pixel offset in opposite direction
+
+
+ 344
+
+ Too much time to load image as
+Texture
+
+
+ 349
+
+ OffScreen Canvas3D needlessly
+forces power-of-two for its buffer
+
+
+ 351
+
+ Need a new mechanism to free D3D
+surface
+
+
+ 352
+
+ VC compiler generates warning on
+Windows AMD64 build
+
+
+ 353
+
+ GeometryArray Memory Leak
+
+
+ 355
+
+ IndexedXXXStripArray throws NPE
+with ByRef Indices
+
+
+ 356
+
+ Exception in RenderBin when
+removing a Shape3D with no geometry
+
+
+ 358
+
+ Document that OGL 1.2 is
+supported, but at reduced functionality
+
+
+ 360
+
+ SceneGraphStreamWriter.writeBranchGraph
+throws exception
+
+
+ 366
+
+ Raster appears without image on
+systems without NPOT support
+
+
+ 367
+
+ Clip throws NPE in case of
+region = null in a live scene
+
+
+ 368
+
+ Background texture doesn't work
+on system with no NPOT support
+
+
+ 370
+
+ Deadlock when calling
+Raster.setimage from user thread
+
+
+ 371
+
+ Poor raster quality for systems
+that don't support NPOT textures
+
+
+ 372
+
+ ImageComponent.set(BufferedImage)
+ignored when used by Raster
+
+
+ 373
+
+ ImageComponent.set(BufferedImage)
+ignored when used by Background
+
+
+ 374
+
+ Exception when calling
+Background.setImage on live scene graph
+
+
+ 379
+
+ Needs NPOT support documented in
+Texture, Texture3D and TextureCubeMap
+
+
+ 380
+
+ NPE when uncheck Show Color
+Texture in Dot3 demo
+
+
+ 383
+
+ JCanvas3D's offscreen Canvas3D
+is inverted.
+
+
+ 392
+
+ Texture loading regression for
+optimized RGB PNG files
+
+
+ 393
+
+ TextureLoader regression on
+BufferedImage.TYPE_BYTE_INDEXED
+
+
+ 395
+
+ JCanvas3D / JOGL: Program freezes
+
+
+ 400
+
+ Lighting differs with various
+renderers
+
+
+
+403
+
+ AssertionError while changing
+(offscreen) Texture size
+
+JOGL Rendering Pipeline
+
+j3d.rend"
+system
+property
+to "jogl",
+for example:
+
+
+java -Dj3d.rend=jogl ClassName
+
+More Information
+
+Java 3DTM
+1.5.1 Release
+
+
+Instructions for Installing Java 3D 1.5.1
+
+
+
+
+
+Linux
+
+
+
+
+
+cd /usr/java/jdk1.6.0_01/jre
+
+
+
+
+
+sh /path-to-download-files/java3d-1_5_1-linux-i586.bin
+
+
+
+
+
+Solaris
+
+
+
+
+
+cd /usr/java/jdk1.6.0_01/jre
+
+
+
+
+
+sh /path-to-download-files/java3d-1_5_1-solaris-x86.bin
+
+
+
+
+
+Windows
+
+
+
+
+
+
+
+
+Mac OS X
+
+
+No installer is currently available for the Mac OS X operating
+environment. You will need to download the
+java3d-1_5_1-macosx.zip
+file and manually install
+the
+necessary files into your JRE. After you unzip this file, follow
+the instructions in the unzipped README.txt file.
+
+
diff --git a/j3d-core/release-info/fcs-1_5_1/README-unzip.html b/j3d-core/release-info/fcs-1_5_1/README-unzip.html
new file mode 100644
index 0000000..d615077
--- /dev/null
+++ b/j3d-core/release-info/fcs-1_5_1/README-unzip.html
@@ -0,0 +1,213 @@
+
+
+
+
+
+
+
+
+Java 3DTM
+1.5.1 Release
+
+Instructions for Unzipping Java 3D 1.5.1 Release
+
+The 1.5.1 version of the
+Java 3DTM
+API runs on JDK version 1.5.0 and higher. It has been released for
+the Solaris, Linux, Windows,
+and Mac OS X
+operating
+environments.
+
+
+
+Windows
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Linux,
+Solaris, Mac OS X
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ cd /tmp
+
+ unzip java3d-1_5_1-*.zip
+
+
+
+This will create a
+"java3d-1_5_1-XXX" subdirectory in /tmp where the
+downloaded files can be found. The file you need for manual
+installation is "j3d-jre.zip".
+
+
+
+
+
+
+
+
+
+
+
+ cd /usr/java/jdk1.6.0_01/jre
+
+ unzip /tmp/java3d-1_5_1-*/j3d-jre.zip
+
+
+
+Verify that the j3dcore.jar, j3dutils.jar, and vecmath.jar files end up
+in
+"/usr/java/jdk1.6.0_01/jre/lib/ext"
+
+
+
+
+
diff --git a/j3d-core/release-info/fcs-1_5_1/README.html b/j3d-core/release-info/fcs-1_5_1/README.html
new file mode 100644
index 0000000..1a7b139
--- /dev/null
+++ b/j3d-core/release-info/fcs-1_5_1/README.html
@@ -0,0 +1,1085 @@
+
+
+
+
+
+
+ Java 3DTM
+1.5.1
+Release Notes
+
+
+
+ System Requirements
+(Solaris Sparc, Solaris
+x86, Linux, Windows, Mac
+OS X)
+
+
+
+ Improvements in
+1.5.1
+
+ JOGL Rendering Pipeline
+
+ More Information
+
+System
+Requirements
+
+Solaris Sparc
+
+
+
+
+
+pkginfo -l SUNWglrt". OpenGL for Solaris
+can be
+obtained at: http://www.sun.com/software/graphics/opengl/Solaris x86
+
+
+
+
+
+Linux
+
+
+
+
+
+
+
+
+
+Windows
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OpenGL version
+
+
+
+
+
+The (default) OpenGL renderer of Java 3D requires OpenGL 1.3
+or
+later,
+available from your graphics card manufacturer.
+
+
+
+
+ DirectX version
+
+
+
+
+
+The (optional) DirectX renderer of Java 3D requires
+DirectX 9.0 or
+later, which is available from Microsoft at: http://www.microsoft.com/windows/directx/
+. The DirectX version of
+Java 3D is selected by setting the "
+
+ j3d.rend"
+system
+property
+to "d3d",
+for example:
+
+
+
+
+ java -Dj3d.rend=d3d ClassName
+
+
+NOTE: The DirectX version of Java 3D is used if a suitable version of
+OpenGL cannot be found. Note also that DirectX is chosen by default on
+Windows Vista systems with an ATI graphics card (due to ATI driver
+bugs).
+Mac OS X
+
+
+
+
+
+
+
+
+
+you can click
+here for a direct link to the download folder
+
+
+
+
+
+ Improvements
+in 1.5.1
+
+Enhancements
+
+
+
+
+
+Issues Fixed in 1.5.1
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Issue
+
+
+
+ Description
+
+
+
+
+
+ 126
+
+
+
+ Use OpenGL
+automatic mipmap generation
+
+
+
+
+
+ 157
+
+
+
+ Would like a
+JOALMixer implementation of AudioEngine3DL2
+
+
+
+
+
+ 197
+
+
+
+ Consider supporting
+pack200 for Java Web Start / JNLP
+
+
+
+
+
+ 226
+
+
+
+ D3D : fail on
+stress test for the creation and destruction of Canvases
+
+
+
+
+
+ 239
+
+
+
+ Stencil buffer
+should be cleared at the start of each frame
+
+
+
+
+
+ 257
+
+
+
+ Java3D Applet
+Launcher support
+
+
+
+
+
+ 274
+
+
+
+ NPE With
+Simultaneous View and Content Side PickingBehaviors
+
+
+
+
+
+ 293
+
+
+
+ Need better logging
+for j3d error, warning, assertion messages.
+
+
+
+
+
+ 314
+
+
+
+ Issue with
+Stenciled Transparent Objects
+
+
+
+
+
+ 347
+
+
+
+ OffScreen Canvas3D
+always reloads textures, display lists
+
+
+
+
+
+ 348
+
+
+
+ Programmable
+shaders do not work for OffScreen Canvas3D
+
+
+
+
+
+ 357
+
+
+
+ Memory leak when
+using textures with multiple views
+
+
+
+
+
+ 362
+
+
+
+ dynamic assignment
+if Canvas3D to View makes content disappear
+
+
+
+
+
+ 364
+
+
+
+ Canvas3D.setOffScreenBuffer(null)
+sometimes hangs
+
+
+
+
+
+ 378
+
+
+
+ Shaders are not
+rendered when Canvas3D is created and destroyed
+
+
+
+
+
+ 381
+
+
+
+ ByRef, yDown,
+4BYTE_ABGR throws ArrayIndexOOB Exception
+
+
+
+
+
+ 396
+
+
+
+ Off-screen Canvas3D
+/ D3D: Resizing crashes VM
+
+
+
+
+
+ 402
+
+
+
+ Off-screen Canvas3D
+throws Exception on BufferedImage of TYPE_4BYTE_ABGR and TYPE_INT_ARGB
+
+
+
+
+
+ 408
+
+
+
+ Poor quality of
+auto-generated mipmaps
+
+
+
+
+
+ 411
+
+
+
+ Add Primitive flag
+to reverse Y for tex coords
+
+
+
+
+
+ 412
+
+
+
+ Exception when
+updating Y_UP BY_REFERENCE image
+
+
+
+
+
+ 414
+
+
+
+ D3D: NPOT textures
+not properly disabled on card that lacks support
+
+
+
+
+
+ 415
+
+
+
+ Need ability to
+disable NPOT textures for raster/background
+
+
+
+
+
+ 416
+
+
+
+ JOGL:
+ClassCastException in Renderer with NioImageBuffer
+
+
+
+
+
+ 417
+
+
+
+ JOGL: Mip-mapped
+NPOT textures rendered incorrectly
+
+
+
+
+
+ 424
+
+
+
+ JOALMixer requires
+the default Viewer's setUserHeadToVworldEnable setting to true
+
+
+
+
+
+ 425
+
+
+
+ NullPointerException
+in automatic mipmap generation
+
+
+
+
+
+ 427
+
+
+
+ Method with
+constructor name: ObjectFileMaterial
+
+
+
+
+
+ 430
+
+
+
+ Deliver JOALMixer
+for JNLP and download bundle
+
+
+
+
+
+
+
+ 431
+
+
+
+ disabled PointSound
+starts playing when scheduling bounds are entered
+
+
+
+
+
+ 433
+
+
+
+ JCanvas3D crashed
+when using jogl pipe
+
+
+
+
+
+ 434
+
+
+
+ OutOfMemory after
+creating millions of RenderAtomListInfo objects
+
+
+
+
+
+ 437
+
+
+
+ SceneGraphStreamWriter
+NPE
+
+
+
+
+
+ 435
+
+
+
+ Memory leak when
+reusing an Appearance with a single Texture
+
+
+
+
+
+ 438
+
+
+
+ ConfiguredUniverse
+& SimpleUniverse constructor missing
+
+
+
+
+
+ 441
+
+
+
+ ArrayIndexOutOfBoundsException
+in IndexedTriangleArrayRetained Intersect
+
+
+
+
+
+ 444
+
+
+
+ Transform updates
+overly expensive
+
+
+
+
+
+ 446
+
+
+
+ JCanvas3D and focus
+
+
+
+
+
+ 447
+
+
+
+ Enhance Element
+Traversal To Improve Pick Hits
+
+
+
+
+
+ 449
+
+
+
+ SceneGraphIO can
+not support ImageComponent2DURL
+
+
+
+
+
+ 452
+
+
+
+ Java 3D should fall
+back to D3D if OpenGL not available
+
+
+
+
+
+ 453
+
+
+
+ SceneGraphIO does
+not support SceneGraphObjects name field
+
+
+
+
+
+ 455
+
+
+
+ Need to disable
+NPOT textures for older cards that claim to support it.
+
+
+
+
+
+ 456
+
+
+
+ NPOT background (
+maybe raster) fail to work if HW doesn't support NPOT texture
+
+
+
+
+
+ 457
+
+
+
+ ClassCastException
+in MasterControl when updating Texture3D
+
+
+
+
+
+ 458
+
+
+
+ Canvas3D stops
+rendering on window close
+
+
+
+
+
+ 461
+
+
+
+ ClassCastException
+thrown when using filters with NioImageBuffer
+
+
+
+
+
+ 466
+
+
+
+ NPE when updating
+lights with multiple views
+
+
+
+
+
+ 467
+
+
+
+ Add Java3D source
+jar file as a separate or part of the distribution
+
+
+
+
+
+ 468
+
+
+
+ SceneGraphStreamReader/Writer
+do not close the stream
+
+
+
+
+
+ 470
+
+
+
+ Need informative
+error message for mismatched NioImageBuffer
+
+
+
+
+
+ 471
+
+
+
+ Performance
+degradation with shader attribute object setValue()
+
+
+
+
+
+ 474
+
+
+
+ Update javadoc for
+TextureLoader for ImageException
+
+
+
+
+
+ 478
+
+
+
+ Memory leak in
+TransparencySortController
+
+
+
+
+
+ 479
+
+
+
+ JOGL: Screen door
+transparency renders incorrectly on JoglPipeline
+
+
+
+
+
+ 480
+
+
+
+ getBounds should
+cache results
+
+
+
+
+
+ 481
+
+
+
+ JOALSample: cannot
+load if only URLString is given in MediaContainer
+
+
+
+
+
+ 485
+
+
+
+ ClassCastException
+when switching shaders in PhongShadingGLSL example
+
+
+
+
+
+ 486
+
+
+
+ Java 3D hangs on
+some Windows Vista systems
+
+
+
+
+
+ 488
+
+
+
+ ImageComponent3D
+bug with by-reference images
+
+
+
+
+
+ 489
+
+
+
+ AutoOffScreenCanvas3D:
+postSwap() is called twice
+
+
+
+
+
+ 490
+
+
+
+ JOALSample fails to
+load second sample
+
+
+
+
+
+ 491
+
+
+
+ Refactor
+platform-specific classes to use non-overlapping class names
+
+
+
+
+
+ 492
+
+
+
+ ImageComponent2D.setSubImage
+throws IllegalArgumentException
+
+
+
+
+
+ 494
+
+
+
+ Group.moveto(null)
+throws a NullPointerException
+
+
+
+
+
+
+
+ 496
+
+
+
+ Big performance hit
+in VirtualUniverse.getNodeId
+
+
+
+
+
+
+
+
+500
+
+
+
+ Reuse JOAL buffers
+where possible
+
+
+
+
+
+JOGL Rendering
+Pipeline
+
+
+
+j3d.rend"
+system
+property
+to "jogl",
+for example:
+
+
+
+
+java -Dj3d.rend=jogl ClassName
+
+
+More
+Information
+
+
+
+Java 3DTM 1.5.2 Release
+Instructions for Installing Java 3D 1.5.2
+Preferred method
+
+Alternative method
+
+Windows
+Linux or Solaris
+
+cd /myhome/j3d
+
+
+sh /path-to-download-files/j3d-1_5_2-linux-i586.bin
+
+export CLASSPATH=".:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar
+
+
+
+export LD_LIBRARY_PATH=/myhome/j3d/lib/i386
+
+
+Mac OS X
+Java 3DTM 1.5.2 Release
+Instructions for Unzipping the Java 3D 1.5.2 Release
+Windows
+
+
+j3d-1_5_2-XXX.zip
+(using Windows
+Explorer or an unzip tool such as WinZip) to a temporary
+download folder,
+for example, c:\Downloads. This will
+create a j3d-1_5_2-XXX subfolder in
+your download folder where the
+downloaded files can be found. The file you need for manual
+installation is j3d-jre.zip.
+
+ C:\Users\myhome\j3d, and
+unzip j3d-jre.zip into this folder.
+
+ CLASSPATH environment
+variable to include the full paths to j3dcore.jar,
+ j3dutils.jar, and vecmath.jar.
+For example, add the following to your CLASSPATH
+variable,
+using the System control panel, Advanced tab, Environment Variables
+button:
+
+ .;C:\Users\myhome\j3d\lib\ext\j3dcore.jar;C:\Users\myhome\j3d\lib\ext\j3dutils.jar;C:\Users\myhome\j3d\lib\ext\vecmath.jar
+
+
+ PATH environment
+variable to contain the full path to the lib\i386
+folder (or lib\amd64 for
+Windows/x64). For example, on 32-bit Windows, add the following to your
+ PATH variable, using the System control
+panel, Advanced tab, Environment Variables button.
+
+ C:\Users\myhome\j3d\lib\i386
+
+Linux,
+Solaris
+
+
+j3d-1_5_2-XXX.zip
+into a temporary
+download directory,
+for example, /tmp. This will
+create a j3d-1_5_2-XXX subdirectory
+in /tmp where the
+downloaded files can be found. The file you need for manual
+installation is j3d-jre.zip.
+
+ /myhome/j3d, and
+unzip j3d-jre.zip into this directory
+as follows:
+
+
+
+ cd /myhome/j3d
+ unzip /tmp/j3d-1_5_2-*/j3d-jre.zip
+
+ CLASSPATH environment
+variable to include the full paths to j3dcore.jar,
+ j3dutils.jar, and vecmath.jar.
+For example:
+
+ export
+CLASSPATH=.:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar
+
+ LD_LIBRARY_PATH
+environment
+variable to contain the full path to the lib/<ARCH>
+directory. For example, on 32-bit Linux:
+
+ export LD_LIBRARY_PATH=/myhome/j3d/lib/i386
+ Mac OS X
+
+
+j3d-1_5_2-XXX.zip
+into a temporary
+download directory,
+for example, /tmp. This will
+create a j3d-1_5_2-XXX subdirectory
+in /tmp where the
+downloaded files can be found. The file you need for manual
+installation is j3d-jre.zip.
+
+ /myhome/j3d, and
+unzip j3d-jre.zip into this directory
+as follows:
+
+
+
+ cd /myhome/j3d
+ unzip /tmp/j3d-1_5_2-*/j3d-jre.zip
+
+ CLASSPATH environment
+variable to include the full paths to j3dcore.jar,
+ j3dutils.jar, and vecmath.jar.
+For example:
+
+ export
+CLASSPATH=.:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar
+
+ /tmp.
+
+ /myhome/jogl, and
+unzip jogl-*.zip into this directory
+as follows:
+
+
+
+ cd /myhome/jogl
+ unzip /tmp/jogl-*.zip
+
+ CLASSPATH environment
+variable to include the full paths to jogl.jar
+and gluegen-rt.jar.
+For example:
+
+ export
+CLASSPATH="${CLASSPATH}:/myhome/jogl/lib/jogl.jar:/myhome/jogl/lib/gluegen-rt.jar
+
+ DYLD_LIBRARY_PATH
+environment
+variable to contain the full path to the lib
+directory. For example:
+
+ export DYLD_LIBRARY_PATH=/myhome/jogl/lib
+ Java 3DTM 1.5.2
+Release Notes
+
+ System Requirements
+(Solaris Sparc, Solaris
+x86, Linux, Windows, Mac OS X)
+
+ Improvements in 1.5.2
+ JOGL Rendering Pipeline
+ More Information
+System Requirements
+Solaris Sparc
+
+
+pkginfo -l SUNWglrt". OpenGL for Solaris can be
+obtained at: http://www.sun.com/software/graphics/opengl/Solaris x86
+
+
+Linux
+
+
+
+
+Windows
+
+
+
+
+
+
+ OpenGL version
+
+
+The (default) OpenGL renderer of Java 3D requires OpenGL 1.3 or
+later,
+available from your graphics card manufacturer.
+
+
+ DirectX version
+
+
+The (optional) DirectX renderer of Java 3D requires
+DirectX 9.0 or
+later, which is available from Microsoft at: http://www.microsoft.com/windows/directx/
+. The DirectX version of
+Java 3D is selected by setting the "
+ j3d.rend" system
+property
+to "d3d",
+for example:
+
+
+ java -Dj3d.rend=d3d ClassName
+
+ NOTE: The DirectX version of Java 3D is used if a suitable version
+ of OpenGL cannot be found. Note also that DirectX is chosen by
+ default on Windows Vista systems with an ATI graphics card (due to
+ ATI driver bugs).
+Mac OS X
+
+
+
+
+you can click
+here for a direct link to the download folder
+
+
+ Improvements in 1.5.2
+Enhancements
+
+
+Issues Fixed in 1.5.2
+
+
+
+
+
+
+ Issue
+
+ Description
+
+
+ 179
+
+ OrbitBehavior.setRotationCenter gives spurious view shift
+
+
+ 483
+
+ NullPointerException when writing Font3D using scenegraph.io
+
+
+ 506
+
+ NullPointerException: Calling getNominalSensorRotation in WandViewBehavior when internal nominalSensorRotation is null causes a NullPointerException.
+
+
+ 510
+
+ J3DGraphics2D context lost when canvas changes frame
+
+
+ 513
+
+ Down-rev D3D driver can cause JVM to crash
+
+
+ 514
+
+ NPE in Wonderland : triggered in cached bounds computation
+
+
+ 519
+
+ IntersectionInfo.getGeometry return null for IndexedArrayGeometry
+
+
+ 525
+
+ JOALMixer only playing one sample
+
+
+ 532
+
+ Background geometry BG isn't saved with SceneGraphFileWriter
+
+
+ 534
+
+ ClassNotFoundException when running applet if Java 3D installed into JRE
+
+
+ 538
+
+ Machine precision bug in AxisAngle4d and Quat4d
+
+
+ 540
+
+ ArrayIndexOutOfBoundsException when calling setPickable
+
+
+ 541
+
+ Bound.closest_point() method creates unused Matrix3d
+
+
+ 543
+
+ J3DClock does not adjust to clock skew
+
+
+ 544
+
+ GroupRetained.getBounds() should return BoundingBox?
+
+
+ 545
+
+ Update docs to discourage installing Java 3D into JRE
+
+
+ 548
+
+ RFE - Disable getLock() / unLock() on non-alive GeometryArray
+
+
+ 555
+
+ Muting a PointSound causes a ClassCastException
+
+
+ 560
+
+ Use D3DCREATE_FPU_PRESERVE flag on D3D pipeline
+
+
+ 561
+
+ Decrease memory footprint of BoundingBox
+
+
+ 562
+
+ Error occurs when Canvas3D removed from View
+
+
+ 563
+
+ Background cloneNode() fails with Background geometry
+
+
+ 567
+
+ Update license to GPL v2 + CLASSPATH
+
+
+ 569
+
+ ImageComponent.ALLOW_IMAGE_READ is false
+
+
+ 583
+
+ A disposed Graphics2D remains in Canvas3D after removal and addtion
+
+
+
+585
+
+ ClassCastException in TransformStructure.java
+
+JOGL Rendering Pipeline
+
+j3d.rend"
+system
+property
+to "jogl",
+for example:
+
+
+java -Dj3d.rend=jogl ClassName
+
+More Information
+
+3D Graphics API for the Java Platform 1.5.2-beta2 Pre-Release
+Instructions for installing the 3D Graphics API for the Java Platform
+Preferred method
+
+Alternative method
+
+Windows
+Linux or Solaris
+
+cd /myhome/j3d
+
+
+sh /path-to-download-files/j3d-1_5_2-beta2-linux-i586.bin
+
+export CLASSPATH=".:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar
+
+
+
+export LD_LIBRARY_PATH=/myhome/j3d/lib/i386
+
+
+Mac OS X
+3D Graphics API for the Java Platform 1.5.2 Pre-Release
+Instructions for Unzipping 3D Graphics API for the Java
+Platform 1.5.2 Pre-Release
+Windows
+
+
+j3d-1_5_2-XXX.zip
+(using Windows
+Explorer or an unzip tool such as WinZip) to a temporary
+download folder,
+for example, c:\Downloads. This will
+create a j3d-1_5_2-XXX subfolder in
+your download folder where the
+downloaded files can be found. The file you need for manual
+installation is j3d-jre.zip.
+
+ C:\Users\myhome\j3d, and
+unzip j3d-jre.zip into this folder.
+
+ CLASSPATH environment
+variable to include the full paths to j3dcore.jar,
+ j3dutils.jar, and vecmath.jar.
+For example, add the following to your CLASSPATH
+variable,
+using the System control panel, Advanced tab, Environment Variables
+button:
+
+ .;C:\Users\myhome\j3d\lib\ext\j3dcore.jar;C:\Users\myhome\j3d\lib\ext\j3dutils.jar;C:\Users\myhome\j3d\lib\ext\vecmath.jar
+
+
+ PATH environment
+variable to contain the full path to the lib\i386
+folder (or lib\amd64 for
+Windows/x64). For example, on 32-bit Windows, add the following to your
+ PATH variable, using the System control
+panel, Advanced tab, Environment Variables button.
+
+ C:\Users\myhome\j3d\lib\i386
+
+Linux,
+Solaris
+
+
+j3d-1_5_2-XXX.zip
+into a temporary
+download directory,
+for example, /tmp. This will
+create a j3d-1_5_2-XXX subdirectory
+in /tmp where the
+downloaded files can be found. The file you need for manual
+installation is j3d-jre.zip.
+
+ /myhome/j3d, and
+unzip j3d-jre.zip into this directory
+as follows:
+
+
+
+ cd /myhome/j3d
+ unzip /tmp/j3d-1_5_2-*/j3d-jre.zip
+
+ CLASSPATH environment
+variable to include the full paths to j3dcore.jar,
+ j3dutils.jar, and vecmath.jar.
+For example:
+
+ export
+CLASSPATH=.:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar
+
+ LD_LIBRARY_PATH
+environment
+variable to contain the full path to the lib/<ARCH>
+directory. For example, on 32-bit Linux:
+
+ export LD_LIBRARY_PATH=/myhome/j3d/lib/i386
+ Mac OS X
+
+
+j3d-1_5_2-XXX.zip
+into a temporary
+download directory,
+for example, /tmp. This will
+create a j3d-1_5_2-XXX subdirectory
+in /tmp where the
+downloaded files can be found. The file you need for manual
+installation is j3d-jre.zip.
+
+ /myhome/j3d, and
+unzip j3d-jre.zip into this directory
+as follows:
+
+
+
+ cd /myhome/j3d
+ unzip /tmp/j3d-1_5_2-*/j3d-jre.zip
+
+ CLASSPATH environment
+variable to include the full paths to j3dcore.jar,
+ j3dutils.jar, and vecmath.jar.
+For example:
+
+ export
+CLASSPATH=.:/myhome/j3d/lib/ext/j3dcore.jar:/myhome/j3d/lib/ext/j3dutils.jar:/myhome/j3d/lib/ext/vecmath.jar
+
+ /tmp.
+
+ /myhome/jogl, and
+unzip jogl-*.zip into this directory
+as follows:
+
+
+
+ cd /myhome/jogl
+ unzip /tmp/jogl-*.zip
+
+ CLASSPATH environment
+variable to include the full paths to jogl.jar
+and gluegen-rt.jar.
+For example:
+
+ export
+CLASSPATH="${CLASSPATH}:/myhome/jogl/lib/jogl.jar:/myhome/jogl/lib/gluegen-rt.jar
+
+ DYLD_LIBRARY_PATH
+environment
+variable to contain the full path to the lib
+directory. For example:
+
+ export DYLD_LIBRARY_PATH=/myhome/jogl/lib
+ Java 3DTM 1.5.2-beta2
+Release Notes
+
+ System Requirements
+(Solaris Sparc, Solaris
+x86, Linux, Windows, Mac OS X)
+
+ Improvements in 1.5.2-beta2
+ JOGL Rendering Pipeline
+ More Information
+System Requirements
+Solaris Sparc
+
+
+pkginfo -l SUNWglrt". OpenGL for Solaris can be
+obtained at: http://www.sun.com/software/graphics/opengl/Solaris x86
+
+
+Linux
+
+
+
+
+Windows
+
+
+
+
+
+
+ OpenGL version
+
+
+The (default) OpenGL renderer of Java 3D requires OpenGL 1.3 or
+later,
+available from your graphics card manufacturer.
+
+
+ DirectX version
+
+
+The (optional) DirectX renderer of Java 3D requires
+DirectX 9.0 or
+later, which is available from Microsoft at: http://www.microsoft.com/windows/directx/
+. The DirectX version of
+Java 3D is selected by setting the "
+ j3d.rend" system
+property
+to "d3d",
+for example:
+
+
+ java -Dj3d.rend=d3d ClassName
+
+ NOTE: The DirectX version of Java 3D is used if a suitable version
+ of OpenGL cannot be found. Note also that DirectX is chosen by
+ default on Windows Vista systems with an ATI graphics card (due to
+ ATI driver bugs).
+Mac OS X
+
+
+
+
+you can click
+here for a direct link to the download folder
+
+
+ Improvements in 1.5.2-beta2
+Issues Fixed in 1.5.2-beta2
+
+
+
+
+
+
+ Issue
+
+ Description
+
+
+ 543
+
+ J3DClock does not adjust to clock skew
+
+
+
+583
+
+ A disposed Graphics2D remains in Canvas3D after removal and addtion
+ Improvements in 1.5.2-beta1
+Enhancements
+
+
+Issues Fixed in 1.5.2-beta1
+
+
+
+
+
+
+
+ Issue
+
+ Description
+
+
+ 179
+
+ OrbitBehavior.setRotationCenter gives spurious view shift
+
+
+ 483
+
+ NullPointerException when writing Font3D using scenegraph.io
+
+
+ 506
+
+ NullPointerException: Calling getNominalSensorRotation in WandViewBehavior when internal nominalSensorRotation is null causes a NullPointerException.
+
+
+ 513
+
+ Down-rev D3D driver can cause JVM to crash
+
+
+ 514
+
+ NPE in Wonderland : triggered in cached bounds computation
+
+
+ 519
+
+ IntersectionInfo.getGeometry return null for IndexedArrayGeometry
+
+
+ 525
+
+ JOALMixer only playing one sample
+
+
+ 532
+
+ Background geometry BG isn't saved with SceneGraphFileWriter
+
+
+ 534
+
+ ClassNotFoundException when running applet if Java 3D installed into JRE
+
+
+ 538
+
+ Machine precision bug in AxisAngle4d and Quat4d
+
+
+ 540
+
+ ArrayIndexOutOfBoundsException when calling setPickable
+
+
+ 541
+
+ Bound.closest_point() method creates unused Matrix3d
+
+
+ 544
+
+ GroupRetained.getBounds() should return BoundingBox?
+
+
+ 545
+
+ Update docs to discourage installing Java 3D into JRE
+
+
+ 548
+
+ RFE - Disable getLock() / unLock() on non-alive GeometryArray
+
+
+ 555
+
+ Muting a PointSound causes a ClassCastException
+
+
+ 560
+
+ Use D3DCREATE_FPU_PRESERVE flag on D3D pipeline
+
+
+ 561
+
+ Decrease memory footprint of BoundingBox
+
+
+ 562
+
+ Error occurs when Canvas3D removed from View
+
+
+ 563
+
+ Background cloneNode() fails with Background geometry
+
+
+ 567
+
+ Update license to GPL v2 + CLASSPATH
+
+
+
+569
+
+ ImageComponent.ALLOW_IMAGE_READ is false
+
+JOGL Rendering Pipeline
+
+j3d.rend"
+system
+property
+to "jogl",
+for example:
+
+
+java -Dj3d.rend=jogl ClassName
+
+More Information
+
+
+ *
+ *
Increasing Alpha parameters:loopCount -- This is the number of times to run this
+ * Alpha; a value of -1 specifies that the Alpha loops
+ * indefinitely.triggerTime -- This is the time in milliseconds since
+ * the start time that this object first triggers. If (startTime +
+ * triggerTime >= currentTime) then the Alpha object starts running.phaseDelayDuration -- This is an additional number of
+ * milliseconds to wait after triggerTime before actually starting
+ * this Alpha.mode -- This can be set to INCREASING_ENABLE,
+ * DECREASING_ENABLE, or the Or'ed value of the two.
+ * INCREASING_ENABLE activates the increasing Alpha parameters listed
+ * below; DECREASING_ENABLE activates the decreasing Alpha parameters
+ * listed below.
+ *
+ *
Decreasing Alpha parameters:increasingAlphaDuration -- This is the period of time
+ * during which Alpha goes from zero to one. increasingAlphaRampDuration -- This is the period of
+ * time during which the Alpha step size increases at the beginning of
+ * the increasingAlphaDuration and, correspondingly, decreases at the
+ * end of the increasingAlphaDuration. This parameter is clamped to
+ * half of increasingAlphaDuration. When this parameter is non-zero,
+ * one gets constant acceleration while it is in effect; constant
+ * positive acceleration at the beginning of the ramp and constant
+ * negative acceleration at the end of the ramp. If this parameter is
+ * zero, then the effective velocity of the Alpha value is constant
+ * and the acceleration is zero (ie, a linearly increasing alpha
+ * ramp).alphaAtOneDuration -- This is the period of time that
+ * Alpha stays at one.
+ *
+ *
+ *
+ * @see Interpolator
+ */
+
+public class Alpha extends NodeComponent {
+
+ // loopCount < -1 --> reserved
+ // loopCount == -1 --> repeat forever
+ // loopCount >= 0 --> repeat count
+ private int loopCount;
+
+ /**
+ * Specifies that the increasing component of the alpha is used.
+ */
+ public static final int INCREASING_ENABLE = 1;
+
+ /**
+ * Specifies that the decreasing component of the alpha is used
+ */
+ public static final int DECREASING_ENABLE = 2;
+
+ /**
+ * This alpha's mode, specifies whether to process
+ * increasing and decreasing alphas.
+ */
+ private int mode;
+
+ private float triggerTime;
+ private float phaseDelay;
+ private float increasingAlpha;
+ private long increasingAlphaRamp;
+ private float incAlphaRampInternal;
+ private float alphaAtOne;
+ private float decreasingAlpha;
+ private long decreasingAlphaRamp;
+ private float decAlphaRampInternal;
+ private float alphaAtZero;
+
+ // For pausing and resuming Alpha
+ private long pauseTime = 0L;
+ private boolean paused = false;
+
+ // Stop time gets used only for loopCount > 0
+ private float stopTime;
+
+ // Start time in milliseconds
+ private long startTime = MasterControl.systemStartTime;
+
+ /**
+ * Constructs an Alpha object with default parameters. The default
+ * values are as follows:
+ * decreasingAlphaDuration -- This is the period of time
+ * during which Alpha goes from one to zero.decreasingAlphaRampDuration -- This is the period of
+ * time during which the Alpha step size increases at the beginning of
+ * the decreasingAlphaDuration and, correspondingly, decreases at the
+ * end of the decreasingAlphaDuration. This parameter is clamped to
+ * half of decreasingAlphaDuration. When this parameter is non-zero,
+ * one gets constant acceleration while it is in effect; constant
+ * positive acceleration at the beginning of the ramp and constant
+ * negative acceleration at the end of the ramp. If this parameter is
+ * zero, the effective velocity of the Alpha value is constant and the
+ * acceleration is zero (i.e., a linearly-decreasing alpha ramp).alphaAtZeroDuration -- This is the period of time that
+ * Alpha stays at zero.
+ *
+ *
+ * loopCount : -1
+ */
+ public Alpha() {
+ loopCount = -1;
+ mode = INCREASING_ENABLE;
+ increasingAlpha = 1.0f; // converted to seconds internally
+ /*
+ // Java initialize them to zero by default
+ triggerTime = 0L;
+ phaseDelay = 0.0f;
+ increasingAlphaRamp = 0.0f;
+ alphaAtOne = 0.0f;
+ decreasingAlpha = 0.0f;
+ decreasingAlphaRamp = 0.0f;
+ alphaAtZero = 0.0f;
+ */
+ }
+
+
+ /**
+ * This constructor takes all of the Alpha user-definable parameters.
+ * @param loopCount number of times to run this alpha; a value
+ * of -1 specifies that the alpha loops indefinitely
+ * @param mode indicates whether the increasing alpha parameters or
+ * the decreasing alpha parameters or both are active. This parameter
+ * accepts the following values, INCREASING_ENABLE or
+ * DECREASING_ENABLE, which may be ORed together to specify
+ * that both are active.
+ * The increasing alpha parameters are increasingAlphaDuration,
+ * increasingAlphaRampDuration, and alphaAtOneDuration.
+ * The decreasing alpha parameters are decreasingAlphaDuration,
+ * decreasingAlphaRampDuration, and alphaAtZeroDuration.
+ * @param triggerTime time in milliseconds since the start time
+ * that this object first triggers
+ * @param phaseDelayDuration number of milliseconds to wait after
+ * triggerTime before actually starting this alpha
+ * @param increasingAlphaDuration period of time during which alpha goes
+ * from zero to one
+ * @param increasingAlphaRampDuration period of time during which
+ * the alpha step size increases at the beginning of the
+ * increasingAlphaDuration and, correspondingly, decreases at the end
+ * of the increasingAlphaDuration. This value is clamped to half of
+ * increasingAlphaDuration. NOTE: a value of zero means that the alpha
+ * step size remains constant during the entire increasingAlphaDuration.
+ * @param alphaAtOneDuration period of time that alpha stays at one
+ * @param decreasingAlphaDuration period of time during which alpha goes
+ * from one to zero
+ * @param decreasingAlphaRampDuration period of time during which
+ * the alpha step size increases at the beginning of the
+ * decreasingAlphaDuration and, correspondingly, decreases at the end
+ * of the decreasingAlphaDuration. This value is clamped to half of
+ * decreasingAlphaDuration. NOTE: a value of zero means that the alpha
+ * step size remains constant during the entire decreasingAlphaDuration.
+ * @param alphaAtZeroDuration period of time that alpha stays at zero
+ */
+ public Alpha(int loopCount, int mode,
+ long triggerTime, long phaseDelayDuration,
+ long increasingAlphaDuration,
+ long increasingAlphaRampDuration,
+ long alphaAtOneDuration,
+ long decreasingAlphaDuration,
+ long decreasingAlphaRampDuration,
+ long alphaAtZeroDuration) {
+
+ this.loopCount = loopCount;
+ this.mode = mode;
+ this.triggerTime = (float) triggerTime * .001f;
+ phaseDelay = (float) phaseDelayDuration * .001f;
+
+ increasingAlpha = (float) increasingAlphaDuration * .001f;
+ alphaAtOne = (float)alphaAtOneDuration * .001f;
+ increasingAlphaRamp = increasingAlphaRampDuration;
+ incAlphaRampInternal = increasingAlphaRampDuration * .001f;
+ if (incAlphaRampInternal > (0.5f * increasingAlpha)) {
+ incAlphaRampInternal = 0.5f * increasingAlpha;
+ }
+
+ decreasingAlpha = (float)decreasingAlphaDuration * .001f;
+ alphaAtZero = (float)alphaAtZeroDuration * .001f;
+ decreasingAlphaRamp = decreasingAlphaRampDuration;
+ decAlphaRampInternal = decreasingAlphaRampDuration * .001f;
+ if (decAlphaRampInternal > (0.5f * decreasingAlpha)) {
+ decAlphaRampInternal = 0.5f * decreasingAlpha;
+ }
+ computeStopTime();
+ }
+
+
+ /**
+ * Constructs a new Alpha object that assumes that the mode is
+ * INCREASING_ENABLE.
+ *
+ * @param loopCount number of times to run this alpha; a value
+ * of -1 specifies that the alpha loops indefinitely.
+ * @param triggerTime time in milliseconds since the start time
+ * that this object first triggers
+ * @param phaseDelayDuration number of milliseconds to wait after
+ * triggerTime before actually starting this alpha
+ * @param increasingAlphaDuration period of time during which alpha goes
+ * from zero to one
+ * @param increasingAlphaRampDuration period of time during which
+ * the alpha step size increases at the beginning of the
+ * increasingAlphaDuration and, correspondingly, decreases at the end
+ * of the increasingAlphaDuration. This value is clamped to half of
+ * increasingAlphaDuration. NOTE: a value of zero means that the alpha
+ * step size remains constant during the entire increasingAlphaDuration.
+ * @param alphaAtOneDuration period of time that alpha stays at one
+ */
+
+ public Alpha(int loopCount,
+ long triggerTime, long phaseDelayDuration,
+ long increasingAlphaDuration,
+ long increasingAlphaRampDuration,
+ long alphaAtOneDuration) {
+ this(loopCount, INCREASING_ENABLE,
+ triggerTime, phaseDelayDuration,
+ increasingAlphaDuration, increasingAlphaRampDuration,
+ alphaAtOneDuration, 0, 0, 0);
+ }
+
+
+ /**
+ * This constructor takes only the loopCount and increasingAlphaDuration
+ * as parameters and assigns the default values to all of the other
+ * parameters.
+ * @param loopCount number of times to run this alpha; a value
+ * of -1 specifies that the alpha loops indefinitely
+ * @param increasingAlphaDuration period of time during which alpha goes
+ * from zero to one
+ */
+ public Alpha(int loopCount, long increasingAlphaDuration) {
+ // defaults
+ mode = INCREASING_ENABLE;
+ increasingAlpha = (float) increasingAlphaDuration * .001f;
+ this.loopCount = loopCount;
+
+ if (loopCount >= 0) {
+ stopTime = loopCount*increasingAlpha;
+ }
+ }
+
+
+ /**
+ * Pauses this alpha object. The current system time when this
+ * method is called will be used in place of the actual current
+ * time when calculating subsequent alpha values. This has the
+ * effect of freezing the interpolator at the time the method is
+ * called.
+ *
+ * @since Java 3D 1.3
+ */
+ public void pause() {
+ pause(J3dClock.currentTimeMillis());
+ }
+
+ /**
+ * Pauses this alpha object as of the specified time. The specified
+ * time will be used in place of the actual current time when
+ * calculating subsequent alpha values. This has the effect of freezing
+ * the interpolator at the specified time. Note that specifying a
+ * time in the future (that is, a time greater than
+ * System.currentTimeMillis()) will cause the alpha to immediately
+ * advance to that point before pausing. Similarly, specifying a
+ * time in the past (that is, a time less than
+ * System.currentTimeMillis()) will cause the alpha to immediately
+ * revert to that point before pausing.
+ *
+ * @param time the time at which to pause the alpha
+ *
+ * @exception IllegalArgumentException if time <= 0
+ *
+ * @since Java 3D 1.3
+ */
+ public void pause(long time) {
+ if (time <= 0L) {
+ throw new IllegalArgumentException(J3dI18N.getString("Alpha0"));
+ }
+
+ paused = true;
+ pauseTime = time;
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Resumes this alpha object. If the alpha
+ * object was paused, the difference between the current
+ * time and the pause time will be used to adjust the startTime of
+ * this alpha. The equation is as follows:
+ *
+ *
+ * mode : INCREASING_ENABLE
+ * startTime : system start time
+ * triggerTime : 0
+ * phaseDelayDuration : 0
+ * increasingAlphaDuration : 1000
+ * increasingAlphaRampDuration : 0
+ * alphaAtOneDuration : 0
+ * decreasingAlphaDuration : 0
+ * decreasingAlphaRampDuration : 0
+ * alphaAtZeroDuration : 0
+ * isPaused : false
+ * pauseTime : 0
+ *
+ *
+ *
+ * Since the alpha object is no longer paused, this has the effect
+ * of resuming the interpolator as of the current time. If the
+ * alpha object is not paused when this method is called, then this
+ * method does nothing--the start time is not adjusted in this case.
+ *
+ * @since Java 3D 1.3
+ */
+ public void resume() {
+ resume(J3dClock.currentTimeMillis());
+ }
+
+ /**
+ * Resumes this alpha object as of the specified time. If the alpha
+ * object was paused, the difference between the specified
+ * time and the pause time will be used to adjust the startTime of
+ * this alpha. The equation is as follows:
+ *
+ * startTime += System.currentTimeMillis() - pauseTime
+ *
+ *
+ * Since the alpha object is no longer paused, this has the effect
+ * of resuming the interpolator as of the specified time. If the
+ * alpha object is not paused when this method is called, then this
+ * method does nothing--the start time is not adjusted in this case.
+ *
+ * @param time the time at which to resume the alpha
+ *
+ * @exception IllegalArgumentException if time <= 0
+ *
+ * @since Java 3D 1.3
+ */
+ public void resume(long time) {
+ if (time <= 0L) {
+ throw new IllegalArgumentException(J3dI18N.getString("Alpha0"));
+ }
+
+ if (paused) {
+ long newStartTime = startTime + time - pauseTime;
+ paused = false;
+ pauseTime = 0L;
+ setStartTime(newStartTime);
+ }
+ }
+
+ /**
+ * Returns true if this alpha object is paused.
+ * @return true if this alpha object is paused, false otherwise
+ *
+ * @since Java 3D 1.3
+ */
+ public boolean isPaused() {
+ return paused;
+ }
+
+ /**
+ * Returns the time at which this alpha was paused.
+ * @return the pause time; returns 0 if this alpha is not paused
+ *
+ * @since Java 3D 1.3
+ */
+ public long getPauseTime() {
+ return pauseTime;
+ }
+
+
+ /**
+ * This method returns a value between 0.0 and 1.0 inclusive,
+ * based on the current time and the time-to-alpha parameters
+ * established for this alpha. If this alpha object is paused,
+ * the value will be based on the pause time rather than the
+ * current time.
+ * This method will return the starting alpha value if the alpha
+ * has not yet started (that is, if the current time is less
+ * than startTime + triggerTime + phaseDelayDuration). This
+ * method will return the ending alpha value if the alpha has
+ * finished (that is, if the loop count has expired).
+ *
+ * @return a value between 0.0 and 1.0 based on the current time
+ */
+ public float value() {
+ long currentTime = paused ? pauseTime : J3dClock.currentTimeMillis();
+ return this.value(currentTime);
+ }
+
+ /**
+ * This method returns a value between 0.0 and 1.0 inclusive,
+ * based on the specified time and the time-to-alpha parameters
+ * established for this alpha.
+ * This method will return the starting alpha value if the alpha
+ * has not yet started (that is, if the specified time is less
+ * than startTime + triggerTime + phaseDelayDuration). This
+ * method will return the ending alpha value if the alpha has
+ * finished (that is, if the loop count has expired).
+ *
+ * @param atTime The time for which we wish to compute alpha
+ * @return a value between 0.0 and 1.0 based on the specified time
+ */
+ public float value(long atTime) {
+ float interpolatorTime
+ = (float)(atTime - startTime) * .001f; // startTime is in millisec
+ float alpha, a1, a2, dt, alphaRampDuration;
+
+ // System.err.println("alpha mode: " + mode);
+
+ // If non-looping and before start
+ // if ((loopCount != -1) &&
+ // interpolatorTime <= ( triggerTime + phaseDelay)) {
+ //
+ // if (( mode & INCREASING_ENABLE ) == 0 &&
+ // ( mode & DECREASING_ENABLE) != 0)
+ // alpha = 1.0f;
+ // else
+ // alpha = 0.0f;
+ // return alpha;
+ // }
+
+
+ // Case of {constantly} moving forward, snap back, forward again
+ if (( mode & INCREASING_ENABLE ) != 0 &&
+ ( mode & DECREASING_ENABLE) == 0) {
+
+ if(interpolatorTime <= (triggerTime + phaseDelay))
+ return 0.0f;
+
+ if((loopCount != -1) && (interpolatorTime >= stopTime))
+ return 1.0f;
+
+ // Constant velocity case
+ if (incAlphaRampInternal == 0.0f) {
+
+ alpha = mfmod((interpolatorTime - triggerTime - phaseDelay) +
+ 6.0f*( increasingAlpha + alphaAtOne),
+ (increasingAlpha + alphaAtOne))/ increasingAlpha;
+
+ if ( alpha > 1.0f) alpha = 1.0f;
+ return alpha;
+ }
+
+ // Ramped velocity case
+ alphaRampDuration = incAlphaRampInternal;
+
+ dt = mfmod((interpolatorTime - triggerTime - phaseDelay) +
+ 6.0f*( increasingAlpha + alphaAtOne),
+ ( increasingAlpha + alphaAtOne));
+ if (dt >= increasingAlpha) { alpha = 1.0f; return alpha; }
+
+ // Original equation kept to help understand
+ // computation logic - simplification saves
+ // a multiply and an add
+ // a1 = 1.0f/(alphaRampDuration*alphaRampDuration +
+ // ( increasingAlpha - 2*alphaRampDuration)*
+ // alphaRampDuration);
+
+ a1 = 1.0f/(increasingAlpha * alphaRampDuration -
+ alphaRampDuration * alphaRampDuration);
+
+ if (dt < alphaRampDuration) {
+ alpha = 0.5f*a1*dt*dt;
+ } else if (dt < increasingAlpha - alphaRampDuration) {
+ alpha = 0.5f*a1*alphaRampDuration*
+ alphaRampDuration +
+ (dt - alphaRampDuration)*a1*
+ alphaRampDuration;
+ } else {
+ alpha = a1*alphaRampDuration*alphaRampDuration +
+ ( increasingAlpha - 2.0f*alphaRampDuration)*a1*
+ alphaRampDuration -
+ 0.5f*a1*( increasingAlpha - dt)*
+ ( increasingAlpha - dt);
+ }
+ return alpha;
+
+ } else
+
+
+ // Case of {constantly} moving backward, snap forward, backward
+ // again
+ if (( mode & INCREASING_ENABLE ) == 0 &&
+ ( mode & DECREASING_ENABLE) != 0) {
+
+ // If non-looping and past end
+ // if ((loopCount != -1)
+ // && (interpolatorTime
+ // >= (triggerTime + phaseDelay + decreasingAlpha))) {
+ // alpha = 0.0f;
+ // return alpha;
+ // }
+
+ if(interpolatorTime <= (triggerTime + phaseDelay))
+ return 1.0f;
+
+ if((loopCount != -1) && (interpolatorTime >= stopTime) )
+ return 0.0f;
+
+
+
+ // Constant velocity case
+ if (decAlphaRampInternal == 0.0f) {
+ alpha = mfmod((interpolatorTime - triggerTime -
+ phaseDelay) +
+ 6.0f*( decreasingAlpha + alphaAtZero),
+ (decreasingAlpha + alphaAtZero))/ decreasingAlpha;
+ if ( alpha > 1.0f) { alpha = 0.0f; return alpha; }
+ alpha = 1.0f - alpha;
+ return alpha;
+ }
+
+ // Ramped velocity case
+ alphaRampDuration = decAlphaRampInternal;
+
+ dt = mfmod((interpolatorTime - triggerTime - phaseDelay) +
+ 6.0f*( decreasingAlpha + alphaAtZero),
+ ( decreasingAlpha + alphaAtZero));
+ if (dt >= decreasingAlpha) { alpha = 0.0f; return alpha; }
+
+ // Original equation kept to help understand
+ // computation logic - simplification saves
+ // a multiply and an add
+ // a1 = 1.0f/(alphaRampDuration*alphaRampDuration +
+ // ( decreasingAlpha - 2*alphaRampDuration)*
+ // alphaRampDuration);
+
+ a1 = 1.0f/(decreasingAlpha * alphaRampDuration -
+ alphaRampDuration * alphaRampDuration);
+
+ if (dt < alphaRampDuration) {
+ alpha = 0.5f*a1*dt*dt;
+ } else if (dt < decreasingAlpha - alphaRampDuration) {
+ alpha = 0.5f*a1*alphaRampDuration*
+ alphaRampDuration +
+ (dt - alphaRampDuration)*a1*
+ alphaRampDuration;
+ } else {
+ alpha = a1*alphaRampDuration*alphaRampDuration +
+ ( decreasingAlpha - 2.0f*alphaRampDuration)*a1*
+ alphaRampDuration -
+ 0.5f*a1*( decreasingAlpha - dt)*
+ ( decreasingAlpha - dt);
+ }
+ alpha = 1.0f - alpha;
+ return alpha;
+
+ } else
+
+
+ // Case of {osscilating} increasing and decreasing alpha
+ if (( mode & INCREASING_ENABLE) != 0 &&
+ ( mode & DECREASING_ENABLE) != 0) {
+
+ // If non-looping and past end
+ // if ((loopCount != -1) &&
+ // (interpolatorTime >=
+ // (triggerTime + phaseDelay + increasingAlpha +
+ // alphaAtOne + decreasingAlpha))) {
+ // alpha = 0.0f;
+ // return alpha;
+ // }
+
+
+ // If non-looping and past end, we always end up at zero since
+ // decreasing alpha has been requested.
+ if(interpolatorTime <= (triggerTime + phaseDelay))
+ return 0.0f;
+
+ if( (loopCount != -1) && (interpolatorTime >= stopTime))
+ return 0.0f;
+
+ // Constant velocity case
+ if (incAlphaRampInternal == 0.0f
+ && decAlphaRampInternal == 0.0f) {
+ dt = mfmod(interpolatorTime - triggerTime - phaseDelay +
+ 6.0f*(increasingAlpha + alphaAtOne +
+ decreasingAlpha + alphaAtZero),
+ increasingAlpha + alphaAtOne +
+ decreasingAlpha + alphaAtZero);
+ alpha = dt / increasingAlpha;
+ if ( alpha < 1.0f) return alpha;
+ // sub all increasing alpha time
+ dt -= increasingAlpha;
+ if (dt < alphaAtOne) { alpha = 1.0f; return alpha; }
+ // sub out alpha @ 1 time
+ dt -= alphaAtOne;
+ alpha = dt/ decreasingAlpha;
+ if ( alpha < 1.0f) alpha = 1.0f - alpha;
+ else alpha = 0.0f;
+ return alpha;
+ }
+
+ // Ramped velocity case
+ alphaRampDuration = incAlphaRampInternal;
+
+ // work around for bug 4308308
+ if (alphaRampDuration == 0.0f)
+ alphaRampDuration = .00001f;
+
+ dt = mfmod(interpolatorTime - triggerTime - phaseDelay +
+ 6.0f*( increasingAlpha + alphaAtOne +
+ decreasingAlpha + alphaAtZero),
+ increasingAlpha + alphaAtOne +
+ decreasingAlpha + alphaAtZero);
+ if (dt <= increasingAlpha) {
+
+ // Original equation kept to help understand
+ // computation logic - simplification saves
+ // a multiply and an add
+ // a1 = 1.0f/(alphaRampDuration*alphaRampDuration +
+ // ( increasingAlpha - 2*alphaRampDuration)*
+ // alphaRampDuration);
+
+ a1 = 1.0f/(increasingAlpha * alphaRampDuration -
+ alphaRampDuration * alphaRampDuration);
+
+ if (dt < alphaRampDuration) {
+ alpha = 0.5f*a1*dt*dt;
+ } else if (dt < increasingAlpha - alphaRampDuration) {
+ alpha = 0.5f*a1*alphaRampDuration*
+ alphaRampDuration +
+ (dt - alphaRampDuration)*a1*
+ alphaRampDuration;
+ } else {
+ alpha = a1*alphaRampDuration*alphaRampDuration+
+ ( increasingAlpha - 2.0f*alphaRampDuration)*a1*
+ alphaRampDuration -
+ 0.5f*a1*( increasingAlpha - dt)*
+ ( increasingAlpha - dt);
+ }
+ return alpha;
+ }
+ else if (dt <= increasingAlpha + alphaAtOne) {
+ alpha = 1.0f; return alpha;
+ }
+ else if (dt >= increasingAlpha + alphaAtOne + decreasingAlpha) {
+ alpha = 0.0f; return alpha;
+ }
+ else {
+ dt -= increasingAlpha + alphaAtOne;
+
+ alphaRampDuration = decAlphaRampInternal;
+
+ // work around for bug 4308308
+ if (alphaRampDuration == 0.0f)
+ alphaRampDuration = .00001f;
+
+ // Original equation kept to help understand
+ // computation logic - simplification saves
+ // a multiply and an add
+ // a1 = 1.0f/(alphaRampDuration*alphaRampDuration +
+ // ( decreasingAlpha - 2*alphaRampDuration)*
+ // alphaRampDuration);
+
+ a1 = 1.0f/(decreasingAlpha * alphaRampDuration -
+ alphaRampDuration * alphaRampDuration);
+
+ if (dt < alphaRampDuration) {
+ alpha = 0.5f*a1*dt*dt;
+ } else if (dt < decreasingAlpha - alphaRampDuration) {
+ alpha = 0.5f*a1*alphaRampDuration*
+ alphaRampDuration +
+ (dt - alphaRampDuration)*a1*
+ alphaRampDuration;
+ } else {
+ alpha =
+ a1*alphaRampDuration*alphaRampDuration +
+ (decreasingAlpha - 2.0f*alphaRampDuration)*a1*
+ alphaRampDuration -
+ 0.5f*a1*( decreasingAlpha - dt)*
+ (decreasingAlpha - dt);
+ }
+ alpha = 1.0f - alpha;
+ return alpha;
+ }
+
+ }
+ return 0.0f;
+ }
+
+ float mfmod(float a, float b) {
+ float fm, ta = (a), tb = (b);
+ int fmint;
+ if (tb < 0.0f) tb = -tb;
+ if (ta < 0.0f) ta = -ta;
+
+ fmint =(int)( ta/tb);
+ fm = ta - (float)fmint * tb;
+
+ if ((a) < 0.0f) return ((b) - fm);
+ else return fm;
+ }
+
+ /**
+ * Retrieves this alpha's startTime, the base
+ * for all relative time specifications; the default value
+ * for startTime is the system start time.
+ * @return this alpha's startTime.
+ */
+ public long getStartTime() {
+ return this.startTime;
+ }
+
+ /**
+ * Sets this alpha's startTime to that specified in the argument;
+ * startTime sets the base (or zero) for all relative time
+ * computations; the default value for startTime is the system
+ * start time.
+ * @param startTime the new startTime value
+ */
+ public void setStartTime(long startTime) {
+ this.startTime = startTime;
+ // This is used for passive wakeupOnElapsedFrame in
+ // Interpolator to restart behavior after alpha.finished()
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's loopCount.
+ * @return this alpha's loopCount.
+ */
+ public int getLoopCount() {
+ return this.loopCount;
+ }
+
+ /**
+ * Set this alpha's loopCount to that specified in the argument.
+ * @param loopCount the new loopCount value
+ */
+ public void setLoopCount(int loopCount) {
+ this.loopCount = loopCount;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's mode.
+ * @return this alpha's mode: any combination of
+ * INCREASING_ENABLE and DECREASING_ENABLE
+ */
+ public int getMode() {
+ return this.mode;
+ }
+
+ /**
+ * Set this alpha's mode to that specified in the argument.
+ * @param mode indicates whether the increasing alpha parameters or
+ * the decreasing alpha parameters or both are active. This parameter
+ * accepts the following values, INCREASING_ENABLE or
+ * DECREASING_ENABLE, which may be ORed together to specify
+ * that both are active.
+ * The increasing alpha parameters are increasingAlphaDuration,
+ * increasingAlphaRampDuration, and alphaAtOneDuration.
+ * The decreasing alpha parameters are decreasingAlphaDuration,
+ * decreasingAlphaRampDuration, and alphaAtZeroDuration.
+ */
+ public void setMode(int mode) {
+ this.mode = mode;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's triggerTime.
+ * @return this alpha's triggerTime.
+ */
+ public long getTriggerTime() {
+ return (long) (this.triggerTime * 1000f);
+ }
+
+ /**
+ * Set this alpha's triggerTime to that specified in the argument.
+ * @param triggerTime the new triggerTime
+ */
+ public void setTriggerTime(long triggerTime) {
+ this.triggerTime = (float) triggerTime * .001f;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's phaseDelayDuration.
+ * @return this alpha's phaseDelayDuration.
+ */
+ public long getPhaseDelayDuration() {
+ return (long)(this.phaseDelay * 1000f);
+ }
+
+ /**
+ * Set this alpha's phaseDelayDuration to that specified in
+ * the argument.
+ * @param phaseDelayDuration the new phaseDelayDuration
+ */
+ public void setPhaseDelayDuration(long phaseDelayDuration) {
+ this.phaseDelay = (float) phaseDelayDuration * .001f;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's increasingAlphaDuration.
+ * @return this alpha's increasingAlphaDuration.
+ */
+ public long getIncreasingAlphaDuration() {
+ return (long)(this.increasingAlpha * 1000f);
+ }
+
+ /**
+ * Set this alpha's increasingAlphaDuration to that specified in
+ * the argument.
+ * @param increasingAlphaDuration the new increasingAlphaDuration
+ */
+ public void setIncreasingAlphaDuration(long increasingAlphaDuration) {
+ this.increasingAlpha = (float) increasingAlphaDuration * .001f;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's increasingAlphaRampDuration.
+ * @return this alpha's increasingAlphaRampDuration.
+ */
+ public long getIncreasingAlphaRampDuration() {
+ return increasingAlphaRamp;
+ }
+
+ /**
+ * Set this alpha's increasingAlphaRampDuration to that specified
+ * in the argument.
+ * @param increasingAlphaRampDuration the new increasingAlphaRampDuration
+ */
+ public void setIncreasingAlphaRampDuration(long increasingAlphaRampDuration) {
+ increasingAlphaRamp = increasingAlphaRampDuration;
+ incAlphaRampInternal = (float) increasingAlphaRampDuration * .001f;
+ if (incAlphaRampInternal > (0.5f * increasingAlpha)) {
+ incAlphaRampInternal = 0.5f * increasingAlpha;
+ }
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's alphaAtOneDuration.
+ * @return this alpha's alphaAtOneDuration.
+ */
+ public long getAlphaAtOneDuration() {
+ return (long)(this.alphaAtOne * 1000f);
+ }
+
+ /**
+ * Set this alpha object's alphaAtOneDuration to the specified
+ * value.
+ * @param alphaAtOneDuration the new alphaAtOneDuration
+ */
+ public void setAlphaAtOneDuration(long alphaAtOneDuration) {
+ this.alphaAtOne = (float) alphaAtOneDuration * .001f;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's decreasingAlphaDuration.
+ * @return this alpha's decreasingAlphaDuration.
+ */
+ public long getDecreasingAlphaDuration() {
+ return (long)(this.decreasingAlpha * 1000f);
+ }
+
+ /**
+ * Set this alpha's decreasingAlphaDuration to that specified in
+ * the argument.
+ * @param decreasingAlphaDuration the new decreasingAlphaDuration
+ */
+ public void setDecreasingAlphaDuration(long decreasingAlphaDuration) {
+ this.decreasingAlpha = (float) decreasingAlphaDuration * .001f;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's decreasingAlphaRampDuration.
+ * @return this alpha's decreasingAlphaRampDuration.
+ */
+ public long getDecreasingAlphaRampDuration() {
+ return decreasingAlphaRamp;
+ }
+
+ /**
+ * Set this alpha's decreasingAlphaRampDuration to that specified
+ * in the argument.
+ * @param decreasingAlphaRampDuration the new decreasingAlphaRampDuration
+ */
+ public void setDecreasingAlphaRampDuration(long decreasingAlphaRampDuration) {
+ decreasingAlphaRamp = decreasingAlphaRampDuration;
+ decAlphaRampInternal = (float) decreasingAlphaRampDuration * .001f;
+ if (decAlphaRampInternal > (0.5f * decreasingAlpha)) {
+ decAlphaRampInternal = 0.5f * decreasingAlpha;
+ }
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Retrieves this alpha's alphaAtZeroDuration.
+ * @return this alpha's alphaAtZeroDuration.
+ */
+ public long getAlphaAtZeroDuration() {
+ return (long)(this.alphaAtZero * 1000f);
+ }
+
+ /**
+ * Set this alpha object's alphaAtZeroDuration to the specified
+ * value.
+ * @param alphaAtZeroDuration the new alphaAtZeroDuration
+ */
+ public void setAlphaAtZeroDuration(long alphaAtZeroDuration) {
+ this.alphaAtZero = (float) alphaAtZeroDuration * .001f;
+ computeStopTime();
+ VirtualUniverse.mc.sendRunMessage(J3dThread.RENDER_THREAD);
+ }
+
+ /**
+ * Query to test if this alpha object is past its activity window,
+ * that is, if it has finished looping.
+ * @return true if no longer looping, false otherwise
+ */
+ public boolean finished() {
+ long currentTime = paused ? pauseTime : J3dClock.currentTimeMillis();
+ return ((loopCount != -1) &&
+ ((float)(currentTime - startTime) * .001f > stopTime));
+ }
+
+ final private void computeStopTime() {
+ if (loopCount >= 0) {
+ float sum = 0;
+ if (( mode & INCREASING_ENABLE ) != 0) {
+ sum = increasingAlpha+alphaAtOne;
+ }
+ if ((mode & DECREASING_ENABLE) != 0) {
+ sum += decreasingAlpha+alphaAtZero;
+ }
+ stopTime = this.triggerTime + phaseDelay + loopCount*sum;
+ } else {
+ stopTime = 0;
+ }
+ }
+
+ /**
+ * This internal method returns a clone of the Alpha
+ *
+ * @return a duplicate of this Alpha
+ */
+ Alpha cloneAlpha() {
+ Alpha a = new Alpha();
+ a.setStartTime(getStartTime());
+ a.setLoopCount(getLoopCount());
+ a.setMode(getMode());
+ a.setTriggerTime(getTriggerTime());
+ a.setPhaseDelayDuration(getPhaseDelayDuration());
+ a.setIncreasingAlphaDuration(getIncreasingAlphaDuration());
+ a.setIncreasingAlphaRampDuration(getIncreasingAlphaRampDuration());
+ a.setAlphaAtOneDuration(getAlphaAtOneDuration());
+ a.setDecreasingAlphaDuration(getDecreasingAlphaDuration());
+ a.setDecreasingAlphaRampDuration(getDecreasingAlphaRampDuration());
+ a.setAlphaAtZeroDuration(getAlphaAtZeroDuration());
+ return a;
+ }
+
+ static {
+ VirtualUniverse.loadLibraries();
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AlternateAppearance.java b/j3d-core/src/classes/share/javax/media/j3d/AlternateAppearance.java
new file mode 100644
index 0000000..16f82b4
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AlternateAppearance.java
@@ -0,0 +1,621 @@
+/*
+ * $RCSfile: AlternateAppearance.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Enumeration;
+
+
+/**
+ * The AlternateAppearance leaf node is used for overriding the
+ * Appearance component of selected nodes. It defines an Appearance
+ * component object and a region of influence in which this
+ * AlternateAppearance node is active. An AlternateAppearance node
+ * also contains a list of Group nodes that specifies the hierarchical
+ * scope of this AlternateAppearance. If the scope list is empty,
+ * then the AlternateAppearance node has universe scope: all nodes
+ * within the region of influence are affected by this
+ * AlternateAppearance node. If the scope list is non-empty, then
+ * only those Leaf nodes under the Group nodes in the scope list are
+ * affected by this AlternateAppearance node (subject to the
+ * influencing bounds).
+ *
+ * startTime += time - pauseTime
+ * appearance : null
+ */
+ public AlternateAppearance() {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ }
+
+ /**
+ * Constructs an AlternateAppearance node with the specified appearance.
+ * @param appearance the appearance that is used for those nodes affected
+ * by this AlternateAppearance node.
+ */
+ public AlternateAppearance(Appearance appearance) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ ((AlternateAppearanceRetained)retained).initAppearance(appearance);
+ }
+
+ /**
+ * Creates the retained mode AlternateAppearanceRetained object that this
+ * Alternate Appearance component object will point to.
+ */
+ void createRetained() {
+ this.retained = new AlternateAppearanceRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Sets the appearance of this AlternateAppearance node.
+ * This appearance overrides the appearance in those Shape3D and
+ * Morph nodes affected by this AlternateAppearance node.
+ * @param appearance the new appearance.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAppearance(Appearance appearance) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPEARANCE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance0"));
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).setAppearance(appearance);
+ else
+ ((AlternateAppearanceRetained)this.retained).initAppearance(appearance);
+ }
+
+
+ /**
+ * Retrieves the appearance from this AlternateAppearance node.
+ * @return the current appearance.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Appearance getAppearance() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPEARANCE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance2"));
+
+ return ((AlternateAppearanceRetained)this.retained).getAppearance();
+
+ }
+
+ /**
+ * Sets the AlternateAppearance's influencing region to the specified
+ * bounds.
+ * This is used when the influencing bounding leaf is set to null.
+ * @param region the bounds that contains the AlternateAppearance's
+ * new influencing region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBounds(Bounds region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance3"));
+
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).setInfluencingBounds(region);
+ else
+ ((AlternateAppearanceRetained)this.retained).initInfluencingBounds(region);
+ }
+
+ /**
+ * Retrieves the AlternateAppearance node's influencing bounds.
+ * @return this AlternateAppearance's influencing bounds information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getInfluencingBounds() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance4"));
+
+
+ return ((AlternateAppearanceRetained)this.retained).getInfluencingBounds();
+ }
+
+
+ /**
+ * Sets the AlternateAppearance's influencing region to the specified
+ * bounding leaf.
+ * When set to a value other than null, this overrides the influencing
+ * bounds object.
+ * @param region the bounding leaf node used to specify the
+ * AlternateAppearance node's new influencing region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance3"));
+
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).setInfluencingBoundingLeaf(region);
+ else
+ ((AlternateAppearanceRetained)this.retained).initInfluencingBoundingLeaf(region);
+ }
+
+
+ /**
+ * Retrieves the AlternateAppearance node's influencing bounding leaf.
+ * @return this AlternateAppearance's influencing bounding leaf information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public BoundingLeaf getInfluencingBoundingLeaf() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance4"));
+
+
+ return ((AlternateAppearanceRetained)this.retained).getInfluencingBoundingLeaf();
+ }
+
+
+ /**
+ * Replaces the node at the specified index in this
+ * AlternateAppearance node's
+ * list of scopes with the specified Group node.
+ * By default, AlternateAppearance nodes are scoped only by their
+ * influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be stored at the specified index.
+ * @param index the index of the Group node to be replaced.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void setScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance7"));
+
+
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).setScope(scope, index);
+ else
+ ((AlternateAppearanceRetained)this.retained).initScope(scope, index);
+ }
+
+
+ /**
+ * Retrieves the Group node at the specified index from
+ * this AlternateAppearance node's list of scopes.
+ * @param index the index of the Group node to be returned.
+ * @return the Group node at the specified index.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Group getScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance8"));
+
+
+ return ((AlternateAppearanceRetained)this.retained).getScope(index);
+ }
+
+
+ /**
+ * Inserts the specified Group node into this AlternateAppearance node's
+ * list of scopes at the specified index.
+ * By default, AlternateAppearance nodes are scoped only by their
+ * influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be inserted at the specified index.
+ * @param index the index at which the Group node is inserted.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void insertScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance9"));
+
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).insertScope(scope, index);
+ else
+ ((AlternateAppearanceRetained)this.retained).initInsertScope(scope, index);
+ }
+
+
+ /**
+ * Removes the node at the specified index from this AlternateAppearance
+ * node's
+ * list of scopes. If this operation causes the list of scopes to
+ * become empty, then this AlternateAppearance will have universe scope:
+ * all nodes
+ * within the region of influence will be affected by this
+ * AlternateAppearance node.
+ * @param index the index of the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the group node at the
+ * specified index is part of a compiled scene graph
+ */
+ public void removeScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance10"));
+
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).removeScope(index);
+ else
+ ((AlternateAppearanceRetained)this.retained).initRemoveScope(index);
+ }
+
+
+ /**
+ * Returns an enumeration of this AlternateAppearance node's list
+ * of scopes.
+ * @return an Enumeration object containing all nodes in this
+ * AlternateAppearance node's list of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Enumeration getAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance11"));
+
+
+ return (Enumeration) ((AlternateAppearanceRetained)this.retained).getAllScopes();
+ }
+
+
+ /**
+ * Appends the specified Group node to this AlternateAppearance node's
+ * list of scopes.
+ * By default, AlternateAppearance nodes are scoped only by their
+ * influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be appended.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void addScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance12"));
+
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).addScope(scope);
+ else
+ ((AlternateAppearanceRetained)this.retained).initAddScope(scope);
+ }
+
+
+ /**
+ * Returns the number of nodes in this AlternateAppearance node's list
+ * of scopes.
+ * If this number is 0, then the list of scopes is empty and this
+ * AlternateAppearance node has universe scope: all nodes within the
+ * region of
+ * influence are affected by this AlternateAppearance node.
+ * @return the number of nodes in this AlternateAppearance node's list
+ * of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int numScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance11"));
+
+
+ return ((AlternateAppearanceRetained)this.retained).numScopes();
+ }
+
+
+ /**
+ * Retrieves the index of the specified Group node in this
+ * AlternateAppearance node's list of scopes.
+ *
+ * @param scope the Group node to be looked up.
+ * @return the index of the specified Group node;
+ * returns -1 if the object is not in the list.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int indexOfScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance8"));
+
+ return ((AlternateAppearanceRetained)this.retained).indexOfScope(scope);
+ }
+
+
+ /**
+ * Removes the specified Group node from this AlternateAppearance
+ * node's list of scopes. If the specified object is not in the
+ * list, the list is not modified. If this operation causes the
+ * list of scopes to become empty, then this AlternateAppearance
+ * will have universe scope: all nodes within the region of
+ * influence will be affected by this AlternateAppearance node.
+ *
+ * @param scope the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance10"));
+
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).removeScope(scope);
+ else
+ ((AlternateAppearanceRetained)this.retained).initRemoveScope(scope);
+ }
+
+
+ /**
+ * Removes all Group nodes from this AlternateAppearance node's
+ * list of scopes. The AlternateAppearance node will then have
+ * universe scope: all nodes within the region of influence will
+ * be affected by this AlternateAppearance node.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if any group node in this
+ * node's list of scopes is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AlternateAppearance10"));
+ if (isLive())
+ ((AlternateAppearanceRetained)this.retained).removeAllScopes();
+ else
+ ((AlternateAppearanceRetained)this.retained).initRemoveAllScopes();
+ }
+
+
+ /**
+ * Copies all AlternateAppearance information from
+ *
+ * scope : empty (universe scope)
+ * influencing bounds : null
+ * influencing bounding leaf : null
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ AlternateAppearanceRetained attr = (AlternateAppearanceRetained)
+ originalNode.retained;
+ AlternateAppearanceRetained rt = (AlternateAppearanceRetained) retained;
+
+ rt.initAppearance((Appearance) getNodeComponent(
+ attr.getAppearance(),
+ forceDuplicate,
+ originalNode.nodeHashtable));
+
+ rt.initInfluencingBounds(attr.getInfluencingBounds());
+
+ Enumeration elm = attr.getAllScopes();
+ while (elm.hasMoreElements()) {
+ // this reference will set correctly in updateNodeReferences() callback
+ rt.initAddScope((Group) elm.nextElement());
+ }
+
+ // correct value will set in updateNodeReferences
+ rt.initInfluencingBoundingLeaf(attr.getInfluencingBoundingLeaf());
+
+ }
+
+ /**
+ * Callback used to allow a node to check if any nodes referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any node references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding Node in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * node is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+
+ AlternateAppearanceRetained rt = (AlternateAppearanceRetained)
+ retained;
+
+ BoundingLeaf bl = rt.getInfluencingBoundingLeaf();
+
+ if (bl != null) {
+ Object o = referenceTable.getNewObjectReference(bl);
+ rt.initInfluencingBoundingLeaf((BoundingLeaf) o);
+ }
+
+ int num = rt.numScopes();
+ for (int i=0; i < num; i++) {
+ rt.initScope((Group) referenceTable.
+ getNewObjectReference(rt.getScope(i)), i);
+ }
+ }
+
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ AlternateAppearance app = new AlternateAppearance();
+ app.duplicateNode(this, forceDuplicate);
+ return app;
+ }
+}
+
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AlternateAppearanceRetained.java b/j3d-core/src/classes/share/javax/media/j3d/AlternateAppearanceRetained.java
new file mode 100644
index 0000000..a5f2d92
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AlternateAppearanceRetained.java
@@ -0,0 +1,881 @@
+/*
+ * $RCSfile: AlternateAppearanceRetained.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+import javax.vecmath.*;
+import java.util.Enumeration;
+import java.util.Vector;
+import java.util.ArrayList;
+
+
+class AlternateAppearanceRetained extends LeafRetained {
+
+
+ // Statics used when something in the alternate app changes
+ static final int APPEARANCE_CHANGED = 0x0001;
+ static final int SCOPE_CHANGED = 0x0002;
+ static final int BOUNDS_CHANGED = 0x0004;
+ static final int BOUNDINGLEAF_CHANGED = 0x0008;
+ static final int INIT_MIRROR = 0x0010; // setLive
+ static final int CLEAR_MIRROR = 0x0020; // clearLive
+
+
+ /**
+ * The Boundary object defining the lights's region of influence.
+ */
+ Bounds regionOfInfluence = null;
+
+ /**
+ * The bounding leaf reference
+ */
+ BoundingLeafRetained boundingLeaf = null;
+
+ /**
+ * Vector of GroupRetained nodes that scopes this alternate app .
+ */
+ Vector scopes = new Vector();
+
+ // This is true when this alternate app is referenced in an immediate mode context
+ boolean inImmCtx = false;
+
+ // Target threads to be notified when light changes
+ static final int targetThreads = J3dThread.UPDATE_RENDERING_ENVIRONMENT |
+ J3dThread.UPDATE_RENDER;
+
+ // Boolean to indicate if this object is scoped (only used for mirror objects
+ boolean isScoped = false;
+
+ // The object that contains the dynamic HashKey - a string type object
+ // Used in scoping
+ HashKey tempKey = new HashKey(250);
+
+ /**
+ * The transformed value of the applicationRegion.
+ */
+ Bounds region = null;
+
+ /**
+ * mirror Alternate appearance
+ */
+ AlternateAppearanceRetained mirrorAltApp = null;
+
+ /**
+ * Appearance for this object
+ */
+ AppearanceRetained appearance;
+
+ /**
+ * A reference to the scene graph alternateApp
+ */
+ AlternateAppearanceRetained sgAltApp = null;
+
+ /**
+ * Is true, if the mirror altapp is viewScoped
+ */
+ boolean isViewScoped = false;
+
+ AlternateAppearanceRetained() {
+ this.nodeType = NodeRetained.ALTERNATEAPPEARANCE;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ /**
+ * Initializes the appearance
+ */
+ void initAppearance(Appearance app) {
+ if (app != null)
+ appearance = (AppearanceRetained) app.retained;
+ else
+ appearance = null;
+ }
+
+
+ /**
+ * sets the appearance and send a message
+ */
+ void setAppearance(Appearance app) {
+ if (appearance != null)
+ synchronized(appearance.liveStateLock) {
+ appearance.clearLive(refCount);
+ }
+ initAppearance(app);
+ if (appearance != null) {
+ synchronized(appearance.liveStateLock) {
+ appearance.setLive(inBackgroundGroup, refCount);
+ }
+ }
+ // There is no need to clone the appearance's mirror
+ sendMessage(APPEARANCE_CHANGED,
+ (appearance != null ? appearance.mirror: null));
+ }
+
+
+
+ Appearance getAppearance() {
+ return (appearance == null ? null: (Appearance) appearance.source);
+ }
+
+
+ /**
+ * Set the alternate's region of influence.
+ */
+ void initInfluencingBounds(Bounds region) {
+ if (region != null) {
+ this.regionOfInfluence = (Bounds) region.clone();
+ } else {
+ this.regionOfInfluence = null;
+ }
+ }
+
+ /**
+ * Set the alternate's region of influence and send message
+ */
+ void setInfluencingBounds(Bounds region) {
+ initInfluencingBounds(region);
+ sendMessage(BOUNDS_CHANGED,
+ (region != null ? region.clone() : null));
+ }
+
+ /**
+ * Get the alternate's region of Influence.
+ */
+ Bounds getInfluencingBounds() {
+ return (regionOfInfluence != null ?
+ (Bounds) regionOfInfluence.clone() : null);
+ }
+
+ /**
+ * Set the alternate's region of influence to the specified Leaf node.
+ */
+ void initInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ } else {
+ boundingLeaf = null;
+ }
+ }
+
+ /**
+ * Set the alternate's region of influence to the specified Leaf node.
+ */
+ void setInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (boundingLeaf != null)
+ boundingLeaf.mirrorBoundingLeaf.removeUser(mirrorAltApp);
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ boundingLeaf.mirrorBoundingLeaf.addUser(mirrorAltApp);
+ } else {
+ boundingLeaf = null;
+ }
+ sendMessage(BOUNDINGLEAF_CHANGED,
+ (boundingLeaf != null ?
+ boundingLeaf.mirrorBoundingLeaf : null));
+ }
+
+ /**
+ * Get the alternate's region of influence.
+ */
+ BoundingLeaf getInfluencingBoundingLeaf() {
+ return (boundingLeaf != null ?
+ (BoundingLeaf)boundingLeaf.source : null);
+ }
+
+
+
+ /**
+ * Replaces the specified scope with the scope provided.
+ * @param scope the new scope
+ * @param index which scope to replace
+ */
+ void initScope(Group scope, int index) {
+ scopes.setElementAt((GroupRetained)(scope.retained), index);
+
+ }
+
+ /**
+ * Replaces the specified scope with the scope provided.
+ * @param scope the new scope
+ * @param index which scope to replace
+ */
+ void setScope(Group scope, int index) {
+
+ ArrayList removeScopeList = new ArrayList();
+ GroupRetained group;
+ ArrayList addScopeList = new ArrayList();
+ Object[] scopeInfo = new Object[3];
+
+ group = (GroupRetained) scopes.get(index);
+ tempKey.reset();
+ group.removeAllNodesForScopedAltApp(mirrorAltApp, removeScopeList, tempKey);
+
+ group = (GroupRetained)scope.retained;
+ initScope(scope, index);
+ tempKey.reset();
+
+ // If its a group, then add the scope to the group, if
+ // its a shape, then keep a list to be added during
+ // updateMirrorObject
+ group.addAllNodesForScopedAltApp(mirrorAltApp,addScopeList, tempKey);
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE:Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+ Group getScope(int index) {
+ return (Group)(((GroupRetained)(scopes.elementAt(index))).source);
+ }
+
+
+ /**
+ * Inserts the specified scope at specified index.before the
+ * alt app is live
+ * @param scope the new scope
+ * @param index position to insert new scope at
+ */
+ void initInsertScope(Node scope, int index) {
+ GroupRetained group = (GroupRetained)scope.retained;
+ scopes.insertElementAt((GroupRetained)(scope.retained), index);
+ group.setAltAppScope();
+ }
+
+ /**
+ * Inserts the specified scope at specified index and sends
+ * a message
+ * @param scope the new scope
+ * @param index position to insert new scope at
+ */
+ void insertScope(Node scope, int index) {
+ Object[] scopeInfo = new Object[3];
+ ArrayList addScopeList = new ArrayList();
+ GroupRetained group = (GroupRetained)scope.retained;
+
+ initInsertScope(scope, index);
+ group = (GroupRetained)scope.retained;
+ tempKey.reset();
+ group.addAllNodesForScopedAltApp(mirrorAltApp,addScopeList, tempKey);
+
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = null;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+
+
+ void initRemoveScope(int index) {
+ GroupRetained group = (GroupRetained)scopes.elementAt(index);
+ scopes.removeElementAt(index);
+ group.removeAltAppScope();
+
+ }
+
+ void removeScope(int index) {
+
+ Object[] scopeInfo = new Object[3];
+ ArrayList removeScopeList = new ArrayList();
+ GroupRetained group = (GroupRetained)scopes.elementAt(index);
+
+ tempKey.reset();
+ group.removeAllNodesForScopedAltApp(mirrorAltApp, removeScopeList, tempKey);
+
+ initRemoveScope(index);
+ scopeInfo[0] = null;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+ /**
+ * Removes the specified Group node from this node's list of scopes.
+ * Method is a no-op if the
+ * specified node is not found
+ * @param The Group node to be removed
+ */
+ void removeScope(Group scope) {
+ int ind = indexOfScope(scope);
+ if(ind >= 0)
+ removeScope(ind);
+ }
+
+ void initRemoveScope(Group scope) {
+ int ind = indexOfScope(scope);
+ if(ind >= 0)
+ initRemoveScope(ind);
+ }
+
+ void removeAllScopes() {
+ GroupRetained group;
+ ArrayList removeScopeList = new ArrayList();
+ int n = scopes.size();
+ for(int index = n-1; index >= 0; index--) {
+ group = (GroupRetained)scopes.elementAt(index);
+ tempKey.reset();
+ group.removeAllNodesForScopedAltApp(mirrorAltApp, removeScopeList, tempKey);
+ initRemoveScope(index);
+ }
+ Object[] scopeInfo = new Object[3];
+ scopeInfo[0] = null;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+ void initRemoveAllScopes() {
+ int n = scopes.size();
+ for(int i = n-1; i >= 0; i--)
+ initRemoveScope(i);
+ }
+
+ /**
+ * Returns an enumeration object of the scoperen.
+ * @return an enumeration object of the scoperen
+ */
+ Enumeration getAllScopes() {
+ Enumeration elm = scopes.elements();
+ Vector v = new Vector(scopes.size());
+ while (elm.hasMoreElements()) {
+ v.add( ((GroupRetained) elm.nextElement()).source);
+ }
+ return v.elements();
+ }
+
+ /**
+ * Returns the index of the specified Group node in this node's list of scopes.
+ * @param scope the Group node whose index is needed
+ */
+ int indexOfScope(Group scope) {
+ if(scope != null)
+ return scopes.indexOf((GroupRetained)scope.retained);
+ else
+ return scopes.indexOf(null);
+ }
+
+ /**
+ * Appends the specified scope to this node's list of scopes before
+ * the alt app is alive
+ * @param scope the scope to add to this node's list of scopes
+ */
+ void initAddScope(Group scope) {
+ GroupRetained group = (GroupRetained)scope.retained;
+ scopes.addElement((GroupRetained)(scope.retained));
+ group.setAltAppScope();
+ }
+
+ /**
+ * Appends the specified scope to this node's list of scopes.
+ * @param scope the scope to add to this node's list of scopes
+ */
+ void addScope(Group scope) {
+
+ Object[] scopeInfo = new Object[3];
+ ArrayList addScopeList = new ArrayList();
+ GroupRetained group = (GroupRetained)scope.retained;
+
+ initAddScope(scope);
+ tempKey.reset();
+ group.addAllNodesForScopedAltApp(mirrorAltApp,addScopeList, tempKey);
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = null;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+
+
+ /**
+ * Returns a count of this nodes' scopes.
+ * @return the number of scopes descendant from this node
+ */
+ int numScopes() {
+ return scopes.size();
+ }
+
+
+ /**
+ * This sets the immedate mode context flag
+ */
+ void setInImmCtx(boolean inCtx) {
+ inImmCtx = inCtx;
+ }
+
+ /**
+ * This gets the immedate mode context flag
+ */
+ boolean getInImmCtx() {
+ return (inImmCtx);
+ }
+
+ boolean isScoped() {
+ return (scopes != null);
+ }
+
+
+ void updateImmediateMirrorObject(Object[] objs) {
+ GroupRetained group;
+ Vector currentScopes;
+ int i, nscopes;
+ Transform3D trans;
+
+ int component = ((Integer)objs[1]).intValue();
+ if ((component & APPEARANCE_CHANGED) != 0) {
+ mirrorAltApp.appearance = (AppearanceRetained)objs[2];
+ }
+ if ((component & BOUNDS_CHANGED) != 0) {
+ mirrorAltApp.regionOfInfluence = (Bounds) objs[2];
+ if (mirrorAltApp.boundingLeaf == null) {
+ if (objs[2] != null) {
+ mirrorAltApp.region = (Bounds)mirrorAltApp.regionOfInfluence.copy(mirrorAltApp.region);
+ mirrorAltApp.region.transform(
+ mirrorAltApp.regionOfInfluence,
+ getCurrentLocalToVworld());
+ }
+ else {
+ mirrorAltApp.region = null;
+ }
+ }
+ }
+ else if ((component & BOUNDINGLEAF_CHANGED) != 0) {
+ mirrorAltApp.boundingLeaf = (BoundingLeafRetained)objs[2];
+ if (objs[2] != null) {
+ mirrorAltApp.region = (Bounds)mirrorAltApp.boundingLeaf.transformedRegion;
+ }
+ else {
+ if (mirrorAltApp.regionOfInfluence != null) {
+ mirrorAltApp.region = mirrorAltApp.regionOfInfluence.copy(mirrorAltApp.region);
+ mirrorAltApp.region.transform(
+ mirrorAltApp.regionOfInfluence,
+ getCurrentLocalToVworld());
+ }
+ else {
+ mirrorAltApp.region = null;
+ }
+
+ }
+ }
+ else if ((component & SCOPE_CHANGED) != 0) {
+ Object[] scopeList = (Object[])objs[2];
+ ArrayList addList = (ArrayList)scopeList[0];
+ ArrayList removeList = (ArrayList)scopeList[1];
+ boolean isScoped = ((Boolean)scopeList[2]).booleanValue();
+
+ if (addList != null) {
+ mirrorAltApp.isScoped = isScoped;
+ for (i = 0; i < addList.size(); i++) {
+ Shape3DRetained obj = ((GeometryAtom)addList.get(i)).source;
+ obj.addAltApp(mirrorAltApp);
+ }
+ }
+
+ if (removeList != null) {
+ mirrorAltApp.isScoped = isScoped;
+ for (i = 0; i < removeList.size(); i++) {
+ Shape3DRetained obj = ((GeometryAtom)removeList.get(i)).source;
+ obj.removeAltApp(mirrorAltApp);
+ }
+ }
+ }
+
+
+ }
+
+
+ /** Note: This routine will only be called on
+ * the mirror object - will update the object's
+ * cached region and transformed region
+ */
+
+ void updateBoundingLeaf() {
+ if (boundingLeaf != null && boundingLeaf.switchState.currentSwitchOn) {
+ region = boundingLeaf.transformedRegion;
+ } else {
+ if (regionOfInfluence != null) {
+ region = regionOfInfluence.copy(region);
+ region.transform(regionOfInfluence, getCurrentLocalToVworld());
+ } else {
+ region = null;
+ }
+ }
+ }
+
+ void setLive(SetLiveState s) {
+ GroupRetained group;
+ Vector currentScopes;
+ int i, nscopes;
+ TransformGroupRetained[] tlist;
+
+ if (inImmCtx) {
+ throw new IllegalSharingException(J3dI18N.getString("AlternateAppearanceRetained13"));
+ }
+
+ if (inSharedGroup) {
+ throw new
+ IllegalSharingException(J3dI18N.getString("AlternateAppearanceRetained15"));
+ }
+
+ if (inBackgroundGroup) {
+ throw new
+ IllegalSceneGraphException(J3dI18N.getString("AlternateAppearanceRetained16"));
+ }
+
+ super.doSetLive(s);
+
+ if (appearance != null) {
+ if (appearance.getInImmCtx()) {
+ throw new IllegalSharingException(J3dI18N.getString("AlternateAppearanceRetained14"));
+ }
+ synchronized(appearance.liveStateLock) {
+ appearance.setLive(inBackgroundGroup, s.refCount);
+ }
+ }
+
+ // Create the mirror object
+ // Initialization of the mirror object during the INSERT_NODE
+ // message (in updateMirrorObject)
+ if (mirrorAltApp == null) {
+ mirrorAltApp = (AlternateAppearanceRetained)this.clone();
+ // Assign the bounding leaf of this mirror object as null
+ // it will later be assigned to be the mirror of the alternate app
+ // bounding leaf object
+ mirrorAltApp.boundingLeaf = null;
+ mirrorAltApp.sgAltApp = this;
+ }
+ // If bounding leaf is not null, add the mirror object as a user
+ // so that any changes to the bounding leaf will be received
+ if (boundingLeaf != null) {
+ boundingLeaf.mirrorBoundingLeaf.addUser(mirrorAltApp);
+ }
+
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(mirrorAltApp);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(mirrorAltApp);
+ }
+
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorAltApp,
+ Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+
+ // process switch leaf
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorAltApp, Targets.ENV_TARGETS);
+ }
+ mirrorAltApp.switchState = (SwitchState)s.switchStates.get(0);
+
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+
+ // At the end make it live
+ super.markAsLive();
+
+ // Initialize the mirror object, this needs to be done, when
+ // renderBin is not accessing any of the fields
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.ALTERNATEAPPEARANCE_CHANGED;
+ createMessage.args[0] = this;
+ // a snapshot of all attributes that needs to be initialized
+ // in the mirror object
+ createMessage.args[1]= new Integer(INIT_MIRROR);
+ ArrayList addScopeList = new ArrayList();
+ for (i = 0; i < scopes.size(); i++) {
+ group = (GroupRetained)scopes.get(i);
+ tempKey.reset();
+ group.addAllNodesForScopedAltApp(mirrorAltApp, addScopeList, tempKey);
+ }
+ Object[] scopeInfo = new Object[2];
+ scopeInfo[0] = ((scopes.size() > 0) ? Boolean.TRUE:Boolean.FALSE);
+ scopeInfo[1] = addScopeList;
+ createMessage.args[2] = scopeInfo;
+ if (appearance != null) {
+ createMessage.args[3] = appearance.mirror;
+ }
+ else {
+ createMessage.args[3] = null;
+ }
+ Object[] obj = new Object[2];
+ obj[0] = boundingLeaf;
+ obj[1] = (regionOfInfluence != null?regionOfInfluence.clone():null);
+ createMessage.args[4] = obj;
+ VirtualUniverse.mc.processMessage(createMessage);
+
+
+
+
+
+ }
+
+ /**
+ * This is called on the parent object
+ */
+ void initMirrorObject(Object[] args) {
+ Shape3DRetained shape;
+ Object[] scopeInfo = (Object[]) args[2];
+ Boolean scoped = (Boolean)scopeInfo[0];
+ ArrayList shapeList = (ArrayList)scopeInfo[1];
+ AppearanceRetained app = (AppearanceRetained)args[3];
+ BoundingLeafRetained bl=(BoundingLeafRetained)((Object[])args[4])[0];
+ Bounds bnds = (Bounds)((Object[])args[4])[1];
+
+ for (int i = 0; i < shapeList.size(); i++) {
+ shape = ((GeometryAtom)shapeList.get(i)).source;
+ shape.addAltApp(mirrorAltApp);
+ }
+ mirrorAltApp.isScoped = scoped.booleanValue();
+
+ if (app != null)
+ mirrorAltApp.appearance = app;
+
+ if (bl != null) {
+ mirrorAltApp.boundingLeaf = bl.mirrorBoundingLeaf;
+ mirrorAltApp.region = boundingLeaf.transformedRegion;
+ } else {
+ mirrorAltApp.boundingLeaf = null;
+ mirrorAltApp.region = null;
+ }
+
+ if (bnds != null) {
+ mirrorAltApp.regionOfInfluence = bnds;
+ if (mirrorAltApp.region == null) {
+ mirrorAltApp.region = (Bounds)regionOfInfluence.clone();
+ mirrorAltApp.region.transform(regionOfInfluence, getLastLocalToVworld());
+ }
+ }
+ else {
+ mirrorAltApp.regionOfInfluence = null;
+ }
+
+ }
+
+ void clearMirrorObject(Object[] args) {
+ Shape3DRetained shape;
+ ArrayList shapeList = (ArrayList)args[2];
+ ArrayList removeScopeList = new ArrayList();
+
+ for (int i = 0; i < shapeList.size(); i++) {
+ shape = ((GeometryAtom)shapeList.get(i)).source;
+ shape.removeAltApp(mirrorAltApp);
+ }
+ mirrorAltApp.isScoped = false;
+
+
+
+ }
+
+
+ /**
+ * This clearLive routine first calls the superclass's method, then
+ * it removes itself to the list of alt app
+ */
+ void clearLive(SetLiveState s) {
+ int i, j;
+ GroupRetained group;
+
+ if (appearance != null) {
+ synchronized(appearance.liveStateLock) {
+ appearance.clearLive(s.refCount);
+ }
+ }
+
+ super.clearLive(s);
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+
+ // Remove this mirror light as users of the bounding leaf
+ if (mirrorAltApp.boundingLeaf != null)
+ mirrorAltApp.boundingLeaf.removeUser(mirrorAltApp);
+
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(mirrorAltApp);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(mirrorAltApp);
+ }
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorAltApp,
+ Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorAltApp, Targets.ENV_TARGETS);
+ }
+
+
+ if (scopes.size() > 0) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.ALTERNATEAPPEARANCE_CHANGED;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(CLEAR_MIRROR);
+ ArrayList removeScopeList = new ArrayList();
+ for (i = 0; i < scopes.size(); i++) {
+ group = (GroupRetained)scopes.get(i);
+ tempKey.reset();
+ group.removeAllNodesForScopedAltApp(mirrorAltApp, removeScopeList, tempKey);
+ }
+ createMessage.args[2] = removeScopeList;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+ }
+
+
+
+ void updateTransformChange() {
+ }
+
+ /**
+ * Called on mirror object
+ */
+ void updateImmediateTransformChange() {
+ // If bounding leaf is null, tranform the bounds object
+ if (boundingLeaf == null) {
+ if (regionOfInfluence != null) {
+ region = regionOfInfluence.copy(region);
+ region.transform(regionOfInfluence,
+ sgAltApp.getCurrentLocalToVworld());
+ }
+
+ }
+ }
+
+ final void sendMessage(int attrMask, Object attr) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.ALTERNATEAPPEARANCE_CHANGED;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+
+ void getMirrorObjects(ArrayList leafList, HashKey key) {
+ leafList.add(mirrorAltApp);
+ }
+
+
+ /**
+ * Copies all AlternateAppearance information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ throw new RuntimeException("method not implemented");
+
+// super.duplicateAttributes(originalNode, forceDuplicate);
+
+// AlternateAppearance alternate appearance = (AlternateAppearance) originalNode;
+
+// // XXXX: clone appearance
+
+// setInfluencingBounds(alternate appearance.getInfluencingBounds());
+
+// Enumeration elm = alternate appearance.getAllScopes();
+// while (elm.hasMoreElements()) {
+// // this reference will set correctly in updateNodeReferences() callback
+// addScope((Group) elm.nextElement());
+// }
+
+// // this reference will set correctly in updateNodeReferences() callback
+// setInfluencingBoundingLeaf(alternate appearance.getInfluencingBoundingLeaf());
+ }
+
+// /**
+// * Callback used to allow a node to check if any nodes referenced
+// * by that node have been duplicated via a call to cloneTree.
+// * This method is called by cloneTree after all nodes in
+// * the sub-graph have been duplicated. The cloned Leaf node's method
+// * will be called and the Leaf node can then look up any node references
+// * by using the getNewObjectReference method found in the
+// * NodeReferenceTable object. If a match is found, a
+// * reference to the corresponding Node in the newly cloned sub-graph
+// * is returned. If no corresponding reference is found, either a
+// * DanglingReferenceException is thrown or a reference to the original
+// * node is returned depending on the value of the
+// * allowDanglingReferences parameter passed in the
+// * cloneTree call.
+// * getNewObjectReference method needed to search for
+// * new object instances.
+// * @see NodeReferenceTable
+// * @see Node#cloneTree
+// * @see DanglingReferenceException
+// */
+// public void updateNodeReferences(NodeReferenceTable referenceTable) {
+// throw new RuntimeException("method not implemented");
+//
+// Object o;
+//
+// BoundingLeaf bl = getInfluencingBoundingLeaf();
+// if (bl != null) {
+// o = referenceTable.getNewObjectReference(bl);
+// setInfluencingBoundingLeaf((BoundingLeaf) o);
+// }
+//
+// for (int i=0; i < numScopes(); i++) {
+// o = referenceTable.getNewObjectReference(getScope(i));
+// setScope((Group) o, i);
+// }
+// }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AmbientLight.java b/j3d-core/src/classes/share/javax/media/j3d/AmbientLight.java
new file mode 100644
index 0000000..0c65b45
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AmbientLight.java
@@ -0,0 +1,109 @@
+/*
+ * $RCSfile: AmbientLight.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+
+/**
+ * An ambient light source object. Ambient light is that light
+ * that seems to come from all directions. The AmbientLight object
+ * has the same attributes as a Light node, including color,
+ * influencing bounds, scopes, and
+ * a flag indicating whether this light source is on or off.
+ * Ambient reflections do not depend on the orientation or
+ * position of a surface.
+ * Ambient light has only an ambient reflection component.
+ * It does not have diffuse or specular reflection components.
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ AmbientLight a = new AmbientLight();
+ a.duplicateNode(this, forceDuplicate);
+ return a;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AmbientLightRetained.java b/j3d-core/src/classes/share/javax/media/j3d/AmbientLightRetained.java
new file mode 100644
index 0000000..37b9b4e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AmbientLightRetained.java
@@ -0,0 +1,58 @@
+/*
+ * $RCSfile: AmbientLightRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+
+/**
+ * An ambient light source object.
+ */
+
+class AmbientLightRetained extends LightRetained {
+
+ AmbientLightRetained() {
+ this.nodeType = NodeRetained.AMBIENTLIGHT;
+ lightType = 1;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ void setLive(SetLiveState s) {
+ super.setLive(s);
+ J3dMessage createMessage = super.initMessage(7);
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+ void update(Context ctx, int lightSlot, double scale) {
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Appearance.java b/j3d-core/src/classes/share/javax/media/j3d/Appearance.java
new file mode 100644
index 0000000..2e276a6
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Appearance.java
@@ -0,0 +1,1032 @@
+/*
+ * $RCSfile: Appearance.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Hashtable;
+
+/**
+ * The Appearance object defines all rendering state that can be set
+ * as a component object of a Shape3D node. The rendering state
+ * consists of the following:
+ *
+ *
+ * @see ColoringAttributes
+ * @see LineAttributes
+ * @see PointAttributes
+ * @see PolygonAttributes
+ * @see RenderingAttributes
+ * @see TransparencyAttributes
+ * @see Material
+ * @see Texture
+ * @see TextureAttributes
+ * @see TexCoordGeneration
+ * @see TextureUnitState
+ */
+public class Appearance extends NodeComponent {
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its coloringAttributes component
+ * information.
+ */
+ public static final int
+ ALLOW_COLORING_ATTRIBUTES_READ = CapabilityBits.APPEARANCE_ALLOW_COLORING_ATTRIBUTES_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its coloringAttributes component
+ * information.
+ */
+ public static final int
+ ALLOW_COLORING_ATTRIBUTES_WRITE = CapabilityBits.APPEARANCE_ALLOW_COLORING_ATTRIBUTES_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its transparency component
+ * information.
+ */
+ public static final int
+ ALLOW_TRANSPARENCY_ATTRIBUTES_READ = CapabilityBits.APPEARANCE_ALLOW_TRANSPARENCY_ATTRIBUTES_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its transparency component
+ * information.
+ */
+ public static final int
+ ALLOW_TRANSPARENCY_ATTRIBUTES_WRITE = CapabilityBits.APPEARANCE_ALLOW_TRANSPARENCY_ATTRIBUTES_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its rendering/rasterization component
+ * information.
+ */
+ public static final int
+ ALLOW_RENDERING_ATTRIBUTES_READ = CapabilityBits.APPEARANCE_ALLOW_RENDERING_ATTRIBUTES_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its rendering/rasterization component
+ * information.
+ */
+ public static final int
+ ALLOW_RENDERING_ATTRIBUTES_WRITE = CapabilityBits.APPEARANCE_ALLOW_RENDERING_ATTRIBUTES_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its polygon component
+ * information.
+ */
+ public static final int
+ ALLOW_POLYGON_ATTRIBUTES_READ = CapabilityBits.APPEARANCE_ALLOW_POLYGON_ATTRIBUTES_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its polygon component
+ * information.
+ */
+ public static final int
+ ALLOW_POLYGON_ATTRIBUTES_WRITE = CapabilityBits.APPEARANCE_ALLOW_POLYGON_ATTRIBUTES_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its line component
+ * information.
+ */
+ public static final int
+ ALLOW_LINE_ATTRIBUTES_READ = CapabilityBits.APPEARANCE_ALLOW_LINE_ATTRIBUTES_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its line component
+ * information.
+ */
+ public static final int
+ ALLOW_LINE_ATTRIBUTES_WRITE = CapabilityBits.APPEARANCE_ALLOW_LINE_ATTRIBUTES_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its point component
+ * information.
+ */
+ public static final int
+ ALLOW_POINT_ATTRIBUTES_READ = CapabilityBits.APPEARANCE_ALLOW_POINT_ATTRIBUTES_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its point component
+ * information.
+ */
+ public static final int
+ ALLOW_POINT_ATTRIBUTES_WRITE = CapabilityBits.APPEARANCE_ALLOW_POINT_ATTRIBUTES_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its material component information.
+ */
+ public static final int
+ ALLOW_MATERIAL_READ = CapabilityBits.APPEARANCE_ALLOW_MATERIAL_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its material component information.
+ */
+ public static final int
+ ALLOW_MATERIAL_WRITE = CapabilityBits.APPEARANCE_ALLOW_MATERIAL_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its texture component information.
+ */
+ public static final int
+ ALLOW_TEXTURE_READ = CapabilityBits.APPEARANCE_ALLOW_TEXTURE_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its texture component information.
+ */
+ public static final int
+ ALLOW_TEXTURE_WRITE = CapabilityBits.APPEARANCE_ALLOW_TEXTURE_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its textureAttributes component
+ * information.
+ */
+ public static final int
+ ALLOW_TEXTURE_ATTRIBUTES_READ = CapabilityBits.APPEARANCE_ALLOW_TEXTURE_ATTRIBUTES_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its textureAttributes component
+ * information.
+ */
+ public static final int
+ ALLOW_TEXTURE_ATTRIBUTES_WRITE = CapabilityBits.APPEARANCE_ALLOW_TEXTURE_ATTRIBUTES_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its texture coordinate generation component
+ * information.
+ */
+ public static final int
+ ALLOW_TEXGEN_READ = CapabilityBits.APPEARANCE_ALLOW_TEXGEN_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its texture coordinate generation component
+ * information.
+ */
+ public static final int
+ ALLOW_TEXGEN_WRITE = CapabilityBits.APPEARANCE_ALLOW_TEXGEN_WRITE;
+
+ /**
+ * Specifies that this Appearance object
+ * allows reading its texture unit state component
+ * information.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int ALLOW_TEXTURE_UNIT_STATE_READ =
+ CapabilityBits.APPEARANCE_ALLOW_TEXTURE_UNIT_STATE_READ;
+
+ /**
+ * Specifies that this Appearance object
+ * allows writing its texture unit state component
+ * information.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int ALLOW_TEXTURE_UNIT_STATE_WRITE =
+ CapabilityBits.APPEARANCE_ALLOW_TEXTURE_UNIT_STATE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_COLORING_ATTRIBUTES_READ,
+ ALLOW_LINE_ATTRIBUTES_READ,
+ ALLOW_MATERIAL_READ,
+ ALLOW_POINT_ATTRIBUTES_READ,
+ ALLOW_POLYGON_ATTRIBUTES_READ,
+ ALLOW_RENDERING_ATTRIBUTES_READ,
+ ALLOW_TEXGEN_READ,
+ ALLOW_TEXTURE_ATTRIBUTES_READ,
+ ALLOW_TEXTURE_READ,
+ ALLOW_TEXTURE_UNIT_STATE_READ,
+ ALLOW_TRANSPARENCY_ATTRIBUTES_READ
+ };
+
+ /**
+ * Constructs an Appearance component object using defaults for all
+ * state variables. All component object references are initialized
+ * to null.
+ */
+ public Appearance() {
+ // Just use default values
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Creates the retained mode AppearanceRetained object that this
+ * Appearance component object will point to.
+ */
+ void createRetained() {
+ this.retained = new AppearanceRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Sets the material object to the specified object.
+ * Setting it to null disables lighting.
+ * @param material object that specifies the desired material
+ * properties
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setMaterial(Material material) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_MATERIAL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance0"));
+ ((AppearanceRetained)this.retained).setMaterial(material);
+ }
+
+ /**
+ * Retrieves the current material object.
+ * @return the material object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Material getMaterial() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_MATERIAL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance1"));
+ return ((AppearanceRetained)this.retained).getMaterial();
+ }
+
+ /**
+ * Sets the coloringAttributes object to the specified object.
+ * Setting it to null will result in default attribute usage.
+ * @param coloringAttributes object that specifies the desired
+ * coloringAttributes parameters
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setColoringAttributes(ColoringAttributes coloringAttributes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COLORING_ATTRIBUTES_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance6"));
+ ((AppearanceRetained)this.retained).setColoringAttributes(coloringAttributes);
+ }
+
+ /**
+ * Retrieves the current coloringAttributes object.
+ * @return the coloringAttributes object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public ColoringAttributes getColoringAttributes() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COLORING_ATTRIBUTES_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance7"));
+ return ((AppearanceRetained)this.retained).getColoringAttributes();
+ }
+
+ /**
+ * Sets the transparencyAttributes object to the specified object.
+ * Setting it to null will result in default attribute usage.
+ * @param transparencyAttributes object that specifies the desired
+ * transparencyAttributes parameters
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setTransparencyAttributes(TransparencyAttributes transparencyAttributes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_TRANSPARENCY_ATTRIBUTES_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance8"));
+ ((AppearanceRetained)this.retained).setTransparencyAttributes(transparencyAttributes);
+ }
+
+ /**
+ * Retrieves the current transparencyAttributes object.
+ * @return the transparencyAttributes object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public TransparencyAttributes getTransparencyAttributes() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_TRANSPARENCY_ATTRIBUTES_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance9"));
+ return ((AppearanceRetained)this.retained).getTransparencyAttributes();
+ }
+
+ /**
+ * Sets the renderingAttributes object to the specified object.
+ * Setting it to null will result in default attribute usage.
+ * @param renderingAttributes object that specifies the desired
+ * renderingAttributes parameters
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setRenderingAttributes(RenderingAttributes renderingAttributes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_RENDERING_ATTRIBUTES_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance10"));
+ ((AppearanceRetained)this.retained).setRenderingAttributes(renderingAttributes);
+ }
+
+ /**
+ * Retrieves the current renderingAttributes object.
+ * @return the renderingAttributes object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public RenderingAttributes getRenderingAttributes() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_RENDERING_ATTRIBUTES_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance11"));
+ return ((AppearanceRetained)this.retained).getRenderingAttributes();
+ }
+
+ /**
+ * Sets the polygonAttributes object to the specified object.
+ * Setting it to null will result in default attribute usage.
+ * @param polygonAttributes object that specifies the desired
+ * polygonAttributes parameters
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setPolygonAttributes(PolygonAttributes polygonAttributes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_POLYGON_ATTRIBUTES_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance12"));
+ ((AppearanceRetained)this.retained).setPolygonAttributes(polygonAttributes);
+ }
+
+ /**
+ * Retrieves the current polygonAttributes object.
+ * @return the polygonAttributes object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public PolygonAttributes getPolygonAttributes() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_POLYGON_ATTRIBUTES_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance13"));
+ return ((AppearanceRetained)this.retained).getPolygonAttributes();
+ }
+
+ /**
+ * Sets the lineAttributes object to the specified object.
+ * Setting it to null will result in default attribute usage.
+ * @param lineAttributes object that specifies the desired
+ * lineAttributes parameters
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setLineAttributes(LineAttributes lineAttributes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_LINE_ATTRIBUTES_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance14"));
+ ((AppearanceRetained)this.retained).setLineAttributes(lineAttributes);
+ }
+
+ /**
+ * Retrieves the current lineAttributes object.
+ * @return the lineAttributes object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public LineAttributes getLineAttributes() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_LINE_ATTRIBUTES_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance15"));
+ return ((AppearanceRetained)this.retained).getLineAttributes();
+ }
+
+ /**
+ * Sets the pointAttributes object to the specified object.
+ * Setting it to null will result in default attribute usage.
+ * @param pointAttributes object that specifies the desired
+ * pointAttributes parameters
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setPointAttributes(PointAttributes pointAttributes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_POINT_ATTRIBUTES_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance16"));
+ ((AppearanceRetained)this.retained).setPointAttributes(pointAttributes);
+ }
+
+ /**
+ * Retrieves the current pointAttributes object.
+ * @return the pointAttributes object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public PointAttributes getPointAttributes() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_POINT_ATTRIBUTES_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance17"));
+ return ((AppearanceRetained)this.retained).getPointAttributes();
+ }
+
+ /**
+ * Sets the texture object to the specified object.
+ * Setting it to null disables texture mapping.
+ *
+ * 0 through
+ * stateArray.length-1.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the specified array is
+ * non-null and any of the texture object, textureAttributes
+ * object, or texCoordGeneration object in this appearance object
+ * is already non-null.
+ *
+ * @exception IllegalSharingException if this Appearance is live and
+ * any of the specified textures refers to an ImageComponent2D that is
+ * being used by a Canvas3D as an off-screen buffer.
+ *
+ * @exception IllegalSharingException if this Appearance is
+ * being used by an immediate mode context and
+ * any of the specified textures refers to an ImageComponent2D that is
+ * being used by a Canvas3D as an off-screen buffer.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureUnitState(TextureUnitState[] stateArray) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_TEXTURE_UNIT_STATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance20"));
+
+ // Do illegal sharing check
+ if (stateArray != null) {
+ for(int j=0; jindex >=
+ * stateArray.length.
+ *
+ * @exception IllegalSharingException if this Appearance is live and
+ * the specified texture refers to an ImageComponent2D that is being used
+ * by a Canvas3D as an off-screen buffer.
+ *
+ * @exception IllegalSharingException if this Appearance is
+ * being used by an immediate mode context and
+ * the specified texture refers to an ImageComponent2D that is being used
+ * by a Canvas3D as an off-screen buffer.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureUnitState(int index, TextureUnitState state) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_TEXTURE_UNIT_STATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Appearance20"));
+
+ // Do illegal sharing check
+ if (state != null) {
+ TextureRetained texRetained =
+ ((TextureUnitStateRetained)state.retained).texture;
+ if(texRetained != null) {
+ ImageComponent[] images = texRetained.getImages();
+ if(images != null) {
+ for(int i=0; ioriginalNodeComponent into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+
+ Hashtable hashtable = originalNodeComponent.nodeHashtable;
+
+ AppearanceRetained app = (AppearanceRetained) originalNodeComponent.retained;
+
+ AppearanceRetained rt = (AppearanceRetained) retained;
+
+ rt.setMaterial((Material) getNodeComponent(app.getMaterial(),
+ forceDuplicate,
+ hashtable));
+
+ rt.setColoringAttributes((ColoringAttributes) getNodeComponent(
+ app.getColoringAttributes(),
+ forceDuplicate,
+ hashtable));
+
+
+ rt.setTransparencyAttributes((TransparencyAttributes) getNodeComponent(
+ app.getTransparencyAttributes(),
+ forceDuplicate,
+ hashtable));
+
+
+ rt.setRenderingAttributes((RenderingAttributes) getNodeComponent(
+ app.getRenderingAttributes(),
+ forceDuplicate,
+ hashtable));
+
+
+ rt.setPolygonAttributes((PolygonAttributes) getNodeComponent(
+ app.getPolygonAttributes(),
+ forceDuplicate,
+ hashtable));
+
+
+ rt.setLineAttributes((LineAttributes) getNodeComponent(
+ app.getLineAttributes(),
+ forceDuplicate,
+ hashtable));
+
+
+ rt.setPointAttributes((PointAttributes) getNodeComponent(
+ app.getPointAttributes(),
+ forceDuplicate,
+ hashtable));
+
+ rt.setTexture((Texture) getNodeComponent(app.getTexture(),
+ forceDuplicate,
+ hashtable));
+
+ rt.setTextureAttributes((TextureAttributes) getNodeComponent(
+ app.getTextureAttributes(),
+ forceDuplicate,
+ hashtable));
+
+ rt.setTexCoordGeneration((TexCoordGeneration) getNodeComponent(
+ app.getTexCoordGeneration(),
+ forceDuplicate,
+ hashtable));
+
+ TextureUnitState state[] = app.getTextureUnitState();
+ if (state != null) {
+ rt.setTextureUnitState(state);
+ for (int i=0; i < state.length; i++) {
+ rt.setTextureUnitState(i, (TextureUnitState)
+ getNodeComponent(state[i],
+ forceDuplicate,
+ hashtable));
+ }
+ }
+
+ }
+
+ /**
+ * 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() {
+ if (getDuplicateOnCloneTree())
+ return true;
+
+ AppearanceRetained rt = (AppearanceRetained) retained;
+
+ NodeComponent nc;
+
+ nc = rt.getMaterial();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ nc = rt.getColoringAttributes();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ nc = rt.getTransparencyAttributes();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ nc = rt.getPolygonAttributes();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ nc = rt.getLineAttributes();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ nc = rt.getPointAttributes();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ nc = rt.getTexture();
+ if ((nc != null) && nc.duplicateChild())
+ return true;
+
+ nc = rt.getTextureAttributes();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ nc = rt.getTexCoordGeneration();
+ if ((nc != null) && nc.getDuplicateOnCloneTree())
+ return true;
+
+ // XXXX: TextureUnitState
+
+ return false;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AppearanceRetained.java b/j3d-core/src/classes/share/javax/media/j3d/AppearanceRetained.java
new file mode 100644
index 0000000..f1b9029
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AppearanceRetained.java
@@ -0,0 +1,1417 @@
+/*
+ * $RCSfile: AppearanceRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.11 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Vector;
+import java.util.BitSet;
+import java.util.ArrayList;
+
+
+/**
+ * The Appearance object defines all rendering state that can be set
+ * as a component object of a Shape3D node.
+ */
+class AppearanceRetained extends NodeComponentRetained {
+
+ //
+ // State variables: these should all be initialized to approproate
+ // Java 3D defaults.
+ //
+
+ // Material object used when lighting is enabled
+ MaterialRetained material = null;
+
+ // Texture object used to apply a texture map to an object
+ TextureRetained texture = null;
+
+ // Texture coordinate generation object
+ TexCoordGenerationRetained texCoordGeneration = null;
+
+ // Texture Attributes bundle object
+ TextureAttributesRetained textureAttributes = null;
+
+ TextureUnitStateRetained texUnitState[] = null;
+
+ // Coloring Attributes bundle object
+ ColoringAttributesRetained coloringAttributes = null;
+
+ // Transparency Attributes bundle object
+ TransparencyAttributesRetained transparencyAttributes = null;
+
+ // Rendering Attributes bundle object
+ RenderingAttributesRetained renderingAttributes = null;
+
+ // Polygon Attributes bundle object
+ PolygonAttributesRetained polygonAttributes = null;
+
+ // Line Attributes bundle object
+ LineAttributesRetained lineAttributes = null;
+
+ // Point Attributes bundle object
+ PointAttributesRetained pointAttributes = null;
+
+
+ // Lock used for synchronization of live state
+ Object liveStateLock = new Object();
+
+ // NOTE: Consider grouping random state into common objects
+
+ // Cache used during compilation. If map == compState, then
+ // mapAppearance can be used for this appearance
+ CompileState map = null;
+ AppearanceRetained mapAppearance = null;
+
+ static final int MATERIAL = 0x0001;
+ static final int TEXTURE = 0x0002;
+ static final int TEXCOORD_GEN = 0x0004;
+ static final int TEXTURE_ATTR = 0x0008;
+ static final int COLOR = 0x0010;
+ static final int TRANSPARENCY = 0x0020;
+ static final int RENDERING = 0x0040;
+ static final int POLYGON = 0x0080;
+ static final int LINE = 0x0100;
+ static final int POINT = 0x0200;
+ static final int TEXTURE_UNIT_STATE = 0x0400;
+
+ static final int ALL_SOLE_USERS = 0;
+
+ // A pointer to the scene graph appearance object
+ AppearanceRetained sgApp = null;
+
+ // The object level hashcode for this appearance
+ // int objHashCode = super.hashCode();
+
+ /**
+ * Set the material object to the specified object.
+ * @param material object that specifies the desired material
+ * @exception IllegalSharingException
+ * properties
+ */
+ void setMaterial(Material material) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.material != null) {
+ this.material.clearLive(refCount);
+ this.material.removeMirrorUsers(this);
+ }
+ if (material != null) {
+ ((MaterialRetained)material.retained).setLive(inBackgroundGroup, refCount);
+ // If appearance is live, then copy all the users of this
+ // appaearance as users of this material
+ ((MaterialRetained)material.retained).copyMirrorUsers(this);
+ }
+ sendMessage(MATERIAL,
+ (material != null ?
+ ((MaterialRetained)material.retained).mirror : null), true);
+ }
+ if (material == null) {
+ this.material = null;
+ } else {
+ this.material = (MaterialRetained)material.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieve the current material object.
+ * @return the material object
+ */
+ Material getMaterial() {
+ return (material == null ? null : (Material)material.source);
+ }
+
+ /**
+ * Sets the texture object to the specified object.
+ * @param texture object that specifies the desired texture
+ * map and texture parameters
+ */
+ void setTexture(Texture texture) {
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.texture != null) {
+ this.texture.clearLive(refCount);
+ this.texture.removeMirrorUsers(this);
+ }
+
+ if (texture != null) {
+ ((TextureRetained)texture.retained).setLive(inBackgroundGroup, refCount);
+ ((TextureRetained)texture.retained).copyMirrorUsers(this);
+ }
+ sendMessage(TEXTURE,
+ (texture != null ?
+ ((TextureRetained)texture.retained).mirror : null), true);
+
+ }
+
+
+ if (texture == null) {
+ this.texture = null;
+ } else {
+ this.texture = (TextureRetained)texture.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current texture object.
+ * @return the texture object
+ */
+ Texture getTexture() {
+ return (texture == null ? null : (Texture)texture.source);
+ }
+
+ /**
+ * Sets the textureAttrbutes object to the specified object.
+ * @param textureAttributes object that specifies the desired texture
+ * attributes
+ */
+ void setTextureAttributes(TextureAttributes textureAttributes) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.textureAttributes != null) {
+ this.textureAttributes.clearLive(refCount);
+ this.textureAttributes.removeMirrorUsers(this);
+ }
+
+ if (textureAttributes != null) {
+ ((TextureAttributesRetained)textureAttributes.retained).setLive(inBackgroundGroup, refCount);
+ ((TextureAttributesRetained)textureAttributes.retained).copyMirrorUsers(this);
+ }
+ sendMessage(TEXTURE_ATTR,
+ (textureAttributes != null ?
+ ((TextureAttributesRetained)textureAttributes.retained).mirror:
+ null), true);
+
+ }
+
+
+ if (textureAttributes == null) {
+ this.textureAttributes = null;
+ } else {
+ this.textureAttributes = (TextureAttributesRetained)textureAttributes.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current textureAttributes object.
+ * @return the textureAttributes object
+ */
+ TextureAttributes getTextureAttributes() {
+ return (textureAttributes == null ? null :
+ (TextureAttributes)textureAttributes.source);
+ }
+
+ /**
+ * Sets the coloringAttrbutes object to the specified object.
+ * @param coloringAttributes object that specifies the desired texture
+ * attributes
+ */
+ void setColoringAttributes(ColoringAttributes coloringAttributes) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.coloringAttributes != null) {
+ this.coloringAttributes.clearLive(refCount);
+ this.coloringAttributes.removeMirrorUsers(this);
+ }
+
+ if (coloringAttributes != null) {
+ ((ColoringAttributesRetained)coloringAttributes.retained).setLive(inBackgroundGroup, refCount);
+ ((ColoringAttributesRetained)coloringAttributes.retained).copyMirrorUsers(this);
+ }
+ sendMessage(COLOR,
+ (coloringAttributes != null ?
+ ((ColoringAttributesRetained)coloringAttributes.retained).mirror:
+ null), true);
+ }
+
+
+ if (coloringAttributes == null) {
+ this.coloringAttributes = null;
+ } else {
+ this.coloringAttributes = (ColoringAttributesRetained)coloringAttributes.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current coloringAttributes object.
+ * @return the coloringAttributes object
+ */
+ ColoringAttributes getColoringAttributes() {
+ return (coloringAttributes == null ? null :
+ (ColoringAttributes)coloringAttributes.source);
+ }
+
+ /**
+ * Sets the transparencyAttrbutes object to the specified object.
+ * @param transparencyAttributes object that specifies the desired texture
+ * attributes
+ */
+ void setTransparencyAttributes(TransparencyAttributes transparencyAttributes) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.transparencyAttributes != null) {
+ this.transparencyAttributes.clearLive(refCount);
+ this.transparencyAttributes.removeMirrorUsers(this);
+ }
+
+ if (transparencyAttributes != null) {
+ ((TransparencyAttributesRetained)transparencyAttributes.retained).setLive(inBackgroundGroup, refCount);
+ ((TransparencyAttributesRetained)transparencyAttributes.retained).copyMirrorUsers(this);
+ }
+
+ sendMessage(TRANSPARENCY,
+ (transparencyAttributes != null ?
+ ((TransparencyAttributesRetained)transparencyAttributes.retained).mirror: null), true);
+ }
+
+
+ if (transparencyAttributes == null) {
+ this.transparencyAttributes = null;
+ } else {
+ this.transparencyAttributes = (TransparencyAttributesRetained)transparencyAttributes.retained;
+
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current transparencyAttributes object.
+ * @return the transparencyAttributes object
+ */
+ TransparencyAttributes getTransparencyAttributes() {
+ return (transparencyAttributes == null ? null :
+ (TransparencyAttributes)transparencyAttributes.source);
+ }
+
+ /**
+ * Sets the renderingAttrbutes object to the specified object.
+ * @param renderingAttributes object that specifies the desired texture
+ * attributes
+ */
+ void setRenderingAttributes(RenderingAttributes renderingAttributes) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+ if (this.renderingAttributes != null) {
+ this.renderingAttributes.clearLive(refCount);
+ this.renderingAttributes.removeMirrorUsers(this);
+ }
+
+ if (renderingAttributes != null) {
+ ((RenderingAttributesRetained)renderingAttributes.retained).setLive(inBackgroundGroup, refCount);
+ ((RenderingAttributesRetained)renderingAttributes.retained).copyMirrorUsers(this);
+ }
+ Object m = null;
+ boolean v = true;
+ if (renderingAttributes != null) {
+ m = ((RenderingAttributesRetained)renderingAttributes.retained).mirror;
+ v = ((RenderingAttributesRetained)renderingAttributes.retained).visible;
+ }
+ sendMessage(RENDERING,m, v);
+ // Also need to send a message to GeometryStructure.
+ sendRenderingAttributesChangedMessage( v);
+ }
+ if (renderingAttributes == null) {
+ this.renderingAttributes = null;
+ } else {
+ this.renderingAttributes = (RenderingAttributesRetained)renderingAttributes.retained;
+
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current renderingAttributes object.
+ * @return the renderingAttributes object
+ */
+ RenderingAttributes getRenderingAttributes() {
+ if (renderingAttributes == null)
+ return null;
+
+ return (RenderingAttributes)renderingAttributes.source;
+ }
+
+ /**
+ * Sets the polygonAttrbutes object to the specified object.
+ * @param polygonAttributes object that specifies the desired texture
+ * attributes
+ */
+ void setPolygonAttributes(PolygonAttributes polygonAttributes) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+ if (this.polygonAttributes != null) {
+ this.polygonAttributes.clearLive(refCount);
+ this.polygonAttributes.removeMirrorUsers(this);
+ }
+
+ if (polygonAttributes != null) {
+ ((PolygonAttributesRetained)polygonAttributes.retained).setLive(inBackgroundGroup, refCount);
+ ((PolygonAttributesRetained)polygonAttributes.retained).copyMirrorUsers(this);
+ }
+ sendMessage(POLYGON,
+ (polygonAttributes != null ?
+ ((PolygonAttributesRetained)polygonAttributes.retained).mirror :
+ null), true);
+
+ }
+
+ if (polygonAttributes == null) {
+ this.polygonAttributes = null;
+ } else {
+ this.polygonAttributes = (PolygonAttributesRetained)polygonAttributes.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current polygonAttributes object.
+ * @return the polygonAttributes object
+ */
+ PolygonAttributes getPolygonAttributes() {
+ return (polygonAttributes == null ? null:
+ (PolygonAttributes)polygonAttributes.source);
+ }
+
+ /**
+ * Sets the lineAttrbutes object to the specified object.
+ * @param lineAttributes object that specifies the desired texture
+ * attributes
+ */
+ void setLineAttributes(LineAttributes lineAttributes) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.lineAttributes != null) {
+ this.lineAttributes.clearLive(refCount);
+ this.lineAttributes.removeMirrorUsers(this);
+ }
+
+ if (lineAttributes != null) {
+ ((LineAttributesRetained)lineAttributes.retained).setLive(inBackgroundGroup, refCount);
+ ((LineAttributesRetained)lineAttributes.retained).copyMirrorUsers(this);
+ }
+ sendMessage(LINE,
+ (lineAttributes != null ?
+ ((LineAttributesRetained)lineAttributes.retained).mirror: null), true);
+ }
+
+
+ if (lineAttributes == null) {
+ this.lineAttributes = null;
+ } else {
+ this.lineAttributes = (LineAttributesRetained)lineAttributes.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current lineAttributes object.
+ * @return the lineAttributes object
+ */
+ LineAttributes getLineAttributes() {
+ return (lineAttributes == null ? null :
+ (LineAttributes)lineAttributes.source);
+ }
+
+ /**
+ * Sets the pointAttrbutes object to the specified object.
+ * @param pointAttributes object that specifies the desired texture
+ * attributes
+ */
+ void setPointAttributes(PointAttributes pointAttributes) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.pointAttributes != null) {
+ this.pointAttributes.clearLive(refCount);
+ this.pointAttributes.removeMirrorUsers(this);
+ }
+ if (pointAttributes != null) {
+ ((PointAttributesRetained)pointAttributes.retained).setLive(inBackgroundGroup, refCount);
+ ((PointAttributesRetained)pointAttributes.retained).copyMirrorUsers(this);
+ }
+ sendMessage(POINT,
+ (pointAttributes != null ?
+ ((PointAttributesRetained)pointAttributes.retained).mirror:
+ null), true);
+ }
+
+
+ if (pointAttributes == null) {
+ this.pointAttributes = null;
+ } else {
+ this.pointAttributes = (PointAttributesRetained)pointAttributes.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current pointAttributes object.
+ * @return the pointAttributes object
+ */
+ PointAttributes getPointAttributes() {
+ return (pointAttributes == null? null : (PointAttributes)pointAttributes.source);
+ }
+
+ /**
+ * Sets the texCoordGeneration object to the specified object.
+ * @param texCoordGeneration object that specifies the texture coordinate
+ * generation parameters
+ */
+ void setTexCoordGeneration(TexCoordGeneration texGen) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ if (this.texCoordGeneration != null) {
+ this.texCoordGeneration.clearLive(refCount);
+ this.texCoordGeneration.removeMirrorUsers(this);
+ }
+
+ if (texGen != null) {
+ ((TexCoordGenerationRetained)texGen.retained).setLive(inBackgroundGroup, refCount);
+ ((TexCoordGenerationRetained)texGen.retained).copyMirrorUsers(this);
+ }
+ sendMessage(TEXCOORD_GEN,
+ (texGen != null ?
+ ((TexCoordGenerationRetained)texGen.retained).mirror : null), true);
+ }
+
+ if (texGen == null) {
+ this.texCoordGeneration = null;
+ } else {
+ this.texCoordGeneration = (TexCoordGenerationRetained)texGen.retained;
+ }
+ }
+ }
+
+ /**
+ * Retrieves the current texCoordGeneration object.
+ * @return the texCoordGeneration object
+ */
+ TexCoordGeneration getTexCoordGeneration() {
+ return (texCoordGeneration == null ? null :
+ (TexCoordGeneration)texCoordGeneration.source);
+ }
+
+
+ /**
+ * Sets the texture unit state array to the specified array.
+ * @param textureUnitState array that specifies the texture unit state
+ */
+ void setTextureUnitState(TextureUnitState[] stateArray) {
+
+ int i;
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ // remove the existing texture unit states from this appearance
+ if (this.texUnitState != null) {
+ for (i = 0; i < this.texUnitState.length; i++) {
+ if (this.texUnitState[i] != null) {
+ this.texUnitState[i].clearLive(refCount);
+ this.texUnitState[i].removeMirrorUsers(this);
+ }
+ }
+ }
+
+ // add the specified texture unit states to this appearance
+ // also make a copy of the array of references to the units
+ if (stateArray != null && stateArray.length > 0) {
+
+ Object [] args = new Object[2];
+
+ // -1 index means the entire array is to be set
+ args[0] = new Integer(-1);
+
+ // make a copy of the array for the message,
+ TextureUnitStateRetained mirrorStateArray[] =
+ new TextureUnitStateRetained[stateArray.length];
+
+ args[1] = (Object) mirrorStateArray;
+
+ for (i = 0; i < stateArray.length; i++) {
+ TextureUnitState tu = stateArray[i];
+ if (tu != null) {
+ ((TextureUnitStateRetained)tu.retained).setLive(
+ inBackgroundGroup, refCount);
+ ((TextureUnitStateRetained)tu.retained).copyMirrorUsers(
+ this);
+ mirrorStateArray[i] = (TextureUnitStateRetained)
+ ((TextureUnitStateRetained)tu.retained).mirror;
+ } else {
+ mirrorStateArray[i] = null;
+ }
+ }
+ sendMessage(TEXTURE_UNIT_STATE, args, true);
+
+ } else {
+ sendMessage(TEXTURE_UNIT_STATE, null, true);
+ }
+ }
+
+ // assign the retained copy of the texture unit state to the
+ // appearance
+ if (stateArray == null) {
+ this.texUnitState = null;
+ } else {
+
+ // make another copy of the array for the retained object
+ // itself if it doesn't have a copy or the array size is
+ // not the same
+ if ((this.texUnitState == null) ||
+ (this.texUnitState.length != stateArray.length)) {
+ this.texUnitState = new TextureUnitStateRetained[
+ stateArray.length];
+ }
+ for (i = 0; i < stateArray.length; i++) {
+ if (stateArray[i] != null) {
+ this.texUnitState[i] =
+ (TextureUnitStateRetained)stateArray[i].retained;
+ } else {
+ this.texUnitState[i] = null;
+ }
+ }
+ }
+ }
+ }
+
+ void setTextureUnitState(int index, TextureUnitState state) {
+
+ synchronized(liveStateLock) {
+ if (source.isLive()) {
+
+ // remove the existing texture unit states from this appearance
+ // Note: Let Java throw an exception if texUnitState is null
+ // or index is >= texUnitState.length.
+ if (this.texUnitState[index] != null) {
+ this.texUnitState[index].clearLive(refCount);
+ this.texUnitState[index].removeMirrorUsers(this);
+ }
+
+ // add the specified texture unit states to this appearance
+ // also make a copy of the array of references to the units
+ Object args[] = new Object[2];
+ args[0] = new Integer(index);
+
+ if (state != null) {
+ ((TextureUnitStateRetained)state.retained).setLive(
+ inBackgroundGroup, refCount);
+ ((TextureUnitStateRetained)state.retained).copyMirrorUsers(this);
+ args[1] = ((TextureUnitStateRetained)state.retained).mirror;
+ sendMessage(TEXTURE_UNIT_STATE, args, true);
+ } else {
+ args[1] = null;
+ sendMessage(TEXTURE_UNIT_STATE, args, true);
+ }
+ }
+
+ // assign the retained copy of the texture unit state to the
+ // appearance
+ if (state != null) {
+ this.texUnitState[index] = (TextureUnitStateRetained)state.retained;
+ } else {
+ this.texUnitState[index] = null;
+ }
+ }
+ }
+
+
+
+ /**
+ * Retrieves the array of texture unit state objects from this
+ * Appearance object. A shallow copy of the array of references to
+ * the TextureUnitState objects is returned.
+ *
+ */
+ TextureUnitState[] getTextureUnitState() {
+ if (texUnitState == null) {
+ return null;
+ } else {
+ TextureUnitState tus[] =
+ new TextureUnitState[texUnitState.length];
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] != null) {
+ tus[i] = (TextureUnitState) texUnitState[i].source;
+ } else {
+ tus[i] = null;
+ }
+ }
+ return tus;
+ }
+ }
+
+ /**
+ * Retrieves the texture unit state object at the specified
+ * index within the texture unit state array.
+ */
+ TextureUnitState getTextureUnitState(int index) {
+
+ // let Java throw an exception if texUnitState == null or
+ // index is >= length
+ if (texUnitState[index] != null)
+ return (TextureUnitState)texUnitState[index].source;
+ else
+ return null;
+ }
+
+
+ /**
+ * Retrieves the length of the texture unit state array from
+ * this appearance object. The length of this array specifies the
+ * maximum number of texture units that will be used by this
+ * appearance object. If the array is null, a count of 0 is
+ * returned.
+ */
+
+ int getTextureUnitCount() {
+ if (texUnitState == null)
+ return 0;
+ else
+ return texUnitState.length;
+ }
+
+
+ synchronized void createMirrorObject() {
+ if (mirror == null) {
+ // we can't check isStatic() since it sub-NodeComponent
+ // create a new one, we should create a
+ // new AppearanceRetained() even though isStatic() = true.
+ // For simplicity, always create a retained side.
+ mirror = new AppearanceRetained();
+ }
+ initMirrorObject();
+ }
+
+ /**
+ * This routine updates the mirror appearance for this appearance.
+ * It also calls the update method for each node component if it
+ * is not null.
+ */
+ synchronized void initMirrorObject() {
+
+ AppearanceRetained mirrorApp = (AppearanceRetained)mirror;
+
+ mirrorApp.source = source;
+ mirrorApp.sgApp = this;
+
+ // Fix for Issue 33: copy the changedFrequent mask to mirror
+ mirrorApp.changedFrequent = changedFrequent;
+
+ if (material != null) {
+ mirrorApp.material = (MaterialRetained)material.mirror;
+ } else {
+ mirrorApp.material = null;
+ }
+
+ if (texture != null) {
+ mirrorApp.texture = (TextureRetained)texture.mirror;
+ } else {
+ mirrorApp.texture = null;
+ }
+ if (texCoordGeneration != null) {
+ mirrorApp.texCoordGeneration = (TexCoordGenerationRetained)texCoordGeneration.mirror;
+ } else {
+ mirrorApp.texCoordGeneration = null;
+ }
+
+ if (textureAttributes != null) {
+ mirrorApp.textureAttributes = (TextureAttributesRetained)textureAttributes.mirror;
+ } else {
+ mirrorApp.textureAttributes = null;
+ }
+
+ // TextureUnitState supercedes the single texture interface
+ if (texUnitState != null && texUnitState.length > 0) {
+ mirrorApp.texUnitState =
+ new TextureUnitStateRetained[texUnitState.length];
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] != null) {
+ mirrorApp.texUnitState[i] =
+ (TextureUnitStateRetained)texUnitState[i].mirror;
+ }
+ }
+ } else if (mirrorApp.texture != null ||
+ mirrorApp.textureAttributes != null ||
+ mirrorApp.texCoordGeneration != null) {
+
+ mirrorApp.texUnitState = new TextureUnitStateRetained[1];
+ mirrorApp.texUnitState[0] = new TextureUnitStateRetained();
+ mirrorApp.texUnitState[0].set(
+ mirrorApp.texture,
+ mirrorApp.textureAttributes,
+ mirrorApp.texCoordGeneration);
+ }
+
+ if (coloringAttributes != null) {
+ mirrorApp.coloringAttributes = (ColoringAttributesRetained)coloringAttributes.mirror;
+ } else {
+ mirrorApp.coloringAttributes = null;
+ }
+ if (transparencyAttributes != null) {
+ mirrorApp.transparencyAttributes = (TransparencyAttributesRetained)transparencyAttributes.mirror;
+ } else {
+ mirrorApp.transparencyAttributes = null;
+ }
+
+ if (renderingAttributes != null) {
+ mirrorApp.renderingAttributes = (RenderingAttributesRetained)renderingAttributes.mirror;
+ } else {
+ mirrorApp.renderingAttributes = null;
+ }
+
+ if (polygonAttributes != null) {
+ mirrorApp.polygonAttributes = (PolygonAttributesRetained)polygonAttributes.mirror;
+ } else {
+ mirrorApp.polygonAttributes = null;
+ }
+
+ if (lineAttributes != null) {
+ mirrorApp.lineAttributes = (LineAttributesRetained)lineAttributes.mirror;
+ } else {
+ mirrorApp.lineAttributes = null;
+ }
+
+ if (pointAttributes != null) {
+ mirrorApp.pointAttributes = (PointAttributesRetained)pointAttributes.mirror;
+ } else {
+ mirrorApp.pointAttributes = null;
+ }
+ }
+
+ /**
+ * Update the "component" field of the mirror object with the
+ * given "value"
+ */
+ synchronized void updateMirrorObject(int component, Object value) {
+ AppearanceRetained mirrorApp = (AppearanceRetained)mirror;
+ if ((component & MATERIAL) != 0) {
+ mirrorApp.material = (MaterialRetained)value;
+ }
+ else if ((component & TEXTURE) != 0) {
+ // Issue 435: set mirror texture
+ mirrorApp.texture = (TextureRetained)value;
+ if (mirrorApp.texUnitState == null) {
+ mirrorApp.texUnitState = new TextureUnitStateRetained[1];
+ mirrorApp.texUnitState[0] = new TextureUnitStateRetained();
+ }
+ mirrorApp.texUnitState[0].texture = (TextureRetained)value;
+ }
+ else if ((component & TEXCOORD_GEN) != 0) {
+ if (mirrorApp.texUnitState == null) {
+ mirrorApp.texUnitState = new TextureUnitStateRetained[1];
+ mirrorApp.texUnitState[0] = new TextureUnitStateRetained();
+ }
+ mirrorApp.texUnitState[0].texGen = (TexCoordGenerationRetained)value;
+ }
+ else if ((component & TEXTURE_ATTR) != 0) {
+ if (mirrorApp.texUnitState == null) {
+ mirrorApp.texUnitState = new TextureUnitStateRetained[1];
+ mirrorApp.texUnitState[0] = new TextureUnitStateRetained();
+ }
+ mirrorApp.texUnitState[0].texAttrs = (TextureAttributesRetained)value;
+ }
+ else if ((component & TEXTURE_UNIT_STATE) != 0) {
+ Object [] args = (Object [])value;
+
+ if (args == null) {
+ mirrorApp.texUnitState = null;
+ } else {
+ int index = ((Integer)args[0]).intValue();
+ if (index == -1) {
+ mirrorApp.texUnitState =
+ (TextureUnitStateRetained [])args[1];
+ } else {
+ mirrorApp.texUnitState[index] =
+ (TextureUnitStateRetained)args[1];
+ }
+ }
+ }
+ else if ((component & COLOR) != 0) {
+ mirrorApp.coloringAttributes = (ColoringAttributesRetained)value;
+ }
+ else if ((component & TRANSPARENCY) != 0) {
+ mirrorApp.transparencyAttributes = (TransparencyAttributesRetained)value;
+ }
+ else if ((component & RENDERING) != 0) {
+ mirrorApp.renderingAttributes = (RenderingAttributesRetained)value;
+ }
+ else if ((component & POLYGON) != 0) {
+ mirrorApp.polygonAttributes = (PolygonAttributesRetained)value;
+ }
+ else if ((component & LINE) != 0) {
+ mirrorApp.lineAttributes = (LineAttributesRetained)value;
+ }
+ else if ((component & POINT) != 0) {
+ mirrorApp.pointAttributes = (PointAttributesRetained)value;
+ }
+
+ }
+
+ void setLive(boolean backgroundGroup, int refCount) {
+ // System.err.println("AppearceRetained.setLive()");
+ doSetLive(backgroundGroup, refCount);
+ markAsLive();
+ }
+
+ /**
+ * This method calls the setLive method of all appearance bundle
+ * objects.
+ */
+ void doSetLive(boolean backgroundGroup, int refCount) {
+ // System.err.println("AppearceRetained.doSetLive()");
+
+ if (material != null) {
+
+ material.setLive(backgroundGroup, refCount);
+ }
+
+ if (texture != null) {
+
+ texture.setLive(backgroundGroup, refCount);
+ }
+
+ if (texCoordGeneration != null) {
+
+ texCoordGeneration.setLive(backgroundGroup, refCount);
+ }
+
+ if (textureAttributes != null) {
+
+ textureAttributes.setLive(backgroundGroup, refCount);
+ }
+
+ if (texUnitState != null) {
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] != null)
+ texUnitState[i].setLive(backgroundGroup, refCount);
+ }
+ }
+
+
+ if (coloringAttributes != null) {
+ coloringAttributes.setLive(backgroundGroup, refCount);
+ }
+
+ if (transparencyAttributes != null) {
+ transparencyAttributes.setLive(backgroundGroup, refCount);
+ }
+
+ if (renderingAttributes != null) {
+ renderingAttributes.setLive(backgroundGroup, refCount);
+ }
+
+ if (polygonAttributes != null) {
+ polygonAttributes.setLive(backgroundGroup, refCount);
+ }
+
+ if (lineAttributes != null) {
+ lineAttributes.setLive(backgroundGroup, refCount);
+ }
+
+ if (pointAttributes != null) {
+ pointAttributes.setLive(backgroundGroup, refCount);
+ }
+
+
+ // Increment the reference count and initialize the appearance
+ // mirror object
+ super.doSetLive(backgroundGroup, refCount);
+ }
+
+ /**
+ * This method calls the clearLive method of all appearance bundle
+ * objects.
+ */
+ void clearLive(int refCount) {
+ super.clearLive(refCount);
+
+ if (texture != null) {
+ texture.clearLive(refCount);
+ }
+
+ if (texCoordGeneration != null) {
+ texCoordGeneration.clearLive(refCount);
+ }
+
+ if (textureAttributes != null) {
+ textureAttributes.clearLive(refCount);
+ }
+
+ if (texUnitState != null) {
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] != null)
+ texUnitState[i].clearLive(refCount);
+ }
+ }
+
+ if (coloringAttributes != null) {
+ coloringAttributes.clearLive(refCount);
+ }
+
+ if (transparencyAttributes != null) {
+ transparencyAttributes.clearLive(refCount);
+ }
+
+ if (renderingAttributes != null) {
+ renderingAttributes.clearLive(refCount);
+ }
+
+ if (polygonAttributes != null) {
+ polygonAttributes.clearLive(refCount);
+ }
+
+ if (lineAttributes != null) {
+ lineAttributes.clearLive(refCount);
+ }
+
+ if (pointAttributes != null) {
+ pointAttributes.clearLive(refCount);
+ }
+
+ if (material != null) {
+ material.clearLive(refCount);
+ }
+ }
+
+
+ boolean isStatic() {
+ boolean flag;
+
+ flag = (source.capabilityBitsEmpty() &&
+ ((texture == null) ||
+ texture.source.capabilityBitsEmpty()) &&
+ ((texCoordGeneration == null) ||
+ texCoordGeneration.source.capabilityBitsEmpty()) &&
+ ((textureAttributes == null) ||
+ textureAttributes.source.capabilityBitsEmpty()) &&
+ ((coloringAttributes == null) ||
+ coloringAttributes.source.capabilityBitsEmpty()) &&
+ ((transparencyAttributes == null) ||
+ transparencyAttributes.source.capabilityBitsEmpty()) &&
+ ((renderingAttributes == null) ||
+ renderingAttributes.source.capabilityBitsEmpty()) &&
+ ((polygonAttributes == null) ||
+ polygonAttributes.source.capabilityBitsEmpty()) &&
+ ((lineAttributes == null) ||
+ lineAttributes.source.capabilityBitsEmpty()) &&
+ ((pointAttributes == null) ||
+ pointAttributes.source.capabilityBitsEmpty()) &&
+ ((material == null) ||
+ material.source.capabilityBitsEmpty()));
+
+ if (!flag)
+ return flag;
+
+ if (texUnitState != null) {
+ for (int i = 0; i < texUnitState.length && flag; i++) {
+ if (texUnitState[i] != null) {
+ flag = flag && texUnitState[i].isStatic();
+ }
+ }
+ }
+
+ return flag;
+ }
+
+ // Issue 209 - enable this method (was previously commented out)
+ // Simply pass along to the NodeComponents
+ void compile(CompileState compState) {
+ setCompiled();
+
+ if (texture != null) {
+ texture.compile(compState);
+ }
+
+ if (texCoordGeneration != null) {
+ texCoordGeneration.compile(compState);
+ }
+
+ if (textureAttributes != null) {
+ textureAttributes.compile(compState);
+ }
+
+ if (texUnitState != null) {
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] != null)
+ texUnitState[i].compile(compState);
+ }
+ }
+
+ if (coloringAttributes != null) {
+ coloringAttributes.compile(compState);
+ }
+
+ if (transparencyAttributes != null) {
+ transparencyAttributes.compile(compState);
+ }
+
+ if (renderingAttributes != null) {
+ renderingAttributes.compile(compState);
+ }
+
+ if (polygonAttributes != null) {
+ polygonAttributes.compile(compState);
+ }
+
+ if (lineAttributes != null) {
+ lineAttributes.compile(compState);
+ }
+
+ if (pointAttributes != null) {
+ pointAttributes.compile(compState);
+ }
+
+ if (material != null) {
+ material.compile(compState);
+ }
+ }
+
+ /**
+ * Returns the hashcode for this object.
+ * hashcode should be constant for object but same for two objects
+ * if .equals() is true. For an appearance (where .equals() is going
+ * to use the values in the appearance), the only way to have a
+ * constant value is for all appearances to have the same hashcode, so
+ * we use the hashcode of the class obj.
+ *
+ * Since hashCode is only used by AppearanceMap (at present) we may be
+ * able to improve efficency by calcing a hashCode from the values.
+ */
+ public int hashCode() {
+ return getClass().hashCode();
+ }
+
+ public boolean equals(Object obj) {
+ return ((obj instanceof AppearanceRetained) &&
+ equals((AppearanceRetained) obj));
+ }
+
+ boolean equals(AppearanceRetained app) {
+ boolean flag;
+
+ flag = (app == this) ||
+ ((app != null) &&
+ (((material == app.material) ||
+ ((material != null) && material.equivalent(app.material))) &&
+ ((texture == app.texture) ||
+ ((texture != null) && texture.equals(app.texture))) &&
+ ((renderingAttributes == app.renderingAttributes) ||
+ ((renderingAttributes != null) &&
+ renderingAttributes.equivalent(
+ app.renderingAttributes))) &&
+ ((polygonAttributes == app.polygonAttributes) ||
+ ((polygonAttributes != null) &&
+ polygonAttributes.equivalent(app.polygonAttributes))) &&
+ ((texCoordGeneration == app.texCoordGeneration) ||
+ ((texCoordGeneration != null) &&
+ texCoordGeneration.equivalent(app.texCoordGeneration))) &&
+ ((textureAttributes == app.textureAttributes) ||
+ ((textureAttributes != null) &&
+ textureAttributes.equivalent(app.textureAttributes))) &&
+ ((coloringAttributes == app.coloringAttributes) ||
+ ((coloringAttributes != null) &&
+ coloringAttributes.equivalent(app.coloringAttributes))) &&
+ ((transparencyAttributes == app.transparencyAttributes) ||
+ ((transparencyAttributes != null) &&
+ transparencyAttributes.equivalent(
+ app.transparencyAttributes))) &&
+ ((lineAttributes == app.lineAttributes) ||
+ ((lineAttributes != null) &&
+ lineAttributes.equivalent(app.lineAttributes))) &&
+ ((pointAttributes == app.pointAttributes) ||
+ ((pointAttributes != null) &&
+ pointAttributes.equivalent(app.pointAttributes)))));
+
+ if (!flag)
+ return (flag);
+
+ if (texUnitState == app.texUnitState)
+ return (flag);
+
+ if (texUnitState == null || app.texUnitState == null ||
+ texUnitState.length != app.texUnitState.length)
+ return (false);
+
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] == app.texUnitState[i])
+ continue;
+
+ if (texUnitState[i] == null || app.texUnitState[i] == null ||
+ !texUnitState[i].equals(app.texUnitState[i]))
+ return (false);
+ }
+ return (true);
+ }
+
+
+
+
+ synchronized void addAMirrorUser(Shape3DRetained shape) {
+
+ super.addAMirrorUser(shape);
+ if (material != null)
+ material.addAMirrorUser(shape);
+
+ if (texture != null)
+ texture.addAMirrorUser(shape);
+ if (texCoordGeneration != null)
+ texCoordGeneration.addAMirrorUser(shape);
+ if (textureAttributes != null)
+ textureAttributes.addAMirrorUser(shape);
+
+ if (texUnitState != null) {
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] != null)
+ texUnitState[i].addAMirrorUser(shape);
+ }
+ }
+
+ if (coloringAttributes != null)
+ coloringAttributes.addAMirrorUser(shape);
+ if (transparencyAttributes != null)
+ transparencyAttributes.addAMirrorUser(shape);
+ if (renderingAttributes != null)
+ renderingAttributes.addAMirrorUser(shape);
+ if (polygonAttributes != null)
+ polygonAttributes.addAMirrorUser(shape);
+ if (lineAttributes != null)
+ lineAttributes.addAMirrorUser(shape);
+ if (pointAttributes != null)
+ pointAttributes.addAMirrorUser(shape);
+ }
+
+ synchronized void removeAMirrorUser(Shape3DRetained shape) {
+ super.removeAMirrorUser(shape);
+ if (material != null)
+ material.removeAMirrorUser(shape);
+ if (texture != null)
+ texture.removeAMirrorUser(shape);
+ if (texCoordGeneration != null)
+ texCoordGeneration.removeAMirrorUser(shape);
+ if (textureAttributes != null)
+ textureAttributes.removeAMirrorUser(shape);
+
+ if (texUnitState != null) {
+ for (int i = 0; i < texUnitState.length; i++) {
+ if (texUnitState[i] != null)
+ texUnitState[i].removeAMirrorUser(shape);
+ }
+ }
+
+ if (coloringAttributes != null)
+ coloringAttributes.removeAMirrorUser(shape);
+ if (transparencyAttributes != null)
+ transparencyAttributes.removeAMirrorUser(shape);
+ if (renderingAttributes != null)
+ renderingAttributes.removeAMirrorUser(shape);
+ if (polygonAttributes != null)
+ polygonAttributes.removeAMirrorUser(shape);
+ if (lineAttributes != null)
+ lineAttributes.removeAMirrorUser(shape);
+ if (pointAttributes != null)
+ pointAttributes.removeAMirrorUser(shape);
+ }
+
+ // 3rd argument used only when Rendering Attr comp changes
+ final void sendMessage(int attrMask, Object attr, boolean visible) {
+ ArrayList univList = new ArrayList();
+ ArrayList gaList = Shape3DRetained.getGeomAtomsList(mirror.users, univList);
+ // Send to rendering attribute structure, regardless of
+ // whether there are users or not (alternate appearance case ..)
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+ createMessage.type = J3dMessage.APPEARANCE_CHANGED;
+ createMessage.universe = null;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr;
+ createMessage.args[3] = new Integer(changedFrequent);
+
+ VirtualUniverse.mc.processMessage(createMessage);
+
+
+ // System.err.println("univList.size is " + univList.size());
+ for(int i=0; i The selection of this device driver is done through methods in the
+ * PhysicalEnvironment object - see PhysicalEnvironment class.
+ * The application would query how many audio devices are available. For
+ * each device, the user can get the AudioDevice object that describes it
+ * and query its characteristics. Once a decision is made about which of
+ * the available audio devices to use for a PhysicalEnvironment, the
+ * particular device is set into this PhysicalEnvironment's fields. Each
+ * PhysicalEnvironment object may use only a single audio device.
+ *
+ *
+ * Each audio device driver must be initialized.
+ * The chosen device driver should be initialized before any Java3D
+ * Sound methods are executed because the implementation of the Sound
+ * methods, in general, are potentially device driver dependent.
+ *
+ * These methods set and retrieve the audio playback type used to output
+ * the analog audio from rendering Java3D Sound nodes.
+ * The audio playback type specifies that playback will be through:
+ * stereo headphones, a monaural speaker, or a pair of speakers.
+ * For the stereo speakers, it is assumed that the two output speakers are
+ * equally distant from the listener, both at same angle from the head
+ * axis (thus oriented symmetrically about the listener), and at the same
+ * elevation.
+ * The type of playback chosen affects the sound image generated.
+ * Cross-talk cancellation is applied to the audio image if playback over
+ * stereo speakers is selected.
+ *
+ * These methods set and retrieve the distance in meters from the center
+ * ear (the midpoint between the left and right ears) and one of the
+ * speakers in the listener's environment. For monaural speaker playback,
+ * a typical distance from the listener to the speaker in a workstation
+ * cabinet is 0.76 meters. For stereo speakers placed at the sides of the
+ * display, this might be 0.82 meters.
+ *
+ * These methods set and retrieve the angle in radians between the vectors
+ * from the center ear to each of the speaker transducers and the vectors
+ * from the center ear parallel to the head coordinate's Z axis. Speakers
+ * placed at the sides of the computer display typically range between
+ * 0.28 to 0.35 radians (between 10 and 20 degrees).
+ *
+ * While the sound image created for final output to the playback system
+ * is either only mono or stereo (for this version of Java3D) most device
+ * driver implementations will mix the left and right image signals
+ * generated for each rendered sound source before outputting the final
+ * playback image. Each sound source will use N input channels of this
+ * internal mixer. Each implemented Java3D audio device driver will have
+ * its own limitations and driver-specific characteristics. These include
+ * channel availability and usage (during rendering). Methods for
+ * querying these device-driver specific characteristics are provided.
A browser or applications developer must instantiate whatever system-
+ * specific audio devices that he or she needs and that exist on the system.
+ * This device information typically exists in a site configuration file.
+ * The browser or application will instantiate the physical environment as
+ * requested by the end-user.
+ *
+ *
+ * Set up and clear the sound as a sample on the device.
+ *
+ *
+ * Muted sound take channels up on the systems mixer (because they're
+ * rendered as samples playing with gain zero.
+ *
+ *
+ * Scale factor applied to all sound's amplitude active within this region.
+ * This factor attenuates both direct and reflected/reverbered amplitudes.
+ * Valid values are >= 0.0
+ *
+ *
+ * Rolloff scale factor is used to model atmospheric changes from normal
+ * speed of sound. The base value, 0.344 meters/millisecond is used
+ * to approximate the speed of sound through air at room temperature,
+ * is multipled by this scale factor whenever the speed of sound is
+ * applied during spatialization calculations.
+ * Valid values are >= 0.0. Values > 1.0 increase the speed of sound,
+ * while values < 1.0 decrease its speed. A value of zero makes sound
+ * silent (but it continues to play).
+ *
+ *
+ * Auralization is the environmental modeling of sound iteratively
+ * reflecting off the surfaces of the bounded region the listener is in.
+ * Auralization components include
+ * early, distinct, low-order reflections and later, dense,
+ * higher-order reflections referred to as reverberation.
+ * These reflections are attenuated relative to the direct, unreflected
+ * sound. The difference in gain between direct and reflected sound
+ * gives the listener a sense of the surface material and
+ * the relative distance of the sound.
+ * The delay between the start of the direct sound and start of
+ * reverberation (as detected by the listener),
+ * as well as the length of time reverberation is audible as it
+ * exponentially decays, give the listener a sense of the size of the
+ * listening space.
+ *
+ *Reflection Coefficient
+ * Gain attenuation of the initial
+ * reflections across all frequencies.
(Early) Reflection Delay
+ * The time it takes for the first
+ * low-order reflected sound to reach the listener.
Reverb Coefficient
+ * Gain attenuation of the late reflections
+ * (referred to as 'reverb') across all frequencies.
Reverb Delay
+ * The time it takes for reverbered sound
+ * to reach the listener.
Decay Time
+ * Describes the reverb decay curve by defining the
+ * length of time reverb takes to decay to effective zero.
+ *
Decay Filter
+ * High-frequencies of the late reverberation
+ * can be attenuated at a different rate.
Density
+ * Modal density (spectral coloration) of
+ * reverberation.
Diffusion
+ * Echo dispersement of reverberation.
Reverb Bounds
+ * Approximates the volume of the listening space.
+ * If specified, it defines the reverberation delay.
Reverb Order
+ * Optionally limits the amount of times during
+ * reverb calculation that a sound is recursively reflected off the
+ * bounding region.
+ * The reflection coefficient is an amplitude scale factor used to
+ * approximate the average reflective or absorptive characteristics
+ * for early reflections
+ * of the composite surfaces in the region the listener is in.
+ * This scale factor is applied to the sound's amplitude regardless of the
+ * sound's position.
+ * The range of valid values is 0.0 to 1.0.
+ * A value of 1.0 denotes that reflections are unattenuated -
+ * the amplitude of reflected sound waves are not decreased.
+ * A value of 0.0 represents full absorption of reflections
+ * by the surfaces in the listening space (no reflections occur
+ * thus reverberation is disabled).
+ *
+ *
+ * The early reflection delay time (in milliseconds) can be explicitly
+ * set. Well-defined values are floats > 0.0.
+ * A value of 0.0 results in reverberation being added as soon as
+ * possible after the sound begins.
+ *
+ *
+ * The reverb coefficient is an amplitude scale factor used to
+ * approximate the average reflective or absorptive characteristics
+ * of late reflections.
+ * A value of 0.0 represents full absorption of reflections
+ * by the surfaces in the listening space (no reflections occur
+ * thus reverberation is disabled).
+ *
+ *
+ * The reverb delay time (in milliseconds) is set either explicitly,
+ * or implicitly by supplying a reverb bounds volume (from which the
+ * delay time can be calculated). Well-defined values are floats > 0.0.
+ * A value of 0.0 results in reverberation being added as soon as
+ * possible after the sound begins. Reverb delay, as calculated from non-
+ * null reverb bounds, takes precedence over explicitly set delay time.
+ *
+ *
+ * The reverb bounding region defines the overall size of space
+ * that reverberation is calculated for.
+ * This optional bounds does not have to be the same as the application
+ * region of the Soundscape node referencing this AuralAttributes object.
+ * If this bounding region is specified then reverb decay and delay are
+ * internally calculated from this bounds.
+ *
+ *
+ * The reverb order is a hint that can be used during reverberation
+ * to limit the number of late reflections required in calculation of
+ * reverb decay.
+ * All positive values can be interpreted during reverb rendering
+ * as the maximum order of reflections to be calculated.
+ * A non-positive value signifies that no limit is placed on the order of
+ * reflections calculated during reverberation rendering.
+ * In the case where reverb order is not limited, reverb decay is defined
+ * strictly by the Reverberation Decay Time parameter.
+ *
+ *
+ * The reverberation decay time explicitly defines the length of time in
+ * milliseconds it takes for the amplitude of late reflections to
+ * exponentally decrease to effective zero.
+ * In the case where reverb delay is set non-positive
+ * the renderer will perform the shortest reverberation decay
+ * possible.
+ * If ReverbOrder is set, this parameter is clamped by the reverb
+ * time calculated as time = reverb Delay * reverb Order.
+ * If ReverbOrder is 0, the decay time parameter is not clamped.
+ *
+ *
+ * The reverberation decay filter defines how frequencies above a given
+ * value are attenuated by the listening space. This allows for modelling
+ * materials on surfaces that absorb high frequencies at a faster rate
+ * than low frequencies.
+ *
+ *
+ * The reverberation diffusion explicitly defines echo dispersement
+ * (sometimes refered to as echo density). The value for diffusion
+ * is proportional to the number of echos per second heard in late
+ * reverberation, especially noticable at the tail of the reverberation
+ * decay. The greater the diffusion the more 'natural' the reverberation
+ * decay sounds. Reducing diffusion makes the decay sound hollow as
+ * produced in a small highly reflecive space (such as a bathroom).
+ *
+ *
+ * The reverberation density explicitly defines modal reverb density
+ * The value for this modal density is proportional to the number of
+ * resonances heard in late reverberation perceived as spectral
+ * coloration. The greater the density, the smoother, less grainy the
+ * later reverberation decay.
+ *
+ *
+ * This parameter specifies a (distance, filter) attenuation pairs array.
+ * If this is not set, no distance filtering is performed (equivalent to
+ * using a distance filter of Sound.NO_FILTER for all distances). Currently,
+ * this filter is a low-pass cutoff frequency. This array of pairs defines
+ * a piece-wise linear slope for range of values. This attenuation array is
+ * similar to the PointSound node's distanceAttenuation pair array, except
+ * paired with distances in this list are frequency values. Using these
+ * pairs, distance-based low-pass frequency filtering can be applied during
+ * sound rendering. Distances, specified in the local coordinate system in
+ * meters, must be > 0. Frequencies (in Hz) must be > 0.
+ *
+ *
+ * Doppler effect can be used to create a greater sense of movement of
+ * sound sources, and can help reduce front-back localization errors.
+ * The frequency of sound waves emanating from the source are raised or
+ * lowered based on the speed of the source in relation to the listener,
+ * and several AuralAttribute parameters.
+ *
+ */
+public class AuralAttributes extends NodeComponent {
+
+ /**
+ *
+ * Constants
+ *
+ * These flags, when enabled using the setCapability method, allow an
+ * application to invoke methods that read or write its parameters.
+ *
+ */
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's attribute gain scale factor information.
+ */
+ public static final int
+ ALLOW_ATTRIBUTE_GAIN_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_ATTRIBUTE_GAIN_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's attribute gain scale factor information.
+ */
+ public static final int
+ ALLOW_ATTRIBUTE_GAIN_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_ATTRIBUTE_GAIN_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's atmospheric rolloff.
+ */
+ public static final int
+ ALLOW_ROLLOFF_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_ROLLOFF_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's atmospheric rolloff.
+ */
+ public static final int
+ ALLOW_ROLLOFF_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_ROLLOFF_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reflection coefficient.
+ */
+ public static final int
+ ALLOW_REFLECTION_COEFFICIENT_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REFLECTION_COEFFICIENT_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reflection coefficient.
+ */
+ public static final int
+ ALLOW_REFLECTION_COEFFICIENT_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REFLECTION_COEFFICIENT_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reflection delay information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_REFLECTION_DELAY_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REFLECTION_DELAY_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reflection delay information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_REFLECTION_DELAY_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REFLECTION_DELAY_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reverb coefficient.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_REVERB_COEFFICIENT_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REVERB_COEFFICIENT_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reverb coefficient.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_REVERB_COEFFICIENT_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REVERB_COEFFICIENT_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reverberation delay information.
+ */
+ public static final int
+ ALLOW_REVERB_DELAY_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REVERB_DELAY_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reverberation delay information.
+ */
+ public static final int
+ ALLOW_REVERB_DELAY_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REVERB_DELAY_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reverb order (feedback loop) information.
+ */
+ public static final int
+ ALLOW_REVERB_ORDER_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REVERB_ORDER_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reverb order (feedback loop) information.
+ */
+ public static final int
+ ALLOW_REVERB_ORDER_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_REVERB_ORDER_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reverb decay time information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DECAY_TIME_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DECAY_TIME_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reverb decay time information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DECAY_TIME_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DECAY_TIME_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reverb decay filter information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DECAY_FILTER_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DECAY_FILTER_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reverb decay filter information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DECAY_FILTER_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DECAY_FILTER_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reverb diffusion information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DIFFUSION_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DIFFUSION_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reverb diffusion information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DIFFUSION_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DIFFUSION_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's reverb density information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DENSITY_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DENSITY_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's reverb density information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_DENSITY_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DENSITY_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's frequency cutoff information.
+ */
+ public static final int
+ ALLOW_DISTANCE_FILTER_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DISTANCE_FILTER_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's frequency cutoff information.
+ */
+ public static final int
+ ALLOW_DISTANCE_FILTER_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_DISTANCE_FILTER_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's frequency scale factor information.
+ */
+ public static final int
+ ALLOW_FREQUENCY_SCALE_FACTOR_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_FREQUENCY_SCALE_FACTOR_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's frequency scale factor information.
+ */
+ public static final int
+ ALLOW_FREQUENCY_SCALE_FACTOR_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_FREQUENCY_SCALE_FACTOR_WRITE;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the reading of it's velocity scale factor information.
+ */
+ public static final int
+ ALLOW_VELOCITY_SCALE_FACTOR_READ = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_VELOCITY_SCALE_FACTOR_READ;
+
+ /**
+ * For AuralAttributes component objects, specifies that this object
+ * allows the writing of it's velocity scale factor information.
+ */
+ public static final int
+ ALLOW_VELOCITY_SCALE_FACTOR_WRITE = CapabilityBits.AURAL_ATTRIBUTES_ALLOW_VELOCITY_SCALE_FACTOR_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_ATTRIBUTE_GAIN_READ,
+ ALLOW_DECAY_FILTER_READ,
+ ALLOW_DECAY_TIME_READ,
+ ALLOW_DENSITY_READ,
+ ALLOW_DIFFUSION_READ,
+ ALLOW_DISTANCE_FILTER_READ,
+ ALLOW_FREQUENCY_SCALE_FACTOR_READ,
+ ALLOW_REFLECTION_COEFFICIENT_READ,
+ ALLOW_REFLECTION_DELAY_READ,
+ ALLOW_REVERB_COEFFICIENT_READ,
+ ALLOW_REVERB_DELAY_READ,
+ ALLOW_REVERB_ORDER_READ,
+ ALLOW_ROLLOFF_READ,
+ ALLOW_VELOCITY_SCALE_FACTOR_READ
+ };
+
+ /** *****************
+ *
+ * Constructors
+ *
+ * ******************/
+ /**
+ * Constructs and initializes a new AuralAttributes object using default
+ * parameters. The following default values are used:
+ *
+ * attribute gain: 1.0
+ */
+ public AuralAttributes() {
+ // Just use default values
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs and initializes a new AuralAttributes object using specified
+ * parameters including an array of Point2f for the distanceFilter.
+ * @param gain amplitude scale factor
+ * @param rolloff atmospheric (changing speed of sound) scale factor
+ * @param reflectionCoefficient reflective/absorptive factor applied to reflections
+ * @param reverbDelay delay time before start of reverberation
+ * @param reverbOrder limit to number of reflections added to reverb signal
+ * @param distanceFilter frequency cutoff
+ * @param frequencyScaleFactor applied to change of pitch
+ * @param velocityScaleFactor applied to velocity of sound in relation to listener
+ */
+ public AuralAttributes(float gain,
+ float rolloff,
+ float reflectionCoefficient,
+ float reverbDelay,
+ int reverbOrder,
+ Point2f[] distanceFilter,
+ float frequencyScaleFactor,
+ float velocityScaleFactor) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((AuralAttributesRetained)this.retained).setAttributeGain(gain);
+ ((AuralAttributesRetained)this.retained).setRolloff(rolloff);
+ ((AuralAttributesRetained)this.retained).setReflectionCoefficient(
+ reflectionCoefficient);
+ ((AuralAttributesRetained)this.retained).setReverbDelay(reverbDelay);
+ ((AuralAttributesRetained)this.retained).setReverbOrder(reverbOrder);
+ ((AuralAttributesRetained)this.retained).setDistanceFilter(
+ distanceFilter);
+ ((AuralAttributesRetained)this.retained).setFrequencyScaleFactor(
+ frequencyScaleFactor);
+ ((AuralAttributesRetained)this.retained).setVelocityScaleFactor(
+ velocityScaleFactor);
+ }
+ /**
+ * Constructs and initializes a new AuralAttributes object using specified
+ * parameters with separate float arrays for components of distanceFilter.
+ * @param gain amplitude scale factor
+ * @param rolloff atmospheric (changing speed of sound) scale factor
+ * @param reflectionCoefficient reflection/absorption factor applied to reflections
+ * @param reverbDelay delay time before start of reverberation
+ * @param reverbOrder limit to number of reflections added to reverb signal
+ * @param distance filter frequency cutoff distances
+ * @param frequencyCutoff distance filter frequency cutoff
+ * @param frequencyScaleFactor applied to velocity/wave-length
+ * @param velocityScaleFactor applied to velocity of sound in relation to listener
+ */
+ public AuralAttributes(float gain,
+ float rolloff,
+ float reflectionCoefficient,
+ float reverbDelay,
+ int reverbOrder,
+ float[] distance,
+ float[] frequencyCutoff,
+ float frequencyScaleFactor,
+ float velocityScaleFactor) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((AuralAttributesRetained)this.retained).setAttributeGain(gain);
+ ((AuralAttributesRetained)this.retained).setRolloff(rolloff);
+ ((AuralAttributesRetained)this.retained).setReflectionCoefficient(
+ reflectionCoefficient);
+ ((AuralAttributesRetained)this.retained).setReverbDelay(reverbDelay);
+ ((AuralAttributesRetained)this.retained).setReverbOrder(reverbOrder);
+ ((AuralAttributesRetained)this.retained).setDistanceFilter(distance,
+ frequencyCutoff);
+ ((AuralAttributesRetained)this.retained).setFrequencyScaleFactor(
+ frequencyScaleFactor);
+ ((AuralAttributesRetained)this.retained).setVelocityScaleFactor(
+ velocityScaleFactor);
+ }
+
+ /**
+ * Constructs and initializes a new AuralAttributes object using specified
+ * parameters with separate float arrays for components of distanceFilter
+ * and full reverb parameters.
+ * @param gain amplitude scale factor
+ * @param rolloff atmospheric (changing speed of sound) scale factor
+ * @param reflectionCoefficient factor applied to early reflections
+ * @param reflectionDelay delay time before start of early reflections
+ * @param reverbCoefficient factor applied to late reflections
+ * @param reverbDelay delay time before start of late reverberation
+ * @param decayTime time (in milliseconds) reverb takes to decay to -60bD
+ * @param decayFilter reverb decay filter frequency cutoff
+ * @param diffusion percentage of echo dispersement between min and max
+ * @param density percentage of modal density between min and max
+ * @param distance filter frequency cutoff distances
+ * @param frequencyCutoff distance filter frequency cutoff
+ * @param frequencyScaleFactor applied to velocity/wave-length
+ * @param velocityScaleFactor applied to velocity of sound in relation to listener
+ * @since Java 3D 1.3
+ */
+ public AuralAttributes(float gain,
+ float rolloff,
+ float reflectionCoefficient,
+ float reflectionDelay,
+ float reverbCoefficient,
+ float reverbDelay,
+ float decayTime,
+ float decayFilter,
+ float diffusion,
+ float density,
+ float[] distance,
+ float[] frequencyCutoff,
+ float frequencyScaleFactor,
+ float velocityScaleFactor) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((AuralAttributesRetained)this.retained).setAttributeGain(gain);
+ ((AuralAttributesRetained)this.retained).setRolloff(rolloff);
+ ((AuralAttributesRetained)this.retained).setReflectionCoefficient(
+ reflectionCoefficient);
+ ((AuralAttributesRetained)this.retained).setReflectionDelay(
+ reflectionDelay);
+ ((AuralAttributesRetained)this.retained).setReverbCoefficient(
+ reverbCoefficient);
+ ((AuralAttributesRetained)this.retained).setReverbDelay(
+ reverbDelay);
+ ((AuralAttributesRetained)this.retained).setDecayTime(decayTime);
+ ((AuralAttributesRetained)this.retained).setDecayFilter(decayFilter);
+ ((AuralAttributesRetained)this.retained).setDiffusion(diffusion);
+ ((AuralAttributesRetained)this.retained).setDensity(density);
+ ((AuralAttributesRetained)this.retained).setDistanceFilter(distance,
+ frequencyCutoff);
+ ((AuralAttributesRetained)this.retained).setFrequencyScaleFactor(
+ frequencyScaleFactor);
+ ((AuralAttributesRetained)this.retained).setVelocityScaleFactor(
+ velocityScaleFactor);
+ }
+
+ /**
+ * Creates the retained mode AuralAttributesRetained object that this
+ * component object will point to.
+ */
+ void createRetained() {
+ this.retained = new AuralAttributesRetained();
+ this.retained.setSource(this);
+ }
+
+ /** ****************************************
+ *
+ * Attribute Gain
+ *
+ * ****************************************/
+ /**
+ * Set Attribute Gain (amplitude) scale factor.
+ * @param gain scale factor applied to amplitude of direct and reflected sound
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAttributeGain(float gain) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ATTRIBUTE_GAIN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes0"));
+ ((AuralAttributesRetained)this.retained).setAttributeGain(gain);
+ }
+
+ /**
+ * Retrieve Attribute Gain (amplitude).
+ * @return gain amplitude scale factor
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getAttributeGain() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ATTRIBUTE_GAIN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes1"));
+ return ((AuralAttributesRetained)this.retained).getAttributeGain();
+ }
+
+ /**
+ * Set Attribute Gain Rolloff.
+ * @param rolloff atmospheric gain scale factor (changing speed of sound)
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setRolloff(float rolloff) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ROLLOFF_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes2"));
+ ((AuralAttributesRetained)this.retained).setRolloff(rolloff);
+ }
+
+ /**
+ * Retrieve Attribute Gain Rolloff.
+ * @return rolloff atmospheric gain scale factor (changing speed of sound)
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getRolloff() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ROLLOFF_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes3"));
+ return ((AuralAttributesRetained)this.retained).getRolloff();
+ }
+
+ /**
+ * Set Reflective Coefficient.
+ * Scales the amplitude of the early reflections of reverberated sounds
+ * @param coefficient reflection/absorption factor applied to reflections
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setReflectionCoefficient(float coefficient) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REFLECTION_COEFFICIENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes4"));
+ ((AuralAttributesRetained)this.retained).setReflectionCoefficient(coefficient);
+ }
+
+ /**
+ * Retrieve Reflective Coefficient.
+ * @return reflection coeff reflection/absorption factor
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getReflectionCoefficient() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REFLECTION_COEFFICIENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes21"));
+ return ((AuralAttributesRetained)this.retained).getReflectionCoefficient();
+ }
+
+ /*********************
+ *
+ * Early Reflection Delay
+ *
+ ********************/
+ /**
+ * Set early Refection Delay Time.
+ * In this form, the parameter specifies the time between the start of the
+ * direct, unreflected sound and the start of first order early reflections.
+ * In this method, this time is explicitly given in milliseconds.
+ * @param reflectionDelay delay time before start of reverberation
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public void setReflectionDelay(float reflectionDelay) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REFLECTION_DELAY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes22"));
+ ((AuralAttributesRetained)this.retained).setReflectionDelay(reflectionDelay);
+ }
+
+ /**
+ * Retrieve Reflection Delay Time.
+ * @return reflection delay time
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public float getReflectionDelay() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REFLECTION_DELAY_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes23"));
+ return ((AuralAttributesRetained)this.retained).getReflectionDelay();
+ }
+
+ /** ******************
+ *
+ * Reverb Coefficient
+ *
+ ********************/
+ /**
+ * Set Reverb Coefficient.
+ * Scale the amplitude of the late reflections including the decaying tail
+ * of reverberated sound.
+ * @param coefficient reflective/absorptive factor applied to late reflections
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public void setReverbCoefficient(float coefficient) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_COEFFICIENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes24"));
+ ((AuralAttributesRetained)this.retained).setReverbCoefficient(coefficient);
+ }
+
+ /**
+ * Retrieve Reverb Coefficient.
+ * @return late reflection coeff. reflection/absorption factor
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public float getReverbCoefficient() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_COEFFICIENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes25"));
+ return ((AuralAttributesRetained)this.retained).getReverbCoefficient();
+ }
+
+ /*********************
+ *
+ * Reverberation Delay
+ *
+ ********************/
+ /**
+ * Set Reverberation Delay Time.
+ * In this form, the parameter specifies the time between the start of the
+ * direct, unreflected sound and the start of reverberation. In this
+ * method, this time is explicitly given in milliseconds.
+ * @param reverbDelay delay time before start of reverberation
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setReverbDelay(float reverbDelay) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_DELAY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes5"));
+ ((AuralAttributesRetained)this.retained).setReverbDelay(reverbDelay);
+ }
+
+ /**
+ * Retrieve Reverberation Delay Time.
+ * @return reverb delay time
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getReverbDelay() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_DELAY_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes7"));
+ return ((AuralAttributesRetained)this.retained).getReverbDelay();
+ }
+
+ /** ******************
+ *
+ * Decay Time
+ *
+ ********************/
+ /**
+ * Set Decay Time
+ * Length of time from the start of late reflections reverberation volume
+ * takes to decay to effective zero (-60 dB of initial signal amplitude).
+ * @param decayTime of late reflections (reverb) in milliseconds
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public void setDecayTime(float decayTime) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DECAY_TIME_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes28"));
+ ((AuralAttributesRetained)this.retained).setDecayTime(decayTime);
+ }
+
+ /**
+ * Retrieve Decay Time.
+ * @return reverb decay time
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public float getDecayTime() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DECAY_TIME_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes29"));
+ return ((AuralAttributesRetained)this.retained).getDecayTime();
+ }
+
+ /** ******************
+ *
+ * Decay Filter
+ *
+ ********************/
+ /**
+ * Set Decay Filter
+ * In this form, reverberation decay filtering is defined as a low-pass
+ * filter, starting at the given reference frequency. This allows for
+ * higher frequencies to be attenuated at a different (typically faster)
+ * rate than lower frequencies.
+ * @param frequencyCutoff of reverberation decay low-pass filter
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public void setDecayFilter(float frequencyCutoff) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DECAY_FILTER_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes30"));
+ ((AuralAttributesRetained)this.retained).setDecayFilter(frequencyCutoff);
+ }
+
+ /**
+ * Retrieve Decay Filter.
+ * @return reverb decay filter cutoff frequency
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public float getDecayFilter() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DECAY_FILTER_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes31"));
+ return ((AuralAttributesRetained)this.retained).getDecayFilter();
+ }
+
+ /** ******************
+ *
+ * Diffusion
+ *
+ ********************/
+ /**
+ * Set Diffusion.
+ * Sets the echo dispersement of reverberation to an amount between
+ * the minimum (0.0) to the maximum (1.0) available. Changing this
+ * increases/decreases the 'smoothness' of reverb decay.
+ * @param ratio reverberation echo dispersement factor
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public void setDiffusion(float ratio) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DIFFUSION_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes32"));
+ ((AuralAttributesRetained)this.retained).setDiffusion(ratio);
+ }
+
+ /**
+ * Retrieve Diffusion.
+ * @return reverb diffusion ratio
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public float getDiffusion() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DIFFUSION_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes33"));
+ return ((AuralAttributesRetained)this.retained).getDiffusion();
+ }
+
+ /** ******************
+ *
+ * Density
+ *
+ ********************/
+ /**
+ * Set Density.
+ * Sets the density of reverberation to an amount between
+ * the minimum (0.0) to the maximum (1.0) available. Changing this
+ * effects the spectral coloration (timbre) of late reflections.
+ * @param ratio reverberation modal density factor
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public void setDensity(float ratio) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DENSITY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes34"));
+ ((AuralAttributesRetained)this.retained).setDensity(ratio);
+ }
+
+ /**
+ * Retrieve Density.
+ * @return reverb density
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.3
+ */
+ public float getDensity() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DENSITY_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes35"));
+ return ((AuralAttributesRetained)this.retained).getDensity();
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ *
+ * rolloff: 1.0
+ * reflection coeff: 0.0
+ * reflection delay: 20.0
+ * reverb coeff: 1.0
+ * reverb delay: 40.0
+ * decay time: 1000.0
+ * decay filter: 5000.0<>
+ * diffusion: 1.0
+ * density: 1.0
+ * reverb bounds: null
+ * reverb order: 0
+ * distance filtering: null (no filtering performed)
+ * frequency scale factor: 1.0
+ * velocity scale factor: 0.0
+ * setReverbBounds(Bounds)
+ */
+ public void setReverbDelay(Bounds reverbVolume) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_DELAY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes5"));
+ ((AuralAttributesRetained)this.retained).setReverbBounds(reverbVolume);
+ }
+
+ /**
+ * Set Reverberation Bounds volume.
+ * In this form, the reverberation bounds volume parameter is used to
+ * calculate the reverberation Delay and Decay times. Specification
+ * of a non-null bounding volume causes the explicit values given for
+ * Reverb Delay and Decay to be overridden by the implicit values
+ * calculated from these bounds.
+ * ALLOW_REVERB_DELAY_WRITE flag used setting capability of this method.
+ * @param reverbVolume the bounding region
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.2
+ */
+ public void setReverbBounds(Bounds reverbVolume) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_DELAY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes26"));
+ ((AuralAttributesRetained)this.retained).setReverbBounds(reverbVolume);
+ }
+
+ /**
+ * Retrieve Reverberation Delay Bounds volume.
+ * @return reverb bounds volume that defines the Reverberation space and
+ * indirectly the delay/decay
+ * ALLOW_REVERB_DELAY_READ flag used setting capability of this method.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.2
+ */
+ public Bounds getReverbBounds() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_DELAY_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes27"));
+ return ((AuralAttributesRetained)this.retained).getReverbBounds();
+ }
+
+ /** *******************
+ *
+ * Reverberation Order
+ *
+ ********************/
+ /**
+ * Set Reverberation Order
+ * This parameter limits the number of times reflections are added
+ * to the reverberation being rendered.
+ * A non-positive value specifies an unbounded number of reflections.
+ * @param reverbOrder limit to the number of times reflections added to reverb signal
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setReverbOrder(int reverbOrder) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REVERB_ORDER_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes8"));
+ ((AuralAttributesRetained)this.retained).setReverbOrder(reverbOrder);
+ }
+
+ /**
+ * Retrieve Reverberation Order
+ * @return reverb order
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getReverbOrder() {
+ if (!this.getCapability(ALLOW_REVERB_ORDER_READ))
+ if (isLiveOrCompiled())
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes9"));
+ return ((AuralAttributesRetained)this.retained).getReverbOrder();
+ }
+
+ /**
+ * Set Distance Filter using a single array containing distances and
+ * frequency cutoff as pairs of values as a single array of Point2f.
+ * @param attenuation array of pairs of distance and frequency cutoff
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDistanceFilter(Point2f[] attenuation) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DISTANCE_FILTER_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes10"));
+ ((AuralAttributesRetained)this.retained).setDistanceFilter(attenuation);
+ }
+
+ /**
+ * Set Distance Filter using separate arrays for distances and frequency
+ * cutoff. The distance and frequencyCutoff arrays should be of the same
+ * length. If the frequencyCutoff array length is greater than the distance
+ * array length, the frequencyCutoff array elements beyond the length of
+ * the distance array are ignored. If the frequencyCutoff array is shorter
+ * than the distance array, the last frequencyCutoff array value is repeated
+ * to fill an array of length equal to distance array.
+ * @param distance array of float distance with corresponding cutoff values
+ * @param frequencyCutoff array of frequency cutoff values in Hertz
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDistanceFilter(float[] distance,
+ float[] frequencyCutoff) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DISTANCE_FILTER_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes10"));
+ ((AuralAttributesRetained)this.retained).setDistanceFilter(
+ distance, frequencyCutoff );
+ }
+
+ /**
+ * Retrieve Distance Filter array length.
+ * @return attenuation array length
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getDistanceFilterLength() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DISTANCE_FILTER_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes12"));
+ return (((AuralAttributesRetained)this.retained).getDistanceFilterLength());
+ }
+ /**
+ * Retrieve Distance Filter as a single array containing distances
+ * and frequency cutoff. The distance filter is copied into
+ * the specified array.
+ * The array must be large enough to hold all of the points.
+ * The individual array elements must be allocated by the caller.
+ * @param attenuation array of pairs of distance and frequency cutoff values
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDistanceFilter(Point2f[] attenuation) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DISTANCE_FILTER_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes12"));
+ ((AuralAttributesRetained)this.retained).getDistanceFilter(attenuation);
+ }
+
+ /**
+ * Retrieve Distance Filter in separate distance and frequency cutoff arrays.
+ * The arrays must be large enough to hold all of the distance
+ * and frequency cutoff values.
+ * @param distance array
+ * @param frequencyCutoff cutoff array
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDistanceFilter(float[] distance,
+ float[] frequencyCutoff) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_DISTANCE_FILTER_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes12"));
+ ((AuralAttributesRetained)this.retained).getDistanceFilter(
+ distance, frequencyCutoff);
+ }
+
+ /**
+ * This parameter specifies a scale factor applied to the frequency
+ * of sound during rendering playback. If the Doppler effect is
+ * disabled, this scale factor can be used to increase or
+ * decrease the original pitch of the sound. During rendering,
+ * this scale factor expands or contracts the usual frequency shift
+ * applied to the sound source due to Doppler calculations.
+ * Valid values are >= 0.0.
+ * A value of zero causes playing sounds to pause.
+ * @param frequencyScaleFactor factor applied to change of frequency
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setFrequencyScaleFactor(float frequencyScaleFactor) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_FREQUENCY_SCALE_FACTOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes15"));
+ ((AuralAttributesRetained)this.retained).setFrequencyScaleFactor(
+ frequencyScaleFactor);
+ }
+
+ /**
+ * Retrieve Frequency Scale Factor.
+ * @return scaleFactor factor applied to change of frequency
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getFrequencyScaleFactor() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_FREQUENCY_SCALE_FACTOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes17"));
+ return ((AuralAttributesRetained)this.retained).getFrequencyScaleFactor();
+ }
+
+ /** ******************************
+ *
+ * Velocity Scale Factor
+ *
+ *********************************/
+ /**
+ * Set Velocity scale factor applied during Doppler Effect calculation.
+ * This parameter specifies a scale factor applied to the velocity of
+ * the sound relative to the listener's position and movement in relation
+ * to the sound's position and movement. This scale factor is multipled
+ * by the calculated velocity portion of the Doppler effect equation used
+ * during sound rendering.
+ * A value of zero disables Doppler calculations.
+ * @param velocityScaleFactor applied to velocity of sound in relation
+ * to listener
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setVelocityScaleFactor(float velocityScaleFactor) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_VELOCITY_SCALE_FACTOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes19"));
+ ((AuralAttributesRetained)this.retained).setVelocityScaleFactor(
+ velocityScaleFactor);
+ }
+
+ /**
+ * Retrieve Velocity Scale Factor used to calculate Doppler Effect.
+ * @return scale factor applied to Doppler velocity of sound
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getVelocityScaleFactor() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_VELOCITY_SCALE_FACTOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("AuralAttributes20"));
+ return ((AuralAttributesRetained)this.retained).getVelocityScaleFactor();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ AuralAttributes a = new AuralAttributes();
+ a.duplicateNodeComponent(this, this.forceDuplicate);
+ return a;
+ }
+
+
+ /**
+ * Copies all AuralAttributes information from originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent,
+ forceDuplicate);
+
+ AuralAttributesRetained aural = (AuralAttributesRetained) originalNodeComponent.retained;
+ AuralAttributesRetained rt = (AuralAttributesRetained) retained;
+
+ rt.setAttributeGain(aural.getAttributeGain());
+ rt.setRolloff(aural.getRolloff());
+ rt.setReflectionCoefficient(aural.getReflectionCoefficient());
+ rt.setReverbDelay(aural.getReverbDelay());
+ rt.setReverbOrder(aural.getReverbOrder());
+ rt.setReverbBounds(aural.getReverbBounds());
+ rt.setFrequencyScaleFactor(aural.getFrequencyScaleFactor());
+ rt.setVelocityScaleFactor(aural.getVelocityScaleFactor());
+ int len = aural.getDistanceFilterLength();
+ float distance[] = new float[len];
+ float frequencyCutoff[] = new float[len];
+ aural.getDistanceFilter(distance, frequencyCutoff);
+ rt.setDistanceFilter(distance, frequencyCutoff);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/AuralAttributesRetained.java b/j3d-core/src/classes/share/javax/media/j3d/AuralAttributesRetained.java
new file mode 100644
index 0000000..5d038c0
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/AuralAttributesRetained.java
@@ -0,0 +1,673 @@
+/*
+ * $RCSfile: AuralAttributesRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Hashtable;
+import javax.vecmath.Point2f;
+
+/**
+ * The AuralAttributesRetained object defines all rendering state that can
+ * be set as a component object of a retained Soundscape node.
+ */
+class AuralAttributesRetained extends NodeComponentRetained {
+
+ /**
+ * Gain Scale Factor applied to source with this attribute
+ */
+ float attributeGain = 1.0f; // Valid values are >= 0.0.
+
+ /**
+ * Atmospheric Rolloff - speed of sound - coeff
+ * Normal gain attenuation based on distance of sound from
+ * listener is scaled by a rolloff factor, which can increase
+ * or decrease the usual inverse-distance-square value.
+ */
+ float rolloff = 1.0f; // Valid values are >= 0.0
+ static final float SPEED_OF_SOUND = 0.344f; // in meters/milliseconds
+
+ /*
+ * Reverberation
+ *
+ * Within Java 3D's model for auralization, the components to
+ * reverberation for a particular space are:
+ * Reflection and Reverb Coefficients -
+ * attenuation of sound (uniform for all frequencies) due to
+ * absorption of reflected sound off materials within the
+ * listening space.
+ * Reflection and Reverb Delay -
+ * approximating time from the start of the direct sound that
+ * initial early and late reflection waves take to reach listener.
+ * Reverb Decay -
+ * approximating time from the start of the direct sound that
+ * reverberation is audible.
+ */
+
+ /**
+ * Coefficients for reverberation
+ * The (early) Reflection and Reverberation coefficient scale factors
+ * are used to approximate the reflective/absorptive characteristics
+ * of the surfaces in this bounded Auralizaton environment.
+ * Theses scale factors is applied to sound's amplitude regardless
+ * of sound's position.
+ * Value of 1.0 represents complete (unattenuated) sound reflection.
+ * Value of 0.0 represents full absorption; reverberation is disabled.
+ */
+ float reflectionCoefficient = 0.0f; // Range of values 0.0 to 1.0
+ float reverbCoefficient = 1.0f; // Range of values 0.0 to 1.0
+
+ /**
+ * Time Delays in milliseconds
+ * Set with either explicitly with time, or impliciticly by supplying
+ * bounds volume and having the delay time calculated.
+ * Bounds of reverberation space does not have to be the same as
+ * Attribute bounds.
+ */
+ float reflectionDelay = 20.0f; // in milliseconds
+ float reverbDelay = 40.0f; // in milliseconds
+ Bounds reverbBounds = null;
+
+ /**
+ * Decay parameters
+ * Length and timbre of reverb decay tail
+ */
+ float decayTime = 1000.0f; // in milliseconds
+ float decayFilter = 5000.0f; // low-pass cutoff frequency
+
+ /**
+ * Reverb Diffusion and Density ratios (0=min, 1=max)
+ */
+ float diffusion = 1.0f;
+ float density = 1.0f;
+
+ /**
+ * Reverberation order
+ * This limits the number of Reverberation iterations executed while
+ * sound is being reverberated. As long as reflection coefficient is
+ * small enough, the reverberated sound decreases (as it would naturally)
+ * each successive iteration.
+ * Value of > zero defines the greatest reflection order to be used by
+ * the reverberator.
+ * All positive values are used as the number of loop iteration.
+ * Value of <= zero signifies that reverberation is to loop until reverb
+ * gain reaches zero (-60dB or 1/1000 of sound amplitude).
+ */
+ int reverbOrder = 0;
+
+ /**
+ * Distance Filter
+ * Each sound source is attenuated by a filter based on it's distance
+ * from the listener.
+ * For now the only supported filterType will be LOW_PASS frequency cutoff.
+ * At some time full FIR filtering will be supported.
+ */
+ static final int NO_FILTERING = -1;
+ static final int LOW_PASS = 1;
+
+ int filterType = NO_FILTERING;
+ float[] distance = null;
+ float[] frequencyCutoff = null;
+
+ /**
+ * Doppler Effect parameters
+ * Between two snapshots of the head and sound source positions some
+ * delta time apart, the distance between head and source is compared.
+ * If there has been no change in the distance between head and sound
+ * source over this delta time:
+ * f' = f
+ *
+ * If there has been a change in the distance between head and sound:
+ * f' = f * Af * v
+ *
+ * When head and sound are moving towards each other then
+ * | (S * Ar) + (deltaV(h,t) * Av) |
+ * v = | -------------------------------- |
+ * | (S * Ar) - (deltaV(s,t) * Av) |
+ *
+ * When head and sound are moving away from each other then
+ * | (S * Ar) - (deltaV(h,t) * Av) |
+ * v = | -------------------------------- |
+ * | (S * Ar) + (deltaV(s,t) * Av) |
+ *
+ *
+ * Af = AuralAttribute frequency scalefactor
+ * Ar = AuralAttribute rolloff scalefactor
+ * Av = AuralAttribute velocity scalefactor
+ * deltaV = delta velocity
+ * f = frequency of sound
+ * h = Listeners head position
+ * v = Ratio of delta velocities
+ * Vh = Vector from center ear to sound source
+ * S = Speed of sound
+ * s = Sound source position
+ * t = time
+ *
+ * If adjusted velocity of head or adjusted velocity of sound is
+ * greater than adjusted speed of sound, f' is undefined.
+ */
+ /**
+ * Frequency Scale Factor
+ * used to increase or reduce the change of frequency associated
+ * with normal rate of playback.
+ * Value of zero causes sounds to be paused.
+ */
+ float frequencyScaleFactor = 1.0f;
+ /**
+ * Velocity Scale Factor
+ * Float value applied to the Change of distance between Sound Source
+ * and Listener over some delta time. Non-zero if listener moving
+ * even if sound is not. Value of zero implies no Doppler applied.
+ */
+ float velocityScaleFactor = 0.0f;
+
+ /**
+ * This boolean is set when something changes in the attributes
+ */
+ boolean aaDirty = true;
+
+ /**
+ * The mirror copy of this AuralAttributes.
+ */
+ AuralAttributesRetained mirrorAa = null;
+
+ /**
+ ** Debug print mechanism for Sound nodes
+ **/
+ static final // 'static final' so compiler doesn't include debugPrint calls
+ boolean debugFlag = false;
+
+ static final // 'static final' so internal error message are not compiled
+ boolean internalErrors = false;
+
+ void debugPrint(String message) {
+ if (debugFlag) // leave test in in case debugFlag made non-static final
+ System.err.println(message);
+ }
+
+
+ // ****************************************
+ //
+ // Set and Get individual attribute values
+ //
+ // ****************************************
+
+ /**
+ * Set Attribute Gain (amplitude)
+ * @param gain scale factor applied to amplitude
+ */
+ void setAttributeGain(float gain) {
+ this.attributeGain = gain;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Attribute Gain (amplitude)
+ * @return gain amplitude scale factor
+ */
+ float getAttributeGain() {
+ return this.attributeGain;
+ }
+
+ /**
+ * Set Attribute Gain Rolloff
+ * @param rolloff atmospheric gain scale factor (changing speed of sound)
+ */
+ void setRolloff(float rolloff) {
+ this.rolloff = rolloff;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Attribute Gain Rolloff
+ * @return rolloff atmospheric gain scale factor (changing speed of sound)
+ */
+ float getRolloff() {
+ return this.rolloff;
+ }
+
+ /**
+ * Set Reflective Coefficient
+ * @param reflectionCoefficient reflection/absorption factor applied to
+ * early reflections.
+ */
+ void setReflectionCoefficient(float reflectionCoefficient) {
+ this.reflectionCoefficient = reflectionCoefficient;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Reflective Coefficient
+ * @return reflection coeff reflection/absorption factor applied to
+ * early reflections.
+ */
+ float getReflectionCoefficient() {
+ return this.reflectionCoefficient;
+ }
+
+ /**
+ * Set Reflection Delay Time
+ * @param reflectionDelay time before the start of early (first order)
+ * reflections.
+ */
+ void setReflectionDelay(float reflectionDelay) {
+ this.reflectionDelay = reflectionDelay;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Reflection Delay Time
+ * @return reflection delay time
+ */
+ float getReflectionDelay() {
+ return this.reflectionDelay;
+ }
+
+ /**
+ * Set Reverb Coefficient
+ * @param reverbCoefficient reflection/absorption factor applied to
+ * late reflections.
+ */
+ void setReverbCoefficient(float reverbCoefficient) {
+ this.reverbCoefficient = reverbCoefficient;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Reverb Coefficient
+ * @return reverb coeff reflection/absorption factor applied to late
+ * reflections.
+ */
+ float getReverbCoefficient() {
+ return this.reverbCoefficient;
+ }
+
+ /**
+ * Set Revereration Delay Time
+ * @param reverbDelay time between each order of reflection
+ */
+ void setReverbDelay(float reverbDelay) {
+ this.reverbDelay = reverbDelay;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Revereration Delay Time
+ * @return reverb delay time between each order of reflection
+ */
+ float getReverbDelay() {
+ return this.reverbDelay;
+ }
+ /**
+ * Set Decay Time
+ * @param decayTime length of time reverb takes to decay
+ */
+ void setDecayTime(float decayTime) {
+ this.decayTime = decayTime;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Revereration Decay Time
+ * @return reverb delay time
+ */
+ float getDecayTime() {
+ return this.decayTime;
+ }
+
+ /**
+ * Set Decay Filter
+ * @param decayFilter frequency referenced used in low-pass filtering
+ */
+ void setDecayFilter(float decayFilter) {
+ this.decayFilter = decayFilter;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+
+ /**
+ * Retrieve Revereration Decay Filter
+ * @return reverb delay Filter
+ */
+ float getDecayFilter() {
+ return this.decayFilter;
+ }
+
+ /**
+ * Set Reverb Diffusion
+ * @param diffusion ratio between min and max device diffusion settings
+ */
+ void setDiffusion(float diffusion) {
+ this.diffusion = diffusion;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+
+ /**
+ * Retrieve Revereration Decay Diffusion
+ * @return reverb diffusion
+ */
+ float getDiffusion() {
+ return this.diffusion;
+ }
+
+ /**
+ * Set Reverb Density
+ * @param density ratio between min and max device density settings
+ */
+ void setDensity(float density) {
+ this.density = density;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+
+ /**
+ * Retrieve Revereration Density
+ * @return reverb density
+ */
+ float getDensity() {
+ return this.density;
+ }
+
+
+ /**
+ * Set Revereration Bounds
+ * @param reverbVolume bounds used to approximate reverb time.
+ */
+ synchronized void setReverbBounds(Bounds reverbVolume) {
+ this.reverbBounds = reverbVolume;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Revereration Delay Bounds volume
+ * @return reverb bounds volume that defines the Reverberation space and
+ * indirectly the delay
+ */
+ Bounds getReverbBounds() {
+ return this.reverbBounds;
+ }
+
+ /**
+ * Set Reverberation Order of Reflections
+ * @param reverbOrder number of times reflections added to reverb signal
+ */
+ void setReverbOrder(int reverbOrder) {
+ this.reverbOrder = reverbOrder;
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Retrieve Reverberation Order of Reflections
+ * @return reverb order number of times reflections added to reverb signal
+ */
+ int getReverbOrder() {
+ return this.reverbOrder;
+ }
+
+ /**
+ * Set Distance Filter (based on distances and frequency cutoff)
+ * @param attenuation array of pairs defining distance frequency cutoff
+ */
+ synchronized void setDistanceFilter(Point2f[] attenuation) {
+ if (attenuation == null) {
+ this.filterType = NO_FILTERING;
+ return;
+ }
+ int attenuationLength = attenuation.length;
+ if (attenuationLength == 0) {
+ this.filterType = NO_FILTERING;
+ return;
+ }
+ this.filterType = LOW_PASS;
+ // Reallocate every time unless size of new array equal old array
+ if ( distance == null ||
+ (distance != null && (distance.length != attenuationLength) ) ) {
+ this.distance = new float[attenuationLength];
+ this.frequencyCutoff = new float[attenuationLength];
+ }
+ for (int i = 0; i< attenuationLength; i++) {
+ this.distance[i] = attenuation[i].x;
+ this.frequencyCutoff[i] = attenuation[i].y;
+ }
+ this.aaDirty = true;
+ notifyUsers();
+ }
+ /**
+ * Set Distance Filter (based on distances and frequency cutoff) using
+ * separate arrays
+ * @param distance array containing distance values
+ * @param filter array containing low-pass frequency cutoff values
+ */
+ synchronized void setDistanceFilter(float[] distance, float[] filter) {
+ if (distance == null || filter == null) {
+ this.filterType = NO_FILTERING;
+ return;
+ }
+ int distanceLength = distance.length;
+ int filterLength = filter.length;
+ if (distanceLength == 0 || filterLength == 0) {
+ this.filterType = NO_FILTERING;
+ return;
+ }
+ // Reallocate every time unless size of new array equal old array
+ if ( this.distance == null ||
+ ( this.distance != null &&
+ (this.distance.length != filterLength) ) ) {
+ this.distance = new float[distanceLength];
+ this.frequencyCutoff = new float[distanceLength];
+ }
+ this.filterType = LOW_PASS;
+ // Copy the distance array into nodes field
+ System.arraycopy(distance, 0, this.distance, 0, distanceLength);
+ // Copy the filter array an array of same length as the distance array
+ if (distanceLength <= filterLength) {
+ System.arraycopy(filter, 0, this.frequencyCutoff,0, distanceLength);
+ }
+ else {
+ System.arraycopy(filter, 0, this.frequencyCutoff, 0, filterLength);
+ // Extend filter array to length of distance array by
+ // replicate last filter values.
+ for (int i=filterLength; i< distanceLength; i++) {
+ this.frequencyCutoff[i] = filter[filterLength - 1];
+ }
+ }
+ if (debugFlag) {
+ debugPrint("AAR setDistanceFilter(D,F)");
+ for (int jj=0;jjwindow.width/image.width
+ * and window.height/image.height. The image will
+ * exactly fill either the width or height of the window, but not
+ * necessarily both. The portion of the window not filled by the
+ * image will be filled with the background color.
+ * The upper left corner of the image is anchored at the
+ * upper-left corner of the window.
+ *
+ * @see #setImageScaleMode
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int SCALE_FIT_MIN = 1;
+
+ /**
+ * Indicates that the background image is uniformly scaled to fit
+ * the window such that the entire window is filled. The image is
+ * scaled by the larger of window.width/image.width
+ * and window.height/image.height. The image will
+ * entirely fill the window, but may by clipped either in X
+ * or Y.
+ * The upper left corner of the image is anchored at the
+ * upper-left corner of the window.
+ *
+ * @see #setImageScaleMode
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int SCALE_FIT_MAX = 2;
+
+
+ /**
+ * Indicates that the background image is scaled to fit the
+ * window. The image is scaled non-uniformly in x and
+ * y by window.width/image.width and and
+ * window.height/image.height, respectively. The
+ * image will entirely fill the window.
+ *
+ * @see #setImageScaleMode
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int SCALE_FIT_ALL = 3;
+
+ /**
+ * Indicates that the background image is tiled to fill the entire
+ * window. The image is not scaled.
+ * The upper left corner of the image is anchored at the
+ * upper-left corner of the window.
+ *
+ * @see #setImageScaleMode
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int SCALE_REPEAT = 4;
+
+ /**
+ * Indicates that the background image is centered in the window
+ * and that no scaling of the image is done. The image will be
+ * drawn in its actual size. If the window is smaller than the
+ * image, the image will be clipped. If the window is larger than
+ * the image, the portion of the window not filled by the image
+ * will be filled with the background color.
+ *
+ * @see #setImageScaleMode
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int SCALE_NONE_CENTER = 5;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_APPLICATION_BOUNDS_READ,
+ ALLOW_COLOR_READ,
+ ALLOW_GEOMETRY_READ,
+ ALLOW_IMAGE_READ,
+ ALLOW_IMAGE_SCALE_MODE_READ
+ };
+
+
+ /**
+ * Constructs a Background node with default parameters. The default
+ * values are as follows:
+ *
+ * color : black (0,0,0)
+ */
+ public Background () {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a Background node with the specified color.
+ * This color is used to fill the window prior to drawing any
+ * objects in the scene.
+ */
+ public Background(Color3f color) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((BackgroundRetained)this.retained).setColor(color);
+ }
+
+ /**
+ * Constructs a Background node with the specified color.
+ * This color is used to fill the window prior to drawing any
+ * objects in the scene.
+ */
+ public Background(float r, float g, float b) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((BackgroundRetained)this.retained).setColor(r, g, b);
+ }
+
+ /**
+ * Constructs a Background node with the specified image. If this
+ * image is non-null, it is rendered to the window prior to
+ * drawing any objects in the scene. If the image is smaller
+ * than the window,
+ * then that portion of the window not covered by the image is
+ * filled with the background color.
+ *
+ * @param image pixel array object used as the background image
+ *
+ * @exception IllegalArgumentException if the image class of the specified
+ * ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.
+ */
+ public Background(ImageComponent2D image) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ if((image != null) &&
+ (image.getImageClass() == ImageComponent.ImageClass.NIO_IMAGE_BUFFER)) {
+ throw new IllegalArgumentException(J3dI18N.getString("Background14"));
+ }
+
+ ((BackgroundRetained)this.retained).setImage(image);
+ }
+
+ /**
+ * Constructs a Background node with the specified geometry.
+ * If non-null, this background geometry is drawn on top of
+ * the background color and image using a projection
+ * matrix that essentially puts the geometry at infinity. The geometry
+ * should be pre-tessellated onto a unit sphere.
+ * @param branch the root of the background geometry
+ * @exception IllegalSharingException if the BranchGroup node
+ * is a child of any Group node, or is already attached to a Locale,
+ * or is already referenced by another Background node.
+ * @exception IllegalSceneGraphException if specified branch graph
+ * contains an illegal node.
+ */
+ public Background(BranchGroup branch) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((BackgroundRetained)this.retained).setGeometry(branch);
+ }
+
+ /**
+ * Sets the background color to the specified color.
+ * This color is used to fill the window prior to drawing any
+ * objects in the scene.
+ * @param color the new background color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background0"));
+
+ if (isLive())
+ ((BackgroundRetained)this.retained).setColor(color);
+ else
+ ((BackgroundRetained)this.retained).initColor(color);
+
+ }
+
+ /**
+ * Sets the background color to the specified color.
+ * This color is used to fill the window prior to drawing any
+ * objects in the scene.
+ * @param r the red component of the background color
+ * @param g the green component of the background color
+ * @param b the blue component of the background color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setColor(float r, float g, float b) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background0"));
+
+ if (isLive())
+ ((BackgroundRetained)this.retained).setColor(r, g, b);
+ else
+ ((BackgroundRetained)this.retained).initColor(r, g, b);
+ }
+
+ /**
+ * Retrieves the background color.
+ * @param color the vector that will receive the current background color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background2"));
+
+ ((BackgroundRetained)this.retained).getColor(color);
+ }
+
+ /**
+ * Sets the background image to the specified image. If this
+ * image is non-null, it is rendered to the window prior to
+ * drawing any objects in the scene. If the image is smaller
+ * than the window,
+ * then that portion of the window not covered by the image is
+ * filled with the background color.
+ *
+ * @param image new pixel array object used as the background image
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalSharingException if this Background is live and
+ * the specified image is being used by a Canvas3D as an off-screen buffer.
+ *
+ * @exception IllegalSharingException if this Background is
+ * being used by an immediate mode context and
+ * the specified image is being used by a Canvas3D as an off-screen buffer.
+ *
+ * @exception IllegalArgumentException if the image class of the specified
+ * ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.
+ */
+ public void setImage(ImageComponent2D image) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_IMAGE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background3"));
+
+ BackgroundRetained bgRetained = (BackgroundRetained)this.retained;
+
+ if((image != null) &&
+ (image.getImageClass() == ImageComponent.ImageClass.NIO_IMAGE_BUFFER)) {
+ throw new IllegalArgumentException(J3dI18N.getString("Background14"));
+ }
+
+ // Do illegal sharing check
+ if(image != null) {
+ ImageComponent2DRetained imageRetained = (ImageComponent2DRetained) image.retained;
+ if(imageRetained.getUsedByOffScreen()) {
+ if(isLive()) {
+ throw new IllegalSharingException(J3dI18N.getString("Background12"));
+ }
+ if(bgRetained.getInImmCtx()) {
+ throw new IllegalSharingException(J3dI18N.getString("Background13"));
+ }
+ }
+ }
+
+ if (isLive())
+ bgRetained.setImage(image);
+ else
+ bgRetained.initImage(image);
+ }
+
+ /**
+ * Retrieves the background image.
+ * @return the current background image
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public ImageComponent2D getImage() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_IMAGE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background4"));
+
+ return ((BackgroundRetained)this.retained).getImage();
+ }
+
+ /**
+ * Sets the image scale mode for this Background node.
+ *
+ * @param imageScaleMode the new image scale mode, one of:
+ * SCALE_NONE, SCALE_FIT_MIN, SCALE_FIT_MAX, SCALE_FIT_ALL,
+ * SCALE_REPEAT, or SCALE_NONE_CENTER.
+ *
+ * @exception IllegalArgumentException if
+ * image : null
+ * geometry : null
+ * image scale mode : SCALE_NONE
+ * application bounds : null
+ * application bounding leaf : null
+ * imageScaleMode
+ * is a value other than SCALE_NONE, SCALE_FIT_MIN, SCALE_FIT_MAX,
+ * SCALE_FIT_ALL, SCALE_REPEAT, or SCALE_NONE_CENTER.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void setImageScaleMode(int imageScaleMode) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_IMAGE_SCALE_MODE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background9"));
+
+ switch (imageScaleMode) {
+ case SCALE_NONE:
+ case SCALE_FIT_MIN:
+ case SCALE_FIT_MAX:
+ case SCALE_FIT_ALL:
+ case SCALE_REPEAT:
+ case SCALE_NONE_CENTER:
+ break;
+ default:
+ throw new IllegalArgumentException(J3dI18N.getString("Background11"));
+ }
+
+ if (isLive())
+ ((BackgroundRetained)this.retained).setImageScaleMode(imageScaleMode);
+ else
+ ((BackgroundRetained)this.retained).initImageScaleMode(imageScaleMode);
+
+ }
+
+ /**
+ * Retrieves the current image scale mode.
+ * @return the current image scale mode, one of:
+ * SCALE_NONE, SCALE_FIT_MIN, SCALE_FIT_MAX, SCALE_FIT_ALL,
+ * SCALE_REPEAT, or SCALE_NONE_CENTER.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int getImageScaleMode() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_IMAGE_SCALE_MODE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background10"));
+ return ((BackgroundRetained)this.retained).getImageScaleMode();
+ }
+
+ /**
+ * Sets the background geometry to the specified BranchGroup node.
+ * If non-null, this background geometry is drawn on top of
+ * the background color and image using a projection
+ * matrix that essentially puts the geometry at infinity. The geometry
+ * should be pre-tessellated onto a unit sphere.
+ * @param branch the root of the background geometry
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception IllegalSharingException if the BranchGroup node
+ * is a child of any Group node, or is already attached to a Locale,
+ * or is already referenced by another Background node.
+ * @exception IllegalSceneGraphException if specified branch graph
+ * contains an illegal node.
+ */
+ public void setGeometry(BranchGroup branch) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_GEOMETRY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background5"));
+
+ if (isLive())
+ ((BackgroundRetained)this.retained).setGeometry(branch);
+ else
+ ((BackgroundRetained)this.retained).initGeometry(branch);
+ }
+
+ /**
+ * Retrieves the background geometry.
+ * @return the BranchGroup node that is the root of the background
+ * geometry
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public BranchGroup getGeometry() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_GEOMETRY_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background6"));
+
+ return ((BackgroundRetained)this.retained).getGeometry();
+ }
+
+ /**
+ * Set the Background's application region to the specified bounds.
+ * This is used when the application bounding leaf is set to null.
+ * @param region the bounds that contains the Background's new application
+ * region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setApplicationBounds(Bounds region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background7"));
+
+ if (isLive())
+ ((BackgroundRetained)this.retained).setApplicationBounds(region);
+ else
+ ((BackgroundRetained)this.retained).initApplicationBounds(region);
+ }
+
+ /**
+ * Retrieves the Background node's application bounds.
+ * @return this Background's application bounds information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getApplicationBounds() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background8"));
+
+ return ((BackgroundRetained)this.retained).getApplicationBounds();
+ }
+
+ /**
+ * Set the Background's application region to the specified bounding leaf.
+ * When set to a value other than null, this overrides the application
+ * bounds object.
+ * @param region the bounding leaf node used to specify the Background
+ * node's new application region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setApplicationBoundingLeaf(BoundingLeaf region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background7"));
+
+ if (isLive())
+ ((BackgroundRetained)this.retained).setApplicationBoundingLeaf(region);
+ else
+ ((BackgroundRetained)this.retained).initApplicationBoundingLeaf(region);
+ }
+
+ /**
+ * Retrieves the Background node's application bounding leaf.
+ * @return this Background's application bounding leaf information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public BoundingLeaf getApplicationBoundingLeaf() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Background8"));
+
+ return ((BackgroundRetained)this.retained).getApplicationBoundingLeaf();
+ }
+
+ /**
+ * Creates the retained mode BackgroundRetained object that this
+ * Background component object will point to.
+ */
+ void createRetained() {
+ this.retained = new BackgroundRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * Creates a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ * Background geometry will not clone in this operation.
+ * It is the user's responsibility
+ * to call cloneTree on that branchGroup.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ Background b = new Background();
+ b.duplicateNode(this, forceDuplicate);
+ return b;
+ }
+
+
+ /**
+ * Copies all node information from originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.
+ * NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ * @exception ClassCastException if originalNode is not an instance of
+ * Background
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public void duplicateNode(Node originalNode, boolean
+ forceDuplicate) {
+ checkDuplicateNode(originalNode, forceDuplicate);
+ }
+
+
+ /**
+ * Copies all Background information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ BackgroundRetained attr = (BackgroundRetained) originalNode.retained;
+ BackgroundRetained rt = (BackgroundRetained) retained;
+
+ Color3f c = new Color3f();
+ attr.getColor(c);
+ rt.initColor(c);
+ rt.initApplicationBounds(attr.getApplicationBounds());
+ rt.initGeometry(attr.getGeometry());
+ // issue # 563: add call to cloneTree()
+ rt.initGeometry((BranchGroup) (attr.getGeometry() == null ? null : attr.getGeometry().cloneTree(true)));
+ rt.initImage((ImageComponent2D) getNodeComponent(
+ attr.getImage(),
+ forceDuplicate,
+ originalNode.nodeHashtable));
+
+ // this will be updated in updateNodeReferences
+ rt.initApplicationBoundingLeaf(attr.getApplicationBoundingLeaf());
+ }
+
+
+ /**
+ * Callback used to allow a node to check if any scene graph objects
+ * referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any object references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding object in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * object is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances
+ *
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+ super.updateNodeReferences(referenceTable);
+
+ BackgroundRetained rt = (BackgroundRetained) retained;
+ BoundingLeaf bl= rt.getApplicationBoundingLeaf();
+
+ if (bl != null) {
+ Object o = referenceTable.getNewObjectReference(bl);
+ rt.initApplicationBoundingLeaf((BoundingLeaf) o);
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BackgroundRetained.java b/j3d-core/src/classes/share/javax/media/j3d/BackgroundRetained.java
new file mode 100644
index 0000000..d21930e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BackgroundRetained.java
@@ -0,0 +1,795 @@
+/*
+ * $RCSfile: BackgroundRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+import java.awt.geom.AffineTransform;
+import java.awt.image.AffineTransformOp;
+import java.awt.image.BufferedImage;
+
+
+/**
+ * The Background leaf node defines either a solid background color
+ * or a background image that is used to fill the window at the
+ * beginning of each new frame. It also specifies an application
+ * region in which this background is active.
+ */
+class BackgroundRetained extends LeafRetained {
+
+ static final int COLOR_CHANGED = 0x00001;
+ static final int IMAGE_CHANGED = 0x00002;
+ static final int GEOMETRY_CHANGED = 0x00004;
+ static final int BOUNDS_CHANGED = 0x00008;
+ static final int BOUNDINGLEAF_CHANGED = 0x00010;
+ static final int IMAGE_SCALE_CHANGED = 0x00020;
+ // Background color or image. If non-null, the image overrides the
+ // color.
+ Color3f color = new Color3f(0.0f, 0.0f, 0.0f);
+ ImageComponent2DRetained image = null;
+ Texture2DRetained texture = null;
+
+ // the image scale mode if image is used.
+ int imageScaleMode = Background.SCALE_NONE;
+
+ /**
+ * The Boundary object defining the lights's application region.
+ */
+ Bounds applicationRegion = null;
+
+ /**
+ * The bounding leaf reference
+ */
+ BoundingLeafRetained boundingLeaf = null;
+
+ /**
+ * Background geometry branch group
+ */
+ BranchGroup geometryBranch = null;
+
+ /**
+ * The transformed value of the applicationRegion.
+ */
+ Bounds transformedRegion = null;
+
+ /**
+ * The state structure used for Background Geometry
+ */
+ SetLiveState setLiveState = null;
+
+ /**
+ * The locale of this Background node since we don't have mirror object
+ * when clearLive is called
+ * locale is set to null, we still want locale to have a
+ * non-null value, since renderingEnv structure may be using the
+ * locale
+ */
+ Locale cachedLocale = null;
+
+ // This is true when this background is referenced in an immediate mode context
+ boolean inImmCtx = false;
+
+ // list of light nodes for background geometry
+ ArrayList lights = new ArrayList();
+
+ // list of fog nodes for background geometry
+ ArrayList fogs = new ArrayList();
+
+ // a list of background geometry atoms
+ ArrayList bgGeometryAtomList = new ArrayList();
+
+ // false is background geometry atoms list has changed
+ boolean bgGeometryAtomListDirty = true;
+
+ // an array of background geometry atoms
+ GeometryAtom[] bgGeometryAtoms = null;
+
+ // Target threads to be notified when light changes
+ // Note, the rendering env structure only get notified
+ // when there is a bounds related change
+ final static int targetThreads = J3dThread.UPDATE_RENDERING_ENVIRONMENT |
+ J3dThread.UPDATE_RENDER;
+
+ // Is true, if the background is viewScoped
+ boolean isViewScoped = false;
+
+ BackgroundRetained () {
+ this.nodeType = NodeRetained.BACKGROUND;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ /**
+ * Initializes the background color to the specified color.
+ * This color is used
+ * if the image is null.
+ * @param color the new background color
+ */
+ final void initColor(Color3f color) {
+ this.color.set(color);
+ }
+
+
+ /**
+ * Sets the background color to the specified color. This color is used
+ * if the image is null.
+ * @param color the new background color
+ */
+ final void setColor(Color3f color) {
+ initColor(color);
+ if (source.isLive()) {
+ sendMessage(COLOR_CHANGED, new Color3f(color));
+ }
+ }
+
+ /**
+ * Initializes the background color to the specified color.
+ * This color is used
+ * if the image is null.
+ * @param r the red component of the background color
+ * @param g the green component of the background color
+ * @param b the blue component of the background color
+ */
+ final void initColor(float r, float g, float b) {
+ this.color.x = r;
+ this.color.y = g;
+ this.color.z = b;
+ }
+
+
+
+ /**
+ * Sets the background color to the specified color. This color is used
+ * if the image is null.
+ * @param r the red component of the background color
+ * @param g the green component of the background color
+ * @param b the blue component of the background color
+ */
+ final void setColor(float r, float g, float b) {
+ setColor(new Color3f(r, g, b));
+ }
+
+
+ /**
+ * Retrieves the background color.
+ * @param color the vector that will receive the current background color
+ */
+ final void getColor(Color3f color) {
+ color.set(this.color);
+ }
+
+ /**
+ * Initialize the image scale mode to the specified mode
+ * @imageScaleMode the image scale mode to the used
+ */
+ final void initImageScaleMode(int imageScaleMode){
+ this.imageScaleMode = imageScaleMode;
+ }
+
+ /**
+ * Sets the image scale mode for this Background node.
+ * @param imageScaleMode the image scale mode
+ */
+ final void setImageScaleMode(int imageScaleMode){
+ initImageScaleMode(imageScaleMode);
+ if(source.isLive()){
+ sendMessage(IMAGE_SCALE_CHANGED, new Integer(imageScaleMode));
+ }
+ }
+
+ /**
+ * gets the image scale mode for this Background node.
+ */
+ final int getImageScaleMode(){
+ return imageScaleMode;
+ }
+
+ /**
+ * Initializes the background image to the specified image.
+ * @param image new ImageCompoent2D object used as the background image
+ */
+ final void initImage(ImageComponent2D img) {
+ int texFormat;
+
+ if (img == null) {
+ image = null;
+ texture = null;
+ return;
+ }
+
+ if (img.retained != image ) {
+ image = (ImageComponent2DRetained) img.retained;
+ image.setEnforceNonPowerOfTwoSupport(true);
+ switch(image.getNumberOfComponents()) {
+ case 1:
+ texFormat = Texture.INTENSITY;
+ break;
+ case 2:
+ texFormat = Texture.LUMINANCE_ALPHA;
+ break;
+ case 3:
+ texFormat = Texture.RGB;
+ break;
+ case 4:
+ texFormat = Texture.RGBA;
+ break;
+ default:
+ assert false;
+ return;
+ }
+
+ Texture2D tex2D = new Texture2D(Texture.BASE_LEVEL, texFormat,
+ img.getWidth(), img.getHeight());
+ texture = (Texture2DRetained) tex2D.retained;
+ // Background is special case of Raster.
+ texture.setUseAsRaster(true);
+ // Fix to issue 373 : ImageComponent.set(BufferedImage) ignored when used by Background
+ image.addUser(texture);
+ texture.initImage(0,img);
+ }
+ }
+
+ /**
+ * Sets the background image to the specified image.
+ * @param image new ImageCompoent3D object used as the background image
+ */
+ final void setImage(ImageComponent2D img) {
+ if (source.isLive()) {
+ if (texture != null) {
+ texture.clearLive(refCount);
+ }
+ }
+ initImage(img);
+ if (source.isLive()) {
+ if (texture != null) {
+ texture.setLive(inBackgroundGroup, refCount);
+ }
+
+ sendMessage(IMAGE_CHANGED,
+ (texture != null ? texture.mirror : null));
+
+ }
+ }
+
+ /**
+ * Retrieves the background image.
+ * @return the current background image
+ */
+ final ImageComponent2D getImage() {
+ return (image == null ? null :
+ (ImageComponent2D)image.source);
+ }
+
+ /**
+ * Initializes the background geometry branch group to the specified branch.
+ * @param branch new branch group object used for background geometry
+ */
+ final void initGeometry(BranchGroup branch) {
+ geometryBranch = branch;
+ }
+
+
+ /**
+ * Sets the background geometry branch group to the specified branch.
+ * @param branch new branch group object used for background geometry
+ */
+ final void setGeometry(BranchGroup branch) {
+ int numMessages = 0;
+ int i;
+
+ if (source.isLive()) {
+ J3dMessage m[];
+ if (geometryBranch != null)
+ numMessages+=2; // REMOVE_NODES, ORDERED_GROUP_REMOVED
+ if (branch != null)
+ numMessages+=2; // INSERT_NODES, ORDERED_GROUP_INSERTED
+ m = new J3dMessage[numMessages];
+ for (i=0; itrue, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ BackgroundSound b = new BackgroundSound();
+ b.duplicateNode(this, forceDuplicate);
+ return b;
+ }
+
+ /**
+ * Copies all node information from originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.
+ * NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ * @exception ClassCastException if originalNode is not an instance of
+ * Sound
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public void duplicateNode(Node originalNode, boolean forceDuplicate) {
+ checkDuplicateNode(originalNode, forceDuplicate);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BackgroundSoundRetained.java b/j3d-core/src/classes/share/javax/media/j3d/BackgroundSoundRetained.java
new file mode 100644
index 0000000..8643f68
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BackgroundSoundRetained.java
@@ -0,0 +1,47 @@
+/*
+ * $RCSfile: BackgroundSoundRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * BackgroundSound is a class for sounds that are not spatially rendered.
+ * These sounds are simply added to the stereo sound mix without modification.
+ * These could be used to play mono or stereo music, or ambient sound effects.
+ */
+class BackgroundSoundRetained extends SoundRetained {
+
+ BackgroundSoundRetained() {
+ this.nodeType = NodeRetained.BACKGROUNDSOUND;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BadTransformException.java b/j3d-core/src/classes/share/javax/media/j3d/BadTransformException.java
new file mode 100644
index 0000000..911a046
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BadTransformException.java
@@ -0,0 +1,74 @@
+/*
+ * $RCSfile: BadTransformException.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Indicates an attempt to use a Tranform3D object that is
+ * inappropriate for the object in which it is being used.
+ * For example:
+ *
+ *
+ */
+public class BadTransformException extends RuntimeException{
+
+/**
+ * Create the exception object with default values.
+ */
+ public BadTransformException(){
+ }
+
+/**
+ * Create the exception object that outputs message.
+ * @param str the message string to be output.
+ */
+ public BadTransformException(String str){
+
+ super(str);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Behavior.java b/j3d-core/src/classes/share/javax/media/j3d/Behavior.java
new file mode 100644
index 0000000..e825e37
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Behavior.java
@@ -0,0 +1,527 @@
+/*
+ * $RCSfile: Behavior.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+import java.util.Enumeration;
+
+/**
+ * The Behavior leaf node provides a framework for adding user-defined
+ * actions into the scene graph. Behavior is an abstract class that
+ * defines two methods that must be overridden by a subclass: An
+ * initialization method, called once when the behavior
+ * becomes "live," and a processStimulus method called
+ * whenever appropriate by the Java 3D behavior scheduler. The
+ * Behavior node also contains an enable flag, a scheduling region,
+ * a scheduling interval, and a wakeup condition.
+ *
+ * initialize method allows a Behavior object to
+ * initialize its internal state and specify its initial wakeup
+ * condition(s). Java 3D invokes a behavior's initialize code when the
+ * behavior's containing BranchGroup node is added to the virtual
+ * universe. Java 3D does not invoke the initialize method in a new
+ * thread. Thus, for Java 3D to regain control, the initialize method
+ * must not execute an infinite loop; it must return. Furthermore, a
+ * wakeup condition must be set or else the behavior's processStimulus
+ * method is never executed.
+ *
+ * processStimulus method receives and processes a
+ * behavior's ongoing messages. The Java 3D behavior scheduler invokes
+ * a Behavior node's processStimulus method when an active ViewPlatform's
+ * activation volume intersects a Behavior object's scheduling region
+ * and all of that behavior's wakeup criteria are satisfied. The
+ * processStimulus method performs its computations and actions
+ * (possibly including the registration of state change information
+ * that could cause Java 3D to wake other Behavior objects),
+ * establishes its next wakeup condition, and finally exits.
+ * A typical behavior will modify one or more nodes or node components
+ * in the scene graph. These modifications can happen in parallel
+ * with rendering. In general, applications cannot count on behavior
+ * execution being synchronized with rendering. There are two
+ * exceptions to this general rule:
+ *
+ *
+ *
+ * Note that modifications to geometry by-reference or texture
+ * by-reference are not guaranteed to show up in the same frame as
+ * other scene graph changes.
+ *
+ * processStimulus method of a single behavior instance
+ * are guaranteed to take effect in the same rendering frame.processStimulus methods of the set of behaviors that
+ * wake up in response to a WakeupOnElapsedFrames(0) wakeup condition
+ * are guaranteed to take effect in the same rendering frame.
+ *
+ *
+ *
+ *
+ *
+ *
+ * enable flag : true
+ */
+ public Behavior() {
+ }
+
+ /**
+ * Initialize this behavior. Classes that extend Behavior must
+ * provide their own initialize method.
+ *
+ * scheduling bounds : null
+ * scheduling bounding leaf : null
+ * scheduling interval : numSchedulingIntervals / 2
+ *
+ * NOTE: Applications should not call this method. It is called
+ * by the Java 3D behavior scheduler.
+ */
+ public abstract void initialize();
+
+ /**
+ * Process a stimulus meant for this behavior. This method is invoked
+ * if the Behavior's wakeup criteria are satisfied and an active
+ * ViewPlatform's
+ * activation volume intersects with the Behavior's scheduling region.
+ * Classes that extend Behavior must provide their own processStimulus
+ * method.
+ *
+ * NOTE: Applications should not call this method. It is called
+ * by the Java 3D behavior scheduler.
+ * @param criteria an enumeration of triggered wakeup criteria for this
+ * behavior
+ */
+ public abstract void processStimulus(Enumeration criteria);
+
+ /**
+ * Set the Behavior's scheduling region to the specified bounds.
+ * This is used when the scheduling bounding leaf is set to null.
+ * @param region the bounds that contains the Behavior's new scheduling
+ * region
+ */
+ public void setSchedulingBounds(Bounds region) {
+ ((BehaviorRetained)this.retained).setSchedulingBounds(region);
+ }
+
+ /**
+ * Retrieves the Behavior node's scheduling bounds.
+ * @return this Behavior's scheduling bounds information
+ */
+ public Bounds getSchedulingBounds() {
+ return ((BehaviorRetained)this.retained).getSchedulingBounds();
+ }
+
+ /**
+ * Set the Behavior's scheduling region to the specified bounding leaf.
+ * When set to a value other than null, this overrides the scheduling
+ * bounds object.
+ * @param region the bounding leaf node used to specify the Behavior
+ * node's new scheduling region
+ */
+ public void setSchedulingBoundingLeaf(BoundingLeaf region) {
+ ((BehaviorRetained)this.retained).setSchedulingBoundingLeaf(region);
+ }
+
+ /**
+ * Retrieves the Behavior node's scheduling bounding leaf.
+ * @return this Behavior's scheduling bounding leaf information
+ */
+ public BoundingLeaf getSchedulingBoundingLeaf() {
+ return ((BehaviorRetained)this.retained).getSchedulingBoundingLeaf();
+ }
+
+ /**
+ * Creates the retained mode BehaviorRetained object that this
+ * Behavior object will point to.
+ */
+ void createRetained() {
+ this.retained = new BehaviorRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Defines this behavior's wakeup criteria. This method
+ * may only be called from a Behavior object's initialize
+ * or processStimulus methods to (re)arm the next wakeup.
+ * It should be the last thing done by those methods.
+ * @param criteria the wakeup criteria for this behavior
+ * @exception IllegalStateException if this method is called by
+ * a method other than initialize or processStimulus
+ */
+ protected void wakeupOn(WakeupCondition criteria) {
+ BehaviorRetained behavret = (BehaviorRetained) this.retained;
+ synchronized (behavret) {
+ if (!behavret.inCallback) {
+ throw new IllegalStateException(J3dI18N.getString("Behavior0"));
+ }
+ }
+ behavret.wakeupOn(criteria);
+ }
+
+ /**
+ * Retrieves this behavior's current wakeup condition as set by
+ * the wakeupOn method. If no wakeup condition is currently
+ * active, null will be returned. In particular, this means that
+ * null will be returned if Java 3D is executing this behavior's
+ * processStimulus routine and wakeupOn has not yet been called to
+ * re-arm the wakeup condition for next time.
+ *
+ * @return the current wakeup condition for this behavior
+ *
+ * @since Java 3D 1.3
+ */
+ protected WakeupCondition getWakeupCondition() {
+ return ((BehaviorRetained)this.retained).getWakeupCondition();
+ }
+
+ /**
+ * Posts the specified postId to the Behavior Scheduler. All behaviors
+ * that have registered WakeupOnBehaviorPost with this postId, or a postId
+ * of 0, and with this behavior, or a null behavior, will have that wakeup
+ * condition met.
+ * numSchedulingIntervals / 2.
+ *
+ * @return the number of supported scheduling intervals
+ *
+ * @since Java 3D 1.3
+ */
+ public static int getNumSchedulingIntervals() {
+ return BehaviorRetained.NUM_SCHEDULING_INTERVALS;
+ }
+
+
+ /**
+ * Sets the scheduling interval of this Behavior node to the
+ * specified value.
+ *
+ * The scheduling interval defines a partial order of execution
+ * for behaviors that wake up in response to the same wakeup
+ * condition (that is, those behaviors that are processed at the
+ * same "time"). Given a set of behaviors whose wakeup conditions
+ * are satisfied at the same time, the behavior scheduler will
+ * execute all behaviors in a lower scheduling interval before
+ * executing any behavior in a higher scheduling interval. Within
+ * a scheduling interval, behaviors can be executed in any order,
+ * or in parallel. Note that this partial ordering is only
+ * guaranteed for those behaviors that wake up at the same time in
+ * response to the same wakeup condition, for example, the set of
+ * behaviors that wake up every frame in response to a
+ * WakeupOnElapsedFrames(0) wakeup condition.
+ *
+ * The default value is numSchedulingIntervals / 2.
+ *
+ * @param schedulingInterval the new scheduling interval
+ *
+ * @exception IllegalArgumentException if
+ * schedulingInterval < 0 or
+ * schedulingInterval >=
+ * numSchedulingIntervals
+ *
+ * @since Java 3D 1.3
+ */
+ public void setSchedulingInterval(int schedulingInterval) {
+ if (schedulingInterval < 0 ||
+ schedulingInterval >= getNumSchedulingIntervals()) {
+
+ throw new IllegalStateException(J3dI18N.getString("Behavior1"));
+ }
+
+ ((BehaviorRetained)this.retained).
+ setSchedulingInterval(schedulingInterval);
+ }
+
+ /**
+ * Retrieves the current scheduling interval of this Behavior
+ * node.
+ *
+ * @return the current scheduling interval
+ *
+ * @since Java 3D 1.3
+ */
+ public int getSchedulingInterval() {
+ return ((BehaviorRetained)this.retained).getSchedulingInterval();
+ }
+
+ /**
+ * Returns the primary view associated with this behavior. This method
+ * is useful with certain types of behaviors (e.g., Billboard, LOD) that
+ * rely on per-View information and with behaviors in general in regards
+ * to scheduling (the distance from the view platform determines the
+ * active behaviors). The "primary" view is defined to be the first
+ * View attached to a live ViewPlatform, if there is more than one active
+ * View. So, for instance, Billboard behaviors would be oriented toward
+ * this primary view, in the case of multiple active views into the same
+ * scene graph.
+ */
+ protected View getView() {
+ return ((BehaviorRetained)this.retained).getView();
+ }
+
+
+ /**
+ * Copies all Behavior information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ BehaviorRetained attr = (BehaviorRetained) originalNode.retained;
+ BehaviorRetained rt = (BehaviorRetained) retained;
+
+ rt.setEnable(attr.getEnable());
+ rt.setSchedulingBounds(attr.getSchedulingBounds());
+ rt.setSchedulingInterval(attr.getSchedulingInterval());
+ // will set to the correct one in updateNodeReferences
+ rt.setSchedulingBoundingLeaf(attr.getSchedulingBoundingLeaf());
+
+ }
+
+
+ /**
+ * Callback used to allow a node to check if any scene graph objects
+ * referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any object references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding object in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * object is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ *
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+ super.updateNodeReferences(referenceTable);
+
+ BehaviorRetained rt = (BehaviorRetained) retained;
+ BoundingLeaf bl= rt.getSchedulingBoundingLeaf();
+
+ // check for schedulingBoundingLeaf
+ if (bl != null) {
+ Object o = referenceTable.getNewObjectReference(bl);
+ rt.setSchedulingBoundingLeaf((BoundingLeaf) o);
+
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BehaviorRetained.java b/j3d-core/src/classes/share/javax/media/j3d/BehaviorRetained.java
new file mode 100644
index 0000000..61c45ab
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BehaviorRetained.java
@@ -0,0 +1,530 @@
+/*
+ * $RCSfile: BehaviorRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+import java.util.ArrayList;
+
+/**
+ * Behavior is an abstract class that contains the framework for all
+ * behavioral components in Java 3D.
+ */
+
+class BehaviorRetained extends LeafRetained {
+ // These bitmasks are used to quickly tell what conditions this behavior
+ // is waiting for. Currently BehaviorStructure only used 4 of them.
+ static final int WAKEUP_ACTIVATE_INDEX = 0;
+ static final int WAKEUP_DEACTIVATE_INDEX = 1;
+ static final int WAKEUP_VP_ENTRY_INDEX = 2;
+ static final int WAKEUP_VP_EXIT_INDEX = 3;
+ static final int WAKEUP_TIME_INDEX = 4;
+
+ static final int NUM_WAKEUPS = 5;
+
+ static final int WAKEUP_ACTIVATE = 0x0001;
+ static final int WAKEUP_DEACTIVATE = 0x0002;
+ static final int WAKEUP_VP_ENTRY = 0x0004;
+ static final int WAKEUP_VP_EXIT = 0x0008;
+ static final int WAKEUP_TIME = 0x0010;
+
+ /**
+ * The number of scheduling intervals supported by this
+ * implementation. This is fixed for a particular implementation
+ * and must be at least 10.
+ */
+ static final int NUM_SCHEDULING_INTERVALS = 10;
+
+ // different types of IndexedUnorderedSet that use in BehaviorStructure
+ static final int BEHAIVORS_IN_BS_LIST = 0;
+ static final int SCHEDULE_IN_BS_LIST = 1;
+
+ // total number of different IndexedUnorderedSet types
+ static final int TOTAL_INDEXED_UNORDER_SET_TYPES = 2;
+
+ /**
+ * The Boundary object defining the behavior's scheduling region.
+ */
+ Bounds schedulingRegion = null;
+
+ /**
+ * The bounding leaf reference
+ */
+ BoundingLeafRetained boundingLeaf = null;
+
+ /**
+ * The current wakeup condition.
+ */
+ WakeupCondition wakeupCondition = null;
+
+ /**
+ * This is the new WakeupCondition to be set in
+ * initialize wakeupOn()
+ */
+ WakeupCondition newWakeupCondition = null;
+
+ /**
+ * The current view platform for this behavior; this value is
+ * false until it comes into range of a view platform.
+ */
+ ViewPlatformRetained vp = null;
+
+ /**
+ * The current activation status for this behavior; this value
+ * is false until it comes into range of a view platform.
+ */
+ boolean active = false;
+
+ /**
+ * Flag indicating whether the behavior is enabled.
+ */
+ boolean enable = true;
+
+ /**
+ * Current scheduling interval.
+ */
+ int schedulingInterval = NUM_SCHEDULING_INTERVALS / 2;
+
+ /**
+ * This is a flag that tells the behavior scheduler whether the
+ * user-programmed process stimulus called wakeupOn, if it did
+ * not, then the wakeupCondition will be set to null.
+ */
+ boolean conditionSet = false;
+
+ /**
+ * This is a flag that indicates whether we are in an initialize or
+ * processStimulus callback. If wakeupOn is called for this behavior
+ * when this flag is not set, an exception will be thrown.
+ */
+ boolean inCallback = false;
+
+ /**
+ * This is a flag that indicates whether we are in initialize
+ * callback. If wakeupOn is called for this behavior when
+ * this flag is true, then its
+ * buildTree() will delay until insert nodes message
+ * is get. This is because some localToVworld[] that wakeup
+ * depends may not initialize when this behavior setLive().
+ */
+ boolean inInitCallback = false;
+
+ /**
+ * The transformed schedulingRegion
+ */
+ Bounds transformedRegion = null;
+
+ // A bitmask that indicates that the scheduling region has changed.
+ int isDirty = 0xffff;
+
+ /**
+ * A bitmask that represents all conditions that this behavior is waiting on.
+ */
+ int wakeupMask = 0;
+
+ /**
+ * An array of ints that count how many of each wakup is present
+ */
+ int[] wakeupArray = new int[NUM_WAKEUPS];
+
+ // use to post message when bounds change, always point to this
+ Object targets[] = new Object[1];
+
+ BehaviorRetained() {
+ this.nodeType = NodeRetained.BEHAVIOR;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ targets[0] = this;
+ IndexedUnorderSet.init(this, TOTAL_INDEXED_UNORDER_SET_TYPES);
+ }
+
+ /**
+ * Get the Behavior's scheduling region.
+ * @return this Behavior's scheduling region information
+ */
+ Bounds getSchedulingBounds() {
+ Bounds b = null;
+
+ if (schedulingRegion != null) {
+ b = (Bounds) schedulingRegion.clone();
+ if (staticTransform != null) {
+ Transform3D invTransform = staticTransform.getInvTransform();
+ b.transform(invTransform);
+ }
+ }
+ return b;
+ }
+
+ /**
+ * Set the Behavior's scheduling region.
+ * @param region a region that contains the Behavior's new scheduling
+ * bounds
+ */
+ synchronized void setSchedulingBounds(Bounds region) {
+
+ if (region != null) {
+ schedulingRegion = (Bounds) region.clone();
+ if (staticTransform != null) {
+ schedulingRegion.transform(staticTransform.transform);
+ }
+ } else {
+ schedulingRegion = null;
+ }
+
+ if (source != null && source.isLive()) {
+ sendMessage(J3dMessage.REGION_BOUND_CHANGED);
+ }
+ }
+
+ /**
+ * Set the Sound's scheduling region to the specified Leaf node.
+ */
+ synchronized void setSchedulingBoundingLeaf(BoundingLeaf region) {
+
+ if (source != null && source.isLive()) {
+ if (boundingLeaf != null)
+ boundingLeaf.mirrorBoundingLeaf.removeUser(this);
+ }
+
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ } else {
+ boundingLeaf = null;
+ }
+
+ if (source != null && source.isLive()) {
+ if (boundingLeaf != null)
+ boundingLeaf.mirrorBoundingLeaf.addUser(this);
+ sendMessage(J3dMessage.REGION_BOUND_CHANGED);
+ }
+ }
+
+ /**
+ * Enables or disables this Behavior. The default state is enabled.
+ * @param state true or false to enable or disable this Behavior
+ */
+ void setEnable(boolean state) {
+ if (enable != state) {
+ enable = state;
+ if (source != null && source.isLive()) {
+ sendMessage(state ? J3dMessage.BEHAVIOR_ENABLE:
+ J3dMessage.BEHAVIOR_DISABLE);
+ }
+ }
+ }
+
+
+ /**
+ * Retrieves the state of the Behavior enable flag.
+ * @return the Behavior enable state
+ */
+ boolean getEnable() {
+ return enable;
+ }
+
+
+ /**
+ * Sets the scheduling interval of this Behavior node to the
+ * specified value.
+ * @param schedulingInterval the new scheduling interval
+ */
+ void setSchedulingInterval(int schedulingInterval) {
+
+ if ((source != null) && source.isLive()
+ && !inCallback) {
+ // avoid MT safe problem when user thread setting
+ // this while behavior scheduling using this.
+ sendMessage(J3dMessage.SCHEDULING_INTERVAL_CHANGED,
+ new Integer(schedulingInterval));
+ } else {
+ // garantee this setting reflect in next frame
+ this.schedulingInterval = schedulingInterval;
+ }
+ }
+
+
+ /**
+ * Retrieves the current scheduling interval of this Behavior
+ * node.
+ *
+ * @return the current scheduling interval
+ */
+ int getSchedulingInterval() {
+ return schedulingInterval;
+ }
+
+
+ /**
+ * Get the Behavior's scheduling region
+ */
+ BoundingLeaf getSchedulingBoundingLeaf() {
+ return (boundingLeaf != null ?
+ (BoundingLeaf)boundingLeaf.source : null);
+ }
+
+ /**
+ * This setLive routine first calls the superclass's method, then
+ * it activates all canvases that are associated with the attached
+ * view.
+ */
+ synchronized void setLive(SetLiveState s) {
+
+ super.doSetLive(s);
+ if (inBackgroundGroup) {
+ throw new
+ IllegalSceneGraphException(J3dI18N.getString("BehaviorRetained0"));
+ }
+ if (inSharedGroup) {
+ throw new
+ IllegalSharingException(J3dI18N.getString("BehaviorRetained1"));
+ }
+
+ s.nodeList.add(this);
+ s.behaviorNodes.add(this);
+ s.notifyThreads |= J3dThread.UPDATE_BEHAVIOR;
+ // process switch leaf
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(this, Targets.BEH_TARGETS);
+ }
+ switchState = (SwitchState)s.switchStates.get(0);
+
+ if (boundingLeaf != null) {
+ boundingLeaf.mirrorBoundingLeaf.addUser(this);
+ }
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(this, Targets.BEH_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+ super.markAsLive();
+ }
+
+ /**
+ * This clearLive routine first calls the superclass's method, then
+ * it deactivates all canvases that are associated with the attached
+ * view.
+ */
+ synchronized void clearLive(SetLiveState s) {
+ super.clearLive(s);
+ s.nodeList.add(this);
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(this, Targets.BEH_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+ s.notifyThreads |= J3dThread.UPDATE_BEHAVIOR;
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(this, Targets.BEH_TARGETS);
+ }
+ if (boundingLeaf != null) {
+ boundingLeaf.mirrorBoundingLeaf.removeUser(this);
+ }
+ // BehaviorStructure removeBehavior() will do the
+ // wakeupCondition.cleanTree() over there.
+ }
+
+ /**
+ * This routine execute the user's initialize method
+ */
+ void executeInitialize() {
+
+ synchronized (this) {
+ boolean inCallbackSaved = inCallback;
+ boolean inInitCallbackSaved = inInitCallback;
+
+ inCallback = true;
+ inInitCallback = true;
+ try {
+ ((Behavior)this.source).initialize();
+ }
+ catch (RuntimeException e) {
+ System.err.println("Exception occurred during Behavior initialization:");
+ e.printStackTrace();
+ }
+ catch (Error e) {
+ // Issue 264 - catch Error
+ System.err.println("Error occurred during Behavior initialization:");
+ e.printStackTrace();
+ }
+ inCallback = inCallbackSaved;
+ inInitCallback = inInitCallbackSaved;
+ }
+ }
+
+ /**
+ * Defines this behavior's wakeup criteria.
+ * @param criteria The wakeup criterion for this object
+ */
+ void wakeupOn(WakeupCondition criteria) {
+ // If not call by initialize(), buildTree will
+ // delay until insertNodes in BehaviorStructure
+ // Otherwise BehaviorScheduler will invoke
+ // handleLastWakeupOn()
+ if (criteria == null) {
+ throw new NullPointerException(J3dI18N.getString("BehaviorRetained2"));
+ }
+
+ if (!inInitCallback) {
+ conditionSet = true;
+ wakeupCondition = criteria;
+ } else {
+ // delay setting wakeup condition in BehaviorStructure
+ // activateBehaviors(). This is because there may have
+ // previously wakeupCondition attach to it and
+ // scheduling even after clearLive() due to message
+ // delay processing. It is not MT safe to set it
+ // in user thread.
+ newWakeupCondition = criteria;
+ }
+
+ }
+
+ // The above wakeupOn() just remember the reference
+ // We only need to handle (and ignore the rest) the
+ // last wakeupOn() condition set in the behavior.
+ // This handle the case when multiple wakeupOn()
+ // are invoked in the same processStimulus()
+ void handleLastWakeupOn(WakeupCondition prevWakeupCond,
+ BehaviorStructure bs) {
+
+ if (bs == universe.behaviorStructure) {
+ if (wakeupCondition == prevWakeupCond) {
+ // reuse the same wakeupCondition
+ wakeupCondition.resetTree();
+ } else {
+ if (prevWakeupCond != null) {
+ prevWakeupCond.cleanTree(bs);
+ }
+ wakeupCondition.buildTree(null, 0, this);
+ }
+ } else {
+ // No need to do prevWakeupCond.cleanTree(bs)
+ // since removeBehavior() will do so
+ }
+ }
+
+
+ /**
+ * Returns this behavior's wakeup criteria.
+ * @return criteria The wakeup criteria of this object
+ */
+ WakeupCondition getWakeupCondition() {
+ return wakeupCondition;
+ }
+
+ /**
+ * Post the specified Id. Behaviors use this method to cause sequential
+ * scheduling of other behavior object.
+ * @param postId The Id being posted
+ */
+
+ void postId(int postId){
+ if (source != null && source.isLive()) {
+ universe.behaviorStructure.handleBehaviorPost((Behavior) source, postId);
+ }
+ }
+
+ protected View getView() {
+ return (universe != null ?
+ universe.getCurrentView() : null);
+ }
+
+ synchronized void updateTransformRegion(Bounds bound) {
+ if (boundingLeaf == null) {
+ updateTransformRegion();
+ } else {
+ if (bound == null) {
+ transformedRegion = null;
+ } else {
+ transformedRegion = (Bounds) bound.clone();
+ transformedRegion.transform(
+ boundingLeaf.mirrorBoundingLeaf.getCurrentLocalToVworld());
+ }
+ }
+ }
+
+ synchronized void updateTransformRegion() {
+ if (boundingLeaf == null ||
+ !boundingLeaf.mirrorBoundingLeaf.switchState.currentSwitchOn) {
+ if (schedulingRegion == null) {
+ transformedRegion = null;
+ } else {
+ // use schedulingRegion
+ if (transformedRegion != null) {
+ transformedRegion.set(schedulingRegion);
+ } else {
+ transformedRegion = (Bounds) schedulingRegion.clone();
+ }
+ transformedRegion.transform(getCurrentLocalToVworld());
+
+ }
+ } else {
+ // use boundingLeaf
+ transformedRegion =
+ boundingLeaf.mirrorBoundingLeaf.transformedRegion;
+
+ }
+ }
+
+
+ // Note: This routine will only to update the object's
+ // transformed region
+ void updateBoundingLeaf(long refTime) {
+ transformedRegion = (Bounds)boundingLeaf.mirrorBoundingLeaf.transformedRegion;
+ }
+
+
+ void addWakeupCondition() {}
+
+ final void sendMessage(int mtype, Object arg) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_BEHAVIOR;
+ createMessage.type = mtype;
+ createMessage.universe = universe;
+ createMessage.args[0] = targets;
+ createMessage.args[1]= this;
+ createMessage.args[2]= arg;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+ final void sendMessage(int mtype) {
+ sendMessage(mtype, null);
+ }
+
+ void mergeTransform(TransformGroupRetained xform) {
+ super.mergeTransform(xform);
+ if (schedulingRegion != null) {
+ schedulingRegion.transform(xform.transform);
+ }
+ if (source instanceof DistanceLOD) {
+ ((DistanceLOD)source).mergeTransform(xform);
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BehaviorScheduler.java b/j3d-core/src/classes/share/javax/media/j3d/BehaviorScheduler.java
new file mode 100644
index 0000000..8a05d3e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BehaviorScheduler.java
@@ -0,0 +1,248 @@
+/*
+ * $RCSfile: BehaviorScheduler.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.ArrayList;
+import java.util.logging.Level;
+
+class BehaviorScheduler extends J3dThread {
+
+ /**
+ * The virtual universe that owns this BehaviorScheduler
+ */
+ VirtualUniverse univ = null;
+
+ // reference to behaviourStructure processList
+ UnorderList processList[];
+
+ // reference to scheduleList;
+ IndexedUnorderSet scheduleList;
+
+ // reference to universe.behaviorStructure
+ BehaviorStructure behaviorStructure;
+
+ // A count for BehaviorScheduler start/stop
+ int stopCount = -1;
+
+ /**
+ * These are used for start/stop BehaviorScheduler
+ */
+ long lastStartTime;
+ long lastStopTime;
+
+ // lock to ensure consistency of interval values read
+ Object intervalTimeLock = new Object();
+
+ /**
+ * Some variables used to name threads correctly
+ */
+ private static int numInstances = 0;
+ private int instanceNum = -1;
+
+ private synchronized int newInstanceNum() {
+ return (++numInstances);
+ }
+
+ int getInstanceNum() {
+ if (instanceNum == -1)
+ instanceNum = newInstanceNum();
+ return instanceNum;
+ }
+
+
+ BehaviorScheduler(ThreadGroup t, VirtualUniverse universe) {
+ super(t);
+ setName("J3D-BehaviorScheduler-" + getInstanceNum());
+ this.univ = universe;
+ behaviorStructure = universe.behaviorStructure;
+ scheduleList = behaviorStructure.scheduleList;
+ processList = behaviorStructure.processList;
+ type = J3dThread.BEHAVIOR_SCHEDULER;
+ }
+
+ void stopBehaviorScheduler(long[] intervalTime) {
+
+ stopCount = 2;
+ VirtualUniverse.mc.sendRunMessage(univ, J3dThread.BEHAVIOR_SCHEDULER);
+ while (!userStop ) {
+ MasterControl.threadYield();
+ }
+ synchronized (intervalTimeLock) {
+ intervalTime[0] = lastStartTime;
+ intervalTime[1] = lastStopTime;
+ }
+ }
+
+ void startBehaviorScheduler() {
+ // don't allow scheduler start until intervalTime is read
+ synchronized (intervalTimeLock) {
+ stopCount = -1;
+ userStop = false;
+ VirtualUniverse.mc.setWork();
+ }
+ }
+
+ void deactivate() {
+ active = false;
+ if (stopCount >= 0) {
+ userStop = true;
+ }
+ }
+
+ /**
+ * The main loop for the Behavior Scheduler.
+ * Main method for firing off vector of satisfied conditions that
+ * are contained in the condMet vector. Method is synchronized
+ * because it is modifying the current wakeup vectors in the
+ * clean (emptying out satisfied conditions) and processStimulus
+ * (adding conditions again if wakeupOn called) calls.
+ */
+ void doWork(long referenceTime) {
+ BehaviorRetained arr[];
+ UnorderList list;
+ int i, size, interval;
+
+ lastStartTime = J3dClock.currentTimeMillis();
+
+ if (stopCount >= 0) {
+ VirtualUniverse.mc.sendRunMessage(univ, J3dThread.BEHAVIOR_SCHEDULER);
+ if (--stopCount == 0) {
+ userStop = true;
+ }
+ }
+
+
+ for (interval = 0;
+ interval < BehaviorRetained.NUM_SCHEDULING_INTERVALS;
+ interval++) {
+
+ list = processList[interval];
+
+ if (list.isEmpty()) {
+ continue;
+ }
+ arr = (BehaviorRetained []) list.toArray(false);
+
+ size = list.arraySize();
+
+ for (i = 0; i < size ; i++) {
+ BehaviorRetained behavret = arr[i];
+
+
+ synchronized (behavret) {
+ Behavior behav = (Behavior) behavret.source;
+
+ if (!behav.isLive() ||
+ !behavret.conditionSet ||
+ (behavret.wakeupCondition == null)) {
+ continue;
+ }
+
+ if (behavret.wakeupCondition.trigEnum == null) {
+ behavret.wakeupCondition.trigEnum =
+ new WakeupCriteriaEnumerator(behavret.wakeupCondition,
+ WakeupCondition.TRIGGERED_ELEMENTS);
+ } else {
+ behavret.wakeupCondition.trigEnum.reset(
+ behavret.wakeupCondition,
+ WakeupCondition.TRIGGERED_ELEMENTS);
+ }
+
+ // BehaviorRetained now cache the old
+ // wakeupCondition in order to
+ // reuse it without the heavyweight cleanTree()
+ // behavret.wakeupCondition.cleanTree();
+
+ behavret.conditionSet = false;
+ WakeupCondition wakeupCond = behavret.wakeupCondition;
+
+ synchronized (behavret) {
+ behavret.inCallback = true;
+ univ.inBehavior = true;
+ try {
+ behav.processStimulus(wakeupCond.trigEnum);
+ }
+ catch (RuntimeException e) {
+ // Force behavior condition to be unset
+ // Issue 21: don't call cleanTree here
+ behavret.conditionSet = false;
+ System.err.println("Exception occurred during Behavior execution:");
+ e.printStackTrace();
+ }
+ catch (Error e) {
+ // Force behavior condition to be unset
+ // Fix for issue 264
+ behavret.conditionSet = false;
+ System.err.println("Error occurred during Behavior execution:");
+ e.printStackTrace();
+ }
+ univ.inBehavior = false;
+ behavret.inCallback = false;
+ }
+ // note that if the behavior wasn't reset, we need to make the
+ // wakeupcondition equal to null
+ if (behavret.conditionSet == false) {
+ if (wakeupCond != null) {
+ wakeupCond.cleanTree(behaviorStructure);
+ }
+ behavret.wakeupCondition = null;
+ behavret.active = false;
+ scheduleList.remove(behavret);
+ } else {
+ behavret.handleLastWakeupOn(wakeupCond,
+ behaviorStructure);
+ }
+ }
+ }
+ list.clear();
+ }
+
+ behaviorStructure.handleAWTEvent();
+ behaviorStructure.handleBehaviorPost();
+ lastStopTime = J3dClock.currentTimeMillis();
+
+ if (MasterControl.isStatsLoggable(Level.FINE)) {
+ VirtualUniverse.mc.recordTime(MasterControl.TimeType.BEHAVIOR, (lastStopTime-lastStartTime)*1000000);
+ }
+ }
+
+ void free() {
+ behaviorStructure = null;
+ getThreadData(null, null).thread = null;
+ univ = null;
+ for (int i=BehaviorRetained.NUM_SCHEDULING_INTERVALS-1;
+ i >= 0; i--) {
+ processList[i].clear();
+ }
+ scheduleList.clear();
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BehaviorStructure.java b/j3d-core/src/classes/share/javax/media/j3d/BehaviorStructure.java
new file mode 100644
index 0000000..faa1fca
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BehaviorStructure.java
@@ -0,0 +1,1679 @@
+/*
+ * $RCSfile: BehaviorStructure.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+import java.awt.*;
+import java.awt.event.*;
+import java.util.Arrays;
+
+/**
+ * A behavior structure is a object that organizes behaviors,
+ * wakeup conditions, and other behavior scheduler entities.
+ */
+
+class BehaviorStructure extends J3dStructure {
+
+ /**
+ * The list of behaviors
+ */
+ IndexedUnorderSet behaviors;
+
+ /**
+ * The list of view platforms
+ */
+ IndexedUnorderSet viewPlatforms;
+
+ /**
+ * An array of schedulable behaviors, use in
+ * removeViewPlatform() to go through only active behaviors
+ */
+ IndexedUnorderSet scheduleList;
+
+ /**
+ * An array of process behaviors
+ */
+ UnorderList processList[] = new UnorderList[BehaviorRetained.NUM_SCHEDULING_INTERVALS];
+
+ /**
+ * A bounds used for getting a view platform scheduling BoundingSphere
+ */
+ // BoundingSphere tempSphere = new BoundingSphere();
+ // BoundingSphere vpsphere = new BoundingSphere();
+ Point3d vpCenter = new Point3d();
+ Point3d vpTransCenter = new Point3d();
+
+ /**
+ * A list of bounds WakeupOnViewPlatformEntry objects that
+ * have seen ViewPlatformEntry
+ */
+ WakeupIndexedList boundsEntryList;
+
+ /**
+ * A list of bounds WakeupOnViewPlatformExit objects that have
+ * seen ViewPlatformEntry
+ */
+ WakeupIndexedList boundsExitList;
+
+ /**
+ * A list of WakeupOnSensorEntry objects that have seen a sensor
+ */
+ WakeupIndexedList currentSensorEntryList;
+
+ /**
+ * A list of WakeupOnSensorExit objects that have seen a sensor
+ */
+ WakeupIndexedList currentSensorExitList;
+
+ /**
+ * The lists of the WakeupCriterion objects that the
+ * behavior scheduler keeps.
+ */
+ WakeupIndexedList wakeupOnAWTEvent;
+ WakeupIndexedList wakeupOnActivation;
+ WakeupIndexedList wakeupOnDeactivation;
+ WakeupIndexedList wakeupOnBehaviorPost;
+ WakeupIndexedList wakeupOnElapsedFrames;
+ WakeupIndexedList wakeupOnViewPlatformEntry;
+ WakeupIndexedList wakeupOnViewPlatformExit;
+ WakeupIndexedList wakeupOnSensorEntry;
+ WakeupIndexedList wakeupOnSensorExit;
+
+ // Temporary array for processTransformChanged()
+ UnorderList transformViewPlatformList = new UnorderList(ViewPlatformRetained.class);
+
+
+ // The number of active wakeup condition in wakeupOnElapsedFrames
+ int activeWakeupOnFrameCount = 0;
+
+ // The number of active wakeup condition in wakeupOnSensorEntry/Exit
+ int activeWakeupOnSensorCount = 0;
+
+ /**
+ * Buffers to hold events when user thread is in processStimulus()
+ * while this event is receiving. This avoid any lost of event.
+ * We did not remove individual element from the following list
+ * (except clear()) so the order is still preserve.
+ */
+ UnorderList awtEventsBuffer = new UnorderList(AWTEvent.class);
+
+ // Use generic integer array to avoid new Integer() for individual element
+ int postIDBuffer[] = new int[10]; // size of default UnorderList
+ int clonePostIDBuffer[] = new int[postIDBuffer.length];
+
+ UnorderList behaviorPostBuffer = new UnorderList(Behavior.class);
+
+ // temp values for transformed hotspot used in
+ // wakeupOnSensorEntry/ExitupdateSensorsHotspot
+ Transform3D sensorTransform = new Transform3D();
+ Vector3d sensorLoc = new Vector3d();
+ Point3d ptSensorLoc = new Point3d();
+
+ // list of active physical environments
+ UnorderList physicalEnvironments = new UnorderList(1, PhysicalEnvironment.class);
+
+
+ // list of Behavior waiting to be add to behavior list and buildTree()
+ UnorderList pendingBehaviors = new UnorderList(BehaviorRetained.class);
+
+ // true if branch detach
+ boolean branchDetach = false;
+
+ // This is used to notify WakeupOnAWTEvent re-enable Canvas3D events
+ long awtEventTimestamp = 1;
+
+ // used to process transform messages
+ boolean transformMsg = false;
+ UpdateTargets targets = null;
+
+ BehaviorStructure(VirtualUniverse u) {
+ super(u, J3dThread.UPDATE_BEHAVIOR);
+
+ for (int i=BehaviorRetained.NUM_SCHEDULING_INTERVALS-1;
+ i >= 0; i--) {
+ processList[i] = new UnorderList(BehaviorRetained.class);
+ }
+ behaviors = new IndexedUnorderSet(BehaviorRetained.class,
+ BehaviorRetained.BEHAIVORS_IN_BS_LIST, u);
+ viewPlatforms = new IndexedUnorderSet(ViewPlatformRetained.class,
+ ViewPlatformRetained.VP_IN_BS_LIST, u);
+ scheduleList = new IndexedUnorderSet(BehaviorRetained.class,
+ BehaviorRetained.SCHEDULE_IN_BS_LIST, u);
+ boundsEntryList = new WakeupIndexedList(WakeupOnViewPlatformEntry.class,
+ WakeupOnViewPlatformEntry.BOUNDSENTRY_IN_BS_LIST, u);
+ boundsExitList = new WakeupIndexedList(WakeupOnViewPlatformExit.class,
+ WakeupOnViewPlatformExit.BOUNDSEXIT_IN_BS_LIST, u);
+ currentSensorEntryList = new WakeupIndexedList(WakeupOnSensorEntry.class,
+ WakeupOnSensorEntry.SENSORENTRY_IN_BS_LIST, u);
+ currentSensorExitList = new WakeupIndexedList(WakeupOnSensorExit.class,
+ WakeupOnSensorExit.SENSOREXIT_IN_BS_LIST, u);
+ wakeupOnAWTEvent = new WakeupIndexedList(WakeupOnAWTEvent.class,
+ WakeupOnAWTEvent.COND_IN_BS_LIST, u);
+ wakeupOnActivation = new WakeupIndexedList(WakeupOnActivation.class,
+ WakeupOnActivation.COND_IN_BS_LIST, u);
+ wakeupOnDeactivation = new WakeupIndexedList(WakeupOnDeactivation.class,
+ WakeupOnDeactivation.COND_IN_BS_LIST, u);
+ wakeupOnBehaviorPost = new WakeupIndexedList(WakeupOnBehaviorPost.class,
+ WakeupOnBehaviorPost.COND_IN_BS_LIST, u);
+ wakeupOnElapsedFrames = new WakeupIndexedList(WakeupOnElapsedFrames.class,
+ WakeupOnElapsedFrames.COND_IN_BS_LIST, u);
+ wakeupOnViewPlatformEntry = new WakeupIndexedList(WakeupOnViewPlatformEntry.class,
+ WakeupOnViewPlatformEntry.COND_IN_BS_LIST, u);
+ wakeupOnViewPlatformExit = new WakeupIndexedList(WakeupOnViewPlatformExit.class,
+ WakeupOnViewPlatformExit.COND_IN_BS_LIST, u);
+ wakeupOnSensorEntry = new WakeupIndexedList(WakeupOnSensorEntry.class,
+ WakeupOnSensorEntry.COND_IN_BS_LIST, u);
+ wakeupOnSensorExit = new WakeupIndexedList(WakeupOnSensorExit.class,
+ WakeupOnSensorExit.COND_IN_BS_LIST, u);
+
+ }
+
+ void processMessages(long referenceTime) {
+
+ J3dMessage[] messages = getMessages(referenceTime);
+ int nMsg = getNumMessage();
+ J3dMessage m;
+
+ if (nMsg > 0) {
+ for (int i=0; i
+ * alignment mode : ROTATE_ABOUT_AXIS
+ */
+ public Billboard() {
+ nAxis.x = 0.0;
+ nAxis.y = 1.0;
+ nAxis.z = 0.0;
+ }
+
+
+ /**
+ * Constructs a Billboard node with default parameters that operates
+ * on the specified TransformGroup node.
+ * The default alignment mode is ROTATE_ABOUT_AXIS rotation with the axis
+ * pointing along the Y axis.
+ * @param tg the TransformGroup node that this Billboard
+ * node operates upon
+ */
+ public Billboard(TransformGroup tg) {
+ this.tg = tg;
+ nAxis.x = 0.0;
+ nAxis.y = 1.0;
+ nAxis.z = 0.0;
+
+ }
+
+
+ /**
+ * Constructs a Billboard node with the specified axis and mode
+ * that operates on the specified TransformGroup node.
+ * The specified axis must not be parallel to the Z
+ * axis--(0,0,z) for any value of z. It is not
+ * possible for the +Z axis to point at the viewer's eye
+ * position by rotating about itself. The target transform will
+ * be set to the identity if the axis is (0,0,z).
+ *
+ * @param tg the TransformGroup node that this Billboard
+ * node operates upon
+ * @param mode alignment mode, one of ROTATE_ABOUT_AXIS or
+ * ROTATE_ABOUT_POINT
+ * @param axis the ray about which the billboard rotates
+ */
+ public Billboard(TransformGroup tg, int mode, Vector3f axis) {
+ this.tg = tg;
+ this.mode = mode;
+ this.axis.set(axis);
+ double invMag;
+ invMag = 1.0/Math.sqrt(axis.x*axis.x + axis.y*axis.y + axis.z*axis.z);
+ nAxis.x = (double)axis.x*invMag;
+ nAxis.y = (double)axis.y*invMag;
+ nAxis.z = (double)axis.z*invMag;
+
+ }
+
+ /**
+ * Constructs a Billboard node with the specified rotation point and mode
+ * that operates on the specified TransformGroup node.
+ * @param tg the TransformGroup node that this Billboard
+ * node operates upon
+ * @param mode alignment mode, one of ROTATE_ABOUT_AXIS or
+ * ROTATE_ABOUT_POINT
+ * @param point the position about which the billboard rotates
+ */
+ public Billboard(TransformGroup tg, int mode, Point3f point) {
+ this.tg = tg;
+ this.mode = mode;
+ this.rotationPoint.set(point);
+ }
+
+ /**
+ * Sets the alignment mode.
+ * @param mode one of: ROTATE_ABOUT_AXIS or ROTATE_ABOUT_POINT
+ */
+ public void setAlignmentMode(int mode) {
+ this.mode = mode;
+ }
+
+
+ /**
+ * Gets the alignment mode.
+ * @return one of: ROTATE_ABOUT_AXIS or ROTATE_ABOUT_POINT
+ */
+ public int getAlignmentMode() {
+ return this.mode;
+ }
+
+
+ /**
+ * Sets the alignment axis.
+ * The specified axis must not be parallel to the Z
+ * axis--(0,0,z) for any value of z. It is not
+ * possible for the +Z axis to point at the viewer's eye
+ * position by rotating about itself. The target transform will
+ * be set to the identity if the axis is (0,0,z).
+ *
+ * @param axis the ray about which the billboard rotates
+ */
+ public void setAlignmentAxis(Vector3f axis) {
+ this.axis.set(axis);
+ double invMag;
+ invMag = 1.0/Math.sqrt(axis.x*axis.x + axis.y*axis.y + axis.z*axis.z);
+ nAxis.x = (double)axis.x*invMag;
+ nAxis.y = (double)axis.y*invMag;
+ nAxis.z = (double)axis.z*invMag;
+
+ }
+
+
+ /**
+ * Sets the alignment axis.
+ * The specified axis must not be parallel to the Z
+ * axis--(0,0,z) for any value of z. It is not
+ * possible for the +Z axis to point at the viewer's eye
+ * position by rotating about itself. The target transform will
+ * be set to the identity if the axis is (0,0,z).
+ *
+ * @param x the x component of the ray about which the billboard rotates
+ * @param y the y component of the ray about which the billboard rotates
+ * @param z the z component of the ray about which the billboard rotates
+ */
+ public void setAlignmentAxis(float x, float y, float z) {
+ this.axis.set(x, y, z);
+ this.axis.set(axis);
+ double invMag;
+ invMag = 1.0/Math.sqrt(axis.x*axis.x + axis.y*axis.y + axis.z*axis.z);
+ nAxis.x = (double)axis.x*invMag;
+ nAxis.y = (double)axis.y*invMag;
+ nAxis.z = (double)axis.z*invMag;
+
+ }
+
+
+ /**
+ * Gets the alignment axis and sets the parameter to this value.
+ * @param axis the vector that will contain the ray about which
+ * the billboard rotates
+ */
+ public void getAlignmentAxis(Vector3f axis) {
+ axis.set(this.axis);
+ }
+
+ /**
+ * Sets the rotation point.
+ * @param point the point about which the billboard rotates
+ */
+ public void setRotationPoint(Point3f point) {
+ this.rotationPoint.set(point);
+ }
+
+
+ /**
+ * Sets the rotation point.
+ * @param x the x component of the point about which the billboard rotates
+ * @param y the y component of the point about which the billboard rotates
+ * @param z the z component of the point about which the billboard rotates
+ */
+ public void setRotationPoint(float x, float y, float z) {
+ this.rotationPoint.set(x, y, z);
+ }
+
+
+ /**
+ * Gets the rotation point and sets the parameter to this value.
+ * @param point the position the Billboard rotates about
+ */
+ public void getRotationPoint(Point3f point) {
+ point.set(this.rotationPoint);
+ }
+ /**
+ * Sets the tranformGroup for this Billboard object.
+ * @param tg the transformGroup node which replaces the current
+ * transformGroup node for this Billboard
+ */
+ public void setTarget(TransformGroup tg ) {
+ this.tg = tg;
+ }
+
+ /**
+ * Returns a copy of the transformGroup associated with this Billboard.
+ * @return the TranformGroup for this Billboard
+ */
+ public TransformGroup getTarget() {
+ return(tg);
+ }
+
+
+ /**
+ * Initialize method that sets up initial wakeup criteria.
+ */
+ public void initialize() {
+ // Insert wakeup condition into queue
+ wakeupOn(wakeupFrame);
+ }
+
+
+ /**
+ * Process stimulus method that computes appropriate transform.
+ * @param criteria an enumeration of the criteria that caused the
+ * stimulus
+ */
+ public void processStimulus(Enumeration criteria) {
+ double angle = 0.0;
+ double mag,sign;
+ double tx,ty,tz;
+
+ if( tg == null ){
+ wakeupOn(wakeupFrame);
+ return;
+ }
+
+ // get viewplatforms's location in virutal world
+ View v = this.getView();
+ if( v == null ) {
+ wakeupOn(wakeupFrame);
+ return;
+ }
+ Canvas3D canvas = (Canvas3D)v.getCanvas3D(0);
+ boolean status;
+
+ Transform3D xform = new Transform3D();
+ Transform3D bbXform = new Transform3D();
+ Transform3D prevTransform = new Transform3D();
+
+ ((TransformGroupRetained) tg.retained).getTransform(prevTransform);
+
+ if (mode == ROTATE_ABOUT_AXIS ) { // rotate about axis
+ canvas.getCenterEyeInImagePlate(viewPosition);
+ canvas.getImagePlateToVworld(xform); // xform is imagePlateToLocal
+ xform.transform(viewPosition);
+
+ // get billboard's transform
+
+ // since we are using getTransform() to get the transform
+ // of the transformGroup, we need to use getLocalToVworld()
+ // to get the localToVworld which includes the static transform
+
+ ((NodeRetained)tg.retained).getLocalToVworld(xform);
+
+ xform.invert(); // xform is now vWorldToLocal
+
+ // transform the eye position into the billboard's coordinate system
+ xform.transform(viewPosition);
+
+ // eyeVec is a vector from the local origin to the eye pt in local
+ eyeVec.set(viewPosition);
+ eyeVec.normalize();
+
+ // project the eye into the rotation plane
+ status = projectToPlane(eyeVec, nAxis);
+
+ // If the first project was successful ..
+ if (status) {
+ // project the z axis into the rotation plane
+ zAxis.x = 0.0;
+ zAxis.y = 0.0;
+ zAxis.z = 1.0;
+ status = projectToPlane(zAxis, nAxis);
+ }
+
+
+ ((TransformGroupRetained) tg.retained).getTransform(xform);
+ if (status) {
+ // compute the sign of the angle by checking if the cross product
+ // of the two vectors is in the same direction as the normal axis
+ vector.cross(eyeVec, zAxis);
+ if (vector.dot(nAxis) > 0.0) {
+ sign = 1.0;
+ } else {
+ sign = -1.0;
+ }
+
+ // compute the angle between the projected eye vector and the
+ // projected z
+ double dot = eyeVec.dot(zAxis);
+
+ if (dot > 1.0f) {
+ dot = 1.0f;
+ } else if (dot < -1.0f) {
+ dot = -1.0f;
+ }
+
+ angle = sign*Math.acos(dot);
+
+ // use -angle because xform is to *undo* rotation by angle
+ aa.x = nAxis.x;
+ aa.y = nAxis.y;
+ aa.z = nAxis.z;
+ aa.angle = -angle;
+ bbXform.set(aa);
+ if( !prevTransform.epsilonEquals(bbXform, EPSILON)) {
+ // Optimization for Billboard since it use passive
+ // behavior
+ // set the transform on the Billboard TG
+ tg.setTransform(bbXform);
+ }
+ }
+ else {
+ bbXform.setIdentity();
+ if (!prevTransform.epsilonEquals(bbXform, EPSILON)) {
+ tg.setTransform(bbXform);
+ }
+ }
+
+ } else { // rotate about point
+ // Need to rotate Z axis to point to eye, and Y axis to be
+ // parallel to view platform Y axis, rotating around rotation pt
+
+ Transform3D zRotate = new Transform3D();
+
+ // get the eye point
+ canvas.getCenterEyeInImagePlate(viewPosition);
+
+ // derive the yUp point
+ yUpPoint.set(viewPosition);
+ yUpPoint.y += 0.01; // one cm in Physical space
+
+ // transform the points to the Billboard's space
+ canvas.getImagePlateToVworld(xform); // xform is ImagePlateToVworld
+
+ xform.transform(viewPosition);
+ xform.transform(yUpPoint);
+
+ // get billboard's transform
+
+ // since we are using getTransform() to get the transform
+ // of the transformGroup, we need to use getLocalToVworld()
+ // to get the localToVworld which includes the static transform
+
+ ((NodeRetained)tg.retained).getLocalToVworld(xform);
+
+ xform.invert(); // xform is vWorldToLocal
+
+ // transfom points to local coord sys
+ xform.transform(viewPosition);
+ xform.transform(yUpPoint);
+
+ // Make a vector from viewPostion to 0,0,0 in the BB coord sys
+ eyeVec.set(viewPosition);
+ eyeVec.normalize();
+
+ // create a yUp vector
+ yUp.set(yUpPoint);
+ yUp.sub(viewPosition);
+ yUp.normalize();
+
+
+ // find the plane to rotate z
+ zAxis.x = 0.0;
+ zAxis.y = 0.0;
+ zAxis.z = 1.0;
+
+ // rotation axis is cross product of eyeVec and zAxis
+ vector.cross(eyeVec, zAxis); // vector is cross product
+
+ // if cross product is non-zero, vector is rotation axis and
+ // rotation angle is acos(eyeVec.dot(zAxis)));
+ double length = vector.length();
+
+ if (length > 0.0001) {
+ double dot = eyeVec.dot(zAxis);
+
+ if (dot > 1.0f) {
+ dot = 1.0f;
+ } else if (dot < -1.0f) {
+ dot = -1.0f;
+ }
+
+ angle = Math.acos(dot);
+ aa.x = vector.x;
+ aa.y = vector.y;
+ aa.z = vector.z;
+ aa.angle = -angle;
+ zRotate.set(aa);
+ } else {
+ // no rotation needed, set to identity (scale = 1.0)
+ zRotate.set(1.0);
+ }
+
+ // Transform the yAxis by zRotate
+ yAxis.x = 0.0;
+ yAxis.y = 1.0;
+ yAxis.z = 0.0;
+ zRotate.transform(yAxis);
+
+ // project the yAxis onto the plane perp to the eyeVec
+ status = projectToPlane(yAxis, eyeVec);
+
+ if (status) {
+ // project the yUp onto the plane perp to the eyeVec
+ status = projectToPlane(yUp, eyeVec);
+ }
+
+ ((TransformGroupRetained) tg.retained).getTransform(xform);
+ if (status) {
+ // rotation angle is acos(yUp.dot(yAxis));
+ double dot = yUp.dot(yAxis);
+
+ // Fix numerical error, otherwise acos return NULL
+ if (dot > 1.0f) {
+ dot = 1.0f;
+ } else if (dot < -1.0f) {
+ dot = -1.0f;
+ }
+
+ angle = Math.acos(dot);
+
+ // check the sign by looking a the cross product vs the eyeVec
+ vector.cross(yUp, yAxis); // vector is cross product
+ if (eyeVec.dot(vector) < 0) {
+ angle *= -1;
+ }
+ aa.x = eyeVec.x;
+ aa.y = eyeVec.y;
+ aa.z = eyeVec.z;
+ aa.angle = -angle;
+
+ xform.set(aa); // xform is now yRotate
+
+ // rotate around the rotation point
+ vector.x = rotationPoint.x;
+ vector.y = rotationPoint.y;
+ vector.z = rotationPoint.z; // vector to translate to RP
+ bbXform.set(vector); // translate to RP
+ bbXform.mul(xform); // yRotate
+ bbXform.mul(zRotate); // zRotate
+ vector.scale(-1.0); // vector to translate back
+ xform.set(vector); // xform to translate back
+ bbXform.mul(xform); // translate back
+
+
+ if (!prevTransform.epsilonEquals(bbXform, EPSILON)) {
+ // set the transform on the Billboard TG
+ tg.setTransform(bbXform);
+ }
+ }
+ else {
+ bbXform.setIdentity();
+ if (!prevTransform.epsilonEquals(bbXform, EPSILON)) {
+ tg.setTransform(bbXform);
+ }
+ }
+ }
+
+ // Insert wakeup condition into queue
+ wakeupOn(wakeupFrame);
+}
+
+private boolean projectToPlane(Vector3d projVec, Vector3d planeVec) {
+ double dis = planeVec.dot(projVec);
+ projVec.x = projVec.x - planeVec.x*dis;
+ projVec.y = projVec.y - planeVec.y*dis;
+ projVec.z = projVec.z - planeVec.z*dis;
+
+ double length = projVec.length();
+
+ if (length < EPSILON) {
+ return false;
+ }
+ projVec.scale(1 / length);
+ return true;
+}
+
+ /**
+ * Creates a new instance of the node. This routine is called
+ * by
+ * alignment axis : Y-axis (0,1,0)
+ * rotation point : (0,0,1)
+ * target transform group: null
+ *cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ Billboard b = new Billboard();
+ b.duplicateNode(this, forceDuplicate);
+ return b;
+ }
+
+
+ /**
+ * Copies all Billboard information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ Billboard bb = (Billboard) originalNode;
+
+ setAlignmentMode(bb.getAlignmentMode());
+
+ Vector3f v = new Vector3f();
+ bb.getAlignmentAxis(v);
+ setAlignmentAxis(v);
+
+ Point3f p = new Point3f();
+ bb.getRotationPoint(p);
+ setRotationPoint(p);
+
+ // this will be updated by updateNodeReferences() later
+ setTarget(bb.getTarget());
+ }
+
+
+ /**
+ * Callback used to allow a node to check if any scene graph objects
+ * referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any object references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding object in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * object is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+ super.updateNodeReferences(referenceTable);
+
+ // check for new TransformGroup
+ TransformGroup g = getTarget();
+ if (g != null) {
+ setTarget((TransformGroup) referenceTable.getNewObjectReference(g));
+ }
+ }
+}
+
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BoundingBox.java b/j3d-core/src/classes/share/javax/media/j3d/BoundingBox.java
new file mode 100644
index 0000000..a87ed4c
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BoundingBox.java
@@ -0,0 +1,1955 @@
+/*
+ * $RCSfile: BoundingBox.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.10 $
+ * $Date: 2008/02/28 20:17:19 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import com.sun.j3d.internal.HashCodeUtil;
+
+/**
+ * This class defines an axis aligned bounding box which is used for
+ * bounding regions.
+ *
+ */
+
+public class BoundingBox extends Bounds {
+
+ /**
+ * The corner of the bounding box with the numerically smallest
+ * values.
+ */
+ Point3d lower;
+
+ /**
+ * The corner of the bounding box with the numerically largest
+ * values.
+ */
+ Point3d upper;
+
+ private Point3d centroid = null;
+ private static final double EPS = 1.0E-8;
+
+ // reusable temp objects
+ private BoundingSphere tmpSphere = null;
+ private BoundingBox tmpBox = null;
+ private BoundingPolytope tmpPolytope = null;
+ private Point3d tmpP3d = null;
+
+
+ /**
+ * Constructs and initializes a BoundingBox given min,max in x,y,z.
+ * @param lower the "small" corner
+ * @param upper the "large" corner
+ */
+ public BoundingBox(Point3d lower, Point3d upper) {
+ boundId = BOUNDING_BOX;
+ this.lower = new Point3d(lower);
+ this.upper = new Point3d(upper);
+ updateBoundsStates();
+ }
+
+ /**
+ * Constructs and initializes a 2X bounding box about the
+ * origin. The lower corner is initialized to (-1.0d, -1.0d, -1.0d)
+ * and the opper corner is initialized to (1.0d, 1.0d, 1.0d).
+ */
+ public BoundingBox() {
+ boundId = BOUNDING_BOX;
+ lower = new Point3d(-1.0d, -1.0d, -1.0d);
+ upper = new Point3d( 1.0d, 1.0d, 1.0d);
+ updateBoundsStates();
+ }
+
+ /**
+ * Constructs a BoundingBox from a bounding object.
+ * @param boundsObject a bounds object
+ */
+ public BoundingBox(Bounds boundsObject) {
+ int i;
+ boundId = BOUNDING_BOX;
+ if( boundsObject == null ) {
+ // Negative volume.
+ lower = new Point3d( 1.0d, 1.0d, 1.0d);
+ upper = new Point3d(-1.0d, -1.0d, -1.0d);
+ }
+ else if( boundsObject.boundsIsInfinite ) {
+ lower = new Point3d( Double.NEGATIVE_INFINITY,
+ Double.NEGATIVE_INFINITY,
+ Double.NEGATIVE_INFINITY);
+ upper = new Point3d(Double.POSITIVE_INFINITY,
+ Double.POSITIVE_INFINITY,
+ Double.POSITIVE_INFINITY);
+ }
+ else if( boundsObject.boundId == BOUNDING_BOX){
+ BoundingBox box = (BoundingBox)boundsObject;
+
+ lower = new Point3d(box.lower.x, box.lower.y, box.lower.z);
+ upper = new Point3d(box.upper.x, box.upper.y, box.upper.z);
+
+ }
+ else if( boundsObject.boundId == BOUNDING_SPHERE ) {
+ BoundingSphere sphere = (BoundingSphere)boundsObject;
+
+ lower = new Point3d(sphere.center.x-sphere.radius,
+ sphere.center.y-sphere.radius,
+ sphere.center.z-sphere.radius);
+
+ upper = new Point3d(sphere.center.x+sphere.radius,
+ sphere.center.y+sphere.radius,
+ sphere.center.z+sphere.radius);
+
+ }
+ else if(boundsObject.boundId == BOUNDING_POLYTOPE) {
+ BoundingPolytope polytope = (BoundingPolytope)boundsObject;
+ if( polytope.nVerts < 1 ) { // handle degenerate case
+ lower = new Point3d(-1.0d, -1.0d, -1.0d);
+ upper = new Point3d( 1.0d, 1.0d, 1.0d);
+ } else {
+ lower = new Point3d( polytope.verts[0].x, polytope.verts[0].y,
+ polytope.verts[0].z);
+ upper = new Point3d( polytope.verts[0].x, polytope.verts[0].y,
+ polytope.verts[0].z);
+
+ for(i=1;ibounds object is
+ * equal to this BoundingBox object. They are equal if the
+ * specified bounds object is an instance of
+ * BoundingBox and all of the data
+ * members of bounds are equal to the corresponding
+ * data members in this BoundingBox.
+ * @param bounds the object with which the comparison is made.
+ * @return true if this BoundingBox is equal to bounds;
+ * otherwise false
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean equals(Object bounds) {
+ try {
+ BoundingBox box = (BoundingBox)bounds;
+ return (lower.equals(box.lower) &&
+ upper.equals(box.upper));
+ }
+ catch (NullPointerException e) {
+ return false;
+ }
+ catch (ClassCastException e) {
+ return false;
+ }
+ }
+
+
+ /**
+ * Returns a hash code value for this BoundingBox object
+ * based on the data values in this object. Two different
+ * BoundingBox objects with identical data values (i.e.,
+ * BoundingBox.equals returns true) will return the same hash
+ * code value. Two BoundingBox objects with different data
+ * members may return the same hash code value, although this is
+ * not likely.
+ * @return a hash code value for this BoundingBox object.
+ *
+ * @since Java 3D 1.2
+ */
+ public int hashCode() {
+ long bits = 1L;
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(lower.x);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(lower.y);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(lower.z);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(upper.x);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(upper.y);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(upper.z);
+ return (int) (bits ^ (bits >> 32));
+ }
+
+
+ /**
+ * Combines this bounding box with a bounding object so that the
+ * resulting bounding box encloses the original bounding box and the
+ * specified bounds object.
+ * @param boundsObject another bounds object
+ */
+ public void combine(Bounds boundsObject) {
+
+ if((boundsObject == null) || (boundsObject.boundsIsEmpty)
+ || (boundsIsInfinite))
+ return;
+
+ if((boundsIsEmpty) || (boundsObject.boundsIsInfinite)) {
+ this.set(boundsObject);
+ return;
+ }
+
+ if( boundsObject.boundId == BOUNDING_BOX){
+ BoundingBox box = (BoundingBox)boundsObject;
+
+ if( lower.x > box.lower.x) lower.x = box.lower.x;
+ if( lower.y > box.lower.y) lower.y = box.lower.y;
+ if( lower.z > box.lower.z) lower.z = box.lower.z;
+ if( upper.x < box.upper.x) upper.x = box.upper.x;
+ if( upper.y < box.upper.y) upper.y = box.upper.y;
+ if( upper.z < box.upper.z) upper.z = box.upper.z;
+
+ }
+ else if( boundsObject.boundId == BOUNDING_SPHERE ) {
+ BoundingSphere sphere = (BoundingSphere)boundsObject;
+ if( lower.x > (sphere.center.x - sphere.radius))
+ lower.x = sphere.center.x - sphere.radius;
+ if( lower.y > (sphere.center.y - sphere.radius))
+ lower.y = sphere.center.y - sphere.radius;
+ if( lower.z > (sphere.center.z - sphere.radius))
+ lower.z = sphere.center.z - sphere.radius;
+ if( upper.x < (sphere.center.x + sphere.radius))
+ upper.x = sphere.center.x + sphere.radius;
+ if( upper.y < (sphere.center.y + sphere.radius))
+ upper.y = sphere.center.y + sphere.radius;
+ if( upper.z < (sphere.center.z + sphere.radius))
+ upper.z = sphere.center.z + sphere.radius;
+
+ }
+ else if(boundsObject.boundId == BOUNDING_POLYTOPE) {
+ BoundingPolytope polytope = (BoundingPolytope)boundsObject;
+ int i;
+ for(i=1;icloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ BoundingLeaf bl = new BoundingLeaf();
+ bl.duplicateNode(this, forceDuplicate);
+ return bl;
+ }
+
+
+
+ /**
+ * Copies all BoundingLeaf information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ ((BoundingLeafRetained) retained).initRegion(
+ ((BoundingLeafRetained) originalNode.retained).getRegion());
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BoundingLeafRetained.java b/j3d-core/src/classes/share/javax/media/j3d/BoundingLeafRetained.java
new file mode 100644
index 0000000..5a4e588
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BoundingLeafRetained.java
@@ -0,0 +1,288 @@
+/*
+ * $RCSfile: BoundingLeafRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+
+/**
+ * The BoundingLeaf node defines a bounding region object that can be
+ * referenced by other nodes to define a region of influence, an
+ * application region, or a scheduling region.
+ */
+class BoundingLeafRetained extends LeafRetained {
+ // Statics used when something in the boundingleaf changes
+ static final int REGION_CHANGED = 0x0001;
+ static final Integer REGION_CHANGED_MESSAGE = new Integer(REGION_CHANGED);
+
+ // The bounding region object defined by this node
+ Bounds region = null;
+
+
+ // For the mirror object, this region is the transformed region
+ // (the region of the original bounding leaf object transformed
+ // by the cache transform)
+ Bounds transformedRegion = null;
+
+ BoundingLeafRetained mirrorBoundingLeaf;
+
+ // A list of Objects that refer, directly or indirectly, to this
+ // bounding leaf object
+ ArrayList users = new ArrayList();
+
+ // Target threads to be notified when light changes
+ int targetThreads = J3dThread.UPDATE_RENDERING_ENVIRONMENT |
+ J3dThread.UPDATE_RENDER;
+
+
+ // Target threads for tranform change
+ int transformTargetThreads =
+ J3dThread.UPDATE_RENDERING_ENVIRONMENT | J3dThread.UPDATE_GEOMETRY;
+
+ BoundingLeafRetained() {
+ this.nodeType = NodeRetained.BOUNDINGLEAF;
+ }
+
+ void createBoundingLeaf() {
+ this.nodeType = NodeRetained.BOUNDINGLEAF;
+ mirrorBoundingLeaf = new BoundingLeafRetained();
+ }
+
+ /**
+ * Initialize the bounding region
+ */
+ void initRegion(Bounds region) {
+ if (region != null) {
+ this.region = (Bounds) region.clone();
+ }
+ else {
+ this.region = null;
+ }
+ if (staticTransform != null) {
+ this.region.transform(staticTransform.transform);
+ }
+ }
+
+ /**
+ * Set the bounding region
+ */
+ void setRegion(Bounds region) {
+ initRegion(region);
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = mirrorBoundingLeaf.targetThreads;
+ createMessage.type = J3dMessage.BOUNDINGLEAF_CHANGED;
+ createMessage.universe = universe;
+ createMessage.args[0] = this;
+ createMessage.args[1]= REGION_CHANGED_MESSAGE;
+ if (region != null) {
+ createMessage.args[2] = (Bounds)(region.clone());
+ } else {
+ createMessage.args[2] = null;
+ }
+ createMessage.args[3] = mirrorBoundingLeaf.users.toArray();
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+
+ /**
+ * Get the bounding region
+ */
+ Bounds getRegion() {
+ Bounds b = null;
+ if (this.region != null) {
+ b = (Bounds) this.region.clone();
+ if (staticTransform != null) {
+ Transform3D invTransform = staticTransform.getInvTransform();
+ b.transform(invTransform);
+ }
+ }
+ return b;
+ }
+
+
+ void setLive(SetLiveState s) {
+ super.doSetLive(s);
+
+ if (inBackgroundGroup) {
+ throw new
+ IllegalSceneGraphException(J3dI18N.getString("BoundingLeafRetained0"));
+ }
+
+ if (inSharedGroup) {
+ throw new
+ IllegalSharingException(J3dI18N.getString("BoundingLeafRetained1"));
+ }
+
+
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorBoundingLeaf,
+ Targets.BLN_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+ mirrorBoundingLeaf.localToVworld = new Transform3D[1][];
+ mirrorBoundingLeaf.localToVworldIndex = new int[1][];
+ mirrorBoundingLeaf.localToVworld[0] = this.localToVworld[0];
+ mirrorBoundingLeaf.localToVworldIndex[0] = this.localToVworldIndex[0];
+ mirrorBoundingLeaf.parent = parent;
+ if (region != null) {
+ mirrorBoundingLeaf.region = (Bounds)region.clone();
+ mirrorBoundingLeaf.transformedRegion = (Bounds)region.clone();
+ mirrorBoundingLeaf.transformedRegion.transform(
+ mirrorBoundingLeaf.getCurrentLocalToVworld());
+ } else {
+ mirrorBoundingLeaf.region = null;
+ mirrorBoundingLeaf.transformedRegion = null;
+ }
+ // process switch leaf
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorBoundingLeaf,
+ Targets.BLN_TARGETS);
+ }
+ mirrorBoundingLeaf.switchState = (SwitchState)s.switchStates.get(0);
+ super.markAsLive();
+ }
+
+
+ /** Update the "component" field of the mirror object with the
+ * given "value"
+ */
+ synchronized void updateImmediateMirrorObject(Object[] objs) {
+
+ int component = ((Integer)objs[1]).intValue();
+ Bounds b = ((Bounds)objs[2]);
+ Transform3D t;
+
+ if ((component & REGION_CHANGED) != 0) {
+ mirrorBoundingLeaf.region = b;
+ if (b != null) {
+ mirrorBoundingLeaf.transformedRegion = (Bounds)b.clone();
+ t = mirrorBoundingLeaf.getCurrentLocalToVworld();
+ mirrorBoundingLeaf.transformedRegion.transform(b, t);
+ }
+ else {
+ mirrorBoundingLeaf.transformedRegion = null;
+ }
+
+ }
+ }
+
+ /**
+ * Add a user to the list of users.
+ * There is no if (node.source.isLive()) check since
+ * mirror objects are the users of the mirror bounding leaf
+ * and they do not have a source.
+ */
+ synchronized void addUser(LeafRetained node) {
+ users.add(node);
+ if (node.nodeType == NodeRetained.BACKGROUND ||
+ node.nodeType == NodeRetained.CLIP ||
+ node.nodeType == NodeRetained.ALTERNATEAPPEARANCE ||
+ node instanceof FogRetained ||
+ node instanceof LightRetained) {
+ transformTargetThreads |= J3dThread.UPDATE_RENDER;
+ }
+ else if (node instanceof BehaviorRetained) {
+ transformTargetThreads |= J3dThread.UPDATE_BEHAVIOR;
+ targetThreads |= J3dThread.UPDATE_BEHAVIOR;
+ }
+ else if (node instanceof SoundRetained ||
+ node.nodeType == NodeRetained.SOUNDSCAPE) {
+ transformTargetThreads |= J3dThread.UPDATE_SOUND;
+ }
+
+ }
+
+ /**
+ * Remove user from the list of users.
+ * There is no if (node.source.isLive()) check since
+ * mirror objects are the users of the mirror bounding leaf
+ * and they do not have a source.
+ */
+ synchronized void removeUser(LeafRetained u) {
+ int i;
+ users.remove(users.indexOf(u));
+ // For now reconstruct the transform target threads from scratch
+ transformTargetThreads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ targetThreads = J3dThread.UPDATE_RENDERING_ENVIRONMENT |
+ J3dThread.UPDATE_RENDER;
+
+ for (i =0; i < users.size(); i++) {
+ LeafRetained node = (LeafRetained)users.get(i);
+ if (node.nodeType == NodeRetained.BACKGROUND ||
+ node.nodeType == NodeRetained.CLIP ||
+ node.nodeType == NodeRetained.ALTERNATEAPPEARANCE ||
+ node instanceof FogRetained ||
+ node instanceof LightRetained) {
+ transformTargetThreads |= J3dThread.UPDATE_RENDER;
+ }
+ else if (node.nodeType == NodeRetained.BEHAVIOR) {
+ transformTargetThreads |= J3dThread.UPDATE_BEHAVIOR;
+ targetThreads |= J3dThread.UPDATE_BEHAVIOR;
+ }
+ else if (node instanceof SoundRetained ||
+ node.nodeType == NodeRetained.SOUNDSCAPE) {
+ transformTargetThreads |= J3dThread.UPDATE_SOUND;
+ }
+ }
+ }
+
+
+ // This function is called on the mirror bounding leaf
+ void updateImmediateTransformChange() {
+ Transform3D t;
+ t = getCurrentLocalToVworld();
+ if (region != null) {
+ transformedRegion.transform(region, t);
+ }
+ }
+
+ void clearLive(SetLiveState s) {
+ super.clearLive();
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorBoundingLeaf,
+ Targets.BLN_TARGETS);
+ }
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorBoundingLeaf,
+ Targets.BLN_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+ }
+
+ void mergeTransform(TransformGroupRetained xform) {
+ super.mergeTransform(xform);
+ region.transform(xform.transform);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BoundingPolytope.java b/j3d-core/src/classes/share/javax/media/j3d/BoundingPolytope.java
new file mode 100644
index 0000000..b1618c3
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BoundingPolytope.java
@@ -0,0 +1,1759 @@
+/*
+ * $RCSfile: BoundingPolytope.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+import com.sun.j3d.internal.HashCodeUtil;
+
+/**
+ * A BoundingPolytope defines a polyhedral bounding region using the
+ * intersection of four or more half spaces. The region defined by a
+ * BoundingPolytope is always convex and must be closed.
+ *
+ * Ax + By + Cz + D <= 0
+ *
+ * where A, B, C, D are the parameters that specify the plane. The
+ * parameters are passed in the x, y, z, and w fields, respectively,
+ * of a Vector4d object. The intersection of the set of half-spaces
+ * corresponding to the planes in this BoundingPolytope defines the
+ * bounding region.
+ */
+
+public class BoundingPolytope extends Bounds {
+
+ /**
+ * An array of bounding planes.
+ */
+ Vector4d[] planes;
+ double[] mag; // magnitude of plane vector
+ double[] pDotN; // point on plane dotted with normal
+ Point3d[] verts; // vertices of polytope
+ int nVerts; // number of verts in polytope
+ Point3d centroid = new Point3d(); // centroid of polytope
+
+ Point3d boxVerts[];
+ boolean allocBoxVerts = false;
+
+ /**
+ * Constructs a BoundingPolytope using the specified planes.
+ * @param planes a set of planes defining the polytope.
+ * @exception IllegalArgumentException if the length of the
+ * specified array of planes is less than 4.
+ */
+ public BoundingPolytope(Vector4d[] planes) {
+ if (planes.length < 4) {
+ throw new IllegalArgumentException(J3dI18N.getString("BoundingPolytope11"));
+ }
+
+ boundId = BOUNDING_POLYTOPE;
+ int i;
+ double invMag;
+ this.planes = new Vector4d[planes.length];
+ mag = new double[planes.length];
+ pDotN = new double[planes.length];
+
+ for(i=0;i
+ * planes[1] : -x <= 1 (-1,0,0,-1)
+ * planes[2] : y <= 1 (0,1,0,-1)
+ * planes[3] : -y <= 1 (0,-1,0,-1)
+ * planes[4] : z <= 1 (0,0,1,-1)
+ * planes[5] : -z <= 1 (0,0,-1,-1)
+ *
+ */
+ public BoundingPolytope() {
+ boundId = BOUNDING_POLYTOPE;
+ planes = new Vector4d[6];
+ mag = new double[planes.length];
+ pDotN = new double[planes.length];
+
+ planes[0] = new Vector4d( 1.0, 0.0, 0.0, -1.0 );
+ planes[1] = new Vector4d(-1.0, 0.0, 0.0, -1.0 );
+ planes[2] = new Vector4d( 0.0, 1.0, 0.0, -1.0 );
+ planes[3] = new Vector4d( 0.0,-1.0, 0.0, -1.0 );
+ planes[4] = new Vector4d( 0.0, 0.0, 1.0, -1.0 );
+ planes[5] = new Vector4d( 0.0, 0.0,-1.0, -1.0 );
+ mag[0] = 1.0;
+ mag[1] = 1.0;
+ mag[2] = 1.0;
+ mag[3] = 1.0;
+ mag[4] = 1.0;
+ mag[5] = 1.0;
+
+ computeAllVerts(); // XXXX: lazy evaluate
+ }
+
+
+ /**
+ * Constructs a BoundingPolytope from the specified bounds object.
+ * The new polytope will circumscribe the region specified by the
+ * input bounds.
+ * @param boundsObject the bounds object from which this polytope
+ * is constructed.
+ */
+ public BoundingPolytope(Bounds boundsObject ) {
+ int i;
+
+ boundId = BOUNDING_POLYTOPE;
+
+ if( boundsObject == null ) {
+ boundsIsEmpty = true;
+ boundsIsInfinite = false;
+ initEmptyPolytope();
+ computeAllVerts(); // XXXX: lazy evaluate
+ return;
+ }
+
+ boundsIsEmpty = boundsObject.boundsIsEmpty;
+ boundsIsInfinite = boundsObject.boundsIsInfinite;
+
+ if( boundsObject.boundId == BOUNDING_SPHERE ) {
+ BoundingSphere sphere = (BoundingSphere)boundsObject;
+ planes = new Vector4d[6];
+ mag = new double[planes.length];
+ pDotN = new double[planes.length];
+
+ planes[0] = new Vector4d( 1.0, 0.0, 0.0, -(sphere.center.x+sphere.radius) );
+ planes[1] = new Vector4d(-1.0, 0.0, 0.0, sphere.center.x-sphere.radius );
+ planes[2] = new Vector4d( 0.0, 1.0, 0.0, -(sphere.center.y+sphere.radius) );
+ planes[3] = new Vector4d( 0.0,-1.0, 0.0, sphere.center.y-sphere.radius );
+ planes[4] = new Vector4d( 0.0, 0.0, 1.0, -(sphere.center.z+sphere.radius) );
+ planes[5] = new Vector4d( 0.0, 0.0,-1.0, sphere.center.z-sphere.radius );
+ mag[0] = 1.0;
+ mag[1] = 1.0;
+ mag[2] = 1.0;
+ mag[3] = 1.0;
+ mag[4] = 1.0;
+ mag[5] = 1.0;
+ computeAllVerts(); // XXXX: lazy evaluate
+
+ } else if( boundsObject.boundId == BOUNDING_BOX ){
+ BoundingBox box = (BoundingBox)boundsObject;
+ planes = new Vector4d[6];
+ pDotN = new double[planes.length];
+ mag = new double[planes.length];
+
+ planes[0] = new Vector4d( 1.0, 0.0, 0.0, -box.upper.x );
+ planes[1] = new Vector4d(-1.0, 0.0, 0.0, box.lower.x );
+ planes[2] = new Vector4d( 0.0, 1.0, 0.0, -box.upper.y );
+ planes[3] = new Vector4d( 0.0,-1.0, 0.0, box.lower.y );
+ planes[4] = new Vector4d( 0.0, 0.0, 1.0, -box.upper.z );
+ planes[5] = new Vector4d( 0.0, 0.0,-1.0, box.lower.z );
+ mag[0] = 1.0;
+ mag[1] = 1.0;
+ mag[2] = 1.0;
+ mag[3] = 1.0;
+ mag[4] = 1.0;
+ mag[5] = 1.0;
+ computeAllVerts(); // XXXX: lazy evaluate
+
+ } else if( boundsObject.boundId == BOUNDING_POLYTOPE ) {
+ BoundingPolytope polytope = (BoundingPolytope)boundsObject;
+ planes = new Vector4d[polytope.planes.length];
+ mag = new double[planes.length];
+ pDotN = new double[planes.length];
+ nVerts = polytope.nVerts;
+ verts = new Point3d[nVerts];
+ for(i=0;ibounds object is an instance of
+ * BoundingPolytope and all of the data
+ * members of bounds are equal to the corresponding
+ * data members in this BoundingPolytope.
+ * @param bounds the object with which the comparison is made.
+ * @return true if this BoundingPolytope is equal to bounds;
+ * otherwise false
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean equals(Object bounds) {
+ try {
+ BoundingPolytope polytope = (BoundingPolytope)bounds;
+ if (planes.length != polytope.planes.length)
+ return false;
+ for (int i = 0; i < planes.length; i++)
+ if (!planes[i].equals(polytope.planes[i]))
+ return false;
+
+ return true;
+ }
+ catch (NullPointerException e) {
+ return false;
+ }
+ catch (ClassCastException e) {
+ return false;
+ }
+ }
+
+
+ /**
+ * Returns a hash code value for this BoundingPolytope object
+ * based on the data values in this object. Two different
+ * BoundingPolytope objects with identical data values (i.e.,
+ * BoundingPolytope.equals returns true) will return the same hash
+ * code value. Two BoundingPolytope objects with different data
+ * members may return the same hash code value, although this is
+ * not likely.
+ * @return a hash code value for this BoundingPolytope object.
+ *
+ * @since Java 3D 1.2
+ */
+ public int hashCode() {
+ long bits = 1L;
+
+ for (int i = 0; i < planes.length; i++) {
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(planes[i].x);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(planes[i].y);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(planes[i].z);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(planes[i].w);
+ }
+
+ return (int) (bits ^ (bits >> 32));
+ }
+
+
+ /**
+ * Combines this bounding polytope with a bounding object so that the
+ * resulting bounding polytope encloses the original bounding polytope and the
+ * given bounds object.
+ * @param boundsObject another bounds object
+ */
+ public void combine(Bounds boundsObject) {
+ BoundingSphere sphere;
+
+ if((boundsObject == null) || (boundsObject.boundsIsEmpty)
+ || (boundsIsInfinite))
+ return;
+
+
+ if((boundsIsEmpty) || (boundsObject.boundsIsInfinite)) {
+ this.set(boundsObject);
+ return;
+ }
+
+ boundsIsEmpty = boundsObject.boundsIsEmpty;
+ boundsIsInfinite = boundsObject.boundsIsInfinite;
+
+ if( boundsObject.boundId == BOUNDING_SPHERE ) {
+ sphere = (BoundingSphere)boundsObject;
+ int i;
+ double dis;
+ for(i = 0; i < planes.length; i++){
+ dis = sphere.radius+ sphere.center.x*planes[i].x +
+ sphere.center.y*planes[i].y + sphere.center.z *
+ planes[i].z + planes[i].w;
+ if( dis > 0.0 ) {
+ planes[i].w += -dis;
+ }
+ }
+ } else if( boundsObject instanceof BoundingBox){
+ BoundingBox b = (BoundingBox)boundsObject;
+ if( !allocBoxVerts){
+ boxVerts = new Point3d[8];
+ for(int j=0;j<8;j++)boxVerts[j] = new Point3d();
+ allocBoxVerts = true;
+ }
+ boxVerts[0].set(b.lower.x, b.lower.y, b.lower.z );
+ boxVerts[1].set(b.lower.x, b.upper.y, b.lower.z );
+ boxVerts[2].set(b.upper.x, b.lower.y, b.lower.z );
+ boxVerts[3].set(b.upper.x, b.upper.y, b.lower.z );
+ boxVerts[4].set(b.lower.x, b.lower.y, b.upper.z );
+ boxVerts[5].set(b.lower.x, b.upper.y, b.upper.z );
+ boxVerts[6].set(b.upper.x, b.lower.y, b.upper.z );
+ boxVerts[7].set(b.upper.x, b.upper.y, b.upper.z );
+ this.combine(boxVerts);
+
+ } else if(boundsObject.boundId == BOUNDING_POLYTOPE) {
+ BoundingPolytope polytope = (BoundingPolytope)boundsObject;
+ this.combine(polytope.verts);
+ } else {
+ throw new IllegalArgumentException(J3dI18N.getString("BoundingPolytope3"));
+ }
+
+ computeAllVerts();
+ }
+
+ /**
+ * Combines this bounding polytope with an array of bounding objects so that the
+ * resulting bounding polytope encloses the original bounding polytope and the
+ * given array of bounds object.
+ * @param boundsObjects an array of bounds objects
+ */
+ public void combine(Bounds[] boundsObjects) {
+ int i=0;
+ double dis;
+
+ if( (boundsObjects == null) || (boundsObjects.length <= 0)
+ || (boundsIsInfinite))
+ return;
+
+ // find first non empty bounds object
+ while( (ibounds object is
+ * equal to this BoundingSphere object. They are equal if the
+ * specified bounds object is an instance of
+ * BoundingSphere and all of the data
+ * members of bounds are equal to the corresponding
+ * data members in this BoundingSphere.
+ * @param bounds the object with which the comparison is made.
+ * @return true if this BoundingSphere is equal to bounds;
+ * otherwise false
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean equals(Object bounds) {
+ try {
+ BoundingSphere sphere = (BoundingSphere)bounds;
+ return (center.equals(sphere.center) &&
+ radius == sphere.radius);
+ }
+ catch (NullPointerException e) {
+ return false;
+ }
+ catch (ClassCastException e) {
+ return false;
+ }
+ }
+
+
+ /**
+ * Returns a hash code value for this BoundingSphere object
+ * based on the data values in this object. Two different
+ * BoundingSphere objects with identical data values (i.e.,
+ * BoundingSphere.equals returns true) will return the same hash
+ * code value. Two BoundingSphere objects with different data
+ * members may return the same hash code value, although this is
+ * not likely.
+ * @return a hash code value for this BoundingSphere object.
+ *
+ * @since Java 3D 1.2
+ */
+ public int hashCode() {
+ long bits = 1L;
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(radius);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(center.x);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(center.y);
+ bits = 31L * bits + HashCodeUtil.doubleToLongBits(center.z);
+ return (int) (bits ^ (bits >> 32));
+ }
+
+
+ /**
+ * Combines this bounding sphere with a bounding object so that the
+ * resulting bounding sphere encloses the original bounding sphere and the
+ * given bounds object.
+ * @param boundsObject another bounds object
+ */
+ public void combine(Bounds boundsObject) {
+ double t,dis,d1,u,l,x,y,z,oldc_to_new_c;
+ BoundingSphere sphere;
+
+ if((boundsObject == null) || (boundsObject.boundsIsEmpty)
+ || (boundsIsInfinite))
+ return;
+
+ if((boundsIsEmpty) || (boundsObject.boundsIsInfinite)) {
+ this.set(boundsObject);
+ return;
+ }
+
+
+ if( boundsObject.boundId == BOUNDING_BOX){
+ BoundingBox b = (BoundingBox)boundsObject;
+
+ // start with point furthest from sphere
+ u = b.upper.x-center.x;
+ l = b.lower.x-center.x;
+ if( u*u > l*l)
+ x = b.upper.x;
+ else
+ x = b.lower.x;
+
+ u = b.upper.y-center.y;
+ l = b.lower.y-center.y;
+ if( u*u > l*l)
+ y = b.upper.y;
+ else
+ y = b.lower.y;
+
+ u = b.upper.z-center.z;
+ l = b.lower.z-center.z;
+ if( u*u > l*l)
+ z = b.upper.z;
+ else
+ z = b.lower.z;
+
+ dis = Math.sqrt( (x - center.x)*(x - center.x) +
+ (y - center.y)*(y - center.y) +
+ (z - center.z)*(z - center.z) );
+
+ if( dis > radius) {
+ radius = (dis + radius)*.5;
+ oldc_to_new_c = dis - radius;
+ center.x = (radius*center.x + oldc_to_new_c*x)/dis;
+ center.y = (radius*center.y + oldc_to_new_c*y)/dis;
+ center.z = (radius*center.z + oldc_to_new_c*z)/dis;
+ combinePoint( b.upper.x, b.upper.y, b.upper.z);
+ combinePoint( b.upper.x, b.upper.y, b.lower.z);
+ combinePoint( b.upper.x, b.lower.y, b.upper.z);
+ combinePoint( b.upper.x, b.lower.y, b.lower.z);
+ combinePoint( b.lower.x, b.upper.y, b.upper.z);
+ combinePoint( b.lower.x, b.upper.y, b.lower.z);
+ combinePoint( b.lower.x, b.lower.y, b.upper.z);
+ combinePoint( b.lower.x, b.lower.y, b.lower.z);
+ }
+ } else if( boundsObject.boundId == BOUNDING_SPHERE ) {
+ sphere = (BoundingSphere)boundsObject;
+ dis = Math.sqrt( (center.x - sphere.center.x)*
+ (center.x - sphere.center.x) +
+ (center.y - sphere.center.y)*
+ (center.y - sphere.center.y) +
+ (center.z - sphere.center.z)*
+ (center.z - sphere.center.z) );
+ if( radius > sphere.radius) {
+ if( (dis+sphere.radius) > radius) {
+ d1 = .5*(radius-sphere.radius+dis);
+ t = d1/dis;
+ radius = d1+sphere.radius;
+ center.x = sphere.center.x + (center.x-sphere.center.x)*t;
+ center.y = sphere.center.y + (center.y-sphere.center.y)*t;
+ center.z = sphere.center.z + (center.z-sphere.center.z)*t;
+ }
+ }else {
+ if( (dis+radius) <= sphere.radius) {
+ center.x = sphere.center.x;
+ center.y = sphere.center.y;
+ center.z = sphere.center.z;
+ radius = sphere.radius;
+ }else {
+ d1 = .5*(sphere.radius-radius+dis);
+ t = d1/dis;
+ radius = d1+radius;
+ center.x = center.x + (sphere.center.x-center.x)*t;
+ center.y = center.y + (sphere.center.y-center.y)*t;
+ center.z = center.z + (sphere.center.z-center.z)*t;
+ }
+ }
+
+ } else if(boundsObject.boundId == BOUNDING_POLYTOPE) {
+ BoundingPolytope polytope = (BoundingPolytope)boundsObject;
+ this.combine(polytope.verts);
+ } else {
+ throw new IllegalArgumentException(J3dI18N.getString("BoundingSphere3"));
+ }
+ updateBoundsStates();
+ }
+
+ private void combinePoint( double x, double y, double z) {
+ double dis,oldc_to_new_c;
+ dis = Math.sqrt( (x - center.x)*(x - center.x) +
+ (y - center.y)*(y - center.y) +
+ (z - center.z)*(z - center.z) );
+
+ if( dis > radius) {
+ radius = (dis + radius)*.5;
+ oldc_to_new_c = dis - radius;
+ center.x = (radius*center.x + oldc_to_new_c*x)/dis;
+ center.y = (radius*center.y + oldc_to_new_c*y)/dis;
+ center.z = (radius*center.z + oldc_to_new_c*z)/dis;
+ }
+ }
+
+ /**
+ * Combines this bounding sphere with an array of bounding objects so that the
+ * resulting bounding sphere encloses the original bounding sphere and the
+ * given array of bounds object.
+ * @param boundsObjects an array of bounds objects
+ */
+ public void combine(Bounds[] boundsObjects) {
+ BoundingSphere sphere;
+ BoundingBox b;
+ BoundingPolytope polytope;
+ double t,dis,d1,u,l,x,y,z,oldc_to_new_c;
+ int i=0;
+
+
+ if((boundsObjects == null) || (boundsObjects.length <= 0)
+ || (boundsIsInfinite))
+ return;
+
+ // find first non empty bounds object
+ while((ibounds object is
+ * equal to this Bounds object. They are equal if both the
+ * specified bounds object and this Bounds are
+ * instances of the same Bounds subclass and all of the data
+ * members of bounds are equal to the corresponding
+ * data members in this Bounds.
+ * @param bounds the object with which the comparison is made.
+ * @return true if this Bounds object is equal to bounds;
+ * otherwise false
+ *
+ * @since Java 3D 1.2
+ */
+ public abstract boolean equals(Object bounds);
+
+
+ /**
+ * Returns a hash code for this Bounds object based on the
+ * data values in this object. Two different Bounds objects of
+ * the same type with identical data values (i.e., Bounds.equals
+ * returns true) will return the same hash code. Two Bounds
+ * objects with different data members may return the same hash code
+ * value, although this is not likely.
+ * @return a hash code for this Bounds object.
+ *
+ * @since Java 3D 1.2
+ */
+ public abstract int hashCode();
+
+
+ /**
+ * Test for intersection with a ray.
+ * @param origin the starting point of the ray
+ * @param direction the direction of the ray
+ * @return true or false indicating if an intersection occured
+ */
+ public abstract boolean intersect( Point3d origin, Vector3d direction );
+
+ /**
+ * Test for intersection with a point.
+ * @param point a point defining a position in 3-space
+ * @return true or false indicating if an intersection occured
+ */
+ public abstract boolean intersect( Point3d point );
+
+ /**
+ * Test for intersection with a ray
+ * @param origin is a the starting point of the ray
+ * @param direction is the direction of the ray
+ * @param position is a point defining the location of the pick w= distance to pick
+ * @return true or false indicating if an intersection occured
+ */
+ abstract boolean intersect( Point3d origin, Vector3d direction, Point4d position );
+
+ /**
+ * Test for intersection with a point
+ * @param point is a point defining a position in 3-space
+ * @param position is a point defining the location of the pick w= distance to pick
+ * @return true or false indicating if an intersection occured
+ */
+ abstract boolean intersect( Point3d point, Point4d position);
+
+ /**
+ * Test for intersection with a segment
+ * @param start is a point defining the start of the line segment
+ * @param end is a point defining the end of the line segment
+ * @param position is a point defining the location of the pick w= distance to pick
+ * @return true or false indicating if an intersection occured
+ */
+ abstract boolean intersect( Point3d start, Point3d end, Point4d position );
+
+ /**
+ * Test for intersection with another bounds object
+ *
+ * Test for intersection with another bounds object
+ * @param boundsObject is another bounds object
+ * @return true or false indicating if an intersection occured
+ */
+ abstract boolean intersect( Bounds boundsObject, Point4d position );
+
+ /**
+ * Test for intersection with another bounds object.
+ * @param boundsObject another bounds object
+ * @return true or false indicating if an intersection occurred
+ */
+ public abstract boolean intersect( Bounds boundsObject );
+
+ /**
+ * Test for intersection with another bounds object.
+ * @param boundsObjects an array of bounding objects
+ * @return true or false indicating if an intersection occured
+ */
+ public abstract boolean intersect( Bounds[] boundsObjects );
+
+
+ /**
+ * Finds closest bounding object that intersects this bounding object.
+ * @param boundsObjects an array of bounds objects
+ * @return closest bounding object
+ */
+ public abstract Bounds closestIntersection( Bounds[] boundsObjects);
+
+ /**
+ * Returns the center of the bounds
+ * @return bounds center
+ */
+ abstract Point3d getCenter();
+
+ /**
+ * Combines this bounding object with a bounding object so that the
+ * resulting bounding object encloses the original bounding object and the
+ * given bounds object.
+ * @param boundsObject another bounds object
+ */
+ public abstract void combine( Bounds boundsObject );
+
+
+ /**
+ * Combines this bounding object with an array of bounding objects so that the
+ * resulting bounding object encloses the original bounding object and the
+ * given array of bounds object.
+ * @param boundsObjects an array of bounds objects
+ */
+ public abstract void combine( Bounds[] boundsObjects);
+
+ /**
+ * Combines this bounding object with a point.
+ * @param point a 3d point in space
+ */
+ public abstract void combine( Point3d point);
+
+ /**
+ * Combines this bounding object with an array of points.
+ * @param points an array of 3d points in space
+ */
+ public abstract void combine( Point3d[] points);
+
+ /**
+ * Transforms this bounding object by the given matrix.
+ * @param trans the transformation matrix
+ */
+ public abstract void transform(Transform3D trans);
+
+ /**
+ * Modifies the bounding object so that it bounds the volume
+ * generated by transforming the given bounding object.
+ * @param bounds the bounding object to be transformed
+ * @param trans the transformation matrix
+ */
+ public abstract void transform( Bounds bounds, Transform3D trans);
+
+ /**
+ * Tests whether the bounds is empty. A bounds is
+ * empty if it is null (either by construction or as the result of
+ * a null intersection) or if its volume is negative. A bounds
+ * with a volume of zero is not empty.
+ * @return true if the bounds is empty; otherwise, it returns false
+ */
+ public abstract boolean isEmpty();
+
+ /**
+ * Sets the value of this Bounds object.
+ * @param boundsObject another bounds object.
+ */
+ public abstract void set( Bounds boundsObject);
+
+
+ abstract Bounds copy(Bounds region);
+
+
+ private void test_point(Vector4d[] planes, Point3d new_point) {
+ for (int i = 0; i < planes.length; i++){
+ double dist = (new_point.x*planes[i].x + new_point.y*planes[i].y +
+ new_point.z*planes[i].z + planes[i].w ) ;
+ if (dist > EPSILON ){
+ System.err.println("new point is outside of" +
+ " plane["+i+"] dist = " + dist);
+ }
+ }
+ }
+
+ /**
+ * computes the closest point from the given point to a set of planes
+ * (polytope)
+ * @param g the point
+ * @param planes array of bounding planes
+ * @param new_point point on planes closest g
+ */
+ boolean closest_point( Point3d g, Vector4d[] planes, Point3d new_point ) {
+
+ double t,s,dist,w;
+ boolean converged, inside, firstPoint, firstInside;
+ int i,count;
+ double ab,ac,bc,ad,bd,cd,aa,bb,cc;
+ double b1,b2,b3,d1,d2,d3,y1,y2,y3;
+ double h11,h12,h13,h22,h23,h33;
+ double l12,l13,l23;
+ Point3d n = new Point3d();
+ Point3d p = new Point3d();
+ Vector3d delta = null;
+
+ // These are temporary until the solve code is working
+
+
+ /*
+ * The algorithm:
+ * We want to find the point "n", closest to "g", while still within
+ * the the polytope defined by "planes". We find the solution by
+ * minimizing the value for a "penalty function";
+ *
+ * f = distance(n,g)^2 + sum for each i: w(distance(n, planes[i]))
+ *
+ * Where "w" is a weighting which indicates how much more important
+ * it is to be close to the planes than it is to be close to "g".
+ *
+ * We minimize this function by taking it's derivitive, and then
+ * solving for the value of n when the derivitive equals 0.
+ *
+ * For the 1D case with a single plane (a,b,c,d), x = n.x and g = g.x,
+ * this looks like:
+ *
+ * f(x) = (x - g) ^ 2 + w(ax + d)^2
+ * f'(x) = 2x -2g + 2waax + 2wad
+ *
+ * (note aa = a^2) setting f'(x) = 0 gives:
+ *
+ * (1 + waa)x = g - wad
+ *
+ * Note that the solution is just outside the plane [a, d]. With the
+ * correct choice of w, this should be inside of the EPSILON tolerance
+ * outside the planes.
+ *
+ * Extending to 3D gives the matrix solution:
+ *
+ * | (1 + waa) wab wac |
+ * H = | wab (1 + wbb) wbc |
+ * | wac wbc (1 + wcc) |
+ *
+ * b = [g.x - wad, g.y - wbd, g.z - wcd]
+ *
+ * H * n = b
+ *
+ * n = b * H.inverse()
+ *
+ * The implementation speeds this process up by recognizing that
+ * H is symmetric, so that it can be decomposed into three matrices:
+ *
+ * H = L * D * L.transpose()
+ *
+ * 1.0 0.0 0.0 d1 0.0 0.0
+ * L = l12 1.0 0.0 D = 0.0 d2 0.0
+ * l13 l23 1.0 0.0 0.0 d3
+ *
+ * n can then be derived by back-substitution, where the original
+ * problem is decomposed as:
+ *
+ * H * n = b
+ * L * D * L.transpose() * n = b
+ * L * D * y = b; L.transpose() * n = y
+ *
+ * We can then multiply out the terms of L * D and solve for y, and
+ * then use y to solve for n.
+ */
+
+ w=100.0 / EPSILON; // must be large enough to ensure that solution
+ // is within EPSILON of planes
+
+ count = 0;
+ p.set(g);
+
+ if (debug) {
+ System.err.println("closest_point():\nincoming g="+" "+g.x+" "+g.y+
+ " "+g.z);
+ }
+
+ converged = false;
+ firstPoint = true;
+ firstInside = false;
+
+ Vector4d pln;
+
+ while( !converged ) {
+ if (debug) {
+ System.err.println("start: p="+" "+p.x+" "+p.y+" "+p.z);
+ }
+
+ // test the current point against the planes, for each
+ // plane that is violated, add it's contribution to the
+ // penalty function
+ inside = true;
+ aa=0.0; bb=0.0; cc=0.0;
+ ab=0.0; ac=0.0; bc=0.0; ad=0.0; bd=0.0; cd=0.0;
+ for(i = 0; i < planes.length; i++){
+ pln = planes[i];
+ dist = (p.x*pln.x + p.y*pln.y +
+ p.z*pln.z + pln.w ) ;
+ // if point is outside or within EPSILON of the boundary, add
+ // the plane to the penalty matrix. We do this even if the
+ // point is already inside the polytope to prevent numerical
+ // instablity in cases where the point is just outside the
+ // boundary of several planes of the polytope
+ if (dist > -EPSILON ){
+ aa = aa + pln.x * pln.x;
+ bb = bb + pln.y * pln.y;
+ cc = cc + pln.z * pln.z;
+ ab = ab + pln.x * pln.y;
+ ac = ac + pln.x * pln.z;
+ bc = bc + pln.y * pln.z;
+ ad = ad + pln.x * pln.w;
+ bd = bd + pln.y * pln.w;
+ cd = cd + pln.z * pln.w;
+ }
+ // If the point is inside if dist is <= EPSILON
+ if (dist > EPSILON ){
+ inside = false;
+ if (debug) {
+ System.err.println("point outside plane["+i+"]=("+
+ pln.x+ ","+pln.y+",\n\t"+pln.z+
+ ","+ pln.w+")\ndist = " + dist);
+ }
+ }
+ }
+ // see if we are done
+ if (inside) {
+ if (debug) {
+ System.err.println("p is inside");
+ }
+ if (firstPoint) {
+ firstInside = true;
+ }
+ new_point.set(p);
+ converged = true;
+ } else { // solve for a closer point
+ firstPoint = false;
+
+ // this is the upper right corner of H, which is all we
+ // need to do the decomposition since the matrix is symetric
+ h11 = 1.0 + aa * w;
+ h12 = ab * w;
+ h13 = ac * w;
+ h22 = 1.0 + bb * w;
+ h23 = bc * w;
+ h33 = 1.0 + cc * w;
+
+ if (debug) {
+ System.err.println(" hessin= ");
+ System.err.println(h11+" "+h12+" "+h13);
+ System.err.println(" "+h22+" "+h23);
+ System.err.println(" "+h33);
+ }
+
+ // these are the constant terms
+ b1 = g.x - w * ad;
+ b2 = g.y - w * bd;
+ b3 = g.z - w * cd;
+
+ if (debug) {
+ System.err.println(" b1,b2,b3 = "+b1+" "+b2+" " +b3);
+ }
+
+ // solve, d1, d2, d3 actually 1/dx, which is more useful
+ d1 = 1/h11;
+ l12 = d1 * h12;
+ l13 = d1 * h13;
+ s = h22-l12*h12;
+ d2 = 1/s;
+ t = h23-h12*l13;
+ l23 = d2 * t;
+ d3 = 1/(h33 - h13*l13 - t*l23);
+
+ if (debug) {
+ System.err.println(" l12,l13,l23 "+l12+" "+l13+" "+l23);
+ System.err.println(" d1,d2,d3 "+ d1+" "+d2+" "+d3);
+ }
+
+ // we have L and D, now solve for y
+ y1 = d1 * b1;
+ y2 = d2 * (b2 - h12*y1);
+ y3 = d3 * (b3 - h13*y1 - t*y2);
+
+ if (debug) {
+ System.err.println(" y1,y2,y3 = "+y1+" "+y2+" "+y3);
+ }
+
+ // we have y, solve for n
+ n.z = y3;
+ n.y = (y2 - l23*n.z);
+ n.x = (y1 - l13*n.z - l12*n.y);
+
+ if (debug) {
+ System.err.println("new point = " + n.x+" " + n.y+" " +
+ n.z);
+ test_point(planes, n);
+
+ if (delta == null) delta = new Vector3d();
+ delta.sub(n, p);
+ delta.normalize();
+ System.err.println("p->n direction: " + delta);
+ Matrix3d hMatrix = new Matrix3d();
+ // check using the the javax.vecmath routine
+ hMatrix.m00 = h11;
+ hMatrix.m01 = h12;
+ hMatrix.m02 = h13;
+ hMatrix.m10 = h12; // h21 = h12
+ hMatrix.m11 = h22;
+ hMatrix.m12 = h23;
+ hMatrix.m20 = h13; // h31 = h13
+ hMatrix.m21 = h23; // h32 = h22
+ hMatrix.m22 = h33;
+ hMatrix.invert();
+ Point3d check = new Point3d(b1, b2, b3);
+ hMatrix.transform(check);
+
+ System.err.println("check point = " + check.x+" " +
+ check.y+" " + check.z);
+ }
+
+ // see if we have converged yet
+ dist = (p.x-n.x)*(p.x-n.x) + (p.y-n.y)*(p.y-n.y) +
+ (p.z-n.z)*(p.z-n.z);
+
+ if (debug) {
+ System.err.println("p->n distance =" + dist );
+ }
+
+ if( dist < EPSILON) { // close enough
+ converged = true;
+ new_point.set(n);
+ } else {
+ p.set(n);
+ count++;
+ if(count > 4 ){ // watch for cycling between two minimums
+ new_point.set(n);
+ converged = true;
+ }
+ }
+ }
+ }
+ if (debug) {
+ System.err.println("returning pnt ("+new_point.x+" "+
+ new_point.y+" "+new_point.z+")");
+
+ if(firstInside) System.err.println("input point inside polytope ");
+ }
+ return firstInside;
+ }
+
+ boolean intersect_ptope_sphere( BoundingPolytope polyTope,
+ BoundingSphere sphere) {
+ Point3d p = new Point3d();
+ boolean inside;
+
+
+ if (debug) {
+ System.err.println("ptope_sphere intersect sphere ="+sphere);
+ }
+ inside = closest_point( sphere.center, polyTope.planes, p );
+ if (debug) {
+ System.err.println("ptope sphere intersect point ="+p);
+ }
+ if (!inside){
+ // if distance between polytope and sphere center is greater than
+ // radius then no intersection
+ if (p.distanceSquared( sphere.center) >
+ sphere.radius*sphere.radius){
+ if (debug) {
+ System.err.println("ptope_sphere returns false");
+ }
+ return false;
+ } else {
+ if (debug) {
+ System.err.println("ptope_sphere returns true");
+ }
+ return true;
+ }
+ } else {
+ if (debug) {
+ System.err.println("ptope_sphere returns true");
+ }
+ return true;
+ }
+ }
+
+ boolean intersect_ptope_abox( BoundingPolytope polyTope, BoundingBox box) {
+ Vector4d planes[] = new Vector4d[6];
+
+ if (debug) {
+ System.err.println("ptope_abox, box = " + box);
+ }
+ planes[0] = new Vector4d( -1.0, 0.0, 0.0, box.lower.x);
+ planes[1] = new Vector4d( 1.0, 0.0, 0.0,-box.upper.x);
+ planes[2] = new Vector4d( 0.0,-1.0, 0.0, box.lower.y);
+ planes[3] = new Vector4d( 0.0, 1.0, 0.0,-box.upper.y);
+ planes[4] = new Vector4d( 0.0, 0.0,-1.0, box.lower.z);
+ planes[5] = new Vector4d( 0.0, 0.0, 1.0,-box.upper.z);
+
+
+ BoundingPolytope pbox = new BoundingPolytope( planes);
+
+ boolean result = intersect_ptope_ptope( polyTope, pbox );
+ if (debug) {
+ System.err.println("ptope_abox returns " + result);
+ }
+ return(result);
+ }
+
+
+ boolean intersect_ptope_ptope( BoundingPolytope poly1,
+ BoundingPolytope poly2) {
+ boolean intersect;
+ Point3d p = new Point3d();
+ Point3d g = new Point3d();
+ Point3d gnew = new Point3d();
+ Point3d pnew = new Point3d();
+
+ intersect = false;
+
+ p.x = 0.0;
+ p.y = 0.0;
+ p.z = 0.0;
+
+ // start from an arbitrary point on poly1
+ closest_point( p, poly1.planes, g);
+
+ // get the closest points on each polytope
+ if (debug) {
+ System.err.println("ptope_ptope: first g = "+g);
+ }
+ intersect = closest_point( g, poly2.planes, p);
+
+ if (intersect) {
+ return true;
+ }
+
+ if (debug) {
+ System.err.println("first p = "+p+"\n");
+ }
+ intersect = closest_point( p, poly1.planes, gnew);
+ if (debug) {
+ System.err.println("gnew = "+gnew+" intersect="+intersect);
+ }
+
+ // loop until the closest points on the two polytopes are not changing
+
+ double prevDist = p.distanceSquared(g);
+ double dist;
+
+ while( !intersect ) {
+
+ dist = p.distanceSquared(gnew);
+
+ if (dist < prevDist) {
+ g.set(gnew);
+ intersect = closest_point( g, poly2.planes, pnew );
+ if (debug) {
+ System.err.println("pnew = "+pnew+" intersect="+intersect);
+ }
+ } else {
+ g.set(gnew);
+ break;
+ }
+ prevDist = dist;
+ dist = pnew.distanceSquared(g);
+
+ if (dist < prevDist) {
+ p.set(pnew);
+ if( !intersect ) {
+ intersect = closest_point( p, poly1.planes, gnew );
+ if (debug) {
+ System.err.println("gnew = "+gnew+" intersect="+
+ intersect);
+ }
+ }
+ } else {
+ p.set(pnew);
+ break;
+ }
+ prevDist = dist;
+ }
+
+ if (debug) {
+ System.err.println("gnew="+" "+gnew.x+" "+gnew.y+" "+gnew.z);
+ System.err.println("pnew="+" "+pnew.x+" "+pnew.y+" "+pnew.z);
+ }
+ return intersect;
+ }
+
+
+ synchronized void setWithLock(Bounds b) {
+ this.set(b);
+ }
+
+ synchronized void getWithLock(Bounds b) {
+ b.set(this);
+ }
+
+ // Return one of Pick Bounds type define in PickShape
+ abstract int getPickType();
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BranchGroup.java b/j3d-core/src/classes/share/javax/media/j3d/BranchGroup.java
new file mode 100644
index 0000000..6b97205
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BranchGroup.java
@@ -0,0 +1,583 @@
+/*
+ * $RCSfile: BranchGroup.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+/**
+ * The BranchGroup serves as a pointer to the root of a
+ * scene graph branch; BranchGroup objects are the only objects that
+ * can be inserted into a Locale's set of objects. A subgraph, rooted
+ * by a BranchGroup node can be thought of as a compile unit. The
+ * following things may be done with BranchGroup:
+ *
+ *
+ * Note that that if a BranchGroup is included in another subgraph, as a child of
+ * some other group node, it may not be attached to a Locale.
+ */
+
+public class BranchGroup extends Group {
+
+ /**
+ * For BranchGroup nodes, specifies that this BranchGroup allows detaching
+ * from its parent.
+ */
+ public static final int
+ ALLOW_DETACH = CapabilityBits.BRANCH_GROUP_ALLOW_DETACH;
+
+ /**
+ * Constructs and initializes a new BranchGroup node object.
+ */
+ public BranchGroup() {
+ }
+
+ /**
+ * Creates the retained mode BranchGroupRetained object that this
+ * BranchGroup component object will point to.
+ */
+ void createRetained() {
+ this.retained = new BranchGroupRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * Compiles the source BranchGroup associated with this object and
+ * creates and caches a compiled scene graph.
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ * @exception RestrictedAccessException if the method is called
+ * when this object is part of a live scene graph.
+ */
+ public void compile() {
+ if (isLive()) {
+ throw new RestrictedAccessException(
+ J3dI18N.getString("BranchGroup0"));
+ }
+
+ if (isCompiled() == false) {
+ // will throw SceneGraphCycleException if there is a cycle
+ // in the scene graph
+ checkForCycle();
+
+ ((BranchGroupRetained)this.retained).compile();
+ }
+ }
+
+ /**
+ * Detaches this BranchGroup from its parent.
+ */
+ public void detach() {
+ Group parent;
+
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_DETACH))
+ throw new CapabilityNotSetException(J3dI18N.getString("BranchGroup1"));
+
+ if (((BranchGroupRetained)this.retained).parent != null) {
+ parent = (Group)((BranchGroupRetained)this.retained).parent.source;
+ if(!parent.getCapability(Group.ALLOW_CHILDREN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("BranchGroup2"));
+ }
+ }
+
+ ((BranchGroupRetained)this.retained).detach();
+ }
+
+
+ void validateModeFlagAndPickShape(int mode, int flags, PickShape pickShape) {
+
+ if(isLive()==false) {
+ throw new IllegalStateException(J3dI18N.getString("BranchGroup3"));
+ }
+
+ if((mode != PickInfo.PICK_BOUNDS) && (mode != PickInfo.PICK_GEOMETRY)) {
+
+ throw new IllegalArgumentException(J3dI18N.getString("BranchGroup4"));
+ }
+
+ if((pickShape instanceof PickPoint) && (mode == PickInfo.PICK_GEOMETRY)) {
+ throw new IllegalArgumentException(J3dI18N.getString("BranchGroup5"));
+ }
+
+ if(((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) &&
+ ((flags & PickInfo.ALL_GEOM_INFO) != 0)) {
+ throw new IllegalArgumentException(J3dI18N.getString("BranchGroup6"));
+ }
+
+ if((mode == PickInfo.PICK_BOUNDS) &&
+ (((flags & (PickInfo.CLOSEST_GEOM_INFO |
+ PickInfo.ALL_GEOM_INFO |
+ PickInfo.CLOSEST_DISTANCE |
+ PickInfo.CLOSEST_INTERSECTION_POINT)) != 0))) {
+
+ throw new IllegalArgumentException(J3dI18N.getString("BranchGroup7"));
+ }
+
+ if((pickShape instanceof PickBounds) &&
+ (((flags & (PickInfo.CLOSEST_GEOM_INFO |
+ PickInfo.ALL_GEOM_INFO |
+ PickInfo.CLOSEST_DISTANCE |
+ PickInfo.CLOSEST_INTERSECTION_POINT)) != 0))) {
+
+ throw new IllegalArgumentException(J3dI18N.getString("BranchGroup8"));
+ }
+
+ }
+
+ /**
+ * Returns an array referencing all the items that are pickable below this
+ * BranchGroup that intersect with PickShape.
+ * The resultant array is unordered.
+ *
+ * @param pickShape the PickShape object
+ *
+ * @see SceneGraphPath
+ * @see Locale#pickAll
+ * @see PickShape
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ */
+ public SceneGraphPath[] pickAll( PickShape pickShape ) {
+
+ if(isLive()==false)
+ throw new IllegalStateException(J3dI18N.getString("BranchGroup3"));
+
+ return ((BranchGroupRetained)this.retained).pickAll(pickShape);
+
+ }
+
+ /**
+ * Returns an array unsorted references to all the PickInfo objects that are
+ * pickable below this BranchGroup that intersect with PickShape.
+ * The accuracy of the pick is set by the pick mode. The mode include :
+ * PickInfo.PICK_BOUNDS and PickInfo.PICK_GEOMETRY. The amount of information returned
+ * is specified via a masked variable, flags, indicating which components are
+ * present in each returned PickInfo object.
+ *
+ * @param mode picking mode, one of PickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see Locale#pickAll(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+
+ public PickInfo[] pickAll( int mode, int flags, PickShape pickShape ) {
+
+ validateModeFlagAndPickShape(mode, flags, pickShape);
+ return ((BranchGroupRetained)this.retained).pickAll(mode, flags, pickShape);
+
+ }
+
+
+ /**
+ * Returns a sorted array of references to all the Pickable items that
+ * intersect with the pickShape. Element [0] references the item closest
+ * to origin of PickShape successive array elements are further
+ * from the origin
+ *
+ * Note: If pickShape is of type PickBounds, the resulting array
+ * is unordered.
+ * @param pickShape the PickShape object
+ *
+ * @see SceneGraphPath
+ * @see Locale#pickAllSorted
+ * @see PickShape
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ */
+ public SceneGraphPath[] pickAllSorted( PickShape pickShape ) {
+
+ if(isLive()==false)
+ throw new IllegalStateException(J3dI18N.getString("BranchGroup3"));
+
+ return ((BranchGroupRetained)this.retained).pickAllSorted(pickShape);
+
+ }
+
+
+ /**
+ * Returns a sorted array of PickInfo references to all the pickable
+ * items that intersect with the pickShape. Element [0] references
+ * the item closest to origin of PickShape successive array
+ * elements are further from the origin
+ * The accuracy of the pick is set by the pick mode. The mode include :
+ * PickInfo.PICK_BOUNDS and PickInfo.PICK_GEOMETRY. The amount of information returned
+ * is specified via a masked variable, flags, indicating which components are
+ * present in each returned PickInfo object.
+ *
+ * @param mode picking mode, one of PickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see Locale#pickAllSorted(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+ public PickInfo[] pickAllSorted( int mode, int flags, PickShape pickShape ) {
+
+ validateModeFlagAndPickShape(mode, flags, pickShape);
+ return ((BranchGroupRetained)this.retained).pickAllSorted(mode, flags, pickShape);
+
+ }
+
+ /**
+ * Returns a SceneGraphPath that references the pickable item
+ * closest to the origin of pickShape.
+ *
+ * Note: If pickShape is of type PickBounds, the return is any pickable node
+ * below this BranchGroup.
+ * @param pickShape the PickShape object
+ *
+ * @see SceneGraphPath
+ * @see Locale#pickClosest
+ * @see PickShape
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ */
+ public SceneGraphPath pickClosest( PickShape pickShape ) {
+
+ if(isLive()==false)
+ throw new IllegalStateException(J3dI18N.getString("BranchGroup3"));
+
+ return ((BranchGroupRetained)this.retained).pickClosest(pickShape);
+
+ }
+
+ /**
+ * Returns a PickInfo which references the pickable item
+ * which is closest to the origin of pickShape.
+ * The accuracy of the pick is set by the pick mode. The mode include :
+ * PickInfo.PICK_BOUNDS and PickInfo.PICK_GEOMETRY. The amount of information returned
+ * is specified via a masked variable, flags, indicating which components are
+ * present in each returned PickInfo object.
+ *
+ * @param mode picking mode, one of PickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see Locale#pickClosest(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+ public PickInfo pickClosest( int mode, int flags, PickShape pickShape ) {
+
+ validateModeFlagAndPickShape(mode, flags, pickShape);
+ return ((BranchGroupRetained)this.retained).pickClosest(mode, flags, pickShape);
+
+ }
+
+
+ /**
+ * Returns a reference to any item that is Pickable below this BranchGroup that
+ * intersects with pickShape.
+ * @param pickShape the PickShape object
+ *
+ * @see SceneGraphPath
+ * @see Locale#pickAny
+ * @see PickShape
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ */
+ public SceneGraphPath pickAny( PickShape pickShape ) {
+
+ if(isLive()==false)
+ throw new IllegalStateException(J3dI18N.getString("BranchGroup3"));
+
+ return ((BranchGroupRetained)this.retained).pickAny(pickShape);
+
+ }
+
+ /**
+ * Returns a PickInfo which references the pickable item below this
+ * BranchGroup that intersects with pickShape.
+ * The accuracy of the pick is set by the pick mode. The mode include :
+ * PickInfo.PICK_BOUNDS and PickInfo.PICK_GEOMETRY. The amount of information returned
+ * is specified via a masked variable, flags, indicating which components are
+ * present in each returned PickInfo object.
+ *
+ * @param mode picking mode, one of PickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if BranchGroup is not live.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see Locale#pickAny(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+ public PickInfo pickAny( int mode, int flags, PickShape pickShape ) {
+
+ validateModeFlagAndPickShape(mode, flags, pickShape);
+ return ((BranchGroupRetained)this.retained).pickAny(mode, flags, pickShape);
+
+ }
+
+ /**
+ * Creates a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+
+ BranchGroup bg = new BranchGroup();
+ bg.duplicateNode(this, forceDuplicate);
+ return bg;
+
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/BranchGroupRetained.java b/j3d-core/src/classes/share/javax/media/j3d/BranchGroupRetained.java
new file mode 100644
index 0000000..ebe55eb
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/BranchGroupRetained.java
@@ -0,0 +1,378 @@
+/*
+ * $RCSfile: BranchGroupRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.10 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.*;
+
+/**
+ * The BranchGroup node provides the ability to insert a branch of
+ * a scene graph into the virtual world.
+ */
+
+class BranchGroupRetained extends GroupRetained {
+
+ // This boolean is used in a moveTo operation to get transforms to update
+ boolean isDirty = false;
+
+ // This boolean is used when the BG is inserted into the scene
+ boolean isNew = false;
+
+ /**
+ * True, if this branchGroup is directly attached to the locale
+ */
+ boolean attachedToLocale = false;
+
+
+ BranchGroupRetained() {
+ this.nodeType = NodeRetained.BRANCHGROUP;
+ }
+
+ /**
+ * This sets the current locale.
+ */
+ void setLocale(Locale loc) {
+ locale = loc;
+ }
+
+ /**
+ * This gets the current locale
+ */
+ Locale getLocale() {
+ return locale;
+ }
+
+ /**
+ * Detaches this BranchGroup from its parent.
+ */
+ void detach() {
+ dirtyBoundsCache();
+ if (universe != null) {
+ universe.resetWaitMCFlag();
+ synchronized (universe.sceneGraphLock) {
+ boolean isLive = source.isLive();
+ if (isLive) {
+ notifySceneGraphChanged(true);
+ }
+ GroupRetained oldParent = (GroupRetained)parent;
+ do_detach();
+ universe.setLiveState.clear();
+ if (isLive) {
+ if (oldParent==null) {
+ universe.notifyStructureChangeListeners(false,locale,(BranchGroup)this.source);
+ } else {
+ universe.notifyStructureChangeListeners(false,oldParent.source, (BranchGroup)this.source);
+ }
+ }
+ }
+ universe.waitForMC();
+ } else { // Not live yet, just do it.
+ this.do_detach();
+ if (universe != null) {
+ synchronized (universe.sceneGraphLock) {
+ universe.setLiveState.clear();
+ }
+ }
+ }
+ }
+
+ // The method that does the work once the lock is acquired.
+ void do_detach() {
+ if (attachedToLocale) {
+ locale.doRemoveBranchGraph((BranchGroup)this.source, null, 0);
+ } else if (parent != null) {
+ GroupRetained g = (GroupRetained)parent;
+ g.doRemoveChild(g.children.indexOf(this), null, 0);
+ }
+ }
+
+ void setNodeData(SetLiveState s) {
+ // super.setNodeData will set branchGroupPaths
+ // based on s.parentBranchGroupPaths, we need to
+ // set it earlier in order to undo the effect.
+ s.parentBranchGroupPaths = branchGroupPaths;
+
+ super.setNodeData(s);
+
+ if (!inSharedGroup) {
+ setAuxData(s, 0, 0);
+ } else {
+ // For inSharedGroup case.
+ int j, hkIndex;
+ for(j=0; jrenderOffScreenBuffer method. Off-screen Canvas3Ds
+ * are single buffered. However, on many systems, the actual
+ * rendering is done to an off-screen hardware buffer or to a 3D
+ * library-specific buffer and only copied to the off-screen buffer of
+ * the Canvas when the rendering is complete, at "buffer swap" time.
+ * Off-screen Canvas3Ds are monoscopic.
+ * stopRenderer method, prior to adding the
+ * Canvas3D object to an active View object (that is, one that is
+ * attached to a live ViewPlatform object).
+ *
+ *
+ *
+ * getGraphicsContext3D retrieves the immediate-mode
+ * 3D graphics context associated with this Canvas3D. It creates a
+ * new graphics context if one does not already exist.
+ * getGraphics2D retrieves the
+ * 2D graphics object associated with this Canvas3D. It creates a
+ * new 2D graphics object if one does not already exist.
+ * swap synchronizes and swaps buffers on a
+ * double-buffered canvas for this Canvas3D object. This method
+ * should only be called if the Java 3D renderer has been stopped.
+ * In the normal case, the renderer automatically swaps
+ * the buffer.
+ *
+ *
+ * preRender called by the Java 3D rendering loop after
+ * clearing the canvas and before any rendering has been done for
+ * this frame.
+ * postRender called by the Java 3D rendering loop after
+ * completing all rendering to the canvas for this frame and before
+ * the buffer swap.
+ * postSwap called by the Java 3D rendering loop after
+ * completing all rendering to the canvas, and all other canvases
+ * associated with this view, for this frame following the
+ * buffer swap.
+ * renderField called by the Java 3D rendering loop
+ * during the execution of the rendering loop. It is called once
+ * for each field (i.e., once per frame on a mono system or once
+ * each for the right eye and left eye on a two-pass stereo system.
+ *
+ * clear canvas (both eyes)
+ * call preRender() // user-supplied method
+ * set left eye view
+ * render opaque scene graph objects
+ * call renderField(FIELD_LEFT) // user-supplied method
+ * render transparent scene graph objects
+ * set right eye view
+ * render opaque scene graph objects again
+ * call renderField(FIELD_RIGHT) // user-supplied method
+ * render transparent scene graph objects again
+ * call postRender() // user-supplied method
+ * synchronize and swap buffers
+ * call postSwap() // user-supplied method
+ *
+ *
+ * clear canvas
+ * call preRender() // user-supplied method
+ * set view
+ * render opaque scene graph objects
+ * call renderField(FIELD_ALL) // user-supplied method
+ * render transparent scene graph objects
+ * call postRender() // user-supplied method
+ * synchronize and swap buffers
+ * call postSwap() // user-supplied method
+ *
+ *
+ * left manual eye in image plate : (0.142, 0.135, 0.4572)
+ *
+ * @param graphicsConfiguration a valid GraphicsConfiguration object that
+ * will be used to create the canvas. This object should not be null and
+ * should be created using a GraphicsConfigTemplate3D or the
+ * getPreferredConfiguration() method of the SimpleUniverse utility. For
+ * backward compatibility with earlier versions of Java 3D, a null or
+ * default GraphicsConfiguration will still work when used to create a
+ * Canvas3D on the default screen, but an error message will be printed.
+ * A NullPointerException or IllegalArgumentException will be thrown in a
+ * subsequent release.
+ *
+ * @exception IllegalArgumentException if the specified
+ * GraphicsConfiguration does not support 3D rendering
+ */
+ public Canvas3D(GraphicsConfiguration graphicsConfiguration) {
+ this(null, checkForValidGraphicsConfig(graphicsConfiguration, false), false);
+ }
+
+ /**
+ * Constructs and initializes a new Canvas3D object that Java 3D
+ * can render into.
+ *
+ * @param graphicsConfiguration a valid GraphicsConfiguration object
+ * that will be used to create the canvas. This must be created either
+ * with a GraphicsConfigTemplate3D or by using the
+ * getPreferredConfiguration() method of the SimpleUniverse utility.
+ *
+ * @param offScreen a flag that indicates whether this canvas is
+ * an off-screen 3D rendering canvas. Note that if offScreen
+ * is set to true, this Canvas3D object cannot be used for normal
+ * rendering; it should not be added to any Container object.
+ *
+ * @exception NullPointerException if the GraphicsConfiguration
+ * is null.
+ *
+ * @exception IllegalArgumentException if the specified
+ * GraphicsConfiguration does not support 3D rendering
+ *
+ * @since Java 3D 1.2
+ */
+ public Canvas3D(GraphicsConfiguration graphicsConfiguration, boolean offScreen) {
+ this(null, checkForValidGraphicsConfig(graphicsConfiguration, offScreen), offScreen);
+ }
+
+ // Private constructor only called by the two public constructors after
+ // they have validated the graphics config (and possibly constructed a new
+ // default config).
+ // The graphics config must be valid, unique, and non-null.
+ private Canvas3D(Object dummyObj1,
+ GraphicsConfiguration graphicsConfiguration,
+ boolean offScreen) {
+ this(dummyObj1,
+ graphicsConfiguration,
+ getGraphicsConfig(graphicsConfiguration),
+ offScreen);
+ }
+
+ // Private constructor only called by the previous private constructor.
+ // The graphicsConfiguration parameter is used by Canvas3D to lookup the
+ // graphics device and graphics template. The graphicsConfiguration2
+ // parameter is generated by the Pipeline from graphicsConfiguration and
+ // is only used to initialize the java.awt.Canvas.
+ private Canvas3D(Object dummyObj1,
+ GraphicsConfiguration graphicsConfiguration,
+ GraphicsConfiguration graphicsConfiguration2,
+ boolean offScreen) {
+
+ super(graphicsConfiguration2);
+
+ this.offScreen = offScreen;
+ this.graphicsConfiguration = graphicsConfiguration;
+
+ // Issue 131: Set the autoOffScreen variable based on whether this
+ // canvas3d implements the AutoOffScreenCanvas3D tagging interface.
+ // Eventually, we may replace this with an actual API.
+ boolean autoOffScreenCanvas3D = false;
+ if (this instanceof com.sun.j3d.exp.swing.impl.AutoOffScreenCanvas3D) {
+ autoOffScreenCanvas3D = true;
+ }
+
+ // Throw an illegal argument exception if an on-screen canvas is tagged
+ // as an auto-off-screen canvas
+ if (autoOffScreenCanvas3D && !offScreen) {
+ throw new IllegalArgumentException(J3dI18N.getString("Canvas3D25"));
+ }
+
+ // Issue 163 : Set dirty bits for both Renderer and RenderBin
+ cvDirtyMask[0] = VIEW_INFO_DIRTY;
+ cvDirtyMask[1] = VIEW_INFO_DIRTY;
+
+ GraphicsConfigInfo gcInfo = graphicsConfigTable.get(graphicsConfiguration);
+ requestedStencilSize = gcInfo.getGraphicsConfigTemplate3D().getStencilSize();
+
+ fbConfig = Pipeline.getPipeline().getFbConfig(gcInfo);
+
+ if (offScreen) {
+
+ // Issue 131: set manual rendering flag based on whether this is
+ // an auto-off-screen Canvas3D.
+ manualRendering = !autoOffScreenCanvas3D;
+
+ screen = new Screen3D(graphicsConfiguration, offScreen);
+
+ // QUESTION: keep a list of off-screen Screen3D objects?
+ // Does this list need to be grouped by GraphicsDevice?
+
+ synchronized(dirtyMaskLock) {
+ cvDirtyMask[0] |= MOVED_OR_RESIZED_DIRTY;
+ cvDirtyMask[1] |= MOVED_OR_RESIZED_DIRTY;
+ }
+
+ // this canvas will not receive the paint callback,
+ // so we need to set the necessary flags here
+ firstPaintCalled = true;
+
+ if (manualRendering) {
+ // since this canvas will not receive the addNotify
+ // callback from AWT, set the added flag here for
+ // evaluateActive to work correctly
+ added = true;
+ }
+
+ evaluateActive();
+
+ // create the rendererStructure object
+ //rendererStructure = new RendererStructure();
+ offScreenCanvasLoc = new Point(0, 0);
+ offScreenCanvasSize = new Dimension(0, 0);
+
+ this.setLocation(offScreenCanvasLoc);
+ this.setSize(offScreenCanvasSize);
+ newSize = offScreenCanvasSize;
+ newPosition = offScreenCanvasLoc;
+
+ // Issue 131: create event catchers for auto-offScreen
+ if (!manualRendering) {
+ eventCatcher = new EventCatcher(this);
+ canvasViewEventCatcher = new CanvasViewEventCatcher(this);
+ }
+ } else {
+
+ GraphicsDevice graphicsDevice;
+ graphicsDevice = graphicsConfiguration.getDevice();
+
+ eventCatcher = new EventCatcher(this);
+ canvasViewEventCatcher = new CanvasViewEventCatcher(this);
+
+ synchronized(VirtualUniverse.mc.deviceScreenMap) {
+ screen = (Screen3D) VirtualUniverse.mc.
+ deviceScreenMap.get(graphicsDevice);
+
+ if (screen == null) {
+ screen = new Screen3D(graphicsConfiguration, offScreen);
+ VirtualUniverse.mc.deviceScreenMap.put(graphicsDevice,
+ screen);
+ }
+ }
+
+ }
+
+ lights = new LightRetained[VirtualUniverse.mc.maxLights];
+ frameCount = new int[VirtualUniverse.mc.maxLights];
+ for (int i=0; i
+ * right manual eye in image plate : (0.208, 0.135, 0.4572)
+ * stereo enable : true
+ * double buffer enable : true
+ * monoscopic view policy : View.CYCLOPEAN_EYE_VIEW
+ * off-screen mode : false
+ * off-screen buffer : null
+ * off-screen location : (0,0)
+ * true if this Canvas3D is an off-screen canvas;
+ * false if this is an on-screen canvas.
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean isOffScreen() {
+ return offScreen;
+ }
+
+
+ /**
+ * Sets the off-screen buffer for this Canvas3D. The specified
+ * image is written into by the Java 3D renderer. The size of the
+ * specified ImageComponent determines the size, in pixels, of
+ * this Canvas3D--the size inherited from Component is ignored.
+ * postSwap method, or call
+ * waitForOffScreenRendering.
+ *
+ * @exception NullPointerException if the off-screen buffer is null.
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode, or if either the width or the height of
+ * the associated Screen3D's size is <= 0, or if the associated
+ * Screen3D's physical width or height is <= 0.
+ * @exception RestrictedAccessException if an off-screen rendering
+ * is already in process for this Canvas3D or if the Java 3D renderer
+ * is stopped.
+ *
+ * @see #setOffScreenBuffer
+ * @see Screen3D#setSize(int, int)
+ * @see Screen3D#setSize(Dimension)
+ * @see Screen3D#setPhysicalScreenWidth
+ * @see Screen3D#setPhysicalScreenHeight
+ * @see #waitForOffScreenRendering
+ * @see #postSwap
+ *
+ * @since Java 3D 1.2
+ */
+ public void renderOffScreenBuffer() {
+
+ if (!offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+
+ // Issue 131: Cannot manually render to an automatic canvas.
+ if (!manualRendering)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D24"));
+
+ // Issue 260 : Cannot render if we already have a fatal error
+ if (fatalError) {
+ throw new IllegalRenderingStateException(J3dI18N.getString("Canvas3D30"));
+ }
+
+ if (offScreenBuffer == null)
+ throw new NullPointerException(J3dI18N.getString("Canvas3D10"));
+
+ Dimension screenSize = screen.getSize();
+
+ if (screenSize.width <= 0)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D8"));
+
+ if (screenSize.height <= 0)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D9"));
+
+ if (screen.getPhysicalScreenWidth() <= 0.0)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D12"));
+
+ if (screen.getPhysicalScreenHeight() <= 0.0)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D13"));
+
+ if (offScreenRendering)
+ throw new RestrictedAccessException(J3dI18N.getString("Canvas3D2"));
+
+ if (!isRunning)
+ throw new RestrictedAccessException(J3dI18N.getString("Canvas3D11"));
+
+ // Fix to issue 66
+ if ((!active) || (pendingView == null)) {
+ /* No rendering is performed if this Canvas3D object has not been
+ added to an active View. */
+ return;
+ }
+
+ // Issue 131: moved code that determines off-screen boundary to separate
+ // method that is called from the renderer
+
+ offScreenRendering = true;
+
+ // Fix to issue 66.
+ /* This is an attempt to do the following check in one atomic operation :
+ ((view != null) && (view.inCanvasCallback)) */
+
+ boolean inCanvasCallback = false;
+ try {
+ inCanvasCallback = view.inCanvasCallback;
+
+ } catch (NullPointerException npe) {
+ /* Do nothing here */
+ }
+
+ if (inCanvasCallback) {
+ // Here we assume that view is stable if inCanvasCallback
+ // is true. This assumption is valid among all j3d threads as
+ // all access to view is synchronized by MasterControl.
+ // Issue : user threads access to view isn't synchronize hence
+ // is model will break.
+ if (screen.renderer == null) {
+
+ // It is possible that screen.renderer = null when this View
+ // is shared by another onScreen Canvas and this callback
+ // is from that Canvas. In this case it need one more
+ // round before the renderer.
+ screen.renderer = (Renderer) screen.deviceRendererMap.get(
+ screen.graphicsDevice);
+ // screen.renderer may equal to null when multiple
+ // screen is used and this Canvas3D is in different
+ // screen sharing the same View not yet initialize.
+ }
+
+ // if called from render call back, send a message directly to
+ // the renderer message queue, and call renderer doWork
+ // to do the offscreen rendering now
+ if (Thread.currentThread() == screen.renderer) {
+
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.RENDER_THREAD;
+ createMessage.type = J3dMessage.RENDER_OFFSCREEN;
+ createMessage.universe = this.view.universe;
+ createMessage.view = this.view;
+ createMessage.args[0] = this;
+
+ screen.renderer.rendererStructure.addMessage(createMessage);
+
+ // modify the args to reflect offScreen rendering
+ screen.renderer.args = new Object[4];
+ ((Object[])screen.renderer.args)[0] =
+ new Integer(Renderer.REQUESTRENDER);
+ ((Object[])screen.renderer.args)[1] = this;
+ ((Object[])screen.renderer.args)[2] = view;
+ // This extra argument 3 is needed in MasterControl to
+ // test whether offscreen Rendering is used or not
+ ((Object[])screen.renderer.args)[3] = null;
+
+ // call renderer doWork directly since we are already in
+ // the renderer thread
+ screen.renderer.doWork(0);
+ } else {
+
+ // XXXX:
+ // Now we are in trouble, this will cause deadlock if
+ // waitForOffScreenRendering() is invoked
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.RENDER_THREAD;
+ createMessage.type = J3dMessage.RENDER_OFFSCREEN;
+ createMessage.universe = this.view.universe;
+ createMessage.view = this.view;
+ createMessage.args[0] = this;
+ screen.renderer.rendererStructure.addMessage(createMessage);
+ VirtualUniverse.mc.setWorkForRequestRenderer();
+ }
+
+ } else if (Thread.currentThread() instanceof BehaviorScheduler) {
+
+ // If called from behavior scheduler, send a message directly to
+ // the renderer message queue.
+ // Note that we didn't use
+ // currentThread() == view.universe.behaviorScheduler
+ // since the caller may be another universe Behavior
+ // scheduler.
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.RENDER_THREAD;
+ createMessage.type = J3dMessage.RENDER_OFFSCREEN;
+ createMessage.universe = this.view.universe;
+ createMessage.view = this.view;
+ createMessage.args[0] = this;
+ screen.renderer.rendererStructure.addMessage(createMessage);
+ VirtualUniverse.mc.setWorkForRequestRenderer();
+
+ } else {
+ // send a message to renderBin
+ // Fix for issue 66 : Since view might not been set yet,
+ // we have to use pendingView instead.
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDER;
+ createMessage.type = J3dMessage.RENDER_OFFSCREEN;
+ createMessage.universe = this.pendingView.universe;
+ createMessage.view = this.pendingView;
+ createMessage.args[0] = this;
+ createMessage.args[1] = offScreenBuffer;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+ }
+
+
+ /**
+ * Waits for this Canvas3D's off-screen rendering to be done.
+ * This method will wait until the postSwap method of this
+ * off-screen Canvas3D has completed. If this Canvas3D has not
+ * been added to an active view or if the renderer is stopped for this
+ * Canvas3D, then this method will return
+ * immediately. This method must not be called from a render
+ * callback method of an off-screen Canvas3D.
+ *
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode, or if this method is called from a render
+ * callback method of an off-screen Canvas3D.
+ *
+ * @see #renderOffScreenBuffer
+ * @see #postSwap
+ *
+ * @since Java 3D 1.2
+ */
+ public void waitForOffScreenRendering() {
+
+ if (!offScreen) {
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+ }
+
+ if (Thread.currentThread() instanceof Renderer) {
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D31"));
+ }
+
+ while (offScreenRendering) {
+ MasterControl.threadYield();
+ }
+ }
+
+
+ /**
+ * Sets the location of this off-screen Canvas3D. The location is
+ * the upper-left corner of the Canvas3D relative to the
+ * upper-left corner of the corresponding off-screen Screen3D.
+ * The function of this method is similar to that of
+ * Component.setLocation for on-screen Canvas3D
+ * objects. The default location is (0,0).
+ *
+ * @param x the x coordinate of the upper-left corner of
+ * the new location.
+ * @param y the y coordinate of the upper-left corner of
+ * the new location.
+ *
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setOffScreenLocation(int x, int y) {
+
+ if (!offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+
+ synchronized(cvLock) {
+ offScreenCanvasLoc.setLocation(x, y);
+ }
+ }
+
+
+ /**
+ * Sets the location of this off-screen Canvas3D. The location is
+ * the upper-left corner of the Canvas3D relative to the
+ * upper-left corner of the corresponding off-screen Screen3D.
+ * The function of this method is similar to that of
+ * Component.setLocation for on-screen Canvas3D
+ * objects. The default location is (0,0).
+ *
+ * @param p the point defining the upper-left corner of the new
+ * location.
+ *
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setOffScreenLocation(Point p) {
+
+ if (!offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+
+ synchronized(cvLock) {
+ offScreenCanvasLoc.setLocation(p);
+ }
+ }
+
+
+ /**
+ * Retrieves the location of this off-screen Canvas3D. The
+ * location is the upper-left corner of the Canvas3D relative to
+ * the upper-left corner of the corresponding off-screen Screen3D.
+ * The function of this method is similar to that of
+ * Component.getLocation for on-screen Canvas3D
+ * objects.
+ *
+ * @return a new point representing the upper-left corner of the
+ * location of this off-screen Canvas3D.
+ *
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public Point getOffScreenLocation() {
+ if (!offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+
+ return (new Point(offScreenCanvasLoc));
+ }
+
+
+ /**
+ * Retrieves the location of this off-screen Canvas3D and stores
+ * it in the specified Point object. The location is the
+ * upper-left corner of the Canvas3D relative to the upper-left
+ * corner of the corresponding off-screen Screen3D. The function
+ * of this method is similar to that of
+ * Component.getLocation for on-screen Canvas3D
+ * objects. This version of getOffScreenLocation is
+ * useful if the caller wants to avoid allocating a new Point
+ * object on the heap.
+ *
+ * @param rv Point object into which the upper-left corner of the
+ * location of this off-screen Canvas3D is copied.
+ * If rv is null, a new Point is allocated.
+ *
+ * @return rv
+ *
+ * @exception IllegalStateException if this Canvas3D is not in
+ * off-screen mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public Point getOffScreenLocation(Point rv) {
+
+ if (!offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D1"));
+
+ if (rv == null)
+ return (new Point(offScreenCanvasLoc));
+
+ else {
+ rv.setLocation(offScreenCanvasLoc);
+ return rv;
+ }
+ }
+
+ void endOffScreenRendering() {
+
+ ImageComponent2DRetained icRetained = (ImageComponent2DRetained)offScreenBuffer.retained;
+ boolean isByRef = icRetained.isByReference();
+ boolean isYUp = icRetained.isYUp();
+ ImageComponentRetained.ImageData imageData = icRetained.getImageData(false);
+
+ if(!isByRef) {
+ // If icRetained has a null image ( BufferedImage)
+ if (imageData == null) {
+ assert (!isByRef);
+ icRetained.createBlankImageData();
+ imageData = icRetained.getImageData(false);
+ }
+ // Check for possible format conversion in imageData
+ else {
+ // Format convert imageData if format is unsupported.
+ icRetained.evaluateExtensions(this);
+ }
+ // read the image from the offscreen buffer
+ readOffScreenBuffer(ctx, icRetained.getImageFormatTypeIntValue(false),
+ icRetained.getImageDataTypeIntValue(), imageData.get(),
+ offScreenCanvasSize.width, offScreenCanvasSize.height);
+
+ } else {
+ icRetained.geomLock.getLock();
+ // Create a copy of format converted image in imageData if format is unsupported.
+ icRetained.evaluateExtensions(this);
+
+ // read the image from the offscreen buffer
+ readOffScreenBuffer(ctx, icRetained.getImageFormatTypeIntValue(false),
+ icRetained.getImageDataTypeIntValue(), imageData.get(),
+ offScreenCanvasSize.width, offScreenCanvasSize.height);
+
+ // For byRef, we might have to copy buffer back into
+ // the user's referenced ImageComponent2D
+ if(!imageData.isDataByRef()) {
+ if(icRetained.isImageTypeSupported()) {
+ icRetained.copyToRefImage(0);
+ } else {
+ // This method only handle RGBA conversion.
+ icRetained.copyToRefImageWithFormatConversion(0);
+ }
+ }
+
+ icRetained.geomLock.unLock();
+ }
+ }
+
+ /**
+ * Synchronize and swap buffers on a double buffered canvas for
+ * this Canvas3D object. This method should only be called if the
+ * Java 3D renderer has been stopped. In the normal case, the renderer
+ * automatically swaps the buffer.
+ * This method calls the flush(true) methods of the
+ * associated 2D and 3D graphics contexts, if they have been allocated.
+ *
+ * @exception RestrictedAccessException if the Java 3D renderer is
+ * running.
+ * @exception IllegalStateException if this Canvas3D is in
+ * off-screen mode.
+ *
+ * @see #stopRenderer
+ * @see GraphicsContext3D#flush
+ * @see J3DGraphics2D#flush
+ */
+ public void swap() {
+ if (offScreen)
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D14"));
+
+ if (isRunning)
+ throw new RestrictedAccessException(J3dI18N.getString("Canvas3D0"));
+
+ if (!firstPaintCalled) {
+ return;
+ }
+
+ if (view != null && graphicsContext3D != null) {
+ if ((view.universe != null) &&
+ (Thread.currentThread() == view.universe.behaviorScheduler)) {
+ graphicsContext3D.sendRenderMessage(false, GraphicsContext3D.SWAP, null, null);
+ } else {
+ graphicsContext3D.sendRenderMessage(true, GraphicsContext3D.SWAP, null, null);
+ }
+ graphicsContext3D.runMonitor(J3dThread.WAIT);
+ }
+ }
+
+ void doSwap() {
+
+ if (firstPaintCalled && useDoubleBuffer) {
+ try {
+ if (validCtx && (ctx != null) && (view != null)) {
+ synchronized (drawingSurfaceObject) {
+ if (validCtx) {
+ if (!drawingSurfaceObject.renderLock()) {
+ graphicsContext3D.runMonitor(J3dThread.NOTIFY);
+ return;
+ }
+ this.syncRender(ctx, true);
+ int status = swapBuffers(ctx, screen.display, drawable);
+ if (status != NOCHANGE) {
+ resetImmediateRendering(status);
+ }
+ drawingSurfaceObject.unLock();
+ }
+ }
+ }
+ } catch (NullPointerException ne) {
+ drawingSurfaceObject.unLock();
+ }
+ }
+ // Increment the elapsedFrame for the behavior structure
+ // to trigger any interpolators
+ view.universe.behaviorStructure.incElapsedFrames();
+ // waitup user thread in PureImmediate mode to continue
+ if (reEvaluateCanvasCmd != 0) {
+ int status;
+
+ antialiasingSet = false;
+ if (reEvaluateCanvasCmd == RESIZE) {
+ assert VirtualUniverse.mc.isD3D();
+ status = resizeD3DCanvas(ctx);
+ } else {
+ status = toggleFullScreenMode(ctx);
+ }
+ // reset everything
+ if (status != NOCHANGE) {
+ resetImmediateRendering(status);
+ }
+ reEvaluateCanvasCmd = 0;
+ }
+ graphicsContext3D.runMonitor(J3dThread.NOTIFY);
+ }
+
+ /**
+ * Wrapper for native createNewContext method.
+ */
+ Context createNewContext(Context shareCtx, boolean isSharedCtx) {
+ Context retVal = createNewContext(this.screen.display,
+ this.drawable,
+ this.fbConfig,
+ shareCtx, isSharedCtx,
+ this.offScreen,
+ VirtualUniverse.mc.glslLibraryAvailable,
+ VirtualUniverse.mc.cgLibraryAvailable);
+ // compute the max available texture units
+ maxAvailableTextureUnits = Math.max(maxTextureUnits, maxTextureImageUnits);
+
+ return retVal;
+ }
+
+ /**
+ * Make the context associated with the specified canvas current.
+ */
+ final void makeCtxCurrent() {
+ makeCtxCurrent(ctx, screen.display, drawable);
+ }
+
+ /**
+ * Make the specified context current.
+ */
+ final void makeCtxCurrent(Context ctx) {
+ makeCtxCurrent(ctx, screen.display, drawable);
+ }
+
+ final void makeCtxCurrent(Context ctx, long dpy, Drawable drawable) {
+ if (ctx != screen.renderer.currentCtx || drawable != screen.renderer.currentDrawable) {
+ if (!drawingSurfaceObject.isLocked()) {
+ drawingSurfaceObject.renderLock();
+ useCtx(ctx, dpy, drawable);
+ drawingSurfaceObject.unLock();
+ } else {
+ useCtx(ctx, dpy, drawable);
+ }
+ screen.renderer.currentCtx = ctx;
+ screen.renderer.currentDrawable = drawable;
+ }
+ }
+
+ // Give the pipeline a chance to release the context; the Pipeline may
+ // or may not ignore this call.
+ void releaseCtx() {
+ if (screen.renderer.currentCtx != null) {
+ boolean needLock = !drawingSurfaceObject.isLocked();
+ if (needLock) {
+ drawingSurfaceObject.renderLock();
+ }
+ if (releaseCtx(screen.renderer.currentCtx, screen.display)) {
+ screen.renderer.currentCtx = null;
+ screen.renderer.currentDrawable = null;
+ }
+ if (needLock) {
+ drawingSurfaceObject.unLock();
+ }
+ }
+ }
+
+
+ /**
+ * Sets the position of the manual left eye in image-plate
+ * coordinates. This value determines eye placement when a head
+ * tracker is not in use and the application is directly controlling
+ * the eye position in image-plate coordinates.
+ * In head-tracked mode or when the windowEyePointPolicy is
+ * RELATIVE_TO_FIELD_OF_VIEW or RELATIVE_TO_COEXISTENCE, this value
+ * is ignored. When the
+ * windowEyepointPolicy is RELATIVE_TO_WINDOW only the Z value is
+ * used.
+ * @param position the new manual left eye position
+ */
+ public void setLeftManualEyeInImagePlate(Point3d position) {
+
+ this.leftManualEyeInImagePlate.set(position);
+ synchronized(dirtyMaskLock) {
+ cvDirtyMask[0] |= EYE_IN_IMAGE_PLATE_DIRTY;
+ cvDirtyMask[1] |= EYE_IN_IMAGE_PLATE_DIRTY;
+ }
+ redraw();
+ }
+
+ /**
+ * Sets the position of the manual right eye in image-plate
+ * coordinates. This value determines eye placement when a head
+ * tracker is not in use and the application is directly controlling
+ * the eye position in image-plate coordinates.
+ * In head-tracked mode or when the windowEyePointPolicy is
+ * RELATIVE_TO_FIELD_OF_VIEW or RELATIVE_TO_COEXISTENCE, this value
+ * is ignored. When the
+ * windowEyepointPolicy is RELATIVE_TO_WINDOW only the Z value is
+ * used.
+ * @param position the new manual right eye position
+ */
+ public void setRightManualEyeInImagePlate(Point3d position) {
+
+ this.rightManualEyeInImagePlate.set(position);
+ synchronized(dirtyMaskLock) {
+ cvDirtyMask[0] |= EYE_IN_IMAGE_PLATE_DIRTY;
+ cvDirtyMask[1] |= EYE_IN_IMAGE_PLATE_DIRTY;
+ }
+ redraw();
+ }
+
+ /**
+ * Retrieves the position of the user-specified, manual left eye
+ * in image-plate
+ * coordinates and copies that value into the object provided.
+ * @param position the object that will receive the position
+ */
+ public void getLeftManualEyeInImagePlate(Point3d position) {
+ position.set(this.leftManualEyeInImagePlate);
+ }
+
+ /**
+ * Retrieves the position of the user-specified, manual right eye
+ * in image-plate
+ * coordinates and copies that value into the object provided.
+ * @param position the object that will receive the position
+ */
+ public void getRightManualEyeInImagePlate(Point3d position) {
+ position.set(this.rightManualEyeInImagePlate);
+ }
+
+ /**
+ * Retrieves the actual position of the left eye
+ * in image-plate
+ * coordinates and copies that value into the object provided.
+ * This value is a function of the windowEyepointPolicy, the tracking
+ * enable flag, and the manual left eye position.
+ * @param position the object that will receive the position
+ */
+ public void getLeftEyeInImagePlate(Point3d position) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ position.set(canvasViewCache.getLeftEyeInImagePlate());
+ }
+ }
+ else {
+ position.set(leftManualEyeInImagePlate);
+ }
+ }
+
+ /**
+ * Retrieves the actual position of the right eye
+ * in image-plate
+ * coordinates and copies that value into the object provided.
+ * This value is a function of the windowEyepointPolicy, the tracking
+ * enable flag, and the manual right eye position.
+ * @param position the object that will receive the position
+ */
+ public void getRightEyeInImagePlate(Point3d position) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ position.set(canvasViewCache.getRightEyeInImagePlate());
+ }
+ }
+ else {
+ position.set(rightManualEyeInImagePlate);
+ }
+ }
+
+ /**
+ * Retrieves the actual position of the center eye
+ * in image-plate
+ * coordinates and copies that value into the object provided.
+ * The center eye is the fictional eye half-way between the left and
+ * right eye.
+ * This value is a function of the windowEyepointPolicy, the tracking
+ * enable flag, and the manual right and left eye positions.
+ * @param position the object that will receive the position
+ * @see #setMonoscopicViewPolicy
+ */
+ // XXXX: This might not make sense for field-sequential HMD.
+ public void getCenterEyeInImagePlate(Point3d position) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ position.set(canvasViewCache.getCenterEyeInImagePlate());
+ }
+ }
+ else {
+ Point3d cenEye = new Point3d();
+ cenEye.add(leftManualEyeInImagePlate, rightManualEyeInImagePlate);
+ cenEye.scale(0.5);
+ position.set(cenEye);
+ }
+ }
+
+ /**
+ * Retrieves the current ImagePlate coordinates to Virtual World
+ * coordinates transform and places it into the specified object.
+ * @param t the Transform3D object that will receive the
+ * transform
+ */
+ // TODO: Document -- This will return the transform of left plate.
+ public void getImagePlateToVworld(Transform3D t) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ t.set(canvasViewCache.getImagePlateToVworld());
+ }
+ }
+ else {
+ t.setIdentity();
+ }
+ }
+
+ /**
+ * Computes the position of the specified AWT pixel value
+ * in image-plate
+ * coordinates and copies that value into the object provided.
+ * @param x the X coordinate of the pixel relative to the upper-left
+ * hand corner of the window.
+ * @param y the Y coordinate of the pixel relative to the upper-left
+ * hand corner of the window.
+ * @param imagePlatePoint the object that will receive the position in
+ * physical image plate coordinates (relative to the lower-left
+ * corner of the screen).
+ */
+ // TODO: Document -- This transform the pixel location to the left image plate.
+ public void getPixelLocationInImagePlate(int x, int y,
+ Point3d imagePlatePoint) {
+
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ imagePlatePoint.x =
+ canvasViewCache.getWindowXInImagePlate((double)x);
+ imagePlatePoint.y =
+ canvasViewCache.getWindowYInImagePlate((double)y);
+ imagePlatePoint.z = 0.0;
+ }
+ } else {
+ imagePlatePoint.set(0.0, 0.0, 0.0);
+ }
+ }
+
+
+ void getPixelLocationInImagePlate(double x, double y, double z,
+ Point3d imagePlatePoint) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ canvasViewCache.getPixelLocationInImagePlate(
+ x, y, z, imagePlatePoint);
+ }
+ } else {
+ imagePlatePoint.set(0.0, 0.0, 0.0);
+ }
+ }
+
+
+ /**
+ * Computes the position of the specified AWT pixel value
+ * in image-plate
+ * coordinates and copies that value into the object provided.
+ * @param pixelLocation the coordinates of the pixel relative to
+ * the upper-left hand corner of the window.
+ * @param imagePlatePoint the object that will receive the position in
+ * physical image plate coordinates (relative to the lower-left
+ * corner of the screen).
+ *
+ * @since Java 3D 1.2
+ */
+ // TODO: Document -- This transform the pixel location to the left image plate.
+ public void getPixelLocationInImagePlate(Point2d pixelLocation,
+ Point3d imagePlatePoint) {
+
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ imagePlatePoint.x =
+ canvasViewCache.getWindowXInImagePlate(pixelLocation.x);
+ imagePlatePoint.y =
+ canvasViewCache.getWindowYInImagePlate(pixelLocation.y);
+ imagePlatePoint.z = 0.0;
+ }
+ }
+ else {
+ imagePlatePoint.set(0.0, 0.0, 0.0);
+ }
+ }
+
+
+ /**
+ * Projects the specified point from image plate coordinates
+ * into AWT pixel coordinates. The AWT pixel coordinates are
+ * copied into the object provided.
+ * @param imagePlatePoint the position in
+ * physical image plate coordinates (relative to the lower-left
+ * corner of the screen).
+ * @param pixelLocation the object that will receive the coordinates
+ * of the pixel relative to the upper-left hand corner of the window.
+ *
+ * @since Java 3D 1.2
+ */
+ // TODO: Document -- This transform the pixel location from the left image plate.
+ public void getPixelLocationFromImagePlate(Point3d imagePlatePoint,
+ Point2d pixelLocation) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ canvasViewCache.getPixelLocationFromImagePlate(
+ imagePlatePoint, pixelLocation);
+ }
+ }
+ else {
+ pixelLocation.set(0.0, 0.0);
+ }
+ }
+
+ /**
+ * Copies the current Vworld projection transform for each eye
+ * into the specified Transform3D objects. This transform takes
+ * points in virtual world coordinates and projects them into
+ * clipping coordinates, which are in the range [-1,1] in
+ * X, Y, and Z after clipping and perspective
+ * division.
+ * In monoscopic mode, the same projection transform will be
+ * copied into both the right and left eye Transform3D objects.
+ *
+ * @param leftProjection the Transform3D object that will receive
+ * a copy of the current projection transform for the left eye.
+ *
+ * @param rightProjection the Transform3D object that will receive
+ * a copy of the current projection transform for the right eye.
+ *
+ * @since Java 3D 1.3
+ */
+ public void getVworldProjection(Transform3D leftProjection,
+ Transform3D rightProjection) {
+ if (canvasViewCache != null) {
+ ViewPlatformRetained viewPlatformRetained =
+ (ViewPlatformRetained)view.getViewPlatform().retained;
+
+ synchronized(canvasViewCache) {
+ leftProjection.mul(canvasViewCache.getLeftProjection(),
+ canvasViewCache.getLeftVpcToEc());
+ leftProjection.mul(viewPlatformRetained.getVworldToVpc());
+
+ // caluclate right eye if in stereo, otherwise
+ // this is the same as the left eye.
+ if (useStereo) {
+ rightProjection.mul(canvasViewCache.getRightProjection(),
+ canvasViewCache.getRightVpcToEc());
+ rightProjection.mul(viewPlatformRetained.getVworldToVpc());
+ }
+ else {
+ rightProjection.set(leftProjection);
+ }
+ }
+ }
+ else {
+ leftProjection.setIdentity();
+ rightProjection.setIdentity();
+ }
+ }
+
+ /**
+ * Copies the inverse of the current Vworld projection transform
+ * for each eye into the specified Transform3D objects. This
+ * transform takes points in clipping coordinates, which are in
+ * the range [-1,1] in X, Y, and Z after
+ * clipping and perspective division, and transforms them into
+ * virtual world coordinates.
+ * In monoscopic mode, the same inverse projection transform will
+ * be copied into both the right and left eye Transform3D objects.
+ *
+ * @param leftInverseProjection the Transform3D object that will
+ * receive a copy of the current inverse projection transform for
+ * the left eye.
+ * @param rightInverseProjection the Transform3D object that will
+ * receive a copy of the current inverse projection transform for
+ * the right eye.
+ *
+ * @since Java 3D 1.3
+ */
+ public void getInverseVworldProjection(Transform3D leftInverseProjection,
+ Transform3D rightInverseProjection) {
+ if (canvasViewCache != null) {
+ ViewPlatformRetained viewPlatformRetained =
+ (ViewPlatformRetained)view.getViewPlatform().retained;
+
+ synchronized(canvasViewCache) {
+ leftInverseProjection.set(
+ canvasViewCache.getLeftCcToVworld());
+
+ // caluclate right eye if in stereo, otherwise
+ // this is the same as the left eye.
+ if (useStereo) {
+ rightInverseProjection.set(
+ canvasViewCache.getRightCcToVworld());
+ }
+ else {
+ rightInverseProjection.set(leftInverseProjection);
+ }
+ }
+
+ }
+ else {
+ leftInverseProjection.setIdentity();
+ rightInverseProjection.setIdentity();
+ }
+ }
+
+
+ /**
+ * Retrieves the physical width of this canvas window in meters.
+ * @return the physical window width in meters.
+ */
+ public double getPhysicalWidth() {
+ double width = 0.0;
+
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ width = canvasViewCache.getPhysicalWindowWidth();
+ }
+ }
+
+ return width;
+ }
+
+ /**
+ * Retrieves the physical height of this canvas window in meters.
+ * @return the physical window height in meters.
+ */
+ public double getPhysicalHeight() {
+ double height = 0.0;
+
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ height = canvasViewCache.getPhysicalWindowHeight();
+ }
+ }
+
+ return height;
+ }
+
+ /**
+ * Retrieves the current Virtual World coordinates to ImagePlate
+ * coordinates transform and places it into the specified object.
+ * @param t the Transform3D object that will receive the
+ * transform
+ */
+ // TODO: Document -- This will return the transform of left plate.
+ public void getVworldToImagePlate(Transform3D t) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ t.set(canvasViewCache.getVworldToImagePlate());
+ }
+ }
+ else {
+ t.setIdentity();
+ }
+ }
+
+ void getLastVworldToImagePlate(Transform3D t) {
+ if (canvasViewCache != null) {
+ synchronized(canvasViewCache) {
+ t.set(canvasViewCache.getLastVworldToImagePlate());
+ }
+ }
+ else {
+ t.setIdentity();
+ }
+ }
+
+ /**
+ * Sets view that points to this Canvas3D.
+ * @param view view object that points to this Canvas3D
+ */
+ void setView(View view) {
+ pendingView = view;
+
+ // We can't set View directly here in user thread since
+ // other threads may using canvas.view
+ // e.g. In Renderer, we use canvas3d.view.inCallBack
+ // before and after postSwap(), if view change in between
+ // than view.inCallBack may never reset to false.
+ VirtualUniverse.mc.postRequest(MasterControl.SET_VIEW, this);
+ evaluateActive();
+ }
+
+ void computeViewCache() {
+ synchronized(cvLock) {
+ if (view == null) {
+ canvasViewCache = null;
+ canvasViewCacheFrustum = null;
+ } else {
+
+ canvasViewCache = new CanvasViewCache(this,
+ screen.screenViewCache,
+ view.viewCache);
+ // Issue 109 : construct a separate canvasViewCache for
+ // computing view frustum
+ canvasViewCacheFrustum = new CanvasViewCache(this,
+ screen.screenViewCache,
+ view.viewCache);
+ synchronized (dirtyMaskLock) {
+ cvDirtyMask[0] = VIEW_INFO_DIRTY;
+ cvDirtyMask[1] = VIEW_INFO_DIRTY;
+ }
+ }
+ }
+ }
+
+ /**
+ * Gets view that points to this Canvas3D.
+ * @return view object that points to this Canvas3D
+ */
+ public View getView() {
+ return pendingView;
+ }
+
+ /**
+ * Returns a status flag indicating whether or not stereo
+ * is available.
+ * This is equivalent to:
+ *
+ *
+ *
+ * @return a flag indicating whether stereo is available
+ */
+ public boolean getStereoAvailable() {
+ return ((Boolean)queryProperties().get("stereoAvailable")).
+ booleanValue();
+ }
+
+ /**
+ * Turns stereo on or off. Note that this attribute is used
+ * only when stereo is available. Enabling stereo on a Canvas3D
+ * that does not support stereo has no effect.
+ * @param flag enables or disables the display of stereo
+ *
+ * @see #queryProperties
+ */
+ public void setStereoEnable(boolean flag) {
+ stereoEnable = flag;
+ useStereo = stereoEnable && stereoAvailable;
+ synchronized(dirtyMaskLock) {
+ cvDirtyMask[0] |= STEREO_DIRTY;
+ cvDirtyMask[1] |= STEREO_DIRTY;
+ }
+ redraw();
+ }
+
+ /**
+ * Returns a status flag indicating whether or not stereo
+ * is enabled.
+ * @return a flag indicating whether stereo is enabled
+ */
+ public boolean getStereoEnable() {
+ return this.stereoEnable;
+ }
+
+
+ /**
+ * Specifies how Java 3D generates monoscopic view. If set to
+ * View.LEFT_EYE_VIEW, the view generated corresponds to the view as
+ * seen from the left eye. If set to View.RIGHT_EYE_VIEW, the view
+ * generated corresponds to the view as seen from the right
+ * eye. If set to View.CYCLOPEAN_EYE_VIEW, the view generated
+ * corresponds to the view as seen from the 'center eye', the
+ * fictional eye half-way between the left and right eye. The
+ * default monoscopic view policy is View.CYCLOPEAN_EYE_VIEW.
+ *
+ * ((Boolean)queryProperties().
+ * get("stereoAvailable")).
+ * booleanValue()
+ *
+ *
+ *
+ *
+ * @return a flag indicating whether double buffering is available.
+ */
+ public boolean getDoubleBufferAvailable() {
+ return ((Boolean)queryProperties().get("doubleBufferAvailable")).
+ booleanValue();
+ }
+
+ /**
+ * Turns double buffering on or off. If double buffering
+ * is off, all drawing is to the front buffer and no buffer swap
+ * is done between frames. It should be stressed that running
+ * Java 3D with double buffering disabled is not recommended.
+ * Enabling double buffering on a Canvas3D
+ * that does not support double buffering has no effect.
+ *
+ * @param flag enables or disables double buffering.
+ *
+ * @see #queryProperties
+ */
+ public void setDoubleBufferEnable(boolean flag) {
+ doubleBufferEnable = flag;
+ useDoubleBuffer = doubleBufferEnable && doubleBufferAvailable;
+ if (Thread.currentThread() == screen.renderer) {
+ setRenderMode(ctx, FIELD_ALL, useDoubleBuffer);
+ }
+ redraw();
+ }
+
+ /**
+ * Returns a status flag indicating whether or not double
+ * buffering is enabled.
+ * @return a flag indicating if double buffering is enabled.
+ */
+ public boolean getDoubleBufferEnable() {
+ return doubleBufferEnable;
+ }
+
+ /**
+ * Returns a status flag indicating whether or not scene
+ * antialiasing is available.
+ * This is equivalent to:
+ *
+ * ((Boolean)queryProperties().
+ * get("doubleBufferAvailable")).
+ * booleanValue()
+ *
+ *
+ *
+ *
+ * @return a flag indicating whether scene antialiasing is available.
+ */
+ public boolean getSceneAntialiasingAvailable() {
+ return ((Boolean)queryProperties().get("sceneAntialiasingAvailable")).
+ booleanValue();
+ }
+
+
+ /**
+ * Returns a flag indicating whether or not the specified shading
+ * language is supported. A ShaderError will be generated if an
+ * unsupported shading language is used.
+ *
+ * @param shadingLanguage the shading language being queried, one of:
+ *
+ * ((Boolean)queryProperties().
+ * get("sceneAntialiasingAvailable")).
+ * booleanValue()
+ *
+ * Shader.SHADING_LANGUAGE_GLSL or
+ * Shader.SHADING_LANGUAGE_CG.
+ *
+ * @return true if the specified shading language is supported,
+ * false otherwise.
+ *
+ * @since Java 3D 1.4
+ */
+ public boolean isShadingLanguageSupported(int shadingLanguage) {
+ // Call queryProperties to ensure that the shading language flags are valid
+ queryProperties();
+
+ // Return flag for specified shading language
+ switch (shadingLanguage) {
+ case Shader.SHADING_LANGUAGE_GLSL:
+ return shadingLanguageGLSL;
+ case Shader.SHADING_LANGUAGE_CG:
+ return shadingLanguageCg;
+ }
+
+ return false;
+ }
+
+
+ /**
+ * Returns a read-only Map object containing key-value pairs that define
+ * various properties for this Canvas3D. All of the keys are
+ * String objects. The values are key-specific, but most will be
+ * Boolean, Integer, Float, Double, or String objects.
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * Key (String)
+ * Value Type
+ *
+ *
+ * shadingLanguageCgBoolean
+ *
+ *
+ * shadingLanguageGLSLBoolean
+ *
+ *
+ * doubleBufferAvailableBoolean
+ *
+ *
+ * stereoAvailableBoolean
+ *
+ *
+ * sceneAntialiasingAvailableBoolean
+ *
+ *
+ * sceneAntialiasingNumPassesInteger
+ *
+ *
+ * stencilSizeInteger
+ *
+ *
+ * texture3DAvailableBoolean
+ *
+ *
+ * textureColorTableSizeInteger
+ *
+ *
+ * textureLodRangeAvailableBoolean
+ *
+ *
+ * textureLodOffsetAvailableBoolean
+ *
+ *
+ * textureWidthMaxInteger
+ *
+ *
+ * textureHeightMaxInteger
+ *
+ *
+ * textureBoundaryWidthMaxInteger
+ *
+ *
+ * textureEnvCombineAvailableBoolean
+ *
+ *
+ * textureCombineDot3AvailableBoolean
+ *
+ *
+ * textureCombineSubtractAvailableBoolean
+ *
+ *
+ * textureCoordSetsMaxInteger
+ *
+ *
+ * textureUnitStateMaxInteger
+ *
+ *
+ * textureImageUnitsMaxInteger
+ *
+ *
+ * textureImageUnitsVertexMaxInteger
+ *
+ *
+ * textureImageUnitsCombinedMaxInteger
+ *
+ *
+ * textureCubeMapAvailableBoolean
+ *
+ *
+ * textureDetailAvailableBoolean
+ *
+ *
+ * textureSharpenAvailableBoolean
+ *
+ *
+ * textureFilter4AvailableBoolean
+ *
+ *
+ * textureAnisotropicFilterDegreeMaxFloat
+ *
+ *
+ * textureNonPowerOfTwoAvailableBoolean
+ *
+ *
+ * vertexAttrsMaxInteger
+ *
+ *
+ * compressedGeometry.majorVersionNumberInteger
+ *
+ *
+ * compressedGeometry.minorVersionNumberInteger
+ *
+ *
+ * compressedGeometry.minorMinorVersionNumberInteger
+ *
+ *
+ * native.versionString
+ *
+ *
+ *
+ * @return the properties of this Canavs3D
+ *
+ * @since Java 3D 1.2
+ */
+ public final Map queryProperties() {
+ if (queryProps == null) {
+ boolean createDummyCtx = false;
+
+ synchronized (VirtualUniverse.mc.contextCreationLock) {
+ if (ctx == null) {
+ createDummyCtx = true;
+ }
+ }
+
+ if (createDummyCtx) {
+ GraphicsConfigTemplate3D.setQueryProps(this);
+ }
+
+ //create query Properties
+ createQueryProps();
+ }
+
+ if (fatalError) {
+ throw new IllegalStateException(J3dI18N.getString("Canvas3D29"));
+ }
+
+ return queryProps;
+ }
+
+ void createQueryContext() {
+ // create a dummy context to query for support of certain
+ // extensions, the context will destroy immediately
+ // inside the native code after setting the various
+ // fields in this object
+ createQueryContext(screen.display, drawable,
+ fbConfig, offScreen, 1, 1,
+ VirtualUniverse.mc.glslLibraryAvailable,
+ VirtualUniverse.mc.cgLibraryAvailable);
+ // compute the max available texture units
+ maxAvailableTextureUnits = Math.max(maxTextureUnits, maxTextureImageUnits);
+ }
+
+ /**
+ * Creates the query properties for this Canvas.
+ */
+ private void createQueryProps() {
+ // Create lists of keys and values
+ ArrayList keys = new ArrayList();
+ ArrayList values = new ArrayList();
+ int pass = 0;
+
+ // properties not associated with graphics context
+ keys.add("doubleBufferAvailable");
+ values.add(new Boolean(doubleBufferAvailable));
+
+ keys.add("stereoAvailable");
+ values.add(new Boolean(stereoAvailable));
+
+ keys.add("sceneAntialiasingAvailable");
+ values.add(new Boolean(sceneAntialiasingAvailable));
+
+ keys.add("sceneAntialiasingNumPasses");
+
+ if (sceneAntialiasingAvailable) {
+ pass = (sceneAntialiasingMultiSamplesAvailable ?
+ 1: Renderer.NUM_ACCUMULATION_SAMPLES);
+ }
+ values.add(new Integer(pass));
+
+ keys.add("stencilSize");
+ // Return the actual stencil size if the user owns it, otherwise
+ // return 0
+ if (userStencilAvailable) {
+ values.add(new Integer(actualStencilSize));
+ } else {
+ values.add(new Integer(0));
+ }
+
+ keys.add("compressedGeometry.majorVersionNumber");
+ values.add(new Integer(GeometryDecompressor.majorVersionNumber));
+ keys.add("compressedGeometry.minorVersionNumber");
+ values.add(new Integer(GeometryDecompressor.minorVersionNumber));
+ keys.add("compressedGeometry.minorMinorVersionNumber");
+ values.add(new Integer(GeometryDecompressor.minorMinorVersionNumber));
+
+ // Properties associated with graphics context
+ keys.add("texture3DAvailable");
+ values.add(new Boolean((textureExtendedFeatures & TEXTURE_3D) != 0));
+
+ keys.add("textureColorTableSize");
+ values.add(new Integer(textureColorTableSize));
+
+ keys.add("textureEnvCombineAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_COMBINE) != 0));
+
+ keys.add("textureCombineDot3Available");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_COMBINE_DOT3) != 0));
+
+ keys.add("textureCombineSubtractAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_COMBINE_SUBTRACT) != 0));
+
+ keys.add("textureCubeMapAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_CUBE_MAP) != 0));
+
+ keys.add("textureSharpenAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_SHARPEN) != 0));
+
+ keys.add("textureDetailAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_DETAIL) != 0));
+
+ keys.add("textureFilter4Available");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_FILTER4) != 0));
+
+ keys.add("textureAnisotropicFilterDegreeMax");
+ values.add(new Float(anisotropicDegreeMax));
+
+ keys.add("textureWidthMax");
+ values.add(new Integer(textureWidthMax));
+
+ keys.add("textureHeightMax");
+ values.add(new Integer(textureHeightMax));
+
+ keys.add("texture3DWidthMax");
+ values.add(new Integer(texture3DWidthMax));
+
+ keys.add("texture3DHeightMax");
+ values.add(new Integer(texture3DHeightMax));
+
+ keys.add("texture3DDepthMax");
+ values.add(new Integer(texture3DDepthMax));
+
+ keys.add("textureBoundaryWidthMax");
+ values.add(new Integer(textureBoundaryWidthMax));
+
+ keys.add("textureLodRangeAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_LOD_RANGE) != 0));
+
+ keys.add("textureLodOffsetAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_LOD_OFFSET) != 0));
+
+ keys.add("textureNonPowerOfTwoAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_NON_POWER_OF_TWO) != 0));
+
+ keys.add("textureAutoMipMapGenerationAvailable");
+ values.add(new Boolean(
+ (textureExtendedFeatures & TEXTURE_AUTO_MIPMAP_GENERATION) != 0));
+
+ keys.add("textureCoordSetsMax");
+ values.add(new Integer(maxTexCoordSets));
+
+ keys.add("textureUnitStateMax");
+ values.add(new Integer(maxTextureUnits));
+
+ keys.add("textureImageUnitsMax");
+ values.add(new Integer(maxTextureImageUnits));
+
+ keys.add("textureImageUnitsVertexMax");
+ values.add(new Integer(maxVertexTextureImageUnits));
+
+ keys.add("textureImageUnitsCombinedMax");
+ values.add(new Integer(maxCombinedTextureImageUnits));
+
+ keys.add("vertexAttrsMax");
+ values.add(new Integer(maxVertexAttrs));
+
+ keys.add("shadingLanguageGLSL");
+ values.add(new Boolean(shadingLanguageGLSL));
+
+ keys.add("shadingLanguageCg");
+ values.add(new Boolean(shadingLanguageCg));
+
+ keys.add("native.version");
+ values.add(nativeGraphicsVersion);
+
+ keys.add("native.vendor");
+ values.add(nativeGraphicsVendor);
+
+ keys.add("native.renderer");
+ values.add(nativeGraphicsRenderer);
+
+ // Now Create read-only properties object
+ queryProps =
+ new J3dQueryProps((String[]) keys.toArray(new String[0]),
+ values.toArray());
+ }
+
+
+ /**
+ * Update the view cache associated with this canvas.
+ */
+ void updateViewCache(boolean flag, CanvasViewCache cvc,
+ BoundingBox frustumBBox, boolean doInfinite) {
+
+ assert cvc == null;
+ synchronized(cvLock) {
+ if (firstPaintCalled && (canvasViewCache != null)) {
+ assert canvasViewCacheFrustum != null;
+ // Issue 109 : choose the appropriate cvCache
+ if (frustumBBox != null) {
+ canvasViewCacheFrustum.snapshot(true);
+ canvasViewCacheFrustum.computeDerivedData(flag, null,
+ frustumBBox, doInfinite);
+ } else {
+ canvasViewCache.snapshot(false);
+ canvasViewCache.computeDerivedData(flag, null,
+ null, doInfinite);
+ }
+ }
+ }
+ }
+
+ /**
+ * Set depthBufferWriteEnableOverride flag
+ */
+ void setDepthBufferWriteEnableOverride(boolean flag) {
+ depthBufferWriteEnableOverride = flag;
+ }
+
+ /**
+ * Set depthBufferEnableOverride flag
+ */
+ void setDepthBufferEnableOverride(boolean flag) {
+ depthBufferEnableOverride = flag;
+ }
+
+ // Static initializer for Canvas3D class
+ static {
+ VirtualUniverse.loadLibraries();
+ }
+
+
+ void resetTexture(Context ctx, int texUnitIndex) {
+ // D3D also need to reset texture attributes
+ this.resetTextureNative(ctx, texUnitIndex);
+
+ if (texUnitIndex < 0) {
+ texUnitIndex = 0;
+ }
+ texUnitState[texUnitIndex].mirror = null;
+ texUnitState[texUnitIndex].texture = null;
+
+ if (VirtualUniverse.mc.isD3D()) {
+ texUnitState[texUnitIndex].texAttrs = null;
+ texUnitState[texUnitIndex].texGen = null;
+ }
+ }
+
+
+ // use by D3D only
+ void resetTextureBin() {
+ Object obj;
+ TextureRetained tex;
+
+ // We don't use rdr.objectId for background texture in D3D
+ // so there is no need to handle rdr.objectId
+ if ((graphics2D != null) &&
+ (graphics2D.objectId != -1)) {
+ VirtualUniverse.mc.freeTexture2DId(graphics2D.objectId);
+ // let J3DGraphics2DImpl to initialize texture again
+ graphics2D.objectId = -1;
+ }
+
+ for (int id = textureIDResourceTable.size()-1; id >= 0; id--) {
+ obj = textureIDResourceTable.get(id);
+ if (obj != null) {
+ if (obj instanceof TextureRetained) {
+ tex = (TextureRetained) obj;
+ tex.resourceCreationMask &= ~canvasBit;
+ }
+ }
+ }
+ }
+
+
+ void d3dResize() {
+ assert VirtualUniverse.mc.isD3D();
+ int status = resizeD3DCanvas(ctx);
+
+ antialiasingSet = false;
+
+ // We need to reevaluate everything since d3d may create
+ // a new ctx
+ if (status != NOCHANGE) {
+ resetRendering(status);
+ }
+ }
+
+ void d3dToggle() {
+ assert VirtualUniverse.mc.isD3D();
+ int status = toggleFullScreenMode(ctx);
+
+ antialiasingSet = false;
+ if (status != NOCHANGE) {
+ resetRendering(status);
+ }
+ }
+
+ // use by D3D only
+ void notifyD3DPeer(int cmd) {
+ assert VirtualUniverse.mc.isD3D();
+ if (active) {
+ if (isRunning) {
+ if ((view != null) &&
+ (view.active) &&
+ // it is possible that view is set active by MC
+ // but renderer not yet set
+ (screen.renderer != null)) {
+ VirtualUniverse.mc.postRequest(MasterControl.STOP_RENDERER, this);
+
+ while (isRunningStatus) {
+ MasterControl.threadYield();
+ }
+ J3dMessage renderMessage = new J3dMessage();
+ renderMessage.threads = J3dThread.RENDER_THREAD;
+ if (cmd == RESIZE) {
+ renderMessage.type = J3dMessage.RESIZE_CANVAS;
+ } else {
+ renderMessage.type = J3dMessage.TOGGLE_CANVAS;
+ }
+ renderMessage.universe = null;
+ renderMessage.view = null;
+ renderMessage.args[0] = this;
+
+ screen.renderer.rendererStructure.addMessage(renderMessage);
+ VirtualUniverse.mc.postRequest(MasterControl.START_RENDERER, this);
+ VirtualUniverse.mc.sendRunMessage(view,
+ J3dThread.RENDER_THREAD);
+ }
+ } else {
+ // may be in immediate mode
+ reEvaluateCanvasCmd = cmd;
+ }
+ }
+ }
+
+ // reset all attributes so that everything e.g. display list,
+ // texture will recreate again in the next frame
+ void resetRendering(int status) {
+
+ if (status == RECREATEDDRAW) {
+ // D3D use MANAGE_POOL when createTexture, so there
+ // is no need to download texture again in case of RESETSURFACE
+ resetTextureBin();
+ screen.renderer.needToResendTextureDown = true;
+ }
+
+ reset();
+
+ synchronized (dirtyMaskLock) {
+ cvDirtyMask[0] |= VIEW_INFO_DIRTY;
+ cvDirtyMask[1] |= VIEW_INFO_DIRTY;
+ }
+
+ }
+
+
+ void reset() {
+ int i;
+ currentAppear = new AppearanceRetained();
+ currentMaterial = new MaterialRetained();
+ viewFrustum = new CachedFrustum();
+ canvasDirty = 0xffff;
+ lightBin = null;
+ environmentSet = null;
+ attributeBin = null;
+ shaderBin = null;
+ textureBin = null;
+ renderMolecule = null;
+ polygonAttributes = null;
+ lineAttributes = null;
+ pointAttributes = null;
+ material = null;
+ enableLighting = false;
+ transparency = null;
+ coloringAttributes = null;
+ shaderProgram = null;
+ texture = null;
+ texAttrs = null;
+ if (texUnitState != null) {
+ TextureUnitStateRetained tus;
+ for (i=0; i < texUnitState.length; i++) {
+ tus = texUnitState[i];
+ if (tus != null) {
+ tus.texAttrs = null;
+ tus.texGen = null;
+ }
+ }
+ }
+ texCoordGeneration = null;
+ renderingAttrs = null;
+ appearance = null;
+ appHandle = null;
+ dirtyRenderMoleculeList.clear();
+ displayListResourceFreeList.clear();
+
+ dirtyDlistPerRinfoList.clear();
+ textureIdResourceFreeList.clear();
+
+ lightChanged = true;
+ modelMatrix = null;
+ modelClip = null;
+ fog = null;
+ texLinearMode = false;
+ sceneAmbient = new Color3f();
+
+
+ for (i=0; i< frameCount.length;i++) {
+ frameCount[i] = -1;
+ }
+
+ for (i=0; i < lights.length; i++) {
+ lights[i] = null;
+ }
+
+ if (currentLights != null) {
+ for (i=0; i < currentLights.length; i++) {
+ currentLights[i] = null;
+ }
+ }
+
+ enableMask = -1;
+ stateUpdateMask = 0;
+ depthBufferWriteEnableOverride = false;
+ depthBufferEnableOverride = false;
+ depthBufferWriteEnable = true;
+ vfPlanesValid = false;
+ lightChanged = false;
+
+ for (i=0; i < curStateToUpdate.length; i++) {
+ curStateToUpdate[i] = null;
+ }
+
+ // Issue 362 - need to reset display lists and ctxTimeStamp in this
+ // method, so that display lists will be recreated when canvas is
+ // removed from a view and then added back into a view with another
+ // canvas
+ needToRebuildDisplayList = true;
+ ctxTimeStamp = VirtualUniverse.mc.getContextTimeStamp();
+ }
+
+
+ void resetImmediateRendering(int status) {
+ canvasDirty = 0xffff;
+ ra = null;
+
+ setSceneAmbient(ctx, 0.0f, 0.0f, 0.0f);
+ disableFog(ctx);
+ resetRenderingAttributes(ctx, false, false);
+
+ resetTexture(ctx, -1);
+ resetTexCoordGeneration(ctx);
+ resetTextureAttributes(ctx);
+ texUnitState[0].texAttrs = null;
+ texUnitState[0].texGen = null;
+
+ resetPolygonAttributes(ctx);
+ resetLineAttributes(ctx);
+ resetPointAttributes(ctx);
+ resetTransparency(ctx,
+ RenderMolecule.SURFACE,
+ PolygonAttributes.POLYGON_FILL,
+ false, false);
+ resetColoringAttributes(ctx,
+ 1.0f, 1.0f,
+ 1.0f, 1.0f, false);
+ updateMaterial(ctx, 1.0f, 1.0f, 1.0f, 1.0f);
+ resetRendering(NOCHANGE);
+ makeCtxCurrent();
+ synchronized (dirtyMaskLock) {
+ cvDirtyMask[0] |= VIEW_INFO_DIRTY;
+ cvDirtyMask[1] |= VIEW_INFO_DIRTY;
+ }
+ needToRebuildDisplayList = true;
+
+ ctxTimeStamp = VirtualUniverse.mc.getContextTimeStamp();
+ if (status == RECREATEDDRAW) {
+ screen.renderer.needToResendTextureDown = true;
+ }
+ }
+
+
+ // overide Canvas.getSize()
+ public Dimension getSize() {
+ if (!fullScreenMode) {
+ return super.getSize();
+ } else {
+ return new Dimension(fullscreenWidth, fullscreenHeight);
+ }
+ }
+
+ public Dimension getSize(Dimension rv) {
+ if (!fullScreenMode) {
+ return super.getSize(rv);
+ } else {
+ if (rv == null) {
+ return new Dimension(fullscreenWidth, fullscreenHeight);
+ } else {
+ rv.setSize(fullscreenWidth, fullscreenHeight);
+ return rv;
+ }
+ }
+ }
+
+ public Point getLocationOnScreen() {
+ if (!fullScreenMode) {
+ try {
+ return super.getLocationOnScreen();
+ } catch (IllegalComponentStateException e) {}
+ }
+ return new Point();
+ }
+
+ public int getX() {
+ if (!fullScreenMode) {
+ return super.getX();
+ } else {
+ return 0;
+ }
+ }
+
+
+ public int getY() {
+ if (!fullScreenMode) {
+ return super.getY();
+ } else {
+ return 0;
+ }
+ }
+
+ public int getWidth() {
+ if (!fullScreenMode) {
+ return super.getWidth();
+ } else {
+ return screen.screenSize.width;
+ }
+ }
+
+ public int getHeight() {
+ if (!fullScreenMode) {
+ return super.getHeight();
+ } else {
+ return screen.screenSize.height;
+ }
+ }
+
+ public Point getLocation(Point rv) {
+ if (!fullScreenMode) {
+ return super.getLocation(rv);
+ } else {
+ if (rv != null) {
+ rv.setLocation(0, 0);
+ return rv;
+ } else {
+ return new Point();
+ }
+ }
+ }
+
+ public Point getLocation() {
+ if (!fullScreenMode) {
+ return super.getLocation();
+ } else {
+ return new Point();
+ }
+ }
+
+ public Rectangle getBounds() {
+ if (!fullScreenMode) {
+ return super.getBounds();
+ } else {
+ return new Rectangle(0, 0,
+ screen.screenSize.width,
+ screen.screenSize.height);
+ }
+ }
+
+ public Rectangle getBounds(Rectangle rv) {
+ if (!fullScreenMode) {
+ return super.getBounds(rv);
+ } else {
+ if (rv != null) {
+ rv.setBounds(0, 0,
+ screen.screenSize.width,
+ screen.screenSize.height);
+ return rv;
+ } else {
+ return new Rectangle(0, 0,
+ screen.screenSize.width,
+ screen.screenSize.height);
+ }
+ }
+ }
+
+ void setProjectionMatrix(Context ctx, Transform3D projTrans) {
+ this.projTrans = projTrans;
+ setProjectionMatrix(ctx, projTrans.mat);
+ }
+
+ void setModelViewMatrix(Context ctx, double[] viewMatrix, Transform3D mTrans) {
+ setModelViewMatrix(ctx, viewMatrix, mTrans.mat);
+ if (!useStereo) {
+ this.modelMatrix = mTrans;
+ } else {
+ // TODO : This seems wrong to do only for the right eye.
+ // A possible approach is to invalidate the cache at begin of
+ // each eye.
+ if (rightStereoPass) {
+ // Only set cache in right stereo pass, otherwise
+ // if the left stereo pass set the cache value,
+ // setModelViewMatrix() in right stereo pass will not
+ // perform in RenderMolecules.
+ this.modelMatrix = mTrans;
+ }
+ }
+ }
+
+ void setDepthBufferWriteEnable(boolean mode) {
+ depthBufferWriteEnable = mode;
+ setDepthBufferWriteEnable(ctx, mode);
+ }
+
+ void setNumActiveTexUnit(int n) {
+ numActiveTexUnit = n;
+ }
+
+ int getNumActiveTexUnit() {
+ return numActiveTexUnit;
+ }
+
+ void setLastActiveTexUnit(int n) {
+ lastActiveTexUnit = n;
+ }
+
+ int getLastActiveTexUnit() {
+ return lastActiveTexUnit;
+ }
+
+ // Create the texture state array
+ void createTexUnitState() {
+ texUnitState = new TextureUnitStateRetained[maxAvailableTextureUnits];
+ for (int t = 0; t < maxAvailableTextureUnits; t++) {
+ texUnitState[t] = new TextureUnitStateRetained();
+ texUnitState[t].texture = null;
+ texUnitState[t].mirror = null;
+ }
+ }
+
+ boolean supportGlobalAlpha() {
+ return ((extensionsSupported & SUN_GLOBAL_ALPHA) != 0);
+ }
+
+ /**
+ * Enable separate specular color if it is not overriden by the
+ * property j3d.disableSeparateSpecular.
+ */
+ void enableSeparateSpecularColor() {
+ boolean enable = !VirtualUniverse.mc.disableSeparateSpecularColor;
+ updateSeparateSpecularColorEnable(ctx, enable);
+ }
+
+ final void beginScene() {
+ beginScene(ctx);
+ }
+
+ final void endScene() {
+ endScene(ctx);
+ }
+
+
+ // Send a createOffScreenBuffer message to Renderer (via
+ // MasterControl) and wait for it to be done
+ private void sendCreateOffScreenBuffer() {
+ // Wait for the buffer to be created unless called from
+ // a Behavior or from a Rendering thread
+ if (!(Thread.currentThread() instanceof BehaviorScheduler) &&
+ !(Thread.currentThread() instanceof Renderer)) {
+
+ offScreenBufferPending = true;
+ }
+
+ // Send message to Renderer thread to perform createOffScreenBuffer.
+ VirtualUniverse.mc.sendCreateOffScreenBuffer(this);
+
+ // Wait for off-screen buffer to be created
+ while (offScreenBufferPending) {
+ // Issue 364: create master control thread if needed
+ VirtualUniverse.mc.createMasterControlThread();
+ MasterControl.threadYield();
+ }
+ }
+
+ // Send a destroyOffScreenBuffer message to Renderer (via
+ // MasterControl) and wait for it to be done
+ private void sendDestroyCtxAndOffScreenBuffer() {
+ // Wait for the buffer to be destroyed unless called from
+ // a Behavior or from a Rendering thread
+ Thread currentThread = Thread.currentThread();
+ if (!(currentThread instanceof BehaviorScheduler) &&
+ !(currentThread instanceof Renderer)) {
+
+ offScreenBufferPending = true;
+ }
+
+ // Fix for Issue 18 and Issue 175
+ // Send message to Renderer thread to perform remove Ctx and destroyOffScreenBuffer.
+
+ VirtualUniverse.mc.sendDestroyCtxAndOffScreenBuffer(this);
+
+ // Wait for ctx and off-screen buffer to be destroyed
+ while (offScreenBufferPending) {
+ // Issue 364: create master control thread if needed
+ VirtualUniverse.mc.createMasterControlThread();
+ MasterControl.threadYield();
+ }
+ }
+
+ // Send a allocateCanvasId message to Renderer (via MasterControl) without
+ // waiting for it to be done
+ private void sendAllocateCanvasId() {
+ // Send message to Renderer thread to allocate a canvasId
+ VirtualUniverse.mc.sendAllocateCanvasId(this);
+ }
+
+ // Send a freeCanvasId message to Renderer (via MasterControl) without
+ // waiting for it to be done
+ private void sendFreeCanvasId() {
+ // Send message to Renderer thread to free the canvasId
+ VirtualUniverse.mc.sendFreeCanvasId(this);
+ }
+
+ private void removeCtx() {
+
+ if ((screen != null) &&
+ (screen.renderer != null) &&
+ (ctx != null)) {
+ VirtualUniverse.mc.postRequest(MasterControl.FREE_CONTEXT,
+ new Object[]{this,
+ new Long(screen.display),
+ drawable,
+ ctx});
+ // Fix for Issue 19
+ // Wait for the context to be freed unless called from
+ // a Behavior or from a Rendering thread
+ Thread currentThread = Thread.currentThread();
+ if (!(currentThread instanceof BehaviorScheduler) &&
+ !(currentThread instanceof Renderer)) {
+ while (ctxTimeStamp != 0) {
+ MasterControl.threadYield();
+ }
+ }
+ ctx = null;
+ }
+ }
+
+ /**
+ * Serialization of Canvas3D objects is not supported.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ private void writeObject(java.io.ObjectOutputStream out)
+ throws java.io.IOException {
+
+ throw new UnsupportedOperationException(J3dI18N.getString("Canvas3D20"));
+ }
+
+ /**
+ * Serialization of Canvas3D objects is not supported.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ private void readObject(java.io.ObjectInputStream in)
+ throws java.io.IOException, ClassNotFoundException {
+
+ throw new UnsupportedOperationException(J3dI18N.getString("Canvas3D20"));
+ }
+
+
+ // mark that the current bin specified by the bit is already updated
+ void setStateIsUpdated(int bit) {
+ stateUpdateMask &= ~(1 << bit);
+ }
+
+ // mark that the bin specified by the bit needs to be updated
+ void setStateToUpdate(int bit, Object bin) {
+ stateUpdateMask |= 1 << bit;
+ curStateToUpdate[bit] = bin;
+ }
+
+ // update LightBin, EnvironmentSet, AttributeBin & ShaderBin if neccessary
+ // according to the stateUpdateMask
+
+ static int ENV_STATE_MASK = (1 << LIGHTBIN_BIT) |
+ (1 << ENVIRONMENTSET_BIT) |
+ (1 << ATTRIBUTEBIN_BIT) |
+ (1 << SHADERBIN_BIT);
+
+ void updateEnvState() {
+
+ if ((stateUpdateMask & ENV_STATE_MASK) == 0)
+ return;
+
+ if ((stateUpdateMask & (1 << LIGHTBIN_BIT)) != 0) {
+ ((LightBin)curStateToUpdate[LIGHTBIN_BIT]).updateAttributes(this);
+ }
+
+ if ((stateUpdateMask & (1 << ENVIRONMENTSET_BIT)) != 0) {
+ ((EnvironmentSet)
+ curStateToUpdate[ENVIRONMENTSET_BIT]).updateAttributes(this);
+ }
+
+ if ((stateUpdateMask & (1 << ATTRIBUTEBIN_BIT)) != 0) {
+ ((AttributeBin)
+ curStateToUpdate[ATTRIBUTEBIN_BIT]).updateAttributes(this);
+ }
+
+ if ((stateUpdateMask & (1 << SHADERBIN_BIT)) != 0) {
+ ((ShaderBin)
+ curStateToUpdate[SHADERBIN_BIT]).updateAttributes(this);
+ }
+
+
+ // reset the state update mask for those environment state bits
+ stateUpdateMask &= ~ENV_STATE_MASK;
+ }
+
+ /**
+ * update state if neccessary according to the stateUpdatedMask
+ */
+ void updateState( int dirtyBits) {
+
+
+ if (stateUpdateMask == 0)
+ return;
+
+ updateEnvState();
+
+ if ((stateUpdateMask & (1 << TEXTUREBIN_BIT)) != 0) {
+ ((TextureBin)
+ curStateToUpdate[TEXTUREBIN_BIT]).updateAttributes(this);
+ }
+
+ if ((stateUpdateMask & (1 << RENDERMOLECULE_BIT)) != 0) {
+ ((RenderMolecule)
+ curStateToUpdate[RENDERMOLECULE_BIT]).updateAttributes(this,
+ dirtyBits);
+
+ }
+
+ if ((stateUpdateMask & (1 << TRANSPARENCY_BIT)) != 0) {
+ ((RenderMolecule)curStateToUpdate[RENDERMOLECULE_BIT]).updateTransparencyAttributes(this);
+ stateUpdateMask &= ~(1 << TRANSPARENCY_BIT);
+ }
+
+ // reset state update mask
+ stateUpdateMask = 0;
+ }
+
+
+ // This method updates this Texture2D for raster.
+ // Note : No multi-texture is not used.
+ void updateTextureForRaster(Texture2DRetained texture) {
+
+ // Setup texture and texture attributes for texture unit 0.
+ Pipeline.getPipeline().updateTextureUnitState(ctx, 0, true);
+ setLastActiveTexUnit(0);
+ setNumActiveTexUnit(1);
+
+ texture.updateNative(this);
+ resetTextureAttributes(ctx);
+
+ for(int i=1; i < maxTextureUnits; i++) {
+ resetTexture(ctx, i);
+ }
+
+ // set the active texture unit back to 0
+ activeTextureUnit(ctx, 0);
+
+ // Force the next textureBin to reload.
+ canvasDirty |= Canvas3D.TEXTUREBIN_DIRTY | Canvas3D.TEXTUREATTRIBUTES_DIRTY;
+ }
+
+ void restoreTextureBin() {
+
+ // Need to check TextureBin's shaderBin for null
+ // TextureBin can get clear() if there isn't any RM under it.
+ if((textureBin != null) && (textureBin.shaderBin != null)) {
+ textureBin.updateAttributes(this);
+ }
+ }
+
+ void textureFill(RasterRetained raster, Point2d winCoord,
+ float mapZ, float alpha) {
+
+ int winWidth = canvasViewCache.getCanvasWidth();
+ int winHeight = canvasViewCache.getCanvasHeight();
+
+ int rasterImageWidth = raster.image.width;
+ int rasterImageHeight = raster.image.height;
+
+ float texMinU = 0, texMinV = 0, texMaxU = 0, texMaxV = 0;
+ float mapMinX = 0, mapMinY = 0, mapMaxX = 0, mapMaxY = 0;
+
+ Point rasterSrcOffset = new Point();
+ raster.getSrcOffset(rasterSrcOffset);
+
+ Dimension rasterSize = new Dimension();
+ raster.getSize(rasterSize);
+
+// System.err.println("rasterImageWidth " + rasterImageWidth + " rasterImageHeight " + rasterImageHeight);
+// System.err.println("rasterSrcOffset " + rasterSrcOffset + " rasterSize " + rasterSize);
+
+ int rasterMinX = rasterSrcOffset.x;
+ int rasterMaxX = rasterSrcOffset.x + rasterSize.width;
+ int rasterMinY = rasterSrcOffset.y;
+ int rasterMaxY = rasterSrcOffset.y + rasterSize.height;
+
+ if ((rasterMinX >= rasterImageWidth) || (rasterMinY >= rasterImageHeight) ||
+ (rasterMaxX <= 0) || (rasterMaxY <= 0)) {
+ return;
+ }
+
+ if (rasterMinX < 0) {
+ rasterMinX = 0;
+ }
+ if (rasterMinY < 0) {
+ rasterMinY = 0;
+ }
+
+ if (rasterMaxX > rasterImageWidth) {
+ rasterMaxX = rasterImageWidth;
+ }
+
+ if (rasterMaxY > rasterImageHeight) {
+ rasterMaxY = rasterImageHeight;
+ }
+
+ texMinU = (float) rasterMinX / (float) rasterImageWidth;
+ texMaxU = (float) rasterMaxX / (float) rasterImageWidth;
+ mapMinX = (float) winCoord.x / (float) winWidth;
+ mapMaxX = (float) (winCoord.x + (rasterMaxX - rasterMinX)) / (float) winWidth;
+
+ if (raster.image.isYUp()) {
+ texMinV = (float) rasterMinY / (float) rasterImageHeight;
+ texMaxV = (float) rasterMaxY / (float) rasterImageHeight;
+ } else {
+ // System.err.println("In yUp is false case");
+ texMinV = 1.0f - (float) rasterMaxY / (float) rasterImageHeight;
+ texMaxV = 1.0f - (float) rasterMinY / (float) rasterImageHeight;
+ }
+
+ mapMinY = 1.0f - ((float) (winCoord.y + (rasterMaxY - rasterMinY)) / (float) winHeight);
+ mapMaxY = 1.0f - ((float) winCoord.y / (float) winHeight);
+
+ textureFillRaster(ctx, texMinU, texMaxU, texMinV, texMaxV,
+ mapMinX, mapMaxX, mapMinY, mapMaxY, mapZ, alpha, raster.image.useBilinearFilter());
+
+ }
+
+ void textureFill(BackgroundRetained bg, int winWidth, int winHeight) {
+
+ final int maxX = bg.image.width;
+ final int maxY = bg.image.height;
+
+// System.err.println("maxX " + maxX + " maxY " + maxY);
+
+ float xzoom = (float)winWidth / maxX;
+ float yzoom = (float)winHeight / maxY;
+ float zoom = 0;
+ float texMinU = 0, texMinV = 0, texMaxU = 0, texMaxV = 0, adjustV = 0;
+ float mapMinX = 0, mapMinY = 0, mapMaxX = 0, mapMaxY = 0;
+ float halfWidth = 0, halfHeight = 0;
+
+ switch (bg.imageScaleMode) {
+ case Background.SCALE_NONE:
+ texMinU = 0.0f;
+ texMinV = 0.0f;
+ texMaxU = 1.0f;
+ texMaxV = 1.0f;
+ halfWidth = (float)winWidth/2.0f;
+ halfHeight = (float)winHeight/2.0f;
+ mapMinX = (float) ((0 - halfWidth)/halfWidth);
+ mapMinY = (float) ((0 - halfHeight)/halfHeight);
+ mapMaxX = (float) ((maxX - halfWidth)/halfWidth);
+ mapMaxY = (float) ((maxY - halfHeight)/halfHeight);
+ adjustV = ((float)winHeight - (float)maxY)/halfHeight;
+ mapMinY += adjustV;
+ mapMaxY += adjustV;
+ break;
+ case Background.SCALE_FIT_MIN:
+ zoom = Math.min(xzoom, yzoom);
+ texMinU = 0.0f;
+ texMinV = 0.0f;
+ texMaxU = 1.0f;
+ texMaxV = 1.0f;
+ mapMinX = -1.0f;
+ mapMaxY = 1.0f;
+ if (xzoom < yzoom) {
+ mapMaxX = 1.0f;
+ mapMinY = -1.0f + 2.0f * ( 1.0f - zoom * (float)maxY/(float) winHeight );
+ } else {
+ mapMaxX = -1.0f + zoom * (float)maxX/winWidth * 2;
+ mapMinY = -1.0f;
+ }
+ break;
+ case Background.SCALE_FIT_MAX:
+ zoom = Math.max(xzoom, yzoom);
+ mapMinX = -1.0f;
+ mapMinY = -1.0f;
+ mapMaxX = 1.0f;
+ mapMaxY = 1.0f;
+ if (xzoom < yzoom) {
+ texMinU = 0.0f;
+ texMinV = 0.0f;
+ texMaxU = (float)winWidth/maxX/zoom;
+ texMaxV = 1.0f;
+ } else {
+ texMinU = 0.0f;
+ texMinV = 1.0f - (float)winHeight/maxY/zoom;
+ texMaxU = 1.0f;
+ texMaxV = 1.0f;
+ }
+ break;
+ case Background.SCALE_FIT_ALL:
+ texMinU = 0.0f;
+ texMinV = 0.0f;
+ texMaxU = 1.0f;
+ texMaxV = 1.0f;
+ mapMinX = -1.0f;
+ mapMinY = -1.0f;
+ mapMaxX = 1.0f;
+ mapMaxY = 1.0f;
+ break;
+ case Background.SCALE_REPEAT:
+
+ texMinU = 0.0f;
+ texMinV = - yzoom;
+ texMaxU = xzoom;
+ texMaxV = 0.0f;
+ mapMinX = -1.0f;
+ mapMinY = -1.0f;
+ mapMaxX = 1.0f;
+ mapMaxY = 1.0f;
+ break;
+ case Background.SCALE_NONE_CENTER:
+ // TODO : Why is there a zoom ?
+ if(xzoom >= 1.0f){
+ texMinU = 0.0f;
+ texMaxU = 1.0f;
+ mapMinX = -(float)maxX/winWidth;
+ mapMaxX = (float)maxX/winWidth;
+ } else {
+ texMinU = 0.5f - (float)winWidth/maxX/2;
+ texMaxU = 0.5f + (float)winWidth/maxX/2;
+ mapMinX = -1.0f;
+ mapMaxX = 1.0f;
+ }
+ if (yzoom >= 1.0f) {
+ texMinV = 0.0f;
+ texMaxV = 1.0f;
+ mapMinY = -(float)maxY/winHeight;
+ mapMaxY = (float)maxY/winHeight;
+ } else {
+ texMinV = 0.5f - (float)winHeight/maxY/2;
+ texMaxV = 0.5f + (float)winHeight/maxY/2;
+ mapMinY = -1.0f;
+ mapMaxY = 1.0f;
+ }
+ break;
+ }
+
+// System.err.println("Java 3D : mapMinX " + mapMinX + " mapMinY " + mapMinY +
+// " mapMaxX " + mapMaxX + " mapMaxY " + mapMaxY);
+ textureFillBackground(ctx, texMinU, texMaxU, texMinV, texMaxV,
+ mapMinX, mapMaxX, mapMinY, mapMaxY, bg.image.useBilinearFilter());
+
+ }
+
+
+ void clear(BackgroundRetained bg, int winWidth, int winHeight) {
+
+ // Issue 239 - clear stencil if requested and available
+ // Note that this is a partial solution, since we eventually want an API
+ // to control this.
+ boolean clearStencil = VirtualUniverse.mc.stencilClear &&
+ userStencilAvailable;
+
+ clear(ctx, bg.color.x, bg.color.y, bg.color.z, clearStencil);
+
+ // TODO : This is a bug on not mirror bg. Will fix this as a bug after 1.5 beta.
+ // For now, as a workaround, we will check bg.image and bg.image.imageData not null.
+ if((bg.image != null) && (bg.image.imageData != null)) {
+ // setup Texture pipe.
+ updateTextureForRaster(bg.texture);
+
+ textureFill(bg, winWidth, winHeight);
+
+ // Restore texture pipe.
+ restoreTextureBin();
+ }
+ }
+
+ /**
+ * obj is either TextureRetained or DetailTextureImage
+ * if obj is DetailTextureImage then we just clear
+ * the resourceCreationMask of all the formats
+ * no matter it is create or not since we don't
+ * remember the format information for simplicity.
+ * We don't need to check duplicate value of id in the
+ * table since this procedure is invoke only when id
+ * of texture is -1 one time only.
+ * This is always call from Renderer thread.
+ */
+ void addTextureResource(int id, Object obj) {
+ if (id <= 0) {
+ return;
+ }
+
+ if (useSharedCtx) {
+ screen.renderer.addTextureResource(id, obj);
+ } else {
+ // This will replace the previous key if exists
+ if (textureIDResourceTable.size() <= id) {
+ for (int i=textureIDResourceTable.size();
+ i < id; i++) {
+ textureIDResourceTable.add(null);
+ }
+ textureIDResourceTable.add(obj);
+ } else {
+ textureIDResourceTable.set(id, obj);
+ }
+
+ }
+ }
+
+ // handle free resource in the FreeList
+ void freeResourcesInFreeList(Context ctx) {
+ Iterator it;
+ ArrayList list;
+ int i, val;
+ GeometryArrayRetained geo;
+
+ // free resource for those canvases that
+ // don't use shared ctx
+ if (displayListResourceFreeList.size() > 0) {
+ for (it = displayListResourceFreeList.iterator(); it.hasNext();) {
+ val = ((Integer) it.next()).intValue();
+ if (val <= 0) {
+ continue;
+ }
+ freeDisplayList(ctx, val);
+ }
+ displayListResourceFreeList.clear();
+ }
+
+ if (textureIdResourceFreeList.size() > 0) {
+ for (it = textureIdResourceFreeList.iterator(); it.hasNext();) {
+ val = ((Integer) it.next()).intValue();
+ if (val <= 0) {
+ continue;
+ }
+ if (val >= textureIDResourceTable.size()) {
+ System.err.println("Error in freeResourcesInFreeList : ResourceIDTableSize = " +
+ textureIDResourceTable.size() +
+ " val = " + val);
+ } else {
+ Object obj = textureIDResourceTable.get(val);
+ if (obj instanceof TextureRetained) {
+ TextureRetained tex = (TextureRetained) obj;
+ synchronized (tex.resourceLock) {
+ tex.resourceCreationMask &= ~canvasBit;
+ if (tex.resourceCreationMask == 0) {
+ tex.freeTextureId(val);
+ }
+ }
+ }
+
+ textureIDResourceTable.set(val, null);
+ }
+ freeTexture(ctx, val);
+ }
+ textureIdResourceFreeList.clear();
+ }
+ }
+
+ void freeContextResources(Renderer rdr, boolean freeBackground,
+ Context ctx) {
+
+
+ Object obj;
+ TextureRetained tex;
+
+ // Just return if we don't have a valid renderer or context
+ if (rdr == null || ctx == null) {
+ return;
+ }
+
+ if (freeBackground) {
+ // Dispose of Graphics2D Texture
+ if (graphics2D != null) {
+ graphics2D.dispose();
+ }
+ }
+
+ for (int id = textureIDResourceTable.size()-1; id >= 0; id--) {
+ obj = textureIDResourceTable.get(id);
+ if (obj == null) {
+ continue;
+ }
+
+ // Issue 403 : this assertion doesn't hold in some cases
+ // TODO KCR : determine why this is the case
+// assert id == ((TextureRetained)obj).objectId;
+
+ freeTexture(ctx, id);
+ if (obj instanceof TextureRetained) {
+ tex = (TextureRetained) obj;
+ synchronized (tex.resourceLock) {
+ tex.resourceCreationMask &= ~canvasBit;
+ if (tex.resourceCreationMask == 0) {
+
+ tex.freeTextureId(id);
+ }
+ }
+ }
+ }
+ textureIDResourceTable.clear();
+
+ freeAllDisplayListResources(ctx);
+ }
+
+ void freeAllDisplayListResources(Context ctx) {
+ if ((view != null) && (view.renderBin != null)) {
+ view.renderBin.freeAllDisplayListResources(this, ctx);
+ if (useSharedCtx) {
+ // We need to rebuild all other Canvas3D resource
+ // shared by this Canvas3D. Since we didn't
+ // remember resource in Renderer but RenderBin only.
+ if ((screen != null) && (screen.renderer != null)) {
+ screen.renderer.needToRebuildDisplayList = true;
+ }
+ }
+ }
+
+ }
+
+
+ // *****************************************************************
+ // Wrappers for native methods go below here
+ // *****************************************************************
+
+ // This is the native method for creating the underlying graphics context.
+ private Context createNewContext(long display, Drawable drawable,
+ long fbConfig, Context shareCtx, boolean isSharedCtx,
+ boolean offScreen,
+ boolean glslLibraryAvailable,
+ boolean cgLibraryAvailable) {
+ return Pipeline.getPipeline().createNewContext(this, display, drawable,
+ fbConfig, shareCtx, isSharedCtx,
+ offScreen,
+ glslLibraryAvailable,
+ cgLibraryAvailable);
+ }
+
+ private void createQueryContext(long display, Drawable drawable,
+ long fbConfig, boolean offScreen, int width, int height,
+ boolean glslLibraryAvailable,
+ boolean cgLibraryAvailable) {
+ Pipeline.getPipeline().createQueryContext(this, display, drawable,
+ fbConfig, offScreen, width, height,
+ glslLibraryAvailable,
+ cgLibraryAvailable);
+ }
+
+ // This is the native for creating offscreen buffer
+ Drawable createOffScreenBuffer(Context ctx, long display, long fbConfig, int width, int height) {
+ return Pipeline.getPipeline().createOffScreenBuffer(this,
+ ctx, display, fbConfig, width, height);
+ }
+
+ void destroyOffScreenBuffer(Context ctx, long display, long fbConfig, Drawable drawable) {
+ assert drawable != null;
+ Pipeline.getPipeline().destroyOffScreenBuffer(this, ctx, display, fbConfig, drawable);
+ }
+
+ // This is the native for reading the image from the offscreen buffer
+ private void readOffScreenBuffer(Context ctx, int format, int type, Object data, int width, int height) {
+ Pipeline.getPipeline().readOffScreenBuffer(this, ctx, format, type, data, width, height);
+ }
+
+ // The native method for swapBuffers
+ int swapBuffers(Context ctx, long dpy, Drawable drawable) {
+ return Pipeline.getPipeline().swapBuffers(this, ctx, dpy, drawable);
+ }
+
+ // notify D3D that Canvas is resize
+ private int resizeD3DCanvas(Context ctx) {
+ return Pipeline.getPipeline().resizeD3DCanvas(this, ctx);
+ }
+
+ // notify D3D to toggle between FullScreen and window mode
+ private int toggleFullScreenMode(Context ctx) {
+ return Pipeline.getPipeline().toggleFullScreenMode(this, ctx);
+ }
+
+ // -----------------------------------------------------------------------------
+
+ // native method for setting Material when no material is present
+ void updateMaterial(Context ctx, float r, float g, float b, float a) {
+ Pipeline.getPipeline().updateMaterialColor(ctx, r, g, b, a);
+ }
+
+ static void destroyContext(long display, Drawable drawable, Context ctx) {
+ Pipeline.getPipeline().destroyContext(display, drawable, ctx);
+ }
+
+ // This is the native method for doing accumulation.
+ void accum(Context ctx, float value) {
+ Pipeline.getPipeline().accum(ctx, value);
+ }
+
+ // This is the native method for doing accumulation return.
+ void accumReturn(Context ctx) {
+ Pipeline.getPipeline().accumReturn(ctx);
+ }
+
+ // This is the native method for clearing the accumulation buffer.
+ void clearAccum(Context ctx) {
+ Pipeline.getPipeline().clearAccum(ctx);
+ }
+
+ // This is the native method for getting the number of lights the underlying
+ // native library can support.
+ int getNumCtxLights(Context ctx) {
+ return Pipeline.getPipeline().getNumCtxLights(ctx);
+ }
+
+ // Native method for decal 1st child setup
+ boolean decal1stChildSetup(Context ctx) {
+ return Pipeline.getPipeline().decal1stChildSetup(ctx);
+ }
+
+ // Native method for decal nth child setup
+ void decalNthChildSetup(Context ctx) {
+ Pipeline.getPipeline().decalNthChildSetup(ctx);
+ }
+
+ // Native method for decal reset
+ void decalReset(Context ctx, boolean depthBufferEnable) {
+ Pipeline.getPipeline().decalReset(ctx, depthBufferEnable);
+ }
+
+ // Native method for decal reset
+ void ctxUpdateEyeLightingEnable(Context ctx, boolean localEyeLightingEnable) {
+ Pipeline.getPipeline().ctxUpdateEyeLightingEnable(ctx, localEyeLightingEnable);
+ }
+
+ // The following three methods are used in multi-pass case
+
+ // native method for setting blend color
+ void setBlendColor(Context ctx, float red, float green,
+ float blue, float alpha) {
+ Pipeline.getPipeline().setBlendColor(ctx, red, green,
+ blue, alpha);
+ }
+
+ // native method for setting blend func
+ void setBlendFunc(Context ctx, int src, int dst) {
+ Pipeline.getPipeline().setBlendFunc(ctx, src, dst);
+ }
+
+ // native method for setting fog enable flag
+ void setFogEnableFlag(Context ctx, boolean enableFlag) {
+ Pipeline.getPipeline().setFogEnableFlag(ctx, enableFlag);
+ }
+
+ // Setup the full scene antialising in D3D and ogl when GL_ARB_multisamle supported
+ void setFullSceneAntialiasing(Context ctx, boolean enable) {
+ Pipeline.getPipeline().setFullSceneAntialiasing(ctx, enable);
+ }
+
+ void setGlobalAlpha(Context ctx, float alpha) {
+ Pipeline.getPipeline().setGlobalAlpha(ctx, alpha);
+ }
+
+ // Native method to update separate specular color control
+ void updateSeparateSpecularColorEnable(Context ctx, boolean control) {
+ Pipeline.getPipeline().updateSeparateSpecularColorEnable(ctx, control);
+ }
+
+ // Initialization for D3D when scene begin
+ private void beginScene(Context ctx) {
+ Pipeline.getPipeline().beginScene(ctx);
+ }
+ private void endScene(Context ctx) {
+ Pipeline.getPipeline().endScene(ctx);
+ }
+
+ // True under Solaris,
+ // False under windows when display mode <= 8 bit
+ private boolean validGraphicsMode() {
+ return Pipeline.getPipeline().validGraphicsMode();
+ }
+
+ // native method for setting light enables
+ void setLightEnables(Context ctx, long enableMask, int maxLights) {
+ Pipeline.getPipeline().setLightEnables(ctx, enableMask, maxLights);
+ }
+
+ // native method for setting scene ambient
+ void setSceneAmbient(Context ctx, float red, float green, float blue) {
+ Pipeline.getPipeline().setSceneAmbient(ctx, red, green, blue);
+ }
+
+ // native method for disabling fog
+ void disableFog(Context ctx) {
+ Pipeline.getPipeline().disableFog(ctx);
+ }
+
+ // native method for disabling modelClip
+ void disableModelClip(Context ctx) {
+ Pipeline.getPipeline().disableModelClip(ctx);
+ }
+
+ // native method for setting default RenderingAttributes
+ void resetRenderingAttributes(Context ctx,
+ boolean depthBufferWriteEnableOverride,
+ boolean depthBufferEnableOverride) {
+ Pipeline.getPipeline().resetRenderingAttributes(ctx,
+ depthBufferWriteEnableOverride,
+ depthBufferEnableOverride);
+ }
+
+ // native method for setting default texture
+ void resetTextureNative(Context ctx, int texUnitIndex) {
+ Pipeline.getPipeline().resetTextureNative(ctx, texUnitIndex);
+ }
+
+ // native method for activating a particular texture unit
+ void activeTextureUnit(Context ctx, int texUnitIndex) {
+ Pipeline.getPipeline().activeTextureUnit(ctx, texUnitIndex);
+ }
+
+ // native method for setting default TexCoordGeneration
+ void resetTexCoordGeneration(Context ctx) {
+ Pipeline.getPipeline().resetTexCoordGeneration(ctx);
+ }
+
+ // native method for setting default TextureAttributes
+ void resetTextureAttributes(Context ctx) {
+ Pipeline.getPipeline().resetTextureAttributes(ctx);
+ }
+
+ // native method for setting default PolygonAttributes
+ void resetPolygonAttributes(Context ctx) {
+ Pipeline.getPipeline().resetPolygonAttributes(ctx);
+ }
+
+ // native method for setting default LineAttributes
+ void resetLineAttributes(Context ctx) {
+ Pipeline.getPipeline().resetLineAttributes(ctx);
+ }
+
+ // native method for setting default PointAttributes
+ void resetPointAttributes(Context ctx) {
+ Pipeline.getPipeline().resetPointAttributes(ctx);
+ }
+
+ // native method for setting default TransparencyAttributes
+ void resetTransparency(Context ctx, int geometryType,
+ int polygonMode, boolean lineAA,
+ boolean pointAA) {
+ Pipeline.getPipeline().resetTransparency(ctx, geometryType,
+ polygonMode, lineAA,
+ pointAA);
+ }
+
+ // native method for setting default ColoringAttributes
+ void resetColoringAttributes(Context ctx,
+ float r, float g,
+ float b, float a,
+ boolean enableLight) {
+ Pipeline.getPipeline().resetColoringAttributes(ctx,
+ r, g,
+ b, a,
+ enableLight);
+ }
+
+ /**
+ * This native method makes sure that the rendering for this canvas
+ * gets done now.
+ */
+ void syncRender(Context ctx, boolean wait) {
+ Pipeline.getPipeline().syncRender(ctx, wait);
+ }
+
+ // The native method that sets this ctx to be the current one
+ static boolean useCtx(Context ctx, long display, Drawable drawable) {
+ return Pipeline.getPipeline().useCtx(ctx, display, drawable);
+ }
+
+ // Give the Pipeline a chance to release the context. The return
+ // value indicates whether the context was released.
+ private boolean releaseCtx(Context ctx, long dpy) {
+ return Pipeline.getPipeline().releaseCtx(ctx, dpy);
+ }
+
+ void clear(Context ctx, float r, float g, float b, boolean clearStencil) {
+ Pipeline.getPipeline().clear(ctx, r, g, b, clearStencil);
+ }
+
+ void textureFillBackground(Context ctx, float texMinU, float texMaxU, float texMinV, float texMaxV,
+ float mapMinX, float mapMaxX, float mapMinY, float mapMaxY, boolean useBiliearFilter) {
+ Pipeline.getPipeline().textureFillBackground(ctx, texMinU, texMaxU, texMinV, texMaxV,
+ mapMinX, mapMaxX, mapMinY, mapMaxY, useBiliearFilter);
+ }
+
+ void textureFillRaster(Context ctx, float texMinU, float texMaxU, float texMinV, float texMaxV,
+ float mapMinX, float mapMaxX, float mapMinY, float mapMaxY, float mapZ, float alpha, boolean useBiliearFilter) {
+ Pipeline.getPipeline().textureFillRaster(ctx, texMinU, texMaxU, texMinV, texMaxV,
+ mapMinX, mapMaxX, mapMinY, mapMaxY, mapZ, alpha, useBiliearFilter);
+ }
+
+ void executeRasterDepth(Context ctx, float posX, float posY, float posZ,
+ int srcOffsetX, int srcOffsetY, int rasterWidth, int rasterHeight,
+ int depthWidth, int depthHeight, int depthType, Object depthData) {
+ Pipeline.getPipeline().executeRasterDepth(ctx, posX, posY, posZ,
+ srcOffsetX, srcOffsetY, rasterWidth, rasterHeight, depthWidth, depthHeight, depthType, depthData);
+ }
+
+ // The native method for setting the ModelView matrix.
+ void setModelViewMatrix(Context ctx, double[] viewMatrix, double[] modelMatrix) {
+ Pipeline.getPipeline().setModelViewMatrix(ctx, viewMatrix, modelMatrix);
+ }
+
+ // The native method for setting the Projection matrix.
+ void setProjectionMatrix(Context ctx, double[] projMatrix) {
+ Pipeline.getPipeline().setProjectionMatrix(ctx, projMatrix);
+ }
+
+ // The native method for setting the Viewport.
+ void setViewport(Context ctx, int x, int y, int width, int height) {
+ Pipeline.getPipeline().setViewport(ctx, x, y, width, height);
+ }
+
+ // used for display Lists
+ void newDisplayList(Context ctx, int displayListId) {
+ Pipeline.getPipeline().newDisplayList(ctx, displayListId);
+ }
+ void endDisplayList(Context ctx) {
+ Pipeline.getPipeline().endDisplayList(ctx);
+ }
+ void callDisplayList(Context ctx, int id, boolean isNonUniformScale) {
+ Pipeline.getPipeline().callDisplayList(ctx, id, isNonUniformScale);
+ }
+
+ static void freeDisplayList(Context ctx, int id) {
+ Pipeline.getPipeline().freeDisplayList(ctx, id);
+ }
+ static void freeTexture(Context ctx, int id) {
+ Pipeline.getPipeline().freeTexture(ctx, id);
+ }
+
+ void texturemapping(Context ctx,
+ int px, int py,
+ int xmin, int ymin, int xmax, int ymax,
+ int texWidth, int texHeight,
+ int rasWidth,
+ int format, int objectId,
+ byte[] image,
+ int winWidth, int winHeight) {
+ Pipeline.getPipeline().texturemapping(ctx,
+ px, py,
+ xmin, ymin, xmax, ymax,
+ texWidth, texHeight,
+ rasWidth,
+ format, objectId,
+ image,
+ winWidth, winHeight);
+ }
+
+ boolean initTexturemapping(Context ctx, int texWidth,
+ int texHeight, int objectId) {
+ return Pipeline.getPipeline().initTexturemapping(ctx, texWidth,
+ texHeight, objectId);
+ }
+
+
+ // Set internal render mode to one of FIELD_ALL, FIELD_LEFT or
+ // FIELD_RIGHT. Note that it is up to the caller to ensure that
+ // stereo is available before setting the mode to FIELD_LEFT or
+ // FIELD_RIGHT. The boolean isTRUE for double buffered mode, FALSE
+ // foe single buffering.
+ void setRenderMode(Context ctx, int mode, boolean doubleBuffer) {
+ Pipeline.getPipeline().setRenderMode(ctx, mode, doubleBuffer);
+ }
+
+ // Set glDepthMask.
+ void setDepthBufferWriteEnable(Context ctx, boolean mode) {
+ Pipeline.getPipeline().setDepthBufferWriteEnable(ctx, mode);
+ }
+
+ // Methods to get actual capabilities from Canvas3D
+
+ boolean hasDoubleBuffer() {
+ return Pipeline.getPipeline().hasDoubleBuffer(this);
+ }
+
+ boolean hasStereo() {
+ return Pipeline.getPipeline().hasStereo(this);
+ }
+
+ int getStencilSize() {
+ return Pipeline.getPipeline().getStencilSize(this);
+ }
+
+ boolean hasSceneAntialiasingMultisample() {
+ return Pipeline.getPipeline().hasSceneAntialiasingMultisample(this);
+ }
+
+ boolean hasSceneAntialiasingAccum() {
+ return Pipeline.getPipeline().hasSceneAntialiasingAccum(this);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CanvasViewCache.java b/j3d-core/src/classes/share/javax/media/j3d/CanvasViewCache.java
new file mode 100644
index 0000000..419dc63
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CanvasViewCache.java
@@ -0,0 +1,2046 @@
+/*
+ * $RCSfile: CanvasViewCache.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.Point;
+import java.awt.Dimension;
+import java.awt.Rectangle;
+import java.awt.IllegalComponentStateException;
+import javax.vecmath.*;
+
+/**
+ * The CanvasViewCache class is used to cache all data, both API data
+ * and derived data, that is dependent on the Canvas3D or Screen3D.
+ * The final view and projection matrices are stored here.
+ */
+
+class CanvasViewCache extends Object {
+ // Used for debugging only
+ private static Object debugLock = new Object();
+
+ // The canvas associated with this canvas view cache
+ private Canvas3D canvas;
+
+ // Mask that indicates this CanvasViewCache view dependence info. has changed,
+ // and CanvasViewCache may need to recompute the final view matries.
+ int cvcDirtyMask = 0;
+
+ // The screen view cache associated with this canvas view cache
+ private ScreenViewCache screenViewCache;
+
+ // The view cache associated with this canvas view cache
+ private ViewCache viewCache;
+
+ // *************
+ // API/INPUT DATA
+ // *************
+
+ // The position and size of the canvas (in pixels)
+ private int awtCanvasX;
+ private int awtCanvasY;
+ private int awtCanvasWidth;
+ private int awtCanvasHeight;
+
+ // The current RenderBin used for rendering during the frame
+ // associated with this snapshot.
+ private RenderBin renderBin;
+
+ // Flag indicating whether or not stereo will be used. Computed by
+ // Canvas3D as: useStereo = stereoEnable && stereoAvailable
+ private boolean useStereo;
+
+ // Current monoscopic view policy from canvas
+ private int monoscopicViewPolicy;
+
+ // The manual positions of the left and right eyes in image-plate
+ // coordinates.
+ // Note that these values are only used in non-head-tracked mode
+ // when the view's window eyepoint policy is one of RELATIVE_TO_SCREEN
+ // or RELATIVE_TO_WINDOW.
+ private Point3d leftManualEyeInImagePlate = new Point3d();
+ private Point3d rightManualEyeInImagePlate = new Point3d();
+
+ // *************
+ // DERIVED DATA
+ // *************
+
+ // The width and height of the screen in meters (from ScreenViewCache)
+ double physicalScreenWidth;
+ double physicalScreenHeight;
+
+ // The width and height of the screen in pixels (from ScreenViewCache)
+ int screenWidth;
+ int screenHeight;
+
+ // Meters per pixel in the X and Y dimension (from ScreenViewCache)
+ double metersPerPixelX;
+ double metersPerPixelY;
+
+ // The position and size of the canvas (in pixels)
+ private int canvasX;
+ private int canvasY;
+ private int canvasWidth;
+ private int canvasHeight;
+
+ // Either the Canvas' or the View's monoscopicViewPolicy
+ private int effectiveMonoscopicViewPolicy;
+
+ // The current cached projection transforms.
+ private Transform3D leftProjection = new Transform3D();
+ private Transform3D rightProjection = new Transform3D();
+ private Transform3D infLeftProjection = new Transform3D();
+ private Transform3D infRightProjection = new Transform3D();
+
+ // The current cached viewing transforms.
+ private Transform3D leftVpcToEc = new Transform3D();
+ private Transform3D rightVpcToEc = new Transform3D();
+ private Transform3D infLeftVpcToEc = new Transform3D();
+ private Transform3D infRightVpcToEc = new Transform3D();
+
+ // The current cached inverse viewing transforms.
+ private Transform3D leftEcToVpc = new Transform3D();
+ private Transform3D rightEcToVpc = new Transform3D();
+ private Transform3D infLeftEcToVpc = new Transform3D();
+ private Transform3D infRightEcToVpc = new Transform3D();
+
+ // Arrays of Vector4d objects that represent the plane equations for
+ // the 6 planes in the viewing frustum in ViewPlatform coordinates.
+ private Vector4d[] leftFrustumPlanes = new Vector4d[6];
+ private Vector4d[] rightFrustumPlanes = new Vector4d[6];
+
+ // Arrays of Vector4d objects that represent the volume of viewing frustum
+ private Point4d leftFrustumPoints[] = new Point4d[8];
+ private Point4d rightFrustumPoints[] = new Point4d[8];
+
+ // Calibration matrix from Screen object for HMD mode using
+ // non-field-sequential stereo
+
+ private Transform3D headTrackerToLeftImagePlate = new Transform3D();
+ private Transform3D headTrackerToRightImagePlate = new Transform3D();
+
+ // Head tracked version of eye in imageplate
+ private Point3d leftTrackedEyeInImagePlate = new Point3d();
+ private Point3d rightTrackedEyeInImagePlate = new Point3d();
+
+ // Derived version of eye in image plate coordinates
+ private Point3d leftEyeInImagePlate = new Point3d();
+ private Point3d rightEyeInImagePlate = new Point3d();
+ private Point3d centerEyeInImagePlate = new Point3d();
+
+ // Derived version of nominalEyeOffsetFromNominalScreen
+ private double nominalEyeOffset;
+
+ // Physical window position,size and center (in image plate coordinates)
+ private double physicalWindowXLeft;
+ private double physicalWindowYBottom;
+ private double physicalWindowXRight;
+ private double physicalWindowYTop;
+ private double physicalWindowWidth;
+ private double physicalWindowHeight;
+ private Point3d physicalWindowCenter = new Point3d();
+
+ // Screen scale value from viewCache or from screen size.
+ private double screenScale;
+
+ // Window scale value that compensates for window size if
+ // the window resize policy is PHYSICAL_WORLD.
+ private double windowScale;
+
+ // ViewPlatform scale that takes coordinates from view platform
+ // coordinates and scales them to physical coordinates
+ private double viewPlatformScale;
+
+ // Various derived transforms
+
+ private Transform3D leftCcToVworld = new Transform3D();
+ private Transform3D rightCcToVworld = new Transform3D();
+
+ private Transform3D coexistenceToLeftPlate = new Transform3D();
+ private Transform3D coexistenceToRightPlate = new Transform3D();
+
+ private Transform3D vpcToCoexistence = new Transform3D();
+
+ private Transform3D vpcToLeftPlate = new Transform3D();
+ private Transform3D vpcToRightPlate = new Transform3D();
+ private Transform3D leftPlateToVpc = new Transform3D();
+ private Transform3D rightPlateToVpc = new Transform3D();
+ private Transform3D vworldToLeftPlate = new Transform3D();
+ private Transform3D lastVworldToLeftPlate = new Transform3D();
+ private Transform3D vworldToRightPlate = new Transform3D();
+ private Transform3D leftPlateToVworld = new Transform3D();
+ private Transform3D rightPlateToVworld = new Transform3D();
+ private Transform3D headToLeftImagePlate = new Transform3D();
+ private Transform3D headToRightImagePlate = new Transform3D();
+
+ private Transform3D vworldToTrackerBase = new Transform3D();
+ private Transform3D tempTrans = new Transform3D();
+ private Transform3D headToVworld = new Transform3D();
+ private Vector3d coexistenceCenter = new Vector3d();
+
+ // scale for transformimg clip and fog distances
+ private double vworldToCoexistenceScale;
+ private double infVworldToCoexistenceScale;
+
+ //
+ // Temporary matrices and vectors, so we dont generate garbage
+ //
+ private Transform3D tMat1 = new Transform3D();
+ private Transform3D tMat2 = new Transform3D();
+ private Vector3d tVec1 = new Vector3d();
+ private Vector3d tVec2 = new Vector3d();
+ private Vector3d tVec3 = new Vector3d();
+ private Point3d tPnt1 = new Point3d();
+ private Point3d tPnt2 = new Point3d();
+
+ private Matrix4d tMatrix = new Matrix4d();
+
+ /**
+ * The view platform transforms.
+ */
+ private Transform3D vworldToVpc = new Transform3D();
+ private Transform3D vpcToVworld = new Transform3D();
+ private Transform3D infVworldToVpc = new Transform3D();
+
+ // This flag is used to remember the last time doInfinite flag
+ // is true or not.
+ // If this cache is updated twice, the first time in RenderBin
+ // updateViewCache() and the second time in Renderer with
+ // geometryBackground. The first time will reset the vcDirtyMask
+ // to 0 so that geometry background will not get updated the
+ // second time doComputeDerivedData() is invoked when view change.
+ private boolean lastDoInfinite = false;
+ private boolean updateLastTime = false;
+
+ void getCanvasPositionAndSize() {
+ if(J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2) {
+ System.err.println("Get canvas position and size");
+ System.err.println("Before");
+ System.err.println("Canvas pos = (" + awtCanvasX + ", " +
+ awtCanvasY + "), size = " + awtCanvasWidth +
+ "x" + awtCanvasHeight);
+ System.err.println("After");
+ }
+ awtCanvasX = canvas.newPosition.x;
+ awtCanvasY = canvas.newPosition.y;
+ awtCanvasWidth = canvas.newSize.width;
+ awtCanvasHeight = canvas.newSize.height;
+
+ // The following works around problem when awt creates 0-size
+ // window at startup
+ if ((awtCanvasWidth <= 0) || (awtCanvasHeight <= 0)) {
+ awtCanvasWidth = 1;
+ awtCanvasHeight = 1;
+ }
+
+ if (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1) {
+ System.err.println("Canvas pos = (" + awtCanvasX + ", " +
+ awtCanvasY + "), size = " + awtCanvasWidth +
+ "x" + awtCanvasHeight);
+ }
+ }
+
+ void computefrustumBBox(BoundingBox frustumBBox) {
+ int i;
+
+ for(i = 0; i < leftFrustumPoints.length; i++) {
+ if(frustumBBox.lower.x > leftFrustumPoints[i].x)
+ frustumBBox.lower.x = leftFrustumPoints[i].x;
+ if(frustumBBox.lower.y > leftFrustumPoints[i].y)
+ frustumBBox.lower.y = leftFrustumPoints[i].y;
+ if(frustumBBox.lower.z > leftFrustumPoints[i].z)
+ frustumBBox.lower.z = leftFrustumPoints[i].z;
+
+ if(frustumBBox.upper.x < leftFrustumPoints[i].x)
+ frustumBBox.upper.x = leftFrustumPoints[i].x;
+ if(frustumBBox.upper.y < leftFrustumPoints[i].y)
+ frustumBBox.upper.y = leftFrustumPoints[i].y;
+ if(frustumBBox.upper.z < leftFrustumPoints[i].z)
+ frustumBBox.upper.z = leftFrustumPoints[i].z;
+ }
+
+ if(useStereo) {
+
+ for(i = 0; i< rightFrustumPoints.length; i++) {
+ if(frustumBBox.lower.x > rightFrustumPoints[i].x)
+ frustumBBox.lower.x = rightFrustumPoints[i].x;
+ if(frustumBBox.lower.y > rightFrustumPoints[i].y)
+ frustumBBox.lower.y = rightFrustumPoints[i].y;
+ if(frustumBBox.lower.z > rightFrustumPoints[i].z)
+ frustumBBox.lower.z = rightFrustumPoints[i].z;
+
+ if(frustumBBox.upper.x < rightFrustumPoints[i].x)
+ frustumBBox.upper.x = rightFrustumPoints[i].x;
+ if(frustumBBox.upper.y < rightFrustumPoints[i].y)
+ frustumBBox.upper.y = rightFrustumPoints[i].y;
+ if(frustumBBox.upper.z < rightFrustumPoints[i].z)
+ frustumBBox.upper.z = rightFrustumPoints[i].z;
+ }
+
+ }
+ }
+
+
+ void copyComputedCanvasViewCache(CanvasViewCache cvc, boolean doInfinite) {
+ // For performance reason, only data needed by renderer are copied.
+ // useStereo,
+ // canvasWidth,
+ // canvasHeight,
+ // leftProjection,
+ // rightProjection,
+ // leftVpcToEc,
+ // rightVpcToEc,
+ // leftFrustumPlanes,
+ // rightFrustumPlanes,
+ // vpcToVworld,
+ // vworldToVpc.
+
+ cvc.useStereo = useStereo;
+ cvc.canvasWidth = canvasWidth;
+ cvc.canvasHeight = canvasHeight;
+ cvc.leftProjection.set(leftProjection);
+ cvc.rightProjection.set(rightProjection);
+ cvc.leftVpcToEc.set(leftVpcToEc) ;
+ cvc.rightVpcToEc.set(rightVpcToEc) ;
+
+ cvc.vpcToVworld = vpcToVworld;
+ cvc.vworldToVpc.set(vworldToVpc);
+
+ if (doInfinite) {
+ cvc.infLeftProjection.set(infLeftProjection);
+ cvc.infRightProjection.set(infRightProjection);
+ cvc.infLeftVpcToEc.set(infLeftVpcToEc) ;
+ cvc.infRightVpcToEc.set(infRightVpcToEc) ;
+ cvc.infVworldToVpc.set(infVworldToVpc);
+ }
+
+ for (int i = 0; i < leftFrustumPlanes.length; i++) {
+ cvc.leftFrustumPlanes[i].x = leftFrustumPlanes[i].x;
+ cvc.leftFrustumPlanes[i].y = leftFrustumPlanes[i].y;
+ cvc.leftFrustumPlanes[i].z = leftFrustumPlanes[i].z;
+ cvc.leftFrustumPlanes[i].w = leftFrustumPlanes[i].w;
+
+ cvc.rightFrustumPlanes[i].x = rightFrustumPlanes[i].x;
+ cvc.rightFrustumPlanes[i].y = rightFrustumPlanes[i].y;
+ cvc.rightFrustumPlanes[i].z = rightFrustumPlanes[i].z;
+ cvc.rightFrustumPlanes[i].w = rightFrustumPlanes[i].w;
+ }
+ }
+
+
+ /**
+ * Take snapshot of all per-canvas API parameters and input values.
+ * NOTE: This is probably not needed, but we'll do it for symmetry
+ * with the ScreenViewCache and ViewCache objects.
+ */
+ synchronized void snapshot(boolean computeFrustum) {
+ // Issue 109 : determine the the correct index to use -- either the
+ // Renderer or RenderBin
+ int dirtyIndex = computeFrustum ?
+ Canvas3D.RENDER_BIN_DIRTY_IDX : Canvas3D.RENDERER_DIRTY_IDX;
+
+ synchronized (canvas.dirtyMaskLock) {
+ // Issue 109 : read/clear the dirty bits for the correct index
+ cvcDirtyMask = canvas.cvDirtyMask[dirtyIndex];
+ canvas.cvDirtyMask[dirtyIndex] = 0;
+ }
+
+ useStereo = canvas.useStereo;
+ monoscopicViewPolicy = canvas.monoscopicViewPolicy;
+ leftManualEyeInImagePlate.set(canvas.leftManualEyeInImagePlate);
+ rightManualEyeInImagePlate.set(canvas.rightManualEyeInImagePlate);
+
+ if(( cvcDirtyMask & Canvas3D.MOVED_OR_RESIZED_DIRTY) != 0) {
+ getCanvasPositionAndSize();
+ }
+
+ renderBin = canvas.view.renderBin;
+
+ }
+
+ /**
+ * Compute derived data using the snapshot of the per-canvas,
+ * per-screen and per-view data.
+ */
+ synchronized void computeDerivedData(boolean currentFlag,
+ CanvasViewCache cvc, BoundingBox frustumBBox, boolean doInfinite) {
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1)) {
+ synchronized(debugLock) {
+ System.err.println("------------------------------");
+ doComputeDerivedData(currentFlag,cvc,frustumBBox,doInfinite);
+ }
+ }
+ else {
+ doComputeDerivedData(currentFlag,cvc,frustumBBox,doInfinite);
+ }
+ }
+
+ /**
+ * Compute derived data using the snapshot of the per-canvas,
+ * per-screen and per-view data. Caller must synchronize before
+ * calling this method.
+ */
+ private void doComputeDerivedData(boolean currentFlag,
+ CanvasViewCache cvc, BoundingBox frustumBBox, boolean doInfinite) {
+
+ // Issue 109 : determine the the correct index to use -- either the
+ // Renderer or RenderBin
+ int dirtyIndex = (frustumBBox != null) ?
+ Canvas3D.RENDER_BIN_DIRTY_IDX : Canvas3D.RENDERER_DIRTY_IDX;
+ int scrvcDirtyMask;
+
+ // Issue 109 : read/clear the dirty bits for the correct index
+ synchronized (screenViewCache) {
+ scrvcDirtyMask = screenViewCache.scrvcDirtyMask[dirtyIndex];
+ // reset screen view dirty mask if canvas is offScreen. Note:
+ // there is only one canvas per offscreen, so it is ok to
+ // do the reset here.
+ if (canvas.offScreen) {
+ screenViewCache.scrvcDirtyMask[dirtyIndex] = 0;
+ }
+ }
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ if(cvcDirtyMask != 0)
+ System.err.println("cvcDirtyMask : " + cvcDirtyMask);
+
+ if(scrvcDirtyMask != 0)
+ System.err.println("scrvcDirtyMask : "+ scrvcDirtyMask);
+
+ if(viewCache.vcDirtyMask != 0)
+ System.err.println("vcDirtyMask : " + viewCache.vcDirtyMask);
+ }
+
+
+ // NOTE: This fix is only fixing the symptoms, but not the
+ // root of the bug. We shouldn't have to check for null here.
+ if(viewCache.vpRetained == null) {
+ System.err.println("CanvasViewCache : Error! viewCache.vpRetained is null");
+ return;
+ }
+
+ // This flag is use to force a computation when a ViewPlatformTransform
+ // is detected. No sync. needed. We're doing a read of t/f.
+ // XXXX: Peeking at the dirty flag is a hack. Need to revisit this.
+ boolean vprNotDirty = (viewCache.vpRetained.vprDirtyMask == 0);
+
+ // Issue 131: If not manual, it has to be considered as an onscreen canvas.
+ if(!canvas.manualRendering &&
+ (vprNotDirty) &&
+ (cvcDirtyMask == 0) &&
+ (scrvcDirtyMask == 0) &&
+ (viewCache.vcDirtyMask == 0) &&
+ !(updateLastTime && (doInfinite != lastDoInfinite))) {
+ if(frustumBBox != null)
+ computefrustumBBox(frustumBBox);
+
+ // Copy the computed data into cvc.
+ if(cvc != null) {
+ copyComputedCanvasViewCache(cvc, doInfinite);
+ }
+ lastDoInfinite = doInfinite;
+ updateLastTime = false;
+ return;
+ }
+
+ lastDoInfinite = doInfinite;
+ updateLastTime = true;
+
+ if(currentFlag) {
+ vpcToVworld.set(viewCache.vpRetained.getCurrentLocalToVworld(null));
+ }
+ else {
+ vpcToVworld.set(viewCache.vpRetained.getLastLocalToVworld(null));
+ }
+
+ // System.err.println("vpcToVworld is \n" + vpcToVworld);
+
+ try {
+ vworldToVpc.invert(vpcToVworld);
+ }
+ catch (SingularMatrixException e) {
+ vworldToVpc.setIdentity();
+ //System.err.println("SingularMatrixException encountered when doing vworldToVpc invert");
+ }
+ if (doInfinite) {
+ vworldToVpc.getRotation(infVworldToVpc);
+ }
+
+ // Compute global flags
+ if (monoscopicViewPolicy == View.CYCLOPEAN_EYE_VIEW)
+ effectiveMonoscopicViewPolicy = viewCache.monoscopicViewPolicy;
+ else
+ effectiveMonoscopicViewPolicy = monoscopicViewPolicy;
+
+ // Recompute info about current canvas window
+ computeCanvasInfo();
+
+ // Compute coexistence center (in plate coordinates)
+ computeCoexistenceCenter();
+
+ // Get Eye position in image-plate coordinates
+ cacheEyePosition();
+
+ // Compute VPC to COE and COE to PLATE transforms
+ computeVpcToCoexistence();
+ computeCoexistenceToPlate();
+
+ // Compute view and projection matrices
+ computeView(doInfinite);
+
+
+ computePlateToVworld();
+
+ if (!currentFlag) {
+ // save the result for use in RasterRetained computeWinCoord
+ lastVworldToLeftPlate.set(vworldToLeftPlate);
+ }
+ computeHeadToVworld();
+
+ if (frustumBBox != null)
+ computefrustumBBox(frustumBBox);
+
+ // Issue 109: cvc should *always* be null
+ assert cvc == null;
+ if(cvc != null)
+ copyComputedCanvasViewCache(cvc, doInfinite);
+
+ canvas.canvasDirty |= Canvas3D.VIEW_MATRIX_DIRTY;
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1)) {
+ // Print some data :
+ System.err.println("useStereo = " + useStereo);
+ System.err.println("leftProjection:\n" + leftProjection);
+ System.err.println("rightProjection:\n " + rightProjection);
+ System.err.println("leftVpcToEc:\n" + leftVpcToEc);
+ System.err.println("rightVpcToEc:\n" + rightVpcToEc);
+ System.err.println("vpcToVworld:\n" + vpcToVworld);
+ System.err.println("vworldToVpc:\n" + vworldToVpc);
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ int i;
+ for (i = 0; i < leftFrustumPlanes.length; i++) {
+ System.err.println("leftFrustumPlanes " + i + " is " +
+ leftFrustumPlanes[i]);
+ }
+
+ for (i = 0; i < rightFrustumPlanes.length; i++) {
+ System.err.println("rightFrustumPlanes " + i + " is " +
+ rightFrustumPlanes[i]);
+ }
+ }
+ }
+
+ }
+
+ private void computeCanvasInfo() {
+ // Copy the screen width and height info into derived parameters
+ physicalScreenWidth = screenViewCache.physicalScreenWidth;
+ physicalScreenHeight = screenViewCache.physicalScreenHeight;
+
+ screenWidth = screenViewCache.screenWidth;
+ screenHeight = screenViewCache.screenHeight;
+
+ metersPerPixelX = screenViewCache.metersPerPixelX;
+ metersPerPixelY = screenViewCache.metersPerPixelY;
+
+ // If a multi-screen virtual device (e.g. Xinerama) is being used,
+ // then awtCanvasX and awtCanvasY are relative to the origin of that
+ // virtual screen. Subtract the origin of the physical screen to
+ // compute the origin in physical (image plate) coordinates.
+ Rectangle screenBounds = canvas.graphicsConfiguration.getBounds();
+ canvasX = awtCanvasX - screenBounds.x;
+ canvasY = awtCanvasY - screenBounds.y;
+
+ // Use awtCanvasWidth and awtCanvasHeight as reported.
+ canvasWidth = awtCanvasWidth;
+ canvasHeight = awtCanvasHeight;
+
+ // Convert the window system ``pixel'' coordinate location and size
+ // of the window into physical units (meters) and coordinate system.
+
+ // Window width and Height in meters
+ physicalWindowWidth = canvasWidth * metersPerPixelX;
+ physicalWindowHeight = canvasHeight * metersPerPixelY;
+
+ // Compute the 4 corners of the window in physical units
+ physicalWindowXLeft = metersPerPixelX *
+ (double) canvasX;
+ physicalWindowYBottom = metersPerPixelY *
+ (double)(screenHeight - canvasHeight - canvasY);
+
+ physicalWindowXRight = physicalWindowXLeft + physicalWindowWidth;
+ physicalWindowYTop = physicalWindowYBottom + physicalWindowHeight;
+
+ // Cache the physical location of the center of the window
+ physicalWindowCenter.x =
+ physicalWindowXLeft + physicalWindowWidth / 2.0;
+ physicalWindowCenter.y =
+ physicalWindowYBottom + physicalWindowHeight / 2.0;
+ physicalWindowCenter.z = 0.0;
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("Canvas pos = (" + awtCanvasX + ", " +
+ awtCanvasY + "), size = " + awtCanvasWidth +
+ "x" + awtCanvasHeight);
+
+ System.err.println("Window LL corner (in plate coordinates): " +
+ "(" + physicalWindowXLeft + "," + physicalWindowYBottom + ")");
+
+ System.err.println("Window size (in plate coordinates): " +
+ "(" + physicalWindowWidth + "," + physicalWindowHeight + ")");
+
+ System.err.println("Window center (in plate coordinates): " +
+ physicalWindowCenter);
+
+ System.err.println();
+ }
+
+ // Compute the view platform scale. This combines
+ // the screen scale and the window scale.
+ computeViewPlatformScale();
+
+ if (!viewCache.compatibilityModeEnable &&
+ viewCache.viewPolicy == View.HMD_VIEW) {
+ if (!useStereo) {
+ switch(effectiveMonoscopicViewPolicy) {
+ case View.CYCLOPEAN_EYE_VIEW:
+ if(J3dDebug.devPhase) {
+ System.err.println("CanvasViewCache : Should never reach here.\n" +
+ "HMD_VIEW with CYCLOPEAN_EYE_VIEW is not allowed");
+ }
+ break;
+
+ case View.LEFT_EYE_VIEW:
+ headTrackerToLeftImagePlate.set(screenViewCache.
+ headTrackerToLeftImagePlate);
+ break;
+
+ case View.RIGHT_EYE_VIEW:
+ headTrackerToLeftImagePlate.set(screenViewCache.
+ headTrackerToRightImagePlate);
+ break;
+ }
+ }
+ else {
+ headTrackerToLeftImagePlate.set(screenViewCache.
+ headTrackerToLeftImagePlate);
+
+ headTrackerToRightImagePlate.set(screenViewCache.
+ headTrackerToRightImagePlate);
+ }
+
+ }
+ }
+
+ // Routine to compute the center of coexistence coordinates in
+ // imageplate coordinates. Also compute the scale from Vpc
+ private void computeViewPlatformScale() {
+ windowScale = screenScale = 1.0;
+
+ if (!viewCache.compatibilityModeEnable) {
+ switch (viewCache.screenScalePolicy) {
+ case View.SCALE_SCREEN_SIZE:
+ screenScale = physicalScreenWidth / 2.0;
+ break;
+ case View.SCALE_EXPLICIT:
+ screenScale = viewCache.screenScale;
+ break;
+ }
+
+ if (viewCache.windowResizePolicy == View.PHYSICAL_WORLD) {
+ windowScale = physicalWindowWidth / physicalScreenWidth;
+ }
+ }
+
+ viewPlatformScale = windowScale * screenScale;
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("viewCache.windowResizePolicy = " +
+ viewCache.windowResizePolicy);
+ System.err.println("physicalWindowWidth = " + physicalWindowWidth);
+ System.err.println("physicalScreenWidth = " + physicalScreenWidth);
+ System.err.println("windowScale = " + windowScale);
+ System.err.println("screenScale = " + screenScale);
+ System.err.println("viewPlatformScale = " + viewPlatformScale);
+ }
+ }
+
+ private void cacheEyePosFixedField() {
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1))
+ System.err.println("cacheEyePosFixedField:");
+
+ // y is always the window center
+ rightEyeInImagePlate.y =
+ leftEyeInImagePlate.y =
+ physicalWindowCenter.y;
+
+ if (!useStereo) {
+ switch(effectiveMonoscopicViewPolicy) {
+ case View.CYCLOPEAN_EYE_VIEW:
+ leftEyeInImagePlate.x = physicalWindowCenter.x;
+ break;
+
+ case View.LEFT_EYE_VIEW:
+ leftEyeInImagePlate.x =
+ physicalWindowCenter.x + viewCache.leftEyePosInHead.x;
+ break;
+
+ case View.RIGHT_EYE_VIEW:
+ leftEyeInImagePlate.x =
+ physicalWindowCenter.x + viewCache.rightEyePosInHead.x;
+ break;
+ }
+
+ // Set right as well just in case
+ rightEyeInImagePlate.x = leftEyeInImagePlate.x;
+ }
+ else {
+ leftEyeInImagePlate.x =
+ physicalWindowCenter.x + viewCache.leftEyePosInHead.x;
+
+ rightEyeInImagePlate.x =
+ physicalWindowCenter.x + viewCache.rightEyePosInHead.x;
+ }
+
+ //
+ // Derive the z distance by constraining the field of view of the
+ // window width to be constant.
+ //
+ rightEyeInImagePlate.z =
+ leftEyeInImagePlate.z =
+ physicalWindowWidth /
+ (2.0 * Math.tan(viewCache.fieldOfView / 2.0));
+
+ // Denote that eyes-in-ImagePlate fields have changed so that
+ // these new values can be sent to the AudioDevice
+ if (this.viewCache.view.soundScheduler != null)
+ this.viewCache.view.soundScheduler.setListenerFlag(
+ SoundScheduler.EYE_POSITIONS_CHANGED);
+ }
+
+ /**
+ * Case of view eye position contrainted to center of window, but
+ * with z distance from plate eye pos.
+ */
+ private void cacheEyePosWindowRelative() {
+
+ if ((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1))
+ System.err.println("cacheEyePosWindowRelative:");
+
+ // y is always the window center
+ rightEyeInImagePlate.y =
+ leftEyeInImagePlate.y =
+ physicalWindowCenter.y;
+
+ // z is always from the existing eye pos
+ rightEyeInImagePlate.z =
+ leftEyeInImagePlate.z =
+ leftManualEyeInImagePlate.z;
+
+ if (!useStereo) {
+
+ switch(effectiveMonoscopicViewPolicy) {
+
+ case View.CYCLOPEAN_EYE_VIEW:
+ leftEyeInImagePlate.x =
+ physicalWindowCenter.x;
+ break;
+
+ case View.LEFT_EYE_VIEW:
+ leftEyeInImagePlate.x =
+ physicalWindowCenter.x +
+ viewCache.leftEyePosInHead.x;
+ break;
+
+ case View.RIGHT_EYE_VIEW:
+ leftEyeInImagePlate.x =
+ physicalWindowCenter.x +
+ viewCache.rightEyePosInHead.x;
+ break;
+
+ }
+
+ // Set right as well just in case
+ rightEyeInImagePlate.x =
+ leftEyeInImagePlate.x;
+
+ }
+ else {
+
+ leftEyeInImagePlate.x =
+ physicalWindowCenter.x +
+ viewCache.leftEyePosInHead.x;
+
+ rightEyeInImagePlate.x =
+ physicalWindowCenter.x +
+ viewCache.rightEyePosInHead.x;
+
+ // Right z gets its own value
+ rightEyeInImagePlate.z =
+ rightManualEyeInImagePlate.z;
+ }
+
+ // Denote that eyes-in-ImagePlate fields have changed so that
+ // these new values can be sent to the AudioDevice
+ if (this.viewCache.view.soundScheduler != null)
+ this.viewCache.view.soundScheduler.setListenerFlag(
+ SoundScheduler.EYE_POSITIONS_CHANGED);
+ }
+
+ /**
+ * Common routine used when head tracking and when using manual
+ * relative_to_screen eyepoint policy.
+ */
+ private void cacheEyePosScreenRelative(Point3d leftEye, Point3d rightEye) {
+ if ((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1))
+ System.err.println("cacheEyePosScreenRelative:");
+
+ if (!useStereo) {
+ switch(effectiveMonoscopicViewPolicy) {
+
+ case View.CYCLOPEAN_EYE_VIEW:
+ leftEyeInImagePlate.x = (leftEye.x + rightEye.x) / 2.0;
+ leftEyeInImagePlate.y = (leftEye.y + rightEye.y) / 2.0;
+ leftEyeInImagePlate.z = (leftEye.z + rightEye.z) / 2.0;
+ break;
+
+ case View.LEFT_EYE_VIEW:
+ leftEyeInImagePlate.set(leftEye);
+ break;
+
+ case View.RIGHT_EYE_VIEW:
+ leftEyeInImagePlate.set(rightEye);
+ break;
+
+ }
+
+ // Set right as well just in case
+ rightEyeInImagePlate.set(leftEyeInImagePlate);
+ }
+ else {
+ leftEyeInImagePlate.set(leftEye);
+ rightEyeInImagePlate.set(rightEye);
+ }
+
+ // Denote that eyes-in-ImagePlate fields have changed so that
+ // these new values can be sent to the AudioDevice
+ if (this.viewCache.view.soundScheduler != null)
+ this.viewCache.view.soundScheduler.setListenerFlag(
+ SoundScheduler.EYE_POSITIONS_CHANGED);
+ }
+
+ private void cacheEyePosCoexistenceRelative(Point3d leftManualEyeInCoexistence,
+ Point3d rightManualEyeInCoexistence) {
+
+ tPnt1.set(leftManualEyeInCoexistence);
+ viewCache.coexistenceToTrackerBase.transform(tPnt1);
+ screenViewCache.trackerBaseToImagePlate.transform(tPnt1);
+ tPnt1.add(coexistenceCenter);
+
+ tPnt2.set(rightManualEyeInCoexistence);
+ viewCache.coexistenceToTrackerBase.transform(tPnt2);
+ screenViewCache.trackerBaseToImagePlate.transform(tPnt2);
+ tPnt2.add(coexistenceCenter);
+
+ cacheEyePosScreenRelative(tPnt1, tPnt2);
+
+ }
+
+ /**
+ * Compute the head-tracked eye position for the right and
+ * left eyes.
+ */
+ private void computeTrackedEyePosition() {
+ if ((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("computeTrackedEyePosition:");
+ System.err.println("viewCache.headTrackerToTrackerBase:");
+ System.err.println(viewCache.headTrackerToTrackerBase);
+
+ System.err.println("viewCache.headToHeadTracker:");
+ System.err.println(viewCache.headToHeadTracker);
+ }
+
+ if (viewCache.viewPolicy != View.HMD_VIEW) {
+ if ((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("screenViewCache.trackerBaseToImagePlate:");
+ System.err.println(screenViewCache.trackerBaseToImagePlate);
+ }
+
+ headToLeftImagePlate.set(coexistenceCenter);
+ headToLeftImagePlate.mul(screenViewCache.trackerBaseToImagePlate);
+ headToLeftImagePlate.mul(viewCache.headTrackerToTrackerBase);
+ headToLeftImagePlate.mul(viewCache.headToHeadTracker);
+
+ headToLeftImagePlate.transform(viewCache.leftEyePosInHead,
+ leftTrackedEyeInImagePlate);
+
+ headToLeftImagePlate.transform(viewCache.rightEyePosInHead,
+ rightTrackedEyeInImagePlate);
+ }
+ else {
+ if ((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("headTrackerToLeftImagePlate:");
+ System.err.println(headTrackerToLeftImagePlate);
+ }
+
+ headToLeftImagePlate.mul(headTrackerToLeftImagePlate,
+ viewCache.headToHeadTracker);
+
+ headToLeftImagePlate.transform(viewCache.leftEyePosInHead,
+ leftTrackedEyeInImagePlate);
+
+ if(useStereo) {
+ headToRightImagePlate.mul(headTrackerToRightImagePlate,
+ viewCache.headToHeadTracker);
+
+ headToRightImagePlate.transform(viewCache.rightEyePosInHead,
+ rightTrackedEyeInImagePlate);
+ }
+ else { // HMD_VIEW with no stereo.
+ headToLeftImagePlate.transform(viewCache.rightEyePosInHead,
+ rightTrackedEyeInImagePlate);
+ }
+
+ }
+
+ if ((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("headToLeftImagePlate:");
+ System.err.println(headToLeftImagePlate);
+ System.err.println("headToRightImagePlate:");
+ System.err.println(headToRightImagePlate);
+
+ }
+ }
+
+ /**
+ * Routine to cache the current eye position in image plate
+ * coordinates.
+ */
+ private void cacheEyePosition() {
+ if (viewCache.compatibilityModeEnable) {
+ // XXXX: Compute compatibility mode eye position in ImagePlate???
+ cacheEyePosScreenRelative(leftManualEyeInImagePlate,
+ rightManualEyeInImagePlate);
+ }
+ else if (viewCache.getDoHeadTracking()) {
+ computeTrackedEyePosition();
+ cacheEyePosScreenRelative(leftTrackedEyeInImagePlate,
+ rightTrackedEyeInImagePlate);
+ }
+ else {
+ switch (viewCache.windowEyepointPolicy) {
+
+ case View.RELATIVE_TO_FIELD_OF_VIEW:
+ cacheEyePosFixedField();
+ break;
+
+ case View.RELATIVE_TO_WINDOW:
+ cacheEyePosWindowRelative();
+ break;
+
+ case View.RELATIVE_TO_SCREEN:
+ cacheEyePosScreenRelative(leftManualEyeInImagePlate,
+ rightManualEyeInImagePlate);
+ break;
+
+ case View.RELATIVE_TO_COEXISTENCE:
+ cacheEyePosCoexistenceRelative(viewCache.leftManualEyeInCoexistence,
+ viewCache.rightManualEyeInCoexistence);
+ break;
+ }
+ }
+
+ // Compute center eye
+ centerEyeInImagePlate.add(leftEyeInImagePlate, rightEyeInImagePlate);
+ centerEyeInImagePlate.scale(0.5);
+
+ // Compute derived value of nominalEyeOffsetFromNominalScreen
+ if (viewCache.windowEyepointPolicy == View.RELATIVE_TO_FIELD_OF_VIEW)
+ nominalEyeOffset = centerEyeInImagePlate.z;
+ else
+ nominalEyeOffset = viewCache.nominalEyeOffsetFromNominalScreen;
+
+ if ((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1)) {
+ System.err.println("leftEyeInImagePlate = " +
+ leftEyeInImagePlate);
+ System.err.println("rightEyeInImagePlate = " +
+ rightEyeInImagePlate);
+ System.err.println("centerEyeInImagePlate = " +
+ centerEyeInImagePlate);
+ System.err.println("nominalEyeOffset = " +
+ nominalEyeOffset);
+ System.err.println();
+ }
+ }
+
+ private void computePlateToVworld() {
+ if (viewCache.compatibilityModeEnable) {
+ // XXXX: implement this correctly for compat mode
+ leftPlateToVworld.setIdentity();
+ vworldToLeftPlate.setIdentity();
+ }
+ else {
+ try {
+ leftPlateToVpc.invert(vpcToLeftPlate);
+ }
+ catch (SingularMatrixException e) {
+ leftPlateToVpc.setIdentity();
+ /*
+ System.err.println("SingularMatrixException encountered when doing" +
+ " leftPlateToVpc invert");
+ */
+ }
+
+ leftPlateToVworld.mul(vpcToVworld, leftPlateToVpc);
+ vworldToLeftPlate.mul(vpcToLeftPlate, vworldToVpc);
+
+ if(useStereo) {
+ try {
+ rightPlateToVpc.invert(vpcToRightPlate);
+ }
+ catch (SingularMatrixException e) {
+ rightPlateToVpc.setIdentity();
+ /*
+ System.err.println("SingularMatrixException encountered when doing" +
+ " rightPlateToVpc invert");
+ */
+ }
+
+ rightPlateToVworld.mul(vpcToVworld, rightPlateToVpc);
+ vworldToRightPlate.mul(vpcToRightPlate, vworldToVpc);
+
+ }
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("vpcToVworld:");
+ System.err.println(vpcToVworld);
+ System.err.println("vpcToLeftPlate:");
+ System.err.println(vpcToLeftPlate);
+ if(useStereo) {
+ System.err.println("vpcToRightPlate:");
+ System.err.println(vpcToRightPlate);
+
+ }
+
+ }
+ }
+
+ // Denote that eyes-in-ImagePlate fields have changed so that
+ // these new values can be sent to the AudioDevice
+ if (this.viewCache.view.soundScheduler != null)
+ this.viewCache.view.soundScheduler.setListenerFlag(
+ SoundScheduler.IMAGE_PLATE_TO_VWORLD_CHANGED);
+ }
+
+
+ private void computeHeadToVworld() {
+ // Concatenate headToLeftImagePlate with leftPlateToVworld
+
+ if (viewCache.compatibilityModeEnable) {
+ // XXXX: implement this correctly for compat mode
+ headToVworld.setIdentity();
+ }
+ else {
+ headToVworld.mul(leftPlateToVworld, headToLeftImagePlate);
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("leftPlateToVworld:");
+ System.err.println(leftPlateToVworld);
+ System.err.println("headToLeftImagePlate:");
+ System.err.println(headToLeftImagePlate);
+ System.err.println("...gives -> headToVworld:");
+ System.err.println(headToVworld);
+ }
+ }
+
+ // Denote that eyes-in-ImagePlate fields have changed so that
+ // these new values can be sent to the AudioDevice
+ if (this.viewCache.view.soundScheduler != null)
+ this.viewCache.view.soundScheduler.setListenerFlag(
+ SoundScheduler.HEAD_TO_VWORLD_CHANGED);
+ }
+
+ private void computeVpcToCoexistence() {
+ // Create a transform with the view platform to coexistence scale
+ tMat1.set(viewPlatformScale);
+
+ // XXXX: Is this really correct to ignore HMD?
+
+ if (viewCache.viewPolicy != View.HMD_VIEW) {
+ switch (viewCache.coexistenceCenterInPworldPolicy) {
+ case View.NOMINAL_SCREEN :
+ switch (viewCache.viewAttachPolicy) {
+ case View.NOMINAL_SCREEN:
+ tMat2.setIdentity();
+ break;
+ case View.NOMINAL_HEAD:
+ tVec1.set(0.0, 0.0, nominalEyeOffset);
+ tMat2.set(tVec1);
+ break;
+ case View.NOMINAL_FEET:
+ tVec1.set(0.0, -viewCache.nominalEyeHeightFromGround,
+ nominalEyeOffset);
+ tMat2.set(tVec1);
+ break;
+ }
+
+ break;
+ case View.NOMINAL_HEAD :
+ switch (viewCache.viewAttachPolicy) {
+ case View.NOMINAL_SCREEN:
+ tVec1.set(0.0, 0.0, -nominalEyeOffset);
+ tMat2.set(tVec1);
+ break;
+ case View.NOMINAL_HEAD:
+ tMat2.setIdentity();
+ break;
+ case View.NOMINAL_FEET:
+ tVec1.set(0.0, -viewCache.nominalEyeHeightFromGround,
+ 0.0);
+ tMat2.set(tVec1);
+ break;
+ }
+ break;
+ case View.NOMINAL_FEET:
+ switch (viewCache.viewAttachPolicy) {
+ case View.NOMINAL_SCREEN:
+ tVec1.set(0.0,
+ viewCache.nominalEyeHeightFromGround, -nominalEyeOffset);
+ tMat2.set(tVec1);
+ break;
+ case View.NOMINAL_HEAD:
+ tVec1.set(0.0, viewCache.nominalEyeHeightFromGround,
+ 0.0);
+ tMat2.set(tVec1);
+
+ break;
+ case View.NOMINAL_FEET:
+ tMat2.setIdentity();
+ break;
+ }
+ break;
+ }
+
+ vpcToCoexistence.mul(tMat2, tMat1);
+ }
+ else {
+ vpcToCoexistence.set(tMat1);
+ }
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("vpcToCoexistence:");
+ System.err.println(vpcToCoexistence);
+ }
+ }
+
+ private void computeCoexistenceCenter() {
+
+ if ((!viewCache.compatibilityModeEnable) &&
+ (viewCache.viewPolicy != View.HMD_VIEW) &&
+ (viewCache.coexistenceCenteringEnable) &&
+ (viewCache.coexistenceCenterInPworldPolicy == View.NOMINAL_SCREEN)) {
+
+ // Compute the coexistence center in image plate coordinates
+
+ // Image plate cordinates have their orgin in the lower
+ // left hand corner of the CRT visiable raster.
+ // The nominal coexistence center is at the *center* of
+ // targeted area: either the window or screen, depending
+ // on policy.
+ if (viewCache.windowMovementPolicy == View.VIRTUAL_WORLD) {
+ coexistenceCenter.x = physicalScreenWidth / 2.0;
+ coexistenceCenter.y = physicalScreenHeight / 2.0;
+ coexistenceCenter.z = 0.0;
+ }
+ else { // windowMovementPolicy == PHYSICAL_WORLD
+ coexistenceCenter.x = physicalWindowCenter.x;
+ coexistenceCenter.y = physicalWindowCenter.y;
+ coexistenceCenter.z = 0.0;
+ }
+ }
+ else {
+ coexistenceCenter.set(0.0, 0.0, 0.0);
+ }
+
+ if(J3dDebug.devPhase) {
+ if (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1) {
+ System.err.println("coexistenceCenter = " + coexistenceCenter);
+ }
+ }
+ }
+
+ private void computeCoexistenceToPlate() {
+ if (viewCache.compatibilityModeEnable) {
+ // XXXX: implement this correctly
+ coexistenceToLeftPlate.setIdentity();
+ return;
+ }
+
+ if (viewCache.viewPolicy != View.HMD_VIEW) {
+ coexistenceToLeftPlate.set(coexistenceCenter);
+ coexistenceToLeftPlate.mul(screenViewCache.trackerBaseToImagePlate);
+ coexistenceToLeftPlate.mul(viewCache.coexistenceToTrackerBase);
+
+ if(useStereo) {
+ coexistenceToRightPlate.set(coexistenceToLeftPlate);
+ }
+ }
+ else {
+ coexistenceToLeftPlate.mul(headTrackerToLeftImagePlate,
+ viewCache.trackerBaseToHeadTracker);
+ coexistenceToLeftPlate.mul(viewCache.coexistenceToTrackerBase);
+
+ if(useStereo) {
+ coexistenceToRightPlate.mul(headTrackerToRightImagePlate,
+ viewCache.trackerBaseToHeadTracker);
+ coexistenceToRightPlate.mul(viewCache.coexistenceToTrackerBase);
+ }
+ }
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("coexistenceToLeftPlate:");
+ System.err.println(coexistenceToLeftPlate);
+ if(useStereo) {
+ System.err.println("coexistenceToRightPlate:");
+ System.err.println(coexistenceToRightPlate);
+
+ }
+ }
+ }
+
+ /**
+ * Computes the viewing matrices.
+ *
+ * computeView computes the following:
+ *
+ * shadingLanguageCg
+ *
+ * A Boolean indicating whether or not Cg shading Language
+ * is available for this Canvas3D.
+ *
+ * shadingLanguageGLSL
+ *
+ * A Boolean indicating whether or not GLSL shading Language
+ * is available for this Canvas3D.
+ *
+ * doubleBufferAvailable
+ *
+ * A Boolean indicating whether or not double buffering
+ * is available for this Canvas3D. This is equivalent to
+ * the getDoubleBufferAvailable method. If this flag is false,
+ * the Canvas3D will be rendered in single buffer mode; requests
+ * to enable double buffering will be ignored.
+ *
+ * stereoAvailable
+ *
+ * A Boolean indicating whether or not stereo
+ * is available for this Canvas3D. This is equivalent to
+ * the getStereoAvailable method. If this flag is false,
+ * the Canvas3D will be rendered in monoscopic mode; requests
+ * to enable stereo will be ignored.
+ *
+ * sceneAntialiasingAvailable
+ *
+ * A Boolean indicating whether or not scene antialiasing
+ * is available for this Canvas3D. This is equivalent to
+ * the getSceneAntialiasingAvailable method. If this flag is false,
+ * requests to enable scene antialiasing will be ignored.
+ *
+ * sceneAntialiasingNumPasses
+ *
+ * An Integer indicating the number of passes scene antialiasing
+ * requires to render a single frame for this Canvas3D.
+ * If this value is zero, scene antialiasing is not supported.
+ * If this value is one, multisampling antialiasing is used.
+ * Otherwise, the number indicates the number of rendering passes
+ * needed.
+ *
+ * stencilSize
+ *
+ * An Integer indicating the number of stencil bits that are available
+ * for this Canvas3D.
+ *
+ * texture3DAvailable
+ *
+ * A Boolean indicating whether or not 3D Texture mapping
+ * is available for this Canvas3D. If this flag is false,
+ * 3D texture mapping is either not supported by the underlying
+ * rendering layer or is otherwise unavailable for this
+ * particular Canvas3D. All use of 3D texture mapping will be
+ * ignored in this case.
+ *
+ * textureColorTableSize
+ *
+ * An Integer indicating the maximum size of the texture color
+ * table for this Canvas3D. If the size is 0, the texture
+ * color table is either not supported by the underlying rendering
+ * layer or is otherwise unavailable for this particular
+ * Canvas3D. An attempt to use a texture color table larger than
+ * textureColorTableSize will be ignored; no color lookup will be
+ * performed.
+ *
+ * textureLodRangeAvailable
+ *
+ * A Boolean indicating whether or not setting only a subset of mipmap
+ * levels and setting a range of texture LOD are available for this
+ * Canvas3D.
+ * If it indicates false, setting a subset of mipmap levels and
+ * setting a texture LOD range are not supported by the underlying
+ * rendering layer, and an attempt to set base level, or maximum level,
+ * or minimum LOD, or maximum LOD will be ignored. In this case,
+ * images for all mipmap levels must be defined for the texture to be
+ * valid.
+ *
+ * textureLodOffsetAvailable
+ *
+ * A Boolean indicating whether or not setting texture LOD offset is
+ * available for this Canvas3D. If it indicates false, setting
+ * texture LOD offset is not supported by the underlying rendering
+ * layer, and an attempt to set the texture LOD offset will be ignored.
+ *
+ * textureWidthMax
+ *
+ * An Integer indicating the maximum texture width supported by
+ * this Canvas3D. If the width of a texture exceeds the maximum texture
+ * width for a Canvas3D, then the texture will be effectively disabled
+ * for that Canvas3D.
+ *
+ * textureHeightMax
+ *
+ * An Integer indicating the maximum texture height supported by
+ * this Canvas3D. If the height of a texture exceeds the maximum texture
+ * height for a Canvas3D, then the texture will be effectively disabled
+ * for that Canvas3D.
+ *
+ * textureBoundaryWidthMax
+ *
+ * An Integer indicating the maximum texture boundary width
+ * supported by the underlying rendering layer for this Canvas3D. If
+ * the maximum supported texture boundary width is 0, then texture
+ * boundary is not supported by the underlying rendering layer.
+ * An attempt to specify a texture boundary width > the
+ * textureBoundaryWidthMax will effectively disable the texture.
+ *
+ * textureEnvCombineAvailable
+ *
+ * A Boolean indicating whether or not texture environment combine
+ * operation is supported for this Canvas3D. If it indicates false,
+ * then texture environment combine is not supported by the
+ * underlying rendering layer, and an attempt to specify COMBINE
+ * as the texture mode will be ignored. The texture mode in effect
+ * will be REPLACE.
+ *
+ * textureCombineDot3Available
+ *
+ * A Boolean indicating whether or not texture combine mode
+ * COMBINE_DOT3 is
+ * supported for this Canvas3D. If it indicates false, then
+ * texture combine mode COMBINE_DOT3 is not supported by
+ * the underlying rendering layer, and an attempt to specify
+ * COMBINE_DOT3 as the texture combine mode will be ignored.
+ * The texture combine mode in effect will be COMBINE_REPLACE.
+ *
+ * textureCombineSubtractAvailable
+ *
+ * A Boolean indicating whether or not texture combine mode
+ * COMBINE_SUBTRACT is
+ * supported for this Canvas3D. If it indicates false, then
+ * texture combine mode COMBINE_SUBTRACT is not supported by
+ * the underlying rendering layer, and an attempt to specify
+ * COMBINE_SUBTRACT as the texture combine mode will be ignored.
+ * The texture combine mode in effect will be COMBINE_REPLACE.
+ *
+ * textureCoordSetsMax
+ *
+ * An Integer indicating the maximum number of texture coordinate sets
+ * supported by the underlying rendering layer.
+ *
+ * textureUnitStateMax
+ *
+ * An Integer indicating the maximum number of fixed-function texture units
+ * supported by the underlying rendering layer. If the number of
+ * application-sepcified texture unit states exceeds the maximum number
+ * for a Canvas3D, and the fixed-function rendering pipeline is used, then
+ * the texture will be effectively disabled for that Canvas3D.
+ *
+ * textureImageUnitsMax
+ *
+ * An Integer indicating the maximum number of texture image units
+ * that can be accessed by the fragment shader when programmable shaders
+ * are used.
+ *
+ * textureImageUnitsVertexMax
+ *
+ * An Integer indicating the maximum number of texture image units
+ * that can be accessed by the vertex shader when programmable shaders
+ * are used.
+ *
+ * textureImageUnitsCombinedMax
+ *
+ * An Integer indicating the combined maximum number of texture image units
+ * that can be accessed by the vertex shader and the fragment shader when
+ * programmable shaders are used.
+ *
+ * textureCubeMapAvailable
+ *
+ * A Boolean indicating whether or not texture cube map is supported
+ * for this Canvas3D. If it indicates false, then texture cube map
+ * is not supported by the underlying rendering layer, and an attempt
+ * to specify NORMAL_MAP or REFLECTION_MAP as the texture generation
+ * mode will be ignored. The texture generation mode in effect will
+ * be SPHERE_MAP.
+ *
+ * textureDetailAvailable
+ *
+ * A Boolean indicating whether or not detail texture is supported
+ * for this Canvas3D. If it indicates false, then detail texture is
+ * not supported by the underlying rendering layer, and an attempt
+ * to specify LINEAR_DETAIL, LINEAR_DETAIL_ALPHA or
+ * LINEAR_DETAIL_RGB as the texture magnification filter mode will
+ * be ignored. The texture magnification filter mode in effect will
+ * be BASE_LEVEL_LINEAR.
+ * As of Java 3D 1.5, this property is always false.
+ *
+ * textureSharpenAvailable
+ *
+ * A Boolean indicating whether or not sharpen texture is supported
+ * for this Canvas3D. If it indicates false, then sharpen texture
+ * is not supported by the underlying rendering layer, and an attempt
+ * to specify LINEAR_SHARPEN, LINEAR_SHARPEN_ALPHA or
+ * LINEAR_SHARPEN_RGB as the texture magnification filter mode
+ * will be ignored. The texture magnification filter mode in effect
+ * will be BASE_LEVEL_LINEAR.
+ *
+ * textureFilter4Available
+ *
+ * A Boolean indicating whether or not filter4 is supported for this
+ * Canvas3D. If it indicates flase, then filter4 is not supported
+ * by the underlying rendering layer, and an attempt to specify
+ * FILTER_4 as the texture minification filter mode or texture
+ * magnification filter mode will be ignored. The texture filter mode
+ * in effect will be BASE_LEVEL_LINEAR.
+ *
+ * textureAnisotropicFilterDegreeMax
+ *
+ * A Float indicating the maximum degree of anisotropic filter
+ * available for this Canvas3D. If it indicates 1.0, setting
+ * anisotropic filter is not supported by the underlying rendering
+ * layer, and an attempt to set anisotropic filter degree will be ignored.
+ *
+ * textureNonPowerOfTwoAvailable
+ *
+ * A Boolean indicating whether or not texture dimensions that are
+ * not powers of two are supported for
+ * for this Canvas3D. If it indicates false, then textures with
+ * non power of two sizes will be ignored. Set the property
+ * j3d.textureEnforcePowerOfTwo to revert to the pre-1.5 behavior
+ * of throwing exceptions for non power of two textures.
+ *
+ * vertexAttrsMax
+ *
+ * An Integer indicating the maximum number of vertex attributes
+ * supported by the underlying rendering layer. This is in addition to
+ * the vertex coordinate (position), color, normal, and so forth.
+ *
+ * compressedGeometry.majorVersionNumber
+ * compressedGeometry.minorVersionNumber
+ * compressedGeometry.minorMinorVersionNumber
+ *
+ * Integers indicating the major, minor, and minor-minor
+ * version numbers, respectively, of the version of compressed
+ * geometry supported by this version of Java 3D.
+ *
+ * native.version
+ *
+ * A String indicating the version number of the native graphics
+ * library. The format of this string is defined by the native
+ * library.
+ *
+ *
+ * left (& right) eye viewing matrices (only left is valid for mono view)
+ *
+ *
+ * This call works for both fixed screen and HMD displays.
+ */
+ private void computeView(boolean doInfinite) {
+ int i,j;
+ int backClipPolicy;
+ double Fl, Fr, B, scale, backClipDistance;
+
+ // compute scale used for transforming clip and fog distances
+ vworldToCoexistenceScale = vworldToVpc.getDistanceScale()
+ * vpcToCoexistence.getDistanceScale();
+ if(doInfinite) {
+ infVworldToCoexistenceScale = infVworldToVpc.getDistanceScale()
+ * vpcToCoexistence.getDistanceScale();
+ }
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("vworldToCoexistenceScale = " +
+ vworldToCoexistenceScale);
+ }
+
+ // compute coexistenceToVworld transform -- dirty bit candidate!!
+ tempTrans.mul(viewCache.coexistenceToTrackerBase, vpcToCoexistence);
+ vworldToTrackerBase.mul(tempTrans, vworldToVpc);
+
+ // If we are in compatibility mode, compute the view and
+ // projection matrices accordingly
+ if (viewCache.compatibilityModeEnable) {
+ leftProjection.set(viewCache.compatLeftProjection);
+ leftVpcToEc.set(viewCache.compatVpcToEc);
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1)) {
+ System.err.println("Left projection and view matrices");
+ System.err.println("ecToCc (leftProjection) :");
+ System.err.println(leftProjection);
+ System.err.println("vpcToEc:");
+ System.err.println(leftVpcToEc);
+ }
+
+ computeFrustumPlanes(leftProjection, leftVpcToEc,
+ leftFrustumPlanes, leftFrustumPoints,
+ leftCcToVworld);
+
+ if(useStereo) {
+ rightProjection.set(viewCache.compatRightProjection);
+ rightVpcToEc.set(viewCache.compatVpcToEc);
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1)) {
+ System.err.println("Right projection and view matrices");
+ System.err.println("ecToCc:");
+ System.err.println("vpcToEc:");
+ System.err.println(rightVpcToEc);
+ }
+
+ computeFrustumPlanes(rightProjection, rightVpcToEc,
+ rightFrustumPlanes, rightFrustumPoints,
+ rightCcToVworld);
+ }
+
+ return;
+ }
+
+ //
+ // The clipping plane distances are set from the internal policy.
+ //
+ // Note that the plane distance follows the standard Z axis
+ // convention, e.g. negative numbers further away.
+ // Note that for policy from eye, the distance is negative in
+ // the direction of z in front of the eye.
+ // Note that for policy from screen, the distance is negative for
+ // locations behind the screen, and positive in front.
+ //
+ // The distance attributes are measured either in physical (plate)
+ // units, or vworld units.
+ //
+
+ // Compute scale factor for front clip plane computation
+ if (viewCache.frontClipPolicy == View.VIRTUAL_EYE ||
+ viewCache.frontClipPolicy == View.VIRTUAL_SCREEN) {
+ scale = vworldToCoexistenceScale;
+ }
+ else {
+ scale = windowScale;
+ }
+
+ // Set left and right front clipping plane distances.
+ if(viewCache.frontClipPolicy == View.PHYSICAL_EYE ||
+ viewCache.frontClipPolicy == View.VIRTUAL_EYE) {
+ Fl = leftEyeInImagePlate.z +
+ scale * -viewCache.frontClipDistance;
+ Fr = rightEyeInImagePlate.z +
+ scale * -viewCache.frontClipDistance;
+ }
+ else {
+ Fl = scale * -viewCache.frontClipDistance;
+ Fr = scale * -viewCache.frontClipDistance;
+ }
+
+ // if there is an active clip node, use it and ignore the view's
+ // backclip
+ if ((renderBin != null) && (renderBin.backClipActive)) {
+ backClipPolicy = View.VIRTUAL_EYE;
+ backClipDistance = renderBin.backClipDistanceInVworld;
+ } else {
+ backClipPolicy = viewCache.backClipPolicy;
+ backClipDistance = viewCache.backClipDistance;
+ }
+
+ // Compute scale factor for rear clip plane computation
+ if (backClipPolicy == View.VIRTUAL_EYE ||
+ backClipPolicy == View.VIRTUAL_SCREEN) {
+ scale = vworldToCoexistenceScale;
+ }
+ else {
+ scale = windowScale;
+ }
+
+ // Set left and right rear clipping plane distnaces.
+ if(backClipPolicy == View.PHYSICAL_EYE ||
+ backClipPolicy == View.VIRTUAL_EYE) {
+ // Yes, left for both left and right rear.
+ B = leftEyeInImagePlate.z +
+ scale * -backClipDistance;
+ }
+ else {
+ B = scale * -backClipDistance;
+ }
+
+ // XXXX: Can optimize for HMD case.
+ if (true /*viewCache.viewPolicy != View.HMD_VIEW*/) {
+
+ // Call buildProjView to build the projection and view matrices.
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("Left projection and view matrices");
+ System.err.println("Fl " + Fl + " B " + B);
+ System.err.println("leftEyeInImagePlate\n" + leftEyeInImagePlate);
+ System.err.println("Before : leftProjection\n" + leftProjection);
+ System.err.println("Before leftVpcToEc\n" + leftVpcToEc);
+ }
+
+ buildProjView(leftEyeInImagePlate, coexistenceToLeftPlate,
+ vpcToLeftPlate, Fl, B, leftProjection, leftVpcToEc, false);
+
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("After : leftProjection\n" + leftProjection);
+ System.err.println("After leftVpcToEc\n" + leftVpcToEc);
+ }
+
+ computeFrustumPlanes(leftProjection, leftVpcToEc,
+ leftFrustumPlanes, leftFrustumPoints,
+ leftCcToVworld);
+
+ if(useStereo) {
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2))
+ System.err.println("Right projection and view matrices");
+
+ buildProjView(rightEyeInImagePlate, coexistenceToRightPlate,
+ vpcToRightPlate, Fr, B, rightProjection,
+ rightVpcToEc, false);
+
+ computeFrustumPlanes(rightProjection, rightVpcToEc,
+ rightFrustumPlanes, rightFrustumPoints,
+ rightCcToVworld);
+ }
+
+ //
+ // Now to compute the left (& right) eye (and infinite)
+ // viewing matrices.
+ if(doInfinite) {
+ // Call buildProjView separately for infinite view
+ buildProjView(leftEyeInImagePlate, coexistenceToLeftPlate,
+ vpcToLeftPlate, leftEyeInImagePlate.z - 0.05,
+ leftEyeInImagePlate.z - 1.5,
+ infLeftProjection, infLeftVpcToEc, true);
+
+ if(useStereo) {
+ buildProjView(rightEyeInImagePlate, coexistenceToRightPlate,
+ vpcToRightPlate, rightEyeInImagePlate.z - 0.05,
+ rightEyeInImagePlate.z - 1.5,
+ infRightProjection, infRightVpcToEc, true);
+
+ }
+ }
+ }
+ // XXXX: The following code has never been ported
+// else {
+// Point3d cen_eye;
+//
+// // HMD case. Just concatenate the approprate matrices together.
+// // Additional work just for now
+//
+// compute_lr_plate_to_cc( &cen_eye, Fl, B, 0, &vb, 0);
+//
+// if(useStereo) {
+// mat_mul_dpt(&right_eye_pos_in_head,
+// head_to_right_plate, &cen_eye);
+// compute_lr_plate_to_cc( &cen_eye, Fr, B,
+// 1, &vb, 0);
+// }
+//
+// // Make sure that coexistence_to_plate is current.
+// // (It is usually constant for fixed plates, always varies for HMDs.)
+// // For HMD case, computes finial matrices that will be used.
+// //
+// computeCoexistenceToPlate();
+// }
+
+ }
+
+ /**
+ * Debugging routine to analyze the projection matrix.
+ */
+ private void analyzeProjection(Transform3D p, double xMax) {
+ if (viewCache.projectionPolicy == View.PARALLEL_PROJECTION)
+ System.err.println("PARALLEL_PROJECTION =");
+ else
+ System.err.println("PERSPECTIVE_PROJECTION =");
+
+ System.err.println(p);
+
+ double projectionPlaneZ = ((p.mat[0] * xMax + p.mat[3] - p.mat[15]) /
+ (p.mat[14] - p.mat[2]));
+
+ System.err.println("projection plane at z = " + projectionPlaneZ);
+ }
+
+ /**
+ * buildProjView creates a projection and viewing matrix.
+ *
+ * Inputs:
+ * ep : eye point, in plate coordinates
+ * coe2Plate : matrix from coexistence to image plate.
+ * F, B : front, back clipping planes, in plate coordinates
+ * doInfinite : flag to indicate ``at infinity'' view desired
+ *
+ * Output:
+ * vpc2Plate : matric from vpc to image plate.
+ * ecToCc : projection matrix from Eye Coordinates (EC)
+ * to Clipping Coordinates (CC)
+ * vpcToEc : view matrix from ViewPlatform Coordinates (VPC)
+ * to Eye Coordinates (EC)
+ */
+ private void buildProjView(Point3d ep,
+ Transform3D coe2Plate,
+ Transform3D vpc2Plate,
+ double F,
+ double B,
+ Transform3D ecToCc,
+ Transform3D vpcToEc,
+ boolean doInfinite) {
+
+ // Lx,Ly Hx,Hy will be adjusted window boundaries
+ double Lx, Hx, Ly, Hy;
+ Lx = physicalWindowXLeft; Hx = physicalWindowXRight;
+ Ly = physicalWindowYBottom; Hy = physicalWindowYTop;
+
+ ecToCc.setIdentity();
+
+
+ // XXXX: we have no concept of glass correction in the Java 3D API
+ //
+ // Correction in apparent 3D position of window due to glass/CRT
+ // and spherical/cylinderical curvarure of CRT.
+ // This boils down to producing modified values of Lx Ly Hx Hy
+ // and is different for hot spot vs. window center corrections.
+ //
+ /* XXXX:
+ double cx, cy;
+ if(viewPolicy != HMD_VIEW && enable_crt_glass_correction) {
+ if (correction_point == CORRECTION_POINT_WINDOW_CENTER) {
+ correct_crt( ep, Lx, Ly, &cx, &cy); Lx = cx; Ly = cy;
+ correct_crt( ep, Hx, Hy, &cx, &cy); Hx = cx; Hy = cy;
+ }
+ else { // must be hot spot correction
+ // Not real code yet, for now just do same as above.
+ correct_crt( ep, Lx, Ly, &cx, &cy); Lx = cx; Ly = cy;
+ correct_crt( ep, Hx, Hy, &cx, &cy); Hx = cx; Hy = cy;
+ }
+ }
+ */
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("ep = " + ep);
+ System.err.println("Lx = " + Lx + ", Hx = " + Hx);
+ System.err.println("Ly = " + Ly + ", Hy = " + Hy);
+ System.err.println("F = " + F + ", B = " + B);
+ }
+
+ // Compute the proper projection equation. Note that we
+ // do this in two steps: first we generate ImagePlateToCc,
+ // then we translate this by EcToPlate, resulting in a
+ // projection from EctoCc.
+ //
+ // A more efficient (and more accurate) approach would be to
+ // modify the equations below to directly project from EcToCc.
+
+ if (viewCache.projectionPolicy == View.PARALLEL_PROJECTION) {
+ double inv_dx, inv_dy, inv_dz;
+ inv_dx = 1.0 / (Hx - Lx);
+ inv_dy = 1.0 / (Hy - Ly);
+ inv_dz = 1.0 / (F - B);
+
+ ecToCc.mat[0] = 2.0 * inv_dx;
+ ecToCc.mat[3] = -(Hx + Lx) * inv_dx;
+ ecToCc.mat[5] = 2.0 * inv_dy;
+ ecToCc.mat[7] = -(Hy + Ly) * inv_dy;
+ ecToCc.mat[10] = 2.0 * inv_dz;
+ ecToCc.mat[11] = -(F + B) * inv_dz;
+ }
+ else {
+ double sxy, rzb, inv_dx, inv_dy;
+
+ inv_dx = 1.0 / (Hx - Lx);
+ inv_dy = 1.0 / (Hy - Ly);
+ rzb = 1.0/(ep.z - B);
+ sxy = ep.z*rzb;
+
+ ecToCc.mat[0] = sxy*2.0*inv_dx;
+ ecToCc.mat[5] = sxy*2.0*inv_dy;
+
+ ecToCc.mat[2] = rzb*(Hx+Lx - 2.0*ep.x)*inv_dx;
+ ecToCc.mat[6] = rzb*(Hy+Ly - 2.0*ep.y)*inv_dy;
+ ecToCc.mat[10] = rzb*(B+F-2*ep.z)/(B-F);
+ ecToCc.mat[14] = -rzb;
+
+ ecToCc.mat[3] = sxy*(-Hx-Lx)*inv_dx;
+ ecToCc.mat[7] = sxy*(-Hy-Ly)*inv_dy;
+ ecToCc.mat[11] = rzb*(B - ep.z - B*(B+F - 2*ep.z)/(B-F));
+ ecToCc.mat[15] = sxy;
+ }
+
+ // Since we set the matrix elements ourselves, we need to set the
+ // type field. A value of 0 means a non-affine matrix.
+ ecToCc.setOrthoDirtyBit();
+
+ // EC to ImagePlate matrix is a simple translation.
+ tVec1.set(ep.x, ep.y, ep.z);
+ tMat1.set(tVec1);
+ ecToCc.mul(tMat1);
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("ecToCc:");
+ analyzeProjection(ecToCc, Hx);
+ }
+
+ if(!doInfinite) {
+ // View matrix is:
+ // [plateToEc] [coexistence_to_plate] [vpc_to_coexistence]
+ // where vpc_to_coexistence includes the viewPlatformScale
+
+ // First compute ViewPlatform to Plate
+ vpc2Plate.mul(coe2Plate, vpcToCoexistence);
+
+ // ImagePlate to EC matrix is a simple translation.
+ tVec1.set(-ep.x, -ep.y, -ep.z);
+ tMat1.set(tVec1);
+ vpcToEc.mul(tMat1, vpc2Plate);
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ System.err.println("vpcToEc:");
+ System.err.println(vpcToEc);
+ }
+ }
+ else {
+ // Final infinite composite is:
+ // [coexistence_to_eye] [vpc_to_coexistence (vom)]
+ // (does vworld_to_coe_scale_factor get used here??? )
+ //
+ // The method is to relocate the coexistence org centered on
+ // the eye rather than the window center (via coexistence_to_eye).
+ // Computationaly simpler simplifed equation form may exist.
+
+ // coexistence to eye is a simple translation.
+/*
+ tVec1.set(ep.x, ep.y, ep.z);
+ tMat1.set(tVec1);
+ vpcToEc.mul(tMat1, vpcToCoexistence);
+ // First compute ViewPlatform to Plate
+ vpcToPlate.mul(coexistenceToPlatevpcToPlate, vpcToCoexistence);
+*/
+
+ // ImagePlate to EC matrix is a simple translation.
+ tVec1.set(-ep.x, -ep.y, -ep.z);
+ tMat1.set(tVec1);
+ tMat1.mul(tMat1, vpc2Plate);
+ tMat1.getRotation(vpcToEc); // use only rotation component of transform
+
+ }
+
+ }
+
+ /**
+ * Compute the plane equations for the frustum in ViewPlatform
+ * coordinates, plus its viewing frustum points. ccToVworld will
+ * be cached - used by Canavs3D.getInverseVworldProjection().
+ */
+ private void computeFrustumPlanes(Transform3D ecToCc,
+ Transform3D vpcToEc,
+ Vector4d [] frustumPlanes,
+ Point4d [] frustumPoints,
+ Transform3D ccToVworld) {
+
+ // Compute the inverse of the Vworld to Cc transform. This
+ // gives us the Cc to Vworld transform.
+ tMat2.mul(ecToCc, vpcToEc);
+ ccToVworld.mul(tMat2, vworldToVpc);
+ // System.err.println("ccToVworld = " + ccToVworld);
+ try {
+ ccToVworld.invert();
+ }
+ catch (SingularMatrixException e) {
+ ccToVworld.setIdentity();
+ // System.err.println("SingularMatrixException encountered when doing invert in computeFrustumPlanes");
+ }
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_2)) {
+ Transform3D t = new Transform3D();
+ t.mul(ecToCc, vpcToEc);
+ t.mul(vworldToVpc);
+ System.err.println("\nvworldToCc = " + t);
+ System.err.println("ccToVworld = " + ccToVworld);
+ t.mul(ccToVworld);
+ System.err.println("vworldToCc * ccToVworld = " + t);
+ }
+
+ // Transform the 8 corners of the viewing frustum into Vpc
+ frustumPoints[0].set(-1.0, -1.0, 1.0, 1.0); // lower-left-front
+ frustumPoints[1].set(-1.0, 1.0, 1.0, 1.0); // upper-left-front
+ frustumPoints[2].set( 1.0, 1.0, 1.0, 1.0); // upper-right-front
+ frustumPoints[3].set( 1.0, -1.0, 1.0, 1.0); // lower-right-front
+ frustumPoints[4].set(-1.0, -1.0, -1.0, 1.0); // lower-left-back
+ frustumPoints[5].set(-1.0, 1.0, -1.0, 1.0); // upper-left-back
+ frustumPoints[6].set( 1.0, 1.0, -1.0, 1.0); // upper-right-back
+ frustumPoints[7].set( 1.0, -1.0, -1.0, 1.0); // lower-right-back
+
+ ccToVworld.get(tMatrix);
+ int i;
+ for (i = 0; i < frustumPoints.length; i++) {
+ tMatrix.transform(frustumPoints[i]);
+ double w_inv = 1.0 / frustumPoints[i].w;
+ frustumPoints[i].x *= w_inv;
+ frustumPoints[i].y *= w_inv;
+ frustumPoints[i].z *= w_inv;
+ }
+
+ // Now compute the 6 plane equations
+ // left
+ computePlaneEq(frustumPoints[0], frustumPoints[4],
+ frustumPoints[5], frustumPoints[1],
+ frustumPlanes[0]);
+
+ // right
+ computePlaneEq(frustumPoints[3], frustumPoints[2],
+ frustumPoints[6], frustumPoints[7],
+ frustumPlanes[1]);
+
+ // top
+ computePlaneEq(frustumPoints[1], frustumPoints[5],
+ frustumPoints[6], frustumPoints[2],
+ frustumPlanes[2]);
+
+ // bottom
+ computePlaneEq(frustumPoints[0], frustumPoints[3],
+ frustumPoints[7], frustumPoints[4],
+ frustumPlanes[3]);
+
+ // front
+ computePlaneEq(frustumPoints[0], frustumPoints[1],
+ frustumPoints[2], frustumPoints[3],
+ frustumPlanes[4]);
+
+ // back
+ computePlaneEq(frustumPoints[4], frustumPoints[7],
+ frustumPoints[6], frustumPoints[5],
+ frustumPlanes[5]);
+
+ //System.err.println("left plane = " + frustumPlanes[0]);
+ //System.err.println("right plane = " + frustumPlanes[1]);
+ //System.err.println("top plane = " + frustumPlanes[2]);
+ //System.err.println("bottom plane = " + frustumPlanes[3]);
+ //System.err.println("front plane = " + frustumPlanes[4]);
+ //System.err.println("back plane = " + frustumPlanes[5]);
+ }
+
+ private void computePlaneEq(Point4d p1, Point4d p2, Point4d p3, Point4d p4,
+ Vector4d planeEq) {
+ tVec1.x = p3.x - p1.x;
+ tVec1.y = p3.y - p1.y;
+ tVec1.z = p3.z - p1.z;
+
+ tVec2.x = p2.x - p1.x;
+ tVec2.y = p2.y - p1.y;
+ tVec2.z = p2.z - p1.z;
+
+ tVec3.cross(tVec2, tVec1);
+ tVec3.normalize();
+ planeEq.x = tVec3.x;
+ planeEq.y = tVec3.y;
+ planeEq.z = tVec3.z;
+ planeEq.w = -(planeEq.x * p1.x + planeEq.y * p1.y + planeEq.z * p1.z);
+ }
+
+ // Get methods for returning derived data values.
+ // Eventually, these get functions will cause some of the parameters
+ // to be lazily evaluated.
+ //
+ // NOTE: in the case of Transform3D, and Tuple objects, a reference
+ // to the actual derived data is returned. In these cases, the caller
+ // must ensure that the returned data is not modified.
+ //
+ // NOTE: the snapshot and computeDerivedData methods are synchronized.
+ // Callers of the following methods that can run asynchronously with
+ // the renderer must call these methods and copy the data from within
+ // a synchronized block on the canvas view cache object.
+
+ int getCanvasX() {
+ return canvasX;
+ }
+
+ int getCanvasY() {
+ return canvasY;
+ }
+
+ int getCanvasWidth() {
+ return canvasWidth;
+ }
+
+ int getCanvasHeight() {
+ return canvasHeight;
+ }
+
+ double getPhysicalWindowWidth() {
+ return physicalWindowWidth;
+ }
+
+ double getPhysicalWindowHeight() {
+ return physicalWindowHeight;
+ }
+
+ boolean getUseStereo() {
+ return useStereo;
+ }
+
+ Transform3D getLeftProjection() {
+ return leftProjection;
+ }
+
+ Transform3D getRightProjection() {
+ return rightProjection;
+ }
+
+ Transform3D getLeftVpcToEc() {
+ return leftVpcToEc;
+ }
+
+ Transform3D getRightVpcToEc() {
+ return rightVpcToEc;
+ }
+
+ Transform3D getLeftEcToVpc() {
+ return leftEcToVpc;
+ }
+
+ Transform3D getRightEcToVpc() {
+ return rightEcToVpc;
+ }
+
+ Transform3D getInfLeftProjection() {
+ return infLeftProjection;
+ }
+
+ Transform3D getInfRightProjection() {
+ return infLeftProjection;
+ }
+
+ Transform3D getInfLeftVpcToEc() {
+ return infLeftVpcToEc;
+ }
+
+ Transform3D getInfRightVpcToEc() {
+ return infRightVpcToEc;
+ }
+
+ Transform3D getInfLeftEcToVpc() {
+ return infLeftEcToVpc;
+ }
+
+ Transform3D getInfgRightEcToVpc() {
+ return infRightEcToVpc;
+ }
+
+ Transform3D getInfVworldToVpc() {
+ return infVworldToVpc;
+ }
+
+ Transform3D getLeftCcToVworld() {
+ return leftCcToVworld;
+ }
+
+ Transform3D getRightCcToVworld() {
+ return rightCcToVworld;
+ }
+
+ Transform3D getImagePlateToVworld() {
+ // XXXX: Document -- This will return the transform of left plate.
+ return leftPlateToVworld;
+ }
+
+
+
+ Transform3D getLastVworldToImagePlate() {
+ // XXXX: Document -- This will return the transform of left plate.
+ return lastVworldToLeftPlate;
+
+ }
+
+ Transform3D getVworldToImagePlate() {
+ // XXXX: Document -- This will return the transform of left plate.
+ return vworldToLeftPlate;
+ }
+
+ Transform3D getVworldToTrackerBase() {
+ return vworldToTrackerBase;
+ }
+
+ double getVworldToCoexistenceScale() {
+ return vworldToCoexistenceScale;
+ }
+
+ double getInfVworldToCoexistenceScale() {
+ return infVworldToCoexistenceScale;
+ }
+
+ Point3d getLeftEyeInImagePlate() {
+ return leftEyeInImagePlate;
+ }
+
+ Point3d getRightEyeInImagePlate() {
+ return rightEyeInImagePlate;
+ }
+
+ Point3d getCenterEyeInImagePlate() {
+ return centerEyeInImagePlate;
+ }
+
+ Transform3D getHeadToVworld() {
+ return headToVworld;
+ }
+
+ Transform3D getVpcToVworld() {
+ return vpcToVworld;
+ }
+
+ Transform3D getVworldToVpc() {
+ return vworldToVpc;
+ }
+
+
+ // Transform the specified X point in AWT window-relative coordinates
+ // to image plate coordinates
+ double getWindowXInImagePlate(double x) {
+ double xScreen = x + (double)canvasX;
+ return metersPerPixelX * xScreen;
+ }
+
+ // Transform the specified Y point in AWT window-relative coordinates
+ // to image plate coordinates
+ double getWindowYInImagePlate(double y) {
+ double yScreen = y + (double)canvasY;
+ return metersPerPixelY * ((double)(screenHeight - 1) - yScreen);
+ }
+
+ Vector4d[] getLeftFrustumPlanesInVworld() {
+ return leftFrustumPlanes;
+ }
+
+ Vector4d[] getRightFrustumPlanesInVworld() {
+ return rightFrustumPlanes;
+ }
+
+
+ void getPixelLocationInImagePlate(double x, double y, double z,
+ Point3d imagePlatePoint) {
+
+ double screenx = (x + canvasX)*metersPerPixelX;
+ double screeny = (screenHeight - 1 - canvasY - y)*metersPerPixelY;
+
+ if ((viewCache.projectionPolicy == View.PERSPECTIVE_PROJECTION) &&
+ (centerEyeInImagePlate.z != 0)) {
+ double zScale = 1.0 - z/centerEyeInImagePlate.z;
+ imagePlatePoint.x = (screenx - centerEyeInImagePlate.x)*zScale
+ + centerEyeInImagePlate.x;
+ imagePlatePoint.y = (screeny - centerEyeInImagePlate.y)*zScale
+ + centerEyeInImagePlate.y;
+ } else {
+ imagePlatePoint.x = screenx;
+ imagePlatePoint.y = screeny;
+ }
+ imagePlatePoint.z = z;
+ }
+
+ /**
+ * Projects the specified point from image plate coordinates
+ * into AWT pixel coordinates.
+ */
+ void getPixelLocationFromImagePlate(Point3d imagePlatePoint,
+ Point2d pixelLocation) {
+
+ double screenX, screenY;
+
+ if(viewCache.projectionPolicy == View.PERSPECTIVE_PROJECTION) {
+ // get the vector from centerEyeInImagePlate to imagePlatePoint
+ tVec1.sub(imagePlatePoint, centerEyeInImagePlate);
+
+ // Scale this vector to make it end at the projection plane.
+ // Scale is ratio :
+ // eye->imagePlate Plane dist / eye->imagePlatePt dist
+ // eye dist to plane is eyePos.z (eye is in +z space)
+ // image->eye dist is -tVec1.z (image->eye is in -z dir)
+ //System.err.println("eye dist = " + (centerEyeInImagePlate.z));
+ //System.err.println("image dist = " + (-tVec1.z));
+ if (tVec1.z != 0) {
+ double zScale = centerEyeInImagePlate.z / (-tVec1.z);
+ screenX = centerEyeInImagePlate.x + tVec1.x * zScale;
+ screenY = centerEyeInImagePlate.y + tVec1.y * zScale;
+
+ } else {
+ screenX = imagePlatePoint.x;
+ screenY = imagePlatePoint.y;
+ }
+
+ } else {
+ screenX = imagePlatePoint.x;
+ screenY = imagePlatePoint.y;
+ }
+
+ //System.err.println("screenX = " + screenX + " screenY = " + screenY);
+ // Note: screenPt is in image plate coords, at z=0
+
+ // Transform from image plate coords to screen coords
+ pixelLocation.x = (screenX / screenViewCache.metersPerPixelX) - canvasX;
+ pixelLocation.y = screenViewCache.screenHeight - 1 -
+ (screenY / screenViewCache.metersPerPixelY) - canvasY;
+ //System.err.println("pixelLocation = " + pixelLocation);
+ }
+
+ /**
+ * Constructs and initializes a CanvasViewCache object.
+ * Note that the canvas, screen, screenCache, view, and
+ * viewCache parameters are all fixed at construction time
+ * and must be non-null.
+ */
+ CanvasViewCache(Canvas3D canvas,
+ ScreenViewCache screenViewCache,
+ ViewCache viewCache) {
+
+ this.canvas = canvas;
+ this.screenViewCache = screenViewCache;
+ this.viewCache = viewCache;
+
+ // Set up the initial plane equations
+ int i;
+ for (i = 0; i < leftFrustumPlanes.length; i++) {
+ leftFrustumPlanes[i] = new Vector4d();
+ rightFrustumPlanes[i] = new Vector4d();
+ }
+
+ for (i = 0; i < leftFrustumPoints.length; i++) {
+ leftFrustumPoints[i] = new Point4d();
+ rightFrustumPoints[i] = new Point4d();
+ }
+
+ // canvas is null in Renderer copyOfCvCache
+ if (canvas != null) {
+ leftEyeInImagePlate.set(canvas.leftManualEyeInImagePlate);
+ rightEyeInImagePlate.set(canvas.rightManualEyeInImagePlate);
+ centerEyeInImagePlate.add(leftEyeInImagePlate,
+ rightEyeInImagePlate);
+ centerEyeInImagePlate.scale(0.5);
+ }
+
+ if((J3dDebug.devPhase) && (J3dDebug.canvasViewCache >= J3dDebug.LEVEL_1))
+ System.err.println("Constructed a CanvasViewCache");
+ }
+
+ synchronized void setCanvas(Canvas3D c) {
+ canvas = c;
+ }
+
+ synchronized void setScreenViewCache(ScreenViewCache svc) {
+ screenViewCache = svc;
+ }
+
+ synchronized void setViewCache(ViewCache vc) {
+ viewCache = vc;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CanvasViewEventCatcher.java b/j3d-core/src/classes/share/javax/media/j3d/CanvasViewEventCatcher.java
new file mode 100644
index 0000000..b821841
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CanvasViewEventCatcher.java
@@ -0,0 +1,102 @@
+/*
+ * $RCSfile: CanvasViewEventCatcher.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.ArrayList;
+import java.awt.*;
+import java.awt.event.*;
+
+/**
+ * The CanvasViewEventCatcher class is used to track events on a Canvas3D that
+ * may cause view matries to change.
+ *
+ */
+class CanvasViewEventCatcher extends ComponentAdapter {
+
+ // The canvas associated with this event catcher
+ private Canvas3D canvas;
+ private static final boolean DEBUG = false;
+
+ CanvasViewEventCatcher(Canvas3D c) {
+ canvas = c;
+ }
+
+ public void componentResized(ComponentEvent e) {
+ if (DEBUG) {
+ System.err.println("Component resized " + e);
+ }
+
+ if(e.getComponent() == canvas ) {
+ if (DEBUG) {
+ System.err.println("It is canvas!");
+ }
+ synchronized(canvas) {
+ synchronized (canvas.dirtyMaskLock) {
+ canvas.cvDirtyMask[0] |= Canvas3D.MOVED_OR_RESIZED_DIRTY;
+ canvas.cvDirtyMask[1] |= Canvas3D.MOVED_OR_RESIZED_DIRTY;
+ }
+ canvas.resizeGraphics2D = true;
+ }
+
+ // see comment below
+ try {
+ canvas.newSize = canvas.getSize();
+ canvas.newPosition = canvas.getLocationOnScreen();
+ } catch (IllegalComponentStateException ex) {}
+
+ }
+ }
+
+ public void componentMoved(ComponentEvent e) {
+ if (DEBUG) {
+ System.err.println("Component moved " + e);
+ }
+
+ synchronized(canvas) {
+ synchronized (canvas.dirtyMaskLock) {
+ canvas.cvDirtyMask[0] |= Canvas3D.MOVED_OR_RESIZED_DIRTY;
+ canvas.cvDirtyMask[1] |= Canvas3D.MOVED_OR_RESIZED_DIRTY;
+ }
+ }
+ // Can't sync. with canvas lock since canvas.getLocationOnScreen()
+ // required Component lock. The order is reverse of
+ // removeNotify() lock sequence which required Component lock
+ // first, then canvas lock in removeComponentListener()
+
+ try {
+ canvas.newSize = canvas.getSize();
+ canvas.newPosition = canvas.getLocationOnScreen();
+ } catch (IllegalComponentStateException ex) {}
+
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CapabilityBits.java b/j3d-core/src/classes/share/javax/media/j3d/CapabilityBits.java
new file mode 100644
index 0000000..8dbdb7e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CapabilityBits.java
@@ -0,0 +1,546 @@
+/*
+ * $RCSfile: CapabilityBits.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * This CapabilityBits class provides a global namespace for all
+ * capability bits
+ */
+class CapabilityBits extends Object {
+
+ // SceneGraphObject
+
+ // Node extends SceneGraphObject
+ static final int NODE_ENABLE_COLLISION_REPORTING = 0;
+ static final int NODE_ENABLE_PICK_REPORTING = 1;
+ private static final int NODE_UNUSED_BIT = 2;
+ static final int NODE_ALLOW_BOUNDS_READ = 3;
+ static final int NODE_ALLOW_BOUNDS_WRITE = 4;
+ static final int NODE_ALLOW_PICKABLE_READ = 5;
+ static final int NODE_ALLOW_PICKABLE_WRITE = 6;
+ static final int NODE_ALLOW_COLLIDABLE_READ = 7;
+ static final int NODE_ALLOW_COLLIDABLE_WRITE = 8;
+ static final int NODE_ALLOW_AUTO_COMPUTE_BOUNDS_READ = 9;
+ static final int NODE_ALLOW_AUTO_COMPUTE_BOUNDS_WRITE = 10;
+ static final int NODE_ALLOW_LOCAL_TO_VWORLD_READ = 11;
+
+
+ // Group extends Node
+ static final int GROUP_ALLOW_CHILDREN_READ = 12;
+ static final int GROUP_ALLOW_CHILDREN_WRITE = 13;
+ static final int GROUP_ALLOW_CHILDREN_EXTEND = 14;
+ static final int GROUP_ALLOW_COLLISION_BOUNDS_READ = 15;
+ static final int GROUP_ALLOW_COLLISION_BOUNDS_WRITE = 16;
+
+ // BranchGroup extends Group
+ static final int BRANCH_GROUP_ALLOW_DETACH = 17;
+
+ // SharedGroup extends Group
+ static final int SHARED_GROUP_ALLOW_LINK_READ = 17;
+
+ // TransformGroup extends Group
+ static final int TRANSFORM_GROUP_ALLOW_TRANSFORM_READ = 17;
+ static final int TRANSFORM_GROUP_ALLOW_TRANSFORM_WRITE = 18;
+
+ // Switch extends Group
+ static final int SWITCH_ALLOW_SWITCH_READ = 17;
+ static final int SWITCH_ALLOW_SWITCH_WRITE = 18;
+
+ // ViewSpecificGroup extends Group
+ static final int VIEW_SPECIFIC_GROUP_ALLOW_VIEW_READ = 17;
+ static final int VIEW_SPECIFIC_GROUP_ALLOW_VIEW_WRITE = 18;
+
+ // OrderedGroup extends Group
+ static final int ORDERED_GROUP_ALLOW_CHILD_INDEX_ORDER_READ = 17;
+ static final int ORDERED_GROUP_ALLOW_CHILD_INDEX_ORDER_WRITE = 18;
+
+
+ // Leaf extends Node
+
+ // Background extends Leaf
+ static final int BACKGROUND_ALLOW_APPLICATION_BOUNDS_READ = 12;
+ static final int BACKGROUND_ALLOW_APPLICATION_BOUNDS_WRITE = 13;
+ static final int BACKGROUND_ALLOW_IMAGE_READ = 14;
+ static final int BACKGROUND_ALLOW_IMAGE_WRITE = 15;
+ static final int BACKGROUND_ALLOW_COLOR_READ = 16;
+ static final int BACKGROUND_ALLOW_COLOR_WRITE = 17;
+ static final int BACKGROUND_ALLOW_GEOMETRY_READ = 18;
+ static final int BACKGROUND_ALLOW_GEOMETRY_WRITE = 19;
+ static final int BACKGROUND_ALLOW_IMAGE_SCALE_MODE_READ = 20;
+ static final int BACKGROUND_ALLOW_IMAGE_SCALE_MODE_WRITE = 21;
+
+ // BoundingLeaf extends Leaf
+ static final int BOUNDING_LEAF_ALLOW_REGION_READ = 12;
+ static final int BOUNDING_LEAF_ALLOW_REGION_WRITE = 13;
+
+ // Clip extends Leaf
+ static final int CLIP_ALLOW_APPLICATION_BOUNDS_READ = 12;
+ static final int CLIP_ALLOW_APPLICATION_BOUNDS_WRITE = 13;
+ static final int CLIP_ALLOW_BACK_DISTANCE_READ = 14;
+ static final int CLIP_ALLOW_BACK_DISTANCE_WRITE = 15;
+
+ // Morph extends Leaf
+ static final int MORPH_ALLOW_GEOMETRY_ARRAY_READ = 12;
+ static final int MORPH_ALLOW_GEOMETRY_ARRAY_WRITE = 13;
+ static final int MORPH_ALLOW_APPEARANCE_READ = 14;
+ static final int MORPH_ALLOW_APPEARANCE_WRITE = 15;
+ static final int MORPH_ALLOW_WEIGHTS_READ = 16;
+ static final int MORPH_ALLOW_WEIGHTS_WRITE = 17;
+ static final int MORPH_ALLOW_COLLISION_BOUNDS_READ = 18;
+ static final int MORPH_ALLOW_COLLISION_BOUNDS_WRITE = 19;
+ static final int MORPH_ALLOW_APPEARANCE_OVERRIDE_READ = 20;
+ static final int MORPH_ALLOW_APPEARANCE_OVERRIDE_WRITE = 21;
+
+ // Link extends Leaf
+ static final int LINK_ALLOW_SHARED_GROUP_READ = 12;
+ static final int LINK_ALLOW_SHARED_GROUP_WRITE = 13;
+
+ // Shape3D extends Leaf
+ static final int SHAPE3D_ALLOW_GEOMETRY_READ = 12;
+ static final int SHAPE3D_ALLOW_GEOMETRY_WRITE = 13;
+ static final int SHAPE3D_ALLOW_APPEARANCE_READ = 14;
+ static final int SHAPE3D_ALLOW_APPEARANCE_WRITE = 15;
+ static final int SHAPE3D_ALLOW_COLLISION_BOUNDS_READ = 16;
+ static final int SHAPE3D_ALLOW_COLLISION_BOUNDS_WRITE = 17;
+ static final int SHAPE3D_ALLOW_APPEARANCE_OVERRIDE_READ = 18;
+ static final int SHAPE3D_ALLOW_APPEARANCE_OVERRIDE_WRITE = 19;
+
+ // OrientedShape3D extends Shape3D
+ static final int ORIENTED_SHAPE3D_ALLOW_MODE_READ = 20;
+ static final int ORIENTED_SHAPE3D_ALLOW_MODE_WRITE = 21;
+ static final int ORIENTED_SHAPE3D_ALLOW_AXIS_READ = 22;
+ static final int ORIENTED_SHAPE3D_ALLOW_AXIS_WRITE = 23;
+ static final int ORIENTED_SHAPE3D_ALLOW_POINT_READ = 24;
+ static final int ORIENTED_SHAPE3D_ALLOW_POINT_WRITE = 25;
+ static final int ORIENTED_SHAPE3D_ALLOW_SCALE_READ = 26;
+ static final int ORIENTED_SHAPE3D_ALLOW_SCALE_WRITE = 27;
+
+ // Soundscape extends Leaf
+ static final int SOUNDSCAPE_ALLOW_APPLICATION_BOUNDS_READ = 12;
+ static final int SOUNDSCAPE_ALLOW_APPLICATION_BOUNDS_WRITE = 13;
+ static final int SOUNDSCAPE_ALLOW_ATTRIBUTES_READ = 14;
+ static final int SOUNDSCAPE_ALLOW_ATTRIBUTES_WRITE = 15;
+
+ // ViewPlatform extends Leaf
+ static final int VIEW_PLATFORM_ALLOW_POLICY_READ = 12;
+ static final int VIEW_PLATFORM_ALLOW_POLICY_WRITE = 13;
+
+ // Fog extends Leaf
+ static final int FOG_ALLOW_INFLUENCING_BOUNDS_READ = 12;
+ static final int FOG_ALLOW_INFLUENCING_BOUNDS_WRITE = 13;
+ static final int FOG_ALLOW_COLOR_READ = 14;
+ static final int FOG_ALLOW_COLOR_WRITE = 15;
+
+ // ExponentialFog extends Fog
+ static final int EXPONENTIAL_FOG_ALLOW_DENSITY_READ = 16;
+ static final int EXPONENTIAL_FOG_ALLOW_DENSITY_WRITE = 17;
+
+ // LinearFog extends Fog
+ static final int LINEAR_FOG_ALLOW_DISTANCE_READ = 16;
+ static final int LINEAR_FOG_ALLOW_DISTANCE_WRITE = 17;
+
+ // Additional Fog bits (must go after LinearFog bits)
+ static final int FOG_ALLOW_SCOPE_READ = 18;
+ static final int FOG_ALLOW_SCOPE_WRITE = 19;
+
+ // Light extends Leaf
+ static final int LIGHT_ALLOW_STATE_READ = 12;
+ static final int LIGHT_ALLOW_STATE_WRITE = 13;
+ static final int LIGHT_ALLOW_COLOR_READ = 14;
+ static final int LIGHT_ALLOW_COLOR_WRITE = 15;
+ static final int LIGHT_ALLOW_INFLUENCING_BOUNDS_READ = 16;
+ static final int LIGHT_ALLOW_INFLUENCING_BOUNDS_WRITE = 17;
+
+ // DirectionalLight extends Light
+ static final int DIRECTIONAL_LIGHT_ALLOW_DIRECTION_READ = 18;
+ static final int DIRECTIONAL_LIGHT_ALLOW_DIRECTION_WRITE = 19;
+
+ // PointLight extends Light
+ static final int POINT_LIGHT_ALLOW_POSITION_READ = 18;
+ static final int POINT_LIGHT_ALLOW_POSITION_WRITE = 19;
+ static final int POINT_LIGHT_ALLOW_ATTENUATION_READ = 20;
+ static final int POINT_LIGHT_ALLOW_ATTENUATION_WRITE = 21;
+
+ // SpotLight extends PointLight
+ static final int SPOT_LIGHT_ALLOW_SPREAD_ANGLE_WRITE = 22;
+ static final int SPOT_LIGHT_ALLOW_SPREAD_ANGLE_READ = 23;
+ static final int SPOT_LIGHT_ALLOW_CONCENTRATION_WRITE = 24;
+ static final int SPOT_LIGHT_ALLOW_CONCENTRATION_READ = 25;
+ static final int SPOT_LIGHT_ALLOW_DIRECTION_WRITE = 26;
+ static final int SPOT_LIGHT_ALLOW_DIRECTION_READ = 27;
+
+ // Additional Light bits (must go after SpotLight bits)
+ static final int LIGHT_ALLOW_SCOPE_READ = 28;
+ static final int LIGHT_ALLOW_SCOPE_WRITE = 29;
+
+ // Sound extends Leaf
+ static final int SOUND_ALLOW_SOUND_DATA_READ = 12;
+ static final int SOUND_ALLOW_SOUND_DATA_WRITE = 13;
+ static final int SOUND_ALLOW_INITIAL_GAIN_READ = 14;
+ static final int SOUND_ALLOW_INITIAL_GAIN_WRITE = 15;
+ static final int SOUND_ALLOW_LOOP_READ = 16;
+ static final int SOUND_ALLOW_LOOP_WRITE = 17;
+ static final int SOUND_ALLOW_RELEASE_READ = 18;
+ static final int SOUND_ALLOW_RELEASE_WRITE = 19;
+ static final int SOUND_ALLOW_CONT_PLAY_READ = 20;
+ static final int SOUND_ALLOW_CONT_PLAY_WRITE = 21;
+ static final int SOUND_ALLOW_ENABLE_READ = 22;
+ static final int SOUND_ALLOW_ENABLE_WRITE = 23;
+ static final int SOUND_ALLOW_SCHEDULING_BOUNDS_READ = 24;
+ static final int SOUND_ALLOW_SCHEDULING_BOUNDS_WRITE = 25;
+ static final int SOUND_ALLOW_PRIORITY_READ = 26;
+ static final int SOUND_ALLOW_PRIORITY_WRITE = 27;
+ static final int SOUND_ALLOW_DURATION_READ = 28;
+ static final int SOUND_ALLOW_IS_READY_READ = 29;
+ static final int SOUND_ALLOW_IS_PLAYING_READ = 30;
+ static final int SOUND_ALLOW_CHANNELS_USED_READ = 31;
+ static final int SOUND_ALLOW_MUTE_READ = 40;
+ static final int SOUND_ALLOW_MUTE_WRITE = 41;
+ static final int SOUND_ALLOW_PAUSE_READ = 42;
+ static final int SOUND_ALLOW_PAUSE_WRITE = 43;
+ static final int SOUND_ALLOW_RATE_SCALE_FACTOR_READ = 44;
+ static final int SOUND_ALLOW_RATE_SCALE_FACTOR_WRITE = 45;
+
+ // PointSound extends Sound
+ static final int POINT_SOUND_ALLOW_POSITION_READ = 32;
+ static final int POINT_SOUND_ALLOW_POSITION_WRITE = 33;
+ static final int POINT_SOUND_ALLOW_DISTANCE_GAIN_READ = 34;
+ static final int POINT_SOUND_ALLOW_DISTANCE_GAIN_WRITE = 35;
+
+ // ConeSound extends PointSound
+ static final int CONE_SOUND_ALLOW_DIRECTION_READ = 36;
+ static final int CONE_SOUND_ALLOW_DIRECTION_WRITE = 37;
+ static final int CONE_SOUND_ALLOW_ANGULAR_ATTENUATION_READ = 38;
+ static final int CONE_SOUND_ALLOW_ANGULAR_ATTENUATION_WRITE = 39;
+
+ // ModelClip extends Leaf
+ static final int MODEL_CLIP_ALLOW_INFLUENCING_BOUNDS_READ = 12;
+ static final int MODEL_CLIP_ALLOW_INFLUENCING_BOUNDS_WRITE = 13;
+ static final int MODEL_CLIP_ALLOW_PLANE_READ = 14;
+ static final int MODEL_CLIP_ALLOW_PLANE_WRITE = 15;
+ static final int MODEL_CLIP_ALLOW_ENABLE_READ = 16;
+ static final int MODEL_CLIP_ALLOW_ENABLE_WRITE = 17;
+ static final int MODEL_CLIP_ALLOW_SCOPE_READ = 18;
+ static final int MODEL_CLIP_ALLOW_SCOPE_WRITE = 19;
+
+ // AlternateAppearance extends Leaf
+ static final int ALTERNATE_APPEARANCE_ALLOW_INFLUENCING_BOUNDS_READ = 12;
+ static final int ALTERNATE_APPEARANCE_ALLOW_INFLUENCING_BOUNDS_WRITE = 13;
+ static final int ALTERNATE_APPEARANCE_ALLOW_APPEARANCE_READ = 14;
+ static final int ALTERNATE_APPEARANCE_ALLOW_APPEARANCE_WRITE = 15;
+ static final int ALTERNATE_APPEARANCE_ALLOW_SCOPE_READ = 16;
+ static final int ALTERNATE_APPEARANCE_ALLOW_SCOPE_WRITE = 17;
+
+ // Additional Node bits (must go after all existing Node subclass bits)
+ static final int NODE_ALLOW_PARENT_READ = 46;
+ static final int NODE_ALLOW_LOCALE_READ = 47;
+
+
+ // NodeComponent extends SceneGraphObject
+
+ // Appearance extends NodeComponent
+ static final int APPEARANCE_ALLOW_MATERIAL_READ = 0;
+ static final int APPEARANCE_ALLOW_MATERIAL_WRITE = 1;
+ static final int APPEARANCE_ALLOW_TEXTURE_READ = 2;
+ static final int APPEARANCE_ALLOW_TEXTURE_WRITE = 3;
+ static final int APPEARANCE_ALLOW_TEXGEN_READ = 4;
+ static final int APPEARANCE_ALLOW_TEXGEN_WRITE = 5;
+ static final int APPEARANCE_ALLOW_TEXTURE_ATTRIBUTES_READ = 6;
+ static final int APPEARANCE_ALLOW_TEXTURE_ATTRIBUTES_WRITE = 7;
+ static final int APPEARANCE_ALLOW_COLORING_ATTRIBUTES_READ = 8;
+ static final int APPEARANCE_ALLOW_COLORING_ATTRIBUTES_WRITE = 9;
+ static final int APPEARANCE_ALLOW_TRANSPARENCY_ATTRIBUTES_READ = 10;
+ static final int APPEARANCE_ALLOW_TRANSPARENCY_ATTRIBUTES_WRITE = 11;
+ static final int APPEARANCE_ALLOW_RENDERING_ATTRIBUTES_READ = 12;
+ static final int APPEARANCE_ALLOW_RENDERING_ATTRIBUTES_WRITE = 13;
+ static final int APPEARANCE_ALLOW_POLYGON_ATTRIBUTES_READ = 14;
+ static final int APPEARANCE_ALLOW_POLYGON_ATTRIBUTES_WRITE = 15;
+ static final int APPEARANCE_ALLOW_LINE_ATTRIBUTES_READ = 16;
+ static final int APPEARANCE_ALLOW_LINE_ATTRIBUTES_WRITE = 17;
+ static final int APPEARANCE_ALLOW_POINT_ATTRIBUTES_READ = 18;
+ static final int APPEARANCE_ALLOW_POINT_ATTRIBUTES_WRITE = 19;
+ static final int APPEARANCE_ALLOW_TEXTURE_UNIT_STATE_READ = 20;
+ static final int APPEARANCE_ALLOW_TEXTURE_UNIT_STATE_WRITE = 21;
+
+ // ShaderAppearance extends Appearance
+ static final int SHADER_APPEARANCE_ALLOW_SHADER_PROGRAM_READ = 22;
+ static final int SHADER_APPEARANCE_ALLOW_SHADER_PROGRAM_WRITE = 23;
+ static final int SHADER_APPEARANCE_ALLOW_SHADER_ATTRIBUTE_SET_READ = 24;
+ static final int SHADER_APPEARANCE_ALLOW_SHADER_ATTRIBUTE_SET_WRITE = 25;
+
+ // AuralAttributes extends NodeComponent
+ static final int AURAL_ATTRIBUTES_ALLOW_ATTRIBUTE_GAIN_READ = 0;
+ static final int AURAL_ATTRIBUTES_ALLOW_ATTRIBUTE_GAIN_WRITE = 1;
+ static final int AURAL_ATTRIBUTES_ALLOW_ROLLOFF_READ = 2;
+ static final int AURAL_ATTRIBUTES_ALLOW_ROLLOFF_WRITE = 3;
+ static final int AURAL_ATTRIBUTES_ALLOW_REFLECTION_COEFFICIENT_READ = 4;
+ static final int AURAL_ATTRIBUTES_ALLOW_REFLECTION_COEFFICIENT_WRITE = 5;
+ static final int AURAL_ATTRIBUTES_ALLOW_REVERB_DELAY_READ = 6;
+ static final int AURAL_ATTRIBUTES_ALLOW_REVERB_DELAY_WRITE = 7;
+ static final int AURAL_ATTRIBUTES_ALLOW_REVERB_ORDER_READ = 8;
+ static final int AURAL_ATTRIBUTES_ALLOW_REVERB_ORDER_WRITE = 9;
+ static final int AURAL_ATTRIBUTES_ALLOW_DISTANCE_FILTER_READ = 10;
+ static final int AURAL_ATTRIBUTES_ALLOW_DISTANCE_FILTER_WRITE = 11;
+ static final int AURAL_ATTRIBUTES_ALLOW_FREQUENCY_SCALE_FACTOR_READ = 12;
+ static final int AURAL_ATTRIBUTES_ALLOW_FREQUENCY_SCALE_FACTOR_WRITE = 13;
+ static final int AURAL_ATTRIBUTES_ALLOW_VELOCITY_SCALE_FACTOR_READ = 14;
+ static final int AURAL_ATTRIBUTES_ALLOW_VELOCITY_SCALE_FACTOR_WRITE = 15;
+ static final int AURAL_ATTRIBUTES_ALLOW_REFLECTION_DELAY_READ = 16;
+ static final int AURAL_ATTRIBUTES_ALLOW_REFLECTION_DELAY_WRITE = 17;
+ static final int AURAL_ATTRIBUTES_ALLOW_REVERB_COEFFICIENT_READ = 18;
+ static final int AURAL_ATTRIBUTES_ALLOW_REVERB_COEFFICIENT_WRITE = 19;
+ static final int AURAL_ATTRIBUTES_ALLOW_DECAY_TIME_READ = 20;
+ static final int AURAL_ATTRIBUTES_ALLOW_DECAY_TIME_WRITE = 21;
+ static final int AURAL_ATTRIBUTES_ALLOW_DECAY_FILTER_READ = 22;
+ static final int AURAL_ATTRIBUTES_ALLOW_DECAY_FILTER_WRITE = 23;
+ static final int AURAL_ATTRIBUTES_ALLOW_DIFFUSION_READ = 24;
+ static final int AURAL_ATTRIBUTES_ALLOW_DIFFUSION_WRITE = 25;
+ static final int AURAL_ATTRIBUTES_ALLOW_DENSITY_READ = 26;
+ static final int AURAL_ATTRIBUTES_ALLOW_DENSITY_WRITE = 27;
+
+ // ColoringAttributes extends NodeComponent
+ static final int COLORING_ATTRIBUTES_ALLOW_COLOR_READ = 0;
+ static final int COLORING_ATTRIBUTES_ALLOW_COLOR_WRITE = 1;
+ static final int COLORING_ATTRIBUTES_ALLOW_SHADE_MODEL_READ = 2;
+ static final int COLORING_ATTRIBUTES_ALLOW_SHADE_MODEL_WRITE = 3;
+
+ // DepthComponent extends NodeComponent
+ static final int DEPTH_COMPONENT_ALLOW_SIZE_READ = 0;
+ static final int DEPTH_COMPONENT_ALLOW_DATA_READ = 1;
+
+ // ImageComponent extends NodeComponent
+ static final int IMAGE_COMPONENT_ALLOW_SIZE_READ = 0;
+ static final int IMAGE_COMPONENT_ALLOW_FORMAT_READ = 1;
+ static final int IMAGE_COMPONENT_ALLOW_IMAGE_READ = 2;
+ static final int IMAGE_COMPONENT_ALLOW_IMAGE_WRITE = 3;
+
+ // LineAttributes extends NodeComponent
+ static final int LINE_ATTRIBUTES_ALLOW_WIDTH_READ = 0;
+ static final int LINE_ATTRIBUTES_ALLOW_WIDTH_WRITE = 1;
+ static final int LINE_ATTRIBUTES_ALLOW_PATTERN_READ = 2;
+ static final int LINE_ATTRIBUTES_ALLOW_PATTERN_WRITE = 3;
+ static final int LINE_ATTRIBUTES_ALLOW_ANTIALIASING_READ = 4;
+ static final int LINE_ATTRIBUTES_ALLOW_ANTIALIASING_WRITE = 5;
+
+ // Material extends NodeComponent
+ static final int MATERIAL_ALLOW_COMPONENT_READ = 0;
+ static final int MATERIAL_ALLOW_COMPONENT_WRITE = 1;
+
+ // MediaContainer extends NodeComponent
+ static final int MEDIA_CONTAINER_ALLOW_CACHE_READ = 0;
+ static final int MEDIA_CONTAINER_ALLOW_CACHE_WRITE = 1;
+ static final int MEDIA_CONTAINER_ALLOW_URL_READ = 2;
+ static final int MEDIA_CONTAINER_ALLOW_URL_WRITE = 3;
+
+ // PointAttributes extends NodeComponent
+ static final int POINT_ATTRIBUTES_ALLOW_SIZE_READ = 0;
+ static final int POINT_ATTRIBUTES_ALLOW_SIZE_WRITE = 1;
+ static final int POINT_ATTRIBUTES_ALLOW_ANTIALIASING_READ = 2;
+ static final int POINT_ATTRIBUTES_ALLOW_ANTIALIASING_WRITE = 3;
+
+ // PolygonAttributes extends NodeComponent
+ static final int POLYGON_ATTRIBUTES_ALLOW_CULL_FACE_READ = 0;
+ static final int POLYGON_ATTRIBUTES_ALLOW_CULL_FACE_WRITE = 1;
+ static final int POLYGON_ATTRIBUTES_ALLOW_MODE_READ = 2;
+ static final int POLYGON_ATTRIBUTES_ALLOW_MODE_WRITE = 3;
+ static final int POLYGON_ATTRIBUTES_ALLOW_OFFSET_READ = 4;
+ static final int POLYGON_ATTRIBUTES_ALLOW_OFFSET_WRITE = 5;
+ static final int POLYGON_ATTRIBUTES_ALLOW_NORMAL_FLIP_READ = 6;
+ static final int POLYGON_ATTRIBUTES_ALLOW_NORMAL_FLIP_WRITE = 7;
+
+ // RenderingAttributes extends NodeComponent
+ static final int RENDERING_ATTRIBUTES_ALLOW_ALPHA_TEST_VALUE_READ = 0;
+ static final int RENDERING_ATTRIBUTES_ALLOW_ALPHA_TEST_VALUE_WRITE = 1;
+ static final int RENDERING_ATTRIBUTES_ALLOW_ALPHA_TEST_FUNCTION_READ = 2;
+ static final int RENDERING_ATTRIBUTES_ALLOW_ALPHA_TEST_FUNCTION_WRITE = 3;
+ static final int RENDERING_ATTRIBUTES_ALLOW_DEPTH_ENABLE_READ = 4;
+ static final int RENDERING_ATTRIBUTES_ALLOW_VISIBLE_READ = 5;
+ static final int RENDERING_ATTRIBUTES_ALLOW_VISIBLE_WRITE = 6;
+ static final int RENDERING_ATTRIBUTES_ALLOW_RASTER_OP_READ = 7;
+ static final int RENDERING_ATTRIBUTES_ALLOW_RASTER_OP_WRITE = 8;
+ static final int
+ RENDERING_ATTRIBUTES_ALLOW_IGNORE_VERTEX_COLORS_READ = 9;
+ static final int
+ RENDERING_ATTRIBUTES_ALLOW_IGNORE_VERTEX_COLORS_WRITE = 10;
+ static final int RENDERING_ATTRIBUTES_ALLOW_DEPTH_ENABLE_WRITE = 11;
+ static final int RENDERING_ATTRIBUTES_ALLOW_DEPTH_TEST_FUNCTION_READ = 12;
+ static final int RENDERING_ATTRIBUTES_ALLOW_DEPTH_TEST_FUNCTION_WRITE = 13;
+ static final int RENDERING_ATTRIBUTES_ALLOW_STENCIL_ATTRIBUTES_READ = 14;
+ static final int RENDERING_ATTRIBUTES_ALLOW_STENCIL_ATTRIBUTES_WRITE = 15;
+
+ // TexCoordGeneration extends NodeComponent
+ static final int TEX_COORD_GENERATION_ALLOW_ENABLE_READ = 0;
+ static final int TEX_COORD_GENERATION_ALLOW_ENABLE_WRITE = 1;
+ static final int TEX_COORD_GENERATION_ALLOW_FORMAT_READ = 2;
+ static final int TEX_COORD_GENERATION_ALLOW_MODE_READ = 3;
+ static final int TEX_COORD_GENERATION_ALLOW_PLANE_READ = 4;
+ static final int TEX_COORD_GENERATION_ALLOW_PLANE_WRITE = 5;
+
+ // Texture extends NodeComponent
+ static final int TEXTURE_ALLOW_ENABLE_READ = 0;
+ static final int TEXTURE_ALLOW_ENABLE_WRITE = 1;
+ static final int TEXTURE_ALLOW_BOUNDARY_MODE_READ = 2;
+ static final int TEXTURE_ALLOW_FILTER_READ = 3;
+ static final int TEXTURE_ALLOW_IMAGE_READ = 4;
+ static final int TEXTURE_ALLOW_MIPMAP_MODE_READ = 5;
+ static final int TEXTURE_ALLOW_BOUNDARY_COLOR_READ = 6;
+ static final int TEXTURE_ALLOW_IMAGE_WRITE = 7;
+ static final int TEXTURE_ALLOW_SIZE_READ = 8;
+ static final int TEXTURE_ALLOW_FORMAT_READ = 9;
+ static final int TEXTURE_ALLOW_LOD_RANGE_READ = 10;
+ static final int TEXTURE_ALLOW_LOD_RANGE_WRITE = 11;
+ static final int TEXTURE_ALLOW_ANISOTROPIC_FILTER_READ = 12;
+ static final int TEXTURE_ALLOW_SHARPEN_TEXTURE_READ = 13;
+ static final int TEXTURE_ALLOW_FILTER4_READ = 14;
+
+ // Texture2D extends Texture
+ static final int TEXTURE2D_ALLOW_DETAIL_TEXTURE_READ = 15;
+
+ // TextureAttributes extends NodeComponent
+ static final int TEXTURE_ATTRIBUTES_ALLOW_MODE_READ = 0;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_MODE_WRITE = 1;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_BLEND_COLOR_READ = 2;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_BLEND_COLOR_WRITE = 3;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_TRANSFORM_READ = 4;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_TRANSFORM_WRITE = 5;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_COLOR_TABLE_READ = 6;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_COLOR_TABLE_WRITE = 7;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_COMBINE_READ = 8;
+ static final int TEXTURE_ATTRIBUTES_ALLOW_COMBINE_WRITE = 9;
+
+ // TransparencyAttributes extends NodeComponent
+ static final int TRANSPARENCY_ATTRIBUTES_ALLOW_MODE_READ = 0;
+ static final int TRANSPARENCY_ATTRIBUTES_ALLOW_MODE_WRITE = 1;
+ static final int TRANSPARENCY_ATTRIBUTES_ALLOW_VALUE_READ = 2;
+ static final int TRANSPARENCY_ATTRIBUTES_ALLOW_VALUE_WRITE = 3;
+ static final int TRANSPARENCY_ATTRIBUTES_ALLOW_BLEND_FUNCTION_READ = 4;
+ static final int TRANSPARENCY_ATTRIBUTES_ALLOW_BLEND_FUNCTION_WRITE = 5;
+
+ // TextureUnitState extends NodeComponent
+ static final int TEXTURE_UNIT_STATE_ALLOW_STATE_READ = 0;
+ static final int TEXTURE_UNIT_STATE_ALLOW_STATE_WRITE = 1;
+
+ // ShaderProgram extends NodeComponent
+ static final int SHADER_PROGRAM_ALLOW_SHADERS_READ = 0;
+ static final int SHADER_PROGRAM_ALLOW_NAMES_READ = 1;
+
+ // ShaderAttributeSet extends NodeComponent
+ static final int SHADER_ATTRIBUTE_SET_ALLOW_ATTRIBUTES_READ = 0;
+ static final int SHADER_ATTRIBUTE_SET_ALLOW_ATTRIBUTES_WRITE = 1;
+
+ // ShaderAttribute extends NodeComponent
+
+ // ShaderAttributeObject extends ShaderAttribute
+ static final int SHADER_ATTRIBUTE_OBJECT_ALLOW_VALUE_READ = 0;
+ static final int SHADER_ATTRIBUTE_OBJECT_ALLOW_VALUE_WRITE = 1;
+
+ // Geometry extends NodeComponent
+ // NOTE: additional bits are below the subclasses
+
+ // GeometryArray extends Geometry
+ static final int GEOMETRY_ARRAY_ALLOW_COORDINATE_READ = 0;
+ static final int GEOMETRY_ARRAY_ALLOW_COORDINATE_WRITE = 1;
+ static final int GEOMETRY_ARRAY_ALLOW_COLOR_READ = 2;
+ static final int GEOMETRY_ARRAY_ALLOW_COLOR_WRITE = 3;
+ static final int GEOMETRY_ARRAY_ALLOW_NORMAL_READ = 4;
+ static final int GEOMETRY_ARRAY_ALLOW_NORMAL_WRITE = 5;
+ static final int GEOMETRY_ARRAY_ALLOW_TEXCOORD_READ = 6;
+ static final int GEOMETRY_ARRAY_ALLOW_TEXCOORD_WRITE = 7;
+ static final int GEOMETRY_ARRAY_ALLOW_COUNT_READ = 8;
+
+ // IndexedGeometryArray extends GeometryArray
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_COORDINATE_INDEX_READ = 9;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_COORDINATE_INDEX_WRITE= 10;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_COLOR_INDEX_READ = 11;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_COLOR_INDEX_WRITE = 12;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_NORMAL_INDEX_READ = 13;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_NORMAL_INDEX_WRITE = 14;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_TEXCOORD_INDEX_READ = 15;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_TEXCOORD_INDEX_WRITE = 16;
+
+ // Additional GeometryArray bits (must go after IndexedGeometryArray bits)
+ static final int GEOMETRY_ARRAY_ALLOW_FORMAT_READ = 17;
+ static final int J3D_1_2_GEOMETRY_ARRAY_ALLOW_REF_DATA_READ = 18;
+ static final int GEOMETRY_ARRAY_ALLOW_REF_DATA_WRITE = 19;
+ static final int GEOMETRY_ARRAY_ALLOW_COUNT_WRITE = 20;
+ static final int GEOMETRY_ARRAY_ALLOW_REF_DATA_READ = 21;
+ static final int GEOMETRY_ARRAY_ALLOW_VERTEX_ATTR_READ = 22;
+ static final int GEOMETRY_ARRAY_ALLOW_VERTEX_ATTR_WRITE = 23;
+
+ // Additional GeometryArray bits (must go after IndexedGeometryArray bits)
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_VERTEX_ATTR_INDEX_READ = 24;
+ static final int INDEXED_GEOMETRY_ARRAY_ALLOW_VERTEX_ATTR_INDEX_WRITE = 25;
+
+ // CompressedGeometry extends Geometry
+ static final int COMPRESSED_GEOMETRY_ALLOW_COUNT_READ = 0;
+ static final int COMPRESSED_GEOMETRY_ALLOW_HEADER_READ = 1;
+ static final int COMPRESSED_GEOMETRY_ALLOW_GEOMETRY_READ = 2;
+ static final int COMPRESSED_GEOMETRY_ALLOW_REF_DATA_READ = 3;
+
+ // Raster extends Geometry
+ static final int RASTER_ALLOW_POSITION_READ = 0;
+ static final int RASTER_ALLOW_POSITION_WRITE = 1;
+ static final int RASTER_ALLOW_OFFSET_READ = 2;
+ static final int RASTER_ALLOW_OFFSET_WRITE = 3;
+ static final int RASTER_ALLOW_IMAGE_READ = 4;
+ static final int RASTER_ALLOW_IMAGE_WRITE = 5;
+ static final int RASTER_ALLOW_DEPTH_COMPONENT_READ = 6;
+ static final int RASTER_ALLOW_DEPTH_COMPONENT_WRITE = 7;
+ static final int RASTER_ALLOW_SIZE_READ = 8;
+ static final int RASTER_ALLOW_SIZE_WRITE = 9;
+ static final int RASTER_ALLOW_TYPE_READ = 10;
+ static final int RASTER_ALLOW_CLIP_MODE_READ = 11;
+ static final int RASTER_ALLOW_CLIP_MODE_WRITE = 12;
+
+ // Text3D extends Geometry
+ static final int TEXT3D_ALLOW_FONT3D_READ = 0;
+ static final int TEXT3D_ALLOW_FONT3D_WRITE = 1;
+ static final int TEXT3D_ALLOW_STRING_READ = 2;
+ static final int TEXT3D_ALLOW_STRING_WRITE = 3;
+ static final int TEXT3D_ALLOW_POSITION_READ = 4;
+ static final int TEXT3D_ALLOW_POSITION_WRITE = 5;
+ static final int TEXT3D_ALLOW_ALIGNMENT_READ = 6;
+ static final int TEXT3D_ALLOW_ALIGNMENT_WRITE = 7;
+ static final int TEXT3D_ALLOW_PATH_READ = 8;
+ static final int TEXT3D_ALLOW_PATH_WRITE = 9;
+ static final int TEXT3D_ALLOW_CHARACTER_SPACING_READ = 10;
+ static final int TEXT3D_ALLOW_CHARACTER_SPACING_WRITE = 11;
+ static final int TEXT3D_ALLOW_BOUNDING_BOX_READ = 12;
+
+ // Additional geometry bits (must go after GeometryArray bits)
+ // NOTE: ALLOW_INTERSECT was duplicated by the old value of
+ // ALLOW_REF_DATA_READ in Java 3D 1.2.
+ static final int GEOMETRY_ALLOW_INTERSECT = 18;
+
+ // NOTE: any further additional Geometry bits must come after the
+ // last GeometryArray bit
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CapabilityNotSetException.java b/j3d-core/src/classes/share/javax/media/j3d/CapabilityNotSetException.java
new file mode 100644
index 0000000..7b4cf74
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CapabilityNotSetException.java
@@ -0,0 +1,56 @@
+/*
+ * $RCSfile: CapabilityNotSetException.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Indicates an access to a live or
+ * compiled Scene Graph object without the required capability
+ * set.
+ */
+public class CapabilityNotSetException extends RestrictedAccessException {
+
+/**
+ * Create the exception object with default values.
+ */
+ public CapabilityNotSetException(){
+ }
+
+/**
+ * Create the exception object that outputs message.
+ * @param str the message string to be output.
+ */
+ public CapabilityNotSetException(String str){
+
+ super(str);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CgShaderProgram.java b/j3d-core/src/classes/share/javax/media/j3d/CgShaderProgram.java
new file mode 100644
index 0000000..ebeda56
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CgShaderProgram.java
@@ -0,0 +1,192 @@
+/*
+ * $RCSfile: CgShaderProgram.java,v $
+ *
+ * Copyright 2004-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The CgShaderProgram object is a concrete implementation of a
+ * ShaderProgram node component for NVIDIA's Cg shader language.
+ *
+ * @see SourceCodeShader
+ *
+ * @since Java 3D 1.4
+ */
+
+public class CgShaderProgram extends ShaderProgram {
+
+ /**
+ * Constructs a Cg shader program node component.
+ *
+ *
+ * TODO: ADD MORE DOCUMENTATION HERE.
+ */
+ public CgShaderProgram() {
+ }
+
+ // Implement abstract setVertexAttrNames method (inherit javadoc from parent class)
+ public void setVertexAttrNames(String[] vertexAttrNames) {
+ checkForLiveOrCompiled();
+
+ if (vertexAttrNames != null) {
+ for (int i = 0; i < vertexAttrNames.length; i++) {
+ if (vertexAttrNames[i] == null) {
+ throw new NullPointerException();
+ }
+ }
+ }
+
+ ((CgShaderProgramRetained)this.retained).setVertexAttrNames(vertexAttrNames);
+ }
+
+ // Implement abstract getVertexAttrNames method (inherit javadoc from parent class)
+ public String[] getVertexAttrNames() {
+
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_NAMES_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("CgShaderProgram0"));
+ }
+ }
+
+ return ((CgShaderProgramRetained)this.retained).getVertexAttrNames();
+ }
+
+ // Implement abstract setShaderAttrNames method (inherit javadoc from parent class)
+ public void setShaderAttrNames(String[] shaderAttrNames) {
+ checkForLiveOrCompiled();
+
+ if (shaderAttrNames != null) {
+ for (int i = 0; i < shaderAttrNames.length; i++) {
+ if (shaderAttrNames[i] == null) {
+ throw new NullPointerException();
+ }
+ }
+ }
+
+ ((CgShaderProgramRetained)this.retained).setShaderAttrNames(shaderAttrNames);
+ }
+
+ // Implement abstract getShaderAttrNames method (inherit javadoc from parent class)
+ public String[] getShaderAttrNames() {
+
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_NAMES_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("CgShaderProgram0"));
+ }
+ }
+
+ return ((CgShaderProgramRetained)this.retained).getShaderAttrNames();
+ }
+
+ /**
+ * Copies the specified array of shaders into this shader
+ * program. This method makes a shallow copy of the array. The
+ * array of shaders may be null or empty (0 length), but the
+ * elements of the array must be non-null. The shading language of
+ * each shader in the array must be
+ * SHADING_LANGUAGE_CG. Each shader in the array must
+ * be a SourceCodeShader. There must be no more than one vertex shader
+ * and one fragment shader in the array.
+ *
+ * @param shaders array of Shader objects to be copied into this
+ * ShaderProgram
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalArgumentException if the shading language of
+ * any shader in the shaders array is not
+ * SHADING_LANGUAGE_CG.
+ *
+ * @exception IllegalArgumentException if there are more than one
+ * vertex shader or more than one fragment shader in the shaders
+ * array.
+ *
+ * @exception ClassCastException if any shader in the shaders
+ * array is not a SourceCodeShader.
+ */
+ public void setShaders(Shader[] shaders) {
+ checkForLiveOrCompiled();
+
+ if (shaders != null) {
+ // Check shaders for valid shading language, class type, etc.
+ for (int i = 0; i < shaders.length; i++) {
+ boolean hasVertexShader = false;
+ boolean hasFragmentShader = false;
+
+ // Check shading language
+ if (shaders[i].getShadingLanguage() != Shader.SHADING_LANGUAGE_CG) {
+ throw new IllegalArgumentException(J3dI18N.getString("CgShaderProgram2"));
+ }
+
+ // Check for more than one vertex shader or fragment shader
+ if (shaders[i].getShaderType() == Shader.SHADER_TYPE_VERTEX) {
+ if (hasVertexShader) {
+ throw new IllegalArgumentException(J3dI18N.getString("CgShaderProgram3"));
+ }
+ hasVertexShader = true;
+ }
+ else { // Shader.SHADER_TYPE_FRAGMENT
+ if (hasFragmentShader) {
+ throw new IllegalArgumentException(J3dI18N.getString("CgShaderProgram4"));
+ }
+ hasFragmentShader = true;
+ }
+
+ // Try to cast shader to SourceCodeShader; it will throw
+ // ClassCastException if it isn't.
+ SourceCodeShader shad = (SourceCodeShader)shaders[i];
+ }
+ }
+
+ ((CgShaderProgramRetained)this.retained).setShaders(shaders);
+ }
+
+ // Implement abstract getShaders method (inherit javadoc from parent class)
+ public Shader[] getShaders() {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_SHADERS_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("CgShaderProgram1"));
+ }
+ }
+
+ return ((CgShaderProgramRetained)this.retained).getShaders();
+ }
+
+ /**
+ * Creates a retained mode CgShaderProgramRetained object that this
+ * CgShaderProgram component object will point to.
+ */
+ void createRetained() {
+ this.retained = new CgShaderProgramRetained();
+ this.retained.setSource(this);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CgShaderProgramRetained.java b/j3d-core/src/classes/share/javax/media/j3d/CgShaderProgramRetained.java
new file mode 100644
index 0000000..8f7cd73
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CgShaderProgramRetained.java
@@ -0,0 +1,404 @@
+/*
+ * $RCSfile: CgShaderProgramRetained.java,v $
+ *
+ * Copyright 2005-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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The CgShaderProgram object is a concrete implementation of a
+ * ShaderProgram node component for NVIDIA's Cg shader language.
+ */
+
+class CgShaderProgramRetained extends ShaderProgramRetained {
+
+ /**
+ * Constructs a Cg shader program node component.
+ */
+ CgShaderProgramRetained() {
+ }
+
+ synchronized void createMirrorObject() {
+ // System.err.println("CgShaderProgramRetained : createMirrorObject");
+ // This method should only call by setLive().
+ if (mirror == null) {
+ CgShaderProgramRetained mirrorCgSP = new CgShaderProgramRetained();
+ mirror = mirrorCgSP;
+ }
+ initMirrorObject();
+ }
+
+ // ShaderAttributeValue methods
+
+ ShaderError setUniform1i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int value) {
+
+ return Pipeline.getPipeline().setCgUniform1i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform1f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float value) {
+
+ return Pipeline.getPipeline().setCgUniform1f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform2i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int[] value) {
+
+ return Pipeline.getPipeline().setCgUniform2i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform2f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniform2f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform3i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int[] value) {
+
+ return Pipeline.getPipeline().setCgUniform3i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform3f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniform3f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform4i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int[] value) {
+
+ return Pipeline.getPipeline().setCgUniform4i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform4f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniform4f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniformMatrix3f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniformMatrix3f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniformMatrix4f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniformMatrix4f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ // ShaderAttributeArray methods
+
+ ShaderError setUniform1iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setCgUniform1iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform1fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniform1fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform2iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setCgUniform2iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform2fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniform2fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform3iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setCgUniform3iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform3fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniform3fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform4iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setCgUniform4iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform4fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniform4fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniformMatrix3fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniformMatrix3fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniformMatrix4fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setCgUniformMatrix4fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+
+ /**
+ * Method to return a flag indicating whether this
+ * ShaderProgram is supported on the specified Canvas.
+ */
+ boolean isSupported(Canvas3D cv) {
+ return cv.shadingLanguageCg;
+ }
+
+ /**
+ * Method to create the native shader.
+ */
+ ShaderError createShader(Context ctx, ShaderRetained shader, ShaderId[] shaderIdArr) {
+ return Pipeline.getPipeline().createCgShader(ctx, shader.shaderType, shaderIdArr);
+ }
+
+ /**
+ * Method to destroy the native shader.
+ */
+ ShaderError destroyShader(Context ctx, ShaderId shaderId) {
+ return Pipeline.getPipeline().destroyCgShader(ctx, shaderId);
+ }
+
+ /**
+ * Method to compile the native shader.
+ */
+ ShaderError compileShader(Context ctx, ShaderId shaderId, String source) {
+ return Pipeline.getPipeline().compileCgShader(ctx, shaderId, source );
+ }
+
+ /**
+ * Method to create the native shader program.
+ */
+ ShaderError createShaderProgram(Context ctx, ShaderProgramId[] shaderProgramIdArr) {
+ return Pipeline.getPipeline().createCgShaderProgram(ctx, shaderProgramIdArr);
+ }
+
+ /**
+ * Method to destroy the native shader program.
+ */
+ ShaderError destroyShaderProgram(Context ctx, ShaderProgramId shaderProgramId) {
+ return Pipeline.getPipeline().destroyCgShaderProgram(ctx, shaderProgramId);
+ }
+
+ /**
+ * Method to link the native shader program.
+ */
+ ShaderError linkShaderProgram(Context ctx, ShaderProgramId shaderProgramId, ShaderId[] shaderIds) {
+ return Pipeline.getPipeline().linkCgShaderProgram(ctx, shaderProgramId, shaderIds);
+ }
+
+ ShaderError bindVertexAttrName(Context ctx, ShaderProgramId shaderProgramId, String attrName, int attrIndex) {
+ // This is a no-op for Cg
+ return null;
+ }
+
+ void lookupVertexAttrNames(Context ctx, ShaderProgramId shaderProgramId, String[] attrNames, boolean[] errArr) {
+ Pipeline.getPipeline().lookupCgVertexAttrNames(ctx, shaderProgramId, attrNames.length, attrNames, errArr);
+ }
+
+ void lookupShaderAttrNames(Context ctx, ShaderProgramId shaderProgramId,
+ String[] attrNames, AttrNameInfo[] attrNameInfoArr) {
+
+ int numAttrNames = attrNames.length;
+
+ ShaderAttrLoc[] locArr = new ShaderAttrLoc[numAttrNames];
+ int[] typeArr = new int[numAttrNames];
+ int[] sizeArr = new int[numAttrNames]; // currently unused
+ boolean[] isArrayArr = new boolean[numAttrNames];
+
+ Pipeline.getPipeline().lookupCgShaderAttrNames(ctx, shaderProgramId,
+ numAttrNames, attrNames, locArr, typeArr, sizeArr, isArrayArr);
+
+ for (int i = 0; i < numAttrNames; i++) {
+ attrNameInfoArr[i] = new AttrNameInfo();
+ attrNameInfoArr[i].setLocation(locArr[i]);
+ attrNameInfoArr[i].setArray(isArrayArr[i]);
+ attrNameInfoArr[i].setType(typeArr[i]);
+ /*
+ System.err.println(attrNames[i] +
+ " : loc = " + locArr[i] +
+ ", type = " + typeArr[i] +
+ ", isArray = " + isArrayArr[i] +
+ ", size = " + sizeArr[i]);
+ */
+ }
+ }
+
+ /**
+ * Method to enable the native shader program.
+ */
+ ShaderError enableShaderProgram(Context ctx, ShaderProgramId shaderProgramId) {
+ return Pipeline.getPipeline().useCgShaderProgram(ctx, shaderProgramId);
+ }
+
+ /**
+ * Method to disable the native shader program.
+ */
+ ShaderError disableShaderProgram(Context ctx) {
+ return Pipeline.getPipeline().useCgShaderProgram(ctx, null);
+ }
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Clip.java b/j3d-core/src/classes/share/javax/media/j3d/Clip.java
new file mode 100644
index 0000000..0d70595
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Clip.java
@@ -0,0 +1,314 @@
+/*
+ * $RCSfile: Clip.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+/**
+ * The Clip leaf node defines the back, or far, clip distance in
+ * the virtual universe.
+ * The distance is specified in the local coordinate system of this node.
+ * This node also specifies an application
+ * region in which this clip node is active.
+ * A Clip node is active when its application region intersects
+ * the ViewPlatform's activation volume. If multiple Clip nodes
+ * are active, the Clip node that is "closest" to the eye will be
+ * used.
+ * If no clip node is in scope of the view platform
+ * associated with the current view, then the back clip distance is
+ * defined by the View object.
+ * The front clip distance is always defined by the
+ * View object.
+ *
+ * @see View
+ */
+public class Clip extends Leaf {
+
+ /**
+ * Specifies that the Clip allows read access to its application
+ * bounds and bounding leaf at runtime.
+ */
+ public static final int
+ ALLOW_APPLICATION_BOUNDS_READ = CapabilityBits.CLIP_ALLOW_APPLICATION_BOUNDS_READ;
+
+ /**
+ * Specifies that the Clip allows write access to its application
+ * bounds and bounding leaf at runtime.
+ */
+ public static final int
+ ALLOW_APPLICATION_BOUNDS_WRITE = CapabilityBits.CLIP_ALLOW_APPLICATION_BOUNDS_WRITE;
+
+ /**
+ * Specifies that the Clip allows read access to its back distance
+ * at runtime.
+ */
+ public static final int
+ ALLOW_BACK_DISTANCE_READ = CapabilityBits.CLIP_ALLOW_BACK_DISTANCE_READ;
+
+ /**
+ * Specifies that the Clip allows write access to its back distance
+ * at runtime.
+ */
+ public static final int
+ ALLOW_BACK_DISTANCE_WRITE = CapabilityBits.CLIP_ALLOW_BACK_DISTANCE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_APPLICATION_BOUNDS_READ,
+ ALLOW_BACK_DISTANCE_READ
+ };
+
+ /**
+ * Constructs a Clip node with default parameters. The default
+ * values are as follows:
+ *
+ * back clip distance : 100 meters
+ */
+ public Clip () {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a Clip node with the specified back clip distance.
+ */
+ public Clip(double backDistance) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ClipRetained)this.retained).initBackDistance(backDistance);
+ }
+
+ /**
+ * Sets the back clip distance to the specified value.
+ * There are several considerations that need to be taken into
+ * account when choosing values for the front and back clip
+ * distances. These are enumerated in the description of
+ *
+ * View.setFrontClipDistance.
+ * @param backDistance the new back clip distance in meters
+ * @see View#setFrontClipDistance
+ * @see View#setBackClipDistance
+ */
+ public void setBackDistance(double backDistance) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_BACK_DISTANCE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Clip0"));
+
+ if (isLive())
+ ((ClipRetained)this.retained).setBackDistance(backDistance);
+ else
+ ((ClipRetained)this.retained).initBackDistance(backDistance);
+ }
+
+ /**
+ * Retrieves the back clip distance.
+ * @return the current back clip distance, in meters
+ */
+ public double getBackDistance() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_BACK_DISTANCE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Clip1"));
+ return ((ClipRetained)this.retained).getBackDistance();
+ }
+
+ /**
+ * Set the Clip's application region to the specified bounds.
+ * This is used when the application bounding leaf is set to null.
+ * @param region the bounds that contains the Clip's new application
+ * region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setApplicationBounds(Bounds region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Clip2"));
+
+ if (isLive())
+ ((ClipRetained)this.retained).setApplicationBounds(region);
+ else
+ ((ClipRetained)this.retained).initApplicationBounds(region);
+ }
+
+ /**
+ * Retrieves the Clip node's application bounds.
+ * @return this Clip's application bounds information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getApplicationBounds() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Clip3"));
+
+ return ((ClipRetained)this.retained).getApplicationBounds();
+ }
+
+ /**
+ * Set the Clip's application region to the specified bounding leaf.
+ * When set to a value other than null, this overrides the application
+ * bounds object.
+ * @param region the bounding leaf node used to specify the Clip
+ * node's new application region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setApplicationBoundingLeaf(BoundingLeaf region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Clip2"));
+
+ if (isLive())
+ ((ClipRetained)this.retained).setApplicationBoundingLeaf(region);
+ else
+ ((ClipRetained)this.retained).initApplicationBoundingLeaf(region);
+ }
+
+ /**
+ * Retrieves the Clip node's application bounding leaf.
+ * @return this Clip's application bounding leaf information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public BoundingLeaf getApplicationBoundingLeaf() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPLICATION_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Clip3"));
+
+ return ((ClipRetained)this.retained).getApplicationBoundingLeaf();
+ }
+
+ /**
+ * Creates the retained mode ClipRetained object that this
+ * Clip component object will point to.
+ */
+ void createRetained() {
+ this.retained = new ClipRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ * application bounding leaf : null
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ Clip c = new Clip();
+ c.duplicateNode(this, forceDuplicate);
+ return c;
+ }
+
+ /**
+ * Callback used to allow a node to check if any scene graph objects
+ * referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any object references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding object in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * object is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+ ClipRetained rt = (ClipRetained) retained;
+ BoundingLeaf bl = rt.getApplicationBoundingLeaf();
+
+ // check for applicationBoundingLeaf
+ if (bl != null) {
+ Object o = referenceTable.getNewObjectReference(bl);
+ rt.initApplicationBoundingLeaf((BoundingLeaf) o);
+ }
+ }
+
+
+ /**
+ * Copies all Clip information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ ClipRetained attr = (ClipRetained) originalNode.retained;
+ ClipRetained rt = (ClipRetained) retained;
+
+ rt.initBackDistance(attr.getBackDistance());
+ rt.initApplicationBounds(attr.getApplicationBounds());
+
+ // correct value will set in updateNodeReferences
+ rt.initApplicationBoundingLeaf(attr.getApplicationBoundingLeaf());
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ClipRetained.java b/j3d-core/src/classes/share/javax/media/j3d/ClipRetained.java
new file mode 100644
index 0000000..85ca707
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ClipRetained.java
@@ -0,0 +1,403 @@
+/*
+ * $RCSfile: ClipRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+
+/**
+ * The Clip leaf node defines the back, or far, clipping distance in
+ * the virtual universe. The front clipping plane is defined in the
+ * View object. If no clip node is in scope of the view platform
+ * associated with the current view, then the back clipping plane is
+ * also defined by the View.
+ * @see View
+ */
+class ClipRetained extends LeafRetained {
+
+ static final int BOUNDS_CHANGED = 0x00001;
+ static final int BOUNDINGLEAF_CHANGED = 0x00002;
+ static final int BACKDISTANCE_CHANGED = 0x00004;
+
+ /**
+ * Clip's back distance
+ */
+ double backDistance = 100.0;
+
+ /**
+ * back distance scaled to vworld
+ */
+ double backDistanceInVworld;
+
+ /**
+ * The Boundary object defining the application region.
+ */
+ Bounds applicationRegion = null;
+
+ /**
+ * The bounding leaf reference
+ */
+ BoundingLeafRetained boundingLeaf = null;
+
+ /**
+ * The transformed value of the applicationRegion.
+ */
+ Bounds transformedRegion = null;
+
+ // This is true when this object is referenced in an immediate mode context
+ boolean inImmCtx = false;
+
+
+ // Target threads to be notified when light changes
+ // Note, the rendering env structure only get notified
+ // when there is a bounds related change
+ static final int targetThreads = J3dThread.UPDATE_RENDER |
+ J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+
+
+ // Is true, if the clip is viewScoped
+ boolean isViewScoped = false;
+
+ /**
+ * Constructs a Clip node with a default color (black).
+ */
+ ClipRetained () {
+ this.nodeType = NodeRetained.CLIP;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ /**
+ * initializes the clip's back distance to the specified value.
+ * @param backDistance the new back clipping distance
+ */
+ final void initBackDistance(double backDistance) {
+ this.backDistance = backDistance;
+ }
+
+
+ /**
+ * Sets the clip's back distance to the specified value.
+ * @param backDistance the new back clipping distance
+ */
+ final void setBackDistance(double backDistance) {
+ this.backDistance = backDistance;
+ sendMessage(BACKDISTANCE_CHANGED, new Double(backDistance), null);
+ }
+
+ /**
+ * Retrieves the clip's back distance.
+ * @return the current back clipping distance
+ */
+ final double getBackDistance() {
+ return backDistance;
+ }
+
+
+ /**
+ * Initializes the Clip's application region.
+ * @param region a region that contains the Backgound's new application bounds
+ */
+ final void initApplicationBounds(Bounds region) {
+ if (region != null) {
+ applicationRegion = (Bounds) region.clone();
+ } else {
+ applicationRegion = null;
+ }
+ }
+
+ /**
+ * Set the Clip's application region.
+ * @param region a region that contains the Clip's new application bounds
+ */
+ final void setApplicationBounds(Bounds region) {
+ initApplicationBounds(region);
+ // Don't send the message if there is a valid boundingleaf
+ if (boundingLeaf == null) {
+ sendMessage(BOUNDS_CHANGED,
+ (region != null ? region.clone(): null), null);
+ }
+ }
+
+ /**
+ * Get the Backgound's application region.
+ * @return this Clip's application bounds information
+ */
+ final Bounds getApplicationBounds() {
+ return (applicationRegion != null ?
+ (Bounds) applicationRegion.clone() : null);
+ }
+
+ /**
+ * Initializes the Clip's application region
+ * to the specified Leaf node.
+ */
+ void initApplicationBoundingLeaf(BoundingLeaf region) {
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ } else {
+ boundingLeaf = null;
+ }
+ }
+
+ /**
+ * Set the Clip's application region to the specified Leaf node.
+ */
+ void setApplicationBoundingLeaf(BoundingLeaf region) {
+ if (boundingLeaf != null)
+ boundingLeaf.mirrorBoundingLeaf.removeUser(this);
+
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ boundingLeaf.mirrorBoundingLeaf.addUser(this);
+ } else {
+ boundingLeaf = null;
+ }
+ sendMessage(BOUNDINGLEAF_CHANGED,
+ (boundingLeaf != null ?
+ boundingLeaf.mirrorBoundingLeaf : null),
+ (applicationRegion != null ? applicationRegion.clone() : null));
+ }
+
+ /**
+ * Get the Clip's application region
+ */
+ BoundingLeaf getApplicationBoundingLeaf() {
+ return (boundingLeaf != null ?
+ (BoundingLeaf)boundingLeaf.source : null);
+ }
+
+ /**
+ * This sets the immedate mode context flag
+ */
+ void setInImmCtx(boolean inCtx) {
+ inImmCtx = inCtx;
+ }
+
+ /**
+ * This gets the immedate mode context flag
+ */
+ boolean getInImmCtx() {
+ return inImmCtx;
+ }
+
+ /**
+ * This setLive routine first calls the superclass's method, then
+ * it adds itself to the list of lights
+ */
+ void setLive(SetLiveState s) {
+ if (inImmCtx) {
+ throw new IllegalSharingException(J3dI18N.getString("ClipRetained0"));
+ }
+
+ super.doSetLive(s);
+
+ if (inBackgroundGroup) {
+ throw new
+ IllegalSceneGraphException(J3dI18N.getString("ClipRetained1"));
+ }
+
+ if (inSharedGroup) {
+ throw new
+ IllegalSharingException(J3dI18N.getString("ClipRetained2"));
+ }
+
+
+ initMirrorObject();
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(this);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(this);
+ }
+ // process switch leaf
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(this, Targets.ENV_TARGETS);
+ }
+ switchState = (SwitchState)s.switchStates.get(0);
+
+ // add this node to the transform target
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(this, Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+
+ super.markAsLive();
+ }
+
+ /**
+ * This clearLive routine first calls the superclass's method, then
+ * it removes itself to the list of lights
+ */
+ void clearLive(SetLiveState s) {
+ super.clearLive(s);
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(this);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(this);
+ }
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(this, Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+
+
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(this, Targets.ENV_TARGETS);
+ }
+ }
+
+ void initMirrorObject() {
+ Transform3D lastLocalToVworld = getLastLocalToVworld();
+
+ if (boundingLeaf != null) {
+ transformedRegion = (Bounds)boundingLeaf.mirrorBoundingLeaf.transformedRegion;
+ }
+ else { // Evaluate applicationRegion if not null
+ if (applicationRegion != null) {
+ transformedRegion = (Bounds)applicationRegion.clone();
+ transformedRegion.transform(applicationRegion, lastLocalToVworld);
+ }
+ else {
+ transformedRegion = null;
+ }
+
+ }
+ backDistanceInVworld = backDistance *
+ lastLocalToVworld.getDistanceScale();
+ }
+
+
+ // The update Object function.
+ void updateImmediateMirrorObject(Object[] objs) {
+ int component = ((Integer)objs[1]).intValue();
+ Transform3D trans;
+ Transform3D currentLocalToVworld = getCurrentLocalToVworld();
+
+ // Bounds message only sent when boundingleaf is null
+ if ((component & BOUNDS_CHANGED) != 0) {
+ if (objs[2] != null) {
+ transformedRegion = ((Bounds) objs[2]).copy(transformedRegion);
+ transformedRegion.transform(transformedRegion,
+ currentLocalToVworld);
+ }
+ else {
+ transformedRegion = null;
+ }
+ }
+ else if ((component & BOUNDINGLEAF_CHANGED) != 0) {
+ if (objs[2] != null) {
+ transformedRegion = ((BoundingLeafRetained)objs[2]).transformedRegion;
+ }
+ else { // Evaluate applicationRegion if not null
+ Bounds appRegion = (Bounds)objs[3];
+ if (appRegion != null) {
+ transformedRegion = ((Bounds)appRegion).copy(transformedRegion);
+ transformedRegion.transform(appRegion,
+ currentLocalToVworld);
+ }
+ else {
+ transformedRegion = null;
+ }
+
+ }
+
+ }
+ else if ((component & BACKDISTANCE_CHANGED) != 0) {
+ backDistanceInVworld = ((Double)objs[2]).doubleValue() *
+ currentLocalToVworld.getDistanceScale();
+ }
+ }
+
+ /** Note: This routine will only be called on
+ * the mirror object - will update the object's
+ * cached region and transformed region
+ */
+
+ void updateBoundingLeaf() {
+ if (boundingLeaf != null &&
+ boundingLeaf.mirrorBoundingLeaf.switchState.currentSwitchOn) {
+ transformedRegion =
+ boundingLeaf.mirrorBoundingLeaf.transformedRegion;
+ } else { // Evaluate applicationRegion if not null
+ if (applicationRegion != null) {
+ transformedRegion = applicationRegion.copy(transformedRegion);
+ transformedRegion.transform(applicationRegion,
+ getCurrentLocalToVworld());
+ } else {
+ transformedRegion = null;
+ }
+ }
+ }
+
+ void updateImmediateTransformChange() {
+ // If bounding leaf is null, tranform the bounds object
+ if (boundingLeaf == null) {
+ if (applicationRegion != null) {
+ transformedRegion = (Bounds)applicationRegion.clone();
+ transformedRegion.transform(applicationRegion,
+ getCurrentLocalToVworld());
+ }
+ }
+ }
+
+ final void sendMessage(int attrMask, Object attr, Object attr2) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.type = J3dMessage.CLIP_CHANGED;
+ createMessage.universe = universe;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr;
+ createMessage.args[3] = attr2;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+ void mergeTransform(TransformGroupRetained xform) {
+ super.mergeTransform(xform);
+ if (applicationRegion != null) {
+ applicationRegion.transform(xform.transform);
+ }
+ }
+ void getMirrorObjects(ArrayList leafList, HashKey key) {
+ leafList.add(this);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ColorInterpolator.java b/j3d-core/src/classes/share/javax/media/j3d/ColorInterpolator.java
new file mode 100644
index 0000000..03d0863
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ColorInterpolator.java
@@ -0,0 +1,315 @@
+/*
+ * $RCSfile: ColorInterpolator.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+import java.util.Enumeration;
+
+/**
+ * Color interpolation behavior. This class defines a behavior that
+ * modifies the ambient, emissive, diffuse, or specular color of its
+ * target material object by linearly interpolating between a pair of
+ * specified colors, using the value generated by the specified Alpha
+ * object.
+ * The behavior modifies the color specified by the
+ * Material's colorTarget attribute, one of: AMBIENT, EMISSIVE,
+ * DIFFUSE, SPECULAR, or AMBIENT_AND_DIFFUSE.
+ * The ALLOW_COMPONENT_READ bit must be set in the Material object in
+ * order for the Material's colorTarget to be read.
+ * If the Material object's ALLOW_COMPONENT_READ bit is not set, the
+ * diffuse component will be modified.
+ *
+ * @see Material
+ */
+
+public class ColorInterpolator extends Interpolator {
+
+ Material target;
+ Color3f startColor = new Color3f();
+ Color3f endColor = new Color3f();
+ Color3f newColor = new Color3f();
+
+ // We can't use a boolean flag since it is possible
+ // that after alpha change, this procedure only run
+ // once at alpha.finish(). So the best way is to
+ // detect alpha value change.
+ private float prevAlphaValue = Float.NaN;
+ private int prevColorTarget = -1;
+ private WakeupCriterion passiveWakeupCriterion =
+ (WakeupCriterion) new WakeupOnElapsedFrames(0, true);
+
+ // non-public, no parameter constructor used by cloneNode
+ ColorInterpolator() {
+ }
+
+ /**
+ * Constructs a trivial color interpolator with a specified target,
+ * a starting color of black, and an ending color of white.
+ * @param alpha the alpha object for this interpolator
+ * @param target the material component object whose
+ * color is affected by this color interpolator
+ */
+ public ColorInterpolator(Alpha alpha,
+ Material target) {
+
+ super(alpha);
+
+ this.target = target;
+ this.startColor.set(0.0f, 0.0f, 0.0f);
+ this.endColor.set(1.0f, 1.0f, 1.0f);
+ }
+
+ /**
+ * Constructs a color interpolator with the specified target,
+ * starting color, and ending color.
+ * @param alpha the alpha object for this interpolator
+ * @param target the material component object whose
+ * color is affected by this color interpolator
+ * @param startColor the starting color
+ * @param endColor the ending color
+ */
+ public ColorInterpolator(Alpha alpha,
+ Material target,
+ Color3f startColor,
+ Color3f endColor) {
+
+ super(alpha);
+
+ this.target = target;
+ this.startColor.set(startColor);
+ this.endColor.set(endColor);
+ }
+
+ /**
+ * This method sets the startColor for this interpolator.
+ * @param color the new start color
+ */
+ public void setStartColor(Color3f color) {
+ startColor.set(color);
+ prevAlphaValue = Float.NaN;
+ }
+
+ /**
+ * This method retrieves this interpolator's startColor.
+ * @param color the vector that will receive the interpolator's start color
+ */
+ public void getStartColor(Color3f color) {
+ color.set(startColor);
+ }
+
+ /**
+ * This method sets the endColor for this interpolator.
+ * @param color the new end color
+ */
+ public void setEndColor(Color3f color) {
+ endColor.set(color);
+ prevAlphaValue = Float.NaN;
+ }
+
+ /**
+ * This method retrieves this interpolator's endColor.
+ * @param color the vector that will receive the interpolator's end color
+ */
+ public void getEndColor(Color3f color) {
+ color.set(endColor);
+ }
+
+ /**
+ * This method sets the target material component object for
+ * this interpolator.
+ * @param target the material component object whose
+ * color is affected by this color interpolator
+ */
+ public void setTarget(Material target) {
+ this.target = target;
+ prevAlphaValue = Float.NaN;
+ }
+
+ /**
+ * This method retrieves this interpolator's target material
+ * component object.
+ * @return the interpolator's target material component object
+ */
+ public Material getTarget() {
+ return target;
+ }
+
+ // The ColorInterpolator's initialize routine uses the default
+ // initialization routine.
+
+ /**
+ * This method is invoked by the behavior scheduler every frame.
+ * It maps the alpha value that corresponds to the current time
+ * into a color value and updates the ambient, emissive, diffuse,
+ * or specular color (or both the ambient and diffuse color) of
+ * the specified target Material object with this new color value.
+ *
+ * @param criteria an enumeration of the criteria that caused the
+ * stimulus
+ */
+ public void processStimulus(Enumeration criteria) {
+
+ // Handle stimulus
+ WakeupCriterion criterion = passiveWakeupCriterion;
+
+ if (alpha != null) {
+ float value = alpha.value();
+
+ int colorTarget = Material.DIFFUSE;
+ if (target.getCapability(Material.ALLOW_COMPONENT_READ))
+ colorTarget = target.getColorTarget();
+
+ if (value != prevAlphaValue || colorTarget != prevColorTarget) {
+ newColor.x = (1.0f-value)*startColor.x + value*endColor.x;
+ newColor.y = (1.0f-value)*startColor.y + value*endColor.y;
+ newColor.z = (1.0f-value)*startColor.z + value*endColor.z;
+
+ switch (colorTarget) {
+ case Material.AMBIENT:
+ target.setAmbientColor(newColor);
+ break;
+ case Material.AMBIENT_AND_DIFFUSE:
+ target.setAmbientColor(newColor);
+ // fall through
+ case Material.DIFFUSE:
+ target.setDiffuseColor(newColor);
+ break;
+ case Material.EMISSIVE:
+ target.setEmissiveColor(newColor);
+ break;
+ case Material.SPECULAR:
+ target.setSpecularColor(newColor);
+ break;
+ }
+
+ prevAlphaValue = value;
+ prevColorTarget = colorTarget;
+ }
+
+ if (!alpha.finished() && !alpha.isPaused()) {
+ criterion = defaultWakeupCriterion;
+ }
+ }
+ wakeupOn(criterion);
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ ColorInterpolator ci = new ColorInterpolator();
+ ci.duplicateNode(this, forceDuplicate);
+ return ci;
+ }
+
+
+ /**
+ * Copies all ColorInterpolator information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ ColorInterpolator ci = (ColorInterpolator) originalNode;
+
+ ci.getStartColor(startColor);
+ ci.getEndColor(endColor);
+
+ // this reference will be updated in updateNodeReferences()
+ setTarget(ci.getTarget());
+ }
+
+ /**
+ * Callback used to allow a node to check if any scene graph objects
+ * referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any object references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding object in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * object is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+ super.updateNodeReferences(referenceTable);
+
+ // check Material
+ NodeComponent nc = getTarget();
+
+ if (nc != null) {
+ setTarget((Material) referenceTable.getNewObjectReference(nc));
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ColoringAttributes.java b/j3d-core/src/classes/share/javax/media/j3d/ColoringAttributes.java
new file mode 100644
index 0000000..769129f
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ColoringAttributes.java
@@ -0,0 +1,371 @@
+/*
+ * $RCSfile: ColoringAttributes.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+
+/**
+ * The ColoringAttributes object defines attributes used in
+ * color selection and shading model.
+ *
+ * setColor methods set the current intrinsic red, green, and
+ * blue color values of this ColoringAttributes component object.
+ * This color is only used for unlit geometry. If lighting is enabled,
+ * the material colors are used in the lighting equation to produce
+ * the final color. When vertex colors are present in unlit
+ * geometry, those vertex colors are used in place of this
+ * ColoringAttributes color, unless the vertex colors are ignored.
+ * setColor methods, one
+ * that takes a Color3f and one that takes three floats. No alpha
+ * value is allowed (it's automatically set to 1.0). The float values
+ * range between 0.0 and 1.0, with 1.0 being full intensity of the
+ * color. A color value of (1.0, 1.0, 1.0) is white.
+ * setShadeModel method sets the shade model for this
+ * ColoringAttributes component object. The shade model may be one of
+ * the following:
+ *
+ *
+ * @see Appearance
+ */
+public class ColoringAttributes extends NodeComponent {
+ /**
+ * Specifies that this ColoringAttributes object allows
+ * reading its color component information.
+ */
+ public static final int
+ ALLOW_COLOR_READ = CapabilityBits.COLORING_ATTRIBUTES_ALLOW_COLOR_READ;
+
+ /**
+ * Specifies that this ColoringAttributes object allows
+ * writing its color component information.
+ */
+ public static final int
+ ALLOW_COLOR_WRITE = CapabilityBits.COLORING_ATTRIBUTES_ALLOW_COLOR_WRITE;
+
+ /**
+ * Specifies that this ColoringAttributes object allows
+ * reading its shade model component information.
+ */
+ public static final int
+ ALLOW_SHADE_MODEL_READ = CapabilityBits.COLORING_ATTRIBUTES_ALLOW_SHADE_MODEL_READ;
+
+ /**
+ * Specifies that this ColoringAttributes object allows
+ * writing its shade model component information.
+ */
+ public static final int
+ ALLOW_SHADE_MODEL_WRITE = CapabilityBits.COLORING_ATTRIBUTES_ALLOW_SHADE_MODEL_WRITE;
+
+ /**
+ * Use the fastest available method for shading.
+ */
+ public static final int FASTEST = 0;
+ /**
+ * Use the nicest available method for shading.
+ */
+ public static final int NICEST = 1;
+
+ /**
+ * Do not interpolate color across the primitive.
+ */
+ public static final int SHADE_FLAT = 2;
+ /**
+ * Smoothly interpolate the color at each vertex across the primitive.
+ */
+ public static final int SHADE_GOURAUD = 3;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_COLOR_READ,
+ ALLOW_SHADE_MODEL_READ
+ };
+
+ /**
+ * Constructs a ColoringAttributes node with default parameters.
+ * The default values are as follows:
+ *
+ * color = white (1,1,1)
+ */
+ public ColoringAttributes() {
+ // Just use default attributes
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Construct ColoringAttributes object with specified values.
+ * @param color the intrisic color
+ * @param shadeModel the shade model used; one of FASTEST, NICEST,
+ * SHADE_FLAT, or SHADE_GOURAUD
+ */
+ public ColoringAttributes(Color3f color, int shadeModel) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ColoringAttributesRetained)this.retained).initColor(color);
+ ((ColoringAttributesRetained)this.retained).initShadeModel(shadeModel);
+
+ }
+
+ /**
+ * Construct ColoringAttributes object with specified values.
+ * @param red red component of the intrisic color
+ * @param green green component of the intrisic color
+ * @param blue blue component of the intrisic color
+ * @param shadeModel the shade model used; one of FASTEST, NICEST,
+ * SHADE_FLAT, or SHADE_GOURAUD
+ */
+ public ColoringAttributes(float red, float green, float blue,
+ int shadeModel) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ColoringAttributesRetained)this.retained).initColor(red, green,blue);
+ ((ColoringAttributesRetained)this.retained).initShadeModel(shadeModel);
+ }
+
+ /**
+ * Sets the intrinsic color of this ColoringAttributes
+ * component object. This color is only used for unlit geometry;
+ * if lighting is enabled, then the material colors are used in the
+ * lighting equation to produce the final color.
+ * When vertex colors are present in unlit geometry, those
+ * vertex colors are used in place of this ColoringAttributes color
+ * unless the vertex colors are ignored.
+ * @param color the color that is used when lighting is disabled
+ * or when material is null
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @see Material
+ * @see RenderingAttributes#setIgnoreVertexColors
+ */
+ public void setColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ColoringAttributes0"));
+
+ if (isLive())
+ ((ColoringAttributesRetained)this.retained).setColor(color);
+ else
+ ((ColoringAttributesRetained)this.retained).initColor(color);
+
+ }
+
+ /**
+ * Sets the intrinsic color of this ColoringAttributes
+ * component object. This color is only used for unlit geometry;
+ * if lighting is enabled, then the material colors are used in the
+ * lighting equation to produce the final color.
+ * When vertex colors are present in unlit geometry, those
+ * vertex colors are used in place of this ColoringAttributes color
+ * unless the vertex colors are ignored.
+ * @param r the red component of the color
+ * @param g the green component of the color
+ * @param b the blue component of the color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @see Material
+ * @see RenderingAttributes#setIgnoreVertexColors
+ */
+ public void setColor(float r, float g, float b) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ColoringAttributes0"));
+
+ if (isLive())
+ ((ColoringAttributesRetained)this.retained).setColor(r, g, b);
+ else
+ ((ColoringAttributesRetained)this.retained).initColor(r, g, b);
+ }
+
+ /**
+ * Gets the intrinsic color of this ColoringAttributes
+ * component object.
+ * @param color the vector that will receive color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ColoringAttributes2"));
+
+ ((ColoringAttributesRetained)this.retained).getColor(color);
+ }
+
+ /**
+ * Sets the shade mode for this ColoringAttributes component object.
+ * @param shadeModel the shade mode to be used; one of FASTEST,
+ * NICEST, SHADE_FLAT, or SHADE_GOURAUD
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setShadeModel(int shadeModel) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SHADE_MODEL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ColoringAttributes3"));
+
+ if (isLive())
+ ((ColoringAttributesRetained)this.retained).setShadeModel(shadeModel);
+ else
+ ((ColoringAttributesRetained)this.retained).initShadeModel(shadeModel);
+ }
+
+ /**
+ * Gets the shade mode for this ColoringAttributes component object.
+ * @return shadeModel the shade mode
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getShadeModel() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SHADE_MODEL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ColoringAttributes4"));
+
+ return ((ColoringAttributesRetained)this.retained).getShadeModel();
+ }
+
+ /**
+ * Creates a retained mode ColoringAttributesRetained object that this
+ * ColoringAttributes component object will point to.
+ */
+ void createRetained() {
+ this.retained = new ColoringAttributesRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+
+ public NodeComponent cloneNodeComponent() {
+ ColoringAttributes ca = new ColoringAttributes();
+ ca.duplicateNodeComponent(this);
+ return ca;
+ }
+
+
+ /**
+ * Copies all node information from
+ * shade model = SHADE_GOURAUD
+ * originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+
+ super.duplicateAttributes(originalNodeComponent,
+ forceDuplicate);
+
+ ColoringAttributesRetained attr =
+ (ColoringAttributesRetained) originalNodeComponent.retained;
+
+ ColoringAttributesRetained rt = (ColoringAttributesRetained) retained;
+ Color3f c = new Color3f();
+ attr.getColor(c);
+
+ rt.initColor(c);
+ rt.initShadeModel(attr.getShadeModel());
+ }
+
+ /**
+ * Returns a String representation of this ColoringAttributes object.
+ * If the scene graph is live only those values with their
+ * Capability read bit set will be displayed.
+ */
+ public String toString() {
+ StringBuffer str = new StringBuffer(getNamePrefix());
+ str.append("javax.media.j3d.ColoringAttributes: ");
+ String shadingModes[] = { "FASTEST", "NICEST", "SHADE_FLAT",
+ "SHADE_GOURAUD" };
+
+ try {
+ Color3f color=new Color3f();
+ getColor( color );
+ str.append( "Color="+color );
+ }
+ catch (CapabilityNotSetException e) {str.append("Color=N/A");}
+
+ try {
+ str.append( " ShadeModel="+shadingModes[getShadeModel()] );
+ }
+ catch (CapabilityNotSetException ex) {str.append("ShadeModel=N/A");}
+
+ return new String(str);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ColoringAttributesRetained.java b/j3d-core/src/classes/share/javax/media/j3d/ColoringAttributesRetained.java
new file mode 100644
index 0000000..5b496ae
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ColoringAttributesRetained.java
@@ -0,0 +1,264 @@
+/*
+ * $RCSfile: ColoringAttributesRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+import java.util.ArrayList;
+
+/**
+ * The ColoringAttributesRetained object defines attributes that apply to
+ * to coloring mapping.
+ */
+class ColoringAttributesRetained extends NodeComponentRetained {
+ // A list of pre-defined bits to indicate which component
+ // in this ColoringAttributes object changed.
+ static final int COLOR_CHANGED = 0x01;
+ static final int SHADE_MODEL_CHANGED = 0x02;
+
+ // Intrinsic color used when lighting is disabled or when
+ // material is null
+ Color3f color = new Color3f(1.0f, 1.0f, 1.0f);
+
+ // Shade model (flat, smooth)
+ int shadeModel = ColoringAttributes.SHADE_GOURAUD;
+
+ /**
+ * Sets the intrinsic color of this ColoringAttributes
+ * component object.
+ * @param color the color that is used when lighting is disabled
+ * or when material is null
+ */
+ final void initColor(Color3f color) {
+ this.color.set(color);
+ }
+
+ /**
+ * Sets the intrinsic color of this ColoringAttributes
+ * component object and sends a message notifying
+ * the interested structures of the change.
+ * @param color the color that is used when lighting is disabled
+ * or when material is null
+ */
+ final void setColor(Color3f color) {
+ initColor(color);
+ sendMessage(COLOR_CHANGED, new Color3f(color));
+ }
+
+ /**
+ * Sets the intrinsic color of this ColoringAttributes
+ * component object. This color is used when lighting is disabled
+ * or when material is null.
+ * @param r the red component of the color
+ * @param g the green component of the color
+ * @param b the blue component of the color
+ */
+ final void initColor(float r, float g, float b) {
+ this.color.set(r, g, b);
+ }
+
+ /**
+ * Sets the intrinsic color of this ColoringAttributes
+ * component object and sends a message notifying
+ * the interested structures of the change.
+ * This color is used when lighting is disabled
+ * or when material is null.
+ * @param r the red component of the color
+ * @param g the green component of the color
+ * @param b the blue component of the color
+ */
+ final void setColor(float r, float g, float b) {
+ initColor(r, g, b);
+ sendMessage(COLOR_CHANGED, new Color3f(r, g, b));
+ }
+
+ /**
+ * Gets the intrinsic color of this ColoringAttributes
+ * component object.
+ * @param color the vector that will receive color
+ */
+ final void getColor(Color3f color) {
+ color.set(this.color);
+ }
+
+ /**
+ * Sets the shade mode for this ColoringAttributes component object.
+ * @param shadeModel the shade mode to be used; one of FASTEST,
+ * NICEST, SHADE_FLAT, or SHADE_GOURAUD
+ */
+ final void initShadeModel(int shadeModel) {
+ this.shadeModel = shadeModel;
+ }
+
+ /**
+ * Sets the shade mode for this ColoringAttributes component object
+ * and sends a message notifying
+ * the interested structures of the change.
+ * @param shadeModel the shade mode to be used; one of FASTEST,
+ * NICEST, SHADE_FLAT, or SHADE_GOURAUD
+ */
+ final void setShadeModel(int shadeModel) {
+ initShadeModel(shadeModel);
+ sendMessage(SHADE_MODEL_CHANGED, new Integer(shadeModel));
+ }
+
+ /**
+ * Gets the shade mode for this ColoringAttributes component object.
+ * @return shadeModel the shade mode
+ */
+ final int getShadeModel() {
+ return shadeModel;
+ }
+
+
+ /**
+ * Creates and initializes a mirror object, point the mirror object
+ * to the retained object if the object is not editable
+ */
+ synchronized void createMirrorObject() {
+ if (mirror == null) {
+ // Check the capability bits and let the mirror object
+ // point to itself if is not editable
+ if (isStatic()) {
+ mirror = this;
+ } else {
+ ColoringAttributesRetained mirrorCa
+ = new ColoringAttributesRetained();
+ mirrorCa.source = source;
+ mirrorCa.set(this);
+ mirror = mirrorCa;
+ }
+ } else {
+ ((ColoringAttributesRetained) mirror).set(this);
+ }
+ }
+
+ void updateNative(Context ctx,
+ float dRed, float dGreen, float dBlue,
+ float alpha, boolean lEnable) {
+ Pipeline.getPipeline().updateColoringAttributes(ctx,
+ dRed, dBlue, dGreen, color.x, color.y,
+ color.z, alpha,
+ lEnable, shadeModel);
+ }
+
+ /**
+ * Creates a mirror object, point the mirror object to the retained
+ * object if the object is not editable
+ */
+ synchronized void initMirrorObject() {
+ ((ColoringAttributesRetained)mirror).set(this);
+ }
+
+ /** Update the "component" field of the mirror object with the
+ * given "value"
+ */
+ synchronized void updateMirrorObject(int component, Object value) {
+
+ ColoringAttributesRetained mirrorCa =
+ (ColoringAttributesRetained) mirror;
+
+ if ((component & COLOR_CHANGED) != 0) {
+ mirrorCa.color.set(((Color3f)value));
+ }
+ else if ((component & SHADE_MODEL_CHANGED) != 0) {
+ mirrorCa.shadeModel = ((Integer)value).intValue();
+ }
+ }
+
+ boolean equivalent(ColoringAttributesRetained cr) {
+ return ((cr != null) &&
+ color.equals(cr.color) &&
+ (shadeModel == cr.shadeModel));
+ }
+
+
+ // This functions clones the retained side only and is used
+ // internally
+ protected Object clone() {
+ ColoringAttributesRetained cr =
+ (ColoringAttributesRetained)super.clone();
+ cr.color = new Color3f(color);
+ // shadeModel is copied in super.clone()
+ return cr;
+ }
+
+ // This functions clones the retained side only and is used
+ // internally
+ protected void set(ColoringAttributesRetained cr) {
+ super.set(cr);
+ color.set(cr.color);
+ shadeModel = cr.shadeModel;
+ }
+
+ final void sendMessage(int attrMask, Object attr) {
+ ArrayList univList = new ArrayList();
+ ArrayList gaList = Shape3DRetained.getGeomAtomsList(mirror.users, univList);
+ // Send to rendering attribute structure, regardless of
+ // whether there are users or not (alternate appearance case ..)
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+ createMessage.type = J3dMessage.COLORINGATTRIBUTES_CHANGED;
+ createMessage.universe = null;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr;
+ createMessage.args[3] = new Integer(changedFrequent);
+ VirtualUniverse.mc.processMessage(createMessage);
+
+
+ // System.err.println("univList.size is " + univList.size());
+ for(int i=0; i
+ *
+ *
+ * @deprecated As of Java 3D version 1.4.
+ */
+public class CompressedGeometry extends Geometry {
+
+ CompressedGeometryHeader cgHeader ;
+
+ /**
+ * Specifies that this CompressedGeometry object allows reading its
+ * byte count information.
+ */
+ public static final int
+ ALLOW_COUNT_READ = CapabilityBits.COMPRESSED_GEOMETRY_ALLOW_COUNT_READ ;
+
+ /**
+ * Specifies that this CompressedGeometry object allows reading its
+ * header information.
+ */
+ public static final int
+ ALLOW_HEADER_READ = CapabilityBits.COMPRESSED_GEOMETRY_ALLOW_HEADER_READ ;
+
+ /**
+ * Specifies that this CompressedGeometry object allows reading its
+ * geometry data component information.
+ */
+ public static final int
+ ALLOW_GEOMETRY_READ =
+ CapabilityBits.COMPRESSED_GEOMETRY_ALLOW_GEOMETRY_READ ;
+
+ /**
+ * Specifies that this CompressedGeometry allows reading the geometry
+ * data reference information for this object. This is only used in
+ * by-reference geometry mode.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int
+ ALLOW_REF_DATA_READ =
+ CapabilityBits.COMPRESSED_GEOMETRY_ALLOW_REF_DATA_READ;
+
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_COUNT_READ,
+ ALLOW_HEADER_READ,
+ ALLOW_GEOMETRY_READ,
+ ALLOW_REF_DATA_READ
+ };
+
+ /**
+ * Package scoped default constructor for use by cloneNodeComponent.
+ */
+ CompressedGeometry() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Creates a new CompressedGeometry NodeComponent by copying
+ * the specified compressed geometry data into this object.
+ * If the version number of compressed geometry, as specified by
+ * the CompressedGeometryHeader, is incompatible with the
+ * supported version of compressed geometry in the current version
+ * of Java 3D, then the compressed geometry object will not be
+ * rendered.
+ *
+ * @param hdr the compressed geometry header. This is copied
+ * into the CompressedGeometry NodeComponent.
+ *
+ * @param compressedGeometry the compressed geometry data. The
+ * geometry must conform to the format described in Appendix B of
+ * the Java 3D API Specification.
+ *
+ * @exception IllegalArgumentException if a problem is detected with the
+ * header
+ *
+ * @see CompressedGeometryHeader
+ * @see Canvas3D#queryProperties
+ */
+ public CompressedGeometry(CompressedGeometryHeader hdr,
+ byte[] compressedGeometry) {
+ this(hdr, compressedGeometry, false) ;
+ }
+
+ /**
+ * Creates a new CompressedGeometry NodeComponent. The
+ * specified compressed geometry data is either copied into this
+ * object or is accessed by reference.
+ * If the version number of compressed geometry, as specified by
+ * the CompressedGeometryHeader, is incompatible with the
+ * supported version of compressed geometry in the current version
+ * of Java 3D, the compressed geometry object will not be
+ * rendered.
+ *
+ * @param hdr the compressed geometry header. This is copied
+ * into the CompressedGeometry NodeComponent.
+ *
+ * @param compressedGeometry the compressed geometry data. The
+ * geometry must conform to the format described in Appendix B of
+ * the Java 3D API Specification.
+ *
+ * @param byReference a flag that indicates whether the data is copied
+ * into this compressed geometry object or is accessed by reference.
+ *
+ * @exception IllegalArgumentException if a problem is detected with the
+ * header
+ *
+ * @see CompressedGeometryHeader
+ * @see Canvas3D#queryProperties
+ *
+ * @since Java 3D 1.2
+ */
+ public CompressedGeometry(CompressedGeometryHeader hdr,
+ byte[] compressedGeometry,
+ boolean byReference) {
+
+ if ((hdr.size + hdr.start) > compressedGeometry.length)
+ throw new IllegalArgumentException
+ (J3dI18N.getString("CompressedGeometry0")) ;
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ // Create a separate copy of the given header.
+ cgHeader = new CompressedGeometryHeader() ;
+ hdr.copy(cgHeader) ;
+
+ // Create the retained object.
+ ((CompressedGeometryRetained)this.retained).createCompressedGeometry
+ (cgHeader, compressedGeometry, byReference) ;
+
+ // This constructor is designed to accept byte arrays that may contain
+ // possibly many large compressed geometry blocks interspersed with
+ // non-J3D-specific metadata. Only one of these blocks is used per
+ // CompressedGeometry object, so set the geometry offset to zero in
+ // the header if the data itself is copied.
+ if (!byReference)
+ cgHeader.start = 0 ;
+ }
+
+ /**
+ * This constructor is not implemented.
+ *
+ * @exception UnsupportedOperationException this constructor is not
+ * implemented
+ *
+ * @since Java 3D 1.3
+ */
+ public CompressedGeometry(CompressedGeometryHeader hdr,
+ J3DBuffer compressedGeometry) {
+ throw new UnsupportedOperationException(J3dI18N.getString("CompressedGeometry9")) ;
+ }
+
+
+ /**
+ * Returns the size, in bytes, of the compressed geometry buffer.
+ * The size of the compressed geometry header is not included.
+ *
+ * @return the size, in bytes, of the compressed geometry buffer.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getByteCount() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException
+ (J3dI18N.getString("CompressedGeometry1")) ;
+
+ return cgHeader.size ;
+ }
+
+ /**
+ * Copies the compressed geometry header from the CompressedGeometry
+ * NodeComponent into the passed in parameter.
+ *
+ * @param hdr the CompressedGeometryHeader object into which to copy the
+ * CompressedGeometry NodeComponent's header; the offset field may differ
+ * from that which was originally specified if a copy of the original
+ * compressed geometry byte array was created.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see CompressedGeometryHeader
+ */
+ public void getCompressedGeometryHeader(CompressedGeometryHeader hdr) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_HEADER_READ))
+ throw new CapabilityNotSetException
+ (J3dI18N.getString("CompressedGeometry2")) ;
+
+ cgHeader.copy(hdr) ;
+ }
+
+ /**
+ * Retrieves the compressed geometry associated with the
+ * CompressedGeometry NodeComponent object. Copies the compressed
+ * geometry from the CompressedGeometry node into the given array.
+ * The array must be large enough to hold all of the bytes.
+ * The individual array elements must be allocated by the caller.
+ *
+ * @param compressedGeometry the array into which to copy the compressed
+ * geometry.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data access mode for this
+ * object is by-reference.
+ *
+ * @exception ArrayIndexOutOfBoundsException if compressedGeometry byte
+ * array is not large enough to receive the compressed geometry
+ */
+ public void getCompressedGeometry(byte[] compressedGeometry) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_GEOMETRY_READ))
+ throw new CapabilityNotSetException
+ (J3dI18N.getString("CompressedGeometry3")) ;
+
+ if (isByReference())
+ throw new IllegalStateException
+ (J3dI18N.getString("CompressedGeometry7")) ;
+
+ if (cgHeader.size > compressedGeometry.length)
+ throw new ArrayIndexOutOfBoundsException
+ (J3dI18N.getString("CompressedGeometry4")) ;
+
+ ((CompressedGeometryRetained)this.retained).copy(compressedGeometry) ;
+ }
+
+ /**
+ * Decompresses the compressed geometry. Returns an array of Shape nodes
+ * containing the decompressed geometry objects, or null if the version
+ * number of the compressed geometry is incompatible with the decompressor
+ * in the current version of Java 3D.
+ *
+ * @return an array of Shape nodes containing the
+ * geometry decompressed from this CompressedGeometry NodeComponent
+ * object, or null if its version is incompatible
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Shape3D[] decompress() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_GEOMETRY_READ))
+ throw new CapabilityNotSetException
+ (J3dI18N.getString("CompressedGeometry5")) ;
+
+ CompressedGeometryRetained cgr =
+ (CompressedGeometryRetained)this.retained ;
+
+ GeometryDecompressorShape3D decompressor =
+ new GeometryDecompressorShape3D() ;
+
+ // Decompress the geometry as TriangleStripArrays. A combination of
+ // TriangleStripArrays and TrianglesFanArrays is more compact but
+ // requires twice as many Shape3D objects, resulting in slower
+ // rendering performance.
+ //
+ // Using TriangleArray output is currently the fastest, given the
+ // strip sizes observed from various compressed geometry objects, but
+ // produces about twice as many vertices. TriangleStripArray produces
+ // the same number of Shape3D objects as TriangleArray using 1/2
+ // to 2/3 of the vertices, with only a marginal performance penalty.
+ //
+ return decompressor.toTriangleStripArrays(cgr) ;
+ }
+
+
+ /**
+ * Retrieves the data access mode for this CompressedGeometry object.
+ *
+ * @return byReference flag
+ * set to true. In this mode, a reference to the input
+ * data is saved, but the data itself is not necessarily copied. Note
+ * that the compressed geometry header is still copied into this
+ * compressed geometry object. Data referenced by a
+ * CompressedGeometry object must not be modified after the
+ * CompressedGeometry object is constructed.
+ * Applications
+ * must exercise care not to violate this rule. If any referenced
+ * compressed geometry data is modified after construction,
+ * the results are undefined.
+ * true if the data access mode for this
+ * CompressedGeometry object is by-reference;
+ * false if the data access mode is by-copying.
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean isByReference() {
+ return ((CompressedGeometryRetained)this.retained).isByReference() ;
+ }
+
+
+ /**
+ * Gets the compressed geometry data reference.
+ *
+ * @return the current compressed geometry data reference.
+ *
+ * @exception IllegalStateException if the data access mode for this
+ * object is not by-reference.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public byte[] getCompressedGeometryRef() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ))
+ throw new CapabilityNotSetException
+ (J3dI18N.getString("CompressedGeometry6")) ;
+
+ if (!isByReference())
+ throw new IllegalStateException
+ (J3dI18N.getString("CompressedGeometry8")) ;
+
+ return ((CompressedGeometryRetained)this.retained).getReference() ;
+ }
+
+
+ /**
+ * Gets the compressed geometry data buffer reference, which is
+ * always null since NIO buffers are not supported for
+ * CompressedGeometry objects.
+ *
+ * @return null
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public J3DBuffer getCompressedGeometryBuffer() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ))
+ throw new CapabilityNotSetException
+ (J3dI18N.getString("CompressedGeometry6")) ;
+
+ return null;
+ }
+
+
+ /**
+ * Creates the retained mode CompressedGeometryRetained object that this
+ * CompressedGeometry object will point to.
+ */
+ void createRetained() {
+ this.retained = new CompressedGeometryRetained() ;
+ this.retained.setSource(this) ;
+ }
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ CompressedGeometry cg = new CompressedGeometry() ;
+
+ // Duplicate data specific to this class.
+ cg.cgHeader = new CompressedGeometryHeader() ;
+ cgHeader.copy(cg.cgHeader) ;
+
+ // Duplicate the retained side.
+ CompressedGeometryRetained cgr = (CompressedGeometryRetained)retained ;
+ cgr.duplicate((CompressedGeometryRetained)cg.retained) ;
+
+ // Duplicate superclass data and return.
+ cg.duplicateNodeComponent(this) ;
+ return cg ;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryHeader.java b/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryHeader.java
new file mode 100644
index 0000000..fad8927
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryHeader.java
@@ -0,0 +1,260 @@
+/*
+ * $RCSfile: CompressedGeometryHeader.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+
+/**
+ * The CompressedGeometrHeader object is used in conjunction with
+ * the CompressedGeometry object. The CompressedGeometrHeader object
+ * contains information specific to the compressed geometry stored in
+ * CompressedGeometry NodeComponent object. This information
+ * is used to aid the decompression of the compressed geometry.
+ * size bytes of compressed geometry data are copied from the
+ * offset indicated by start instead of copying the entire
+ * byte array. The getCompressedGeometry() method will return only the
+ * bytes used to construct the object, and the getCompressedGeometryHeader()
+ * method will return a header with the start field set to 0.
+ */
+ public int start ;
+
+ /**
+ * A point that defines the lower bound of the x,
+ * y, and z components for all positions in the
+ * compressed geometry buffer. If null, a lower bound of
+ * (-1,-1,-1) is assumed. Java 3D will use this information to
+ * construct a bounding box around compressed geometry objects
+ * that are used in nodes for which the auto compute bounds flag
+ * is true. The default value for this point is null.
+ *
+ * @since Java 3D 1.2
+ */
+ public Point3d lowerBound = null ;
+
+ /**
+ * A point that defines the upper bound of the x,
+ * y, and z components for all positions in the
+ * compressed geometry buffer. If null, an upper bound of (1,1,1)
+ * is assumed. Java 3D will use this information to construct a
+ * bounding box around compressed geometry objects that are used
+ * in nodes for which the auto compute bounds flag is true. The
+ * default value for this point is null.
+ *
+ * @since Java 3D 1.2
+ */
+ public Point3d upperBound = null ;
+
+ /**
+ * Creates a new CompressedGeometryHeader object used for the
+ * creation of a CompressedGeometry NodeComponent object.
+ * All instance data is declared public and no get or set methods are
+ * provided. All values are set to 0 by default and must be filled
+ * in by the application.
+ *
+ * @see CompressedGeometry
+ */
+ public CompressedGeometryHeader() {
+ }
+
+ /**
+ * Package-scoped method to copy current CompressedGeometryHeader object
+ * to the passed-in CompressedGeometryHeader object.
+ *
+ * @param hdr the CompressedGeometryHeader object into which to copy the
+ * current CompressedGeometryHeader.
+ */
+ void copy(CompressedGeometryHeader hdr) {
+ hdr.majorVersionNumber = this.majorVersionNumber ;
+ hdr.minorVersionNumber = this.minorVersionNumber ;
+ hdr.minorMinorVersionNumber = this.minorMinorVersionNumber ;
+ hdr.bufferType = this.bufferType ;
+ hdr.bufferDataPresent = this.bufferDataPresent ;
+ hdr.size = this.size ;
+ hdr.start = this.start ;
+ hdr.lowerBound = this.lowerBound ;
+ hdr.upperBound = this.upperBound ;
+ }
+
+ /**
+ * Returns a String describing the contents of the
+ * CompressedGeometryHeader object.
+ *
+ * @return a String describing contents of the compressed geometry header
+ */
+ public String toString() {
+ String type = "UNKNOWN" ;
+ switch (bufferType) {
+ case POINT_BUFFER: type = "POINT_BUFFER" ; break ;
+ case LINE_BUFFER: type = "LINE_BUFFER" ; break ;
+ case TRIANGLE_BUFFER: type = "TRIANGLE_BUFFER" ; break ;
+ }
+
+ String data = "" ;
+ if ((bufferDataPresent & NORMAL_IN_BUFFER) != 0)
+ data = data + "NORMALS " ;
+ if ((bufferDataPresent & COLOR_IN_BUFFER) != 0)
+ data = data + "COLORS " ;
+ if ((bufferDataPresent & ALPHA_IN_BUFFER) != 0)
+ data = data + "ALPHA " ;
+
+ String lbound = "null" ;
+ if (lowerBound != null)
+ lbound = lowerBound.toString() ;
+
+ String ubound = "null" ;
+ if (upperBound != null)
+ ubound = upperBound.toString() ;
+
+ return
+ "majorVersionNumber: " + majorVersionNumber + " " +
+ "minorVersionNumber: " + minorVersionNumber + " " +
+ "minorMinorVersionNumber: " + minorMinorVersionNumber + "\n" +
+ "bufferType: " + type + " " +
+ "bufferDataPresent: " + data + "\n" +
+ "size: " + size + " " +
+ "start: " + start + "\n" +
+ "lower bound: " + lbound + "\n" +
+ "upper bound: " + ubound + " " ;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryRenderMethod.java b/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryRenderMethod.java
new file mode 100644
index 0000000..352cd87
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryRenderMethod.java
@@ -0,0 +1,119 @@
+/*
+ * $RCSfile: CompressedGeometryRenderMethod.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d ;
+
+/**
+ * The RenderMethod interface is used to create various ways to render
+ * different geometries.
+ */
+
+class CompressedGeometryRenderMethod implements RenderMethod {
+
+ /**
+ * The actual rendering code for this RenderMethod.
+ */
+ public boolean render(RenderMolecule rm, Canvas3D cv,
+ RenderAtomListInfo ra, int dirtyBits) {
+
+ CompressedGeometryRetained cgr ;
+
+ if (rm.doInfinite) {
+ cv.updateState(dirtyBits);
+ while (ra != null) {
+ renderCompressedGeo(ra, rm, cv);
+ ra = ra.next;
+ }
+ return true;
+ }
+
+ boolean isVisible = false; // True if any of the RAs is visible.
+
+ while (ra != null) {
+ if (cv.ra == ra.renderAtom) {
+ if (cv.raIsVisible) {
+ cv.updateState(dirtyBits);
+ renderCompressedGeo(ra, rm, cv);
+ isVisible = true;
+ }
+ }
+ else {
+ if (!VirtualUniverse.mc.viewFrustumCulling ||
+ ra.renderAtom.localeVwcBounds.intersect(cv.viewFrustum)) {
+ cv.updateState(dirtyBits);
+ cv.raIsVisible = true;
+ renderCompressedGeo(ra, rm, cv);
+ isVisible = true;
+ }
+ else {
+ cv.raIsVisible = false;
+ }
+ cv.ra = ra.renderAtom;
+ }
+
+ ra = ra.next;
+ }
+
+ return isVisible;
+
+ }
+
+ void renderCompressedGeo(RenderAtomListInfo ra, RenderMolecule rm, Canvas3D cv) {
+
+ boolean useAlpha ;
+ CompressedGeometryRetained cgr ;
+ useAlpha = rm.useAlpha ;
+
+ cgr = (CompressedGeometryRetained)ra.renderAtom.geometryAtom.geometryArray[ra.index];
+
+ /* force_decompression if lighting is disabled and
+ * ignoreVertexColors is TRUE, since there is no way for openGL
+ * to ignore vertexColors in this case, force decompression
+ */
+ if (rm.textureBin.attributeBin.ignoreVertexColors && rm.enableLighting == false && cgr.mirrorGeometry == null) {
+ cgr.mirrorGeometry = cgr.getGeometry(true, cv) ;
+ }
+ else if (cgr.mirrorGeometry == null) {
+ // cgr.getGeometry() will decompress in software and return a
+ // GeometryRetained if hardware decompression isn't available,
+ // otherwise it just returns cgr.
+ cgr.mirrorGeometry = cgr.getGeometry(false, cv) ;
+ if (cgr.mirrorGeometry == null)
+ // decompressor error
+ return ;
+ }
+
+ cgr.mirrorGeometry.execute(cv, ra.renderAtom, rm.isNonUniformScale,
+ (useAlpha && ra.geometry().noAlpha), rm.alpha,
+ cv.screen.screen,
+ rm.textureBin.attributeBin.ignoreVertexColors);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryRetained.java b/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryRetained.java
new file mode 100644
index 0000000..080d248
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/CompressedGeometryRetained.java
@@ -0,0 +1,466 @@
+/*
+ * $RCSfile: CompressedGeometryRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d ;
+import javax.vecmath.* ;
+
+/**
+ * The compressed geometry object is used to store geometry in a
+ * compressed format. Using compressed geometry reduces the amount
+ * of memory needed by a Java 3D application and increases the speed
+ * objects can be sent over the network. Once geometry decompression
+ * hardware support becomes available, increased rendering performance
+ * will also result from the use of compressed geometry.
+ */
+class CompressedGeometryRetained extends GeometryRetained {
+
+ // If not in by-reference mode, a 48-byte header as defined by the
+ // GL_SUNX_geometry_compression OpenGL extension is always concatenated to
+ // the beginning of the compressed geometry data and copied along with the
+ // it into a contiguous array. This allows hardware decompression using
+ // the obsolete experimental GL_SUNX_geometry_compression extension if
+ // that is all that is available.
+ //
+ // This is completely distinct and not to be confused with the cgHeader
+ // field on the non-retained side, although much of the data is
+ // essentially the same.
+ private static final int HEADER_LENGTH = 48 ;
+
+ // These are the header locations examined.
+ private static final int HEADER_MAJOR_VERSION_OFFSET = 0 ;
+ private static final int HEADER_MINOR_VERSION_OFFSET = 1 ;
+ private static final int HEADER_MINOR_MINOR_VERSION_OFFSET = 2 ;
+ private static final int HEADER_BUFFER_TYPE_OFFSET = 3 ;
+ private static final int HEADER_BUFFER_DATA_OFFSET = 4 ;
+
+ // The OpenGL compressed geometry extensions use bits instead of
+ // enumerations to represent the type of compressed geometry.
+ static final byte TYPE_POINT = 1 ;
+ static final byte TYPE_LINE = 2 ;
+ static final byte TYPE_TRIANGLE = 4 ;
+
+ // Version number of this compressed geometry object.
+ int majorVersionNumber ;
+ int minorVersionNumber ;
+ int minorMinorVersionNumber ;
+
+ // These fields are used by the native execute() method.
+ int packedVersion ;
+ int bufferType ;
+ int bufferContents ;
+ int renderFlags ;
+ int offset ;
+ int size ;
+ byte[] compressedGeometry ;
+
+ // True if by-reference data access mode is in effect.
+ private boolean byReference = false ;
+
+ // A reference to the original byte array with which this object was
+ // created. If hardware decompression is available but it doesn't support
+ // by-reference semantics, then an internal copy of the original byte array
+ // is made even when by-reference semantics have been requested.
+ private byte[] originalCompressedGeometry = null ;
+
+ // True if the platform supports hardware decompression.
+ private static boolean hardwareDecompression = false ;
+
+ // This field retains a reference to the GeometryRetained object used for
+ // geometry-based picking. It is normally the same reference as the
+ // mirror geometry used for rendering unless hardware decompression is
+ // supported.
+ private GeometryRetained pickGeometry = null ;
+
+ /**
+ * Formerly native method that returns availability of a native by-reference
+ * rendering API for compressed geometry.
+ */
+ private boolean decompressByRef(Context ctx) {
+ return false;
+ }
+
+ /**
+ * Formerly native method that returns availability of hardware
+ * rendering (and acceleration) for compressed geometry of the
+ * given version.
+ */
+ private boolean decompressHW(Context ctx, int majorVersion, int minorVersion) {
+ return false;
+ }
+
+ /**
+ * Formerly native method that does HW compressed geometry rendering
+ */
+ private void execute(Context ctx, int version, int bufferType,
+ int bufferContents, int renderFlags,
+ int offset, int size, byte[] geometry) {
+
+ assert false : "This method should never be called!";
+ }
+
+ /**
+ * Method for calling native execute() method on behalf of the J3D renderer.
+ */
+ void execute(Canvas3D cv, RenderAtom ra, boolean isNonUniformScale,
+ boolean updateAlpha, float alpha,
+ int screen, boolean ignoreVertexColors) {
+
+ // XXXX: alpha udpate
+ execute(cv.ctx, packedVersion, bufferType, bufferContents,
+ renderFlags, offset, size, compressedGeometry) ;
+ }
+
+ /**
+ * The package-scoped constructor.
+ */
+ CompressedGeometryRetained() {
+ this.geoType = GEO_TYPE_COMPRESSED ;
+
+ // Compressed geometry is always bounded by [-1..1] on each axis, so
+ // set that as the initial bounding box.
+ geoBounds.setUpper( 1.0, 1.0, 1.0) ;
+ geoBounds.setLower(-1.0,-1.0,-1.0) ;
+ }
+
+ /**
+ * Compressed geometry is immutable so this method does nothing.
+ */
+ void computeBoundingBox() {
+ }
+
+ /**
+ * Update this object. Compressed geometry is immutable so there's
+ * nothing to do.
+ */
+ void update() {
+ isDirty = 0 ;
+ }
+
+ /**
+ * Return true if the data access mode is by-reference.
+ */
+ boolean isByReference() {
+ return this.byReference ;
+ }
+
+ private void createByCopy(byte[] geometry) {
+ // Always copy a header along with the compressed geometry into a
+ // contiguous array in order to support hardware acceleration with the
+ // GL_SUNX_geometry_compression extension. The header is unnecessary
+ // if only the newer GL_SUN_geometry_compression API needs support.
+ compressedGeometry = new byte[HEADER_LENGTH + this.size] ;
+
+ compressedGeometry[HEADER_MAJOR_VERSION_OFFSET] =
+ (byte)this.majorVersionNumber ;
+
+ compressedGeometry[HEADER_MINOR_VERSION_OFFSET] =
+ (byte)this.minorVersionNumber ;
+
+ compressedGeometry[HEADER_MINOR_MINOR_VERSION_OFFSET] =
+ (byte)this.minorMinorVersionNumber ;
+
+ compressedGeometry[HEADER_BUFFER_TYPE_OFFSET] =
+ (byte)this.bufferType ;
+
+ compressedGeometry[HEADER_BUFFER_DATA_OFFSET] =
+ (byte)this.bufferContents ;
+
+ System.arraycopy(geometry, this.offset,
+ compressedGeometry, HEADER_LENGTH, this.size) ;
+
+ this.offset = HEADER_LENGTH ;
+ }
+
+ /**
+ * Creates the retained compressed geometry data. Data from the header is
+ * always copied; the compressed geometry is copied as well if the data
+ * access mode is not by-reference.
+ *
+ * @param hdr the compressed geometry header
+ * @param geometry the compressed geometry
+ * @param byReference if true then by-reference semantics requested
+ */
+ void createCompressedGeometry(CompressedGeometryHeader hdr,
+ byte[] geometry, boolean byReference) {
+
+ this.byReference = byReference ;
+
+ if (hdr.lowerBound != null)
+ this.geoBounds.setLower(hdr.lowerBound) ;
+
+ if (hdr.upperBound != null)
+ this.geoBounds.setUpper(hdr.upperBound) ;
+
+ this.centroid.set(geoBounds.getCenter());
+ recompCentroid = false;
+ this.majorVersionNumber = hdr.majorVersionNumber ;
+ this.minorVersionNumber = hdr.minorVersionNumber ;
+ this.minorMinorVersionNumber = hdr.minorMinorVersionNumber ;
+
+ this.packedVersion =
+ (hdr.majorVersionNumber << 24) |
+ (hdr.minorVersionNumber << 16) |
+ (hdr.minorMinorVersionNumber << 8) ;
+
+ switch(hdr.bufferType) {
+ case CompressedGeometryHeader.POINT_BUFFER:
+ this.bufferType = TYPE_POINT ;
+ break ;
+ case CompressedGeometryHeader.LINE_BUFFER:
+ this.bufferType = TYPE_LINE ;
+ break ;
+ case CompressedGeometryHeader.TRIANGLE_BUFFER:
+ this.bufferType = TYPE_TRIANGLE ;
+ break ;
+ }
+
+ this.bufferContents = hdr.bufferDataPresent ;
+ this.renderFlags = 0 ;
+
+ this.size = hdr.size ;
+ this.offset = hdr.start ;
+
+ if (byReference) {
+ // Assume we can use the given reference, but maintain a second
+ // reference in case a copy is later needed.
+ this.compressedGeometry = geometry ;
+ this.originalCompressedGeometry = geometry ;
+ } else {
+ // Copy the original data into a format that can be used by both
+ // the software and native hardware decompressors.
+ createByCopy(geometry) ;
+ this.originalCompressedGeometry = null ;
+ }
+ }
+
+ /**
+ * Decompress this object into a GeometryArrayRetained if hardware
+ * decompression is not available. Once decompressed the resulting
+ * geometry replaces the geometry reference in the associated RenderAtom
+ * as well as the mirror geometry reference in this object.
+ */
+ GeometryRetained getGeometry(boolean forceDecompression, Canvas3D cv ) {
+
+ if (forceDecompression) {
+ // forceDecompression is set to true if lighting is disabled and
+ // ignoreVertexColors is true, since there is no way for openGL to
+ // ignore vertexColors in this case.
+ GeometryDecompressorRetained gdr =
+ new GeometryDecompressorRetained() ;
+
+ mirrorGeometry = gdr.decompress(this) ;
+ gdr.getBoundingBox(geoBounds) ;
+ pickGeometry = mirrorGeometry ;
+ }
+ else {
+ // Return this object if hardware decompression is available.
+ if (hardwareDecompression)
+ return (GeometryRetained)this ;
+
+ // Check to see if hardware decompression is available.
+ if (decompressHW(cv.ctx, majorVersionNumber, minorVersionNumber)) {
+ hardwareDecompression = true ;
+
+ // If hardware can't handle by-reference, punt to by-copy.
+ if (isByReference() && !decompressByRef(cv.ctx)) {
+ createByCopy(compressedGeometry) ;
+ }
+
+ return (GeometryRetained)this ;
+ }
+
+ // Decompress the data into a GeometryArrayRetained representation
+ // for the mirror geometry reference.
+ GeometryDecompressorRetained gdr =
+ new GeometryDecompressorRetained() ;
+
+ mirrorGeometry = gdr.decompress(this) ;
+ gdr.getBoundingBox(geoBounds) ;
+
+ // The mirror geometry contains a superset of the pick geometry
+ // data. Since hardware decompression isn't available, there's no
+ // need to retain separate pick geometry.
+ pickGeometry = mirrorGeometry ;
+ }
+
+ return mirrorGeometry ;
+ }
+
+ /**
+ * This method always decompresses the geometry and retains the result in
+ * order to support geometry-based picking and collision detection. The
+ * returned GeometryRetained object will contain only positions and
+ * connections.
+ */
+ GeometryRetained getPickGeometry() {
+ // Return the pick geometry if available.
+ if (pickGeometry != null)
+ return pickGeometry ;
+
+ // Decompress the data into a GeometryArrayRetained representation for
+ // the pick geometry reference. Retain it and its bounding box.
+ GeometryDecompressorRetained gdr = new GeometryDecompressorRetained() ;
+ gdr.setDecompressPositionsOnly(true) ;
+
+ pickGeometry = gdr.decompress(this) ;
+ gdr.getBoundingBox(geoBounds) ;
+ return pickGeometry ;
+ }
+
+ //
+ // The following intersect() methods are used to implement geometry-based
+ // picking and collision.
+ //
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ GeometryRetained geomR = getPickGeometry() ;
+ return (geomR != null ?
+ geomR.intersect(pickShape, pickInfo, flags, iPnt, geom, geomIndex) : false);
+ }
+
+ boolean intersect(Bounds targetBound) {
+ GeometryRetained geom = getPickGeometry() ;
+ return (geom != null ? geom.intersect(targetBound) : false);
+ }
+
+ boolean intersect(Transform3D thisToOtherVworld, GeometryRetained g) {
+ GeometryRetained geom = getPickGeometry() ;
+ return (geom != null ?
+ geom.intersect(thisToOtherVworld, g) : false);
+ }
+
+ boolean intersect(Point3d[] pnts) {
+ GeometryRetained geom = getPickGeometry() ;
+ return (geom != null ? geom.intersect(pnts) : false);
+ }
+
+ /**
+ * Return a vertex format mask that's compatible with GeometryArray
+ * objects.
+ */
+ int getVertexFormat() {
+ int vertexFormat = GeometryArray.COORDINATES ;
+
+ if ((this.bufferContents &
+ CompressedGeometryHeader.NORMAL_IN_BUFFER) != 0)
+ vertexFormat |= GeometryArray.NORMALS ;
+
+ if ((this.bufferContents &
+ CompressedGeometryHeader.COLOR_IN_BUFFER) != 0)
+ vertexFormat |= GeometryArray.COLOR ;
+
+ if ((this.bufferContents &
+ CompressedGeometryHeader.ALPHA_IN_BUFFER) != 0)
+ vertexFormat |= GeometryArray.WITH_ALPHA ;
+
+ return vertexFormat ;
+ }
+
+ /**
+ * Return a buffer type that's compatible with CompressedGeometryHeader.
+ */
+ int getBufferType() {
+ switch(this.bufferType) {
+ case TYPE_POINT:
+ return CompressedGeometryHeader.POINT_BUFFER ;
+ case TYPE_LINE:
+ return CompressedGeometryHeader.LINE_BUFFER ;
+ default:
+ case TYPE_TRIANGLE:
+ return CompressedGeometryHeader.TRIANGLE_BUFFER ;
+ }
+ }
+
+ /**
+ * Copies compressed geometry data into the given array of bytes.
+ * The internal header information is not copied.
+ *
+ * @param buff array of bytes into which to copy compressed geometry
+ */
+ void copy(byte[] buff) {
+ System.arraycopy(compressedGeometry, offset, buff, 0, size) ;
+ }
+
+ /**
+ * Returns a reference to the original compressed geometry byte array,
+ * which may have been copied even if by-reference semantics have been
+ * requested. It will be null if byCopy is in effect.
+ *
+ * @return reference to array of bytes containing the compressed geometry.
+ */
+ byte[] getReference() {
+ return originalCompressedGeometry ;
+ }
+
+ /**
+ * Copies all retained data for cloneNodeComponent() on the non-retained
+ * side. This is unlike GeometryArray subclasses which just call the
+ * public API constructors and then duplicateNodeComponent() to invoke the
+ * GeometryArray implementation of duplicateAttributes(), since the
+ * CompressedGeometry class directly subclasses Geometry and calling the
+ * public constructors would cause a lot of redundant data copying.
+ */
+ void duplicate(CompressedGeometryRetained cgr) {
+ cgr.majorVersionNumber = this.majorVersionNumber ;
+ cgr.minorVersionNumber = this.minorVersionNumber ;
+ cgr.minorMinorVersionNumber = this.minorMinorVersionNumber ;
+
+ cgr.packedVersion = this.packedVersion ;
+ cgr.bufferType = this.bufferType ;
+ cgr.bufferContents = this.bufferContents ;
+ cgr.renderFlags = this.renderFlags ;
+
+ cgr.offset = this.offset ;
+ cgr.size= this.size ;
+
+ cgr.geoBounds.setLower(this.geoBounds.lower) ;
+ cgr.geoBounds.setUpper(this.geoBounds.upper) ;
+ cgr.pickGeometry = this.pickGeometry ;
+ cgr.byReference = this.byReference ;
+
+ if (this.byReference) {
+ // Copy references only.
+ cgr.compressedGeometry = this.compressedGeometry ;
+ cgr.originalCompressedGeometry = this.originalCompressedGeometry ;
+ } else {
+ // Copy entire byte array including 48-byte native OpenGL header.
+ cgr.compressedGeometry = new byte[this.compressedGeometry.length] ;
+ System.arraycopy(this.compressedGeometry, 0,
+ cgr.compressedGeometry, 0,
+ this.compressedGeometry.length) ;
+ cgr.originalCompressedGeometry = null ;
+ }
+ }
+
+ int getClassType() {
+ return COMPRESS_TYPE;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ConeSound.java b/j3d-core/src/classes/share/javax/media/j3d/ConeSound.java
new file mode 100644
index 0000000..a5e1232
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ConeSound.java
@@ -0,0 +1,962 @@
+/*
+ * $RCSfile: ConeSound.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.lang.Math;
+import javax.vecmath.Point2f;
+import javax.vecmath.Point3f;
+import javax.vecmath.Vector3f;
+
+
+/**
+ * The ConeSound node object defines a PointSound node whose sound source is
+ * directed along a specific vector in space. A ConeSound source is attenuated
+ * by gain scale factors and filters based on the angle between the vector from
+ * the source to the listener, and the ConeSound's direction vector. This
+ * attenuation is either a single spherical distance gain attenuation (as for
+ * a general PointSound source) or dual front and back distance gain
+ * attenuations defining elliptical attenuation areas. The angular filter and the
+ * active AuralAttribute component filter define what filtering is applied to
+ * the sound source. (See AuralAtttribute class for more details on filtering.)
+ * This node has the same attributes as a PointSound node with the addition of a
+ * direction vector and an array of points each containing: angular distance (in
+ * radians), gain scale factor, and filter (which for now consists of a lowpass
+ * filter cutoff frequency). Similar to the definition of the back distance gain
+ * array for PointSounds, a piece-wise linear curve (defined in terms of
+ * radians from the axis) specifies the slope of these additional attenuation
+ * values.
+ *
+ * A cone sound node can have one or two distance attenuation arrays.
+ * If none are set, no distance gain attenuation is performed (equivalent
+ * to using a distance gain of 1.0 for all distances). If only one distance
+ * attenuation array is set, sphere attenuation is assumed. If both a front
+ * and back distance attenuation are set, elliptical attenuation regions
+ * are defined.
+ *
+ * This value is the sound source's direction vector. It is the axis from
+ * which angular distance is measured.
+ *
+ * Besides sound (linear) distance attenuation a ConeSound can optionally
+ * define angular gain and filter attenuation.
+ *
+ */
+
+public class ConeSound extends PointSound {
+ // Constants
+ //
+ // These flags, when enabled using the setCapability method, allow an
+ // application to invoke methods that respectively read and write direction
+ // and angular attenuation array. These capability flags are enforced only
+ // when the node is part of a live or compiled scene graph.
+
+ /**
+ * Specifies that this ConeSound allows access to its object's direction
+ * information.
+ */
+ public static final int
+ ALLOW_DIRECTION_READ = CapabilityBits.CONE_SOUND_ALLOW_DIRECTION_READ;
+
+ /**
+ * Specifies that this ConeSound allows writing to its object's direction
+ * information.
+ */
+ public static final int
+ ALLOW_DIRECTION_WRITE = CapabilityBits.CONE_SOUND_ALLOW_DIRECTION_WRITE;
+
+ /**
+ * Specifies that this ConeSound allows access to its object's cone params
+ * information.
+ */
+ public static final int
+ ALLOW_ANGULAR_ATTENUATION_READ = CapabilityBits.CONE_SOUND_ALLOW_ANGULAR_ATTENUATION_READ;
+
+ /**
+ * Specifies that this ConeSound allows writing to its object's cone params
+ * information.
+ */
+ public static final int
+ ALLOW_ANGULAR_ATTENUATION_WRITE = CapabilityBits.CONE_SOUND_ALLOW_ANGULAR_ATTENUATION_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_DIRECTION_READ,
+ ALLOW_ANGULAR_ATTENUATION_READ
+ };
+
+ /**
+ * Constructs and initializes a new ConeSound node using default
+ * parameters. The following default values are used:
+ *
+ * Direction vector: (0.0, 0.0, 1.0)
+ */
+ public ConeSound() {
+ // Uses default values defined in ConeSoundRetained.java
+ super();
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a ConeSound node object using only the provided parameter
+ * values for sound, overall initial gain, position, and direction. The
+ * remaining fields are set to the default values above. This form uses
+ * Point3f as input for its position and Vector3f for direction.
+ * @param soundData sound source data associated with this node
+ * @param initialGain amplitude scale factor applied to sound
+ * @param position 3D location of source
+ * @param direction 3D vector defining cone's axis
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ Point3f position,
+ Vector3f direction) {
+
+ super(soundData, initialGain, position );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setDirection(direction);
+ }
+
+ /**
+ * Constructs a ConeSound node object using only the provided parameter
+ * values for sound, overall initial gain, position, and direction. The
+ * remaining fields are set to the default values above. This form uses
+ * individual float parameters for the elements of the position and
+ * direction vectors.
+ * @param soundData sound source data
+ * @param initialGain amplitude scale factor applied to sound
+ * @param posX x coordinate of location of source
+ * @param posY y coordinate of location of source
+ * @param posZ z coordinate of location of source
+ * @param dirX x coordinate cones' axii vector
+ * @param dirY y coordinate cones' axii vector
+ * @param dirZ z coordinate cones' axii vector
+ */
+ public ConeSound(MediaContainer soundData,
+ float initialGain,
+ float posX, float posY, float posZ,
+ float dirX, float dirY, float dirZ) {
+
+ super(soundData, initialGain, posX, posY, posZ );
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ConeSoundRetained)this.retained).setDirection(dirX, dirY, dirZ);
+ }
+
+ /**
+ * Constructs a ConeSound node object using all the provided PointSound
+ * parameter values. This form uses points or vectors as input for its
+ * position, direction, and front/back distance attenuation arrays.
+ *
+ * Angular attenuation:
+ * ((0.0, 1.0, Sound.NO_FILTER),(p/2, 0.0, Sound.NO_FILTER))
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ ConeSound c = new ConeSound();
+ c.duplicateNode(this, forceDuplicate);
+ return c;
+ }
+
+ /**
+ * Copies all node information from originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.
+ * NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ * @exception ClassCastException if originalNode is not an instance of
+ * ConeSound
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public void duplicateNode(Node originalNode, boolean forceDuplicate) {
+ checkDuplicateNode(originalNode, forceDuplicate);
+ }
+
+
+ /**
+ * Copies all ConeSound information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ ConeSoundRetained orgRetained = (ConeSoundRetained)originalNode.retained;
+ ConeSoundRetained thisRetained = (ConeSoundRetained)this.retained;
+
+ // front distance gain & attenuation is set in super
+ // set back distance gain only
+ int len = orgRetained.getDistanceGainLength();
+ float distance[] = new float[len];
+ float gain[] = new float[len];
+ orgRetained.getDistanceGain(null, null,distance, gain);
+ thisRetained.setBackDistanceGain(distance, gain);
+
+ Vector3f v = new Vector3f();
+ orgRetained.getDirection(v);
+ thisRetained.setDirection(v);
+
+ len = orgRetained.getAngularAttenuationLength();
+ distance = gain = null;
+ float angle[] = new float[len];
+ float angularGain[] = new float[len];
+ float frequencyCutoff[] = new float[len];
+
+ orgRetained.getAngularAttenuation(angle, angularGain,
+ frequencyCutoff);
+
+ thisRetained.setAngularAttenuation(angle, angularGain, frequencyCutoff);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ConeSoundRetained.java b/j3d-core/src/classes/share/javax/media/j3d/ConeSoundRetained.java
new file mode 100644
index 0000000..040a352
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ConeSoundRetained.java
@@ -0,0 +1,660 @@
+/*
+ * $RCSfile: ConeSoundRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Vector3f;
+import javax.vecmath.Vector3d;
+import javax.vecmath.Point2f;
+import javax.vecmath.Point3f;
+
+
+
+/**
+ * A ConeSoundRetained node defines a point sound source located at some
+ * location
+ * in space whose amplitude is constrained not only by maximum and minimum
+ * amplitude
+ * spheres but by two concentric cone volumes directed down an vector radiating
+ * from the sound's location.
+ */
+
+class ConeSoundRetained extends PointSoundRetained {
+ /**
+ * The Cone Sound's direction vector. This is the cone axis.
+ */
+ Vector3f direction = new Vector3f(0.0f, 0.0f, 1.0f);
+
+ // The transformed direction of this sound
+ Vector3f xformDirection = new Vector3f(0.0f, 0.0f, 1.0f);
+
+ // Sound's gain is attenuated for listener locations off-angle from
+ // the source source direction.
+ // This can be set of three numbers:
+ // angular distance in radians
+ // gain scale factor
+ // filtering (currently the only filtering supported is lowpass)
+
+ // For now the only supported filterType will be LOW_PASS frequency cutoff.
+ // At some time full FIR filtering will be supported.
+ static final int NO_FILTERING = -1;
+ static final int LOW_PASS = 1;
+
+ // Pairs of distances and gain scale factors that define piecewise linear
+ // gain BACK attenuation between each pair.
+ // These are used for defining elliptical attenuation regions.
+ float[] backAttenuationDistance = null;
+ float[] backAttenuationGain = null;
+
+ float[] angularDistance = {0.0f, ((float)(Math.PI) * 0.5f)};
+ float[] angularGain = {1.0f, 0.0f};
+ int filterType = NO_FILTERING;
+ float[] frequencyCutoff = {Sound.NO_FILTER, Sound.NO_FILTER};
+
+ ConeSoundRetained() {
+ this.nodeType = NodeRetained.CONESOUND;
+ }
+
+ // *********************
+ //
+ // Distance Gain methods
+ //
+ // *********************
+
+ /**
+ * Sets this sound's distance gain elliptical attenuation -
+ * where gain scale factor is applied to sound based on distance listener
+ * is from sound source.
+ * @param frontAttenuation defined by pairs of (distance,gain-scale-factor)
+ * @param backAttenuation defined by pairs of (distance,gain-scale-factor)
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ void setDistanceGain(Point2f[] frontAttenuation,
+ Point2f[] backAttenuation ) {
+
+ this.setDistanceGain(frontAttenuation);
+ this.setBackDistanceGain(backAttenuation);
+ }
+
+ /**
+ * Sets this sound's distance gain attenuation as an array of Point2fs.
+ * @param frontDistance array of monotonically-increasing floats
+ * @param frontGain array of non-negative scale factors
+ * @param backDistance array of monotonically-increasing floats
+ * @param backGain array of non-negative scale factors
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ void setDistanceGain(float[] frontDistance, float[] frontGain,
+ float[] backDistance, float[] backGain) {
+ this.setDistanceGain(frontDistance, frontGain);
+ this.setBackDistanceGain(backDistance, backGain);
+ }
+
+ /**
+ * Sets this sound's back distance gain attenuation - where gain scale
+ * factor is applied to sound based on distance listener along the negative
+ * sound direction axis from sound source.
+ * @param attenuation defined by pairs of (distance,gain-scale-factor)
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ void setBackDistanceGain(Point2f[] attenuation)
+ {
+ // if attenuation array null set both attenuation components to null
+ if (attenuation == null) {
+ this.backAttenuationDistance = null;
+ this.backAttenuationGain = null;
+ }
+ else {
+ int attenuationLength = attenuation.length;
+ if (attenuationLength == 0) {
+ this.backAttenuationDistance = null;
+ this.backAttenuationGain = null;
+ }
+ else {
+ this.backAttenuationDistance = new float[attenuationLength];
+ this.backAttenuationGain = new float[attenuationLength];
+ for (int i = 0; i < attenuationLength; i++) {
+ this.backAttenuationDistance[i] = attenuation[i].x;
+ this.backAttenuationGain[i] = attenuation[i].y;
+ }
+ }
+ }
+ dispatchAttribChange(BACK_DISTANCE_GAIN_DIRTY_BIT, attenuation);
+ if (source != null && source.isLive()) {
+ notifySceneGraphChanged(false);
+ }
+ }
+
+ /**
+ * Sets this sound's back distance gain attenuation as an array of Point2fs.
+ * @param distance array of monotonically-increasing floats
+ * @param gain array of non-negative scale factors
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ void setBackDistanceGain(float[] distance, float[] gain)
+ {
+ int distanceLength = 0;
+ // if distance or gain arrays are null then treat both as null
+ if (distance == null || gain == null) {
+ this.backAttenuationDistance = null;
+ this.backAttenuationGain = null;
+ }
+ else {
+ // now process the back attenuation values
+ int gainLength = gain.length;
+ distanceLength = distance.length;
+ if (distanceLength == 0 || gainLength == 0) {
+ this.backAttenuationDistance = null;
+ this.backAttenuationGain = null;
+ }
+ else {
+ this.backAttenuationDistance = new float[distanceLength];
+ this.backAttenuationGain = new float[distanceLength];
+ // Copy the distance array into nodes field
+ System.arraycopy(distance, 0, this.backAttenuationDistance,
+ 0, distanceLength);
+ // Copy the gain array an array of same length as the distance array
+ if (distanceLength <= gainLength) {
+ System.arraycopy(gain, 0, this.backAttenuationGain,
+ 0, distanceLength);
+ }
+ else {
+ System.arraycopy(gain, 0, this.backAttenuationGain, 0, gainLength);
+ // Extend gain array to length of distance array
+ // replicate last gain values.
+ for (int i=gainLength; i< distanceLength; i++) {
+ this.backAttenuationGain[i] = gain[gainLength - 1];
+ }
+ }
+ }
+ }
+
+ Point2f [] attenuation = new Point2f[distanceLength];
+ for (int i=0; icloneTree and has at least one Leaf node
+ * that contains a reference to a Node that has no corresponding node in
+ * the cloned sub-graph. This results in two Leaf nodes wanting to share
+ * access to the same Node.
+ * cloneTree should be called with the
+ * allowDanglingReferences parameter set to true.
+ * @see Node#cloneTree
+ */
+public class DanglingReferenceException extends RuntimeException {
+
+ /**
+ * Create the exception object with default values.
+ */
+ public DanglingReferenceException() {
+ }
+
+ /**
+ * Create the exception object that outputs message.
+ * @param str the message string to be output.
+ */
+ public DanglingReferenceException(String str) {
+ super(str);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DecalGroup.java b/j3d-core/src/classes/share/javax/media/j3d/DecalGroup.java
new file mode 100644
index 0000000..d5b4595
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DecalGroup.java
@@ -0,0 +1,97 @@
+/*
+ * $RCSfile: DecalGroup.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+/**
+ * The DecalGroup node is an ordered group node used for defining decal
+ * geometry on top of other geometry. The DecalGroup node specifies that
+ * its children should be rendered in index order and that they generate
+ * coplanar objects. Examples of this include: painted decals or text on
+ * surfaces, a checkerboard layered on top of a table, etc.
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ DecalGroup dg = new DecalGroup();
+ dg.duplicateNode(this, forceDuplicate);
+ return dg;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DecalGroupRetained.java b/j3d-core/src/classes/share/javax/media/j3d/DecalGroupRetained.java
new file mode 100644
index 0000000..c5cc2c4
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DecalGroupRetained.java
@@ -0,0 +1,39 @@
+/*
+ * $RCSfile: DecalGroupRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+class DecalGroupRetained extends OrderedGroupRetained {
+
+ DecalGroupRetained() {
+ this.nodeType = NodeRetained.DECALGROUP;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DefaultRenderMethod.java b/j3d-core/src/classes/share/javax/media/j3d/DefaultRenderMethod.java
new file mode 100644
index 0000000..f631241
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DefaultRenderMethod.java
@@ -0,0 +1,90 @@
+/*
+ * $RCSfile: DefaultRenderMethod.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The RenderMethod interface is used to create various ways to render
+ * different geometries.
+ */
+
+class DefaultRenderMethod implements RenderMethod {
+
+ boolean geometryIsLocked = false;
+
+ /**
+ * The actual rendering code for this RenderMethod
+ */
+ public boolean render(RenderMolecule rm, Canvas3D cv,
+ RenderAtomListInfo ra, int dirtyBits) {
+
+ boolean isVisible = false; // True if any of the RAs is visible.
+
+ while (ra != null) {
+ if (cv.ra == ra.renderAtom) {
+ if (cv.raIsVisible) {
+ cv.updateState(dirtyBits);
+ ra.geometry().execute(cv, ra.renderAtom,
+ rm.isNonUniformScale,
+ rm.useAlpha, rm.alpha,
+ cv.screen.screen,
+ rm.textureBin.attributeBin.
+ ignoreVertexColors);
+ isVisible = true;
+ }
+ }
+ else {
+ if (!VirtualUniverse.mc.viewFrustumCulling ||
+ ra.renderAtom.localeVwcBounds.intersect(cv.viewFrustum)) {
+ cv.raIsVisible = true;
+ cv.updateState(dirtyBits);
+ ra.geometry().execute(cv, ra.renderAtom, rm.isNonUniformScale,
+ rm.useAlpha, rm.alpha,
+ cv.screen.screen,
+ rm.textureBin.attributeBin.
+ ignoreVertexColors);
+ isVisible = true;
+ }
+ else {
+ cv.raIsVisible = false;
+ }
+ cv.ra = ra.renderAtom;
+ }
+ ra = ra.next;
+ }
+
+ return isVisible;
+
+ }
+
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponent.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponent.java
new file mode 100644
index 0000000..df427af
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponent.java
@@ -0,0 +1,94 @@
+/*
+ * $RCSfile: DepthComponent.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Abstract base class that defines a 2D array of depth (Z) values.
+ */
+
+public abstract class DepthComponent extends NodeComponent {
+ /**
+ * Specifies that this DepthComponent object allows reading its
+ * size component information (width and height).
+ */
+ public static final int
+ ALLOW_SIZE_READ = CapabilityBits.DEPTH_COMPONENT_ALLOW_SIZE_READ;
+
+ /**
+ * Specifies that this DepthComponent object allows reading its
+ * depth data component information.
+ */
+ public static final int
+ ALLOW_DATA_READ = CapabilityBits.DEPTH_COMPONENT_ALLOW_DATA_READ;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_SIZE_READ,
+ ALLOW_DATA_READ
+ };
+
+ /**
+ * default constructor
+ */
+ DepthComponent() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Retrieves the width of this depth component object.
+ * @return the width of the array of depth values
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getWidth() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SIZE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("DepthComponent0"));
+ return ((DepthComponentRetained)this.retained).getWidth();
+ }
+
+ /**
+ * Retrieves the height of this depth component object.
+ * @return the height of the array of depth values
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getHeight() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SIZE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("DepthComponent0"));
+ return ((DepthComponentRetained)this.retained).getHeight();
+ }
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponentFloat.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentFloat.java
new file mode 100644
index 0000000..e47101f
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentFloat.java
@@ -0,0 +1,136 @@
+/*
+ * $RCSfile: DepthComponentFloat.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:20 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A 2D array of depth (Z) values in floating point format in the range [0,1].
+ * A value of 0.0 indicates the closest Z value to the user while a value of
+ * 1.0 indicates the farthest Z value.
+ */
+
+public class DepthComponentFloat extends DepthComponent {
+
+ /**
+ * Package scope defualt constructor used by cloneNodeComponent
+ */
+ DepthComponentFloat() {
+ }
+
+ /**
+ * Constructs a new floating-point depth (z-buffer) component object with
+ * the specified width and height.
+ * @param width the width of the array of depth values
+ * @param height the height of the array of depth values
+ */
+ public DepthComponentFloat(int width, int height) {
+ ((DepthComponentFloatRetained)this.retained).initialize(width, height);
+ }
+
+ /**
+ * Copies the specified depth data to this object.
+ * @param depthData array of floats containing the depth data
+ * @exception RestrictedAccessException if the method is called
+ * when this object is part of live or compiled scene graph.
+ */
+ public void setDepthData(float[] depthData) {
+ checkForLiveOrCompiled();
+ ((DepthComponentFloatRetained)this.retained).setDepthData(depthData);
+ }
+
+ /**
+ * Copies the depth data from this object to the specified array.
+ * The array must be large enough to hold all of the floats.
+ * @param depthData array of floats that will receive a copy of
+ * the depth data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDepthData(float[] depthData) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(DepthComponent.ALLOW_DATA_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("DepthComponentFloat0"));
+ ((DepthComponentFloatRetained)this.retained).getDepthData(depthData);
+ }
+
+ /**
+ * Creates a retained mode DepthComponentFloatRetained object that this
+ * DepthComponentFloat component object will point to.
+ */
+ void createRetained() {
+ this.retained = new DepthComponentFloatRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ DepthComponentFloatRetained rt = (DepthComponentFloatRetained) retained;
+ DepthComponentFloat d = new DepthComponentFloat(rt.width,
+ rt.height);
+ d.duplicateNodeComponent(this);
+ return d;
+ }
+
+
+ /**
+ * Copies all node information from originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent,
+ forceDuplicate);
+ // width, height is copied in cloneNode before
+ int len = getWidth()*getHeight();
+ float f[] = new float[len];
+
+ ((DepthComponentFloatRetained) originalNodeComponent.retained).getDepthData(f);
+ ((DepthComponentFloatRetained) retained).setDepthData(f);
+ }
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponentFloatRetained.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentFloatRetained.java
new file mode 100644
index 0000000..5afac54
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentFloatRetained.java
@@ -0,0 +1,93 @@
+/*
+ * $RCSfile: DepthComponentFloatRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+/**
+ * A 2D array of depth (Z) values in floating point format in the range [0,1].
+ * A value of 0.0 indicates the closest Z value to the user while a value of
+ * 1.0 indicates the farthest Z value.
+ */
+
+class DepthComponentFloatRetained extends DepthComponentRetained {
+ float depthData[];
+
+ /**
+ * Constructs a new floating-point depth (z-buffer) component object with
+ * the specified width and height.
+ * @param width the width of the array of depth values
+ * @param height the height of the array of depth values
+ */
+ void initialize(int width, int height) {
+ type = DEPTH_COMPONENT_TYPE_FLOAT;
+ depthData = new float[width * height];
+ this.width = width;
+ this.height = height;
+ }
+
+ /**
+ * Copies the specified depth data to this object.
+ * @param depthData array of floats containing the depth data
+ */
+ void setDepthData(float[] depthData) {
+ int i;
+ for (i = 0; i < depthData.length; i++)
+ this.depthData[i] = depthData[i];
+ }
+
+
+ /**
+ * Copies the depth data from this object to the specified array.
+ * @param depthData array of floats that will receive a copy of
+ * the depth data
+ */
+ void getDepthData(float[] depthData) {
+ int i;
+ for (i = 0; i < this.depthData.length; i++)
+ depthData[i] = this.depthData[i];
+ }
+
+ /*
+ * retrieve depth data from input buffer
+ */
+ final void retrieveDepth(float[] buf, int wRead, int hRead) {
+ int srcOffset, dstOffset, i;
+
+ // Yup -> Ydown
+ for (srcOffset = (hRead - 1) * wRead, dstOffset = 0,
+ i = 0; i < hRead; i++,
+ srcOffset -= wRead, dstOffset += width) {
+
+ System.arraycopy(buf, srcOffset, depthData, dstOffset, wRead);
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponentInt.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentInt.java
new file mode 100644
index 0000000..63c0338
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentInt.java
@@ -0,0 +1,134 @@
+/*
+ * $RCSfile: DepthComponentInt.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A 2D array of depth (Z) values in integer format. Values are in the
+ * range [0,(2**N)-1], where N is the pixel depth of the Z buffer.
+ */
+
+public class DepthComponentInt extends DepthComponent {
+
+ /**
+ * Package scope default constructor
+ */
+ DepthComponentInt() {
+ }
+
+ /**
+ * Constructs a new integer depth (z-buffer) component object with the
+ * specified width and height.
+ * @param width the width of the array of depth values
+ * @param height the height of the array of depth values
+ */
+ public DepthComponentInt(int width, int height) {
+ ((DepthComponentIntRetained)this.retained).initialize(width, height);
+ }
+
+ /**
+ * Copies the specified depth data to this object.
+ * @param depthData array of ints containing the depth data
+ * @exception RestrictedAccessException if the method is called
+ * when this object is part of live or compiled scene graph.
+ */
+ public void setDepthData(int[] depthData) {
+ checkForLiveOrCompiled();
+ ((DepthComponentIntRetained)this.retained).setDepthData(depthData);
+ }
+
+ /**
+ * Copies the depth data from this object to the specified array.
+ * The array must be large enough to hold all of the ints.
+ * @param depthData array of ints that will receive a copy of
+ * the depth data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDepthData(int[] depthData) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(DepthComponent.ALLOW_DATA_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("DepthComponentInt0"));
+ ((DepthComponentIntRetained)this.retained).getDepthData(depthData);
+ }
+
+ /**
+ * Creates a retained mode DepthComponentIntRetained object that this
+ * DepthComponentInt component object will point to.
+ */
+ void createRetained() {
+ this.retained = new DepthComponentIntRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ DepthComponentIntRetained rt = (DepthComponentIntRetained) retained;
+ DepthComponentInt d = new DepthComponentInt(rt.width,
+ rt.height);
+ d.duplicateNodeComponent(this);
+ return d;
+ }
+
+
+ /**
+ * Copies all node information from originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+
+ // width, height is copied in cloneNode before
+ int len = getWidth()*getHeight();
+ int d[] = new int[len];
+ ((DepthComponentIntRetained) originalNodeComponent.retained).getDepthData(d);
+ ((DepthComponentIntRetained) retained).setDepthData(d);
+ }
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponentIntRetained.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentIntRetained.java
new file mode 100644
index 0000000..1828e3d
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentIntRetained.java
@@ -0,0 +1,93 @@
+/*
+ * $RCSfile: DepthComponentIntRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+/**
+ * A 2D array of depth (Z) values in integer format. Values are in the
+ * range [0,(2**N)-1], where N is the pixel depth of the Z buffer.
+ */
+
+class DepthComponentIntRetained extends DepthComponentRetained {
+ int depthData[];
+
+ /**
+ * Constructs a new integer depth (z-buffer) component object with the
+ * specified width and height.
+ * @param width the width of the array of depth values
+ * @param height the height of the array of depth values
+ */
+ void initialize(int width, int height) {
+ type = DEPTH_COMPONENT_TYPE_INT;
+ depthData = new int[width * height];
+ this.width = width;
+ this.height = height;
+ }
+
+ /**
+ * Copies the specified depth data to this object.
+ * @param depthData array of ints containing the depth data
+ */
+ void setDepthData(int[] depthData) {
+ int i;
+ for (i = 0; i < depthData.length; i++)
+ this.depthData[i] = depthData[i];
+ }
+
+
+ /**
+ * Copies the depth data from this object to the specified array.
+ * @param depthData array of ints that will receive a copy of
+ * the depth data
+ */
+ void getDepthData(int[] depthData) {
+ int i;
+
+ for (i = 0; i < this.depthData.length; i++)
+ depthData[i] = this.depthData[i];
+ }
+
+ /**
+ * retrieve depth data from input buffer
+ */
+ final void retrieveDepth(int[] buf, int wRead, int hRead) {
+ int srcOffset, dstOffset, i;
+
+ // Yup -> Ydown
+ for (srcOffset = (hRead - 1) * wRead, dstOffset = 0,
+ i = 0; i < hRead; i++,
+ srcOffset -= wRead, dstOffset += width) {
+
+ System.arraycopy(buf, srcOffset, depthData, dstOffset, wRead);
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponentNative.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentNative.java
new file mode 100644
index 0000000..714fb0e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentNative.java
@@ -0,0 +1,126 @@
+/*
+ * $RCSfile: DepthComponentNative.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A 2D array of depth (Z) values stored in the most efficient format for a
+ * particular device. Values are not accessible by the user and may only be
+ * used to read the Z values and subsequently write them back.
+ */
+
+public class DepthComponentNative extends DepthComponent {
+ /**
+ * Package scope defualt constructor for use by cloneNodeComponent
+ */
+ DepthComponentNative() {
+ }
+
+ /**
+ * Constructs a new native depth (z-buffer) component object with the
+ * specified width and height.
+ * @param width the width of the array of depth values
+ * @param height the height of the array of depth values
+ */
+ public DepthComponentNative(int width, int height) {
+ ((DepthComponentNativeRetained)this.retained).initialize(width, height);
+ }
+
+ /**
+ * Copies the depth data from this object to the specified array.
+ * @param depthData array of ints that will receive a copy of
+ * the depth data
+ */
+ void getDepthData(int[] depthData) {
+ ((DepthComponentNativeRetained)this.retained).getDepthData(depthData);
+ }
+
+ /**
+ * Creates a retained mode DepthComponentIntRetained object that this
+ * DepthComponentInt component object will point to.
+ */
+ void createRetained() {
+ this.retained = new DepthComponentNativeRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Creates a new DepthComponentNative object. Called from a Leaf node's
+ * duplicateNode method.
+ *
+ * @return a duplicate of the DepthComponentNative object.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public NodeComponent cloneNodeComponent() {
+ DepthComponentNativeRetained rt = (DepthComponentNativeRetained) retained;
+ DepthComponentNative d = new DepthComponentNative(rt.width,
+ rt.height);
+ d.duplicateNodeComponent(this);
+ return d;
+ }
+
+
+ /**
+ * Copies all node information from originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+
+ int originalData[] = ((DepthComponentNativeRetained)
+ originalNodeComponent.retained).depthData;
+
+ int currentData[] = ((DepthComponentNativeRetained) retained).depthData;
+
+ if (originalData != null) {
+ for (int i=0; i < originalData.length; i++)
+ currentData[i] = originalData[i];
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponentNativeRetained.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentNativeRetained.java
new file mode 100644
index 0000000..4cbaec6
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentNativeRetained.java
@@ -0,0 +1,82 @@
+/*
+ * $RCSfile: DepthComponentNativeRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A 2D array of depth (Z) values stored in the most efficient format for a
+ * particular device. Values are not accessible by the user and may only be
+ * used to read the Z values and subsequently write them back.
+ */
+
+class DepthComponentNativeRetained extends DepthComponentRetained {
+ // Change this to whatever native format is best...
+ int depthData[];
+
+ /**
+ * Constructs a new native depth (z-buffer) component object with the
+ * specified width and height.
+ * @param width the width of the array of depth values
+ * @param height the height of the array of depth values
+ */
+ void initialize(int width, int height) {
+ type = DEPTH_COMPONENT_TYPE_NATIVE;
+ depthData = new int[width * height];
+ this.width = width;
+ this.height = height;
+ }
+
+ /**
+ * Copies the depth data from this object to the specified array.
+ * @param depthData array of ints that will receive a copy of
+ * the depth data
+ */
+ void getDepthData(int[] depthData) {
+ int i;
+ for (i = 0; i < this.depthData.length; i++)
+ depthData[i] = this.depthData[i];
+ }
+
+ /**
+ * retrieve depth data from input buffer
+ */
+ final void retrieveDepth(int[] buf, int wRead, int hRead) {
+ int srcOffset, dstOffset, i;
+
+ // Yup -> Ydown
+ for (srcOffset = (hRead - 1) * wRead, dstOffset = 0,
+ i = 0; i < hRead; i++,
+ srcOffset -= wRead, dstOffset += width) {
+
+ System.arraycopy(buf, srcOffset, depthData, dstOffset, wRead);
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DepthComponentRetained.java b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentRetained.java
new file mode 100644
index 0000000..1e9c008
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DepthComponentRetained.java
@@ -0,0 +1,67 @@
+/*
+ * $RCSfile: DepthComponentRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Abstract base class that defines a 2D array of depth (Z) values.
+ */
+
+
+abstract class DepthComponentRetained extends NodeComponentRetained {
+ // depth component types
+ static final int DEPTH_COMPONENT_TYPE_INT = 1;
+ static final int DEPTH_COMPONENT_TYPE_FLOAT = 2;
+ static final int DEPTH_COMPONENT_TYPE_NATIVE = DEPTH_COMPONENT_TYPE_INT;
+
+
+ // Width and height of DepthComponent---set by subclasses
+ int width;
+ int height;
+ int type;
+
+ /**
+ * Retrieves the width of this depth component object
+ * @return the width of the array of depth values
+ */
+ int getWidth() {
+ return width;
+ }
+
+ /**
+ * Retrieves the height of this depth component object
+ * @return the height of the array of depth values
+ */
+ int getHeight() {
+ return height;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DirectionalLight.java b/j3d-core/src/classes/share/javax/media/j3d/DirectionalLight.java
new file mode 100644
index 0000000..47def94
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DirectionalLight.java
@@ -0,0 +1,222 @@
+/*
+ * $RCSfile: DirectionalLight.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+import javax.vecmath.Vector3f;
+
+/**
+ * A DirectionalLight node defines an oriented light with an origin at
+ * infinity. It has the same attributes as a Light node, with the
+ * addition of a directional vector to specify the direction in which the
+ * light shines. A directional light has parallel light rays that travel
+ * in one direction along the specified vector. Directional light contributes
+ * to diffuse and specular reflections, which in turn depend on the
+ * orientation of an object's surface but not its position. A directional
+ * light does not contribute to ambient reflections.
+ */
+
+public class DirectionalLight extends Light {
+ /**
+ * Specifies that the Node allows access to its object's direction
+ * information.
+ */
+ public static final int
+ ALLOW_DIRECTION_READ = CapabilityBits.DIRECTIONAL_LIGHT_ALLOW_DIRECTION_READ;
+
+ /**
+ * Specifies that the Node allows writing to its object's direction
+ * information.
+ */
+ public static final int
+ ALLOW_DIRECTION_WRITE = CapabilityBits.DIRECTIONAL_LIGHT_ALLOW_DIRECTION_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_DIRECTION_READ
+ };
+
+ /**
+ * Constructs a DirectionalLight node with default parameters.
+ * The default values are as follows:
+ *
+ * direction : (0,0,-1)
+ */
+ public DirectionalLight() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs and initializes a directional light.
+ * @param color the color of the light source
+ * @param direction the direction vector pointing from the light
+ * to the object
+ */
+ public DirectionalLight(Color3f color, Vector3f direction) {
+ super(color);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((DirectionalLightRetained)this.retained).initDirection(direction);
+ }
+
+ /**
+ * Constructs and initializes a directional light.
+ * @param lightOn flag indicating whether this light is on or off
+ * @param color the color of the light source
+ * @param direction the direction vector pointing from the light
+ * to the object
+ */
+ public DirectionalLight(boolean lightOn, Color3f color, Vector3f direction) {
+ super(lightOn, color);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((DirectionalLightRetained)this.retained).initDirection(direction);
+ }
+
+ /**
+ * Creates the retained mode DirectionalLightRetained object that this
+ * DirectionalLight component object will point to.
+ */
+ void createRetained() {
+ this.retained = new DirectionalLightRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Set light direction.
+ * @param direction the new direction
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDirection(Vector3f direction) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DIRECTION_WRITE))
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("DirectionalLight0"));
+
+ if (isLive())
+ ((DirectionalLightRetained)this.retained).setDirection(direction);
+ else
+ ((DirectionalLightRetained)this.retained).initDirection(direction);
+ }
+
+ /**
+ * Set light direction.
+ * @param x the new X direction
+ * @param y the new Y direction
+ * @param z the new Z direction
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDirection(float x, float y, float z) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DIRECTION_WRITE))
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("DirectionalLight1"));
+
+ if (isLive())
+ ((DirectionalLightRetained)this.retained).setDirection(x,y,z);
+ else
+ ((DirectionalLightRetained)this.retained).initDirection(x,y,z);
+ }
+
+ /**
+ * Gets this Light's current direction and places it in the parameter specified.
+ * @param direction the vector that will receive this node's direction
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDirection(Vector3f direction) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DIRECTION_READ))
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("DirectionalLight2"));
+
+ ((DirectionalLightRetained)this.retained).getDirection(direction);
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ DirectionalLight d = new DirectionalLight();
+ d.duplicateNode(this, forceDuplicate);
+ return d;
+ }
+
+
+ /**
+ * Copies all DirectionalLight information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ Vector3f v = new Vector3f();
+ ((DirectionalLightRetained) originalNode.retained).getDirection(v);
+ ((DirectionalLightRetained) retained).initDirection(v);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DirectionalLightRetained.java b/j3d-core/src/classes/share/javax/media/j3d/DirectionalLightRetained.java
new file mode 100644
index 0000000..57274b0
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DirectionalLightRetained.java
@@ -0,0 +1,220 @@
+/*
+ * $RCSfile: DirectionalLightRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+
+/**
+ * An infinite directional light source object.
+ */
+
+class DirectionalLightRetained extends LightRetained
+{
+ static final int DIRECTION_CHANGED = LAST_DEFINED_BIT << 1;
+
+ // The direction in which this light source is pointing.
+ Vector3f direction = new Vector3f(0.0f, 0.0f, -1.0f);
+
+ // The transformed direction
+ Vector3f xformDirection = new Vector3f(0.0f, 0.0f, -1.0f);
+
+ DirectionalLightRetained() {
+ this.nodeType = NodeRetained.DIRECTIONALLIGHT;
+ lightType = 2;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ /**
+ * Initializes this light's direction from the vector provided.
+ * @param direction the new direction
+ */
+ void initDirection(Vector3f direction) {
+ this.direction.set(direction);
+ if (staticTransform != null) {
+ staticTransform.transform.transform(
+ this.direction, this.direction);
+ }
+ }
+
+ /**
+ * Sets this light's direction from the vector provided.
+ * and sends a message
+ * @param direction the new direction
+ */
+ void setDirection(Vector3f direction) {
+ initDirection(direction);
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.type = J3dMessage.LIGHT_CHANGED;
+ createMessage.universe = universe;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(DIRECTION_CHANGED);
+ if (inSharedGroup)
+ createMessage.args[2] = new Integer(numMirrorLights);
+ else
+ createMessage.args[2] = new Integer(1);
+ createMessage.args[3] = mirrorLights.clone();
+ createMessage.args[4] = new Vector3f(direction);
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ }
+
+
+ /**
+ * Initializes this light's direction from the three values provided.
+ * @param x the new x direction
+ * @param y the new y direction
+ * @param z the new z direction
+ */
+ void initDirection(float x, float y, float z) {
+ this.direction.x = x;
+ this.direction.y = y;
+ this.direction.z = z;
+
+ if (staticTransform != null) {
+ staticTransform.transform.transform(
+ this.direction, this.direction);
+ }
+ }
+
+ /**
+ * Sets this light's direction from the three values provided.
+ * @param x the new x direction
+ * @param y the new y direction
+ * @param z the new z direction
+ */
+ void setDirection(float x, float y, float z) {
+ setDirection(new Vector3f(x, y, z));
+ }
+
+
+ /**
+ * Retrieves this light's direction and places it in the
+ * vector provided.
+ * @param direction the variable to receive the direction vector
+ */
+ void getDirection(Vector3f direction) {
+ direction.set(this.direction);
+ if (staticTransform != null) {
+ Transform3D invTransform = staticTransform.getInvTransform();
+ invTransform.transform(direction, direction);
+ }
+ }
+
+
+
+ void setLive(SetLiveState s) {
+ super.setLive(s);
+ J3dMessage createMessage = super.initMessage(8);
+ Object[] objs = (Object[])createMessage.args[4];
+ objs[7] = new Vector3f(direction);
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ }
+
+ /**
+ * This update function, and its native counterpart,
+ * updates a directional light. This includes its
+ * color and its transformed direction.
+ */
+ // Note : if you add any more fields here , you need to update
+ // updateLight() in RenderingEnvironmentStructure
+ void updateMirrorObject(Object[] objs) {
+ int i;
+ int component = ((Integer)objs[1]).intValue();
+ Transform3D trans;
+ int numLgts = ((Integer)objs[2]).intValue();
+
+ LightRetained[] mLgts = (LightRetained[]) objs[3];
+ DirectionalLightRetained ml;
+ if ((component & DIRECTION_CHANGED) != 0) {
+
+ for (i = 0; i < numLgts; i++) {
+ if (mLgts[i].nodeType == NodeRetained.DIRECTIONALLIGHT) {
+ ml = (DirectionalLightRetained) mLgts[i];
+ ml.direction = (Vector3f)objs[4];
+ ml.getLastLocalToVworld().transform(ml.direction,
+ ml.xformDirection);
+ ml.xformDirection.normalize();
+ }
+ }
+ }
+
+ if ((component & INIT_MIRROR) != 0) {
+ for (i = 0; i < numLgts; i++) {
+ if (mLgts[i].nodeType == NodeRetained.DIRECTIONALLIGHT) {
+ ml = (DirectionalLightRetained) mLgts[i];
+ ml.direction = (Vector3f)((Object[])objs[4])[7];
+ ml.getLastLocalToVworld().transform(ml.direction,
+ ml.xformDirection);
+ ml.xformDirection.normalize();
+ }
+ }
+ }
+ // call the parent's mirror object update routine
+ super.updateMirrorObject(objs);
+ }
+
+
+ void update(Context ctx, int lightSlot, double scale) {
+ Pipeline.getPipeline().updateDirectionalLight(ctx,
+ lightSlot, color.x, color.y, color.z,
+ xformDirection.x, xformDirection.y,
+ xformDirection.z);
+ }
+
+ // Clones only the retained side, internal use only
+ protected Object clone() {
+ DirectionalLightRetained dr =
+ (DirectionalLightRetained)super.clone();
+ dr.direction = new Vector3f(direction);
+ dr.xformDirection = new Vector3f(0.0f, 0.0f, -1.0f);
+ return dr;
+ }
+
+
+ // Called on the mirror object
+ void updateTransformChange() {
+ super.updateTransformChange();
+
+ getLastLocalToVworld().transform(direction, xformDirection);
+ xformDirection.normalize();
+
+ }
+
+ void mergeTransform(TransformGroupRetained xform) {
+ super.mergeTransform(xform);
+ xform.transform.transform(direction, direction);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DisplayListRenderMethod.java b/j3d-core/src/classes/share/javax/media/j3d/DisplayListRenderMethod.java
new file mode 100644
index 0000000..6811067
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DisplayListRenderMethod.java
@@ -0,0 +1,273 @@
+/*
+ * $RCSfile: DisplayListRenderMethod.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The RenderMethod interface is used to create various ways to render
+ * different geometries.
+ */
+
+class DisplayListRenderMethod implements RenderMethod {
+
+ /**
+ * display list buffer size
+ */
+ final int bufferSize = 128;
+
+ /**
+ * display list buffer
+ */
+ int[] buffer = new int[bufferSize];
+
+ /**
+ * The actual rendering code for this RenderMethod
+ */
+ public boolean render(RenderMolecule rm, Canvas3D cv,
+ RenderAtomListInfo ra,
+ int dirtyBits) {
+
+ if (rm.doInfinite ||
+ !VirtualUniverse.mc.viewFrustumCulling ||
+ rm.vwcBounds.intersect(cv.viewFrustum)) {
+ cv.updateState(dirtyBits);
+ cv.callDisplayList(cv.ctx, rm.displayListId,
+ rm.isNonUniformScale);
+ return true;
+ }
+ return false;
+ }
+
+ public boolean renderSeparateDlists(RenderMolecule rm,
+ Canvas3D cv,
+ RenderAtomListInfo r, int dirtyBits) {
+
+ if (rm.doInfinite) {
+ cv.updateState(dirtyBits);
+ while (r != null) {
+ cv.callDisplayList(cv.ctx,
+ ((GeometryArrayRetained)r.geometry()).dlistId,
+ rm.isNonUniformScale);
+ r = r.next;
+ }
+
+ return true;
+ }
+
+ boolean isVisible = false; // True if any of the RAs is visible.
+ while (r != null) {
+ if (cv.ra == r.renderAtom) {
+ if (cv.raIsVisible) {
+ cv.updateState(dirtyBits);
+ cv.callDisplayList(cv.ctx,
+ ((GeometryArrayRetained)r.geometry()).dlistId,
+ rm.isNonUniformScale);
+ isVisible = true;
+ }
+ }
+ else {
+ if (r.renderAtom.localeVwcBounds.intersect(cv.viewFrustum)) {
+ cv.updateState(dirtyBits);
+ cv.raIsVisible = true;
+ cv.callDisplayList(cv.ctx,
+ ((GeometryArrayRetained)r.geometry()).dlistId,
+ rm.isNonUniformScale);
+ isVisible = true;
+ }
+ else {
+ cv.raIsVisible = false;
+ }
+ cv.ra = r.renderAtom;
+ }
+ r = r.next;
+ }
+
+ return isVisible;
+ }
+
+
+
+ public boolean renderSeparateDlistPerRinfo(RenderMolecule rm,
+ Canvas3D cv,
+ RenderAtomListInfo r,
+ int dirtyBits) {
+
+ if (rm.doInfinite) {
+ cv.updateState(dirtyBits);
+ while (r != null) {
+ cv.callDisplayList(cv.ctx,r.renderAtom.dlistIds[r.index],
+ rm.isNonUniformScale);
+ r = r.next;
+ }
+ return true;
+ }
+ boolean isVisible = false; // True if any of the RAs is visible.
+ while (r != null) {
+ if (cv.ra == r.renderAtom) {
+ if (cv.raIsVisible) {
+ cv.updateState(dirtyBits);
+ cv.callDisplayList(cv.ctx, r.renderAtom.dlistIds[r.index],
+ rm.isNonUniformScale);
+ isVisible = true;
+ }
+ }
+ else {
+ if (r.renderAtom.localeVwcBounds.intersect(cv.viewFrustum)) {
+ cv.updateState(dirtyBits);
+ cv.raIsVisible = true;
+ cv.callDisplayList(cv.ctx, r.renderAtom.dlistIds[r.index],
+ rm.isNonUniformScale);
+ isVisible = true;
+ }
+ else {
+ cv.raIsVisible = false;
+ }
+ cv.ra = r.renderAtom;
+ }
+ r = r.next;
+ }
+ return isVisible;
+
+ }
+
+
+
+
+ void buildDisplayList(RenderMolecule rm, Canvas3D cv) {
+ RenderAtomListInfo ra;
+ boolean useAlpha;
+ GeometryArrayRetained geo;
+ useAlpha = rm.useAlpha;
+ Transform3D staticTransform;
+ Transform3D staticNormalTransform;
+
+ if ((rm.primaryRenderAtomList != null) &&
+ (rm.texCoordSetMapLen <= cv.maxTexCoordSets)) {
+
+ cv.newDisplayList(cv.ctx, rm.displayListId);
+
+ ra = rm.primaryRenderAtomList;
+
+ while (ra != null) {
+ geo = (GeometryArrayRetained)ra.geometry();
+ if (ra.renderAtom.geometryAtom.source.staticTransform == null) {
+ staticTransform = null;
+ staticNormalTransform = null;
+ } else {
+ staticTransform =
+ ra.renderAtom.geometryAtom.source.staticTransform.transform;
+ if ((geo.vertexFormat & GeometryArray.NORMALS) != 0) {
+ staticNormalTransform =
+ ra.renderAtom.geometryAtom.source.staticTransform.getNormalTransform();
+ } else {
+ staticNormalTransform = null;
+ }
+ }
+ geo.buildGA(cv, ra.renderAtom, false,
+ (useAlpha &&
+ ((geo.vertexFormat & GeometryArray.COLOR) != 0)),
+ rm.alpha,
+ rm.textureBin.attributeBin.ignoreVertexColors,
+ staticTransform,
+ staticNormalTransform);
+ ra = ra.next;
+ }
+ cv.endDisplayList(cv.ctx);
+ }
+ }
+
+ void buildIndividualDisplayList(RenderAtomListInfo ra, Canvas3D cv,
+ Context ctx) {
+ GeometryArrayRetained geo;
+
+ geo = (GeometryArrayRetained)ra.geometry();
+ if ((geo.texCoordSetMap != null) &&
+ (geo.texCoordSetMap.length > cv.maxTexCoordSets)) {
+ return;
+ }
+
+ // Note, the dlistId does not change when renderer is building
+ cv.newDisplayList(ctx, geo.dlistId);
+
+ // No need to lock when it is indexed geometry since we have
+ // our own copy
+ // Note individual dlist is only created if alpha is not modifiable
+ // so, we don't need any renderMolecule specific information
+ geo.buildGA(cv, ra.renderAtom, false,
+ false,
+ 1.0f,
+ false,
+ null, null);
+ cv.endDisplayList(ctx);
+ }
+
+ void buildDlistPerRinfo(RenderAtomListInfo ra, RenderMolecule rm, Canvas3D cv) {
+ boolean useAlpha;
+ GeometryArrayRetained geo;
+ useAlpha = rm.useAlpha;
+ Transform3D staticTransform;
+ Transform3D staticNormalTransform;
+ int id;
+
+ geo = (GeometryArrayRetained)ra.geometry();
+ if ((rm.primaryRenderAtomList != null) &&
+ (rm.texCoordSetMapLen <= cv.maxTexCoordSets)) {
+
+ id = ra.renderAtom.dlistIds[ra.index];
+ cv.newDisplayList(cv.ctx, id);
+ geo = (GeometryArrayRetained)ra.geometry();
+ if (ra.renderAtom.geometryAtom.source.staticTransform == null) {
+ staticTransform = null;
+ staticNormalTransform = null;
+ } else {
+ staticTransform =
+ ra.renderAtom.geometryAtom.source.staticTransform.transform;
+ if ((geo.vertexFormat & GeometryArray.NORMALS) != 0) {
+ staticNormalTransform =
+ ra.renderAtom.geometryAtom.source.staticTransform.getNormalTransform();
+ } else {
+ staticNormalTransform = null;
+ }
+ }
+
+ geo.buildGA(cv, ra.renderAtom, false,
+ (useAlpha &&
+ ((geo.vertexFormat & GeometryArray.COLOR) != 0)),
+ rm.alpha,
+ rm.textureBin.attributeBin.ignoreVertexColors,
+ staticTransform,
+ staticNormalTransform);
+ cv.endDisplayList(cv.ctx);
+ }
+
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DistanceLOD.java b/j3d-core/src/classes/share/javax/media/j3d/DistanceLOD.java
new file mode 100644
index 0000000..775d7b3
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DistanceLOD.java
@@ -0,0 +1,310 @@
+/*
+ * $RCSfile: DistanceLOD.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Point3f;
+import java.util.Enumeration;
+
+/**
+ * This class defines a distance-based LOD behavior node that operates on
+ * a Switch group node to select one of the children of that Switch node
+ * based on the distance of this LOD node from the viewer.
+ * An array of n monotonically increasing distance values is
+ * specified, such that distances[0] is associated with the highest level of
+ * detail and distances[n-1] is associated with the lowest level of
+ * detail. Based on the actual distance from the viewer to
+ * this DistanceLOD node, these n
+ * distance values [0, n-1] select from among n+1
+ * levels of detail [0, n]. If d is the distance from
+ * the viewer to the LOD node, then the equation for determining
+ * which level of detail (child of the Switch node) is selected is:
+ *
+ * 0, if d <= distances[0]
+ *
+ *
+ * i, if distances[i-1] < d <= distances[i]
+ *
+ * n, if d > distances[n-1]
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ DistanceLOD d = new DistanceLOD();
+ d.duplicateNode(this, forceDuplicate);
+ return d;
+ }
+
+
+ /**
+ * Copies all DistanceLOD information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ DistanceLOD lod = (DistanceLOD) originalNode;
+
+ int numD = lod.numDistances();
+
+ // No API available to set the size of this array after initialize
+ this.distances = new double[numD];
+
+ for (int i = 0; i < numD; i++)
+ setDistance(i, lod.getDistance(i));
+
+ Point3f p = new Point3f();
+ lod.getPosition(p);
+ setPosition(p);
+ }
+
+ void mergeTransform(TransformGroupRetained xform) {
+ xform.transform.transform(position, position);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Drawable.java b/j3d-core/src/classes/share/javax/media/j3d/Drawable.java
new file mode 100644
index 0000000..bb531a9
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Drawable.java
@@ -0,0 +1,41 @@
+/*
+ * $RCSfile: Drawable.java,v $
+ *
+ * Copyright 2006-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.
+ *
+ * $Revision: 1.4 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Tagging interface for drawable (window) objects. The rendering pipelines
+ * will define concrete classes that implement this interface. All code that
+ * uses the tagged objects will be in the pipelines.
+ */
+interface Drawable {
+ // No methods or constants defined at this time
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DrawingSurfaceObject.java b/j3d-core/src/classes/share/javax/media/j3d/DrawingSurfaceObject.java
new file mode 100644
index 0000000..f7063bc
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DrawingSurfaceObject.java
@@ -0,0 +1,61 @@
+/*
+ * $RCSfile: DrawingSurfaceObject.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The DrawingSurfaceObject class is used to manage native drawing surface
+ */
+
+abstract class DrawingSurfaceObject extends Object {
+
+ Canvas3D canvas;
+ boolean gotDsiLock = false;
+ boolean onScreen;
+
+ abstract boolean renderLock();
+ abstract void unLock();
+ abstract void getDrawingSurfaceObjectInfo();
+ abstract void invalidate();
+
+ DrawingSurfaceObject(Canvas3D cv) {
+ canvas = cv;
+ onScreen = !cv.offScreen;
+ }
+
+ synchronized boolean isLocked() {
+ return gotDsiLock;
+ }
+
+ synchronized void contextValidated() {
+ canvas.validCtx = true;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/DrawingSurfaceObjectAWT.java b/j3d-core/src/classes/share/javax/media/j3d/DrawingSurfaceObjectAWT.java
new file mode 100644
index 0000000..ccdb8b9
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/DrawingSurfaceObjectAWT.java
@@ -0,0 +1,170 @@
+/*
+ * $RCSfile: DrawingSurfaceObjectAWT.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.Point;
+
+/**
+ * The DrawingSurfaceObject class is used to manage native drawing surface
+ */
+
+class DrawingSurfaceObjectAWT extends DrawingSurfaceObject {
+
+ // drawing surface
+ private long nativeDS = 0;
+ private long dsi = 0;
+
+ private boolean doLastUnlock = false;
+ private boolean xineramaDisabled = false;
+
+ private long display = 0;
+ private int screenID = 0;
+
+ private static long nativeAWT = 0;
+
+ private native boolean lockAWT(long ds);
+ private native void unlockAWT(long ds);
+ private static native void lockGlobal(long awt);
+ private static native void unlockGlobal(long awt);
+ private native long getDrawingSurfaceAWT(Canvas3D cv, long awt);
+ private native long getDrawingSurfaceInfo(long ds);
+ private static native void freeResource(long awt, long ds, long dsi);
+
+ // TODO: long window
+ private native int getDrawingSurfaceWindowIdAWT(Canvas3D cv, long ds, long dsi,
+ long display, int screenID,
+ boolean xineramaDisabled);
+
+ DrawingSurfaceObjectAWT(Canvas3D cv, long awt,
+ long display, int screenID,
+ boolean xineramaDisabled) {
+ super(cv);
+ nativeAWT = awt;
+
+ this.display = display;
+ this.screenID = screenID;
+ this.xineramaDisabled = xineramaDisabled;
+ }
+
+ synchronized boolean renderLock() {
+
+ if (onScreen) {
+ if (nativeDS == 0) {
+ return false;
+ } else {
+ if (lockAWT(nativeDS)) {
+ gotDsiLock = true;
+ return true;
+ } else {
+ return false;
+ }
+ }
+ } else {
+ gotDsiLock = true;
+ lockGlobal(nativeAWT);
+ }
+ return true;
+ }
+
+ synchronized void unLock() {
+
+ if (gotDsiLock) {
+ if (onScreen) {
+ if (nativeDS != 0) {
+ unlockAWT(nativeDS);
+ gotDsiLock = false;
+ if (doLastUnlock) {
+ nativeDS = 0;
+ dsi = 0;
+ doLastUnlock = false;
+ }
+ }
+ } else {
+ unlockGlobal(nativeAWT);
+ gotDsiLock = false;
+ }
+ }
+ }
+
+
+ synchronized void getDrawingSurfaceObjectInfo() {
+ // Free old DS and DSI
+ if (nativeDS != 0 && dsi != 0) {
+ freeResource(nativeAWT, nativeDS, dsi);
+ nativeDS = 0;
+ dsi = 0;
+ }
+
+ // get native drawing surface - ds
+ nativeDS = getDrawingSurfaceAWT(canvas, nativeAWT);
+
+ // get window id
+ if (nativeDS != 0) {
+ dsi = getDrawingSurfaceInfo(nativeDS);
+ if (dsi != 0) {
+ long nativeDrawable = getDrawingSurfaceWindowIdAWT
+ (canvas, nativeDS, dsi, display, screenID,
+ xineramaDisabled);
+ canvas.drawable = new NativeDrawable(nativeDrawable);
+ }
+ }
+ }
+
+
+ synchronized void invalidate() {
+ if (gotDsiLock && (nativeDS != 0)) {
+ // Should not call unlock in AWT thread
+ // Otherwise IllegalMonitorException will throw
+ // unlockAWT(nativeDS);
+ // We don't reset nativeDS & dsi to 0 here.
+ // This allow Renderer to continue unLock.
+ doLastUnlock = true;
+ } else {
+ nativeDS = 0;
+ dsi = 0;
+ }
+ }
+
+ static void freeDrawingSurface(Object obj) {
+ long p[] = (long[]) obj;
+ freeResource(nativeAWT, p[0], p[1]);
+ }
+
+ long getDSI() {
+ return dsi;
+ }
+
+ long getDS() {
+ return nativeDS;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/EnvironmentSet.java b/j3d-core/src/classes/share/javax/media/j3d/EnvironmentSet.java
new file mode 100644
index 0000000..1bcbc36
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/EnvironmentSet.java
@@ -0,0 +1,557 @@
+/*
+ * $RCSfile: EnvironmentSet.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.*;
+
+/**
+ * The LightBin manages a collection of EnvironmentSet objects.
+ * The number of objects managed depends upon the number of Lights
+ * in each EnvironmentSet and the number of lights supported by
+ * the underlying rendering layer.
+ */
+
+class EnvironmentSet extends Object implements ObjectUpdate{
+ // A list of pre-defined bits to indicate which component
+ // of the rendermolecule changed
+ static final int LIGHTENABLE_CHANGED = 0x01;
+ static final int AMBIENT_CHANGED = 0x02;
+ static final int FOG_CHANGED = 0x04;
+ static final int MODELCLIP_CHANGED = 0x08;
+
+ /**
+ * The ArrayList of Lights in this EnvironmentSet
+ */
+ ArrayList lights = new ArrayList();
+
+ /**
+ * The position of the light in the lightbin that the
+ * lights in this environment set corresponds to
+ */
+ int[] ltPos = null;
+
+
+ /**
+ * The arraylist of ambient lights in this env list
+ */
+ ArrayList ambLights = new ArrayList();
+
+ /**
+ * The LightBin that this EnvironmentSet resides
+ */
+ LightBin lightBin = null;
+
+ /**
+ * The bitmask of light slots that need to be enabled for this
+ */
+ long enableMask = 0;
+
+ /**
+ * The cached scene ambient component for this EnvirionmentSet
+ */
+ Color3f sceneAmbient = new Color3f();
+
+ /**
+ * The RenderBin for this EnvirionmentSet
+ */
+ RenderBin renderBin = null;
+
+ /**
+ * The fog for this EnvironmentSet
+ */
+ FogRetained fog = null;
+
+
+ /**
+ * The model clip for this EnvironmentSet
+ */
+ ModelClipRetained modelClip = null;
+
+ /**
+ * enable mask for the model clip planes in this environment set
+ */
+ int enableMCMask = 0; // enable mask used in modelClip.update()
+ int enableMCMaskCache = 0; // enable mask computed in renderBin that
+ // is copied into enableMCMask in updateObject
+
+ /**
+ * The references to the next and previous LightBins in the
+ * list.
+ */
+ EnvironmentSet next = null;
+ EnvironmentSet prev = null;
+
+ /**
+ * List of attrributeBins to be added next Frame
+ */
+ ArrayList addAttributeBins = new ArrayList();
+
+
+ /**
+ * Canvas Dirty Mask for
+ */
+ int canvasDirty = 0;
+
+ /**
+ * cached value of enable mask
+ */
+ long enableMaskCache = 0;
+
+ /**
+ *
+ */
+ boolean onUpdateList = false;
+
+ /**
+ * The list of AttributeBins in this EnvironmentSet
+ */
+ AttributeBin attributeBinList = null;
+
+ EnvironmentSet(RenderAtom ra, LightRetained[] lightList, FogRetained fog,
+ ModelClipRetained modelClip, RenderBin rb) {
+ renderBin = rb;
+ reset(ra, lightList, fog, modelClip);
+ }
+
+ private void reset(RenderAtom ra, LightRetained[] lightList, FogRetained fog,
+ ModelClipRetained modelClip) {
+ int i;
+ LightRetained light;
+
+ prev = null;
+ next = null;
+ onUpdateList = false;
+ attributeBinList = null;
+ lights.clear();
+ ambLights.clear();
+ sceneAmbient.x = 0.0f;
+ sceneAmbient.y = 0.0f;
+ sceneAmbient.z = 0.0f;
+ if (lightList != null) {
+ for (i=0; i
+ * f = e-(density * z)
+ *
+ * In addition to specifying the fog density, ExponentialFog lets you
+ * specify the fog color, which is represented by R, G, and B
+ * color values, where a color of (0,0,0) represents black.
+ */
+public class ExponentialFog extends Fog {
+ /**
+ * Specifies that this ExponentialFog node allows read access to its
+ * density information.
+ */
+ public static final int
+ ALLOW_DENSITY_READ = CapabilityBits.EXPONENTIAL_FOG_ALLOW_DENSITY_READ;
+
+ /**
+ * Specifies that this ExponentialFog node allows write access to its
+ * density information.
+ */
+ public static final int
+ ALLOW_DENSITY_WRITE = CapabilityBits.EXPONENTIAL_FOG_ALLOW_DENSITY_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_DENSITY_READ
+ };
+
+ /**
+ * Constructs an ExponentialFog node with default parameters.
+ * The default values are as follows:
+ * z is the distance from the viewpoint.
+ * density is the density of the fog.
+ * density : 1.0
+ */
+ public ExponentialFog() {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs an ExponentialFog node with the specified fog color.
+ * @param color the fog color
+ */
+ public ExponentialFog(Color3f color) {
+ super(color);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs an ExponentialFog node with the specified fog color
+ * and density.
+ * @param color the fog color
+ * @param density the density of the fog
+ */
+ public ExponentialFog(Color3f color, float density) {
+ super(color);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ExponentialFogRetained)this.retained).initDensity(density);
+ }
+
+ /**
+ * Constructs an ExponentialFog node with the specified fog color.
+ * @param r the red component of the fog color
+ * @param g the green component of the fog color
+ * @param b the blue component of the fog color
+ */
+ public ExponentialFog(float r, float g, float b) {
+ super(r, g, b);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs an ExponentialFog node with the specified fog color
+ * and density.
+ * @param r the red component of the fog color
+ * @param g the green component of the fog color
+ * @param b the blue component of the fog color
+ * @param density the density of the fog
+ */
+ public ExponentialFog(float r, float g, float b, float density) {
+ super(r, g, b);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ExponentialFogRetained)this.retained).initDensity(density);
+ }
+
+ /**
+ * Sets fog density.
+ * @param density the new density of this fog
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setDensity(float density) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DENSITY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ExponentialFog0"));
+
+ if (isLive())
+ ((ExponentialFogRetained)this.retained).setDensity(density);
+ else
+ ((ExponentialFogRetained)this.retained).initDensity(density);
+ }
+
+ /**
+ * Gets fog density.
+ * @return the density of this fog
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getDensity() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DENSITY_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ExponentialFog1"));
+
+ return ((ExponentialFogRetained)this.retained).getDensity();
+ }
+
+ /**
+ * Creates the retained mode ExponentialFogRetained object that this
+ * ExponentialFog node will point to.
+ */
+ void createRetained() {
+ this.retained = new ExponentialFogRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ ExponentialFog ef = new ExponentialFog();
+ ef.duplicateNode(this, forceDuplicate);
+ return ef;
+ }
+
+
+ /**
+ * Copies all ExponentialFog information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ ((ExponentialFogRetained) retained).initDensity(
+ ((ExponentialFogRetained) originalNode.retained).getDensity());
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ExponentialFogRetained.java b/j3d-core/src/classes/share/javax/media/j3d/ExponentialFogRetained.java
new file mode 100644
index 0000000..6d8d29c
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ExponentialFogRetained.java
@@ -0,0 +1,183 @@
+/*
+ * $RCSfile: ExponentialFogRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+import java.util.ArrayList;
+
+/**
+ * The ExponentialFog leaf node defines distance parameters for
+ * exponential fog.
+ */
+class ExponentialFogRetained extends FogRetained {
+ // Fog density
+ private float density = 1.0f;
+
+ // Issue 144: density in Eye Coordinates (EC)
+ private float densityInEc;
+
+ // dirty bits for ExponentialFog
+ static final int DENSITY_CHANGED = FogRetained.LAST_DEFINED_BIT << 1;
+
+
+ ExponentialFogRetained() {
+ this.nodeType = NodeRetained.EXPONENTIALFOG;
+ }
+
+ /**
+ * initializes fog density
+ */
+ void initDensity(float density){
+ this.density = density;
+ }
+
+ /**
+ * Sets fog density and send a message
+ */
+ void setDensity(float density){
+ this.density = density;
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.type = J3dMessage.FOG_CHANGED;
+ createMessage.universe = universe;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(DENSITY_CHANGED);
+ createMessage.args[2] = new Float(density);
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+ /**
+ * Gets fog density
+ */
+ float getDensity(){
+ return this.density;
+ }
+
+
+ void setLive(SetLiveState s) {
+ super.setLive(s);
+ GroupRetained group;
+
+ // Initialize the mirror object, this needs to be done, when
+ // renderBin is not accessing any of the fields
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.FOG_CHANGED;
+ createMessage.args[0] = this;
+ // a snapshot of all attributes that needs to be initialized
+ // in the mirror object
+ createMessage.args[1]= new Integer(INIT_MIRROR);
+ ArrayList addScopeList = new ArrayList();
+ for (int i = 0; i < scopes.size(); i++) {
+ group = (GroupRetained)scopes.get(i);
+ tempKey.reset();
+ group.addAllNodesForScopedFog(mirrorFog, addScopeList, tempKey);
+ }
+ Object[] scopeInfo = new Object[2];
+ scopeInfo[0] = ((scopes.size() > 0) ? Boolean.TRUE:Boolean.FALSE);
+ scopeInfo[1] = addScopeList;
+ createMessage.args[2] = scopeInfo;
+ Color3f clr = new Color3f(color);
+ createMessage.args[3] = clr;
+
+ Object[] obj = new Object[5];
+ obj[0] = boundingLeaf;
+ obj[1] = (regionOfInfluence != null?regionOfInfluence.clone():null);
+ obj[2] = (inBackgroundGroup? Boolean.TRUE:Boolean.FALSE);
+ obj[3] = geometryBackground;
+ obj[4] = new Float(density);
+
+ createMessage.args[4] = obj;
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ }
+
+
+ /**
+ * This method and its native counterpart update the native context
+ * fog values.
+ */
+ void update(Context ctx, double scale) {
+ // Issue 144: recompute the density in EC, and send it to native code
+ validateDistancesInEc(scale);
+ Pipeline.getPipeline().updateExponentialFog(ctx, color.x, color.y, color.z, densityInEc);
+ }
+
+
+
+ // The update Object function.
+ // Note : if you add any more fields here , you need to update
+ // updateFog() in RenderingEnvironmentStructure
+ void updateMirrorObject(Object[] objs) {
+
+ int component = ((Integer)objs[1]).intValue();
+
+
+ if ((component & DENSITY_CHANGED) != 0)
+ ((ExponentialFogRetained)mirrorFog).density = ((Float)objs[2]).floatValue();
+
+ if ((component & INIT_MIRROR) != 0) {
+ ((ExponentialFogRetained)mirrorFog).density = ((Float)((Object[])objs[4])[4]).floatValue();
+
+ }
+ // Issue 144: store the local to vworld scale used to transform the density
+ ((ExponentialFogRetained)mirrorFog).setLocalToVworldScale(getLastLocalToVworld().getDistanceScale());
+
+ super.updateMirrorObject(objs);
+ }
+
+
+ // Clone the retained side only, internal use only
+ protected Object clone() {
+ ExponentialFogRetained efr =
+ (ExponentialFogRetained)super.clone();
+
+ efr.initDensity(getDensity());
+
+ return efr;
+ }
+
+ // Issue 144: method to recompute the density in EC by multiplying the specified
+ // density by the inverse of the local to EC scale
+ /**
+ * Scale distances from local to eye coordinate.
+ */
+ protected void validateDistancesInEc(double vworldToCoexistenceScale) {
+ // vworldToCoexistenceScale can be used here since
+ // CoexistenceToEc has a unit scale
+ double localToEcScale = getLocalToVworldScale() * vworldToCoexistenceScale;
+
+ densityInEc = (float)(density / localToEcScale);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Fog.java b/j3d-core/src/classes/share/javax/media/j3d/Fog.java
new file mode 100644
index 0000000..3b49425
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Fog.java
@@ -0,0 +1,570 @@
+/*
+ * $RCSfile: Fog.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Enumeration;
+import javax.vecmath.Color3f;
+
+/**
+ * The Fog leaf node defines a set of fog parameters common to all
+ * types of fog. These parameters include the fog color and a region
+ * of influence in which this Fog node is active.
+ * A Fog node also contains a list of Group nodes that specifies the
+ * hierarchical scope of this Fog. If the scope list is empty, then
+ * the Fog node has universe scope: all nodes within the region of
+ * influence are affected by this Fog node. If the scope list is
+ * non-empty, then only those Leaf nodes under the Group nodes in the
+ * scope list are affected by this Fog node (subject to the
+ * influencing bounds).
+ *
+ * color : black (0,0,0)
+ */
+ public Fog() {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a Fog node with the specified fog color.
+ * @param color the fog color
+ */
+ public Fog(Color3f color) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((FogRetained)this.retained).initColor(color);
+ }
+
+ /**
+ * Constructs a Fog node with the specified fog color.
+ * @param r the red component of the fog color
+ * @param g the green component of the fog color
+ * @param b the blue component of the fog color
+ */
+ public Fog(float r, float g, float b) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((FogRetained)this.retained).initColor(r, g, b);
+ }
+
+ /**
+ * Sets the fog color to the specified color.
+ * @param color the new fog color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog0"));
+
+ if (isLive())
+ ((FogRetained)this.retained).setColor(color);
+ else
+ ((FogRetained)this.retained).initColor(color);
+ }
+
+ /**
+ * Sets the fog color to the specified color.
+ * @param r the red component of the fog color
+ * @param g the green component of the fog color
+ * @param b the blue component of the fog color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setColor(float r, float g, float b) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog0"));
+
+ if (isLive())
+ ((FogRetained)this.retained).setColor(r, g, b);
+ else
+ ((FogRetained)this.retained).initColor(r, g, b);
+ }
+
+ /**
+ * Retrieves the fog color.
+ * @param color the vector that will receive the current fog color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog2"));
+
+ ((FogRetained)this.retained).getColor(color);
+ }
+
+ /**
+ * Sets the Fog's influencing region to the specified bounds.
+ * This is used when the influencing bounding leaf is set to null.
+ * @param region the bounds that contains the Fog's new influencing region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBounds(Bounds region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog3"));
+
+ if (isLive())
+ ((FogRetained)this.retained).setInfluencingBounds(region);
+ else
+ ((FogRetained)this.retained).initInfluencingBounds(region);
+
+ }
+
+ /**
+ * Retrieves the Fog node's influencing bounds.
+ * @return this Fog's influencing bounds information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getInfluencingBounds() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog4"));
+
+ return ((FogRetained)this.retained).getInfluencingBounds();
+ }
+
+ /**
+ * Sets the Fog's influencing region to the specified bounding leaf.
+ * When set to a value other than null, this overrides the influencing
+ * bounds object.
+ * @param region the bounding leaf node used to specify the Fog
+ * node's new influencing region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog3"));
+
+ if (isLive())
+ ((FogRetained)this.retained).setInfluencingBoundingLeaf(region);
+ else
+ ((FogRetained)this.retained).initInfluencingBoundingLeaf(region);
+ }
+
+ /**
+ * Retrieves the Fog node's influencing bounding leaf.
+ * @return this Fog's influencing bounding leaf information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public BoundingLeaf getInfluencingBoundingLeaf() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog4"));
+
+ return ((FogRetained)this.retained).getInfluencingBoundingLeaf();
+ }
+
+
+ /**
+ * Replaces the node at the specified index in this Fog node's
+ * list of scopes with the specified Group node.
+ * By default, Fog nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be stored at the specified index.
+ * @param index the index of the Group node to be replaced.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void setScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog7"));
+
+
+ if (isLive())
+ ((FogRetained)this.retained).setScope(scope, index);
+ else
+ ((FogRetained)this.retained).initScope(scope, index);
+ }
+
+
+ /**
+ * Retrieves the Group node at the specified index from this Fog node's
+ * list of scopes.
+ * @param index the index of the Group node to be returned.
+ * @return the Group node at the specified index.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Group getScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog8"));
+
+ return ((FogRetained)this.retained).getScope(index);
+ }
+
+
+ /**
+ * Inserts the specified Group node into this Fog node's
+ * list of scopes at the specified index.
+ * By default, Fog nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be inserted at the specified index.
+ * @param index the index at which the Group node is inserted.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void insertScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog9"));
+
+ if (isLive())
+ ((FogRetained)this.retained).insertScope(scope, index);
+ else
+ ((FogRetained)this.retained).initInsertScope(scope, index);
+ }
+
+
+ /**
+ * Removes the node at the specified index from this Fog node's
+ * list of scopes. If this operation causes the list of scopes to
+ * become empty, then this Fog will have universe scope: all nodes
+ * within the region of influence will be affected by this Fog node.
+ * @param index the index of the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the group node at the
+ * specified index is part of a compiled scene graph
+ */
+ public void removeScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog10"));
+
+ if (isLive())
+ ((FogRetained)this.retained).removeScope(index);
+ else
+ ((FogRetained)this.retained).initRemoveScope(index);
+ }
+
+
+ /**
+ * Returns an enumeration of this Fog node's list of scopes.
+ * @return an Enumeration object containing all nodes in this Fog node's
+ * list of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Enumeration getAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog11"));
+
+ return (Enumeration) ((FogRetained)this.retained).getAllScopes();
+ }
+
+
+ /**
+ * Appends the specified Group node to this Fog node's list of scopes.
+ * By default, Fog nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be appended.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void addScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog12"));
+
+ if (isLive())
+ ((FogRetained)this.retained).addScope(scope);
+ else
+ ((FogRetained)this.retained).initAddScope(scope);
+ }
+
+
+ /**
+ * Returns the number of nodes in this Fog node's list of scopes.
+ * If this number is 0, then the list of scopes is empty and this
+ * Fog node has universe scope: all nodes within the region of
+ * influence are affected by this Fog node.
+ * @return the number of nodes in this Fog node's list of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int numScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog11"));
+
+ return ((FogRetained)this.retained).numScopes();
+ }
+
+
+ /**
+ * Retrieves the index of the specified Group node in this
+ * Fog node's list of scopes.
+ *
+ * @param scope the Group node to be looked up.
+ * @return the index of the specified Group node;
+ * returns -1 if the object is not in the list.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int indexOfScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog8"));
+ return ((FogRetained)this.retained).indexOfScope(scope);
+ }
+
+
+ /**
+ * Removes the specified Group node from this Fog
+ * node's list of scopes. If the specified object is not in the
+ * list, the list is not modified. If this operation causes the
+ * list of scopes to become empty, then this Fog
+ * will have universe scope: all nodes within the region of
+ * influence will be affected by this Fog node.
+ *
+ * @param scope the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog10"));
+
+ if (isLive())
+ ((FogRetained)this.retained).removeScope(scope);
+ else
+ ((FogRetained)this.retained).initRemoveScope(scope);
+ }
+
+
+ /**
+ * Removes all Group nodes from this Fog node's
+ * list of scopes. The Fog node will then have
+ * universe scope: all nodes within the region of influence will
+ * be affected by this Fog node.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if any group node in this
+ * node's list of scopes is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Fog10"));
+
+ if (isLive())
+ ((FogRetained)this.retained).removeAllScopes();
+ else
+ ((FogRetained)this.retained).initRemoveAllScopes();
+ }
+
+
+ /**
+ * Copies all Fog information from
+ *
+ * scope : empty (universe scope)
+ * influencing bounds : null
+ * influencing bounding leaf : null
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ FogRetained attr = (FogRetained) originalNode.retained;
+ FogRetained rt = (FogRetained) retained;
+
+ Color3f c = new Color3f();
+ attr.getColor(c);
+ rt.initColor(c);
+ rt.initInfluencingBounds(attr.getInfluencingBounds());
+
+ Enumeration elm = attr.getAllScopes();
+ while (elm.hasMoreElements()) {
+ // this reference will set correctly in updateNodeReferences() callback
+ rt.initAddScope((Group) elm.nextElement());
+ }
+
+ // this reference will set correctly in updateNodeReferences() callback
+ rt.initInfluencingBoundingLeaf(attr.getInfluencingBoundingLeaf());
+ }
+
+ /**
+ * Callback used to allow a node to check if any nodes referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any node references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding Node in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * node is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+
+ FogRetained rt = (FogRetained) retained;
+ BoundingLeaf bl = rt.getInfluencingBoundingLeaf();
+
+ if (bl != null) {
+ Object o = referenceTable.getNewObjectReference(bl);
+ rt.initInfluencingBoundingLeaf((BoundingLeaf) o);
+ }
+
+
+ int num = rt.numScopes();
+ for (int i=0; i < num; i++) {
+ rt.initScope((Group) referenceTable.
+ getNewObjectReference(rt.getScope(i)), i);
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/FogRetained.java b/j3d-core/src/classes/share/javax/media/j3d/FogRetained.java
new file mode 100644
index 0000000..7bde7fa
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/FogRetained.java
@@ -0,0 +1,827 @@
+/*
+ * $RCSfile: FogRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.Enumeration;
+import java.util.Vector;
+import java.util.ArrayList;
+
+/**
+ * The Fog leaf node defines Fog parameters.
+ * It also specifies an region of influence in which this fog node
+ * is active.
+ */
+abstract class FogRetained extends LeafRetained{
+
+ // Statics used when something in the fog changes
+ static final int COLOR_CHANGED = 0x0001;
+ static final int SCOPE_CHANGED = 0x0002;
+ static final int BOUNDS_CHANGED = 0x0004;
+ static final int BOUNDINGLEAF_CHANGED = 0x0008;
+ static final int INIT_MIRROR = 0x0010;
+ static final int CLEAR_MIRROR = 0x0020;
+ static final int LAST_DEFINED_BIT = 0x0020;
+
+ // Fog color.
+ Color3f color = new Color3f(0.0f, 0.0f, 0.0f);
+
+ /**
+ * The Boundary object defining the lights's region of influence.
+ */
+ Bounds regionOfInfluence = null;
+
+ /**
+ * The bounding leaf reference
+ */
+ BoundingLeafRetained boundingLeaf = null;
+
+ /**
+ * Vector of GroupRetained nodes that scopes this fog.
+ */
+ Vector scopes = new Vector();
+
+ // An int that is set when this fog is changed
+ int isDirty = 0xffff;
+
+ // This is true when this fog is referenced in an immediate mode context
+ boolean inImmCtx = false;
+
+ /**
+ * The transformed value of the applicationRegion.
+ */
+ Bounds region = null;
+
+ // A reference to the scene graph fog
+ FogRetained sgFog = null;
+
+ // The mirror copy of this fog
+ FogRetained mirrorFog = null;
+
+ // Target threads to be notified when light changes
+ static final int targetThreads = J3dThread.UPDATE_RENDERING_ENVIRONMENT |
+ J3dThread.UPDATE_RENDER;
+
+ // Boolean to indicate if this object is scoped (only used for mirror objects
+ boolean isScoped = false;
+
+ // The object that contains the dynamic HashKey - a string type object
+ // Used in scoping
+ HashKey tempKey = new HashKey(250);
+
+ /**
+ * The EnvironmentSets which reference this fog.
+ * Note that multiple RenderBin update thread may access
+ * this shared environmentSets simultaneously.
+ * So we use UnorderList when sync. all the operations.
+ */
+ UnorderList environmentSets = new UnorderList(1, EnvironmentSet.class);
+
+ // Is true, if the mirror fog is viewScoped
+ boolean isViewScoped = false;
+
+ // Scale value extracted from localToVworld transform
+ private double localToVworldScale = 1.0;
+
+ FogRetained() {
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ /**
+ * Initialize the fog color to the specified color.
+ */
+ void initColor(Color3f color) {
+ this.color.set(color);
+ }
+ /**
+ * Sets the fog color to the specified color and send message
+ */
+ void setColor(Color3f color) {
+ this.color.set(color);
+ sendMessage(COLOR_CHANGED, new Color3f(color));
+ }
+
+ /**
+ * Sets the fog color to the specified color.
+ */
+ void initColor(float r, float g, float b) {
+ this.color.x = r;
+ this.color.y = g;
+ this.color.z = b;
+ }
+ /**
+ * Sets the fog color to the specified color and send message
+ */
+ void setColor(float r, float g, float b) {
+ initColor(r, g, b);
+ sendMessage(COLOR_CHANGED, new Color3f(r, g, b));
+ }
+
+ /**
+ * Retrieves the fog color.
+ */
+ void getColor(Color3f color) {
+ color.set(this.color);
+ }
+
+ /**
+ * Set the Fog's region of influence.
+ */
+ void initInfluencingBounds(Bounds region) {
+ if (region != null) {
+ this.regionOfInfluence = (Bounds) region.clone();
+ } else {
+ this.regionOfInfluence = null;
+ }
+ if (staticTransform != null) {
+ this.regionOfInfluence.transform(staticTransform.transform);
+ }
+ }
+
+ /**
+ * Set the Fog's region of influence and send message
+ */
+ void setInfluencingBounds(Bounds region) {
+ initInfluencingBounds(region);
+ sendMessage(BOUNDS_CHANGED,
+ (region != null ? region.clone() : null));
+ }
+
+ /**
+ * Get the Fog's region of Influence.
+ */
+ Bounds getInfluencingBounds() {
+ Bounds b = null;
+ if (regionOfInfluence != null) {
+ b = (Bounds)regionOfInfluence.clone();
+ if (staticTransform != null) {
+ Transform3D invTransform = staticTransform.getInvTransform();
+ b.transform(invTransform);
+ }
+ }
+ return b;
+ }
+
+ /**
+ * Set the Fog's region of influence to the specified Leaf node.
+ */
+ void initInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ } else {
+ boundingLeaf = null;
+ }
+ }
+
+ /**
+ * Set the Fog's region of influence to the specified Leaf node.
+ */
+ void setInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (boundingLeaf != null)
+ boundingLeaf.mirrorBoundingLeaf.removeUser(mirrorFog);
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ boundingLeaf.mirrorBoundingLeaf.addUser(mirrorFog);
+ } else {
+ boundingLeaf = null;
+ }
+ sendMessage(BOUNDINGLEAF_CHANGED,
+ (boundingLeaf != null ?
+ boundingLeaf.mirrorBoundingLeaf : null));
+ }
+
+
+ /**
+ * Get the Fog's region of influence.
+ */
+ BoundingLeaf getInfluencingBoundingLeaf() {
+ return (boundingLeaf != null ?
+ (BoundingLeaf)boundingLeaf.source : null);
+ }
+
+ /**
+ * Replaces the specified scope with the scope provided.
+ * @param scope the new scope
+ * @param index which scope to replace
+ */
+ void initScope(Group scope, int index) {
+ scopes.setElementAt((GroupRetained)(scope.retained), index);
+
+ }
+
+ /**
+ * Replaces the specified scope with the scope provided.
+ * @param scope the new scope
+ * @param index which scope to replace
+ */
+ void setScope(Group scope, int index) {
+
+ ArrayList addScopeList = new ArrayList();
+ ArrayList removeScopeList = new ArrayList();
+ GroupRetained group;
+ Object[] scopeInfo = new Object[3];
+
+
+ group = (GroupRetained) scopes.get(index);
+ tempKey.reset();
+ group.removeAllNodesForScopedFog(mirrorFog, removeScopeList, tempKey);
+
+ group = (GroupRetained)scope.retained;
+ initScope(scope, index);
+ tempKey.reset();
+ // If its a group, then add the scope to the group, if
+ // its a shape, then keep a list to be added during
+ // updateMirrorObject
+ group.addAllNodesForScopedFog(mirrorFog,addScopeList, tempKey);
+
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE:Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+ /**
+ * Inserts the specified scope at specified index.before the
+ * fog is live
+ * @param scope the new scope
+ * @param index position to insert new scope at
+ */
+ void initInsertScope(Node scope, int index) {
+ GroupRetained group = (GroupRetained)scope.retained;
+ group.setFogScope();
+ scopes.insertElementAt((GroupRetained)(scope.retained), index);
+ }
+
+ /**
+ * Inserts the specified scope at specified index and sends
+ * a message
+ * @param scope the new scope
+ * @param index position to insert new scope at
+ */
+ void insertScope(Node scope, int index) {
+ Object[] scopeInfo = new Object[3];
+ ArrayList addScopeList = new ArrayList();
+
+ initInsertScope(scope, index);
+ GroupRetained group = (GroupRetained)scope.retained;
+ tempKey.reset();
+ group.addAllNodesForScopedFog(mirrorFog,addScopeList, tempKey);
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = null;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+
+ void initRemoveScope(int index) {
+ GroupRetained group = (GroupRetained)scopes.elementAt(index);
+ scopes.removeElementAt(index);
+ group.removeFogScope();
+
+ }
+
+ void removeScope(int index) {
+
+ Object[] scopeInfo = new Object[3];
+ ArrayList removeScopeList = new ArrayList();
+ GroupRetained group = (GroupRetained)scopes.elementAt(index);
+
+ tempKey.reset();
+ group.removeAllNodesForScopedFog(mirrorFog, removeScopeList, tempKey);
+
+ initRemoveScope(index);
+ scopeInfo[0] = null;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+
+ /**
+ * Returns the scope specified by the index.
+ * @param index which scope to return
+ * @return the scoperen at location index
+ */
+ Group getScope(int index) {
+ return (Group)(((GroupRetained)(scopes.elementAt(index))).source);
+ }
+
+ /**
+ * Returns an enumeration object of the scoperen.
+ * @return an enumeration object of the scoperen
+ */
+ Enumeration getAllScopes() {
+ Enumeration elm = scopes.elements();
+ Vector v = new Vector(scopes.size());
+ while (elm.hasMoreElements()) {
+ v.add( ((GroupRetained) elm.nextElement()).source);
+ }
+ return v.elements();
+ }
+
+ /**
+ * Appends the specified scope to this node's list of scopes before
+ * the fog is alive
+ * @param scope the scope to add to this node's list of scopes
+ */
+ void initAddScope(Group scope) {
+ GroupRetained group = (GroupRetained)scope.retained;
+ scopes.addElement((GroupRetained)(scope.retained));
+ group.setFogScope();
+ }
+
+ /**
+ * Appends the specified scope to this node's list of scopes.
+ * @param scope the scope to add to this node's list of scopes
+ */
+ void addScope(Group scope) {
+
+ Object[] scopeInfo = new Object[3];
+ ArrayList addScopeList = new ArrayList();
+ GroupRetained group = (GroupRetained)scope.retained;
+
+ initAddScope(scope);
+ tempKey.reset();
+ group.addAllNodesForScopedFog(mirrorFog,addScopeList, tempKey);
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = null;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+ /**
+ * Returns a count of this nodes' scopes.
+ * @return the number of scopes descendant from this node
+ */
+ int numScopes() {
+ return scopes.size();
+ }
+
+ /**
+ * Returns the index of the specified scope within this nodes' list of scopes
+ * @param scope whose index is desired
+ * @return index of specified scope
+ */
+ int indexOfScope(Group scope) {
+ if(scope != null)
+ return scopes.indexOf((GroupRetained)scope.retained);
+ else
+ return scopes.indexOf(null);
+ }
+
+ /**
+ * Removes the specified scope from this nodes' list of scopes
+ * @param scope to be removed. If the scope is not found,
+ * the method returns silently
+ */
+ void removeScope(Group scope) {
+ int i = indexOfScope(scope);
+ if(i >= 0)
+ removeScope(i);
+ }
+
+ void initRemoveScope(Group scope) {
+ int i = indexOfScope(scope);
+ if(i >= 0)
+ initRemoveScope(i);
+ }
+
+ /**
+ * Removes all the scopes from this node's list of scopes.
+ * The node should revert to universal
+ * scope after this method returns
+ */
+ void removeAllScopes() {
+ Object[] scopeInfo = new Object[3];
+ ArrayList removeScopeList = new ArrayList();
+ GroupRetained group;
+ int n = scopes.size();
+
+ tempKey.reset();
+ for(int index = n-1; index >= 0; index--) {
+ group = (GroupRetained)scopes.elementAt(index);
+ group.removeAllNodesForScopedFog(mirrorFog, removeScopeList, tempKey);
+ initRemoveScope(index);
+ }
+ scopeInfo[0] = null;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = Boolean.FALSE;
+ sendMessage(SCOPE_CHANGED, scopeInfo);
+ }
+
+ /**
+ * Removes all scopes from this node
+ */
+ void initRemoveAllScopes() {
+ int n = scopes.size();
+ for(int index = n-1; index >= 0; index--)
+ initRemoveScope(index);
+ }
+
+ /**
+ * This sets the immedate mode context flag
+ */
+ void setInImmCtx(boolean inCtx) {
+ inImmCtx = inCtx;
+ }
+
+ /**
+ * This gets the immedate mode context flag
+ */
+ boolean getInImmCtx() {
+ return (inImmCtx);
+ }
+
+ boolean isScoped() {
+ return (scopes != null);
+ }
+
+ /**
+ * This abstract method is used to update the current native
+ * context fog values.
+ */
+ abstract void update(Context ctx, double scale);
+
+
+ void updateImmediateMirrorObject(Object[] objs) {
+ GroupRetained group;
+ Vector currentScopes;
+ int i, nscopes;
+ Transform3D trans;
+
+ int component = ((Integer)objs[1]).intValue();
+ if ((component & BOUNDS_CHANGED) != 0) {
+ mirrorFog.regionOfInfluence = (Bounds) objs[2];
+ if (mirrorFog.boundingLeaf == null) {
+ if (objs[2] != null) {
+ mirrorFog.region = ((Bounds)mirrorFog.regionOfInfluence).copy(mirrorFog.region);
+ mirrorFog.region.transform(
+ mirrorFog.regionOfInfluence,
+ getCurrentLocalToVworld());
+ }
+ else {
+ mirrorFog.region = null;
+ }
+ }
+ }
+ else if ((component & BOUNDINGLEAF_CHANGED) != 0) {
+ mirrorFog.boundingLeaf = (BoundingLeafRetained)objs[2];
+ if (objs[2] != null) {
+ mirrorFog.region = (Bounds)mirrorFog.boundingLeaf.transformedRegion;
+ }
+ else {
+ if (mirrorFog.regionOfInfluence != null) {
+ mirrorFog.region = ((Bounds)mirrorFog.regionOfInfluence).copy(mirrorFog.region);
+ mirrorFog.region.transform(
+ mirrorFog.regionOfInfluence,
+ getCurrentLocalToVworld());
+ }
+ else {
+ mirrorFog.region = null;
+ }
+
+ }
+ }
+ else if ((component & SCOPE_CHANGED) != 0) {
+ Object[] scopeList = (Object[])objs[2];
+ ArrayList addList = (ArrayList)scopeList[0];
+ ArrayList removeList = (ArrayList)scopeList[1];
+ boolean isScoped = ((Boolean)scopeList[2]).booleanValue();
+
+ if (addList != null) {
+ mirrorFog.isScoped = isScoped;
+ for (i = 0; i < addList.size(); i++) {
+ Shape3DRetained obj = ((GeometryAtom)addList.get(i)).source;
+ obj.addFog(mirrorFog);
+ }
+ }
+
+ if (removeList != null) {
+ mirrorFog.isScoped = isScoped;
+ for (i = 0; i < removeList.size(); i++) {
+ Shape3DRetained obj = ((GeometryAtom)removeList.get(i)).source;
+ obj.removeFog(mirrorFog);
+ }
+ }
+ }
+
+
+ }
+
+ /**
+ * The update Object function.
+ */
+ void updateMirrorObject(Object[] objs) {
+
+ int component = ((Integer)objs[1]).intValue();
+ if ((component & COLOR_CHANGED) != 0) {
+ mirrorFog.color.set((Color3f)objs[2]);
+ }
+ if ((component & INIT_MIRROR) != 0) {
+ mirrorFog.color.set((Color3f)objs[3]);
+ }
+ }
+
+
+ /**
+ * Note: This routine will only be called on
+ * the mirror object - will update the object's
+ * cached region and transformed region
+ */
+ void updateBoundingLeaf() {
+ if (boundingLeaf != null && boundingLeaf.switchState.currentSwitchOn) {
+ region = boundingLeaf.transformedRegion;
+ } else {
+ if (regionOfInfluence != null) {
+ region = regionOfInfluence.copy(region);
+ region.transform(regionOfInfluence,
+ getCurrentLocalToVworld());
+ } else {
+ region = null;
+ }
+ }
+ }
+
+ /**
+ * This setLive routine just calls the superclass's method (after
+ * checking for use by an immediate context). It is up to the
+ * subclasses of fog to add themselves to the list of fogs
+ */
+ void setLive(SetLiveState s) {
+ GroupRetained group;
+ Vector currentScopes;
+ int i, nscopes;
+ TransformGroupRetained[] tlist;
+
+ if (inImmCtx) {
+ throw new IllegalSharingException(J3dI18N.getString("FogRetained0"));
+ }
+ super.doSetLive(s);
+
+ if (inSharedGroup) {
+ throw new
+ IllegalSharingException(J3dI18N.getString("FogRetained1"));
+ }
+
+
+ // Create the mirror object
+ // Initialization of the mirror object during the INSERT_NODE
+ // message (in updateMirrorObject)
+ if (mirrorFog == null) {
+ // mirrorFog = (FogRetained)this.clone(true);
+ mirrorFog = (FogRetained)this.clone();
+ // Assign the bounding leaf of this mirror object as null
+ // it will later be assigned to be the mirror of the lights
+ // bounding leaf object
+ mirrorFog.boundingLeaf = null;
+ mirrorFog.sgFog = this;
+ }
+ // initMirrorObject();
+ // If bounding leaf is not null, add the mirror object as a user
+ // so that any changes to the bounding leaf will be received
+ if (boundingLeaf != null) {
+ boundingLeaf.mirrorBoundingLeaf.addUser(mirrorFog);
+ }
+
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(mirrorFog);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(mirrorFog);
+ }
+
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorFog, Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+
+
+
+ // process switch leaf
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorFog, Targets.ENV_TARGETS);
+ }
+ mirrorFog.switchState = (SwitchState)s.switchStates.get(0);
+
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+
+
+
+ super.markAsLive();
+
+
+ }
+ // This is called on the parent object
+ void initMirrorObject(Object[] args) {
+ Shape3DRetained shape;
+ Object[] scopeInfo = (Object[]) args[2];
+ Boolean scoped = (Boolean)scopeInfo[0];
+ ArrayList shapeList = (ArrayList)scopeInfo[1];
+ BoundingLeafRetained bl=(BoundingLeafRetained)((Object[])args[4])[0];
+ Bounds bnds = (Bounds)((Object[])args[4])[1];
+
+ mirrorFog.inBackgroundGroup = ((Boolean)((Object[])args[4])[2]).booleanValue();
+ mirrorFog.geometryBackground = (BackgroundRetained)((Object[])args[4])[3];
+ for (int i = 0; i < shapeList.size(); i++) {
+ shape = ((GeometryAtom)shapeList.get(i)).source;
+ shape.addFog(mirrorFog);
+ }
+ mirrorFog.isScoped = scoped.booleanValue();
+
+ if (bl != null) {
+ mirrorFog.boundingLeaf = bl.mirrorBoundingLeaf;
+ mirrorFog.region = boundingLeaf.transformedRegion;
+ } else {
+ mirrorFog.boundingLeaf = null;
+ mirrorFog.region = null;
+ }
+
+ if (bnds != null) {
+ mirrorFog.regionOfInfluence = bnds;
+ if (mirrorFog.region == null) {
+ mirrorFog.region = (Bounds)regionOfInfluence.clone();
+ mirrorFog.region.transform(regionOfInfluence, getLastLocalToVworld());
+ }
+ }
+ else {
+ mirrorFog.regionOfInfluence = null;
+ }
+
+ }
+
+ // This is called on the parent object
+ void clearMirrorObject(Object[] args) {
+ Shape3DRetained shape;
+ ArrayList shapeList = (ArrayList)args[2];
+ ArrayList removeScopeList = new ArrayList();
+
+ for (int i = 0; i < shapeList.size(); i++) {
+ shape = ((GeometryAtom)shapeList.get(i)).source;
+ shape.removeFog(mirrorFog);
+ }
+ mirrorFog.isScoped = false;
+
+
+
+ }
+
+
+
+ /**
+ * This clearLive routine first calls the superclass's method, then
+ * it removes itself to the list of fogs
+ */
+ void clearLive(SetLiveState s) {
+ int i, j;
+ GroupRetained group;
+
+ super.clearLive(s);
+
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorFog, Targets.ENV_TARGETS);
+ }
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+
+ // Remove this mirror light as users of the bounding leaf
+ if (mirrorFog.boundingLeaf != null)
+ mirrorFog.boundingLeaf.removeUser(mirrorFog);
+
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(mirrorFog);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(mirrorFog);
+ }
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorFog, Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+
+
+ if (scopes.size() > 0) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.FOG_CHANGED;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(CLEAR_MIRROR);
+ ArrayList removeScopeList = new ArrayList();
+ for (i = 0; i < scopes.size(); i++) {
+ group = (GroupRetained)scopes.get(i);
+ tempKey.reset();
+ group.removeAllNodesForScopedFog(mirrorFog, removeScopeList, tempKey);
+ }
+ createMessage.args[2] = removeScopeList;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+ }
+
+ // Clone the retained side only, internal use only
+ protected Object clone() {
+ FogRetained fr = (FogRetained)super.clone();
+
+ fr.color = new Color3f(color);
+ Bounds b = getInfluencingBounds();
+ if (b != null) {
+ fr.initInfluencingBounds(b);
+ }
+
+ fr.scopes = new Vector();
+ fr.isDirty = 0xffff;
+ fr.inImmCtx = false;
+ fr.region = null;
+ fr.sgFog = null;
+ fr.mirrorFog = null;
+ fr.environmentSets = new UnorderList(1, EnvironmentSet.class);
+ return fr;
+ }
+
+ void updateTransformChange() {
+ super.updateTransformChange();
+ setLocalToVworldScale(sgFog.getLastLocalToVworld().getDistanceScale());
+ }
+
+ // Called on mirror object
+ void updateImmediateTransformChange() {
+ // If bounding leaf is null, tranform the bounds object
+ if (boundingLeaf == null) {
+ if (regionOfInfluence != null) {
+ region = regionOfInfluence.copy(region);
+ region.transform(regionOfInfluence,
+ sgFog.getCurrentLocalToVworld());
+ }
+
+ }
+ }
+
+ final void sendMessage(int attrMask, Object attr) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.FOG_CHANGED;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+ void mergeTransform(TransformGroupRetained xform) {
+ super.mergeTransform(xform);
+ if (regionOfInfluence != null) {
+ regionOfInfluence.transform(xform.transform);
+ }
+ }
+ void getMirrorObjects(ArrayList leafList, HashKey key) {
+ leafList.add(mirrorFog);
+ }
+
+ /**
+ * Scale distances from local to eye coordinate
+ */
+ protected void validateDistancesInEc(double vworldToCoexistenceScale) {
+ assert false : "subclasses should override this method";
+ }
+
+ double getLocalToVworldScale() {
+ return localToVworldScale;
+ }
+
+ void setLocalToVworldScale(double localToVworldScale) {
+ this.localToVworldScale = localToVworldScale;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Font3D.java b/j3d-core/src/classes/share/javax/media/j3d/Font3D.java
new file mode 100644
index 0000000..100eae5
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Font3D.java
@@ -0,0 +1,1167 @@
+/*
+ * $RCSfile: Font3D.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import com.sun.j3d.utils.geometry.*;
+import com.sun.j3d.internal.FastVector;
+import java.awt.Font;
+import java.awt.font.*;
+import java.awt.geom.Rectangle2D;
+import java.awt.geom.AffineTransform;
+import javax.vecmath.*;
+import java.awt.Shape;
+import java.awt.geom.PathIterator;
+import java.util.*;
+
+/**
+ * The Font3D object is used to store extruded 2D glyphs. These
+ * 3D glyphs can then be used to construct Text3D NodeComponent
+ * objects.
+ *
+ * tessellation tolerance : 0.01
+ *
+ * flatness parameter in
+ * the java.awt.Shape.getPathIterator method.
+ * @param extrudePath the extrusion path used to describe how
+ * the edge of the font varies along the Z axis.
+ *
+ * @since Java 3D 1.2
+ */
+ public Font3D(Font font,
+ double tessellationTolerance,
+ FontExtrusion extrudePath) {
+
+ this.font = font;
+ this.tessellationTolerance = tessellationTolerance;
+ this.fontExtrusion = extrudePath;
+ this.frc = new FontRenderContext(new AffineTransform(),
+ true, true);
+ }
+
+ /**
+ * Returns the Java 2D Font used to create this Font3D object.
+ * @return Font object used by this Font3D
+ */
+ public Font getFont() {
+ return this.font;
+ }
+
+
+ /**
+ * Returns the tessellation tolerance with which this Font3D was
+ * created.
+ * @return the tessellation tolerance used by this Font3D
+ *
+ * @since Java 3D 1.2
+ */
+ public double getTessellationTolerance() {
+ return tessellationTolerance;
+ }
+
+
+ /**
+ * Copies the FontExtrusion object used to create this Font3D object
+ * into the specified parameter.
+ *
+ * @param extrudePath object that will receive the
+ * FontExtrusion information for this Font3D object
+ */
+ public void getFontExtrusion(FontExtrusion extrudePath) {
+ extrudePath = this.fontExtrusion;
+ }
+
+ /**
+ * Returns the 3D bounding box of the specified glyph code.
+ *
+ * @param glyphCode the glyphCode from the original 2D Font
+ * @param bounds the 3D glyph's bounds
+ */
+ public void getBoundingBox(int glyphCode, BoundingBox bounds){
+ int[] gCodes = {glyphCode};
+ GlyphVector gVec = font.createGlyphVector(frc, gCodes);
+ Rectangle2D.Float bounds2d = (Rectangle2D.Float)
+ (((GlyphMetrics)(gVec.getGlyphMetrics(0))).getBounds2D());
+
+ Point3d lower = new Point3d(bounds2d.x, bounds2d.y, 0.0);
+ Point3d upper;
+ if (fontExtrusion != null) {
+ upper = new Point3d(bounds2d.x + bounds2d.width,
+ bounds2d.y + bounds2d.height,
+ fontExtrusion.length);
+ } else {
+ upper = new Point3d(bounds2d.x + bounds2d.width,
+ bounds2d.y + bounds2d.height,
+ 0.0);
+ }
+ bounds.setLower(lower);
+ bounds.setUpper(upper);
+ }
+
+ // BY MIK OF CLASSX
+ /**
+ * Returns a GeometryArray of a glyph in this Font3D.
+ *
+ * @param c character from which to generate a tessellated glyph.
+ *
+ * @return a GeometryArray
+ *
+ * @since Java 3D 1.4
+ */
+ public GeometryArray getGlyphGeometry(char c) {
+ char code[] = { c };
+ GlyphVector gv = font.createGlyphVector(frc, code);
+
+ // triangulate the glyph
+ GeometryArrayRetained glyph_gar = triangulateGlyphs(gv, code[0]);
+
+ // Assume that triangulateGlyphs returns a triangle array with only coords & normals
+ // (and without by-ref, interleaved, etc.)
+ assert glyph_gar instanceof TriangleArrayRetained :
+ "Font3D: GeometryArray is not an instance of TrangleArray";
+ assert glyph_gar.getVertexFormat() == (GeometryArray.COORDINATES | GeometryArray.NORMALS) :
+ "Font3D: Illegal GeometryArray format -- only coordinates and normals expected";
+
+ // create a correctly sized TriangleArray
+ TriangleArray ga = new TriangleArray(glyph_gar.getVertexCount(),glyph_gar.getVertexFormat());
+
+ // temp storage for coords, normals
+ float tmp[] = new float[3];
+
+ int vertexCount = ga.getVertexCount();
+ for(int i=0; i
+ * extrusion shape : null
+ *
+ * A null extrusion shape specifies that a straight line from 0.0
+ * to 0.2 (straight bevel) is used.
+ *
+ * @see Font3D
+ */
+ public FontExtrusion() {
+ shape = null;
+ }
+
+ /**
+ * Constructs a FontExtrusion object with the specified shape, using
+ * the default tessellation tolerance. The
+ * specified shape is used to construct the edge
+ * contour of a Font3D object. Each shape begins with an implicit
+ * point at 0.0. Contour must be monotonic in x.
+ *
+ * @param extrusionShape the shape object to use to generate the
+ * extrusion path.
+ * A null shape specifies that a straight line from 0.0 to 0.2
+ * (straight bevel) is used.
+ *
+ * @exception IllegalArgumentException if multiple contours in
+ * extrusionShape, or contour is not monotonic or least x-value
+ * of a contour point is not 0.0f
+ *
+ * @see Font3D
+ */
+ public FontExtrusion(Shape extrusionShape) {
+ setExtrusionShape(extrusionShape);
+ }
+
+
+ /**
+ * Constructs a FontExtrusion object with the specified shape, using
+ * the specified tessellation tolerance. The
+ * specified shape is used to construct the edge
+ * contour of a Font3D object. Each shape begins with an implicit
+ * point at 0.0. Contour must be monotonic in x.
+ *
+ * @param extrusionShape the shape object to use to generate the
+ * extrusion path.
+ * A null shape specifies that a straight line from 0.0 to 0.2
+ * (straight bevel) is used.
+ * @param tessellationTolerance the tessellation tolerance value
+ * used in tessellating the extrusion shape.
+ * This corresponds to the
+ * tessellation tolerance : 0.01
+ * flatness parameter in
+ * the java.awt.Shape.getPathIterator method.
+ *
+ * @exception IllegalArgumentException if multiple contours in
+ * extrusionShape, or contour is not monotonic or least x-value
+ * of a contour point is not 0.0f
+ *
+ * @see Font3D
+ *
+ * @since Java 3D 1.2
+ */
+ public FontExtrusion(Shape extrusionShape,
+ double tessellationTolerance) {
+
+ this.tessellationTolerance = tessellationTolerance;
+ setExtrusionShape(extrusionShape);
+ }
+
+
+ /**
+ * Sets the FontExtrusion's shape parameter. This
+ * parameter is used to construct the 3D contour of a Font3D object.
+ *
+ * @param extrusionShape the shape object to use to generate the
+ * extrusion path.
+ * A null shape specifies that a straight line from 0.0 to 0.2
+ * (straight bevel) is used.
+ *
+ * @exception IllegalArgumentException if multiple contours in
+ * extrusionShape, or contour is not monotonic or least x-value
+ * of a contour point is not 0.0f
+ *
+ * @see Font3D
+ * @see java.awt.Shape
+ */
+ public void setExtrusionShape(Shape extrusionShape) {
+ shape = extrusionShape;
+ if (shape == null) return;
+
+ PathIterator pIt = shape.getPathIterator(null, tessellationTolerance);
+ ArrayList coords = new ArrayList();
+ float tmpCoords[] = new float[6], prevX = 0.0f;
+ int flag, n = 0, inc = -1;
+
+ // Extrusion shape is restricted to be single contour, monotonous
+ // increasing, non-self-intersecting curve. Throw exception otherwise
+ while (!pIt.isDone()) {
+ Point2f vertex = new Point2f();
+ flag = pIt.currentSegment(tmpCoords);
+ if (flag == PathIterator.SEG_LINETO){
+ vertex.x = tmpCoords[0];
+ vertex.y = tmpCoords[1];
+ if (inc == -1){
+ if (prevX < vertex.x) inc = 0;
+ else if (prevX > vertex.x) inc = 1;
+ }
+ //Flag 'inc' indicates if curve is monotonic increasing or
+ // monotonic decreasing. It is set to -1 initially and remains
+ // -1 if consecutive x values are same. Once 'inc' is set to
+ // 1 or 0, exception is thrown is curve changes direction.
+ if (((inc == 0) && (prevX > vertex.x)) ||
+ ((inc == 1) && (prevX < vertex.x)))
+ throw new IllegalArgumentException(J3dI18N.getString("FontExtrusion0"));
+
+ prevX = vertex.x;
+ n++;
+ coords.add(vertex);
+ }else if (flag == PathIterator.SEG_MOVETO){
+ if (n != 0)
+ throw new IllegalArgumentException(J3dI18N.getString("FontExtrusion3"));
+
+ vertex.x = tmpCoords[0];
+ vertex.y = tmpCoords[1];
+ prevX = vertex.x;
+ n++;
+ coords.add(vertex);
+ }
+ pIt.next();
+ }
+
+ //if (inc == 1){
+ //Point2f vertex = new Point2f(0.0f, 0.0f);
+ //coords.add(vertex);
+ //}
+ int i, num = coords.size();
+ pnts = new Point2f[num];
+ //System.err.println("num "+num+" inc "+inc);
+ if (inc == 0){
+ for (i=0;i < num;i++){
+ pnts[i] = (Point2f)coords.get(i);
+ //System.err.println("i "+i+" x "+ pnts[i].x+" y "+pnts[i].y);
+ }
+ }
+ else {
+ for (i=0;i < num;i++) {
+ pnts[i] = (Point2f)coords.get(num - i -1);
+ //System.err.println("i "+i+" x "+ pnts[i].x+" y "+pnts[i].y);
+ }
+ }
+
+ //Force last y to be zero until Text3D face scaling is implemented
+ pnts[num-1].y = 0.0f;
+ if (pnts[0].x != 0.0f)
+ throw new IllegalArgumentException(J3dI18N.getString("FontExtrusion1"));
+
+ //Compute straight line distance between first and last points.
+ float dx = (pnts[0].x - pnts[num-1].x);
+ float dy = (pnts[0].y - pnts[num-1].y);
+ length = (float)Math.sqrt(dx*dx + dy*dy);
+ }
+
+
+ /**
+ * Gets the FontExtrusion's shape parameter. This
+ * parameter is used to construct the 3D contour of a Font3D object.
+ *
+ * @return extrusionShape the shape object used to generate the
+ * extrusion path
+ *
+ * @see Font3D
+ * @see java.awt.Shape
+ */
+ public Shape getExtrusionShape() {
+ return shape;
+ }
+
+
+ /**
+ * Returns the tessellation tolerance with which this FontExtrusion was
+ * created.
+ * @return the tessellation tolerance used by this FontExtrusion
+ *
+ * @since Java 3D 1.2
+ */
+ public double getTessellationTolerance() {
+ return tessellationTolerance;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/FreeListManager.java b/j3d-core/src/classes/share/javax/media/j3d/FreeListManager.java
new file mode 100644
index 0000000..aa40a8e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/FreeListManager.java
@@ -0,0 +1,94 @@
+/*
+ * $RCSfile: FreeListManager.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+class FreeListManager {
+
+ private static final boolean DEBUG = false;
+
+ // constants that represent the freelists managed by the Manager
+ static final int DISPLAYLIST = 0;
+ static final int TEXTURE2D = 1;
+ static final int TEXTURE3D = 2;
+
+ private static int maxFreeListNum = 2;
+
+ // what list we are going to shrink next
+ private static int currlist = 0;
+
+ static MemoryFreeList[] freelist = null;
+
+ static void createFreeLists() {
+ maxFreeListNum = 2;
+ freelist = new MemoryFreeList[maxFreeListNum+1];
+ freelist[DISPLAYLIST] = new IntegerFreeList();
+ freelist[TEXTURE2D] = new IntegerFreeList();
+ freelist[TEXTURE3D] = new IntegerFreeList();
+
+ }
+
+ // see if the current list can be shrunk
+ static void manageLists() {
+// System.err.println("manageLists");
+ if (freelist[currlist] != null) {
+ freelist[currlist].shrink();
+ }
+
+ currlist++;
+ if (currlist > maxFreeListNum) currlist = 0;
+ }
+
+ // return the freelist specified by the list param
+ static MemoryFreeList getFreeList(int list) {
+ if (list < 0 || list > maxFreeListNum) {
+ if (DEBUG) System.err.println("illegal list");
+ return null;
+ }
+ else {
+ return freelist[list];
+ }
+ }
+
+ static Object getObject(int listId) {
+ return freelist[listId].getObject();
+ }
+
+ static void freeObject(int listId, Object obj) {
+ freelist[listId].add(obj);
+ }
+
+ static void clearList(int listId) {
+ freelist[listId].clear();
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GLSLShaderProgram.java b/j3d-core/src/classes/share/javax/media/j3d/GLSLShaderProgram.java
new file mode 100644
index 0000000..b29813c
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GLSLShaderProgram.java
@@ -0,0 +1,177 @@
+/*
+ * $RCSfile: GLSLShaderProgram.java,v $
+ *
+ * Copyright 2004-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The GLSLShaderProgram object is a concrete implementation of a
+ * ShaderProgram node component for the OpenGL GLSL shading language.
+ *
+ * @see SourceCodeShader
+ *
+ * @since Java 3D 1.4
+ */
+
+public class GLSLShaderProgram extends ShaderProgram {
+
+ /**
+ * Constructs a GLSL shader program node component.
+ *
+ *
+ * TODO: ADD MORE DOCUMENTATION HERE.
+ */
+ public GLSLShaderProgram() {
+ }
+
+ // Implement abstract setVertexAttrNames method (inherit javadoc from parent class)
+ public void setVertexAttrNames(String[] vertexAttrNames) {
+ checkForLiveOrCompiled();
+
+ if (vertexAttrNames != null) {
+ for (int i = 0; i < vertexAttrNames.length; i++) {
+ if (vertexAttrNames[i] == null) {
+ throw new NullPointerException();
+ }
+ }
+ }
+
+ ((GLSLShaderProgramRetained)this.retained).setVertexAttrNames(vertexAttrNames);
+ }
+
+ // Implement abstract getVertexAttrNames method (inherit javadoc from parent class)
+ public String[] getVertexAttrNames() {
+
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_NAMES_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GLSLShaderProgram0"));
+ }
+ }
+
+ return ((GLSLShaderProgramRetained)this.retained).getVertexAttrNames();
+
+ }
+
+ // Implement abstract setShaderAttrNames method (inherit javadoc from parent class)
+ public void setShaderAttrNames(String[] shaderAttrNames) {
+ checkForLiveOrCompiled();
+
+ if (shaderAttrNames != null) {
+ for (int i = 0; i < shaderAttrNames.length; i++) {
+ if (shaderAttrNames[i] == null) {
+ throw new NullPointerException();
+ }
+ }
+ }
+
+ ((GLSLShaderProgramRetained)this.retained).setShaderAttrNames(shaderAttrNames);
+ }
+
+ // Implement abstract getShaderAttrNames method (inherit javadoc from parent class)
+ public String[] getShaderAttrNames() {
+
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_NAMES_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GLSLShaderProgram0"));
+ }
+ }
+
+ return ((GLSLShaderProgramRetained)this.retained).getShaderAttrNames();
+
+ }
+
+ /**
+ * Copies the specified array of shaders into this shader
+ * program. This method makes a shallow copy of the array. The
+ * array of shaders may be null or empty (0 length), but the
+ * elements of the array must be non-null. The shading language of
+ * each shader in the array must be
+ * SHADING_LANGUAGE_GLSL. Each shader in the array must
+ * be a SourceCodeShader.
+ *
+ * @param shaders array of Shader objects to be copied into this
+ * ShaderProgram
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalArgumentException if the shading language of
+ * any shader in the shaders array is not
+ * SHADING_LANGUAGE_GLSL.
+ *
+ * @exception ClassCastException if any shader in the shaders
+ * array is not a SourceCodeShader.
+ *
+ * @exception NullPointerException if any element in the
+ * shaders array is null.
+ */
+ public void setShaders(Shader[] shaders) {
+ checkForLiveOrCompiled();
+
+ if(shaders != null) {
+ // Check shaders for valid shading language and class type
+ for (int i = 0; i < shaders.length; i++) {
+ if (shaders[i].getShadingLanguage() != Shader.SHADING_LANGUAGE_GLSL) {
+ throw new IllegalArgumentException(J3dI18N.getString("GLSLShaderProgram2"));
+ }
+
+ // Try to cast shader to SourceCodeShader; it will throw
+ // ClassCastException if it isn't.
+ SourceCodeShader shad = (SourceCodeShader)shaders[i];
+ }
+
+ }
+
+ ((GLSLShaderProgramRetained)this.retained).setShaders(shaders);
+ }
+
+ // Implement abstract getShaders method (inherit javadoc from parent class)
+ public Shader[] getShaders() {
+
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_SHADERS_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GLSLShaderProgram1"));
+ }
+ }
+
+ return ((GLSLShaderProgramRetained)this.retained).getShaders();
+ }
+
+ /**
+ * Creates a retained mode GLSLShaderProgramRetained object that this
+ * GLSLShaderProgram component object will point to.
+ */
+ void createRetained() {
+ this.retained = new GLSLShaderProgramRetained();
+ this.retained.setSource(this);
+ }
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GLSLShaderProgramRetained.java b/j3d-core/src/classes/share/javax/media/j3d/GLSLShaderProgramRetained.java
new file mode 100644
index 0000000..830171d
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GLSLShaderProgramRetained.java
@@ -0,0 +1,401 @@
+/*
+ * $RCSfile: GLSLShaderProgramRetained.java,v $
+ *
+ * Copyright 2005-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The GLSLShaderProgram object is a concrete implementation of a
+ * ShaderProgram node component for the OpenGL GLSL shading language.
+ */
+
+class GLSLShaderProgramRetained extends ShaderProgramRetained {
+
+ /**
+ * Constructs a GLSL shader program node component.
+ */
+ GLSLShaderProgramRetained() {
+ }
+
+ synchronized void createMirrorObject() {
+ // System.err.println("GLSLShaderProgramRetained : createMirrorObject");
+ // This method should only call by setLive().
+ if (mirror == null) {
+ GLSLShaderProgramRetained mirrorGLSLSP = new GLSLShaderProgramRetained();
+ mirror = mirrorGLSLSP;
+ mirror.source = source;
+ }
+ initMirrorObject();
+ }
+
+ // ShaderAttributeValue methods
+
+ ShaderError setUniform1i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int value) {
+
+ return Pipeline.getPipeline().setGLSLUniform1i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform1f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float value) {
+
+ return Pipeline.getPipeline().setGLSLUniform1f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform2i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform2i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform2f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform2f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform3i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform3i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform3f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform3f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform4i(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform4i(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniform4f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform4f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniformMatrix3f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniformMatrix3f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ ShaderError setUniformMatrix4f(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniformMatrix4f(ctx,
+ shaderProgramId,
+ uniformLocation,
+ value);
+ }
+
+ // ShaderAttributeArray methods
+
+ ShaderError setUniform1iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform1iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform1fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform1fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform2iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform2iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform2fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform2fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform3iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform3iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform3fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform3fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform4iArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ int[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform4iArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniform4fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniform4fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniformMatrix3fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniformMatrix3fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ ShaderError setUniformMatrix4fArray(Context ctx,
+ ShaderProgramId shaderProgramId,
+ ShaderAttrLoc uniformLocation,
+ int numElements,
+ float[] value) {
+
+ return Pipeline.getPipeline().setGLSLUniformMatrix4fArray(ctx,
+ shaderProgramId,
+ uniformLocation,
+ numElements,
+ value);
+ }
+
+ /**
+ * Method to return a flag indicating whether this
+ * ShaderProgram is supported on the specified Canvas.
+ */
+ boolean isSupported(Canvas3D cv) {
+ return cv.shadingLanguageGLSL;
+ }
+
+ /**
+ * Method to create the native shader.
+ */
+ ShaderError createShader(Context ctx, ShaderRetained shader, ShaderId[] shaderIdArr) {
+ return Pipeline.getPipeline().createGLSLShader(ctx, shader.shaderType, shaderIdArr);
+ }
+
+ /**
+ * Method to destroy the native shader.
+ */
+ ShaderError destroyShader(Context ctx, ShaderId shaderId) {
+ return Pipeline.getPipeline().destroyGLSLShader(ctx, shaderId);
+ }
+
+ /**
+ * Method to compile the native shader.
+ */
+ ShaderError compileShader(Context ctx, ShaderId shaderId, String source) {
+ return Pipeline.getPipeline().compileGLSLShader(ctx, shaderId, source );
+ }
+
+ /**
+ * Method to create the native shader program.
+ */
+ ShaderError createShaderProgram(Context ctx, ShaderProgramId[] shaderProgramIdArr) {
+ return Pipeline.getPipeline().createGLSLShaderProgram(ctx, shaderProgramIdArr);
+ }
+
+ /**
+ * Method to destroy the native shader program.
+ */
+ ShaderError destroyShaderProgram(Context ctx, ShaderProgramId shaderProgramId) {
+ return Pipeline.getPipeline().destroyGLSLShaderProgram(ctx, shaderProgramId);
+ }
+
+ /**
+ * Method to link the native shader program.
+ */
+ ShaderError linkShaderProgram(Context ctx, ShaderProgramId shaderProgramId, ShaderId[] shaderIds) {
+ return Pipeline.getPipeline().linkGLSLShaderProgram(ctx, shaderProgramId, shaderIds);
+ }
+
+ ShaderError bindVertexAttrName(Context ctx, ShaderProgramId shaderProgramId, String attrName, int attrIndex) {
+ return Pipeline.getPipeline().bindGLSLVertexAttrName(ctx, shaderProgramId, attrName, attrIndex);
+ }
+
+ void lookupVertexAttrNames(Context ctx, ShaderProgramId shaderProgramId, String[] attrNames, boolean[] errArr) {
+ // This method is a no-op for GLSL
+ }
+
+ void lookupShaderAttrNames(Context ctx, ShaderProgramId shaderProgramId,
+ String[] attrNames, AttrNameInfo[] attrNameInfoArr) {
+
+ int numAttrNames = attrNames.length;
+
+ ShaderAttrLoc[] locArr = new ShaderAttrLoc[numAttrNames];
+ int[] typeArr = new int[numAttrNames];
+ int[] sizeArr = new int[numAttrNames]; // currently unused
+ boolean[] isArrayArr = new boolean[numAttrNames];
+
+ Pipeline.getPipeline().lookupGLSLShaderAttrNames(ctx, shaderProgramId,
+ numAttrNames, attrNames, locArr, typeArr, sizeArr, isArrayArr);
+
+ for (int i = 0; i < numAttrNames; i++) {
+ attrNameInfoArr[i] = new AttrNameInfo();
+ attrNameInfoArr[i].setLocation(locArr[i]);
+ attrNameInfoArr[i].setArray(isArrayArr[i]);
+ attrNameInfoArr[i].setType(typeArr[i]);
+// System.err.println(attrNames[i] +
+// " : loc = " + locArr[i] +
+// ", type = " + typeArr[i] +
+// ", isArray = " + isArrayArr[i] +
+// ", size = " + sizeArr[i]);
+ }
+ }
+
+ /**
+ * Method to enable the native shader program.
+ */
+ ShaderError enableShaderProgram(Context ctx, ShaderProgramId shaderProgramId) {
+ return Pipeline.getPipeline().useGLSLShaderProgram(ctx, shaderProgramId);
+ }
+
+ /**
+ * Method to disable the native shader program.
+ */
+ ShaderError disableShaderProgram(Context ctx) {
+ return Pipeline.getPipeline().useGLSLShaderProgram(ctx, null);
+ }
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GeneralizedStrip.java b/j3d-core/src/classes/share/javax/media/j3d/GeneralizedStrip.java
new file mode 100644
index 0000000..5c41992
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GeneralizedStrip.java
@@ -0,0 +1,894 @@
+/*
+ * $RCSfile: GeneralizedStrip.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+import java.util.* ;
+
+
+/**
+ * This class provides static methods to support topological
+ * transformations on generalized strips. This is used by the
+ * GeometryDecompressor. These methods only need to look at the
+ * vertex replacement flags to determine how the vertices in the strip
+ * are connected. The connections are rearranged in different ways to
+ * transform generalized strips to GeometryArray representations.
+ *
+ * @see GeneralizedStripFlags
+ * @see GeneralizedVertexList
+ * @see GeometryDecompressor
+ */
+class GeneralizedStrip {
+ private static final boolean debug = false ;
+
+ // Private convenience copies of various constants.
+ private static final int CW =
+ GeneralizedStripFlags.FRONTFACE_CW ;
+ private static final int CCW =
+ GeneralizedStripFlags.FRONTFACE_CCW ;
+ private static final int RESTART_CW =
+ GeneralizedStripFlags.RESTART_CW ;
+ private static final int RESTART_CCW =
+ GeneralizedStripFlags.RESTART_CCW ;
+ private static final int REPLACE_MIDDLE =
+ GeneralizedStripFlags.REPLACE_MIDDLE ;
+ private static final int REPLACE_OLDEST =
+ GeneralizedStripFlags.REPLACE_OLDEST ;
+
+ /**
+ * The IntList is like an ArrayList, but avoids the Integer
+ * object wrapper and accessor overhead for simple lists of ints.
+ */
+ static class IntList {
+ /**
+ * The array of ints.
+ */
+ int ints[] ;
+
+ /**
+ * The number of ints in this instance.
+ */
+ int count ;
+
+ /**
+ * Construct a new empty IntList of the given initial size.
+ * @param initialSize initial size of the backing array
+ */
+ IntList(int initialSize) {
+ ints = new int[initialSize] ;
+ count = 0 ;
+ }
+
+ /**
+ * Constructs an IntList with the given contents.
+ * @param ints the array of ints to use as the contents
+ */
+ IntList(int ints[]) {
+ this.ints = ints ;
+ this.count = ints.length ;
+ }
+
+ /**
+ * Add a new int to the end of this list.
+ * @param i the int to be appended to this list
+ */
+ void add(int i) {
+ if (count == ints.length) {
+ int newints[] = new int[2*count] ;
+ System.arraycopy(ints, 0, newints, 0, count) ;
+ ints = newints ;
+ if (debug)
+ System.err.println
+ ("GeneralizedStrip.IntList: reallocated " +
+ (2*count) + " ints") ;
+ }
+ ints[count++] = i ;
+ }
+
+ /**
+ * Trim the backing array to the current count and return the
+ * resulting backing array.
+ */
+ int[] trim() {
+ if (count != ints.length) {
+ int newints[] = new int[count] ;
+ System.arraycopy(ints, 0, newints, 0, count) ;
+ ints = newints ;
+ }
+ return ints ;
+ }
+
+ /**
+ * Fill the list with consecutive integers starting from 0.
+ */
+ void fillAscending() {
+ for (int i = 0 ; i < ints.length ; i++)
+ ints[i] = i ;
+
+ count = ints.length ;
+ }
+
+ public String toString() {
+ String s = new String("[") ;
+ for (int i = 0 ; i < count-1 ; i++)
+ s = s + Integer.toString(ints[i]) + ", " ;
+ return s + Integer.toString(ints[count-1]) + "]" ;
+ }
+ }
+
+ /**
+ * The StripArray class is used as the output of some conversion methods
+ * in the GeneralizedStrip class.
+ */
+ static class StripArray {
+ /**
+ * A list of indices into the vertices of the original generalized
+ * strip. It specifies the order in which vertices in the original
+ * strip should be followed to build GeometryArray objects.
+ */
+ IntList vertices ;
+
+ /**
+ * A list of strip counts.
+ */
+ IntList stripCounts ;
+
+ /**
+ * Creates a StripArray with the specified vertices and stripCounts.
+ * @param vertices IntList containing vertex indicies.
+ * @param stripCounts IntList containing strip lengths.
+ */
+ StripArray(IntList vertices, IntList stripCounts) {
+ this.vertices = vertices ;
+ this.stripCounts = stripCounts ;
+ }
+ }
+
+ /**
+ * Interprets the vertex flags associated with a class implementing
+ * GeneralizedStripFlags, constructing and returning a 2-element array of
+ * StripArray objects. The first StripArray will contain triangle strips
+ * and the second will contain triangle fans.
+ *
+ * @param vertices an object implementing GeneralizedStripFlags
+ * @param frontFace a flag, either GeneralizedStripFlags.FRONTFACE_CW or
+ * GeneralizedStripFlags.FRONTFACE_CCW, indicating front face winding
+ * @return a 2-element array containing strips in 0 and fans in 1
+ */
+ static StripArray[] toStripsAndFans(GeneralizedStripFlags vertices,
+ int frontFace) {
+
+ int size = vertices.getFlagCount() ;
+
+ // Initialize IntLists to worst-case sizes.
+ IntList stripVerts = new IntList(size*3) ;
+ IntList fanVerts = new IntList(size*3) ;
+ IntList stripCounts = new IntList(size) ;
+ IntList fanCounts = new IntList(size) ;
+
+ toStripsAndFans(vertices, frontFace,
+ stripVerts, stripCounts, fanVerts, fanCounts) ;
+
+ // Construct the StripArray output.
+ StripArray sa[] = new StripArray[2] ;
+
+ if (stripCounts.count > 0)
+ sa[0] = new StripArray(stripVerts, stripCounts) ;
+
+ if (fanCounts.count > 0)
+ sa[1] = new StripArray(fanVerts, fanCounts) ;
+
+ return sa ;
+ }
+
+ private static void toStripsAndFans(GeneralizedStripFlags vertices,
+ int frontFace,
+ IntList stripVerts,
+ IntList stripCounts,
+ IntList fanVerts,
+ IntList fanCounts) {
+ int newFlag, curFlag, winding ;
+ int v, size, stripStart, stripLength ;
+ boolean transition = false ;
+
+ stripStart = 0 ;
+ stripLength = 3 ;
+ curFlag = vertices.getFlag(0) ;
+ winding = (curFlag == RESTART_CW ? CW : CCW) ;
+ size = vertices.getFlagCount() ;
+
+ // Vertex replace flags for the first 3 vertices are irrelevant since
+ // they can only define a single triangle. The first meaningful
+ // replace flag starts at the 4th vertex.
+ v = 3 ;
+ if (v < size)
+ curFlag = vertices.getFlag(v) ;
+
+ while (v < size) {
+ newFlag = vertices.getFlag(v) ;
+
+ if ((newFlag == curFlag) &&
+ (newFlag != RESTART_CW) && (newFlag != RESTART_CCW)) {
+ // The last flag was the same as this one, and it wasn't a
+ // restart: proceed to the next vertex.
+ stripLength++ ;
+ v++ ;
+
+ } else {
+ // Either this vertex flag changed from the last one, or
+ // the flag explicitly specifies a restart: process the
+ // last strip and start up a new one.
+ if (curFlag == REPLACE_MIDDLE)
+ addFan(fanVerts, fanCounts, stripStart, stripLength,
+ frontFace, winding, transition) ;
+ else
+ addStrip(stripVerts, stripCounts, stripStart, stripLength,
+ frontFace, winding) ;
+
+ // Restart: skip to the 4th vertex of the new strip.
+ if ((newFlag == RESTART_CW) || (newFlag == RESTART_CCW)) {
+ winding = (newFlag == RESTART_CW ? CW : CCW) ;
+ stripStart = v ;
+ stripLength = 3 ;
+ v += 3 ;
+ transition = false ;
+ if (v < size)
+ curFlag = vertices.getFlag(v) ;
+ }
+ // Strip/fan transition: decrement start of strip.
+ else {
+ if (newFlag == REPLACE_OLDEST) {
+ // Flip winding order when transitioning from fans
+ // to strips.
+ winding = (winding == CW ? CCW : CW) ;
+ stripStart = v-2 ;
+ stripLength = 3 ;
+ } else {
+ // Flip winding order when transitioning from
+ // strips to fans only if the preceding strip has
+ // an even number of vertices.
+ if ((stripLength & 0x01) == 0)
+ winding = (winding == CW ? CCW : CW) ;
+ stripStart = v-3 ;
+ stripLength = 4 ;
+ }
+ v++ ;
+ transition = true ;
+ curFlag = newFlag ;
+ }
+ }
+ }
+
+ // Finish off the last strip or fan.
+ // If v > size then the strip is degenerate.
+ if (v == size)
+ if (curFlag == REPLACE_MIDDLE)
+ addFan(fanVerts, fanCounts, stripStart, stripLength,
+ frontFace, winding, transition) ;
+ else
+ addStrip(stripVerts, stripCounts, stripStart, stripLength,
+ frontFace, winding) ;
+ else
+ throw new IllegalArgumentException
+ (J3dI18N.getString("GeneralizedStrip0")) ;
+
+ if (debug) {
+ System.err.println("GeneralizedStrip.toStripsAndFans") ;
+ if (v > size)
+ System.err.println(" ended with a degenerate triangle:" +
+ " number of vertices: " + (v-size)) ;
+
+ System.err.println("\n number of strips: " + stripCounts.count) ;
+ if (stripCounts.count > 0) {
+ System.err.println(" number of vertices: " + stripVerts.count) ;
+ System.err.println(" vertices/strip: " +
+ (float)stripVerts.count/stripCounts.count) ;
+ System.err.println(" strip counts: " + stripCounts.toString()) ;
+ // System.err.println(" indices: " + stripVerts.toString()) ;
+ }
+
+ System.err.println("\n number of fans: " + fanCounts.count) ;
+ if (fanCounts.count > 0) {
+ System.err.println(" number of vertices: " + fanVerts.count) ;
+ System.err.println(" vertices/strip: " +
+ (float)fanVerts.count/fanCounts.count) ;
+ System.err.println(" fan counts: " + fanCounts.toString()) ;
+ // System.err.println(" indices: " + fanVerts.toString()) ;
+ }
+ System.err.println("\n total vertices: " +
+ (stripVerts.count + fanVerts.count) +
+ "\n original number of vertices: " + size +
+ "\n") ;
+ }
+ }
+
+ //
+ // Java 3D specifies that the vertices of front-facing polygons
+ // have counter-clockwise (CCW) winding order when projected to
+ // the view surface. Polygons with clockwise (CW) vertex winding
+ // will be culled as back-facing by default.
+ //
+ // Generalized triangle strips can flip the orientation of their
+ // triangles with the RESTART_CW and RESTART_CCW vertex flags.
+ // Strips flagged with an orientation opposite to what has been
+ // specified as front-facing must have their windings reversed in
+ // order to have the correct face orientation when represented as
+ // GeometryArray objects.
+ //
+ private static void addStrip(IntList stripVerts,
+ IntList stripCounts,
+ int start, int length,
+ int frontFace, int winding) {
+ int vindex = start ;
+
+ if (winding == frontFace) {
+ // Maintain original order.
+ stripCounts.add(length) ;
+ while (vindex < start + length) {
+ stripVerts.add(vindex++) ;
+ }
+ } else if ((length & 0x1) == 1) {
+ // Reverse winding order if number of vertices is odd.
+ stripCounts.add(length) ;
+ vindex += length-1 ;
+ while (vindex >= start) {
+ stripVerts.add(vindex--) ;
+ }
+ } else if (length == 4) {
+ // Swap middle vertices.
+ stripCounts.add(4) ;
+ stripVerts.add(vindex) ;
+ stripVerts.add(vindex+2) ;
+ stripVerts.add(vindex+1) ;
+ stripVerts.add(vindex+3) ;
+ } else {
+ // Make the 1st triangle a singleton with reverse winding.
+ stripCounts.add(3) ;
+ stripVerts.add(vindex) ;
+ stripVerts.add(vindex+2) ;
+ stripVerts.add(vindex+1) ;
+ if (length > 3) {
+ // Copy the rest of the vertices in original order.
+ vindex++ ;
+ stripCounts.add(length-1) ;
+ while (vindex < start + length) {
+ stripVerts.add(vindex++) ;
+ }
+ }
+ }
+ }
+
+ private static void addFan(IntList fanVerts,
+ IntList fanCounts,
+ int start, int length,
+ int frontFace, int winding,
+ boolean transition) {
+ int vindex = start ;
+ fanVerts.add(vindex++) ;
+
+ if (winding == frontFace) {
+ if (transition) {
+ // Skip 1st triangle if this is the result of a transition.
+ fanCounts.add(length-1) ;
+ vindex++ ;
+ } else {
+ fanCounts.add(length) ;
+ fanVerts.add(vindex++) ;
+ }
+ while (vindex < start + length) {
+ fanVerts.add(vindex++) ;
+ }
+ } else {
+ // Reverse winding order.
+ vindex += length-2 ;
+ while (vindex > start+1) {
+ fanVerts.add(vindex--) ;
+ }
+ if (transition) {
+ // Skip 1st triangle if this is the result of a transition.
+ fanCounts.add(length-1) ;
+ } else {
+ fanCounts.add(length) ;
+ fanVerts.add(vindex) ;
+ }
+ }
+ }
+
+ /**
+ * Interprets the vertex flags associated with a class implementing
+ * GeneralizedStripFlags, constructing and returning a StripArray containing
+ * exclusively strips.
+ *
+ * @param vertices an object implementing GeneralizedStripFlags
+ * @param frontFace a flag, either GeneralizedStripFlags.FRONTFACE_CW or
+ * GeneralizedStripFlags.FRONTFACE_CCW, indicating front face winding
+ * @return a StripArray containing the converted strips
+ */
+ static StripArray toTriangleStrips(GeneralizedStripFlags vertices,
+ int frontFace) {
+
+ int size = vertices.getFlagCount() ;
+
+ // initialize lists to worst-case sizes.
+ IntList stripVerts = new IntList(size*3) ;
+ IntList fanVerts = new IntList(size*3) ;
+ IntList stripCounts = new IntList(size) ;
+ IntList fanCounts = new IntList(size) ;
+
+ toStripsAndFans(vertices, frontFace,
+ stripVerts, stripCounts, fanVerts, fanCounts) ;
+
+ if (fanCounts.count == 0)
+ if (stripCounts.count > 0)
+ return new StripArray(stripVerts, stripCounts) ;
+ else
+ return null ;
+
+ // convert each fan to one or more strips
+ int i, v = 0 ;
+ for (i = 0 ; i < fanCounts.count ; i++) {
+ fanToStrips(v, fanCounts.ints[i], fanVerts.ints,
+ stripVerts, stripCounts, false) ;
+ v += fanCounts.ints[i] ;
+ }
+
+ // create the StripArray output
+ StripArray sa = new StripArray(stripVerts, stripCounts) ;
+
+ if (debug) {
+ System.err.println("GeneralizedStrip.toTriangleStrips" +
+ "\n number of strips: " +
+ sa.stripCounts.count) ;
+ if (sa.stripCounts.count > 0) {
+ System.err.println(" number of vertices: " +
+ sa.vertices.count +
+ "\n vertices/strip: " +
+ ((float)sa.vertices.count /
+ (float)sa.stripCounts.count)) ;
+ System.err.print(" strip counts: [") ;
+ for (i = 0 ; i < sa.stripCounts.count-1 ; i++)
+ System.err.print(sa.stripCounts.ints[i] + ", ") ;
+ System.err.println(sa.stripCounts.ints[i] + "]") ;
+ }
+ System.err.println() ;
+ }
+ return sa ;
+ }
+
+ private static void fanToStrips(int v, int length, int fans[],
+ IntList stripVerts,
+ IntList stripCounts,
+ boolean convexPlanar) {
+ if (convexPlanar) {
+ // Construct a strip by criss-crossing across the interior.
+ stripCounts.add(length) ;
+ stripVerts.add(fans[v]) ;
+
+ int j = v + 1 ;
+ int k = v + (length - 1) ;
+ while (j <= k) {
+ stripVerts.add(fans[j++]) ;
+ if (j > k) break ;
+ stripVerts.add(fans[k--]) ;
+ }
+ } else {
+ // Traverse non-convex or non-planar fan, biting off 3-triangle
+ // strips or less. First 5 vertices produce 1 strip of 3
+ // triangles, and every 4 vertices after that produce another
+ // strip of 3 triangles. Each remaining strip adds 2 vertices.
+ int fanStart = v ;
+ v++ ;
+ while (v+4 <= fanStart + length) {
+ stripVerts.add(fans[v]) ;
+ stripVerts.add(fans[v+1]) ;
+ stripVerts.add(fans[fanStart]) ;
+ stripVerts.add(fans[v+2]) ;
+ stripVerts.add(fans[v+3]) ;
+ stripCounts.add(5) ;
+ v += 3 ;
+ }
+
+ // Finish off the fan.
+ if (v+1 < fanStart + length) {
+ stripVerts.add(fans[v]) ;
+ stripVerts.add(fans[v+1]) ;
+ stripVerts.add(fans[fanStart]) ;
+ v++ ;
+
+ if (v+1 < fanStart + length) {
+ stripVerts.add(fans[v+1]) ;
+ stripCounts.add(4) ;
+ }
+ else
+ stripCounts.add(3) ;
+ }
+ }
+ }
+
+ /**
+ * Interprets the vertex flags associated with a class implementing
+ * GeneralizedStripFlags, constructing and returning an array of vertex
+ * references representing the original generalized strip as individual
+ * triangles. Each sequence of three consecutive vertex references in the
+ * output defines a single triangle.
+ *
+ * @param vertices an object implementing GeneralizedStripFlags
+ * @param frontFace a flag, either GeneralizedStripFlags.FRONTFACE_CW or
+ * GeneralizedStripFlags.FRONTFACE_CCW, indicating front face winding
+ * @return an array of indices into the original vertex array
+ */
+ static int[] toTriangles(GeneralizedStripFlags vertices, int frontFace) {
+
+ int vertexCount = 0 ;
+ StripArray sa[] = toStripsAndFans(vertices, frontFace) ;
+
+ if (sa[0] != null)
+ vertexCount = 3 * getTriangleCount(sa[0].stripCounts) ;
+ if (sa[1] != null)
+ vertexCount += 3 * getTriangleCount(sa[1].stripCounts) ;
+
+ if (debug)
+ System.err.println("GeneralizedStrip.toTriangles\n" +
+ " number of triangles: " + vertexCount/3 + "\n" +
+ " number of vertices: " + vertexCount + "\n") ;
+ int t = 0 ;
+ int triangles[] = new int[vertexCount] ;
+
+ if (sa[0] != null)
+ t = stripsToTriangles(t, triangles,
+ 0, sa[0].vertices.ints,
+ 0, sa[0].stripCounts.ints,
+ sa[0].stripCounts.count) ;
+ if (sa[1] != null)
+ t = fansToTriangles(t, triangles,
+ 0, sa[1].vertices.ints,
+ 0, sa[1].stripCounts.ints,
+ sa[1].stripCounts.count) ;
+ return triangles ;
+ }
+
+ private static int stripsToTriangles(int tstart, int tbuff[],
+ int vstart, int vertices[],
+ int stripStart, int stripCounts[],
+ int stripCount) {
+ int t = tstart ;
+ int v = vstart ;
+ for (int i = 0 ; i < stripCount ; i++) {
+ for (int j = 0 ; j < stripCounts[i+stripStart] - 2 ; j++) {
+ if ((j & 0x01) == 0) {
+ // even-numbered triangles
+ tbuff[t*3 +0] = vertices[v+0] ;
+ tbuff[t*3 +1] = vertices[v+1] ;
+ tbuff[t*3 +2] = vertices[v+2] ;
+ } else {
+ // odd-numbered triangles
+ tbuff[t*3 +0] = vertices[v+1] ;
+ tbuff[t*3 +1] = vertices[v+0] ;
+ tbuff[t*3 +2] = vertices[v+2] ;
+ }
+ t++ ; v++ ;
+ }
+ v += 2 ;
+ }
+ return t ;
+ }
+
+ private static int fansToTriangles(int tstart, int tbuff[],
+ int vstart, int vertices[],
+ int stripStart, int stripCounts[],
+ int stripCount) {
+ int t = tstart ;
+ int v = vstart ;
+ for (int i = 0 ; i < stripCount ; i++) {
+ for (int j = 0 ; j < stripCounts[i+stripStart] - 2 ; j++) {
+ tbuff[t*3 +0] = vertices[v] ;
+ tbuff[t*3 +1] = vertices[v+j+1] ;
+ tbuff[t*3 +2] = vertices[v+j+2] ;
+ t++ ;
+ }
+ v += stripCounts[i+stripStart] ;
+ }
+ return t ;
+ }
+
+ /**
+ * Interprets the vertex flags associated with a class implementing
+ * GeneralizedStripFlags, constructing and returning a 2-element array of
+ * StripArray objects. The first StripArray will contain triangle strips
+ * and the second will contain individual triangles in the vertices
+ * field. Short strips will be converted to individual triangles.
+ *
+ * @param vertices an object implementing GeneralizedStripFlags
+ * @param frontFace a flag, either GeneralizedStripFlags.FRONTFACE_CW or
+ * GeneralizedStripFlags.FRONTFACE_CCW, indicating front face winding
+ * @param shortStripSize strips this size or less will be converted to
+ * individual triangles if there are more than maxShortStrips of them
+ * @param maxShortStrips maximum number of short strips allowed before
+ * creating individual triangles
+ * @return a 2-element array containing strips in 0 and triangles in 1
+ */
+ static StripArray[] toStripsAndTriangles(GeneralizedStripFlags vertices,
+ int frontFace, int shortStripSize,
+ int maxShortStrips) {
+ int longStripCount = 0 ;
+ int longStripVertexCount = 0 ;
+ int shortStripCount = 0 ;
+ int triangleCount = 0 ;
+
+ StripArray sa[] = new StripArray[2] ;
+ StripArray ts = toTriangleStrips(vertices, frontFace) ;
+
+ for (int i = 0 ; i < ts.stripCounts.count ; i++)
+ if (ts.stripCounts.ints[i] <= shortStripSize) {
+ shortStripCount++ ;
+ triangleCount += ts.stripCounts.ints[i] - 2 ;
+ } else {
+ longStripCount++ ;
+ longStripVertexCount += ts.stripCounts.ints[i] ;
+ }
+
+ if (debug)
+ System.err.print("GeneralizedStrip.toStripsAndTriangles\n" +
+ " short strip size: " + shortStripSize +
+ " short strips tolerated: " + maxShortStrips +
+ " number of short strips: " + shortStripCount +
+ "\n\n") ;
+
+ if (shortStripCount <= maxShortStrips) {
+ sa[0] = ts ;
+ sa[1] = null ;
+ } else {
+ int si = 0 ; int newStripVerts[] = new int[longStripVertexCount] ;
+ int ci = 0 ; int newStripCounts[] = new int[longStripCount] ;
+ int ti = 0 ; int triangles[] = new int[3*triangleCount] ;
+ int vi = 0 ;
+
+ for (int i = 0 ; i < ts.stripCounts.count ; i++) {
+ if (ts.stripCounts.ints[i] <= shortStripSize) {
+ ti = stripsToTriangles(ti, triangles,
+ vi, ts.vertices.ints,
+ i, ts.stripCounts.ints, 1) ;
+ vi += ts.stripCounts.ints[i] ;
+ } else {
+ newStripCounts[ci++] = ts.stripCounts.ints[i] ;
+ for (int j = 0 ; j < ts.stripCounts.ints[i] ; j++)
+ newStripVerts[si++] = ts.vertices.ints[vi++] ;
+ }
+ }
+
+ if (longStripCount > 0)
+ sa[0] = new StripArray(new IntList(newStripVerts),
+ new IntList(newStripCounts)) ;
+ else
+ sa[0] = null ;
+
+ sa[1] = new StripArray(new IntList(triangles), null) ;
+
+ if (debug) {
+ System.err.println(" triangles separated: " + triangleCount) ;
+ if (longStripCount > 0) {
+ System.err.println
+ (" new vertices/strip: " +
+ ((float)longStripVertexCount/(float)longStripCount)) ;
+
+ System.err.print(" long strip counts: [") ;
+ for (int i = 0 ; i < longStripCount-1 ; i++)
+ System.err.print(newStripCounts[i++] + ", ") ;
+
+ System.err.println
+ (newStripCounts[longStripCount-1] + "]\n") ;
+ }
+ }
+ }
+ return sa ;
+ }
+
+ /**
+ * Interprets the vertex flags associated with a class implementing
+ * GeneralizedStripFlags, constructing and returning a StripArray.
+ *
+ * RESTART_CW and RESTART_CCW are treated as equivalent, as are
+ * REPLACE_MIDDLE and REPLACE_OLDEST.
+ *
+ * @param vertices an object implementing GeneralizedStripFlags
+ * @return a StripArray representing an array of line strips
+ */
+ static StripArray toLineStrips(GeneralizedStripFlags vertices) {
+ int v, size, stripStart, stripLength, flag ;
+
+ stripStart = 0 ;
+ stripLength = 2 ;
+ size = vertices.getFlagCount() ;
+
+ // Initialize IntLists to worst-case sizes.
+ IntList stripVerts = new IntList(size*2) ;
+ IntList stripCounts = new IntList(size) ;
+
+ // Vertex replace flags for the first two vertices are irrelevant.
+ v = 2 ;
+ while (v < size) {
+ flag = vertices.getFlag(v) ;
+
+ if ((flag != RESTART_CW) && (flag != RESTART_CCW)) {
+ // proceed to the next vertex.
+ stripLength++ ;
+ v++ ;
+
+ } else {
+ // Record the last strip.
+ stripCounts.add(stripLength) ;
+ for (int i = stripStart ; i < stripStart+stripLength ; i++)
+ stripVerts.add(i) ;
+
+ // Start a new strip and skip to its 3rd vertex.
+ stripStart = v ;
+ stripLength = 2 ;
+ v += 2 ;
+ }
+ }
+
+ // Finish off the last strip.
+ // If v > size then the strip is degenerate.
+ if (v == size) {
+ stripCounts.add(stripLength) ;
+ for (int i = stripStart ; i < stripStart+stripLength ; i++)
+ stripVerts.add(i) ;
+ } else
+ throw new IllegalArgumentException
+ (J3dI18N.getString("GeneralizedStrip0")) ;
+
+ if (debug) {
+ System.err.println("GeneralizedStrip.toLineStrips\n") ;
+ if (v > size)
+ System.err.println(" ended with a degenerate line") ;
+
+ System.err.println(" number of strips: " + stripCounts.count) ;
+ if (stripCounts.count > 0) {
+ System.err.println(" number of vertices: " + stripVerts.count) ;
+ System.err.println(" vertices/strip: " +
+ (float)stripVerts.count/stripCounts.count) ;
+ System.err.println(" strip counts: " + stripCounts.toString()) ;
+ // System.err.println(" indices: " + stripVerts.toString()) ;
+ }
+ System.err.println() ;
+ }
+
+ if (stripCounts.count > 0)
+ return new StripArray(stripVerts, stripCounts) ;
+ else
+ return null ;
+ }
+
+ /**
+ * Counts the number of lines defined by arrays of line strips.
+ *
+ * @param stripCounts array of strip counts, as used by the
+ * GeometryStripArray object
+ * @return number of lines in the strips
+ */
+ static int getLineCount(int stripCounts[]) {
+ int count = 0 ;
+ for (int i = 0 ; i < stripCounts.length ; i++)
+ count += (stripCounts[i] - 1) ;
+ return count ;
+ }
+
+ /**
+ * Counts the number of triangles defined by arrays of
+ * triangle strips or fans.
+ *
+ * @param stripCounts array of strip counts, as used by the
+ * GeometryStripArray object
+ * @return number of triangles in the strips or fans
+ */
+ static int getTriangleCount(int stripCounts[]) {
+ int count = 0 ;
+ for (int i = 0 ; i < stripCounts.length ; i++)
+ count += (stripCounts[i] - 2) ;
+ return count ;
+ }
+
+ /**
+ * Counts the number of triangles defined by arrays of
+ * triangle strips or fans.
+ *
+ * @param stripCounts IntList of strip counts
+ * @return number of triangles in the strips or fans
+ */
+ static int getTriangleCount(IntList stripCounts) {
+ int count = 0 ;
+ for (int i = 0 ; i < stripCounts.count ; i++)
+ count += (stripCounts.ints[i] - 2) ;
+ return count ;
+ }
+
+ /**
+ * Breaks up triangle strips into separate triangles.
+ *
+ * @param stripCounts array of strip counts, as used by the
+ * GeometryStripArray object
+ * @return array of ints which index into the original vertex array; each
+ * set of three consecutive vertex indices defines a single triangle
+ */
+ static int[] stripsToTriangles(int stripCounts[]) {
+ int triangleCount = getTriangleCount(stripCounts) ;
+ int tbuff[] = new int[3*triangleCount] ;
+ IntList vertices = new IntList(triangleCount + 2*stripCounts.length) ;
+
+ vertices.fillAscending() ;
+ stripsToTriangles(0, tbuff,
+ 0, vertices.ints,
+ 0, stripCounts,
+ stripCounts.length) ;
+ return tbuff ;
+ }
+
+ /**
+ * Breaks up triangle fans into separate triangles.
+ *
+ * @param stripCounts array of strip counts, as used by the
+ * GeometryStripArray object
+ * @return array of ints which index into the original vertex array; each
+ * set of three consecutive vertex indices defines a single triangle
+ */
+ static int[] fansToTriangles(int stripCounts[]) {
+ int triangleCount = getTriangleCount(stripCounts) ;
+ int tbuff[] = new int[3*triangleCount] ;
+ IntList vertices = new IntList(triangleCount + 2*stripCounts.length) ;
+
+ vertices.fillAscending() ;
+ fansToTriangles(0, tbuff,
+ 0, vertices.ints,
+ 0, stripCounts,
+ stripCounts.length) ;
+ return tbuff ;
+ }
+
+ /**
+ * Takes a fan and converts it to one or more strips.
+ *
+ * @param v index into the fans array of the first vertex in the fan
+ * @param length number of vertices in the fan
+ * @param fans array of vertex indices representing one or more fans
+ * @param convexPlanar if true indicates that the fan is convex and
+ * planar; such fans will always be converted into a single strip
+ * @return a StripArray containing the converted strips
+ */
+ static StripArray fanToStrips(int v, int length, int fans[],
+ boolean convexPlanar) {
+
+ // Initialize IntLists to worst-case sizes.
+ IntList stripVerts = new IntList(length*3) ;
+ IntList stripCounts = new IntList(length) ;
+
+ fanToStrips(v, length, fans, stripVerts, stripCounts, convexPlanar) ;
+ return new StripArray(stripVerts, stripCounts) ;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GeneralizedStripFlags.java b/j3d-core/src/classes/share/javax/media/j3d/GeneralizedStripFlags.java
new file mode 100644
index 0000000..9d37808
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GeneralizedStripFlags.java
@@ -0,0 +1,92 @@
+/*
+ * $RCSfile: GeneralizedStripFlags.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A class which implements GeneralizedStripFlags provides the means to access
+ * the vertex replace code flags associated with each vertex of a generalized
+ * strip. This allows a flexible representation of generalized strips for
+ * various classes and makes it possible to provide a common subset of static
+ * methods which operate only on their topology.
+ *
+ * @see GeneralizedStrip
+ * @see GeneralizedVertexList
+ */
+interface GeneralizedStripFlags {
+
+ /**
+ * This flag indicates that a vertex starts a new strip with clockwise
+ * winding.
+ */
+ static final int RESTART_CW = 0 ;
+
+ /**
+ * This flag indicates that a vertex starts a new strip with
+ * counter-clockwise winding.
+ */
+ static final int RESTART_CCW = 1 ;
+
+ /**
+ * This flag indicates that the next triangle in the strip is defined by
+ * replacing the middle vertex of the previous triangle in the strip.
+ */
+ static final int REPLACE_MIDDLE = 2 ;
+
+ /**
+ * This flag indicates that the next triangle in the strip is defined by
+ * replacing the oldest vertex of the previous triangle in the strip.
+ */
+ static final int REPLACE_OLDEST = 3 ;
+
+ /**
+ * This constant is used to indicate that triangles with clockwise vertex
+ * winding are front facing.
+ */
+ static final int FRONTFACE_CW = 0 ;
+
+ /**
+ * This constant is used to indicate that triangles with counter-clockwise
+ * vertex winding are front facing.
+ */
+ static final int FRONTFACE_CCW = 1 ;
+
+ /**
+ * Return the number of flags. This should be the same as the number of
+ * vertices in the generalized strip.
+ */
+ int getFlagCount() ;
+
+ /**
+ * Return the flag associated with the vertex at the specified index.
+ */
+ int getFlag(int index) ;
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GeneralizedVertexList.java b/j3d-core/src/classes/share/javax/media/j3d/GeneralizedVertexList.java
new file mode 100644
index 0000000..d146189
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GeneralizedVertexList.java
@@ -0,0 +1,406 @@
+/*
+ * $RCSfile: GeneralizedVertexList.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+import javax.vecmath.* ;
+import java.util.* ;
+
+/**
+ * The GeneralizedVertexList class is a variable-size list used to
+ * collect the vertices for a generalized strip of points, lines, or
+ * triangles. This is used by the GeometryDecompressor. This class
+ * implements the GeneralizedStripFlags interface and provides methods
+ * for copying instance vertex data into various fixed-size
+ * GeometryArray representations.
+ *
+ * @see GeneralizedStrip
+ * @see GeometryDecompressor
+ */
+class GeneralizedVertexList implements GeneralizedStripFlags {
+
+ // The ArrayList containing the vertices.
+ private ArrayList vertices ;
+
+ // Booleans for individual vertex components.
+ private boolean hasColor3 = false ;
+ private boolean hasColor4 = false ;
+ private boolean hasNormals = false ;
+
+ // Indicates the vertex winding of front-facing triangles in this strip.
+ private int frontFace ;
+
+ /**
+ * Count of number of strips generated after conversion to GeometryArray.
+ */
+ int stripCount ;
+
+ /**
+ * Count of number of vertices generated after conversion to GeometryArray.
+ */
+ int vertexCount ;
+
+ /**
+ * Count of number of triangles generated after conversion to GeometryArray.
+ */
+ int triangleCount ;
+
+ /**
+ * Bits describing the data bundled with each vertex. This is specified
+ * using the GeometryArray mask components.
+ */
+ int vertexFormat ;
+
+ /**
+ * Creates a new GeneralizedVertexList for the specified vertex format.
+ * @param vertexFormat a mask indicating which components are
+ * present in each vertex, as used by GeometryArray.
+ * @param frontFace a flag, either GeneralizedStripFlags.FRONTFACE_CW or
+ * GeneralizedStripFlags.FRONTFACE_CCW, indicating front face winding
+ * @param initSize initial number of elements
+ * @see GeometryArray
+ */
+ GeneralizedVertexList(int vertexFormat, int frontFace, int initSize) {
+ this.frontFace = frontFace ;
+ setVertexFormat(vertexFormat) ;
+
+ if (initSize == 0)
+ vertices = new ArrayList() ;
+ else
+ vertices = new ArrayList(initSize) ;
+
+ stripCount = 0 ;
+ vertexCount = 0 ;
+ triangleCount = 0 ;
+ }
+
+ /**
+ * Creates a new GeneralizedVertexList for the specified vertex format.
+ * @param vertexFormat a mask indicating which components are
+ * present in each vertex, as used by GeometryArray.
+ * @param frontFace a flag, either GeneralizedStripFlags.FRONTFACE_CW or
+ * GeneralizedStripFlags.FRONTFACE_CCW, indicating front face winding
+ * @see GeometryArray
+ */
+ GeneralizedVertexList(int vertexFormat, int frontFace) {
+ this(vertexFormat, frontFace, 0) ;
+ }
+
+ /**
+ * Sets the vertex format for this vertex list.
+ * @param vertexFormat a mask indicating which components are
+ * present in each vertex, as used by GeometryArray.
+ */
+ void setVertexFormat(int vertexFormat) {
+ this.vertexFormat = vertexFormat ;
+
+ if ((vertexFormat & GeometryArray.NORMALS) != 0)
+ hasNormals = true ;
+
+ if ((vertexFormat & GeometryArray.COLOR) != 0)
+ if ((vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ hasColor4 = true ;
+ else
+ hasColor3 = true ;
+ }
+
+ /**
+ * A class with fields corresponding to all the data that can be bundled
+ * with the vertices of generalized strips.
+ */
+ class Vertex {
+ int flag ;
+ Point3f coord ;
+ Color3f color3 ;
+ Color4f color4 ;
+ Vector3f normal ;
+
+ Vertex(Point3f p, Vector3f n, Color4f c, int flag) {
+ this.flag = flag ;
+ coord = new Point3f(p) ;
+
+ if (hasNormals)
+ normal = new Vector3f(n) ;
+
+ if (hasColor3)
+ color3 = new Color3f(c.x, c.y, c.z) ;
+
+ else if (hasColor4)
+ color4 = new Color4f(c) ;
+ }
+ }
+
+ /**
+ * Copy vertex data to a new Vertex object and add it to this list.
+ */
+ void addVertex(Point3f pos, Vector3f norm, Color4f color, int flag) {
+ vertices.add(new Vertex(pos, norm, color, flag)) ;
+ }
+
+ /**
+ * Return the number of vertices in this list.
+ */
+ int size() {
+ return vertices.size() ;
+ }
+
+ // GeneralizedStripFlags interface implementation
+ public int getFlagCount() {
+ return vertices.size() ;
+ }
+
+ // GeneralizedStripFlags interface implementation
+ public int getFlag(int index) {
+ return ((Vertex)vertices.get(index)).flag ;
+ }
+
+ // Copy vertices in the given order to a fixed-length GeometryArray.
+ // Using the array versions of the GeometryArray set() methods results in
+ // a significant performance improvement despite needing to create
+ // fixed-length arrays to hold the vertex elements.
+ private void copyVertexData(GeometryArray ga,
+ GeneralizedStrip.IntList indices) {
+ Vertex v ;
+ Point3f p3f[] = new Point3f[indices.count] ;
+
+ if (hasNormals) {
+ Vector3f v3f[] = new Vector3f[indices.count] ;
+ if (hasColor3) {
+ Color3f c3f[] = new Color3f[indices.count] ;
+ for (int i = 0 ; i < indices.count ; i++) {
+ v = (Vertex)vertices.get(indices.ints[i]) ;
+ p3f[i] = v.coord ;
+ v3f[i] = v.normal ;
+ c3f[i] = v.color3 ;
+ }
+ ga.setColors(0, c3f) ;
+
+ } else if (hasColor4) {
+ Color4f c4f[] = new Color4f[indices.count] ;
+ for (int i = 0 ; i < indices.count ; i++) {
+ v = (Vertex)vertices.get(indices.ints[i]) ;
+ p3f[i] = v.coord ;
+ v3f[i] = v.normal ;
+ c4f[i] = v.color4 ;
+ }
+ ga.setColors(0, c4f) ;
+
+ } else {
+ for (int i = 0 ; i < indices.count ; i++) {
+ v = (Vertex)vertices.get(indices.ints[i]) ;
+ p3f[i] = v.coord ;
+ v3f[i] = v.normal ;
+ }
+ }
+ ga.setNormals(0, v3f) ;
+
+ } else {
+ if (hasColor3) {
+ Color3f c3f[] = new Color3f[indices.count] ;
+ for (int i = 0 ; i < indices.count ; i++) {
+ v = (Vertex)vertices.get(indices.ints[i]) ;
+ p3f[i] = v.coord ;
+ c3f[i] = v.color3 ;
+ }
+ ga.setColors(0, c3f) ;
+
+ } else if (hasColor4) {
+ Color4f c4f[] = new Color4f[indices.count] ;
+ for (int i = 0 ; i < indices.count ; i++) {
+ v = (Vertex)vertices.get(indices.ints[i]) ;
+ p3f[i] = v.coord ;
+ c4f[i] = v.color4 ;
+ }
+ ga.setColors(0, c4f) ;
+
+ } else {
+ for (int i = 0 ; i < indices.count ; i++) {
+ v = (Vertex)vertices.get(indices.ints[i]) ;
+ p3f[i] = v.coord ;
+ }
+ }
+ }
+ ga.setCoordinates(0, p3f) ;
+ }
+
+ /**
+ * Output a PointArray.
+ */
+ PointArray toPointArray() {
+ int size = vertices.size() ;
+
+ if (size > 0) {
+ PointArray pa = new PointArray(size, vertexFormat) ;
+ GeneralizedStrip.IntList il = new GeneralizedStrip.IntList(size) ;
+
+ il.fillAscending() ;
+ copyVertexData(pa, il) ;
+
+ vertexCount += size ;
+ return pa ;
+ }
+ else
+ return null ;
+ }
+
+ /**
+ * Output a TriangleArray.
+ */
+ TriangleArray toTriangleArray() {
+ int vertices[] = GeneralizedStrip.toTriangles(this, frontFace) ;
+
+ if (vertices != null) {
+ TriangleArray ta ;
+ GeneralizedStrip.IntList il ;
+
+ ta = new TriangleArray(vertices.length, vertexFormat) ;
+ il = new GeneralizedStrip.IntList(vertices) ;
+ copyVertexData(ta, il) ;
+
+ vertexCount += vertices.length ;
+ triangleCount += vertices.length/3 ;
+ return ta ;
+ } else
+ return null ;
+ }
+
+ /**
+ * Output a LineStripArray.
+ */
+ LineStripArray toLineStripArray() {
+ GeneralizedStrip.StripArray stripArray =
+ GeneralizedStrip.toLineStrips(this) ;
+
+ if (stripArray != null) {
+ LineStripArray lsa ;
+ lsa = new LineStripArray(stripArray.vertices.count,
+ vertexFormat,
+ stripArray.stripCounts.trim()) ;
+
+ copyVertexData(lsa, stripArray.vertices) ;
+
+ vertexCount += stripArray.vertices.count ;
+ stripCount += stripArray.stripCounts.count ;
+ return lsa ;
+ } else
+ return null ;
+ }
+
+ /**
+ * Output a TriangleStripArray.
+ */
+ TriangleStripArray toTriangleStripArray() {
+ GeneralizedStrip.StripArray stripArray =
+ GeneralizedStrip.toTriangleStrips(this, frontFace) ;
+
+ if (stripArray != null) {
+ TriangleStripArray tsa ;
+ tsa = new TriangleStripArray(stripArray.vertices.count,
+ vertexFormat,
+ stripArray.stripCounts.trim()) ;
+
+ copyVertexData(tsa, stripArray.vertices) ;
+
+ vertexCount += stripArray.vertices.count ;
+ stripCount += stripArray.stripCounts.count ;
+ return tsa ;
+ } else
+ return null ;
+ }
+
+ /**
+ * Output triangle strip and triangle fan arrays.
+ * @return a 2-element array of GeometryStripArray; element 0 if non-null
+ * will contain a TriangleStripArray, and element 1 if non-null will
+ * contain a TriangleFanArray.
+ */
+ GeometryStripArray[] toStripAndFanArrays() {
+ GeneralizedStrip.StripArray stripArray[] =
+ GeneralizedStrip.toStripsAndFans(this, frontFace) ;
+
+ GeometryStripArray gsa[] = new GeometryStripArray[2] ;
+
+ if (stripArray[0] != null) {
+ gsa[0] = new TriangleStripArray(stripArray[0].vertices.count,
+ vertexFormat,
+ stripArray[0].stripCounts.trim()) ;
+
+ copyVertexData(gsa[0], stripArray[0].vertices) ;
+
+ vertexCount += stripArray[0].vertices.count ;
+ stripCount += stripArray[0].stripCounts.count ;
+ }
+
+ if (stripArray[1] != null) {
+ gsa[1] = new TriangleFanArray(stripArray[1].vertices.count,
+ vertexFormat,
+ stripArray[1].stripCounts.trim()) ;
+
+ copyVertexData(gsa[1], stripArray[1].vertices) ;
+
+ vertexCount += stripArray[1].vertices.count ;
+ stripCount += stripArray[1].stripCounts.count ;
+ }
+ return gsa ;
+ }
+
+ /**
+ * Output triangle strip and and triangle arrays.
+ * @return a 2-element array of GeometryArray; element 0 if non-null
+ * will contain a TriangleStripArray, and element 1 if non-null will
+ * contain a TriangleArray.
+ */
+ GeometryArray[] toStripAndTriangleArrays() {
+ GeneralizedStrip.StripArray stripArray[] =
+ GeneralizedStrip.toStripsAndTriangles(this, frontFace, 4, 12) ;
+
+ GeometryArray ga[] = new GeometryArray[2] ;
+
+ if (stripArray[0] != null) {
+ ga[0] = new TriangleStripArray(stripArray[0].vertices.count,
+ vertexFormat,
+ stripArray[0].stripCounts.trim()) ;
+
+ copyVertexData(ga[0], stripArray[0].vertices) ;
+
+ vertexCount += stripArray[0].vertices.count ;
+ stripCount += stripArray[0].stripCounts.count ;
+ }
+
+ if (stripArray[1] != null) {
+ ga[1] = new TriangleArray(stripArray[1].vertices.count,
+ vertexFormat) ;
+
+ copyVertexData(ga[1], stripArray[1].vertices) ;
+ triangleCount += stripArray[1].vertices.count/3 ;
+ }
+ return ga ;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Geometry.java b/j3d-core/src/classes/share/javax/media/j3d/Geometry.java
new file mode 100644
index 0000000..fd160cc
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Geometry.java
@@ -0,0 +1,72 @@
+/*
+ * $RCSfile: Geometry.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:21 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Geometry is an abstract class that specifies the geometry
+ * component information required by a Shape3D node. Geometry objects
+ * describe both the geometry and topology of the Shape3D nodes that
+ * reference them. Geometry objects consist of four generic geometric
+ * types:
+ *
+ * setCoordinate,
+ * setColors, etc.) copy the data into this
+ * GeometryArray. This is appropriate for many applications and
+ * offers an application much flexibility in organizing its data.
+ * This is the default mode.
+ * BY_REFERENCE bit in the
+ * vertexFormat field of the constructor for this
+ * GeometryArray. In this mode, the various set methods for
+ * coordinates, normals, colors, texture coordinates, and vertex attributes
+ * are not used.
+ * Instead, new methods are used to set a reference to user-supplied
+ * coordinate, color, normal, texture coordinate, and vertex attribute
+ * arrays (such as
+ * setCoordRefFloat, setColorRefFloat,
+ * etc.). Data in any array that is referenced by a live or compiled
+ * GeometryArray object may only be modified via the
+ * updateData method (subject to the
+ * ALLOW_REF_DATA_WRITE capability bit). Applications
+ * must exercise care not to violate this rule. If any referenced
+ * geometry data is modified outside of the updateData
+ * method, the results are undefined.
+ * BY_REFERENCE flag.
+ *
+ * @since Java 3D 1.2
+ */
+ public static final int INTERLEAVED = 0x100;
+
+ /**
+ * Specifies that geometry by-reference data for this
+ * GeometryArray, whether interleaved or non-interleaved, is
+ * accessed via J3DBuffer objects that wrap NIO Buffer objects,
+ * rather than float, double, byte, or TupleXX arrays. This flag
+ * is only valid in conjunction with the BY_REFERENCE
+ * flag.
+ *
+ * @see J3DBuffer
+ * @see #setCoordRefBuffer(J3DBuffer)
+ * @see #setColorRefBuffer(J3DBuffer)
+ * @see #setNormalRefBuffer(J3DBuffer)
+ * @see #setTexCoordRefBuffer(int,J3DBuffer)
+ * @see #setVertexAttrRefBuffer(int,J3DBuffer)
+ * @see #setInterleavedVertexBuffer(J3DBuffer)
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int USE_NIO_BUFFER = 0x800;
+
+ /**
+ * Specifies that only the coordinate indices are used for indexed
+ * geometry arrays. In this mode, the values from the coordinate
+ * index array are used as a single set of index values to access
+ * the vertex data for all five vertex components (coord, color,
+ * normal, texCoord, and vertexAttr). The color, normal, texCoord,
+ * and vertexAttr index arrays are neither allocated nor used. Any
+ * attempt to access the color, normal, texCoord,
+ * or vertexAttr index arrays will result in a NullPointerException.
+ * This flag is only valid for indexed geometry arrays
+ * (subclasses of IndexedGeometryArray).
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int USE_COORD_INDEX_ONLY = 0x200;
+
+ /**
+ * Specifies that this GeometryArray contains one or more arrays of
+ * vertex attributes. These attributes are used in programmable
+ * shading.
+ *
+ * @since Java 3D 1.4
+ */
+ public static final int VERTEX_ATTRIBUTES = 0x1000;
+
+ //NVaidya
+ /**
+ * Specifies that the indices in this GeometryArray
+ * are accessed by reference. This flag is only valid for
+ * indexed geometry arrays (subclasses of IndexedGeometryArray) and only
+ * when used in conjunction with the BY_REFERENCE and
+ * USE_COORD_INDEX_ONLY flags.
+ *
+ * @since Java 3D 1.5
+ */
+ public static final int BY_REFERENCE_INDICES = 0x2000;
+
+ // Used to keep track of the last bit (for adding new bits only)
+ private static final int LAST_FORMAT_BIT = 0x2000;
+
+ // Scratch arrays for converting Point[234]f to TexCoord[234]f
+ private TexCoord2f [] texCoord2fArray = null;
+ private TexCoord3f [] texCoord3fArray = null;
+ private TexCoord4f [] texCoord4fArray = null;
+ private TexCoord2f texCoord2fScratch = null;
+ private TexCoord3f texCoord3fScratch = null;
+
+ private static final int[] defTexCoordMap = { 0 };
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_COLOR_READ,
+ ALLOW_COORDINATE_READ,
+ ALLOW_COUNT_READ,
+ ALLOW_FORMAT_READ,
+ ALLOW_NORMAL_READ,
+ ALLOW_REF_DATA_READ,
+ ALLOW_TEXCOORD_READ,
+ ALLOW_VERTEX_ATTR_READ
+ };
+
+
+ // non-public, no parameter constructor
+ GeometryArray() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ //NVaidya
+ /**
+ * Constructs an empty GeometryArray object with the specified
+ * number of vertices and vertex format. Defaults are used
+ * for all other parameters. The default values are as follows:
+ *
+ * texCoordSetCount : 1
+ *
+ * @param vertexCount the number of vertex elements in this GeometryArray
+ * @param vertexFormat a mask indicating which components are
+ * present in each vertex. This is specified as one or more
+ * individual flags that are bitwise "OR"ed together to describe
+ * the per-vertex data.
+ * The flags include:
+ * texCoordSetMap : { 0 }
+ * vertexAttrCount : 0
+ * vertexAttrSizes : null
+ * validVertexCount : vertexCount
+ * initialVertexIndex : 0
+ * initialCoordIndex : 0
+ * initialColorIndex : 0
+ * initialNormalIndex : 0
+ * initialTexCoordIndex : 0
+ * initialVertexAttrIndex : 0
+ * all data array values : 0.0
+ * all data array references : null
+ * COORDINATES, to signal the inclusion of
+ * vertex positions--always present; NORMALS, to signal
+ * the inclusion of per vertex normals; one of COLOR_3 or
+ * COLOR_4, to signal the inclusion of per vertex
+ * colors (without or with alpha information); one of
+ * TEXTURE_COORDINATE_2, TEXTURE_COORDINATE_3
+ * or TEXTURE_COORDINATE_4,
+ * to signal the
+ * inclusion of per-vertex texture coordinates (2D, 3D or 4D);
+ * BY_REFERENCE, to indicate that the data is passed
+ * by reference
+ * rather than by copying; INTERLEAVED, to indicate
+ * that the referenced
+ * data is interleaved in a single array;
+ * USE_NIO_BUFFER, to indicate that the referenced data
+ * is accessed via a J3DBuffer object that wraps an NIO buffer;
+ * USE_COORD_INDEX_ONLY,
+ * to indicate that only the coordinate indices are used for indexed
+ * geometry arrays;
+ * BY_REFERENCE_INDICES, to indicate
+ * that the indices are accessed by reference in indexed
+ * geometry arrays.COORDINATES
+ *
+ * @exception IllegalArgumentException if the USE_COORD_INDEX_ONLY
+ * bit or the BY_REFERENCE_INDICES bit is set for
+ * non-indexed geometry arrays (that is, GeometryArray objects
+ * that are not a subclass of IndexedGeometryArray)
+ *
+ * @exception IllegalArgumentException if the INTERLEAVED
+ * bit is set without the BY_REFERENCE bit being set
+ *
+ * @exception IllegalArgumentException if the USE_NIO_BUFFER
+ * bit is set without the BY_REFERENCE bit being set
+ *
+ * @exception IllegalArgumentException if the INTERLEAVED
+ * bit and the VERTEX_ATTRIBUTES bit are both set
+ *
+ * @exception IllegalArgumentException if the
+ * BY_REFERENCE_INDICES
+ * bit is set without the BY_REFERENCE and
+ * USE_COORD_INDEX_ONLY bits being set
+ */
+ public GeometryArray(int vertexCount, int vertexFormat) {
+ this(vertexCount, vertexFormat,
+ ((vertexFormat & TEXTURE_COORDINATE) != 0 ? 1 : 0),
+ ((vertexFormat & TEXTURE_COORDINATE) != 0 ? defTexCoordMap : null));
+ }
+
+
+ //NVaidya
+ /**
+ * Constructs an empty GeometryArray object with the specified
+ * number of vertices, vertex format, number of texture coordinate
+ * sets, and texture coordinate mapping array. Defaults are used
+ * for all other parameters.
+ *
+ * @param vertexCount the number of vertex elements in this
+ * GeometryArrayCOORDINATES, to signal the inclusion of
+ * vertex positions--always present; NORMALS, to signal
+ * the inclusion of per vertex normals; one of COLOR_3 or
+ * COLOR_4, to signal the inclusion of per vertex
+ * colors (without or with alpha information); one of
+ * TEXTURE_COORDINATE_2 or TEXTURE_COORDINATE_3
+ * or TEXTURE_COORDINATE_4,
+ * to signal the
+ * inclusion of per-vertex texture coordinates (2D , 3D or 4D);
+ * BY_REFERENCE, to indicate that the data is passed
+ * by reference
+ * rather than by copying; INTERLEAVED, to indicate
+ * that the referenced
+ * data is interleaved in a single array;
+ * USE_NIO_BUFFER, to indicate that the referenced data
+ * is accessed via a J3DBuffer object that wraps an NIO buffer;
+ * USE_COORD_INDEX_ONLY,
+ * to indicate that only the coordinate indices are used for indexed
+ * geometry arrays;
+ * BY_REFERENCE_INDICES, to indicate
+ * that the indices are accessed by reference in indexed
+ * geometry arrays.vertexFormat
+ * does not include one of TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3, the
+ * texCoordSetCount parameter is not used.texCoordSetCount. A negative value specifies that
+ * no texture coordinate set maps to the texture unit
+ * corresponding to the index. If there are more texture units in
+ * any associated Appearance object than elements in the mapping
+ * array, the extra elements are assumed to be -1. The same
+ * texture coordinate set may be used for more than one texture
+ * unit. Each texture unit in every associated Appearance must
+ * have a valid source of texture coordinates: either a
+ * non-negative texture coordinate set must be specified in the
+ * mapping array or texture coordinate generation must be enabled.
+ * Texture coordinate generation will take precedence for those
+ * texture units for which a texture coordinate set is specified
+ * and texture coordinate generation is enabled. If
+ * vertexFormat does not include one of
+ * TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3 or
+ * TEXTURE_COORDINATE_4, the
+ * texCoordSetMap array is not used. The following example
+ * illustrates the use of the texCoordSetMap array.
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * Description
+ *
+ *
+ * Use tex coord set 1 for tex unit 0
+ *
+ *
+ * Use no tex coord set for tex unit 1
+ *
+ *
+ * Use tex coord set 0 for tex unit 2
+ *
+ *
+ * Reuse tex coord set 1 for tex unit 3
+ * COORDINATES
+ *
+ * @exception IllegalArgumentException if the USE_COORD_INDEX_ONLY
+ * bit or the BY_REFERENCE_INDICES bit is set for
+ * non-indexed geometry arrays (that is, GeometryArray objects
+ * that are not a subclass of IndexedGeometryArray)
+ *
+ * @exception IllegalArgumentException if the INTERLEAVED
+ * bit is set without the BY_REFERENCE bit being set
+ *
+ * @exception IllegalArgumentException if the USE_NIO_BUFFER
+ * bit is set without the BY_REFERENCE bit being set
+ *
+ * @exception IllegalArgumentException if the INTERLEAVED
+ * bit and the VERTEX_ATTRIBUTES bit are both set
+ *
+ * @exception IllegalArgumentException if the
+ * BY_REFERENCE_INDICES
+ * bit is set without the BY_REFERENCE and
+ * USE_COORD_INDEX_ONLY bits being set
+ *
+ * @exception IllegalArgumentException if
+ * texCoordSetCount < 0
+ *
+ * @exception IllegalArgumentException if any element in
+ * texCoordSetMap[] >= texCoordSetCount.
+ *
+ * @since Java 3D 1.2
+ */
+ public GeometryArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap) {
+ this(vertexCount, vertexFormat, texCoordSetCount, texCoordSetMap, 0, null);
+ }
+
+
+ //NVaidya
+ /**
+ * Constructs an empty GeometryArray object with the specified
+ * number of vertices, vertex format, number of texture coordinate
+ * sets, texture coordinate mapping array, vertex attribute count,
+ * and vertex attribute sizes array.
+ *
+ * @param vertexCount the number of vertex elements in this
+ * GeometryArrayCOORDINATES, to signal the inclusion of
+ * vertex positions--always present; NORMALS, to signal
+ * the inclusion of per vertex normals; one of COLOR_3 or
+ * COLOR_4, to signal the inclusion of per vertex
+ * colors (without or with alpha information); one of
+ * TEXTURE_COORDINATE_2 or TEXTURE_COORDINATE_3
+ * or TEXTURE_COORDINATE_4,
+ * to signal the
+ * inclusion of per-vertex texture coordinates (2D , 3D or 4D);
+ * VERTEX_ATTRIBUTES, to signal
+ * the inclusion of one or more arrays of vertex attributes;
+ * BY_REFERENCE, to indicate that the data is passed
+ * by reference
+ * rather than by copying; INTERLEAVED, to indicate
+ * that the referenced
+ * data is interleaved in a single array;
+ * USE_NIO_BUFFER, to indicate that the referenced data
+ * is accessed via a J3DBuffer object that wraps an NIO buffer;
+ * USE_COORD_INDEX_ONLY,
+ * to indicate that only the coordinate indices are used for indexed
+ * geometry arrays;
+ * BY_REFERENCE_INDICES, to indicate
+ * that the indices are accessed by reference in indexed
+ * geometry arrays.vertexFormat
+ * does not include one of TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3, the
+ * texCoordSetCount parameter is not used.texCoordSetCount. A negative value specifies that
+ * no texture coordinate set maps to the texture unit
+ * corresponding to the index. If there are more texture units in
+ * any associated Appearance object than elements in the mapping
+ * array, the extra elements are assumed to be -1. The same
+ * texture coordinate set may be used for more than one texture
+ * unit. Each texture unit in every associated Appearance must
+ * have a valid source of texture coordinates: either a
+ * non-negative texture coordinate set must be specified in the
+ * mapping array or texture coordinate generation must be enabled.
+ * Texture coordinate generation will take precedence for those
+ * texture units for which a texture coordinate set is specified
+ * and texture coordinate generation is enabled. If
+ * vertexFormat does not include one of
+ * TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3 or
+ * TEXTURE_COORDINATE_4, the
+ * texCoordSetMap array is not used. The following example
+ * illustrates the use of the texCoordSetMap array.
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * Description
+ *
+ *
+ * Use tex coord set 1 for tex unit 0
+ *
+ *
+ * Use no tex coord set for tex unit 1
+ *
+ *
+ * Use tex coord set 0 for tex unit 2
+ *
+ *
+ * Reuse tex coord set 1 for tex unit 3
+ * vertexFormat
+ * does not include VERTEX_ATTRIBUTES, the
+ * vertexAttrCount parameter must be 0.vertexAttrCount.COORDINATES
+ *
+ * @exception IllegalArgumentException if the USE_COORD_INDEX_ONLY
+ * bit or the BY_REFERENCE_INDICES bit is set for
+ * non-indexed geometry arrays (that is, GeometryArray objects
+ * that are not a subclass of IndexedGeometryArray)
+ *
+ * @exception IllegalArgumentException if the INTERLEAVED
+ * bit is set without the BY_REFERENCE bit being set
+ *
+ * @exception IllegalArgumentException if the USE_NIO_BUFFER
+ * bit is set without the BY_REFERENCE bit being set
+ *
+ * @exception IllegalArgumentException if the INTERLEAVED
+ * bit and the VERTEX_ATTRIBUTES bit are both set
+ *
+ * @exception IllegalArgumentException if the
+ * BY_REFERENCE_INDICES
+ * bit is set without the BY_REFERENCE and
+ * USE_COORD_INDEX_ONLY bits being set
+ *
+ * @exception IllegalArgumentException if
+ * texCoordSetCount < 0
+ *
+ * @exception IllegalArgumentException if any element in
+ * texCoordSetMap[] >= texCoordSetCount.
+ *
+ * @exception IllegalArgumentException if
+ * vertexAttrCount > 0 and the
+ * VERTEX_ATTRIBUTES bit is not set
+ *
+ * @exception IllegalArgumentException if
+ * vertexAttrCount < 0
+ *
+ * @exception IllegalArgumentException if
+ * vertexAttrSizes.length != vertexAttrCount
+ *
+ * @exception IllegalArgumentException if any element in
+ * vertexAttrSizes[] is < 1 or
+ * > 4.
+ *
+ * @since Java 3D 1.4
+ */
+ public GeometryArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes) {
+
+ if (vertexCount < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray96"));
+
+ if (texCoordSetCount < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray124"));
+
+ if (vertexAttrCount < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray125"));
+
+ if ((vertexFormat & COORDINATES) == 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray0"));
+
+ if ((vertexFormat & INTERLEAVED) != 0 &&
+ (vertexFormat & BY_REFERENCE) == 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray80"));
+
+ if ((vertexFormat & INTERLEAVED) != 0 &&
+ (vertexFormat & VERTEX_ATTRIBUTES) != 0) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray128"));
+ }
+
+ if ((vertexFormat & USE_COORD_INDEX_ONLY) != 0 &&
+ !(this instanceof IndexedGeometryArray)) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray135"));
+ }
+
+ //NVaidya
+ if ((vertexFormat & BY_REFERENCE_INDICES) != 0) {
+ if (!(this instanceof IndexedGeometryArray))
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray136"));
+ if ((vertexFormat & BY_REFERENCE) == 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray137"));
+ if ((vertexFormat & USE_COORD_INDEX_ONLY) == 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray138"));
+ }
+
+ if ((vertexFormat & USE_NIO_BUFFER) != 0 &&
+ (vertexFormat & BY_REFERENCE) == 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray117"));
+
+ if ((vertexFormat & TEXTURE_COORDINATE) != 0) {
+ if (texCoordSetMap == null)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray106"));
+
+ if (texCoordSetCount == 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray107"));
+
+ for (int i = 0; i < texCoordSetMap.length; i++) {
+ if (texCoordSetMap[i] >= texCoordSetCount)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray108"));
+ }
+
+ if ((vertexFormat & TEXTURE_COORDINATE_2) != 0) {
+ texCoord2fArray = new TexCoord2f[1];
+ texCoord2fScratch = new TexCoord2f();
+ }
+ else if ((vertexFormat & TEXTURE_COORDINATE_3) != 0) {
+ texCoord3fArray = new TexCoord3f[1];
+ texCoord3fScratch = new TexCoord3f();
+ }
+ else if ((vertexFormat & TEXTURE_COORDINATE_4) != 0) {
+ texCoord4fArray = new TexCoord4f[1];
+ }
+ }
+
+ if ((vertexFormat & VERTEX_ATTRIBUTES) != 0) {
+ if (vertexAttrCount > 0) {
+ if (vertexAttrCount != vertexAttrSizes.length) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray132"));
+ }
+
+ for (int i = 0; i < vertexAttrSizes.length; i++) {
+ if (vertexAttrSizes[i] < 1 || vertexAttrSizes[i] > 4) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray133"));
+ }
+ }
+ } else {
+ if (vertexAttrSizes != null && vertexAttrSizes.length != 0) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray132"));
+ }
+ }
+ } else {
+ if (vertexAttrCount > 0) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray131"));
+ }
+ }
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((GeometryArrayRetained)this.retained).createGeometryArrayData(
+ vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes);
+
+ }
+
+
+ //------------------------------------------------------------------
+ // Common methods
+ //------------------------------------------------------------------
+
+ /**
+ * Retrieves the number of vertices in this GeometryArray
+ * @return number of vertices in this GeometryArray
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ */
+ public int getVertexCount() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray1"));
+
+ return ((GeometryArrayRetained)this.retained).getVertexCount();
+ }
+
+ /**
+ * Retrieves the vertexFormat of this GeometryArray
+ * @return format of vertices in this GeometryArray
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ */
+ public int getVertexFormat() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_FORMAT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray2"));
+
+ return ((GeometryArrayRetained)this.retained).getVertexFormat();
+ }
+
+
+ /**
+ * Retrieves the number of texture coordinate sets in this
+ * GeometryArray object.
+ *
+ * @return the number of texture coordinate sets
+ * in this GeometryArray object
+ *
+ * @since Java 3D 1.2
+ */
+ public int getTexCoordSetCount() {
+ return ((GeometryArrayRetained)this.retained).getTexCoordSetCount();
+ }
+
+
+ /**
+ * Retrieves the length of the texture coordinate set mapping
+ * array of this GeometryArray object.
+ *
+ * @return the length of the texture coordinate set mapping
+ * array of this GeometryArray object
+ *
+ * @since Java 3D 1.2
+ */
+ public int getTexCoordSetMapLength() {
+ return ((GeometryArrayRetained)this.retained).getTexCoordSetMapLength();
+ }
+
+
+ /**
+ * Retrieves the texture coordinate set mapping
+ * array from this GeometryArray object.
+ *
+ * @param texCoordSetMap an array that will receive a copy of the
+ * texture coordinate set mapping array. The array must be large
+ * enough to hold all entries of the texture coordinate set
+ * mapping array.
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTexCoordSetMap(int[] texCoordSetMap) {
+ ((GeometryArrayRetained)this.retained).getTexCoordSetMap(texCoordSetMap);
+ }
+
+
+ /**
+ * Retrieves the number of vertex attributes in this GeometryArray
+ * object.
+ *
+ * @return the number of vertex attributes in this GeometryArray
+ * object
+ *
+ * @since Java 3D 1.4
+ */
+ public int getVertexAttrCount() {
+ return ((GeometryArrayRetained)this.retained).getVertexAttrCount();
+ }
+
+
+ /**
+ * Retrieves the vertex attribute sizes array from this
+ * GeometryArray object.
+ *
+ * @param vertexAttrSizes an array that will receive a copy of
+ * the vertex attribute sizes array. The array must hold at least
+ * vertexAttrCount elements.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttrSizes(int[] vertexAttrSizes) {
+ ((GeometryArrayRetained)this.retained).getVertexAttrSizes(vertexAttrSizes);
+ }
+
+
+ /**
+ * Updates geometry array data that is accessed by reference.
+ * This method calls the updateData method of the specified
+ * GeometryUpdater object to synchronize updates to vertex
+ * data that is referenced by this GeometryArray object.
+ * Applications that wish to modify such data must perform all
+ * updates via this method.
+ * BY_REFERENCE, and this
+ * object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public void updateData(GeometryUpdater updater) {
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0 &&
+ isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_REF_DATA_WRITE)) {
+
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray81"));
+ }
+
+ ((GeometryArrayRetained)this.retained).updateData(updater);
+ }
+
+
+ /**
+ * Sets the valid vertex count for this GeometryArray object.
+ * This count specifies the number of vertices actually used in
+ * rendering or other operations such as picking and collision.
+ * This attribute is initialized to vertexCount.
+ *
+ * @param validVertexCount the new valid vertex count.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ *
+ * validVertexCount < 0,
+ * initialVertexIndex + validVertexCount > vertexCount,
+ * initialCoordIndex + validVertexCount > vertexCount,
+ * initialColorIndex + validVertexCount > vertexCount,
+ * initialNormalIndex + validVertexCount > vertexCount,
+ * initialTexCoordIndex + validVertexCount > vertexCount,
+ * initialVertexAttrIndex + validVertexCount > vertexCount
+ * BY_REFERENCE and any the following
+ * are true for non-null array references:
+ *
+ *
+ * where num_words depends on which variant of
+ * CoordRef.length < num_words *
+ * (initialCoordIndex + validVertexCount),
+ * ColorRef.length < num_words *
+ * (initialColorIndex + validVertexCount),
+ * NormalRef.length < num_words *
+ * (initialNormalIndex + validVertexCount),
+ * TexCoordRef.length < num_words *
+ * (initialTexCoordIndex + validVertexCount),
+ * VertexAttrRef.length < num_words *
+ * (initialVertexAttrIndex + validVertexCount),
+ * InterleavedVertices.length < words_per_vertex *
+ * (initialVertexIndex + validVertexCount)
+ * setArrayRef is used, and
+ * words_per_vertex depends on which vertex formats are enabled
+ * for interleaved arrays.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setValidVertexCount(int validVertexCount) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray88"));
+
+ if (validVertexCount < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray96"));
+
+ ((GeometryArrayRetained)this.retained).setValidVertexCount(validVertexCount);
+ // NOTE: the checks for initial*Index + validVertexCount >
+ // vertexCount need to be done in the retained method
+ }
+
+
+ /**
+ * Gets the valid vertex count for this GeometryArray object.
+ * For geometry strip primitives (subclasses of GeometryStripArray),
+ * the valid vertex count is defined to be the sum of the
+ * stripVertexCounts array.
+ * @return the current valid vertex count
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getValidVertexCount() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray89"));
+
+ return ((GeometryArrayRetained)this.retained).getValidVertexCount();
+ }
+
+
+ /**
+ * Copies all node information from originalNodeComponent
+ * into the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+ // vertexFormat and vertexCount are copied in subclass when constructor
+ // public GeometryArray(int vertexCount, int vertexFormat) is used
+ // in cloneNodeComponent()
+ GeometryArrayRetained src = (GeometryArrayRetained) originalNodeComponent.retained;
+ GeometryArrayRetained dst = (GeometryArrayRetained) retained;
+ int format = src.getVertexFormat();
+ if ((format & BY_REFERENCE) == 0) {
+ System.arraycopy(src.vertexData, 0, dst.vertexData, 0,
+ src.vertexData.length);
+ dst.setInitialVertexIndex(src.getInitialVertexIndex());
+
+ } else {
+ dst.setInitialCoordIndex(src.getInitialCoordIndex());
+ dst.setInitialColorIndex(src.getInitialColorIndex());
+ dst.setInitialNormalIndex(src.getInitialNormalIndex());
+ int setCount = src.getTexCoordSetCount();
+ int vAttrCount = src.getVertexAttrCount();
+ for (int i=0; i < setCount; i++) {
+ dst.setInitialTexCoordIndex(i, src.getInitialTexCoordIndex(i));
+ }
+ if ((format & INTERLEAVED) == 0) {
+ if ((format & USE_NIO_BUFFER) == 0) {
+ // Java arrays
+ dst.setCoordRefFloat(src.getCoordRefFloat());
+ dst.setCoordRefDouble(src.getCoordRefDouble());
+ dst.setCoordRef3f(src.getCoordRef3f());
+ dst.setCoordRef3d(src.getCoordRef3d());
+ dst.setColorRefFloat(src.getColorRefFloat());
+ dst.setColorRefByte(src.getColorRefByte());
+ if ((format & WITH_ALPHA) == 0) {
+ dst.setColorRef3f(src.getColorRef3f());
+ dst.setColorRef3b(src.getColorRef3b());
+ } else {
+ dst.setColorRef4f(src.getColorRef4f());
+ dst.setColorRef4b(src.getColorRef4b());
+ }
+ dst.setNormalRefFloat(src.getNormalRefFloat());
+ dst.setNormalRef3f(src.getNormalRef3f());
+
+ switch (src.getVertexAttrType()) {
+ case GeometryArrayRetained.AF:
+ for (int i=0; i < vAttrCount; i++) {
+ dst.setVertexAttrRefFloat(i, src.getVertexAttrRefFloat(i));
+ }
+ break;
+ }
+
+ switch (src.getTexCoordType()) {
+ case GeometryArrayRetained.TF:
+ for (int i=0; i < setCount; i++) {
+ dst.setTexCoordRefFloat(i, src.getTexCoordRefFloat(i));
+ }
+ break;
+ case GeometryArrayRetained.T2F:
+ for (int i=0; i < setCount; i++) {
+ dst.setTexCoordRef2f(i, src.getTexCoordRef2f(i));
+ }
+ break;
+ case GeometryArrayRetained.T3F:
+ for (int i=0; i < setCount; i++) {
+ dst.setTexCoordRef3f(i, src.getTexCoordRef3f(i));
+ }
+ break;
+ }
+ } else {
+ // NIO buffer
+ dst.setCoordRefBuffer(src.getCoordRefBuffer());
+ dst.setColorRefBuffer(src.getColorRefBuffer());
+ dst.setNormalRefBuffer(src.getNormalRefBuffer());
+
+ switch (src.getVertexAttrType()) {
+ case GeometryArrayRetained.AF:
+ for (int i=0; i < vAttrCount; i++) {
+ dst.setVertexAttrRefBuffer(i, src.getVertexAttrRefBuffer(i));
+ }
+ break;
+ }
+
+ switch (src.getTexCoordType()) {
+ case GeometryArrayRetained.TF:
+ for (int i=0; i < setCount; i++) {
+ dst.setTexCoordRefBuffer(i, src.getTexCoordRefBuffer(i));
+ }
+ break;
+ }
+ }
+ } else {
+ dst.setInterleavedVertices(src.getInterleavedVertices());
+ }
+ }
+ }
+
+
+ //------------------------------------------------------------------
+ // By-copying methods
+ //------------------------------------------------------------------
+
+ /**
+ * Sets the initial vertex index for this GeometryArray object.
+ * This index specifies the first vertex within this geometry
+ * array that is actually used in rendering or other operations
+ * such as picking and collision. This attribute is initialized
+ * to 0.
+ * This attribute is only used when the data mode for this
+ * geometry array object is not BY_REFERENCE
+ * or when the data mode is INTERLEAVED.
+ *
+ * @param initialVertexIndex the new initial vertex index.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalArgumentException if either of the following are
+ * true:
+ *
+ *
+ *
+ * @exception ArrayIndexOutOfBoundsException if the geometry data format
+ * is initialVertexIndex < 0 or
+ * initialVertexIndex + validVertexCount > vertexCount
+ * INTERLEAVED, the InterleavedVertices array is
+ * non-null, and:
+ *
+ *
+ * where num_words depends on which vertex formats are enabled.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is InterleavedVertices.length < num_words *
+ * (initialVertexIndex + validVertexCount)
+ * BY_REFERENCE and is not
+ * INTERLEAVED.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setInitialVertexIndex(int initialVertexIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray90"));
+
+ if (initialVertexIndex < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray97"));
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0 && (format & INTERLEAVED) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray105"));
+
+ ((GeometryArrayRetained)this.retained).setInitialVertexIndex(initialVertexIndex);
+ // NOTE: the check for initialVertexIndex + validVertexCount >
+ // vertexCount is done in the retained method
+ }
+
+
+ /**
+ * Gets the initial vertex index for this GeometryArray object.
+ * This attribute is only used when the data mode for this
+ * geometry array object is not BY_REFERENCE
+ * or when the data mode is INTERLEAVED.
+ * @return the current initial vertex index for this GeometryArray object.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getInitialVertexIndex() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray91"));
+
+ return ((GeometryArrayRetained)this.retained).getInitialVertexIndex();
+ }
+
+
+ /**
+ * Sets the coordinate associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param coordinate source array of 3 values containing the new coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinate(int index, float coordinate[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray3"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinate(index, coordinate);
+ }
+
+ /**
+ * Sets the coordinate associated with the vertex at
+ * the specified index.
+ * @param index destination vertex index in this geometry array
+ * @param coordinate source array of 3 values containing the new coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinate(int index, double coordinate[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray3"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinate(index, coordinate);
+ }
+
+ /**
+ * Sets the coordinate associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param coordinate a point containing the new coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinate(int index, Point3f coordinate) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray3"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinate(index, coordinate);
+ }
+
+ /**
+ * Sets the coordinate associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param coordinate a point containing the new coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinate(int index, Point3d coordinate) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray3"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinate(index, coordinate);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of 3*n values containing n new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, float coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of 3*n values containing n new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, double coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of points containing new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, Point3f coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of points containing new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, Point3d coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object using coordinate data starting
+ * from vertex index start for length vertices.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of 3*n values containing n new coordinates
+ * @param start starting source vertex index in coordinates array.
+ * @param length number of vertices to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, float coordinates[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates,
+ start, length);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object using coordinate data starting
+ * from vertex index start for length vertices.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of 3*n values containing n new coordinates
+ * @param start starting source vertex index in coordinates array.
+ * @param length number of vertices to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, double coordinates[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates,
+ start, length);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object using coordinate data starting
+ * from vertex index start for length vertices.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of points containing new coordinates
+ * @param start starting source vertex index in coordinates array.
+ * @param length number of vertices to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, Point3f coordinates[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates,
+ start, length);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object using coordinate data starting
+ * from vertex index start for length vertices.
+ * @param index starting destination vertex index in this geometry array
+ * @param coordinates source array of points containing new coordinates
+ * @param start starting source vertex index in coordinates array.
+ * @param length number of vertices to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setCoordinates(int index, Point3d coordinates[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray7"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).setCoordinates(index, coordinates,
+ start, length);
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param color source array of 3 or 4 values containing the new color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setColor(int index, float color[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray15"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).setColor(index, color);
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param color source array of 3 or 4 values containing the new color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setColor(int index, byte color[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray15"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).setColor(index, color);
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param color a Color3f containing the new color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in the vertex
+ * format
+ */
+ public void setColor(int index, Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray15"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColor(index, color);
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param color a Color4f containing the new color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in the vertex
+ * format
+ */
+ public void setColor(int index, Color4f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray15"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColor(index, color);
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param color a Color3b containing the new color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in the vertex
+ * format
+ */
+ public void setColor(int index, Color3b color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray15"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColor(index, color);
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param color a Color4b containing the new color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in the vertex
+ * format
+ */
+ public void setColor(int index, Color4b color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray15"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColor(index, color);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of 3*n or 4*n values containing n new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setColors(int index, float colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of 3*n or 4*n values containing n new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setColors(int index, byte colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color3f objects containing new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in vertex format
+ */
+ public void setColors(int index, Color3f colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color4f objects containing new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in vertex format
+ */
+ public void setColors(int index, Color4f colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color3b objects containing new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in vertex format
+ */
+ public void setColors(int index, Color3b colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color4b objects containing new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in vertex format
+ */
+ public void setColors(int index, Color4b colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of 3*n or 4*n values containing n new colors
+ * @param start starting source vertex index in colors array.
+ * @param length number of colors to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setColors(int index, float colors[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors, start,
+ length);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of 3*n or 4*n values containing n new colors
+ * @param start starting source vertex index in colors array.
+ * @param length number of colors to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setColors(int index, byte colors[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors, start,
+ length);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color3f objects containing new colors
+ * @param start starting source vertex index in colors array.
+ * @param length number of colors to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in vertex format
+ */
+ public void setColors(int index, Color3f colors[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors, start,
+ length);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color4f objects containing new colors
+ * @param start starting source vertex index in colors array.
+ * @param length number of colors to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in vertex format
+ */
+ public void setColors(int index, Color4f colors[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors, start,
+ length);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color3b objects containing new colors
+ * @param start starting source vertex index in colors array.
+ * @param length number of colors to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in vertex format
+ */
+ public void setColors(int index, Color3b colors[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors, start,
+ length);
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index starting destination vertex index in this geometry array
+ * @param colors source array of Color4b objects containing new colors
+ * @param start starting source vertex index in colors array.
+ * @param length number of colors to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if COLOR bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in vertex format
+ */
+ public void setColors(int index, Color4b colors[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray21"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColors(index, colors, start,
+ length);
+ }
+
+ /**
+ * Sets the normal associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param normal source array of 3 values containing the new normal
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if NORMALS bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setNormal(int index, float normal[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray33"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).setNormal(index, normal);
+ }
+
+ /**
+ * Sets the normal associated with the vertex at
+ * the specified index for this object.
+ * @param index destination vertex index in this geometry array
+ * @param normal the vector containing the new normal
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if NORMALS bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setNormal(int index, Vector3f normal) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray33"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).setNormal(index, normal);
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param normals source array of 3*n values containing n new normals
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if NORMALS bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setNormals(int index, float normals[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray35"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).setNormals(index, normals);
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index for this object. The entire source array is
+ * copied to this geometry array.
+ * @param index starting destination vertex index in this geometry array
+ * @param normals source array of vectors containing new normals
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if NORMALS bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setNormals(int index, Vector3f normals[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray35"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).setNormals(index, normals);
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index for this object using data in normals
+ * starting at index start and ending at index start+length.
+ * @param index starting destination vertex index in this geometry array
+ * @param normals source array of 3*n values containing n new normals
+ * @param start starting source vertex index in normals array.
+ * @param length number of normals to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if NORMALS bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setNormals(int index, float normals[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray35"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).setNormals(index, normals, start, length);
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index for this object using data in normals
+ * starting at index start and ending at index start+length.
+ * @param index starting destination vertex index in this geometry array
+ * @param normals source array of vectors containing new normals
+ * @param start starting source vertex index in normals array.
+ * @param length number of normals to be copied.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception ArrayIndexOutOfBoundsException if NORMALS bit NOT set in
+ * constructor vertexFormat or array index for element is out of bounds.
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void setNormals(int index, Vector3f normals[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray35"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).setNormals(index, normals, start, length);
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinate(int texCoordSet, ...)
+ */
+ public void setTextureCoordinate(int index, float texCoord[]) {
+ setTextureCoordinate(0, index, texCoord);
+ }
+
+ /**
+ * Sets the texture coordinate associated with the vertex at the
+ * specified index in the specified texture coordinate set for
+ * this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param texCoord source array of 2, 3 or 4 values containing the new
+ * texture coordinate
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinate(int texCoordSet,
+ int index, float texCoord[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray39"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoord, 0, 1);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinate(int texCoordSet, TexCoord2f texCoord)
+ */
+ public void setTextureCoordinate(int index, Point2f texCoord) {
+ texCoord2fScratch.set(texCoord);
+ setTextureCoordinate(0, index, texCoord2fScratch);
+ }
+
+ /**
+ * Sets the texture coordinate associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param texCoord the TexCoord2f containing the new texture coordinate
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_3 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinate(int texCoordSet,
+ int index, TexCoord2f texCoord) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray39"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_3 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray94"));
+
+ texCoord2fArray[0] = texCoord;
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoord2fArray, 0, 1);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinate(int texCoordSet, TexCoord3f texCoord)
+ */
+ public void setTextureCoordinate(int index, Point3f texCoord) {
+ texCoord3fScratch.set(texCoord);
+ setTextureCoordinate(0, index, texCoord3fScratch);
+ }
+
+ /**
+ * Sets the texture coordinate associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param texCoord the TexCoord3f containing the new texture coordinate
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinate(int texCoordSet,
+ int index, TexCoord3f texCoord) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray39"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray95"));
+
+ texCoord3fArray[0] = texCoord;
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoord3fArray, 0, 1);
+ }
+
+ /**
+ * Sets the texture coordinate associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param texCoord the TexCoord4f containing the new texture coordinate
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3 is specified in vertex format
+ *
+ * @since Java 3D 1.3
+ */
+ public void setTextureCoordinate(int texCoordSet,
+ int index, TexCoord4f texCoord) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray39"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_3)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray109"));
+
+ texCoord4fArray[0] = texCoord;
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoord4fArray, 0, 1);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinates(int texCoordSet, ...)
+ */
+ public void setTextureCoordinates(int index, float texCoords[]) {
+ setTextureCoordinates(0, index, texCoords);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The entire source array is
+ * copied to this geometry array.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of 2*n, 3*n or 4*n values containing n new
+ * texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, float texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & GeometryArray.TEXTURE_COORDINATE_2) != 0)
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, 0, texCoords.length / 2);
+ else if ((format & GeometryArray.TEXTURE_COORDINATE_3) != 0)
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, 0, texCoords.length / 3);
+ else
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, 0, texCoords.length / 4);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinates(int texCoordSet, TexCoord2f texCoords[])
+ */
+ public void setTextureCoordinates(int index, Point2f texCoords[]) {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ 0, index, texCoords, 0, texCoords.length);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The entire source array is
+ * copied to this geometry array.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of TexCoord2f objects containing new
+ * texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_3 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, TexCoord2f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_3 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray94"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, 0, texCoords.length);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinates(int texCoordSet, TexCoord3f texCoords[])
+ */
+ public void setTextureCoordinates(int index, Point3f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ 0, index, texCoords, 0, texCoords.length);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The entire source array is
+ * copied to this geometry array.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of TexCoord3f objects containing new
+ * texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, TexCoord3f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray95"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, 0, texCoords.length);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The entire source array is
+ * copied to this geometry array.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of TexCoord4f objects containing new
+ * texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3 is specified in vertex format
+ *
+ * @since Java 3D 1.3
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, TexCoord4f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_3)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray109"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, 0, texCoords.length);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinates(int texCoordSet, ...)
+ */
+ public void setTextureCoordinates(int index, float texCoords[],
+ int start, int length) {
+ setTextureCoordinates(0, index, texCoords, start, length);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices
+ * starting at the specified index in the specified texture
+ * coordinate set for this object using data in
+ * texCoords starting at index start and
+ * ending at index start+length.
+ *
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of 2*n , 3*n or 4*n values containing
+ * n new texture coordinates
+ * @param start starting source vertex index in texCoords
+ * array.
+ * @param length number of texture Coordinates to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, float texCoords[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, start, length);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinates(int texCoordSet, TexCoord2f texCoords[], ...)
+ */
+ public void setTextureCoordinates(int index, Point2f texCoords[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ 0, index, texCoords, start, length);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices
+ * starting at the specified index in the specified texture
+ * coordinate set for this object using data in
+ * texCoords starting at index start and
+ * ending at index start+length.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of TexCoord2f objects containing new
+ * texture coordinates
+ * @param start starting source vertex index in texCoords
+ * array.
+ * @param length number of texture Coordinates to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_3 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, TexCoord2f texCoords[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_3 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray94"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, start, length);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinates(int texCoordSet, TexCoord3f texCoords[], ...)
+ */
+ public void setTextureCoordinates(int index, Point3f texCoords[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ 0, index, texCoords, start, length);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices
+ * starting at the specified index in the specified texture
+ * coordinate set for this object. starting at index
+ * start and ending at index start+length.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of TexCoord3f objects containing new
+ * texture coordinates
+ * @param start starting source vertex index in texCoords
+ * array.
+ * @param length number of texture Coordinates to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, TexCoord3f texCoords[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray95"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, start, length);
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices
+ * starting at the specified index in the specified texture
+ * coordinate set for this object. starting at index
+ * start and ending at index start+length.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param texCoords source array of TexCoord4f objects containing new
+ * texture coordinates
+ * @param start starting source vertex index in texCoords
+ * array.
+ * @param length number of texture Coordinates to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3 is specified in vertex format
+ *
+ * @since Java 3D 1.3
+ */
+ public void setTextureCoordinates(int texCoordSet,
+ int index, TexCoord4f texCoords[],
+ int start, int length) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray42"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_3)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray109"));
+
+ ((GeometryArrayRetained)this.retained).setTextureCoordinates(
+ texCoordSet, index, texCoords, start, length);
+ }
+
+
+ /**
+ * Sets the vertex attribute associated with the vertex at the
+ * specified index in the specified vertex attribute number for
+ * this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param vertexAttr source array of 1, 2, 3 or 4 values containing
+ * the new vertex attribute
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range, or if the vertexAttr array is
+ * too small.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttr(int vertexAttrNum, int index,
+ float[] vertexAttr) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttr, 0, 1);
+ }
+
+ /**
+ * Sets the vertex attribute associated with the vertex at the
+ * specified index in the specified vertex attribute number for
+ * this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param vertexAttr the Point2f containing the new vertex attribute
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 2.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttr(int vertexAttrNum, int index,
+ Point2f vertexAttr) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 2) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttr(
+ vertexAttrNum, index, vertexAttr);
+ }
+
+ /**
+ * Sets the vertex attribute associated with the vertex at the
+ * specified index in the specified vertex attribute number for
+ * this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param vertexAttr the Point3f containing the new vertex attribute
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 3.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttr(int vertexAttrNum, int index,
+ Point3f vertexAttr) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 3) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttr(
+ vertexAttrNum, index, vertexAttr);
+ }
+
+ /**
+ * Sets the vertex attribute associated with the vertex at the
+ * specified index in the specified vertex attribute number for
+ * this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param vertexAttr the Point4f containing the new vertex attribute
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 4.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttr(int vertexAttrNum, int index,
+ Point4f vertexAttr) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 4) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttr(
+ vertexAttrNum, index, vertexAttr);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The entire source array is copied to this
+ * geometry array.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of 1*n, 2*n, 3*n, or 4*n values
+ * containing n new vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range, or if the vertexAttr array is
+ * too large.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ float[] vertexAttrs) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, 0, vertexAttrs.length / size);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The entire source array is copied to this
+ * geometry array.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point2f objects containing new
+ * vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range, or if the vertexAttr array is
+ * too large.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 2.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ Point2f[] vertexAttrs) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 2) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, 0, vertexAttrs.length);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The entire source array is copied to this
+ * geometry array.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point3f objects containing new
+ * vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range, or if the vertexAttr array is
+ * too large.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 3.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ Point3f[] vertexAttrs) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 3) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, 0, vertexAttrs.length);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The entire source array is copied to this
+ * geometry array.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point4f objects containing new
+ * vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range, or if the vertexAttr array is
+ * too large.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 4.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ Point4f[] vertexAttrs) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 4) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, 0, vertexAttrs.length);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of 1*n, 2*n, 3*n, or 4*n values
+ * containing n new vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if any of index,
+ * (index+length), or vertexAttrNum are out of range, or if
+ * vertexAttrs is too small.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ float[] vertexAttrs,
+ int start, int length) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, start, length);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point2f objects containing new
+ * vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if any of index,
+ * (index+length), or vertexAttrNum are out of range, or if
+ * vertexAttrs is too small.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 2.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ Point2f[] vertexAttrs,
+ int start, int length) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 2) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, start, length);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point3f objects containing new
+ * vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if any of index,
+ * (index+length), or vertexAttrNum are out of range, or if
+ * vertexAttrs is too small.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 3.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ Point3f[] vertexAttrs,
+ int start, int length) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 3) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, start, length);
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point4f objects containing new
+ * vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if any of index,
+ * (index+length), or vertexAttrNum are out of range, or if
+ * vertexAttrs is too small.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 4.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrs(int vertexAttrNum, int index,
+ Point4f[] vertexAttrs,
+ int start, int length) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray126"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 4) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrs(
+ vertexAttrNum, index, vertexAttrs, start, length);
+ }
+
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index for this object using data in texCoords
+ * @param index source vertex index in this geometry array
+ * @param coordinate destination array of 3 values that will receive the coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinate(int index, float coordinate[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray48"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinate(index, coordinate);
+ }
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param coordinate destination array of 3 values that will receive the coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinate(int index, double coordinate[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray48"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinate(index, coordinate);
+ }
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param coordinate a vector that will receive the coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinate(int index, Point3f coordinate) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray48"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinate(index, coordinate);
+ }
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param coordinate a vector that will receive the coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinate(int index, Point3d coordinate) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray48"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinate(index, coordinate);
+ }
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index for this object. The length of the destination
+ * array determines the number of vertices copied.
+ * A maximum of vertexCount-index coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the coordinates, only as
+ * many coordinates as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param coordinates destination array of 3*n values that will receive new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinates(int index, float coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray52"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinates(index, coordinates);
+ }
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index for this object. The length of the destination
+ * array determines the number of vertices copied.
+ * A maximum of vertexCount-index coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the coordinates, only as
+ * many coordinates as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param coordinates destination array of 3*n values that will receive new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinates(int index, double coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray52"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinates(index, coordinates);
+ }
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index for this object. The length of the destination
+ * array determines the number of vertices copied.
+ * A maximum of vertexCount-index coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the coordinates, only as
+ * many coordinates as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param coordinates destination array of points that will receive new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinates(int index, Point3f coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray52"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinates(index, coordinates);
+ }
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index for this object. The length of the destination
+ * array determines the number of vertices copied.
+ * A maximum of vertexCount-index coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the coordinates, only as
+ * many coordinates as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param coordinates destination array of points that will receive new coordinates
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getCoordinates(int index, Point3d coordinates[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray52"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ ((GeometryArrayRetained)this.retained).getCoordinates(index, coordinates);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index for this object. The color is copied into the
+ * specified array. The array must be large enough to hold all
+ * of the colors.
+ * @param index source vertex index in this geometry array
+ * @param color destination array of 3 or 4 values that will receive the color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getColor(int index, float color[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray56"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).getColor(index, color);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index for this object. The color is copied into the
+ * specified array. The array must be large enough to hold all of
+ * the colors.
+ * @param index source vertex index in this geometry array
+ * @param color destination array of 3 or 4 values that will receive the color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getColor(int index, byte color[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray56"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).getColor(index, color);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param color a vector that will receive the color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in the vertex
+ * format
+ */
+ public void getColor(int index, Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray56"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).getColor(index, color);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param color a vector that will receive the color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in the vertex
+ * format
+ */
+ public void getColor(int index, Color4f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray56"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).getColor(index, color);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param color a vector that will receive the color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in the vertex
+ * format
+ */
+ public void getColor(int index, Color3b color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray56"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).getColor(index, color);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param color a vector that will receive the color
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in the vertex
+ * format
+ */
+ public void getColor(int index, Color4b color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray56"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).getColor(index, color);
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index for this object. The color is copied into the
+ * specified array. The length of the destination
+ * array determines the number of colors copied.
+ * A maximum of vertexCount-index colors
+ * are copied. If the destination array is larger than is needed
+ * to hold the colors, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the colors, only as
+ * many colors as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param colors destination array of 3*n or 4*n values that will
+ * receive n new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getColors(int index, float colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray62"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).getColors(index, colors);
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index for this object. The color is copied into the
+ * specified array. The length of the destination
+ * array determines the number of colors copied.
+ * A maximum of vertexCount-index colors
+ * are copied. If the destination array is larger than is needed
+ * to hold the colors, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the colors, only as
+ * many colors as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param colors destination array of 3*n or 4*n values that will
+ * receive new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getColors(int index, byte colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray62"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ ((GeometryArrayRetained)this.retained).getColors(index, colors);
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index for this object. The color is copied into the
+ * specified array. The length of the destination
+ * array determines the number of colors copied.
+ * A maximum of vertexCount-index colors
+ * are copied. If the destination array is larger than is needed
+ * to hold the colors, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the colors, only as
+ * many colors as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param colors destination array of Color3f objects that will receive new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in the vertex
+ * format
+ */
+ public void getColors(int index, Color3f colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray62"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).getColors(index, colors);
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index for this object. The color is copied into the
+ * specified array. The length of the destination
+ * array determines the number of colors copied.
+ * A maximum of vertexCount-index colors
+ * are copied. If the destination array is larger than is needed
+ * to hold the colors, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the colors, only as
+ * many colors as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param colors destination array of Color4f objects that will receive new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in the vertex
+ * format
+ */
+ public void getColors(int index, Color4f colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray62"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).getColors(index, colors);
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index for this object. The color is copied into the
+ * specified array. The length of the destination
+ * array determines the number of colors copied.
+ * A maximum of vertexCount-index colors
+ * are copied. If the destination array is larger than is needed
+ * to hold the colors, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the colors, only as
+ * many colors as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param colors destination array of Color3b objects that will receive new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_4 is specified in the vertex
+ * format
+ */
+ public void getColors(int index, Color3b colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray62"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).getColors(index, colors);
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index for this object. The color is copied into the
+ * specified array. The length of the destination
+ * array determines the number of colors copied.
+ * A maximum of vertexCount-index colors
+ * are copied. If the destination array is larger than is needed
+ * to hold the colors, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the colors, only as
+ * many colors as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param colors destination array of Color4b objects that will receive new colors
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ * @exception IllegalStateException if COLOR_3 is specified in the vertex
+ * format
+ */
+ public void getColors(int index, Color4b colors[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray62"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & COLOR ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray76"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).getColors(index, colors);
+ }
+
+ /**
+ * Gets the normal associated with the vertex at
+ * the specified index for this object. The normal is copied into
+ * the specified array.
+ * @param index source vertex index in this geometry array
+ * @param normal destination array of 3 values that will receive the normal
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getNormal(int index, float normal[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray68"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).getNormal(index, normal);
+ }
+
+ /**
+ * Gets the normal associated with the vertex at
+ * the specified index for this object.
+ * @param index source vertex index in this geometry array
+ * @param normal the vector that will receive the normal
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getNormal(int index, Vector3f normal) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray68"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).getNormal(index, normal);
+ }
+
+ /**
+ * Gets the normals associated with the vertices starting at
+ * the specified index for this object. The length of the destination
+ * array determines the number of normals copied.
+ * A maximum of vertexCount-index normals
+ * are copied. If the destination array is larger than is needed
+ * to hold the normals, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the normals, only as
+ * many normals as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param normals destination array of 3*n values that will receive the normal
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getNormals(int index, float normals[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray70"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).getNormals(index, normals);
+ }
+
+ /**
+ * Gets the normals associated with the vertices starting at
+ * the specified index for this object. The length of the destination
+ * array determines the number of normals copied.
+ * A maximum of vertexCount-index normals
+ * are copied. If the destination array is larger than is needed
+ * to hold the normals, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the normals, only as
+ * many normals as the array will hold are copied.
+ *
+ * @param index starting source vertex index in this geometry array
+ * @param normals destination array of vectors that will receive the normals
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ */
+ public void getNormals(int index, Vector3f normals[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray70"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & NORMALS ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray77"));
+
+ ((GeometryArrayRetained)this.retained).getNormals(index, normals);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinate(int texCoordSet, ...)
+ */
+ public void getTextureCoordinate(int index, float texCoord[]) {
+ getTextureCoordinate(0, index, texCoord);
+ }
+
+ /**
+ * Gets the texture coordinate associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param texCoord array of 2, 3 or 4 values that will receive the
+ * texture coordinate
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTextureCoordinate(int texCoordSet,
+ int index, float texCoord[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray72"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ ((GeometryArrayRetained)this.retained).getTextureCoordinate(
+ texCoordSet, index, texCoord);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinate(int texCoordSet, TexCoord2f texCoord)
+ */
+ public void getTextureCoordinate(int index, Point2f texCoord) {
+ getTextureCoordinate(0, index, texCoord2fArray[0]);
+ texCoord.set(texCoord2fArray[0]);
+ }
+
+ /**
+ * Gets the texture coordinate associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param texCoord the vector that will receive the texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_3 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTextureCoordinate(int texCoordSet,
+ int index, TexCoord2f texCoord) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray72"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_3 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray94"));
+
+ ((GeometryArrayRetained)this.retained).getTextureCoordinate(
+ texCoordSet, index, texCoord);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinate(int texCoordSet, TexCoord3f texCoord)
+ */
+ public void getTextureCoordinate(int index, Point3f texCoord) {
+ getTextureCoordinate(0, index, texCoord3fArray[0]);
+ texCoord.set(texCoord3fArray[0]);
+ }
+
+ /**
+ * Gets the texture coordinate associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param texCoord the vector that will receive the texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTextureCoordinate(int texCoordSet,
+ int index, TexCoord3f texCoord) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray72"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray95"));
+ ((GeometryArrayRetained)this.retained).getTextureCoordinate(
+ texCoordSet, index, texCoord);
+ }
+
+ /**
+ * Gets the texture coordinate associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param texCoord the vector that will receive the texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3 is specified in vertex format
+ *
+ * @since Java 3D 1.3
+ */
+ public void getTextureCoordinate(int texCoordSet,
+ int index, TexCoord4f texCoord) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray72"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_3)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray109"));
+ ((GeometryArrayRetained)this.retained).getTextureCoordinate(
+ texCoordSet, index, texCoord);
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinates(int texCoordSet, ...)
+ */
+ public void getTextureCoordinates(int index, float texCoords[]) {
+ getTextureCoordinates(0, index, texCoords);
+ }
+
+ /**
+ * Gets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The length of the destination
+ * array determines the number of texture coordinates copied.
+ * A maximum of vertexCount-index texture coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the texture coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the texture coordinates, only as
+ * many texture coordinates as the array will hold are copied.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param texCoords destination array of 2*n , 3*n or 4*n values that
+ * will receive n new texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTextureCoordinates(int texCoordSet,
+ int index, float texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray75"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ ((GeometryArrayRetained)this.retained).getTextureCoordinates(
+ texCoordSet, index, texCoords);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinates(int texCoordSet, TexCoord2f texCoords[])
+ */
+ public void getTextureCoordinates(int index, Point2f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray75"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ ((GeometryArrayRetained)this.retained).getTextureCoordinates(
+ 0, index, texCoords);
+ }
+
+ /**
+ * Gets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The length of the destination
+ * array determines the number of texture coordinates copied.
+ * A maximum of vertexCount-index texture coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the texture coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the texture coordinates, only as
+ * many texture coordinates as the array will hold are copied.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param texCoords destination array of TexCoord2f objects that will
+ * receive the texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_3 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTextureCoordinates(int texCoordSet,
+ int index, TexCoord2f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray75"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_3 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray94"));
+ ((GeometryArrayRetained)this.retained).getTextureCoordinates(
+ texCoordSet, index, texCoords);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinates(int texCoordSet, TexCoord3f texCoords[])
+ */
+ public void getTextureCoordinates(int index, Point3f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray75"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ ((GeometryArrayRetained)this.retained).getTextureCoordinates(
+ 0, index, texCoords);
+ }
+
+ /**
+ * Gets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The length of the destination
+ * array determines the number of texture coordinates copied.
+ * A maximum of vertexCount-index texture coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the texture coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the texture coordinates, only as
+ * many texture coordinates as the array will hold are copied.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param texCoords destination array of TexCoord3f objects that will
+ * receive the texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_4 is specified in vertex format
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTextureCoordinates(int texCoordSet,
+ int index, TexCoord3f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray75"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray95"));
+ ((GeometryArrayRetained)this.retained).getTextureCoordinates(
+ texCoordSet, index, texCoords);
+ }
+
+
+ /**
+ * Gets the texture coordinates associated with the vertices starting at
+ * the specified index in the specified texture coordinate set
+ * for this object. The length of the destination
+ * array determines the number of texture coordinates copied.
+ * A maximum of vertexCount-index texture coordinates
+ * are copied. If the destination array is larger than is needed
+ * to hold the texture coordinates, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the texture coordinates, only as
+ * many texture coordinates as the array will hold are copied.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param texCoords destination array of TexCoord4f objects that will
+ * receive the texture coordinates
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if TEXTURE_COORDINATE_2 or
+ * TEXTURE_COORDINATE_3 is specified in vertex format
+ *
+ * @since Java 3D 1.3
+ */
+ public void getTextureCoordinates(int texCoordSet,
+ int index, TexCoord4f texCoords[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray75"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((format & TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ if (((((GeometryArrayRetained)this.retained).vertexFormat) &
+ (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_3)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray109"));
+
+ ((GeometryArrayRetained)this.retained).getTextureCoordinates(
+ texCoordSet, index, texCoords);
+ }
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param vertexAttr array of 1, 2, 3 or 4 values that will receive the
+ * vertex attribute
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range, or if the vertexAttr array is
+ * too small.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ float[] vertexAttr) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttr(
+ vertexAttrNum, index, vertexAttr);
+ }
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param vertexAttr the vector that will receive the vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 2.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ Point2f vertexAttr) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 2) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttr(
+ vertexAttrNum, index, vertexAttr);
+ }
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param vertexAttr the vector that will receive the vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 3.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ Point3f vertexAttr) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 3) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttr(
+ vertexAttrNum, index, vertexAttr);
+ }
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index source vertex index in this geometry array
+ * @param vertexAttr the vector that will receive the vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 4.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ Point4f vertexAttr) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 4) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttr(
+ vertexAttrNum, index, vertexAttr);
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The length of the destination
+ * array determines the number of vertex attributes copied.
+ * A maximum of vertexCount-index vertex attributes
+ * are copied. If the destination array is larger than is needed
+ * to hold the vertex attributes, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the vertex attributes, only as
+ * many vertex attributes as the array will hold are copied.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param vertexAttrs destination array of 1*n, 2*n, 3*n, or 4*n values
+ * that will receive n new vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ float[] vertexAttrs) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttrs(
+ vertexAttrNum, index, vertexAttrs);
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The length of the destination
+ * array determines the number of vertex attributes copied.
+ * A maximum of vertexCount-index vertex attributes
+ * are copied. If the destination array is larger than is needed
+ * to hold the vertex attributes, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the vertex attributes, only as
+ * many vertex attributes as the array will hold are copied.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param vertexAttrs destination array of Point2f objects that will
+ * receive the vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 2.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ Point2f[] vertexAttrs) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 2) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttrs(
+ vertexAttrNum, index, vertexAttrs);
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The length of the destination
+ * array determines the number of vertex attributes copied.
+ * A maximum of vertexCount-index vertex attributes
+ * are copied. If the destination array is larger than is needed
+ * to hold the vertex attributes, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the vertex attributes, only as
+ * many vertex attributes as the array will hold are copied.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param vertexAttrs destination array of Point3f objects that will
+ * receive the vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 3.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ Point3f[] vertexAttrs) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 3) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttrs(
+ vertexAttrNum, index, vertexAttrs);
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object. The length of the destination
+ * array determines the number of vertex attributes copied.
+ * A maximum of vertexCount-index vertex attributes
+ * are copied. If the destination array is larger than is needed
+ * to hold the vertex attributes, the excess locations in the
+ * array are not modified. If the destination array is smaller
+ * than is needed to hold the vertex attributes, only as
+ * many vertex attributes as the array will hold are copied.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting source vertex index in this geometry array
+ * @param vertexAttrs destination array of Point4f objects that will
+ * receive the vertex attributes
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE.
+ *
+ * @exception IllegalStateException if the size of the specified
+ * vertex attribute number is not 4.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ Point4f[] vertexAttrs) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_VERTEX_ATTR_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray127"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+ }
+
+ int size = ((GeometryArrayRetained)this.retained).vertexAttrSizes[vertexAttrNum];
+ if (size != 4) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray134"));
+ }
+
+ ((GeometryArrayRetained)this.retained).getVertexAttrs(
+ vertexAttrNum, index, vertexAttrs);
+ }
+
+
+ //------------------------------------------------------------------
+ // By-reference methods
+ //------------------------------------------------------------------
+
+ /**
+ * Sets the initial coordinate index for this GeometryArray object.
+ * This index specifies the first coordinate within the array of
+ * coordinates referenced by this geometry
+ * array that is actually used in rendering or other operations
+ * such as picking and collision. This attribute is initialized
+ * to 0.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ *
+ * @param initialCoordIndex the new initial coordinate index.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * BY_REFERENCE or if the data mode
+ * is INTERLEAVED.
+ *
+ *
+ * initialCoordIndex < 0 or
+ * initialCoordIndex + validVertexCount > vertexCount
+ *
+ *
+ * where num_words depends on which variant of
+ * CoordRef.length < num_words *
+ * (initialCoordIndex + validVertexCount)
+ * setCoordRef is used.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setInitialCoordIndex(int initialCoordIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray90"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if (initialCoordIndex < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray97"));
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setInitialCoordIndex(initialCoordIndex);
+ // NOTE: the check for initialCoordIndex + validVertexCount >
+ // vertexCount needs to be done in the retained method
+ }
+
+
+ /**
+ * Gets the initial coordinate index for this GeometryArray object.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ * @return the current initial coordinate index for this
+ * GeometryArray object.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getInitialCoordIndex() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray91"));
+
+ return ((GeometryArrayRetained)this.retained).getInitialCoordIndex();
+ }
+
+
+ /**
+ * Sets the initial color index for this GeometryArray object.
+ * This index specifies the first color within the array of
+ * colors referenced by this geometry
+ * array that is actually used in rendering or other operations
+ * such as picking and collision. This attribute is initialized
+ * to 0.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ *
+ * @param initialColorIndex the new initial color index.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * BY_REFERENCE or if the data mode
+ * is INTERLEAVED.
+ *
+ *
+ * initialColorIndex < 0 or
+ * initialColorIndex + validVertexCount > vertexCount
+ *
+ *
+ * where num_words depends on which variant of
+ * ColorRef.length < num_words *
+ * (initialColorIndex + validVertexCount)
+ * setColorRef is used.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setInitialColorIndex(int initialColorIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray90"));
+
+ if (initialColorIndex < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray97"));
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setInitialColorIndex(initialColorIndex);
+ // NOTE: the check for initialColorIndex + validVertexCount >
+ // vertexCount needs to be done in the retained method
+ }
+
+
+ /**
+ * Gets the initial color index for this GeometryArray object.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ * @return the current initial color index for this
+ * GeometryArray object.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getInitialColorIndex() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray91"));
+
+ return ((GeometryArrayRetained)this.retained).getInitialColorIndex();
+ }
+
+
+ /**
+ * Sets the initial normal index for this GeometryArray object.
+ * This index specifies the first normal within the array of
+ * normals referenced by this geometry
+ * array that is actually used in rendering or other operations
+ * such as picking and collision. This attribute is initialized
+ * to 0.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ *
+ * @param initialNormalIndex the new initial normal index.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * BY_REFERENCE or if the data mode
+ * is INTERLEAVED.
+ *
+ *
+ * initialNormalIndex < 0 or
+ * initialNormalIndex + validVertexCount > vertexCount
+ *
+ *
+ * where num_words depends on which variant of
+ * NormalRef.length < num_words *
+ * (initialNormalIndex + validVertexCount)
+ * setNormalRef is used.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setInitialNormalIndex(int initialNormalIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray90"));
+
+ if (initialNormalIndex < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray97"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setInitialNormalIndex(initialNormalIndex);
+ // NOTE: the check for initialNormalIndex + validVertexCount >
+ // vertexCount needs to be done in the retained method
+ }
+
+
+ /**
+ * Gets the initial normal index for this GeometryArray object.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ * @return the current initial normal index for this
+ * GeometryArray object.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getInitialNormalIndex() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray91"));
+
+ return ((GeometryArrayRetained)this.retained).getInitialNormalIndex();
+ }
+
+
+ /**
+ * Sets the initial texture coordinate index for the specified
+ * texture coordinate set for this GeometryArray object. This
+ * index specifies the first texture coordinate within the array
+ * of texture coordinates referenced by this geometry array that
+ * is actually used in rendering or other operations such as
+ * picking and collision. This attribute is initialized to 0.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param initialTexCoordIndex the new initial texture coordinate index.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * BY_REFERENCE or if the data mode
+ * is INTERLEAVED.
+ *
+ *
+ * initialTexCoordIndex < 0 or
+ * initialTexCoordIndex + validVertexCount > vertexCount
+ *
+ *
+ * where num_words depends on which variant of
+ * TexCoordRef.length < num_words *
+ * (initialTexCoordIndex + validVertexCount)
+ * setTexCoordRef is used.
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if texCoordSet is out of range.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setInitialTexCoordIndex(int texCoordSet,
+ int initialTexCoordIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray90"));
+
+ if (initialTexCoordIndex < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryArray97"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setInitialTexCoordIndex(
+ texCoordSet, initialTexCoordIndex);
+
+ // NOTE: the check for initialTexCoordIndex + validVertexCount >
+ // vertexCount needs to be done in the retained method
+ }
+
+
+ /**
+ * Gets the initial texture coordinate index for the specified
+ * texture coordinate set for this GeometryArray object.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ *
+ * @return the current initial texture coordinate index for the specified
+ * texture coordinate set
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if texCoordSet is out of range.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public int getInitialTexCoordIndex(int texCoordSet) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray91"));
+
+ return ((GeometryArrayRetained)this.retained).getInitialTexCoordIndex(
+ texCoordSet);
+ }
+
+
+ /**
+ * Sets the initial vertex attribute index for the specified
+ * vertex attribute number for this GeometryArray object. This
+ * index specifies the first vertex attribute within the array
+ * of vertex attributes referenced by this geometry array that
+ * is actually used in rendering or other operations such as
+ * picking and collision. This attribute is initialized to 0.
+ * This attribute is only used when the data mode for this
+ * geometry array object is BY_REFERENCE
+ * and is not INTERLEAVED.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param initialVertexAttrIndex the new initial vertex attribute index.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * BY_REFERENCE or if the data mode
+ * is INTERLEAVED.
+ *
+ *
+ * initialVertexAttrIndex < 0 or
+ * initialVertexAttrIndex + validVertexCount > vertexCount
+ *
+ *
+ * where num_words is the size of the specified
+ * vertexAttrNum (1, 2, 3, or 4).
+ * VertexAttrRef.length < num_words *
+ * (initialVertexAttrIndex + validVertexCount)
+ * BY_REFERENCE
+ * and is not INTERLEAVED.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ *
+ * @return the current initial vertex attribute index for the specified
+ * vertex attribute number
+ *
+ * @exception ArrayIndexOutOfBoundsException if vertexAttrNum is
+ * out of range.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.4
+ */
+ public int getInitialVertexAttrIndex(int vertexAttrNum) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_COUNT_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray91"));
+ }
+ }
+
+ return ((GeometryArrayRetained)this.retained).getInitialVertexAttrIndex(
+ vertexAttrNum);
+ }
+
+
+ /**
+ * Sets the coordinate buffer reference to the specified
+ * buffer object. The buffer contains either a java.nio.FloatBuffer
+ * or java.nio.DoubleBuffer object containing single or double
+ * precision floating-point x, y,
+ * and z values for each vertex (for a total of 3*n
+ * values, where n is the number of vertices).
+ * If the coordinate buffer
+ * reference is null, the entire geometry array object is
+ * treated as if it were null--any Shape3D or Morph node that uses
+ * this geometry array will not be drawn.
+ *
+ * @param coords a J3DBuffer object to which a reference will be set.
+ * The buffer contains an NIO buffer of 3*n float or
+ * double values.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception IllegalArgumentException if the java.nio.Buffer
+ * contained in the specified J3DBuffer is not a
+ * java.nio.FloatBuffer or a java.nio.DoubleBuffer object.
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * coords.getBuffer().limit() <
+ * 3 * (initialCoordIndex + validVertexCount).
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the coordinate index array is greater than or equal to the
+ * number of vertices defined by the coords object,
+ * coords.getBuffer().limit() / 3.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setCoordRefBuffer(J3DBuffer coords) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setCoordRefBuffer(coords);
+ }
+
+
+ /**
+ * Gets the coordinate array buffer reference.
+ * @return the current coordinate array buffer reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.3
+ */
+ public J3DBuffer getCoordRefBuffer() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getCoordRefBuffer();
+ }
+
+
+ /**
+ * Sets the float coordinate array reference to the specified
+ * array. The array contains floating-point x, y,
+ * and z values for each vertex (for a total of 3*n
+ * values, where n is the number of vertices). Only one of
+ * coordRefFloat, coordRefDouble,
+ * coordRef3f, or coordRef3d may be
+ * non-null (or they may all be null). An attempt to set more
+ * than one of these attributes to a non-null reference will
+ * result in an exception being thrown. If all coordinate array
+ * references are null, the entire geometry array object is
+ * treated as if it were null--any Shape3D or Morph node that uses
+ * this geometry array will not be drawn.
+ *
+ * @param coords an array of 3*n values to which a
+ * reference will be set.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any other coordinate reference is also non-null.
+ * @exception ArrayIndexOutOfBoundsException if
+ * coords.length < 3 * (initialCoordIndex + validVertexCount).
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the coordinate index array is greater than or equal to the
+ * number of vertices defined by the coords array,
+ * coords.length / 3.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setCoordRefFloat(float[] coords) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setCoordRefFloat(coords);
+
+ }
+
+
+ /**
+ * Gets the float coordinate array reference.
+ * @return the current float coordinate array reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.2
+ */
+ public float[] getCoordRefFloat() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getCoordRefFloat();
+ }
+
+
+ /**
+ * Sets the double coordinate array reference to the specified
+ * array. The array contains double-precision
+ * floating-point x, y,
+ * and z values for each vertex (for a total of 3*n
+ * values, where n is the number of vertices). Only one of
+ * coordRefFloat, coordRefDouble,
+ * coordRef3f, or coordRef3d may be
+ * non-null (or they may all be null). An attempt to set more
+ * than one of these attributes to a non-null reference will
+ * result in an exception being thrown. If all coordinate array
+ * references are null, the entire geometry array object is
+ * treated as if it were null--any Shape3D or Morph node that uses
+ * this geometry array will not be drawn.
+ *
+ * @param coords an array of 3*n values to which a
+ * reference will be set.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any other coordinate reference is also non-null.
+ * @exception ArrayIndexOutOfBoundsException if
+ * coords.length < 3 * (initialCoordIndex + validVertexCount).
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the coordinate index array is greater than or equal to the
+ * number of vertices defined by the coords array,
+ * coords.length / 3.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setCoordRefDouble(double[] coords) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setCoordRefDouble(coords);
+
+ }
+
+
+ /**
+ * Gets the double coordinate array reference.
+ * @return the current double coordinate array reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.2
+ */
+ public double[] getCoordRefDouble() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getCoordRefDouble();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Point3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setCoordRef3f(Point3f[] coords) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setCoordRef3f(coords);
+
+
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Point3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public Point3f[] getCoordRef3f() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getCoordRef3f();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Point3d arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setCoordRef3d(Point3d[] coords) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setCoordRef3d(coords);
+
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Point3d arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public Point3d[] getCoordRef3d() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getCoordRef3d();
+ }
+
+
+ /**
+ * Sets the color buffer reference to the specified
+ * buffer object. The buffer contains either a java.nio.FloatBuffer
+ * or java.nio.ByteBuffer object containing floating-point
+ * or byte red, green,
+ * blue, and, optionally, alpha values for each
+ * vertex (for a total of 3*n or 4*n values, where
+ * n is the number of vertices).
+ * If the color buffer reference is null and colors are enabled
+ * (that is, the vertexFormat includes either COLOR_3 or
+ * COLOR_4), the entire geometry array object is
+ * treated as if it were null--any Shape3D or Morph node that uses
+ * this geometry array will not be drawn.
+ *
+ * @param colors a J3DBuffer object to which a reference will be set.
+ * The buffer contains an NIO buffer of 3*n or 4*n
+ * float or byte values.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception IllegalArgumentException if the java.nio.Buffer
+ * contained in the specified J3DBuffer is not a
+ * java.nio.FloatBuffer or a java.nio.ByteBuffer object.
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * COLOR bits are set in the
+ * vertexFormat, or if
+ * colors.getBuffer().limit() < num_words *
+ * (initialColorIndex + validVertexCount),
+ * where num_words is 3 or 4 depending on the vertex color format.
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the color index array is greater than or equal to the
+ * number of vertices defined by the colors object,
+ * colors.getBuffer().limit() / num_words.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setColorRefBuffer(J3DBuffer colors) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setColorRefBuffer(colors);
+
+ }
+
+
+ /**
+ * Gets the color array buffer reference.
+ * @return the current color array buffer reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.3
+ */
+ public J3DBuffer getColorRefBuffer() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getColorRefBuffer();
+ }
+
+
+ /**
+ * Sets the float color array reference to the specified array.
+ * The array contains floating-point red, green,
+ * blue, and, optionally, alpha values for each
+ * vertex (for a total of 3*n or 4*n values, where
+ * n is the number of vertices). Only one of
+ * colorRefFloat, colorRefByte,
+ * colorRef3f, colorRef4f,
+ * colorRef3b, or colorRef4b may be
+ * non-null (or they may all be null). An attempt to set more
+ * than one of these attributes to a non-null reference will
+ * result in an exception being thrown. If all color array
+ * references are null and colors are enabled (that is, the
+ * vertexFormat includes either COLOR_3 or
+ * COLOR_4), the entire geometry array object is
+ * treated as if it were null--any Shape3D or Morph node that uses
+ * this geometry array will not be drawn.
+ *
+ * @param colors an array of 3*n or 4*n values to which a
+ * reference will be set.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any other color reference is also non-null.
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * COLOR bits are set in the
+ * vertexFormat, or if
+ * colors.length < num_words *
+ * (initialColorIndex + validVertexCount),
+ * where num_words is 3 or 4 depending on the vertex color format.
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the color index array is greater than or equal to the
+ * number of vertices defined by the colors array,
+ * colors.length / num_words.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setColorRefFloat(float[] colors) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setColorRefFloat(colors);
+
+ }
+
+
+ /**
+ * Gets the float color array reference.
+ * @return the current float color array reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.2
+ */
+ public float[] getColorRefFloat() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getColorRefFloat();
+ }
+
+
+ /**
+ * Sets the byte color array reference to the specified array.
+ * The array contains red, green,
+ * blue, and, optionally, alpha values for each
+ * vertex (for a total of 3*n or 4*n values, where
+ * n is the number of vertices). Only one of
+ * colorRefFloat, colorRefByte,
+ * colorRef3f, colorRef4f,
+ * colorRef3b, or colorRef4b may be
+ * non-null (or they may all be null). An attempt to set more
+ * than one of these attributes to a non-null reference will
+ * result in an exception being thrown. If all color array
+ * references are null and colors are enabled (that is, the
+ * vertexFormat includes either COLOR_3 or
+ * COLOR_4), the entire geometry array object is
+ * treated as if it were null--any Shape3D or Morph node that uses
+ * this geometry array will not be drawn.
+ *
+ * @param colors an array of 3*n or 4*n values to which a
+ * reference will be set.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any other color reference is also non-null.
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * COLOR bits are set in the
+ * vertexFormat, or if
+ * colors.length < num_words *
+ * (initialColorIndex + validVertexCount),
+ * where num_words is 3 or 4 depending on the vertex color format.
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the color index array is greater than or equal to the
+ * number of vertices defined by the colors array,
+ * colors.length / num_words.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setColorRefByte(byte[] colors) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setColorRefByte(colors);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * Gets the byte color array reference.
+ * @return the current byte color array reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.2
+ */
+ public byte[] getColorRefByte() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getColorRefByte();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setColorRef3f(Color3f[] colors) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColorRef3f(colors);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public Color3f[] getColorRef3f() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getColorRef3f();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color4f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setColorRef4f(Color4f[] colors) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColorRef4f(colors);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color4f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public Color4f[] getColorRef4f() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getColorRef4f();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color3b arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setColorRef3b(Color3b[] colors) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ if ((format & WITH_ALPHA) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray92"));
+
+ ((GeometryArrayRetained)this.retained).setColorRef3b(colors);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color3b arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public Color3b[] getColorRef3b() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getColorRef3b();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color4b arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setColorRef4b(Color4b[] colors) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ if ((format & WITH_ALPHA) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray93"));
+
+ ((GeometryArrayRetained)this.retained).setColorRef4b(colors);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Color4b arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public Color4b[] getColorRef4b() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getColorRef4b();
+ }
+
+
+ /**
+ * Sets the normal buffer reference to the specified
+ * buffer object. The buffer contains a java.nio.FloatBuffer
+ * object containing nx, ny,
+ * and nz values for each vertex (for a total of 3*n
+ * values, where n is the number of vertices).
+ * If the normal buffer reference is null and normals are enabled
+ * (that is, the vertexFormat includes NORMAL), the
+ * entire geometry array object is treated as if it were null--any
+ * Shape3D or Morph node that uses this geometry array will not be
+ * drawn.
+ *
+ * @param normals a J3DBuffer object to which a reference will be set.
+ * The buffer contains an NIO buffer of 3*n float values.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception IllegalArgumentException if the java.nio.Buffer
+ * contained in the specified J3DBuffer is not a
+ * java.nio.FloatBuffer object.
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * NORMALS bit is not set in the
+ * vertexFormat, or if
+ * normals.getBuffer().limit() <
+ * 3 * (initialNormalIndex + validVertexCount).
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the normal index array is greater than or equal to the
+ * number of vertices defined by the normals object,
+ * normals.getBuffer().limit() / 3.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setNormalRefBuffer(J3DBuffer normals) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setNormalRefBuffer(normals);
+ }
+
+
+ /**
+ * Gets the normal array buffer reference.
+ * @return the current normal array buffer reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.3
+ */
+ public J3DBuffer getNormalRefBuffer() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getNormalRefBuffer();
+ }
+
+
+ /**
+ * Sets the float normal array reference to the specified
+ * array. The array contains floating-point nx, ny,
+ * and nz values for each vertex (for a total of 3*n
+ * values, where n is the number of vertices). Only one of
+ * normalRefFloat or normalRef3f may be
+ * non-null (or they may all be null). An attempt to set more
+ * than one of these attributes to a non-null reference will
+ * result in an exception being thrown. If all normal array
+ * references are null and normals are enabled (that is, the
+ * vertexFormat includes
+ * NORMAL), the entire geometry array object is
+ * treated as if it were null--any Shape3D or Morph node that uses
+ * this geometry array will not be drawn.
+ *
+ * @param normals an array of 3*n values to which a
+ * reference will be set.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any other normal reference is also non-null.
+ * @exception ArrayIndexOutOfBoundsException if
+ * NORMALS bit is not set in the
+ * vertexFormat, or if
+ * normals.length < 3 * (initialNormalIndex + validVertexCount).
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the normal index array is greater than or equal to the
+ * number of vertices defined by the normals array,
+ * normals.length / 3.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setNormalRefFloat(float[] normals) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setNormalRefFloat(normals);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * Gets the float normal array reference.
+ * @return the current float normal array reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @since Java 3D 1.2
+ */
+ public float[] getNormalRefFloat() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getNormalRefFloat();
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Vector3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setNormalRef3f(Vector3f[] normals) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setNormalRef3f(normals);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for Vector3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public Vector3f[] getNormalRef3f() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getNormalRef3f();
+ }
+
+
+ /**
+ * Sets the texture coordinate buffer reference for the specified
+ * texture coordinate set to the
+ * specified buffer object. The buffer contains a java.nio.FloatBuffer
+ * object containing s,
+ * t, and, optionally, r and q values for each
+ * vertex (for
+ * a total of 2*n , 3*n or 4*n values,
+ * where n is
+ * the number of vertices).
+ * If the texCoord buffer reference is null and texture
+ * coordinates are enabled (that is, the vertexFormat includes
+ * TEXTURE_COORDINATE_2,
+ * TEXTURE_COORDINATE_3, or
+ * TEXTURE_COORDINATE_4), the entire geometry
+ * array object is treated as if it were null--any Shape3D or
+ * Morph node that uses this geometry array will not be drawn.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param texCoords a J3DBuffer object to which a reference will be set.
+ * The buffer contains an NIO buffer of 2*n, 3*n or
+ * 4*n float values.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception IllegalArgumentException if the java.nio.Buffer
+ * contained in the specified J3DBuffer is not a
+ * java.nio.FloatBuffer object.
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat, or if texCoordSet is out of range,
+ * or if
+ * texCoords.getBuffer().limit() < num_words
+ * * (initialTexCoordIndex + validVertexCount),
+ * where num_words is 2, 3, or 4 depending on the vertex
+ * texture coordinate format.
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the texture coordinate index array is greater than or equal to the
+ * number of vertices defined by the texCoords object,
+ * texCoords.getBuffer().limit() / num_words.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setTexCoordRefBuffer(int texCoordSet, J3DBuffer texCoords) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setTexCoordRefBuffer(
+ texCoordSet, texCoords);
+
+ }
+
+
+ /**
+ * Gets the texture coordinate array buffer reference for the specified
+ * texture coordinate set.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ *
+ * @return the current texture coordinate array buffer reference
+ * for the specified texture coordinate set
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or texCoordSet is out of range.
+ *
+ * @since Java 3D 1.3
+ */
+ public J3DBuffer getTexCoordRefBuffer(int texCoordSet) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getTexCoordRefBuffer(texCoordSet);
+ }
+
+
+ /**
+ * Sets the float texture coordinate array reference for the specified
+ * texture coordinate set to the
+ * specified array. The array contains floating-point s,
+ * t, and, optionally, r and q values for each
+ * vertex (for
+ * a total of 2*n , 3*n or 4*n values,
+ * where n is
+ * the number of vertices). Only one of
+ * texCoordRefFloat, texCoordRef2f, or
+ * texCoordRef3f may be non-null (or they may all be
+ * null). An attempt to set more than one of these attributes to
+ * a non-null reference will result in an exception being thrown.
+ * If all texCoord array references are null and texture
+ * coordinates are enabled (that is, the vertexFormat includes
+ * TEXTURE_COORDINATE_2,
+ * TEXTURE_COORDINATE_3, or
+ * TEXTURE_COORDINATE_4), the entire geometry
+ * array object is treated as if it were null--any Shape3D or
+ * Morph node that uses this geometry array will not be drawn.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param texCoords an array of 2*n, 3*n or
+ * 4*n values to
+ * which a reference will be set.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any other texCoord reference is also non-null.
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat, or if texCoordSet is out of range,
+ * or if
+ * texCoords.length < num_words *
+ * (initialTexCoordIndex + validVertexCount),
+ * where num_words is 2, 3, or 4 depending on the vertex
+ * texture coordinate format.
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the texture coordinate index array is greater than or equal to the
+ * number of vertices defined by the texCoords array,
+ * texCoords.length / num_words.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTexCoordRefFloat(int texCoordSet, float[] texCoords) {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ ((GeometryArrayRetained)this.retained).setTexCoordRefFloat(
+ texCoordSet, texCoords);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * Gets the float texture coordinate array reference for the specified
+ * texture coordinate set.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ *
+ * @return the current float texture coordinate array reference
+ * for the specified texture coordinate set
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception ArrayIndexOutOfBoundsException if none of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or texCoordSet is out of range.
+ *
+ * @since Java 3D 1.2
+ */
+ public float[] getTexCoordRefFloat(int texCoordSet) {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getTexCoordRefFloat(
+ texCoordSet);
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for TexCoord2f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTexCoordRef2f(int texCoordSet, TexCoord2f[] texCoords) {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ if ((format & (TEXTURE_COORDINATE_3 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray94"));
+
+ ((GeometryArrayRetained)this.retained).setTexCoordRef2f(
+ texCoordSet, texCoords);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for TexCoord2f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public TexCoord2f[] getTexCoordRef2f(int texCoordSet) {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getTexCoordRef2f(
+ texCoordSet);
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for TexCoord3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTexCoordRef3f(int texCoordSet, TexCoord3f[] texCoords) {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ if ((format & (TEXTURE_COORDINATE_2 | TEXTURE_COORDINATE_4)) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray95"));
+
+ ((GeometryArrayRetained)this.retained).setTexCoordRef3f(
+ texCoordSet, texCoords);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * @deprecated As of Java 3D version 1.3, use geometry by-copy
+ * for TexCoord3f arrays
+ *
+ * @since Java 3D 1.2
+ */
+ public TexCoord3f[] getTexCoordRef3f(int texCoordSet) {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ if ((format & INTERLEAVED) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+
+ return ((GeometryArrayRetained)this.retained).getTexCoordRef3f(
+ texCoordSet);
+ }
+
+
+ /**
+ * Sets the vertex attribute buffer reference for the specified
+ * vertex attribute number to the specified buffer object. The
+ * buffer contains a java.nio.FloatBuffer object containing 1, 2,
+ * 3, or 4 values for each vertex (for a total of 1*n,
+ * 2*n, 3*n, or 4*n values, where n is
+ * the number of vertices).
+ * If the vertexAttr buffer reference is null and vertex
+ * attributes are enabled (that is, the vertexFormat includes
+ * VERTEX_ATTRIBUTES), the entire geometry array
+ * object is treated as if it were null--any Shape3D node that
+ * uses this geometry array will not be drawn.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ *
+ * @param vertexAttrs a J3DBuffer object to which a reference will
+ * be set. The buffer contains an NIO buffer of 1*n,
+ * 2*n, 3*n, or 4*n float values.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception IllegalArgumentException if the java.nio.Buffer
+ * contained in the specified J3DBuffer is not a
+ * java.nio.FloatBuffer object.
+ *
+ * @exception ArrayIndexOutOfBoundsException if vertexAttrNum is out of
+ * range, or if
+ * vertexAttrs.getBuffer().limit() < num_words
+ * * (initialVertexAttrIndex + validVertexCount),
+ * where num_words is the size of the specified
+ * vertexAttrNum (1, 2, 3, or 4).
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the vertex attribute index array is greater than or equal to the
+ * number of vertices defined by the vertexAttrs object,
+ * vertexAttrs.getBuffer().limit() / num_words.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrRefBuffer(int vertexAttrNum, J3DBuffer vertexAttrs) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+ }
+
+ if ((format & INTERLEAVED) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrRefBuffer(
+ vertexAttrNum, vertexAttrs);
+ }
+
+
+ /**
+ * Gets the vertex attribute array buffer reference for the specified
+ * vertex attribute number.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ *
+ * @return the current vertex attribute array buffer reference
+ * for the specified vertex attribute number
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is not USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception ArrayIndexOutOfBoundsException if vertexAttrNum is out
+ * of range.
+ *
+ * @since Java 3D 1.4
+ */
+ public J3DBuffer getVertexAttrRefBuffer(int vertexAttrNum) {
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+
+ if ((format & USE_NIO_BUFFER) == 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+ }
+
+ if ((format & INTERLEAVED) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+ }
+
+ return ((GeometryArrayRetained)this.retained).getVertexAttrRefBuffer(vertexAttrNum);
+ }
+
+
+ /*
+ * XXXX: add the following to the javadoc if we ever add double-precision
+ * methods for vertex attribtues.
+ *
+ *-----------------------------------------------------------------
+ * Only one of vertexAttrRefFloat, or
+ * vertexAttrRefDouble may be non-null (or they may
+ * all be null). An attempt to set more than one of these
+ * attributes to a non-null reference will result in an exception
+ * being thrown.
+ *
+ * If all vertexAttr array references are null and vertex
+ * ...
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any other vertexAttr reference is also non-null.
+ * ...
+ *-----------------------------------------------------------------
+ */
+
+ /**
+ * Sets the float vertex attribute array reference for the
+ * specified vertex attribute number to the specified array. The
+ * array contains 1, 2, 3, or 4 floating-point values for each
+ * vertex (for a total of 1*n, 2*n, 3*n, or
+ * 4*n values, where n is the number of vertices).
+ *
+ * If the vertexAttr array reference is null and vertex
+ * attributes are enabled (that is, the vertexFormat includes
+ * VERTEX_ATTRIBUTES), the entire geometry array
+ * object is treated as if it were null--any Shape3D node that
+ * uses this geometry array will not be drawn.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ *
+ * @param vertexAttrs an array of 1*n, 2*n,
+ * 3*n, or 4*n values to which a reference will be
+ * set.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception ArrayIndexOutOfBoundsException if vertexAttrNum is
+ * out of range, or if
+ * vertexAttrs.length < num_words *
+ * (initialVertexAttrIndex + validVertexCount),
+ * where num_words is the size of the specified
+ * vertexAttrNum (1, 2, 3, or 4).
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the vertex attribute index array is greater than or equal to the
+ * number of vertices defined by the vertexAttrs array,
+ * vertexAttrs.length / num_words.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrRefFloat(int vertexAttrNum, float[] vertexAttrs) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+ }
+
+ if ((format & USE_NIO_BUFFER) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+ }
+
+ if ((format & INTERLEAVED) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+ }
+
+ ((GeometryArrayRetained)this.retained).setVertexAttrRefFloat(
+ vertexAttrNum, vertexAttrs);
+
+ // NOTE: the checks for multiple non-null references, and the
+ // array length check need to be done in the retained method
+ }
+
+
+ /**
+ * Gets the float vertex attribute array reference for the specified
+ * vertex attribute number.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ *
+ * @return the current float vertex attribute array reference
+ * for the specified vertex attribute number
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE,
+ * is USE_NIO_BUFFER, or is INTERLEAVED.
+ *
+ * @exception ArrayIndexOutOfBoundsException if vertexAttrNum is
+ * out of range.
+ *
+ * @since Java 3D 1.4
+ */
+ public float[] getVertexAttrRefFloat(int vertexAttrNum) {
+
+ if (isLiveOrCompiled()) {
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE) == 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray83"));
+ }
+
+ if ((format & USE_NIO_BUFFER) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+ }
+
+ if ((format & INTERLEAVED) != 0) {
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray84"));
+ }
+
+ return ((GeometryArrayRetained)this.retained).getVertexAttrRefFloat(
+ vertexAttrNum);
+ }
+
+
+ /**
+ * Sets the interleaved vertex array reference to the specified
+ * array. The vertex components must be stored in a predetermined
+ * order in the array. The order is: texture coordinates, colors,
+ * normals, and positional coordinates.
+ * Vertex attributes are not supported in interleaved mode.
+ * In the case of texture
+ * coordinates, the values for each texture coordinate set
+ * are stored in order from 0 through texCoordSetCount-1. Only those
+ * components that are enabled appear in the vertex. The number
+ * of words per vertex depends on which vertex components are
+ * enabled. Texture coordinates, if enabled, use 2 words per
+ * texture coordinate set per vertex for
+ * TEXTURE_COORDINATE_2, 3 words per texture
+ * coordinate set per vertex for
+ * TEXTURE_COORDINATE_3 or 4 words per texture
+ * coordinate set per vertex for
+ * TEXTURE_COORDINATE_4. Colors, if enabled, use 3
+ * words per vertex for COLOR_3 or 4 words per vertex
+ * for COLOR_4. Normals, if enabled, use 3 words per
+ * vertex. Positional coordinates, which are always enabled, use
+ * 3 words per vertex. For example, the format of interleaved
+ * data for a GeometryArray object whose vertexFormat includes
+ * COORDINATES, COLOR_3, and
+ * NORMALS would be: red, green,
+ * blue, Nx, Ny, Nz, x,
+ * y, z. All components of a vertex are stored in
+ * adjacent memory locations. The first component of vertex 0 is
+ * stored beginning at index 0 in the array. The first component
+ * of vertex 1 is stored beginning at index
+ * words_per_vertex in the array. The total number of
+ * words needed to store n vertices is
+ * words_per_vertex*n.
+ *
+ * @param vertexData an array of vertex values to which a
+ * reference will be set.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not INTERLEAVED
+ * or is USE_NIO_BUFFER.
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * vertexData.length < words_per_vertex *
+ * (initialVertexIndex + validVertexCount),
+ * where words_per_vertex depends on which formats are enabled.
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the index array associated with any of the enabled vertex
+ * components (coord, color, normal, texcoord) is greater than or
+ * equal to the number of vertices defined by the vertexData
+ * array,
+ * vertexData.length / words_per_vertex.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setInterleavedVertices(float[] vertexData) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & INTERLEAVED) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray85"));
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ ((GeometryArrayRetained)this.retained).setInterleavedVertices(vertexData);
+
+ // NOTE: the array length check needs to be done in the retained method
+ }
+
+
+ /**
+ * Gets the interleaved vertices array reference.
+ * @return the current interleaved vertices array reference.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not INTERLEAVED
+ * or is USE_NIO_BUFFER.
+ *
+ * @since Java 3D 1.2
+ */
+ public float[] getInterleavedVertices() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & INTERLEAVED) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray85"));
+
+
+ if ((format & USE_NIO_BUFFER) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray119"));
+
+ return ((GeometryArrayRetained)this.retained).getInterleavedVertices();
+ }
+
+ /**
+ * Sets the interleaved vertex buffer reference to the specified
+ * buffer object. The buffer must contain a java.nio.FloatBuffer object.
+ * The vertex components must be stored in a predetermined
+ * order in the buffer. The order is: texture coordinates, colors,
+ * normals, and positional coordinates.
+ * Vertex attributes are not supported in interleaved mode.
+ * In the case of texture
+ * coordinates, the values for each texture coordinate set
+ * are stored in order from 0 through texCoordSetCount-1. Only those
+ * components that are enabled appear in the vertex. The number
+ * of words per vertex depends on which vertex components are
+ * enabled. Texture coordinates, if enabled, use 2 words per
+ * texture coordinate set per vertex for
+ * TEXTURE_COORDINATE_2, 3 words per texture
+ * coordinate set per vertex for
+ * TEXTURE_COORDINATE_3 or 4 words per texture
+ * coordinate set per vertex for
+ * TEXTURE_COORDINATE_4. Colors, if enabled, use 3
+ * words per vertex for COLOR_3 or 4 words per vertex
+ * for COLOR_4. Normals, if enabled, use 3 words per
+ * vertex. Positional coordinates, which are always enabled, use
+ * 3 words per vertex. For example, the format of interleaved
+ * data for a GeometryArray object whose vertexFormat includes
+ * COORDINATES, COLOR_3, and
+ * NORMALS would be: red, green,
+ * blue, Nx, Ny, Nz, x,
+ * y, z. All components of a vertex are stored in
+ * adjacent memory locations. The first component of vertex 0 is
+ * stored beginning at index 0 in the buffer. The first component
+ * of vertex 1 is stored beginning at index
+ * words_per_vertex in the buffer. The total number of
+ * words needed to store n vertices is
+ * words_per_vertex*n.
+ *
+ * @param vertexData a J3DBuffer object to which a reference will be set.
+ * The buffer contains an NIO float buffer of
+ * words_per_vertex*n values.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not INTERLEAVED
+ * or is not USE_NIO_BUFFER.
+ *
+ * @exception IllegalArgumentException if the java.nio.Buffer
+ * contained in the specified J3DBuffer is not a
+ * java.nio.FloatBuffer object.
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * vertexData.getBuffer().limit() < words_per_vertex *
+ * (initialVertexIndex + validVertexCount),
+ * where words_per_vertex depends on which formats are enabled.
+ *
+ * @exception ArrayIndexOutOfBoundsException if this GeometryArray
+ * object is a subclass of IndexedGeometryArray, and any element
+ * in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the index array associated with any of the enabled vertex
+ * components (coord, color, normal, texcoord) is greater than or
+ * equal to the number of vertices defined by the vertexData
+ * object,
+ * vertexData.getBuffer().limit() / words_per_vertex.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setInterleavedVertexBuffer(J3DBuffer vertexData) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & INTERLEAVED) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray85"));
+
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ ((GeometryArrayRetained)this.retained).setInterleavedVertexBuffer(vertexData);
+
+ }
+
+
+ /**
+ * Gets the interleaved vertex array buffer reference.
+ * @return the current interleaved vertex array buffer reference.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not INTERLEAVED
+ * or is not USE_NIO_BUFFER.
+ *
+ * @since Java 3D 1.3
+ */
+ public J3DBuffer getInterleavedVertexBuffer() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ) &&
+ !this.getCapability(J3D_1_2_ALLOW_REF_DATA_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+ }
+
+ int format = ((GeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & INTERLEAVED) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray85"));
+
+ if ((format & USE_NIO_BUFFER) == 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray118"));
+
+ return ((GeometryArrayRetained)this.retained).getInterleavedVertexBuffer();
+
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GeometryArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/GeometryArrayRetained.java
new file mode 100644
index 0000000..20f99de
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GeometryArrayRetained.java
@@ -0,0 +1,11299 @@
+/*
+ * $RCSfile: GeometryArrayRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.12 $
+ * $Date: 2008/02/28 20:17:22 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import com.sun.j3d.internal.Distance;
+import javax.vecmath.*;
+import java.lang.Math;
+import java.util.ArrayList;
+import java.util.Set;
+import java.util.HashSet;
+import java.util.HashMap;
+import java.util.Vector;
+import java.util.Enumeration;
+import com.sun.j3d.internal.ByteBufferWrapper;
+import com.sun.j3d.internal.BufferWrapper;
+import com.sun.j3d.internal.FloatBufferWrapper;
+import com.sun.j3d.internal.DoubleBufferWrapper;
+
+
+/**
+ * The GeometryArray object contains arrays of positional coordinates,
+ * colors, normals and/or texture coordinates that describe
+ * point, line, or surface geometry. It is extended to create
+ * the various primitive types (e.g., lines, triangle_strips, etc.)
+ */
+
+abstract class GeometryArrayRetained extends GeometryRetained{
+
+ // XXXX: Memory footprint reduction. Should have separate object to
+ // to contain specific data such as a ByRef object for
+ // all ByRef related data. So that incases where no
+ // ByRef is needed, the ByRef object reference is
+ // set to null. Hence saving memory!
+ // Need object such as Texture, D3d and ByRef ...
+ //
+
+
+ // Contains a bitset indicating which components are present
+ int vertexFormat;
+
+ // Whether this geometry was ever rendered as transparent
+ int c4fAllocated = 0;
+
+ // Total Number of vertices
+ int vertexCount;
+
+ // number of vertices used in rendering
+ int validVertexCount;
+
+ // The vertex data in packed format
+ float vertexData[];
+
+ // vertex data in packed format for each screen in multi-screen situation
+ // if alpha values of each vertex are to be updated
+ private float mvertexData[][];
+
+ //
+ // The following offset/stride values are internally computed
+ // from the format
+ //
+
+ // Stride (in words) from one vertex to the next
+ int stride;
+
+ // Stride (in words) from one texture coordinate to the next
+ int texCoordStride;
+
+ // Offset (in words) within each vertex of the coordinate position
+ int coordinateOffset;
+
+ // Offset (in words) within each vertex of the normal
+ int normalOffset;
+
+ // Offset (in words) within each vertex of the color
+ int colorOffset;
+
+ // Offset (in words) within each vertex of the texture coordinate
+ int textureOffset;
+
+ // Offset (in words) within each vertex of each vertex attribute
+ int[] vertexAttrOffsets;
+
+ // Stride (size) of all vertex attributes
+ int vertexAttrStride;
+
+ // alpha value for transparency and texture blending
+ private float[] lastAlpha = new float[1];
+ float lastScreenAlpha = -1;
+
+ int colorChanged = 0;
+
+ // byte to float scale factor
+ static final float ByteToFloatScale = 1.0f/255.0f;
+
+ // float to byte scale factor
+ static final float FloatToByteScale = 255.0f;
+
+ // Set flag indicating that we are in the updater. This flag
+ // can be used by the various setRef methods to inhibit any
+ // update messages
+ boolean inUpdater = false;
+
+ // Array List used for messages
+ ArrayList gaList = new ArrayList(1);
+
+
+ // Target threads to be notified when morph changes
+ static final int targetThreads = (J3dThread.UPDATE_RENDER |
+ J3dThread.UPDATE_GEOMETRY);
+
+ // used for byReference geometry
+ float[] floatRefCoords = null;
+ double[] doubleRefCoords = null;
+ Point3d[] p3dRefCoords = null;
+ Point3f[] p3fRefCoords = null;
+
+ // Used for NIO buffer geometry
+ J3DBuffer coordRefBuffer = null;
+ FloatBufferWrapper floatBufferRefCoords = null;
+ DoubleBufferWrapper doubleBufferRefCoords = null;
+
+ // Initial index to use for rendering
+ int initialCoordIndex = 0;
+ int initialColorIndex = 0;
+ int initialNormalIndex = 0;
+ int[] initialTexCoordIndex = null;
+ int[] initialVertexAttrIndex = null;
+ int initialVertexIndex = 0;
+
+
+ // used for byReference colors
+ float[] floatRefColors = null;
+ byte[] byteRefColors = null;
+ Color3f[] c3fRefColors = null;
+ Color4f[] c4fRefColors = null;
+ Color3b[] c3bRefColors = null;
+ Color4b[] c4bRefColors = null;
+
+ // Used for NIO buffer colors
+ J3DBuffer colorRefBuffer = null;
+ FloatBufferWrapper floatBufferRefColors = null;
+ ByteBufferWrapper byteBufferRefColors = null;
+
+ // flag to indicate if the "by reference" component is already set
+ int vertexType = 0;
+ static final int PF = 0x1;
+ static final int PD = 0x2;
+ static final int P3F = 0x4;
+ static final int P3D = 0x8;
+ static final int VERTEX_DEFINED = PF | PD | P3F | P3D;
+
+ static final int CF = 0x10;
+ static final int CUB = 0x20;
+ static final int C3F = 0x40;
+ static final int C4F = 0x80;
+ static final int C3UB = 0x100;
+ static final int C4UB = 0x200;
+ static final int COLOR_DEFINED = CF | CUB | C3F | C4F| C3UB | C4UB;
+
+ static final int NF = 0x400;
+ static final int N3F = 0x800;
+ static final int NORMAL_DEFINED = NF | N3F;
+
+ static final int TF = 0x1000;
+ static final int T2F = 0x2000;
+ static final int T3F = 0x4000;
+ static final int TEXCOORD_DEFINED = TF | T2F | T3F;
+
+ static final int AF = 0x8000;
+ static final int VATTR_DEFINED = AF;
+
+ // Flag word indicating the type of by-ref texCoord. We will copy this to
+ // the vertexType field only when the references for all texture coordinate
+ // sets are set to non-null values.
+ private int texCoordType = 0;
+
+ // Flag word indicating the type of by-ref vertex attr. We will copy this to
+ // the vertexType field only when the references for all vertex attrs
+ // are set to non-null values.
+ private int vertexAttrType = 0;
+
+ // flag for execute geometry array when by reference
+ static final int COORD_FLOAT = 0x01;
+ static final int COORD_DOUBLE = 0x02;
+ static final int COLOR_FLOAT = 0x04;
+ static final int COLOR_BYTE = 0x08;
+ static final int NORMAL_FLOAT = 0x10;
+ static final int TEXCOORD_FLOAT = 0x20;
+ static final int VATTR_FLOAT = 0x40;
+
+
+ // used by "by reference" normals
+ float[] floatRefNormals = null;
+ Vector3f[] v3fRefNormals = null;
+
+ // Used for NIO buffer normals
+ J3DBuffer normalRefBuffer = null;
+ FloatBufferWrapper floatBufferRefNormals = null;
+
+ // used for "by reference" vertex attrs
+ float[][] floatRefVertexAttrs = null;
+
+ // Used for NIO buffer vertex attrs
+ J3DBuffer[] vertexAttrsRefBuffer = null;
+ FloatBufferWrapper[] floatBufferRefVertexAttrs = null;
+ Object[] nioFloatBufferRefVertexAttrs = null;
+
+ // used by "by reference" tex coords
+ Object[] refTexCoords = null;
+ TexCoord2f[] t2fRefTexCoords = null;
+ TexCoord3f[] t3fRefTexCoords = null;
+
+ // Used for NIO buffer tex coords
+ Object[] refTexCoordsBuffer = null;
+ //FloatBufferWrapper[] floatBufferRefTexCoords = null;
+
+
+ // used by interleaved array
+ float[] interLeavedVertexData = null;
+
+ // used by interleaved NIO buffer
+ J3DBuffer interleavedVertexBuffer = null;
+ FloatBufferWrapper interleavedFloatBufferImpl = null;
+
+ // pointers used, when transparency is turned on
+ // or when its an object such as C3F, P3F etc ..
+ float[] mirrorFloatRefCoords = null;
+ double[] mirrorDoubleRefCoords = null;
+ float[] mirrorFloatRefNormals = null;
+ float[][] mirrorFloatRefVertexAttrs = null;
+ float[] mirrorFloatRefTexCoords = null;
+ Object[] mirrorRefTexCoords = null;
+
+ float[][] mirrorFloatRefColors = new float[1][];
+ byte[][] mirrorUnsignedByteRefColors= new byte[1][];
+ float[][] mirrorInterleavedColorPointer = null;
+
+ // boolean to determine if a mirror was allocated
+ int mirrorVertexAllocated = 0;
+ int mirrorColorAllocated = 0;
+ boolean mirrorNormalAllocated = false;
+
+ // Some dirty bits for GeometryArrays
+ static final int COORDINATE_CHANGED = 0x01;
+ static final int NORMAL_CHANGED = 0x02;
+ static final int COLOR_CHANGED = 0x04;
+ static final int TEXTURE_CHANGED = 0x08;
+ static final int BOUNDS_CHANGED = 0x10;
+ static final int INDEX_CHANGED = 0x20;
+ static final int STRIPCOUNT_CHANGED = 0x40;
+ static final int VATTR_CHANGED = 0x80;
+ static final int VERTEX_CHANGED = COORDINATE_CHANGED |
+ NORMAL_CHANGED |
+ COLOR_CHANGED |
+ TEXTURE_CHANGED |
+ VATTR_CHANGED;
+
+ static final int defaultTexCoordSetMap[] = {0};
+ int texCoordSetCount = 0;
+ int [] texCoordSetMap = null;
+
+ // this array contains offset to the texCoord data for each
+ // texture unit. -1 means no corresponding texCoord data offset
+ int [] texCoordSetMapOffset = null;
+
+ // Vertex attribute information
+ int vertexAttrCount = 0;
+ int[] vertexAttrSizes = null;
+
+
+ // This point to a list of VertexBuffers in a Vector structure
+ // Each element correspond to a D3D context that create this VB.
+ // Note that this GeometryArray can be used by multiple ctx.
+ long pVertexBuffers = 0;
+ int dirtyFlag;
+
+ // each bit corresponds to a unique renderer if shared context
+ // or a unique canvas otherwise
+ int resourceCreationMask = 0x0;
+
+ // Fix for Issue 5
+ //
+ // Replace the per-canvas reference count with a per-RenderBin set
+ // of users. The per-RenderBin set of users of this display list
+ // is defined as a HashMap where:
+ //
+ // key = the RenderBin
+ // value = a set of RenderAtomListInfo objects using this
+ // geometry array for display list purposes
+ private HashMap dlistUsers = null;
+
+ // timestamp used to create display list. This is either
+ // one per renderer for useSharedCtx, or one per Canvas for non-shared
+ // ctx
+ private long[] timeStampPerDlist = new long[2];
+
+ // Unique display list Id, if this geometry is shared
+ int dlistId = -1;
+ Integer dlistObj = null;
+
+ // A list of pre-defined bits to indicate which component
+ // in this Texture object changed.
+ // static final int DLIST_CREATE_CHANGED = 0x01;
+ static final int INIT_MIRROR_GEOMETRY = 0x02;
+
+
+ // A list of Universes that this Geometry is referenced in Morph from
+ ArrayList morphUniverseList = null;
+
+ // A list of ArrayLists which contain all the MorphRetained objects
+ // refering to this geometry. Each list corresponds to the universe
+ // above.
+ ArrayList morphUserLists = null;
+
+ // The following variables are only used in compile mode
+
+ // Offset of a geometry array into the merged array
+ int[] geoOffset;
+
+ // vertexcount of a geometry array in a merge array
+ int[] compileVcount;
+
+ boolean isCompiled = false;
+
+ boolean isShared = false;
+
+ IndexedGeometryArrayRetained cloneSourceArray = null;
+
+ static final double EPS = 1.0e-13;
+
+ void freeD3DArray(boolean deleteVB) {
+ assert VirtualUniverse.mc.isD3D();
+ Pipeline.getPipeline().freeD3DArray(this, deleteVB);
+ }
+
+ GeometryArrayRetained() {
+ dirtyFlag = INDEX_CHANGED|VERTEX_CHANGED;
+ lastAlpha[0] = 1.0f;
+ }
+
+
+ void setLive(boolean inBackgroundGroup, int refCount) {
+ dirtyFlag = VERTEX_CHANGED|INDEX_CHANGED;
+ isEditable = !isWriteStatic();
+ super.doSetLive(inBackgroundGroup, refCount);
+ super.markAsLive();
+ // Send message to RenderingAttribute structure to obtain a dlistId
+ // System.err.println("Geometry - "+this+"refCount = "+this.refCount);
+ if (this.refCount > 1) {
+ // Send to rendering attribute structure,
+ /*
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+ createMessage.type = J3dMessage.GEOMETRYARRAY_CHANGED;
+ createMessage.universe = null;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(DLIST_CREATE_CHANGED);
+ VirtualUniverse.mc.processMessage(createMessage);
+ */
+ isShared = true;
+ } // Clone geometry only for the first setLive
+ else {
+ // If geometry is indexed and use_index_coord is false, unindexify
+ // otherwise, set mirrorGeometry to null (from previous clearLive)
+ if (this instanceof IndexedGeometryArrayRetained) {
+ // Send to rendering attribute structure,
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+ createMessage.type = J3dMessage.GEOMETRY_CHANGED;
+ createMessage.universe = null;
+ createMessage.args[0] = null;
+ createMessage.args[1]= this;
+ createMessage.args[2]= new Integer(INIT_MIRROR_GEOMETRY);
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+ }
+
+ }
+
+ void clearLive(int refCount) {
+ super.clearLive(refCount);
+
+ if (this.refCount <= 0) {
+ if (pVertexBuffers != 0) {
+ J3dMessage renderMessage = new J3dMessage();
+ renderMessage.threads = J3dThread.RENDER_THREAD;
+ renderMessage.type = J3dMessage.RENDER_IMMEDIATE;
+ renderMessage.universe = null;
+ renderMessage.view = null;
+ renderMessage.args[0] = null;
+ renderMessage.args[1] = this;
+ // Any one renderer is fine since VB store the ctx
+ // where it is created.
+ Enumeration e = Screen3D.deviceRendererMap.elements();
+ Renderer rdr = (Renderer) e.nextElement();
+ rdr.rendererStructure.addMessage(renderMessage);
+ VirtualUniverse.mc.setWorkForRequestRenderer();
+ }
+ isShared = false;
+ }
+ }
+
+ void computeBoundingBox() {
+
+ // System.err.println("computeBoundingBox ....");
+
+ if (boundsDirty && VirtualUniverse.mc.cacheAutoComputedBounds) {
+ for(ArrayListvertexAttrCount elements.
+ */
+ void getVertexAttrSizes(int[] vertexAttrSizes) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ vertexAttrSizes[i] = this.vertexAttrSizes[i];
+ }
+ }
+
+
+
+ void sendDataChangedMessage(boolean coordinatesChanged) {
+ J3dMessage[] m;
+ int i, j, k, index, numShapeMessages, numMorphMessages;
+ ArrayList shapeList;
+ Shape3DRetained s;
+ ArrayList morphList;
+ MorphRetained morph;
+
+ synchronized(liveStateLock) {
+ if (source != null && source.isLive()) {
+ // System.err.println("In GeometryArrayRetained - ");
+
+ // Send a message to renderBin to rebuild the display list or
+ // process the vertex array accordingly
+ // XXXX: Should I send one per universe, isn't display list
+ // shared by all context/universes?
+ int threads = J3dThread.UPDATE_RENDER;
+ // If the geometry type is Indexed then we need to clone the geometry
+ // We also need to update the cachedChangedFrequent flag
+ threads |= J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+
+ synchronized (universeList) {
+ numShapeMessages = universeList.size();
+ m = new J3dMessage[numShapeMessages];
+
+ k = 0;
+
+ for (i = 0; i < numShapeMessages; i++, k++) {
+ gaList.clear();
+
+ shapeList = (ArrayList)userLists.get(i);
+ for (j=0; jlength vertices.
+ * @param index the vertex index
+ * @param coordinates an array of vectors containing new coordinates
+ * @param start starting vertex index of data in coordinates .
+ * @param length number of vertices to be copied.
+ */
+ void setCoordinates(int index, float coordinates[], int start, int length) {
+ int offset = this.stride * index + coordinateOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COORDINATE_CHANGED;
+ for (i= start * 3, j= offset; i < (start+length) * 3;
+ i+=3, j+= this.stride) {
+ this.vertexData[j] = coordinates[i];
+ this.vertexData[j+1]= coordinates[i+1];
+ this.vertexData[j+2]= coordinates[i+2];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (inUpdater ||source == null ) {
+ return;
+ }
+ if (!isLive) {
+ boundsDirty = true;
+ return;
+ }
+
+ // Compute geo's bounds
+ processCoordsChanged(false);
+
+ sendDataChangedMessage(true);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object using coordinate data starting
+ * from vertex index start for length vertices.
+ * @param index the vertex index
+ * @param coordinates an array of 3*n values containing n new coordinates
+ * @param start starting vertex index of data in coordinates .
+ * @param length number of vertices to be copied.
+ */
+ void setCoordinates(int index, double coordinates[], int start, int length) {
+ int offset = this.stride * index + coordinateOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COORDINATE_CHANGED;
+
+ for (i= start*3, j= offset; i < (start+length)*3;
+ i+=3, j+= this.stride) {
+ this.vertexData[j] = (float)coordinates[i];
+ this.vertexData[j+1]= (float)coordinates[i+1];
+ this.vertexData[j+2]= (float)coordinates[i+2];
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (inUpdater || (source == null)) {
+ return;
+ }
+ if (!isLive) {
+ boundsDirty = true;
+ return;
+ }
+
+
+ // Compute geo's bounds
+ processCoordsChanged(false);
+
+ sendDataChangedMessage(true);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object using coordinate data starting
+ * from vertex index start for length vertices.
+ * @param index the vertex index
+ * @param coordinates an array of vectors containing new coordinates
+ * @param start starting vertex index of data in coordinates .
+ * @param length number of vertices to be copied.
+ */
+ void setCoordinates(int index, Point3f coordinates[], int start,
+ int length) {
+ int offset = this.stride * index + coordinateOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COORDINATE_CHANGED;
+
+ for (i=start, j= offset;i < start + length; i++, j+= this.stride) {
+ this.vertexData[j] = coordinates[i].x;
+ this.vertexData[j+1]= coordinates[i].y;
+ this.vertexData[j+2]= coordinates[i].z;
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ }
+
+ if (inUpdater || (source == null)) {
+ return;
+ }
+ if (!isLive) {
+ boundsDirty = true;
+ return;
+ }
+
+
+ // Compute geo's bounds
+ processCoordsChanged(false);
+
+ sendDataChangedMessage(true);
+ }
+
+ /**
+ * Sets the coordinates associated with the vertices starting at
+ * the specified index for this object using coordinate data starting
+ * from vertex index start for length vertices.
+ * @param index the vertex index
+ * @param coordinates an array of vectors containing new coordinates
+ * @param start starting vertex index of data in coordinates .
+ * @param length number of vertices to be copied.
+ */
+ void setCoordinates(int index, Point3d coordinates[], int start,
+ int length) {
+ int offset = this.stride * index + coordinateOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COORDINATE_CHANGED;
+
+ for (i=start, j= offset;i < start + length; i++, j+= this.stride) {
+ this.vertexData[j] = (float)coordinates[i].x;
+ this.vertexData[j+1]= (float)coordinates[i].y;
+ this.vertexData[j+2]= (float)coordinates[i].z;
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (inUpdater || (source == null)) {
+ return;
+ }
+ if (!isLive) {
+ boundsDirty = true;
+ return;
+ }
+
+ // Compute geo's bounds
+ processCoordsChanged(false);
+
+ sendDataChangedMessage(true);
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color an array of 3 or 4 values containing the new color
+ */
+ void setColor(int index, float color[]) {
+ int offset = this.stride*index + colorOffset;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+ this.vertexData[offset] = color[0];
+ this.vertexData[offset+1] = color[1];
+ this.vertexData[offset+2] = color[2];
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ this.vertexData[offset+3] = color[3]*lastAlpha[0];
+ else
+ this.vertexData[offset+3] = lastAlpha[0];
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color an array of 3 or 4 values containing the new color
+ */
+ void setColor(int index, byte color[]) {
+ int offset = this.stride*index + colorOffset;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive) {
+ geomLock.getLock();
+ }
+
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+ this.vertexData[offset] = (color[0] & 0xff) * ByteToFloatScale;
+ this.vertexData[offset+1] = (color[1] & 0xff) * ByteToFloatScale;
+ this.vertexData[offset+2] = (color[2] & 0xff) * ByteToFloatScale;
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ this.vertexData[offset+3] = ((color[3] & 0xff)* ByteToFloatScale)*lastAlpha[0];
+ else
+ this.vertexData[offset+3] = lastAlpha[0];
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector containing the new color
+ */
+ void setColor(int index, Color3f color) {
+ int offset = this.stride*index + colorOffset;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+ this.vertexData[offset] = color.x;
+ this.vertexData[offset+1] = color.y;
+ this.vertexData[offset+2] = color.z;
+ this.vertexData[offset+3] = lastAlpha[0];
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector containing the new color
+ */
+ void setColor(int index, Color4f color) {
+ int offset = this.stride*index + colorOffset;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+ this.vertexData[offset] = color.x;
+ this.vertexData[offset+1] = color.y;
+ this.vertexData[offset+2] = color.z;
+ this.vertexData[offset+3] = color.w*lastAlpha[0];
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector containing the new color
+ */
+ void setColor(int index, Color3b color) {
+ int offset = this.stride*index + colorOffset;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+ this.vertexData[offset] = (color.x & 0xff) * ByteToFloatScale;
+ this.vertexData[offset+1] = (color.y & 0xff) * ByteToFloatScale;
+ this.vertexData[offset+2] = (color.z & 0xff) * ByteToFloatScale;
+ this.vertexData[offset+3] = lastAlpha[0];
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector containing the new color
+ */
+ void setColor(int index, Color4b color) {
+ int offset = this.stride*index + colorOffset;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+ this.vertexData[offset] = (color.x * 0xff) * ByteToFloatScale;
+ this.vertexData[offset+1] = (color.y * 0xff) * ByteToFloatScale;
+ this.vertexData[offset+2] = (color.z * 0xff) * ByteToFloatScale;
+ this.vertexData[offset+3] = ((color.w & 0xff) * ByteToFloatScale)*lastAlpha[0];
+
+ if(isLive){
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ */
+ void setColors(int index, float colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ {
+ for (i=0, j= offset;i < num; i+= 4, j+= this.stride)
+ {
+ this.vertexData[j] = colors[i];
+ this.vertexData[j+1] = colors[i+1];
+ this.vertexData[j+2] = colors[i+2];
+ this.vertexData[j+3] = colors[i+3]*lastAlpha[0];
+ }
+ }
+ else
+ {
+ for (i=0, j= offset;i < num; i+= 3, j+= this.stride)
+ {
+ this.vertexData[j] = colors[i];
+ this.vertexData[j+1] = colors[i+1];
+ this.vertexData[j+2] = colors[i+2];
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ */
+ void setColors(int index, byte colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ {
+ for (i=0, j= offset;i < num; i+= 4, j+= this.stride)
+ {
+ this.vertexData[j] = (colors[i] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i+1] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i+2] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = ((colors[i+3] & 0xff) * ByteToFloatScale)*lastAlpha[0];
+ }
+ }
+ else
+ {
+ for (i=0, j= offset;i < num; i+= 3, j+= this.stride)
+ {
+ this.vertexData[j] = (colors[i] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i+1] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i+2] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+ }
+
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors containing new colors
+ */
+ void setColors(int index, Color3f colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ this.vertexData[j] = colors[i].x;
+ this.vertexData[j+1] = colors[i].y;
+ this.vertexData[j+2] = colors[i].z;
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors containing new colors
+ */
+ void setColors(int index, Color4f colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ this.vertexData[j] = colors[i].x;
+ this.vertexData[j+1] = colors[i].y;
+ this.vertexData[j+2] = colors[i].z;
+ this.vertexData[j+3] = colors[i].w*lastAlpha[0];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors containing new colors
+ */
+ void setColors(int index, Color3b colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ this.vertexData[j] = (colors[i].x & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i].y & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i].z & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors containing new colors
+ */
+ void setColors(int index, Color4b colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ this.vertexData[j] = (colors[i].x & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i].y & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i].z & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = ((colors[i].w & 0xff) * ByteToFloatScale)*lastAlpha[0];
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ * @param start starting color index of data in colors.
+ * @param length number of colors to be copied.
+ */
+ void setColors(int index, float colors[], int start, int length) {
+ int offset = this.stride*index + colorOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0) {
+ for (i = start * 4, j = offset; i < (start + length) * 4;
+ i += 4, j += this.stride) {
+ this.vertexData[j] = colors[i];
+ this.vertexData[j+1] = colors[i+1];
+ this.vertexData[j+2] = colors[i+2];
+ this.vertexData[j+3] = colors[i+3]*lastAlpha[0];
+ }
+ } else {
+ for (i = start * 3, j = offset; i < (start + length) * 3;
+ i += 3, j += this.stride) {
+ this.vertexData[j] = colors[i];
+ this.vertexData[j+1] = colors[i+1];
+ this.vertexData[j+2] = colors[i+2];
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ * @param start starting color index of data in colors.
+ * @param length number of colors to be copied.
+ */
+ void setColors(int index, byte colors[], int start, int length) {
+ int offset = this.stride*index + colorOffset;
+ int i, j;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0) {
+ for (i = start * 4, j = offset; i < (start + length) * 4;
+ i += 4, j += this.stride) {
+ this.vertexData[j] = (colors[i] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i+1] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i+2] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = ((colors[i+3] & 0xff) * ByteToFloatScale)*lastAlpha[0];
+ }
+ } else {
+ for (i = start * 3, j = offset; i < (start + length) * 3;
+ i += 3, j += this.stride) {
+ this.vertexData[j] = (colors[i] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i+1] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i+2] & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ * @param start starting color index of data in colors.
+ * @param length number of colors to be copied.
+ */
+ void setColors(int index, Color3f colors[], int start, int length) {
+ int offset = this.stride*index + colorOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = colors[i].x;
+ this.vertexData[j+1] = colors[i].y;
+ this.vertexData[j+2] = colors[i].z;
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ * @param start starting color index of data in colors.
+ * @param length number of colors to be copied.
+ */
+ void setColors(int index, Color4f colors[], int start, int length) {
+ int offset = this.stride*index + colorOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = colors[i].x;
+ this.vertexData[j+1] = colors[i].y;
+ this.vertexData[j+2] = colors[i].z;
+ this.vertexData[j+3] = colors[i].w*lastAlpha[0];
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ * @param start starting color index of data in colors.
+ * @param length number of colors to be copied.
+ */
+ void setColors(int index, Color3b colors[], int start, int length) {
+ int offset = this.stride*index + colorOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = (colors[i].x & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i].y & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i].z & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = lastAlpha[0];
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the colors associated with the vertices starting at
+ * the specified index for this object using data in colors
+ * starting at index start for length colors.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values containing n new colors
+ * @param start starting color index of data in colors.
+ * @param length number of colors to be copied.
+ */
+ void setColors(int index, Color4b colors[], int start, int length) {
+ int offset = this.stride*index + colorOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= COLOR_CHANGED;
+ colorChanged = 0xffff;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = (colors[i].x & 0xff) * ByteToFloatScale;
+ this.vertexData[j+1] = (colors[i].y & 0xff) * ByteToFloatScale;
+ this.vertexData[j+2] = (colors[i].z & 0xff) * ByteToFloatScale;
+ this.vertexData[j+3] = ((colors[i].w & 0xff) * ByteToFloatScale)*lastAlpha[0];
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the normal associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param normal the new normal
+ */
+ void setNormal(int index, float normal[]) {
+ int offset = this.stride*index + normalOffset;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ this.vertexData[offset] = normal[0];
+ this.vertexData[offset+1] = normal[1];
+ this.vertexData[offset+2] = normal[2];
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the normal associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param normal the vector containing the new normal
+ */
+ void setNormal(int index, Vector3f normal) {
+ int offset = this.stride*index + normalOffset;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= NORMAL_CHANGED;
+ this.vertexData[offset] = normal.x;
+ this.vertexData[offset+1] = normal.y;
+ this.vertexData[offset+2] = normal.z;
+
+ if(isLive){
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param normals the new normals
+ */
+ void setNormals(int index, float normals[]) {
+ int offset = this.stride*index + normalOffset;
+ int i, j, num = normals.length;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= NORMAL_CHANGED;
+ for (i=0, j= offset;i < num;i += 3, j+= this.stride)
+ {
+ this.vertexData[j] = normals[i];
+ this.vertexData[j+1] = normals[i+1];
+ this.vertexData[j+2] = normals[i+2];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param normals the vector containing the new normals
+ */
+ void setNormals(int index, Vector3f normals[]) {
+ int offset = this.stride*index + normalOffset;
+ int i, j, num = normals.length;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= NORMAL_CHANGED;
+ for (i=0, j= offset;i < num;i++, j+= this.stride)
+ {
+ this.vertexData[j] = normals[i].x;
+ this.vertexData[j+1] = normals[i].y;
+ this.vertexData[j+2] = normals[i].z;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index for this object using data in normals
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param normals the new normals
+ * @param start starting normal index of data in colors .
+ * @param length number of normals to be copied.
+ */
+ void setNormals(int index, float normals[], int start, int length) {
+ int offset = this.stride*index + normalOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= NORMAL_CHANGED;
+ for (i = start * 3, j = offset; i < (start + length) * 3;
+ i+=3, j += this.stride) {
+ this.vertexData[j] = normals[i];
+ this.vertexData[j+1] = normals[i+1];
+ this.vertexData[j+2] = normals[i+2];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the normals associated with the vertices starting at
+ * the specified index for this object using data in normals
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param normals the new normals
+ * @param start starting normal index of data in colors .
+ * @param length number of normals to be copied.
+ */
+ void setNormals(int index, Vector3f normals[], int start, int length) {
+ int offset = this.stride*index + normalOffset;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= NORMAL_CHANGED;
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = normals[i].x;
+ this.vertexData[j+1] = normals[i].y;
+ this.vertexData[j+2] = normals[i].z;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index for this object using data in texCoords
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param texCoords the new texture coordinates
+ * @param start starting texture coordinate index of data in texCoords .
+ * @param length number of texture Coordinates to be copied.
+ */
+ void setTextureCoordinates(int texCoordSet, int index, float texCoords[],
+ int start, int length) {
+
+ if ((this.vertexFormat & GeometryArray.BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j, k;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= TEXTURE_CHANGED;
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE_4) != 0) {
+ for (i = start * 4, j = offset, k = 0; k < length;
+ j += this.stride, k++) {
+ this.vertexData[j] = texCoords[i++];
+ this.vertexData[j+1] = texCoords[i++];
+ this.vertexData[j+2] = texCoords[i++];
+ this.vertexData[j+3] = texCoords[i++];
+ }
+ } else if ((this.vertexFormat &
+ GeometryArray.TEXTURE_COORDINATE_3) != 0) {
+ for (i = start * 3, j = offset, k = 0; k < length;
+ j += this.stride, k++) {
+ this.vertexData[j] = texCoords[i++];
+ this.vertexData[j+1] = texCoords[i++];
+ this.vertexData[j+2] = texCoords[i++];
+ }
+ } else {
+ for (i = start * 2, j = offset, k = 0; k < length;
+ j += this.stride, k++) {
+ this.vertexData[j] = texCoords[i++];
+ this.vertexData[j+1] = texCoords[i++];
+ }
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index for this object using data in texCoords
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param texCoords the new texture coordinates
+ * @param start starting texture coordinate index of data in texCoords .
+ * @param length number of texture Coordinates to be copied.
+ */
+ void setTextureCoordinates(int texCoordSet, int index, Point2f texCoords[],
+ int start, int length) {
+
+ if ((this.vertexFormat & GeometryArray.BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= TEXTURE_CHANGED;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = texCoords[i].x;
+ this.vertexData[j+1] = texCoords[i].y;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index for this object using data in texCoords
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param texCoords the new texture coordinates
+ * @param start starting texture coordinate index of data in texCoords .
+ * @param length number of texture Coordinates to be copied.
+ */
+ void setTextureCoordinates(int texCoordSet, int index, Point3f texCoords[],
+ int start, int length) {
+
+ if ((this.vertexFormat & GeometryArray.BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= TEXTURE_CHANGED;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = texCoords[i].x;
+ this.vertexData[j+1] = texCoords[i].y;
+ this.vertexData[j+2] = texCoords[i].z;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index for this object using data in texCoords
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param texCoords the new texture coordinates
+ * @param start starting texture coordinate index of data in texCoords .
+ * @param length number of texture Coordinates to be copied.
+ */
+ void setTextureCoordinates(int texCoordSet, int index, TexCoord2f texCoords[],
+ int start, int length) {
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= TEXTURE_CHANGED;
+ if ((this.vertexFormat & GeometryArray.BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = texCoords[i].x;
+ this.vertexData[j+1] = texCoords[i].y;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index for this object using data in texCoords
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param texCoords the new texture coordinates
+ * @param start starting texture coordinate index of data in texCoords .
+ * @param length number of texture Coordinates to be copied.
+ */
+ void setTextureCoordinates(int texCoordSet, int index,
+ TexCoord3f texCoords[],
+ int start, int length) {
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= TEXTURE_CHANGED;
+
+ if ((this.vertexFormat & GeometryArray.BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = texCoords[i].x;
+ this.vertexData[j+1] = texCoords[i].y;
+ this.vertexData[j+2] = texCoords[i].z;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the texture coordinates associated with the vertices starting at
+ * the specified index for this object using data in texCoords
+ * starting at index start and ending at index start+length.
+ * @param index the vertex index
+ * @param texCoords the new texture coordinates
+ * @param start starting texture coordinate index of data in texCoords .
+ * @param length number of texture Coordinates to be copied.
+ */
+ void setTextureCoordinates(int texCoordSet, int index,
+ TexCoord4f texCoords[],
+ int start, int length) {
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= TEXTURE_CHANGED;
+
+ if ((this.vertexFormat & GeometryArray.BY_REFERENCE) != 0)
+ throw new IllegalStateException(J3dI18N.getString("GeometryArray82"));
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE ) == 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("GeometryArray79"));
+
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j;
+
+ for (i = start, j = offset; i < start+length; i++, j += this.stride) {
+ this.vertexData[j] = texCoords[i].x;
+ this.vertexData[j+1] = texCoords[i].y;
+ this.vertexData[j+2] = texCoords[i].z;
+ this.vertexData[j+3] = texCoords[i].w;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+
+ /**
+ * Sets the vertex attribute associated with the vertex at the
+ * specified index in the specified vertex attribute number for
+ * this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param vertexAttr the Point2f containing the new vertex attribute
+ */
+ void setVertexAttr(int vertexAttrNum, int index,
+ Point2f vertexAttr) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= VATTR_CHANGED;
+
+ this.vertexData[offset] = vertexAttr.x;
+ this.vertexData[offset+1] = vertexAttr.y;
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attribute associated with the vertex at the
+ * specified index in the specified vertex attribute number for
+ * this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param vertexAttr the Point3f containing the new vertex attribute
+ */
+ void setVertexAttr(int vertexAttrNum, int index,
+ Point3f vertexAttr) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= VATTR_CHANGED;
+
+ this.vertexData[offset] = vertexAttr.x;
+ this.vertexData[offset+1] = vertexAttr.y;
+ this.vertexData[offset+2] = vertexAttr.z;
+
+ if (isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attribute associated with the vertex at the
+ * specified index in the specified vertex attribute number for
+ * this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index destination vertex index in this geometry array
+ * @param vertexAttr the Point4f containing the new vertex attribute
+ */
+ void setVertexAttr(int vertexAttrNum, int index,
+ Point4f vertexAttr) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= VATTR_CHANGED;
+
+ this.vertexData[offset] = vertexAttr.x;
+ this.vertexData[offset+1] = vertexAttr.y;
+ this.vertexData[offset+2] = vertexAttr.z;
+ this.vertexData[offset+3] = vertexAttr.w;
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of 1*n, 2*n, 3*n, or 4*n values
+ * containing n new vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ */
+ void setVertexAttrs(int vertexAttrNum, int index,
+ float[] vertexAttrs,
+ int start, int length) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int size = vertexAttrSizes[vertexAttrNum];
+ int i, j, k;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= VATTR_CHANGED;
+
+ for (i = start * size, j = offset, k = 0; k < length; i += size, j += this.stride, k++) {
+ for (int ii = 0; ii < size; ii++) {
+ this.vertexData[j+ii] = vertexAttrs[i+ii];
+ }
+ }
+
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point2f objects containing new
+ * vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ */
+ void setVertexAttrs(int vertexAttrNum, int index,
+ Point2f[] vertexAttrs,
+ int start, int length) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int i, j, k;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= VATTR_CHANGED;
+
+ for (i = start, j = offset, k = 0; k < length; i++, j += this.stride, k++) {
+ this.vertexData[j] = vertexAttrs[i].x;
+ this.vertexData[j+1] = vertexAttrs[i].y;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point3f objects containing new
+ * vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ */
+ void setVertexAttrs(int vertexAttrNum, int index,
+ Point3f[] vertexAttrs,
+ int start, int length) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int i, j, k;
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= VATTR_CHANGED;
+
+ for (i = start, j = offset, k = 0; k < length; i++, j += this.stride, k++) {
+ this.vertexData[j] = vertexAttrs[i].x;
+ this.vertexData[j+1] = vertexAttrs[i].y;
+ this.vertexData[j+2] = vertexAttrs[i].z;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attributes associated with the vertices
+ * starting at the specified index in the specified vertex
+ * attribute number for this object using data in
+ * vertexAttrs starting at index start and
+ * ending at index start+length.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index starting destination vertex index in this geometry array
+ * @param vertexAttrs source array of Point4f objects containing new
+ * vertex attributes
+ * @param start starting source vertex index in vertexAttrs
+ * array.
+ * @param length number of vertex attributes to be copied.
+ */
+ void setVertexAttrs(int vertexAttrNum, int index,
+ Point4f[] vertexAttrs,
+ int start, int length) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int i, j, k;
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= VATTR_CHANGED;
+
+ for (i = start, j = offset, k = 0; k < length; i++, j += this.stride, k++) {
+ this.vertexData[j] = vertexAttrs[i].x;
+ this.vertexData[j+1] = vertexAttrs[i].y;
+ this.vertexData[j+2] = vertexAttrs[i].z;
+ this.vertexData[j+3] = vertexAttrs[i].w;
+ }
+ if(isLive) {
+ geomLock.unLock();
+ sendDataChangedMessage(false);
+ }
+ }
+
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinate an array of 3 values that will receive the new coordinate
+ */
+ void getCoordinate(int index, float coordinate[]) {
+ int offset = this.stride*index + coordinateOffset;
+
+ coordinate[0]= this.vertexData[offset];
+ coordinate[1]= this.vertexData[offset+1];
+ coordinate[2]= this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinate an array of 3 values that will receive the new coordinate
+ */
+ void getCoordinate(int index, double coordinate[]) {
+ int offset = this.stride*index + coordinateOffset;
+
+ coordinate[0]= (double)this.vertexData[offset];
+ coordinate[1]= (double)this.vertexData[offset+1];
+ coordinate[2]= (double)this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinate a vector that will receive the new coordinate
+ */
+ void getCoordinate(int index, Point3f coordinate) {
+ int offset = this.stride*index + coordinateOffset;
+
+ coordinate.x = this.vertexData[offset];
+ coordinate.y = this.vertexData[offset+1];
+ coordinate.z = this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the coordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinate a vector that will receive the new coordinate
+ */
+ void getCoordinate(int index, Point3d coordinate) {
+ int offset = this.stride*index + coordinateOffset;
+
+ coordinate.x = (double)this.vertexData[offset];
+ coordinate.y = (double)this.vertexData[offset+1];
+ coordinate.z = (double)this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinates an array of 3*n values that will receive new coordinates
+ */
+ void getCoordinates(int index, float coordinates[]) {
+ int offset = this.stride*index + coordinateOffset;
+ int i, j, num = coordinates.length;
+
+ for (i=0,j= offset;i < num;i +=3, j += this.stride)
+ {
+ coordinates[i] = this.vertexData[j];
+ coordinates[i+1]= this.vertexData[j+1];
+ coordinates[i+2]= this.vertexData[j+2];
+ }
+ }
+
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinates an array of 3*n values that will receive new coordinates
+ */
+ void getCoordinates(int index, double coordinates[]) {
+ int offset = this.stride*index + coordinateOffset;
+ int i, j, num = coordinates.length;
+
+ for (i=0,j= offset;i < num;i +=3, j += this.stride)
+ {
+ coordinates[i] = (double)this.vertexData[j];
+ coordinates[i+1]= (double)this.vertexData[j+1];
+ coordinates[i+2]= (double)this.vertexData[j+2];
+ }
+ }
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinates an array of vectors that will receive new coordinates
+ */
+ void getCoordinates(int index, Point3f coordinates[]) {
+ int offset = this.stride*index + coordinateOffset;
+ int i, j, num = coordinates.length;
+
+ for (i=0,j= offset;i < num;i++, j += this.stride)
+ {
+ coordinates[i].x = this.vertexData[j];
+ coordinates[i].y = this.vertexData[j+1];
+ coordinates[i].z = this.vertexData[j+2];
+ }
+ }
+
+ /**
+ * Gets the coordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param coordinates an array of vectors that will receive new coordinates
+ */
+ void getCoordinates(int index, Point3d coordinates[]) {
+ int offset = this.stride*index + coordinateOffset;
+ int i, j, num = coordinates.length;
+
+ for (i=0,j= offset;i < num;i++, j += this.stride)
+ {
+ coordinates[i].x = (double)this.vertexData[j];
+ coordinates[i].y = (double)this.vertexData[j+1];
+ coordinates[i].z = (double)this.vertexData[j+2];
+ }
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color an array of 3 or 4 values that will receive the new color
+ */
+ void getColor(int index, float color[]) {
+ int offset = this.stride*index + colorOffset;
+
+ color[0]= this.vertexData[offset];
+ color[1]= this.vertexData[offset+1];
+ color[2]= this.vertexData[offset+2];
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ color[3]= this.vertexData[offset+3]/lastAlpha[0];
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color an array of 3 or 4 values that will receive the new color
+ */
+ void getColor(int index, byte color[]) {
+ int offset = this.stride*index + colorOffset;
+
+ color[0]= (byte)(this.vertexData[offset] * FloatToByteScale);
+ color[1]= (byte)(this.vertexData[offset+1] * FloatToByteScale);
+ color[2]= (byte)(this.vertexData[offset+2] * FloatToByteScale);
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ color[3]= (byte)((this.vertexData[offset+3]/lastAlpha[0]) * FloatToByteScale);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector that will receive the new color
+ */
+ void getColor(int index, Color3f color) {
+ int offset = this.stride*index + colorOffset;
+
+ color.x = this.vertexData[offset];
+ color.y = this.vertexData[offset+1];
+ color.z = this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector that will receive the new color
+ */
+ void getColor(int index, Color4f color) {
+ int offset = this.stride*index + colorOffset;
+
+ color.x = this.vertexData[offset];
+ color.y = this.vertexData[offset+1];
+ color.z = this.vertexData[offset+2];
+ color.w= this.vertexData[offset+3]/lastAlpha[0];
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector that will receive the new color
+ */
+ void getColor(int index, Color3b color) {
+ int offset = this.stride*index + colorOffset;
+
+ color.x = (byte)(this.vertexData[offset] * FloatToByteScale);
+ color.y = (byte)(this.vertexData[offset+1] * FloatToByteScale);
+ color.z = (byte)(this.vertexData[offset+2] * FloatToByteScale);
+ }
+
+ /**
+ * Gets the color associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param color a vector that will receive the new color
+ */
+ void getColor(int index, Color4b color) {
+ int offset = this.stride*index + colorOffset;
+
+ color.x = (byte)(this.vertexData[offset] * FloatToByteScale);
+ color.y = (byte)(this.vertexData[offset+1] * FloatToByteScale);
+ color.z = (byte)(this.vertexData[offset+2] * FloatToByteScale);
+ color.w = (byte)((this.vertexData[offset+3]/lastAlpha[0]) * FloatToByteScale);
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values that will receive n new colors
+ */
+ void getColors(int index, float colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+ float val = 1.0f/lastAlpha[0];
+
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ {
+ for (i=0, j= offset;i < num; i+= 4, j+= this.stride)
+ {
+ colors[i] = this.vertexData[j];
+ colors[i+1]= this.vertexData[j+1];
+ colors[i+2]= this.vertexData[j+2];
+ colors[i+3]= this.vertexData[j+3] * val;
+ }
+ }
+ else
+ {
+ for (i=0, j= offset;i < num; i+= 3, j+= this.stride)
+ {
+ colors[i] = this.vertexData[j];
+ colors[i+1]= this.vertexData[j+1];
+ colors[i+2]= this.vertexData[j+2];
+ }
+ }
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of 3*n or 4*n values that will receive new colors
+ */
+ void getColors(int index, byte colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+ float val = 1.0f/lastAlpha[0];
+
+
+ if ((this.vertexFormat & GeometryArray.WITH_ALPHA) != 0)
+ {
+ for (i=0, j= offset;i < num; i+= 4, j+= this.stride)
+ {
+ colors[i] = (byte)(this.vertexData[j] * FloatToByteScale);
+ colors[i+1]= (byte)(this.vertexData[j+1] * FloatToByteScale);
+ colors[i+2]= (byte)(this.vertexData[j+2] * FloatToByteScale);
+ colors[i+3]= (byte)((this.vertexData[j+3] * val) * FloatToByteScale);
+ }
+ }
+ else
+ {
+ for (i=0, j= offset;i < num; i+= 3, j+= this.stride)
+ {
+ colors[i] = (byte)(this.vertexData[j] * FloatToByteScale);
+ colors[i+1]= (byte)(this.vertexData[j+1] * FloatToByteScale);
+ colors[i+2]= (byte)(this.vertexData[j+2] * FloatToByteScale);
+ }
+ }
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors that will receive new colors
+ */
+ void getColors(int index, Color3f colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ colors[i].x = this.vertexData[j];
+ colors[i].y = this.vertexData[j+1];
+ colors[i].z = this.vertexData[j+2];
+ }
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors that will receive new colors
+ */
+ void getColors(int index, Color4f colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+ float val = 1.0f/lastAlpha[0];
+
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ colors[i].x = this.vertexData[j];
+ colors[i].y = this.vertexData[j+1];
+ colors[i].z = this.vertexData[j+2];
+ colors[i].w = this.vertexData[j+3] * val;
+ }
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors that will receive new colors
+ */
+ void getColors(int index, Color3b colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ colors[i].x = (byte)(this.vertexData[j] * FloatToByteScale);
+ colors[i].y = (byte)(this.vertexData[j+1] * FloatToByteScale);
+ colors[i].z = (byte)(this.vertexData[j+2] * FloatToByteScale);
+ }
+ }
+
+ /**
+ * Gets the colors associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param colors an array of vectors that will receive new colors
+ */
+ void getColors(int index, Color4b colors[]) {
+ int offset = this.stride*index + colorOffset;
+ int i, j, num = colors.length;
+ float val = 1.0f/lastAlpha[0];
+
+ for (i=0, j= offset;i < num; i++, j+= this.stride)
+ {
+ colors[i].x = (byte)(this.vertexData[j] * FloatToByteScale);
+ colors[i].y = (byte)(this.vertexData[j+1] * FloatToByteScale);
+ colors[i].z = (byte)(this.vertexData[j+2] * FloatToByteScale);
+ colors[i].w = (byte)(this.vertexData[j+3] * val * FloatToByteScale);
+ }
+ }
+
+ /**
+ * Gets the normal associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param normal array that will receive the new normal
+ */
+ void getNormal(int index, float normal[]) {
+ int offset = this.stride*index + normalOffset;
+
+ normal[0]= this.vertexData[offset];
+ normal[1]= this.vertexData[offset+1];
+ normal[2]= this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the normal associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param normal the vector that will receive the new normal
+ */
+ void getNormal(int index, Vector3f normal) {
+ int offset = this.stride*index + normalOffset;
+
+ normal.x= this.vertexData[offset];
+ normal.y= this.vertexData[offset+1];
+ normal.z= this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the normals associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param normals array that will receive the new normals
+ */
+ void getNormals(int index, float normals[]) {
+ int offset = this.stride*index + normalOffset;
+ int i, j, num = normals.length;
+
+ for (i=0, j= offset;i < num;i+=3, j+= this.stride)
+ {
+ normals[i] = this.vertexData[j];
+ normals[i+1]= this.vertexData[j+1];
+ normals[i+2]= this.vertexData[j+2];
+ }
+ }
+
+ /**
+ * Gets the normals associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param normals the vector that will receive the new normals
+ */
+ void getNormals(int index, Vector3f normals[]) {
+ int offset = this.stride*index + normalOffset;
+ int i, j, num = normals.length;
+
+ for (i=0, j= offset;i < num;i++, j+= this.stride)
+ {
+ normals[i].x= this.vertexData[j];
+ normals[i].y= this.vertexData[j+1];
+ normals[i].z= this.vertexData[j+2];
+ }
+ }
+
+ /**
+ * Gets the texture co-ordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoord array that will receive the new texture co-ordinate
+ */
+ void getTextureCoordinate(int texCoordSet, int index, float texCoord[]) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+
+ texCoord[0]= this.vertexData[offset];
+ texCoord[1]= this.vertexData[offset+1];
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE_3) != 0) {
+ texCoord[2]= this.vertexData[offset+2];
+
+ } else if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE_4)
+ != 0) {
+ texCoord[2]= this.vertexData[offset+2];
+ texCoord[3]= this.vertexData[offset+3];
+ }
+ }
+
+ /**
+ * Gets the texture co-ordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoord the vector that will receive the new texture co-ordinates
+ */
+ void getTextureCoordinate(int texCoordSet, int index, TexCoord2f texCoord) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+
+ texCoord.x= this.vertexData[offset];
+ texCoord.y= this.vertexData[offset+1];
+ }
+
+ /**
+ * Gets the texture co-ordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoord the vector that will receive the new texture co-ordinates
+ */
+ void getTextureCoordinate(int texCoordSet, int index, TexCoord3f texCoord) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+
+ texCoord.x= this.vertexData[offset];
+ texCoord.y= this.vertexData[offset+1];
+ texCoord.z= this.vertexData[offset+2];
+ }
+
+ /**
+ * Gets the texture co-ordinate associated with the vertex at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoord the vector that will receive the new texture co-ordinates
+ */
+ void getTextureCoordinate(int texCoordSet, int index, TexCoord4f texCoord) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+
+ texCoord.x= this.vertexData[offset];
+ texCoord.y= this.vertexData[offset+1];
+ texCoord.z= this.vertexData[offset+2];
+ texCoord.w= this.vertexData[offset+3];
+ }
+
+ /**
+ * Gets the texture co-ordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoords array that will receive the new texture co-ordinates
+ */
+ void getTextureCoordinates(int texCoordSet, int index, float texCoords[]) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j, num = texCoords.length;
+
+ if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE_4) != 0) {
+ for (i=0, j= offset;i < num;i+=4, j+= this.stride)
+ {
+ texCoords[i]= this.vertexData[j];
+ texCoords[i+1]= this.vertexData[j+1];
+ texCoords[i+2]= this.vertexData[j+2];
+ texCoords[i+3]= this.vertexData[j+3];
+ }
+ } else if ((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE_3)
+ != 0) {
+ for (i=0, j= offset;i < num;i+=3, j+= this.stride)
+ {
+ texCoords[i]= this.vertexData[j];
+ texCoords[i+1]= this.vertexData[j+1];
+ texCoords[i+2]= this.vertexData[j+2];
+ }
+ } else {
+ for (i=0, j= offset;i < num;i+=2, j+= this.stride)
+ {
+ texCoords[i]= this.vertexData[j];
+ texCoords[i+1]= this.vertexData[j+1];
+ }
+ }
+ }
+
+ /**
+ * Gets the texture co-ordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoords the vector that will receive the new texture co-ordinates
+ */
+ void getTextureCoordinates(int texCoordSet, int index,
+ TexCoord2f texCoords[]) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j, num = texCoords.length;
+
+ for (i=0, j= offset;i < num;i++, j+= this.stride)
+ {
+ texCoords[i].x= this.vertexData[j];
+ texCoords[i].y= this.vertexData[j+1];
+ }
+ }
+
+ /**
+ * Gets the texture co-ordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoords the vector that will receive the new texture co-ordinates
+ */
+ void getTextureCoordinates(int texCoordSet, int index, TexCoord3f texCoords[]) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j, num = texCoords.length;
+
+ for (i=0, j= offset;i < num;i++, j+= this.stride)
+ {
+ texCoords[i].x= this.vertexData[j];
+ texCoords[i].y= this.vertexData[j+1];
+ texCoords[i].z= this.vertexData[j+2];
+ }
+ }
+
+ /**
+ * Gets the texture co-ordinates associated with the vertices starting at
+ * the specified index.
+ * @param index the vertex index
+ * @param texCoords the vector that will receive the new texture co-ordinates
+ */
+ void getTextureCoordinates(int texCoordSet, int index, TexCoord4f texCoords[]) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j, num = texCoords.length;
+
+ for (i=0, j= offset;i < num;i++, j+= this.stride)
+ {
+ texCoords[i].x= this.vertexData[j];
+ texCoords[i].y= this.vertexData[j+1];
+ texCoords[i].z= this.vertexData[j+2];
+ texCoords[i].w= this.vertexData[j+3];
+ }
+ }
+
+ void getTextureCoordinates(int texCoordSet, int index,
+ Point2f texCoords[]) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j, num = texCoords.length;
+
+ for (i=0, j= offset;i < num;i++, j+= this.stride)
+ {
+ texCoords[i].x= this.vertexData[j];
+ texCoords[i].y= this.vertexData[j+1];
+ }
+ }
+
+ void getTextureCoordinates(int texCoordSet, int index, Point3f texCoords[]) {
+ int offset = this.stride*index + textureOffset +
+ texCoordSet * texCoordStride;
+ int i, j, num = texCoords.length;
+
+ for (i=0, j= offset;i < num;i++, j+= this.stride)
+ {
+ texCoords[i].x= this.vertexData[j];
+ texCoords[i].y= this.vertexData[j+1];
+ texCoords[i].z= this.vertexData[j+2];
+ }
+ }
+
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ float[] vertexAttr) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int size = vertexAttrSizes[vertexAttrNum];
+
+ for (int i = 0; i < size; i++) {
+ vertexAttr[i] = this.vertexData[offset+i];
+
+ }
+
+ }
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ Point2f vertexAttr) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+
+ vertexAttr.x = this.vertexData[offset];
+ vertexAttr.y = this.vertexData[offset+1];
+
+ }
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ Point3f vertexAttr) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+
+ vertexAttr.x = this.vertexData[offset];
+ vertexAttr.y = this.vertexData[offset+1];
+ vertexAttr.z = this.vertexData[offset+2];
+
+ }
+
+ /**
+ * Gets the vertex attribute associated with the vertex at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttr(int vertexAttrNum, int index,
+ Point4f vertexAttr) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+
+ vertexAttr.x = this.vertexData[offset];
+ vertexAttr.y = this.vertexData[offset+1];
+ vertexAttr.z = this.vertexData[offset+2];
+ vertexAttr.w = this.vertexData[offset+3];
+
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ float[] vertexAttrs) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int size = vertexAttrSizes[vertexAttrNum];
+ int i, j, k;
+
+ for (i = 0, j = offset;
+ ((i < vertexAttrs.length) && (j < this.vertexData.length)) ;
+ i += size, j += this.stride) {
+ for (k = 0; k < size; k++) {
+ vertexAttrs[i+k] = this.vertexData[j+k];
+ }
+ }
+
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ Point2f[] vertexAttrs) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int i, j;
+
+ for (i = 0, j = offset;
+ ((i < vertexAttrs.length) && (j < this.vertexData.length)) ;
+ i++, j += this.stride) {
+ vertexAttrs[i].x = this.vertexData[j];
+ vertexAttrs[i].y = this.vertexData[j+1];
+ }
+
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ Point3f[] vertexAttrs) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int i, j;
+
+ for (i = 0, j = offset;
+ ((i < vertexAttrs.length) && (j < this.vertexData.length)) ;
+ i++, j += this.stride) {
+ vertexAttrs[i].x = this.vertexData[j];
+ vertexAttrs[i].y = this.vertexData[j+1];
+ vertexAttrs[i].z = this.vertexData[j+2];
+ }
+
+ }
+
+ /**
+ * Gets the vertex attributes associated with the vertices starting at
+ * the specified index in the specified vertex attribute number
+ * for this object.
+ */
+ public void getVertexAttrs(int vertexAttrNum, int index,
+ Point4f[] vertexAttrs) {
+
+ int offset = this.stride*index + vertexAttrOffsets[vertexAttrNum];
+ int i, j;
+
+ for (i = 0, j = offset;
+ ((i < vertexAttrs.length) && (j < this.vertexData.length)) ;
+ i++, j += this.stride) {
+ vertexAttrs[i].x = this.vertexData[j];
+ vertexAttrs[i].y = this.vertexData[j+1];
+ vertexAttrs[i].z = this.vertexData[j+2];
+ vertexAttrs[i].w = this.vertexData[j+3];
+ }
+
+ }
+
+
+ /**
+ * Updates geometry array data.
+ */
+ void updateData(GeometryUpdater updater) {
+ boolean nullGeo = false;
+
+ // Add yourself to obtain the geometry lock
+ // and Thread.currentThread().sleep until you get the lock
+ geomLock.getLock();
+
+ inUpdater = true;
+ updater.updateData((Geometry)source);
+ inUpdater = false;
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) != 0) {
+ if((vertexFormat & GeometryArray.USE_NIO_BUFFER) != 0) {
+ // XXXX: handle the nio buffer
+ if (!(this instanceof IndexedGeometryArrayRetained) ||
+ (vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) != 0) {
+ if (((vertexFormat & GeometryArray.INTERLEAVED) != 0)) {
+ setupMirrorInterleavedColorPointer(false);
+ nullGeo = (interleavedFloatBufferImpl == null);
+ }
+ else {
+ setupMirrorColorPointer((vertexType & COLOR_DEFINED), false);
+ nullGeo = ((vertexType & GeometryArrayRetained.VERTEX_DEFINED) == 0);
+ }
+ }
+ }
+ else {
+ if (!(this instanceof IndexedGeometryArrayRetained) ||
+ (vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) != 0) {
+ if (((vertexFormat & GeometryArray.INTERLEAVED) != 0)) {
+ setupMirrorInterleavedColorPointer(false);
+ nullGeo = (interLeavedVertexData == null);
+ }
+ else {
+ setupMirrorVertexPointer(vertexType & VERTEX_DEFINED);
+ setupMirrorColorPointer((vertexType & COLOR_DEFINED), false);
+ setupMirrorNormalPointer(vertexType & NORMAL_DEFINED);
+ setupMirrorTexCoordPointer(texCoordType);
+ setupMirrorVertexAttrPointer(vertexAttrType);
+ nullGeo = ((vertexType & GeometryArrayRetained.VERTEX_DEFINED) == 0);
+ }
+ }
+ }
+
+ //NVaidya
+ // User may or may not have changed indices in updater callback.
+ // We need to presume that the user may indeed have and, thus, will
+ // need to recompute maxCoordIndex unconditionally while
+ // geomLock is still locked.
+ if ((vertexFormat & GeometryArray.BY_REFERENCE_INDICES) != 0) {
+ assert (this instanceof IndexedGeometryArrayRetained);
+
+ if (((IndexedGeometryArrayRetained)this).getCoordIndicesRef() == null) {
+ nullGeo = true;
+ }
+ ((IndexedGeometryArrayRetained)this).doPostUpdaterUpdate();
+ }
+ }
+
+ dirtyFlag |= VERTEX_CHANGED;
+ colorChanged = 0xffff;
+ geomLock.unLock();
+
+ if (source != null && source.isLive()) {
+ processCoordsChanged(nullGeo);
+ sendDataChangedMessage(true);
+ }
+ }
+
+ boolean intersectBoundingBox( Point3d coordinates[],
+ BoundingBox box,
+ double dist[],
+ Point3d iPnt) {
+ int i, j;
+ int out[] = new int[6];
+
+ //Do trivial vertex test.
+ for(i=0; i<6; i++)
+ out[i] = 0;
+ for(i=0; ivalidVertexCount > vertexCount
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public GeometryStripArray(int vertexCount,
+ int vertexFormat,
+ int[] stripVertexCounts) {
+
+ super(vertexCount, vertexFormat);
+ ((GeometryStripArrayRetained)this.retained).setStripVertexCounts(stripVertexCounts);
+ }
+
+ /**
+ * Constructs an empty GeometryStripArray object with the specified
+ * number of vertices, vertex format, number of texture coordinate
+ * sets, texture coordinate mapping array, and
+ * array of per-strip vertex counts.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param stripVertexCounts array that specifies
+ * the count of the number of vertices for each separate strip.
+ * The length of this array is the number of separate strips.
+ * The sum of the elements in this array defines the total number
+ * of valid vertices that are rendered (validVertexCount).
+ *
+ * @exception IllegalArgumentException if
+ * validVertexCount > vertexCount
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public GeometryStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int[] stripVertexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap);
+ ((GeometryStripArrayRetained)this.retained).setStripVertexCounts(stripVertexCounts);
+ }
+
+ /**
+ * Constructs an empty GeometryStripArray object with the
+ * specified number of vertices, vertex format, number of texture
+ * coordinate sets, texture coordinate mapping array, vertex
+ * attribute count, vertex attribute sizes array, and array of
+ * per-strip vertex counts.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param stripVertexCounts array that specifies
+ * the count of the number of vertices for each separate strip.
+ * The length of this array is the number of separate strips.
+ * The sum of the elements in this array defines the total number
+ * of valid vertices that are rendered (validVertexCount).
+ *
+ * @exception IllegalArgumentException if
+ * validVertexCount > vertexCount
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public GeometryStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int[] stripVertexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes);
+
+ ((GeometryStripArrayRetained)this.retained).setStripVertexCounts(stripVertexCounts);
+ }
+
+ /**
+ * Get number of strips in the GeometryStripArray.
+ * @return numStrips number of strips
+ */
+ public int getNumStrips() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(GeometryArray.ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryStripArray0"));
+
+ return ((GeometryStripArrayRetained)this.retained).getNumStrips();
+ }
+
+ /**
+ * Sets the array of strip vertex counts. The length of this
+ * array is the number of separate strips. The elements in this
+ * array specify the number of vertices for each separate strip.
+ * The sum of the elements in this array defines the total number
+ * of valid vertices that are rendered (validVertexCount).
+ *
+ * @param stripVertexCounts array that specifies
+ * the count of the number of vertices for each separate strip.
+ *
+ * @exception IllegalArgumentException if any of the following are
+ * true:
+ *
+ *
+ * initialVertexIndex + validVertexCount > vertexCount,
+ * initialCoordIndex + validVertexCount > vertexCount,
+ * initialColorIndex + validVertexCount > vertexCount,
+ * initialNormalIndex + validVertexCount > vertexCount,
+ * initialTexCoordIndex + validVertexCount > vertexCount
+ * BY_REFERENCE and any the following
+ * are true for non-null array references:
+ *
+ *
+ * where num_words depends on which variant of
+ * CoordRef.length < num_words *
+ * (initialCoordIndex + validVertexCount)
+ * ColorRef.length < num_words *
+ * (initialColorIndex + validVertexCount)
+ * NormalRef.length < num_words *
+ * (initialNormalIndex + validVertexCount)
+ * TexCoordRef.length < num_words *
+ * (initialTexCoordIndex + validVertexCount)
+ * setArrayRef is used.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setStripVertexCounts(int[] stripVertexCounts) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(GeometryArray.ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryStripArray2"));
+
+ ((GeometryStripArrayRetained)this.retained).setStripVertexCounts(stripVertexCounts);
+
+ }
+
+ /**
+ * Get a list of vertexCounts for each strip. The list is copied
+ * into the specified array. The array must be large enough to hold
+ * all of the ints.
+ * @param stripVertexCounts an array that will receive vertexCounts
+ */
+ public void getStripVertexCounts(int[] stripVertexCounts) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(GeometryArray.ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryStripArray1"));
+
+ ((GeometryStripArrayRetained)this.retained).getStripVertexCounts(stripVertexCounts);
+ }
+
+ /**
+ * This method is not supported for geometry strip arrays.
+ * The sum of the elements in the strip vertex counts array
+ * defines the valid vertex count.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setValidVertexCount(int validVertexCount) {
+ throw new UnsupportedOperationException();
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GeometryStripArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/GeometryStripArrayRetained.java
new file mode 100644
index 0000000..d16ade6
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GeometryStripArrayRetained.java
@@ -0,0 +1,835 @@
+/*
+ * $RCSfile: GeometryStripArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:22 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+import java.util.Vector;
+import com.sun.j3d.internal.ByteBufferWrapper;
+import com.sun.j3d.internal.BufferWrapper;
+import com.sun.j3d.internal.FloatBufferWrapper;
+import com.sun.j3d.internal.DoubleBufferWrapper;
+
+
+/**
+ * The GeometryStripArray object is an abstract class that is extended for
+ * a set of GeometryArray strip primitives. These include LINE_STRIP,
+ * TRIANGLE_STRIP, and TRIANGLE_FAN.
+ */
+
+abstract class GeometryStripArrayRetained extends GeometryArrayRetained {
+
+ // Array of per-strip vertex counts
+ int stripVertexCounts[];
+
+ // Array of per-strip starting index
+ int stripStartVertexIndices[]; // start of vertices for both by-copy
+ // and by-ref
+ int stripStartOffsetIndices[]; // Used in byRef non_interleaved
+
+ // Following variables are only used in the compile mode
+ // isCompiled = true
+ int[] compileNumStrips;
+ int[] compileStripCountOffset;
+
+
+ /**
+ * Set stripVertexCount data into local array
+ */
+ void setStripVertexCounts(int stripVertexCounts[]) {
+ boolean nullGeo = false;
+
+ int i, num = stripVertexCounts.length, total = 0;
+ for (i=0; i < num; i++) {
+ total += stripVertexCounts[i];
+ if (this instanceof LineStripArrayRetained) {
+ if (stripVertexCounts[i] < 2) {
+ throw new IllegalArgumentException(J3dI18N.getString("LineStripArrayRetained1"));
+ }
+ }
+ else if (this instanceof TriangleStripArrayRetained) {
+ if (stripVertexCounts[i] < 3) {
+ throw new IllegalArgumentException(J3dI18N.getString("TriangleStripArrayRetained1"));
+ }
+ }
+ else if (this instanceof TriangleFanArrayRetained) {
+ if (stripVertexCounts[i] < 3) {
+ throw new IllegalArgumentException(J3dI18N.getString("TriangleFanArrayRetained1"));
+ }
+ }
+ }
+
+ if ((initialVertexIndex + total) > vertexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryStripArray3"));
+ }
+ if ((initialCoordIndex + total) > vertexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryStripArray7"));
+ }
+ if ((initialColorIndex + total) > vertexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryStripArray4"));
+ }
+ if ((initialNormalIndex + total) > vertexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("GeometryStripArray5"));
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ if ((vertexFormat & (GeometryArray.BY_REFERENCE|vertexFormat &GeometryArray.INTERLEAVED)) == GeometryArray.BY_REFERENCE) {
+ for (i = 0; i < texCoordSetCount; i++) {
+ if ((initialTexCoordIndex[i] + total) > vertexCount) {
+ throw new IllegalArgumentException(
+ J3dI18N.getString("GeometryStripArray6"));
+ }
+ }
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ if ((vertexFormat & (GeometryArray.BY_REFERENCE|vertexFormat &GeometryArray.INTERLEAVED)) == GeometryArray.BY_REFERENCE) {
+ for (i = 0; i < vertexAttrCount; i++) {
+ if ((initialVertexAttrIndex[i] + total) > vertexCount) {
+ throw new IllegalArgumentException(
+ J3dI18N.getString("GeometryStripArray8"));
+ }
+ }
+ }
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= STRIPCOUNT_CHANGED;
+ validVertexCount = total;
+ this.stripVertexCounts = new int[num];
+ stripStartVertexIndices = new int[num];
+ stripStartOffsetIndices = new int[num];
+ stripStartOffsetIndices[0] = 0;
+ if ((vertexFormat & (GeometryArray.BY_REFERENCE|vertexFormat &GeometryArray.INTERLEAVED)) == GeometryArray.BY_REFERENCE) {
+ stripStartVertexIndices[0] = initialCoordIndex;
+ nullGeo = ((vertexType & GeometryArrayRetained.VERTEX_DEFINED) == 0);
+ }
+ else {
+ stripStartVertexIndices[0] = initialVertexIndex;
+ if ((vertexFormat & GeometryArray.INTERLEAVED) != 0) {
+ if (( vertexFormat & GeometryArray.USE_NIO_BUFFER) != 0) {
+ nullGeo = (interLeavedVertexData == null);
+ }
+ else {
+ nullGeo = (interleavedFloatBufferImpl == null);
+ }
+ }
+ }
+
+ for (i=0; i
+ * NOTE: Applications should not call this method directly.
+ *
+ * @param geometry the Geometry object being updated.
+ * @see GeometryArray#updateData
+ */
+ public void updateData(Geometry geometry);
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GraphStructureChangeListener.java b/j3d-core/src/classes/share/javax/media/j3d/GraphStructureChangeListener.java
new file mode 100755
index 0000000..fc64a85
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GraphStructureChangeListener.java
@@ -0,0 +1,73 @@
+/*
+ * $RCSfile: GraphStructureChangeListener.java,v $
+ *
+ * Copyright 2005-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:22 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Listener interface for monitoring structural changes to live scene
+ * graphs. BranchGroup additions, removals and moves are reported.
+ *
+ * @see VirtualUniverse#addGraphStructureChangeListener
+ *
+ * @since Java 3D 1.4
+ */
+public interface GraphStructureChangeListener {
+ /**
+ * Invoked when a branch group is added.
+ * Called just before the child is added to the parent.
+ * Parent can be either a BranchGroup or a Locale.
+ *
+ * @param parent the parent of the child being added
+ * @param child the child being added
+ */
+ public void branchGroupAdded(Object parent, BranchGroup child);
+
+ /**
+ * Invoked when a branch group is removed.
+ * Called just after the child has been removed from the parent.
+ * Parent can be either a BranchGroup or a Locale.
+ *
+ * @param parent the parent of the child being added
+ * @param child the child being added
+ */
+ public void branchGroupRemoved(Object parent, BranchGroup child);
+
+ /**
+ * Invoked when a branch group is moved.
+ * Called after a child has been moved to it's new parent. This call differs
+ * from the other methods in that the child is live when this method is called.
+ *
+ * @param oldParent the original parent of the child being moved
+ * @param newParent the new parent of the child being moved
+ * @param child the child being moved
+ */
+ public void branchGroupMoved(Object oldParent, Object newParent, BranchGroup child);
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GraphicsConfigInfo.java b/j3d-core/src/classes/share/javax/media/j3d/GraphicsConfigInfo.java
new file mode 100644
index 0000000..be086d0
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GraphicsConfigInfo.java
@@ -0,0 +1,63 @@
+/*
+ * $RCSfile: GraphicsConfigInfo.java,v $
+ *
+ * Copyright 2005-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:22 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Container for the GraphicsTemplate3D and other private data about a selected
+ * GraphicsConfiguration. An instance of this class is created along with an
+ * instance of GrahpicsConfiguration, whenever getBestConfiguration is called.
+ */
+class GraphicsConfigInfo {
+ private GraphicsConfigTemplate3D graphicsConfigTemplate3D = null;
+ private Object privateData = null;
+
+ GraphicsConfigInfo(GraphicsConfigTemplate3D graphicsConfigTemplate3D) {
+ setGraphicsConfigTemplate3D(graphicsConfigTemplate3D);
+ }
+
+ GraphicsConfigTemplate3D getGraphicsConfigTemplate3D() {
+ return graphicsConfigTemplate3D;
+ }
+
+ void setGraphicsConfigTemplate3D(GraphicsConfigTemplate3D graphicsConfigTemplate3D) {
+ this.graphicsConfigTemplate3D = graphicsConfigTemplate3D;
+ }
+
+ Object getPrivateData() {
+ return privateData;
+ }
+
+ void setPrivateData(Object privateData) {
+ this.privateData = privateData;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GraphicsConfigTemplate3D.java b/j3d-core/src/classes/share/javax/media/j3d/GraphicsConfigTemplate3D.java
new file mode 100644
index 0000000..46e3ea4
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GraphicsConfigTemplate3D.java
@@ -0,0 +1,448 @@
+/*
+ * $RCSfile: GraphicsConfigTemplate3D.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:22 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.GraphicsDevice;
+import java.awt.GraphicsConfiguration;
+import java.awt.GraphicsConfigTemplate;
+
+/**
+ * This class is used to obtain a valid GraphicsConfiguration that can be used by Java 3D.
+ * A user instantiates one of these objects and then sets all
+ * non-default attributes as desired. The getBestConfiguration()
+ * method in the GraphicsDevice class is then called with this
+ * GraphicsConfigTemplate and the "best" GraphicsConfiguration is returned. The "best"
+ * GraphicsConfiguration means that this GraphicsConfiguration is supported and it
+ * meets or exceeds what was requested in the GraphicsConfigTemplate.
+ * Null is returned if no such "best" GraphicsConfiguration is found.
+ *
+ * @see GraphicsConfigTemplate
+ * @see GraphicsDevice
+ * @see GraphicsConfiguration
+ */
+public class GraphicsConfigTemplate3D extends GraphicsConfigTemplate {
+
+ int depthSize;
+ int doubleBuffer;
+ int blueSize;
+ int greenSize;
+ int redSize;
+ int sceneAntialiasing;
+ int stereo;
+ int stencilSize;
+
+ // Temporary variables use for passing argument to/from Request Renderer
+ Object testCfg;
+
+ static Object globalLock = new Object();
+ static Object monitorLock = new Object();
+ static volatile boolean threadWaiting = false;
+
+ /**
+ * Constructs a GraphicsConfigTemplate3D object with default parameters.
+ * The default values are as follows:
+ *
+ * depthSize : 16
+ */
+ public GraphicsConfigTemplate3D() {
+ doubleBuffer = REQUIRED;
+ stereo = UNNECESSARY;
+ depthSize = 16;
+ stencilSize = 0;
+ redSize = greenSize = blueSize = 2;
+ sceneAntialiasing = UNNECESSARY;
+ }
+
+ /**
+ * Sets the double buffering requirement. It should be
+ * GraphicsConfigTemplate.REQUIRED, GraphicsConfigTemplate.PREFERRED,
+ * or GraphicsConfigTemplate.UNNECESSARY.
+ * If an invalid value is passed in, it is ignored.
+ * If the value of double buffering is
+ * GraphicsConfigTemplate.REQUIRED, and no GraphicsConfiguration is found
+ * that meets this requirement, null will be returned in getBestConfiguration().
+ * @param value the value to set this field to
+ */
+ public void setDoubleBuffer(int value) {
+ if (value < REQUIRED && value > UNNECESSARY)
+ return;
+
+ doubleBuffer = value;
+ }
+
+ /**
+ * Retrieves the double buffering value.
+ * @return the current value of the doubleBuffer attribute
+ */
+ public int getDoubleBuffer() {
+ return doubleBuffer;
+ }
+
+ /**
+ * Sets the stereo requirement. It should be
+ * GraphicsConfigTemplate.REQUIRED, GraphicsConfigTemplate.PREFERRED,
+ * or GraphicsConfigTemplate.UNNECESSARY. If an invalid value
+ * is passed in, it is ignored. If the value of stereo requirement is
+ * GraphicsConfigTemplate.REQUIRED, and no GraphicsConfiguration is found
+ * that meets this requirement, null will be returned in getBestConfiguration().
+ * @param value the value to set this field to
+ */
+ public void setStereo(int value) {
+ if (value < REQUIRED && value > UNNECESSARY)
+ return;
+
+ stereo = value;
+ }
+
+ /**
+ * Retrieves the stereo value.
+ * @return the current value of the stereo attribute.
+ */
+ public int getStereo() {
+ return stereo;
+ }
+
+ /**
+ * Sets the scene antialiasing requirement. It should be
+ * GraphicsConfigTemplate.REQUIRED, GraphicsConfigTemplate.PREFERRED,
+ * or GraphicsConfigTemplate.UNNECESSARY. If an invalid value
+ * is passed in, it is ignored. If the value of scene antialiasing is
+ * GraphicsConfigTemplate.REQUIRED, and no GraphicsConfiguration is found
+ * that meets this requirement, null will be returned in getBestConfiguration().
+ * @param value the value to set this field to
+ */
+ public void setSceneAntialiasing(int value) {
+ if (value < REQUIRED && value > UNNECESSARY)
+ return;
+
+ sceneAntialiasing = value;
+ }
+
+ /**
+ * Retrieves the scene antialiasing value.
+ * @return the current value of the scene antialiasing attribute.
+ */
+ public int getSceneAntialiasing() {
+ return sceneAntialiasing;
+ }
+
+ /**
+ * Sets the depth buffer size requirement. This is the minimum requirement.
+ * If no GraphicsConfiguration is found that meets or
+ * exceeds this minimum requirement, null will be returned in
+ * getBestConfiguration().
+ * @param value the value to set this field to
+ */
+ public void setDepthSize(int value) {
+ if (value < 0)
+ return;
+
+ depthSize = value;
+ }
+
+ /**
+ * Retrieves the size of the depth buffer.
+ * @return the current value of the depthSize attribute
+ */
+ public int getDepthSize() {
+ return depthSize;
+ }
+
+ /**
+ * Sets the stencil buffer size requirement.
+ * This is the minimum requirement.
+ * If no GraphicsConfiguration is found that meets or
+ * exceeds this minimum requirement, null will be returned in
+ * getBestConfiguration().
+ *
+ * @param value the value to set this field to
+ *
+ * @since Java 3D 1.4
+ */
+ public void setStencilSize(int value) {
+ if (value < 0)
+ return;
+
+ stencilSize = value;
+ }
+
+ /**
+ * Retrieves the size of the stencil buffer.
+ *
+ * @return the current value of the stencilSize attribute
+ *
+ * @since Java 3D 1.4
+ */
+ public int getStencilSize() {
+ return stencilSize;
+ }
+
+ /**
+ * Sets the number of red bits required. This is the minimum requirement.
+ * If no GraphicsConfiguration is found that meets or
+ * exceeds this minimum requirement, null will be returned in
+ * getBestConfiguration().
+ * @param value the value to set this field to
+ */
+ public void setRedSize(int value) {
+ if (value < 0)
+ return;
+
+ redSize = value;
+ }
+
+ /**
+ * Retrieves the number of red bits requested by this template.
+ * @return the current value of the redSize attribute.
+ */
+ public int getRedSize() {
+ return redSize;
+ }
+
+
+ /**
+ * Sets the number of green bits required. This is the minimum requirement.
+ * If no GraphicsConfiguration is found that meets or
+ * exceeds this minimum requirement, null will be returned in
+ * getBestConfiguration().
+ * @param value the value to set this field to
+ */
+ public void setGreenSize(int value) {
+ if (value < 0)
+ return;
+
+ greenSize = value;
+ }
+
+ /**
+ * Retrieves the number of green bits requested by this template.
+ * @return the current value of the greenSize attribute.
+ */
+ public int getGreenSize() {
+ return greenSize;
+ }
+
+ /**
+ * Sets the number of blue bits required. This is the minimum requirement.
+ * If no GraphicsConfiguration is found that meets or
+ * exceeds this minimum requirement, null will be returned in
+ * getBestConfiguration().
+ * @param value the value to set this field to
+ */
+ public void setBlueSize(int value) {
+ if (value < 0)
+ return;
+
+ blueSize = value;
+ }
+
+ /**
+ * Retrieves the number of blue bits requested by this template.
+ * @return the current value of the blueSize attribute.
+ */
+ public int getBlueSize() {
+ return blueSize;
+ }
+
+ /**
+ * Implement the abstract function of getBestConfiguration() in GraphicsConfigTemplate.
+ * Usually this function is not directly called by the user. It is
+ * implicitly called by getBestConfiguration() in GraphicsDevice.
+ * The method getBestConfiguration() in GraphicsDevice will return whatever this function returns.
+ * This function will return the "best" GraphicsConfiguration. The "best" GraphicsConfiguration
+ * means that this GraphicsConfiguration is supported and it meets or exceeds what was requested in the
+ * GraphicsConfigTemplate. If no such "best" GraphicsConfiguration is found, null is returned.
+ * @param gc the array of GraphicsConfigurations to choose from
+ *
+ * @return the best GraphicsConfiguration
+ *
+ * @see GraphicsDevice
+ */
+ public GraphicsConfiguration
+ getBestConfiguration(GraphicsConfiguration[] gc) {
+ if ((gc == null) || (gc.length == 0) || (gc[0] == null)) {
+ return null;
+ }
+
+ synchronized (globalLock) {
+ testCfg = gc;
+
+ // It is possible that the followign postRequest will
+ // cause request renderer run immediately before
+ // runMonitor(WAIT). So we need to set
+ // threadWaiting to true.
+ threadWaiting = true;
+
+ // Prevent deadlock if invoke from Behavior callback since
+ // this thread has to wait Renderer thread to finish but
+ // MC can only handle postRequest and put it in Renderer
+ // queue when free.
+ if (Thread.currentThread() instanceof BehaviorScheduler) {
+ VirtualUniverse.mc.sendRenderMessage(gc[0], this,
+ MasterControl.GETBESTCONFIG);
+ } else {
+ VirtualUniverse.mc.postRequest(MasterControl.GETBESTCONFIG, this);
+ }
+ runMonitor(J3dThread.WAIT);
+ return (GraphicsConfiguration) testCfg;
+ }
+ }
+
+ /**
+ * Returns a boolean indicating whether or not the given
+ * GraphicsConfiguration can be used to create a drawing
+ * surface that can be rendered to.
+ *
+ * @param gc the GraphicsConfiguration object to test
+ *
+ * @return
+ * doubleBuffer : REQUIRED
+ * sceneAntialiasing : UNNECESSARY
+ * stereo : UNNECESSARY
+ * redSize : 2
+ * greenSize : 2
+ * blueSize : 2
+ * stencilSize : 0
+ * true if this GraphicsConfiguration object
+ * can be used to create surfaces that can be rendered to,
+ * false if the GraphicsConfiguration can not be used
+ * to create a drawing surface usable by this API.
+ */
+ public boolean isGraphicsConfigSupported(GraphicsConfiguration gc) {
+ if (gc == null) {
+ return false;
+ }
+
+ synchronized (globalLock) {
+ testCfg = gc;
+ threadWaiting = true;
+ if (Thread.currentThread() instanceof BehaviorScheduler) {
+ VirtualUniverse.mc.sendRenderMessage(gc, this, MasterControl.ISCONFIGSUPPORT);
+ } else {
+ VirtualUniverse.mc.postRequest(MasterControl.ISCONFIGSUPPORT, this);
+ }
+ runMonitor(J3dThread.WAIT);
+ return ((Boolean) testCfg).booleanValue();
+ }
+ }
+
+ /**
+ * Set the stereo/doubleBuffer/sceneAntialiasingAccum
+ * and hasSceneAntialiasingMultiSamples flags in Canvas3D
+ */
+ static void getGraphicsConfigFeatures(Canvas3D c) {
+ synchronized (globalLock) {
+ threadWaiting = true;
+ if (Thread.currentThread() instanceof BehaviorScheduler) {
+ VirtualUniverse.mc.sendRenderMessage(c.graphicsConfiguration, c,
+ MasterControl.SET_GRAPHICSCONFIG_FEATURES);
+ } else {
+ VirtualUniverse.mc.postRequest(MasterControl.SET_GRAPHICSCONFIG_FEATURES, c);
+ }
+ runMonitor(J3dThread.WAIT);
+ }
+ }
+
+
+
+ /**
+ * Set the queryProperties() map in Canvas3D
+ */
+ static void setQueryProps(Canvas3D c) {
+ synchronized (globalLock) {
+ threadWaiting = true;
+ if (Thread.currentThread() instanceof BehaviorScheduler) {
+ VirtualUniverse.mc.sendRenderMessage(c.graphicsConfiguration, c,
+ MasterControl.SET_QUERYPROPERTIES);
+ } else {
+ VirtualUniverse.mc.postRequest(MasterControl.SET_QUERYPROPERTIES, c);
+ }
+ runMonitor(J3dThread.WAIT);
+ }
+ }
+
+
+ static void runMonitor(int action) {
+ // user thread will locked the globalLock when Renderer
+ // thread invoke this function so we can't use
+ // the same lock.
+ synchronized (monitorLock) {
+ switch (action) {
+ case J3dThread.WAIT:
+ // Issue 279 - loop until ready
+ while (threadWaiting) {
+ try {
+ monitorLock.wait();
+ } catch (InterruptedException e) {
+ System.err.println(e);
+ }
+ }
+ break;
+ case J3dThread.NOTIFY:
+ monitorLock.notify();
+ threadWaiting = false;
+ break;
+ }
+ }
+ }
+
+
+ // Return a string representing the value, one of:
+ // REQUIRED, PREFERRED, or UNNECESSARY
+ private static final String enumStr(int val) {
+ switch (val) {
+ case REQUIRED:
+ return "REQUIRED";
+ case PREFERRED:
+ return "PREFERRED";
+ case UNNECESSARY:
+ return "UNNECESSARY";
+ }
+
+ return "UNDEFINED";
+ }
+
+ /**
+ * Returns a string representation of this object.
+ * @return a string representation of this object.
+ */
+ public String toString() {
+ return
+ "redSize : " + redSize + ", " +
+ "greenSize : " + greenSize + ", " +
+ "blueSize : " + blueSize + ", " +
+ "depthSize : " + depthSize + ", " +
+ "doubleBuffer : " + enumStr(doubleBuffer) + ", " +
+ "sceneAntialiasing : " + enumStr(sceneAntialiasing) + ", " +
+ "stereo : " + enumStr(stereo);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GraphicsContext3D.java b/j3d-core/src/classes/share/javax/media/j3d/GraphicsContext3D.java
new file mode 100644
index 0000000..91d175c
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GraphicsContext3D.java
@@ -0,0 +1,3080 @@
+/*
+ * $RCSfile: GraphicsContext3D.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.15 $
+ * $Date: 2008/02/28 20:17:22 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.Point;
+import java.awt.image.BufferedImage;
+import javax.vecmath.*;
+import java.util.Vector;
+import java.util.Enumeration;
+import java.awt.Dimension;
+
+/**
+ * A GraphicsContext3D object is used for immediate mode rendering into
+ * a 3D canvas. It is created by, and associated with, a specific
+ * Canvas3D object. A GraphicsContext3D defines methods to set 3D graphics
+ * state and draw 3D geometric primitives. There are no public
+ * constructors of GraphicsContext3D. An application obtains a 3D graphics
+ * context object from the Canvas3D object that the application wishes
+ * to render into by using the getGraphicsContext3D method. A new graphics
+ * context is created if one does not already exist. A new GraphicsContext3D
+ * initializes its state variables to the following defaults:
+ *
+ *
+ *
+ * STEREO_BOTH flush(boolean)
+ * method to ensure that the rendering actually happens. The flush
+ * method is implicitly called in the following cases:
+ *
+ *
+ *
+ *
+ * readRaster method calls
+ * flush(true)Canvas3D.swap method calls
+ * flush(true)flush(true) prior to
+ * swapping the buffer for a double buffered on-screen Canvas3Dflush(true) prior to
+ * copying into the off-screen buffer of an off-screen Canvas3Dflush(false) after
+ * calling the preRender, renderField, postRender, and postSwap
+ * Canvas3D callback methods.stereoMode
+ * attributes.
+ *
+ * @param bufferOverride the new buffer override flag
+ *
+ * @see #setFrontBufferRendering
+ * @see #setStereoMode
+ *
+ * @since Java 3D 1.2
+ */
+ public void setBufferOverride(boolean bufferOverride) {
+ uBufferOverride = bufferOverride;
+ if ((canvas3d.view == null) ||
+ (canvas3d.view.universe == null) ||
+ (!canvas3d.view.active) ||
+ (Thread.currentThread() == canvas3d.screen.renderer)) {
+ doSetBufferOverride(bufferOverride);
+ } else if (Thread.currentThread() ==
+ canvas3d.view.universe.behaviorScheduler) {
+ sendRenderMessage(false, GraphicsContext3D.SET_BUFFER_OVERRIDE,
+ new Boolean(bufferOverride), null);
+ } else {
+ sendRenderMessage(true, GraphicsContext3D.SET_BUFFER_OVERRIDE,
+ new Boolean(bufferOverride), null);
+ }
+ }
+
+ void doSetBufferOverride(boolean bufferOverride) {
+ if (bufferOverride != this.bufferOverride) {
+ this.bufferOverride = bufferOverride;
+ dirtyMask |= BUFFER_MODE;
+ }
+ }
+
+
+ /**
+ * Returns the current buffer override flag.
+ * @return true if buffer override is enabled; otherwise,
+ * false is returned
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean getBufferOverride() {
+ return uBufferOverride;
+ }
+
+
+ /**
+ * Sets a flag that enables or disables immediate mode rendering
+ * into the front buffer of a double buffered Canvas3D.
+ * This attribute is only used when the
+ * bufferOverride flag is enabled.
+ * bufferOverride flag is enabled.
+ *
+ *
+ *
+ * STEREO_LEFT specifies that rendering is done into
+ * the left eye.
+ * STEREO_RIGHT specifies that rendering is done into
+ * the right eye.
+ * STEREO_BOTH specifies that rendering is done into
+ * both eyes. This is the default.
+ * STEREO_LEFT,
+ * STEREO_RIGHT, or STEREO_BOTH.
+ *
+ * @since Java 3D 1.2
+ */
+ public int getStereoMode() {
+ return uStereoMode;
+ }
+
+
+//
+// Methods to draw graphics objects
+//
+
+ /**
+ * Clear the Canvas3D to the color or image specified by the
+ * current background node.
+ */
+ public void clear() {
+ if ((canvas3d.view == null) || (canvas3d.view.universe == null) ||
+ (!canvas3d.view.active)) {
+ return;
+ } else if (Thread.currentThread() == canvas3d.screen.renderer) {
+ doClear();
+ } else if (Thread.currentThread() ==
+ canvas3d.view.universe.behaviorScheduler) {
+ sendRenderMessage(false, GraphicsContext3D.CLEAR, null, null);
+ } else {
+ sendRenderMessage(true, GraphicsContext3D.CLEAR, null, null);
+ }
+ }
+
+ void doClear() {
+
+ if (!canvas3d.firstPaintCalled)
+ return;
+
+ RenderBin rb = canvas3d.view.renderBin;
+ BackgroundRetained back = null;
+
+
+ if (this.background != null)
+ back = (BackgroundRetained)this.background.retained;
+ else
+ back = this.black;
+
+ // XXXX: This should ideally be done by the renderer (or by the
+ // canvas itself) when the canvas is first added to a view.
+ /*
+ if ((canvas3d.screen.renderer != null) &&
+ (canvas3d.screen.renderer.renderBin == null))
+ canvas3d.screen.renderer.renderBin = rb;
+ */
+ // If we are in pure immediate mode, update the view cache
+ if (!canvas3d.isRunning)
+ updateViewCache(rb);
+
+ // We need to catch NullPointerException when the dsi
+ // gets yanked from us during a remove.
+
+ try {
+ // Issue 78 - need to get the drawingSurface info every
+ // frame; this is necessary since the HDC (window ID)
+ // on Windows can become invalidated without our
+ // being notified!
+ if (!canvas3d.offScreen) {
+ canvas3d.drawingSurfaceObject.getDrawingSurfaceObjectInfo();
+ }
+
+ if (canvas3d.drawingSurfaceObject.renderLock()) {
+ // XXXX : Fix texture
+ /*
+ if (canvas3d.useSharedCtx) {
+ if (canvas3d.screen.renderer.sharedCtx == 0) {
+ synchronized (VirtualUniverse.mc.contextCreationLock) {
+ canvas3d.screen.renderer.sharedCtx = canvas3d.createNewContext(
+ canvas3d.screen.display,
+ canvas3d.window, 0, true,
+ canvas3d.offScreen);
+ canvas3d.screen.renderer.sharedCtxTimeStamp =
+ VirtualUniverse.mc.getContextTimeStamp();
+ canvas3d.screen.renderer.needToRebuildDisplayList = true;
+ }
+ }
+ }
+ */
+
+ if (canvas3d.ctx == null) {
+ synchronized (VirtualUniverse.mc.contextCreationLock) {
+ canvas3d.ctx = canvas3d.createNewContext(null, false);
+ if (canvas3d.ctx == null) {
+ canvas3d.drawingSurfaceObject.unLock();
+ return;
+ }
+
+ canvas3d.ctxTimeStamp =
+ VirtualUniverse.mc.getContextTimeStamp();
+ canvas3d.screen.renderer.listOfCtxs.add(canvas3d.ctx);
+ canvas3d.screen.renderer.listOfCanvases.add(canvas3d);
+
+ canvas3d.beginScene();
+
+ if (canvas3d.graphics2D != null) {
+ canvas3d.graphics2D.init();
+ }
+
+ // enable separate specular color
+ canvas3d.enableSeparateSpecularColor();
+ }
+
+ // create the cache texture state in canvas
+ // for state download checking purpose
+ if (canvas3d.texUnitState == null) {
+ canvas3d.createTexUnitState();
+ }
+
+ canvas3d.drawingSurfaceObject.contextValidated();
+ canvas3d.screen.renderer.currentCtx = canvas3d.ctx;
+ canvas3d.screen.renderer.currentDrawable = canvas3d.drawable;
+ initializeState();
+ canvas3d.ctxChanged = true;
+ canvas3d.canvasDirty = 0xffff;
+ // Update Appearance
+ updateState(rb, RenderMolecule.SURFACE);
+
+ canvas3d.currentLights = new
+ LightRetained[canvas3d.getNumCtxLights(canvas3d.ctx)];
+
+ for (int j=0; jindex must
+ * be a value
+ * greater than or equal to 0 and less than numChildren().
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live or compiled scene graph and the child node being set is not
+ * a BranchGroup node
+ * @exception MultipleParentException if child has already
+ * been added as a child of another group node
+ * @exception IndexOutOfBoundsException if index is invalid
+ */
+ public void setChild(Node child, int index) {
+ if (child instanceof SharedGroup) {
+ throw new IllegalArgumentException(J3dI18N.getString("Group2"));
+ }
+
+ if (isLiveOrCompiled()) {
+ Node oldchild =
+ (Node) ((GroupRetained)this.retained).getChild(index);
+ if (! (child instanceof BranchGroup))
+ throw new RestrictedAccessException(J3dI18N.getString("Group3"));
+
+ if (!getCapability(ALLOW_CHILDREN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group13"));
+
+ if ((oldchild != null) &&
+ (! ((BranchGroup)oldchild).getCapability(BranchGroup.ALLOW_DETACH))) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Group4"));
+ }
+ }
+
+ ((GroupRetained)retained).setChild(child, index);
+ }
+
+ /**
+ * Inserts the specified child node in this group node's list of
+ * children at the specified index.
+ * @param child the new child
+ * @param index at which location to insert. The index
+ * must be a value
+ * greater than or equal to 0 and less than or equal to
+ * numChildren().
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live
+ * or compiled scene graph and the child node being inserted is not
+ * a BranchGroup node
+ * @exception MultipleParentException if child has already
+ * been added as a child of another group node.
+ * @exception IndexOutOfBoundsException if index is invalid.
+ */
+ public void insertChild(Node child, int index) {
+ if (child instanceof SharedGroup) {
+ throw new IllegalArgumentException(J3dI18N.getString("Group2"));
+ }
+
+ if (isLiveOrCompiled()) {
+ if (! (child instanceof BranchGroup))
+ throw new RestrictedAccessException(J3dI18N.getString("Group6"));
+
+ if (!this.getCapability(ALLOW_CHILDREN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group14"));
+ }
+
+ ((GroupRetained)this.retained).insertChild(child, index);
+ }
+
+ /**
+ * Removes the child node at the specified index from this group node's
+ * list of children.
+ * @param index which child to remove. The index
+ * must be a value
+ * greater than or equal to 0 and less than numChildren().
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live or compiled scene graph and the child node being removed is not
+ * a BranchGroup node
+ * @exception IndexOutOfBoundsException if index is invalid.
+ */
+ public void removeChild(int index) {
+ if (isLiveOrCompiled()) {
+ Node child = ((GroupRetained)this.retained).getChild(index);
+ if (!(child instanceof BranchGroup)) {
+ throw new RestrictedAccessException(J3dI18N.getString("Group7"));
+ }
+
+ if (!this.getCapability(ALLOW_CHILDREN_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Group15"));
+ }
+
+ if (!((BranchGroup)child).getCapability(BranchGroup.ALLOW_DETACH)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Group4"));
+ }
+ }
+
+ ((GroupRetained)this.retained).removeChild(index);
+ }
+
+ /**
+ * Retrieves the child node at the specified index in
+ * this group node's list of children.
+ * @param index which child to return.
+ * @return the children at location index. The index
+ * must be a value
+ * greater than or equal to 0 and less than numChildren().
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception IndexOutOfBoundsException if index is invalid.
+ */
+ public Node getChild(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_CHILDREN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group9"));
+
+ return (Node) ((GroupRetained)this.retained).getChild(index);
+ }
+
+ /**
+ * Returns an Enumeration object of this group node's list of children.
+ * @return an Enumeration object of all the children
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ */
+ public Enumeration getAllChildren() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_CHILDREN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group9"));
+
+ return (Enumeration)((GroupRetained)this.retained).getAllChildren();
+ }
+
+ /**
+ * Appends the specified child node to this group node's list of children.
+ * @param child the child to add to this node's list of children
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part
+ * of live
+ * or compiled scene graph and the child node being added is not
+ * a BranchGroup node
+ * @exception MultipleParentException if child has already
+ * been added as a child of another group node.
+ */
+ public void addChild(Node child) {
+ if (child instanceof SharedGroup) {
+ throw new IllegalArgumentException(J3dI18N.getString("Group2"));
+ }
+
+ if (isLiveOrCompiled()) {
+ if (! (child instanceof BranchGroup))
+ throw new RestrictedAccessException(J3dI18N.getString("Group12"));
+
+ if(!this.getCapability(ALLOW_CHILDREN_EXTEND))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group16"));
+ }
+
+ ((GroupRetained)this.retained).addChild(child);
+ }
+
+ /**
+ * Moves the specified branch group node from its existing location to
+ * the end of this group node's list of children.
+ * @param branchGroup the branch group node to move to this node's list
+ * of children
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ */
+ public void moveTo(BranchGroup branchGroup) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_CHILDREN_EXTEND))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group16"));
+
+ if (! branchGroup.getCapability(BranchGroup.ALLOW_DETACH)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Group4"));
+ }
+ }
+
+ ((GroupRetained)this.retained).moveTo(branchGroup);
+ }
+
+ /**
+ * Returns a count of this group node's children.
+ * @return the number of children descendant from this node.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ */
+ public int numChildren() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_CHILDREN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group9"));
+
+ return ((GroupRetained)this.retained).numChildren();
+ }
+
+
+ /**
+ * Retrieves the index of the specified child node in
+ * this group node's list of children.
+ *
+ * @param child the child node to be looked up.
+ * @return the index of the specified child node;
+ * returns -1 if the object is not in the list.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int indexOfChild(Node child) {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_CHILDREN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group9"));
+
+ return ((GroupRetained)this.retained).indexOfChild(child);
+ }
+
+
+ /**
+ * Removes the specified child node from this group node's
+ * list of children.
+ * If the specified object is not in the list, the list is not modified.
+ *
+ * @param child the child node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live or compiled scene graph and the child node being removed is not
+ * a BranchGroup node
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeChild(Node child) {
+
+ if (isLiveOrCompiled()) {
+ if (!(child instanceof BranchGroup)) {
+ throw new RestrictedAccessException(J3dI18N.getString("Group7"));
+ }
+
+ if (!this.getCapability(ALLOW_CHILDREN_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Group15"));
+ }
+
+ if (!((BranchGroup)child).getCapability(BranchGroup.ALLOW_DETACH)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Group4"));
+ }
+ }
+
+ ((GroupRetained)retained).removeChild(child);
+ }
+
+
+ /**
+ * Removes all children from this Group node.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live or compiled scene graph and any of the children being removed are
+ * not BranchGroup nodes
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeAllChildren() {
+
+ if (isLiveOrCompiled()) {
+ GroupRetained groupR = (GroupRetained)this.retained;
+ for (int index = groupR.numChildren() - 1; index >= 0; index--) {
+ Node child = groupR.getChild(index);
+ if (! (child instanceof BranchGroup))
+ throw new RestrictedAccessException(J3dI18N.getString("Group7"));
+
+ if (!this.getCapability(ALLOW_CHILDREN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Group15"));
+
+ if (!((BranchGroup)child).getCapability(BranchGroup.ALLOW_DETACH)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Group4"));
+ }
+ }
+ }
+
+ ((GroupRetained)retained).removeAllChildren();
+ }
+
+
+ /**
+ * Causes this Group node to be reported as the collision target when
+ * collision is being used and this node or any of its children is in
+ * a collision. The default value is false. For collision with
+ * USE_GEOMETRY set, the collision traverser will check the geometry
+ * of all the Group node's leaf descendants; for collision with
+ * USE_BOUNDS set, the collision traverser will only check the bounds
+ * at this Group node. In both cases, if there is a collision, this
+ * Group node will be reported as the colliding object in the
+ * SceneGraphPath. This reporting is done regardless of whether
+ * ENABLE_COLLISION_REPORTING
+ * is set for this group node (setting alternate collision target to
+ * true implies collision reporting).
+ * @param target Indicates whether this Group node can be the target
+ * of a collision.
+ * @see WakeupOnCollisionEntry
+ * @see WakeupOnCollisionMovement
+ * @see WakeupOnCollisionExit
+ */
+ public void setAlternateCollisionTarget(boolean target) {
+ ((GroupRetained)this.retained).setAlternateCollisionTarget(target);
+ }
+
+ /**
+ * Returns the collision target state.
+ * @return Indicates whether this Group node can be the target of a
+ * collision.
+ */
+ public boolean getAlternateCollisionTarget() {
+ return ((GroupRetained)this.retained).getAlternateCollisionTarget();
+ }
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode and
+ * then cloneTree is called for each child node. For
+ * Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ *
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree
+ * flag to be ignored. When false, the value of each
+ * node's
+ * duplicateOnCloneTree determines whether data is
+ * duplicated or copied.
+ *
+ *
+ * @return a reference to the cloned scene graph.
+ *
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ Node cloneTree(boolean forceDuplicate, Hashtable nodeHashtable) {
+ Group g = (Group) super.cloneTree(forceDuplicate, nodeHashtable);
+ GroupRetained rt = (GroupRetained) retained;
+
+ int nChildren = rt.numChildren();
+ // call cloneTree on all child nodes
+ for (int i = 0; i < nChildren; i++) {
+ Node n = rt.getChild(i);
+ Node clonedN = n.cloneTree(forceDuplicate, nodeHashtable);
+ // add the cloned child to the cloned group node
+ ((GroupRetained) g.retained).addChild(clonedN);
+
+ }
+ return g;
+ }
+
+
+
+ /**
+ * Copies all Node information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ GroupRetained attr = (GroupRetained) originalNode.retained;
+ GroupRetained rt = (GroupRetained) retained;
+
+ rt.setCollisionBounds(attr.getCollisionBounds());
+ rt.setAlternateCollisionTarget(attr.getAlternateCollisionTarget());
+ // throw away any child create before, since some node such as
+ // Sphere has already created its own branch
+ // Without doing this, we may end up with two branches with exactly
+ // the same content when cloneTree() is invoked.
+ rt.children.clear();
+ }
+
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ Group g = new Group();
+ g.duplicateNode(this, forceDuplicate);
+ return g;
+ }
+
+
+ /**
+ * Constructs a Group node with default parameters. The default
+ * values are as follows:
+ *
+ * collision bounds : null
+ */
+ public Group() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/GroupRetained.java b/j3d-core/src/classes/share/javax/media/j3d/GroupRetained.java
new file mode 100644
index 0000000..b1bfb2d
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/GroupRetained.java
@@ -0,0 +1,3225 @@
+/*
+ * $RCSfile: GroupRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.16 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Vector;
+import java.util.Enumeration;
+import java.util.ArrayList;
+
+/**
+ * Group node.
+ */
+
+class GroupRetained extends NodeRetained implements BHLeafInterface {
+ /**
+ * The Group Node's children vector.
+ */
+ ArrayList children = new ArrayList(1);
+
+ /**
+ * The Group node's collision bounds in local coordinates.
+ */
+ Bounds collisionBound = null;
+
+ // The locale that this node is decended from
+ Locale locale = null;
+
+ // The list of lights that are scoped to this node
+ // One such arraylist per path. If not in sharedGroup
+ // then only index 0 is valid
+ ArrayList lights = null;
+
+ // The list of fogs that are scoped to this node
+ // One such arraylist per path. If not in sharedGroup
+ // then only index 0 is valid
+ ArrayList fogs = null;
+
+ // The list of model clips that are scoped to this node
+ // One such arraylist per path. If not in sharedGroup
+ // then only index 0 is valid
+ ArrayList modelClips = null;
+
+
+ // The list of alternateappearance that are scoped to this node
+ // One such arraylist per path. If not in sharedGroup
+ // then only index 0 is valid
+ ArrayList altAppearances = null;
+
+
+ // indicates whether this Group node can be the target of a collision
+ boolean collisionTarget = false;
+
+ // per child switchLinks
+ ArrayList childrenSwitchLinks = null;
+
+ // the immediate childIndex of a parentSwitchLink
+ int parentSwitchLinkChildIndex = -1;
+
+ // per shared path ordered path data
+ ArrayList orderedPaths = null;
+
+ /**
+ * If collisionBound is set, this is equal to the
+ * transformed collisionBounds, otherwise it is equal
+ * to the transformed localBounds.
+ * This variable is set to null unless collisionTarget = true.
+ * This bound is only used by mirror Group.
+ */
+ BoundingBox collisionVwcBounds;
+
+ /**
+ * Mirror group of this node, it is only used when
+ * collisionTarget = true. Otherwise it is set to null.
+ * If not in shared group,
+ * only entry 0 is used.
+ *
+ */
+ ArrayList mirrorGroup;
+
+ /**
+ * key of mirror GroupRetained.
+ */
+ HashKey key;
+
+ /**
+ * sourceNode of this mirror Group
+ */
+ GroupRetained sourceNode;
+
+ /**
+ * The BHLeafNode for this GeometryAtom.
+ */
+ BHLeafNode bhLeafNode = null;
+
+ //
+ // The following variables are used during compile
+ //
+
+ // true if this is the root of the scenegraph tree
+ boolean isRoot = false;
+
+ boolean allocatedLights = false;
+
+ boolean allocatedFogs = false;
+
+ boolean allocatedMclips = false;
+
+ boolean allocatedAltApps = false;
+
+ // > 0 if this group is being used in scoping
+ int scopingRefCount = 0;
+
+
+ ArrayList compiledChildrenList = null;
+
+ boolean isInClearLive = false;
+
+ // List of viewes scoped to this Group, for all subclasses
+ // of group, except ViewSpecificGroup its a pointer to closest
+ // ViewSpecificGroup parent
+ // viewList for this node, if inSharedGroup is
+ // false then only viewList(0) is valid
+ // For VSGs, this list is an intersection of
+ // higher level VSGs
+ ArrayList viewLists = null;
+
+ // True if this Node is descendent of ViewSpecificGroup;
+ boolean inViewSpecificGroup = false;
+
+ GroupRetained() {
+ this.nodeType = NodeRetained.GROUP;
+ // issue 544
+ if (VirtualUniverse.mc.useBoxForGroupBounds) {
+ localBounds = new BoundingBox((Bounds) null);
+ } else {
+ localBounds = new BoundingSphere();
+ ((BoundingSphere) localBounds).setRadius(-1.0);
+ }
+ }
+
+ /**
+ * Sets the collision bounds of a node.
+ * @param bounds the bounding object for the node
+ */
+ void setCollisionBounds(Bounds bounds) {
+ if (bounds == null) {
+ this.collisionBound = null;
+ } else {
+ this.collisionBound = (Bounds)bounds.clone();
+ }
+
+ if (source.isLive()) {
+ J3dMessage message = new J3dMessage();
+ message.type = J3dMessage.COLLISION_BOUND_CHANGED;
+ message.threads = J3dThread.UPDATE_TRANSFORM |
+ J3dThread.UPDATE_GEOMETRY;
+ message.universe = universe;
+ message.args[0] = this;
+ VirtualUniverse.mc.processMessage(message);
+ }
+
+ }
+
+
+ /**
+ * Gets the collision bounds of a node.
+ * @return the node's bounding object
+ */
+ Bounds getCollisionBounds() {
+ return (collisionBound == null ? null : (Bounds)collisionBound.clone());
+ }
+
+ /**
+ * Replaces the specified child with the child provided.
+ * @param child the new child
+ * @param index which child to replace
+ */
+ void setChild(Node child, int index) {
+
+ checkValidChild(child, "GroupRetained0");
+ if (this.source.isLive()) {
+ universe.resetWaitMCFlag();
+ synchronized (universe.sceneGraphLock) {
+ doSetChild(child, index);
+ universe.setLiveState.clear();
+ }
+ universe.waitForMC();
+
+ } else {
+ doSetChild(child, index);
+ if (universe != null) {
+ synchronized (universe.sceneGraphLock) {
+ universe.setLiveState.clear();
+ }
+ }
+ }
+ dirtyBoundsCache();
+ }
+
+ // The method that does the work once the lock is acquired.
+ void doSetChild(Node child, int index) {
+ NodeRetained oldchildr;
+ J3dMessage[] messages = null;
+ int numMessages = 0;
+ int attachStartIndex = 0;
+
+
+ // since we want to make sure the replacement of the child
+ // including removal of the oldChild and insertion of the newChild
+ // all happen in the same frame, we'll send all the necessary
+ // messages to masterControl for processing in one call.
+ // So let's first find out how many messages will be sent
+
+ oldchildr = (NodeRetained) children.get(index);
+
+ if (this.source.isLive()) {
+ if (oldchildr != null) {
+ numMessages+=3; // REMOVE_NODES, ORDERED_GROUP_REMOVED
+ // VIEWSPECIFICGROUP_CLEAR
+ attachStartIndex = 3;
+ }
+
+ if (child != null) {
+ numMessages+=4; // INSERT_NODES,BEHAVIOR_ACTIVATE,ORDERED_GROUP_INSERTED,
+ // VIEWSPECIFICGROUP_INIT
+ }
+
+ messages = new J3dMessage[numMessages];
+ for (int i = 0; i < numMessages; i++) {
+ messages[i] = new J3dMessage();
+ }
+ }
+
+ if(oldchildr != null) {
+ oldchildr.setParent(null);
+ checkClearLive(oldchildr, messages, 0, index, null);
+ if (this.source.isLive()) {
+ universe.notifyStructureChangeListeners(false, this.source, (BranchGroup)oldchildr.source);
+ }
+ }
+ removeChildrenData(index);
+
+ if(child == null) {
+ children.set(index, null);
+ if (messages != null) {
+ VirtualUniverse.mc.processMessage(messages);
+ }
+ return;
+ }
+
+ if (this.source.isLive()) {
+ universe.notifyStructureChangeListeners(true, this.source, (BranchGroup)child);
+ }
+ NodeRetained childr = (NodeRetained) child.retained;
+ childr.setParent(this);
+ children.set(index, childr);
+
+
+ insertChildrenData(index);
+ checkSetLive(childr, index, messages, attachStartIndex, null);
+ if (this.source.isLive()) {
+ ((BranchGroupRetained)childr).isNew = true;
+ }
+
+ if (messages != null) {
+ VirtualUniverse.mc.processMessage(messages);
+ }
+ }
+
+ /**
+ * Inserts the specified child at specified index.
+ * @param child the new child
+ * @param index position to insert new child at
+ */
+ void insertChild(Node child, int index) {
+
+ checkValidChild(child, "GroupRetained1");
+ if (this.source.isLive()) {
+ universe.resetWaitMCFlag();
+ synchronized (universe.sceneGraphLock) {
+ universe.notifyStructureChangeListeners(true, this.source, (BranchGroup)child);
+ doInsertChild(child, index);
+ universe.setLiveState.clear();
+ }
+ universe.waitForMC();
+ } else {
+ doInsertChild(child, index);
+ if (universe != null) {
+ synchronized (universe.sceneGraphLock) {
+ universe.setLiveState.clear();
+ }
+ }
+ }
+ dirtyBoundsCache();
+ }
+
+ // The method that does the work once the lock is acquired.
+ void doInsertChild(Node child, int index) {
+ int i;
+ NodeRetained childi;
+
+ insertChildrenData(index);
+ for (i=index; i
+ * alternate collision target : false
+ *
+ *
+ *
+ * @since Java 3D 1.3
+ */
+
+public class IllegalSceneGraphException extends RuntimeException {
+
+ /**
+ * Create the exception object with default values.
+ */
+ public IllegalSceneGraphException() {
+ }
+
+ /**
+ * Create the exception object that outputs message.
+ * @param str the message string to be output.
+ */
+ public IllegalSceneGraphException(String str) {
+ super(str);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IllegalSharingException.java b/j3d-core/src/classes/share/javax/media/j3d/IllegalSharingException.java
new file mode 100644
index 0000000..29fe941
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IllegalSharingException.java
@@ -0,0 +1,79 @@
+/*
+ * $RCSfile: IllegalSharingException.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Indicates an illegal attempt to share a scene graph object. For example,
+ * the following are illegal:
+ *
+ *
+ */
+public class IllegalSharingException extends IllegalSceneGraphException {
+
+ /**
+ * Create the exception object with default values.
+ */
+ public IllegalSharingException() {
+ }
+
+ /**
+ * Create the exception object that outputs message.
+ * @param str the message string to be output.
+ */
+ public IllegalSharingException(String str) {
+ super(str);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ImageComponent.java b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent.java
new file mode 100644
index 0000000..eacc8c5
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent.java
@@ -0,0 +1,439 @@
+/*
+ * $RCSfile: ImageComponent.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Abstract class that is used to define 2D or 3D ImageComponent
+ * classes used in a Java 3D scene graph. This is used for texture
+ * images, background images and raster components of Shape3D nodes.
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * byReference flag set to true.
+ * In this mode, a reference to the input data is saved, but the data
+ * itself is not necessarily copied (although it may be, depending on
+ * the value of the yUp flag, the format of the
+ * ImageComponent, and the format of the RenderedImage). Image data
+ * referenced by an ImageComponent object can only be modified via
+ * the updateData method.
+ * Applications must exercise care not to violate this rule. If any
+ * referenced RenderedImage is modified outside the updateData method
+ * after it has been passed
+ * to an ImageComponent object, the results are undefined.
+ * Another restriction in by-reference mode is that if the specified
+ * RenderedImage is not an instance of BufferedImage, then
+ * this ImageComponent cannot be used for readRaster or
+ * off-screen rendering operations, since these operations modify
+ * the ImageComponent data.
+ * yUp flag to true in conjunction
+ * with setting the byReference flag to true makes it
+ * possible for Java 3D to avoid copying the texture map in some
+ * cases.
+ *
+ * byteVariable = (byte) intValue; // intValue can be > 127
+ * If intValue is greater than 127, then byteVariable will be negative. The
+ * correct value will be extracted when it is used (by masking off the upper
+ * bits).
+ */
+
+public abstract class ImageComponent extends NodeComponent {
+ //
+ // Pixel format values
+ //
+
+ /**
+ * Specifies that each pixel contains 3 8-bit channels: one each
+ * for red, green, blue. Same as FORMAT_RGB8.
+ */
+ public static final int FORMAT_RGB = 1;
+
+ /**
+ * Specifies that each pixel contains 4 8-bit channels: one each
+ * for red, green, blue, alpha. Same as FORMAT_RGBA8.
+ */
+ public static final int FORMAT_RGBA = 2;
+
+ /**
+ * Specifies that each pixel contains 3 8-bit channels: one each
+ * for red, green, blue. Same as FORMAT_RGB.
+ */
+ public static final int FORMAT_RGB8 = FORMAT_RGB;
+
+ /**
+ * Specifies that each pixel contains 4 8-bit channels: one each
+ * for red, green, blue, alpha. Same as FORMAT_RGBA.
+ */
+ public static final int FORMAT_RGBA8 = FORMAT_RGBA;
+
+ /**
+ * Specifies that each pixel contains 3 5-bit channels: one each
+ * for red, green, blue.
+ */
+ public static final int FORMAT_RGB5 = 3;
+
+ /**
+ * Specifies that each pixel contains 3 5-bit channels: one each
+ * for red, green, blue and 1 1-bit channel for alpha.
+ */
+ public static final int FORMAT_RGB5_A1 = 4;
+
+ /**
+ * Specifies that each pixel contains 3 4-bit channels: one each
+ * for red, green, blue.
+ */
+ public static final int FORMAT_RGB4 = 5;
+
+ /**
+ * Specifies that each pixel contains 4 4-bit channels: one each
+ * for red, green, blue, alpha.
+ */
+ public static final int FORMAT_RGBA4 = 6;
+
+ /**
+ * Specifies that each pixel contains 2 4-bit channels: one each
+ * for luminance and alpha.
+ */
+ public static final int FORMAT_LUM4_ALPHA4 = 7;
+
+ /**
+ * Specifies that each pixel contains 2 8-bit channels: one each
+ * for luminance and alpha.
+ */
+ public static final int FORMAT_LUM8_ALPHA8 = 8;
+
+ /**
+ * Specifies that each pixel contains 2 3-bit channels: one each
+ * for red, green, and 1 2-bit channel for blue.
+ */
+ public static final int FORMAT_R3_G3_B2 = 9;
+
+ /**
+ * Specifies that each pixel contains 1 8-bit channel: it can be
+ * used for only luminance or only alpha or only intensity.
+ */
+ public static final int FORMAT_CHANNEL8 = 10;
+
+ // Internal variable for checking validity of formats
+ // Change this if any more formats are added or removed
+ static final int FORMAT_TOTAL = 10;
+
+
+ /**
+ * Used to specify the class of the image being wrapped.
+ *
+ * @since Java 3D 1.5
+ */
+ public enum ImageClass {
+ /**
+ * Indicates that this ImageComponent object wraps a BufferedImage
+ * object. This is the default state. Note that the image class will
+ * be BUFFERED_IMAGE following a call to set(RenderedImage image)
+ * if we are in by-copy mode, or if the image is an instance of
+ * BufferedImage.
+ */
+ BUFFERED_IMAGE,
+
+ /**
+ * Indicates that this ImageComponent object wraps a RenderedImage
+ * object that is not a BufferedImage. Note that the image class
+ * of an ImageComponent following a call to set(RenderedImage image)
+ * will be RENDERED_IMAGE, if and only if the image is not an instance
+ * of BufferedImage and the ImageComponent is in by-reference mode.
+ */
+ RENDERED_IMAGE,
+
+ /**
+ * Indicates that this ImageComponent object wraps an NioImageBuffer
+ * object. Note that an ImageComponent in this state must not be used
+ * as the off-screen buffer of a Canvas3D nor as the target of a
+ * readRaster operation.
+ */
+ NIO_IMAGE_BUFFER,
+ }
+
+
+ /**
+ * Specifies that this ImageComponent object allows reading its
+ * size component information (width, height, and depth).
+ */
+ public static final int
+ ALLOW_SIZE_READ = CapabilityBits.IMAGE_COMPONENT_ALLOW_SIZE_READ;
+
+ /**
+ * Specifies that this ImageComponent object allows reading its
+ * format component information.
+ */
+ public static final int
+ ALLOW_FORMAT_READ = CapabilityBits.IMAGE_COMPONENT_ALLOW_FORMAT_READ;
+
+ /**
+ * Specifies that this ImageComponent object allows reading its
+ * image component information.
+ */
+ public static final int
+ ALLOW_IMAGE_READ = CapabilityBits.IMAGE_COMPONENT_ALLOW_IMAGE_READ;
+
+ /**
+ * Specifies that this ImageComponent object allows writing its
+ * image component information.
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int
+ ALLOW_IMAGE_WRITE = CapabilityBits.IMAGE_COMPONENT_ALLOW_IMAGE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_SIZE_READ,
+ ALLOW_IMAGE_READ,
+ ALLOW_FORMAT_READ
+ };
+
+ /**
+ * Not a public constructor, for internal use
+ */
+ ImageComponent() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs an image component object using the specified format, width,
+ * and height. Default values are used for all other parameters. The
+ * default values are as follows:
+ *
+ * byReference : false
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA etc.
+ * @param width the number of columns of pixels in this image component
+ * object
+ * @param height the number of rows of pixels in this image component
+ * object
+ * @exception IllegalArgumentException if format is invalid, or if
+ * width or height are not positive.
+ */
+ public ImageComponent(int format, int width, int height) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ImageComponentRetained)this.retained).processParams(format, width, height, 1);
+ }
+
+ /**
+ * Constructs an image component object using the specified format, width,
+ * height, byReference flag, and yUp flag.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA etc.
+ * @param width the number of columns of pixels in this image component
+ * object
+ * @param height the number of rows of pixels in this image component
+ * object
+ * @param byReference a flag that indicates whether the data is copied
+ * into this image component object or is accessed by reference.
+ * @param yUp a flag that indicates the y-orientation of this image
+ * component. If yUp is set to true, the origin of the image is
+ * the lower left; otherwise, the origin of the image is the upper
+ * left.
+ * @exception IllegalArgumentException if format is invalid, or if
+ * width or height are not positive.
+ *
+ * @since Java 3D 1.2
+ */
+ public ImageComponent(int format,
+ int width,
+ int height,
+ boolean byReference,
+ boolean yUp) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ImageComponentRetained)this.retained).setYUp(yUp);
+ ((ImageComponentRetained)this.retained).setByReference(byReference);
+ ((ImageComponentRetained)this.retained).processParams(format, width, height, 1);
+ }
+
+ /**
+ * Retrieves the width of this image component object.
+ * @return the width of this image component object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getWidth() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SIZE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ImageComponent0"));
+ return ((ImageComponentRetained)this.retained).getWidth();
+ }
+
+ /**
+ * Retrieves the height of this image component object.
+ * @return the height of this image component object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getHeight() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SIZE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ImageComponent1"));
+ return ((ImageComponentRetained)this.retained).getHeight();
+ }
+
+ /**
+ * Retrieves the format of this image component object.
+ * @return the format of this image component object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getFormat() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_FORMAT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ImageComponent2"));
+ return ((ImageComponentRetained)this.retained).getFormat();
+ }
+
+
+ /**
+ * Retrieves the data access mode for this ImageComponent object.
+ *
+ * @return
+ * yUp : false
+ * true if the data access mode for this
+ * ImageComponent object is by-reference;
+ * false if the data access mode is by-copying.
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean isByReference() {
+ return ((ImageComponentRetained)this.retained).isByReference();
+ }
+
+
+ /**
+ * Sets the y-orientation of this ImageComponent object to
+ * y-up or y-down.
+ *
+ * @param yUp a flag that indicates the y-orientation of this image
+ * component. If yUp is set to true, the origin of the image is
+ * the lower left; otherwise, the origin of the image is the upper
+ * left.
+ *
+ * @exception RestrictedAccessException if the method is called
+ * when this object is part of live or compiled scene graph.
+ *
+ * @exception IllegalStateException if the image class of this object
+ * is ImageClass.NIO_IMAGE_BUFFER.
+ *
+ * @deprecated as of Java 3D 1.5, the yUp flag should only be set at object
+ * construction time.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setYUp(boolean yUp) {
+ checkForLiveOrCompiled();
+
+ // check for illegal image class
+ if (((ImageComponentRetained)this.retained).getImageClass() == ImageClass.NIO_IMAGE_BUFFER) {
+ throw new IllegalStateException("ImageComponent4");
+ }
+
+ ((ImageComponentRetained)this.retained).setYUp(yUp);
+ }
+
+
+ /**
+ * Retrieves the y-orientation for this ImageComponent object.
+ *
+ * @return true if the y-orientation of this
+ * ImageComponent object is y-up; false if the
+ * y-orientation of this ImageComponent object is y-down.
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean isYUp() {
+ return ((ImageComponentRetained)this.retained).isYUp();
+ }
+
+
+ /**
+ * Retrieves the image class of this ImageComponent object.
+ *
+ * @return the image class of this ImageComponent,
+ * one of: ImageClass.BUFFERED_IMAGE,
+ * ImageClass.RENDERED_IMAGE, or ImageClass.NIO_IMAGE_BUFFER.
+ *
+ * @since Java 3D 1.5
+ */
+ public ImageClass getImageClass() {
+ return ((ImageComponentRetained)this.retained).getImageClass();
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ImageComponent2D.java b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent2D.java
new file mode 100644
index 0000000..1203baa
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent2D.java
@@ -0,0 +1,745 @@
+/*
+ * $RCSfile: ImageComponent2D.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.10 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.image.BufferedImage;
+import java.awt.image.RenderedImage;
+import java.util.logging.Level;
+
+/**
+ * This class defines a 2D image component. This is used for texture
+ * images, background images and raster components of Shape3D nodes.
+ * Prior to Java 3D 1.2, only BufferedImage objects could be used as the
+ * input to an ImageComponent2D object. As of Java 3D 1.2, an
+ * ImageComponent2D accepts any RenderedImage object (BufferedImage is
+ * an implementation of the RenderedImage interface). The methods
+ * that set/get a BufferedImage object are left in for compatibility.
+ * The new methods that set/get a RenderedImage are a superset of the
+ * old methods. In particular, the two set methods in the following
+ * example are equivalent:
+ *
+ *
+ *
+ *
+ *
+ * BufferedImage bi;
+ *
+ * RenderedImage ri = bi;
+ * ImageComponent2D ic;
+ *
+ * ic.set(bi);
+ *
+ * ic.set(ri);
+ *
+ * image : null
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param width the number of columns of pixels in this image component
+ * object
+ * @param height the number of rows of pixels in this image component
+ * object
+ * @exception IllegalArgumentException if format is invalid, or if
+ * width or height are not positive.
+ */
+ public ImageComponent2D(int format,
+ int width,
+ int height) {
+
+ if (MasterControl.isDevLoggable(Level.FINER)) {
+ MasterControl.getDevLogger().finer("ImageComponent - using default of byCopy");
+ }
+ ((ImageComponent2DRetained)this.retained).processParams(format, width, height, 1);
+ }
+
+ /**
+ * Constructs a 2D image component object using the specified format
+ * and BufferedImage. A copy of the BufferedImage is made.
+ * The image class is set to ImageClass.BUFFERED_IMAGE.
+ * Default values are used for all other parameters.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param image the BufferedImage used to create this 2D image component.
+ * @exception IllegalArgumentException if format is invalid, or if
+ * the width or height of the image are not positive.
+ */
+ public ImageComponent2D(int format, BufferedImage image) {
+
+ if (MasterControl.isDevLoggable(Level.FINER)) {
+ MasterControl.getDevLogger().finer("ImageComponent - using default of byCopy");
+ }
+ ((ImageComponent2DRetained)this.retained).processParams(format, image.getWidth(), image.getHeight(), 1);
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Constructs a 2D image component object using the specified format
+ * and RenderedImage. A copy of the RenderedImage is made.
+ * The image class is set to ImageClass.BUFFERED_IMAGE.
+ * Default values are used for all other parameters.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param image the RenderedImage used to create this 2D image component
+ * @exception IllegalArgumentException if format is invalid, or if
+ * the width or height of the image are not positive.
+ *
+ * @since Java 3D 1.2
+ */
+ public ImageComponent2D(int format, RenderedImage image) {
+
+
+ if (MasterControl.isDevLoggable(Level.FINER)) {
+ MasterControl.getDevLogger().finer("ImageComponent - using default of byCopy");
+ }
+ ((ImageComponent2DRetained)this.retained).processParams(format, image.getWidth(), image.getHeight(), 1);
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Constructs a 2D image component object using the specified
+ * format, width, height, byReference flag, and yUp flag.
+ * Default values are used for all other parameters.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param width the number of columns of pixels in this image component
+ * object
+ * @param height the number of rows of pixels in this image component
+ * object
+ * @param byReference a flag that indicates whether the data is copied
+ * into this image component object or is accessed by reference.
+ * @param yUp a flag that indicates the y-orientation of this image
+ * component. If yUp is set to true, the origin of the image is
+ * the lower left; otherwise, the origin of the image is the upper
+ * left.
+ * @exception IllegalArgumentException if format is invalid, or if
+ * width or height are not positive.
+ *
+ * @since Java 3D 1.2
+ */
+ public ImageComponent2D(int format,
+ int width,
+ int height,
+ boolean byReference,
+ boolean yUp) {
+
+ if (MasterControl.isDevLoggable(Level.INFO)) {
+ if (byReference && !yUp) {
+ MasterControl.getDevLogger().info("ImageComponent - yUp should " +
+ "be set when using byReference, " +
+ "otherwise an extra copy of the image will be created");
+ }
+ }
+
+ ((ImageComponentRetained)this.retained).setByReference(byReference);
+ ((ImageComponentRetained)this.retained).setYUp(yUp);
+ ((ImageComponent2DRetained)this.retained).processParams(format, width, height, 1);
+ }
+
+ /**
+ * Constructs a 2D image component object using the specified format,
+ * BufferedImage, byReference flag, and yUp flag.
+ * The image class is set to ImageClass.BUFFERED_IMAGE.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param image the BufferedImage used to create this 2D image component
+ * @param byReference a flag that indicates whether the data is copied
+ * into this image component object or is accessed by reference
+ * @param yUp a flag that indicates the y-orientation of this image
+ * component. If yUp is set to true, the origin of the image is
+ * the lower left; otherwise, the origin of the image is the upper
+ * left.
+ * @exception IllegalArgumentException if format is invalid, or if
+ * the width or height of the image are not positive.
+ *
+ * @since Java 3D 1.2
+ */
+ public ImageComponent2D(int format,
+ BufferedImage image,
+ boolean byReference,
+ boolean yUp) {
+
+ if (MasterControl.isDevLoggable(Level.INFO)) {
+ if (byReference && !yUp) {
+ MasterControl.getDevLogger().info("ImageComponent - yUp should " +
+ "be set when using byReference, " +
+ "otherwise an extra copy of the image will be created");
+ }
+ }
+
+ ((ImageComponentRetained)this.retained).setByReference(byReference);
+ ((ImageComponentRetained)this.retained).setYUp(yUp);
+ ((ImageComponent2DRetained)this.retained).processParams(format, image.getWidth(), image.getHeight(), 1);
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Constructs a 2D image component object using the specified format,
+ * RenderedImage, byReference flag, and yUp flag.
+ * The image class is set to ImageClass.RENDERED_IMAGE if the byReferece
+ * flag is true and the specified RenderedImage is not an instance
+ * of BufferedImage. In all other cases, the image class is set to
+ * ImageClass.BUFFERED_IMAGE.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param image the RenderedImage used to create this 2D image component
+ * @param byReference a flag that indicates whether the data is copied
+ * into this image component object or is accessed by reference.
+ * @param yUp a flag that indicates the y-orientation of this image
+ * component. If yUp is set to true, the origin of the image is
+ * the lower left; otherwise, the origin of the image is the upper
+ * left.
+ * @exception IllegalArgumentException if format is invalid, or if
+ * the width or height of the image are not positive.
+ *
+ * @since Java 3D 1.2
+ */
+ public ImageComponent2D(int format,
+ RenderedImage image,
+ boolean byReference,
+ boolean yUp) {
+
+ if (MasterControl.isDevLoggable(Level.INFO)) {
+ if (byReference && !yUp)
+ MasterControl.getDevLogger().info("ImageComponent - yUp should " +
+ "be set when using byReference, " +
+ "otherwise an extra copy of the image will be created");
+ }
+ ((ImageComponentRetained)this.retained).setByReference(byReference);
+ ((ImageComponentRetained)this.retained).setYUp(yUp);
+ ((ImageComponent2DRetained)this.retained).processParams(format, image.getWidth(), image.getHeight(), 1);
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Constructs a 2D image component object using the specified format,
+ * NioImageBuffer, byReference flag, and yUp flag.
+ * The image class is set to ImageClass.NIO_IMAGE_BUFFER.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param image the NioImageBuffer used to create this 2D image component
+ * @param byReference a flag that indicates whether the data is copied
+ * into this image component object or is accessed by reference.
+ * @param yUp a flag that indicates the y-orientation of this image
+ * component. If yUp is set to true, the origin of the image is
+ * the lower left; otherwise, the origin of the image is the upper
+ * left.
+ *
+ * @exception IllegalArgumentException if format is invalid, or if
+ * the width or height of the image are not positive.
+ *
+ * @exception IllegalArgumentException if the byReference flag is false.
+ *
+ * @exception IllegalArgumentException if the yUp flag is false.
+ *
+ * @exception IllegalArgumentException if the number of components in format
+ * does not match the number of components in image.
+ *
+ * @since Java 3D 1.5
+ */
+ public ImageComponent2D(int format,
+ NioImageBuffer image,
+ boolean byReference,
+ boolean yUp) {
+
+ ((ImageComponentRetained)this.retained).setByReference(byReference);
+ ((ImageComponentRetained)this.retained).setYUp(yUp);
+ ((ImageComponent2DRetained)this.retained).processParams(format, image.getWidth(), image.getHeight(), 1);
+ ((ImageComponent2DRetained)this.retained).set(image);
+ }
+
+ /**
+ * Sets this image component to the specified BufferedImage
+ * object.
+ * If the data access mode is not by-reference, then the
+ * BufferedImage data is copied into this object. If
+ * the data access mode is by-reference, then a reference to the
+ * BufferedImage is saved, but the data is not necessarily
+ * copied.
+ *
+ * imageClass : ImageClass.BUFFERED_IMAGE
+ * BY_REFERENCE.
+ *
+ * @exception IllegalArgumentException if width or
+ * height of
+ * the subregion exceeds the dimension of the image of this object.
+ *
+ * @exception IllegalArgumentException if dstX < 0, or
+ * (dstX + width) > width of this object, or
+ * dstY < 0, or
+ * (dstY + height) > height of this object.
+ *
+ * @exception IllegalArgumentException if srcX < 0, or
+ * (srcX + width) > width of the RenderedImage
+ * object containing the subimage, or
+ * srcY < 0, or
+ * (srcY + height) > height of the
+ * RenderedImage object containing the subimage.
+ *
+ * @exception IllegalArgumentException if the specified RenderedImage
+ * is not compatible with the existing RenderedImage.
+ *
+ * @exception IllegalStateException if the image class is not one of:
+ * ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setSubImage(RenderedImage image, int width, int height,
+ int srcX, int srcY, int dstX, int dstY) {
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_IMAGE_WRITE)) {
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("ImageComponent2D1"));
+ }
+
+ if (((ImageComponent2DRetained)this.retained).isByReference()) {
+ throw new IllegalStateException(
+ J3dI18N.getString("ImageComponent2D4"));
+ }
+
+ int w = ((ImageComponent2DRetained)this.retained).getWidth();
+ int h = ((ImageComponent2DRetained)this.retained).getHeight();
+
+ // Fix to issue 492
+ if ((srcX < 0) || (srcY < 0) ||
+ ((srcX + width) > image.getWidth()) || ((srcY + height) > image.getHeight()) ||
+ (dstX < 0) || (dstY < 0) ||
+ ((dstX + width) > w) || ((dstY + height) > h)) {
+ throw new IllegalArgumentException(
+ J3dI18N.getString("ImageComponent2D3"));
+ }
+
+ ((ImageComponent2DRetained)this.retained).setSubImage(
+ image, width, height, srcX, srcY, dstX, dstY);
+ }
+
+ /**
+ * Updates image data that is accessed by reference.
+ * This method calls the updateData method of the specified
+ * ImageComponent2D.Updater object to synchronize updates to the
+ * image data that is referenced by this ImageComponent2D object.
+ * Applications that wish to modify such data must perform all
+ * updates via this method.
+ * BY_COPY.
+ * @exception IllegalArgumentException if width or
+ * height of
+ * the subregion exceeds the dimension of the image of this object.
+ * @exception IllegalArgumentException if x < 0, or
+ * (x + width) > width of this object, or
+ * y < 0, or
+ * (y + height) > height of this object.
+ *
+ * @since Java 3D 1.3
+ */
+ public void updateData(Updater updater,
+ int x, int y,
+ int width, int height) {
+
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_IMAGE_WRITE)) {
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("ImageComponent2D1"));
+ }
+
+ if (!((ImageComponent2DRetained)this.retained).isByReference()) {
+ throw new IllegalStateException(
+ J3dI18N.getString("ImageComponent2D2"));
+ }
+
+ int w = ((ImageComponent2DRetained)this.retained).getWidth();
+ int h = ((ImageComponent2DRetained)this.retained).getHeight();
+
+ if ((x < 0) || (y < 0) || ((x + width) > w) || ((y + height) > h)) {
+ throw new IllegalArgumentException(
+ J3dI18N.getString("ImageComponent2D3"));
+ }
+
+ ((ImageComponent2DRetained)this.retained).updateData(
+ updater, x, y, width, height);
+ }
+
+ /**
+ * Creates a retained mode ImageComponent2DRetained object that this
+ * ImageComponent2D component object will point to.
+ */
+ void createRetained() {
+ this.retained = new ImageComponent2DRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ ImageComponent2DRetained rt = (ImageComponent2DRetained) retained;
+
+ ImageComponent2D img = new ImageComponent2D(rt.getFormat(),
+ rt.width,
+ rt.height,
+ rt.byReference,
+ rt.yUp);
+ img.duplicateNodeComponent(this);
+ return img;
+ }
+
+
+ /**
+ * Copies all node information from originalNodeComponent
+ * into the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+
+ ImageComponent.ImageClass imageClass =
+ ((ImageComponentRetained)originalNodeComponent.retained).getImageClass();
+ if(imageClass == ImageComponent.ImageClass.NIO_IMAGE_BUFFER) {
+ NioImageBuffer nioImg = ((ImageComponent2DRetained)
+ originalNodeComponent.retained).getNioImage();
+
+ if(nioImg != null) {
+ ((ImageComponent2DRetained) retained).set(nioImg);
+ }
+ } else {
+ RenderedImage img = ((ImageComponent2DRetained)
+ originalNodeComponent.retained).getImage();
+
+ if (img != null) {
+ ((ImageComponent2DRetained) retained).set(img);
+ }
+ }
+ }
+
+ /**
+ * The ImageComponent2D.Updater interface is used in updating image data
+ * that is accessed by reference from a live or compiled ImageComponent
+ * object. Applications that wish to modify such data must define a
+ * class that implements this interface. An instance of that class is
+ * then passed to the updateData method of the
+ * ImageComponent object to be modified.
+ *
+ * @since Java 3D 1.3
+ */
+ public static interface Updater {
+ /**
+ * Updates image data that is accessed by reference.
+ * This method is called by the updateData method of an
+ * ImageComponent object to effect
+ * safe updates to image data that
+ * is referenced by that object. Applications that wish to modify
+ * such data must implement this method and perform all updates
+ * within it.
+ *
+ * NOTE: Applications should not call this method directly.
+ *
+ * @param imageComponent the ImageComponent object being updated.
+ * @param x starting X offset of the subregion.
+ * @param y starting Y offset of the subregion.
+ * @param width width of the subregion.
+ * @param height height of the subregion.
+ *
+ * @see ImageComponent2D#updateData
+ */
+ public void updateData(ImageComponent2D imageComponent,
+ int x, int y,
+ int width, int height);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ImageComponent2DRetained.java b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent2DRetained.java
new file mode 100644
index 0000000..fad9dba
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent2DRetained.java
@@ -0,0 +1,341 @@
+/*
+ * $RCSfile: ImageComponent2DRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.10 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.image.*;
+import java.awt.color.ColorSpace;
+
+/**
+ * This class defines a 2D image component.
+ * This is used for texture images, background images and raster components
+ * of Shape3D nodes.
+ */
+
+class ImageComponent2DRetained extends ImageComponentRetained {
+
+ ImageComponent2DRetained() {
+ }
+
+ /**
+ * This method handles NioImageBuffer
+ * Refers or copies the specified NioImageBuffer to this 2D image component object.
+ * @param image NioImageBuffer object containing the image.
+ * The format and size must be the same as the current format in this
+ * ImageComponent2D object.
+ */
+ void set(NioImageBuffer image) {
+
+ int width = image.getWidth();
+ int height = image.getHeight();
+
+ if (!byReference) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent2D7"));
+ }
+ if (!yUp) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent2D8"));
+ }
+
+ if (width != this.width) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent2DRetained0"));
+ }
+ if (height != this.height) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent2DRetained1"));
+ }
+
+ geomLock.getLock();
+
+ setImageClass(image);
+
+ // This is a byRef image.
+ setRefImage(image,0);
+
+ // Reset this flag to true, incase it was set to false due to
+ // the previous image type.
+ abgrSupported = true;
+
+ imageTypeIsSupported = isImageTypeSupported(image);
+
+ if (imageTypeIsSupported) {
+
+ /* Use reference when ( format is OK, Yup is true, and byRef is true). */
+ // Create image data object with the byRef image. */
+ imageData = createNioImageBufferDataObject(image);
+
+ } else {
+ // Handle abgrSupported is false case.
+ imageData = createNioImageBufferDataObject(null);
+ copyUnsupportedNioImageToImageData(image, 0, 0, 0, 0, width, height, imageData);
+
+ }
+
+ geomLock.unLock();
+
+ if (source.isLive()) {
+ // send a IMAGE_CHANGED message in order to
+ // notify all the users of the change
+ sendMessage(IMAGE_CHANGED, null);
+ }
+ }
+
+ /**
+ * This method handles both BufferedImage and RenderedImage
+ * Copies the specified RenderedImage to this 2D image component object.
+ * @param image RenderedImage object containing the image.
+ * The format and size must be the same as the current format in this
+ * ImageComponent2D object.
+ */
+ void set(RenderedImage image) {
+
+ int width = image.getWidth();
+ int height = image.getHeight();
+
+ if (width != this.width) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent2DRetained0"));
+ }
+ if (height != this.height) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent2DRetained1"));
+ }
+
+ setImageClass(image);
+
+ geomLock.getLock();
+
+ if (byReference) {
+ setRefImage(image,0);
+ }
+
+ // Reset this flag to true, incase it was set to false due to
+ // the previous image type.
+ abgrSupported = true;
+
+ imageTypeIsSupported = isImageTypeSupported(image);
+
+ if (imageTypeIsSupported) {
+
+ if (byReference && yUp) {
+ /* Use reference when ( format is OK, Yup is true, and byRef is true). */
+ // System.err.println("ImageComponent2DRetained.set() : (imageTypeSupported && byReference && yUp) --- (1)");
+ if (image instanceof BufferedImage) {
+ // Create image data object with the byRef image. */
+ imageData = createRenderedImageDataObject(image);
+ }
+ else {
+ // System.err.println("byRef and not BufferedImage !!!");
+ imageData = null;
+ }
+
+ } else {
+ // Either not byRef or not yUp or not both
+ // System.err.println("ImageComponent2DRetained.set() : (imageTypeSupported && ((!byReference && yUp) || (imageTypeSupported && !yUp)) --- (2)");
+
+ // Create image data object with buffer for image. */
+ imageData = createRenderedImageDataObject(null);
+ copySupportedImageToImageData(image, 0, imageData);
+ }
+
+ } else {
+ // image type is unsupported, need to create a supported local copy.
+ // TODO : borrow code from JAI to convert to right format.
+ // System.err.println("ImageComponent2DRetained.set() : (imageTypeSupported == false) --- (4)");
+ /* Will use the code segment in copy() method */
+
+ // Create image data object with buffer for image. */
+ imageData = createRenderedImageDataObject(null);
+ copyUnsupportedImageToImageData(image, 0, imageData);
+
+ }
+
+ geomLock.unLock();
+
+ if (source.isLive()) {
+ // send a IMAGE_CHANGED message in order to
+ // notify all the users of the change
+ sendMessage(IMAGE_CHANGED, null);
+ }
+ }
+
+ void setSubImage(RenderedImage image, int width, int height,
+ int srcX, int srcY, int dstX, int dstY) {
+
+ if (!isSubImageTypeEqual(image)) {
+ throw new IllegalStateException(
+ J3dI18N.getString("ImageComponent2D6"));
+ }
+
+ // Can't be byReference
+ assert (!byReference);
+ assert (imageData != null);
+
+ geomLock.getLock();
+
+ if (imageTypeIsSupported) {
+ // Either not byRef or not yUp or not both
+ // System.err.println("ImageComponent2DRetained.setSubImage() : (imageTypeSupported ) --- (1)");
+ if (image instanceof BufferedImage) {
+ copyImageLineByLine((BufferedImage)image, srcX, srcY, dstX, dstY, 0, width, height, imageData);
+ }
+ else {
+ copySupportedImageToImageData(image, srcX, srcY, dstX, dstY, 0, width, height, imageData);
+ }
+ } else {
+ // image type is unsupported, need to create a supported local copy.
+ // TODO : Should look into borrow code from JAI to convert to right format.
+ // System.err.println("ImageComponent2DRetained.setSubImage() : (imageTypeSupported == false) --- (2)");
+ if (image instanceof BufferedImage) {
+ copyUnsupportedImageToImageData((BufferedImage)image, srcX, srcY, dstX, dstY, 0, width, height, imageData);
+ }
+ else {
+ copyUnsupportedImageToImageData(image, srcX, srcY, dstX, dstY, 0, width, height, imageData);
+ }
+ }
+ geomLock.unLock();
+
+ if (source.isLive()) {
+
+ // send a SUBIMAGE_CHANGED message in order to
+ // notify all the users of the change
+
+ ImageComponentUpdateInfo info;
+
+ info = new ImageComponentUpdateInfo();
+ info.x = dstX;
+ info.y = dstY;
+ info.z = 0;
+ info.width = width;
+ info.height = height;
+
+ sendMessage(SUBIMAGE_CHANGED, info);
+ }
+ }
+
+ /**
+ * Retrieves a copy of the image in this ImageComponent2D object.
+ * @return a new RenderedImage object created from the image in this
+ * ImageComponent2D object
+ */
+ RenderedImage getImage() {
+
+ if (isByReference()) {
+ return (RenderedImage) getRefImage(0);
+ }
+
+ if(imageData != null) {
+ return imageData.createBufferedImage(0);
+ }
+
+ return null;
+ }
+
+ /**
+ * Retrieves the reference of the nio image in this ImageComponent2D object.
+ */
+ NioImageBuffer getNioImage() {
+
+ if (getImageClass() != ImageComponent.ImageClass.NIO_IMAGE_BUFFER) {
+ throw new IllegalStateException(J3dI18N.getString("ImageComponent2D9"));
+ }
+
+ assert (byReference == true);
+
+ return (NioImageBuffer) getRefImage(0);
+ }
+
+ /**
+ * Update data.
+ * x and y specifies the x & y offset of the image data in
+ * ImageComponent. It assumes that the origin is (0, 0).
+ */
+ void updateData(ImageComponent2D.Updater updater,
+ int x, int y, int width, int height) {
+
+ geomLock.getLock();
+ // call the user supplied updateData method to update the data
+ updater.updateData((ImageComponent2D)source, x, y, width, height);
+
+ Object refImage = getRefImage(0);
+ assert (refImage != null);
+ assert (imageData != null);
+
+ // Check is data copied internally.
+ if(!imageData.isDataByRef()) {
+ // update the internal copy of the image data if a copy has been
+ // made
+ if (imageTypeIsSupported) {
+ assert !(refImage instanceof NioImageBuffer);
+
+ if (refImage instanceof BufferedImage) {
+ copyImageLineByLine((BufferedImage)refImage, x, y, x, y, 0, width, height, imageData);
+ } else {
+ RenderedImage ri = (RenderedImage)refImage;
+ copySupportedImageToImageData(ri, (x + ri.getMinX()), (y + ri.getMinY()), x, y, 0, width, height, imageData);
+ }
+ } else {
+ // image type is unsupported, need to create a supported local copy.
+ // TODO : Should look into borrow code from JAI to convert to right format.
+ if (refImage instanceof BufferedImage) {
+ copyUnsupportedImageToImageData((BufferedImage)refImage, x, y, x, y, 0, width, height, imageData);
+ } else if (refImage instanceof RenderedImage) {
+ RenderedImage ri = (RenderedImage)refImage;
+ copyUnsupportedImageToImageData(ri, (x + ri.getMinX()), (y + ri.getMinY()), x, y, 0, width, height, imageData);
+ } else if (refImage instanceof NioImageBuffer) {
+ copyUnsupportedNioImageToImageData((NioImageBuffer)refImage, x, y, x, y, width, height, imageData);
+ } else {
+ assert false;
+ }
+ }
+ }
+ geomLock.unLock();
+
+
+ if (source.isLive()) {
+
+ // send a SUBIMAGE_CHANGED message in order to
+ // notify all the users of the change
+
+ ImageComponentUpdateInfo info;
+
+ info = new ImageComponentUpdateInfo();
+ info.x = x;
+ info.y = y;
+ info.z = 0;
+ info.width = width;
+ info.height = height;
+
+ sendMessage(SUBIMAGE_CHANGED, info);
+ }
+ }
+
+ void clearLive(int refCount) {
+ super.clearLive(refCount);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ImageComponent3D.java b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent3D.java
new file mode 100644
index 0000000..78f73b2
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent3D.java
@@ -0,0 +1,981 @@
+/*
+ * $RCSfile: ImageComponent3D.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.image.BufferedImage;
+import java.awt.image.RenderedImage;
+
+/**
+ * This class defines a 3D image component. This is used for texture
+ * images.
+ * Prior to Java 3D 1.2, only BufferedImage objects could be used as
+ * the input to an ImageComponent3D object. As of Java 3D 1.2, an
+ * ImageComponent3D accepts an array of arbitrary RenderedImage
+ * objects (BufferedImage is an implementation of the RenderedImage
+ * interface). The methods that set/get a BufferedImage object are
+ * left in for compatibility. The new methods that set/get a
+ * RenderedImage are a superset of the old methods. In particular,
+ * the two set methods in the following example are equivalent:
+ *
+ *
+ *
+ *
+ */
+public class ImageComponent3D extends ImageComponent {
+
+ // non-public, no parameter constructor
+ ImageComponent3D() {}
+
+ /**
+ * Constructs a 3D image component object using the specified
+ * format, width, height, and depth. Default values are used for
+ * all other parameters. The default values are as follows:
+ *
+ * BufferedImage bi;
+ *
+ * RenderedImage ri = bi;
+ * ImageComponent3D ic;
+ *
+ * ic.set(0, bi);
+ *
+ * ic.set(0, ri);
+ *
+ * array of images : null
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA, etc.
+ * @param width the number of columns of pixels in this image component
+ * object
+ * @param height the number of rows of pixels in this image component
+ * object
+ * @param depth the number of 2D slices in this image component object
+ * @exception IllegalArgumentException if format is invalid, or if
+ * any of width, height, or depth are not positive.
+ */
+ public ImageComponent3D(int format,
+ int width,
+ int height,
+ int depth) {
+
+ ((ImageComponent3DRetained)this.retained).processParams(format, width, height, depth);
+ }
+
+ /**
+ * Constructs a 3D image component object using the specified format,
+ * and the BufferedImage array.
+ * The image class is set to ImageClass.BUFFERED_IMAGE.
+ * Default values are used for all other parameters.
+ *
+ * @param format the image component format, one of: FORMAT_RGB,
+ * FORMAT_RGBA etc.
+ * @param images an array of BufferedImage objects. The
+ * first image in the array determines the width and height of this
+ * ImageComponent3D.
+ *
+ * @exception IllegalArgumentException if format is invalid, or if
+ * the width or height of the first image are not positive.
+ */
+ public ImageComponent3D(int format, BufferedImage[] images) {
+ ((ImageComponent3DRetained)this.retained).processParams(format,
+ images[0].getWidth(null), images[0].getHeight(null), images.length);
+ for (int i=0; i
+ * imageClass : ImageClass.BUFFERED_IMAGE
+ * width or
+ * height of
+ * the subregion exceeds the dimension of the image in this object.
+ *
+ * @exception IllegalArgumentException if dstX < 0, or
+ * (dstX + width) > width of this object, or
+ * dstY < 0, or
+ * (dstY + height) > height of this object.
+ *
+ * @exception IllegalArgumentException if srcX < 0, or
+ * (srcX + width) > width of the RenderedImage
+ * object containing the subimage, or
+ * srcY < 0, or
+ * (srcY + height) > height of the
+ * RenderedImage object containing the subimage.
+ *
+ * @exception IllegalArgumentException if the specified RenderedImage
+ * is not compatible with the existing RenderedImage.
+ *
+ * @exception IllegalStateException if the image class is not one of:
+ * ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.
+ *
+ * @since Java 3D 1.3
+ */
+ public void setSubImage(int index, RenderedImage image,
+ int width, int height,
+ int srcX, int srcY, int dstX, int dstY) {
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_IMAGE_WRITE)) {
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("ImageComponent3D5"));
+ }
+
+ if (((ImageComponent3DRetained)this.retained).isByReference()) {
+ throw new IllegalStateException(
+ J3dI18N.getString("ImageComponent3D8"));
+ }
+
+ int w = ((ImageComponent3DRetained)this.retained).getWidth();
+ int h = ((ImageComponent3DRetained)this.retained).getHeight();
+
+ if ((srcX < 0) || (srcY < 0) ||
+ ((srcX + width) > w) || ((srcY + height) > h) ||
+ (dstX < 0) || (dstY < 0) ||
+ ((dstX + width) > w) || ((dstY + height) > h)) {
+ throw new IllegalArgumentException(
+ J3dI18N.getString("ImageComponent3D7"));
+ }
+
+ ((ImageComponent3DRetained)this.retained).setSubImage(
+ index, image, width, height, srcX, srcY, dstX, dstY);
+ }
+
+ /**
+ * Updates a particular slice of image data that is accessed by reference.
+ * This method calls the updateData method of the specified
+ * ImageComponent3D.Updater object to synchronize updates to the
+ * image data that is referenced by this ImageComponent3D object.
+ * Applications that wish to modify such data must perform all
+ * updates via this method.
+ * BY_COPY.
+ * @exception IllegalArgumentException if width or
+ * height of
+ * the subregion exceeds the dimension of the image in this object.
+ * @exception IllegalArgumentException if x < 0, or
+ * (x + width) > width of this object, or
+ * y < 0, or
+ * (y + height) > height of this object.
+ * @exception ArrayIndexOutOfBoundsException if index > the
+ * depth of this object.
+ *
+ * @since Java 3D 1.3
+ */
+ public void updateData(Updater updater, int index,
+ int x, int y,
+ int width, int height) {
+ if (isLiveOrCompiled() &&
+ !this.getCapability(ALLOW_IMAGE_WRITE)) {
+ throw new CapabilityNotSetException(
+ J3dI18N.getString("ImageComponent3D5"));
+ }
+
+ if (!((ImageComponent3DRetained)this.retained).isByReference()) {
+ throw new IllegalStateException(
+ J3dI18N.getString("ImageComponent3D6"));
+ }
+
+ int w = ((ImageComponent3DRetained)this.retained).getWidth();
+ int h = ((ImageComponent3DRetained)this.retained).getHeight();
+
+ if ((x < 0) || (y < 0) || ((x + width) > w) || ((y + height) > h)) {
+ throw new IllegalArgumentException(
+ J3dI18N.getString("ImageComponent3D7"));
+ }
+
+ ((ImageComponent3DRetained)this.retained).updateData(
+ updater, index, x, y, width, height);
+ }
+
+
+ /**
+ * Creates a retained mode ImageComponent3DRetained object that this
+ * ImageComponent3D component object will point to.
+ */
+ void createRetained() {
+ this.retained = new ImageComponent3DRetained();
+ this.retained.setSource(this);
+ }
+
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ ImageComponent3DRetained rt = (ImageComponent3DRetained) retained;
+
+ ImageComponent3D img = new ImageComponent3D(rt.getFormat(),
+ rt.width,
+ rt.height,
+ rt.depth);
+
+ // XXXX : replace by this to duplicate other attributes
+ /*
+ ImageComponent3D img = new ImageComponent3D(rt.format,
+ rt.width,
+ rt.height,
+ rt.depth,
+ rt.byReference,
+ rt.yUp);
+ */
+ img.duplicateNodeComponent(this);
+ return img;
+ }
+
+
+ /**
+ * Copies all node information from originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+ // TODO : Handle NioImageBuffer if its supported.
+ RenderedImage imgs[] = ((ImageComponent3DRetained)
+ originalNodeComponent.retained).getImage();
+
+ if (imgs != null) {
+ ImageComponent3DRetained rt = (ImageComponent3DRetained) retained;
+
+ for (int i=rt.depth-1; i>=0; i--) {
+ if (imgs[i] != null) {
+ rt.set(i, imgs[i]);
+ }
+ }
+ }
+ }
+
+ /**
+ * The ImageComponent3D.Updater interface is used in updating image data
+ * that is accessed by reference from a live or compiled ImageComponent
+ * object. Applications that wish to modify such data must define a
+ * class that implements this interface. An instance of that class is
+ * then passed to the updateData method of the
+ * ImageComponent object to be modified.
+ *
+ * @since Java 3D 1.3
+ */
+ public static interface Updater {
+ /**
+ * Updates image data that is accessed by reference.
+ * This method is called by the updateData method of an
+ * ImageComponent object to effect
+ * safe updates to image data that
+ * is referenced by that object. Applications that wish to modify
+ * such data must implement this method and perform all updates
+ * within it.
+ *
+ * NOTE: Applications should not call this method directly.
+ *
+ * @param imageComponent the ImageComponent object being updated.
+ * @param index index of the image to be modified.
+ * @param x starting X offset of the subregion.
+ * @param y starting Y offset of the subregion.
+ * @param width width of the subregion.
+ * @param height height of the subregion.
+ *
+ * @see ImageComponent3D#updateData
+ */
+ public void updateData(ImageComponent3D imageComponent,
+ int index,
+ int x, int y,
+ int width, int height);
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ImageComponent3DRetained.java b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent3DRetained.java
new file mode 100644
index 0000000..057bd66
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ImageComponent3DRetained.java
@@ -0,0 +1,384 @@
+/*
+ * $RCSfile: ImageComponent3DRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.10 $
+ * $Date: 2008/02/28 20:17:23 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.image.*;
+
+/**
+ * This class defines a 3D array of pixels.
+ * This is used for texture images.
+ */
+
+class ImageComponent3DRetained extends ImageComponentRetained {
+
+ void setDepth(int depth) {
+ this.depth = depth;
+ }
+
+ /**
+ * Retrieves the depth of this 3D image component object.
+ * @return the format of this 3D image component object
+ */
+ int getDepth() {
+ return depth;
+ }
+
+ /**
+ * Copies the specified BufferedImage to this 3D image component
+ * object at the specified index.
+ * @param index the image index
+ * @param images BufferedImage object containing the image.
+ * The format and size must be the same as the current format in this
+ * ImageComponent3D object. The index must not exceed the depth of this
+ * ImageComponent3D object.
+ */
+ void set(int index, BufferedImage image) {
+
+ geomLock.getLock();
+
+ if(byReference) {
+ // Fix to issue 488.
+ setRefImage(image, index);
+ }
+
+ if(imageData == null) {
+ // Only do this once, on the first image
+ // Reset this flag to true, incase it was set to false due to
+ // the previous image type.
+ abgrSupported = true;
+ imageTypeIsSupported = isImageTypeSupported(image);
+ imageData = createRenderedImageDataObject(null);
+ }
+ else {
+ if(getImageType() != evaluateImageType(image)) {
+ // TODO need to throw illegal state exception
+ }
+ }
+
+ if (imageTypeIsSupported) {
+ copySupportedImageToImageData(image, index, imageData);
+ } else {
+ // image type is unsupported, need to create a supported local copy.
+ // TODO : borrow code from JAI to convert to right format.
+ copyUnsupportedImageToImageData(image, index, imageData);
+
+ }
+
+ geomLock.unLock();
+
+ if (source.isLive()) {
+ // send a IMAGE_CHANGED message in order to
+ // notify all the users of the change
+ sendMessage(IMAGE_CHANGED, null);
+ }
+ }
+
+ /**
+ * Copies the specified BufferedImage to this 3D image component
+ * object at the specified index.
+ * @param index the image index
+ * @param images BufferedImage object containing the image.
+ * The format and size must be the same as the current format in this
+ * ImageComponent3D object. The index must not exceed the depth of this
+ * ImageComponent3D object.
+ *
+ void set(int index, NioImageBuffer nioImage) {
+
+ int width = nioImage.getWidth();
+ int height = nioImage.getHeight();
+
+ if (!byReference) {
+ throw new IllegalArgumentException(J3dI18N.getString("Need_New_Message_XXXXXImageComponent2D7"));
+ }
+ if (!yUp) {
+ throw new IllegalArgumentException(J3dI18N.getString("Need_New_Message_XXXXXImageComponent2D8"));
+ }
+
+ if (width != this.width) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent3D2"));
+ }
+ if (height != this.height) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent3D4"));
+ }
+
+ geomLock.getLock();
+
+ setImageClass(nioImage);
+
+ // This is a byRef image.
+ setRefImage(nioImage,0);
+
+ if(imageData == null) {
+ // Only do this once, on the first image
+ // Reset this flag to true, incase it was set to false due to
+ // the previous image type.
+ abgrSupported = true;
+
+ imageTypeIsSupported = isImageTypeSupported(nioImage);
+
+
+ // TODO : Need to handle null ....
+ imageData = createNioImageBufferDataObject(null);
+ }
+ else {
+
+ //if(getImageType() != evaluateImageType(image)) {
+ // TODO need to throw illegal state exception
+ //}
+
+ }
+
+ if (imageTypeIsSupported) {
+ // TODO : Need to handle this ..... case ....
+ // copySupportedImageToImageData(image, index, imageData);
+ } else {
+ // System.err.println("Image format is unsupported -- illogical case");
+ throw new AssertionError();
+ }
+
+ geomLock.unLock();
+
+ if (source.isLive()) {
+ // send a IMAGE_CHANGED message in order to
+ // notify all the users of the change
+ sendMessage(IMAGE_CHANGED, null);
+ }
+ }
+ */
+
+ void set(int index, RenderedImage image) {
+
+ int width = image.getWidth();
+ int height = image.getHeight();
+
+ if (width != this.width) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent3D2"));
+ }
+ if (height != this.height) {
+ throw new IllegalArgumentException(J3dI18N.getString("ImageComponent3D4"));
+ }
+
+ if (image instanceof BufferedImage) {
+ set(index, ((BufferedImage)image));
+ }
+ else {
+ // Create a buffered image from renderImage
+ ColorModel cm = image.getColorModel();
+ WritableRaster wRaster = image.copyData(null);
+ BufferedImage bi = new BufferedImage(cm,
+ wRaster,
+ cm.isAlphaPremultiplied()
+ ,null);
+ set(index, bi);
+ }
+ }
+
+ /**
+ * Retrieves a copy of the images in this ImageComponent3D object.
+ * @return a new array of new BufferedImage objects created from the
+ * images in this ImageComponent3D object
+ */
+ RenderedImage[] getRenderedImage() {
+ int i;
+ RenderedImage bi[] = new RenderedImage[depth];
+
+ if (!byReference) {
+ for (i=0; i
+ * validIndexCount : indexCount
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount the number of indices in this object. This
+ * count is the maximum number of vertices that will be rendered.
+ *
+ * @exception IllegalArgumentException if
+ * initialIndexIndex : 0
+ * all index array values : 0
+ * indexCount < 0
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public IndexedGeometryArray(int vertexCount,
+ int vertexFormat,
+ int indexCount) {
+ super(vertexCount, vertexFormat);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((IndexedGeometryArrayRetained)this.retained).createIndexedGeometryArrayData(indexCount);
+ }
+
+ /**
+ * Constructs an empty IndexedGeometryArray object with the specified
+ * number of vertices, vertex format, number of texture coordinate
+ * sets, texture coordinate mapping array, and number of indices.
+ * Defaults are used for all other parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount the number of indices in this object. This
+ * count is the maximum number of vertices that will be rendered.
+ *
+ * @exception IllegalArgumentException if indexCount < 0
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedGeometryArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount) {
+ this(vertexCount, vertexFormat, texCoordSetCount, texCoordSetMap, 0, null, indexCount);
+ }
+
+ /**
+ * Constructs an empty IndexedGeometryArray object with the
+ * specified number of vertices, vertex format, number of texture
+ * coordinate sets, texture coordinate mapping array, vertex
+ * attribute count, vertex attribute sizes array, and number of
+ * indices.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount the number of indices in this object. This
+ * count is the maximum number of vertices that will be rendered.
+ *
+ * @exception IllegalArgumentException if indexCount < 0
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedGeometryArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((IndexedGeometryArrayRetained)this.retained).createIndexedGeometryArrayData(indexCount);
+ }
+
+ /**
+ * Gets number of indices for this IndexedGeometryArray.
+ * @return indexCount the number of indices
+ */
+ public int getIndexCount(){
+ if (isLiveOrCompiled())
+ if(!this.getCapability(GeometryArray.ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray0"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getIndexCount();
+ }
+
+ /**
+ * Sets the valid index count for this IndexedGeometryArray object.
+ * This count specifies the number of indexed vertices actually used
+ * in rendering or other operations such as picking and collision.
+ * This attribute is initialized to indexCount.
+ *
+ * @param validIndexCount the new valid index count.
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @exception IllegalArgumentException if either of the following is true:
+ *
+ *
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element in the range
+ * validIndexCount < 0, or
+ * initialIndexIndex + validIndexCount > indexCount
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the index array associated with any of the enabled vertex
+ * components (coord, color, normal, texcoord) is out of range.
+ * An element is out of range if it is less than 0 or is greater
+ * than or equal to the number of vertices actually defined for
+ * the particular component's array.
+ *
+ * @exception ArrayIndexOutOfBoundsException if the data mode for this geometry
+ * array object is BY_REFERENCE_INDICES and
+ * coordIndices.length < (initialIndexIndex + validIndexCount).
+ *
+ * @since Java 3D 1.3
+ */
+ public void setValidIndexCount(int validIndexCount) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray16"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setValidIndexCount(validIndexCount);
+ }
+
+ /**
+ * Gets the valid index count for this IndexedGeometryArray
+ * object. For geometry strip primitives (subclasses of
+ * IndexedGeometryStripArray), the valid index count is defined
+ * to be the sum of the stripIndexCounts array.
+ *
+ * @return the current valid index count
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int getValidIndexCount() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray17"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getValidIndexCount();
+ }
+
+ /**
+ * Sets the initial index index for this IndexedGeometryArray object.
+ * This index specifies the first index within this indexed geometry
+ * array that is actually used in rendering or other operations
+ * such as picking and collision. This attribute is initialized
+ * to 0.
+ *
+ * @param initialIndexIndex the new initial index index.
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ * @exception IllegalArgumentException if either of the following is true:
+ *
+ *
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element in the range
+ * initialIndexIndex < 0, or
+ * initialIndexIndex + validIndexCount > indexCount
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * in the index array associated with any of the enabled vertex
+ * components (coord, color, normal, texcoord) is out of range.
+ * An element is out of range if it is less than 0 or is greater
+ * than or equal to the number of vertices actually defined for
+ * the particular component's array.
+ *
+ * @exception ArrayIndexOutOfBoundsException if the data mode for this geometry
+ * array object is BY_REFERENCE_INDICES and
+ * coordIndices.length < (initialIndexIndex + validIndexCount).
+ *
+ * @since Java 3D 1.3
+ */
+ public void setInitialIndexIndex(int initialIndexIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray18"));
+
+ if (initialIndexIndex < 0)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryArray20"));
+
+
+ ((IndexedGeometryArrayRetained)this.retained).setInitialIndexIndex(initialIndexIndex);
+ }
+
+ /**
+ * Gets the initial index index for this IndexedGeometryArray object.
+ * @return the current initial index index
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this object is part of a live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int getInitialIndexIndex() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray19"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getInitialIndexIndex();
+
+ }
+
+ /**
+ * This method is not supported for indexed geometry arrays.
+ * Indexed primitives use an array of indices to determine how
+ * to access the vertex array.
+ * The initialIndexIndex attribute can be used to set the starting
+ * index within the index arrays.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setInitialVertexIndex(int initialVertexIndex) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported for indexed geometry arrays.
+ * Indexed primitives use an array of indices to determine how
+ * to access the vertex array.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setInitialCoordIndex(int initialCoordIndex) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported for indexed geometry arrays.
+ * Indexed primitives use an array of indices to determine how
+ * to access the vertex array.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setInitialColorIndex(int initialColorIndex) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported for indexed geometry arrays.
+ * Indexed primitives use an array of indices to determine how
+ * to access the vertex array.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setInitialNormalIndex(int initialNormalIndex) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported for indexed geometry arrays.
+ * Indexed primitives use an array of indices to determine how
+ * to access the vertex array.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setInitialTexCoordIndex(int texCoordSet,
+ int initialTexCoordIndex) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported for indexed geometry arrays.
+ * Indexed primitives use an array of indices to determine how
+ * to access the vertex array.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.4
+ */
+ public void setInitialVertexAttrIndex(int vertexAttrNum,
+ int initialVertexAttrIndex) {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * This method is not supported for indexed geometry arrays.
+ * Indexed primitives use an array of indices to determine how
+ * to access the vertex array.
+ * The validIndexCount attribute can be used to set the number of
+ * valid indexed vertices rendered.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setValidVertexCount(int validVertexCount) {
+ throw new UnsupportedOperationException();
+ }
+
+
+ //NVaidya
+ /**
+ * Sets the coordinate index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param coordinateIndex the new coordinate index
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is less than 0
+ * or is greater than or equal to indexCount
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * and the specified coordinateIndex is out of range. The
+ * coordinateIndex is out of range if it is less than 0 or is
+ * greater than or equal to the number of vertices actually
+ * defined for the coordinate array.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE_INDICES.
+ */
+ public void setCoordinateIndex(int index, int coordinateIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray1"));
+
+ //NVaidya
+ int format = ((IndexedGeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE_INDICES) != 0)
+ throw new IllegalStateException(J3dI18N.getString("IndexedGeometryArray31"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setCoordinateIndex(index, coordinateIndex);
+ }
+
+
+ //NVaidya
+ /**
+ * Sets the coordinate indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param coordinateIndices an array of coordinate indices
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is less than 0
+ * or is greater than or equal to indexCount
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element of the
+ * coordinateIndices array whose destination position is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * is out of range. An element is out of range if it is less than 0
+ * or is greater than or equal to the number of vertices actually
+ * defined for the coordinate array.
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE_INDICES.
+ */
+ public void setCoordinateIndices(int index, int coordinateIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray1"));
+
+ //NVaidya
+ int format = ((IndexedGeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE_INDICES) != 0)
+ throw new IllegalStateException(J3dI18N.getString("IndexedGeometryArray31"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setCoordinateIndices(index, coordinateIndices);
+ }
+
+ //NVaidya
+ /**
+ * Sets the coordinate indices array reference to the specified array.
+ * If the coordinate indices array reference is null, the entire
+ * geometry array object is treated as if it were null--any
+ * Shape3D or Morph node that uses this geometry array will not be drawn.
+ *
+ * @param coordIndices an array of indices to which a reference
+ * will be set.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE_INDICES.
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element of the
+ * coordIndices array whose destination position is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * is out of range. An element is out of range if it is less than 0
+ * or is greater than or equal to the number of vertices actually
+ * defined for the coordinate array.
+ *
+ * @exception ArrayIndexOutOfBoundsException if
+ * coordIndices.length < (initialIndexIndex + validIndexCount).
+ *
+ * @since Java 3D 1.5
+ */
+ public void setCoordIndicesRef(int coordIndices[]) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray86"));
+
+ //NVaidya
+ int format = ((IndexedGeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE_INDICES) == 0)
+ throw new IllegalStateException(J3dI18N.getString("IndexedGeometryArray32"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setCoordIndicesRef(coordIndices);
+ }
+
+ /**
+ * Sets the color index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param colorIndex the new color index
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is less than 0
+ * or is greater than or equal to indexCount
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * and the specified colorIndex is out of range. The
+ * colorIndex is out of range if it is less than 0 or is
+ * greater than or equal to the number of vertices actually
+ * defined for the color array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public void setColorIndex(int index, int colorIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray3"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setColorIndex(index, colorIndex);
+ }
+
+ /**
+ * Sets the color indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param colorIndices an array of color indices
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is less than 0
+ * or is greater than or equal to indexCount
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element of the
+ * colorIndices array whose destination position is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * is out of range. An element is out of range if it is less than 0
+ * or is greater than or equal to the number of vertices actually
+ * defined for the color array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public void setColorIndices(int index, int colorIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray3"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setColorIndices(index, colorIndices);
+ }
+
+ /**
+ * Sets the normal index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param normalIndex the new normal index
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is less than 0
+ * or is greater than or equal to indexCount
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * and the specified normalIndex is out of range. The
+ * normalIndex is out of range if it is less than 0 or is
+ * greater than or equal to the number of vertices actually
+ * defined for the normal array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public void setNormalIndex(int index, int normalIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray5"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setNormalIndex(index, normalIndex);
+ }
+
+ /**
+ * Sets the normal indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param normalIndices an array of normal indices
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is less than 0
+ * or is greater than or equal to indexCount
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element of the
+ * normalIndices array whose destination position is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * is out of range. An element is out of range if it is less than 0
+ * or is greater than or equal to the number of vertices actually
+ * defined for the normal array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public void setNormalIndices(int index, int normalIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray5"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setNormalIndices(index, normalIndices);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinateIndex(int texCoordSet, ...)
+ */
+ public void setTextureCoordinateIndex(int index, int texCoordIndex) {
+ setTextureCoordinateIndex(0, index, texCoordIndex);
+ }
+
+ /**
+ * Sets the texture coordinate index associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index the vertex index
+ * @param texCoordIndex the new texture coordinate index
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if neither of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * and the specified texCoordIndex is out of range. The
+ * texCoordIndex is out of range if it is less than 0 or is
+ * greater than or equal to the number of vertices actually
+ * defined for the texture coordinate array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinateIndex(int texCoordSet,
+ int index,
+ int texCoordIndex) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray7"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setTextureCoordinateIndex(texCoordSet, index, texCoordIndex);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setTextureCoordinateIndices(int texCoordSet, ...)
+ */
+ public void setTextureCoordinateIndices(int index, int texCoordIndices[]) {
+ setTextureCoordinateIndices(0, index, texCoordIndices);
+ }
+
+ /**
+ * Sets the texture coordinate indices associated with the vertices
+ * starting at the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index the vertex index
+ * @param texCoordIndices an array of texture coordinate indices
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if neither of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element of the
+ * texCoordIndices array whose destination position is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * is out of range. An element is out of range if it is less than 0
+ * or is greater than or equal to the number of vertices actually
+ * defined for the texture coordinate array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.2
+ */
+ public void setTextureCoordinateIndices(int texCoordSet,
+ int index,
+ int texCoordIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_TEXCOORD_INDEX_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray7"));
+
+ ((IndexedGeometryArrayRetained)this.retained).setTextureCoordinateIndices(texCoordSet, index, texCoordIndices);
+ }
+
+ /**
+ * Sets the vertex attribute index associated with the vertex at
+ * the specified index for the specified vertex attribute number
+ * for this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index the vertex index
+ * @param vertexAttrIndex the new vertex attribute index
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception ArrayIndexOutOfBoundsException if index is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * and the specified vertexAttrIndex is out of range. The
+ * vertexAttrIndex is out of range if it is less than 0 or is
+ * greater than or equal to the number of vertices actually
+ * defined for the vertex attribute array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrIndex(int vertexAttrNum,
+ int index,
+ int vertexAttrIndex) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_VERTEX_ATTR_INDEX_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray28"));
+ }
+ }
+
+ ((IndexedGeometryArrayRetained)this.retained).setVertexAttrIndex(vertexAttrNum, index, vertexAttrIndex);
+ }
+
+ /**
+ * Sets the vertex attribute indices associated with the vertices
+ * starting at the specified index for the specified vertex attribute number
+ * for this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index the vertex index
+ * @param vertexAttrIndices an array of vertex attribute indices
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception ArrayIndexOutOfBoundsException if any element of the
+ * vertexAttrIndices array whose destination position is in the range
+ * [initialIndexIndex, initialIndexIndex+validIndexCount-1]
+ * is out of range. An element is out of range if it is less than 0
+ * or is greater than or equal to the number of vertices actually
+ * defined for the vertex attribute array.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.4
+ */
+ public void setVertexAttrIndices(int vertexAttrNum,
+ int index,
+ int[] vertexAttrIndices) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_VERTEX_ATTR_INDEX_WRITE)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray28"));
+ }
+ }
+
+ ((IndexedGeometryArrayRetained)this.retained).setVertexAttrIndices(vertexAttrNum, index, vertexAttrIndices);
+ }
+
+ //NVaidya
+ /**
+ * Retrieves the coordinate index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @return the coordinate index
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE_INDICES.
+ */
+ public int getCoordinateIndex(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray9"));
+
+ //NVaidya
+ int format = ((IndexedGeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE_INDICES) != 0)
+ throw new IllegalStateException(J3dI18N.getString("IndexedGeometryArray31"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getCoordinateIndex(index);
+ }
+
+ //NVaidya
+ /**
+ * Retrieves the coordinate indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param coordinateIndices array that will receive the coordinate indices
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is BY_REFERENCE_INDICES.
+ */
+ public void getCoordinateIndices(int index, int coordinateIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray9"));
+
+ //NVaidya
+ int format = ((IndexedGeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE_INDICES) != 0)
+ throw new IllegalStateException(J3dI18N.getString("IndexedGeometryArray31"));
+
+ ((IndexedGeometryArrayRetained)this.retained).getCoordinateIndices(index, coordinateIndices);
+ }
+
+ //NVaidya
+ /**
+ * Returns a reference to the coordinate indices associated with
+ * the vertices
+ * @return the coordinate indices array
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception IllegalStateException if the data mode for this geometry
+ * array object is not BY_REFERENCE_INDICES.
+ *
+ * @since Java 3D 1.5
+ */
+ public int[] getCoordIndicesRef() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_REF_DATA_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("GeometryArray87"));
+
+ int format = ((IndexedGeometryArrayRetained)this.retained).vertexFormat;
+ if ((format & BY_REFERENCE_INDICES) == 0)
+ throw new IllegalStateException(J3dI18N.getString("IndexedGeometryArray32"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getCoordIndicesRef();
+ }
+
+ /**
+ * Retrieves the color index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @return the color index
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public int getColorIndex(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray11"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getColorIndex(index);
+ }
+
+ /**
+ * Retrieves the color indices associated with the vertices starting at
+ * the specified index for this object. The color indicies are
+ * copied into the specified array. The array must be large enough
+ * to hold all of the indices.
+ * @param index the vertex index
+ * @param colorIndices array that will receive the color indices
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public void getColorIndices(int index, int colorIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray11"));
+
+ ((IndexedGeometryArrayRetained)this.retained).getColorIndices(index, colorIndices);
+ }
+
+ /**
+ * Retrieves the normal index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @return the normal index
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public int getNormalIndex(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray13"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getNormalIndex(index);
+ }
+
+ /**
+ * Retrieves the normal indices associated with the vertices starting at
+ * the specified index for this object. The normal indicies are
+ * copied into the specified array. The array must be large enough
+ * to hold all of the normal indicies.
+ *
+ * @param index the vertex index
+ * @param normalIndices array that will receive the normal indices
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ */
+ public void getNormalIndices(int index, int normalIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_NORMAL_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray13"));
+
+ ((IndexedGeometryArrayRetained)this.retained).getNormalIndices(index, normalIndices);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinateIndex(int texCoordSet, ...)
+ */
+ public int getTextureCoordinateIndex(int index) {
+ return (getTextureCoordinateIndex(0, index));
+ }
+
+ /**
+ * Retrieves the texture coordinate index associated with the vertex at
+ * the specified index in the specified texture coordinate set
+ * for this object.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index the vertex index
+ *
+ * @return the texture coordinate index
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if neither of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.2
+ */
+ public int getTextureCoordinateIndex(int texCoordSet, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray15"));
+
+ return ((IndexedGeometryArrayRetained)this.retained).getTextureCoordinateIndex(texCoordSet, index);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getTextureCoordinateIndices(int texCoordSet, ...)
+ */
+ public void getTextureCoordinateIndices(int index, int texCoordIndices[]) {
+ getTextureCoordinateIndices(0, index, texCoordIndices);
+ }
+
+
+ /**
+ * Retrieves the texture coordinate indices associated with the vertices
+ * starting at the specified index in the specified texture coordinate set
+ * for this object. The texture
+ * coordinate indices are copied into the specified array. The array
+ * must be large enough to hold all of the indices.
+ *
+ * @param texCoordSet texture coordinate set in this geometry array
+ * @param index the vertex index
+ * @param texCoordIndices array that will receive the texture coordinate
+ * indices
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if neither of the
+ * TEXTURE_COORDINATE bits are set in the
+ * vertexFormat or if the index or
+ * texCoordSet is out of range.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.2
+ */
+ public void getTextureCoordinateIndices(int texCoordSet,
+ int index,
+ int texCoordIndices[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COORDINATE_INDEX_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray15"));
+
+ ((IndexedGeometryArrayRetained)this.retained).getTextureCoordinateIndices(texCoordSet, index, texCoordIndices);
+ }
+
+ /**
+ * Retrieves the vertex attribute index associated with the vertex at
+ * the specified index for the specified vertex attribute number
+ * for this object.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index the vertex index
+ *
+ * @return the vertex attribute index
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.4
+ */
+ public int getVertexAttrIndex(int vertexAttrNum,
+ int index) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_VERTEX_ATTR_INDEX_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray29"));
+ }
+ }
+
+ return ((IndexedGeometryArrayRetained)this.retained).getVertexAttrIndex(vertexAttrNum, index);
+ }
+
+ /**
+ * Retrieves the vertex attribute indices associated with the vertices
+ * starting at the specified index for the specified vertex attribute number
+ * for this object. The vertex attribute indices
+ * are copied into the specified array. The array
+ * must be large enough to hold all of the indices.
+ *
+ * @param vertexAttrNum vertex attribute number in this geometry array
+ * @param index the vertex index
+ * @param vertexAttrIndices array that will receive the vertex attribute indices
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @exception ArrayIndexOutOfBoundsException if the index or
+ * vertexAttrNum is out of range.
+ *
+ * @exception NullPointerException if the USE_COORD_INDEX_ONLY
+ * bit is set in vertexFormat.
+ *
+ * @since Java 3D 1.4
+ */
+ public void getVertexAttrIndices(int vertexAttrNum,
+ int index,
+ int[] vertexAttrIndices) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_VERTEX_ATTR_INDEX_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryArray29"));
+ }
+ }
+
+ ((IndexedGeometryArrayRetained)this.retained).getVertexAttrIndices(vertexAttrNum, index, vertexAttrIndices);
+ }
+
+ /**
+ * Copies all node information from originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+ // vertexFormat, vertexCount and indexCount are copied in
+ // subclass when constructor
+ // public IndexedGeometryArray(int vertexCount, int vertexFormat,
+ // int indexCount)
+ // is used in cloneNodeComponent()
+ IndexedGeometryArrayRetained ga =
+ (IndexedGeometryArrayRetained) originalNodeComponent.retained;
+ IndexedGeometryArrayRetained rt =
+ (IndexedGeometryArrayRetained) retained;
+
+ int vformat = ga.getVertexFormat();
+ int buffer[] = new int[ga.getIndexCount()];
+
+ if ((vformat & COORDINATES) != 0) {
+ ga.getCoordinateIndices(0, buffer);
+ rt.setCoordinateIndices(0, buffer);
+ }
+
+ if ((vformat & USE_COORD_INDEX_ONLY) == 0) {
+ if ((vformat & NORMALS) != 0) {
+ ga.getNormalIndices(0, buffer);
+ rt.setNormalIndices(0, buffer);
+ }
+
+ if ((vformat & COLOR) != 0) {
+ ga.getColorIndices(0, buffer);
+ rt.setColorIndices(0, buffer);
+ }
+
+ if ((vformat & VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < ga.vertexAttrCount; i++) {
+ ga.getVertexAttrIndices(i, 0, buffer);
+ rt.setVertexAttrIndices(i, 0, buffer);
+ }
+ }
+
+ if ((vformat & TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < ga.texCoordSetCount; i++) {
+ ga.getTextureCoordinateIndices(i, 0, buffer);
+ rt.setTextureCoordinateIndices(i, 0, buffer);
+ }
+ }
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryArrayRetained.java
new file mode 100644
index 0000000..7eeab6e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryArrayRetained.java
@@ -0,0 +1,1928 @@
+/*
+ * $RCSfile: IndexedGeometryArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.12 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+import com.sun.j3d.internal.FloatBufferWrapper;
+
+/**
+ * The IndexedGeometryArray object contains arrays of positional coordinates,
+ * colors, normals and/or texture coordinates that describe
+ * point, line, or surface geometry. It is extended to create
+ * the various primitive types (e.g., lines, triangle_strips, etc.)
+ */
+
+abstract class IndexedGeometryArrayRetained extends GeometryArrayRetained {
+
+ // arrays to save indices for coord, color, normal, texcoord, vertexAttr
+ int[] indexCoord;
+ int[] indexColor;
+ int[] indexNormal;
+ int[][] indexTexCoord;
+ int[][] indexVertexAttr;
+
+ int indexCount = 0;
+
+ int initialIndexIndex = 0;
+ int validIndexCount = 0;
+
+ // Following variables are only used in compile mode
+ int[] compileIndexCount;
+ int[] compileIndexOffset;
+
+ int maxCoordIndex = 0;
+ int maxColorIndex = 0;
+ int maxNormalIndex = 0;
+ int[] maxTexCoordIndices = null;
+ int[] maxVertexAttrIndices = null;
+
+ void createIndexedGeometryArrayData(int indexCount) {
+ this.indexCount = indexCount;
+ this.validIndexCount = indexCount;
+
+ // Only allocate color, normal, texCoord, and vertexAttr
+ // index arrays if USE_COORD_INDEX_ONLY is not set
+ boolean notUCIO = (this.vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0;
+
+ //NVaidya
+ // Only allocate indexCoord if BY_REFERENCE_INDICES not set
+ if(((this.vertexFormat & GeometryArray.COORDINATES) != 0) &&
+ ((this.vertexFormat & GeometryArray.BY_REFERENCE_INDICES) == 0))
+ this.indexCoord = new int[indexCount];
+
+ if(((this.vertexFormat & GeometryArray.NORMALS) != 0) && notUCIO)
+ this.indexNormal = new int[indexCount];
+
+ if(((this.vertexFormat & GeometryArray.COLOR) != 0) && notUCIO)
+ this.indexColor = new int[indexCount];
+
+ if((this.vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ this.indexTexCoord = new int[this.texCoordSetCount][];
+ if(notUCIO) {
+ for (int i = 0; i < this.texCoordSetCount; i++) {
+ this.indexTexCoord[i] = new int[indexCount];
+ }
+ }
+ maxTexCoordIndices = new int[texCoordSetCount];
+ }
+
+ if ((this.vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ this.indexVertexAttr = new int[this.vertexAttrCount][];
+ if (notUCIO) {
+ for (int i = 0; i < this.vertexAttrCount; i++) {
+ this.indexVertexAttr[i] = new int[indexCount];
+ }
+ }
+ this.maxVertexAttrIndices = new int[this.vertexAttrCount];
+ }
+ }
+
+
+ GeometryArrayRetained cloneNonIndexedGeometry() {
+ GeometryArrayRetained obj = null;
+
+ switch (this.geoType) {
+ case GEO_TYPE_INDEXED_LINE_SET:
+ obj = new LineArrayRetained();
+ break;
+ case GEO_TYPE_INDEXED_POINT_SET:
+ obj = new PointArrayRetained();
+ break;
+ case GEO_TYPE_INDEXED_QUAD_SET:
+ obj = new QuadArrayRetained();
+ break;
+ case GEO_TYPE_INDEXED_TRI_SET:
+ obj = new TriangleArrayRetained();
+ break;
+ default:
+ assert false; // Should never get here
+ }
+
+ obj.createGeometryArrayData(validIndexCount,
+ (vertexFormat & ~(GeometryArray.BY_REFERENCE|GeometryArray.INTERLEAVED|GeometryArray.USE_NIO_BUFFER)),
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes);
+ obj.cloneSourceArray = this;
+ obj.unIndexify(this);
+ obj.source=source;
+
+ return obj;
+ }
+
+
+ /**
+ * Gets current number of indices
+ * @return indexCount
+ */
+ int getIndexCount(){
+ return indexCount;
+ }
+
+ void doErrorCheck(int newMax) {
+ doCoordCheck(newMax);
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) != 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ doColorCheck(newMax);
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ doTexCoordCheck(newMax, i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ doVertexAttrCheck(newMax, i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ doNormalCheck(newMax);
+ }
+ }
+ }
+
+ void doCoordCheck(int newMax) {
+ // Check to make sure that the array length defined by the user is ateast maxCoordIndex long
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) == 0) {
+ if (newMax >= vertexCount) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ }
+ else {
+ if(( vertexFormat & GeometryArray.USE_NIO_BUFFER) != 0) {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & GeometryArrayRetained.VERTEX_DEFINED)) {
+ case PF:
+ if(floatBufferRefCoords != null && 3 * newMax >= floatBufferRefCoords.limit() ) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ break;
+ case PD:
+ if(doubleBufferRefCoords != null && 3 * newMax >= doubleBufferRefCoords.limit() ) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ break;
+ }
+ }
+ else {
+ if(interleavedFloatBufferImpl != null && stride * newMax >= interleavedFloatBufferImpl.limit() ) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ }
+ } else {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & VERTEX_DEFINED)) {
+ case PF:
+ if (floatRefCoords != null && (3 * newMax >= floatRefCoords.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ break;
+ case PD:
+ if (doubleRefCoords != null && (3 * newMax >= doubleRefCoords.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+
+ break;
+ case P3F:
+ if (p3fRefCoords != null && (newMax >= p3fRefCoords.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ break;
+ case P3D:
+ if (p3dRefCoords != null && (newMax >= p3dRefCoords.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ break;
+ default:
+ break;
+ }
+ }
+ else {
+ if (interLeavedVertexData != null && (stride * newMax >= interLeavedVertexData.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray23"));
+ }
+ }
+ }
+ }
+
+ }
+
+ void doColorCheck(int newMax) {
+ // If the new Value is greater than the old value, make sure there is array length
+ // to support the change
+ // Check to make sure that the array length defined by the user is ateast maxCoordIndex long
+ if ((vertexFormat & GeometryArray.COLOR) == 0)
+ return;
+
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) == 0) {
+ if (newMax >= vertexCount) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ }
+ else {
+ int multiplier = getColorStride();
+
+ if(( vertexFormat & GeometryArray.USE_NIO_BUFFER) != 0) {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & COLOR_DEFINED)) {
+ case CF:
+ if (floatBufferRefColors != null && multiplier * newMax >= floatBufferRefColors.limit()) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ break;
+ case CUB:
+ if (byteBufferRefColors != null && multiplier * newMax >= byteBufferRefColors.limit()) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ break;
+ }
+ }
+ else {
+ if(interleavedFloatBufferImpl != null &&
+ stride * newMax >= interleavedFloatBufferImpl.limit()) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ }
+ } else {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & COLOR_DEFINED)) {
+ case CF:
+ if (floatRefColors != null && (multiplier * newMax >= floatRefColors.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ break;
+ case CUB:
+ if (byteRefColors != null && (multiplier * newMax >= byteRefColors.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+
+ break;
+ case C3F:
+ if (c3fRefColors != null && (newMax >= c3fRefColors.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ break;
+ case C4F:
+ if (c4fRefColors != null && (newMax >= c4fRefColors.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ break;
+ case C3UB:
+ if (c3bRefColors != null && (newMax >= c3bRefColors.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ break;
+ case C4UB:
+ if (c4bRefColors != null && (newMax >= c4bRefColors.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ break;
+ default:
+ break;
+ }
+ } else {
+ if (interLeavedVertexData != null && (stride * newMax >= interLeavedVertexData.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray24"));
+ }
+ }
+ }
+ }
+
+ }
+
+
+ void doNormalCheck(int newMax) {
+ if ((vertexFormat & GeometryArray.NORMALS) == 0)
+ return;
+
+ // Check to make sure that the array length defined by the user is ateast maxCoordIndex long
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) == 0) {
+ if (newMax >= vertexCount) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray26"));
+ }
+ }
+ else {
+ if(( vertexFormat & GeometryArray.USE_NIO_BUFFER) != 0) {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & GeometryArrayRetained.NORMAL_DEFINED)) {
+ case NF:
+ if(floatBufferRefNormals != null && 3 * newMax >= floatBufferRefNormals.limit() ) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray26"));
+ }
+ break;
+ }
+ }
+ else {
+ if(interleavedFloatBufferImpl != null && stride * newMax >= interleavedFloatBufferImpl.limit() ) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray26"));
+ }
+ }
+ } else {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & NORMAL_DEFINED)) {
+ case NF:
+ if (floatRefNormals != null && (3 * newMax >= floatRefNormals.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray26"));
+ }
+ break;
+ case N3F:
+ if (v3fRefNormals != null && (newMax >= v3fRefNormals.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray26"));
+ }
+
+ break;
+ default:
+ break;
+ }
+ }
+ else {
+ if (interLeavedVertexData != null && (stride * newMax >= interLeavedVertexData.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray26"));
+ }
+ }
+ }
+ }
+
+ }
+
+
+
+ void doTexCoordCheck(int newMax, int texCoordSet) {
+
+ // Check to make sure that the array length defined by the user is ateast maxCoordIndex long
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) == 0)
+ return;
+
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) == 0) {
+ if (newMax >= vertexCount) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray25"));
+ }
+ }
+ else {
+ int multiplier = getTexStride();
+
+ if(( vertexFormat & GeometryArray.USE_NIO_BUFFER) != 0) {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & GeometryArrayRetained.TEXCOORD_DEFINED)) {
+ case TF:
+ FloatBufferWrapper texBuffer;
+ texBuffer = (FloatBufferWrapper)(((J3DBuffer) refTexCoordsBuffer[texCoordSet]).getBufferImpl());
+ if(refTexCoords[texCoordSet] != null && multiplier * newMax >= texBuffer.limit()) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray25"));
+ }
+ break;
+ }
+ }
+ else {
+ if(interleavedFloatBufferImpl != null && stride * newMax >= interleavedFloatBufferImpl.limit() ) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray25"));
+ }
+ }
+ } else {
+
+ if ((vertexFormat & GeometryArray.INTERLEAVED) == 0) {
+ switch ((vertexType & TEXCOORD_DEFINED)) {
+ case TF:
+ if (refTexCoords[texCoordSet] != null && (multiplier * newMax >= ((float[])refTexCoords[texCoordSet]).length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray25"));
+ }
+ break;
+ case T2F:
+ if (refTexCoords[texCoordSet] != null && (newMax >= ((TexCoord2f[])refTexCoords[texCoordSet]).length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray25"));
+ }
+
+ break;
+ case T3F:
+ if (refTexCoords[texCoordSet] != null && (newMax >= ((TexCoord3f[])refTexCoords[texCoordSet]).length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray25"));
+ }
+ break;
+ default:
+ break;
+ }
+ }
+ else {
+ if (interLeavedVertexData != null && (stride * newMax >= interLeavedVertexData.length)) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray25"));
+ }
+ }
+ }
+ }
+
+ }
+
+ void doVertexAttrCheck(int newMax, int vertexAttrNum) {
+
+ // Check to make sure that the array length defined by the user is ateast maxVertexAttrIndex long
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) == 0) {
+ return;
+ }
+
+ // Vertex attributes must not be interleaved
+ assert (vertexFormat & GeometryArray.INTERLEAVED) == 0;
+
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) == 0) {
+ if (newMax >= vertexCount) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray30"));
+ }
+ } else {
+ int multiplier = vertexAttrSizes[vertexAttrNum];
+
+ if(( vertexFormat & GeometryArray.USE_NIO_BUFFER) != 0) {
+ switch (vertexType & VATTR_DEFINED) {
+ case AF:
+ if(multiplier * newMax >= floatBufferRefVertexAttrs[vertexAttrNum].limit()) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray30"));
+ }
+ break;
+ }
+ } else {
+ switch (vertexType & VATTR_DEFINED) {
+ case AF:
+ if (multiplier * newMax >= floatRefVertexAttrs[vertexAttrNum].length) {
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray30"));
+ }
+ break;
+ }
+ }
+ }
+ }
+
+
+ /**
+ * Sets the coordinate index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param coordinateIndex the new coordinate index
+ */
+ final void setCoordinateIndex(int index, int coordinateIndex) {
+ int newMax;
+ newMax = doIndexCheck(index, maxCoordIndex, indexCoord, coordinateIndex);
+ if (newMax > maxCoordIndex) {
+ doErrorCheck(newMax);
+ }
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) != 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ maxColorIndex = newMax;
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ maxNormalIndex = newMax;
+ }
+ }
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= INDEX_CHANGED;
+ this.indexCoord[index] = coordinateIndex;
+ maxCoordIndex = newMax;
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(true);
+ }
+ }
+
+ int doIndexCheck(int index, int maxIndex, int[] indices, int dataValue) {
+ int newMax = maxIndex;
+ if (index < initialIndexIndex)
+ return newMax;
+
+ if (index >= (initialIndexIndex+validIndexCount))
+ return newMax;
+
+ if (dataValue < 0) {
+ // Throw an exception, since index is negative
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray27"));
+
+ }
+
+ if (newMax == indices[index]) {
+ if (dataValue >= newMax) {
+ newMax = dataValue;
+ }
+ // Go thru the entire list and look for the max
+ else {
+ for (int i = 0; i < indices.length; i++) {
+ if (indices[i] > newMax) {
+ newMax = indices[i];
+ }
+ }
+ }
+ }
+ else if (dataValue > newMax) {
+ newMax = dataValue;
+ }
+ return newMax;
+ }
+
+ int doIndicesCheck(int index, int maxIndex, int[] indices, int[] newIndices) {
+ int newMax = maxIndex;
+ boolean computeNewMax = false;
+ int i, j, num = newIndices.length;
+ boolean maxReset = false;
+ for (j = 0; j < num; j++) {
+ if ((index+j) < initialIndexIndex)
+ continue;
+
+ if ((index+j) >= (initialIndexIndex+validIndexCount))
+ continue;
+ if (newIndices[j] < 0) {
+ // Throw an exception, since index is negative
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray27"));
+
+ }
+ if (indices[index+j] == maxIndex) {
+ if (newIndices[j] >= newMax) {
+ newMax = newIndices[j];
+ computeNewMax = false;
+ maxReset = true;
+ }
+ // Go thru the entire list and look for the max
+ // If in the new list there is no value that is >=
+ // to the old maximum
+ else if (!maxReset){
+ computeNewMax = true;
+ }
+ }
+ else if (newIndices[j] >= newMax) {
+ newMax = newIndices[j];
+ computeNewMax = false;
+ maxReset = true;
+ }
+ }
+ if (computeNewMax) {
+ for (i = 0; i < indices.length; i++) {
+ if (indices[i] > newMax) {
+ newMax = indices[i];
+ }
+ }
+ }
+ return newMax;
+ }
+
+
+ /**
+ * Sets the coordinate indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param coordinateIndices an array of coordinate indices
+ */
+ final void setCoordinateIndices(int index, int coordinateIndices[]) {
+ int newMax;
+ int i, j, num = coordinateIndices.length;
+ newMax = doIndicesCheck(index, maxCoordIndex, indexCoord, coordinateIndices);
+ if (newMax > maxCoordIndex) {
+ doErrorCheck(newMax);
+ }
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) != 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ maxColorIndex = newMax;
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ maxNormalIndex = newMax;
+ }
+ }
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= INDEX_CHANGED;
+ maxCoordIndex = newMax;
+ for (i=0, j = index; i < num;i++, j++) {
+ this.indexCoord[j] = coordinateIndices[i];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(true);
+ }
+ }
+
+ //NVaidya
+ /**
+ * Sets the coordinate indices by reference to the specified array
+ * @param coordinateIndices an array of coordinate indices
+ */
+ final void setCoordIndicesRef(int coordinateIndices[]) {
+ int newMax = 0;
+
+ if (coordinateIndices != null) {
+ if (coordinateIndices.length < initialIndexIndex + validIndexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryArray33"));
+ }
+
+ //
+ // option 1: could fake the args to "re-use" doIndicesCheck()
+ //NVaidya
+ // newMax = doIndicesCheck(0, maxCoordIndex, coordinateIndices, coordinateIndices);
+ // if (newMax > maxCoordIndex) {
+ // doErrorCheck(newMax);
+ // }
+ //
+ // option 2: same logic as in setInitialIndexIndex: Better, I Think ?
+ // computeMaxIndex() doesn't check for index < 0 while doIndicesCheck() does.
+ // So, a new method computeMaxIndexWithCheck
+ //NVaidya
+ newMax = computeMaxIndexWithCheck(initialIndexIndex, validIndexCount, coordinateIndices);
+ if (newMax > maxCoordIndex) {
+ doErrorCheck(newMax);
+ }
+ }
+
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) != 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ maxColorIndex = newMax;
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ maxNormalIndex = newMax;
+ }
+ }
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= INDEX_CHANGED;
+ maxCoordIndex = newMax;
+ this.indexCoord = coordinateIndices;
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(true);
+ }
+ }
+
+ //NVaidya
+ /**
+ * trigger from GeometryArrayRetained#updateData()
+ * to recompute maxCoordIndex and perform index integrity checks
+ */
+ final void doPostUpdaterUpdate() {
+ // user may have called setCoordIndicesRef and/or
+ // changed contents of indexCoord array. Thus, need to
+ // recompute maxCoordIndex unconditionally (and redundantly
+ // if user had only invoked setCoordIndicesRef but not also
+ // changed contents). geomLock is currently locked.
+
+ // Option 1:
+ // simply call setCoordIndicesRef(indexCoord); but this seems to cause
+ // deadlock or freeze - probably because the !inUpdater branch sends
+ // out too many sendDataChangedMessage(true) - occurs if updateData
+ // method is called rapidly.
+ // setCoordIndicesRef(indexCoord);
+
+ // Option 2:
+ // use only necessary code from setCoordIndicesRef
+ // System.err.println("IndexedGeometryArrayretained#doUpdaterUpdate");
+ int newMax = 0;
+
+ if (indexCoord != null) {
+ newMax = computeMaxIndexWithCheck(initialIndexIndex, validIndexCount, indexCoord);
+ if (newMax > maxCoordIndex) {
+ doErrorCheck(newMax);
+ }
+ }
+
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) != 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ maxColorIndex = newMax;
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = newMax;
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ maxNormalIndex = newMax;
+ }
+ }
+
+ dirtyFlag |= INDEX_CHANGED;
+ maxCoordIndex = newMax;
+ }
+
+ /**
+ * Sets the color index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param colorIndex the new color index
+ */
+ final void setColorIndex(int index, int colorIndex) {
+ int newMax = maxColorIndex;
+
+ newMax = doIndexCheck(index, maxColorIndex, indexColor, colorIndex);
+ if (newMax > maxColorIndex) {
+ doColorCheck(newMax);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ // No need to set INDEX_CHANGED since IndexBuffer
+ // is used only when USE_COORD_INDEX_ONLY specified.
+ // In this case only coordinate index array is
+ // considered.
+ this.indexColor[index] = colorIndex;
+ maxColorIndex = newMax;
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the color indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param colorIndices an array of color indices
+ */
+ final void setColorIndices(int index, int colorIndices[]) {
+ int i, j, num = colorIndices.length;
+ int newMax;
+
+ newMax = doIndicesCheck(index, maxColorIndex, indexColor, colorIndices);
+ if (newMax > maxColorIndex) {
+ doColorCheck(newMax);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ maxColorIndex = newMax;
+ for (i=0, j = index; i < num;i++, j++) {
+ this.indexColor[j] = colorIndices[i];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the normal index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param normalIndex the new normal index
+ */
+ final void setNormalIndex(int index, int normalIndex) {
+ int newMax;
+
+ newMax = doIndexCheck(index, maxNormalIndex, indexNormal, normalIndex);
+ if (newMax > maxNormalIndex) {
+ doNormalCheck(newMax);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ maxNormalIndex = newMax;
+ this.indexNormal[index] = normalIndex;
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the normal indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param normalIndices an array of normal indices
+ */
+ final void setNormalIndices(int index, int normalIndices[]) {
+ int i, j, num = normalIndices.length;
+ int newMax;
+
+ newMax = doIndicesCheck(index, maxNormalIndex, indexNormal, normalIndices);
+ if (newMax > maxNormalIndex) {
+ doNormalCheck(newMax);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ for (i=0, j = index; i < num;i++, j++) {
+ this.indexNormal[j] = normalIndices[i];
+ }
+ maxNormalIndex = newMax;
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the texture coordinate index associated with the vertex at
+ * the specified index for this object.
+ * @param texCoordSet the texture coordinate set
+ * @param index the vertex index
+ * @param texCoordIndex the new texture coordinate index
+ */
+ final void setTextureCoordinateIndex(int texCoordSet, int index, int texCoordIndex) {
+ int newMax;
+ int [] indices = this.indexTexCoord[texCoordSet];
+
+ newMax = doIndexCheck(index, maxTexCoordIndices[texCoordSet],indices, texCoordIndex);
+ if (newMax > maxTexCoordIndices[texCoordSet]) {
+ doTexCoordCheck(newMax, texCoordSet);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ maxTexCoordIndices[texCoordSet] = newMax;
+ indices[index] = texCoordIndex;
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the texture coordinate indices associated with the vertices
+ * starting at the specified index for this object.
+ * @param texCoordSet the texture coordinate set
+ * @param index the vertex index
+ * @param texCoordIndices an array of texture coordinate indices
+ */
+ final void setTextureCoordinateIndices(int texCoordSet, int index, int texCoordIndices[]) {
+ int i, j, num = texCoordIndices.length;
+ int [] indices = this.indexTexCoord[texCoordSet];
+
+ int newMax;
+
+ newMax = doIndicesCheck(index, maxTexCoordIndices[texCoordSet], indices, texCoordIndices);
+ if (newMax > maxTexCoordIndices[texCoordSet]) {
+ doTexCoordCheck(newMax, texCoordSet);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ maxTexCoordIndices[texCoordSet] = newMax;
+ for (i=0, j = index; i < num;i++, j++) {
+ indices[j] = texCoordIndices[i];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attribute index associated with the vertex at
+ * the specified index for the specified vertex attribute number
+ * for this object.
+ */
+ void setVertexAttrIndex(int vertexAttrNum,
+ int index,
+ int vertexAttrIndex) {
+
+ int newMax;
+ int [] indices = this.indexVertexAttr[vertexAttrNum];
+
+ newMax = doIndexCheck(index, maxVertexAttrIndices[vertexAttrNum],indices, vertexAttrIndex);
+ if (newMax > maxVertexAttrIndices[vertexAttrNum]) {
+ doVertexAttrCheck(newMax, vertexAttrNum);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ maxVertexAttrIndices[vertexAttrNum] = newMax;
+ indices[index] = vertexAttrIndex;
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Sets the vertex attribute indices associated with the vertices
+ * starting at the specified index for the specified vertex attribute number
+ * for this object.
+ */
+ void setVertexAttrIndices(int vertexAttrNum,
+ int index,
+ int[] vertexAttrIndices) {
+
+ int i, j, num = vertexAttrIndices.length;
+ int [] indices = this.indexVertexAttr[vertexAttrNum];
+
+ int newMax;
+
+ newMax = doIndicesCheck(index, maxVertexAttrIndices[vertexAttrNum], indices, vertexAttrIndices);
+ if (newMax > maxVertexAttrIndices[vertexAttrNum]) {
+ doVertexAttrCheck(newMax, vertexAttrNum);
+ }
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ maxVertexAttrIndices[vertexAttrNum] = newMax;
+ for (i=0, j = index; i < num;i++, j++) {
+ indices[j] = vertexAttrIndices[i];
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(false);
+ }
+ }
+
+ /**
+ * Retrieves the coordinate index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @return the coordinate index
+ */
+ final int getCoordinateIndex(int index) {
+ return this.indexCoord[index];
+ }
+
+ /**
+ * Retrieves the coordinate indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param coordinateIndices array that will receive the coordinate indices
+ */
+ final void getCoordinateIndices(int index, int coordinateIndices[]) {
+ int i, j, num = coordinateIndices.length;
+
+ for (i=0, j = index;i < num;i++, j++) {
+ coordinateIndices[i] = this.indexCoord[j];
+ }
+ }
+
+ //NVaidya
+ /**
+ * Returns a reference to the coordinate indices associated
+ * with the vertices
+ */
+ final int[] getCoordIndicesRef() {
+ return this.indexCoord;
+ }
+
+ /**
+ * Retrieves the color index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @return the color index
+ */
+ final int getColorIndex(int index) {
+ return this.indexColor[index];
+ }
+
+ /**
+ * Retrieves the color indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param colorIndices array that will receive the color indices
+ */
+ final void getColorIndices(int index, int colorIndices[]) {
+ int i, j, num = colorIndices.length;
+
+ for (i=0, j = index;i < num;i++, j++) {
+ colorIndices[i] = this.indexColor[j];
+ }
+ }
+
+ /**
+ * Retrieves the normal index associated with the vertex at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @return the normal index
+ */
+ final int getNormalIndex(int index) {
+ return this.indexNormal[index];
+ }
+
+ /**
+ * Retrieves the normal indices associated with the vertices starting at
+ * the specified index for this object.
+ * @param index the vertex index
+ * @param normalIndices array that will receive the normal indices
+ */
+ final void getNormalIndices(int index, int normalIndices[]) {
+ int i, j, num = normalIndices.length;
+
+ for (i=0, j = index;i < num;i++, j++) {
+ normalIndices[i] = this.indexNormal[j];
+ }
+ }
+
+ /**
+ * Retrieves the texture coordinate index associated with the vertex at
+ * the specified index for this object.
+ * @param texCoordSet the texture coordinate set
+ * @param index the vertex index
+ * @return the texture coordinate index
+ */
+ final int getTextureCoordinateIndex(int texCoordSet, int index) {
+ int [] indices = this.indexTexCoord[texCoordSet];
+
+ return indices[index];
+ }
+
+ /**
+ * Retrieves the texture coordinate indices associated with the vertices
+ * starting at the specified index for this object.
+ * @param texCoordSet the texture coordinate set
+ * @param index the vertex index
+ * @param texCoordIndices array that will receive the texture coordinate indices
+ */
+ final void getTextureCoordinateIndices(int texCoordSet, int index, int texCoordIndices[]) {
+ int i, j, num = texCoordIndices.length;
+ int [] indices = this.indexTexCoord[texCoordSet];
+
+ for (i=0, j = index;i < num;i++, j++) {
+ texCoordIndices[i] = indices[j];
+ }
+ }
+
+ /**
+ * Retrieves the vertex attribute index associated with the vertex at
+ * the specified index for the specified vertex attribute number
+ * for this object.
+ */
+ int getVertexAttrIndex(int vertexAttrNum,
+ int index) {
+
+ int [] indices = this.indexVertexAttr[vertexAttrNum];
+
+ return indices[index];
+ }
+
+ /**
+ * Retrieves the vertex attribute indices associated with the vertices
+ * starting at the specified index for the specified vertex attribute number
+ * for this object.
+ */
+ void getVertexAttrIndices(int vertexAttrNum,
+ int index,
+ int[] vertexAttrIndices) {
+
+ int i, j, num = vertexAttrIndices.length;
+ int [] indices = this.indexVertexAttr[vertexAttrNum];
+
+ for (i=0, j = index;i < num;i++, j++) {
+ vertexAttrIndices[i] = indices[j];
+ }
+ }
+
+
+ void execute(Canvas3D cv, RenderAtom ra, boolean isNonUniformScale,
+ boolean updateAlpha, float alpha,
+ int screen, boolean ignoreVertexColors) {
+
+ int cdirty;
+ boolean useAlpha = false;
+ Object[] retVal;
+ if (mirrorGeometry != null) {
+ mirrorGeometry.execute(cv, ra, isNonUniformScale, updateAlpha, alpha,
+ screen, ignoreVertexColors);
+ return;
+ }
+
+ // Check if index array is null; if yes, don't draw anything
+ if (indexCoord == null) {
+ return;
+ }
+
+ //By reference with java array
+ if ((vertexFormat & GeometryArray.USE_NIO_BUFFER) == 0) {
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) == 0) {
+ float[] vdata;
+ // System.err.println("by-copy");
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ // update the alpha values
+ retVal = updateAlphaInVertexData(cv, screen, alpha);
+ useAlpha = (retVal[0] == Boolean.TRUE);
+ vdata = (float[])retVal[1];
+
+ // D3D only
+ if (alpha != lastScreenAlpha) {
+ // handle multiple screen case
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ vdata = vertexData;
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+ }
+ // geomLock is get in MasterControl when
+ // RenderBin render the geometry. So it is safe
+ // just to set the dirty flag here
+ dirtyFlag = 0;
+ }
+
+ Pipeline.getPipeline().executeIndexedGeometry(cv.ctx,
+ this, geoType, isNonUniformScale,
+ useAlpha,
+ ignoreVertexColors,
+ initialIndexIndex,
+ validIndexCount,
+ // Vertex Count is maxCoordIndex + 1
+ maxCoordIndex + 1,
+ ((vertexFormat & GeometryArray.COLOR) != 0)?(vertexFormat|GeometryArray.COLOR_4):vertexFormat,
+ vertexAttrCount, vertexAttrSizes,
+ texCoordSetCount, texCoordSetMap,
+ (texCoordSetMap == null) ? 0 : texCoordSetMap.length,
+ texCoordSetMapOffset,
+ cv.numActiveTexUnit,
+ vdata, null,
+ cdirty, indexCoord);
+
+
+ } // end of non by reference
+ else if ((vertexFormat & GeometryArray.INTERLEAVED) != 0) {
+ if(interLeavedVertexData == null)
+ return;
+
+ float[] cdata = null;
+
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ // update the alpha values
+ retVal = updateAlphaInInterLeavedData(cv, screen, alpha);
+ useAlpha = (retVal[0] == Boolean.TRUE);
+ cdata = (float[])retVal[1];
+ if (alpha != lastScreenAlpha) {
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+ }
+ dirtyFlag = 0;
+ }
+
+ Pipeline.getPipeline().executeIndexedGeometry(cv.ctx,
+ this, geoType, isNonUniformScale,
+ useAlpha,
+ ignoreVertexColors,
+ initialIndexIndex,
+ validIndexCount,
+ maxCoordIndex + 1,
+ vertexFormat,
+ vertexAttrCount, vertexAttrSizes,
+ texCoordSetCount, texCoordSetMap,
+ (texCoordSetMap == null) ? 0 : texCoordSetMap.length,
+ texCoordSetMapOffset,
+ cv.numActiveTexUnit,
+ interLeavedVertexData, cdata,
+ cdirty, indexCoord);
+ } //end of interleaved
+ else {
+ // Check if a vertexformat is set, but the array is null
+ // if yes, don't draw anything
+ if ((vertexType == 0) ||
+ ((vertexType & VERTEX_DEFINED) == 0) ||
+ (((vertexFormat & GeometryArray.COLOR) != 0) &&
+ (vertexType & COLOR_DEFINED) == 0) ||
+ (((vertexFormat & GeometryArray.NORMALS) != 0) &&
+ (vertexType & NORMAL_DEFINED) == 0) ||
+ (((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) &&
+ (vertexType & VATTR_DEFINED) == 0) ||
+ (((vertexFormat& GeometryArray.TEXTURE_COORDINATE) != 0) &&
+ (vertexType & TEXCOORD_DEFINED) == 0)) {
+ return;
+ } else {
+ byte[] cbdata = null;
+ float[] cfdata = null;
+
+ if ((vertexType & (CF | C3F | C4F )) != 0) {
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ cfdata = updateAlphaInFloatRefColors(cv,
+ screen, alpha);
+ if (alpha != lastScreenAlpha) {
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ cfdata = mirrorFloatRefColors[0];
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+
+ }
+ dirtyFlag = 0;
+ }
+ } else if ((vertexType & (CUB| C3UB | C4UB)) != 0) {
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ cbdata = updateAlphaInByteRefColors(
+ cv, screen, alpha);
+ if (alpha != lastScreenAlpha) {
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ cbdata = mirrorUnsignedByteRefColors[0];
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+ }
+ dirtyFlag = 0;
+ }
+ } else {
+ cdirty = dirtyFlag;
+ }
+
+ int vdefined = 0;
+ if((vertexType & (PF | P3F)) != 0)
+ vdefined |= COORD_FLOAT;
+ if((vertexType & (PD | P3D)) != 0)
+ vdefined |= COORD_DOUBLE;
+ if((vertexType & (CF | C3F | C4F)) != 0)
+ vdefined |= COLOR_FLOAT;
+ if((vertexType & (CUB| C3UB | C4UB)) != 0)
+ vdefined |= COLOR_BYTE;
+ if((vertexType & NORMAL_DEFINED) != 0)
+ vdefined |= NORMAL_FLOAT;
+ if((vertexType & VATTR_DEFINED) != 0)
+ vdefined |= VATTR_FLOAT;
+ if((vertexType & TEXCOORD_DEFINED) != 0)
+ vdefined |= TEXCOORD_FLOAT;
+
+ Pipeline.getPipeline().executeIndexedGeometryVA(cv.ctx,
+ this, geoType, isNonUniformScale,
+ ignoreVertexColors,
+ initialIndexIndex,
+ validIndexCount,
+ maxCoordIndex + 1,
+ (vertexFormat | c4fAllocated),
+ vdefined,
+ mirrorFloatRefCoords, mirrorDoubleRefCoords,
+ cfdata, cbdata,
+ mirrorFloatRefNormals,
+ vertexAttrCount, vertexAttrSizes,
+ mirrorFloatRefVertexAttrs,
+ ((texCoordSetMap == null) ? 0:texCoordSetMap.length),
+ texCoordSetMap,
+ cv.numActiveTexUnit,
+ texCoordStride,
+ mirrorRefTexCoords, cdirty, indexCoord);
+ }
+ } // end of non interleaved and by reference
+ }//end of non io buffer
+
+ else {
+ if ((vertexFormat & GeometryArray.INTERLEAVED) != 0) {
+ if( interleavedFloatBufferImpl == null)
+ return;
+
+ float[] cdata = null;
+
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ // update the alpha values
+ retVal = updateAlphaInInterLeavedData(cv, screen, alpha);
+ useAlpha = (retVal[0] == Boolean.TRUE);
+ cdata = (float[])retVal[1];
+ if (alpha != lastScreenAlpha) {
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+ }
+ dirtyFlag = 0;
+ }
+
+ Pipeline.getPipeline().executeIndexedGeometryBuffer(cv.ctx,
+ this, geoType, isNonUniformScale,
+ useAlpha,
+ ignoreVertexColors,
+ initialIndexIndex,
+ validIndexCount,
+ maxCoordIndex + 1,
+ vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ (texCoordSetMap == null) ? 0 : texCoordSetMap.length,
+ texCoordSetMapOffset,
+ cv.numActiveTexUnit,
+ interleavedFloatBufferImpl.getBufferAsObject(), cdata,
+ cdirty, indexCoord);
+ } //end of interleaved
+ else {
+ // Check if a vertexformat is set, but the array is null
+ // if yes, don't draw anything
+ if ((vertexType == 0) ||
+ ((vertexType & VERTEX_DEFINED) == 0) ||
+ (((vertexFormat & GeometryArray.COLOR) != 0) &&
+ (vertexType & COLOR_DEFINED) == 0) ||
+ (((vertexFormat & GeometryArray.NORMALS) != 0) &&
+ (vertexType & NORMAL_DEFINED) == 0) ||
+ (((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) &&
+ (vertexType & VATTR_DEFINED) == 0) ||
+ (((vertexFormat& GeometryArray.TEXTURE_COORDINATE) != 0) &&
+ (vertexType & TEXCOORD_DEFINED) == 0)) {
+ return;
+ } else {
+ byte[] cbdata = null;
+ float[] cfdata = null;
+
+ if ((vertexType & CF ) != 0) {
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ cfdata = updateAlphaInFloatRefColors(cv,
+ screen, alpha);
+ if (alpha != lastScreenAlpha) {
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ // XXXX: handle transparency case
+ //cfdata = null;
+ cfdata = mirrorFloatRefColors[0];
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+
+ }
+ dirtyFlag = 0;
+ }
+ } else if ((vertexType & CUB ) != 0) {
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ cbdata = updateAlphaInByteRefColors(
+ cv, screen, alpha);
+ if (alpha != lastScreenAlpha) {
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ // XXXX: handle transparency case
+ // cbdata = null;
+ cbdata = mirrorUnsignedByteRefColors[0];
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+ }
+ dirtyFlag = 0;
+ }
+ } else {
+ cdirty = dirtyFlag;
+ }
+
+ Object vcoord = null, cdataBuffer=null, normal=null;
+
+ int vdefined = 0;
+ if((vertexType & PF) != 0) {
+ vdefined |= COORD_FLOAT;
+ vcoord = floatBufferRefCoords.getBufferAsObject();
+ } else if((vertexType & PD ) != 0) {
+ vdefined |= COORD_DOUBLE;
+ vcoord = doubleBufferRefCoords.getBufferAsObject();
+ }
+ if((vertexType & CF ) != 0) {
+ vdefined |= COLOR_FLOAT;
+ cdataBuffer = floatBufferRefColors.getBufferAsObject();
+ } else if((vertexType & CUB) != 0) {
+ vdefined |= COLOR_BYTE;
+ cdataBuffer = byteBufferRefColors.getBufferAsObject();
+ }
+
+ if((vertexType & NORMAL_DEFINED) != 0) {
+ vdefined |= NORMAL_FLOAT;
+ normal = floatBufferRefNormals.getBufferAsObject();
+ }
+
+ if ((vertexType & VATTR_DEFINED) != 0) {
+ vdefined |= VATTR_FLOAT;
+ }
+
+ if ((vertexType & TEXCOORD_DEFINED) != 0) {
+ vdefined |= TEXCOORD_FLOAT;
+ }
+
+ Pipeline.getPipeline().executeIndexedGeometryVABuffer(cv.ctx,
+ this, geoType, isNonUniformScale,
+ ignoreVertexColors,
+ initialIndexIndex,
+ validIndexCount,
+ maxCoordIndex + 1,
+ (vertexFormat | c4fAllocated),
+ vdefined,
+ vcoord,
+ cdataBuffer,
+ cfdata, cbdata,
+ normal,
+ vertexAttrCount, vertexAttrSizes,
+ nioFloatBufferRefVertexAttrs,
+ ((texCoordSetMap == null) ? 0:texCoordSetMap.length),
+ texCoordSetMap,
+ cv.numActiveTexUnit,
+ texCoordStride,
+ refTexCoords, cdirty, indexCoord);
+
+ }
+ } // end of non interleaved and by reference
+ } // end of nio buffer
+ }
+
+ void buildGA(Canvas3D cv, RenderAtom ra, boolean isNonUniformScale,
+ boolean updateAlpha, float alpha, boolean ignoreVertexColors,
+ Transform3D xform, Transform3D nxform) {
+ int cdirty;
+ boolean useAlpha = false;
+ Object[] retVal;
+ if (mirrorGeometry != null) {
+ ((GeometryArrayRetained)mirrorGeometry).buildGA(cv, ra, isNonUniformScale, updateAlpha, alpha,
+ ignoreVertexColors, xform, nxform);
+ }
+ else {
+
+ if ((vertexFormat & GeometryArray.BY_REFERENCE) == 0) {
+ float[] vdata;
+ // System.err.println("by-copy");
+ synchronized (this) {
+ cdirty = dirtyFlag;
+ if (updateAlpha && !ignoreVertexColors) {
+ // update the alpha values
+ retVal = updateAlphaInVertexData(cv, cv.screen.screen, alpha);
+ useAlpha = (retVal[0] == Boolean.TRUE);
+ vdata = (float[])retVal[1];
+
+ // D3D only
+ if (alpha != lastScreenAlpha) {
+ // handle multiple screen case
+ lastScreenAlpha = alpha;
+ cdirty |= COLOR_CHANGED;
+ }
+ } else {
+ vdata = vertexData;
+ // if transparency switch between on/off
+ if (lastScreenAlpha != -1) {
+ lastScreenAlpha = -1;
+ cdirty |= COLOR_CHANGED;
+ }
+ }
+ // geomLock is get in MasterControl when
+ // RenderBin render the geometry. So it is safe
+ // just to set the dirty flag here
+ dirtyFlag = 0;
+ }
+
+ Pipeline.getPipeline().buildIndexedGeometry(cv.ctx,
+ this, geoType, isNonUniformScale,
+ updateAlpha, alpha, ignoreVertexColors,
+ initialIndexIndex,
+ validIndexCount,
+ maxCoordIndex + 1,
+ vertexFormat,
+ vertexAttrCount, vertexAttrSizes,
+ texCoordSetCount, texCoordSetMap,
+ (texCoordSetMap == null) ? 0 : texCoordSetMap.length,
+ texCoordSetMapOffset,
+ (xform == null) ? null : xform.mat,
+ (nxform == null) ? null : nxform.mat,
+ vdata, indexCoord);
+ }
+ // XXXX: Note that there is no "else" clause here, and no
+ // buildIndexedGeometryForByRef() method.
+ // We would need to create one if we ever wanted to support by-ref
+ // indexed geometry in display lists. Better yet, we could fix
+ // canBeInDisplayList so that unindexified by-ref geometry could
+ // go into a display list.
+ }
+ }
+
+ void mergeGeometryArrays(ArrayList list) {
+ int numMerge = list.size();
+ int[] texCoord = null;
+ indexCount = 0;
+ for (int i=0; i < numMerge; i++) {
+ IndexedGeometryArrayRetained geo= (IndexedGeometryArrayRetained)list.get(i);
+ indexCount += geo.validIndexCount;
+ }
+ validIndexCount = indexCount;
+ initialIndexIndex = 0;
+ compileIndexCount = new int[numMerge];
+ compileIndexOffset = new int[numMerge];
+ indexCoord = new int[indexCount];
+ boolean notUCIO = (vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0;
+ if (notUCIO) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0)
+ indexColor = new int[indexCount];
+ if ((vertexFormat & GeometryArray.NORMALS) != 0)
+ indexNormal = new int[indexCount];
+ // We only merge if the texCoordSetCount is 1 and there are no
+ // vertex attrs
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ indexTexCoord = new int[1][];
+ indexTexCoord[0] = new int[indexCount];
+ texCoord = indexTexCoord[0];
+ }
+ }
+ int curDataOffset = 0;
+ int curIndexOffset = 0;
+ for (int i = 0; i < numMerge; i++) {
+ IndexedGeometryArrayRetained geo= (IndexedGeometryArrayRetained)list.get(i);
+ int curIndexCount = geo.validIndexCount;
+ compileIndexCount[i] = curIndexCount;
+ // Copy all the indices
+ for (int j = 0; j < curIndexCount; j++) {
+ indexCoord[j+curIndexOffset] = geo.indexCoord[j+geo.initialIndexIndex]+curDataOffset;
+ if (notUCIO) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0)
+ indexColor[j+curIndexOffset] = geo.indexColor[j+geo.initialIndexIndex]+curDataOffset;
+ if ((vertexFormat & GeometryArray.NORMALS) != 0)
+ indexNormal[j+curIndexOffset] = geo.indexNormal[j+geo.initialIndexIndex]+curDataOffset;
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0)
+ texCoord[j+curIndexOffset] = geo.indexTexCoord[0][j+geo.initialIndexIndex]+curDataOffset;
+ }
+ }
+ maxCoordIndex = geo.maxCoordIndex +curDataOffset;
+ compileIndexOffset[i] = curIndexOffset;
+ curDataOffset += geo.vertexCount;
+ curIndexOffset += curIndexCount;
+ }
+ // reset the max Values
+
+ // call the super to merge the vertex data
+ super.mergeGeometryArrays(list);
+ }
+
+
+ boolean isWriteStatic() {
+
+ if (!super.isWriteStatic() ||
+ source.getCapability(IndexedGeometryArray.ALLOW_COORDINATE_INDEX_WRITE ) ||
+ source.getCapability(IndexedGeometryArray.ALLOW_COLOR_INDEX_WRITE) ||
+ source.getCapability(IndexedGeometryArray.ALLOW_NORMAL_INDEX_WRITE) ||
+ source.getCapability(IndexedGeometryArray.ALLOW_VERTEX_ATTR_INDEX_WRITE) ||
+ source.getCapability(IndexedGeometryArray.ALLOW_TEXCOORD_INDEX_WRITE)) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Gets current number of indices
+ * @return indexCount
+ */
+ int getIndexCount(int id){
+ return compileIndexCount[id];
+ }
+
+ int computeMaxIndex(int initial, int count, int[] indices) {
+ int maxIndex = 0;
+ if (indices != null) {
+ for (int i = initial; i < (initial+count); i++) {
+ if (indices[i] > maxIndex) {
+ maxIndex = indices[i];
+ }
+ }
+ }
+ return maxIndex;
+
+ }
+
+ //NVaidya
+ // same as computeMaxIndex method but checks for index < 0
+ int computeMaxIndexWithCheck(int initial, int count, int[] indices) {
+ int maxIndex = 0;
+ for (int i = initial; i < (initial+count); i++) {
+ // Throw an exception, since index is negative
+ if (indices[i] < 0)
+ throw new ArrayIndexOutOfBoundsException(J3dI18N.getString("IndexedGeometryArray27"));
+ if (indices[i] > maxIndex) {
+ maxIndex = indices[i];
+ }
+ }
+ return maxIndex;
+
+ }
+
+ void setValidIndexCount(int validIndexCount) {
+ if (validIndexCount < 0) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryArray21"));
+ }
+ if ((initialIndexIndex + validIndexCount) > indexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryArray22"));
+ }
+ if ((vertexFormat & GeometryArray.BY_REFERENCE_INDICES) != 0) {
+ if (indexCoord != null && indexCoord.length < initialIndexIndex + validIndexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryArray33"));
+ }
+ }
+ int newCoordMax =0;
+ int newColorIndex=0;
+ int newNormalIndex=0;
+ int[] newTexCoordIndex = null;
+ int[] newVertexAttrIndex = null;
+
+ newCoordMax = computeMaxIndex(initialIndexIndex, validIndexCount,indexCoord );
+ doErrorCheck(newCoordMax);
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ newColorIndex = computeMaxIndex(initialIndexIndex, validIndexCount, indexColor);
+ doColorCheck(newColorIndex);
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ newTexCoordIndex = new int[texCoordSetCount];
+ for (int i = 0; i < texCoordSetCount; i++) {
+ newTexCoordIndex[i] = computeMaxIndex(initialIndexIndex,validIndexCount,
+ indexTexCoord[i]);
+ doTexCoordCheck(newTexCoordIndex[i], i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ newVertexAttrIndex = new int[vertexAttrCount];
+ for (int i = 0; i < vertexAttrCount; i++) {
+ newVertexAttrIndex[i] = computeMaxIndex(initialIndexIndex,
+ validIndexCount,
+ indexVertexAttr[i]);
+ doVertexAttrCheck(newVertexAttrIndex[i], i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ newNormalIndex = computeMaxIndex(initialIndexIndex, validIndexCount, indexNormal);
+ doNormalCheck(newNormalIndex);
+ }
+ }
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ this.validIndexCount = validIndexCount;
+ maxCoordIndex = newCoordMax;
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) {
+ maxColorIndex = newColorIndex;
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = newTexCoordIndex[i];
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = newVertexAttrIndex[i];
+ }
+ }
+ maxNormalIndex = newNormalIndex;
+ }
+ else {
+ maxColorIndex = maxCoordIndex;
+ maxNormalIndex = maxCoordIndex;
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = maxCoordIndex;
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = maxCoordIndex;
+ }
+ }
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ // bbox is computed for the entries list.
+ // so, send as false
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(true);
+ }
+
+ }
+
+ void setInitialIndexIndex(int initialIndexIndex) {
+ if ((initialIndexIndex + validIndexCount) > indexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryArray22"));
+ }
+ if ((vertexFormat & GeometryArray.BY_REFERENCE_INDICES) != 0) {
+ if (indexCoord != null && indexCoord.length < initialIndexIndex + validIndexCount) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryArray33"));
+ }
+ }
+
+ int newCoordMax =0;
+ int newColorIndex=0;
+ int newNormalIndex=0;
+ int[] newTexCoordIndex = null;
+ int[] newVertexAttrIndex = null;
+
+ newCoordMax = computeMaxIndex(initialIndexIndex, validIndexCount, indexCoord);
+ doErrorCheck(newCoordMax);
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ newColorIndex = computeMaxIndex(initialIndexIndex, validIndexCount, indexColor);
+ doColorCheck(newColorIndex);
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ newTexCoordIndex = new int[texCoordSetCount];
+ for (int i = 0; i < texCoordSetCount; i++) {
+ newTexCoordIndex[i] = computeMaxIndex(initialIndexIndex,validIndexCount,
+ indexTexCoord[i]);
+ doTexCoordCheck(newTexCoordIndex[i], i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ newVertexAttrIndex = new int[vertexAttrCount];
+ for (int i = 0; i < vertexAttrCount; i++) {
+ newVertexAttrIndex[i] = computeMaxIndex(initialIndexIndex,
+ validIndexCount,
+ indexVertexAttr[i]);
+ doVertexAttrCheck(newVertexAttrIndex[i], i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ newNormalIndex = computeMaxIndex(initialIndexIndex, validIndexCount, indexNormal);
+ doNormalCheck(newNormalIndex);
+ }
+ }
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ dirtyFlag |= INDEX_CHANGED;
+ this.initialIndexIndex = initialIndexIndex;
+ maxCoordIndex = newCoordMax;
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) {
+ maxColorIndex = newColorIndex;
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = newTexCoordIndex[i];
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = newVertexAttrIndex[i];
+ }
+ }
+ maxNormalIndex = newNormalIndex;
+ }
+ else {
+ maxColorIndex = maxCoordIndex;
+ maxNormalIndex = maxCoordIndex;
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (int i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = maxCoordIndex;
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (int i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = maxCoordIndex;
+ }
+ }
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ // bbox is computed for the entries list.
+ // so, send as false
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(true);
+ }
+ }
+
+ int getInitialIndexIndex() {
+ return initialIndexIndex;
+ }
+
+ int getValidIndexCount() {
+ return validIndexCount;
+ }
+
+ void handleFrequencyChange(int bit) {
+ if ((bit == IndexedGeometryArray.ALLOW_COORDINATE_INDEX_WRITE) ||
+ (((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) &&
+ ((vertexFormat & GeometryArray.COLOR) != 0) &&
+ bit == IndexedGeometryArray.ALLOW_COLOR_INDEX_WRITE) ||
+ (((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) &&
+ ((vertexFormat & GeometryArray.NORMALS) != 0) &&
+ bit == IndexedGeometryArray.ALLOW_NORMAL_INDEX_WRITE) ||
+ (((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0)&&
+ ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0)&&
+ bit == IndexedGeometryArray.ALLOW_VERTEX_ATTR_INDEX_WRITE) ||
+ (((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0)&&
+ ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0)&&
+ bit == IndexedGeometryArray.ALLOW_TEXCOORD_INDEX_WRITE)) {
+
+ setFrequencyChangeMask(bit, 0x1);
+ }
+ else {
+ super.handleFrequencyChange(bit);
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryStripArray.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryStripArray.java
new file mode 100644
index 0000000..a87ed00
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryStripArray.java
@@ -0,0 +1,265 @@
+/*
+ * $RCSfile: IndexedGeometryStripArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The IndexedGeometryStripArray object is an abstract class that is extended for
+ * a set of IndexedGeometryArray strip primitives. These include LINE_STRIP,
+ * TRIANGLE_STRIP, and TRIANGLE_FAN.
+ */
+
+public abstract class IndexedGeometryStripArray extends IndexedGeometryArray {
+
+ // non-public, no parameter constructor
+ IndexedGeometryStripArray() {}
+
+ /**
+ * Constructs an empty IndexedGeometryStripArray object with the specified
+ * number of vertices, vertex format, number of indices, and
+ * array of per-strip index counts.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts array that specifies
+ * the count of the number of indices for each separate strip.
+ * The length of this array is the number of separate strips.
+ * The sum of the elements in this array defines the total number
+ * of valid indexed vertices that are rendered (validIndexCount).
+ *
+ * @exception IllegalArgumentException if
+ * validIndexCount > indexCount
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public IndexedGeometryStripArray(int vertexCount,
+ int vertexFormat,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat, indexCount);
+ ((IndexedGeometryStripArrayRetained)this.retained).
+ setStripIndexCounts(stripIndexCounts);
+ }
+
+ /**
+ * Constructs an empty IndexedGeometryStripArray object with the specified
+ * number of vertices, vertex format, number of texture coordinate
+ * sets, texture coordinate mapping array, number of indices, and
+ * array of per-strip index counts.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts array that specifies
+ * the count of the number of indices for each separate strip.
+ * The length of this array is the number of separate strips.
+ * The sum of the elements in this array defines the total number
+ * of valid indexed vertices that are rendered (validIndexCount).
+ *
+ * @exception IllegalArgumentException if
+ * validIndexCount > indexCount
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedGeometryStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount);
+ ((IndexedGeometryStripArrayRetained)this.retained).
+ setStripIndexCounts(stripIndexCounts);
+ }
+
+ /**
+ * Constructs an empty IndexedGeometryStripArray object with the
+ * specified number of vertices, vertex format, number of texture
+ * coordinate sets, texture coordinate mapping array, vertex
+ * attribute count, vertex attribute sizes array, number of
+ * indices, and array of per-strip index counts.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts array that specifies
+ * the count of the number of indices for each separate strip.
+ * The length of this array is the number of separate strips.
+ * The sum of the elements in this array defines the total number
+ * of valid indexed vertices that are rendered (validIndexCount).
+ *
+ * @exception IllegalArgumentException if
+ * validIndexCount > indexCount
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedGeometryStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount);
+
+ ((IndexedGeometryStripArrayRetained)this.retained).
+ setStripIndexCounts(stripIndexCounts);
+ }
+
+ /**
+ * Get number of strips in the GeometryStripArray
+ * @return numStrips number of strips
+ */
+ public int getNumStrips(){
+ if (isLiveOrCompiled())
+ if(!this.getCapability(GeometryArray.ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryStripArray0"));
+
+ return ((IndexedGeometryStripArrayRetained)this.retained).getNumStrips();
+ }
+
+ /**
+ * Sets the array of strip index counts. The length of this
+ * array is the number of separate strips. The elements in this
+ * array specify the number of indices for each separate strip.
+ * The sum of the elements in this array defines the total number
+ * of valid indexed vertices that are rendered (validIndexCount).
+ *
+ * @param stripIndexCounts array that specifies
+ * the count of the number of indices for each separate strip.
+ *
+ * @exception IllegalArgumentException if
+ * initialIndexIndex + validIndexCount > indexCount
+ *
+ * @since Java 3D 1.3
+ */
+ public void setStripIndexCounts(int[] stripIndexCounts) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(GeometryArray.ALLOW_COUNT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryStripArray2"));
+
+ ((IndexedGeometryStripArrayRetained)this.retained).setStripIndexCounts(stripIndexCounts);
+
+ }
+
+ /**
+ * Gets a list of indexCounts for each strip. The list is
+ * copied into the specified array. The array must be
+ * large enough to hold all of the ints.
+ * @param stripIndexCounts an array that will receive indexCounts
+ */
+ public void getStripIndexCounts(int[] stripIndexCounts) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(GeometryArray.ALLOW_COUNT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("IndexedGeometryStripArray1"));
+
+ ((IndexedGeometryStripArrayRetained)this.retained).
+ getStripIndexCounts(stripIndexCounts);
+ }
+
+ /**
+ * This method is not supported for indexed geometry strip arrays.
+ * The sum of the elements in the strip index counts array defines
+ * the valid index count.
+ *
+ * @exception UnsupportedOperationException this method is not supported
+ *
+ * @since Java 3D 1.3
+ */
+ public void setValidIndexCount(int validIndexCount) {
+ throw new UnsupportedOperationException();
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryStripArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryStripArrayRetained.java
new file mode 100644
index 0000000..5538cdb
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedGeometryStripArrayRetained.java
@@ -0,0 +1,251 @@
+/*
+ * $RCSfile: IndexedGeometryStripArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+import java.util.ArrayList;
+
+/**
+ * The IndexedGeometryStripArray object is an abstract class that is extended for
+ * a set of IndexedGeometryArray strip primitives. These include LINE_STRIP,
+ * TRIANGLE_STRIP, and TRIANGLE_FAN.
+ */
+
+abstract class IndexedGeometryStripArrayRetained extends IndexedGeometryArrayRetained {
+
+ // Array of per-strip vertex counts
+ int stripIndexCounts[];
+
+ // Following variables are only used in compile mode
+ int[] compileStripICOffset;
+ int[] compileIndexLength;
+
+ /**
+ * Set stripIndexCount data into local array
+ */
+ void setStripIndexCounts(int stripIndexCounts[]) {
+ int i, num = stripIndexCounts.length, total = 0;
+
+ for (i=0; i < num; i++) {
+ total += stripIndexCounts[i];
+ if (this instanceof IndexedLineStripArrayRetained) {
+ if (stripIndexCounts[i] < 2) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArrayRetained1"));
+ }
+ }
+ else if (this instanceof IndexedTriangleStripArrayRetained) {
+ if (stripIndexCounts[i] < 3) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArrayRetained1"));
+ }
+ }
+ else if (this instanceof IndexedTriangleFanArrayRetained) {
+ if (stripIndexCounts[i] < 3) {
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleFanArrayRetained1"));
+ }
+ }
+ }
+
+ // Sum of all stripIndexCounts MUST be same as indexCount
+ if ((initialIndexIndex + total) > indexCount)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedGeometryStripArrayRetained0"));
+ int newCoordMax =0;
+ int newColorIndex=0;
+ int newNormalIndex=0;
+ int[] newTexCoordIndex = null;
+ int[] newVertexAttrIndex = null;
+
+ newCoordMax = computeMaxIndex(initialIndexIndex, total, indexCoord);
+ doErrorCheck(newCoordMax);
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) {
+ if ((vertexFormat & GeometryArray.COLOR) != 0) {
+ newColorIndex = computeMaxIndex(initialIndexIndex, total, indexColor);
+ doColorCheck(newColorIndex);
+ }
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ newTexCoordIndex = new int[texCoordSetCount];
+ for (i = 0; i < texCoordSetCount; i++) {
+ newTexCoordIndex[i] = computeMaxIndex(initialIndexIndex,total,
+ indexTexCoord[i]);
+ doTexCoordCheck(newTexCoordIndex[i], i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ newVertexAttrIndex = new int[vertexAttrCount];
+ for (i = 0; i < vertexAttrCount; i++) {
+ newVertexAttrIndex[i] = computeMaxIndex(initialIndexIndex,
+ total,
+ indexVertexAttr[i]);
+ doTexCoordCheck(newVertexAttrIndex[i], i);
+ }
+ }
+ if ((vertexFormat & GeometryArray.NORMALS) != 0) {
+ newNormalIndex = computeMaxIndex(initialIndexIndex, total, indexNormal);
+ doNormalCheck(newNormalIndex);
+ }
+ }
+
+ boolean isLive = source!=null && source.isLive();
+ if(isLive){
+ geomLock.getLock();
+ }
+ validIndexCount = total;
+ this.stripIndexCounts = new int[num];
+ for (i=0;i < num;i++)
+ {
+ this.stripIndexCounts[i] = stripIndexCounts[i];
+ }
+ maxCoordIndex = newCoordMax;
+ if ((vertexFormat & GeometryArray.USE_COORD_INDEX_ONLY) == 0) {
+ maxColorIndex = newColorIndex;
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = newTexCoordIndex[i];
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = newVertexAttrIndex[i];
+ }
+ }
+ maxNormalIndex = newNormalIndex;
+ }
+ else {
+ maxColorIndex = maxCoordIndex;
+ maxNormalIndex = maxCoordIndex;
+ if ((vertexFormat & GeometryArray.TEXTURE_COORDINATE) != 0) {
+ for (i = 0; i < texCoordSetCount; i++) {
+ maxTexCoordIndices[i] = maxCoordIndex;
+ }
+ }
+ if ((vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ for (i = 0; i < vertexAttrCount; i++) {
+ maxVertexAttrIndices[i] = maxCoordIndex;
+ }
+ }
+ }
+ if(isLive) {
+ geomLock.unLock();
+ }
+ // bbox is computed for the entries list.
+ // so, send as false
+ if (!inUpdater && isLive) {
+ sendDataChangedMessage(true);
+ }
+
+ }
+
+ @Override
+ GeometryArrayRetained cloneNonIndexedGeometry() {
+ GeometryStripArrayRetained obj = null;
+
+ switch (this.geoType) {
+ case GEO_TYPE_INDEXED_LINE_STRIP_SET:
+ obj = new LineStripArrayRetained();
+ break;
+ case GEO_TYPE_INDEXED_TRI_FAN_SET:
+ obj = new TriangleFanArrayRetained();
+ break;
+ case GEO_TYPE_INDEXED_TRI_STRIP_SET:
+ obj = new TriangleStripArrayRetained();
+ break;
+ }
+ obj.createGeometryArrayData(validIndexCount,
+ (vertexFormat & ~(GeometryArray.BY_REFERENCE|GeometryArray.INTERLEAVED|GeometryArray.USE_NIO_BUFFER)),
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes);
+ obj.unIndexify(this);
+ obj.setStripVertexCounts(stripIndexCounts);
+ obj.cloneSourceArray = this;
+ obj.source = source;
+
+ return obj;
+ }
+
+
+ /**
+ * Get number of strips in the GeometryStripArray
+ * @return numStrips number of strips
+ */
+ int getNumStrips(){
+ return stripIndexCounts.length;
+ }
+
+ /**
+ * Get a list of vertexCounts for each strip
+ * @param stripIndexCounts an array that will receive vertexCounts
+ */
+ void getStripIndexCounts(int stripIndexCounts[]){
+ for (int i=stripIndexCounts.length-1;i >= 0; i--) {
+ stripIndexCounts[i] = this.stripIndexCounts[i];
+ }
+ }
+
+ void mergeGeometryArrays(ArrayList list) {
+ int numMerge = list.size();
+ int numCount = 0;
+ int i, j;
+
+ for (i = 0; i < numMerge; i++) {
+ IndexedGeometryStripArrayRetained geo = (IndexedGeometryStripArrayRetained) list.get(i);
+ numCount += geo.stripIndexCounts.length;
+ }
+
+ stripIndexCounts = new int[numCount];
+ compileIndexLength = new int[numCount];
+ compileStripICOffset = new int[numMerge];
+ int curICOffset = 0;
+ for (i = 0; i < numMerge; i++) {
+ IndexedGeometryStripArrayRetained geo = (IndexedGeometryStripArrayRetained) list.get(i);
+ compileStripICOffset[i] = curICOffset;
+ compileIndexLength[i] = geo.stripIndexCounts.length;
+ System.arraycopy(geo.stripIndexCounts, 0, stripIndexCounts,
+ curICOffset, geo.stripIndexCounts.length);
+ curICOffset += geo.stripIndexCounts.length;
+ }
+ super.mergeGeometryArrays(list);
+
+ }
+ int getNumStrips(int id){
+ return compileIndexLength[id];
+ }
+
+ /**
+ * Get a list of vertexCounts for each strip
+ * @param stripIndexCounts an array that will receive vertexCounts
+ */
+ void getStripIndexCounts(int id, int stripIndexCounts[]){
+ int count = compileIndexLength[id];
+ int coffset = compileStripICOffset[id];
+ for (int i=0;i < count; i++) {
+ stripIndexCounts[i] = this.stripIndexCounts[coffset+1];
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedLineArray.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineArray.java
new file mode 100644
index 0000000..842908e
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineArray.java
@@ -0,0 +1,222 @@
+/*
+ * $RCSfile: IndexedLineArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The IndexedLineArray object draws the array of vertices as individual
+ * line segments. Each pair of vertices defines a line to be drawn.
+ */
+
+public class IndexedLineArray extends IndexedGeometryArray {
+ /**
+ * Package scoped default constructor.
+ */
+ IndexedLineArray() {
+ }
+
+ /**
+ * Constructs an empty IndexedLineArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 2, or indexCount is not
+ * a multiple of 2
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public IndexedLineArray(int vertexCount, int vertexFormat, int indexCount) {
+ super(vertexCount,vertexFormat, indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineArray0"));
+
+ if (indexCount < 2 || ((indexCount%2) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedLineArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 2, or indexCount is not
+ * a multiple of 2
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedLineArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineArray0"));
+
+ if (indexCount < 2 || ((indexCount%2) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedLineArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 2, or indexCount is not
+ * a multiple of 2
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedLineArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineArray0"));
+
+ if (indexCount < 2 || ((indexCount%2) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineArray1"));
+ }
+
+ /**
+ * Creates the retained mode IndexedLineArrayRetained object that this
+ * IndexedLineArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new IndexedLineArrayRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ IndexedLineArrayRetained rt = (IndexedLineArrayRetained) retained;
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ IndexedLineArray l = new IndexedLineArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ rt.getIndexCount());
+ l.duplicateNodeComponent(this);
+ return l;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedLineArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineArrayRetained.java
new file mode 100644
index 0000000..d2c7c35
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineArrayRetained.java
@@ -0,0 +1,431 @@
+/*
+ * $RCSfile: IndexedLineArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The IndexedLineArray object draws the array of vertices as individual
+ * line segments. Each pair of vertices defines a line to be drawn.
+ */
+
+class IndexedLineArrayRetained extends IndexedGeometryArrayRetained {
+
+ IndexedLineArrayRetained() {
+ this.geoType = GEO_TYPE_INDEXED_LINE_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[2];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ //NVaidya
+ // Bug 447: While loops below now traverse over all
+ // elements in the valid index range from initialIndexIndex
+ // to initialIndexInex + validIndexCount - 1
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ int[] vtxIndexArr = new int[2];
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < loopStopIndex) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[k]);
+ }
+ if (intersectLineAndRay(pnts[0], pnts[1], pickRay.origin,
+ pickRay.direction, sdist,
+ iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+ Vector3d dir =
+ new Vector3d(pickSegment.end.x - pickSegment.start.x,
+ pickSegment.end.y - pickSegment.start.y,
+ pickSegment.end.z - pickSegment.start.z);
+
+ while (i < loopStopIndex) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[k]);
+ }
+ if (intersectLineAndRay(pnts[0], pnts[1],
+ pickSegment.start,
+ dir, sdist, iPnt) &&
+ (sdist[0] <= 1.0)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < loopStopIndex) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[k]);
+ }
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < loopStopIndex) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[k]);
+ }
+ if (intersectBoundingSphere(pnts, bsphere, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < loopStopIndex) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[k]);
+ }
+ if (intersectBoundingPolytope(pnts, bpolytope, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+
+ while (i < loopStopIndex) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[k]);
+ }
+ if (intersectCylinder(pnts, pickCylinder, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < loopStopIndex) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[k]);
+ }
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineArrayRetained0"));
+ default:
+ throw new RuntimeException("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+
+ }
+
+ boolean intersect(Point3d[] pnts) {
+ Point3d[] points = new Point3d[2];
+ Vector3d dir;
+ double dist[] = new double[1];
+ //NVaidya
+ // Bug 447: correction for loop indices
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+
+ switch (pnts.length) {
+ case 3: // Triangle/Quad , common case first
+ case 4:
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ if (intersectSegment(pnts, points[0], points[1], dist,
+ null)) {
+ return true;
+ }
+ }
+ break;
+ case 2: // Line
+ dir = new Vector3d();
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ dir.x = points[1].x - points[0].x;
+ dir.y = points[1].y - points[0].y;
+ dir.z = points[1].z - points[0].z;
+ if (intersectLineAndRay(pnts[0], pnts[1], points[0],
+ dir, dist, null) &&
+ (dist[0] <= 1.0)) {
+ return true;
+ }
+ }
+ break;
+ case 1: // Point
+ dir = new Vector3d();
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ dir.x = points[1].x - points[0].x;
+ dir.y = points[1].y - points[0].y;
+ dir.z = points[1].z - points[0].z;
+ if (intersectPntAndRay(pnts[0], points[0], dir, dist) &&
+ (dist[0] <= 1.0)) {
+ return true;
+ }
+ }
+ break;
+ }
+ return false;
+ }
+
+
+ boolean intersect(Transform3D thisToOtherVworld,
+ GeometryRetained geom) {
+
+ Point3d[] pnts = new Point3d[2];
+ //NVaidya
+ // Bug 447: correction for loop indices
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], pnts[0]);
+ getVertexData(indexCoord[i++], pnts[1]);
+ thisToOtherVworld.transform(pnts[0]);
+ thisToOtherVworld.transform(pnts[1]);
+ if (geom.intersect(pnts)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ // the bounds argument is already transformed
+ boolean intersect(Bounds targetBound) {
+ Point3d[] pnts = new Point3d[2];
+ //NVaidya
+ // Bug 447: correction for loop indices
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+ switch(targetBound.getPickType()) {
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox box = (BoundingBox) targetBound;
+
+ while(i < loopStopIndex) {
+ getVertexData(indexCoord[i++], pnts[0]);
+ getVertexData(indexCoord[i++], pnts[1]);
+ if (intersectBoundingBox(pnts, box, null, null)) {
+ return true;
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere) targetBound;
+
+ while(i < loopStopIndex) {
+ getVertexData(indexCoord[i++], pnts[0]);
+ getVertexData(indexCoord[i++], pnts[1]);
+ if (intersectBoundingSphere(pnts, bsphere, null, null)) {
+ return true;
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope) targetBound;
+
+ while(i < loopStopIndex) {
+ getVertexData(indexCoord[i++], pnts[0]);
+ getVertexData(indexCoord[i++], pnts[1]);
+ if (intersectBoundingPolytope(pnts, bpolytope, null, null)) {
+ return true;
+ }
+ }
+ break;
+ default:
+ throw new RuntimeException("Bounds not supported for intersection "
+ + targetBound);
+ }
+ return false;
+ }
+
+ int getClassType() {
+ return LINE_TYPE;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedLineStripArray.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineStripArray.java
new file mode 100644
index 0000000..6afcc2f
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineStripArray.java
@@ -0,0 +1,250 @@
+/*
+ * $RCSfile: IndexedLineStripArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The IndexedLineStripArray object draws an array of vertices as a set of
+ * connected line strips. An array of per-strip index counts specifies
+ * where the separate strips appear in the indexed vertex array.
+ * For every strip in the set, each vertex, beginning with
+ * the second vertex in the array, defines a line segment to be drawn
+ * from the previous vertex to the current vertex.
+ */
+
+public class IndexedLineStripArray extends IndexedGeometryStripArray {
+
+ /**
+ * Package scoped default constructor.
+ */
+ IndexedLineStripArray() {
+ }
+
+ /**
+ * Constructs an empty IndexedLineStripArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts
+ * see {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 2,
+ * or any element in the stripIndexCounts array is less than 2
+ * ;
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ */
+ public IndexedLineStripArray(int vertexCount,
+ int vertexFormat,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat, indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArray0"));
+
+ if (indexCount < 2 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedLineStripArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts
+ * see {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 2,
+ * or any element in the stripIndexCounts array is less than 2
+ * ;
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedLineStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArray0"));
+
+ if (indexCount < 2 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedLineStripArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts
+ * see {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 2,
+ * or any element in the stripIndexCounts array is less than 2
+ * ;
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedLineStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArray0"));
+
+ if (indexCount < 2 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArray1"));
+ }
+
+ /**
+ * Creates the retained mode IndexedLineStripArrayRetained object that this
+ * IndexedLineStripArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new IndexedLineStripArrayRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ IndexedLineStripArrayRetained rt =
+ (IndexedLineStripArrayRetained) retained;
+ int stripIndexCounts[] = new int[rt.getNumStrips()];
+ rt.getStripIndexCounts(stripIndexCounts);
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ IndexedLineStripArray l = new IndexedLineStripArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ rt.getIndexCount(),
+ stripIndexCounts);
+ l.duplicateNodeComponent(this);
+ return l;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedLineStripArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineStripArrayRetained.java
new file mode 100644
index 0000000..bf3a270
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedLineStripArrayRetained.java
@@ -0,0 +1,494 @@
+/*
+ * $RCSfile: IndexedLineStripArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The IndexedLineStripArray object draws an array of vertices as a set of
+ * connected line strips. An array of per-strip vertex counts specifies
+ * where the separate strips appear in the vertex array.
+ * For every strip in the set, each vertex, beginning with
+ * the second vertex in the array, defines a line segment to be drawn
+ * from the previous vertex to the current vertex.
+ */
+
+class IndexedLineStripArrayRetained extends IndexedGeometryStripArrayRetained {
+
+ IndexedLineStripArrayRetained() {
+ geoType = GEO_TYPE_INDEXED_LINE_STRIP_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[2];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ int scount, j, i = 0;
+ int count = 0;
+ int[] vtxIndexArr = new int[2];
+
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ vtxIndexArr[0] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ vtxIndexArr[1] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectLineAndRay(pnts[0], pnts[1], pickRay.origin,
+ pickRay.direction, sdist,
+ iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+ Vector3d dir =
+ new Vector3d(pickSegment.end.x - pickSegment.start.x,
+ pickSegment.end.y - pickSegment.start.y,
+ pickSegment.end.z - pickSegment.start.z);
+
+ while (i < stripIndexCounts.length) {
+ vtxIndexArr[0] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ vtxIndexArr[1] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectLineAndRay(pnts[0], pnts[1],
+ pickSegment.start,
+ dir, sdist, iPnt) &&
+ (sdist[0] <= 1.0)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ vtxIndexArr[0] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ vtxIndexArr[1] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ vtxIndexArr[0] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ vtxIndexArr[1] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectBoundingSphere(pnts, bsphere, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ vtxIndexArr[0] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ vtxIndexArr[1] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectBoundingPolytope(pnts, bpolytope, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ vtxIndexArr[0] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ vtxIndexArr[1] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectCylinder(pnts, pickCylinder, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ vtxIndexArr[0] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ vtxIndexArr[1] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedLineStripArrayRetained0"));
+ default:
+ throw new RuntimeException ("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+ }
+
+ // intersect pnts[] with every triangle in this object
+ boolean intersect(Point3d[] pnts) {
+ int i = 0;
+ int j, count=0;
+ int scount;
+ Point3d[] points = new Point3d[2];
+ double dist[] = new double[1];
+ Vector3d dir;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+
+ switch (pnts.length) {
+ case 3:
+ case 4: // Triangle, Quad
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[1]);
+ if (intersectSegment(pnts, points[0], points[1],
+ dist, null)) {
+ return true;
+ }
+ points[0].set(points[1]);
+ }
+ }
+ break;
+ case 2: // line
+ dir = new Vector3d();
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[1]);
+ dir.x = points[1].x - points[0].x;
+ dir.y = points[1].y - points[0].y;
+ dir.z = points[1].z - points[0].z;
+ if (intersectLineAndRay(pnts[0], pnts[1],
+ points[0], dir, dist, null)
+ && (dist[0] <= 1.0)) {
+ return true;
+ }
+ points[0].set(points[1]);
+ }
+ }
+ break;
+ case 1: // point
+ dir = new Vector3d();
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[1]);
+ dir.x = points[1].x - points[0].x;
+ dir.y = points[1].y - points[0].y;
+ dir.z = points[1].z - points[0].z;
+ if (intersectPntAndRay(pnts[0], points[0], dir,
+ dist) &&
+ (dist[0] <= 1.0)) {
+ return true;
+ }
+ points[0].set(points[1]);
+ }
+ }
+ break;
+ }
+
+ return false;
+ }
+
+ boolean intersect(Transform3D thisToOtherVworld,
+ GeometryRetained geom) {
+ int i = 0;
+ int j, count=0;
+ Point3d[] pnts = new Point3d[2];
+ int scount;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ thisToOtherVworld.transform(pnts[0]);
+ scount = stripIndexCounts[i++];
+
+ for (j = 1; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[1]);
+ thisToOtherVworld.transform(pnts[1]);
+ if (geom.intersect( pnts)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+ }
+ return false;
+ }
+
+ // the bounds argument is already transformed
+ boolean intersect(Bounds targetBound) {
+ int i = 0;
+ int j, count=0;
+ Point3d[] pnts = new Point3d[2];
+ int scount;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+ switch(targetBound.getPickType()) {
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox box = (BoundingBox) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectBoundingBox(pnts, box, null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectBoundingSphere(pnts, bsphere, null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ scount = stripIndexCounts[i++];
+ for (j=1; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[1]);
+ if (intersectBoundingPolytope(pnts, bpolytope, null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+ }
+ break;
+ default:
+ throw new RuntimeException("Bounds not supported for intersection "
+ + targetBound);
+ }
+ return false;
+ }
+
+ int getClassType() {
+ return LINE_TYPE;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedObject.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedObject.java
new file mode 100644
index 0000000..1ae97db
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedObject.java
@@ -0,0 +1,73 @@
+/*
+ * $RCSfile: IndexedObject.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Class used for IndexedUnorderedList
+ */
+
+abstract class IndexedObject extends Object {
+
+ /**
+ * A 2D array listIdx[3][len] is used.
+ * The entry listIdx[0][], listIdx[0][1] is used for each VirtualUniverse.
+ * The entry listIdx[2][0] is used for index to which one to use.
+ *
+ * This is used to handle the case the Node Object move from
+ * one VirtualUniverse A to another VirtualUniverse B.
+ * It is possible that another Structures in B may get the add
+ * message first before the Structures in A get the remove
+ * message to clear the entry. This cause MT problem. So a
+ * 2D array is used to resolve it.
+ */
+ int[][] listIdx;
+
+ abstract VirtualUniverse getVirtualUniverse();
+
+ synchronized int getIdxUsed(VirtualUniverse u) {
+ int idx = listIdx[2][0];
+ if (u == getVirtualUniverse()) {
+ return idx;
+ }
+ return (idx == 0 ? 1 : 0);
+ }
+
+ void incIdxUsed() {
+ if (listIdx[2][0] == 0) {
+ listIdx[2][0] = 1;
+ } else {
+ listIdx[2][0] = 0;
+ }
+ }
+}
+
+
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedPointArray.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedPointArray.java
new file mode 100644
index 0000000..eaba2ef
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedPointArray.java
@@ -0,0 +1,221 @@
+/*
+ * $RCSfile: IndexedPointArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The IndexedPointArray object draws the array of vertices as
+ * individual points.
+ */
+
+public class IndexedPointArray extends IndexedGeometryArray {
+
+ /**
+ * Package scoped default constructor.
+ */
+ IndexedPointArray() {
+ }
+
+ /**
+ * Constructs an empty IndexedPointArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1
+ * or indexCount is less than 1
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public IndexedPointArray(int vertexCount, int vertexFormat, int indexCount) {
+ super(vertexCount,vertexFormat, indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedPointArray0"));
+
+ if (indexCount < 1 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedPointArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedPointArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1
+ * or indexCount is less than 1
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedPointArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedPointArray0"));
+
+ if (indexCount < 1 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedPointArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedPointArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1
+ * or indexCount is less than 1
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedPointArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedPointArray0"));
+
+ if (indexCount < 1 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedPointArray1"));
+ }
+
+ /**
+ * Creates the retained mode IndexedPointArrayRetained object that this
+ * IndexedPointArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new IndexedPointArrayRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ IndexedPointArrayRetained rt = (IndexedPointArrayRetained) retained;
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ IndexedPointArray p = new IndexedPointArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ rt.getIndexCount());
+ p.duplicateNodeComponent(this);
+ return p;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedPointArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedPointArrayRetained.java
new file mode 100644
index 0000000..e88e4c8
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedPointArrayRetained.java
@@ -0,0 +1,309 @@
+/*
+ * $RCSfile: IndexedPointArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The IndexedPointArray object draws the array of vertices as individual points.
+ */
+
+class IndexedPointArrayRetained extends IndexedGeometryArrayRetained {
+
+ IndexedPointArrayRetained() {
+ this.geoType = GEO_TYPE_INDEXED_POINT_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ Point3d pnt = new Point3d();
+ int[] vtxIndexArr = new int[1];
+
+ int i = ((vertexFormat & GeometryArray.BY_REFERENCE) == 0 ?
+ initialVertexIndex : initialCoordIndex);
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < validVertexCount) {
+ vtxIndexArr[0] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnt);
+ if (intersectPntAndRay(pnt, pickRay.origin,
+ pickRay.direction, sdist)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = pnt.x;
+ y = pnt.y;
+ z = pnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+ Vector3d dir =
+ new Vector3d(pickSegment.end.x - pickSegment.start.x,
+ pickSegment.end.y - pickSegment.start.y,
+ pickSegment.end.z - pickSegment.start.z);
+
+ while (i < validVertexCount) {
+ vtxIndexArr[0] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnt);
+ if (intersectPntAndRay(pnt, pickSegment.start,
+ dir, sdist) &&
+ (sdist[0] <= 1.0)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = pnt.x;
+ y = pnt.y;
+ z = pnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ case PickShape.PICKBOUNDINGSPHERE:
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ Bounds bounds = ((PickBounds) pickShape).bounds;
+
+ while (i < validVertexCount) {
+ vtxIndexArr[0] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnt);
+ if (bounds.intersect(pnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ sdist[0] = pickShape.distance(pnt);
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = pnt.x;
+ y = pnt.y;
+ z = pnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+
+ while (i < validVertexCount) {
+ vtxIndexArr[0] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnt);
+ if (intersectCylinder(pnt, pickCylinder, sdist)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = pnt.x;
+ y = pnt.y;
+ z = pnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < validVertexCount) {
+ vtxIndexArr[0] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnt);
+ if (intersectCone(pnt, pickCone, sdist)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = pnt.x;
+ y = pnt.y;
+ z = pnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedPointArrayRetained0"));
+ default:
+ throw new RuntimeException ("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+ }
+
+ boolean intersect(Point3d[] pnts) {
+ Point3d point = new Point3d();
+ int i = ((vertexFormat & GeometryArray.BY_REFERENCE) == 0 ?
+ initialVertexIndex : initialCoordIndex);
+
+ switch (pnts.length) {
+ case 3: // Triangle
+ while (i < validVertexCount) {
+ getVertexData(indexCoord[i++], point);
+ if (intersectTriPnt(pnts[0], pnts[1], pnts[2], point)) {
+ return true;
+ }
+ }
+ break;
+ case 4: // Quad
+ while (i < validVertexCount) {
+ getVertexData(indexCoord[i++], point);
+ if (intersectTriPnt(pnts[0], pnts[1], pnts[2], point) ||
+ intersectTriPnt(pnts[0], pnts[2], pnts[3], point)) {
+ return true;
+ }
+ }
+ break;
+ case 2: // Line
+ double dist[] = new double[1];
+ Vector3d dir = new Vector3d();
+
+ while (i < validVertexCount) {
+ getVertexData(indexCoord[i++], point);
+ dir.x = pnts[1].x - pnts[0].x;
+ dir.y = pnts[1].y - pnts[0].y;
+ dir.z = pnts[1].z - pnts[0].z;
+ if (intersectPntAndRay(point, pnts[0], dir, dist) &&
+ (dist[0] <= 1.0)) {
+ return true;
+ }
+ }
+ break;
+ case 1: // Point
+ while (i < validVertexCount) {
+ getVertexData(indexCoord[i++], point);
+ if ((pnts[0].x == point.x) &&
+ (pnts[0].y == point.y) &&
+ (pnts[0].z == point.z)) {
+ return true;
+ }
+ }
+ break;
+ }
+ return false;
+ }
+
+ boolean intersect(Transform3D thisToOtherVworld,
+ GeometryRetained geom) {
+ Point3d[] pnt = new Point3d[1];
+ int i = ((vertexFormat & GeometryArray.BY_REFERENCE) == 0 ?
+ initialVertexIndex : initialCoordIndex);
+ pnt[0] = new Point3d();
+
+ while (i < validVertexCount) {
+ getVertexData(indexCoord[i++], pnt[0]);
+ thisToOtherVworld.transform(pnt[0]);
+ if (geom.intersect(pnt)) {
+ return true;
+ }
+ }
+ return false;
+
+ }
+
+ // the bounds argument is already transformed
+ boolean intersect(Bounds targetBound) {
+ int i = ((vertexFormat & GeometryArray.BY_REFERENCE) == 0 ?
+ initialVertexIndex : initialCoordIndex);
+ Point3d pnt = new Point3d();
+
+ while (i < validVertexCount) {
+ getVertexData(indexCoord[i++], pnt);
+ if (targetBound.intersect(pnt)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ int getClassType() {
+ return POINT_TYPE;
+ }
+}
+
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedQuadArray.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedQuadArray.java
new file mode 100644
index 0000000..3849ac7
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedQuadArray.java
@@ -0,0 +1,225 @@
+/*
+ * $RCSfile: IndexedQuadArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The IndexedQuadArray object draws the array of vertices as individual
+ * quadrilaterals. Each group
+ * of four vertices defines a quadrilateral to be drawn.
+ */
+
+public class IndexedQuadArray extends IndexedGeometryArray {
+
+ /**
+ * Package scoped default constructor.
+ */
+ IndexedQuadArray() {
+ }
+
+ /**
+ * Constructs an empty IndexedQuadArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 4, or indexCount is not
+ * a multiple of 4
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public IndexedQuadArray(int vertexCount, int vertexFormat, int indexCount) {
+ super(vertexCount,vertexFormat, indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedQuadArray0"));
+
+ if (indexCount < 4 || ((indexCount%4) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedQuadArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedQuadArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 4, or indexCount is not
+ * a multiple of 4
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedQuadArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedQuadArray0"));
+
+ if (indexCount < 4 || ((indexCount%4) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedQuadArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedQuadArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 4, or indexCount is not
+ * a multiple of 4
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedQuadArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedQuadArray0"));
+
+ if (indexCount < 4 || ((indexCount%4) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedQuadArray1"));
+ }
+
+ /**
+ * Creates the retained mode IndexedQuadArrayRetained object that this
+ * IndexedQuadArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new IndexedQuadArrayRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ IndexedQuadArrayRetained rt = (IndexedQuadArrayRetained) retained;
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ IndexedQuadArray q = new IndexedQuadArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ rt.getIndexCount());
+ q.duplicateNodeComponent(this);
+ return q;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedQuadArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedQuadArrayRetained.java
new file mode 100644
index 0000000..0368835
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedQuadArrayRetained.java
@@ -0,0 +1,460 @@
+/*
+ * $RCSfile: IndexedQuadArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The IndexedQuadArray object draws the array of vertices as individual
+ * quadrilaterals. Each group
+ * of four vertices defines a quadrilateral to be drawn.
+ */
+
+class IndexedQuadArrayRetained extends IndexedGeometryArrayRetained {
+
+ IndexedQuadArrayRetained() {
+ this.geoType = GEO_TYPE_INDEXED_QUAD_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[4];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ int[] vtxIndexArr = new int[4];
+
+ //NVaidya
+ // Bug 447: While loops below now traverse over all
+ // elements in the valid index range from initialIndexIndex
+ // to initialIndexInex + validIndexCount - 1
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+ pnts[3] = new Point3d();
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < loopStopIndex) {
+ for(int j=0; j<4; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectRay(pnts, pickRay, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+
+ while (i < loopStopIndex) {
+ for(int j=0; j<4; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectSegment(pnts, pickSegment.start,
+ pickSegment.end, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+ while (i < loopStopIndex) {
+ for(int j=0; j<4; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+ while (i < loopStopIndex) {
+ for(int j=0; j<4; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectBoundingSphere(pnts, bsphere, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+ while (i < loopStopIndex) {
+ for(int j=0; j<4; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectBoundingPolytope(pnts, bpolytope, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+ while (i < loopStopIndex) {
+ for(int j=0; j<4; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectCylinder(pnts, pickCylinder, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+ while (i < loopStopIndex) {
+ for(int j=0; j<4; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedQuadArrayRetained0"));
+ default:
+ throw new RuntimeException("PickShape not supported for intersection ");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+
+ }
+
+ // intersect pnts[] with every quad in this object
+ boolean intersect(Point3d[] pnts) {
+ Point3d[] points = new Point3d[4];
+ double dist[] = new double[1];
+ //NVaidya
+ // Bug 447: correction for loop indices
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+ points[2] = new Point3d();
+ points[3] = new Point3d();
+
+ switch (pnts.length) {
+ case 3: // Triangle
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ if (intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[1], pnts[2]) ||
+ intersectTriTri(points[0], points[2], points[3],
+ pnts[0], pnts[1], pnts[2])) {
+ return true;
+ }
+ }
+ break;
+ case 4: // Quad
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ if (intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[1], pnts[2]) ||
+ intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[2], pnts[3]) ||
+ intersectTriTri(points[0], points[2], points[3],
+ pnts[0], pnts[1], pnts[2]) ||
+ intersectTriTri(points[0], points[2], points[3],
+ pnts[0], pnts[2], pnts[3])) {
+ return true;
+ }
+ }
+ break;
+ case 2: // Line
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ if (intersectSegment(points, pnts[0], pnts[1], dist,
+ null)) {
+ return true;
+ }
+ }
+ break;
+ case 1: // Point
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ if (intersectTriPnt(points[0], points[1], points[2],
+ pnts[0]) ||
+ intersectTriPnt(points[0], points[2], points[3],
+ pnts[0])) {
+ return true;
+ }
+ }
+ break;
+ }
+ return false;
+ }
+
+
+ boolean intersect(Transform3D thisToOtherVworld,
+ GeometryRetained geom) {
+
+ Point3d[] points = new Point3d[4];
+ //NVaidya
+ // Bug 447: correction for loop indices
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+ points[2] = new Point3d();
+ points[3] = new Point3d();
+
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ thisToOtherVworld.transform(points[0]);
+ thisToOtherVworld.transform(points[1]);
+ thisToOtherVworld.transform(points[2]);
+ thisToOtherVworld.transform(points[3]);
+ if (geom.intersect(points)) {
+ return true;
+ }
+ } // for each quad
+ return false;
+ }
+
+ // the bounds argument is already transformed
+ boolean intersect(Bounds targetBound) {
+ Point3d[] points = new Point3d[4];
+ //NVaidya
+ // Bug 447: correction for loop indices
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+ points[2] = new Point3d();
+ points[3] = new Point3d();
+
+ switch(targetBound.getPickType()) {
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox box = (BoundingBox) targetBound;
+
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ if (intersectBoundingBox(points, box, null, null)) {
+ return true;
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere) targetBound;
+
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ if (intersectBoundingSphere(points, bsphere, null,
+ null)) {
+ return true;
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope) targetBound;
+ while (i < loopStopIndex) {
+ getVertexData(indexCoord[i++], points[0]);
+ getVertexData(indexCoord[i++], points[1]);
+ getVertexData(indexCoord[i++], points[2]);
+ getVertexData(indexCoord[i++], points[3]);
+ if (intersectBoundingPolytope(points, bpolytope, null, null)) {
+ return true;
+ }
+ }
+ break;
+ default:
+ throw new RuntimeException("Bounds not supported for intersection "
+ + targetBound);
+ }
+ return false;
+ }
+
+
+ int getClassType() {
+ return QUAD_TYPE;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleArray.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleArray.java
new file mode 100644
index 0000000..ee2dc69
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleArray.java
@@ -0,0 +1,225 @@
+/*
+ * $RCSfile: IndexedTriangleArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The IndexedTriangleArray object draws the array of vertices as individual
+ * triangles. Each group
+ * of three vertices defines a triangle to be drawn.
+ */
+
+public class IndexedTriangleArray extends IndexedGeometryArray {
+
+ /**
+ * Package scoped default constructor.
+ */
+ IndexedTriangleArray() {
+ }
+
+ /**
+ * Constructs an empty IndexedTriangleArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 3, or indexCount is not
+ * a multiple of 3
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public IndexedTriangleArray(int vertexCount, int vertexFormat, int indexCount) {
+ super(vertexCount,vertexFormat, indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleArray0"));
+
+ if (indexCount < 3 || ((indexCount%3) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedTriangleArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 3, or indexCount is not
+ * a multiple of 3
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedTriangleArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleArray0"));
+
+ if (indexCount < 3 || ((indexCount%3) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedTriangleArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 3, or indexCount is not
+ * a multiple of 3
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedTriangleArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleArray0"));
+
+ if (indexCount < 3 || ((indexCount%3) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleArray1"));
+ }
+
+ /**
+ * Creates the retained mode IndexedTriangleArrayRetained object that this
+ * IndexedTriangleArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new IndexedTriangleArrayRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ IndexedTriangleArrayRetained rt = (IndexedTriangleArrayRetained) retained;
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ IndexedTriangleArray t = new IndexedTriangleArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ rt.getIndexCount());
+ t.duplicateNodeComponent(this);
+ return t;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleArrayRetained.java
new file mode 100644
index 0000000..dca0208
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleArrayRetained.java
@@ -0,0 +1,440 @@
+/*
+ * $RCSfile: IndexedTriangleArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.9 $
+ * $Date: 2008/02/28 20:17:24 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The IndexedTriangleArray object draws the array of vertices as individual
+ * triangles. Each group
+ * of three vertices defines a triangle to be drawn.
+ */
+
+class IndexedTriangleArrayRetained extends IndexedGeometryArrayRetained {
+
+ IndexedTriangleArrayRetained() {
+ this.geoType = GEO_TYPE_INDEXED_TRI_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[3];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ int[] vtxIndexArr = new int[3];
+
+ //NVaidya
+ // Bug 447: While loops below now traverse over all
+ // elements in the valid index range from initialIndexIndex
+ // to initialIndexInex + validIndexCount - 1
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < loopStopIndex) {
+ for(int j=0; j<3; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectRay(pnts, pickRay, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+ while (i < loopStopIndex) {
+ for(int j=0; j<3; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectSegment(pnts, pickSegment.start,
+ pickSegment.end, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < loopStopIndex) {
+ for(int j=0; j<3; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < loopStopIndex) {
+ for(int j=0; j<3; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectBoundingSphere(pnts, bsphere, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < loopStopIndex) {
+ for(int j=0; j<3; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectBoundingPolytope(pnts, bpolytope,
+ sdist,iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+ while (i < loopStopIndex) {
+ for(int j=0; j<3; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectCylinder(pnts, pickCylinder, sdist,
+ iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < loopStopIndex) {
+ for(int j=0; j<3; j++) {
+ vtxIndexArr[j] = indexCoord[i];
+ getVertexData(indexCoord[i++], pnts[j]);
+ }
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleArrayRetained0"));
+ default:
+ throw new RuntimeException ("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+ }
+
+ // intersect pnts[] with every triangle in this object
+ boolean intersect(Point3d[] pnts) {
+ Point3d[] points = new Point3d[3];
+ double dist[] = new double[1];
+ //NVaidya
+ // Bug 447: correction for loop indices
+ int i = initialIndexIndex;
+ int loopStopIndex = initialIndexIndex + validIndexCount;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+ points[2] = new Point3d();
+
+ switch (pnts.length) {
+ case 3: // Triangle
+ while (i
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedTriangleFanArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleFanArray0"));
+
+ if (indexCount < 3 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleFanArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedTriangleFanArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts
+ * see {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 3,
+ * or any element in the stripIndexCounts array is less than 3
+ * ;
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedTriangleFanArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleFanArray0"));
+
+ if (indexCount < 3 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleFanArray1"));
+ }
+
+ /**
+ * Creates the retained mode IndexedTriangleFanArrayRetained object that this
+ * IndexedTriangleFanArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new IndexedTriangleFanArrayRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ IndexedTriangleFanArrayRetained rt =
+ (IndexedTriangleFanArrayRetained) retained;
+ int stripIndexCounts[] = new int[rt.getNumStrips()];
+ rt.getStripIndexCounts(stripIndexCounts);
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ IndexedTriangleFanArray t = new IndexedTriangleFanArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ rt.getIndexCount(),
+ stripIndexCounts);
+ t.duplicateNodeComponent(this);
+ return t;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleFanArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleFanArrayRetained.java
new file mode 100644
index 0000000..89bdb07
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleFanArrayRetained.java
@@ -0,0 +1,513 @@
+/*
+ * $RCSfile: IndexedTriangleFanArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The IndexedTriangleFanArray object draws an array of vertices as a set of
+ * connected triangle fans. An array of per-strip
+ * vertex counts specifies where the separate strips (fans) appear
+ * in the vertex array. For every strip in the set,
+ * each vertex, beginning with the third vertex in the array,
+ * defines a triangle to be drawn using the current vertex,
+ * the previous vertex and the first vertex. This can be thought of
+ * as a collection of convex polygons.
+ */
+
+class IndexedTriangleFanArrayRetained extends IndexedGeometryStripArrayRetained {
+
+ IndexedTriangleFanArrayRetained(){
+ geoType = GEO_TYPE_INDEXED_TRI_FAN_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[3];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ int i = 0;
+ int j, scount, count = 0;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+ int[] vtxIndexArr = new int[3];
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectRay(pnts, pickRay, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectSegment(pnts, pickSegment.start,
+ pickSegment.end, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingSphere(pnts, bsphere, sdist,
+ iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingPolytope(pnts, bpolytope,
+ sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectCylinder(pnts, pickCylinder, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleFanArrayRetained0"));
+ default:
+ throw new RuntimeException ("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+ }
+
+ // intersect pnts[] with every triangle in this object
+ boolean intersect(Point3d[] pnts) {
+ int j, end;
+ Point3d[] points = new Point3d[3];
+ double dist[] = new double[1];
+ int i = 0, scount, count = 0;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+ points[2] = new Point3d();
+
+ switch (pnts.length) {
+ case 3: // Triangle
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[1], pnts[2])) {
+ return true;
+ }
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ case 4: // Quad
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[1], pnts[2]) ||
+ intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[2], pnts[3])) {
+ return true;
+ }
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ case 2: // Line
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectSegment(points, pnts[0], pnts[1],
+ dist, null)) {
+ return true;
+ }
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ case 1: // Point
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectTriPnt(points[0], points[1], points[2],
+ pnts[0])) {
+ return true;
+ }
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ }
+ return false;
+ }
+
+ boolean intersect(Transform3D thisToOtherVworld, GeometryRetained geom) {
+ int i = 0, j, scount, count = 0;
+ Point3d[] pnts = new Point3d[3];
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ thisToOtherVworld.transform(pnts[0]);
+ thisToOtherVworld.transform(pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ thisToOtherVworld.transform(pnts[2]);
+ if (geom.intersect(pnts)) {
+ return true;
+ }
+ pnts[1].set(pnts[2]);
+ }
+ }
+ return false;
+ }
+
+ // the bounds argument is already transformed
+ boolean intersect(Bounds targetBound) {
+ int i = 0;
+ int j, scount, count = 0;
+ Point3d[] pnts = new Point3d[3];
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+
+ switch(targetBound.getPickType()) {
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox box = (BoundingBox) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingBox(pnts, box, null, null)) {
+ return true;
+ }
+ pnts[1].set(pnts[2]);
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingSphere(pnts, bsphere, null, null)) {
+ return true;
+ }
+ pnts[1].set(pnts[2]);
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingPolytope(pnts, bpolytope, null, null)) {
+ return true;
+ }
+ pnts[1].set(pnts[2]);
+ }
+ }
+ break;
+ default:
+ throw new RuntimeException("Bounds not supported for intersection "
+ + targetBound);
+ }
+ return false;
+ }
+
+ int getClassType() {
+ return TRIANGLE_TYPE;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleStripArray.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleStripArray.java
new file mode 100644
index 0000000..6d959d4
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleStripArray.java
@@ -0,0 +1,251 @@
+/*
+ * $RCSfile: IndexedTriangleStripArray.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The IndexedTriangleStripArray object draws an array of vertices as a set of
+ * connected triangle strips. An array of per-strip index counts specifies
+ * where the separate strips appear in the indexed vertex array.
+ * For every strip in the set,
+ * each vertex, beginning with the third vertex in the array,
+ * defines a triangle to be drawn using the current vertex and
+ * the two previous vertices.
+ */
+
+public class IndexedTriangleStripArray extends IndexedGeometryStripArray {
+
+ /**
+ * Package scoped default constructor
+ */
+ IndexedTriangleStripArray() {
+ }
+
+ /**
+ * Constructs an empty IndexedTriangleStripArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int)}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts
+ * see {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 3,
+ * or any element in the stripIndexCounts array is less than 3
+ * ;
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ */
+ public IndexedTriangleStripArray(int vertexCount,
+ int vertexFormat,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat, indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArray0"));
+
+ if (indexCount < 3 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedTriangleStripArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts
+ * see {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 3,
+ * or any element in the stripIndexCounts array is less than 3
+ * ;
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public IndexedTriangleStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArray0"));
+
+ if (indexCount < 3 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArray1"));
+ }
+
+ /**
+ * Constructs an empty IndexedTriangleStripArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param indexCount
+ * see {@link IndexedGeometryArray#IndexedGeometryArray(int,int,int,int[],int,int[],int)}
+ * for a description of this parameter.
+ *
+ * @param stripIndexCounts
+ * see {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 1,
+ * or indexCount is less than 3,
+ * or any element in the stripIndexCounts array is less than 3
+ * ;
+ * See {@link IndexedGeometryStripArray#IndexedGeometryStripArray(int,int,int,int[],int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public IndexedTriangleStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int indexCount,
+ int[] stripIndexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ indexCount, stripIndexCounts);
+
+ if (vertexCount < 1)
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArray0"));
+
+ if (indexCount < 3 )
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArray1"));
+ }
+
+ /**
+ * Creates the retained mode IndexedTriangleStripArrayRetained object that this
+ * IndexedTriangleStripArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new IndexedTriangleStripArrayRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ IndexedTriangleStripArrayRetained rt =
+ (IndexedTriangleStripArrayRetained) retained;
+ int stripIndexCounts[] = new int[rt.getNumStrips()];
+ rt.getStripIndexCounts(stripIndexCounts);
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ IndexedTriangleStripArray t = new IndexedTriangleStripArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ rt.getIndexCount(),
+ stripIndexCounts);
+ t.duplicateNodeComponent(this);
+ return t;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleStripArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleStripArrayRetained.java
new file mode 100644
index 0000000..8558065
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedTriangleStripArrayRetained.java
@@ -0,0 +1,534 @@
+/*
+ * $RCSfile: IndexedTriangleStripArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The IndexedTriangleStripArray object draws an array of vertices as a set of
+ * connected triangle strips. An array of per-strip vertex counts specifies
+ * where the separate strips appear in the vertex array.
+ * For every strip in the set,
+ * each vertex, beginning with the third vertex in the array,
+ * defines a triangle to be drawn using the current vertex and
+ * the two previous vertices.
+ */
+
+class IndexedTriangleStripArrayRetained extends IndexedGeometryStripArrayRetained {
+
+ IndexedTriangleStripArrayRetained(){
+ geoType = GEO_TYPE_INDEXED_TRI_STRIP_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[3];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ int i = 0;
+ int j, scount, count = 0;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+ int[] vtxIndexArr = new int[3];
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectRay(pnts, pickRay, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectSegment(pnts, pickSegment.start,
+ pickSegment.end, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingSphere(pnts, bsphere, sdist,
+ iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingPolytope(pnts, bpolytope,
+ sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectCylinder(pnts, pickCylinder, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < stripIndexCounts.length) {
+ for(int k=0; k<2; k++) {
+ vtxIndexArr[k] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[k]);
+ }
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ vtxIndexArr[2] = indexCoord[count];
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ pnts[1].set(pnts[2]);
+ vtxIndexArr[1] = vtxIndexArr[2];
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("IndexedTriangleStripArrayRetained0"));
+ default:
+ throw new RuntimeException ("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+ }
+
+ // intersect pnts[] with every triangle in this object
+ boolean intersect(Point3d[] pnts) {
+ int j, end;
+ Point3d[] points = new Point3d[3];
+ double dist[] = new double[1];
+ int i = 0, scount, count = 0;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+ points[2] = new Point3d();
+
+ switch (pnts.length) {
+ case 3: // Triangle
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[1], pnts[2])) {
+ return true;
+ }
+ points[0].set(points[1]);
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ case 4: // Quad
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[1], pnts[2]) ||
+ intersectTriTri(points[0], points[1], points[2],
+ pnts[0], pnts[2], pnts[3])) {
+ return true;
+ }
+ points[0].set(points[1]);
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ case 2: // Line
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectSegment(points, pnts[0], pnts[1],
+ dist, null)) {
+ return true;
+ }
+ points[0].set(points[1]);
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ case 1: // Point
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], points[0]);
+ getVertexData(indexCoord[count++], points[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], points[2]);
+ if (intersectTriPnt(points[0], points[1], points[2],
+ pnts[0])) {
+ return true;
+ }
+ points[0].set(points[1]);
+ points[1].set(points[2]);
+ }
+ }
+ break;
+ }
+ return false;
+ }
+
+ boolean intersect(Transform3D thisToOtherVworld, GeometryRetained geom) {
+ int i = 0, j, scount, count = 0;
+ Point3d[] pnts = new Point3d[3];
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ thisToOtherVworld.transform(pnts[0]);
+ thisToOtherVworld.transform(pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ thisToOtherVworld.transform(pnts[2]);
+ if (geom.intersect(pnts)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ pnts[1].set(pnts[2]);
+ }
+ }
+ return false;
+ }
+
+ // the bounds argument is already transformed
+ boolean intersect(Bounds targetBound) {
+ int i = 0;
+ int j, scount, count = 0;
+ Point3d[] pnts = new Point3d[3];
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ pnts[2] = new Point3d();
+
+ switch(targetBound.getPickType()) {
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox box = (BoundingBox) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingBox(pnts, box, null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ pnts[1].set(pnts[2]);
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingSphere(pnts, bsphere, null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ pnts[1].set(pnts[2]);
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope) targetBound;
+
+ while (i < stripIndexCounts.length) {
+ getVertexData(indexCoord[count++], pnts[0]);
+ getVertexData(indexCoord[count++], pnts[1]);
+ scount = stripIndexCounts[i++];
+ for (j=2; j < scount; j++) {
+ getVertexData(indexCoord[count++], pnts[2]);
+ if (intersectBoundingPolytope(pnts, bpolytope, null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ pnts[1].set(pnts[2]);
+ }
+ }
+ break;
+ default:
+ throw new RuntimeException("Bounds not supported for intersection "
+ + targetBound);
+ }
+ return false;
+ }
+
+ int getClassType() {
+ return TRIANGLE_TYPE;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/IndexedUnorderSet.java b/j3d-core/src/classes/share/javax/media/j3d/IndexedUnorderSet.java
new file mode 100644
index 0000000..e3a45c0
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/IndexedUnorderSet.java
@@ -0,0 +1,617 @@
+/*
+ * $RCSfile: IndexedUnorderSet.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A strongly type indexed unorder set.
+ * All operations remove(IndexedObject, ListType), add(IndexedObject, ListType),
+ * contains(IndexedObject, ListType) etc. take O(1) time.
+ * The class is designed to optimize speed. So many reductance
+ * procedures call and range check as found in ArrayList are
+ * removed.
+ *
+ *
+ * IndexedUnorderSet IUset =
+ * new IndexedUnorderSet(YourClass.class, listType);
+ * // add element here
+ *
+ * YourClass[] arr = (YourClass []) IUset.toArray();
+ * int size = IUset.arraySize();
+ * for (int i=0; i < size; i++) {
+ * YourClass obj = arr[i];
+ * ....
+ * }
+ *
+ *
+ *
+ * 1) The array return is a copied of internal array.
+ *
+ *
+ * 2) Don't use arr.length , use IUset.arraySize();
+ * 3) IndexedObject contains an array of listIndex, the number of
+ * array elements depends on the number of different types of
+ * IndexedUnorderSet that use it.
+ * 4) No need to do casting for individual element as in ArrayList.
+ * 5) IndexedUnorderSet is thread safe.
+ * 6) Object implement this interface MUST initialize the index to -1.
+ *
+ * 1) Order of IndexedObject in list is not important
+ */
+
+class IndexedUnorderSet implements Cloneable, java.io.Serializable {
+
+ // XXXX: set to false when release
+ final static boolean debug = false;
+
+ /**
+ * The array buffer into which the elements of the ArrayList are stored.
+ * The capacity of the ArrayList is the length of this array buffer.
+ *
+ * It is non-private to enable compiler do inlining for get(),
+ * set(), remove() when -O flag turn on.
+ */
+ transient IndexedObject elementData[];
+
+ /**
+ * Clone copy of elementData return by toArray(true);
+ */
+ transient Object cloneData[];
+ // size of the above clone objec.
+ transient int cloneSize;
+
+ transient boolean isDirty = true;
+
+ /**
+ * Component Type of individual array element entry
+ */
+ Class componentType;
+
+ /**
+ * The size of the ArrayList (the number of elements it contains).
+ *
+ * We make it non-private to enable compiler do inlining for
+ * getSize() when -O flag turn on.
+ */
+ int size;
+
+ int listType;
+
+ // Current VirtualUniverse using this structure
+ VirtualUniverse univ;
+
+ /**
+ * Constructs an empty list with the specified initial capacity.
+ * and the class data Type
+ *
+ * @param initialCapacity the initial capacity of the list.
+ * @param componentType class type of element in the list.
+ */
+ IndexedUnorderSet(int initialCapacity, Class componentType,
+ int listType, VirtualUniverse univ) {
+ this.componentType = componentType;
+ this.elementData = (IndexedObject[])java.lang.reflect.Array.newInstance(
+ componentType, initialCapacity);
+ this.listType = listType;
+ this.univ = univ;
+ }
+
+ /**
+ * Constructs an empty list.
+ * @param componentType class type of element in the list.
+ */
+ IndexedUnorderSet(Class componentType, int listType,
+ VirtualUniverse univ) {
+ this(10, componentType, listType, univ);
+ }
+
+
+ /**
+ * Constructs an empty list with the specified initial capacity.
+ *
+ * @param initialCapacity the initial capacity of the list.
+ */
+ IndexedUnorderSet(int initialCapacity, int listType,
+ VirtualUniverse univ) {
+ this(initialCapacity, IndexedObject.class, listType, univ);
+ }
+
+ /**
+ * Constructs an empty list.
+ * @param listType default to Object.
+ */
+ IndexedUnorderSet(int listType, VirtualUniverse univ) {
+ this(10, IndexedObject.class, listType, univ);
+ }
+
+ /**
+ * Initialize all indexes to -1
+ */
+ final static void init(IndexedObject obj, int len) {
+ obj.listIdx = new int[3][];
+
+ obj.listIdx[0] = new int[len];
+ obj.listIdx[1] = new int[len];
+ obj.listIdx[2] = new int[1];
+
+ for (int i=0; i < len; i++) {
+ obj.listIdx[0][i] = -1;
+ obj.listIdx[1][i] = -1;
+ }
+
+ // Just want to set both RenderMolecule idx
+ // and BehaviorRetained idx to 0 by default
+ // It is OK without the following lines
+ if (obj instanceof SceneGraphObjectRetained) {
+ // setlive() will change this back to 0
+ obj.listIdx[2][0] = 1;
+ } else {
+ obj.listIdx[2][0] = 0;
+ }
+ }
+
+ /**
+ * Returns the number of elements in this list.
+ *
+ * @return the number of elements in this list.
+ */
+ final int size() {
+ return size;
+ }
+
+
+ /**
+ * Returns the size of entry use in toArray() number of elements
+ * in this list.
+ *
+ * @return the number of elements in this list.
+ */
+ final int arraySize() {
+ return cloneSize;
+ }
+
+ /**
+ * Tests if this list has no elements.
+ *
+ * @return true if this list has no elements;
+ * false otherwise.
+ */
+ final boolean isEmpty() {
+ return size == 0;
+ }
+
+ /**
+ * Returns true if this list contains the specified element.
+ *
+ * @param o element whose presence in this List is to be tested.
+ */
+ synchronized final boolean contains(IndexedObject o) {
+ return (o.listIdx[o.getIdxUsed(univ)][listType] >= 0);
+ }
+
+
+ /**
+ * Searches for the last occurence of the given argument, testing
+ * for equality using the equals method.
+ *
+ * @param o an object.
+ * @return the index of the first occurrence of the argument in this
+ * list; returns -1 if the object is not found.
+ * @see Object#equals(Object)
+ */
+ synchronized final int indexOf(IndexedObject o) {
+ return o.listIdx[o.getIdxUsed(univ)][listType];
+ }
+
+ /**
+ * Returns a shallow copy of this ArrayList instance. (The
+ * elements themselves are not copied.)
+ *
+ * @return a clone of this ArrayList instance.
+ */
+ synchronized protected final Object clone() {
+ try {
+ IndexedUnorderSet v = (IndexedUnorderSet)super.clone();
+ v.elementData = (IndexedObject[])java.lang.reflect.Array.newInstance(
+ componentType, size);
+ System.arraycopy(elementData, 0, v.elementData, 0, size);
+ isDirty = true; // can't use the old cloneData reference
+ return v;
+ } catch (CloneNotSupportedException e) {
+ // this shouldn't happen, since we are Cloneable
+ throw new InternalError();
+ }
+ }
+
+
+ /**
+ * Returns an array containing all of the elements in this list.
+ * The size of the array may longer than the actual size. Use
+ * arraySize() to retrieve the size.
+ * The array return is a copied of internal array. if copy
+ * is true.
+ *
+ * @return an array containing all of the elements in this list
+ */
+ synchronized final Object[] toArray(boolean copy) {
+ if (copy) {
+ if (isDirty) {
+ if ((cloneData == null) || cloneData.length < size) {
+ cloneData = (Object[])java.lang.reflect.Array.newInstance(
+ componentType, size);
+ }
+ System.arraycopy(elementData, 0, cloneData, 0, size);
+ cloneSize = size;
+ isDirty = false;
+ }
+ return cloneData;
+ } else {
+ cloneSize = size;
+ return elementData;
+ }
+
+ }
+
+ /**
+ * Returns an array containing all of the elements in this list.
+ * The size of the array may longer than the actual size. Use
+ * arraySize() to retrieve the size.
+ * The array return is a copied of internal array. So another
+ * thread can continue add/delete the current list. However,
+ * it should be noticed that two call to toArray() may return
+ * the same copy.
+ *
+ * @return an array containing all of the elements in this list
+ */
+ synchronized final Object[] toArray() {
+ return toArray(true);
+ }
+
+
+ /**
+ * Returns an array containing elements starting from startElement
+ * all of the elements in this list. A new array of exact size
+ * is always allocated.
+ *
+ * @param startElement starting element to copy
+ *
+ * @return an array containing elements starting from
+ * startElement, null if element not found.
+ *
+ */
+ synchronized final Object[] toArray(IndexedObject startElement) {
+ int idx = indexOf(startElement);
+ if (idx < 0) {
+ return (Object[])java.lang.reflect.Array.newInstance(componentType, 0);
+ }
+
+ int s = size - idx;
+ Object data[] = (Object[])java.lang.reflect.Array.newInstance(componentType, s);
+ System.arraycopy(elementData, idx, data, 0, s);
+ return data;
+ }
+
+ /**
+ * Trims the capacity of this ArrayList instance to be the
+ * list's current size. An application can use this operation to minimize
+ * the storage of an ArrayList instance.
+ */
+ synchronized final void trimToSize() {
+ if (elementData.length > size) {
+ Object oldData[] = elementData;
+ elementData = (IndexedObject[])java.lang.reflect.Array.newInstance(
+ componentType,
+ size);
+ System.arraycopy(oldData, 0, elementData, 0, size);
+ }
+ }
+
+
+ // Positional Access Operations
+
+ /**
+ * Returns the element at the specified position in this list.
+ *
+ * @param index index of element to return.
+ * @return the element at the specified position in this list.
+ * @throws IndexOutOfBoundsException if index is out of range (index
+ * < 0 || index >= size()).
+ */
+ synchronized final Object get(int index) {
+ return elementData[index];
+ }
+
+ /**
+ * Replaces the element at the specified position in this list with
+ * the specified element.
+ *
+ * @param index index of element to replace.
+ * @param o element to be stored at the specified position.
+ * @return the element previously at the specified position.
+ * @throws IndexOutOfBoundsException if index out of range
+ * (index < 0 || index >= size()).
+ */
+ synchronized final void set(int index, IndexedObject o) {
+ IndexedObject oldElm = elementData[index];
+ if (oldElm != null) {
+ oldElm.listIdx[oldElm.getIdxUsed(univ)][listType] = -1;
+ }
+ elementData[index] = o;
+
+ int univIdx = o.getIdxUsed(univ);
+
+ if (debug) {
+ if (o.listIdx[univIdx][listType] != -1) {
+ System.err.println("Illegal use of UnorderIndexedList idx in set " +
+ o.listIdx[univIdx][listType]);
+ Thread.dumpStack();
+ }
+ }
+
+ o.listIdx[univIdx][listType] = index;
+ isDirty = true;
+ }
+
+ /**
+ * Appends the specified element to the end of this list.
+ * It is the user responsible to ensure that the element add is of
+ * the same type as array componentType.
+ *
+ * @param o element to be appended to this list.
+ */
+ synchronized final void add(IndexedObject o) {
+
+ if (elementData.length == size) {
+ IndexedObject oldData[] = elementData;
+ elementData = (IndexedObject[])java.lang.reflect.Array.newInstance(
+ componentType,
+ (size << 1));
+ System.arraycopy(oldData, 0, elementData, 0, size);
+
+ }
+
+ int univIdx = o.getIdxUsed(univ);
+
+ if (debug) {
+ int idx = o.listIdx[univIdx][listType];
+ if (idx >= 0) {
+ if (elementData[idx] != o) {
+ System.err.println("Illegal use of UnorderIndexedList idx in add " + idx);
+ Thread.dumpStack();
+ }
+ }
+ }
+
+ int idx = size++;
+ elementData[idx] = o;
+ o.listIdx[univIdx][listType] = idx;
+ isDirty = true;
+ }
+
+
+ /**
+ * Removes the element at the specified position in this list.
+ * Replace the removed element by the last one.
+ *
+ * @param index the index of the element to removed.
+ * @throws IndexOutOfBoundsException if index out of range (index
+ * < 0 || index >= size()).
+ */
+ synchronized final void remove(int index) {
+ IndexedObject elm = elementData[index];
+
+ int univIdx = elm.getIdxUsed(univ);
+
+ if (debug) {
+ if (elm.listIdx[univIdx][listType] != index) {
+ System.err.println("Inconsistent idx in remove, expect " + index + " actual " + elm.listIdx[univIdx][listType]);
+ Thread.dumpStack();
+ }
+ }
+
+ elm.listIdx[univIdx][listType] = -1;
+ size--;
+ if (index != size) {
+ elm = elementData[size];
+ elm.listIdx[univIdx][listType] = index;
+ elementData[index] = elm;
+ }
+ elementData[size] = null;
+ isDirty = true;
+ /*
+ if ((cloneData != null) && (index < cloneData.length)) {
+ cloneData[index] = null; // for gc
+ }
+ */
+ }
+
+
+ /**
+ * Removes the element at the last position in this list.
+ * @return The element remove
+ * @throws IndexOutOfBoundsException if array is empty
+ */
+ synchronized final Object removeLastElement() {
+ IndexedObject elm = elementData[--size];
+ elementData[size] = null;
+ elm.listIdx[elm.getIdxUsed(univ)][listType] = -1;
+ isDirty = true;
+ /*
+ if ((cloneData != null) && (size < cloneData.length)) {
+ cloneData[size] = null; // for gc
+ }
+ */
+ return elm;
+ }
+
+
+ /**
+ * Removes the specified element in this list.
+ * Replace the removed element by the last one.
+ *
+ * @param o the element to removed.
+ * @return true if object remove
+ * @throws IndexOutOfBoundsException if index out of range (index
+ * < 0 || index >= size()).
+ */
+ synchronized final boolean remove(IndexedObject o) {
+ int univIdx = o.getIdxUsed(univ);
+ int idx = o.listIdx[univIdx][listType];
+
+ if (idx >= 0) {
+ if (debug) {
+ if (o != elementData[idx]) {
+ System.err.println(this + " Illegal use of UnorderIndexedList in remove expect " + o + " actual " + elementData[idx] + " idx = " + idx);
+ Thread.dumpStack();
+ }
+ }
+ // Object in the container
+ size--;
+ if (idx != size) {
+ IndexedObject elm = elementData[size];
+ elementData[idx] = elm;
+ elm.listIdx[elm.getIdxUsed(univ)][listType] = idx;
+ }
+ elementData[size] = null;
+ o.listIdx[univIdx][listType] = -1;
+ isDirty = true;
+ return true;
+ }
+ return false;
+ }
+
+
+ /**
+ * Removes all of the elements from this list. The list will
+ * be empty after this call returns.
+ */
+ synchronized final void clear() {
+ IndexedObject o;
+ for (int i = size-1; i >= 0; i--) {
+ o = elementData[i];
+ o.listIdx[o.getIdxUsed(univ)][listType] = -1;
+ elementData[i] = null; // Let gc do its work
+ }
+ size = 0;
+ isDirty = true;
+ }
+
+ synchronized final void clearMirror() {
+
+ if (cloneData != null) {
+ for (int i = cloneData.length-1; i >= 0; i--) {
+ // don't set index to -1 since the original
+ // copy is using this.
+ cloneData[i] = null; // Let gc do its work
+ }
+ }
+ cloneSize = 0;
+ isDirty = true;
+ }
+
+ final Class getComponentType() {
+ return componentType;
+ }
+
+ /*
+ synchronized public String toString() {
+ StringBuffer sb = new StringBuffer("Size = " + size + "\n[");
+ int len = size-1;
+ Object obj;
+
+ for (int i=0; i < size; i++) {
+ obj = elementData[i];
+ if (obj != null) {
+ sb.append(elementData[i].toString());
+ } else {
+ sb.append("NULL");
+ }
+ if (i != len) {
+ sb.append(", ");
+ }
+ }
+ sb.append("]\n");
+ return sb.toString();
+ }
+ */
+
+
+ /**
+ * Save the state of the ArrayList instance to a stream (that
+ * is, serialize it).
+ *
+ * @serialData The length of the array backing the ArrayList
+ * instance is emitted (int), followed by all of its elements
+ * (each an Object) in the proper order.
+ */
+ private synchronized void writeObject(java.io.ObjectOutputStream s)
+ throws java.io.IOException{
+ // Write out element count, and any hidden stuff
+ s.defaultWriteObject();
+
+ // Write out array length
+ s.writeInt(elementData.length);
+
+ // Write out all elements in the proper order.
+ for (int i=0; i
+ * 2) Can't modify the clone() copy.
+ * 3) IndexedObject can't be null
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ Interpolator it = (Interpolator) originalNode;
+
+ Alpha a = it.getAlpha();
+ if (a != null) {
+ setAlpha(a.cloneAlpha());
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3DBuffer.java b/j3d-core/src/classes/share/javax/media/j3d/J3DBuffer.java
new file mode 100644
index 0000000..0169ae3
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3DBuffer.java
@@ -0,0 +1,247 @@
+/*
+ * $RCSfile: J3DBuffer.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import com.sun.j3d.internal.ByteBufferWrapper;
+import com.sun.j3d.internal.BufferWrapper;
+import com.sun.j3d.internal.FloatBufferWrapper;
+import com.sun.j3d.internal.DoubleBufferWrapper;
+import com.sun.j3d.internal.ByteOrderWrapper;
+
+/**
+ * Java 3D wrapper class for java.nio.Buffer objects.
+ * When used to wrap a non-null NIO buffer object, this class will
+ * create a read-only view of the wrapped NIO buffer, and will call
+ * rewind on the read-only view, so that elements 0
+ * through buffer.limit()-1 will be available internally.
+ *
+ * @see GeometryArray#setCoordRefBuffer(J3DBuffer)
+ * @see GeometryArray#setColorRefBuffer(J3DBuffer)
+ * @see GeometryArray#setNormalRefBuffer(J3DBuffer)
+ * @see GeometryArray#setTexCoordRefBuffer(int,J3DBuffer)
+ * @see GeometryArray#setVertexAttrRefBuffer(int,J3DBuffer)
+ * @see GeometryArray#setInterleavedVertexBuffer(J3DBuffer)
+ * @see CompressedGeometry#CompressedGeometry(CompressedGeometryHeader,J3DBuffer)
+ *
+ * @since Java 3D 1.3
+ */
+
+public class J3DBuffer {
+ static final int TYPE_NULL = 0;
+ static final int TYPE_UNKNOWN = 1;
+ static final int TYPE_BYTE = 2;
+ static final int TYPE_CHAR = 3;
+ static final int TYPE_SHORT = 4;
+ static final int TYPE_INT = 5;
+ static final int TYPE_LONG = 6;
+ static final int TYPE_FLOAT = 7;
+ static final int TYPE_DOUBLE = 8;
+
+ static boolean unsupportedOperation = false;
+
+ private java.nio.Buffer originalBuffer = null;
+ private BufferWrapper bufferImpl = null;
+ private int bufferType = TYPE_NULL;
+
+ /**
+ * Constructs a J3DBuffer object and initializes it with
+ * a null NIO buffer object. The NIO buffer object
+ * must be set to a non-null value before using this J3DBuffer
+ * object in a Java 3D node component.
+ *
+ * @exception UnsupportedOperationException if the JVM does not
+ * support native access to direct NIO buffers
+ */
+ public J3DBuffer() {
+ this(null);
+ }
+
+
+ /**
+ * Constructs a J3DBuffer object and initializes it with
+ * the specified NIO buffer object.
+ *
+ * @param buffer the NIO buffer wrapped by this J3DBuffer
+ *
+ * @exception UnsupportedOperationException if the JVM does not
+ * support native access to direct NIO buffers
+ *
+ * @exception IllegalArgumentException if the specified buffer is
+ * not a direct buffer, or if the byte order of the specified
+ * buffer does not match the native byte order of the underlying
+ * platform.
+ */
+ public J3DBuffer(java.nio.Buffer buffer) {
+ if (unsupportedOperation)
+ throw new UnsupportedOperationException(J3dI18N.getString("J3DBuffer0"));
+
+ setBuffer(buffer);
+ }
+
+
+ /**
+ * Sets the NIO buffer object in this J3DBuffer to
+ * the specified object.
+ *
+ * @param buffer the NIO buffer wrapped by this J3DBuffer
+ *
+ * @exception IllegalArgumentException if the specified buffer is
+ * not a direct buffer, or if the byte order of the specified
+ * buffer does not match the native byte order of the underlying
+ * platform.
+ */
+ public void setBuffer(java.nio.Buffer buffer) {
+ int bType = TYPE_NULL;
+ boolean direct = false;
+ java.nio.ByteOrder order = java.nio.ByteOrder.BIG_ENDIAN;
+
+ if (buffer == null) {
+ bType = TYPE_NULL;
+ }
+ else if (buffer instanceof java.nio.ByteBuffer) {
+ bType = TYPE_BYTE;
+ direct = ((java.nio.ByteBuffer)buffer).isDirect();
+ order = ((java.nio.ByteBuffer)buffer).order();
+ }
+ else if (buffer instanceof java.nio.CharBuffer) {
+ bType = TYPE_CHAR;
+ direct = ((java.nio.CharBuffer)buffer).isDirect();
+ order = ((java.nio.CharBuffer)buffer).order();
+ }
+ else if (buffer instanceof java.nio.ShortBuffer) {
+ bType = TYPE_SHORT;
+ direct = ((java.nio.ShortBuffer)buffer).isDirect();
+ order = ((java.nio.ShortBuffer)buffer).order();
+ }
+ else if (buffer instanceof java.nio.IntBuffer) {
+ bType = TYPE_INT;
+ direct = ((java.nio.IntBuffer)buffer).isDirect();
+ order = ((java.nio.IntBuffer)buffer).order();
+ }
+ else if (buffer instanceof java.nio.LongBuffer) {
+ bType = TYPE_LONG;
+ direct = ((java.nio.LongBuffer)buffer).isDirect();
+ order = ((java.nio.LongBuffer)buffer).order();
+ }
+ else if (buffer instanceof java.nio.FloatBuffer) {
+ bType = TYPE_FLOAT;
+ direct = ((java.nio.FloatBuffer)buffer).isDirect();
+ order = ((java.nio.FloatBuffer)buffer).order();
+ }
+ else if (buffer instanceof java.nio.DoubleBuffer) {
+ bType = TYPE_DOUBLE;
+ direct = ((java.nio.DoubleBuffer)buffer).isDirect();
+ order = ((java.nio.DoubleBuffer)buffer).order();
+ }
+ else {
+ bType = TYPE_UNKNOWN;
+ }
+
+ // Verify that the buffer is direct and has the correct byte order
+ if (buffer != null) {
+ if (!direct) {
+ throw new IllegalArgumentException(J3dI18N.getString("J3DBuffer1"));
+ }
+
+ if (order != java.nio.ByteOrder.nativeOrder()) {
+ throw new IllegalArgumentException(J3dI18N.getString("J3DBuffer2"));
+ }
+ }
+
+ bufferType = bType;
+ originalBuffer = buffer;
+
+ // Make a read-only view of the buffer if the type is one
+ // of the internally supported types: byte, float, or double
+ switch (bufferType) {
+ case TYPE_BYTE:
+ java.nio.ByteBuffer byteBuffer =
+ ((java.nio.ByteBuffer)buffer).asReadOnlyBuffer();
+ byteBuffer.rewind();
+ bufferImpl = new ByteBufferWrapper(byteBuffer);
+ break;
+ case TYPE_FLOAT:
+ java.nio.FloatBuffer floatBuffer =
+ ((java.nio.FloatBuffer)buffer).asReadOnlyBuffer();
+ floatBuffer.rewind();
+ bufferImpl = new FloatBufferWrapper(floatBuffer);
+ break;
+ case TYPE_DOUBLE:
+ java.nio.DoubleBuffer doubleBuffer =
+ ((java.nio.DoubleBuffer)buffer).asReadOnlyBuffer();
+ doubleBuffer.rewind();
+ bufferImpl = new DoubleBufferWrapper(doubleBuffer);
+ break;
+ default:
+ bufferImpl = null;
+ }
+ }
+
+
+ /**
+ * Retrieves the NIO buffer object from this J3DBuffer.
+ *
+ * @return the current NIO buffer wrapped by this J3DBuffer
+ */
+ public java.nio.Buffer getBuffer() {
+ return originalBuffer;
+ }
+
+
+ int getBufferType() {
+ return bufferType;
+ }
+
+
+ BufferWrapper getBufferImpl() {
+ return bufferImpl;
+ }
+
+ private static boolean checkNativeBufferAccess(java.nio.Buffer buffer) {
+ if (buffer == null /*|| !Pipeline.getPipeline().checkNativeBufferAccess(buffer)*/) {
+ return false;
+ }
+ else {
+ return true;
+ }
+ }
+
+ static {
+ // Allocate a direct byte buffer and verify that we can
+ // access the data pointer from native code
+ java.nio.ByteBuffer buffer = java.nio.ByteBuffer.allocateDirect(8);
+
+ if (!checkNativeBufferAccess(buffer)) {
+ unsupportedOperation = true;
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3DGraphics2D.java b/j3d-core/src/classes/share/javax/media/j3d/J3DGraphics2D.java
new file mode 100644
index 0000000..c42e696
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3DGraphics2D.java
@@ -0,0 +1,190 @@
+/*
+ * $RCSfile: J3DGraphics2D.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.awt.*;
+import java.awt.image.BufferedImage;
+import java.awt.image.ImageObserver;
+
+
+/**
+ * The J3DGraphics2D class extends Graphics2D to provide 2D rendering
+ * into a Canvas3D. It is an abstract base class that is further
+ * extended by a non-public Java 3D implementation class. This class
+ * allows Java 2D rendering to be mixed with Java 3D rendering in the
+ * same Canvas3D, subject to the same restrictions as imposed for 3D
+ * immediate-mode rendering: In mixed-mode rendering, all Java 2D
+ * requests must be done from one of the Canvas3D callback methods; in
+ * pure-immediate mode, the Java 3D renderer must be stopped for the
+ * Canvas3D being rendered into.
+ *
+ * flush(boolean) method to ensure
+ * that the rendering actually happens. The flush method is implicitly
+ * called in the following cases:
+ *
+ *
+ *
+ *
+ * Canvas3D.swap method calls
+ * flush(true)flush(true) prior to
+ * swapping the buffer for a double buffered on-screen Canvas3Dflush(true) prior to
+ * copying into the off-screen buffer of an off-screen Canvas3Dflush(false) after
+ * calling the preRender, renderField, postRender, and postSwap
+ * Canvas3D callback methods.drawImage(...)
+ * followed by flush(false), but can avoid the cost
+ * of making an extra copy of the image in some cases. Anything
+ * previously drawn to this J3DGraphics2D will be flushed before
+ * the image is drawn.
+ *
+ * @param img The image to draw
+ * @param x The x location to draw at
+ * @param y The y location to draw at
+ * @param observer The ImageObserver
+ *
+ * @since Java 3D 1.3
+ */
+ public abstract void drawAndFlushImage(BufferedImage img, int x, int y,
+ ImageObserver observer);
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3DGraphics2DImpl.java b/j3d-core/src/classes/share/javax/media/j3d/J3DGraphics2DImpl.java
new file mode 100644
index 0000000..4ad2605
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3DGraphics2DImpl.java
@@ -0,0 +1,1117 @@
+/*
+ * $RCSfile: J3DGraphics2DImpl.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/05/15 19:11:56 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.io.*;
+import java.util.*;
+import java.awt.*;
+import java.awt.event.*;
+import java.text.AttributedCharacterIterator;
+import java.awt.RenderingHints.Key;
+import java.awt.geom.*;
+import java.awt.image.*;
+import java.awt.image.renderable.RenderableImage;
+import java.awt.font.*;
+
+/**
+ * Implementation class for J3DGraphics2D
+ */
+
+final class J3DGraphics2DImpl extends J3DGraphics2D {
+ private boolean hasBeenDisposed = false;
+ private Graphics2D offScreenGraphics2D;
+ private BufferedImage g3dImage = null;
+ private byte[] data = null;
+ private boolean isFlushed = true;
+ private Canvas3D canvas3d;
+ private int width, height;
+ private int texWidth, texHeight;
+ private int xmin, ymin, xmax, ymax;
+ private Object extentLock = new Object();
+ private boolean abgr;
+ private boolean initTexMap = false;
+ private boolean strokeSet=false;
+ private Point2D.Float ptSrc = new Point2D.Float();
+ private Point2D.Float ptDst1 = new Point2D.Float();
+ private Point2D.Float ptDst2 = new Point2D.Float();
+ private Color xOrModeColor = null;
+ private volatile boolean initCtx = false;
+ private volatile boolean threadWaiting = false;
+ static final Color blackTransparent = new Color(0,0,0,0);
+ int objectId = -1;
+
+ // Package scope contructor
+ J3DGraphics2DImpl(Canvas3D c) {
+ canvas3d = c;
+
+ synchronized (VirtualUniverse.mc.contextCreationLock) {
+ if (c.ctx == null) {
+ // create a dummy bufferImage
+ width = 1;
+ height = 1;
+ g3dImage = new BufferedImage(width, height,
+ BufferedImage.TYPE_INT_ARGB);
+ offScreenGraphics2D = g3dImage.createGraphics();
+ } else {
+ init();
+ }
+ }
+
+ }
+
+ // This is invoke from Renderer callback when the first
+ // time createContext() finish which set
+ // canvas3d.extensionSupported correctly.
+ void init() {
+ // if ABGR extension is supported, we want to use
+ // TYPE_4BYTE_ABGR to make a fast copy
+ if (!initCtx) {
+ abgr = ((canvas3d.extensionsSupported & Canvas3D.EXT_ABGR) != 0);
+
+ width = canvas3d.getWidth();
+ height = canvas3d.getHeight();
+ initTexMap = false;
+
+ if (width <= 0) {
+ width = 1;
+ }
+ if (height <= 0) {
+ height = 1;
+ }
+
+ synchronized (extentLock) {
+ xmax = width;
+ ymax = height;
+ xmin = 0;
+ ymin = 0;
+ }
+ g3dImage = new BufferedImage(width, height,
+ (abgr ? BufferedImage.TYPE_4BYTE_ABGR:
+ BufferedImage.TYPE_INT_ARGB));
+ offScreenGraphics2D = g3dImage.createGraphics();
+ clearOffScreen();
+ if (!abgr) {
+ data = new byte[width*height*4];
+ }
+
+ // should be the last flag to set
+ initCtx = true;
+ }
+ }
+
+ /**
+ * Flushes all previously executed rendering operations to the
+ * drawing buffer for this 2D graphics object.
+ *
+ * @param wait flag indicating whether or not to wait for the
+ * rendering to be complete before returning from this call.
+ */
+ public void flush(boolean waiting) {
+
+ if (hasBeenDisposed) {
+ throw new IllegalStateException(J3dI18N.getString("J3DGraphics2D0"));
+ }
+
+ if (!isFlushed) {
+ // Composite g3dImage into Canvas3D
+ if (Thread.currentThread() == canvas3d.screen.renderer) {
+ if (!initCtx) {
+ return;
+ }
+ doFlush();
+ } else {
+ if (!initCtx) {
+ if (waiting &&
+ (canvas3d.pendingView != null) &&
+ canvas3d.pendingView.activeStatus) {
+ // wait until Renderer init() this context
+
+ while (!initCtx) {
+ MasterControl.threadYield();
+ }
+ } else {
+ return;
+ }
+ }
+ // Behavior Scheduler or other threads
+ // XXXX: may not be legal for behaviorScheduler
+ // May cause deadlock if it is in behaviorScheduler
+ // and we wait for Renderer to finish
+ boolean renderRun = (Thread.currentThread() !=
+ canvas3d.view.universe.behaviorScheduler);
+ // This must put before sendRenderMessage()
+ threadWaiting = true;
+ sendRenderMessage(renderRun, GraphicsContext3D.FLUSH2D, null,
+ null, null);
+ if (waiting) {
+ // It is possible that thread got notify BEFORE
+ // the following runMonitor invoke.
+ runMonitor(J3dThread.WAIT);
+ }
+ }
+ isFlushed = true;
+
+ }
+ }
+
+ // copy the data into a byte buffer that will be passed to opengl
+ void doFlush() {
+ assert !hasBeenDisposed;
+
+ // clip to offscreen buffer size
+ if (canvas3d.ctx == null) {
+ canvas3d.getGraphicsContext3D().doClear();
+ }
+
+ synchronized (extentLock) {
+ if (xmin < 0) {
+ xmin = 0;
+ }
+ if (xmax > width) {
+ xmax = width;
+ }
+ if (ymin < 0) {
+ ymin = 0;
+ }
+ if (ymax > height) {
+ ymax = height;
+ }
+
+ if ((xmax - xmin > 0) &&
+ (ymax - ymin > 0)) {
+ if (abgr) {
+ data = ((DataBufferByte)g3dImage.getRaster().getDataBuffer()).getData();
+ } else {
+ copyImage(g3dImage, data, width, height, xmin, ymin, xmax, ymax);
+ }
+ copyDataToCanvas(0, 0, xmin, ymin, xmax, ymax, width, height);
+ } else {
+
+ runMonitor(J3dThread.NOTIFY);
+ }
+ // this define an empty region
+ xmax = 0;
+ ymax = 0;
+ xmin = width;
+ ymin = height;
+ }
+
+ }
+
+
+ // borrowed from ImageComponentRetained since ImageComponent2D
+ // seems to do stuff we don't need to
+ final void copyImage(BufferedImage bi, byte[] image,
+ int width, int height,
+ int x1, int y1, int x2, int y2) {
+
+ assert !hasBeenDisposed;
+
+ int biType = bi.getType();
+ int w, h, i, j;
+ int row, rowBegin, rowInc, dstBegin;
+
+ dstBegin = 0;
+ rowInc = 1;
+ rowBegin = 0;
+
+ // convert format to RGBA for underlying OGL use
+ if ((biType == BufferedImage.TYPE_INT_ARGB) ||
+ (biType == BufferedImage.TYPE_INT_RGB)) {
+ // optimized cases
+ rowBegin = y1;
+
+ int colBegin = x1;
+
+ int[] intData =
+ ((DataBufferInt)bi.getRaster().getDataBuffer()).getData();
+ int rowOffset = rowInc * width;
+ int intPixel;
+
+ rowBegin = rowBegin*width + colBegin;
+ dstBegin = rowBegin*4;
+
+ if (biType == BufferedImage.TYPE_INT_ARGB) {
+ for (h = y1; h < y2; h++) {
+ i = rowBegin;
+ j = dstBegin;
+ for (w = x1; w < x2; w++, i++) {
+ intPixel = intData[i];
+ image[j++] = (byte)((intPixel >> 16) & 0xff);
+ image[j++] = (byte)((intPixel >> 8) & 0xff);
+ image[j++] = (byte)(intPixel & 0xff);
+ image[j++] = (byte)((intPixel >> 24) & 0xff);
+ }
+ rowBegin += rowOffset;
+ dstBegin += (rowOffset*4);
+ }
+ } else {
+ for (h = y1; h < y2; h++) {
+ i = rowBegin;
+ j = dstBegin;
+ for (w = x1; w < x2; w++, i++) {
+ intPixel = intData[i];
+ image[j++] = (byte)((intPixel >> 16) & 0xff);
+ image[j++] = (byte)((intPixel >> 8) & 0xff);
+ image[j++] = (byte)(intPixel & 0xff);
+ image[j++] = (byte)255;
+ }
+ rowBegin += rowOffset;
+ dstBegin += (rowOffset*4);
+ }
+ }
+ } else {
+ // non-optimized cases
+ WritableRaster ras = bi.getRaster();
+ ColorModel cm = bi.getColorModel();
+ Object pixel = ImageComponentRetained.getDataElementBuffer(ras);
+
+ j = (y1*width + x1)*4;
+ for (h = y1; h < y2; h++) {
+ i = j;
+ for (w = x1; w < x2; w++) {
+ ras.getDataElements(w, h, pixel);
+ image[j++] = (byte)cm.getRed(pixel);
+ image[j++] = (byte)cm.getGreen(pixel);
+ image[j++] = (byte)cm.getBlue(pixel);
+ image[j++] = (byte)cm.getAlpha(pixel);
+
+ }
+ j = i+ width*4;
+ }
+ }
+ }
+
+ void sendRenderMessage(boolean renderRun, int command,
+ Object arg1, Object arg2, Object arg3) {
+ // send a message to the request renderer
+ J3dMessage renderMessage = new J3dMessage();
+ renderMessage.threads = J3dThread.RENDER_THREAD;
+ renderMessage.type = J3dMessage.RENDER_IMMEDIATE;
+ renderMessage.universe = null;
+ renderMessage.view = null;
+ renderMessage.args[0] = canvas3d;
+ renderMessage.args[1] = new Integer(command);
+ renderMessage.args[2] = arg1;
+ renderMessage.args[3] = arg2;
+ renderMessage.args[4] = arg3;
+
+ while (!canvas3d.view.inRenderThreadData) {
+ // wait until the renderer thread data in added in
+ // MC:RenderThreadData array ready to receive message
+ MasterControl.threadYield();
+ }
+
+ canvas3d.screen.renderer.rendererStructure.addMessage(renderMessage);
+
+ if (renderRun) {
+ // notify mc that there is work to do
+ VirtualUniverse.mc.sendRunMessage(canvas3d.view, J3dThread.RENDER_THREAD);
+ } else {
+ // notify mc that there is work for the request renderer
+ VirtualUniverse.mc.setWorkForRequestRenderer();
+ }
+ }
+
+ final void validate() {
+ validate(0, 0, width, height);
+ }
+
+ void validate(float x1, float y1, float x2, float y2,
+ AffineTransform xform) {
+ float t;
+
+ if (xform == null) {
+ validate(x1, y1, x2, y2);
+ } else {
+ ptSrc.x = x1;
+ ptSrc.y = y1;
+ xform.transform(ptSrc, ptDst1);
+ ptSrc.x = x2;
+ ptSrc.y = y2;
+ xform.transform(ptSrc, ptDst2);
+
+ if (ptDst1.x > ptDst2.x) {
+ t = ptDst1.x;
+ ptDst1.x = ptDst2.x;
+ ptDst2.x = t;
+ }
+ if (ptDst1.y > ptDst2.y) {
+ t = ptDst1.y;
+ ptDst1.y = ptDst2.y;
+ ptDst2.y = t;
+ }
+ // take care of numerical error by adding 1
+ validate(ptDst1.x-1, ptDst1.y-1, ptDst2.x+1, ptDst2.y+1);
+ }
+ }
+
+ void validate(float x1, float y1, float x2, float y2) {
+ boolean doResize = false;
+ isFlushed = false;
+
+ synchronized(canvas3d) {
+ if (initCtx && canvas3d.resizeGraphics2D) {
+ doResize = true;
+ canvas3d.resizeGraphics2D = false;
+ }
+ }
+ if (doResize) {
+ synchronized (VirtualUniverse.mc.contextCreationLock) {
+ Graphics2D oldOffScreenGraphics2D = offScreenGraphics2D;
+ initCtx = false;
+ init();
+ copyGraphics2D(oldOffScreenGraphics2D);
+ }
+ } else {
+ AffineTransform tr = getTransform();
+ ptSrc.x = x1;
+ ptSrc.y = y1;
+ tr.transform(ptSrc, ptDst1);
+ ptSrc.x = x2;
+ ptSrc.y = y2;
+ tr.transform(ptSrc, ptDst2);
+
+ synchronized (extentLock) {
+ if (ptDst1.x < xmin) {
+ xmin = (int) ptDst1.x;
+ }
+ if (ptDst1.y < ymin) {
+ ymin = (int) ptDst1.y;
+ }
+ if (ptDst2.x > xmax) {
+ xmax = (int) ptDst2.x;
+ }
+ if (ptDst2.y > ymax) {
+ ymax = (int) ptDst2.y;
+ }
+ }
+ }
+ }
+
+ void copyGraphics2D(Graphics2D oldg) {
+ // restore the original setting of Graphics2D when resizing the windows
+ setColor(oldg.getColor());
+ setFont(oldg.getFont());
+ setClip(oldg.getClip());
+ setComposite(oldg.getComposite());
+ setTransform(oldg.getTransform());
+ setPaint(oldg.getPaint());
+ setStroke(oldg.getStroke());
+ if (xOrModeColor != null) {
+ setXORMode(xOrModeColor);
+ }
+
+ }
+
+ // Implementation of Graphics2D methods
+ public final void clip(Shape s) {
+ offScreenGraphics2D.clip(s);
+ }
+
+ public FontMetrics getFontMetrics() {
+ return offScreenGraphics2D.getFontMetrics();
+ }
+
+ public Rectangle getClipBounds(Rectangle r) {
+ return offScreenGraphics2D.getClipBounds(r);
+ }
+
+ public Rectangle getClipRect() {
+ return offScreenGraphics2D.getClipRect();
+ }
+
+ public String toString() {
+ return offScreenGraphics2D.toString();
+
+ }
+
+ public final AffineTransform getTransform() {
+ return offScreenGraphics2D.getTransform();
+ }
+
+ public final Color getColor() {
+ return offScreenGraphics2D.getColor();
+ }
+
+ public final Composite getComposite() {
+ return offScreenGraphics2D.getComposite();
+ }
+
+ public final Font getFont() {
+ return offScreenGraphics2D.getFont();
+ }
+
+ public final FontMetrics getFontMetrics(Font f) {
+ return offScreenGraphics2D.getFontMetrics(f);
+ }
+
+ public final FontRenderContext getFontRenderContext() {
+ return offScreenGraphics2D.getFontRenderContext();
+ }
+
+ public final GraphicsConfiguration getDeviceConfiguration() {
+ return offScreenGraphics2D.getDeviceConfiguration();
+ }
+
+ public final Object getRenderingHint(Key hintKey) {
+ return offScreenGraphics2D.getRenderingHint(hintKey);
+ }
+
+ public final Paint getPaint() {
+ return offScreenGraphics2D.getPaint();
+ }
+
+ public final Rectangle getClipBounds() {
+ return offScreenGraphics2D.getClipBounds();
+ }
+
+ public final RenderingHints getRenderingHints() {
+ return offScreenGraphics2D.getRenderingHints();
+ }
+
+ public final Shape getClip() {
+ return offScreenGraphics2D.getClip();
+ }
+
+ public final Stroke getStroke() {
+ return offScreenGraphics2D.getStroke();
+ }
+
+ public final boolean drawImage(Image img, AffineTransform xform,
+ ImageObserver obs) {
+
+ validate(0, 0, img.getWidth(obs), img.getHeight(obs), xform);
+ return offScreenGraphics2D.drawImage(img, xform, obs);
+ }
+
+ public final void drawImage(BufferedImage img, BufferedImageOp op,
+ int x, int y) {
+ if (op != null) {
+ img = op.filter(img, null);
+ }
+ validate(x, y, x+img.getWidth(), y+img.getHeight());
+ offScreenGraphics2D.drawImage(img, null, x, y);
+ }
+
+ public final boolean drawImage(Image img,
+ int x, int y,
+ ImageObserver observer) {
+
+ validate(x, y,
+ x + img.getWidth(observer),
+ y + img.getWidth(observer));
+ return offScreenGraphics2D.drawImage(img, x, y, observer);
+ }
+
+ public final boolean drawImage(Image img, int x, int y,
+ int width, int height,
+ ImageObserver observer) {
+ validate(x, y, x+width, y+height);
+ return offScreenGraphics2D.drawImage(img, x, y, width, height,
+ observer);
+ }
+
+ public final boolean drawImage(Image img, int x, int y,
+ int width, int height,
+ Color bgcolor,
+ ImageObserver observer) {
+ validate(x, y, x+width, y+height);
+ return offScreenGraphics2D.drawImage(img, x, y, width, height, bgcolor,
+ observer);
+ }
+
+ public final void drawImage(BufferedImage img,
+ int dx1, int dy1, int dx2, int dy2,
+ int sx1, int sy1, int sx2, int sy2,
+ ImageObserver observer) {
+ validate(dx1, dy1, dx2, dy2);
+ offScreenGraphics2D.drawImage(img, dx1, dy1, dx2, dy2, sx1, sy1,
+ sx2, sy2, observer);
+ }
+
+ public final boolean drawImage(Image img,
+ int dx1, int dy1, int dx2, int dy2,
+ int sx1, int sy1, int sx2, int sy2,
+ ImageObserver observer) {
+ validate(dx1, dy1, dx2, dy2);
+ return offScreenGraphics2D.drawImage(img, dx1, dy1, dx2, dy2, sx1, sy1,
+ sx2, sy2, observer);
+ }
+
+ public final boolean drawImage(Image img,
+ int dx1, int dy1, int dx2, int dy2,
+ int sx1, int sy1, int sx2, int sy2,
+ Color bgcolor,
+ ImageObserver observer) {
+ validate(dx1, dy1, dx2, dy2);
+ return offScreenGraphics2D.drawImage(img, dx1, dy1, dx2, dy2, sx1, sy1,
+ sx2, sy2, bgcolor, observer);
+ }
+
+ public final boolean drawImage(Image img, int x, int y,
+ Color bgcolor,
+ ImageObserver observer) {
+ validate(x, y, x+img.getWidth(observer), y+img.getHeight(observer));
+ return offScreenGraphics2D.drawImage(img, x, y, bgcolor, observer);
+ }
+
+ public final boolean hit(Rectangle rect, Shape s, boolean onStroke) {
+ return offScreenGraphics2D.hit(rect, s, onStroke);
+ }
+
+ public final void addRenderingHints(Map hints) {
+ offScreenGraphics2D.addRenderingHints(hints);
+ }
+
+ public final void clipRect(int x, int y, int width, int height) {
+ offScreenGraphics2D.clipRect(x, y, width, height);
+ }
+
+ public final void copyArea(int x, int y, int width, int height,
+ int dx, int dy) {
+ validate(x+dx, y+dy, x+dx+width, y+dy+height);
+ offScreenGraphics2D.copyArea(x, y, width, height, dx, dy);
+ }
+
+ public final void draw(Shape s) {
+ Rectangle rect = s.getBounds();
+ validate(rect.x, rect.y,
+ rect.x + rect.width,
+ rect.y + rect.height);
+ offScreenGraphics2D.draw(s);
+ }
+
+ public final void drawArc(int x, int y, int width, int height,
+ int startAngle, int arcAngle) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawArc(x, y, width, height, startAngle, arcAngle);
+ }
+
+ public final void drawGlyphVector(GlyphVector g, float x, float y) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawGlyphVector(g, x, y);
+ }
+
+ public final void drawLine(int x1, int y1, int x2, int y2) {
+ int minx, miny, maxx, maxy;
+ if (!strokeSet) {
+ if (x1 > x2) {
+ minx = x2;
+ maxx = x1;
+ } else {
+ minx = x1;
+ maxx = x2;
+ }
+ if (y1 > y2) {
+ miny = y2;
+ maxy = y1;
+ } else {
+ miny = y1;
+ maxy = y2;
+ }
+ validate(minx, miny, maxx, maxy);
+ } else {
+ // XXXX: call validate with bounding box of primitive
+ // XXXX: Need to consider Stroke width
+ validate();
+ }
+ offScreenGraphics2D.drawLine(x1, y1, x2, y2);
+ }
+
+ public final void drawOval(int x, int y, int width, int height) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawOval(x, y, width, height);
+ }
+
+ public final void drawPolygon(int xPoints[], int yPoints[],
+ int nPoints) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawPolygon(xPoints, yPoints, nPoints);
+ }
+
+ public final void drawPolyline(int xPoints[], int yPoints[],
+ int nPoints) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawPolyline(xPoints, yPoints, nPoints);
+ }
+
+ public final void drawRenderableImage(RenderableImage img,
+ AffineTransform xform) {
+
+ validate(0, 0, img.getWidth(), img.getHeight(), xform);
+ offScreenGraphics2D.drawRenderableImage(img, xform);
+ }
+
+ public final void drawRenderedImage(RenderedImage img,
+ AffineTransform xform) {
+ validate(0, 0, img.getWidth(), img.getHeight(), xform);
+ offScreenGraphics2D.drawRenderedImage(img, xform);
+ }
+
+ public final void drawRoundRect(int x, int y, int width, int height,
+ int arcWidth, int arcHeight) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawRoundRect(x, y, width, height, arcWidth,
+ arcHeight);
+ }
+
+ public final void drawString(AttributedCharacterIterator iterator,
+ int x, int y) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawString(iterator, x, y);
+ }
+
+ public final void drawString(AttributedCharacterIterator iterator,
+ float x, float y) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawString(iterator, x, y);
+ }
+
+ public final void drawString(String s, float x, float y) {
+ TextLayout layout = new TextLayout(s, getFont(),
+ getFontRenderContext());
+ Rectangle2D bounds = layout.getBounds();
+ float x1 = (float) bounds.getX();
+ float y1 = (float) bounds.getY();
+ validate(x1+x, y1+y,
+ x1 + x + (float) bounds.getWidth(),
+ y1 + y + (float) bounds.getHeight());
+ offScreenGraphics2D.drawString(s, x, y);
+
+ }
+
+ public final void drawString(String s, int x, int y) {
+ drawString(s, (float) x, (float) y);
+ }
+
+ public final void fill(Shape s) {
+ Rectangle rect = s.getBounds();
+ validate(rect.x, rect.y, rect.x + rect.width, rect.y + rect.height);
+ offScreenGraphics2D.fill(s);
+ }
+
+ public final void fillArc(int x, int y, int width, int height,
+ int startAngle, int arcAngle) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.fillArc(x, y, width, height, startAngle, arcAngle);
+ }
+
+ public final void fillOval(int x, int y, int width, int height) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.fillOval(x, y, width, height);
+ }
+
+ public final void fillRoundRect(int x, int y, int width, int height,
+ int arcWidth, int arcHeight) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.fillRoundRect(x, y, width, height, arcWidth,
+ arcHeight);
+ }
+
+ public final void rotate(double theta) {
+ offScreenGraphics2D.rotate(theta);
+ }
+
+ public final void rotate(double theta, double x, double y) {
+ offScreenGraphics2D.rotate(theta, x, y);
+ }
+
+ public final void scale(double sx, double sy) {
+ offScreenGraphics2D.scale(sx, sy);
+ }
+
+ public final void setClip(Shape clip) {
+ offScreenGraphics2D.setClip(clip);
+ }
+
+
+ public final void setClip(int x, int y, int width, int height) {
+ offScreenGraphics2D.setClip(x, y, width, height);
+ }
+
+ public final void setColor(Color c) {
+ offScreenGraphics2D.setColor(c);
+ }
+
+ public final void setComposite(Composite comp) {
+ offScreenGraphics2D.setComposite(comp);
+ }
+
+ public final void setFont(Font font) {
+ offScreenGraphics2D.setFont(font);
+ }
+
+ public final void setPaint( Paint paint ) {
+ offScreenGraphics2D.setPaint(paint);
+ }
+
+ public final void setPaintMode() {
+ xOrModeColor = null;
+ offScreenGraphics2D.setPaintMode();
+ }
+
+ public final void setRenderingHint(Key hintKey, Object hintValue) {
+ offScreenGraphics2D.setRenderingHint(hintKey, hintValue);
+ }
+
+ public final void setRenderingHints(Map hints) {
+ offScreenGraphics2D.setRenderingHints(hints);
+ }
+
+ public final void setStroke(Stroke s) {
+ strokeSet = (s != null);
+ offScreenGraphics2D.setStroke(s);
+ }
+
+ public final void setTransform(AffineTransform Tx) {
+ offScreenGraphics2D.setTransform(Tx);
+ }
+
+ public final void setXORMode(Color c1) {
+ xOrModeColor = c1;
+ offScreenGraphics2D.setXORMode(c1);
+ }
+
+ public final void shear(double shx, double shy) {
+ offScreenGraphics2D.shear(shx, shy);
+ }
+
+ public final void transform(AffineTransform Tx) {
+ offScreenGraphics2D.transform(Tx);
+ }
+
+ public final void translate(double tx, double ty) {
+ offScreenGraphics2D.translate(tx, ty);
+ }
+
+ public final void translate(int x, int y) {
+ offScreenGraphics2D.translate(x, y);
+ }
+ public boolean hitClip(int x, int y, int width, int height) {
+ return offScreenGraphics2D.hitClip(x, y, width, height);
+ }
+
+ public void draw3DRect(int x, int y, int width, int height,
+ boolean raised) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.draw3DRect(x, y, width, height, raised);
+ }
+
+ public void drawBytes(byte data[], int offset, int length, int x, int y) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawBytes(data, offset, length, x, y);
+ }
+
+ public void drawChars(char data[], int offset, int length, int x, int y) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawChars(data, offset, length, x, y);
+ }
+
+ public void drawPolygon(Polygon p) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.drawPolygon(p);
+ }
+
+ public void drawRect(int x, int y, int width, int height) {
+ // XXXX: call validate with bounding box of primitive
+ // XXXX: need to consider Stroke width
+ validate();
+ offScreenGraphics2D.drawRect(x, y, width, height);
+ }
+
+ public void fill3DRect(int x, int y, int width, int height,
+ boolean raised) {
+ // XXXX: call validate with bounding box of primitive
+ // XXXX: need to consider Stroke width
+ validate();
+ offScreenGraphics2D.fill3DRect(x, y, width, height, raised);
+ }
+
+ public void fillPolygon(Polygon p) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.fillPolygon(p);
+ }
+
+ public final void fillPolygon(int xPoints[], int yPoints[],
+ int nPoints) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.fillPolygon(xPoints, yPoints, nPoints);
+ }
+
+ public final void fillRect(int x, int y, int width, int height) {
+ // XXXX: call validate with bounding box of primitive
+ validate();
+ offScreenGraphics2D.fillRect(x, y, width, height);
+ }
+
+ // Issue 121 - release all resources, mark as disposed
+ public void dispose() {
+
+ // Issue 583 - do nothing if graphics has already been disposed
+ if (hasBeenDisposed) {
+ return;
+ }
+
+ if (Thread.currentThread() == canvas3d.screen.renderer) {
+ doDispose();
+ } else {
+ // Behavior Scheduler or other threads
+ // XXXX: may not be legal for behaviorScheduler
+ // May cause deadlock if it is in behaviorScheduler
+ // and we wait for Renderer to finish
+ boolean renderRun = (Thread.currentThread() !=
+ canvas3d.view.universe.behaviorScheduler);
+ sendRenderMessage(renderRun, GraphicsContext3D.DISPOSE2D,
+ null, null, null);
+ }
+
+
+ }
+
+ public void doDispose() {
+
+ if (hasBeenDisposed) {
+ return;
+ }
+
+ if (objectId != -1) {
+ canvas3d.freeTexture(canvas3d.ctx, objectId);
+ VirtualUniverse.mc.freeTexture2DId(objectId);
+ objectId = -1;
+ }
+
+ // Dispose of the underlying Graphics2D
+ offScreenGraphics2D.dispose();
+
+ // Mark as disposed
+ hasBeenDisposed = true;
+ // Issue 583 - set graphics2D field to null so it will get recreated
+ canvas3d.graphics2D = null;
+ }
+
+ public void drawAndFlushImage(BufferedImage img, int x, int y,
+ ImageObserver observer) {
+
+ if (hasBeenDisposed) {
+ throw new IllegalStateException(J3dI18N.getString("J3DGraphics2D0"));
+ }
+
+ if (!(initCtx && abgr &&
+ (img.getType() == BufferedImage.TYPE_4BYTE_ABGR))) {
+ drawImage(img, x, y, observer);
+ flush(false);
+ return;
+ }
+
+ if (Thread.currentThread() == canvas3d.screen.renderer) {
+ doDrawAndFlushImage(img, x, y, observer);
+ } else {
+ // Behavior Scheduler or other threads
+ // XXXX: may not be legal for behaviorScheduler
+ // May cause deadlock if it is in behaviorScheduler
+ // and we wait for Renderer to finish
+ boolean renderRun = (Thread.currentThread() !=
+ canvas3d.view.universe.behaviorScheduler);
+ sendRenderMessage(renderRun, GraphicsContext3D.DRAWANDFLUSH2D,
+ img, new Point(x, y), observer);
+ }
+ }
+
+ void doDrawAndFlushImage(BufferedImage img, int x, int y,
+ ImageObserver observer) {
+
+ assert !hasBeenDisposed;
+
+ int imgWidth = img.getWidth(observer);
+ int imgHeight = img.getHeight(observer);
+ int px, py, x1, y1, x2, y2;
+
+ if (canvas3d.ctx == null) {
+ canvas3d.getGraphicsContext3D().doClear();
+ }
+
+ // format needs to be 4BYTE_ABGR and abgr needs to be supported
+ // also must be in canvas callback
+ data = ((DataBufferByte)img.getRaster().getDataBuffer()).getData();
+
+ // Transform the affine transform,
+ // note we do not handle scale/rotate etc.
+ AffineTransform tr = getTransform();
+ ptSrc.x = x;
+ ptSrc.y = y;
+ tr.transform(ptSrc, ptDst1);
+ px = (int) ptDst1.x;
+ py = (int) ptDst1.y;
+
+ // clip to offscreen buffer size
+
+ if (px + imgWidth > width) {
+ x2 = width - px;
+ } else {
+ x2 = imgWidth;
+ }
+
+ if (px < 0) {
+ x1 = -px;
+ px = 0;
+ } else {
+ x1 = 0;
+ }
+
+ if (py + imgHeight > height) {
+ y2 = height - py;
+ } else {
+ y2 = imgHeight;
+ }
+
+ if (py < 0) {
+ y1 = -py;
+ py = 0;
+ } else {
+ y1 = 0;
+ }
+
+ if ((y2 - y1 > 0) && (x2 - x1 > 0)) {
+ copyDataToCanvas(px, py, x1,y1, x2, y2,imgWidth, imgHeight);
+ }
+
+ }
+
+
+ void copyDataToCanvas(int px, int py, int x1, int y1,
+ int x2, int y2, int w, int h) {
+ try {
+ if (!canvas3d.drawingSurfaceObject.renderLock()) {
+ return;
+ }
+
+ if (!initTexMap) {
+ if (objectId == -1) {
+ objectId = VirtualUniverse.mc.getTexture2DId();
+ }
+ texWidth = getGreaterPowerOf2(w);
+ texHeight = getGreaterPowerOf2(h);
+
+ // Canvas got resize, need to init texture map again
+ // in Renderer thread
+ if (!canvas3d.initTexturemapping(canvas3d.ctx,
+ texWidth, texHeight,
+ objectId)) {
+ // Fail to get the texture surface, most likely
+ // there is not enough texture memory
+ initTexMap = false;
+ VirtualUniverse.mc.freeTexture2DId(objectId);
+ objectId = -1;
+ // TODO : Need to find a better way to report no resource problem --- Chien.
+ System.err.println("J3DGraphics2DImpl.copyDataToCanvas() : Fail to get texture resources ...");
+
+ } else {
+ initTexMap = true;
+ }
+ }
+ if (initTexMap) {
+ canvas3d.texturemapping(canvas3d.ctx, px, py,
+ x1, y1, x2, y2,
+ texWidth, texHeight, w,
+ (abgr ? ImageComponentRetained.TYPE_BYTE_ABGR:
+ ImageComponentRetained.TYPE_BYTE_RGBA),
+ objectId, data, width, height);
+ }
+
+ canvas3d.drawingSurfaceObject.unLock();
+ } catch (NullPointerException ne) {
+ canvas3d.drawingSurfaceObject.unLock();
+ throw ne;
+ }
+
+ clearOffScreen();
+ runMonitor(J3dThread.NOTIFY);
+ }
+
+ void clearOffScreen() {
+ Composite comp = offScreenGraphics2D.getComposite();
+ Color c = offScreenGraphics2D.getColor();
+ offScreenGraphics2D.setComposite(AlphaComposite.Src);
+ offScreenGraphics2D.setColor(blackTransparent);
+ offScreenGraphics2D.fillRect(xmin, ymin, (xmax-xmin), (ymax-ymin));
+ offScreenGraphics2D.setComposite(comp);
+ offScreenGraphics2D.setColor(c);
+ }
+
+ /**
+ * Return an integer of power 2 greater than x
+ */
+ static int getGreaterPowerOf2(int x) {
+ int i = -1;
+ if (x >= 0) {
+ for (i = 1; i < x; i <<= 1);
+ }
+ return i;
+ }
+
+ /**
+ * MC may not scheduler Renderer thread or Renderer thread
+ * may not process message FLUSH. This will hang user
+ * thread.
+ */
+ synchronized void runMonitor(int action) {
+ if (action == J3dThread.WAIT) {
+ // Issue 279 - loop until ready
+ while (threadWaiting) {
+ try {
+ wait();
+ } catch (InterruptedException e){}
+ }
+ } else if (action == J3dThread.NOTIFY) {
+ notify();
+ threadWaiting = false;
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dClock.java b/j3d-core/src/classes/share/javax/media/j3d/J3dClock.java
new file mode 100644
index 0000000..7809fe2
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dClock.java
@@ -0,0 +1,101 @@
+/*
+ * $RCSfile: J3dClock.java,v $
+ *
+ * Copyright 2005-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/05/22 18:10:39 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Utility class to provide a more accurate replacement for
+ * System.currentTimeMillis().
+ */
+class J3dClock {
+
+ // Issue 543 - Flag to indicate whether clock skews are taken in account
+ // and corrected. false by default. Set by the "j3d.adjustClockSkew" property.
+ private static boolean skewAdjustedClock = false;
+
+ private static long deltaTime;
+ private static final long nsecPerMsec = 1000000;
+
+ /**
+ * Private constructor, since no instance should ever be created.
+ */
+ private J3dClock() {
+ }
+
+ /**
+ * Returns the current time in milliseconds. This is a more
+ * accurate version of System.currentTimeMillis and should be used in
+ * its place.
+ *
+ * @return the current time in milliseconds.
+ */
+ static long currentTimeMillis() {
+ if (!skewAdjustedClock) {
+ return (System.nanoTime() / nsecPerMsec) + deltaTime;
+ } else {
+ // Issue 543 - Adjust for possible clock skew
+ long time = (System.nanoTime() / nsecPerMsec) + deltaTime;
+ long sysTime = System.currentTimeMillis();
+ if (Math.abs(time - sysTime) > 50) {
+ long baseTime, baseTimerValue;
+ synchronized (J3dClock.class) {
+ baseTime = System.currentTimeMillis();
+ baseTimerValue = System.nanoTime();
+ }
+ deltaTime = baseTime - (baseTimerValue / nsecPerMsec);
+ time = (System.nanoTime() / nsecPerMsec) + deltaTime;
+ }
+ return time;
+ }
+ }
+
+ static {
+ // Issue 543: get property for clock skew adjustment
+ skewAdjustedClock = MasterControl.getBooleanProperty("j3d.adjustClockSkew",
+ skewAdjustedClock, "clock skew adjustment");
+
+ // Call time methods once without using their values to ensure that
+ // the methods are "warmed up". We need to make sure that the actual
+ // calls that we use take place as close together as possible in time.
+ System.currentTimeMillis();
+ System.nanoTime();
+
+ // Compute deltaTime between System.currentTimeMillis()
+ // and the high-res timer, use a synchronized block to force both calls
+ // to be made before the integer divide
+ long baseTime, baseTimerValue;
+ synchronized (J3dClock.class) {
+ baseTime = System.currentTimeMillis();
+ baseTimerValue = System.nanoTime();
+ }
+ deltaTime = baseTime - (baseTimerValue / nsecPerMsec);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dDebug.java b/j3d-core/src/classes/share/javax/media/j3d/J3dDebug.java
new file mode 100644
index 0000000..2674cec
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dDebug.java
@@ -0,0 +1,461 @@
+/*
+ * $RCSfile: J3dDebug.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+class J3dDebug {
+
+ // For production release devPhase is set to false.
+
+ // Do no debugging.
+ static final int NO_DEBUG = 0;
+
+ // How much debugging information do we want ?
+ // (LEVEL_1 is very terse, LEVEL_5 is very verbose)
+ static final int LEVEL_1 = 1;
+ static final int LEVEL_2 = 2;
+ static final int LEVEL_3 = 3;
+ static final int LEVEL_4 = 4;
+ static final int LEVEL_5 = 5;
+
+ // This static final variable is used to turn on/off debugging,
+ // checking, and initializing codes that may be preferred in
+ // development phase but not necessarily required in the
+ // production release.
+ //
+ // Beside for debugging, use this variable to do initialization,
+ // checking objects existence, and other checks that may help in
+ // uncovering potential bugs during code development. This
+ // variable should be turned off during production release as it
+ // may cause performance hit.
+ static final boolean devPhase = VersionInfo.isDevPhase;
+
+ // This is a property variable. It allows a true/false be sent to
+ // J3d from command line, to on/off code segments. To avoid
+ // performance hit in production release, this variable MUST be
+ // used with devPhase when guarding code segments for execution.
+ // eg. if(J3dDebug.devPhase && J3dDebug.debug)
+ // do code_segment;
+ // Note: devPhase is a static final variable and debug isn't. If
+ // devPhase is put before debug, smart compiler will not include
+ // code_segment when devPhase is false.
+ static boolean debug;
+
+ // Class debug variable, there is one debug variable per class.
+ // Set one of the 5 debug levels to the class debug variable when
+ // debugging.
+ // For example, alpha = !devPhase?NO_DEBUG:LEVEL_2; will cause
+ // code segments guarded by LEVEL_1 and LEVEL_2 be executed. And
+ // alpha = !devPhase?NO_DEBUG:NO_DEBUG; means do no debug.
+ static final int alpha = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int alternateAppearance = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int ambientLight = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int ambientLightRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int appearance = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int appearanceRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int assertionFailureException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int attributeBin = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int audioDevice = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int audioDevice3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int audioDeviceEnumerator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int auralAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int auralAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int bHInsertStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int bHInternalNode = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int bHLeafInterface = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int bHLeafNode = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int bHNode = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int bHTree = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int background = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int backgroundRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int backgroundSound = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int backgroundSoundRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int badTransformException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int behavior = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int behaviorRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int behaviorScheduler = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int behaviorStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int billboard = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int boundingBox = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int boundingLeaf = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int boundingLeafRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int boundingPolytope = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int boundingSphere = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int bounds = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int branchGroup = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int branchGroupRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int cachedFrustum = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int canvas3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int canvasViewCache = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int canvasViewEventCatcher = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int capabilityBits = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int capabilityNotSetException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int clip = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int clipRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int colorInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int coloringAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int coloringAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int compileState = !devPhase?NO_DEBUG:LEVEL_3;
+ static final int compressedGeometry = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int compressedGeometryHeader = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int compressedGeometryRenderMethod = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int compressedGeometryRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int coneSound = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int coneSoundRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int danglingReferenceException = !devPhase?NO_DEBUG:NO_DEBUG;
+
+ static final int decalGroup = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int decalGroupRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int defaultRenderMethod = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponent = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponentFloat = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponentFloatRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponentInt = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponentIntRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponentNative = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponentNativeRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int depthComponentRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int directionalLight = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int directionalLightRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int displayListRenderMethod = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int distanceLOD = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int environmentSet = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int eventCatcher = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int exponentialFog = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int exponentialFogRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int fog = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int fogRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int font3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int fontExtrusion = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int generalizedStrip = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int generalizedStripFlags = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int generalizedVertexList = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometry = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryAtom = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryDecompressor = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryDecompressorRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryDecompressorShape3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryLock = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryLockInterface = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryStripArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryStripArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int geometryUpdater = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int graphicsConfigTemplate3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int graphicsContext3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int group = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int groupRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int hashKey = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int hiResCoord = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int illegalRenderingStateException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int illegalSharingException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int imageComponent = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int imageComponent2D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int imageComponent2DRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int imageComponent3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int imageComponent3DRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int imageComponentRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedGeometryArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedGeometryArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedGeometryStripArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedGeometryStripArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedLineArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedLineArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedLineStripArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedLineStripArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedPointArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedPointArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedQuadArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedQuadArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedTriangleArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedTriangleArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedTriangleFanArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedTriangleFanArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedTriangleStripArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int indexedTriangleStripArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int inputDevice = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int inputDeviceBlockingThread = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int inputDeviceScheduler = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int interpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dDataInputStream = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dDataOutputStream = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dDebug = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dI18N = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dMessage = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dNodeTable = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dQueryProps = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dThread = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int j3dThreadData = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lOD = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int leaf = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int leafRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int light = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lightBin = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lightRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lightSet = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lineArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lineArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lineAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lineAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lineStripArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int lineStripArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int linearFog = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int linearFogRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int link = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int linkRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int locale = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int mRSWLock = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int masterControl = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int material = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int materialRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int mediaContainer = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int mediaContainerRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int modelClip = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int modelClipRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int morph = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int morphRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int multipleParentException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int node = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int nodeComponent = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int nodeComponentRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int nodeReferenceTable = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int nodeRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int objectUpdate = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int orderedBin = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int orderedCollection = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int orderedGroup = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int orderedGroupRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pathInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int physicalBody = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int physicalEnvironment = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickBounds = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickCone = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickCylinderRay = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickCylinderSegment = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickPoint = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickRay = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickSegment = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pickShape = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int picking = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointLight = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointLightRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointSound = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int pointSoundRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int polygonAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int polygonAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int positionInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int positionPathInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int quadArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int quadArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int raster = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int rasterRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderAtom = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderBin = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderBinLock = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderMethod = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderMolecule = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderer = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int rendererStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderingAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderingAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderingAttributesStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int renderingEnvironmentStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int restrictedAccessException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int rotPosPathInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int rotPosScalePathInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int rotationInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int rotationPathInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int scaleInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sceneGraphCycleException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sceneGraphObject = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sceneGraphObjectRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sceneGraphPath = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int screen3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int screenViewCache = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sensor = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sensorRead = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int setLiveState = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int shape3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int shape3DRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sharedGroup = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sharedGroupRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int sound = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int soundException = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int soundRenderer = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int soundRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int soundScheduler = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int soundStructure = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int soundscape = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int soundscapeRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int spotLight = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int spotLightRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int structureUpdateThread = !devPhase?NO_DEBUG:NO_DEBUG;
+
+ // switch is a reserved word.
+ static final int Switch = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int switchRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int switchValueInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int table = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int texCoordGeneration = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int texCoordGenerationRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int text3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int text3DRenderMethod = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int text3DRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int texture = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int texture2D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int texture2DRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int texture3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int texture3DRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int textureAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int textureAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int textureBin = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int textureRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int textureSetting = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int timerThread = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int transform3D = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int transformGroup = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int transformGroupRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int transformStructure = !devPhase?NO_DEBUG:J3dDebug.LEVEL_3;
+ static final int transparencyAttributes = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int transparencyAttributesRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int transparencyInterpolator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int triangleArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int triangleArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int triangleFanArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int triangleFanArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int triangleStripArray = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int triangleStripArrayRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int unorderList = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int vertexArrayRenderMethod = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int view = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int viewCache = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int viewPlatform = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int viewPlatformRetained = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int virtualUniverse = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupAnd = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupAndOfOrs = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupCondition = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupCriteriaEnumerator = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupCriterion = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnAWTEvent = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnActivation = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnBehaviorPost = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnCollisionEntry = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnCollisionExit = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnCollisionMovement = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnDeactivation = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnElapsedFrames = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnElapsedTime = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnElapsedTimeHeap = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnSensorEntry = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnSensorExit = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnTransformChange = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnViewPlatformEntry = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOnViewPlatformExit = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOr = !devPhase?NO_DEBUG:NO_DEBUG;
+ static final int wakeupOrOfAnds = !devPhase?NO_DEBUG:NO_DEBUG;
+
+
+ static boolean doDebug(int j3dClassLevel, int level, String str) {
+ if(j3dClassLevel >= level) {
+ System.err.print(str);
+ return true;
+ }
+ return false;
+ }
+
+ static boolean doDebug(int j3dClassLevel, int level) {
+ if(j3dClassLevel >= level) {
+ return true;
+ }
+ return false;
+ }
+
+ static void doAssert(boolean expr, String str) {
+ if (! expr) {
+ throw new AssertionFailureException("(" + str + ")" + "is false");
+ }
+ }
+
+ static void pkgInfo(ClassLoader classLoader,
+ String pkgName,
+ String className) {
+
+ try {
+ classLoader.loadClass(pkgName + "." + className);
+
+ Package p = Package.getPackage(pkgName);
+ if (p == null) {
+ System.err.println("WARNING: Package.getPackage(" +
+ pkgName +
+ ") is null");
+ }
+ else {
+ if(devPhase && debug) {
+ System.err.println(p);
+ System.err.println("Specification Title = " +
+ p.getSpecificationTitle());
+ System.err.println("Specification Vendor = " +
+ p.getSpecificationVendor());
+ System.err.println("Specification Version = " +
+ p.getSpecificationVersion());
+ System.err.println("Implementation Vendor = " +
+ p.getImplementationVendor());
+ System.err.println("Implementation Version = " +
+ p.getImplementationVersion());
+ }
+ else if(devPhase)
+ System.err.println(", Java 3D " + p.getImplementationVersion() + ".");
+ }
+ }
+ catch (ClassNotFoundException e) {
+ System.err.println("Unable to load " + pkgName);
+ }
+
+ // System.err.println();
+ }
+
+
+ static {
+ // initialize the debug flag
+ debug = false;
+ }
+
+}
+
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dI18N.java b/j3d-core/src/classes/share/javax/media/j3d/J3dI18N.java
new file mode 100644
index 0000000..f17bfc4
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dI18N.java
@@ -0,0 +1,50 @@
+/*
+ * $RCSfile: J3dI18N.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.io.*;
+import java.util.*;
+
+
+class J3dI18N {
+ static String getString(String key) {
+ String s;
+ try {
+ s = (String) ResourceBundle.getBundle("javax.media.j3d.ExceptionStrings").getString(key);
+ }
+ catch (MissingResourceException e) {
+ System.err.println("J3dI18N: Error looking up: " + key);
+ s = key;
+ }
+ return s;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dMessage.java b/j3d-core/src/classes/share/javax/media/j3d/J3dMessage.java
new file mode 100644
index 0000000..74ebc92
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dMessage.java
@@ -0,0 +1,190 @@
+/*
+ * $RCSfile: J3dMessage.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.11 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The J3dMessage is the super class of all messages in Java 3D. It implements
+ * all of the common data members needed.
+ */
+
+class J3dMessage extends Object {
+ /**
+ * The various message types.
+ */
+ static final int INVALID_TYPE = -1;
+ static final int INSERT_NODES = 0;
+ static final int REMOVE_NODES = 1;
+ static final int RUN = 2;
+ static final int TRANSFORM_CHANGED = 3;
+ static final int UPDATE_VIEW = 4;
+ static final int STOP_THREAD = 5;
+ static final int COLORINGATTRIBUTES_CHANGED = 6;
+ static final int LINEATTRIBUTES_CHANGED = 7;
+ static final int POINTATTRIBUTES_CHANGED = 8;
+ static final int POLYGONATTRIBUTES_CHANGED = 9;
+ static final int RENDERINGATTRIBUTES_CHANGED = 10;
+ static final int TEXTUREATTRIBUTES_CHANGED = 11;
+ static final int TRANSPARENCYATTRIBUTES_CHANGED = 12;
+ static final int MATERIAL_CHANGED = 13;
+ static final int TEXCOORDGENERATION_CHANGED = 14;
+ static final int TEXTURE_CHANGED = 15;
+ static final int MORPH_CHANGED = 16;
+ static final int GEOMETRY_CHANGED = 17;
+ static final int APPEARANCE_CHANGED = 18;
+ static final int LIGHT_CHANGED = 19;
+ static final int BACKGROUND_CHANGED = 20;
+ static final int CLIP_CHANGED = 21;
+ static final int FOG_CHANGED = 22;
+ static final int BOUNDINGLEAF_CHANGED = 23;
+ static final int SHAPE3D_CHANGED = 24;
+ static final int TEXT3D_TRANSFORM_CHANGED = 25;
+ static final int TEXT3D_DATA_CHANGED = 26;
+ static final int SWITCH_CHANGED = 27;
+ static final int COND_MET = 28;
+ static final int BEHAVIOR_ENABLE = 29;
+ static final int BEHAVIOR_DISABLE = 30;
+ static final int INSERT_RENDERATOMS = 31;
+ static final int ORDERED_GROUP_INSERTED = 32;
+ static final int ORDERED_GROUP_REMOVED = 33;
+ static final int COLLISION_BOUND_CHANGED = 34;
+ static final int REGION_BOUND_CHANGED = 35;
+ static final int MODELCLIP_CHANGED = 36;
+ static final int BOUNDS_AUTO_COMPUTE_CHANGED = 37;
+ static final int SOUND_ATTRIB_CHANGED = 38;
+ static final int AURALATTRIBUTES_CHANGED = 39;
+ static final int SOUNDSCAPE_CHANGED = 40;
+ static final int ALTERNATEAPPEARANCE_CHANGED = 41;
+ static final int RENDER_OFFSCREEN = 42;
+ static final int RENDER_RETAINED = 43;
+ static final int RENDER_IMMEDIATE = 44;
+ static final int SOUND_STATE_CHANGED = 45;
+ static final int ORIENTEDSHAPE3D_CHANGED = 46;
+ static final int TEXTURE_UNIT_STATE_CHANGED = 47;
+ static final int UPDATE_VIEWPLATFORM = 48;
+ static final int BEHAVIOR_ACTIVATE = 49;
+ static final int GEOMETRYARRAY_CHANGED = 50;
+ static final int MEDIA_CONTAINER_CHANGED = 51;
+ static final int RESIZE_CANVAS = 52;
+ static final int TOGGLE_CANVAS = 53;
+ static final int IMAGE_COMPONENT_CHANGED = 54;
+ static final int SCHEDULING_INTERVAL_CHANGED = 55;
+ static final int VIEWSPECIFICGROUP_CHANGED = 56;
+ static final int VIEWSPECIFICGROUP_INIT = 57;
+ static final int VIEWSPECIFICGROUP_CLEAR = 58;
+ static final int ORDERED_GROUP_TABLE_CHANGED = 59;
+ static final int BEHAVIOR_REEVALUATE = 60;
+ static final int CREATE_OFFSCREENBUFFER = 61;
+ static final int DESTROY_CTX_AND_OFFSCREENBUFFER = 62;
+ static final int SHADER_ATTRIBUTE_CHANGED = 63;
+ static final int SHADER_ATTRIBUTE_SET_CHANGED = 64;
+ static final int SHADER_APPEARANCE_CHANGED = 65;
+ static final int ALLOCATE_CANVASID = 66;
+ static final int FREE_CANVASID = 67;
+
+ /**
+ * This is the time snapshot at which this change occured
+ */
+ long time = -1;
+
+ /**
+ * This is the number of references to this message
+ */
+ private int refcount = 0;
+
+ /**
+ * This is a bitmask of the types of threads that need to be run
+ * once this message is consumed.
+ */
+ int threads = 0;
+
+ /**
+ * The universe that this message originated from
+ */
+ VirtualUniverse universe;
+
+ /**
+ * This holds the type of this message
+ */
+ int type = -1;
+
+ /**
+ * This holds the target view of this message, null means all views
+ */
+ View view = null;
+
+
+ /**
+ * The arguements for a message, 5 for now
+ */
+ static final int MAX_ARGS = 6;
+
+ Object[] args = new Object[MAX_ARGS];
+
+ /**
+ * This constructor does nothing
+ */
+ J3dMessage() {
+ }
+
+ final synchronized void clear() {
+ // System.err.println("J3dMessage : " + this );
+ view = null;
+ universe = null;
+ args[0] = null;
+ args[1] = null;
+ args[2] = null;
+ args[3] = null;
+ args[4] = null;
+ args[5] = null;
+ }
+
+ /**
+ * This increments the reference count for this message
+ */
+ final synchronized void incRefcount() {
+ refcount++;
+ }
+
+ /**
+ * This decrements the reference count for this message. If it goes
+ * to 0, the message is put on the MasterControl freelist.
+ */
+ final synchronized void decRefcount() {
+ if (--refcount == 0) {
+ clear();
+ }
+ }
+
+ final synchronized int getRefcount() {
+ return refcount;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dNodeTable.java b/j3d-core/src/classes/share/javax/media/j3d/J3dNodeTable.java
new file mode 100644
index 0000000..93972d1
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dNodeTable.java
@@ -0,0 +1,309 @@
+/*
+ * $RCSfile: J3dNodeTable.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.io.DataOutputStream;
+import java.io.OutputStream;
+import java.util.Hashtable;
+import javax.vecmath.Color3f;
+import javax.vecmath.Tuple3f;
+
+/**
+ * The J3dNodeTable object provides utilities for the save/load
+ * methods in the Java3d nodes. Specifically, it holds an enumerated
+ * list of the Java3D node types and their respective Class names.
+ * It keeps these lists in a Hashtable and an array and allows
+ * other classes to get an enumerated value associated with an Object
+ * type or an instance of an Object associated with an enumerated value.
+ *
+ */
+class J3dNodeTable {
+
+ // nodeTable holds the enumerated value/Classname pairs. This is
+ // used to look up enumerated values given a Class name.
+ Hashtable nodeTable = new Hashtable();
+
+ // nodeArray holds the value/Classname pairs also, but allows lookups
+ // in the other direction (given a value, what's the Class name?)
+ String nodeArray[];
+
+ // Following is a list of the current scene graph objects of java3D.
+ // In order to make later node insertion easier, and to add some logic to
+ // this arbitrary list, the groups of nodes are grouped in terms of
+ // similar functionality of node types.
+
+ // Maximum number of nodes
+ static final int MAX_NUM_NODES = 200;
+
+ // Nothing occupies slot 0 - thus we can return 0 from this class'
+ // methods to denote failure.
+ static final int NOTHING = 0;
+
+ // 1 - 9: Groups
+ static final int GROUP = 1;
+ static final int TRANSFORM_GROUP = 2;
+ static final int SWITCH_GROUP = 3;
+ static final int ORDERED_GROUP = 4;
+ static final int BRANCH_GROUP = 5;
+ static final int ENDGROUP = 9; // denotes done with group
+
+ // 10 - 19: Shape3D (in a class by itself)
+ static final int SHAPE3D = 10;
+
+ // 20 - 49: Appearance and all of its attributes
+ static final int APPEARANCE = 20;
+ static final int MATERIAL = 21;
+ static final int TEXTURE = 22;
+ static final int TEX_COORD_GENERATION = 23;
+ static final int TEXTURE_ATTRIBUTES = 24;
+ static final int COLORING_ATTRIBUTES = 25;
+ static final int TRANSPARENCY_ATTRIBUTES = 26;
+ static final int RENDERING_ATTRIBUTES = 27;
+ static final int POLYGON_ATTRIBUTES = 28;
+ static final int LINE_ATTRIBUTES = 29;
+ static final int POINT_ATTRIBUTES = 30;
+ static final int TEXTURE_2D = 31;
+ static final int TEXTURE_3D = 32;
+ static final int IMAGE_COMPONENT = 33;
+ static final int IMAGE_COMPONENT_2D = 34;
+ static final int IMAGE_COMPONENT_3D = 35;
+ static final int ENDAPPEARANCE = 49;
+
+ // 100 - 149: All Geometry types
+ static final int GEOMETRY = 100;
+ static final int COMPRESSED_GEOMETRY = 101;
+ static final int GEOMETRY_ARRAY = 102;
+ static final int GEOMETRY_STRIP_ARRAY = 103;
+ static final int INDEXED_GEOMETRY_ARRAY = 104;
+ static final int INDEXED_GEOMETRY_STRIP_ARRAY = 105;
+ static final int INDEXED_LINE_ARRAY = 106;
+ static final int INDEXED_LINE_STRIP_ARRAY = 107;
+ static final int INDEXED_POINT_ARRAY = 108;
+ static final int INDEXED_QUAD_ARRAY = 109;
+ static final int INDEXED_TRIANGLE_ARRAY = 110;
+ static final int INDEXED_TRIANGLE_FAN_ARRAY = 111;
+ static final int INDEXED_TRIANGLE_STRIP_ARRAY = 112;
+ static final int LINE_ARRAY = 113;
+ static final int LINE_STRIP_ARRAY = 114;
+ static final int POINT_ARRAY = 115;
+ static final int QUAD_ARRAY = 116;
+ static final int TRIANGLE_ARRAY = 117;
+ static final int TRIANGLE_FAN_ARRAY = 118;
+ static final int TRIANGLE_STRIP_ARRAY = 119;
+ static final int BACKGROUND_SOUND = 120;
+ static final int POINT_SOUND = 121;
+ static final int CONE_SOUND = 122;
+ static final int MEDIA_CONTAINER = 123;
+
+ // 150 - 169: Behaviors
+ static final int ROTATION_INTERPOLATOR = 150;
+ static final int ROTPOSSCALEPATH_INTERPOLATOR = 151;
+ static final int ROTATIONPATH_INTERPOLATOR = 152;
+ static final int POSITIONPATH_INTERPOLATOR = 153;
+ static final int ROTPOSPATH_INTERPOLATOR = 154;
+ static final int POSITION_INTERPOLATOR = 155;
+ static final int SWITCHVALUE_INTERPOLATOR = 156;
+ static final int COLOR_INTERPOLATOR = 157;
+ static final int SCALE_INTERPOLATOR = 158;
+ // Problem: these next two are non j3d-core items
+ static final int SOUND_PLAYER = 159;
+ static final int SOUND_FADER = 160;
+
+ // 170 - 189: Various utility nodes
+ static final int BOUNDS = 170;
+ static final int BOUNDING_SPHERE = 171;
+ static final int BOUNDING_BOX = 172;
+ static final int BOUNDING_POLYTOPE = 173;
+ static final int TRANSFORM3D = 180;
+ static final int BACKGROUND = 181;
+
+ // 190 - 199: Lights
+ static final int LIGHT = 190;
+ static final int POINT_LIGHT = 191;
+ static final int SPOT_LIGHT = 192;
+ static final int DIRECTIONAL_LIGHT = 193;
+ static final int AMBIENT_LIGHT = 194;
+
+
+ /**
+ * Constructs this Object, which initializes the array and Hashtable
+ */
+ J3dNodeTable() {
+ nodeArray = new String[MAX_NUM_NODES];
+ //Initialize all table entries to null
+ for (int i = 0; i < MAX_NUM_NODES; ++i)
+ nodeArray[i] = null;
+ // Setup slots of nodeArray where there should be valid values
+ nodeArray[GROUP] = "Group";
+ nodeArray[TRANSFORM_GROUP] = "TransformGroup";
+ nodeArray[SWITCH_GROUP] = "Switch";
+ nodeArray[ORDERED_GROUP] = "OrderedGroup";
+ nodeArray[BRANCH_GROUP] = "BranchGroup";
+
+ nodeArray[SHAPE3D] = "Shape3D";
+
+ nodeArray[APPEARANCE] = "Appearance";
+ nodeArray[MATERIAL] = "Material";
+ nodeArray[TEXTURE] = "Texture";
+ nodeArray[TEXTURE_2D] = "Texture2D";
+ nodeArray[TEXTURE_3D] = "Texture3D";
+ nodeArray[IMAGE_COMPONENT] = "ImageComponent";
+ nodeArray[IMAGE_COMPONENT_2D] = "ImageComponent2D";
+ nodeArray[IMAGE_COMPONENT_3D] = "ImageComponent3D";
+ nodeArray[TRANSPARENCY_ATTRIBUTES] = "TransparencyAttributes";
+
+ nodeArray[GEOMETRY] = "Geometry";
+ nodeArray[COMPRESSED_GEOMETRY] = "CompressedGeometry";
+ nodeArray[GEOMETRY_ARRAY] = "GeometryArray";
+ nodeArray[GEOMETRY_STRIP_ARRAY] = "GeometryStripArray";
+ nodeArray[INDEXED_GEOMETRY_ARRAY] = "IndexedGeometryArray";
+ nodeArray[INDEXED_GEOMETRY_STRIP_ARRAY] = "IndexedGeometryStripArray";
+ nodeArray[INDEXED_LINE_ARRAY] = "IndexedLineArray";
+ nodeArray[INDEXED_LINE_STRIP_ARRAY] = "IndexedLineStripArray";
+ nodeArray[INDEXED_POINT_ARRAY] = "IndexedPointArray";
+ nodeArray[INDEXED_QUAD_ARRAY] = "IndexedQuadArray";
+ nodeArray[INDEXED_TRIANGLE_ARRAY] = "IndexedTriangleArray";
+ nodeArray[INDEXED_TRIANGLE_FAN_ARRAY] = "IndexedTriangleFanArray";
+ nodeArray[INDEXED_TRIANGLE_STRIP_ARRAY] = "indexedTriangleStripArray";
+ nodeArray[LINE_ARRAY] = "LineArray";
+ nodeArray[LINE_STRIP_ARRAY] = "LineStripArray";
+ nodeArray[POINT_ARRAY] = "PointArray";
+ nodeArray[QUAD_ARRAY] = "QuadArray";
+ nodeArray[TRIANGLE_ARRAY] = "TriangleArray";
+ nodeArray[TRIANGLE_FAN_ARRAY] = "TriangleFanArray";
+ nodeArray[TRIANGLE_STRIP_ARRAY] = "TriangleStripArray";
+ nodeArray[BACKGROUND_SOUND] = "BackgroundSound";
+ nodeArray[POINT_SOUND] = "PointSound";
+ nodeArray[CONE_SOUND] = "ConeSound";
+ nodeArray[MEDIA_CONTAINER] = "MediaContainer";
+
+ nodeArray[ROTATION_INTERPOLATOR] = "RotationInterpolator";
+ nodeArray[ROTPOSSCALEPATH_INTERPOLATOR] = "RotPosScalePathInterpolator";
+ nodeArray[ROTATIONPATH_INTERPOLATOR] = "RotationPathInterpolator";
+ nodeArray[POSITIONPATH_INTERPOLATOR] = "PositionPathInterpolator";
+ nodeArray[ROTPOSPATH_INTERPOLATOR] = "RotPosPathInterpolator";
+ nodeArray[POSITION_INTERPOLATOR] = "PositionInterpolator";
+ nodeArray[SWITCHVALUE_INTERPOLATOR] = "SwitchValueInterpolator";
+ nodeArray[COLOR_INTERPOLATOR] = "ColorInterpolator";
+ nodeArray[SCALE_INTERPOLATOR] = "ScaleInterpolator";
+ nodeArray[SOUND_PLAYER] = "SoundPlayer";
+ nodeArray[SOUND_FADER] = "SoundFader";
+
+ nodeArray[BOUNDS] = "Bounds";
+ nodeArray[BOUNDING_SPHERE] = "BoundingSphere";
+ nodeArray[BOUNDING_BOX] = "BoundingBox";
+ nodeArray[BOUNDING_POLYTOPE] = "BoundingPolytope";
+ nodeArray[TRANSFORM3D] = "Transform3D";
+ nodeArray[BACKGROUND] = "Background";
+
+ nodeArray[LIGHT] = "Light";
+ nodeArray[POINT_LIGHT] = "PointLight";
+ nodeArray[SPOT_LIGHT] = "SpotLight";
+ nodeArray[DIRECTIONAL_LIGHT] = "DirectionalLight";
+ nodeArray[AMBIENT_LIGHT] = "AmbientLight";
+
+ for (int i = 0; i < MAX_NUM_NODES; ++i) {
+ if (nodeArray[i] != null)
+ nodeTable.put(nodeArray[i], new Integer(i));
+ }
+
+ }
+
+ /**
+ * Returns the enumerated value associated with an Object. This
+ * method retrieves the base class name (with no package name and
+ * with no "Retained" portion (if it's part of the Object's name);
+ * we're just looking for the base Java3d node type here.
+ */
+ int getNodeValue(Object object) {
+ Integer i;
+ String fullName = object.getClass().getName();
+ int firstIndex;
+ int lastIndex ;
+ if ((firstIndex = fullName.lastIndexOf(".")) == -1)
+ firstIndex = 0;
+ else
+ firstIndex++;
+ if ((lastIndex = fullName.lastIndexOf("Retained")) == -1)
+ lastIndex = fullName.length();
+ String nodeName = fullName.substring(firstIndex, lastIndex);
+ if ((i = (Integer)nodeTable.get(nodeName))
+ != null) {
+ return i.intValue();
+ }
+ else {
+ // This conditional exists because if a group node is
+ // actually a subclass of some standard Java3d Group type
+ // (e.g., VrmlParser), then we'll just save it and reload
+ // it as a Group.
+ if (object instanceof TransformGroup ||
+ object instanceof TransformGroupRetained)
+ return TRANSFORM_GROUP;
+ else if (object instanceof BranchGroup ||
+ object instanceof BranchGroupRetained)
+ return BRANCH_GROUP;
+ else if (object instanceof Switch ||
+ object instanceof SwitchRetained)
+ return SWITCH_GROUP;
+ else if (object instanceof Group ||
+ object instanceof GroupRetained)
+ return GROUP;
+ else if (object instanceof Shape3D)
+ return SHAPE3D; // For Text2D object in particular
+ else {
+ System.err.println("Warning: Don't know how to save object of type " + object);
+ return 0;
+ }
+ }
+ }
+
+ /**
+ * Returns new instance of an object with the Class name
+ * associated with the given enumerated value.
+ */
+ Object getObject(int nodeValue) {
+ try {
+ if (nodeArray[nodeValue] != null) {
+ String nodeName = "javax.media.j3d." + nodeArray[nodeValue];
+ return Class.forName(nodeName).newInstance();
+ }
+ }
+ catch (Exception e) {
+ throw new RuntimeException("Exception creating object for nodeValue " +
+ nodeValue + "\n nodeName = javax.media.j3d." +
+ nodeArray[nodeValue]);
+ }
+ return null;
+ }
+
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dNotification.java b/j3d-core/src/classes/share/javax/media/j3d/J3dNotification.java
new file mode 100644
index 0000000..d5db279
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dNotification.java
@@ -0,0 +1,63 @@
+/*
+ * $RCSfile: J3dNotification.java,v $
+ *
+ * Copyright 2005-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * J3dNotification is used to hold data for asynchronous error notification.
+ */
+
+class J3dNotification extends Object {
+ /**
+ * The various notification types.
+ */
+ static final int INVALID_TYPE = -1;
+ static final int SHADER_ERROR = 0;
+ static final int RENDERING_ERROR = 1;
+
+ /**
+ * This holds the type of this message
+ */
+ int type = INVALID_TYPE;
+
+ /**
+ * The universe that this message originated from
+ */
+ VirtualUniverse universe;
+
+ /**
+ * The arguements for a message, 6 for now
+ */
+ static final int MAX_ARGS = 6;
+
+ Object[] args = new Object[MAX_ARGS];
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dQueryProps.java b/j3d-core/src/classes/share/javax/media/j3d/J3dQueryProps.java
new file mode 100644
index 0000000..b167c18
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dQueryProps.java
@@ -0,0 +1,129 @@
+/*
+ * $RCSfile: J3dQueryProps.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.*;
+
+
+/**
+ * Properties object for query operations. It is a read-only Map backed
+ * up by a Hashtable.
+ */
+class J3dQueryProps extends AbstractMap {
+ private Hashtable table;
+ private Set entrySet = null;
+
+
+ /**
+ * Constructs a new J3dQueryProps object using the specified
+ * array of keys and the specified values. The arrays must be
+ * the same size.
+ */
+ J3dQueryProps(String[] keys, Object[] values) {
+ table = new Hashtable();
+ for (int i = 0; i < keys.length; i++) {
+ table.put(keys[i], values[i]);
+ }
+ }
+
+ /**
+ * Gets value corresponding to specified key
+ */
+ public Object get(Object key) {
+ return table.get(key);
+ }
+
+ /**
+ * Returns true if the specified key is contained in this Map
+ */
+ public boolean containsKey(Object key) {
+ return table.containsKey(key);
+ }
+
+ /**
+ * Returns true if the specified value is contained in this Map
+ */
+ public boolean containsValue(Object value) {
+ return table.containsValue(value);
+ }
+
+ /**
+ * Returns a new Set object for the entries of this map
+ */
+ public Set entrySet() {
+ if (entrySet == null)
+ entrySet = new EntrySet();
+
+ return entrySet;
+ }
+
+
+ /**
+ * Entry set class
+ */
+ private class EntrySet extends AbstractSet {
+ private EntrySet() {
+ }
+
+ public int size() {
+ return table.size();
+ }
+
+ public Iterator iterator() {
+ return new MapIterator();
+ }
+ }
+
+
+ /**
+ * Entry set class
+ */
+ private class MapIterator implements Iterator {
+ private Iterator i;
+
+ private MapIterator() {
+ i = table.entrySet().iterator();
+ }
+
+ public boolean hasNext() {
+ return i.hasNext();
+ }
+
+ public Object next() {
+ return i.next();
+ }
+
+ public void remove() {
+ throw new UnsupportedOperationException();
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dStructure.java b/j3d-core/src/classes/share/javax/media/j3d/J3dStructure.java
new file mode 100644
index 0000000..fa9b7de
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dStructure.java
@@ -0,0 +1,172 @@
+/*
+ * $RCSfile: J3dStructure.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+
+/**
+ * The J3dStructure is the super class of all structures in Java 3D.
+ * A structure is a object that organizes a collection of objects.
+ */
+
+abstract class J3dStructure extends Object {
+ /**
+ * This is the list of messages to be processed by this structure
+ */
+ UnorderList messageList = new UnorderList(5, J3dMessage.class);
+
+ /**
+ * This is the update Thread for this structure
+ */
+
+ StructureUpdateThread updateThread = null;
+
+ /**
+ * This is the type of update thread
+ */
+ int threadType = -1;
+
+ /**
+ * The universe of this structure
+ */
+ VirtualUniverse universe = null;
+
+ /**
+ * The thread data for the update thread
+ */
+ J3dThreadData threadData = new J3dThreadData();
+
+ /**
+ * number of messages for this snapshot of time
+ */
+ int nMessage = 0;
+ J3dMessage[] msgList = new J3dMessage[5];
+
+ /**
+ * This constructor does nothing
+ */
+ J3dStructure(VirtualUniverse u, int type) {
+ universe = u;
+ threadType = type;
+ threadData.threadType = type;
+ }
+
+ /**
+ * This returns the thread data for this thread.
+ */
+ final J3dThreadData getUpdateThreadData() {
+ return (threadData);
+ }
+
+ /**
+ * This adds a message to the list of messages for this structure
+ */
+ final void addMessage(J3dMessage message) {
+
+ if (threadData != null) {
+ threadData.lastUpdateTime = message.time;
+ } else {
+ // this force message to consume when initialized
+ message.time = -1;
+ }
+ message.incRefcount();
+ messageList.add(message);
+ }
+
+
+ /**
+ * This returns whether or not there are any pending messages
+ */
+ final J3dMessage[] getMessages(long referenceTime) {
+ int sz, n = 0;
+
+ synchronized (messageList) {
+ if ((sz = messageList.size()) > 0) {
+ J3dMessage mess[] = (J3dMessage []) messageList.toArray(false);
+ for (n = 0; n < sz; n++) {
+ if (mess[n].time > referenceTime) {
+ break;
+ }
+ }
+ if (n > 0) {
+ if (msgList.length < n) {
+ msgList = new J3dMessage[n];
+ }
+ messageList.shift(msgList, n);
+ }
+ }
+ }
+
+ nMessage = n;
+ return msgList;
+ }
+
+ final void clearMessages() {
+ synchronized (messageList) {
+ int nmessage = messageList.size();
+ if (nmessage > 0) {
+ J3dMessage mess[] = (J3dMessage []) messageList.toArray(false);
+ for (int i = nmessage-1; i >=0; i--) {
+ mess[i].decRefcount();
+ }
+ messageList.clear();
+ }
+ nMessage = 0;
+ msgList = new J3dMessage[5];
+ }
+
+ }
+
+ int getNumMessage() {
+ return nMessage;
+ }
+
+ /**
+ * This gets overriden by the structure
+ */
+ abstract void processMessages(long referenceTime);
+
+ /**
+ * This is used by MasterControl to process any unused message
+ * for final cleanup. DON'T decrememt message count in
+ * the method, as it is done by MasterControl.
+ */
+ abstract void removeNodes(J3dMessage m);
+
+ /**
+ * Release resource associate with this structure before GC
+ * We need to clear all those IndexedUnorderSet/WakeupIndexedList
+ * so that the listIdx associate with IndexedObject reset to -1.
+ */
+ abstract void cleanup();
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/J3dThread.java b/j3d-core/src/classes/share/javax/media/j3d/J3dThread.java
new file mode 100644
index 0000000..f98b9f3
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/J3dThread.java
@@ -0,0 +1,358 @@
+/*
+ * $RCSfile: J3dThread.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The J3dThread is the super class of all slave threads in Java 3D. It implements
+ * all of the common flow control constructs.
+ */
+
+abstract class J3dThread extends Thread {
+ /**
+ * These are the thread types that a message may affect
+ */
+ static final int BEHAVIOR_SCHEDULER = 0x01;
+ static final int SOUND_SCHEDULER = 0x02;
+ static final int INPUT_DEVICE_SCHEDULER = 0x04;
+ static final int RENDER_THREAD = 0x10;
+// static final int COLLISION_THREAD = 0x20;
+ static final int UPDATE_GEOMETRY = 0x40;
+ static final int UPDATE_RENDER = 0x80;
+ static final int UPDATE_BEHAVIOR = 0x100;
+ static final int UPDATE_SOUND = 0x200;
+ static final int UPDATE_RENDERING_ATTRIBUTES = 0x400;
+ static final int UPDATE_RENDERING_ENVIRONMENT = 0x1000;
+ static final int UPDATE_TRANSFORM = 0x2000;
+
+ /**
+ * The classification types.
+ */
+ static final int WORK_THREAD = 0x01;
+ static final int UPDATE_THREAD = 0x02;
+
+ /**
+ * This runMonitor action puts the thread into an initial wait state
+ */
+ static final int WAIT = 0;
+
+ /**
+ * This runMonitor action notifies MasterControl that this thread
+ * has completed and wait.
+ */
+ static final int NOTIFY_AND_WAIT = 1;
+
+ /**
+ * This is used by Canvas3D Renderer to notify user thread
+ * that swap is completed.
+ */
+ static final int NOTIFY = 2;
+
+ /**
+ * This runMonitor action tells the thread to run N number of
+ * iterations.
+ */
+ static final int RUN = 2;
+
+ /**
+ * This runMonitor action tells the thread to stop running
+ */
+ static final int STOP = 3;
+
+ /**
+ * This indicates that this thread has been activated by MC
+ */
+ boolean active = false;
+
+ /**
+ * This indicates that this thread is alive and running
+ */
+ private volatile boolean running = true;
+
+ /**
+ * This flag is set by the RUN action of runMonitor to indicate that the
+ * waiting thread has work to do.
+ */
+ private volatile boolean ready = false;
+
+ /**
+ * The thread data for this thread
+ */
+ private J3dThreadData[] data = null;
+
+ /**
+ * This indicates that this thread is started and able to accept work
+ */
+ private volatile boolean started = false;
+
+ /**
+ * The time values passed into this thread
+ */
+ long referenceTime;
+
+ /**
+ * Use to assign threadOpts WAIT_ALL_THREADS
+ */
+ long lastWaitTimestamp = 0;
+
+ /**
+ * The type of this thread. It is one of the above constants.
+ */
+ int type;
+
+ /**
+ * The classification of this thread. It is one of the above constants.
+ */
+ int classification = WORK_THREAD;
+
+ /**
+ * The arguments passed in for this thread
+ */
+ Object[] args = null;
+
+ /**
+ * Flag to indicate that user initiate a thread stop
+ */
+ volatile boolean userStop = false;
+
+ /**
+ * Flag to indicate that this thread is waiting to be notify
+ */
+ private volatile boolean waiting = false;
+
+ /**
+ * Some variables used to name threads correctly
+ */
+ private static int numInstances = 0;
+ private int instanceNum = -1;
+
+ private synchronized int newInstanceNum() {
+ return (++numInstances);
+ }
+
+ int getInstanceNum() {
+ if (instanceNum == -1)
+ instanceNum = newInstanceNum();
+ return instanceNum;
+ }
+
+ /**
+ * This method is defined by all slave threads to implement
+ * one iteration of work.
+ */
+ abstract void doWork(long referenceTime);
+
+ /**
+ * This constructor simply assigns the given id.
+ */
+ J3dThread(ThreadGroup t) {
+ super(t, "");
+ }
+
+ /**
+ * This returns the thread data for this thread.
+ */
+ synchronized J3dThreadData getThreadData(View v, Canvas3D c) {
+ J3dThreadData threadData;
+ int i, j;
+ J3dThreadData[] newData;
+
+ if (type != RENDER_THREAD) { // Regular Thread
+ if (data == null) {
+ data = new J3dThreadData[1];
+ data[0] = new J3dThreadData();
+ data[0].thread = this;
+ data[0].threadType = type;
+ data[0].view = null;
+ data[0].canvas = null;
+ }
+ threadData = data[0];
+ } else { // Render thread
+
+ // Note: each renderer has multiple thread data mappings
+ // for its render and swap threads
+
+ if (data == null) {
+ data = new J3dThreadData[1];
+ data[0] = new J3dThreadData();
+ data[0].thread = this;
+ data[0].threadType = type;
+ data[0].view = v;
+ data[0].canvas = c;
+ data[0].threadArgs = new Object[4];
+ threadData = data[0];
+ } else {
+ for (i=0; ioriginalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ LOD lod = (LOD) originalNode;
+
+ int numSwitch = lod.numSwitches();
+ for (int i = 0; i < numSwitch; i++) {
+ addSwitch(lod.getSwitch(i));
+ }
+ }
+
+ /**
+ * Callback used to allow a node to check if any nodes referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any node references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding Node in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * node is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+ int numSwitch = numSwitches();
+
+ for (int i = 0; i < numSwitch; i++) {
+ Switch curSwitch = getSwitch(i);
+ if (curSwitch != null) {
+ setSwitch((Switch)
+ referenceTable.getNewObjectReference(curSwitch), i);
+ }
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Leaf.java b/j3d-core/src/classes/share/javax/media/j3d/Leaf.java
new file mode 100644
index 0000000..c9b445c
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Leaf.java
@@ -0,0 +1,53 @@
+/*
+ * $RCSfile: Leaf.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The Leaf node is an abstract class for all scene graph nodes that
+ * have no children.
+ * Leaf nodes specify lights, geometry, and sounds. They specify special
+ * linking and instancing capabilities for sharing scene graphs and
+ * provide a view platform for positioning and orienting a view in the
+ * virtual world.
+ * false as
+ * the argument.
+ *
+ * @see Material
+ * @see Bounds
+ * @see BoundingLeaf
+ * @see Group
+ * @see PolygonAttributes
+ */
+
+public abstract class Light extends Leaf {
+ /**
+ * Specifies that this Light allows read access to its current state
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_STATE_READ = CapabilityBits.LIGHT_ALLOW_STATE_READ;
+
+ /**
+ * Specifies that this Light allows write access to its current state
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_STATE_WRITE = CapabilityBits.LIGHT_ALLOW_STATE_WRITE;
+
+ /**
+ * Specifies that this Light allows read access to its color
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_COLOR_READ = CapabilityBits.LIGHT_ALLOW_COLOR_READ;
+
+ /**
+ * Specifies that this Light allows write access to its color
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_COLOR_WRITE = CapabilityBits.LIGHT_ALLOW_COLOR_WRITE;
+
+ /**
+ * Specifies that this Light allows read access to its
+ * influencing bounds and bounds leaf information.
+ */
+ public static final int
+ ALLOW_INFLUENCING_BOUNDS_READ = CapabilityBits.LIGHT_ALLOW_INFLUENCING_BOUNDS_READ;
+
+ /**
+ * Specifies that this Light allows write access to its
+ * influencing bounds and bounds leaf information.
+ */
+ public static final int
+ ALLOW_INFLUENCING_BOUNDS_WRITE = CapabilityBits.LIGHT_ALLOW_INFLUENCING_BOUNDS_WRITE;
+
+ /**
+ * Specifies that this Light allows read access to its scope
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_SCOPE_READ = CapabilityBits.LIGHT_ALLOW_SCOPE_READ;
+
+ /**
+ * Specifies that this Light allows write access to its scope
+ * information at runtime.
+ */
+ public static final int
+ ALLOW_SCOPE_WRITE = CapabilityBits.LIGHT_ALLOW_SCOPE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_STATE_READ,
+ ALLOW_COLOR_READ,
+ ALLOW_INFLUENCING_BOUNDS_READ,
+ ALLOW_SCOPE_READ
+ };
+
+ /**
+ * Constructs a Light node with default parameters. The default
+ * values are as follows:
+ *
+ * enable flag : true
+ */
+ public Light() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs and initializes a Light node using the specified color.
+ * @param color the color of the light source
+ */
+ public Light(Color3f color) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((LightRetained)this.retained).initColor(color);
+ }
+
+ /**
+ * Constructs and initializes a Light node using the specified enable
+ * flag and color.
+ * @param lightOn flag indicating whether this light is on or off
+ * @param color the color of the light source
+ */
+ public Light(boolean lightOn, Color3f color) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((LightRetained)this.retained).initEnable(lightOn);
+ ((LightRetained)this.retained).initColor(color);
+ }
+
+ /**
+ * Turns the light on or off.
+ * @param state true or false to set light on or off
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setEnable(boolean state) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_STATE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light0"));
+
+ if (isLive())
+ ((LightRetained)this.retained).setEnable(state);
+ else
+ ((LightRetained)this.retained).initEnable(state);
+ }
+
+ /**
+ * Retrieves this Light's current state (on/off).
+ * @return this node's current state (on/off)
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public boolean getEnable() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_STATE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light1"));
+
+ return ((LightRetained)this.retained).getEnable();
+ }
+
+ /**
+ * Sets the Light's current color.
+ * @param color the value of this node's new color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light2"));
+
+ if (isLive())
+ ((LightRetained)this.retained).setColor(color);
+ else
+ ((LightRetained)this.retained).initColor(color);
+ }
+
+ /**
+ * Gets this Light's current color and places it in the parameter specified.
+ * @param color the vector that will receive this node's color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLOR_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light3"));
+
+ ((LightRetained)this.retained).getColor(color);
+ }
+
+ /**
+ * Replaces the node at the specified index in this Light node's
+ * list of scopes with the specified Group node.
+ * By default, Light nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be stored at the specified index.
+ * @param index the index of the Group node to be replaced.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void setScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light4"));
+
+ if (isLive())
+ ((LightRetained)this.retained).setScope(scope, index);
+ else
+ ((LightRetained)this.retained).initScope(scope, index);
+ }
+
+
+ /**
+ * Retrieves the Group node at the specified index from this Light node's
+ * list of scopes.
+ * @param index the index of the Group node to be returned.
+ * @return the Group node at the specified index.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Group getScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light5"));
+
+ return ((LightRetained)this.retained).getScope(index);
+ }
+
+
+ /**
+ * Inserts the specified Group node into this Light node's
+ * list of scopes at the specified index.
+ * By default, Light nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be inserted at the specified index.
+ * @param index the index at which the Group node is inserted.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void insertScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light6"));
+
+ if (isLive())
+ ((LightRetained)this.retained).insertScope(scope, index);
+ else
+ ((LightRetained)this.retained).initInsertScope(scope, index);
+ }
+
+
+ /**
+ * Removes the node at the specified index from this Light node's
+ * list of scopes. If this operation causes the list of scopes to
+ * become empty, then this Light will have universe scope: all nodes
+ * within the region of influence will be affected by this Light node.
+ * @param index the index of the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the group node at the
+ * specified index is part of a compiled scene graph
+ */
+ public void removeScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light7"));
+
+ if (isLive())
+ ((LightRetained)this.retained).removeScope(index);
+ else
+ ((LightRetained)this.retained).initRemoveScope(index);
+ }
+
+
+ /**
+ * Returns an enumeration of this Light node's list of scopes.
+ * @return an Enumeration object containing all nodes in this Light node's
+ * list of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Enumeration getAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light8"));
+
+ return (Enumeration) ((LightRetained)this.retained).getAllScopes();
+ }
+
+
+ /**
+ * Appends the specified Group node to this Light node's list of scopes.
+ * By default, Light nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be appended.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void addScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light9"));
+
+ if (isLive())
+ ((LightRetained)this.retained).addScope(scope);
+ else
+ ((LightRetained)this.retained).initAddScope(scope);
+ }
+
+
+ /**
+ * Returns the number of nodes in this Light node's list of scopes.
+ * If this number is 0, then the list of scopes is empty and this
+ * Light node has universe scope: all nodes within the region of
+ * influence are affected by this Light node.
+ * @return the number of nodes in this Light node's list of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int numScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light8"));
+
+ return ((LightRetained)this.retained).numScopes();
+ }
+
+
+ /**
+ * Retrieves the index of the specified Group node in this
+ * Light node's list of scopes.
+ *
+ * @param scope the Group node to be looked up.
+ * @return the index of the specified Group node;
+ * returns -1 if the object is not in the list.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int indexOfScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light8"));
+
+ return ((LightRetained)this.retained).indexOfScope(scope);
+ }
+
+
+ /**
+ * Removes the specified Group node from this Light
+ * node's list of scopes. If the specified object is not in the
+ * list, the list is not modified. If this operation causes the
+ * list of scopes to become empty, then this Light
+ * will have universe scope: all nodes within the region of
+ * influence will be affected by this Light node.
+ *
+ * @param scope the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light7"));
+
+ if (isLive())
+ ((LightRetained)this.retained).removeScope(scope);
+ else
+ ((LightRetained)this.retained).initRemoveScope(scope);
+ }
+
+
+ /**
+ * Removes all Group nodes from this Light node's
+ * list of scopes. The Light node will then have
+ * universe scope: all nodes within the region of influence will
+ * be affected by this Light node.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if any group node in this
+ * node's list of scopes is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light7"));
+
+ if (isLive())
+ ((LightRetained)this.retained).removeAllScopes();
+ else
+ ((LightRetained)this.retained).initRemoveAllScopes();
+ }
+
+
+ /**
+ * Sets the Light's influencing region to the specified bounds.
+ * This is used when the influencing bounding leaf is set to null.
+ * @param region the bounds that contains the Light's new influencing
+ * region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBounds(Bounds region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light11"));
+
+ if (isLive())
+ ((LightRetained)this.retained).setInfluencingBounds(region);
+ else
+ ((LightRetained)this.retained).initInfluencingBounds(region);
+ }
+
+ /**
+ * Retrieves the Light node's influencing bounds.
+ * @return this Light's influencing bounds information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getInfluencingBounds() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light12"));
+
+ return ((LightRetained)this.retained).getInfluencingBounds();
+ }
+
+ /**
+ * Sets the Light's influencing region to the specified bounding leaf.
+ * When set to a value other than null, this overrides the influencing
+ * bounds object.
+ * @param region the bounding leaf node used to specify the Light
+ * node's new influencing region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light11"));
+
+ if (isLive())
+ ((LightRetained)this.retained).setInfluencingBoundingLeaf(region);
+ else
+ ((LightRetained)this.retained).initInfluencingBoundingLeaf(region);
+ }
+
+ /**
+ * Retrieves the Light node's influencing bounding leaf.
+ * @return this Light's influencing bounding leaf information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public BoundingLeaf getInfluencingBoundingLeaf() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Light12"));
+
+ return ((LightRetained)this.retained).getInfluencingBoundingLeaf();
+ }
+
+
+
+ /**
+ * Copies all Light information from
+ *
+ * color : white (1,1,1)
+ * scope : empty (universe scope)
+ * influencing bounds : null
+ * influencing bounding leaf : null
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ LightRetained attr = (LightRetained) originalNode.retained;
+ LightRetained rt = (LightRetained) retained;
+
+ Color3f c = new Color3f();
+ attr.getColor(c);
+ rt.initColor(c);
+ rt.initInfluencingBounds(attr.getInfluencingBounds());
+
+ Enumeration elm = attr.getAllScopes();
+ while (elm.hasMoreElements()) {
+ // this reference will set correctly in updateNodeReferences() callback
+ rt.initAddScope((Group) elm.nextElement());
+ }
+
+ // this reference will set correctly in updateNodeReferences() callback
+ rt.initInfluencingBoundingLeaf(attr.getInfluencingBoundingLeaf());
+
+ rt.initEnable(attr.getEnable());
+ }
+
+ /**
+ * Callback used to allow a node to check if any scene graph objects
+ * referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any object references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding object in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * object is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+
+
+ LightRetained rt = (LightRetained) retained;
+ BoundingLeaf bl = rt.getInfluencingBoundingLeaf();
+
+ if (bl != null) {
+ Object o = referenceTable.getNewObjectReference(bl);
+ rt.initInfluencingBoundingLeaf((BoundingLeaf)o);
+ }
+
+ int num = rt.numScopes();
+ for (int i=0; i < num; i++) {
+ rt.initScope((Group) referenceTable.
+ getNewObjectReference(rt.getScope(i)), i);
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LightBin.java b/j3d-core/src/classes/share/javax/media/j3d/LightBin.java
new file mode 100644
index 0000000..f456fdd
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LightBin.java
@@ -0,0 +1,470 @@
+/*
+ * $RCSfile: LightBin.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+
+/**
+ * The LightBin manages a collection of EnvironmentSet objects.
+ * The number of objects managed depends upon the number of Lights
+ * in each EnvironmentSet and the number of lights supported by
+ * the underlying rendering layer.
+ */
+
+class LightBin extends Object implements ObjectUpdate {
+
+ /**
+ * The maximum number of lights in a LightBin
+ */
+ int maxLights = -1;
+
+ /**
+ * The Array of Light references in this LightBin.
+ * This array is always maxLights in length.
+ */
+ LightRetained[] lights = null;
+
+ /**
+ * An Array of reference counts for shared lights in
+ * among EnvirionmentSets
+ */
+ int[] lightsRef = null;
+
+ /**
+ * The number of empty light slots in this LightBin
+ */
+ int numEmptySlots = -1;
+
+ /**
+ * The RenderBin for this object
+ */
+ RenderBin renderBin = null;
+
+ /**
+ * The references to the next and previous LightBins in the
+ * list.
+ */
+ LightBin next = null;
+ LightBin prev = null;
+
+ /**
+ * The list of EnvironmentSets in this LightBin.
+ */
+ EnvironmentSet environmentSetList = null;
+
+ /**
+ * List of envSet to be added for the next iteration
+ */
+ ArrayList insertEnvSet = new ArrayList();
+
+
+
+ /**
+ * cache of the canvasDirty
+ */
+ int canvasDirty = 0;
+
+ /**
+ * lightDirty Mask cache , used to
+ * mark the lightdirty bits for next frame
+ */
+ int lightDirtyMaskCache = 0;
+
+
+ /**
+ * lightDirty Mask used during rendering
+ */
+ int lightDirtyMask = 0;
+
+ /**
+ * List of pointLts in this lightbin
+ * Need to reload these lights when vworld scale changes
+ */
+ ArrayList pointLts = new ArrayList();
+ int[] pointLtsSlotIndex;
+
+ // OrderedGroup info
+ OrderedCollection orderedCollection = null;
+
+ boolean onUpdateList = false;
+
+ // background node that contains geometry
+ BackgroundRetained geometryBackground = null;
+
+
+
+ LightBin(int maxLights, RenderBin rb, boolean isOpaque) {
+ this.maxLights = maxLights;
+ this.numEmptySlots = maxLights;
+ lights = new LightRetained[maxLights];
+ lightsRef = new int[maxLights];
+ renderBin = rb;
+ }
+
+ void reset(boolean inOpaque) {
+ prev = null;
+ next = null;
+ orderedCollection = null;
+ environmentSetList = null;
+ onUpdateList = false;
+ geometryBackground = null;
+ // No need to reset the lights and lightRef
+ if (J3dDebug.devPhase && J3dDebug.debug) {
+ for (int i=0; i
+ * See {@link GeometryArray#GeometryArray(int,int)}
+ * for more exceptions that can be thrown
+ */
+ public LineArray(int vertexCount, int vertexFormat) {
+ super(vertexCount,vertexFormat);
+
+ if (vertexCount < 2 || ((vertexCount%2) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("LineArray0"));
+ }
+
+ /**
+ * Constructs an empty LineArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 2
+ * or vertexCount is not a multiple of 2
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public LineArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap);
+
+ if (vertexCount < 2 || ((vertexCount%2) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("LineArray0"));
+ }
+
+ /**
+ * Constructs an empty LineArray object using the specified
+ * parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 2
+ * or vertexCount is not a multiple of 3
+ * ;
+ * See {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public LineArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes);
+
+ if (vertexCount < 2 || ((vertexCount%2) != 0))
+ throw new IllegalArgumentException(J3dI18N.getString("LineArray0"));
+ }
+
+ /**
+ * Creates the retained mode LineArrayRetained object that this
+ * LineArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new LineArrayRetained();
+ this.retained.setSource(this);
+ }
+
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ LineArrayRetained rt = (LineArrayRetained) retained;
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ LineArray l = new LineArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes);
+ l.duplicateNodeComponent(this);
+ return l;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LineArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/LineArrayRetained.java
new file mode 100644
index 0000000..5fec6d6
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LineArrayRetained.java
@@ -0,0 +1,455 @@
+/*
+ * $RCSfile: LineArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The LineArray object draws the array of vertices as individual
+ * line segments. Each pair of vertices defines a line to be drawn.
+ */
+
+class LineArrayRetained extends GeometryArrayRetained implements Cloneable {
+
+ LineArrayRetained() {
+ this.geoType = GEO_TYPE_LINE_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[2];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ int[] vtxIndexArr = new int[2];
+
+ int i = ((vertexFormat & GeometryArray.BY_REFERENCE) == 0 ?
+ initialVertexIndex : initialCoordIndex);
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while (i < validVertexCount) {
+ for(int j=0; j<2; j++) {
+ vtxIndexArr[j] = i;
+ getVertexData(i++, pnts[j]);
+ }
+ if (intersectLineAndRay(pnts[0], pnts[1], pickRay.origin,
+ pickRay.direction, sdist,
+ iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+ Vector3d dir =
+ new Vector3d(pickSegment.end.x - pickSegment.start.x,
+ pickSegment.end.y - pickSegment.start.y,
+ pickSegment.end.z - pickSegment.start.z);
+
+ while (i < validVertexCount) {
+ for(int j=0; j<2; j++) {
+ vtxIndexArr[j] = i;
+ getVertexData(i++, pnts[j]);
+ }
+ if (intersectLineAndRay(pnts[0], pnts[1],
+ pickSegment.start,
+ dir, sdist, iPnt) &&
+ (sdist[0] <= 1.0)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+ while (i < validVertexCount) {
+ for(int j=0; j<2; j++) {
+ vtxIndexArr[j] = i;
+ getVertexData(i++, pnts[j]);
+ }
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < validVertexCount) {
+ for(int j=0; j<2; j++) {
+ vtxIndexArr[j] = i;
+ getVertexData(i++, pnts[j]);
+ }
+ if (intersectBoundingSphere(pnts, bsphere, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < validVertexCount) {
+ for(int j=0; j<2; j++) {
+ vtxIndexArr[j] = i;
+ getVertexData(i++, pnts[j]);
+ }
+ if (intersectBoundingPolytope(pnts, bpolytope, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+
+ while (i < validVertexCount) {
+ for(int j=0; j<2; j++) {
+ vtxIndexArr[j] = i;
+ getVertexData(i++, pnts[j]);
+ }
+ if (intersectCylinder(pnts, pickCylinder, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < validVertexCount) {
+ for(int j=0; j<2; j++) {
+ vtxIndexArr[j] = i;
+ getVertexData(i++, pnts[j]);
+ }
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("LineArrayRetained0"));
+ default:
+ throw new RuntimeException ("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+
+ }
+
+ boolean intersect(Point3d[] pnts) {
+ Point3d[] points = new Point3d[2];
+ double dist[] = new double[1];
+ Vector3d dir;
+ int i = ((vertexFormat & GeometryArray.BY_REFERENCE) == 0 ?
+ initialVertexIndex : initialCoordIndex);
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+
+ switch (pnts.length) {
+ case 3: // Triangle
+ case 4: // Quad
+ while (i
+ *
+ *
+ * line width : 1
+ */
+ public LineAttributes(){
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a LineAttributes object with specified values.
+ * @param lineWidth the width of lines in pixels
+ * @param linePattern the line pattern, one of PATTERN_SOLID,
+ * PATTERN_DASH, PATTERN_DOT, or PATTERN_DASH_DOT
+ * @param lineAntialiasing flag to set line antialising ON or OFF
+ */
+ public LineAttributes(float lineWidth, int linePattern,
+ boolean lineAntialiasing){
+
+ if (linePattern < PATTERN_SOLID || linePattern > PATTERN_DASH_DOT)
+ throw new IllegalArgumentException(J3dI18N.getString("LineAttributes0"));
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((LineAttributesRetained)this.retained).initLineWidth(lineWidth);
+ ((LineAttributesRetained)this.retained).initLinePattern(linePattern);
+ ((LineAttributesRetained)this.retained).initLineAntialiasingEnable(lineAntialiasing);
+ }
+
+ /**
+ * Sets the line width for this LineAttributes component object.
+ * @param lineWidth the width, in pixels, of line primitives
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setLineWidth(float lineWidth) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_WIDTH_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes1"));
+ if (isLive())
+ ((LineAttributesRetained)this.retained).setLineWidth(lineWidth);
+ else
+ ((LineAttributesRetained)this.retained).initLineWidth(lineWidth);
+
+ }
+
+ /**
+ * Gets the line width for this LineAttributes component object.
+ * @return the width, in pixels, of line primitives
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getLineWidth() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_WIDTH_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes2"));
+ return ((LineAttributesRetained)this.retained).getLineWidth();
+ }
+
+ /**
+ * Sets the line pattern for this LineAttributes component object.
+ * @param linePattern the line pattern to be used, one of:
+ * PATTERN_SOLID, PATTERN_DASH, PATTERN_DOT, PATTERN_DASH_DOT, or
+ * PATTERN_USER_DEFINED.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setLinePattern(int linePattern) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_PATTERN_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes3"));
+
+ if (linePattern < PATTERN_SOLID || linePattern > PATTERN_USER_DEFINED)
+ throw new IllegalArgumentException(J3dI18N.getString("LineAttributes4"));
+
+ if (isLive())
+ ((LineAttributesRetained)this.retained).setLinePattern(linePattern);
+ else
+ ((LineAttributesRetained)this.retained).initLinePattern(linePattern);
+
+
+}
+
+ /**
+ * Gets the line pattern for this LineAttributes component object.
+ * @return the line pattern
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getLinePattern() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_PATTERN_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("LineAttributes5"));
+
+ return ((LineAttributesRetained)this.retained).getLinePattern();
+ }
+
+
+ /**
+ * Sets the line pattern mask to the specified value. This is
+ * used when the linePattern attribute is set to
+ * PATTERN_USER_DEFINED. In this mode, the pattern is specified
+ * using a 16-bit mask that specifies on and off segments. Bit 0
+ * in the pattern mask corresponds to the first pixel of the line
+ * or line strip primitive. A value of 1 for a bit in the pattern
+ * mask indicates that the corresponding pixel is drawn, while a
+ * value of 0 indicates that the corresponding pixel is not drawn.
+ * After all 16 bits in the pattern are used, the pattern is
+ * repeated. For example, a mask of 0x00ff defines a dashed line
+ * with a repeating pattern of 8 pixels on followed by 8 pixels
+ * off. A value of 0x0101 defines a a dotted line with a
+ * repeating pattern of 1 pixel on and 7 pixels off
+ *
+ * line pattern : PATTERN_SOLID
+ * pattern mask : 0xffff
+ * pattern scale factor : 1
+ * line antialiasing : false
+ * originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent,
+ forceDuplicate);
+
+ LineAttributesRetained attr = (LineAttributesRetained)
+ originalNodeComponent.retained;
+ LineAttributesRetained rt = (LineAttributesRetained) retained;
+
+ rt.initLineWidth(attr.getLineWidth());
+ rt.initLinePattern(attr.getLinePattern());
+ rt.initLineAntialiasingEnable(attr.getLineAntialiasingEnable());
+ rt.initPatternMask(attr.getPatternMask());
+ rt.initPatternScaleFactor(attr.getPatternScaleFactor());
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LineAttributesRetained.java b/j3d-core/src/classes/share/javax/media/j3d/LineAttributesRetained.java
new file mode 100644
index 0000000..dac3c42
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LineAttributesRetained.java
@@ -0,0 +1,345 @@
+/*
+ * $RCSfile: LineAttributesRetained.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.ArrayList;
+
+/**
+ * The LineAttributesRetained object defines all rendering state that can be set
+ * as a component object of a Shape3D node.
+ */
+class LineAttributesRetained extends NodeComponentRetained {
+ // A list of pre-defined bits to indicate which component
+ // in this LineAttributesRetained object changed.
+ static final int LINE_WIDTH_CHANGED = 0x01;
+ static final int LINE_PATTERN_CHANGED = 0x02;
+ static final int LINE_AA_CHANGED = 0x04;
+ static final int LINE_PATTERN_MASK_CHANGED = 0x08;
+ static final int LINE_PATTERN_SCALEFACTOR_CHANGED = 0x10;
+
+ // Width, in pixels, of line primitives
+ float lineWidth = 1.0f;
+
+ // The line pattern to be used
+ int linePattern = LineAttributes.PATTERN_SOLID;
+
+ // Line antialiasing switch
+ boolean lineAntialiasing = false;
+
+ // user-defined line pattern mask
+ int linePatternMask = 0xffff;
+
+ // line mask pattern scale factor
+ int linePatternScaleFactor = 1;
+
+ /**
+ * Sets the line width for this lineAttributes component object.
+ * @param lineWidth the width, in pixels, of line primitives
+ */
+ final void initLineWidth(float lineWidth) {
+ this.lineWidth = lineWidth;
+ }
+
+ /**
+ * Sets the line width for this lineAttributes component object and sends a
+ * message notifying the interested structures of the change.
+ * @param lineWidth the width, in pixels, of line primitives
+ */
+ final void setLineWidth(float lineWidth) {
+ initLineWidth(lineWidth);
+ sendMessage(LINE_WIDTH_CHANGED, new Float(lineWidth));
+ }
+
+ /**
+ * Gets the line width for this lineAttributes component object.
+ * @return the width, in pixels, of line primitives
+ */
+ final float getLineWidth() {
+ return lineWidth;
+ }
+
+ /**
+ * Sets the line pattern for this lineAttributes component object
+ * @param linePattern the line pattern to be used, one of:
+ * PATTERN_SOLID, PATTERN_DASH, PATTERN_DOT, or PATTERN_DASH_DOT
+ */
+ final void initLinePattern(int linePattern) {
+ this.linePattern = linePattern;
+ }
+ /**
+ * Sets the line pattern for this lineAttributes component object
+ * and sends a message notifying the interested structures of the change.
+ * @param linePattern the line pattern to be used, one of:
+ * PATTERN_SOLID, PATTERN_DASH, PATTERN_DOT, or PATTERN_DASH_DOT
+ */
+ final void setLinePattern(int linePattern) {
+ initLinePattern(linePattern);
+ sendMessage(LINE_PATTERN_CHANGED, new Integer(linePattern));
+ }
+
+ /**
+ * Gets the line pattern for this lineAttributes component object.
+ * @return the line pattern
+ */
+ final int getLinePattern() {
+ return linePattern;
+ }
+
+ /**
+ * Enables or disables line antialiasing
+ * for this lineAttributes component object and sends a
+ * message notifying the interested structures of the change.
+ * @param state true or false to enable or disable line antialiasing
+ */
+ final void initLineAntialiasingEnable(boolean state) {
+ lineAntialiasing = state;
+ }
+ /**
+ * Enables or disables line antialiasing
+ * for this lineAttributes component object and sends a
+ * message notifying the interested structures of the change.
+ * @param state true or false to enable or disable line antialiasing
+ */
+ final void setLineAntialiasingEnable(boolean state) {
+ initLineAntialiasingEnable(state);
+ sendMessage(LINE_AA_CHANGED,
+ (state ? Boolean.TRUE: Boolean.FALSE));
+ }
+
+ /**
+ * Retrieves the state of the line antialiasing flag.
+ * @return true if line antialiasing is enabled,
+ * false if line antialiasing is disabled
+ */
+ final boolean getLineAntialiasingEnable() {
+ return lineAntialiasing;
+ }
+
+
+ /**
+ * Sets the pattern mask for this LineAttributes component object.
+ * This is used when the linePattern attribute is set to
+ * PATTERN_USER_DEFINED.
+ * @param mask the line pattern mask to be used.
+ */
+ final void initPatternMask(int mask) {
+ this.linePatternMask = mask;
+ }
+
+ /**
+ * Sets the pattern mask for this LineAttributes component object
+ * and sends a message notifying the interested structures of change.
+ * This is used when the linePattern attribute is set to
+ * PATTERN_USER_DEFINED.
+ * @param mask the line pattern mask to be used.
+ */
+ final void setPatternMask(int mask) {
+ initPatternMask(mask);
+ sendMessage(LINE_PATTERN_MASK_CHANGED, new Integer(mask));
+ }
+
+ /**
+ * Retrieves the pattern mask for this LineAttributes component object.
+ * @return the user-defined pattern mask
+ */
+ final int getPatternMask() {
+ return linePatternMask;
+ }
+
+ /**
+ * Sets the pattern mask scale factor for this LineAttributes
+ * component object. This is used when the linePattern attribute
+ * is set to PATTERN_USER_DEFINED.
+ * @param scaleFactor the scale factor of mask, clamp to [1, 15]
+ */
+ final void initPatternScaleFactor(int scaleFactor) {
+ if (scaleFactor < 1) {
+ scaleFactor = 1;
+ } else if (scaleFactor > 15) {
+ scaleFactor = 15;
+ }
+ this.linePatternScaleFactor = scaleFactor;
+ }
+
+ /**
+ * Sets the pattern mask scale factor for this LineAttributes
+ * component object and sends a message notifying the interested
+ * structures of change. This is used when the linePattern
+ * attribute is set to PATTERN_USER_DEFINED.
+ * @param scaleFactor the scale factor of mask, clamp to [1, 15]
+ */
+ final void setPatternScaleFactor(int scaleFactor) {
+ initPatternScaleFactor(scaleFactor);
+ sendMessage(LINE_PATTERN_SCALEFACTOR_CHANGED, new Integer(scaleFactor));
+ }
+
+ /**
+ * Retrieves the pattern scale factor for this LineAttributes
+ * component object.
+ * @return the pattern mask scale factor
+ */
+ final int getPatternScaleFactor() {
+ return linePatternScaleFactor;
+ }
+
+ /**
+ * Creates and initializes a mirror object, point the mirror object
+ * to the retained object if the object is not editable
+ */
+ synchronized void createMirrorObject() {
+ if (mirror == null) {
+ // Check the capability bits and let the mirror object
+ // point to itself if is not editable
+ if (isStatic()) {
+ mirror = this;
+ } else {
+ LineAttributesRetained mirrorLa = new LineAttributesRetained();
+ mirrorLa.source = source;
+ mirrorLa.set(this);
+ mirror = mirrorLa;
+ }
+ } else {
+ ((LineAttributesRetained) mirror).set(this);
+ }
+ }
+
+
+ /**
+ * This method updates the native context.
+ */
+ void updateNative(Context ctx) {
+ Pipeline.getPipeline().updateLineAttributes(ctx,
+ lineWidth, linePattern, linePatternMask,
+ linePatternScaleFactor, lineAntialiasing);
+ }
+
+
+ /**
+ * Initializes a mirror object, point the mirror object to the retained
+ * object if the object is not editable
+ */
+ synchronized void initMirrorObject() {
+ ((LineAttributesRetained)mirror).set(this);
+ }
+
+ /** Update the "component" field of the mirror object with the
+ * given "value"
+ */
+ synchronized void updateMirrorObject(int component, Object value) {
+
+ LineAttributesRetained mirrorLa = (LineAttributesRetained) mirror;
+
+ if ((component & LINE_WIDTH_CHANGED) != 0) {
+ mirrorLa.lineWidth = ((Float)value).floatValue();
+ }
+ else if ((component & LINE_PATTERN_CHANGED) != 0) {
+ mirrorLa.linePattern = ((Integer)value).intValue();
+ }
+ else if ((component & LINE_AA_CHANGED) != 0) {
+ mirrorLa.lineAntialiasing = ((Boolean)value).booleanValue();
+ }
+ else if ((component & LINE_PATTERN_MASK_CHANGED) != 0) {
+ mirrorLa.linePatternMask = ((Integer)value).intValue();
+ }
+ else if ((component & LINE_PATTERN_SCALEFACTOR_CHANGED) != 0)
+ {
+ mirrorLa.linePatternScaleFactor = ((Integer)value).intValue();
+ }
+ }
+
+
+ boolean equivalent(LineAttributesRetained lr) {
+ return ((lr != null) &&
+ (lineWidth == lr.lineWidth) &&
+ (linePattern == lr.linePattern) &&
+ (lineAntialiasing == lr.lineAntialiasing) &&
+ (linePatternMask == lr.linePatternMask) &&
+ (linePatternScaleFactor == lr.linePatternScaleFactor));
+
+ }
+
+ protected void set(LineAttributesRetained lr) {
+ super.set(lr);
+ lineWidth = lr.lineWidth;
+ linePattern = lr.linePattern;
+ linePatternScaleFactor = lr.linePatternScaleFactor;
+ linePatternMask = lr.linePatternMask;
+ lineAntialiasing = lr.lineAntialiasing;
+ }
+
+ final void sendMessage(int attrMask, Object attr) {
+ ArrayList univList = new ArrayList();
+ ArrayList gaList = Shape3DRetained.getGeomAtomsList(mirror.users, univList);
+
+ // Send to rendering attribute structure, regardless of
+ // whether there are users or not (alternate appearance case ..)
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+ createMessage.type = J3dMessage.LINEATTRIBUTES_CHANGED;
+ createMessage.universe = null;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr;
+ createMessage.args[3] = new Integer(changedFrequent);
+ VirtualUniverse.mc.processMessage(createMessage);
+
+
+ // System.err.println("univList.size is " + univList.size());
+ for(int i=0; i
+ * See {@link GeometryStripArray#GeometryStripArray(int,int,int,int[],int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.2
+ */
+ public LineStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int stripVertexCounts[]) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ stripVertexCounts);
+
+ if (vertexCount < 2 )
+ throw new IllegalArgumentException(J3dI18N.getString("LineStripArray0"));
+ }
+
+ /**
+ * Constructs an empty LineStripArray object using the
+ * specified parameters.
+ *
+ * @param vertexCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexFormat
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param texCoordSetMap
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrCount
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param vertexAttrSizes
+ * see {@link GeometryArray#GeometryArray(int,int,int,int[],int,int[])}
+ * for a description of this parameter.
+ *
+ * @param stripVertexCounts
+ * see {@link GeometryStripArray#GeometryStripArray(int,int,int,int[],int,int[],int[])}
+ * for a description of this parameter.
+ *
+ * @exception IllegalArgumentException if vertexCount is less than 2
+ * or any element in the stripVertexCounts array is less than 2
+ * ;
+ * See {@link GeometryStripArray#GeometryStripArray(int,int,int,int[],int,int[],int[])}
+ * for more exceptions that can be thrown
+ *
+ * @since Java 3D 1.4
+ */
+ public LineStripArray(int vertexCount,
+ int vertexFormat,
+ int texCoordSetCount,
+ int[] texCoordSetMap,
+ int vertexAttrCount,
+ int[] vertexAttrSizes,
+ int[] stripVertexCounts) {
+
+ super(vertexCount, vertexFormat,
+ texCoordSetCount, texCoordSetMap,
+ vertexAttrCount, vertexAttrSizes,
+ stripVertexCounts);
+
+ if (vertexCount < 2 )
+ throw new IllegalArgumentException(J3dI18N.getString("LineStripArray0"));
+ }
+
+ /**
+ * Creates the retained mode LineStripArrayRetained object that this
+ * LineStripArray object will point to.
+ */
+ void createRetained() {
+ this.retained = new LineStripArrayRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ LineStripArrayRetained rt = (LineStripArrayRetained) retained;
+ int stripcounts[] = new int[rt.getNumStrips()];
+ rt.getStripVertexCounts(stripcounts);
+ int texSetCount = rt.getTexCoordSetCount();
+ int[] texMap = null;
+ int vertexAttrCount = rt.getVertexAttrCount();
+ int[] vertexAttrSizes = null;
+ if (texSetCount > 0) {
+ texMap = new int[rt.getTexCoordSetMapLength()];
+ rt.getTexCoordSetMap(texMap);
+ }
+ if (vertexAttrCount > 0) {
+ vertexAttrSizes = new int[vertexAttrCount];
+ rt.getVertexAttrSizes(vertexAttrSizes);
+ }
+ LineStripArray l = new LineStripArray(rt.getVertexCount(),
+ rt.getVertexFormat(),
+ texSetCount,
+ texMap,
+ vertexAttrCount,
+ vertexAttrSizes,
+ stripcounts);
+ l.duplicateNodeComponent(this);
+ return l;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LineStripArrayRetained.java b/j3d-core/src/classes/share/javax/media/j3d/LineStripArrayRetained.java
new file mode 100644
index 0000000..81de3b9
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LineStripArrayRetained.java
@@ -0,0 +1,555 @@
+/*
+ * $RCSfile: LineStripArrayRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.lang.Math;
+
+/**
+ * The LineStripArray object draws an array of vertices as a set of
+ * connected line strips. An array of per-strip vertex counts specifies
+ * where the separate strips appear in the vertex array.
+ * For every strip in the set, each vertex, beginning with
+ * the second vertex in the array, defines a line segment to be drawn
+ * from the previous vertex to the current vertex.
+ */
+
+class LineStripArrayRetained extends GeometryStripArrayRetained {
+
+ LineStripArrayRetained() {
+ this.geoType = GEO_TYPE_LINE_STRIP_SET;
+ }
+
+ boolean intersect(PickShape pickShape, PickInfo pickInfo, int flags, Point3d iPnt,
+ GeometryRetained geom, int geomIndex) {
+ Point3d pnts[] = new Point3d[2];
+ double sdist[] = new double[1];
+ double minDist = Double.MAX_VALUE;
+ double x = 0, y = 0, z = 0;
+ int j, end;
+ int i = 0;
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+ int[] vtxIndexArr = new int[2];
+
+ switch (pickShape.getPickType()) {
+ case PickShape.PICKRAY:
+ PickRay pickRay= (PickRay) pickShape;
+
+ while(i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ vtxIndexArr[0] = j;
+ getVertexData(j++, pnts[0]);
+ while (j < end) {
+ vtxIndexArr[1] = j;
+ getVertexData(j++, pnts[1]);
+ if (intersectLineAndRay(pnts[0], pnts[1], pickRay.origin,
+ pickRay.direction, sdist,
+ iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKSEGMENT:
+ PickSegment pickSegment = (PickSegment) pickShape;
+ Vector3d dir =
+ new Vector3d(pickSegment.end.x - pickSegment.start.x,
+ pickSegment.end.y - pickSegment.start.y,
+ pickSegment.end.z - pickSegment.start.z);
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ vtxIndexArr[0] = j;
+ getVertexData(j++, pnts[0]);
+ while (j < end) {
+ vtxIndexArr[1] = j;
+ getVertexData(j++, pnts[1]);
+ if (intersectLineAndRay(pnts[0], pnts[1],
+ pickSegment.start,
+ dir, sdist, iPnt) &&
+ (sdist[0] <= 1.0)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox bbox = (BoundingBox)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ vtxIndexArr[0] = j;
+ getVertexData(j++, pnts[0]);
+ while (j < end) {
+ vtxIndexArr[1] = j;
+ getVertexData(j++, pnts[1]);
+ if (intersectBoundingBox(pnts, bbox, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ vtxIndexArr[0] = j;
+ getVertexData(j++, pnts[0]);
+ while (j < end) {
+ vtxIndexArr[1] = j;
+ getVertexData(j++, pnts[1]);
+ if (intersectBoundingSphere(pnts, bsphere, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope)
+ ((PickBounds) pickShape).bounds;
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ vtxIndexArr[0] = j;
+ getVertexData(j++, pnts[0]);
+ while (j < end) {
+ vtxIndexArr[1] = j;
+ getVertexData(j++, pnts[1]);
+ if (intersectBoundingPolytope(pnts, bpolytope, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKCYLINDER:
+ PickCylinder pickCylinder= (PickCylinder) pickShape;
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ vtxIndexArr[0] = j;
+ getVertexData(j++, pnts[0]);
+ while (j < end) {
+ vtxIndexArr[1] = j;
+ getVertexData(j++, pnts[1]);
+ if (intersectCylinder(pnts, pickCylinder, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKCONE:
+ PickCone pickCone= (PickCone) pickShape;
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ vtxIndexArr[0] = j;
+ getVertexData(j++, pnts[0]);
+ while (j < end) {
+ vtxIndexArr[1] = j;
+ getVertexData(j++, pnts[1]);
+ if (intersectCone(pnts, pickCone, sdist, iPnt)) {
+ if (flags == 0) {
+ return true;
+ }
+ if (sdist[0] < minDist) {
+ minDist = sdist[0];
+ x = iPnt.x;
+ y = iPnt.y;
+ z = iPnt.z;
+ if((flags & PickInfo.CLOSEST_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ if((flags & PickInfo.ALL_GEOM_INFO) != 0) {
+ storeInterestData(pickInfo, flags, geom, geomIndex,
+ vtxIndexArr, iPnt, sdist[0]);
+ }
+ }
+ pnts[0].set(pnts[1]);
+ vtxIndexArr[0] = vtxIndexArr[1];
+ }
+ }
+ break;
+ case PickShape.PICKPOINT:
+ // Should not happen since API already check for this
+ throw new IllegalArgumentException(J3dI18N.getString("LineStripArrayRetained0"));
+ default:
+ throw new RuntimeException ("PickShape not supported for intersection");
+ }
+
+ if (minDist < Double.MAX_VALUE) {
+ iPnt.x = x;
+ iPnt.y = y;
+ iPnt.z = z;
+ return true;
+ }
+ return false;
+ }
+
+ boolean intersect(Point3d[] pnts) {
+ int j, end;
+ Point3d[] points = new Point3d[2];
+ double dist[] = new double[1];
+ Vector3d dir;
+ int i = 0;
+
+ points[0] = new Point3d();
+ points[1] = new Point3d();
+
+
+
+ switch (pnts.length) {
+ case 3:
+ case 4: // Triangle, Quad
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, points[0]);
+ while (j < end) {
+ getVertexData(j++, points[1]);
+ if (intersectSegment(pnts, points[0], points[1],
+ dist, null)) {
+ return true;
+ }
+ points[0].set(points[1]);
+ }
+ }
+ break;
+ case 2: // Line
+ dir = new Vector3d();
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, points[0]);
+ while (j < end) {
+ getVertexData(j++, points[1]);
+ dir.x = points[1].x - points[0].x;
+ dir.y = points[1].y - points[0].y;
+ dir.z = points[1].z - points[0].z;
+ if (intersectLineAndRay(pnts[0], pnts[1],
+ points[0], dir, dist, null) &&
+ (dist[0] <= 1.0)) {
+ return true;
+ }
+ points[0].set(points[1]);
+ }
+ }
+ break;
+ case 1: // Point
+ dir = new Vector3d();
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, points[0]);
+ while (j < end) {
+ getVertexData(j++, points[1]);
+ dir.x = points[1].x - points[0].x;
+ dir.y = points[1].y - points[0].y;
+ dir.z = points[1].z - points[0].z;
+ if (intersectPntAndRay(pnts[0], points[0], dir,
+ dist) &&
+ (dist[0] <= 1.0)) {
+ return true;
+ }
+ points[0].set(points[1]);
+ }
+ }
+ break;
+ }
+ return false;
+ }
+
+ boolean intersect(Transform3D thisToOtherVworld,
+ GeometryRetained geom) {
+ int i = 0;
+ int j, end;
+ Point3d[] pnts = new Point3d[2];
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, pnts[0]);
+ thisToOtherVworld.transform(pnts[0]);
+ while (j < end) {
+ getVertexData(j++, pnts[1]);
+ thisToOtherVworld.transform(pnts[1]);
+ if (geom.intersect(pnts)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+ }
+ return false;
+ }
+
+ // the bounds argument is already transformed
+ boolean intersect(Bounds targetBound) {
+ int i = 0;
+ int j, offset, end;
+ Point3d[] pnts = new Point3d[2];
+ pnts[0] = new Point3d();
+ pnts[1] = new Point3d();
+
+
+
+ switch(targetBound.getPickType()) {
+ case PickShape.PICKBOUNDINGBOX:
+ BoundingBox box = (BoundingBox) targetBound;
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, pnts[0]);
+ while ( j < end) {
+ getVertexData(j++, pnts[1]);
+ if (intersectBoundingBox(pnts, box, null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGSPHERE:
+ BoundingSphere bsphere = (BoundingSphere) targetBound;
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, pnts[0]);
+ while ( j < end) {
+ getVertexData(j++, pnts[1]);
+ if (intersectBoundingSphere(pnts, bsphere, null,
+ null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+ }
+ break;
+ case PickShape.PICKBOUNDINGPOLYTOPE:
+ BoundingPolytope bpolytope = (BoundingPolytope) targetBound;
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, pnts[0]);
+ while ( j < end) {
+ getVertexData(j++, pnts[1]);
+ if (intersectBoundingPolytope(pnts, bpolytope,
+ null, null)) {
+ return true;
+ }
+ pnts[0].set(pnts[1]);
+ }
+ }
+ break;
+ default:
+ throw new RuntimeException("Bounds not supported for intersection "
+ + targetBound);
+ }
+
+ return false;
+ }
+
+ // From Graphics Gems IV (pg5) and Graphics Gems II, Pg170
+ void computeCentroid() {
+ int i = 0;
+ int j;
+ double length;
+ double totallength = 0;
+ int start, end;
+ boolean replaceVertex1;
+ Point3d pnt0 = new Point3d();
+ Point3d pnt1 = new Point3d();
+
+ centroid.x = 0;
+ centroid.y = 0;
+ centroid.z = 0;
+
+
+
+ while (i < stripVertexCounts.length) {
+ j = stripStartVertexIndices[i];
+ end = j + stripVertexCounts[i++];
+ getVertexData(j++, pnt0);
+ replaceVertex1 = true;
+ while (j < end) {
+ if (replaceVertex1) {
+ getVertexData(j++, pnt1);
+ replaceVertex1 = false;
+ } else {
+ getVertexData(j++, pnt0);
+ replaceVertex1 = true;
+ }
+ length = pnt0.distance(pnt1);
+ centroid.x += (pnt0.x + pnt1.x) * length;
+ centroid.y += (pnt0.y + pnt1.y) * length;
+ centroid.z += (pnt0.z + pnt1.z) * length;
+ totallength += length;
+ }
+ }
+ if (totallength != 0.0) {
+ length = 1.0/(2.0 * totallength);
+ centroid.x *= length;
+ centroid.y *= length;
+ centroid.z *= length;
+ }
+ }
+
+ int getClassType() {
+ return LINE_TYPE;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LinearFog.java b/j3d-core/src/classes/share/javax/media/j3d/LinearFog.java
new file mode 100644
index 0000000..bfa9733
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LinearFog.java
@@ -0,0 +1,274 @@
+/*
+ * $RCSfile: LinearFog.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+
+/**
+ * The LinearFog leaf node defines fog distance parameters for
+ * linear fog.
+ * LinearFog extends the Fog node by adding a pair of distance values,
+ * in Z, at which the fog should start obscuring the scene and should maximally
+ * obscure the scene.
+ * f, is computed as follows:
+ *
+ *
+ * where:
+ * f = (backDistance - z) / (backDistance - frontDistance)
+ *
+ *
+ */
+public class LinearFog extends Fog {
+ /**
+ * Specifies that this LinearFog node allows read access to its distance
+ * information.
+ */
+ public static final int
+ ALLOW_DISTANCE_READ = CapabilityBits.LINEAR_FOG_ALLOW_DISTANCE_READ;
+
+ /**
+ * Specifies that this LinearFog node allows write access to its distance
+ * information.
+ */
+ public static final int
+ ALLOW_DISTANCE_WRITE = CapabilityBits.LINEAR_FOG_ALLOW_DISTANCE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_DISTANCE_READ
+ };
+
+ /**
+ * Constructs a LinearFog node with default parameters.
+ * The default values are as follows:
+ * z is the distance from the viewpoint.
+ * frontDistance is the distance at which fog starts obscuring objects.
+ * backDistance is the distance at which fog totally obscurs objects.
+ *
+ * front distance : 0.1
+ */
+ public LinearFog() {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a LinearFog node with the specified fog color.
+ * @param color the fog color
+ */
+ public LinearFog(Color3f color) {
+ super(color);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a LinearFog node with the specified fog color and distances.
+ * @param color the fog color
+ * @param frontDistance the front distance for the fog
+ * @param backDistance the back distance for the fog
+ */
+ public LinearFog(Color3f color, double frontDistance, double backDistance) {
+ super(color);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((LinearFogRetained)this.retained).initFrontDistance(frontDistance);
+ ((LinearFogRetained)this.retained).initBackDistance(backDistance);
+ }
+
+ /**
+ * Constructs a LinearFog node with the specified fog color.
+ * @param r the red component of the fog color
+ * @param g the green component of the fog color
+ * @param b the blue component of the fog color
+ */
+ public LinearFog(float r, float g, float b) {
+ super(r, g, b);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a LinearFog node with the specified fog color and distances.
+ * @param r the red component of the fog color
+ * @param g the green component of the fog color
+ * @param b the blue component of the fog color
+ * @param frontDistance the front distance for the fog
+ * @param backDistance the back distance for the fog
+ */
+ public LinearFog(float r, float g, float b,
+ double frontDistance, double backDistance) {
+ super(r, g, b);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((LinearFogRetained)this.retained).initFrontDistance(frontDistance);
+ ((LinearFogRetained)this.retained).initBackDistance(backDistance);
+ }
+
+ /**
+ * Sets front distance for fog.
+ * @param frontDistance the distance at which fog starts obscuring objects
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setFrontDistance(double frontDistance) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("LinearFog0"));
+
+ if (isLive())
+ ((LinearFogRetained)this.retained).setFrontDistance(frontDistance);
+ else
+ ((LinearFogRetained)this.retained).initFrontDistance(frontDistance);
+
+ }
+
+ /**
+ * Gets front distance for fog.
+ * @return the distance at which fog starts obscuring objects
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public double getFrontDistance() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("LinearFog1"));
+
+ return ((LinearFogRetained)this.retained).getFrontDistance();
+ }
+
+ /**
+ * Sets back distance for fog.
+ * @param backDistance the distance at which fog totally obscurs objects
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setBackDistance(double backDistance) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("LinearFog0"));
+ if (isLive())
+ ((LinearFogRetained)this.retained).setBackDistance(backDistance);
+ else
+ ((LinearFogRetained)this.retained).initBackDistance(backDistance);
+
+ }
+
+ /**
+ * Gets back distance for fog.
+ * @return the distance at which fog totally obscurs objects
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public double getBackDistance() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_DISTANCE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("LinearFog1"));
+
+ return ((LinearFogRetained)this.retained).getBackDistance();
+ }
+
+ /**
+ * Creates the retained mode LinearFogRetained object that this
+ * LinearFog node will point to.
+ */
+ void createRetained() {
+ this.retained = new LinearFogRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ * back distance : 1.0
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ LinearFog lf = new LinearFog();
+ lf.duplicateNode(this, forceDuplicate);
+ return lf;
+ }
+
+
+ /**
+ * Copies all LinearFog information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ LinearFogRetained attr = (LinearFogRetained) originalNode.retained;
+ LinearFogRetained rt = (LinearFogRetained) retained;
+
+ rt.initFrontDistance(attr.getFrontDistance());
+ rt.initBackDistance(attr.getBackDistance());
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LinearFogRetained.java b/j3d-core/src/classes/share/javax/media/j3d/LinearFogRetained.java
new file mode 100644
index 0000000..ed88f49
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LinearFogRetained.java
@@ -0,0 +1,204 @@
+/*
+ * $RCSfile: LinearFogRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Vector;
+import javax.vecmath.*;
+import java.util.ArrayList;
+
+/**
+ * The LinearFog leaf node defines distance parameters for
+ * linear fog.
+ */
+class LinearFogRetained extends FogRetained {
+ /**
+ * Fog front and back distance
+ */
+ private double frontDistance = 0.1;
+ private double backDistance = 1.0;
+ private double frontDistanceInEc;
+ private double backDistanceInEc;
+
+ // dirty bits for LinearFog
+ static final int FRONT_DISTANCE_CHANGED = FogRetained.LAST_DEFINED_BIT << 1;
+ static final int BACK_DISTANCE_CHANGED = FogRetained.LAST_DEFINED_BIT << 2;
+
+ LinearFogRetained() {
+ this.nodeType = NodeRetained.LINEARFOG;
+ }
+
+ /**
+ * Initializes front distance for fog before the object is live
+ */
+ void initFrontDistance(double frontDistance){
+ this.frontDistance = frontDistance;
+ }
+
+ /**
+ * Sets front distance for fog and sends a message
+ */
+ void setFrontDistance(double frontDistance){
+ this.frontDistance = frontDistance;
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.type = J3dMessage.FOG_CHANGED;
+ createMessage.universe = universe;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(FRONT_DISTANCE_CHANGED);
+ createMessage.args[2] = new Double(frontDistance);
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ }
+
+ /**
+ * Gets front distance for fog
+ */
+ double getFrontDistance(){
+ return this.frontDistance;
+ }
+
+ /**
+ * Initializes back distance for fog
+ */
+ void initBackDistance(double backDistance){
+ this.backDistance = backDistance;
+ }
+ /**
+ * Sets back distance for fog
+ */
+ void setBackDistance(double backDistance){
+ this.backDistance = backDistance;
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.type = J3dMessage.FOG_CHANGED;
+ createMessage.universe = universe;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(BACK_DISTANCE_CHANGED);
+ createMessage.args[2] = new Double(backDistance);
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+ /**
+ * Gets back distance for fog
+ */
+ double getBackDistance(){
+ return this.backDistance;
+ }
+ /**
+ * This method and its native counterpart update the native context
+ * fog values.
+ */
+ void update(Context ctx, double scale) {
+ validateDistancesInEc(scale);
+ Pipeline.getPipeline().updateLinearFog(ctx,
+ color.x, color.y, color.z, frontDistanceInEc, backDistanceInEc);
+ }
+
+
+
+ void setLive(SetLiveState s) {
+ GroupRetained group;
+
+ super.setLive(s);
+
+ // Initialize the mirror object, this needs to be done, when
+ // renderBin is not accessing any of the fields
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.FOG_CHANGED;
+ createMessage.args[0] = this;
+ // a snapshot of all attributes that needs to be initialized
+ // in the mirror object
+ createMessage.args[1]= new Integer(INIT_MIRROR);
+ ArrayList addScopeList = new ArrayList();
+ for (int i = 0; i < scopes.size(); i++) {
+ group = (GroupRetained)scopes.get(i);
+ tempKey.reset();
+ group.addAllNodesForScopedFog(mirrorFog, addScopeList, tempKey);
+ }
+ Object[] scopeInfo = new Object[2];
+ scopeInfo[0] = ((scopes.size() > 0) ? Boolean.TRUE:Boolean.FALSE);
+ scopeInfo[1] = addScopeList;
+ createMessage.args[2] = scopeInfo;
+ Color3f clr = new Color3f(color);
+ createMessage.args[3] = clr;
+
+ Object[] obj = new Object[6];
+ obj[0] = boundingLeaf;
+ obj[1] = (regionOfInfluence != null?regionOfInfluence.clone():null);
+ obj[2] = (inBackgroundGroup? Boolean.TRUE:Boolean.FALSE);
+ obj[3] = geometryBackground;
+ obj[4] = new Double(frontDistance);
+ obj[5] = new Double(backDistance);
+
+ createMessage.args[4] = obj;
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ }
+
+
+ // The update Object function.
+ // Note : if you add any more fields here , you need to update
+ // updateFog() in RenderingEnvironmentStructure
+ synchronized void updateMirrorObject(Object[] objs) {
+
+ int component = ((Integer)objs[1]).intValue();
+ Transform3D trans;
+
+ if ((component & FRONT_DISTANCE_CHANGED) != 0)
+ ((LinearFogRetained)mirrorFog).frontDistance = ((Double)objs[2]).doubleValue();
+ if ((component & BACK_DISTANCE_CHANGED) != 0)
+ ((LinearFogRetained)mirrorFog).backDistance = ((Double)objs[2]).doubleValue();
+ if ((component & INIT_MIRROR) != 0) {
+ ((LinearFogRetained)mirrorFog).frontDistance = ((Double)((Object[])objs[4])[4]).doubleValue();
+ ((LinearFogRetained)mirrorFog).backDistance = ((Double)((Object[])objs[4])[5]).doubleValue();
+
+ }
+ ((LinearFogRetained)mirrorFog).setLocalToVworldScale(getLastLocalToVworld().getDistanceScale());
+
+ super.updateMirrorObject(objs);
+ }
+
+ /**
+ * Scale distances from local to eye coordinate
+ */
+ protected void validateDistancesInEc(double vworldToCoexistenceScale) {
+ // vworldToCoexistenceScale can be used here since
+ // CoexistenceToEc has a unit scale
+ double localToEcScale = getLocalToVworldScale() * vworldToCoexistenceScale;
+
+ frontDistanceInEc = frontDistance * localToEcScale;
+ backDistanceInEc = backDistance * localToEcScale;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Link.java b/j3d-core/src/classes/share/javax/media/j3d/Link.java
new file mode 100644
index 0000000..e330eea
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Link.java
@@ -0,0 +1,169 @@
+/*
+ * $RCSfile: Link.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:25 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A Link leaf node allows an application to reference a shared graph,
+ * rooted by a SharedGroup node, from within a branch graph or another
+ * shared graph.
+ * Any number of Link nodes can refer to the same SharedGroup node.
+ */
+
+public class Link extends Leaf {
+ /**
+ * For Link nodes, specifies that the node allows access to
+ * its object's SharedGroup information.
+ */
+ public static final int
+ ALLOW_SHARED_GROUP_READ = CapabilityBits.LINK_ALLOW_SHARED_GROUP_READ;
+
+ /**
+ * For Link nodes, specifies that the node allows writing
+ * its object's SharedGroup information.
+ */
+ public static final int
+ ALLOW_SHARED_GROUP_WRITE = CapabilityBits.LINK_ALLOW_SHARED_GROUP_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_SHARED_GROUP_READ
+ };
+
+ /**
+ * Constructs a Link node object that does not yet point to a
+ * SharedGroup node.
+ */
+ public Link() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs a Link node object that points to the specified
+ * SharedGroup node.
+ * @param sharedGroup the SharedGroup node
+ */
+ public Link(SharedGroup sharedGroup) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((LinkRetained)this.retained).setSharedGroup(sharedGroup);
+ }
+
+ /**
+ * Creates the retained mode LinkRetained object that this
+ * Link object will point to.
+ */
+ void createRetained() {
+ this.retained = new LinkRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Sets the node's SharedGroup reference.
+ * @param sharedGroup the SharedGroup node to reference
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setSharedGroup(SharedGroup sharedGroup) {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SHARED_GROUP_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Link0"));
+ ((LinkRetained)this.retained).setSharedGroup(sharedGroup);
+ }
+
+ /**
+ * Retrieves the node's SharedGroup reference.
+ * @return the SharedGroup node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public SharedGroup getSharedGroup() {
+
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SHARED_GROUP_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Link1"));
+ return ((LinkRetained)this.retained).getSharedGroup();
+ }
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ *
+ * The cloned Link node will refer to the same
+ * SharedGroup as the original node. The SharedGroup referred to by
+ * this Link node will not be cloned.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ Link l = new Link();
+ l.duplicateNode(this, forceDuplicate);
+ return l;
+ }
+
+ /**
+ * Copies all Link information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+ ((LinkRetained) retained).setSharedGroup(
+ ((LinkRetained) originalNode.retained).getSharedGroup());
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/LinkRetained.java b/j3d-core/src/classes/share/javax/media/j3d/LinkRetained.java
new file mode 100644
index 0000000..479d1ca
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/LinkRetained.java
@@ -0,0 +1,349 @@
+/*
+ * $RCSfile: LinkRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+import java.util.*;
+
+/**
+ * A Link leaf node consisting of a reference to a SharedGroup node.
+ */
+
+class LinkRetained extends LeafRetained {
+ /**
+ * The SharedGroup component of the link node.
+ */
+ SharedGroupRetained sharedGroup;
+
+ static String plus = "+";
+
+ // This is used when setLive to check for cycle scene graph
+ boolean visited = false;
+
+ LinkRetained() {
+ this.nodeType = NodeRetained.LINK;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ /**
+ * Sets the SharedGroup reference.
+ * @param sharedGroup the SharedGroup node
+ */
+ void setSharedGroup(SharedGroup sharedGroup) {
+ // Note that it is possible that the sharedGroup pass
+ // in already link to another link and live.
+ HashKey newKeys[] = null;
+ boolean abort = false;
+
+ if (source.isLive()) {
+ // bug 4370407: if sharedGroup is a parent, then don't do anything
+ if (sharedGroup != null) {
+ synchronized(universe.sceneGraphLock) {
+ NodeRetained pa;
+ for (pa = parent; pa != null; pa = pa.parent) {
+ if (pa == (NodeRetained)sharedGroup.retained) {
+ abort = true;
+ throw new SceneGraphCycleException(J3dI18N.getString("LinkRetained1"));
+ }
+ }
+ }
+ if (abort)
+ return;
+ }
+
+ newKeys = getNewKeys(locale.nodeId, localToVworldKeys);
+
+ if (this.sharedGroup != null) {
+ ((GroupRetained) parent).checkClearLive(this.sharedGroup,
+ newKeys, true, null,
+ 0, 0, this);
+ this.sharedGroup.parents.removeElement(this);
+ }
+ }
+
+ if (sharedGroup != null) {
+ this.sharedGroup =
+ (SharedGroupRetained)sharedGroup.retained;
+ } else {
+ this.sharedGroup = null;
+ }
+
+ if (source.isLive() && (sharedGroup != null)) {
+
+ this.sharedGroup.parents.addElement(this);
+ visited = true;
+ try {
+ int ci = ((GroupRetained) parent).indexOfChild((Node)this.sharedGroup.source);
+ ((GroupRetained) parent).checkSetLive(this.sharedGroup, ci,
+ newKeys, true, null,
+ 0, this);
+ } catch (SceneGraphCycleException e) {
+ throw e;
+ } finally {
+ visited = false;
+ }
+ }
+
+ }
+
+ /**
+ * Retrieves the SharedGroup reference.
+ * @return the SharedGroup node
+ */
+ SharedGroup getSharedGroup() {
+ return (sharedGroup != null ?
+ (SharedGroup)this.sharedGroup.source : null);
+ }
+
+ void computeCombineBounds(Bounds bounds) {
+
+ if (boundsAutoCompute) {
+ sharedGroup.computeCombineBounds(bounds);
+ } else {
+ // Should this be lock too ? ( MT safe ? )
+ synchronized(localBounds) {
+ bounds.combine(localBounds);
+ }
+ }
+ }
+
+
+ /**
+ * Gets the bounding object of a node.
+ * @return the node's bounding object
+ */
+ Bounds getBounds() {
+ return (boundsAutoCompute ?
+ (Bounds)sharedGroup.getBounds().clone() :
+ super.getBounds());
+ }
+
+
+ /**
+ * assign a name to this node when it is made live.
+ */
+ void setLive(SetLiveState s) {
+
+ super.doSetLive(s);
+
+ if (inBackgroundGroup) {
+ throw new
+ IllegalSceneGraphException(J3dI18N.getString("LinkRetained0"));
+ }
+
+ if (nodeId == null) {
+ nodeId = universe.getNodeId();
+ }
+
+ if (sharedGroup != null) {
+ this.sharedGroup.parents.addElement(this);
+ HashKey newKeys[] = getNewKeys(s.locale.nodeId, s.keys);
+ HashKey oldKeys[] = s.keys;
+ s.keys = newKeys;
+ s.inSharedGroup = true;
+ if (visited) {
+ throw new SceneGraphCycleException(J3dI18N.getString("LinkRetained1"));
+ }
+ visited = true;
+ try {
+ this.sharedGroup.setLive(s);
+ } catch (SceneGraphCycleException e) {
+ throw e;
+ } finally {
+ visited = false;
+ }
+
+ s.inSharedGroup = inSharedGroup;
+ s.keys = oldKeys;
+
+ localBounds.setWithLock(this.sharedGroup.localBounds);
+ }
+
+ super.markAsLive();
+ }
+
+ void setNodeData(SetLiveState s) {
+
+ super.setNodeData(s);
+
+ // add this node to parentTransformLink's childTransformLink
+ if (s.childTransformLinks != null) {
+ // do not duplicate shared nodes
+ synchronized(s.childTransformLinks) {
+ if(!inSharedGroup || !s.childTransformLinks.contains(this)) {
+ s.childTransformLinks.add(this);
+ }
+ }
+ }
+
+ // add this node to parentSwitchLink's childSwitchLink
+ if (s.childSwitchLinks != null) {
+ if(!inSharedGroup ||
+ // only add if not already added in sharedGroup
+ !s.childSwitchLinks.contains(this)) {
+ s.childSwitchLinks.add(this);
+ }
+ }
+ }
+
+
+ void recombineAbove() {
+ localBounds.setWithLock(sharedGroup.localBounds);
+ parent.recombineAbove();
+ }
+
+ /**
+ * assign a name to this node when it is made live.
+ */
+ void clearLive(SetLiveState s) {
+
+ if (sharedGroup != null) {
+ HashKey newKeys[] = getNewKeys(s.locale.nodeId, s.keys);
+ super.clearLive(s);
+ HashKey oldKeys[] = s.keys;
+ s.keys = newKeys;
+ s.inSharedGroup = true;
+ this.sharedGroup.parents.removeElement(this);
+ this.sharedGroup.clearLive(s);
+ s.inSharedGroup = inSharedGroup;
+ s.keys = oldKeys;
+ } else {
+ super.clearLive(s);
+ }
+ }
+
+ void removeNodeData(SetLiveState s) {
+ if(refCount <= 0) {
+ // either not in sharedGroup or last instance in sharedGroup
+ // remove this node from parentTransformLink's childTransformLink
+ if (parentTransformLink != null) {
+ ArrayList obj;
+ if (parentTransformLink instanceof TransformGroupRetained) {
+ obj = ((TransformGroupRetained)
+ parentTransformLink).childTransformLinks;
+ } else {
+ obj = ((SharedGroupRetained)
+ parentTransformLink).childTransformLinks;
+ }
+ synchronized(obj) {
+ obj.remove(this);
+ }
+ }
+
+ // remove this node from parentSwitchLink's childSwitchLink
+ if (parentSwitchLink != null) {
+ ArrayList switchLinks;
+ for(int i=0; iLocale that intersect with PickShape.
+ * The resultant array is unordered.
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @see BranchGroup#pickAll
+ */
+ public SceneGraphPath[] pickAll( PickShape pickShape ) {
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ PickInfo[] pickInfoArr = pickAll( PickInfo.PICK_BOUNDS,
+ PickInfo.SCENEGRAPHPATH, pickShape);
+
+ if(pickInfoArr == null) {
+ return null;
+ }
+ SceneGraphPath[] sgpArr = new SceneGraphPath[pickInfoArr.length];
+ for( int i=0; iPickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see BranchGroup#pickAll(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+ public PickInfo[] pickAll( int mode, int flags, PickShape pickShape ) {
+
+ validateModeFlagAndPickShape(mode, flags, pickShape);
+
+ GeometryAtom geomAtoms[] = universe.geometryStructure.pickAll(this, pickShape);
+
+ return PickInfo.pick(this, geomAtoms, mode, flags, pickShape, PickInfo.PICK_ALL);
+
+ }
+
+ /**
+ * Returns a sorted array of references to all the pickable items
+ * that intersect with the pickShape. Element [0] references the
+ * item closest to origin of PickShape successive array
+ * elements are further from the origin
+ *
+ * NOTE: If pickShape is of type PickBounds, the resulting array
+ * is unordered.
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @see BranchGroup#pickAllSorted
+ */
+ public SceneGraphPath[] pickAllSorted( PickShape pickShape ) {
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ PickInfo[] pickInfoArr = pickAllSorted( PickInfo.PICK_BOUNDS,
+ PickInfo.SCENEGRAPHPATH, pickShape);
+
+ if(pickInfoArr == null) {
+ return null;
+ }
+ SceneGraphPath[] sgpArr = new SceneGraphPath[pickInfoArr.length];
+ for( int i=0; iPickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see BranchGroup#pickAllSorted(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+ public PickInfo[] pickAllSorted( int mode, int flags, PickShape pickShape ) {
+
+ validateModeFlagAndPickShape(mode, flags, pickShape);
+ GeometryAtom geomAtoms[] = universe.geometryStructure.pickAll(this, pickShape);
+
+ if ((geomAtoms == null) || (geomAtoms.length == 0)) {
+ return null;
+ }
+
+ PickInfo[] pickInfoArr = null;
+
+ if (mode == PickInfo.PICK_GEOMETRY) {
+ // Need to have closestDistance set
+ flags |= PickInfo.CLOSEST_DISTANCE;
+ pickInfoArr= PickInfo.pick(this, geomAtoms, mode, flags, pickShape, PickInfo.PICK_ALL);
+ if (pickInfoArr != null) {
+ PickInfo.sortPickInfoArray(pickInfoArr);
+ }
+ }
+ else {
+ PickInfo.sortGeomAtoms(geomAtoms, pickShape);
+ pickInfoArr= PickInfo.pick(this, geomAtoms, mode, flags, pickShape, PickInfo.PICK_ALL);
+ }
+
+ return pickInfoArr;
+ }
+
+ /**
+ * Returns a SceneGraphPath which references the pickable item
+ * which is closest to the origin of pickShape.
+ *
+ * NOTE: If pickShape is of type PickBounds, the return is any
+ * pickable node below this Locale.
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @see BranchGroup#pickClosest
+ */
+ public SceneGraphPath pickClosest( PickShape pickShape ) {
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ PickInfo pickInfo = pickClosest( PickInfo.PICK_BOUNDS,
+ PickInfo.SCENEGRAPHPATH, pickShape);
+
+ if(pickInfo == null) {
+ return null;
+ }
+ return pickInfo.getSceneGraphPath();
+ }
+
+ /**
+ * Returns a PickInfo which references the pickable item
+ * which is closest to the origin of pickShape.
+ * The accuracy of the pick is set by the pick mode. The mode include :
+ * PickInfo.PICK_BOUNDS and PickInfo.PICK_GEOMETRY. The amount of information returned
+ * is specified via a masked variable, flags, indicating which components are
+ * present in each returned PickInfo object.
+ *
+ * @param mode picking mode, one of PickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see BranchGroup#pickClosest(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+ public PickInfo pickClosest( int mode, int flags, PickShape pickShape ) {
+
+ PickInfo[] pickInfoArr = null;
+
+ pickInfoArr = pickAllSorted( mode, flags, pickShape );
+
+ if(pickInfoArr == null) {
+ return null;
+ }
+
+ return pickInfoArr[0];
+
+ }
+
+ /**
+ * Returns a reference to any item that is Pickable below this
+ * Locale which intersects with pickShape.
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @see BranchGroup#pickAny
+ */
+ public SceneGraphPath pickAny( PickShape pickShape ) {
+ if (universe == null) {
+ throw new IllegalStateException(J3dI18N.getString("Locale4"));
+ }
+
+ PickInfo pickInfo = pickAny( PickInfo.PICK_BOUNDS,
+ PickInfo.SCENEGRAPHPATH, pickShape);
+
+ if(pickInfo == null) {
+ return null;
+ }
+ return pickInfo.getSceneGraphPath();
+
+ }
+
+ /**
+ * Returns a PickInfo which references the pickable item below this
+ * Locale which intersects with pickShape.
+ * The accuracy of the pick is set by the pick mode. The mode include :
+ * PickInfo.PICK_BOUNDS and PickInfo.PICK_GEOMETRY. The amount of information returned
+ * is specified via a masked variable, flags, indicating which components are
+ * present in each returned PickInfo object.
+ *
+ * @param mode picking mode, one of PickInfo.PICK_BOUNDS or PickInfo.PICK_GEOMETRY.
+ *
+ * @param flags a mask indicating which components are present in each PickInfo object.
+ * This is specified as one or more individual bits that are bitwise "OR"ed together to
+ * describe the PickInfo data. The flags include :
+ *
+ *
+ *
+ * @param pickShape the description of this picking volume or area.
+ *
+ * @exception IllegalArgumentException if flags contains both CLOSEST_GEOM_INFO and
+ * ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint and pick mode
+ * is set to PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is neither PICK_BOUNDS
+ * nor PICK_GEOMETRY.
+ *
+ * @exception IllegalArgumentException if pick mode is PICK_BOUNDS
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalArgumentException if pickShape is PickBounds
+ * and flags includes any of CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE,
+ * CLOSEST_GEOM_INFO or ALL_GEOM_INFO.
+ *
+ * @exception IllegalStateException if this Locale has been
+ * removed from its VirtualUniverse.
+ *
+ * @exception CapabilityNotSetException if the mode is
+ * PICK_GEOMETRY and the Geometry.ALLOW_INTERSECT capability bit
+ * is not set in any Geometry objects referred to by any shape
+ * node whose bounds intersects the PickShape.
+ *
+ * @exception CapabilityNotSetException if flags contains any of
+ * CLOSEST_INTERSECTION_POINT, CLOSEST_DISTANCE, CLOSEST_GEOM_INFO
+ * or ALL_GEOM_INFO, and the capability bits that control reading of
+ * coordinate data are not set in any GeometryArray object referred
+ * to by any shape node that intersects the PickShape.
+ * The capability bits that must be set to avoid this exception are as follows :
+ * PickInfo.SCENEGRAPHPATH - request for computed SceneGraphPath.
+ * PickInfo.NODE - request for computed intersected Node.
+ * PickInfo.LOCAL_TO_VWORLD - request for computed local to virtual world transform.
+ * PickInfo.CLOSEST_INTERSECTION_POINT - request for closest intersection point.
+ * PickInfo.CLOSEST_DISTANCE - request for the distance of closest intersection.
+ * PickInfo.CLOSEST_GEOM_INFO - request for only the closest intersection geometry information.
+ * PickInfo.ALL_GEOM_INFO - request for all intersection geometry information.
+ *
+ *
+ *
+ * @see BranchGroup#pickAny(int,int,javax.media.j3d.PickShape)
+ * @see PickInfo
+ *
+ * @since Java 3D 1.4
+ *
+ */
+ public PickInfo pickAny( int mode, int flags, PickShape pickShape ) {
+
+ validateModeFlagAndPickShape(mode, flags, pickShape);
+ GeometryAtom geomAtoms[] = universe.geometryStructure.pickAll(this, pickShape);
+
+ PickInfo[] pickInfoArr = PickInfo.pick(this, geomAtoms, mode, flags, pickShape, PickInfo.PICK_ANY);
+
+ if(pickInfoArr == null) {
+ return null;
+ }
+
+ return pickInfoArr[0];
+
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/MRSWLock.java b/j3d-core/src/classes/share/javax/media/j3d/MRSWLock.java
new file mode 100644
index 0000000..aee9bd9
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/MRSWLock.java
@@ -0,0 +1,93 @@
+/*
+ * $RCSfile: MRSWLock.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Use this lock to allow multiple reads/single write synchronization.
+ * To prevent deadlock a read/writeLock call must match with a read/writeUnlock call.
+ * Write request has precedence over read request.
+ */
+
+class MRSWLock {
+
+ static boolean debug = false;
+
+ private int readCount;
+ private boolean write;
+ private int writeRequested;
+ private int lockRequested;
+
+ MRSWLock() {
+ readCount = 0;
+ write = false;
+ writeRequested = 0;
+ lockRequested = 0;
+ }
+
+ synchronized final void readLock() {
+ lockRequested++;
+ while((write == true) || (writeRequested > 0)) {
+ try { wait(); } catch(InterruptedException e){}
+ }
+ lockRequested--;
+ readCount++;
+ }
+
+ synchronized final void readUnlock() {
+ if(readCount>0)
+ readCount--;
+ else
+ if(debug) System.err.println("ReadWriteLock.java : Problem! readCount is >= 0.");
+
+ if(lockRequested>0)
+ notifyAll();
+ }
+
+ synchronized final void writeLock() {
+ lockRequested++;
+ writeRequested++;
+ while((readCount>0)||(write == true)) {
+ try { wait(); } catch(InterruptedException e){}
+ }
+ write = true;
+ lockRequested--;
+ writeRequested--;
+ }
+
+ synchronized final void writeUnlock() {
+ write = false;
+
+ if(lockRequested>0)
+ notifyAll();
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/MasterControl.java b/j3d-core/src/classes/share/javax/media/j3d/MasterControl.java
new file mode 100644
index 0000000..33785bb
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/MasterControl.java
@@ -0,0 +1,3978 @@
+/*
+ * $RCSfile: MasterControl.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.40 $
+ * $Date: 2008/05/22 18:10:39 $
+ * $State: Exp $
+ */
+
+/*
+ * Portions of this code were derived from work done by the Blackdown
+ * group (www.blackdown.org), who did the initial Linux implementation
+ * of the Java 3D API.
+ */
+
+package javax.media.j3d;
+
+import java.util.*;
+import java.awt.*;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+class MasterControl {
+
+ /**
+ * Options for the runMonitor
+ */
+ static final int CHECK_FOR_WORK = 0;
+ static final int SET_WORK = 1;
+ static final int RUN_THREADS = 2;
+ static final int THREAD_DONE = 3;
+ static final int SET_WORK_FOR_REQUEST_RENDERER = 5;
+ static final int RUN_RENDERER_CLEANUP = 6;
+
+ // The thread states for MC
+ static final int SLEEPING = 0;
+ static final int RUNNING = 1;
+ static final int WAITING_FOR_THREADS = 3;
+ static final int WAITING_FOR_CPU = 4;
+ static final int WAITING_FOR_RENDERER_CLEANUP = 5;
+
+ // Constants used in renderer thread argument
+ static final Integer REQUESTRENDER = new Integer(Renderer.REQUESTRENDER);
+ static final Integer RENDER = new Integer(Renderer.RENDER);
+ static final Integer SWAP = new Integer(Renderer.SWAP);
+
+ // Constants used for request from user threads
+ static final Integer ACTIVATE_VIEW = new Integer(1);
+ static final Integer DEACTIVATE_VIEW = new Integer(2);
+ static final Integer START_VIEW = new Integer(3);
+ static final Integer STOP_VIEW = new Integer(4);
+ static final Integer REEVALUATE_CANVAS = new Integer(5);
+ static final Integer UNREGISTER_VIEW = new Integer(6);
+ static final Integer PHYSICAL_ENV_CHANGE = new Integer(7);
+ static final Integer INPUTDEVICE_CHANGE = new Integer(8);
+ static final Integer EMPTY_UNIVERSE = new Integer(9);
+ static final Integer START_RENDERER = new Integer(10);
+ static final Integer STOP_RENDERER = new Integer(11);
+ static final Integer RENDER_ONCE = new Integer(12);
+ static final Integer FREE_CONTEXT = new Integer(13);
+ static final Integer FREE_DRAWING_SURFACE = new Integer(14);
+ static final Integer FREE_MESSAGE = new Integer(15);
+ static final Integer RESET_CANVAS = new Integer(16);
+ static final Integer GETBESTCONFIG = new Integer(17);
+ static final Integer ISCONFIGSUPPORT = new Integer(18);
+ static final Integer SET_GRAPHICSCONFIG_FEATURES = new Integer(19);
+ static final Integer SET_QUERYPROPERTIES = new Integer(20);
+ static final Integer SET_VIEW = new Integer(21);
+
+ // Developer logger for reporting informational messages; see getDevLogger()
+ private static boolean devLoggerEnabled = false;
+ private static Logger devLogger;
+
+ // Stats logger for reporting runtime statistics; see getStatsLogger()
+ private static boolean statsLoggerEnabled = false;
+ private static Logger statsLogger;
+
+ // Core logger for reporting internal errors, warning, and
+ // informational messages; see getCoreLogger()
+ private static boolean coreLoggerEnabled = false;
+ private static Logger coreLogger;
+
+ // Flag indicating that the rendering pipeline libraries are loaded
+ private static boolean librariesLoaded = false;
+
+ // Issue 257: flag indicating that we are running in "appletLauncher" mode
+ // and should use JNLPAppletLauncher to load any native libraries
+ private static boolean appletLauncher = false;
+
+ /**
+ * reference to MasterControl thread
+ */
+ private MasterControlThread mcThread = null;
+
+ /**
+ * The list of views that are currently registered
+ */
+ private UnorderList views = new UnorderList(1, View.class);
+
+
+ /**
+ * by MIK OF CLASSX
+ *
+ * the flag to indicate whether the background of the offscreen
+ * canvas must be transparent or not false by default
+ */
+ boolean transparentOffScreen = false;
+
+ /**
+ * Flag to indicate whether Pbuffers are used for off-screen
+ * rendering; true by default. Set by the "j3d.usePbuffer"
+ * property, When this flag is set to false, Bitmap (Windows) or
+ * Pixmap (UNIX) rendering will be used
+ */
+ boolean usePbuffer = true;
+
+ /**
+ * Flag to indicate whether should renderer view frustum culling is done;
+ * true by default.
+ * Set by the -Dj3d.viewFrustumCulling property, When this flag is
+ * set to false, the renderer view frustum culling is turned off.
+ */
+ boolean viewFrustumCulling = true;
+
+ /**
+ * the flag to indicate whether the geometry should be locked or not
+ */
+
+ private boolean lockGeometry = false;
+
+ /**
+ * The number of registered views that are active
+ */
+ private int numActiveViews = 0;
+
+ /**
+ * The list of active universes get from View
+ */
+ private UnorderList activeUniverseList = new UnorderList(VirtualUniverse.class);
+
+ /**
+ * The list of universes register from View
+ */
+ private UnorderList regUniverseList = new UnorderList(VirtualUniverse.class);
+
+ /**
+ * A lock used for accessing time structures.
+ */
+ private Object timeLock = new Object();
+
+
+ /**
+ * The current "time" value
+ */
+ private long time = 0;
+
+ /**
+ * Use to assign threadOpts in Renderer thread.
+ */
+ private long waitTimestamp = 0;
+
+ /**
+ * The current list of work threads
+ */
+ private UnorderList stateWorkThreads =
+ new UnorderList(J3dThreadData.class);
+ private UnorderList renderWorkThreads =
+ new UnorderList(J3dThreadData.class);
+ private UnorderList requestRenderWorkThreads =
+ new UnorderList(J3dThreadData.class);
+
+ /**
+ * The current list of work threads
+ */
+ private UnorderList renderThreadData = new UnorderList(J3dThreadData.class);
+
+ /**
+ * The list of input device scheduler thread
+ */
+ private UnorderList inputDeviceThreads =
+ new UnorderList(1, InputDeviceScheduler.class);
+
+ /**
+ * A flag that is true when the thread lists need updating
+ */
+ private boolean threadListsChanged;
+
+
+ /**
+ * Markers for the last transform structure update thread
+ * and the last update thread.
+ */
+ private int lastTransformStructureThread = 0;
+ private int lastStructureUpdateThread = 0;
+
+ /**
+ * The current time snapshots
+ */
+ private long currentTime;
+
+ // Only one Timer thread in the system.
+ TimerThread timerThread;
+
+ // Only one Notification thread in the system.
+ private NotificationThread notificationThread;
+
+ /**
+ * This flag indicates that MC is running
+ */
+ volatile boolean running = true;
+
+ /**
+ * This flag indicates that MC has work to do
+ */
+ private boolean workToDo = false;
+
+ /**
+ * This flag indicates that there is work for requestRenderer
+ */
+ private boolean requestRenderWorkToDo = false;
+
+ /**
+ * The number of THREAD_DONE messages pending
+ */
+ private int threadPending = 0;
+ private int renderPending = 0;
+ private int statePending = 0;
+
+ /**
+ * State variables for work lists
+ */
+ private boolean renderWaiting = false;
+ private boolean stateWaiting = false;
+
+ /**
+ * The current state of the MC thread
+ */
+ private int state = SLEEPING;
+
+ // time for sleep in order to met the minimum frame duration
+ private long sleepTime = 0;
+
+
+ /**
+ * The number of cpu's Java 3D may use
+ */
+ private int cpuLimit;
+
+ /**
+ * A list of mirror objects to be updated
+ */
+ private UnorderList mirrorObjects = new UnorderList(ObjectUpdate.class);
+
+ /**
+ * The renderingAttributesStructure for updating node component
+ * objects
+ */
+ private RenderingAttributesStructure renderingAttributesStructure =
+ new RenderingAttributesStructure();
+
+ /**
+ * The default rendering method
+ */
+ private DefaultRenderMethod defaultRenderMethod = null;
+
+ /**
+ * The text3D rendering method
+ */
+ private Text3DRenderMethod text3DRenderMethod = null;
+
+ /**
+ * The vertex array rendering method
+ */
+ private VertexArrayRenderMethod vertexArrayRenderMethod = null;
+
+ /**
+ * The displayList rendering method
+ */
+ private DisplayListRenderMethod displayListRenderMethod = null;
+
+ /**
+ * The compressed geometry rendering method
+ */
+ private CompressedGeometryRenderMethod compressedGeometryRenderMethod = null;
+
+ /**
+ * The oriented shape3D rendering method
+ */
+ private OrientedShape3DRenderMethod orientedShape3DRenderMethod = null;
+
+ /**
+ * This is the start time upon which alpha's and behaviors
+ * are synchronized to. It is initialized once, the first time
+ * that a MasterControl object is created.
+ */
+ static long systemStartTime = 0L;
+
+ // Flag indicating that we are on a Windows OS
+ private static boolean isWindowsOs = false;
+
+ // Flag indicating we are on MacOS
+ private static boolean isMacOs = false;
+
+ // This is a counter for texture id's, valid id starts from 1
+ private int textureIdCount = 0;
+
+ // This is lock for both 2D/3D textureIds;
+ private Object textureIdLock = new Object();
+
+ // This is a time stamp used when context is created
+ private long contextTimeStamp = 0;
+
+ // This is an array of canvasIds in used
+ private boolean[] canvasIds = null;
+ private int canvasFreeIndex = 0;
+ private Object canvasIdLock = new Object();
+
+ // This is a counter for rendererBit
+ private int rendererCount = 0;
+
+ // Flag that indicates whether to shared display context or not
+ boolean isSharedCtx = false;
+
+ // Flag that tells us to use NV_register_combiners
+ boolean useCombiners = false;
+
+ // Flag that indicates whether compile is disabled or not
+ boolean disableCompile = false;
+
+ // Flag that indicates whether or not compaction occurs
+ boolean doCompaction = true;
+
+ // Flag that indicates whether separate specular color is disabled or not
+ boolean disableSeparateSpecularColor = false;
+
+ // Flag that indicates whether DisplayList is used or not
+ boolean isDisplayList = true;
+
+ // If this flag is set, then by-ref geometry will not be
+ // put in display list
+ boolean buildDisplayListIfPossible = false;
+
+ // If this flag is set, then geometry arrays with vertex attributes can
+ // be in display list.
+ boolean vertexAttrsInDisplayList = false;
+
+ // Issue 249 - flag that indicates whether the soleUser optimization is permitted
+ boolean allowSoleUser = false;
+
+ // Issue 266 - Flag indicating whether null graphics configs are allowed
+ // Set by -Dj3d.allowNullGraphicsConfig property
+ // Setting this flag causes Canvas3D to allow a null GraphicsConfiguration
+ // for on-screen canvases. This is only for backward compatibility with
+ // legacy applications.
+ boolean allowNullGraphicsConfig = false;
+
+ // Issue 239 - Flag indicating whether the stencil buffer is cleared by
+ // default each frame when the color and depth buffers are cleared.
+ // Note that this is a partial solution, since we eventually want an API
+ // to control this.
+ boolean stencilClear = false;
+
+ // The global shading language being used. Using a ShaderProgram
+ // with a shading language other than the one specified by
+ // globalShadingLanguage will cause a ShaderError to be generated,
+ static int globalShadingLanguage = Shader.SHADING_LANGUAGE_GLSL;
+
+ // Flags indicating whether the Cg or GLSL libraries are available; we still need
+ // to check for the actual extension support when the Canvas3D with its associated context
+ // is created. Note that these are qualifed by the above globalShadingLanguage, so at
+ // most one of these two flags will be true;
+ static boolean cgLibraryAvailable = false;
+ static boolean glslLibraryAvailable = false;
+
+
+ // REQUESTCLEANUP messages argument
+ static Integer REMOVEALLCTXS_CLEANUP = new Integer(1);
+ static Integer REMOVECTX_CLEANUP = new Integer(2);
+ static Integer REMOVENOTIFY_CLEANUP = new Integer(3);
+ static Integer RESETCANVAS_CLEANUP = new Integer(4);
+ static Integer FREECONTEXT_CLEANUP = new Integer(5);
+
+ // arguments for renderer resource cleanup run
+ Object rendererCleanupArgs[] = {new Integer(Renderer.REQUESTCLEANUP),
+ null, null};
+
+
+ // Context creation should obtain this lock, so that
+ // first_time and all the extension initilialization
+ // are done in the MT safe manner
+ Object contextCreationLock = new Object();
+
+ // Flag that indicates whether to lock the DSI while rendering
+ boolean doDsiRenderLock = false;
+
+ // Flag that indicates the pre-1.5 behavior of enforcing power-of-two
+ // textures. If set, then any non-power-of-two textures will throw an
+ // exception.
+ boolean enforcePowerOfTwo = false;
+
+ // Flag that indicates whether the framebuffer is sharing the
+ // Z-buffer with both the left and right eyes when in stereo mode.
+ // If this is true, we need to clear the Z-buffer between rendering
+ // to the left and right eyes.
+ boolean sharedStereoZBuffer = true;
+
+ // True to disable all underlying multisampling API so it uses
+ // the setting in the driver.
+ boolean implicitAntialiasing = false;
+
+ // False to disable compiled vertex array extensions if support
+ boolean isCompiledVertexArray = true;
+
+ // Number of reserved vertex attribute locations for GLSL (must be at
+ // least 1).
+ // Issue 269 - need to reserve up to 6 vertex attribtue locations to ensure
+ // that we don't collide with a predefined gl_* attribute on nVidia cards.
+ int glslVertexAttrOffset = 6;
+
+ // Hashtable that maps a GraphicsDevice to its associated
+ // Screen3D--this is only used for on-screen Canvas3Ds
+ Hashtable deviceScreenMap = new Hashtable();
+
+ // Use to store all requests from user threads.
+ UnorderList requestObjList = new UnorderList();
+ private UnorderList requestTypeList = new UnorderList(Integer.class);
+
+ // Temporary storage to store stop request for requestViewList
+ private UnorderList tempViewList = new UnorderList();
+ private UnorderList renderOnceList = new UnorderList();
+
+ // This flag is true when there is pending request
+ // i.e. false when the above requestxxx Lists are all empty.
+ private boolean pendingRequest = false;
+
+ // Root ThreadGroup for creating Java 3D threads
+ private static ThreadGroup rootThreadGroup;
+
+ // Thread priority for all Java 3D threads
+ private static int threadPriority;
+
+ static private Object mcThreadLock = new Object();
+
+ private ArrayList timestampUpdateList = new ArrayList(3);
+
+ private UnorderList freeMessageList = new UnorderList(8);
+
+ // Native AWT object
+ long awt;
+
+ // Maximum number of lights
+ int maxLights;
+
+ // This is used for D3D only
+ int resendTexTimestamp = 0;
+
+ // Indicates that the property to disable Xinerama mode was set and
+ // successfully disabled.
+ boolean xineramaDisabled = false;
+
+ // Set by the -Dj3d.sortShape3DBounds property, When this flag is
+ // set to true, the bounds of the Shape3D node will be used in
+ // place of the computed GeometryArray bounds for transparency
+ // sorting for those Shape3D nodes whose boundsAutoCompute
+ // attribute is set to false.
+ boolean sortShape3DBounds = false;
+
+ //Set by -Dj3d.forceReleaseView property.
+ //Setting this flag as true disables the bug fix 4267395 in View deactivate().
+ //The bug 4267395 can lock-up *some* systems, but the bug fix can
+ //produce memory leaks in applications which creates and destroy Canvas3D
+ //from time to time.
+ //Set as true if you have memory leaks after disposing Canvas3D.
+ //Default false value does affect Java3D View dispose behavior.
+ boolean forceReleaseView = false;
+
+ // Issue 561: Set by -Dj3d.releaseBoundingBoxMemory property.
+ // When set to true, the per-instance fields used in bounding box
+ // transformation are released at the end of transform methods. This saves
+ // a significant amount of memory in large scenes containing huge amounts
+ // of bounding boxes. Setting this false can improve performance when
+ // lots of transforms are performed. The default is false.
+ boolean releaseBoundingBoxMemory = false;
+
+ // Issue 480: Cache the bounds of nodes so that getBounds does not
+ // recompute the boounds of the entire graph per call
+ boolean cacheAutoComputedBounds = false;
+
+ // issue 544
+ boolean useBoxForGroupBounds = false;
+
+ /**
+ * Constructs a new MasterControl object. Note that there is
+ * exatly one MasterControl object, created statically by
+ * VirtualUniverse.
+ */
+ MasterControl() {
+ assert librariesLoaded;
+
+ // Get AWT handle
+ awt = Pipeline.getPipeline().getAWT();
+
+ // Initialize the start time upon which alpha's and behaviors
+ // are synchronized to (if it isn't already set).
+ if (systemStartTime == 0L) {
+ systemStartTime = J3dClock.currentTimeMillis();
+ }
+
+ if(J3dDebug.devPhase) {
+ // Check to see whether debug mode is allowed
+ J3dDebug.debug = getBooleanProperty("j3d.debug", false,
+ "J3dDebug.debug");
+ }
+
+ // Check to see whether shared contexts are allowed
+ if (!isD3D()) {
+ isSharedCtx =
+ getBooleanProperty("j3d.sharedctx", isSharedCtx, "shared contexts");
+ }
+
+ doCompaction = getBooleanProperty("j3d.docompaction", doCompaction,
+ "compaction");
+
+ // by MIK OF CLASSX
+ transparentOffScreen = getBooleanProperty("j3d.transparentOffScreen", transparentOffScreen, "transparent OffScreen");
+
+ usePbuffer = getBooleanProperty("j3d.usePbuffer",
+ usePbuffer,
+ "Off-screen Pbuffer");
+
+ viewFrustumCulling = getBooleanProperty("j3d.viewFrustumCulling", viewFrustumCulling,"View frustum culling in the renderer is");
+
+ sortShape3DBounds =
+ getBooleanProperty("j3d.sortShape3DBounds", sortShape3DBounds,
+ "Shape3D bounds enabled for transparency sorting",
+ "Shape3D bounds *ignored* for transparency sorting");
+
+ forceReleaseView =
+ getBooleanProperty("j3d.forceReleaseView", forceReleaseView,
+ "forceReleaseView after Canvas3D dispose enabled",
+ "forceReleaseView after Canvas3D dispose disabled");
+
+ releaseBoundingBoxMemory = getBooleanProperty("j3d.releaseBoundingBoxMemory",
+ releaseBoundingBoxMemory, "releasing memory after bounding box transform");
+
+ useCombiners = getBooleanProperty("j3d.usecombiners", useCombiners,
+ "Using NV_register_combiners if available",
+ "NV_register_combiners disabled");
+
+ if (getProperty("j3d.disablecompile") != null) {
+ disableCompile = true;
+ System.err.println("Java 3D: BranchGroup.compile disabled");
+ }
+
+ if (getProperty("j3d.disableSeparateSpecular") != null) {
+ disableSeparateSpecularColor = true;
+ System.err.println("Java 3D: separate specular color disabled if possible");
+ }
+
+ isDisplayList = getBooleanProperty("j3d.displaylist", isDisplayList,
+ "display list");
+
+ implicitAntialiasing =
+ getBooleanProperty("j3d.implicitAntialiasing",
+ implicitAntialiasing,
+ "implicit antialiasing");
+
+ isCompiledVertexArray =
+ getBooleanProperty("j3d.compiledVertexArray",
+ isCompiledVertexArray,
+ "compiled vertex array");
+
+ boolean j3dOptimizeSpace =
+ getBooleanProperty("j3d.optimizeForSpace", true,
+ "optimize for space");
+
+ if (isDisplayList) {
+ // Build Display list for by-ref geometry
+ // ONLY IF optimizeForSpace is false
+ if (!j3dOptimizeSpace) {
+ buildDisplayListIfPossible = true;
+ }
+
+ // Build display lists for geometry with vertex attributes
+ // ONLY if we are in GLSL mode and GLSL shaders are available
+ if (glslLibraryAvailable) {
+ vertexAttrsInDisplayList = true;
+ }
+ }
+
+ // Check to see whether Renderer can run without DSI lock
+ doDsiRenderLock = getBooleanProperty("j3d.renderLock",
+ doDsiRenderLock,
+ "render lock");
+
+ // Check to see whether we enforce power-of-two textures
+ enforcePowerOfTwo = getBooleanProperty("j3d.textureEnforcePowerOfTwo",
+ enforcePowerOfTwo,
+ "checking power-of-two textures");
+
+ // Issue 249 - check to see whether the soleUser optimization is permitted
+ allowSoleUser = getBooleanProperty("j3d.allowSoleUser",
+ allowSoleUser,
+ "sole-user mode");
+
+ // Issue 266 - check to see whether null graphics configs are allowed
+ allowNullGraphicsConfig = getBooleanProperty("j3d.allowNullGraphicsConfig",
+ allowNullGraphicsConfig,
+ "null graphics configs");
+
+ // Issue 239 - check to see whether per-frame stencil clear is enabled
+ stencilClear = getBooleanProperty("j3d.stencilClear",
+ stencilClear,
+ "per-frame stencil clear");
+
+ // Check to see if stereo mode is sharing the Z-buffer for both eyes.
+ sharedStereoZBuffer =
+ getBooleanProperty("j3d.sharedstereozbuffer",
+ sharedStereoZBuffer,
+ "shared stereo Z buffer");
+
+ // Get the maximum number of concurrent threads (CPUs)
+ final int defaultThreadLimit = getNumberOfProcessors() + 1;
+ Integer threadLimit =
+ (Integer) java.security.AccessController.doPrivileged(
+ new java.security.PrivilegedAction() {
+ public Object run() {
+ return Integer.getInteger("j3d.threadLimit",
+ defaultThreadLimit);
+ }
+ });
+
+ cpuLimit = threadLimit.intValue();
+ if (cpuLimit < 1)
+ cpuLimit = 1;
+ if (J3dDebug.debug || cpuLimit != defaultThreadLimit) {
+ System.err.println("Java 3D: concurrent threadLimit = " +
+ cpuLimit);
+ }
+
+ // Get the input device scheduler sampling time
+ Integer samplingTime =
+ (Integer) java.security.AccessController.doPrivileged(
+ new java.security.PrivilegedAction() {
+ public Object run() {
+ return Integer.getInteger("j3d.deviceSampleTime", 0);
+ }
+ });
+
+ if (samplingTime.intValue() > 0) {
+ InputDeviceScheduler.samplingTime =
+ samplingTime.intValue();
+ System.err.println("Java 3D: Input device sampling time = "
+ + samplingTime + " ms");
+ }
+
+ // Get the glslVertexAttrOffset
+ final int defaultGLSLVertexAttrOffset = glslVertexAttrOffset;
+ Integer vattrOffset =
+ (Integer) java.security.AccessController.doPrivileged(
+ new java.security.PrivilegedAction() {
+ public Object run() {
+ return Integer.getInteger("j3d.glslVertexAttrOffset",
+ defaultGLSLVertexAttrOffset);
+ }
+ });
+
+ glslVertexAttrOffset = vattrOffset.intValue();
+ if (glslVertexAttrOffset < 1) {
+ glslVertexAttrOffset = 1;
+ }
+ if (J3dDebug.debug || glslVertexAttrOffset != defaultGLSLVertexAttrOffset) {
+ System.err.println("Java 3D: glslVertexAttrOffset = " +
+ glslVertexAttrOffset);
+ }
+
+ // See if Xinerama should be disabled for better performance.
+ boolean disableXinerama = false;
+ if (getProperty("j3d.disableXinerama") != null) {
+ disableXinerama = true;
+ }
+
+ // Issue 480 : Cache bounds returned by getBounds()
+ cacheAutoComputedBounds =
+ getBooleanProperty("j3d.cacheAutoComputeBounds",
+ cacheAutoComputedBounds,
+ "Cache AutoCompute Bounds, accelerates getBounds()");
+
+ // Issue 544
+ useBoxForGroupBounds =
+ getBooleanProperty("j3d.useBoxForGroupBounds",
+ useBoxForGroupBounds,
+ "Use of BoundingBox for group geometric bounds");
+
+ // Initialize the native J3D library
+ if (!Pipeline.getPipeline().initializeJ3D(disableXinerama)) {
+ throw new RuntimeException(J3dI18N.getString("MasterControl0"));
+ }
+
+ if (xineramaDisabled) {
+ // initializeJ3D() successfully disabled Xinerama.
+ System.err.println("Java 3D: Xinerama disabled");
+ }
+ else if (disableXinerama) {
+ // j3d.disableXinerama is true, but attempt failed.
+ System.err.println("Java 3D: could not disable Xinerama");
+ }
+
+ // Check for obsolete properties
+ String[] obsoleteProps = {
+ "j3d.backgroundtexture",
+ "j3d.forceNormalized",
+ "j3d.g2ddrawpixel",
+ "j3d.simulatedMultiTexture",
+ "j3d.useFreeLists",
+ };
+ for (int i = 0; i < obsoleteProps.length; i++) {
+ if (getProperty(obsoleteProps[i]) != null) {
+ System.err.println("Java 3D: " + obsoleteProps[i] + " property ignored");
+ }
+ }
+
+ // Get the maximum Lights
+ maxLights = Pipeline.getPipeline().getMaximumLights();
+
+ // create the freelists
+ FreeListManager.createFreeLists();
+
+ // create an array canvas use registers
+ // The 32 limit can be lifted once the
+ // resourceXXXMasks in other classes
+ // are change not to use integer.
+ canvasIds = new boolean[32];
+ for(int i=0; iThread.yield(), this method
+ * guarantees that the current thread will yield to another thread
+ * waiting to run. It also ensures that the other threads will
+ * run for at least a small amount of time before the current
+ * thread runs again.
+ */
+ static final void threadYield() {
+ // Note that we can't just use Thread.yield(), since it
+ // doesn't guarantee that it will actually yield the thread
+ // (and, in fact, it appears to be a no-op under Windows). So
+ // we will sleep for 1 msec instead. Since most threads use
+ // wait/notify, and only use this when they are waiting for
+ // another thread to finish something, this shouldn't be a
+ // performance concern.
+
+ //Thread.yield();
+ try {
+ Thread.sleep(1);
+ }
+ catch (InterruptedException e) {
+ // Do nothing, since we really don't care how long (or
+ // even whether) we sleep
+ }
+ }
+
+ // Return the number of available processors
+ private int getNumberOfProcessors() {
+ return Runtime.getRuntime().availableProcessors();
+ }
+
+ //
+ // The following framework supports code instrumentation. To use it,
+ // add code of the following form to areas that you want to enable for
+ // timing:
+ //
+ // long startTime = System.nanoTime();
+ // sortTransformGroups(tSize, tgs);
+ // long deltaTime = System.nanoTime() - startTime;
+ // VirtualUniverse.mc.recordTime(MasterControl.TimeType.XXXXX, deltaTime);
+ //
+ // where "XXXXX" is the enum representing the code segment being timed.
+ // Additional enums can be defined for new subsystems.
+ //
+
+ static enum TimeType {
+ TOTAL_FRAME,
+ RENDER,
+ BEHAVIOR,
+ // TRANSFORM_UPDATE,
+ // ...
+ }
+
+ private long[] statTimes = new long[TimeType.values().length];
+ private int[] statCounts = new int[TimeType.values().length];
+ private boolean[] statSeen = new boolean[TimeType.values().length];
+ private int frameCycleTick = 0;
+ private long frameCycleNumber = 0L;
+
+ // Method to record times -- should not be called unless the stats logger
+ // level is set to INFO or lower
+ synchronized void recordTime(TimeType type, long deltaTime) {
+ int idx = type.ordinal();
+ statTimes[idx] += deltaTime;
+ statCounts[idx]++;
+ statSeen[idx] = true;
+ }
+
+ // Method to record times -- this is not called unless the stats logger
+ // level is set to INFO or lower
+ private synchronized void logTimes() {
+ ++frameCycleNumber;
+ if (++frameCycleTick >= 10) {
+ StringBuffer strBuf = new StringBuffer();
+ strBuf.append("----------------------------------------------\n").
+ append(" Frame Number = ").
+ append(frameCycleNumber).
+ append("\n");
+ for (int i = 0; i < statTimes.length; i++) {
+ if (statSeen[i]) {
+ strBuf.append(" ");
+ if (statCounts[i] > 0) {
+ strBuf.append(TimeType.values()[i]).
+ append(" [").
+ append(statCounts[i]).
+ append("] = ").
+ append((double)statTimes[i] / 1000000.0 / (double)statCounts[i]).
+ append(" msec per call\n");
+ statTimes[i] = 0L;
+ statCounts[i] = 0;
+ } else {
+ assert statTimes[i] == 0L;
+ strBuf.append(TimeType.values()[i]).
+ append(" [0] = 0.0 msec\n");
+ }
+ }
+ }
+ getStatsLogger().info(strBuf.toString());
+ frameCycleTick = 0;
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/MasterControlThread.java b/j3d-core/src/classes/share/javax/media/j3d/MasterControlThread.java
new file mode 100644
index 0000000..e81a6ad
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/MasterControlThread.java
@@ -0,0 +1,80 @@
+/*
+ * $RCSfile: MasterControlThread.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Master control thread. The MasterControlThread object and thread
+ * are created dynamically whenever needed. Once created, the thread
+ * runs until all other threads are terminated. Then the master
+ * control thread terminates. There is never more than one
+ * MasterControl object or thread in existence at any one time.
+ */
+class MasterControlThread extends Thread {
+
+ private static int numInstances = 0;
+ private int instanceNum = -1;
+
+ private static synchronized int newInstanceNum() {
+ return (++numInstances);
+ }
+
+ private int getInstanceNum() {
+ if (instanceNum == -1)
+ instanceNum = newInstanceNum();
+ return instanceNum;
+ }
+
+ MasterControlThread(ThreadGroup threadGroup) {
+ super(threadGroup, "");
+ setName("J3D-MasterControl-" + getInstanceNum());
+ VirtualUniverse.mc.createMCThreads();
+ this.start();
+ }
+
+ public void run() {
+
+ do {
+ while (VirtualUniverse.mc.running) {
+ VirtualUniverse.mc.doWork();
+
+ // NOTE: no need to call Thread.yield(), since we will
+ // call wait() if there is no work to do (yield seems
+ // to be a no-op on Windows anyway)
+ }
+ } while (!VirtualUniverse.mc.mcThreadDone());
+
+ if(J3dDebug.devPhase) {
+ J3dDebug.doDebug(J3dDebug.masterControl, J3dDebug.LEVEL_1,
+ "MC: MasterControl Thread Terminate");
+ }
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Material.java b/j3d-core/src/classes/share/javax/media/j3d/Material.java
new file mode 100644
index 0000000..86a888a
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Material.java
@@ -0,0 +1,718 @@
+/*
+ * $RCSfile: Material.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+
+/**
+ * The Material object defines the appearance of an object under
+ * illumination.
+ * If the Material object in an Appearance object is null,
+ * lighting is disabled for all nodes that use that Appearance object.
+ *
+ *
+ *
+ * The Material object also enables or disables lighting.
+ */
+public class Material extends NodeComponent {
+
+ /**
+ * For material object, specifies that Material allows reading
+ * individual component field information.
+ */
+ public static final int
+ ALLOW_COMPONENT_READ = CapabilityBits.MATERIAL_ALLOW_COMPONENT_READ;
+
+ /**
+ * For material object, specifies that Material allows reading
+ * individual component field information.
+ */
+ public static final int
+ ALLOW_COMPONENT_WRITE = CapabilityBits.MATERIAL_ALLOW_COMPONENT_WRITE;
+
+ /**
+ * Specifies that per-vertex colors replace the ambient material color.
+ * @see #setColorTarget
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int AMBIENT = 0;
+
+ /**
+ * Specifies that per-vertex colors replace the emissive material color.
+ * @see #setColorTarget
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int EMISSIVE = 1;
+
+ /**
+ * Specifies that per-vertex colors replace the diffuse material color.
+ * This is the default target.
+ * @see #setColorTarget
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int DIFFUSE = 2;
+
+ /**
+ * Specifies that per-vertex colors replace the specular material color.
+ * @see #setColorTarget
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int SPECULAR = 3;
+
+ /**
+ * Specifies that per-vertex colors replace both the ambient and the
+ * diffuse material color.
+ * @see #setColorTarget
+ *
+ * @since Java 3D 1.3
+ */
+ public static final int AMBIENT_AND_DIFFUSE = 4;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_COMPONENT_READ
+ };
+
+ /**
+ * Constructs and initializes a Material object using default parameters.
+ * The default values are as follows:
+ *
+ * lighting enable : true
+ */
+ public Material() {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs and initializes a new material object using the specified
+ * parameters. Lighting is enabled by default.
+ * @param ambientColor the material's ambient color
+ * @param emissiveColor the material's emissive color
+ * @param diffuseColor the material's diffuse color when illuminated by a
+ * light
+ * @param specularColor the material's specular color when illuminated
+ * to generate a highlight
+ * @param shininess the material's shininess in the
+ * range [1.0, 128.0] with 1.0 being not shiny and 128.0 being very shiny.
+ * Values outside this range are clamped.
+ */
+ public Material(Color3f ambientColor,
+ Color3f emissiveColor,
+ Color3f diffuseColor,
+ Color3f specularColor,
+ float shininess) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((MaterialRetained)this.retained).createMaterial(ambientColor,
+ emissiveColor, diffuseColor, specularColor,
+ shininess);
+ }
+
+ /**
+ * Creates a retained mode MaterialRetained object that this
+ * Material component object will point to.
+ */
+ void createRetained() {
+ this.retained = new MaterialRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Sets this material's ambient color.
+ * This specifies how much ambient light is reflected by
+ * the surface.
+ * The ambient color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is either AMBIENT or AMBIENT_AND_DIFFUSE, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's ambient color in the lighting equation.
+ *
+ * @param color the material's ambient color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setAmbientColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+ if (isLive()) {
+ ((MaterialRetained)this.retained).setAmbientColor(color);
+ }
+ else {
+ ((MaterialRetained)this.retained).initAmbientColor(color);
+ }
+ }
+
+ /**
+ * Sets this material's ambient color.
+ * This specifies how much ambient light is reflected by
+ * the surface.
+ * The ambient color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is either AMBIENT or AMBIENT_AND_DIFFUSE, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's ambient color in the lighting equation.
+ *
+ * @param r the new ambient color's red component
+ * @param g the new ambient color's green component
+ * @param b the new ambient color's blue component
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setAmbientColor(float r, float g, float b) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+ if (isLive()) {
+ ((MaterialRetained)this.retained).setAmbientColor(r,g,b);
+ }
+ else {
+ ((MaterialRetained)this.retained).initAmbientColor(r,g,b);
+ }
+ }
+
+ /**
+ * Retrieves this material's ambient color.
+ * @param color that will contain the material's ambient color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getAmbientColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material2"));
+
+ ((MaterialRetained)this.retained).getAmbientColor(color);
+ }
+
+ /**
+ * Sets this material's emissive color.
+ * This is the color of light, if any, that the material emits.
+ * The emissive color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is EMISSIVE, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's emissive color in the lighting equation.
+ *
+ * @param color the new emissive color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setEmissiveColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+ if (isLive())
+ ((MaterialRetained)this.retained).setEmissiveColor(color);
+ else
+ ((MaterialRetained)this.retained).initEmissiveColor(color);
+
+
+
+
+ }
+
+ /**
+ * Sets this material's emissive color.
+ * This is the color of light, if any, that the material emits.
+ * The emissive color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is EMISSIVE, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's emissive color in the lighting equation.
+ *
+ * @param r the new emissive color's red component
+ * @param g the new emissive color's green component
+ * @param b the new emissive color's blue component
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setEmissiveColor(float r, float g, float b) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setEmissiveColor(r,g,b);
+ else
+ ((MaterialRetained)this.retained).initEmissiveColor(r,g,b);
+ }
+
+ /**
+ * Retrieves this material's emissive color and stores it in the
+ * argument provided.
+ * @param color the vector that will receive this material's emissive color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getEmissiveColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material2"));
+
+ ((MaterialRetained)this.retained).getEmissiveColor(color);
+ }
+
+ /**
+ * Sets this material's diffuse color.
+ * This is the color of the material when illuminated by a light source.
+ * The diffuse color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is either DIFFUSE or AMBIENT_AND_DIFFUSE, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's diffuse color in the lighting equation.
+ *
+ * @param color the new diffuse color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setDiffuseColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setDiffuseColor(color);
+ else
+ ((MaterialRetained)this.retained).initDiffuseColor(color);
+ }
+
+ /**
+ * Sets this material's diffuse color.
+ * This is the color of the material when illuminated by a light source.
+ * The diffuse color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is either DIFFUSE or AMBIENT_AND_DIFFUSE, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's diffuse color in the lighting equation.
+ *
+ * @param r the new diffuse color's red component
+ * @param g the new diffuse color's green component
+ * @param b the new diffuse color's blue component
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setDiffuseColor(float r, float g, float b) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setDiffuseColor(r,g,b);
+ else
+ ((MaterialRetained)this.retained).initDiffuseColor(r,g,b);
+ }
+
+ /**
+ * Sets this material's diffuse color plus alpha.
+ * This is the color of the material when illuminated by a light source.
+ * The diffuse color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is either DIFFUSE or AMBIENT_AND_DIFFUSE, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's diffuse color in the lighting equation.
+ *
+ * @param r the new diffuse color's red component
+ * @param g the new diffuse color's green component
+ * @param b the new diffuse color's blue component
+ * @param a the alpha component used to set transparency
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setDiffuseColor(float r, float g, float b, float a) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setDiffuseColor(r,g,b,a);
+ else
+ ((MaterialRetained)this.retained).initDiffuseColor(r,g,b,a);
+ }
+
+ /**
+ * Retrieves this material's diffuse color.
+ * @param color the vector that will receive this material's diffuse color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getDiffuseColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material2"));
+
+ ((MaterialRetained)this.retained).getDiffuseColor(color);
+ }
+
+ /**
+ * Sets this material's specular color.
+ * This is the specular highlight color of the material.
+ * The specular color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is SPECULAR, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's specular color in the lighting equation.
+ *
+ * @param color the new specular color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setSpecularColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setSpecularColor(color);
+ else
+ ((MaterialRetained)this.retained).initSpecularColor(color);
+ }
+
+ /**
+ * Sets this material's specular color.
+ * This is the specular highlight color of the material.
+ * The specular color in this Material object may be overridden by
+ * per-vertex colors in some cases. If vertex colors are present
+ * in the geometry, and lighting is enabled, and the colorTarget
+ * is SPECULAR, and vertex colors are
+ * not being ignored, then the vertex colors are used in place of
+ * this Material's specular color in the lighting equation.
+ *
+ * @param r the new specular color's red component
+ * @param g the new specular color's green component
+ * @param b the new specular color's blue component
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see #setColorTarget
+ */
+ public void setSpecularColor(float r, float g, float b) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setSpecularColor(r,g,b);
+ else
+ ((MaterialRetained)this.retained).initSpecularColor(r,g,b);
+ }
+
+ /**
+ * Retrieves this material's specular color.
+ * @param color the vector that will receive this material's specular color
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getSpecularColor(Color3f color) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material2"));
+
+ ((MaterialRetained)this.retained).getSpecularColor(color);
+ }
+
+ /**
+ * Sets this material's shininess.
+ * This specifies a material specular scattering exponent, or
+ * shininess. It takes a floating point number in the range [1.0, 128.0]
+ * with 1.0 being not shiny and 128.0 being very shiny.
+ * Values outside this range are clamped.
+ * @param shininess the material's shininess
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setShininess(float shininess) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material0"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setShininess(shininess);
+ else
+ ((MaterialRetained)this.retained).initShininess(shininess);
+ }
+
+ /**
+ * Retrieves this material's shininess.
+ * @return the material's shininess
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public float getShininess() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material2"));
+
+ return ((MaterialRetained)this.retained).getShininess();
+ }
+
+ /**
+ * Enables or disables lighting for this appearance component object.
+ * @param state true or false to enable or disable lighting
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setLightingEnable(boolean state) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material15"));
+ if (isLive())
+ ((MaterialRetained)this.retained).setLightingEnable(state);
+ else
+ ((MaterialRetained)this.retained).initLightingEnable(state);
+ }
+
+ /**
+ * Retrieves the state of the lighting enable flag.
+ * @return true if lighting is enabled, false if lighting is disabled
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public boolean getLightingEnable() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material16"));
+ return ((MaterialRetained)this.retained).getLightingEnable();
+ }
+
+ /**
+ * Sets the color target for per-vertex colors. When lighting is
+ * enabled and per-vertex colors are present (and not ignored) in
+ * the geometry for a given Shape3D node, those per-vertex colors
+ * are used in place of the specified material color(s) for this
+ * Material object. The color target is ignored when lighting is
+ * disabled or when per-vertex colors are not used.
+ * The ColorInterpolator behavior also uses the color target to
+ * determine which color in the associated Material is modified.
+ * The default target is DIFFUSE.
+ *
+ * @param colorTarget one of: AMBIENT, EMISSIVE, DIFFUSE, SPECULAR, or
+ * AMBIENT_AND_DIFFUSE.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see RenderingAttributes#setIgnoreVertexColors
+ * @see ColorInterpolator
+ *
+ * @since Java 3D 1.3
+ */
+ public void setColorTarget(int colorTarget) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material3"));
+
+ if (isLive())
+ ((MaterialRetained)this.retained).setColorTarget(colorTarget);
+ else
+ ((MaterialRetained)this.retained).initColorTarget(colorTarget);
+ }
+
+ /**
+ * Retrieves the current color target for this material.
+ *
+ * @return one of: AMBIENT, EMISSIVE, DIFFUSE, SPECULAR, or
+ * AMBIENT_AND_DIFFUSE.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int getColorTarget() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_COMPONENT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Material4"));
+
+ return ((MaterialRetained)this.retained).getColorTarget();
+ }
+
+ /**
+ * Returns a String representation of this Materials values.
+ * If the scene graph is live only those values with their
+ * Capability read bit set will be displayed.
+ */
+ public String toString() {
+ StringBuffer str = new StringBuffer(getNamePrefix());
+ str.append("javax.media.j3d.Material: ");
+ Color3f color=new Color3f();
+ try {
+ getAmbientColor(color);
+ str.append("AmbientColor="+color);
+ } catch (CapabilityNotSetException e) {str.append("AmbientColor=N/A");}
+ try {
+ getEmissiveColor(color);
+ str.append(" EmissiveColor="+color);
+ } catch (CapabilityNotSetException ex) {str.append(" EmissiveColor=N/A");}
+ try {
+ getDiffuseColor(color);
+ str.append(" DiffuseColor="+color);
+ } catch (CapabilityNotSetException exc) {str.append(" DiffuseColor=N/A");}
+ try {
+ getSpecularColor(color);
+ str.append(" SpecularColor="+color);
+ } catch (CapabilityNotSetException exce) {str.append(" SpecularColor=N/A");}
+ try {
+ float f=getShininess();
+ str.append(" Shininess="+f);
+ } catch (CapabilityNotSetException excep) {str.append(" Shininess=N/A");}
+ try {
+ boolean b=getLightingEnable();
+ str.append(" LightingEnable="+b);
+ } catch (CapabilityNotSetException except) {str.append(" LightingEnable=N/A");}
+ try {
+ int i=getColorTarget();
+ str.append(" ColorTarget="+i);
+ } catch (CapabilityNotSetException except) {str.append(" ColorTarget=N/A");}
+ return new String(str);
+ }
+
+ /**
+ * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ Material m = new Material();
+ m.duplicateNodeComponent(this);
+ return m;
+ }
+
+
+ /**
+ * Copies all node information from
+ * ambient color : (0.2, 0.2, 0.2)
+ * emmisive color : (0.0, 0.0, 0.0)
+ * diffuse color : (1.0, 1.0, 1.0)
+ * specular color : (1.0, 1.0, 1.0)
+ * shininess : 64
+ * color target : DIFFUSE
+ * originalNodeComponent into
+ * the current node. This method is called from the
+ * duplicateNode method. This routine does
+ * the actual duplication of all "local data" (any data defined in
+ * this object).
+ *
+ * @param originalNodeComponent the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+ super.duplicateAttributes(originalNodeComponent,
+ forceDuplicate);
+
+ MaterialRetained mat = (MaterialRetained)
+ originalNodeComponent.retained;
+ MaterialRetained rt = (MaterialRetained) retained;
+
+ Color3f c = new Color3f();
+ mat.getAmbientColor(c);
+
+ rt.initAmbientColor(c);
+ mat.getEmissiveColor(c);
+ rt.initEmissiveColor(c);
+ mat.getDiffuseColor(c);
+ rt.initDiffuseColor(c);
+ mat.getSpecularColor(c);
+ rt.initSpecularColor(c);
+ rt.initShininess(mat.getShininess());
+ rt.initLightingEnable(mat.getLightingEnable());
+ rt.initColorTarget(mat.getColorTarget());
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/MaterialRetained.java b/j3d-core/src/classes/share/javax/media/j3d/MaterialRetained.java
new file mode 100644
index 0000000..11c231c
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/MaterialRetained.java
@@ -0,0 +1,563 @@
+/*
+ * $RCSfile: MaterialRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.Color3f;
+import java.util.ArrayList;
+
+/**
+ * The MaterialRetained object defines the appearance of an object under
+ * illumination.
+ */
+class MaterialRetained extends NodeComponentRetained {
+ // Initialize default values for all class variables
+ Color3f ambientColor = new Color3f(0.2f, 0.2f, 0.2f);
+ Color3f emissiveColor = new Color3f(0.0f, 0.0f, 0.0f);
+ Color3f diffuseColor = new Color3f(1.0f, 1.0f, 1.0f);
+ Color3f specularColor = new Color3f(1.0f, 1.0f, 1.0f);
+ float shininess = 64.0f;
+ int colorTarget = Material.DIFFUSE;
+
+ // Lighting enable switch for this material object
+ boolean lightingEnable = true;
+
+ // A list of pre-defined bits to indicate which component
+ // in this Material object changed.
+ static final int AMBIENT_COLOR_CHANGED = 0x01;
+
+ static final int EMISSIVE_COLOR_CHANGED = 0x02;
+
+ static final int DIFFUSE_COLOR_CHANGED = 0x04;
+
+ static final int SPECULAR_COLOR_CHANGED = 0x08;
+
+ static final int SHININESS_CHANGED = 0x10;
+
+ static final int ENABLE_CHANGED = 0x20;
+
+ static final int COLORTARGET_CHANGED = 0x40;
+
+ /**
+ * Constructs and initializes a new material object using the specified
+ * parameters.
+ * @param ambientColor the material's ambient color
+ * @param emissiveColor the material's emissive color
+ * @param diffuseColor the material's diffuse color when illuminated by a
+ * light
+ * @param specularColor the material's specular color when illuminated
+ * to generate a highlight
+ * @param shininess the material's shininess in the
+ * range [1.0, 128.0] with 1.0 being not shiny and 128.0 being very shiny
+ */
+ void createMaterial(Color3f aColor,
+ Color3f eColor,
+ Color3f dColor,
+ Color3f sColor,
+ float shine)
+ {
+ ambientColor.set(aColor);
+ emissiveColor.set(eColor);
+ diffuseColor.set(dColor);
+ specularColor.set(sColor);
+ shininess = shine;
+ }
+
+ /** Initializes this material's ambient color
+ * This specifies how much ambient light is reflected by
+ * the surface. The ambient light color is the product of this
+ * color and the material diffuseColor.
+ * @param color the material's ambient color
+ */
+ final void initAmbientColor(Color3f color) {
+ this.ambientColor.set(color);
+ }
+
+ /**
+ * Sets this material's ambient color and sends a message notifying
+ * the interested structures of the change.
+ * This specifies how much ambient light is reflected by
+ * the surface. The ambient light color is the product of this
+ * color and the material diffuseColor.
+ * @param color the material's ambient color
+ */
+ final void setAmbientColor(Color3f color) {
+ initAmbientColor(color);
+ sendMessage(AMBIENT_COLOR_CHANGED, new Color3f(color));
+ }
+
+ /**
+ * Sets this material's ambient color
+ * @param r the new ambient color's red component
+ * @param g the new ambient color's green component
+ * @param b the new ambient color's blue component
+ */
+ final void initAmbientColor(float r, float g, float b) {
+ this.ambientColor.set(r, g, b);
+ }
+
+
+ /**
+ * Sets this material's ambient color and sends a message notifying
+ * the interested structures of the change.
+ * @param r the new ambient color's red component
+ * @param g the new ambient color's green component
+ * @param b the new ambient color's blue component
+ */
+ final void setAmbientColor(float r, float g, float b) {
+ initAmbientColor(r, g, b);
+ sendMessage(AMBIENT_COLOR_CHANGED, new Color3f(r, g, b));
+ }
+
+ /**
+ * Retrieves this material's ambient color.
+ * @return the material's ambient color
+ */
+ final void getAmbientColor(Color3f color) {
+ color.set(this.ambientColor);
+ }
+
+ /**
+ * Sets this material's emissive color
+ * This is the color of light, if any, that the material emits.
+ * @param color the new emissive color
+ */
+ final void initEmissiveColor(Color3f color) {
+ this.emissiveColor.set(color);
+ }
+
+ /**
+ * Sets this material's emissive color and sends a message notifying
+ * the interested structures of the change.
+ * This is the color of light, if any, that the material emits.
+ * @param color the new emissive color
+ */
+ final void setEmissiveColor(Color3f color) {
+ initEmissiveColor(color);
+ sendMessage(EMISSIVE_COLOR_CHANGED, new Color3f(color));
+ }
+
+ /**
+ * Sets this material's emissive color.
+ * This is the color of light, if any, that the material emits.
+ * @param r the new emissive color's red component
+ * @param g the new emissive color's green component
+ * @param b the new emissive color's blue component
+ */
+ final void initEmissiveColor(float r, float g, float b) {
+ this.emissiveColor.set(r, g, b);
+ }
+
+ /**
+ * Sets this material's emissive color and sends a message notifying
+ * the interested structures of the change.
+ * This is the color of light, if any, that the material emits.
+ * @param r the new emissive color's red component
+ * @param g the new emissive color's green component
+ * @param b the new emissive color's blue component
+ */
+ final void setEmissiveColor(float r, float g, float b) {
+ initEmissiveColor(r, g, b);
+ sendMessage(EMISSIVE_COLOR_CHANGED, new Color3f(r, g, b));
+ }
+
+ /**
+ * Retrieves this material's emissive color and stores it in the
+ * argument provided.
+ * @param color the vector that will receive this material's emissive color
+ */
+ final void getEmissiveColor(Color3f color) {
+ color.set(this.emissiveColor);
+ }
+
+ /**
+ * Sets this material's diffuse color.
+ * This is the color of the material when illuminated by a light source.
+ * @param color the new diffuse color
+ */
+ final void initDiffuseColor(Color3f color) {
+ this.diffuseColor.set(color);
+ }
+
+ /**
+ * Sets this material's diffuse color and sends a message notifying
+ * the interested structures of the change.
+ * This is the color of the material when illuminated by a light source.
+ * @param color the new diffuse color
+ */
+ final void setDiffuseColor(Color3f color) {
+ initDiffuseColor(color);
+ sendMessage(DIFFUSE_COLOR_CHANGED, new Color3f(color));
+ }
+
+ /**
+ * Sets this material's diffuse color.
+ * @param r the new diffuse color's red component
+ * @param g the new diffuse color's green component
+ * @param b the new diffuse color's blue component
+ */
+ final void initDiffuseColor(float r, float g, float b) {
+ this.diffuseColor.set(r, g, b);
+ }
+
+ /**
+ * Sets this material's diffuse color and sends a message notifying
+ * the interested structures of the change.
+ * @param r the new diffuse color's red component
+ * @param g the new diffuse color's green component
+ * @param b the new diffuse color's blue component
+ */
+ final void setDiffuseColor(float r, float g, float b) {
+ initDiffuseColor(r, g, b);
+ sendMessage(DIFFUSE_COLOR_CHANGED, new Color3f(r, g, b));
+ }
+
+ /**
+ * Sets this material's diffuse color plus alpha.
+ * This is the color of the material when illuminated by a light source.
+ * @param r the new diffuse color's red component
+ * @param g the new diffuse color's green component
+ * @param b the new diffuse color's blue component
+ * @param a the alpha component used to set transparency
+ */
+ final void initDiffuseColor(float r, float g, float b, float a) {
+ this.diffuseColor.set(r, g, b);
+ }
+
+ /**
+ * Sets this material's diffuse color plus alpha and sends
+ * a message notifying the interested structures of the change.
+ * This is the color of the material when illuminated by a light source.
+ * @param r the new diffuse color's red component
+ * @param g the new diffuse color's green component
+ * @param b the new diffuse color's blue component
+ * @param a the alpha component used to set transparency
+ */
+ final void setDiffuseColor(float r, float g, float b, float a) {
+ initDiffuseColor(r, g, b);
+ sendMessage(DIFFUSE_COLOR_CHANGED, new Color3f(r, g, b));
+ }
+
+ /**
+ * Retrieves this material's diffuse color.
+ * @param color the vector that will receive this material's diffuse color
+ */
+ final void getDiffuseColor(Color3f color) {
+ color.set(this.diffuseColor);
+ }
+
+ /**
+ * Sets this material's specular color.
+ * This is the specular highlight color of the material.
+ * @param color the new specular color
+ */
+ final void initSpecularColor(Color3f color) {
+ this.specularColor.set(color);
+ }
+
+ /**
+ * Sets this material's specular color and sends a message notifying
+ * the interested structures of the change.
+ * This is the specular highlight color of the material.
+ * @param color the new specular color
+ */
+ final void setSpecularColor(Color3f color) {
+ initSpecularColor(color);
+ sendMessage(SPECULAR_COLOR_CHANGED, new Color3f(color));
+ }
+
+ /**
+ * Sets this material's specular color.
+ * This is the specular highlight color of the material.
+ * @param r the new specular color's red component
+ * @param g the new specular color's green component
+ * @param b the new specular color's blue component
+ */
+ final void initSpecularColor(float r, float g, float b) {
+ this.specularColor.set(r, g, b);
+ }
+
+
+ /**
+ * Sets this material's specular color and sends a message notifying
+ * the interested structures of the change.
+ * This is the specular highlight color of the material.
+ * @param r the new specular color's red component
+ * @param g the new specular color's green component
+ * @param b the new specular color's blue component
+ */
+ final void setSpecularColor(float r, float g, float b) {
+ initSpecularColor(r, g, b);
+ sendMessage(SPECULAR_COLOR_CHANGED, new Color3f(r, g, b));
+ }
+
+ /**
+ * Retrieves this material's specular color.
+ * @param color the vector that will receive this material's specular color
+ */
+ final void getSpecularColor(Color3f color) {
+ color.set(this.specularColor);
+ }
+
+ /**
+ * Sets this material's shininess.
+ * This specifies a material specular exponent, or shininess.
+ * It takes a floating point number in the range [1.0, 128.0]
+ * with 1.0 being not shiny and 128.0 being very shiny.
+ * @param shininess the material's shininess
+ */
+ final void initShininess(float shininess) {
+ // Clamp shininess value
+ if (shininess < 1.0f)
+ this.shininess = 1.0f;
+ else if (shininess > 128.0f)
+ this.shininess = 128.0f;
+ else
+ this.shininess = shininess;
+
+ }
+
+ /**
+ * Sets this material's shininess and sends a message notifying
+ * the interested structures of the change.
+ * This specifies a material specular exponent, or shininess.
+ * It takes a floating point number in the range [1.0, 128.0]
+ * with 1.0 being not shiny and 128.0 being very shiny.
+ * @param shininess the material's shininess
+ */
+ final void setShininess(float shininess) {
+ initShininess(shininess);
+ sendMessage(SHININESS_CHANGED, new Float(this.shininess));
+ }
+
+ /**
+ * Retrieves this material's shininess.
+ * @return the material's shininess
+ */
+ final float getShininess() {
+ return this.shininess;
+ }
+
+ /**
+ * Enables or disables lighting for this appearance component object.
+ * @param state true or false to enable or disable lighting
+ */
+ void initLightingEnable(boolean state) {
+ lightingEnable = state;
+ }
+
+ /**
+ * Enables or disables lighting for this appearance component object
+ * and sends a message notifying
+ * the interested structures of the change.
+ * @param state true or false to enable or disable lighting
+ */
+ void setLightingEnable(boolean state) {
+ initLightingEnable(state);
+ sendMessage(ENABLE_CHANGED,
+ (state ? Boolean.TRUE: Boolean.FALSE));
+ }
+
+ /**
+ * Retrieves the state of the lighting enable flag.
+ * @return true if lighting is enabled, false if lighting is disabled
+ */
+ boolean getLightingEnable() {
+ return lightingEnable;
+ }
+
+ void initColorTarget(int colorTarget) {
+ this.colorTarget = colorTarget;
+ }
+
+ final void setColorTarget(int colorTarget) {
+ initColorTarget(colorTarget);
+ sendMessage(COLORTARGET_CHANGED, new Integer(colorTarget));
+ }
+
+ final int getColorTarget() {
+ return colorTarget;
+ }
+
+ synchronized void createMirrorObject() {
+ if (mirror == null) {
+ // Check the capability bits and let the mirror object
+ // point to itself if is not editable
+ if (isStatic()) {
+ mirror = this;
+ } else {
+ MaterialRetained mirrorMat = new MaterialRetained();
+ mirrorMat.set(this);
+ mirrorMat.source = source;
+ mirror = mirrorMat;
+ }
+ } else {
+ ((MaterialRetained) mirror).set(this);
+ }
+ }
+
+
+ /**
+ * Updates the native context.
+ */
+ void updateNative(Context ctx,
+ float red, float green, float blue, float alpha,
+ boolean enableLighting) {
+ Pipeline.getPipeline().updateMaterial(ctx, red, green, blue, alpha,
+ ambientColor.x, ambientColor.y, ambientColor.z,
+ emissiveColor.x, emissiveColor.y, emissiveColor.z,
+ diffuseColor.x, diffuseColor.y, diffuseColor.z,
+ specularColor.x, specularColor.y, specularColor.z,
+ shininess, colorTarget, enableLighting);
+ }
+
+
+ /**
+ * Creates a mirror object, point the mirror object to the retained
+ * object if the object is not editable
+ */
+ synchronized void initMirrorObject() {
+ MaterialRetained mirrorMaterial = (MaterialRetained)mirror;
+ mirrorMaterial.set(this);
+ }
+
+ /**
+ * Update the "component" field of the mirror object with the
+ * given "value"
+ */
+ synchronized void updateMirrorObject(int component, Object value) {
+ MaterialRetained mirrorMaterial = (MaterialRetained)mirror;
+ if ((component & AMBIENT_COLOR_CHANGED) != 0) {
+ mirrorMaterial.ambientColor = (Color3f)value;
+ }
+ else if ((component & EMISSIVE_COLOR_CHANGED) != 0) {
+ mirrorMaterial.emissiveColor = (Color3f)value;
+ }
+ else if ((component & DIFFUSE_COLOR_CHANGED) != 0) {
+ mirrorMaterial.diffuseColor = (Color3f)value;
+ }
+ else if ((component & SPECULAR_COLOR_CHANGED) != 0) {
+ mirrorMaterial.specularColor = (Color3f)value;
+ }
+ else if ((component & SHININESS_CHANGED) != 0) {
+ mirrorMaterial.shininess = ((Float)value).floatValue();
+ }
+ else if ((component & ENABLE_CHANGED) != 0) {
+ mirrorMaterial.lightingEnable = ((Boolean)value).booleanValue();
+ }
+ else if ((component & COLORTARGET_CHANGED) != 0) {
+ mirrorMaterial.colorTarget = ((Integer)value).intValue();
+ }
+
+ }
+
+
+ boolean equivalent(MaterialRetained m) {
+ return ((m != null) &&
+ lightingEnable == m.lightingEnable &&
+ diffuseColor.equals(m.diffuseColor) &&
+ emissiveColor.equals(m.emissiveColor) &&
+ specularColor.equals(m.specularColor) &&
+ ambientColor.equals(m.ambientColor) &&
+ colorTarget == m.colorTarget &&
+ shininess == m.shininess);
+ }
+
+
+ // This functions clones the retained side only and is used
+ // internally
+ protected Object clone() {
+ MaterialRetained mr = (MaterialRetained)super.clone();
+ // color can't share the same reference
+ mr.ambientColor = new Color3f(ambientColor);
+ mr.emissiveColor = new Color3f(emissiveColor);
+ mr.diffuseColor = new Color3f(diffuseColor);
+ mr.specularColor = new Color3f(specularColor);
+ // other attributes are copy by clone() automatically
+ return mr;
+ }
+
+ protected void set(MaterialRetained mat) {
+ super.set(mat);
+
+ // duplicate any referenced data
+ ambientColor.set(mat.ambientColor);
+ emissiveColor.set(mat.emissiveColor);
+ diffuseColor.set(mat.diffuseColor);
+ specularColor.set(mat.specularColor);
+ shininess = mat.shininess;
+ lightingEnable = mat.lightingEnable;
+ colorTarget = mat.colorTarget;
+ }
+
+
+ final void sendMessage(int attrMask, Object attr) {
+ ArrayList univList = new ArrayList();
+ ArrayList gaList = Shape3DRetained.getGeomAtomsList(mirror.users, univList);
+ // Send to rendering attribute structure, regardless of
+ // whether there are users or not (alternate appearance case ..)
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+ createMessage.type = J3dMessage.MATERIAL_CHANGED;
+ createMessage.universe = null;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr;
+ createMessage.args[3] = new Integer(changedFrequent);
+ VirtualUniverse.mc.processMessage(createMessage);
+
+ int size = univList.size();
+ for(int i=0; isetURLObject,
+ * or setInputStream may be
+ * non-null (or they may all be null). An attempt to set more
+ * than one of these attributes to a non-null reference will
+ * result in an exception being thrown. If all sound media data
+ * references are null, there is no sound associated with this
+ * MediaContainer and Sound nodes referencing this object cannot
+ * be played.
+ */
+public class MediaContainer extends NodeComponent {
+ /**
+ * For MediaContainer component objects, specifies that this object
+ * allows the reading of its cached flag.
+ */
+ public static final int
+ ALLOW_CACHE_READ = CapabilityBits.MEDIA_CONTAINER_ALLOW_CACHE_READ;
+
+ /**
+ * For MediaContainer component objects, specifies that this object
+ * allows the writing of its cached flag.
+ */
+ public static final int
+ ALLOW_CACHE_WRITE = CapabilityBits.MEDIA_CONTAINER_ALLOW_CACHE_WRITE;
+
+ /**
+ * For MediaContainer component objects, specifies that this object
+ * allows the reading of it's sound data.
+ */
+ public static final int
+ ALLOW_URL_READ = CapabilityBits.MEDIA_CONTAINER_ALLOW_URL_READ;
+
+ /**
+ * For MediaContainer component objects, specifies that this object
+ * allows the writing of it's URL path.
+ */
+ public static final int
+ ALLOW_URL_WRITE = CapabilityBits.MEDIA_CONTAINER_ALLOW_URL_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_CACHE_READ,
+ ALLOW_URL_READ
+ };
+
+ /**
+ * Constructs a MediaContainer object with default parameters.
+ * The default values are as follows:
+ *
+ * URL String data : null
+ */
+ public MediaContainer() {
+ // Just use default values
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+ * Constructs and initializes a MediaContainer object using specified
+ * parameters.
+ * @param path string of URL path containing sound data
+ * @exception SoundException if the URL is not valid or cannot be opened
+ */
+ public MediaContainer(String path) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((MediaContainerRetained)this.retained).setURLString(path);
+ }
+
+ /**
+ * Constructs and initializes a MediaContainer object using specified
+ * parameters.
+ * @param url URL path containing sound data
+ * @exception SoundException if the URL is not valid or cannot be opened
+ */
+ public MediaContainer(URL url) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((MediaContainerRetained)this.retained).setURLObject(url);
+ }
+
+ /**
+ * Constructs and initializes a MediaContainer object using specified
+ * parameters.
+ * @param stream input stream containing sound data
+ *
+ * @since Java 3D 1.2
+ */
+ public MediaContainer(InputStream stream) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((MediaContainerRetained)this.retained).setInputStream(stream);
+ }
+
+ /**
+ * Creates the retained mode MediaContainerRetained object that this
+ * component object will point to.
+ */
+ void createRetained() {
+ this.retained = new MediaContainerRetained();
+ this.retained.setSource(this);
+ }
+
+ /**
+ * Set Cache Enable state flag.
+ * Allows the writing of sound data explicitly into the MediaContainer
+ * rather than just referencing a JavaMedia container.
+ * @param flag boolean denoting if sound data is cached in this instance
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setCacheEnable(boolean flag) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_CACHE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer1"));
+
+ ((MediaContainerRetained)this.retained).setCacheEnable(flag);
+ }
+
+ /**
+ * Retrieve Cache Enable state flag.
+ * @return flag denoting is sound data is non-cached or cached
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public boolean getCacheEnable() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_CACHE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer2"));
+
+ return ((MediaContainerRetained)this.retained).getCacheEnable();
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ *
+ * URL object data : null
+ * InputStream data : null
+ * cache enable : true
+ * setURLString
+ */
+ public void setURL(String path) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_URL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer3"));
+ }
+
+ ((MediaContainerRetained)this.retained).setURLString(path);
+ }
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * setURLObject
+ */
+ public void setURL(URL url) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_URL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer3"));
+ ((MediaContainerRetained)this.retained).setURLObject(url);
+ }
+
+ /**
+ * Set URL String.
+ * @param path string of URL containing sound data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception SoundException if the URL is not valid or cannot be opened
+ * @exception IllegalArgumentException if the specified sound data is
+ * non-null and any other sound data reference is also non-null.
+ * @since Java 3D 1.2
+ */
+ public void setURLString(String path) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_URL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer3"));
+ }
+ ((MediaContainerRetained)this.retained).setURLString(path);
+ }
+
+ /**
+ * Set URL Object.
+ * @param url URL object containing sound data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception SoundException if the URL is not valid or cannot be opened
+ * @exception IllegalArgumentException if the specified sound data is
+ * non-null and any other sound data reference is also non-null.
+ * @since Java 3D 1.2
+ */
+ public void setURLObject(URL url) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_URL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer3"));
+ ((MediaContainerRetained)this.retained).setURLObject(url);
+ }
+
+ /**
+ * Set Input Stream.
+ * @param stream input stream object containing sound data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception SoundException if InputStream is bad
+ * @exception IllegalArgumentException if the specified sound data is
+ * non-null and any other sound data reference is also non-null.
+ * @since Java 3D 1.2
+ */
+ public void setInputStream(InputStream stream) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_URL_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer3"));
+ ((MediaContainerRetained)this.retained).setInputStream(stream);
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * getURLString
+ */
+ public String getURL() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_URL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer4"));
+ return ((MediaContainerRetained)this.retained).getURLString();
+ }
+
+ /**
+ * Retrieve URL String.
+ * @return string of URL containing sound data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.2
+ */
+ public String getURLString() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_URL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer4"));
+ return ((MediaContainerRetained)this.retained).getURLString();
+ }
+
+ /**
+ * Retrieve URL Object.
+ * @return URL containing sound data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.2
+ */
+ public URL getURLObject() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_URL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer4"));
+ return ((MediaContainerRetained)this.retained).getURLObject();
+ }
+
+ /**
+ * Retrieve Input Stream.
+ * @return reference to input stream containing sound data
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @since Java 3D 1.2
+ */
+ public InputStream getInputStream() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_URL_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("MediaContainer4"));
+ return ((MediaContainerRetained)this.retained).getInputStream();
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.2, replaced with
+ * cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ MediaContainer mc = new MediaContainer();
+ mc.duplicateNodeComponent(this);
+ return mc;
+ }
+
+
+ /**
+ * Copies all MediaContainer information from
+ * originalNodeComponent into
+ * the current node. This method is called from the
+ * cloneNodeComponent method and duplicateNodeComponent
+ * method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node component's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(NodeComponent originalNodeComponent,
+ boolean forceDuplicate) {
+
+ super.duplicateAttributes(originalNodeComponent, forceDuplicate);
+
+ MediaContainerRetained mc = (MediaContainerRetained)
+ originalNodeComponent.retained;
+ MediaContainerRetained rt = (MediaContainerRetained) retained;
+ rt.setCacheEnable(mc.getCacheEnable());
+ rt.setURLString(mc.getURLString(), false);
+ rt.setURLObject(mc.getURLObject(), false);
+ rt.setInputStream(mc.getInputStream(), false);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/MediaContainerRetained.java b/j3d-core/src/classes/share/javax/media/j3d/MediaContainerRetained.java
new file mode 100644
index 0000000..508205d
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/MediaContainerRetained.java
@@ -0,0 +1,211 @@
+/*
+ * $RCSfile: MediaContainerRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.net.URL;
+import java.io.InputStream;
+
+/**
+ * The MediaContainerRetained object defines all rendering state that can
+ * be set as a component object of a retained Soundscape node.
+ */
+class MediaContainerRetained extends NodeComponentRetained {
+ /**
+ * Gain Scale Factor applied to source with this attribute
+ */
+ boolean cached = true;
+
+ /**
+ * URL string that references the sound data
+ */
+ URL url = null;
+ String urlString = null;
+ InputStream inputStream = null;
+
+
+ /**
+ * Set Cached flag
+ * @param state flag denoting sound data is cached by app within node
+ */
+ void setCacheEnable(boolean state) {
+ this.cached = state;
+ // changing this AFTER sound data attached to node is ignored
+ // notifyUsers();
+ }
+
+ /**
+ * Retrieve Attrribute Gain (amplitude)
+ * @return gain amplitude scale factor
+ */
+ boolean getCacheEnable() {
+ return this.cached;
+ }
+
+ /**
+ * Set URL object that references the sound data
+ * @param url URL object that references the sound data
+ */
+ void setURLObject(URL url) {
+ setURLObject(url, true);
+ }
+
+ /**
+ * Set URL object that references the sound data
+ * @param url URL object that references the sound data
+ * @param forceLoad ensures that message about change is sent to scheduler
+ */
+ void setURLObject(URL url, boolean forceLoad) {
+ // can NOT set URL object field unless the other related fields are null
+ if (url != null) {
+ if (urlString != null || inputStream != null)
+ throw new IllegalArgumentException(J3dI18N.getString("MediaContainer5"));
+ // Test if url object is valid by openning it
+ try {
+ InputStream stream;
+ stream = url.openStream();
+ stream.close();
+ }
+ catch (Exception e) {
+ throw new SoundException(javax.media.j3d.J3dI18N.getString("MediaContainer0"));
+ }
+ }
+ this.url = url;
+ // notifyUsers();
+ // avoid re-loading SAME MediaContainer when duplicateAttrib calls
+ if (forceLoad)
+ dispatchMessage();
+ }
+
+ /**
+ * Set URL path that references the sound data
+ * @param path string of URL that references the sound data
+ */
+ void setURLString(String path) {
+ setURLString(path, true);
+ }
+
+ /**
+ * Set URL path that references the sound data
+ * @param path string of URL that references the sound data
+ * @param forceLoad ensures that message about change is sent to scheduler
+ */
+ void setURLString(String path, boolean forceLoad) {
+ // can NOT set string field unless the other related fields are null
+ if (path != null) {
+ if (this.url != null || inputStream != null)
+ throw new IllegalArgumentException(J3dI18N.getString("MediaContainer5"));
+ // Test if path string is valid URL by trying to generate a URL
+ // and then openning it
+ try {
+ URL url = new URL(path);
+ InputStream stream;
+ stream = url.openStream();
+ stream.close();
+ }
+ catch (Exception e) {
+ throw new SoundException(javax.media.j3d.J3dI18N.getString("MediaContainer0"));
+ }
+ }
+ this.urlString = path;
+ // notifyUsers();
+ // avoid re-loading SAME MediaContainer when duplicateAttrib calls
+ if (forceLoad)
+ dispatchMessage();
+ }
+
+ /**
+ * Set input stream reference to sound data
+ * @param stream InputStream that references the sound data
+ * @param forceLoad ensures that message about change is sent to scheduler
+ */
+ void setInputStream(InputStream stream) {
+ setInputStream(stream, true);
+ }
+
+ /**
+ * Set input stream reference to sound data
+ * @param stream InputStream that references the sound data
+ */
+ void setInputStream(InputStream stream, boolean forceLoad) {
+ // XXXX: AudioDevice not intellegent enough to process InputStreams yet
+ // can NOT set stream field unless the other related fields are null
+ if (stream != null) {
+ if (url != null || urlString != null)
+ throw new IllegalArgumentException(J3dI18N.getString("MediaContainer5"));
+ }
+ this.inputStream = stream;
+ // notifyUsers();
+ // avoid re-loading SAME MediaContainer when duplicateAttrib calls
+ if (forceLoad)
+ dispatchMessage();
+ }
+
+ /**
+ * Retrieve URL String
+ * @return URL string that references the sound data
+ */
+ String getURLString() {
+ return this.urlString;
+ }
+
+ /**
+ * Retrieve URL objects
+ * @return URL object that references the sound data
+ */
+ URL getURLObject() {
+ return this.url;
+ }
+
+ /**
+ * Retrieve InputData
+ * @return InputString that references the sound data
+ */
+ InputStream getInputStream() {
+ return this.inputStream;
+ }
+
+ /**
+ * Dispatch a message about a media container change
+ */
+ void dispatchMessage() {
+ // Send message including a integer argumentD
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.SOUND_SCHEDULER;
+ createMessage.type = J3dMessage.MEDIA_CONTAINER_CHANGED;
+ createMessage.universe = null;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(SoundRetained.SOUND_DATA_DIRTY_BIT);
+ createMessage.args[2]= new Integer(users.size());
+ createMessage.args[3] = users;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/MemoryFreeList.java b/j3d-core/src/classes/share/javax/media/j3d/MemoryFreeList.java
new file mode 100644
index 0000000..b14844f
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/MemoryFreeList.java
@@ -0,0 +1,283 @@
+/*
+ * $RCSfile: MemoryFreeList.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.*;
+
+/**
+ * Class for storing various free lists. This class must be
+ * synchronized because different threads may try to access the lists.
+ */
+class MemoryFreeList {
+
+ // never go smaller than the initial capacity
+ ArrayList elementData = null;
+ int size = 0;
+ int currBlockSize = 10;
+ Object[] currBlock = null;
+ int currBlockIndex = 0;
+ int spaceUsed = 0;
+ int numBlocks = 0;
+ int capacity = 0;
+ int minBlockSize = 0;
+ boolean justShrunk = false;
+ int initcap = 10;
+
+ // the minimum size since the last shrink
+ int minSize = 0;
+
+ Class c = null;
+
+ MemoryFreeList(String className) {
+ this(className, 10);
+ }
+
+ MemoryFreeList(String className, int initialCapacity) {
+ if (initialCapacity < 0) {
+ throw new IllegalArgumentException ("Illegal Capacity: " +
+ initialCapacity);
+ }
+
+ try {
+ c = Class.forName(className);
+ }
+ catch (Exception e) {
+ System.err.println(e);
+ }
+
+ initcap = initialCapacity;
+ currBlockSize = initialCapacity;
+ minBlockSize = currBlockSize;
+ elementData = new ArrayList();
+ // add the first block of memory to the arraylist
+ currBlock = new Object[currBlockSize];
+ elementData.add(currBlock);
+ numBlocks++;
+ capacity += currBlockSize;
+ }
+
+ /*
+ MemoryFreeList(String className, Collection collection) {
+ try {
+ c = Class.forName(className);
+ }
+ catch (Exception e) {
+// System.err.println(e);
+ }
+
+ size = collection.size();
+ initcap = size;
+ currBlockSize = size;
+ minBlockSize = currBlockSize;
+ elementData = new ArrayList();
+ currBlock = new Object[currBlockSize];
+ collection.toArray(currBlock);
+ elementData.add(currBlock);
+ numBlocks++;
+ capacity += currBlockSize;
+ spaceUsed = size;
+ }
+ */
+
+ synchronized int size() {
+ return size;
+ }
+
+
+ synchronized boolean add(Object o) {
+ if (justShrunk) {
+ // empty some space out in the current block instead of
+ // adding this message
+ if ((currBlockSize/2) < spaceUsed) {
+ size -= (spaceUsed - (currBlockSize/2));
+ spaceUsed = (currBlockSize/2);
+ Arrays.fill(currBlock, spaceUsed, currBlockSize-1, null);
+ }
+ justShrunk = false;
+ return false;
+ }
+ else {
+ ensureCapacity(size+1);
+
+ // check to see if the whole block is used and if so, reset the
+ // current block
+// System.err.println("spaceUsed = " + spaceUsed + " currBlockSize = " +
+// currBlockSize + " currBlockIndex = " +
+// currBlockIndex + " currBlock = " + currBlock);
+ if ((currBlockIndex == -1) || (spaceUsed >= currBlockSize)) {
+ currBlockIndex++;
+ currBlock = (Object[])elementData.get(currBlockIndex);
+ currBlockSize = currBlock.length;
+ spaceUsed = 0;
+ }
+ int index = spaceUsed++;
+ currBlock[index] = o;
+ size++;
+
+ return true;
+ }
+ }
+
+ protected synchronized Object removeLastElement() {
+// System.err.println("removeLastElement: size = " + size);
+ int index = --spaceUsed;
+// System.err.println("index = " + index);
+ Object elm = currBlock[index];
+ currBlock[index] = null;
+ size--;
+
+ // see if this block is empty now, and if it is set the previous
+ // block to the current block
+ if (spaceUsed == 0) {
+ currBlockIndex--;
+ if (currBlockIndex < 0) {
+ currBlock = null;
+ currBlockSize = 0;
+ }
+ else {
+ currBlock = (Object[])elementData.get(currBlockIndex);
+ currBlockSize = currBlock.length;
+ }
+ spaceUsed = currBlockSize;
+ }
+
+ return elm;
+ }
+
+
+ synchronized void shrink() {
+// System.err.println("shrink size = " + size + " minSize = " +
+// minSize);
+ if ((minSize > minBlockSize) && (numBlocks > 1)) {
+ justShrunk = true;
+
+// System.err.println("removing a block");
+// Runtime r = Runtime.getRuntime();
+// r.gc();
+// System.err.println("numBlocks = " + numBlocks + " size = " + size);
+// System.err.println("free memory before shrink: " + r.freeMemory());
+
+ // remove the last block
+ Object[] block = (Object[])elementData.remove(numBlocks-1);
+ numBlocks--;
+ capacity -= block.length;
+
+ // we only need to do this if the block removed was the current
+ // block. otherwise we just removed a null block.
+ if (numBlocks == currBlockIndex) {
+ size -= spaceUsed;
+ // set the current block to the last one
+ currBlockIndex = numBlocks-1;
+ currBlock = (Object[])elementData.get(currBlockIndex);
+ currBlockSize = currBlock.length;
+
+ spaceUsed = currBlockSize;
+
+ }
+
+// r.gc();
+// System.err.println("free memory after shrink: " + r.freeMemory());
+// System.err.println("numBlocks = " + numBlocks + " size = " + size);
+ }
+ else {
+ justShrunk = false;
+ }
+ minSize = size;
+ }
+
+ synchronized void ensureCapacity(int minCapacity) {
+// System.err.println("ensureCapacity: size = " + size + " capacity: " +
+// elementData.length);
+// System.err.println("minCapacity = " + minCapacity + " capacity = "
+// + capacity);
+
+ if (minCapacity > capacity) {
+// System.err.println("adding a block: numBlocks = " + numBlocks);
+ int lastBlockSize =
+ ((Object[])elementData.get(numBlocks-1)).length;
+ int prevBlockSize = 0;
+ if (numBlocks > 1) {
+ prevBlockSize =
+ ((Object[])elementData.get(numBlocks-2)).length;
+ }
+ currBlockSize = lastBlockSize + prevBlockSize;
+ currBlock = new Object[currBlockSize];
+ elementData.add(currBlock);
+ numBlocks++;
+ currBlockIndex++;
+ capacity += currBlockSize;
+ // there is nothing used in this block yet
+ spaceUsed = 0;
+ }
+ }
+
+ synchronized void rangeCheck(int index) {
+ if (index >= size || index < 0) {
+ throw new IndexOutOfBoundsException("Index: " + index +
+ ", Size: " + size);
+ }
+ }
+
+ public synchronized void clear() {
+// System.err.println("clear");
+ elementData.clear();
+
+ // put an empty block in
+ currBlockSize = initcap;
+ minBlockSize = currBlockSize;
+ currBlock = new Object[currBlockSize];
+ elementData.add(currBlock);
+ numBlocks = 1;
+ capacity = currBlockSize;
+ spaceUsed = 0;
+ size = 0;
+ currBlockIndex = 0;
+ justShrunk = false;
+ }
+
+ synchronized Object getObject() {
+ if (size > 0) {
+ return removeLastElement();
+ }
+ else {
+ try {
+ return c.newInstance();
+ }
+ catch (Exception e) {
+ System.err.println(e);
+ return null;
+ }
+ }
+ }
+
+}
+
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ModelClip.java b/j3d-core/src/classes/share/javax/media/j3d/ModelClip.java
new file mode 100644
index 0000000..38c75de
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ModelClip.java
@@ -0,0 +1,737 @@
+/*
+ * $RCSfile: ModelClip.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.Enumeration;
+
+/**
+ * The ModelClip leaf node defines a set of 6 arbitrary clipping
+ * planes in the virtual universe. The planes are specified in the
+ * local coordinate system of this node, and may be individually
+ * enabled or disabled. This node also specifies a region of
+ * influence in which this set of planes is active.
+ *
+ * Ax + By + Cz + D <= 0
+ *
+ * where A, B, C, D are the parameters that specify the plane. The
+ * parameters are passed in the x, y, z, and w fields, respectively,
+ * of a Vector4d object. The intersection of the set of half-spaces
+ * corresponding to the enabled planes in this ModelClip node defines
+ * a region in which points are accepted. Points in this acceptance
+ * region will be rendered (subject to view clipping and other
+ * attributes). Points that are not in the acceptance region will not
+ * be rendered.
+ *
+ * @since Java 3D 1.2
+ */
+
+public class ModelClip extends Leaf {
+ /**
+ * Specifies that the ModelClip node allows read access to its influencing
+ * bounds and bounding leaf at runtime.
+ */
+ public static final int ALLOW_INFLUENCING_BOUNDS_READ =
+ CapabilityBits.MODEL_CLIP_ALLOW_INFLUENCING_BOUNDS_READ;
+
+ /**
+ * Specifies that the ModelClip node allows write access to its influencing
+ * bounds and bounding leaf at runtime.
+ */
+ public static final int ALLOW_INFLUENCING_BOUNDS_WRITE =
+ CapabilityBits.MODEL_CLIP_ALLOW_INFLUENCING_BOUNDS_WRITE;
+
+ /**
+ * Specifies that the ModelClip node allows read access to its planes
+ * at runtime.
+ */
+ public static final int ALLOW_PLANE_READ =
+ CapabilityBits.MODEL_CLIP_ALLOW_PLANE_READ;
+
+ /**
+ * Specifies that the ModelClip node allows write access to its planes
+ * at runtime.
+ */
+ public static final int ALLOW_PLANE_WRITE =
+ CapabilityBits.MODEL_CLIP_ALLOW_PLANE_WRITE;
+
+ /**
+ * Specifies that the ModelClip node allows read access to its enable
+ * flags at runtime.
+ */
+ public static final int ALLOW_ENABLE_READ =
+ CapabilityBits.MODEL_CLIP_ALLOW_ENABLE_READ;
+
+ /**
+ * Specifies that the ModelClip node allows write access to its enable
+ * flags at runtime.
+ */
+ public static final int ALLOW_ENABLE_WRITE =
+ CapabilityBits.MODEL_CLIP_ALLOW_ENABLE_WRITE;
+
+ /**
+ * Specifies that this ModelClip node allows read access to its scope
+ * information at runtime.
+ */
+ public static final int ALLOW_SCOPE_READ =
+ CapabilityBits.MODEL_CLIP_ALLOW_SCOPE_READ;
+
+ /**
+ * Specifies that this ModelClip node allows write access to its scope
+ * information at runtime.
+ */
+ public static final int ALLOW_SCOPE_WRITE =
+ CapabilityBits.MODEL_CLIP_ALLOW_SCOPE_WRITE;
+
+ // Array for setting default read capabilities
+ private static final int[] readCapabilities = {
+ ALLOW_SCOPE_READ,
+ ALLOW_ENABLE_READ,
+ ALLOW_INFLUENCING_BOUNDS_READ,
+ ALLOW_PLANE_READ
+ };
+
+ /**
+ * Constructs a ModelClip node with default parameters. The default
+ * values are as follows:
+ *
+ * planes[0] : x <= 1 (1,0,0,-1)
+ */
+ public ModelClip() {
+ // Just use the defaults
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ }
+
+
+ /**
+ * Constructs a ModelClip node using the specified planes. The individual
+ * planes are copied into this node. All planes are enabled.
+ * @param planes an array of 6 model clipping planes
+ */
+ public ModelClip(Vector4d[] planes) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ModelClipRetained)this.retained).initPlanes(planes);
+ }
+
+
+ /**
+ * Constructs a ModelClip node using the specified planes and enable
+ * flags. The individual
+ * planes and enable flags are copied into this node.
+ * @param planes an array of 6 model clipping planes
+ * @param enables an array of 6 enable flags
+ */
+ public ModelClip(Vector4d[] planes, boolean[] enables) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((ModelClipRetained)this.retained).initPlanes(planes);
+ ((ModelClipRetained)this.retained).initEnables(enables);
+ }
+
+
+ /**
+ * Set the ModelClip node's influencing region to the specified bounds.
+ * This is used when the influencing bounding leaf is set to null.
+ * @param region the bounds that contains the new influencing
+ * region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBounds(Bounds region) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip0"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).setInfluencingBounds(region);
+ else
+ ((ModelClipRetained)this.retained).initInfluencingBounds(region);
+ }
+
+
+ /**
+ * Retrieves the ModelClip node's influencing bounds.
+ * @return this node's influencing bounds information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getInfluencingBounds() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip1"));
+
+ return ((ModelClipRetained)this.retained).getInfluencingBounds();
+ }
+
+
+ /**
+ * Set the ModelClip node's influencing region to the specified
+ * bounding leaf.
+ * When set to a value other than null, this overrides the influencing
+ * bounds object.
+ * @param region the bounding leaf node used to specify the
+ * new influencing region.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_INFLUENCING_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip13"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).setInfluencingBoundingLeaf(region);
+ else
+ ((ModelClipRetained)this.retained).initInfluencingBoundingLeaf(region);
+ }
+
+
+ /**
+ * Retrieves the ModelClip node's influencing bounding leaf.
+ * @return this node's influencing bounding leaf information
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public BoundingLeaf getInfluencingBoundingLeaf() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_INFLUENCING_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip14"));
+
+ return ((ModelClipRetained)this.retained).getInfluencingBoundingLeaf();
+ }
+
+
+ /**
+ * Replaces the node at the specified index in this ModelClip node's
+ * list of scopes with the specified Group node.
+ * By default, ModelClip nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be stored at the specified index.
+ * @param index the index of the Group node to be replaced.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void setScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip7"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).setScope(scope, index);
+ else
+ ((ModelClipRetained)this.retained).initScope(scope, index);
+ }
+
+
+ /**
+ * Retrieves the Group node at the specified index from this ModelClip node's
+ * list of scopes.
+ * @param index the index of the Group node to be returned.
+ * @return the Group node at the specified index.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Group getScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip8"));
+
+ return ((ModelClipRetained)this.retained).getScope(index);
+ }
+
+
+ /**
+ * Inserts the specified Group node into this ModelClip node's
+ * list of scopes at the specified index.
+ * By default, ModelClip nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be inserted at the specified index.
+ * @param index the index at which the Group node is inserted.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void insertScope(Group scope, int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip9"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).insertScope(scope, index);
+ else
+ ((ModelClipRetained)this.retained).initInsertScope(scope, index);
+ }
+
+
+ /**
+ * Removes the node at the specified index from this ModelClip node's
+ * list of scopes. If this operation causes the list of scopes to
+ * become empty, then this ModelClip will have universe scope: all nodes
+ * within the region of influence will be affected by this ModelClip node.
+ * @param index the index of the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the group node at the
+ * specified index is part of a compiled scene graph
+ */
+ public void removeScope(int index) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip10"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).removeScope(index);
+ else
+ ((ModelClipRetained)this.retained).initRemoveScope(index);
+ }
+
+
+ /**
+ * Returns an enumeration of this ModelClip node's list of scopes.
+ * @return an Enumeration object containing all nodes in this ModelClip node's
+ * list of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Enumeration getAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip11"));
+
+ return (Enumeration) ((ModelClipRetained)this.retained).getAllScopes();
+ }
+
+
+ /**
+ * Appends the specified Group node to this ModelClip node's list of scopes.
+ * By default, ModelClip nodes are scoped only by their influencing
+ * bounds. This allows them to be further scoped by a list of
+ * nodes in the hierarchy.
+ * @param scope the Group node to be appended.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ */
+ public void addScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip12"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).addScope(scope);
+ else
+ ((ModelClipRetained)this.retained).initAddScope(scope);
+ }
+
+
+ /**
+ * Returns the number of nodes in this ModelClip node's list of scopes.
+ * If this number is 0, then the list of scopes is empty and this
+ * ModelClip node has universe scope: all nodes within the region of
+ * influence are affected by this ModelClip node.
+ * @return the number of nodes in this ModelClip node's list of scopes.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int numScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip11"));
+
+ return ((ModelClipRetained)this.retained).numScopes();
+ }
+
+
+ /**
+ * Retrieves the index of the specified Group node in this
+ * ModelClip node's list of scopes.
+ *
+ * @param scope the Group node to be looked up.
+ * @return the index of the specified Group node;
+ * returns -1 if the object is not in the list.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int indexOfScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip8"));
+ return ((ModelClipRetained)this.retained).indexOfScope(scope);
+ }
+
+
+ /**
+ * Removes the specified Group node from this ModelClip
+ * node's list of scopes. If the specified object is not in the
+ * list, the list is not modified. If this operation causes the
+ * list of scopes to become empty, then this ModelClip
+ * will have universe scope: all nodes within the region of
+ * influence will be affected by this ModelClip node.
+ *
+ * @param scope the Group node to be removed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if the specified group node
+ * is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeScope(Group scope) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip10"));
+ if (isLive())
+ ((ModelClipRetained)this.retained).removeScope(scope);
+ else
+ ((ModelClipRetained)this.retained).initRemoveScope(scope);
+ }
+
+
+ /**
+ * Removes all Group nodes from this ModelClip node's
+ * list of scopes. The ModelClip node will then have
+ * universe scope: all nodes within the region of influence will
+ * be affected by this ModelClip node.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception RestrictedAccessException if any group node in this
+ * node's list of scopes is part of a compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeAllScopes() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_SCOPE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip10"));
+ if (isLive())
+ ((ModelClipRetained)this.retained).removeAllScopes();
+ else
+ ((ModelClipRetained)this.retained).initRemoveAllScopes();
+ }
+
+
+ /**
+ * Sets the clipping planes of this ModelClip node to the
+ * specified planes.
+ * The individual planes are copied into this node.
+ * @param planes an array of 6 model clipping planes
+ */
+ public void setPlanes(Vector4d[] planes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_PLANE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip2"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).setPlanes(planes);
+ else
+ ((ModelClipRetained)this.retained).initPlanes(planes);
+ }
+
+
+ /**
+ * Retrieves the clipping planes from this ModelClip node.
+ * The individual planes are copied into the specified planes, which
+ * must be allocated by the caller. The array must be large
+ * enough to hold all of the vectors.
+ * @param planes an array of 6 vectors that will receive the model
+ * clipping planes from this node
+ */
+ public void getPlanes(Vector4d[] planes) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_PLANE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip3"));
+
+ ((ModelClipRetained)this.retained).getPlanes(planes);
+ }
+
+
+ /**
+ * Sets the specified clipping plane of this ModelClip node.
+ * The specified plane is copied into this node.
+ * @param planeNum specifies which model clipping plane (0-5) is replaced
+ * @param plane new model clipping plane
+ */
+ public void setPlane(int planeNum, Vector4d plane) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_PLANE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip2"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).setPlane(planeNum, plane);
+ else
+ ((ModelClipRetained)this.retained).initPlane(planeNum, plane);
+
+ }
+
+
+ /**
+ * Retrieves the specified clipping plane from this ModelClip node.
+ * The plane is copied into the specified plane, which
+ * must be allocated by the caller.
+ * @param planeNum specifies which model clipping plane (0-5) is retrieved
+ * @param plane a vector that will receive the specified model
+ * clipping plane from this node
+ */
+ public void getPlane(int planeNum, Vector4d plane) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_PLANE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip3"));
+
+ ((ModelClipRetained)this.retained).getPlane(planeNum, plane);
+ }
+
+
+ /**
+ * Sets the per-plane enable flags of this ModelClip node to the
+ * specified values.
+ * @param enables an array of 6 enable flags
+ */
+ public void setEnables(boolean[] enables) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ENABLE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip4"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).setEnables(enables);
+ else
+ ((ModelClipRetained)this.retained).initEnables(enables);
+ }
+
+
+ /**
+ * Retrieves the per-plane enable flags from this ModelClip node.
+ * The enable flags are copied into the specified array.
+ * The array must be large enough to hold all of the enables.
+ * @param enables an array of 6 booleans that will receive the
+ * enable flags from this node
+ */
+ public void getEnables(boolean[] enables) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ENABLE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip5"));
+
+ ((ModelClipRetained)this.retained).getEnables(enables);
+ }
+
+
+ /**
+ * Sets the specified enable flag of this ModelClip node.
+ * @param planeNum specifies which enable flag (0-5) is set
+ * @param enable new enable flag
+ */
+ public void setEnable(int planeNum, boolean enable) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ENABLE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip4"));
+
+ if (isLive())
+ ((ModelClipRetained)this.retained).setEnable(planeNum, enable);
+ else
+ ((ModelClipRetained)this.retained).initEnable(planeNum, enable);
+ }
+
+
+ /**
+ * Retrieves the specified enable flag from this ModelClip node.
+ * @param planeNum specifies which enable flag (0-5) is retrieved
+ * @return the specified enable flag
+ */
+ public boolean getEnable(int planeNum) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_ENABLE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("ModelClip5"));
+
+ return ((ModelClipRetained)this.retained).getEnable(planeNum);
+ }
+
+ /**
+ * Creates the retained mode ModelClipRetained object that
+ * this ModelClip node will point to.
+ */
+ void createRetained() {
+ this.retained = new ModelClipRetained();
+ this.retained.setSource(this);
+ }
+
+
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ * planes[1] : -x <= 1 (-1,0,0,-1)
+ * planes[2] : y <= 1 (0,1,0,-1)
+ * planes[3] : -y <= 1 (0,-1,0,-1)
+ * planes[4] : z <= 1 (0,0,1,-1)
+ * planes[5] : -z <= 1 (0,0,-1,-1)
+ * enables : all planes enabled
+ * scope : empty (universe scope)
+ * influencing bounds : null
+ * influencing bounding leaf : null
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ ModelClip c = new ModelClip();
+ c.duplicateNode(this, forceDuplicate);
+ return c;
+ }
+
+ /**
+ * Callback used to allow a node to check if any scene graph objects
+ * referenced
+ * by that node have been duplicated via a call to cloneTree.
+ * This method is called by cloneTree after all nodes in
+ * the sub-graph have been duplicated. The cloned Leaf node's method
+ * will be called and the Leaf node can then look up any object references
+ * by using the getNewObjectReference method found in the
+ * NodeReferenceTable object. If a match is found, a
+ * reference to the corresponding object in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown or a reference to the original
+ * object is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * getNewObjectReference method needed to search for
+ * new object instances.
+ * @see NodeReferenceTable
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public void updateNodeReferences(NodeReferenceTable referenceTable) {
+ ModelClipRetained rt = (ModelClipRetained) retained;
+ BoundingLeaf bl = rt.getInfluencingBoundingLeaf();
+
+ // check for influencingBoundingLeaf
+ if (bl != null) {
+ Object o = referenceTable.getNewObjectReference( bl);
+ rt.initInfluencingBoundingLeaf((BoundingLeaf) o);
+ }
+
+ int num = rt.numScopes();
+ for (int i=0; i < num; i++) {
+ rt.initScope((Group) referenceTable.
+ getNewObjectReference(rt.getScope(i)), i);
+ }
+ }
+
+
+ /**
+ * Copies all Clip information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ ModelClipRetained attr = (ModelClipRetained)
+ originalNode.retained;
+ ModelClipRetained rt = (ModelClipRetained) retained;
+
+ Vector4d plane = new Vector4d();
+
+ for (int i=5; i >=0; i--) {
+ attr.getPlane(i, plane);
+ rt.initPlane(i, plane);
+ rt.initEnable(i, attr.getEnable(i));
+ }
+ rt.initInfluencingBounds(attr.getInfluencingBounds());
+
+ Enumeration elm = attr.getAllScopes();
+ while (elm.hasMoreElements()) {
+ // this reference will set correctly in updateNodeReferences() callback
+ rt.initAddScope((Group) elm.nextElement());
+ }
+
+ // correct value will set in updateNodeReferences
+ rt.initInfluencingBoundingLeaf(attr.getInfluencingBoundingLeaf());
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/ModelClipRetained.java b/j3d-core/src/classes/share/javax/media/j3d/ModelClipRetained.java
new file mode 100644
index 0000000..9add074
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/ModelClipRetained.java
@@ -0,0 +1,1071 @@
+/*
+ * $RCSfile: ModelClipRetained.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Enumeration;
+import java.util.Vector;
+import java.util.ArrayList;
+import javax.vecmath.*;
+
+/**
+ * The ModelClip retained object.
+ */
+class ModelClipRetained extends LeafRetained {
+
+ // Statics used when something in the fog changes
+ static final int PLANE_CHANGED = 0x0001;
+ static final int PLANES_CHANGED = 0x0002;
+ static final int ENABLE_CHANGED = 0x0004;
+ static final int ENABLES_CHANGED = 0x0008;
+ static final int BOUNDS_CHANGED = 0x0010;
+ static final int BOUNDINGLEAF_CHANGED = 0x0020;
+ static final int SCOPE_CHANGED = 0x0040;
+ static final int INIT_MIRROR = 0x0080;
+ static final int CLEAR_MIRROR = 0x0100;
+ static final int LAST_DEFINED_BIT = 0x0100;
+
+ /**
+ * The clip planes and the enable bits
+ */
+ Vector4d[] planes = new Vector4d[6];
+ boolean[] enables = new boolean[6];
+
+ Vector4d[] xformPlanes = new Vector4d[6];
+
+ // enableFlag is true if one of the enables is true
+ // only used by mirror object
+ boolean enableFlag = false;
+
+ /**
+ * The Boundary object defining the model clip's region of influencing
+ */
+ Bounds regionOfInfluence = null;
+
+ /**
+ * The bounding leaf reference
+ */
+ BoundingLeafRetained boundingLeaf = null;
+
+ /**
+ * The transformed value of the influencingRegion.
+ */
+ Bounds region = null;
+
+ /**
+ * Vector of GroupRetained nodes that scopes this model clip.
+ */
+ Vector scopes = new Vector();
+
+ //Boolean to indicate if this object is scoped (only used for mirror objects
+ boolean isScoped = false;
+
+ // The object that contains the dynamic HashKey - a string type object
+ // Used in scoping
+ HashKey tempKey = new HashKey(250);
+
+ // This is true when this model clip is referenced in an immediate mode context
+ boolean inImmCtx = false;
+
+ // The mirror copy of this modelClip
+ ModelClipRetained mirrorModelClip = null;
+
+ // A reference to the scene graph model clip
+ ModelClipRetained sgModelClip = null;
+
+ // Target threads to be notified when model clip changes
+ final static int targetThreads = J3dThread.UPDATE_RENDERING_ENVIRONMENT |
+ J3dThread.UPDATE_RENDER;
+
+ /**
+ * The EnvironmentSets which reference this model clip.
+ * Note that multiple RenderBin update thread may access
+ * this shared environmentSets simultaneously.
+ * So we use UnorderList which sync. all the operations.
+ */
+ UnorderList environmentSets = new UnorderList(1, EnvironmentSet.class);
+
+ // Is true, if the mirror clip is viewScoped
+ boolean isViewScoped = false;
+
+ /**
+ * Constructs and initializes model clip planes
+ */
+ ModelClipRetained() {
+
+ // planes contains the negate default values
+ planes[0] = new Vector4d( 1.0, 0.0, 0.0,-1.0);
+ planes[1] = new Vector4d(-1.0, 0.0, 0.0,-1.0);
+ planes[2] = new Vector4d( 0.0, 1.0, 0.0,-1.0);
+ planes[3] = new Vector4d( 0.0,-1.0, 0.0,-1.0);
+ planes[4] = new Vector4d( 0.0, 0.0, 1.0,-1.0);
+ planes[5] = new Vector4d( 0.0, 0.0, -1.0,-1.0);
+
+ for (int i = 0; i < 6; i++)
+ xformPlanes[i] = new Vector4d(planes[i]);
+
+ enables[0] = enables[1] = enables[2] = enables[3] =
+ enables[4] = enables[5] = true;
+ }
+
+ /**
+ * Initializes planes before the object is live
+ */
+ void initPlanes(Vector4d[] planes) {
+
+ if (staticTransform != null) {
+ Transform3D xform = staticTransform.getNormalTransform();
+ for (int i = 0; i < 6; i++) {
+ this.planes[i].set(planes[i]);
+ xform.transform(this.planes[i], this.xformPlanes[i]);
+ }
+ } else {
+ for (int i = 0; i < 6; i++) {
+ this.planes[i].set(planes[i]);
+ this.xformPlanes[i].set(this.planes[i]);
+ }
+ }
+ }
+
+ /**
+ * Sets the clip planes and send a message
+ */
+ void setPlanes(Vector4d[] planes) {
+ Vector4d[] pl = new Vector4d[6];
+ initPlanes(planes);
+
+ for (int i = 0; i < 6; i++) {
+ pl[i] = new Vector4d(this.xformPlanes[i]);
+ }
+
+ sendMessage(PLANES_CHANGED, pl, null);
+ }
+
+ /**
+ * Initializes planes before the object is live
+ */
+ void initPlane(int planeNum, Vector4d plane) {
+ if (planeNum < 0 || planeNum > 5)
+ throw new IllegalArgumentException(J3dI18N.getString("ModelClip6"));
+
+ if (staticTransform != null) {
+ Transform3D xform = staticTransform.getNormalTransform();
+ this.planes[planeNum].set(plane);
+ xform.transform(this.planes[planeNum], this.xformPlanes[planeNum]);
+ } else {
+ this.planes[planeNum].set(plane);
+ this.xformPlanes[planeNum].set(plane);
+ }
+ }
+
+ /**
+ * Sets the clip planes and send a message
+ */
+ void setPlane(int planeNum, Vector4d plane) {
+ initPlane(planeNum, plane);
+ sendMessage(PLANE_CHANGED,
+ new Integer(planeNum),
+ new Vector4d(this.xformPlanes[planeNum]));
+ }
+
+ /**
+ * Gets planes
+ */
+ void getPlanes(Vector4d[] planes){
+
+ for (int i = 0; i < 6; i++) {
+ planes[i].set(this.planes[i]);
+ }
+ }
+
+ /**
+ * Gets the specified clipping plane
+ */
+ void getPlane(int planeNum, Vector4d plane) {
+ if (planeNum < 0 || planeNum > 5)
+ throw new IllegalArgumentException(J3dI18N.getString("ModelClip6"));
+ plane.set(this.planes[planeNum]);
+ }
+
+ /**
+ * Initializes planes before the object is live
+ */
+ void initEnables(boolean[] enables) {
+ this.enables[0] = enables[0];
+ this.enables[1] = enables[1];
+ this.enables[2] = enables[2];
+ this.enables[3] = enables[3];
+ this.enables[4] = enables[4];
+ this.enables[5] = enables[5];
+ }
+
+ /**
+ * Sets the clip planes and send a message
+ */
+ void setEnables(boolean[] enables) {
+ Boolean[] en = new Boolean[6];
+
+ initEnables(enables);
+ en[0] = (enables[0] ? Boolean.TRUE: Boolean.FALSE);
+ en[1] = (enables[1] ? Boolean.TRUE: Boolean.FALSE);
+ en[2] = (enables[2] ? Boolean.TRUE: Boolean.FALSE);
+ en[3] = (enables[3] ? Boolean.TRUE: Boolean.FALSE);
+ en[4] = (enables[4] ? Boolean.TRUE: Boolean.FALSE);
+ en[5] = (enables[5] ? Boolean.TRUE: Boolean.FALSE);
+
+ sendMessage(ENABLES_CHANGED, en, null);
+ }
+
+ /**
+ * Initializes planes before the object is live
+ */
+ void initEnable(int planeNum, boolean enable) {
+ if (planeNum < 0 || planeNum > 5)
+ throw new IllegalArgumentException(J3dI18N.getString("ModelClip6"));
+ this.enables[planeNum] = enable;
+ }
+
+ /**
+ * Sets the clip planes and send a message
+ */
+ void setEnable(int planeNum, boolean enable) {
+ initEnable(planeNum, enable);
+ sendMessage(ENABLE_CHANGED,
+ new Integer(planeNum),
+ (enable ? Boolean.TRUE: Boolean.FALSE));
+ }
+
+ /**
+ * Gets enables
+ */
+ void getEnables(boolean[] enables) {
+ enables[0] = this.enables[0];
+ enables[1] = this.enables[1];
+ enables[2] = this.enables[2];
+ enables[3] = this.enables[3];
+ enables[4] = this.enables[4];
+ enables[5] = this.enables[5];
+ }
+
+ /**
+ * Gets the specified enable
+ */
+ boolean getEnable(int planeNum) {
+ if (planeNum < 0 || planeNum > 5)
+ throw new IllegalArgumentException(J3dI18N.getString("ModelClip6"));
+ return (this.enables[planeNum]);
+ }
+
+ /**
+ * Set the Model Clip's region of influencing
+ */
+ void initInfluencingBounds(Bounds region) {
+ if (region != null) {
+ this.regionOfInfluence = (Bounds) region.clone();
+ if (staticTransform != null) {
+ regionOfInfluence.transform(staticTransform.transform);
+ }
+ } else {
+ this.regionOfInfluence = null;
+ }
+ }
+
+ /**
+ * Set the Model Clip's region of influencing and send message
+ */
+ void setInfluencingBounds(Bounds region) {
+ initInfluencingBounds(region);
+ sendMessage(BOUNDS_CHANGED,
+ (region != null ? (Bounds) region.clone(): null),
+ null);
+ }
+
+ /**
+ * Get the Model Clip's region of influencing.
+ */
+ Bounds getInfluencingBounds() {
+ Bounds b = null;
+
+ if (regionOfInfluence != null) {
+ b = (Bounds) regionOfInfluence.clone();
+ if (staticTransform != null) {
+ Transform3D invTransform = staticTransform.getInvTransform();
+ b.transform(invTransform);
+ }
+ }
+ return b;
+ }
+
+ /**
+ * Set the Model Clip's region of influencing to the specified Leaf node.
+ */
+ void initInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ } else {
+ boundingLeaf = null;
+ }
+ }
+
+ /**
+ * Set the Model Clip's region of influencing to the specified Leaf node.
+ */
+ void setInfluencingBoundingLeaf(BoundingLeaf region) {
+ if (boundingLeaf != null)
+ boundingLeaf.mirrorBoundingLeaf.removeUser(mirrorModelClip);
+ if (region != null) {
+ boundingLeaf = (BoundingLeafRetained)region.retained;
+ boundingLeaf.mirrorBoundingLeaf.addUser(mirrorModelClip);
+ } else {
+ boundingLeaf = null;
+ }
+
+ sendMessage(BOUNDINGLEAF_CHANGED,
+ (boundingLeaf != null ?
+ boundingLeaf.mirrorBoundingLeaf : null),
+ null);
+ }
+
+
+ /**
+ * Get the Model Clip's region of influencing.
+ */
+ BoundingLeaf getInfluencingBoundingLeaf() {
+ return (boundingLeaf != null ?
+ (BoundingLeaf)boundingLeaf.source : null);
+ }
+
+ /**
+ * Replaces the specified scope with the scope provided.
+ * @param scope the new scope
+ * @param index which scope to replace
+ */
+ void initScope(Group scope, int index) {
+ scopes.setElementAt((GroupRetained)(scope.retained), index);
+ }
+
+ /**
+ * Replaces the specified scope with the scope provided.
+ * @param scope the new scope
+ * @param index which scope to replace
+ */
+ void setScope(Group scope, int index) {
+
+ ArrayList addScopeList = new ArrayList();
+ ArrayList removeScopeList = new ArrayList();
+ GroupRetained group;
+ Object[] scopeInfo = new Object[3];
+
+ group = (GroupRetained) scopes.get(index);
+ tempKey.reset();
+ group.removeAllNodesForScopedModelClip(mirrorModelClip, removeScopeList, tempKey);
+
+ group = (GroupRetained)scope.retained;
+ initScope(scope, index);
+ tempKey.reset();
+ // If its a group, then add the scope to the group, if
+ // its a shape, then keep a list to be added during
+ // updateMirrorObject
+ group.addAllNodesForScopedModelClip(mirrorModelClip,addScopeList, tempKey);
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE:Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo, null);
+ }
+
+ /**
+ * Inserts the specified scope at specified index
+ * @param scope the new scope
+ * @param index position to insert new scope at
+ */
+ void initInsertScope(Node scope, int index) {
+ GroupRetained group = (GroupRetained)scope.retained;
+ group.setMclipScope();
+ scopes.insertElementAt((GroupRetained)(scope.retained), index);
+ }
+
+ /**
+ * Inserts the specified scope at specified index and sends
+ * a message
+ * @param scope the new scope
+ * @param index position to insert new scope at
+ */
+ void insertScope(Node scope, int index) {
+ Object[] scopeInfo = new Object[3];
+ ArrayList addScopeList = new ArrayList();
+
+ initInsertScope(scope, index);
+ GroupRetained group = (GroupRetained)scope.retained;
+ tempKey.reset();
+ group.addAllNodesForScopedModelClip(mirrorModelClip,addScopeList, tempKey);
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = null;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo, null);
+ }
+
+
+ void initRemoveScope(int index) {
+ GroupRetained group = (GroupRetained)scopes.elementAt(index);
+ group.removeMclipScope();
+ scopes.removeElementAt(index);
+
+ }
+
+ void removeScope(int index) {
+
+ Object[] scopeInfo = new Object[3];
+ ArrayList removeScopeList = new ArrayList();
+ GroupRetained group = (GroupRetained)scopes.elementAt(index);
+
+ initRemoveScope(index);
+ tempKey.reset();
+ group.removeAllNodesForScopedModelClip(mirrorModelClip, removeScopeList, tempKey);
+
+ scopeInfo[0] = null;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo, null);
+ }
+
+ /**
+ * Removes the specified Group node from this ModelClip's list of
+ * scopes if the specified node is not found in the list of scoped
+ * nodes, method returns quietly.
+ *
+ * @param Group node to be removed
+ */
+ void removeScope(Group node) {
+ int ind = indexOfScope(node);
+ if(ind >= 0)
+ removeScope(ind);
+ }
+
+ void initRemoveScope(Group node) {
+ int ind = indexOfScope(node);
+ if(ind >= 0)
+ initRemoveScope(ind);
+ }
+
+ /**
+ * Removes all the Group nodes from the ModelClip's scope
+ * list. The ModelClip reverts to universal scope.
+ */
+ void removeAllScopes() {
+ Object[] scopeInfo = new Object[3];
+ ArrayList removeScopeList = new ArrayList();
+ int n = scopes.size();
+ for(int index = n-1; index >= 0; index--) {
+ GroupRetained group = (GroupRetained)scopes.elementAt(index);
+ initRemoveScope(index);
+ tempKey.reset();
+ group.removeAllNodesForScopedModelClip(mirrorModelClip, removeScopeList, tempKey);
+ }
+
+ scopeInfo[0] = null;
+ scopeInfo[1] = removeScopeList;
+ scopeInfo[2] = (Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo, null);
+ }
+
+
+ void initRemoveAllScopes() {
+ int n = scopes.size();
+ for(int i = n-1; i >= 0; i--) {
+ initRemoveScope(i);
+ }
+ }
+
+ /**
+ * Returns the scope specified by the index.
+ * @param index which scope to return
+ * @return the scoperen at location index
+ */
+ Group getScope(int index) {
+ return (Group)(((GroupRetained)(scopes.elementAt(index))).source);
+ }
+
+ /**
+ * Returns an enumeration object of the scoperen.
+ * @return an enumeration object of the scoperen
+ */
+ Enumeration getAllScopes() {
+ Enumeration elm = scopes.elements();
+ Vector v = new Vector(scopes.size());
+ while (elm.hasMoreElements()) {
+ v.add( ((GroupRetained) elm.nextElement()).source);
+ }
+ return v.elements();
+ }
+
+ /**
+ * Appends the specified scope to this node's list of scopes before
+ * the fog is alive
+ * @param scope the scope to add to this node's list of scopes
+ */
+ void initAddScope(Group scope) {
+ GroupRetained group = (GroupRetained)scope.retained;
+ scopes.addElement((GroupRetained)(scope.retained));
+ group.setMclipScope();
+ }
+
+ /**
+ * Appends the specified scope to this node's list of scopes.
+ * @param scope the scope to add to this node's list of scopes
+ */
+ void addScope(Group scope) {
+
+ Object[] scopeInfo = new Object[3];
+ ArrayList addScopeList = new ArrayList();
+ GroupRetained group = (GroupRetained)scope.retained;
+
+ initAddScope(scope);
+ tempKey.reset();
+ group.addAllNodesForScopedModelClip(mirrorModelClip,addScopeList, tempKey);
+ scopeInfo[0] = addScopeList;
+ scopeInfo[1] = null;
+ scopeInfo[2] = (scopes.size() > 0 ? Boolean.TRUE: Boolean.FALSE);
+ sendMessage(SCOPE_CHANGED, scopeInfo, null);
+ }
+
+ /**
+ * Returns a count of this nodes' scopes.
+ * @return the number of scopes descendant from this node
+ */
+ int numScopes() {
+ return scopes.size();
+ }
+
+ /**
+ * Returns the index of the specified Group node within the ModelClip's list of scoped
+ * Group nodes
+ * @param Group node whose index is desired
+ * @return index of this node
+ */
+ int indexOfScope(Group node) {
+ if(node != null)
+ return scopes.indexOf((GroupRetained)node.retained);
+ else
+ return scopes.indexOf(null);
+ }
+
+ /**
+ * This sets the immedate mode context flag
+ */
+ void setInImmCtx(boolean inCtx) {
+ inImmCtx = inCtx;
+ }
+
+ /**
+ * This gets the immedate mode context flag
+ */
+ boolean getInImmCtx() {
+ return (inImmCtx);
+ }
+
+
+ /**
+ * This method and its native counterpart update the native context
+ * model clip planes.
+ */
+ void update(Canvas3D cv, int enableMask) {
+ cv.setModelViewMatrix(cv.ctx,
+ cv.vworldToEc.mat,
+ getLastLocalToVworld());
+ update(cv.ctx, enableMask, getLastLocalToVworld());
+ }
+
+ void update(Context ctx, int enableMask, Transform3D trans) {
+ if (!VirtualUniverse.mc.isD3D()) {
+ for (int i = 0; i < 6; i ++) {
+ Pipeline.getPipeline().updateModelClip(ctx, i, ((enableMask & (1 << i)) != 0),
+ xformPlanes[i].x, xformPlanes[i].y,
+ xformPlanes[i].z, xformPlanes[i].w);
+ }
+ return;
+ }
+
+ // For D3D we need to transform the plane equations from local to
+ // world coordinate.
+ Transform3D invtrans = new Transform3D(trans);
+
+ // can't call getNormalTransform() since it will cache
+ // normalTransform and may return previous result next time.
+ invtrans.invert();
+ invtrans.transpose();
+
+ for (int i=0; i < 6; i++) {
+ if ((enableMask & (1 << i)) != 0) {
+
+ Vector4d vec = new Vector4d(xformPlanes[i].x, xformPlanes[i].y,
+ xformPlanes[i].z, xformPlanes[i].w);
+ vec.normalize();
+ invtrans.transform(vec);
+ Pipeline.getPipeline().updateModelClip(ctx, i, true, vec.x, vec.y, vec.z, vec.w);
+
+ } else {
+ Pipeline.getPipeline().updateModelClip(ctx, i, false, 0, 0, 0, 0);
+ }
+ }
+ }
+
+ void initMirrorObject(Object[] args) {
+ Shape3DRetained shape;
+ Object[] scopeInfo = (Object[]) args[2];
+ Boolean scoped = (Boolean)scopeInfo[0];
+ ArrayList shapeList = (ArrayList)scopeInfo[1];
+ BoundingLeafRetained bl=(BoundingLeafRetained)((Object[])args[4])[0];
+ Bounds bnds = (Bounds)((Object[])args[4])[1];
+
+ for (int i = 0; i < shapeList.size(); i++) {
+ shape = ((GeometryAtom)shapeList.get(i)).source;
+ shape.addModelClip(mirrorModelClip);
+ }
+ mirrorModelClip.isScoped = scoped.booleanValue();
+
+ if (bl != null) {
+ mirrorModelClip.boundingLeaf = bl.mirrorBoundingLeaf;
+ mirrorModelClip.region = boundingLeaf.transformedRegion;
+ } else {
+ mirrorModelClip.boundingLeaf = null;
+ mirrorModelClip.region = null;
+ }
+
+ if (bnds != null) {
+ mirrorModelClip.regionOfInfluence = bnds;
+ if (mirrorModelClip.region == null) {
+ mirrorModelClip.region = (Bounds)regionOfInfluence.clone();
+ mirrorModelClip.region.transform(regionOfInfluence, getLastLocalToVworld());
+ }
+ }
+ else {
+ mirrorModelClip.regionOfInfluence = null;
+ }
+ boolean[] ens = (boolean[])((Object[])args[4])[2];
+
+ for (int i = 0; i < ens.length; i++) {
+ mirrorModelClip.enables[i] = ens[i];
+ }
+ mirrorModelClip.enableFlag = mirrorModelClip.enables[0] |
+ mirrorModelClip.enables[1] |
+ mirrorModelClip.enables[2] |
+ mirrorModelClip.enables[3] |
+ mirrorModelClip.enables[4] |
+ mirrorModelClip.enables[5] ;
+
+ }
+
+
+
+ void updateMirrorObject(Object[] objs) {
+ int component = ((Integer)objs[1]).intValue();
+ if ((component & PLANES_CHANGED) != 0) {
+ Vector4d[] pl = ((Vector4d[]) objs[2]);
+
+ for (int i = 0; i < 6; i++) {
+ mirrorModelClip.xformPlanes[i].set(pl[i]);
+ }
+ }
+ else if ((component & PLANE_CHANGED) != 0) {
+ int planeNum = ((Integer)objs[2]).intValue();
+
+ mirrorModelClip.xformPlanes[planeNum].set((Vector4d)objs[3]);
+ }
+ else if ((component & INIT_MIRROR) != 0) {
+ Vector4d[] pl = (Vector4d[]) objs[3];
+ for (int i = 0; i < 6; i++) {
+ mirrorModelClip.xformPlanes[i].set(pl[i]);
+ }
+ }
+ }
+
+ // The update Object function.
+ void updateImmediateMirrorObject(Object[] objs) {
+ int component = ((Integer)objs[1]).intValue();
+ Transform3D trans;
+
+
+ if ((component & BOUNDINGLEAF_CHANGED) != 0) {
+ mirrorModelClip.boundingLeaf = (BoundingLeafRetained)objs[2];
+ if (objs[2] != null) {
+ mirrorModelClip.region =
+ (Bounds)mirrorModelClip.boundingLeaf.transformedRegion;
+ }
+ else {
+ if (mirrorModelClip.regionOfInfluence != null) {
+ mirrorModelClip.region =
+ ((Bounds)mirrorModelClip.regionOfInfluence).copy(mirrorModelClip.region);
+ mirrorModelClip.region.transform(mirrorModelClip.regionOfInfluence,
+ getCurrentLocalToVworld());
+ }
+ else {
+ mirrorModelClip.region = null;
+ }
+
+ }
+ }
+
+ if ((component & BOUNDS_CHANGED) != 0) {
+ mirrorModelClip.regionOfInfluence = (Bounds) objs[2];
+ if (mirrorModelClip.boundingLeaf == null) {
+ if (objs[2] != null) {
+ mirrorModelClip.region =
+ ((Bounds)mirrorModelClip.regionOfInfluence).copy(mirrorModelClip.region);
+
+ mirrorModelClip.region.transform(mirrorModelClip.regionOfInfluence,
+ getCurrentLocalToVworld());
+ }
+ else {
+ mirrorModelClip.region = null;
+ }
+ }
+ }
+
+ if ((component & SCOPE_CHANGED) != 0) {
+ Object[] scopeList = (Object[])objs[2];
+ ArrayList addList = (ArrayList)scopeList[0];
+ ArrayList removeList = (ArrayList)scopeList[1];
+ boolean isScoped = ((Boolean)scopeList[2]).booleanValue();
+
+ if (addList != null) {
+ mirrorModelClip.isScoped = isScoped;
+ for (int i = 0; i < addList.size(); i++) {
+ Shape3DRetained obj = ((GeometryAtom)addList.get(i)).source;
+ obj.addModelClip(mirrorModelClip);
+ }
+ }
+
+ if (removeList != null) {
+ mirrorModelClip.isScoped = isScoped;
+ for (int i = 0; i < removeList.size(); i++) {
+ Shape3DRetained obj = ((GeometryAtom)removeList.get(i)).source;
+ obj.removeModelClip(mirrorModelClip);
+ }
+ }
+ }
+
+ if ((component & ENABLES_CHANGED) != 0) {
+ Boolean[] en = ((Boolean[]) objs[2]);
+
+ mirrorModelClip.enables[0] = en[0].booleanValue();
+ mirrorModelClip.enables[1] = en[1].booleanValue();
+ mirrorModelClip.enables[2] = en[2].booleanValue();
+ mirrorModelClip.enables[3] = en[3].booleanValue();
+ mirrorModelClip.enables[4] = en[4].booleanValue();
+ mirrorModelClip.enables[5] = en[5].booleanValue();
+ mirrorModelClip.enableFlag = mirrorModelClip.enables[0] |
+ mirrorModelClip.enables[1] |
+ mirrorModelClip.enables[2] |
+ mirrorModelClip.enables[3] |
+ mirrorModelClip.enables[4] |
+ mirrorModelClip.enables[5] ;
+ } else if ((component & ENABLE_CHANGED) != 0) {
+ int planeNum = ((Integer)objs[2]).intValue();
+
+ mirrorModelClip.enables[planeNum] = ((Boolean)objs[3]).booleanValue();
+ mirrorModelClip.enableFlag = mirrorModelClip.enables[0] |
+ mirrorModelClip.enables[1] |
+ mirrorModelClip.enables[2] |
+ mirrorModelClip.enables[3] |
+ mirrorModelClip.enables[4] |
+ mirrorModelClip.enables[5] ;
+ }
+ }
+
+
+ /** Note: This routine will only be called on
+ * the mirror object - will update the object's
+ * cached region and transformed region
+ */
+ void updateBoundingLeaf() {
+ if (boundingLeaf != null && boundingLeaf.switchState.currentSwitchOn) {
+ region = boundingLeaf.transformedRegion;
+ } else {
+ if (regionOfInfluence != null) {
+ region = regionOfInfluence.copy(region);
+ region.transform(regionOfInfluence, getCurrentLocalToVworld());
+ } else {
+ region = null;
+ }
+ }
+ }
+
+
+ void setLive(SetLiveState s) {
+ GroupRetained group;
+
+ super.doSetLive(s);
+
+ if (inSharedGroup) {
+ throw new
+ IllegalSharingException(J3dI18N.getString("ModelClipRetained1"));
+ }
+
+ // Create the mirror object
+
+
+ if (mirrorModelClip == null) {
+ mirrorModelClip = (ModelClipRetained)this.clone();
+ mirrorModelClip.boundingLeaf = null;
+ mirrorModelClip.sgModelClip = this;
+ }
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(mirrorModelClip);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(mirrorModelClip);
+ }
+
+ // If bounding leaf is not null, add the mirror object as a user
+ // so that any changes to the bounding leaf will be received
+ if (boundingLeaf != null) {
+ boundingLeaf.mirrorBoundingLeaf.addUser(mirrorModelClip);
+ }
+ // process switch leaf
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorModelClip, Targets.ENV_TARGETS);
+ }
+ mirrorModelClip.switchState = (SwitchState)s.switchStates.get(0);
+
+ // add this model clip to the transform target
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorModelClip, Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+ super.markAsLive();
+
+
+ // Initialize the mirror object, this needs to be done, when
+ // renderBin is not accessing any of the fields
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.MODELCLIP_CHANGED;
+ createMessage.args[0] = this;
+ // a snapshot of all attributes that needs to be initialized
+ // in the mirror object
+ createMessage.args[1]= new Integer(INIT_MIRROR);
+ ArrayList addScopeList = new ArrayList();
+ for (int i = 0; i < scopes.size(); i++) {
+ group = (GroupRetained)scopes.get(i);
+ tempKey.reset();
+ group.addAllNodesForScopedModelClip(mirrorModelClip, addScopeList, tempKey);
+ }
+ Object[] scopeInfo = new Object[2];
+ scopeInfo[0] = ((scopes.size() > 0) ? Boolean.TRUE:Boolean.FALSE);
+ scopeInfo[1] = addScopeList;
+ createMessage.args[2] = scopeInfo;
+ createMessage.args[3] = xformPlanes.clone();
+
+ Object[] obj = new Object[3];
+ obj[0] = boundingLeaf;
+ obj[1] = (regionOfInfluence != null?regionOfInfluence.clone():null);
+ obj[2] = enables.clone();
+ createMessage.args[4] = obj;
+ VirtualUniverse.mc.processMessage(createMessage);
+
+
+ }
+
+
+ /**
+ * This clearLive routine first calls the superclass's method, then
+ * it removes itself to the list of model clip
+ */
+ void clearLive(SetLiveState s) {
+
+ super.clearLive(s);
+ s.notifyThreads |= J3dThread.UPDATE_RENDERING_ENVIRONMENT|
+ J3dThread.UPDATE_RENDER;
+ if (s.switchTargets != null &&
+ s.switchTargets[0] != null) {
+ s.switchTargets[0].addNode(mirrorModelClip, Targets.ENV_TARGETS);
+ }
+ // Remove this mirror light as users of the bounding leaf
+ if (mirrorModelClip.boundingLeaf != null)
+ mirrorModelClip.boundingLeaf.removeUser(mirrorModelClip);
+
+ if ((s.viewScopedNodeList != null) && (s.viewLists != null)) {
+ s.viewScopedNodeList.add(mirrorModelClip);
+ s.scopedNodesViewList.add(s.viewLists.get(0));
+ } else {
+ s.nodeList.add(mirrorModelClip);
+ }
+ if (s.transformTargets != null && s.transformTargets[0] != null) {
+ s.transformTargets[0].addNode(mirrorModelClip, Targets.ENV_TARGETS);
+ s.notifyThreads |= J3dThread.UPDATE_TRANSFORM;
+ }
+
+
+ if (scopes.size() > 0) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = J3dThread.UPDATE_RENDERING_ENVIRONMENT;
+ createMessage.universe = universe;
+ createMessage.type = J3dMessage.MODELCLIP_CHANGED;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(CLEAR_MIRROR);
+ ArrayList removeScopeList = new ArrayList();
+ for (int i = 0; i < scopes.size(); i++) {
+ GroupRetained group = (GroupRetained)scopes.get(i);
+ tempKey.reset();
+ group.removeAllNodesForScopedModelClip(mirrorModelClip, removeScopeList, tempKey);
+ }
+ createMessage.args[2] = removeScopeList;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+ }
+
+ // This is called on the parent object
+ void clearMirrorObject(Object[] args) {
+ Shape3DRetained shape;
+ ArrayList shapeList = (ArrayList)args[2];
+ ArrayList removeScopeList = new ArrayList();
+
+ for (int i = 0; i < shapeList.size(); i++) {
+ shape = ((GeometryAtom)shapeList.get(i)).source;
+ shape.removeModelClip(mirrorModelClip);
+ }
+
+ mirrorModelClip.isScoped = false;
+
+ }
+
+
+ // Clone the retained side only, internal use only
+ protected Object clone() {
+ ModelClipRetained mc = (ModelClipRetained)super.clone();
+
+ mc.planes = new Vector4d[6];
+ for (int i = 0; i < 6; i++) {
+ mc.planes[i] = new Vector4d(this.planes[i]);
+ mc.xformPlanes[i] = new Vector4d(this.xformPlanes[i]);
+ }
+
+ mc.enables = new boolean[6];
+ getEnables(mc.enables);
+
+ // Derive the enables flag
+ mc.enableFlag = (mc.enables[0] |
+ mc.enables[1] |
+ mc.enables[2] |
+ mc.enables[3] |
+ mc.enables[4] |
+ mc.enables[5] );
+
+ mc.inImmCtx = false;
+ mc.region = null;
+ mc.sgModelClip = null;
+ mc.mirrorModelClip = null;
+ mc.environmentSets = new UnorderList(1, EnvironmentSet.class);
+
+ if (regionOfInfluence != null) {
+ mc.regionOfInfluence = (Bounds) regionOfInfluence.clone();
+ }
+
+ return mc;
+ }
+
+
+ // Called on mirror object
+ void updateImmediateTransformChange() {
+ // If bounding leaf is null, tranform the bounds object
+ if (boundingLeaf == null) {
+ if (regionOfInfluence != null) {
+ region = regionOfInfluence.copy(region);
+ region.transform(regionOfInfluence,
+ sgModelClip.getCurrentLocalToVworld());
+ }
+
+ }
+ }
+
+
+ void printPlane(int index, String string)
+ {
+ System.err.println(string + " : < " + planes[index].toString()
+ + " > " + enables[index]);
+ }
+
+ void printPlanes(String string, Vector4d[] planes)
+ {
+ System.err.println(string);
+ printPlane(0, "[0]");
+ printPlane(1, "[1]");
+ printPlane(2, "[2]");
+ printPlane(3, "[3]");
+ printPlane(4, "[4]");
+ printPlane(5, "[5]");
+ }
+
+
+ void printEnables(String string, boolean[] enables)
+ {
+ System.err.println(string);
+ System.err.println("[0] : < " + enables[0] + " >");
+ System.err.println("[1] : < " + enables[1] + " >");
+ System.err.println("[2] : < " + enables[2] + " >");
+ System.err.println("[3] : < " + enables[3] + " >");
+ System.err.println("[4] : < " + enables[4] + " >");
+ System.err.println("[5] : < " + enables[5] + " >");
+ }
+
+ final void sendMessage(int attrMask, Object attr1, Object attr2) {
+ J3dMessage createMessage = new J3dMessage();
+ createMessage.threads = targetThreads;
+ createMessage.type = J3dMessage.MODELCLIP_CHANGED;
+ createMessage.universe = universe;
+ createMessage.args[0] = this;
+ createMessage.args[1]= new Integer(attrMask);
+ createMessage.args[2] = attr1;
+ createMessage.args[3] = attr2;
+ VirtualUniverse.mc.processMessage(createMessage);
+ }
+
+ void mergeTransform(TransformGroupRetained staticTransform) {
+ super.mergeTransform(staticTransform);
+
+ if (regionOfInfluence != null) {
+ regionOfInfluence.transform(staticTransform.transform);
+ }
+
+ Transform3D xform = staticTransform.getNormalTransform();
+ for (int i = 0; i < 6; i++) {
+ xform.transform(planes[i], xformPlanes[i]);
+ }
+ }
+ void getMirrorObjects(ArrayList leafList, HashKey key) {
+ leafList.add(mirrorModelClip);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/Morph.java b/j3d-core/src/classes/share/javax/media/j3d/Morph.java
new file mode 100644
index 0000000..d5e0d86
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/Morph.java
@@ -0,0 +1,707 @@
+/*
+ * $RCSfile: Morph.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Hashtable;
+import javax.vecmath.*;
+
+/**
+ * The Morph leaf node permits an application to morph between
+ * multiple GeometryArrays. The Morph node contains a single
+ * Appearance node, an array of GeometryArray objects, and an array of
+ * corresponding weights. The Morph node combines these GeometryArrays
+ * into an aggregate shape based on each GeometryArray's corresponding
+ * weight. Typically, Behavior nodes will modify the weights to
+ * achieve various morphing effects.
+ *
+ *
+ *
+ *
+ *
+ * appearance : null
+ * weights : [1, 0, 0, 0, ...]
+ * collision bounds : null
+ * appearance override enable : false
+ *
+ *
+ *
+ * @exception UnsupportedOperationException if the specified
+ * geometry arrays contain vertex attributes (that is, if their
+ * vertexFormat includes the VERTEX_ATTRIBUTES flag).
+ */
+ public Morph(GeometryArray geometryArrays[]) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((MorphRetained)retained).setGeometryArrays(geometryArrays);
+ }
+
+ /**
+ * Constructs and initializes a Morph node with the specified array
+ * of GeometryArray objects and the specified appearance object.
+ *
+ * @param geometryArrays the geometry components of the Morph node
+ * a null or zero-length array of GeometryArray objects is
+ * permitted, and specifies that no geometry is drawn. In this case,
+ * the array of weights is initialized to a zero-length array.
+ * @param appearance the appearance component of the Morph node
+ *
+ * @exception IllegalArgumentException if any of the specified
+ * geometry array objects differ from each other in any of the
+ * following ways:
+ *
+ *
+ *
+ * @exception UnsupportedOperationException if the specified
+ * geometry arrays contain vertex attributes (that is, if their
+ * vertexFormat includes the VERTEX_ATTRIBUTES flag).
+ */
+ public Morph(GeometryArray geometryArrays[], Appearance appearance) {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((MorphRetained)retained).setGeometryArrays(geometryArrays);
+ ((MorphRetained)this.retained).setAppearance(appearance);
+ }
+
+ /**
+ * Creates the retained mode MorphRetained object that this
+ * Morph object will point to.
+ */
+ void createRetained() {
+ retained = new MorphRetained();
+ retained.setSource(this);
+ }
+
+ /**
+ * Sets the collision bounds of a node.
+ * @param bounds the collision bounding object for a node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setCollisionBounds(Bounds bounds) {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLLISION_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph0"));
+
+ ((MorphRetained)this.retained).setCollisionBounds(bounds);
+ }
+
+ /**
+ * Returns the collision bounding object of this node.
+ * @return the node's collision bounding object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Bounds getCollisionBounds() {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLLISION_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph1"));
+
+ return ((MorphRetained)this.retained).getCollisionBounds();
+ }
+
+
+ /**
+ * Sets the geometryArrays component of the Morph node.
+ *
+ * If the current array of GeometryArrays in this Morph object is
+ * non-null with a length greater than 0, the specified array of
+ * GeometryArrays must be the same length as the current array.
+ * If the current array of GeometryArrays in this Morph object is
+ * null or has a length of 0, and the specified array of
+ * GeometryArrays is non-null with a length greater than 0, the
+ * length of the incoming array defines the number of the geometry
+ * objects that will be morphed. In this case, the weights array
+ * is allocated to be of the same length as the geometry array;
+ * the first element (weights[0]) is initialized to 1.0 and all of
+ * the other weights are initialized to 0.0.
+ *
+ * @param geometryArrays the new geometryArrays component
+ * for the Morph node.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ *
+ *
+ * @exception UnsupportedOperationException if the specified
+ * geometry arrays contain vertex attributes (that is, if their
+ * vertexFormat includes the VERTEX_ATTRIBUTES flag).
+ */
+ public void setGeometryArrays(GeometryArray geometryArrays[]) {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_GEOMETRY_ARRAY_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph2"));
+
+ ((MorphRetained)this.retained).setGeometryArrays(geometryArrays);
+ }
+
+ /**
+ * Retrieves the geometryArray component of this Morph node.
+ * @param index the index of GeometryArray to be returned
+ * @return the geometryArray component of this Morph node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public GeometryArray getGeometryArray(int index) {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_GEOMETRY_ARRAY_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph3"));
+
+ return ((MorphRetained)this.retained).getGeometryArray(index);
+ }
+
+ /**
+ * Sets the appearance component of this Morph node. A null
+ * appearance component specifies that default values are used for all
+ * appearance attributes.
+ * @param appearance the new appearance component for this Morph node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAppearance(Appearance appearance) {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPEARANCE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph4"));
+
+ ((MorphRetained)this.retained).setAppearance(appearance);
+ }
+
+ /**
+ * Retrieves the appearance component of this morph node.
+ * @return the appearance component of this morph node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Appearance getAppearance() {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_APPEARANCE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph5"));
+
+ return ((MorphRetained)this.retained).getAppearance();
+ }
+
+
+ /**
+ * Checks whether the geometry in this morph node intersects with
+ * the specified pickShape.
+ *
+ * @param path the SceneGraphPath to this morph node
+ * @param pickShape the PickShape to be intersected
+ *
+ * @return true if the pick shape intersects this node; false
+ * otherwise.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint.
+ * Java 3D doesn't have spatial information of the surface.
+ * Use PickBounds with BoundingSphere and a small radius, instead.
+ *
+ * @exception CapabilityNotSetException if the Geometry.ALLOW_INTERSECT
+ * capability bit is not set in all of the Geometry objects
+ * referred to by this morph node.
+ */
+ public boolean intersect(SceneGraphPath path, PickShape pickShape) {
+ return intersect(path, pickShape, null);
+ }
+
+
+ /**
+ * Checks whether the geometry in this morph node intersects with
+ * the specified pickRay.
+ *
+ * @param path the SceneGraphPath to this morph node
+ * @param pickRay the PickRay to be intersected
+ * @param dist the closest distance of the intersection
+ *
+ * @return true if the pick shape intersects this node; false
+ * otherwise. If true, dist contains the closest distance of
+ * intersection.
+ *
+ * @exception CapabilityNotSetException if the Geometry.ALLOW_INTERSECT
+ * capability bit is not set in all of the Geometry objects
+ * referred to by this morph node.
+ */
+ public boolean intersect(SceneGraphPath path,
+ PickRay pickRay,
+ double[] dist) {
+
+ if (isLiveOrCompiled()) {
+ checkForAllowIntersect();
+ }
+
+ return ((MorphRetained)this.retained).intersect(path, pickRay, dist);
+ }
+
+
+ /**
+ * Checks whether the geometry in this morph node intersects with
+ * the specified pickShape.
+ *
+ * @param path the SceneGraphPath to this morph node
+ * @param pickShape the PickShape to be intersected
+ * @param dist the closest distance of the intersection
+ *
+ * @return true if the pick shape intersects this node; false
+ * otherwise. If true, dist contains the closest distance of
+ * intersection.
+ *
+ * @exception IllegalArgumentException if pickShape is a PickPoint.
+ * Java 3D doesn't have spatial information of the surface.
+ * Use PickBounds with BoundingSphere and a small radius, instead.
+ *
+ * @exception CapabilityNotSetException if the Geometry.ALLOW_INTERSECT
+ * capability bit is not set in all of the Geometry objects
+ * referred to by this morph node.
+ *
+ * @since Java 3D 1.3
+ */
+ public boolean intersect(SceneGraphPath path,
+ PickShape pickShape,
+ double[] dist) {
+
+ if (isLiveOrCompiled()) {
+ checkForAllowIntersect();
+ }
+
+ if (pickShape instanceof PickPoint) {
+ throw new IllegalArgumentException(J3dI18N.getString("Morph10"));
+ }
+
+ return ((MorphRetained)this.retained).intersect(path, pickShape, dist);
+ }
+
+
+ /**
+ * Sets this Morph node's morph weight vector. The Morph node "weights"
+ * the corresponding GeometryArray by the amount specified.
+ * The weights apply a morph weight vector component that creates
+ * the desired morphing effect.
+ * The length
+ * of the weights parameter must be equal to the length
+ * of the array with which this Morph node was created, otherwise
+ * an IllegalArgumentException is thown.
+ * @param weights the morph weight vector that the morph node will
+ * use in combining the node's geometryArrays. The morph node will "weight"
+ * the corresponding GeometryArray by the amount specified.
+ * N.B.: the sum of the weights should equal 1.0
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception IllegalArgumentException if sum of all 'weights' is
+ * NOT 1.0 or number of weights is NOT exqual to number of GeometryArrays.
+ */
+ public void setWeights(double weights[]) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_WEIGHTS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph8"));
+
+ ((MorphRetained)this.retained).setWeights(weights);
+ }
+
+ /**
+ * Retrieves the Morph node's morph weight vector.
+ * @return the morph weight vector component of this morph node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public double[] getWeights() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_WEIGHTS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph9"));
+
+ return ((MorphRetained)this.retained).getWeights();
+ }
+
+ /**
+ * Sets a flag that indicates whether this node's appearance can
+ * be overridden. If the flag is true, this node's
+ * appearance may be overridden by an AlternateAppearance leaf
+ * node, regardless of the value of the ALLOW_APPEARANCE_WRITE
+ * capability bit.
+ * The default value is false.
+ *
+ * @param flag the apperance override enable flag
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @see AlternateAppearance
+ *
+ * @since Java 3D 1.2
+ */
+ public void setAppearanceOverrideEnable(boolean flag) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_APPEARANCE_OVERRIDE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph11"));
+
+ ((MorphRetained)this.retained).setAppearanceOverrideEnable(flag);
+ }
+
+ /**
+ * Retrieves the appearanceOverrideEnable flag for this node.
+ * @return true if the appearance can be overridden; false
+ * otherwise.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.2
+ */
+ public boolean getAppearanceOverrideEnable() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_APPEARANCE_OVERRIDE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph12"));
+
+ return ((MorphRetained)this.retained).getAppearanceOverrideEnable();
+ }
+
+ /**
+ * Creates a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ Morph m = new Morph();
+ m.duplicateNode(this, forceDuplicate);
+ return m;
+ }
+
+ /**
+ * Copies all node information from originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.
+ * NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ * @exception ClassCastException if originalNode is not an instance of
+ * Morph
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public void duplicateNode(Node originalNode, boolean forceDuplicate) {
+ checkDuplicateNode(originalNode, forceDuplicate);
+ }
+
+ /**
+ * Copies all Morph information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ MorphRetained attr = (MorphRetained) originalNode.retained;
+ MorphRetained rt = (MorphRetained) retained;
+
+ Hashtable hashtable = originalNode.nodeHashtable;
+
+ double weights[] = attr.getWeights();
+
+ rt.setCollisionBounds(attr.getCollisionBounds());
+ rt.setAppearance((Appearance) getNodeComponent(
+ attr.getAppearance(),
+ forceDuplicate,
+ hashtable));
+
+ GeometryArray ga[] = new GeometryArray[weights.length];
+
+ for (int i=weights.length-1; i>=0; i--) {
+ ga[i] = (GeometryArray) getNodeComponent(
+ attr.getGeometryArray(i),
+ forceDuplicate,
+ hashtable);
+ }
+ rt.setGeometryArrays(ga);
+ rt.setWeights(weights);
+ }
+
+ // Method to check whether all geometries have allow intersect
+ // capability bit set; it will throw an exception if any don't
+ // have the bit set.
+ private void checkForAllowIntersect() {
+ MorphRetained morphR = ((MorphRetained)this.retained);
+ int numGeometryArrays = morphR.getNumGeometryArrays();
+ for (int i = 0; i < numGeometryArrays; i++) {
+ if (!morphR.geometryArrays[i].source.
+ getCapability(Geometry.ALLOW_INTERSECT)) {
+
+ throw new CapabilityNotSetException(J3dI18N.getString("Morph6"));
+ }
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/MorphRetained.java b/j3d-core/src/classes/share/javax/media/j3d/MorphRetained.java
new file mode 100644
index 0000000..cbcff38
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/MorphRetained.java
@@ -0,0 +1,1959 @@
+/*
+ * $RCSfile: MorphRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.10 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+import java.util.Vector;
+
+/**
+ * A morph leaf node consisting of geometery and appearance properties.
+ */
+
+class MorphRetained extends LeafRetained implements GeometryUpdater {
+
+ // These bits should match the Shape3D bits ...(Since the mirrors for
+ // both are Shape3DRetained
+ static final int GEOMETRY_CHANGED = 0x00001;
+ static final int APPEARANCE_CHANGED = 0x00002;
+ static final int COLLISION_CHANGED = 0x00004;
+ static final int BOUNDS_CHANGED = 0x00008;
+ static final int APPEARANCEOVERRIDE_CHANGED = 0x00010;
+ static final int UPDATE_MORPH = 0x00020;
+
+ private static final double TOLERANCE = 1.0e-4;
+
+
+ /**
+ * The mirror Shape3DRetained nodes for this object. There is one
+ * mirror for each instance of this Shape3D node. If it is not in
+ * a SharedGroup, only index 0 is valid.
+ */
+ ArrayList mirrorShape3D = new ArrayList();
+
+
+ // Target threads to be notified when morph changes
+ final static int targetThreads = (J3dThread.UPDATE_RENDER |
+ J3dThread.UPDATE_GEOMETRY);
+
+ /**
+ * The appearance component of the morph node.
+ */
+ AppearanceRetained appearance = null;
+
+ /**
+ * The Geosets associated with the morph node.
+ */
+ GeometryArrayRetained geometryArrays[];
+
+ private int numGeometryArrays = 0;
+
+ /**
+ * The weight vector the morph node.
+ */
+ double weights[];
+
+ /**
+ * Reference to the BranchGroup path of this mirror shape
+ * This is used for picking only.
+ */
+ BranchGroupRetained branchGroupPath[];
+
+
+ // cache value for picking in mirror shape.
+ // True if all the node of the path from this to root are all pickable
+ boolean isPickable = true;
+
+
+ // cache value for collidable in mirror shape.
+ // True if all the node of the path from this to root are all collidable
+ boolean isCollidable = true;
+
+
+ // closest switch parent
+ SwitchRetained closestSwitchParent = null;
+
+ // the child index from the closest switch parent
+ int closestSwitchIndex = -1;
+
+ // Is this Morph visible ? The default is true.
+ boolean visible = true;
+
+ // geometry Bounds in local coordinate
+ Bounds bounds = null;
+
+ // geometry Bounds in virtual world coordinate
+ BoundingBox vwcBounds = new BoundingBox();
+
+ // collision Bound in local coordinate
+ Bounds collisionBound = null;
+
+ // collision Bounds in virtual world coordinate
+ Bounds collisionVwcBound = null;
+
+
+ GeometryArray morphedGeometryArray = null;
+
+ // Morph data
+ float[] Mcoord = null;
+ float[] Mcolor = null;
+ float[] Mnormal = null;
+ // First dimension is the coordSet, second dimenension is the vertex index
+ // each vertex has 2 or 3floats
+ float[][]MtexCoord = null;
+
+ // Whether the normal appearance is overrided by the alternate app
+ boolean appearanceOverrideEnable = false;
+
+ int changedFrequent = 0;
+
+
+ MorphRetained() {
+ this.nodeType = NodeRetained.MORPH;
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ ((BoundingBox)localBounds).setUpper(-1.0,-1.0,-1.0);
+ }
+
+ /**
+ * Sets the collision bounds of a node.
+ * @param bounds the bounding object for the node
+ */
+ void setCollisionBounds(Bounds bounds) {
+ if (bounds != null) {
+ collisionBound = (Bounds)bounds.clone();
+ } else {
+ collisionBound = null;
+ }
+ if (source.isLive()) {
+ // Notify Geometry Structure to set mirror shape collision
+ // bound and check for collision
+ J3dMessage message = new J3dMessage();
+ message.type = J3dMessage.COLLISION_BOUND_CHANGED;
+ message.threads = J3dThread.UPDATE_TRANSFORM;
+ message.universe = universe;
+ message.args[1] = collisionBound;
+ VirtualUniverse.mc.processMessage(message);
+ }
+ }
+
+ /**
+ * Sets the geometric bounds of a node.
+ * @param bounds the bounding object for the node
+ */
+ void setBounds(Bounds bounds) {
+ super.setBounds(bounds);
+ if (source.isLive() && !boundsAutoCompute) {
+ J3dMessage message = new J3dMessage();
+ message.type = J3dMessage.REGION_BOUND_CHANGED;
+ message.threads = J3dThread.UPDATE_TRANSFORM |
+ targetThreads;
+ message.universe = universe;
+ message.args[0] = Shape3DRetained.getGeomAtomsArray(mirrorShape3D);
+ message.args[1] = localBounds;
+ VirtualUniverse.mc.processMessage(message);
+ }
+ }
+
+ /**
+ * Gets the collision bounds of a node.
+ * @return the node's bounding object
+ */
+ Bounds getCollisionBounds() {
+ return (collisionBound == null? null : (Bounds)collisionBound.clone());
+ }
+
+ /**
+ * Sets the geometryArrays component of the Morph node.
+ * @param geometryArrays the new vector of geometryArrays for the morph node
+ */
+ void setGeometryArrays(GeometryArray geometryArrays[]) {
+ int i;
+
+ if ((geometryArrays == null || geometryArrays.length == 0) && numGeometryArrays == 0)
+ return;
+
+ GeometryArrayRetained geo, prevGeo;
+
+ if (numGeometryArrays != 0 && (geometryArrays == null || numGeometryArrays != geometryArrays.length))
+ throw new IllegalArgumentException(J3dI18N.getString("MorphRetained0"));
+
+
+ for (i=1;i < geometryArrays.length;i++) {
+ if (geometryArrays[i] == null || geometryArrays[i-1] == null)
+ throw new IllegalArgumentException(J3dI18N.getString("MorphRetained1"));
+ geo = (GeometryArrayRetained)geometryArrays[i].retained;
+ prevGeo = (GeometryArrayRetained)geometryArrays[i-1].retained;
+ if (prevGeo == null || geo == null) {
+ throw new IllegalArgumentException(J3dI18N.getString("MorphRetained1"));
+
+ }
+ doErrorCheck(prevGeo, geo);
+ }
+
+ // Check the first one for vertex attributes
+ geo = (GeometryArrayRetained)geometryArrays[0].retained;
+ if ((geo.vertexFormat & GeometryArray.VERTEX_ATTRIBUTES) != 0) {
+ throw new UnsupportedOperationException(J3dI18N.getString("MorphRetained9"));
+ }
+
+ // Check if the first one is in Immediate context
+ if (geometryArrays[0] != null) {
+ geo = (GeometryArrayRetained)geometryArrays[0].retained;
+ }
+
+ if (numGeometryArrays == 0) {
+ this.geometryArrays = new GeometryArrayRetained[geometryArrays.length];
+ numGeometryArrays = geometryArrays.length;
+ }
+
+ for (i=0;i < numGeometryArrays;i++) {
+ geo = (GeometryArrayRetained)geometryArrays[i].retained;
+ if (((Morph)this.source).isLive()) {
+ if (this.geometryArrays[i] != null) {
+ this.geometryArrays[i].clearLive(refCount);
+ this.geometryArrays[i].removeMorphUser(this);
+ }
+ if (geo != null) {
+ geo.setLive(inBackgroundGroup, refCount);
+ geo.addMorphUser(this);
+ }
+ }
+
+ this.geometryArrays[i] = geo;
+ }
+ if (this.geometryArrays[0] == null)
+ return;
+
+
+ if (weights == null) {
+ weights = new double[numGeometryArrays];
+ weights[0] = 1.0;
+ int vFormat = this.geometryArrays[0].vertexFormat;
+ // default is zero when new array
+ //for (i=1; i < numGeometryArrays;i++) weights[i] = 0.0;
+
+ int texCoordSetCount = this.geometryArrays[0].getTexCoordSetCount();
+ if (this.geometryArrays[0] instanceof IndexedGeometryArrayRetained) {
+ Mcoord = new float[this.geometryArrays[0].getNumCoordCount()* 3];
+
+ if ((vFormat & GeometryArray.COLOR_4) == GeometryArray.COLOR_3)
+ Mcolor = new float[this.geometryArrays[0].getNumColorCount()* 3];
+ else if ((vFormat & GeometryArray.COLOR_4) == GeometryArray.COLOR_4)
+ Mcolor = new float[this.geometryArrays[0].getNumColorCount()* 4];
+
+ MtexCoord = new float[texCoordSetCount][];
+ if ((vFormat & GeometryArray.NORMALS) != 0)
+ Mnormal = new float[this.geometryArrays[0].getNumNormalCount() *3];
+ for (int k = 0; k < texCoordSetCount; k++) {
+ if ((vFormat & GeometryArray.TEXTURE_COORDINATE_2) != 0)
+ MtexCoord[k] = new float[this.geometryArrays[0].getNumTexCoordCount(k) * 2];
+ else if (((vFormat & GeometryArray.TEXTURE_COORDINATE_3) != 0))
+ MtexCoord[k] = new float[this.geometryArrays[0].getNumTexCoordCount(k) * 3];
+ else if (((vFormat & GeometryArray.TEXTURE_COORDINATE_4) != 0))
+ MtexCoord[k] = new float[this.geometryArrays[0].getNumTexCoordCount(k) * 4];
+ }
+ }
+ else {
+ Mcoord = new float[this.geometryArrays[0].validVertexCount* 3];
+
+ if ((vFormat & GeometryArray.COLOR_4) == GeometryArray.COLOR_3) {
+ Mcolor = new float[this.geometryArrays[0].validVertexCount* 3];
+ } else if ((vFormat & GeometryArray.COLOR_4) == GeometryArray.COLOR_4) {
+ Mcolor = new float[this.geometryArrays[0].validVertexCount* 4];
+ }
+ MtexCoord = new float[texCoordSetCount][];
+ if ((vFormat & GeometryArray.NORMALS) != 0) {
+ Mnormal = new float[this.geometryArrays[0].validVertexCount *3];
+ }
+ for (int k = 0; k < texCoordSetCount; k++) {
+ if ((vFormat & GeometryArray.TEXTURE_COORDINATE_2) != 0)
+ MtexCoord[k] = new float[this.geometryArrays[0].validVertexCount * 2];
+ else if (((vFormat & GeometryArray.TEXTURE_COORDINATE_3) != 0))
+ MtexCoord[k] = new float[this.geometryArrays[0].validVertexCount * 3];
+ else if (((vFormat & GeometryArray.TEXTURE_COORDINATE_4) != 0))
+ MtexCoord[k] = new float[this.geometryArrays[0].validVertexCount * 4];
+ }
+ }
+ }
+
+ // create a new morphedGeometryArray
+ initMorphedGeometry();
+
+ if (source.isLive()) {
+
+ Shape3DRetained shape = (Shape3DRetained)mirrorShape3D.get(0);
+
+ shape.setMorphGeometry(morphedGeometryArray, mirrorShape3D);
+
+ J3dMessage mChangeMessage = null;
+ mChangeMessage = new J3dMessage();
+ mChangeMessage.type = J3dMessage.MORPH_CHANGED;
+ mChangeMessage.threads = (J3dThread.UPDATE_GEOMETRY |
+ J3dThread.UPDATE_TRANSFORM);
+ // If its a indexed geometry array, unindexify in renderBin
+ if (this.geometryArrays[0] instanceof IndexedGeometryArrayRetained)
+ mChangeMessage.threads |= J3dThread.UPDATE_RENDERING_ATTRIBUTES;
+ mChangeMessage.args[0] = this;
+ mChangeMessage.args[1]= new Integer(GEOMETRY_CHANGED);
+ // a shadow copy of this ArrayList instance. (The elements themselves are not copied.)
+ mChangeMessage.args[3] = Shape3DRetained.getGeomAtomsArray(mirrorShape3D);
+ mChangeMessage.universe = universe;
+ VirtualUniverse.mc.processMessage(mChangeMessage);
+
+ if (boundsAutoCompute) {
+ GeometryArrayRetained mga = (GeometryArrayRetained)morphedGeometryArray.retained;
+ // Compute the bounds once
+ mga.incrComputeGeoBounds();// This compute the bbox if dirty
+ mga.decrComputeGeoBounds();
+ }
+ }
+
+
+
+ }
+
+ /**
+ * Retrieves the geometryArrays component of this Morph node.
+ * @param index the index of GeometryArray to be returned
+ * @return the geometryArray component of this morph node
+ */
+ GeometryArray getGeometryArray(int index) {
+ return (GeometryArray)this.geometryArrays[index].source;
+ }
+
+ /**
+ * Sets the appearance component of this Morph node.
+ * @param appearance the new apearance component for this morph node
+ */
+ void setAppearance(Appearance newAppearance) {
+ boolean visibleIsDirty = false;
+
+ if (((Morph)this.source).isLive()) {
+
+ if (appearance != null) {
+ this.appearance.clearLive(refCount);
+ for (int i=mirrorShape3D.size()-1; i>=0; i--) {
+ this.appearance.removeAMirrorUser(
+ (Shape3DRetained)mirrorShape3D.get(i));
+ }
+ }
+
+ if (newAppearance != null) {
+ ((AppearanceRetained)newAppearance.retained).setLive(inBackgroundGroup, refCount);
+ appearance = ((AppearanceRetained)newAppearance.retained);
+ int size= mirrorShape3D.size();
+ for (int i=0; irewind on that view,
+ * such that elements 0 through dataBuffer.limit()-1
+ * will be available internally. The number of elements in
+ * the buffer must be exactly width*height*numElementsPerPixel,
+ * where numElementsPerPixel is
+ * 3 for TYPE_3BYTE_BGR and TYPE_3BYTE_RGB,
+ * 4 for TYPE_4BYTE_ABGR and TYPE_4BYTE_RGBA,
+ * and 1 for all other types.
+ *
+ * @exception IllegalArgumentException if width < 1 or height < 1
+ * @exception NullPointerException if imageType or dataBuffer is null
+ * @exception IllegalArgumentException if the type of the dataBuffer does
+ * not match the imageType
+ * @exception IllegalArgumentException if dataBuffer.limit() !=
+ * width*height*numElementsPerPixel
+ * @exception IllegalArgumentException if the byte order of the specified
+ * dataBuffer does not match the native byte order of the underlying
+ * platform.
+ */
+ public NioImageBuffer(int width, int height, ImageType imageType,
+ Buffer dataBuffer) {
+
+ processParams(width, height, imageType);
+ setDataBuffer(dataBuffer);
+ }
+
+ /**
+ * Gets the width of this data buffer.
+ *
+ * @return the width of this data buffer.
+ */
+ public int getWidth() {
+ return width;
+ }
+
+ /**
+ * Gets the height of this data buffer.
+ *
+ * @return the width of this data buffer.
+ */
+ public int getHeight() {
+ return height;
+ }
+
+ /**
+ * Gets the image type of this data buffer.
+ *
+ * @return the image type of this data buffer.
+ */
+ public ImageType getImageType() {
+ return imageType;
+ }
+
+ /**
+ * Sets the data buffer to the specified input data buffer.
+ * The the byte order of the specified dataBuffer must match the native
+ * byte order of the underlying platform.
+ * For best performance, the NIO buffer should be a direct buffer.
+ *
+ * @param dataBuffer an NIO buffer of the correct type (ByteBuffer or
+ * IntBuffer) to match the imageType of this
+ * NioImageBuffer. This method will create a new view of
+ * the buffer, and will call rewind on that view,
+ * such that elements 0 through dataBuffer.limit()-1
+ * will be available internally. The number of elements in
+ * the buffer must be exactly width*height*numElementsPerPixel,
+ * where numElementsPerPixel is
+ * 3 for TYPE_3BYTE_BGR and TYPE_3BYTE_RGB,
+ * 4 for TYPE_4BYTE_ABGR and TYPE_4BYTE_RGBA,
+ * and 1 for all other types.
+ *
+ * @exception NullPointerException if dataBuffer is null
+ * @exception IllegalArgumentException if the type of the dataBuffer does
+ * not match the imageType
+ * @exception IllegalArgumentException if dataBuffer.limit() !=
+ * width*height*numElementsPerPixel
+ * @exception IllegalArgumentException if the byte order of the specified
+ * dataBuffer does not match the native byte order of the underlying
+ * platform.
+ */
+ public void setDataBuffer(Buffer dataBuffer) {
+ if (dataBuffer == null) {
+ throw new NullPointerException();
+ }
+
+ if (dataBuffer.limit() != width*height*elementsPerPixel) {
+ throw new IllegalArgumentException(J3dI18N.getString("NioImageBuffer3"));
+ }
+
+ switch (bufferType) {
+ case BYTE_BUFFER:
+ if (!(dataBuffer instanceof ByteBuffer)) {
+ throw new IllegalArgumentException(J3dI18N.getString("NioImageBuffer4"));
+ }
+ buffer = ((ByteBuffer)dataBuffer).duplicate().rewind();
+ break;
+
+ case INT_BUFFER:
+ if (!(dataBuffer instanceof IntBuffer)) {
+ throw new IllegalArgumentException(J3dI18N.getString("NioImageBuffer4"));
+ }
+
+ if (((IntBuffer)dataBuffer).order() != ByteOrder.nativeOrder()) {
+ throw new IllegalArgumentException(J3dI18N.getString("NioImageBuffer5"));
+ }
+ buffer = ((IntBuffer)dataBuffer).duplicate().rewind();
+ break;
+
+ default:
+ // We should never get here
+ throw new AssertionError("missing case statement");
+ }
+ }
+
+ /**
+ * Gets the data buffer to the specified input data buffer.
+ *
+ * @return a view of the current data buffer for this NIO image buffer.
+ * This view will be rewound such that elements 0
+ * through dataBuffer.limit()-1 are available.
+ */
+ public Buffer getDataBuffer() {
+ Buffer tmpBuffer = null;
+
+ switch (bufferType) {
+ case BYTE_BUFFER:
+ tmpBuffer = ((ByteBuffer)buffer).duplicate();
+ break;
+
+ case INT_BUFFER:
+ tmpBuffer = ((IntBuffer)buffer).duplicate();
+ break;
+
+ default:
+ // We should never get here
+ throw new AssertionError("missing case statement");
+ }
+
+ return tmpBuffer.rewind();
+ }
+
+
+ // Sanity check the input parameters, calculate the buffer type and
+ // the number of bytes per pixel
+ private void processParams(int width, int height, ImageType imageType) {
+ if (width < 1) {
+ throw new IllegalArgumentException(J3dI18N.getString("NioImageBuffer0"));
+ }
+
+ if (height < 1) {
+ throw new IllegalArgumentException(J3dI18N.getString("NioImageBuffer1"));
+ }
+
+ switch (imageType) {
+ case TYPE_3BYTE_BGR:
+ bufferType = BufferType.BYTE_BUFFER;
+ bytesPerPixel = 3;
+ elementsPerPixel = 3;
+ break;
+
+ case TYPE_3BYTE_RGB:
+ bufferType = BufferType.BYTE_BUFFER;
+ bytesPerPixel = 3;
+ elementsPerPixel = 3;
+ break;
+
+ case TYPE_4BYTE_ABGR:
+ bufferType = BufferType.BYTE_BUFFER;
+ bytesPerPixel = 4;
+ elementsPerPixel = 4;
+ break;
+
+ case TYPE_4BYTE_RGBA:
+ bufferType = BufferType.BYTE_BUFFER;
+ bytesPerPixel = 4;
+ elementsPerPixel = 4;
+ break;
+
+ case TYPE_BYTE_GRAY:
+ bufferType = BufferType.BYTE_BUFFER;
+ bytesPerPixel = 1;
+ elementsPerPixel = 1;
+ break;
+
+ case TYPE_INT_ARGB:
+ case TYPE_INT_BGR:
+ case TYPE_INT_RGB:
+ bufferType = BufferType.INT_BUFFER;
+ bytesPerPixel = 4;
+ elementsPerPixel = 1;
+ break;
+
+ default:
+ // We should never get here
+ throw new AssertionError("missing case statement");
+ }
+
+ this.width = width;
+ this.height = height;
+ this.imageType = imageType;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NnuId.java b/j3d-core/src/classes/share/javax/media/j3d/NnuId.java
new file mode 100644
index 0000000..7321a41
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NnuId.java
@@ -0,0 +1,44 @@
+/*
+ * $RCSfile: NnuId.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * Defines a "not necessarily unique ID"
+ */
+
+interface NnuId {
+
+ abstract int equal(NnuId obj);
+
+ abstract int getId();
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NnuIdManager.java b/j3d-core/src/classes/share/javax/media/j3d/NnuIdManager.java
new file mode 100644
index 0000000..40211b0
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NnuIdManager.java
@@ -0,0 +1,352 @@
+/*
+ * $RCSfile: NnuIdManager.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+class NnuIdManager {
+ static int nnuId = 0;
+
+ final static int getId() {
+ if(nnuId == Integer.MAX_VALUE) {
+ nnuId = 0;
+ }
+
+ return nnuId++;
+ }
+
+ final static int equals(NnuId nnuIdArr[], NnuId key, int start, int end) {
+ int mid;
+
+ mid = start +((end - start)/ 2);
+ if(nnuIdArr[mid] != null) {
+ int test = key.equal(nnuIdArr[mid]);
+
+ if((test < 0) && (start != mid))
+ return equals(nnuIdArr, key, start, mid);
+ else if((test > 0) && (start != mid))
+ return equals(nnuIdArr, key, mid, end);
+ else if(test == 0) {
+ // Since id is not necessary unique, we've to do
+ // some extra check.
+
+ // check for equal reference.
+ if(key == nnuIdArr[mid]) {
+ return mid;
+ }
+
+ int temp = mid - 1;
+ // Look to the left.
+ while((temp >= start) && (key.equal(nnuIdArr[temp]) == 0)) {
+ if(key == nnuIdArr[temp]) {
+ return temp;
+ }
+ temp--;
+ }
+
+ // Look to the right.
+ temp = mid + 1;
+ while((temp < end) && (key.equal(nnuIdArr[temp]) == 0)) {
+ if(key == nnuIdArr[temp]) {
+ return temp;
+ }
+ temp++;
+ }
+
+ // Fail equal reference check.
+ return -1;
+ }
+ else
+ return -1;
+ }
+ // A null NnuId object encountered.
+ return -2;
+ }
+
+ final static boolean equals(NnuId nnuIdArr[], NnuId key, int[] index,
+ int start, int end) {
+
+ int mid;
+
+ mid = start +((end - start)/ 2);
+
+ if(nnuIdArr[mid] != null) {
+ int test = key.equal(nnuIdArr[mid]);
+
+ if(start != mid) {
+ if(test < 0) {
+ return equals(nnuIdArr, key, index, start, mid);
+ }
+ else if(test > 0) {
+ return equals(nnuIdArr, key, index, mid, end);
+ }
+ }
+ else { // (start == mid)
+ if(test < 0) {
+ index[0] = mid;
+ return false;
+ }
+ else if(test > 0) {
+ index[0] = mid+1;
+ return false;
+ }
+ }
+
+ // (test == 0)
+ // Since id is not necessary unique, we've to do
+ // some extra check.
+
+ // check for equal reference.
+ if(key == nnuIdArr[mid]) {
+ index[0] = mid;
+ return true;
+ }
+
+ int temp = mid - 1;
+ // Look to the left.
+ while((temp >= start) && (key.equal(nnuIdArr[temp]) == 0)) {
+ if(key == nnuIdArr[temp]) {
+ index[0] = temp;
+ return true;
+ }
+ temp--;
+ }
+
+ // Look to the right.
+ temp = mid + 1;
+ while((temp < end) && (key.equal(nnuIdArr[temp]) == 0)) {
+ if(key == nnuIdArr[temp]) {
+ index[0] = temp;
+ return true;
+ }
+ temp++;
+ }
+
+ // Fail equal reference check.
+ index[0] = temp;
+ return false;
+
+ }
+ // A null entry encountered.
+ // But we still want to return the index where we encounter it.
+ index[0] = mid;
+ return false;
+ }
+
+ final static void sort(NnuId nnuIdArr[]) {
+ if (nnuIdArr.length < 20) {
+ insertSort(nnuIdArr);
+ } else {
+ quicksort(nnuIdArr, 0, nnuIdArr.length-1);
+ }
+ }
+
+ // Insertion sort on smaller array
+ final static void insertSort(NnuId nnuIdArr[]) {
+
+
+ for (int i=0; i
+ * pickable : true
+ */
+ public Node() {
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+ /**
+
+ * @return the parent of this node, or null if this node has no parent
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public Node getParent() {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_PARENT_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Node0"));
+ }
+ }
+
+ NodeRetained nr = ((NodeRetained)this.retained).getParent();
+ return (nr == null ? null : (Node) nr.getSource());
+ }
+
+ /**
+ * Sets the geometric bounds of a node.
+ * @param bounds the bounding object for a node
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setBounds(Bounds bounds) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node1"));
+
+ ((NodeRetained)this.retained).setBounds(bounds);
+ }
+
+ /**
+ * Returns the bounding object of a node.
+ * @return the node's bounding object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ */
+ public Bounds getBounds() {
+
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_BOUNDS_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Node2"));
+ }
+ }
+ else {
+ // this will throw a SceneGraphCycleException if there is
+ // a cycle
+ checkForCycle();
+ }
+
+ return ((NodeRetained)this.retained).getBounds();
+ }
+
+ /**
+ * Returns the collidable value; this value determines whether this node
+ * and it's children, if a group node, can be considered for collision
+ * purposes; if it is set to false, then neither this node nor any
+ * children nodes will be traversed for collision purposes; the default
+ * value is true. The collidable setting is the way that an
+ * application can perform collision culling.
+ * @return the present collidable value for this node
+ */
+ public boolean getCollidable() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLLIDABLE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node16"));
+
+ return ((NodeRetained)retained).getCollidable();
+ }
+
+ /**
+ * Sets the collidable value; determines whether this node and any of its
+ * children, if a group node, can be considered for collision purposes.
+ * @param collidable the new collidable value for this node
+ */
+ public void setCollidable( boolean collidable ) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_COLLIDABLE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node4"));
+
+ ((NodeRetained)retained).setCollidable(collidable);
+ }
+
+ /**
+ * Turns the automatic calcuation of geometric bounds of a node on/off.
+ * @param autoCompute indicates if the node's bounding object is
+ * automatically computed.
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setBoundsAutoCompute(boolean autoCompute) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_AUTO_COMPUTE_BOUNDS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node5"));
+
+ ((NodeRetained)this.retained).setBoundsAutoCompute(autoCompute);
+ }
+
+ /**
+ * Gets the value indicating if the automatic calcuation of geometric bounds of a node is on/off.
+ * @return the node's auto compute flag for the geometric bounding object
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public boolean getBoundsAutoCompute() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_AUTO_COMPUTE_BOUNDS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node6"));
+
+ return ((NodeRetained)this.retained).getBoundsAutoCompute();
+ }
+
+ /**
+ * Retrieves the local coordinates to virtual world coordinates
+ * transform for this node in the scene graph. This is the composite
+ * of all transforms in the scene graph from the root down to
+ *
+ * collidable : true
+ * bounds auto compute : true
+ * bounds : N/A (automatically computed)
+ * this node. It is only valid
+ * for nodes that are part of a live scene graph.
+ * If the node is not part of a live scene graph then the coordinates are
+ * calculated as if the graph was attached at the origin of a locale.
+ * @param t the object that will receive the local coordinates to
+ * Vworld coordinates transform.
+ * @exception RestrictedAccessException if the node is compiled but not
+ * part of a live scene graph
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this node is part of live or compiled scene graph
+ * @exception IllegalSharingException if the node is a descendant
+ * of a SharedGroup node.
+ */
+ public void getLocalToVworld(Transform3D t) {
+ if (isLiveOrCompiled()) {
+ if(!this.getCapability(ALLOW_LOCAL_TO_VWORLD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node8"));
+ }
+
+ if (!isLive()) {
+ // TODO Support compiled graphs
+ if (isCompiled())
+ throw new RestrictedAccessException(J3dI18N.getString("Node7"));
+
+ // In 1.4 we support getLocalToVworld for non live nodes
+ ((NodeRetained)this.retained).computeNonLiveLocalToVworld(t, this);
+ //throw new RestrictedAccessException(J3dI18N.getString("Node7"));
+ } else {
+ ((NodeRetained)this.retained).getLocalToVworld(t);
+ }
+ }
+
+
+ /**
+ * Retrieves the local coordinates to virtual world coordinates
+ * transform for the particular path in the scene graph ending with
+ * this node. This is the composite
+ * of all transforms in the scene graph from the root down to
+ * this node via the specified Link nodes. It is
+ * only valid for nodes that are part of a live scene graph.
+ * @param path the specific path from the node to the Locale
+ * @param t the object that will receive the local coordinates to
+ * Vworld coordinates transform.
+ * @exception RestrictedAccessException if the node is not
+ * part of a live scene graph
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this node is part of live scene graph
+ * @exception IllegalArgumentException if the specified path does
+ * not contain a valid Locale, or if the last node in the path is
+ * different from this node
+ * @exception IllegalSharingException if the node is not a descendant
+ * of a SharedGroup node.
+ */
+ public void getLocalToVworld(SceneGraphPath path, Transform3D t) {
+ if (!isLive()) {
+ throw new RestrictedAccessException(J3dI18N.getString("Node7"));
+ }
+
+ if(!this.getCapability(ALLOW_LOCAL_TO_VWORLD_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node8"));
+
+ ((NodeRetained)this.retained).getLocalToVworld(path,t);
+
+ }
+
+ /**
+ * Retrieves the locale to which this node is attached. If the
+ * node is not part of a live scene graph, null is returned.
+ *
+ * @return the locale to which this node is attached.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this node is part of live scene graph
+ * @exception IllegalSharingException if the node is a descendant
+ * of a SharedGroup node.
+ *
+ * @since Java 3D 1.4
+ */
+ public Locale getLocale() {
+ if (!isLive()) {
+ return null;
+ }
+
+ if(!this.getCapability(ALLOW_LOCALE_READ)) {
+ throw new CapabilityNotSetException(J3dI18N.getString("Node17"));
+ }
+
+ return ((NodeRetained)this.retained).getLocale();
+ }
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode
+ * and then cloneTree
+ * is called for each child node. For Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ * @return a reference to the cloned sub-graph.
+ * @exception DanglingReferenceException When a dangling reference is
+ * discovered during the cloneTree operation.
+ * @exception RestrictedAccessException if this object is part of live
+ * or compiled scene graph
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneTree() {
+ return cloneTree(new NodeReferenceTable(), false, false);
+ }
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode
+ * and then cloneTree is called for each child node.
+ * For Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree determines whether data is
+ * duplicated or copied.
+ * @return a reference to the cloned scene graph.
+ * @exception DanglingReferenceException When a dangling reference is
+ * discovered during the cloneTree operation.
+ * @exception RestrictedAccessException if this object is part of live
+ * or compiled scene graph
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneTree(boolean forceDuplicate) {
+ return cloneTree(new NodeReferenceTable(), forceDuplicate, false);
+ }
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode and
+ * then cloneTree is called for each child node. For
+ * Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ *
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree
+ * flag to be ignored. When false, the value of each node's
+ * duplicateOnCloneTree determines whether data is
+ * duplicated or copied.
+ *
+ * @param allowDanglingReferences when set to true allows
+ * the cloneTree
+ * method to complete even whan a dangling reference is discovered. When
+ * this parameter is false a
+ * DanglingReferenceException is generated as
+ * soon as cloneTree detects this situation.
+ *
+ * @return a reference to the cloned scene graph.
+ *
+ * @exception DanglingReferenceException When a dangling reference is
+ * discovered during the cloneTree operation and the
+ * allowDanglingReference parameter is false.
+ * @exception RestrictedAccessException if this object is part of live
+ * or compiled scene graph
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ *
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneTree(boolean forceDuplicate,
+ boolean allowDanglingReferences) {
+ return cloneTree(new NodeReferenceTable(),
+ forceDuplicate, allowDanglingReferences);
+ }
+
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode
+ * and then cloneTree
+ * is called for each child node. For Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ * @param referenceTable table that stores the mapping between
+ * original and cloned nodes. All previous values in the
+ * referenceTable will be cleared before the clone is made.
+ * @return a reference to the cloned sub-graph.
+ * @exception DanglingReferenceException When a dangling reference is
+ * discovered during the cloneTree operation.
+ * @exception RestrictedAccessException if this object is part of live
+ * or compiled scene graph
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ * @see NodeComponent#setDuplicateOnCloneTree
+ * @since Java 3D 1.2
+ */
+ public Node cloneTree(NodeReferenceTable referenceTable) {
+ return cloneTree(referenceTable, false, false);
+ }
+
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode
+ * and then cloneTree is called for each child node.
+ * For Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ * @param referenceTable table that stores the mapping between
+ * original and cloned nodes. All previous values in the
+ * referenceTable will be cleared before the clone is made.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree determines whether data is
+ * duplicated or copied.
+ * @return a reference to the cloned scene graph.
+ * @exception DanglingReferenceException When a dangling reference is
+ * discovered during the cloneTree operation.
+ * @exception RestrictedAccessException if this object is part of live
+ * or compiled scene graph
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ * @see NodeComponent#setDuplicateOnCloneTree
+ * @since Java 3D 1.2
+ */
+ public Node cloneTree(NodeReferenceTable referenceTable,
+ boolean forceDuplicate) {
+ return cloneTree(referenceTable, forceDuplicate, false);
+ }
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode
+ * and then cloneTree is called for each child node.
+ * For Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ * @param referenceTable table that stores the mapping between
+ * original and cloned nodes. All previous values in the
+ * referenceTable will be cleared before the clone is made.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree determines whether data is
+ * duplicated or copied.
+ *
+ * @param allowDanglingReferences when set to true allows
+ * the cloneTree
+ * method to complete even whan a dangling reference is discovered. When
+ * this parameter is false a
+ * DanglingReferenceException is generated as
+ * soon as cloneTree detects this situation.
+ *
+ * @return a reference to the cloned scene graph.
+ * @exception DanglingReferenceException When a dangling reference is
+ * discovered during the cloneTree operation.
+ * @exception RestrictedAccessException if this object is part of live
+ * or compiled scene graph
+ * @exception SceneGraphCycleException if there is a cycle in the
+ * scene graph
+ * @see NodeComponent#setDuplicateOnCloneTree
+ * @since Java 3D 1.2
+ */
+ public Node cloneTree(NodeReferenceTable referenceTable,
+ boolean forceDuplicate,
+ boolean allowDanglingReferences) {
+
+ if (!isLiveOrCompiled()) {
+ // this will throw a SceneGraphCycleException if there is
+ // a cycle
+ checkForCycle();
+ }
+
+ referenceTable.set(allowDanglingReferences, new Hashtable());
+ Node n = cloneTree(forceDuplicate, referenceTable.objectHashtable);
+
+ // go through hash table looking for Leaf nodes.
+ // call updateNodeReferences for each.
+ Enumeration e = referenceTable.objectHashtable.elements();
+
+ while (e.hasMoreElements()) {
+ SceneGraphObject o = (SceneGraphObject) e.nextElement();
+ o.updateNodeReferences(referenceTable);
+ }
+ return n;
+ }
+
+ /**
+ * Duplicates all the nodes of the specified sub-graph. For Group Nodes
+ * the group node is duplicated via a call to cloneNode and
+ * then cloneTree is called for each child node. For
+ * Leaf Nodes, component
+ * data can either be duplicated or be made a reference to the original
+ * data. Leaf Node cloneTree behavior is determined by the
+ * duplicateOnCloneTree flag found in every Leaf Node's
+ * component data class and by the forceDuplicate paramter.
+ *
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree
+ * flag to be ignored. When false, the value of each node's
+ * duplicateOnCloneTree determines whether data is
+ * duplicated or copied.
+ *
+ * @param nodeHashtable a hashtable used to map orignal node references to
+ * their cloned counterpart.
+ *
+ * @return a reference to the cloned scene graph.
+ *
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ Node cloneTree(boolean forceDuplicate, Hashtable nodeHashtable) {
+ Node l;
+ this.nodeHashtable = nodeHashtable;
+ try {
+ l = cloneNode(forceDuplicate);
+ } catch (RuntimeException e) {
+ this.nodeHashtable = null;
+ throw e;
+ }
+ // must reset to null so that we can tell whether the call is from user
+ // or cloneTree
+ this.nodeHashtable = null;
+ nodeHashtable.put(this, l);
+ return l;
+ }
+
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by cloneTree to duplicate the current node.
+ * cloneNode should be overridden by any user subclassed
+ * objects. All subclasses must have their cloneNode
+ * method consist of the following lines:
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneTree method.
+ *
+ * @param forceDuplicate when set to
+ * public Node cloneNode(boolean forceDuplicate) {
+ * UserSubClass usc = new UserSubClass();
+ * usc.duplicateNode(this, forceDuplicate);
+ * return usc;
+ * }
+ * true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of live
+ * or compiled scene graph
+ *
+ * @see Node#cloneTree
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ throw new RuntimeException(J3dI18N.getString("Node12"));
+ }
+
+
+ /**
+ * Copies all node information from originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.
+ * NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Group#cloneNode
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public void duplicateNode(Node originalNode,
+ boolean forceDuplicate) {
+ duplicateAttributes(originalNode, forceDuplicate);
+ }
+
+ /**
+ * Copies all node information from originalNode into
+ * the current node. This method is called from subclass of
+ * duplicateNode method which is, in turn, called by the
+ * cloneNode method.
+ * duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Group#cloneNode
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ final void checkDuplicateNode(Node originalNode,
+ boolean forceDuplicate) {
+ if (originalNode.nodeHashtable != null) {
+ duplicateAttributes(originalNode, forceDuplicate);
+ } else {
+ // user call cloneNode() or duplicateNode() directly
+ // instead of via cloneTree()
+ originalNode.nodeHashtable = new Hashtable();
+ duplicateAttributes(originalNode, forceDuplicate);
+ originalNode.nodeHashtable = null;
+ }
+ }
+
+
+ /**
+ * Copies all Node information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if originalNode object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+
+ if (originalNode.isLiveOrCompiled()) {
+ throw new RestrictedAccessException(J3dI18N.getString("Node13"));
+ }
+ super.duplicateSceneGraphObject(originalNode);
+ NodeRetained attr = (NodeRetained) originalNode.retained;
+ NodeRetained rt = (NodeRetained) retained;
+
+ rt.setPickable(attr.getPickable());
+ rt.setCollidable(attr.getCollidable());
+ }
+
+
+ /**
+ * When set to true this Node can be Picked.
+ * Setting to false indicates that this node and it's children
+ * are ALL unpickable.
+ *
+ * @param pickable Indicates if this node should be pickable or not
+ */
+ public void setPickable( boolean pickable ) {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_PICKABLE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node14"));
+
+ ((NodeRetained)retained).setPickable(pickable);
+ }
+
+ /**
+ * Returns true if this Node is pickable,
+ * false if it is not pickable.
+ */
+ public boolean getPickable() {
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_PICKABLE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("Node3"));
+
+ return ((NodeRetained)retained).getPickable();
+ }
+
+ /**
+ * checks for cycles in the scene graph
+ */
+ void checkForCycle() {
+ if (visited) {
+ throw new SceneGraphCycleException(J3dI18N.getString("Node15"));
+ }
+ visited = true;
+ Node parent = getParent();
+ if (parent != null) {
+ parent.checkForCycle();
+ }
+ visited = false;
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NodeComponent.java b/j3d-core/src/classes/share/javax/media/j3d/NodeComponent.java
new file mode 100644
index 0000000..90c572a
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NodeComponent.java
@@ -0,0 +1,312 @@
+/*
+ * $RCSfile: NodeComponent.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+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.
+ *
+ *
+ * duplicate on clone tree : false
+ */
+ public NodeComponent() {
+ }
+
+ /**
+ * Sets this node's duplicateOnCloneTree value. The
+ * duplicateOnCloneTree value is used to determine if NodeComponent
+ * objects are to be duplicated or referenced during a
+ *
+ * cloneTree operation. A value of true means
+ * that this NodeComponent object should be duplicated, while a value
+ * of false indicates that this NodeComponent object's
+ * reference will be copied into the newly cloned object. This value
+ * can be overriden via the forceDuplicate parameter of
+ * the cloneTree 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
+ * duplicateOnCloneTree value is used to determine if NodeComponent
+ * objects are to be duplicated or referenced during a
+ * cloneTree operation. A value of true means
+ * that this NodeComponent object should be duplicated, while a value
+ * of false indicates that this NodeComponent object's
+ * reference will be copied into the newly cloned object. This value
+ * can be overriden via the forceDuplicate parameter of
+ * the cloneTree 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
+ * cloneNodeComponent(boolean forceDuplicate)
+ */
+ public NodeComponent cloneNodeComponent() {
+ throw new RuntimeException(J3dI18N.getString("NodeComponent0"));
+ }
+
+
+ /**
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @deprecated As of Java 3D version 1.2, replaced by
+ * duplicateNodeComponent(NodeComponent
+ * originalNodeComponent, boolean forceDuplicate)
+ */
+ public void duplicateNodeComponent(NodeComponent originalNodeComponent) {
+ duplicateAttributes(originalNodeComponent,
+ originalNodeComponent.forceDuplicate);
+ }
+
+ /**
+ * Copies all node information from originalNodeComponent into
+ * the current node component. This method is called from subclass of
+ * duplicateNodeComponent method which is, in turn, called by the
+ * cloneNodeComponent method.
+ *
+ * For any NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ * @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 originalNodeComponent
+ * into the current node. This method is called from the
+ * cloneNodeComponent method which is, in turn, called
+ * by the cloneNode method.
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @param originalNodeComponent the node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree 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 cloneNode to duplicate the
+ * current node.
+ *
+ * cloneNodeComponent should be overridden by any user
+ * subclassed NodeComponent objects. All subclasses must have their
+ * cloneNodeComponent
+ * method consist of the following lines:
+ *
+ *
+ * @param forceDuplicate when set to
+ * public NodeComponent cloneNodeComponent(boolean forceDuplicate) {
+ * UserNodeComponent unc = new UserNodeComponent();
+ * unc.duplicateNodeComponent(this, forceDuplicate);
+ * return unc;
+ * }
+ * true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree 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
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree 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.
+ */
+ 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"));
+ }
+ }
+ }
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NodeComponentRetained.java b/j3d-core/src/classes/share/javax/media/j3d/NodeComponentRetained.java
new file mode 100644
index 0000000..b07e35d
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NodeComponentRetained.java
@@ -0,0 +1,252 @@
+/*
+ * $RCSfile: NodeComponentRetained.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.ArrayList;
+
+/**
+ * Retained version of NodeComponent
+ */
+
+class NodeComponentRetained extends SceneGraphObjectRetained {
+
+ // duplicate or make a reference when cloneTree() is called
+ // on this object.
+ boolean duplicateOnCloneTree = false;
+
+ // This keeps track of how many times this NodeComponent is referenced in
+ // the Scene Graph
+ int refCount = 0; // this is used in setLive
+ int refCnt = 0; // this is used in compile
+
+ // This is true when this appearance is referenced in an immediate mode context
+ private boolean inImmCtx = false;
+
+ // A list of NodeRetained Objects that refer, directly or indirectly, to this
+ // NodeComponentRetained
+ ArrayList users = new ArrayList(1);
+
+ // Mirror object of this node compoenent object
+ NodeComponentRetained mirror = null;
+
+ // Sole User FrequencyBit
+ // In the case of Appearance, its a bitmask of all components
+ int changedFrequent = 0;
+ int compChanged = 0;
+
+ // Increment the refcount. If this is the first, mark it as live.
+ void doSetLive(boolean inBackgroundGroup, int refCount) {
+ int oldRefCount = this.refCount;
+ this.refCount += refCount;
+ if (oldRefCount <= 0) {
+ super.doSetLive(inBackgroundGroup);
+
+ // Create and init a mirror object if not already there
+ // The two procedures is combined since it is redunctant to
+ // call initMirrorObject() if mirror == this (static object).
+ createMirrorObject();
+ }
+ }
+
+ void setLive(boolean inBackgroundGroup, int refCount) {
+ int oldRefCount = this.refCount;
+ doSetLive(inBackgroundGroup, refCount);
+ if (oldRefCount <= 0) {
+ super.markAsLive();
+ }
+ }
+
+
+
+ // Decrement the refcount. If this is the last, mark it as not live.
+ void clearLive(int refCount) {
+ this.refCount -= refCount;
+
+ if (this.refCount <= 0) {
+ super.clearLive();
+ }
+ }
+
+ // increment the compile reference count
+ synchronized void incRefCnt() {
+ refCnt++;
+ }
+
+ // decrement the compile reference count
+ synchronized void decRefCnt() {
+ refCnt--;
+ }
+
+ // remove mirror shape from the list of users
+ void removeAMirrorUser(Shape3DRetained ms) {
+ synchronized(mirror.users) {
+ mirror.users.remove(ms);
+ }
+ }
+
+ // Add a mirror shape to the list of users
+ void addAMirrorUser(Shape3DRetained ms) {
+ synchronized(mirror.users) {
+ mirror.users.add(ms);
+ }
+ }
+
+ // Copy the list of useres passed in into this
+ void copyMirrorUsers(NodeComponentRetained node) {
+ synchronized(mirror.users) {
+ synchronized(node.mirror.users) {
+ int size = node.mirror.users.size();
+ for (int i=0; icloneTree operation. A value of true means
+ * that this NodeComponent object should be duplicated, while a value
+ * of false indicates that this NodeComponent object's
+ * reference will be copied into the newly cloned object. This value
+ * can be overriden via the forceDuplicate parameter of
+ * the cloneTree method.
+ * @param duplicate the value to set.
+ * @see Node#cloneTree
+ */
+ void setDuplicateOnCloneTree(boolean duplicate) {
+ duplicateOnCloneTree = duplicate;
+ }
+
+ /**
+ * Returns this node's duplicateOnCloneTree value. The
+ * duplicateOnCloneTree value is used to determine if NodeComponent
+ * objects are to be duplicated or referenced during a
+ * cloneTree operation. A value of true means
+ * that this NodeComponent object should be duplicated, while a value
+ * of false indicates that this NodeComponent object's
+ * reference will be copied into the newly cloned object. This value
+ * can be overriden via the forceDuplicate parameter of
+ * the cloneTree method.
+ * @return the value of this node's duplicateOnCloneTree
+ * @see Node#cloneTree
+ */
+ boolean getDuplicateOnCloneTree() {
+ return duplicateOnCloneTree;
+ }
+
+
+ void initMirrorObject() {
+ }
+
+ void updateMirrorObject(int component, Object obj) {
+ }
+
+ void createMirrorObject() {
+ // Overridden by appearance and other classes
+ initMirrorObject();
+ mirror = null;
+ }
+
+ void setFrequencyChangeMask(int bit, int mask) {
+ if (source.getCapabilityIsFrequent(bit))
+ changedFrequent |= mask;
+ else if (!source.isLive()) {
+ // Record the freq->infreq change only for non-live node components
+ changedFrequent &= ~mask;
+ }
+ }
+
+ protected Object clone() {
+ NodeComponentRetained ncr = (NodeComponentRetained)super.clone();
+ ncr.changedFrequent = changedFrequent;
+ return ncr;
+ }
+
+ protected void set(NodeComponentRetained nc) {
+ changedFrequent = nc.changedFrequent;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NodeComponentUpdate.java b/j3d-core/src/classes/share/javax/media/j3d/NodeComponentUpdate.java
new file mode 100644
index 0000000..21ecafe
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NodeComponentUpdate.java
@@ -0,0 +1,45 @@
+/*
+ * $RCSfile: NodeComponentUpdate.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * A Node Component Update interface. Any object that can be put in the
+ * node component updateCheck list must implement this interface.
+ */
+
+interface NodeComponentUpdate {
+
+ /**
+ * The actual update function.
+ */
+ abstract void updateNodeComponentCheck();
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NodeData.java b/j3d-core/src/classes/share/javax/media/j3d/NodeData.java
new file mode 100644
index 0000000..277a9a0
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NodeData.java
@@ -0,0 +1,40 @@
+/*
+ * $RCSfile: NodeData.java,v $
+ *
+ * Copyright 2001-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+class NodeData {
+ // per path node data
+ // XXXX: replace per path mirror objects with node data
+ // XXXX: move other basic node's data here
+ SwitchState switchState = null;
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NodeReferenceTable.java b/j3d-core/src/classes/share/javax/media/j3d/NodeReferenceTable.java
new file mode 100644
index 0000000..7a49ff6
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NodeReferenceTable.java
@@ -0,0 +1,140 @@
+/*
+ * $RCSfile: NodeReferenceTable.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Hashtable;
+
+/**
+ * The NodeReferenceTable object is used by a leaf node's
+ * updateNodeReferences method called by the
+ * cloneTree method.
+ * The NodeReferenceTable maps nodes from the original subgraph
+ * to the new nodes in the cloned subgraph. This information
+ * can then be used to update any cloned leaf node references
+ * to reference nodes in the cloned subgraph.
+ * cloneTree call, after all nodes have been duplicated,
+ * each SceneGraphObject's updateNodeReferences method is called.
+ * This method takes a NodeReferenceTable object as a parameter. The
+ * SceneGraphObject's updateNodeReferences method can then use the
+ * getNewObjectReference method from this object to get updated
+ * references to objects that have been duplicated in the new cloneTree
+ * sub-graph. If a match is found, a
+ * reference to the corresponding SceneGraphObject in the newly cloned sub-graph
+ * is returned. If no corresponding reference is found, either a
+ * DanglingReferenceException is thrown by the cloneTree
+ * method or a reference to the original
+ * SceneGraphObject is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ * @see SceneGraphObject#updateNodeReferences
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+public class NodeReferenceTable extends Object {
+
+ Hashtable objectHashtable;
+ boolean allowDanglingReferences;
+
+ /**
+ * Constructs an empty NodeReferenceTable.
+ * @since Java 3D 1.2
+ */
+ public NodeReferenceTable() {
+ }
+
+ // Constructor - this is NOT public!
+ NodeReferenceTable(boolean allowDanglingReferences,
+ Hashtable objectHashtable) {
+ set(allowDanglingReferences, objectHashtable);
+ }
+
+ void set(boolean allowDanglingReferences,
+ Hashtable objectHashtable) {
+ this.objectHashtable = objectHashtable;
+ this.allowDanglingReferences = allowDanglingReferences;
+ }
+
+
+ /**
+ * This method is used in conjunction with the cloneTree
+ * method. It can be used by the updateNodeReferences
+ * method to see if a SceneGraphObject that is being referenced has been duplicated
+ * in the new cloneTree sub-graph.
+ * updateNodeReferences method would use this
+ * method by calling it with the reference to the old (existed before
+ * the cloneTree operation) object. If the object has been duplicated
+ * in the cloneTree sub-graph, the corresponding object in the cloned
+ * sub-graph is returned. If no corresponding reference is found, either
+ * a DanglingReferenceException is thrown or a reference to the original
+ * SceneGraphObject is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ *
+ * @param oldReference the reference to the object in
+ * the original sub-graph.
+ *
+ * @return A reference to the corresponding object in the cloned
+ * sub-graph. If no corresponding object exists, either a
+ * DanglingReferenceException will be generated by the
+ * cloneTree method or a reference to the original object
+ * is returned depending on the value of the
+ * allowDanglingReferences parameter passed in the
+ * cloneTree call.
+ *
+ * @see SceneGraphObject#updateNodeReferences
+ * @see Node#cloneTree
+ * @see DanglingReferenceException
+ */
+ public final SceneGraphObject
+ getNewObjectReference(SceneGraphObject oldReference) {
+
+ // look up original SceneGraphObject in hash table
+ SceneGraphObject newObject =
+ (SceneGraphObject)objectHashtable.get(oldReference);
+
+ if (newObject != null) {
+ // found new reference
+ return newObject;
+ }
+
+ // dangling reference found!
+ if (allowDanglingReferences == true) {
+ return oldReference;
+ }
+
+ // dangling references not allowed
+ throw new DanglingReferenceException();
+ }
+
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/NodeRetained.java b/j3d-core/src/classes/share/javax/media/j3d/NodeRetained.java
new file mode 100644
index 0000000..978db02
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/NodeRetained.java
@@ -0,0 +1,987 @@
+/*
+ * $RCSfile: NodeRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.10 $
+ * $Date: 2008/02/28 20:17:26 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+
+import java.util.Vector;
+import java.util.Hashtable;
+import java.util.ArrayList;
+
+/**
+ * The Node class provides an abstract class for all Group and Leaf
+ * Nodes. It provides a common framework for constructing a Java 3D
+ * scene graph, including bounding volumes and parent pointers.
+ */
+abstract class NodeRetained extends SceneGraphObjectRetained implements NnuId {
+
+ // All the node types in the scene graph
+ static final int BACKGROUND = 1;
+ static final int CLIP = 2;
+ static final int LINEARFOG = 3;
+ static final int EXPONENTIALFOG = 4;
+ static final int AMBIENTLIGHT = 5;
+ static final int DIRECTIONALLIGHT = 6;
+ static final int POINTLIGHT = 7;
+ static final int SPOTLIGHT = 8;
+ static final int LINK = 9;
+ static final int MORPH = 10;
+ static final int SHAPE = 11;
+ static final int BACKGROUNDSOUND = 12;
+ static final int POINTSOUND = 13;
+ static final int CONESOUND = 14;
+ static final int SOUNDSCAPE = 15;
+ static final int VIEWPLATFORM = 16;
+ static final int BEHAVIOR = 17;
+
+ static final int SWITCH = 18;
+ static final int BRANCHGROUP = 19;
+ static final int ORDEREDGROUP = 20;
+ static final int DECALGROUP = 21;
+ static final int SHAREDGROUP = 22;
+ static final int GROUP = 23;
+ static final int TRANSFORMGROUP = 24;
+ static final int BOUNDINGLEAF = 25;
+ static final int MODELCLIP = 26;
+ static final int ALTERNATEAPPEARANCE= 27;
+ static final int ORIENTEDSHAPE3D = 28;
+ static final int VIEWSPECIFICGROUP = 29;
+ static final int NUMNODES = 29;
+
+ // traverse flags
+ static final int CONTAINS_VIEWPLATFORM = 0x1;
+
+
+ /**
+ * The universe that we are in
+ */
+ VirtualUniverse universe = null;
+
+ /**
+ * The locale that this node is attatched to. This is only non-null
+ * if this instance is directly linked into a locale.
+ */
+ Locale locale = null;
+
+ /**
+ * The node's parent.
+ */
+ NodeRetained parent = null;
+
+ /**
+ * The node's internal identifier.
+ */
+ String nodeId = null;
+
+ /**
+ * An int that represents the nodes type. Used for quick if tests
+ * in the traverser.
+ */
+ int nodeType;
+
+ // This keeps track of how many times this Node is refernced, refCount > 1
+ // if node is in a shared group
+ int refCount = 0;
+
+ /**
+ * This is the index for the child, as seen by its parent.
+ */
+ int childIndex = -1;
+
+ /**
+ * This boolean is true when the node is in a sharedGroup
+ */
+ boolean inSharedGroup = false;
+
+ /**
+ * This indicates if the node is pickable. If this node is not
+ * pickable then neither are any children
+ */
+ boolean pickable = true;
+
+ /**
+ * The collidable setting; see getCollidable and setCollidable.
+ */
+ boolean collidable = true;
+
+ // A list of localToVworld transforms. If inSharedGroup is false,
+ // then only localToVworld[0][] is valid.
+ // Note: this contains reference to the actual transforms in the
+ // TransformGroupRetained
+ Transform3D localToVworld[][] = null;
+ int localToVworldIndex[][] = null;
+
+ static final int LAST_LOCAL_TO_VWORLD = 0;
+ static final int CURRENT_LOCAL_TO_VWORLD = 1;
+
+ // A parallel array to localToVworld. This is the keys for
+ // localToVworld transforms in shared groups.
+ HashKey localToVworldKeys[] = null;
+
+ /**
+ * This boolean is true when the geometric bounds for the node is
+ * automatically updated
+ */
+ boolean boundsAutoCompute = true;
+
+ // "effective" bounds in local coordinate if boundsAutoCompute == F,
+ // used for internal operations, not used if boundsAutoCompute == T
+ Bounds localBounds;
+
+ // Bounds set by the API
+ Bounds apiBounds;
+
+ protected Bounds cachedBounds=null; // Cached auto compute bounds, could we use localBounds ?
+ protected boolean validCachedBounds = false; // Fix to Issue 514
+ /**
+ * Each element, p, of branchGroupPaths is a list of BranchGroup from
+ * root of the tree to this.
+ * For BranchGroup under a non-shared group this size of
+ * branchGroupPaths is always 1. Otherwise, the size is equal to
+ * the number of possible paths to reach this node.
+ * This variable is used to cached BranchGroup for fast picking.
+ * For non BranchGroupRetained class this is a reference to
+ * the previous BranchGroupRetained branchGroupPaths.
+ */
+ ArrayList branchGroupPaths = new ArrayList(1);
+
+ // background node whose geometry branch contains this node
+ BackgroundRetained geometryBackground = null;
+
+ // closest parent which is a TransformGroupRetained or sharedGroupRetained
+ GroupRetained parentTransformLink = null;
+
+ // closest parent which is a SwitchRetained or sharedGroupRetained
+ GroupRetained parentSwitchLink = null;
+
+ // static transform if a parent transform group is merged during compile.
+ TransformGroupRetained staticTransform = null;
+
+ // orderedId assigned by OrderedGroup parent
+ Integer orderedId = null;
+
+ // Id use for quick search.
+ int nnuId;
+
+ NodeRetained() {
+ // Get a not necessary unique Id.
+ nnuId = NnuIdManager.getId();
+
+ localBounds = new BoundingBox();
+ ((BoundingBox)localBounds).setUpper(-1.0, -1.0, -1.0);
+ ((BoundingBox)localBounds).setLower( 1.0, 1.0, 1.0);
+ }
+
+
+ public int getId() {
+ return nnuId;
+ }
+
+ public int equal(NnuId obj) {
+ int keyId = obj.getId();
+ if(nnuId < keyId) {
+ return -1;
+ }
+ else if(nnuId > keyId) {
+ return 1;
+ }
+ else { // Found it!
+ return 0;
+ }
+ }
+
+ Bounds getLocalBounds(Bounds bounds) {
+ return (Bounds)bounds.clone();
+ }
+
+ /**
+ * Sets the geometric bounds of a node.
+ * @param bounds the bounding object for the node
+ */
+ void setBounds(Bounds bounds) {
+ apiBounds = bounds;
+ if (source.isLive()) {
+ if (!boundsAutoCompute) {
+ if (bounds != null) {
+ localBounds = getLocalBounds(bounds);
+ if (staticTransform != null) {
+ localBounds.transform(staticTransform.transform);
+ }
+ } else {
+ if(localBounds != null) {
+ localBounds.set((Bounds)null);
+ }
+ else {
+ localBounds = new BoundingBox((Bounds)null);
+ }
+ }
+ }
+ } else {
+ if (bounds != null) {
+ localBounds = getLocalBounds(bounds);
+ if (staticTransform != null) {
+ localBounds.transform(staticTransform.transform);
+ }
+ } else {
+ if(localBounds != null) {
+ localBounds.set((Bounds)null);
+ }
+ else {
+ localBounds = new BoundingBox((Bounds)null);
+ }
+ }
+ }
+ }
+
+ /**
+ * Gets the bounding object of a node.
+ * @return the node's bounding object
+ */
+ Bounds getEffectiveBounds() {
+ Bounds b = null;
+ if (localBounds != null && !localBounds.isEmpty()) {
+ b = (Bounds) localBounds.clone();
+ if (staticTransform != null) {
+ Transform3D invTransform = staticTransform.getInvTransform();
+ b.transform(invTransform);
+ }
+ }
+ return b;
+ }
+
+ Bounds getBounds() {
+ return apiBounds;
+ }
+
+ /**
+ * ONLY needed for SHAPE, MORPH, and LINK node type.
+ * Compute the combine bounds of bounds and its localBounds.
+ */
+ void computeCombineBounds(Bounds bounds) {
+ // Do nothing except for Group, Shape3D, Morph, and Link node.
+ }
+
+
+ /**
+ * Sets the automatic calcuation of geometric bounds of a node.
+ * @param autoCompute is a boolean value indicating if automatic calcuation
+ * of bounds
+ */
+ void setBoundsAutoCompute(boolean autoCompute) {
+ if (this.boundsAutoCompute==autoCompute) {
+ return;
+ }
+
+ this.boundsAutoCompute = autoCompute;
+ dirtyBoundsCache();
+ }
+
+ /**
+ * Gets the auto Compute flag for the geometric bounds.
+ * @return the node's auto Compute flag for the geometric bounding object
+ */
+ boolean getBoundsAutoCompute() {
+ return boundsAutoCompute;
+ }
+
+ /**
+ * Replaces the specified parent by a new parent.
+ * @param parent the new parent
+ */
+ void setParent(NodeRetained parent) {
+ this.parent = parent;
+ }
+
+ /**
+ * Returns the parent of the node.
+ * @return the parent.
+ */
+ NodeRetained getParent() {
+ return (NodeRetained)parent;
+ }
+
+ // Transform the input bound by the current LocalToVWorld
+ void transformBounds(SceneGraphPath path, Bounds bound) {
+ if (!((NodeRetained) path.item.retained).inSharedGroup) {
+ bound.transform(getCurrentLocalToVworld());
+ } else {
+ HashKey key = new HashKey("");
+ path.getHashKey(key);
+ bound.transform(getCurrentLocalToVworld(key));
+ }
+ }
+
+
+ // Note : key will get modified in this method.
+ private void computeLocalToVworld( NodeRetained caller, NodeRetained nodeR,
+ HashKey key, Transform3D l2Vw) {
+ int i;
+
+ // To handle localToVworld under a SG.
+ if(nodeR instanceof SharedGroupRetained) {
+ // Get the immediate parent's id and remove last id from key.
+ String nodeId = key.getLastNodeId();
+
+ SharedGroupRetained sgRetained = (SharedGroupRetained) nodeR;
+
+ // Search for the right parent.
+ for(i=0; inumChildren-1 (i.e.,
+ * there must be no duplicate values and no missing indices). The
+ * order that the child indices appear in the child index order array
+ * determines the order in which the children are rendered. The child
+ * at childIndexOrder[0] is rendered first, followed by
+ * childIndexOrder[1], and so on, with the child at
+ * childIndexOrder[numChildren-1] rendered
+ * last.
+ *
+ * numChildren-1 (i.e., there must be
+ * no duplicate values and no missing indices).
+ *
+ * @param childIndexOrder the array that is copied into this
+ * node's child index order array; this can be null
+ *
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any of the following are true:
+ *
+ *
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void setChildIndexOrder(int[] childIndexOrder) {
+ verifyChildIndexOrderArray(childIndexOrder, 0);
+
+ ((OrderedGroupRetained)retained).setChildIndexOrder(childIndexOrder);
+ }
+
+
+ /**
+ * Retrieves the current childIndexOrder array.
+ *
+ * @return a copy of this node's childIndexOrder array; this
+ * can be null.
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public int[] getChildIndexOrder() {
+
+ if (isLiveOrCompiled())
+ if(!this.getCapability(ALLOW_CHILD_INDEX_ORDER_READ))
+ throw new
+ CapabilityNotSetException(J3dI18N.getString("OrderedGroup5"));
+
+ return ((OrderedGroupRetained)this.retained).getChildIndexOrder();
+ }
+
+ /**
+ * Appends the specified child node to this group node's list of
+ * children, and sets the child index order array to the specified
+ * array. If the specified array is null, this node's
+ * childIndexOrder array is set to null. Its children will then
+ * be rendered in increasing index order. If the specified array
+ * is not null, the entire array is copied to this node's
+ * childIndexOrder array. In this case, the length of the array
+ * must be equal to the number of children in this group after the
+ * new child has been added, and every entry in the array must
+ * have a unique value between 0 and childIndexOrder.length != numChildren;childIndexOrder[i] < 0,
+ * for i in [0, numChildren-1];childIndexOrder[i] >= numChildren,
+ * for i in [0, numChildren-1];childIndexOrder[i] ==
+ * childIndexOrder[j],
+ * for i,j in [0, numChildren-1],
+ * i != j;numChildren-1
+ * (i.e., there must be no duplicate values and no missing
+ * indices).
+ *
+ * @param child the child to add to this node's list of children
+ *
+ * @param childIndexOrder the array that is copied into this
+ * node's child index order array; this can be null
+ *
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ *
+ * @exception RestrictedAccessException if this group node is part
+ * of live
+ * or compiled scene graph and the child node being added is not
+ * a BranchGroup node
+ *
+ * @exception MultipleParentException if child has already
+ * been added as a child of another group node.
+ *
+ * @exception IllegalArgumentException if the specified array is
+ * non-null and any of the following are true:
+ *
+ *
+ *
+ * @since Java 3D 1.3
+ */
+ public void addChild(Node child, int[] childIndexOrder) {
+
+ verifyAddStates(child);
+ verifyChildIndexOrderArray(childIndexOrder, 1);
+
+ ((OrderedGroupRetained)retained).addChild(child, childIndexOrder);
+
+ }
+
+
+ // Overridden methods from Group
+
+ /**
+ * Appends the specified child node to this group node's list of children.
+ *
+ * childIndexOrder.length != numChildren;childIndexOrder[i] < 0,
+ * for i in [0, numChildren-1];childIndexOrder[i] >= numChildren,
+ * for i in [0, numChildren-1];childIndexOrder[i] ==
+ * childIndexOrder[j],
+ * for i,j in [0, numChildren-1],
+ * i != j;child has already
+ * been added as a child of another group node.
+ *
+ * @since Java 3D 1.3
+ */
+ public void addChild(Node child) {
+ // Just call super -- the extra work is done by the retained class
+ super.addChild(child);
+ }
+
+ /**
+ * Inserts the specified child node in this group node's list of
+ * children at the specified index.
+ * This method is only supported when the child index order array
+ * is null.
+ *
+ * @param child the new child
+ * @param index at which location to insert. The index
+ * must be a value
+ * greater than or equal to 0 and less than or equal to
+ * numChildren().
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live
+ * or compiled scene graph and the child node being inserted is not
+ * a BranchGroup node
+ * @exception MultipleParentException if child has already
+ * been added as a child of another group node.
+ * @exception IndexOutOfBoundsException if index is invalid.
+ * @exception IllegalStateException if the childIndexOrder array is
+ * not null.
+ *
+ * @since Java 3D 1.3
+ */
+ public void insertChild(Node child, int index) {
+ if (((OrderedGroupRetained)retained).userChildIndexOrder != null) {
+ throw new IllegalStateException(J3dI18N.getString("OrderedGroup6"));
+ }
+
+ // Just call super -- the extra work is done by the retained class
+ super.insertChild(child, index);
+ }
+
+ /**
+ * Removes the child node at the specified index from this group node's
+ * list of children.
+ *
+ * index
+ * must be a value
+ * greater than or equal to 0 and less than numChildren().
+ * @exception CapabilityNotSetException if the appropriate capability is
+ * not set and this group node is part of live or compiled scene graph
+ * @exception RestrictedAccessException if this group node is part of
+ * live or compiled scene graph and the child node being removed is not
+ * a BranchGroup node
+ * @exception IndexOutOfBoundsException if index is invalid.
+ *
+ * @since Java 3D 1.3
+ */
+ public void removeChild(int index) {
+ // Just call super -- the extra work is done by the retained class
+ super.removeChild(index);
+ }
+
+
+ /**
+ * Moves the specified branch group node from its existing location to
+ * the end of this group node's list of children.
+ *
+ * cloneTree to duplicate the current node.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ OrderedGroup og = new OrderedGroup();
+ og.duplicateNode(this, forceDuplicate);
+ return og;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/OrderedGroupRetained.java b/j3d-core/src/classes/share/javax/media/j3d/OrderedGroupRetained.java
new file mode 100644
index 0000000..ced6674
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/OrderedGroupRetained.java
@@ -0,0 +1,520 @@
+/*
+ * $RCSfile: OrderedGroupRetained.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.8 $
+ * $Date: 2008/02/28 20:17:27 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.ArrayList;
+
+/**
+ * The OrderedGroup is a group node that ensures its children rendered
+ * in index increasing order.
+ */
+
+class OrderedGroupRetained extends GroupRetained {
+ // mapping of ordered child id to child index
+ int orderedChildIdTable[];
+
+ // This is a counter for ordered child id
+ private int orderedChildIdCount = 0;
+
+ // This is a vector of free orderedChildId
+ private ArrayList orderedChildIdFreeList = new ArrayList();
+
+ // One OrderedBin per view
+ OrderedBin[] orderedBin = new OrderedBin[0];
+
+ // child id of the newly added child
+ Integer newChildId;
+
+ // ChildCount used by renderBin to initialize the
+ // orderedCollection in each orderedBin (per view)
+ int childCount = 0;
+
+ // per children ordered path data
+ ArrayList childrenOrderedPaths = new ArrayList(1);
+
+
+ // child index order - set by the user.
+ int[] userChildIndexOrder = null;
+
+ // child index order - use by j3d internal.
+ int[] childIndexOrder = null;
+
+
+ OrderedGroupRetained() {
+ this.nodeType = NodeRetained.ORDEREDGROUP;
+ }
+
+
+ void setChildIndexOrder(int[] cIOArr) {
+ if(cIOArr != null) {
+ if((userChildIndexOrder == null) ||
+ (userChildIndexOrder.length != cIOArr.length)) {
+ userChildIndexOrder = new int[cIOArr.length];
+ }
+
+ System.arraycopy(cIOArr, 0, userChildIndexOrder,
+ 0, userChildIndexOrder.length);
+ }
+ else {
+ userChildIndexOrder = null;
+ }
+
+ if (source.isLive()) {
+ int[] newArr = new int[cIOArr.length];
+ System.arraycopy(cIOArr, 0, newArr,
+ 0, newArr.length);
+ J3dMessage m;
+ m = new J3dMessage();
+ m.threads = J3dThread.UPDATE_RENDER;
+ m.type = J3dMessage.ORDERED_GROUP_TABLE_CHANGED;
+ m.universe = universe;
+ m.args[3] = this;
+ m.args[4] = newArr;
+ VirtualUniverse.mc.processMessage(m);
+ }
+ }
+
+ int[] getChildIndexOrder() {
+ if (userChildIndexOrder == null) {
+ return null;
+ }
+
+ int[] newArr = new int[userChildIndexOrder.length];
+ System.arraycopy(userChildIndexOrder, 0,
+ newArr, 0, userChildIndexOrder.length);
+ return newArr;
+
+ }
+
+ Integer getOrderedChildId() {
+ Integer orderedChildId;
+ synchronized(orderedChildIdFreeList) {
+ if (orderedChildIdFreeList.size() == 0) {
+ orderedChildId = new Integer(orderedChildIdCount);
+ orderedChildIdCount++;
+ } else {
+ orderedChildId = (Integer)orderedChildIdFreeList.remove(0);
+ }
+ }
+ return(orderedChildId);
+ }
+
+ void freeOrderedChildId(int id) {
+ synchronized(orderedChildIdFreeList) {
+ orderedChildIdFreeList.add(new Integer(id));
+ }
+ }
+
+ int getOrderedChildCount() {
+ int count;
+
+ synchronized (orderedChildIdFreeList) {
+ count = orderedChildIdCount;
+ }
+ return count;
+ }
+
+ void addChild(Node child) {
+ if(userChildIndexOrder != null) {
+ doAddChildIndexEntry();
+ }
+
+ // GroupRetained.addChild have to check for case of non-null child index order
+ // array and handle it.
+ super.addChild(child);
+
+ }
+
+ void addChild(Node child, int[] cIOArr) {
+ if(cIOArr != null) {
+ userChildIndexOrder = new int[cIOArr.length];
+
+ System.arraycopy(cIOArr, 0, userChildIndexOrder,
+ 0, userChildIndexOrder.length);
+ }
+ else {
+ userChildIndexOrder = null;
+ }
+
+ // GroupRetained.addChild have to check for case of non-null child
+ // index order array and handle it.
+ super.addChild(child);
+
+ }
+
+ void moveTo(BranchGroup bg) {
+ if(userChildIndexOrder != null) {
+ doAddChildIndexEntry();
+ }
+
+ // GroupRetained.moveto have to check for case of non-null child
+ // index order array and handle it.
+ super.moveTo(bg);
+ }
+
+
+ void doRemoveChildIndexEntry(int index) {
+
+ int[] newArr = new int[userChildIndexOrder.length - 1];
+
+ for(int i=0, j=0; i
+ * alignment mode : ROTATE_ABOUT_AXIS
+ */
+ public OrientedShape3D() {
+ super();
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+ }
+
+
+ /**
+ * Constructs an OrientedShape3D node with the specified geometry
+ * component, appearance component, mode, and axis.
+ * The specified axis must not be parallel to the Z
+ * axis--(0,0,z) for any value of z. It is not
+ * possible for the +Z axis to point at the viewer's eye
+ * position by rotating about itself. The target transform will
+ * be set to the identity if the axis is (0,0,z).
+ *
+ * @param geometry the geometry component with which to initialize
+ * this shape node
+ * @param appearance the appearance component of the shape node
+ * @param mode alignment mode, one of: ROTATE_ABOUT_AXIS,
+ * ROTATE_ABOUT_POINT, or ROTATE_NONE
+ * @param axis the ray about which the OrientedShape3D rotates
+ */
+ public OrientedShape3D(Geometry geometry,
+ Appearance appearance,
+ int mode,
+ Vector3f axis) {
+
+ super(geometry, appearance);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((OrientedShape3DRetained)retained).initAlignmentMode(mode);
+ ((OrientedShape3DRetained)retained).initAlignmentAxis(axis);
+ }
+
+ /**
+ * Constructs an OrientedShape3D node with the specified geometry
+ * component, appearance component, mode, and rotation point.
+ *
+ * @param geometry the geometry component with which to initialize
+ * this shape node
+ * @param appearance the appearance component of the shape node
+ * @param mode alignment mode, one of: ROTATE_ABOUT_AXIS,
+ * ROTATE_ABOUT_POINT, or ROTATE_NONE
+ * @param point the position about which the OrientedShape3D rotates
+ */
+ public OrientedShape3D(Geometry geometry,
+ Appearance appearance,
+ int mode,
+ Point3f point) {
+
+ super(geometry, appearance);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((OrientedShape3DRetained)retained).initAlignmentMode(mode);
+ ((OrientedShape3DRetained)retained).initRotationPoint(point);
+
+ }
+
+
+ /**
+ * Constructs an OrientedShape3D node with the specified geometry
+ * component, appearance component, mode, axis, constant scale
+ * enable flag, and scale
+ * The specified axis must not be parallel to the Z
+ * axis--(0,0,z) for any value of z. It is not
+ * possible for the +Z axis to point at the viewer's eye
+ * position by rotating about itself. The target transform will
+ * be set to the identity if the axis is (0,0,z).
+ *
+ * @param geometry the geometry component with which to initialize
+ * this shape node
+ * @param appearance the appearance component of the shape node
+ * @param mode alignment mode, one of: ROTATE_ABOUT_AXIS,
+ * ROTATE_ABOUT_POINT, or ROTATE_NONE
+ * @param axis the ray about which the OrientedShape3D rotates
+ * @param constantScaleEnable a flag indicating whether to enable
+ * constant scale
+ * @param scale scale value used when constant scale is enabled
+ *
+ * @since Java 3D 1.3
+ */
+ public OrientedShape3D(Geometry geometry,
+ Appearance appearance,
+ int mode,
+ Vector3f axis,
+ boolean constantScaleEnable,
+ double scale) {
+
+ super(geometry, appearance);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((OrientedShape3DRetained)retained).initAlignmentMode(mode);
+ ((OrientedShape3DRetained)retained).initAlignmentAxis(axis);
+ ((OrientedShape3DRetained)retained).
+ initConstantScaleEnable(constantScaleEnable);
+ ((OrientedShape3DRetained)retained).initScale(scale);
+ }
+
+ /**
+ * Constructs an OrientedShape3D node with the specified geometry
+ * component, appearance component, mode, and rotation point.
+ *
+ * @param geometry the geometry component with which to initialize
+ * this shape node
+ * @param appearance the appearance component of the shape node
+ * @param mode alignment mode, one of: ROTATE_ABOUT_AXIS,
+ * ROTATE_ABOUT_POINT, or ROTATE_NONE
+ * @param point the position about which the OrientedShape3D rotates
+ * @param constantScaleEnable a flag indicating whether to enable
+ * constant scale
+ * @param scale scale value used when constant scale is enabled
+ *
+ * @since Java 3D 1.3
+ */
+ public OrientedShape3D(Geometry geometry,
+ Appearance appearance,
+ int mode,
+ Point3f point,
+ boolean constantScaleEnable,
+ double scale) {
+
+ super(geometry, appearance);
+
+ // set default read capabilities
+ setDefaultReadCapabilities(readCapabilities);
+
+ ((OrientedShape3DRetained)retained).initAlignmentMode(mode);
+ ((OrientedShape3DRetained)retained).initRotationPoint(point);
+ ((OrientedShape3DRetained)retained).
+ initConstantScaleEnable(constantScaleEnable);
+ ((OrientedShape3DRetained)retained).initScale(scale);
+ }
+
+
+ /**
+ * Creates the retained mode OrientedShape3DRetained object that this
+ * OrientedShape3D object will point to.
+ */
+ void createRetained() {
+ retained = new OrientedShape3DRetained();
+ retained.setSource(this);
+ }
+
+
+ /**
+ * Sets the alignment mode.
+ *
+ * @param mode alignment mode, one of: ROTATE_ABOUT_AXIS,
+ * ROTATE_ABOUT_POINT, or ROTATE_NONE
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAlignmentMode(int mode) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_MODE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D0"));
+ if (isLive())
+ ((OrientedShape3DRetained)retained).setAlignmentMode(mode);
+ else
+ ((OrientedShape3DRetained)retained).initAlignmentMode(mode);
+ }
+
+
+ /**
+ * Retrieves the alignment mode.
+ *
+ * @return one of: ROTATE_ABOUT_AXIS, ROTATE_ABOUT_POINT,
+ * or ROTATE_NONE
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public int getAlignmentMode() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_MODE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D1"));
+ return((OrientedShape3DRetained)retained).getAlignmentMode();
+ }
+
+
+ /**
+ * Sets the new alignment axis. This is the ray about which this
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_AXIS.
+ * The specified axis must not be parallel to the Z
+ * axis--(0,0,z) for any value of z. It is not
+ * possible for the +Z axis to point at the viewer's eye
+ * position by rotating about itself. The target transform will
+ * be set to the identity if the axis is (0,0,z).
+ *
+ * @param axis the new alignment axis
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAlignmentAxis(Vector3f axis) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_AXIS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D2"));
+ if (isLive())
+ ((OrientedShape3DRetained)retained).setAlignmentAxis(axis);
+ else
+ ((OrientedShape3DRetained)retained).initAlignmentAxis(axis);
+ }
+
+
+ /**
+ * Sets the new alignment axis. This is the ray about which this
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_AXIS.
+ * The specified axis must not be parallel to the Z
+ * axis--(0,0,z) for any value of z. It is not
+ * possible for the +Z axis to point at the viewer's eye
+ * position by rotating about itself. The target transform will
+ * be set to the identity if the axis is (0,0,z).
+ *
+ * @param x the x component of the alignment axis
+ * @param y the y component of the alignment axis
+ * @param z the z component of the alignment axis
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setAlignmentAxis(float x, float y, float z) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_AXIS_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D2"));
+ if (isLive())
+ ((OrientedShape3DRetained)retained).setAlignmentAxis(x,y,z);
+ else
+ ((OrientedShape3DRetained)retained).initAlignmentAxis(x,y,z);
+ }
+
+
+ /**
+ * Retrieves the alignment axis of this OrientedShape3D node,
+ * and copies it into the specified vector.
+ *
+ * @param axis the vector that will contain the alignment axis
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getAlignmentAxis(Vector3f axis) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_AXIS_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D3"));
+ ((OrientedShape3DRetained)retained).getAlignmentAxis(axis);
+ }
+
+ /**
+ * Sets the new rotation point. This is the point about which the
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_POINT.
+ *
+ * @param point the new rotation point
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setRotationPoint(Point3f point) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_POINT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D4"));
+ if (isLive())
+ ((OrientedShape3DRetained)retained).setRotationPoint(point);
+ else
+ ((OrientedShape3DRetained)retained).initRotationPoint(point);
+ }
+
+
+ /**
+ * Sets the new rotation point. This is the point about which the
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_POINT.
+ *
+ * @param x the x component of the rotation point
+ * @param y the y component of the rotation point
+ * @param z the z component of the rotation point
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void setRotationPoint(float x, float y, float z) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_POINT_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D4"));
+ if (isLive())
+ ((OrientedShape3DRetained)retained).setRotationPoint(x,y,z);
+ else
+ ((OrientedShape3DRetained)retained).initRotationPoint(x,y,z);
+ }
+
+
+ /**
+ * Retrieves the rotation point of this OrientedShape3D node,
+ * and copies it into the specified vector.
+ *
+ * @param point the point that will contain the rotation point
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ */
+ public void getRotationPoint(Point3f point) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_POINT_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D5"));
+ ((OrientedShape3DRetained)retained).getRotationPoint(point);
+ }
+
+
+ /**
+ * Sets the constant scale enable flag.
+ *
+ * @param constantScaleEnable a flag indicating whether to enable
+ * constant scale
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void setConstantScaleEnable(boolean constantScaleEnable) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SCALE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D6"));
+
+ if (isLive())
+ ((OrientedShape3DRetained)retained).
+ setConstantScaleEnable(constantScaleEnable);
+ else
+ ((OrientedShape3DRetained)retained).
+ initConstantScaleEnable(constantScaleEnable);
+ }
+
+
+ /**
+ * Retrieves the constant scale enable flag.
+ *
+ * @return the current constant scale enable flag
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public boolean getConstantScaleEnable() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SCALE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D7"));
+
+ return ((OrientedShape3DRetained)retained).getConstantScaleEnable();
+ }
+
+
+ /**
+ * Sets the scale for this OrientedShape3D. This scale is used when
+ * the constant scale enable flag is set to true.
+ *
+ * @param scale the scale value
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public void setScale(double scale) {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SCALE_WRITE))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D8"));
+
+ if (isLive())
+ ((OrientedShape3DRetained)retained).setScale(scale);
+ else
+ ((OrientedShape3DRetained)retained).initScale(scale);
+ }
+
+
+ /**
+ * Retrieves the scale value for this OrientedShape3D.
+ *
+ * @return the current scale value
+ *
+ * @exception CapabilityNotSetException if appropriate capability is
+ * not set and this object is part of live or compiled scene graph
+ *
+ * @since Java 3D 1.3
+ */
+ public double getScale() {
+ if (isLiveOrCompiled())
+ if (!this.getCapability(ALLOW_SCALE_READ))
+ throw new CapabilityNotSetException(J3dI18N.getString("OrientedShape3D9"));
+
+ return ((OrientedShape3DRetained)retained).getScale();
+ }
+
+
+ /**
+ * Used to create a new instance of the node. This routine is called
+ * by
+ * alignment axis : Y-axis (0,1,0)
+ * rotation point : (0,0,1)
+ * constant scale enable : false
+ * scale : 1.0
+ *cloneTree to duplicate the current node.
+ * cloneNode should be overridden by any user subclassed
+ * objects. All subclasses must have their cloneNode
+ * method consist of the following lines:
+ *
+ * @param forceDuplicate when set to
+ * public Node cloneNode(boolean forceDuplicate) {
+ * UserSubClass usc = new UserSubClass();
+ * usc.duplicateNode(this, forceDuplicate);
+ * return usc;
+ * }
+ * true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @see Node#cloneTree
+ * @see Node#duplicateNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public Node cloneNode(boolean forceDuplicate) {
+ OrientedShape3D s = new OrientedShape3D();
+ s.duplicateNode(this, forceDuplicate);
+ return s;
+ }
+
+ /**
+ * Copies all node information from originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.
+ * NodeComponent objects
+ * contained by the object being duplicated, each NodeComponent
+ * object's duplicateOnCloneTree value is used to determine
+ * whether the NodeComponent 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
+ * forceDuplicate parameter in the cloneTree
+ * method to true.
+ *
+ * NOTE: Applications should not call this method directly.
+ * It should only be called by the cloneNode method.
+ *
+ * @param originalNode the original node to duplicate.
+ * @param forceDuplicate when set to true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ * @exception ClassCastException if originalNode is not an instance of
+ * Shape3D
+ *
+ * @see Node#cloneTree
+ * @see Node#cloneNode
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ public void duplicateNode(Node originalNode, boolean forceDuplicate) {
+ checkDuplicateNode(originalNode, forceDuplicate);
+ }
+
+
+
+ /**
+ * Copies all Shape3D information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+
+ super.duplicateAttributes(originalNode, forceDuplicate);
+ OrientedShape3DRetained attr = (OrientedShape3DRetained)
+ originalNode.retained;
+ OrientedShape3DRetained rt = (OrientedShape3DRetained) retained;
+
+ rt.setAlignmentMode(attr.getAlignmentMode());
+ Vector3f axis = new Vector3f();
+ attr.getAlignmentAxis(axis);
+ rt.setAlignmentAxis(axis);
+ Point3f point = new Point3f();
+ attr.getRotationPoint(point);
+ rt.setRotationPoint(point);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/OrientedShape3DRenderMethod.java b/j3d-core/src/classes/share/javax/media/j3d/OrientedShape3DRenderMethod.java
new file mode 100644
index 0000000..61166b5
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/OrientedShape3DRenderMethod.java
@@ -0,0 +1,125 @@
+/*
+ * $RCSfile: OrientedShape3DRenderMethod.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.7 $
+ * $Date: 2008/02/28 20:17:27 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+/**
+ * The OrientedShape3DRenderMethod provides a render method to render
+ * OrientedShape3D nodes.
+ * The RenderMethod interface is used to create various ways to render
+ * different geometries.
+ */
+
+class OrientedShape3DRenderMethod implements RenderMethod {
+
+ public boolean render(RenderMolecule rm, Canvas3D cv,
+ RenderAtomListInfo ra, int dirtyBits) {
+ boolean useAlpha;
+ boolean isNonUniformScale;
+ Transform3D trans=null;
+
+ useAlpha = rm.useAlpha;
+
+ GeometryArrayRetained geo = (GeometryArrayRetained)ra.geometry();
+ geo.setVertexFormat((rm.useAlpha &&
+ ((geo.vertexFormat & GeometryArray.COLOR) != 0)),
+ rm.textureBin.attributeBin.ignoreVertexColors, cv.ctx);
+
+ if (rm.doInfinite) {
+ cv.updateState(dirtyBits);
+ while (ra != null) {
+ trans = ra.infLocalToVworld;
+ isNonUniformScale = !trans.isCongruent();
+
+ cv.setModelViewMatrix(cv.ctx, cv.vworldToEc.mat, trans);
+ ra.geometry().execute(cv, ra.renderAtom, isNonUniformScale,
+ (useAlpha && ra.geometry().noAlpha),
+ rm.alpha,
+ cv.screen.screen,
+ rm.textureBin.attributeBin.ignoreVertexColors);
+ ra = ra.next;
+ }
+ return true;
+ }
+
+ boolean isVisible = false; // True if any of the RAs is visible.
+ while (ra != null) {
+ if (cv.ra == ra.renderAtom) {
+ if (cv.raIsVisible) {
+ cv.updateState(dirtyBits);
+ trans = ra.localToVworld;
+ isNonUniformScale = !trans.isCongruent();
+
+ cv.setModelViewMatrix(cv.ctx, cv.vworldToEc.mat, trans);
+ ra.geometry().execute(cv, ra.renderAtom, isNonUniformScale,
+ (useAlpha && ra.geometry().noAlpha),
+ rm.alpha,
+ cv.screen.screen,
+ rm.textureBin.attributeBin.
+ ignoreVertexColors);
+ isVisible = true;
+ }
+ }
+ else {
+ if (!VirtualUniverse.mc.viewFrustumCulling ||
+ ra.renderAtom.localeVwcBounds.intersect(cv.viewFrustum)) {
+ cv.updateState(dirtyBits);
+ cv.raIsVisible = true;
+ trans = ra.localToVworld;
+ isNonUniformScale = !trans.isCongruent();
+
+ cv.setModelViewMatrix(cv.ctx, cv.vworldToEc.mat, trans);
+ ra.geometry().execute(cv, ra.renderAtom, isNonUniformScale,
+ (useAlpha && ra.geometry().noAlpha),
+ rm.alpha,
+ cv.screen.screen,
+ rm.textureBin.attributeBin.
+ ignoreVertexColors);
+ isVisible = true;
+ }
+ else {
+ cv.raIsVisible = false;
+ }
+ cv.ra = ra.renderAtom;
+
+ }
+ ra = ra.next;
+
+ }
+
+
+ geo.disableGlobalAlpha(cv.ctx,
+ (rm.useAlpha &&
+ ((geo.vertexFormat & GeometryArray.COLOR) != 0)),
+ rm.textureBin.attributeBin.ignoreVertexColors);
+ return isVisible;
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/OrientedShape3DRetained.java b/j3d-core/src/classes/share/javax/media/j3d/OrientedShape3DRetained.java
new file mode 100644
index 0000000..28a62a7
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/OrientedShape3DRetained.java
@@ -0,0 +1,611 @@
+/*
+ * $RCSfile: OrientedShape3DRetained.java,v $
+ *
+ * Copyright 1999-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:27 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+
+class OrientedShape3DRetained extends Shape3DRetained {
+
+ static final int ALIGNMENT_CHANGED = LAST_DEFINED_BIT << 1;
+ static final int AXIS_CHANGED = LAST_DEFINED_BIT << 2;
+ static final int ROTATION_CHANGED = LAST_DEFINED_BIT << 3;
+ static final int CONSTANT_SCALE_CHANGED = LAST_DEFINED_BIT << 4;
+ static final int SCALE_FACTOR_CHANGED = LAST_DEFINED_BIT << 5;
+
+
+ int mode = OrientedShape3D.ROTATE_ABOUT_AXIS;
+
+ // Axis about which to rotate.
+ Vector3f axis = new Vector3f(0.0f, 1.0f, 0.0f);
+ Point3f rotationPoint = new Point3f(0.0f, 0.0f, 1.0f);
+ private Vector3d nAxis = new Vector3d(0.0, 1.0, 0.0); // normalized axis
+
+ // reused temporaries
+ private Point3d viewPosition = new Point3d();
+ private Point3d yUpPoint = new Point3d();
+
+ private Vector3d eyeVec = new Vector3d();
+ private Vector3d yUp = new Vector3d();
+ private Vector3d zAxis = new Vector3d();
+ private Vector3d yAxis = new Vector3d();
+ private Vector3d vector = new Vector3d();
+
+ private AxisAngle4d aa = new AxisAngle4d();
+
+ private Transform3D xform = new Transform3D(); // used several times
+ private Transform3D zRotate = new Transform3D();
+
+ // For scale invariant mode
+ boolean constantScale = false;
+ double scaleFactor = 1.0;
+
+ // Frequently used variables for scale invariant computation
+ // Left and right Vworld to Clip coordinates transforms
+ private Transform3D left_xform = new Transform3D();
+ private Transform3D right_xform = new Transform3D();
+
+ // Transform for scaling the OrientedShape3D to correct for
+ // perspective foreshortening
+ Transform3D scaleXform = new Transform3D();
+
+ // Variables for converting between clip to local world coords
+ private Vector4d im_vec[] = {new Vector4d(), new Vector4d()};
+ private Vector4d lvec = new Vector4d();
+
+ boolean orientedTransformDirty = true;
+
+ Transform3D[] orientedTransforms = new Transform3D[1];
+ static final double EPSILON = 1.0e-6;
+
+
+ /**
+ * Constructs a OrientedShape3D node with default parameters.
+ * The default values are as follows:
+ *
+ * alignment mode : ROTATE_ABOUT_AXIS
+ */
+ public OrientedShape3DRetained() {
+ super();
+ this.nodeType = NodeRetained.ORIENTEDSHAPE3D;
+ }
+
+ // initializes alignment mode
+ void initAlignmentMode(int mode) {
+ this.mode = mode;
+ }
+
+ /**
+ * Sets the alignment mode.
+ * @param mode one of: ROTATE_ABOUT_AXIS or ROTATE_ABOUT_POINT
+ */
+ void setAlignmentMode(int mode) {
+ if (this.mode != mode) {
+ initAlignmentMode(mode);
+ sendChangedMessage(ALIGNMENT_CHANGED, new Integer(mode));
+ }
+ }
+
+ /**
+ * Retrieves the alignment mode.
+ * @return one of: ROTATE_ABOUT_AXIS or ROTATE_ABOUT_POINT
+ */
+ int getAlignmentMode() {
+ return(mode);
+ }
+
+ // initializes alignment axis
+ void initAlignmentAxis(Vector3f axis) {
+ initAlignmentAxis(axis.x, axis.y, axis.z);
+ }
+
+ // initializes alignment axis
+ void initAlignmentAxis(float x, float y, float z) {
+ this.axis.set(x,y,z);
+ double invMag;
+ invMag = 1.0/Math.sqrt(axis.x*axis.x + axis.y*axis.y + axis.z*axis.z);
+ nAxis.x = (double)axis.x*invMag;
+ nAxis.y = (double)axis.y*invMag;
+ nAxis.z = (double)axis.z*invMag;
+ }
+
+ /**
+ * Sets the new alignment axis. This is the ray about which this
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_AXIS.
+ * @param axis the new alignment axis
+ */
+ void setAlignmentAxis(Vector3f axis) {
+ setAlignmentAxis(axis.x, axis.y, axis.z);
+ }
+
+ /**
+ * Sets the new alignment axis. This is the ray about which this
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_AXIS.
+ * @param x the x component of the alignment axis
+ * @param y the y component of the alignment axis
+ * @param z the z component of the alignment axis
+ */
+ void setAlignmentAxis(float x, float y, float z) {
+ initAlignmentAxis(x,y,z);
+
+ if (mode == OrientedShape3D.ROTATE_ABOUT_AXIS) {
+ sendChangedMessage(AXIS_CHANGED, new Vector3f(x,y,z));
+ }
+ }
+
+ /**
+ * Retrieves the alignment axis of this OrientedShape3D node,
+ * and copies it into the specified vector.
+ * @param axis the vector that will contain the alignment axis
+ */
+ void getAlignmentAxis(Vector3f axis) {
+ axis.set(this.axis);
+ }
+
+ // initializes rotation point
+ void initRotationPoint(Point3f point) {
+ rotationPoint.set(point);
+ }
+
+ // initializes rotation point
+ void initRotationPoint(float x, float y, float z) {
+ rotationPoint.set(x,y,z);
+ }
+
+ /**
+ * Sets the new rotation point. This is the point about which the
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_POINT.
+ * @param point the new rotation point
+ */
+ void setRotationPoint(Point3f point) {
+ setRotationPoint(point.x, point.y, point.z);
+ }
+
+ /**
+ * Sets the new rotation point. This is the point about which the
+ * OrientedShape3D rotates when the mode is ROTATE_ABOUT_POINT.
+ * @param x the x component of the rotation point
+ * @param y the y component of the rotation point
+ * @param z the z component of the rotation point
+ */
+ void setRotationPoint(float x, float y, float z) {
+ initRotationPoint(x,y,z);
+
+ if (mode == OrientedShape3D.ROTATE_ABOUT_POINT) {
+ sendChangedMessage(ROTATION_CHANGED, new Point3f(x,y,z));
+ }
+ }
+
+ /**
+ * Retrieves the rotation point of this OrientedShape3D node,
+ * and copies it into the specified vector.
+ * @param axis the point that will contain the rotation point
+ */
+ void getRotationPoint(Point3f point) {
+ point.set(rotationPoint);
+ }
+
+ void setConstantScaleEnable(boolean enable) {
+ if(constantScale != enable) {
+ initConstantScaleEnable(enable);
+ sendChangedMessage(CONSTANT_SCALE_CHANGED, new Boolean(enable));
+ }
+ }
+
+ boolean getConstantScaleEnable() {
+ return constantScale;
+ }
+
+ void initConstantScaleEnable(boolean cons_scale) {
+ constantScale = cons_scale;
+ }
+
+ void setScale(double scale) {
+ initScale(scale);
+ if(constantScale)
+ sendChangedMessage(SCALE_FACTOR_CHANGED, new Double(scale));
+ }
+
+ void initScale(double scale) {
+ scaleFactor = scale;
+ }
+
+ double getScale() {
+ return scaleFactor;
+ }
+
+ void sendChangedMessage(int component, Object attr) {
+ J3dMessage changeMessage = new J3dMessage();
+ changeMessage.type = J3dMessage.ORIENTEDSHAPE3D_CHANGED;
+ changeMessage.threads = targetThreads ;
+ changeMessage.universe = universe;
+ changeMessage.args[0] = getGeomAtomsArray(mirrorShape3D);
+ changeMessage.args[1] = new Integer(component);
+ changeMessage.args[2] = attr;
+ OrientedShape3DRetained[] o3dArr =
+ new OrientedShape3DRetained[mirrorShape3D.size()];
+ mirrorShape3D.toArray(o3dArr);
+ changeMessage.args[3] = o3dArr;
+ changeMessage.args[4] = this;
+ VirtualUniverse.mc.processMessage(changeMessage);
+ }
+
+ void updateImmediateMirrorObject(Object[] args) {
+ int component = ((Integer)args[1]).intValue();
+ if ((component & (ALIGNMENT_CHANGED |
+ AXIS_CHANGED |
+ ROTATION_CHANGED |
+ CONSTANT_SCALE_CHANGED |
+ SCALE_FACTOR_CHANGED)) != 0) {
+ OrientedShape3DRetained[] msArr = (OrientedShape3DRetained[])args[3];
+ Object obj = args[2];
+ if ((component & ALIGNMENT_CHANGED) != 0) {
+ int mode = ((Integer)obj).intValue();
+ for (int i=0; i< msArr.length; i++) {
+ msArr[i].initAlignmentMode(mode);
+ }
+ }
+ else if ((component & AXIS_CHANGED) != 0) {
+ Vector3f axis =(Vector3f) obj;
+ for (int i=0; i< msArr.length; i++) {
+ msArr[i].initAlignmentAxis(axis);
+ }
+ }
+ else if ((component & ROTATION_CHANGED) != 0) {
+ Point3f point =(Point3f) obj;
+ for (int i=0; i< msArr.length; i++) {
+ msArr[i].initRotationPoint(point);
+ }
+ }
+ else if((component & CONSTANT_SCALE_CHANGED) != 0) {
+ boolean bool = ((Boolean)obj).booleanValue();
+ for (int i=0; i< msArr.length; i++) {
+ msArr[i].initConstantScaleEnable(bool);
+ }
+ }
+ else if((component & SCALE_FACTOR_CHANGED) != 0) {
+ double scale = ((Double)obj).doubleValue();
+ for (int i=0; i< msArr.length; i++) {
+ msArr[i].initScale(scale);
+ }
+ }
+ }
+ else {
+ super.updateImmediateMirrorObject(args);
+ }
+ }
+
+
+ Transform3D getOrientedTransform(int viewIndex) {
+ synchronized(orientedTransforms) {
+ if (viewIndex >= orientedTransforms.length) {
+ Transform3D xform = new Transform3D();
+ Transform3D[] newList = new Transform3D[viewIndex+1];
+ for (int i = 0; i < orientedTransforms.length; i++) {
+ newList[i] = orientedTransforms[i];
+ }
+ newList[viewIndex] = xform;
+ orientedTransforms = newList;
+ }
+ else {
+ if (orientedTransforms[viewIndex] == null) {
+ orientedTransforms[viewIndex] = new Transform3D();
+ }
+ }
+ }
+ return orientedTransforms[viewIndex];
+ }
+
+ // called on the parent object
+ // Should be synchronized so that the user thread does not modify the
+ // OrientedShape3D params while computing the transform
+ synchronized void updateOrientedTransform(Canvas3D canvas, int viewIndex) {
+ double angle = 0.0;
+ double sign;
+ boolean status;
+
+ Transform3D orientedxform = getOrientedTransform(viewIndex);
+ // get viewplatforms's location in virutal world
+ if (mode == OrientedShape3D.ROTATE_ABOUT_AXIS) { // rotate about axis
+ canvas.getCenterEyeInImagePlate(viewPosition);
+ canvas.getImagePlateToVworld(xform); // xform is imagePlateToLocal
+ xform.transform(viewPosition);
+
+ // get billboard's transform
+ xform.set(getCurrentLocalToVworld());
+ xform.invert(); // xform is now vWorldToLocal
+
+ // transform the eye position into the billboard's coordinate system
+ xform.transform(viewPosition);
+
+
+ // eyeVec is a vector from the local origin to the eye pt in local
+ eyeVec.set(viewPosition);
+ eyeVec.normalize();
+
+ // project the eye into the rotation plane
+ status = projectToPlane(eyeVec, nAxis);
+
+ if (status) {
+ // project the z axis into the rotation plane
+ zAxis.x = 0.0;
+ zAxis.y = 0.0;
+ zAxis.z = 1.0;
+ status = projectToPlane(zAxis, nAxis);
+ }
+ if (status) {
+
+ // compute the sign of the angle by checking if the cross product
+ // of the two vectors is in the same direction as the normal axis
+ vector.cross(eyeVec, zAxis);
+ if (vector.dot(nAxis) > 0.0) {
+ sign = 1.0;
+ } else {
+ sign = -1.0;
+ }
+
+ // compute the angle between the projected eye vector and the
+ // projected z
+
+ double dot = eyeVec.dot(zAxis);
+ if (dot > 1.0f) {
+ dot = 1.0f;
+ } else if (dot < -1.0f) {
+ dot = -1.0f;
+ }
+
+ angle = sign*Math.acos(dot);
+
+ // use -angle because xform is to *undo* rotation by angle
+ aa.x = nAxis.x;
+ aa.y = nAxis.y;
+ aa.z = nAxis.z;
+ aa.angle = -angle;
+ orientedxform.set(aa);
+ }
+ else {
+ orientedxform.setIdentity();
+ }
+
+ } else { // rotate about point
+ // Need to rotate Z axis to point to eye, and Y axis to be
+ // parallel to view platform Y axis, rotating around rotation pt
+
+ // get the eye point
+ canvas.getCenterEyeInImagePlate(viewPosition);
+
+ // derive the yUp point
+ yUpPoint.set(viewPosition);
+ yUpPoint.y += 0.01; // one cm in Physical space
+
+ // transform the points to the Billboard's space
+ canvas.getImagePlateToVworld(xform); // xform is ImagePlateToVworld
+ xform.transform(viewPosition);
+ xform.transform(yUpPoint);
+
+ // get billboard's transform
+ xform.set(getCurrentLocalToVworld());
+ xform.invert(); // xform is vWorldToLocal
+
+ // transfom points to local coord sys
+ xform.transform(viewPosition);
+ xform.transform(yUpPoint);
+
+ // Make a vector from viewPostion to 0,0,0 in the BB coord sys
+ eyeVec.set(viewPosition);
+ eyeVec.normalize();
+
+ // create a yUp vector
+ yUp.set(yUpPoint);
+ yUp.sub(viewPosition);
+ yUp.normalize();
+
+
+ // find the plane to rotate z
+ zAxis.x = 0.0;
+ zAxis.y = 0.0;
+ zAxis.z = 1.0;
+
+ // rotation axis is cross product of eyeVec and zAxis
+ vector.cross(eyeVec, zAxis); // vector is cross product
+
+ // if cross product is non-zero, vector is rotation axis and
+ // rotation angle is acos(eyeVec.dot(zAxis)));
+ double length = vector.length();
+ if (length > 0.0001) {
+ double dot = eyeVec.dot(zAxis);
+ if (dot > 1.0f) {
+ dot = 1.0f;
+ } else if (dot < -1.0f) {
+ dot = -1.0f;
+ }
+ angle = Math.acos(dot);
+ aa.x = vector.x;
+ aa.y = vector.y;
+ aa.z = vector.z;
+ aa.angle = -angle;
+ zRotate.set(aa);
+ } else {
+ // no rotation needed, set to identity (scale = 1.0)
+ zRotate.set(1.0);
+ }
+
+ // Transform the yAxis by zRotate
+ yAxis.x = 0.0;
+ yAxis.y = 1.0;
+ yAxis.z = 0.0;
+ zRotate.transform(yAxis);
+
+ // project the yAxis onto the plane perp to the eyeVec
+ status = projectToPlane(yAxis, eyeVec);
+
+
+ if (status) {
+ // project the yUp onto the plane perp to the eyeVec
+ status = projectToPlane(yUp, eyeVec);
+ }
+
+ if (status) {
+ // rotation angle is acos(yUp.dot(yAxis));
+ double dot = yUp.dot(yAxis);
+
+ // Fix numerical error, otherwise acos return NULL
+ if (dot > 1.0f) {
+ dot = 1.0f;
+ } else if (dot < -1.0f) {
+ dot = -1.0f;
+ }
+
+ angle = Math.acos(dot);
+
+ // check the sign by looking a the cross product vs the eyeVec
+ vector.cross(yUp, yAxis); // vector is cross product
+ if (eyeVec.dot(vector) < 0) {
+ angle *= -1;
+ }
+ aa.x = eyeVec.x;
+ aa.y = eyeVec.y;
+ aa.z = eyeVec.z;
+ aa.angle = -angle;
+ xform.set(aa); // xform is now yRotate
+
+ // rotate around the rotation point
+ vector.x = rotationPoint.x;
+ vector.y = rotationPoint.y;
+ vector.z = rotationPoint.z; // vector to translate to RP
+ orientedxform.set(vector); // translate to RP
+ orientedxform.mul(xform); // yRotate
+ orientedxform.mul(zRotate); // zRotate
+ vector.scale(-1.0); // vector to translate back
+ xform.set(vector); // xform to translate back
+ orientedxform.mul(xform); // translate back
+ }
+ else {
+ orientedxform.setIdentity();
+ }
+
+ }
+ //Scale invariant computation
+ if(constantScale) {
+ // Back Xform a unit vector to local world coords
+ canvas.getInverseVworldProjection(left_xform, right_xform);
+
+ // the two endpts of the vector have to be transformed
+ // individually because the Xform is not affine
+ im_vec[0].set(0.0, 0.0, 0.0, 1.0);
+ im_vec[1].set(1.0, 0.0, 0.0, 1.0);
+ left_xform.transform(im_vec[0]);
+ left_xform.transform(im_vec[1]);
+
+ left_xform.set(getCurrentLocalToVworld());
+ left_xform.invert();
+ left_xform.transform(im_vec[0]);
+ left_xform.transform(im_vec[1]);
+ lvec.set(im_vec[1]);
+ lvec.sub(im_vec[0]);
+
+ // We simply need the direction of this vector
+ lvec.normalize();
+ im_vec[0].set(0.0, 0.0, 0.0, 1.0);
+ im_vec[1].set(lvec);
+ im_vec[1].w = 1.0;
+
+ // Forward Xfrom to clip coords
+ left_xform.set(getCurrentLocalToVworld());
+ left_xform.transform(im_vec[0]);
+ left_xform.transform(im_vec[1]);
+
+ canvas.getVworldProjection(left_xform, right_xform);
+ left_xform.transform(im_vec[0]);
+ left_xform.transform(im_vec[1]);
+
+ // Perspective division
+ im_vec[0].x /= im_vec[0].w;
+ im_vec[0].y /= im_vec[0].w;
+ im_vec[0].z /= im_vec[0].w;
+
+ im_vec[1].x /= im_vec[1].w;
+ im_vec[1].y /= im_vec[1].w;
+ im_vec[1].z /= im_vec[1].w;
+
+ lvec.set(im_vec[1]);
+ lvec.sub(im_vec[0]);
+
+ // Use the length of this vector to determine the scaling
+ // factor
+ double scale = 1/lvec.length();
+
+ // Convert to meters
+ scale *= scaleFactor*canvas.getPhysicalWidth()/2;
+
+ // Scale object so that it appears the same size
+ scaleXform.setScale(scale);
+ orientedxform.mul(scaleXform);
+ }
+
+ }
+
+
+ private boolean projectToPlane(Vector3d projVec, Vector3d planeVec) {
+ double dis = planeVec.dot(projVec);
+ projVec.x = projVec.x - planeVec.x*dis;
+ projVec.y = projVec.y - planeVec.y*dis;
+ projVec.z = projVec.z - planeVec.z*dis;
+
+ double length = projVec.length();
+ if (length < EPSILON) { // projVec is parallel to planeVec
+ return false;
+ }
+ projVec.scale(1 / length);
+ return true;
+ }
+
+ void compile(CompileState compState) {
+
+ super.compile(compState);
+
+ mergeFlag = SceneGraphObjectRetained.DONT_MERGE;
+
+ // don't push the static transform to orientedShape3D
+ // because orientedShape3D is rendered using vertex array;
+ // it's not worth pushing the transform here
+
+ compState.keepTG = true;
+ }
+
+ void searchGeometryAtoms(UnorderList list) {
+ list.add(getGeomAtom(getMirrorShape(key)));
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/PathInterpolator.java b/j3d-core/src/classes/share/javax/media/j3d/PathInterpolator.java
new file mode 100644
index 0000000..4bc02d6
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/PathInterpolator.java
@@ -0,0 +1,297 @@
+/*
+ * $RCSfile: PathInterpolator.java,v $
+ *
+ * Copyright 1998-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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:27 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import java.util.Enumeration;
+
+/**
+ * PathInterpolator behavior. This class defines the base class for
+ * all Path Interpolators. Subclasses have access to the
+ * computePathInterpolation() method, which computes the
+ * currentInterpolationValue given the current time and alpha.
+ * The method also computes the currentKnotIndex, which is based on
+ * the currentInterpolationValue.
+ * The currentInterpolationValue is calculated
+ * by linearly interpolating among a series of predefined knots
+ * (using the value generated by the specified Alpha object).
+ * The first knot must have a value of 0.0 and the last knot must have a
+ * value of 1.0. An intermediate knot with index k must have a value
+ * strictly greater than any knot with index less than k.
+ */
+
+public abstract class PathInterpolator extends TransformInterpolator {
+
+ // Array of knots
+ private float knots[];
+
+ /**
+ * This value is the ratio between knot values indicated by
+ * the currentKnotIndex variable. So if a subclass wanted to
+ * interpolate between knot values, it would use the currentKnotIndex
+ * to get the bounding knots for the "real" value, then use the
+ * currentInterpolationValue to interpolate between the knots.
+ * To calculate this variable, a subclass needs to call
+ * the
+ * alignment axis : Y-axis (0,1,0)
+ * rotation point : (0,0,1)
+ *computePathInterpolation(alphaValue) method from the subclass's
+ * computeTransform() method. Then this variable will hold a valid
+ * value which can be used in further calculations by the subclass.
+ */
+ protected float currentInterpolationValue;
+
+ /**
+ * This value is the index of the current base knot value, as
+ * determined by the alpha function. A subclass wishing to
+ * interpolate between bounding knots would use this index and
+ * the one following it, and would use the currentInterpolationValue
+ * variable as the ratio between these indices.
+ * To calculate this variable, a subclass needs to call
+ * the computePathInterpolation(alphaValue) method from the subclass's
+ * computeTransform() method. Then this variable will hold a valid
+ * value which can be used in further calculations by the subclass.
+ */
+ protected int currentKnotIndex;
+
+
+ /**
+ * Constructs a PathInterpolator node with a null alpha value and
+ * a null target of TransformGroup
+ *
+ * since Java 3D 1.3
+ */
+ PathInterpolator() {
+ }
+
+
+ /**
+ * Constructs a new PathInterpolator object that interpolates
+ * between the knot values in the knots array. The array of knots
+ * is copied into this PathInterpolator object.
+ * @param alpha the alpha object for this interpolator.
+ * @param knots an array of knot values that specify interpolation
+ * points.
+ *
+ * @deprecated As of Java 3D version 1.3, replaced by
+ * PathInterpolator(Alpha, TransformGroup, float[])
+ */
+ public PathInterpolator(Alpha alpha, float[] knots) {
+ this(alpha, null, knots);
+ }
+
+ /**
+ * Constructs a new PathInterpolator object that interpolates
+ * between the knot values in the knots array. The array of knots
+ * is copied into this PathInterpolator object.
+ * @param alpha the alpha object for this interpolator.
+ * @param target the transformgroup node effected by this pathInterpolator
+ * @param knots an array of knot values that specify interpolation
+ * points.
+ *
+ * @since Java 3D 1.3
+ */
+
+ public PathInterpolator(Alpha alpha,TransformGroup target,
+ float[] knots) {
+ super(alpha, target);
+ setKnots(knots);
+ }
+
+
+ /**
+ * Constructs a new PathInterpolator object that interpolates
+ * between the knot values in the knots array. The array of knots
+ * is copied into this PathInterpolator object.
+ * @param alpha the alpha object for this interpolator.
+ * @param target the transform node effected by this positionInterpolator
+ * @param axisOfTransform the transform that defines the local coordinate
+ * @param knots an array of knot values that specify interpolation
+ * points.
+ *
+ * @since Java 3D 1.3
+ */
+ public PathInterpolator(Alpha alpha,TransformGroup target, Transform3D axisOfTransform,
+ float[] knots) {
+ super(alpha, target, axisOfTransform);
+ setKnots(knots);
+ }
+
+ /**
+ * Retrieves the length of the knots array.
+ * @return the array length
+ */
+ public int getArrayLengths(){
+ return knots.length;
+ }
+
+
+ /**
+ * Sets the knot at the specified index for this interpolator.
+ * @param index the index to be changed
+ * @param knot the new knot value
+ */
+ public void setKnot(int index, float knot) {
+ this.knots[index] = knot;
+ }
+
+
+ /**
+ * Retrieves the knot at the specified index.
+ * @param index the index of the value requested
+ * @return the interpolator's knot value at the associated index
+ */
+ public float getKnot(int index) {
+ return this.knots[index];
+ }
+
+
+ /**
+ * Replaces the existing array of knot values with
+ * the specified array. The array of knots is copied into this
+ * interpolator object. Prior to calling this method,
+ * subclasses should verify that the lengths of the new knots array
+ * and subclass-specific parameter arrays are the same.
+ * @param knots a new array of knot values that specify
+ * interpolation points.
+ *
+ * @since Java 3D 1.2
+ */
+ protected void setKnots(float[] knots) {
+ if (knots[0] < -0.0001 || knots[0] > 0.0001) {
+ throw new IllegalArgumentException(J3dI18N.getString("PathInterpolator0"));
+ }
+
+ if ((knots[knots.length-1] - 1.0f) < -0.0001 || (knots[knots.length-1] - 1.0f) > 0.0001) {
+ throw new IllegalArgumentException(J3dI18N.getString("PathInterpolator1"));
+ }
+
+ this.knots = new float[knots.length];
+ for (int i = 0; i < knots.length; i++) {
+ if (i>0 && knots[i] < knots[i-1]) {
+ throw new IllegalArgumentException(J3dI18N.getString("PathInterpolator2"));
+ }
+ this.knots[i] = knots[i];
+ }
+ }
+
+
+ /**
+ * Copies the array of knots from this interpolator
+ * into the specified array.
+ * The array must be large enough to hold all of the knots.
+ * @param knots array that will receive the knots.
+ *
+ * @since Java 3D 1.2
+ */
+ public void getKnots(float[] knots) {
+ for (int i = 0; i < this.knots.length; i++) {
+ knots[i] = this.knots[i];
+ }
+ }
+
+ /**
+ * Computes the base knot index and interpolation value
+ * given the specified value of alpha and the knots[] array. If
+ * the index is 0 and there should be no interpolation, both the
+ * index variable and the interpolation variable are set to 0.
+ * Otherwise, currentKnotIndex is set to the lower index of the
+ * two bounding knot points and the currentInterpolationValue
+ * variable is set to the ratio of the alpha value between these
+ * two bounding knot points.
+ * @param alphaValue alpha value between 0.0 and 1.0
+ *
+ * @since Java 3D 1.3
+ */
+ protected void computePathInterpolation(float alphaValue ) {
+
+ int i;
+
+ for (i = 0; i < knots.length; i++) {
+ if ((i == 0 && alphaValue <= knots[i]) ||
+ (i > 0 && alphaValue >= knots[i-1] && alphaValue <= knots[i])) {
+
+ if (i==0) {
+ currentInterpolationValue = 0f;
+ currentKnotIndex = 0;
+ }
+ else {
+ currentInterpolationValue =
+ (alphaValue - knots[i-1])/(knots[i] - knots[i-1]);
+ currentKnotIndex = i - 1;
+ }
+ break;
+ }
+ }
+ }
+
+ /**
+ * @deprecated As of Java 3D version 1.3, replaced by
+ * computePathInterpolation(float)
+ */
+ protected void computePathInterpolation() {
+ float value = this.alpha.value();
+ computePathInterpolation(value);
+ }
+
+
+ /**
+ * Copies all PathInterpolator information from
+ * originalNode into
+ * the current node. This method is called from the
+ * cloneNode method which is, in turn, called by the
+ * cloneTree method.true, causes the
+ * duplicateOnCloneTree flag to be ignored. When
+ * false, the value of each node's
+ * duplicateOnCloneTree variable determines whether
+ * NodeComponent data is duplicated or copied.
+ *
+ * @exception RestrictedAccessException if this object is part of a live
+ * or compiled scenegraph.
+ *
+ * @see Node#duplicateNode
+ * @see Node#cloneTree
+ * @see NodeComponent#setDuplicateOnCloneTree
+ */
+ void duplicateAttributes(Node originalNode, boolean forceDuplicate) {
+ super.duplicateAttributes(originalNode, forceDuplicate);
+
+ PathInterpolator pi = (PathInterpolator) originalNode;
+
+ int len = pi.getArrayLengths();
+
+ // No API available to set knots size
+ knots = new float[len];
+
+ for (int i = 0; i < len; i++)
+ setKnot(i, pi.getKnot(i));
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/PhysicalBody.java b/j3d-core/src/classes/share/javax/media/j3d/PhysicalBody.java
new file mode 100644
index 0000000..8118485
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/PhysicalBody.java
@@ -0,0 +1,375 @@
+/*
+ * $RCSfile: PhysicalBody.java,v $
+ *
+ * Copyright 1996-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.
+ *
+ * $Revision: 1.6 $
+ * $Date: 2008/02/28 20:17:27 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.util.ArrayList;
+
+/**
+ * This object contains a specification of the user's head.
+ * Attributes of this object are defined in the head coordinate system.
+ * The orgin is defined to be halfway between the left and right eye
+ * in the plane of the face.
+ * The x-axis extends to the right (of the head looking out from the head).
+ * The y-axis extends up. The z-axis extends to the rear of the head.
+ *
+ * @see View
+ */
+
+public class PhysicalBody extends Object {
+ // The X offset for each eye is 1/2 of the inter-pupilary distance
+ // This constant specifies the default IPD.
+ private static final double HALF_IPD = 0.033;
+
+ // These offsets specify the default ear positions relative to the
+ // "center eye".
+ private static final double EAR_X = 0.080;
+ private static final double EAR_Y = -0.030;
+ private static final double EAR_Z = 0.095;
+
+ /**
+ * The user's left eye's position in head coordinates.
+ */
+ Point3d leftEyePosition = new Point3d(-HALF_IPD, 0.0, 0.0);
+
+ /**
+ * The user's right eye's position in head coordinates.
+ */
+ Point3d rightEyePosition = new Point3d(HALF_IPD, 0.0, 0.0);
+
+ /**
+ * The user's left ear's position in head coordinates.
+ */
+ Point3d leftEarPosition = new Point3d(-EAR_X, EAR_Y, EAR_Z);
+
+ /**
+ * The user's right ear's position in head coordinates.
+ */
+ Point3d rightEarPosition = new Point3d(EAR_X, EAR_Y, EAR_Z);
+
+ /**
+ * The user's nominal eye height as measured
+ * from the ground plane.
+ */
+ double nominalEyeHeightFromGround = 1.68;
+
+ /**
+ * The amount to offset the system's
+ * viewpoint from the user's current eye-point. This offset
+ * distance allows an "Over the shoulder" view of the scene
+ * as seen by the user.
+ *
+ * By default, we will use a Z value of 0.4572 meters (18 inches).
+ */
+ double nominalEyeOffsetFromNominalScreen = 0.4572;
+
+ // Head to head-tracker coordinate system transform.
+ // If head tracking is enabled, this transform is a calibration
+ // constant. If head tracking is not enabled, this transform is
+ // not used.
+ // This is used in both SCREEN_VIEW and HMD_VIEW modes.
+ Transform3D headToHeadTracker = new Transform3D();
+
+ // A list of View Objects that refer to this
+ ArrayList users = new ArrayList();
+
+ // Mask that indicates this PhysicalBody's view dependence info. has changed,
+ // and CanvasViewCache may need to recompute the final view matries.
+ int pbDirtyMask = (View.PB_EYE_POSITION_DIRTY
+ | View.PB_EAR_POSITION_DIRTY
+ | View.PB_NOMINAL_EYE_HEIGHT_FROM_GROUND_DIRTY
+ | View.PB_NOMINAL_EYE_OFFSET_FROM_NOMINAL_SCREEN_DIRTY);
+
+ /**
+ * Constructs a PhysicalBody object with default parameters.
+ * The default values are as follows:
+ *
+ * left eye position : (-0.033, 0.0, 0.0)
+ */
+ public PhysicalBody() {
+ // Just use the defaults
+ initHeadToHeadTracker();
+ }
+
+ // Add a user to the list of users
+ synchronized void removeUser(View view) {
+ int idx = users.indexOf(view);
+ if (idx >= 0) {
+ users.remove(idx);
+ }
+ }
+
+ // Add a user to the list of users
+ synchronized void addUser(View view) {
+ int idx = users.indexOf(view);
+ if (idx < 0) {
+ users.add(view);
+ }
+ }
+
+ // Add a user to the list of users
+ synchronized void notifyUsers() {
+ for (int i=users.size()-1; i>=0; i--) {
+ View view = (View)users.get(i);
+ // XXXX: notifyUsers should have a parameter denoting field changed
+ if (view.soundScheduler != null) {
+ view.soundScheduler.setListenerFlag(
+ SoundScheduler.EAR_POSITIONS_CHANGED |
+ SoundScheduler.EYE_POSITIONS_CHANGED );
+ }
+ view.repaint();
+ }
+ }
+
+ /**
+ * Constructs and initializes a PhysicalBody object from the
+ * specified parameters.
+ * @param leftEyePosition the user's left eye position
+ * @param rightEyePosition the user's right eye position
+ */
+ public PhysicalBody(Point3d leftEyePosition, Point3d rightEyePosition) {
+ this.leftEyePosition.set(leftEyePosition);
+ this.rightEyePosition.set(rightEyePosition);
+ initHeadToHeadTracker();
+ }
+
+ /**
+ * Constructs and initializes a PhysicalBody object from the
+ * specified parameters.
+ * @param leftEyePosition the user's left eye position
+ * @param rightEyePosition the user's right eye position
+ * @param leftEarPosition the user's left ear position
+ * @param rightEarPosition the user's right ear position
+ */
+ public PhysicalBody(Point3d leftEyePosition,
+ Point3d rightEyePosition,
+ Point3d leftEarPosition,
+ Point3d rightEarPosition) {
+
+ this.leftEyePosition.set(leftEyePosition);
+ this.rightEyePosition.set(rightEyePosition);
+ this.leftEarPosition.set(leftEarPosition);
+ this.rightEarPosition.set(rightEarPosition);
+ initHeadToHeadTracker();
+ }
+
+ /**
+ * Returns a string representation of this PhysicalBody's values.
+ */
+
+ public String toString() {
+ return "eyePosition = (" + this.leftEyePosition + ", " +
+ this.rightEyePosition + ")\n" +
+ "earPosition = (" + this.leftEarPosition + ", " +
+ this.rightEarPosition + ")";
+ }
+
+ /**
+ * Retrieves the user head object's left eye position and places
+ * that value in the specified object.
+ * @param position the object that will receive the left-eye's position
+ * in head coordinates
+ */
+ public void getLeftEyePosition(Point3d position) {
+ position.set(this.leftEyePosition);
+ }
+
+ /**
+ * Sets the user head object's left eye position.
+ * @param position the left-eye's position in head coordinates
+ */
+ public void setLeftEyePosition(Point3d position) {
+ synchronized(this) {
+ this.leftEyePosition.set(position);
+ pbDirtyMask |= View.PB_EYE_POSITION_DIRTY;
+ }
+ notifyUsers();
+ }
+
+ /**
+ * Retrieves the user head object's right eye position and places
+ * that value in the specified object.
+ * @param position the object that will receive the right-eye's position
+ * in head coordinates
+ */
+ public void getRightEyePosition(Point3d position) {
+ position.set(this.rightEyePosition);
+ }
+
+ /**
+ * Sets the user head object's right eye position.
+ * @param position the right-eye's position in head coordinates
+ */
+ public void setRightEyePosition(Point3d position) {
+ synchronized(this) {
+ this.rightEyePosition.set(position);
+ pbDirtyMask |= View.PB_EYE_POSITION_DIRTY;
+ }
+ notifyUsers();
+ }
+
+ /**
+ * Retrieves the user head object's left ear position and places
+ * that value in the specified object.
+ * @param position the object that will receive the left-ear's position
+ * in head coordinates
+ */
+ public void getLeftEarPosition(Point3d position) {
+ position.set(this.leftEarPosition);
+ }
+
+ /**
+ * Sets the user head object's left ear position.
+ * @param position the left-ear's position in head coordinates
+ */
+ public void setLeftEarPosition(Point3d position) {
+ synchronized(this) {
+ this.leftEarPosition.set(position);
+ pbDirtyMask |= View.PB_EAR_POSITION_DIRTY;
+ }
+ notifyUsers();
+ }
+
+ /**
+ * Retrieves the user head object's right ear position and places
+ * that value in the specified object.
+ * @param position the object that will receive the right-ear's position
+ * in head coordinates
+ */
+ public void getRightEarPosition(Point3d position) {
+ position.set(this.rightEarPosition);
+ }
+
+ /**
+ * Sets the user head object's right ear position.
+ * @param position the right-ear's position in head coordinates
+ */
+ public void setRightEarPosition(Point3d position) {
+ synchronized(this) {
+ this.rightEarPosition.set(position);
+ pbDirtyMask |= View.PB_EAR_POSITION_DIRTY;
+ }
+ notifyUsers();
+ }
+
+ /**
+ * Sets the nominal eye height from the ground plane.
+ * This parameter defines
+ * the distance from the origin of the user's head (the eyepoint) to
+ * the ground.
+ * It is used when the view attach policy is NOMINAL_FEET.
+ * @param height the nominal height of the eye above the ground plane
+ */
+ public void setNominalEyeHeightFromGround(double height) {
+ synchronized(this) {
+ nominalEyeHeightFromGround = height;
+ pbDirtyMask |= View.PB_NOMINAL_EYE_HEIGHT_FROM_GROUND_DIRTY;
+ }
+ notifyUsers();
+ }
+
+ /**
+ * Retrieves the nominal eye height from the ground plane.
+ * @return the current nominal eye height above the ground plane
+ */
+ public double getNominalEyeHeightFromGround() {
+ return nominalEyeHeightFromGround;
+ }
+
+ /**
+ * Sets the nominal eye offset from the display screen.
+ * This parameter defines
+ * the distance from the origin of the user's head (the eyepoint), in it's
+ * nominal position, to
+ * the screen.
+ * It is used when the view attach policy is NOMINAL_HEAD or NOMINAL_FEET.
+ * This value is overridden to be the actual eyepoint when the window
+ * eyepoint policy is RELATIVE_TO_FIELD_OF_VIEW.
+ * @param offset the nominal offset from the eye to the screen
+ */
+ public void setNominalEyeOffsetFromNominalScreen(double offset) {
+ synchronized(this) {
+ nominalEyeOffsetFromNominalScreen = offset;
+ pbDirtyMask |= View.PB_NOMINAL_EYE_OFFSET_FROM_NOMINAL_SCREEN_DIRTY;
+ }
+ notifyUsers();
+ }
+
+ /**
+ * Retrieves the nominal eye offset from the display screen.
+ * @return the current nominal offset from the eye to the display screen
+ */
+ public double getNominalEyeOffsetFromNominalScreen() {
+ return nominalEyeOffsetFromNominalScreen;
+ }
+
+ /**
+ * Sets the head to head-tracker coordinate system transform.
+ * If head tracking is enabled, this transform is a calibration
+ * constant. If head tracking is not enabled, this transform is
+ * not used.
+ * This is used in both SCREEN_VIEW and HMD_VIEW modes.
+ * @param t the new transform
+ * @exception BadTransformException if the transform is not rigid
+ */
+ public void setHeadToHeadTracker(Transform3D t) {
+ if (!t.isRigid()) {
+ throw new BadTransformException(J3dI18N.getString("PhysicalBody0"));
+ }
+ headToHeadTracker.setWithLock(t);
+ notifyUsers();
+ }
+
+ /**
+ * Retrieves the head to head-tracker coordinate system transform.
+ * @param t the object that will receive the transform
+ */
+ public void getHeadToHeadTracker(Transform3D t) {
+ t.set(headToHeadTracker);
+ }
+
+ // Initialize the head to head-tracker transform
+ private void initHeadToHeadTracker() {
+ // By default the center of the crystal eyes tracker is 20mm down
+ // and 35 mm closer to the screen from the origin of head coordinates
+ // (the center eye).
+ Vector3d v = new Vector3d(0.0, 0.020, 0.035);
+ headToHeadTracker.set(v);
+ }
+}
diff --git a/j3d-core/src/classes/share/javax/media/j3d/PhysicalEnvironment.java b/j3d-core/src/classes/share/javax/media/j3d/PhysicalEnvironment.java
new file mode 100644
index 0000000..02b54c5
--- /dev/null
+++ b/j3d-core/src/classes/share/javax/media/j3d/PhysicalEnvironment.java
@@ -0,0 +1,532 @@
+/*
+ * $RCSfile: PhysicalEnvironment.java,v $
+ *
+ * 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.
+ *
+ * $Revision: 1.5 $
+ * $Date: 2008/02/28 20:17:27 $
+ * $State: Exp $
+ */
+
+package javax.media.j3d;
+
+import javax.vecmath.*;
+import java.awt.*;
+import java.util.*;
+
+/**
+ * This object contains a specification of the physical environment in
+ * which the view will be generated. It is used to set up input
+ * devices (sensors) for head-tracking and other uses, and the audio
+ * output device. Sensors are indexed starting at zero.
+ *
+ * @see View
+ */
+
+public class PhysicalEnvironment extends Object {
+ /**
+ * The Sensor Index associated with the Head
+ */
+ int HeadIndex = 0;
+
+ // The Sensor index associated with the Right Hand
+ int RightHandIndex = 1;
+
+ // The Sensor index associated with the Left Hand
+ int LeftHandIndex = 2;
+
+ // The current Dominant Hand Sensor Index
+ int DominantHandIndex = 1;
+
+ // The current Non Dominant Hand Sensor Index
+ int NonDominantHandIndex = 2;
+
+ //
+ // Coexistence coordinate system to tracker-base coordinate
+ // system transform. If head tracking is enabled, this transform
+ // is a calibration constant. If head tracking is not enabled,
+ // this transform is not used.
+ // This is used in both SCREEN_VIEW and HMD_VIEW modes.
+ //
+ Transform3D coexistenceToTrackerBase = new Transform3D();
+
+ //
+ // Indicates whether the underlying hardware implementation
+ // supports tracking.
+ //
+ boolean trackingAvailable = false;
+
+ // The view associated with this physical environment
+ // View view;
+
+ //
+ // This variable specifies the policy Java 3D will use in placing
+ // the user's eye position relative to the user's head position
+ // (NOMINAL_SCREEN, NOMINAL_HEAD, or NOMINAL_FEET).
+ // It is used in the calibration process.
+ //
+ // TODO: this needs better explanation in the spec
+ int coexistenceCenterInPworldPolicy = View.NOMINAL_SCREEN;
+
+ // Mask that indicates this PhysicalEnv's view dependence info. has changed,
+ // and CanvasViewCache may need to recompute the final view matries.
+ int peDirtyMask = (View.PE_COE_TO_TRACKER_BASE_DIRTY
+ | View.PE_TRACKING_AVAILABLE_DIRTY
+ | View.PE_COE_CENTER_IN_PWORLD_POLICY_DIRTY);
+
+
+//// /**
+//// * The offset in the user's dominant-hand-tracker coordinates
+//// * to that hand's hot spot. This value is a calibration constant.
+//// */
+//// Vector3d dominantHandTrackerHotspotOffset;
+////
+//// /**
+//// * The offset in the user's non-dominant-hand-tracker coordinates
+//// * to that hand's hot spot. This value is a calibration constant.
+//// */
+//// Vector3d nondominantHandTrackerHotspotOffset;
+
+ //
+ // The number of sensor stored within the PhysicalEnvironment
+ //
+ int sensorCount;
+
+ //
+ // Array of sensors
+ //
+ Sensor[] sensors;
+
+ // Audio device associated with this PhysicalEnvironment
+ AudioDevice audioDevice = null;
+
+ boolean sensorListChanged = false;
+
+ Sensor[] sensorList = null;
+
+ // A list of View Objects that refer to this
+ ArrayList users = new ArrayList();
+
+ // Scheduler for input devices
+ InputDeviceScheduler inputsched;
+
+ // store all inputDevices
+ Vector devices = new Vector(1);
+
+ // Number of active view users
+ int activeViewRef = 0;
+
+ // Hashtable that maps a PhysicalEnvironment to its InputDeviceScheduler
+ static Hashtable physicalEnvMap = new Hashtable();
+
+ /**
+ * Constructs a PhysicalEnvironment object with default parameters.
+ * The default values are as follows:
+ *
+ * right eye position : (0.033, 0.0, 0.0)
+ * left ear position : (-0.080, -0.030, 0.095)
+ * right ear position : (0.080, -0.030, 0.095)
+ * nominal eye height from ground : 1.68
+ * nominal eye offset from nominal screen : 0.4572
+ * head to head tracker transform : identity
+ *
+ * sensor count : 3
+ */
+ public PhysicalEnvironment() {
+ this(3);
+ }
+
+ // Add a user to the list of users
+ synchronized void removeUser(View view) {
+ int idx = users.indexOf(view);
+ if (idx >= 0) {
+ users.remove(idx);
+ }
+ }
+
+ // Add a user to the list of users
+ synchronized void addUser(View view) {
+ int idx = users.indexOf(view);
+ if (idx < 0) {
+ users.add(view);
+ }
+ }
+
+ // Add a user to the list of users
+ synchronized void notifyUsers() {
+ for (int i=users.size()-1; i>=0; i--) {
+ View view = (View)users.get(i);
+ view.repaint();
+ }
+ }
+
+ /**
+ * Constructs and initializes a PhysicalEnvironment object with
+ * the specified number of sensors.
+ * @param sensorCount the number of sensors to create.
+ */
+ public PhysicalEnvironment(int sensorCount) {
+ this.sensorCount = sensorCount;
+ sensors = new Sensor[sensorCount];
+ for(int i=sensorCount-1; i>=0; i--) {
+ sensors[i] = null;
+ }
+ }
+
+
+
+ /**
+ * Returns copy of Sensor references. Returns null for zero
+ * sensors, so user of method must check for null. Also, any of
+ * these sensors could be null.
+ */
+ Sensor[] getSensorList() {
+ synchronized(sensors) {
+ if(sensorListChanged) { // note: this is a rare case
+ sensorList = new Sensor[sensors.length];
+ for(int i=0 ; i
+ * sensors : null (for all array elements)
+ * head index : 0
+ * right hand index : 1
+ * left hand index : 2
+ * dominant hand index : 1
+ * nondominant hand index : 2
+ * tracking available : false
+ * audio device : null
+ * input device list : empty
+ * coexistence to tracker base transform : identity
+ * coexistence center in pworld policy : View.NOMINAL_SCREEN
+ * PI/64 radians.
+ */
+ public PickConeRay() {
+ }
+
+ /**
+ * Constructs an infinite cone pick shape from the specified
+ * parameters.
+ * @param origin the origin of the cone
+ * @param direction the direction of the cone
+ * @param spreadAngle the spread angle of the cone in radians
+ */
+ public PickConeRay(Point3d origin, Vector3d direction, double spreadAngle) {
+ this.origin = new Point3d(origin);
+ this.direction = new Vector3d(direction);
+ this.spreadAngle = spreadAngle;
+ }
+
+ /**
+ * Sets the parameters of this PickCone to the specified values.
+ * @param origin the origin of the cone
+ * @param direction the direction of the cone
+ * @param spreadAngle the spread angle of the cone in radians
+ */
+ public void set(Point3d origin, Vector3d direction, double spreadAngle) {
+ this.origin.set(origin);
+ this.direction.set(direction);
+ this.spreadAngle = spreadAngle;
+ }
+
+ /**
+ * Return true if shape intersect with bounds.
+ * The point of intersection is stored in pickPos.
+ * @param bounds the bounds object to check
+ * @param pickPos the location of the point of intersection (not used for
+ * method. Provided for compatibility).
+ */
+ final boolean intersect(Bounds bounds, Point4d pickPos) {
+
+ Point4d iPnt = new Point4d();
+ Vector3d vector = new Vector3d();
+ double distance;
+ double radius;
+ Point3d rayPt = new Point3d();
+
+ //
+ // ================ BOUNDING SPHERE ================
+ //
+ if (bounds instanceof BoundingSphere) {
+ Point3d sphCenter = ((BoundingSphere)bounds).getCenter();
+ double sphRadius = ((BoundingSphere)bounds).getRadius();
+ double sqDist =
+ Distance.pointToRay (sphCenter, origin, direction, rayPt, null);
+ vector.sub (rayPt, origin);
+ distance = vector.length();
+ radius = getRadius (distance);
+ if (sqDist <= (sphRadius+radius)*(sphRadius+radius)) {
+ return true;
+ }
+ return false; // we are too far to intersect
+ }
+ //
+ // ================ BOUNDING BOX ================
+ //
+ else if (bounds instanceof BoundingBox) {
+ // Calculate radius of BoundingBox
+ Point3d lower = new Point3d();
+ ((BoundingBox)bounds).getLower (lower);
+
+ Point3d center = ((BoundingBox)bounds).getCenter ();
+
+ // First, see if cone is too far away from BoundingBox
+ double sqDist =
+ Distance.pointToRay (center, origin, direction, rayPt, null);
+
+ vector.sub (rayPt, origin);
+ distance = vector.length();
+ radius = getRadius (distance);
+
+ double temp = (center.x - lower.x + radius);
+ double boxRadiusSquared = temp*temp;
+ temp = (center.y - lower.y + radius);
+ boxRadiusSquared += temp*temp;
+ temp = (center.z - lower.z + radius);
+ boxRadiusSquared += temp*temp;
+
+
+ if (sqDist > boxRadiusSquared) {
+ return false; // we are too far to intersect
+ }
+ else if (sqDist < (radius*radius)) {
+ return true; // center is in cone
+ }
+
+ // Then, see if ray intersects
+ if (((BoundingBox)bounds).intersect (origin, direction, iPnt)) {
+ return true;
+ }
+
+ // Ray does not intersect, test for distance with each edge
+ Point3d upper = new Point3d();
+ ((BoundingBox)bounds).getUpper (upper);
+
+ Point3d[][] edges = {
+ // Top horizontal 4
+ {upper, new Point3d (lower.x, upper.y, upper.z)},
+ {new Point3d(lower.x, upper.y, upper.z), new Point3d(lower.x, lower.y, upper.z)},
+ {new Point3d(lower.x, lower.y, upper.z), new Point3d(upper.x, lower.y, upper.z)},
+ {new Point3d(upper.x, lower.y, upper.z), upper},
+ // Bottom horizontal 4
+ {lower, new Point3d(lower.x, upper.y, lower.z)},
+ {new Point3d(lower.x, upper.y, lower.z), new Point3d(upper.x, upper.y, lower.z)},
+ {new Point3d(upper.x, upper.y, lower.z), new Point3d(upper.x, lower.y, lower.z)},
+ {new Point3d(upper.x, lower.y, lower.z), lower},
+ // Vertical 4
+ {lower, new Point3d(lower.x, lower.y, upper.z)},
+ {new Point3d(lower.x, upper.y, lower.z), new Point3d(lower.x, upper.y, upper.z)},
+ {new Point3d(upper.x, upper.y, lower.z), new Point3d(upper.x, upper.y, upper.z)},
+ {new Point3d(upper.x, lower.y, lower.z), new Point3d(upper.x, lower.y, upper.z)}
+ };
+
+ for (int i=0;i