Java tutorial
/* * 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. * */ package javax.media.j3d; /** * The TriangleFanArray 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. */ public class TriangleFanArray extends GeometryStripArray { // non-public, no parameter constructor TriangleFanArray() { } /** * Constructs an empty TriangleFanArray 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 stripVertexCounts * see {@link GeometryStripArray#GeometryStripArray(int,int,int[])} * for a description of this parameter. * * @exception IllegalArgumentException if vertexCount is less than 3 * or any element in the stripVertexCounts array is less than 3 * ;<br> * See {@link GeometryStripArray#GeometryStripArray(int,int,int[])} * for more exceptions that can be thrown */ public TriangleFanArray(int vertexCount, int vertexFormat, int stripVertexCounts[]) { super(vertexCount, vertexFormat, stripVertexCounts); if (vertexCount < 3) throw new IllegalArgumentException(J3dI18N.getString("TriangleFanArray0")); } /** * Constructs an empty TriangleFanArray 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 stripVertexCounts * see {@link GeometryStripArray#GeometryStripArray(int,int,int,int[],int[])} * for a description of this parameter. * * @exception IllegalArgumentException if vertexCount is less than 3 * or any element in the stripVertexCounts array is less than 3 * ;<br> * See {@link GeometryStripArray#GeometryStripArray(int,int,int,int[],int[])} * for more exceptions that can be thrown * * @since Java 3D 1.2 */ public TriangleFanArray(int vertexCount, int vertexFormat, int texCoordSetCount, int[] texCoordSetMap, int stripVertexCounts[]) { super(vertexCount, vertexFormat, texCoordSetCount, texCoordSetMap, stripVertexCounts); if (vertexCount < 3) throw new IllegalArgumentException(J3dI18N.getString("TriangleFanArray0")); } /** * Constructs an empty TriangleFanArray 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 3 * or any element in the stripVertexCounts array is less than 3 * ;<br> * See {@link GeometryStripArray#GeometryStripArray(int,int,int,int[],int,int[],int[])} * for more exceptions that can be thrown * * @since Java 3D 1.4 */ public TriangleFanArray(int vertexCount, int vertexFormat, int texCoordSetCount, int[] texCoordSetMap, int vertexAttrCount, int[] vertexAttrSizes, int[] stripVertexCounts) { super(vertexCount, vertexFormat, texCoordSetCount, texCoordSetMap, vertexAttrCount, vertexAttrSizes, stripVertexCounts); if (vertexCount < 3) throw new IllegalArgumentException(J3dI18N.getString("TriangleFanArray0")); } /** * Creates the retained mode TriangleFanArrayRetained object that this * TriangleFanArray object will point to. */ @Override void createRetained() { this.retained = new TriangleFanArrayRetained(); this.retained.setSource(this); } /** * @deprecated replaced with cloneNodeComponent(boolean forceDuplicate) */ @Override public NodeComponent cloneNodeComponent() { TriangleFanArrayRetained rt = (TriangleFanArrayRetained) 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); } TriangleFanArray t = new TriangleFanArray(rt.getVertexCount(), rt.getVertexFormat(), texSetCount, texMap, vertexAttrCount, vertexAttrSizes, stripcounts); t.duplicateNodeComponent(this); return t; } }