001: /*
002: * $RCSfile: TCBKeyFrame.java,v $
003: *
004: * Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
005: *
006: * Redistribution and use in source and binary forms, with or without
007: * modification, are permitted provided that the following conditions
008: * are met:
009: *
010: * - Redistribution of source code must retain the above copyright
011: * notice, this list of conditions and the following disclaimer.
012: *
013: * - Redistribution in binary form must reproduce the above copyright
014: * notice, this list of conditions and the following disclaimer in
015: * the documentation and/or other materials provided with the
016: * distribution.
017: *
018: * Neither the name of Sun Microsystems, Inc. or the names of
019: * contributors may be used to endorse or promote products derived
020: * from this software without specific prior written permission.
021: *
022: * This software is provided "AS IS," without a warranty of any
023: * kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
024: * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
025: * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
026: * EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
027: * NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
028: * USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
029: * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
030: * ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
031: * CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
032: * REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
033: * INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
034: * POSSIBILITY OF SUCH DAMAGES.
035: *
036: * You acknowledge that this software is not designed, licensed or
037: * intended for use in the design, construction, operation or
038: * maintenance of any nuclear facility.
039: *
040: * $Revision: 1.4 $
041: * $Date: 2007/02/09 17:20:12 $
042: * $State: Exp $
043: */
044:
045: package com.sun.j3d.utils.behaviors.interpolators;
046:
047: import javax.media.j3d.*;
048: import java.util.*;
049: import javax.vecmath.*;
050: import com.sun.j3d.internal.J3dUtilsI18N;
051:
052: /**
053: * This class represents a Key Frame that can be used for Kochanek-Bartels
054: * (TCB) spline interpolation.
055: *
056: * @since Java3D 1.1
057: */
058:
059: public class TCBKeyFrame {
060:
061: // Position, Rotation and Scale
062: public Point3f position;
063: public Quat4f quat;
064: public Point3f scale;
065:
066: // Tension, Continuity & Bias
067: public float tension;
068: public float continuity;
069: public float bias;
070:
071: // Sample Time
072: public float knot;
073:
074: // Interpolation type (linear = 0 -> spline interpolation)
075: public int linear;
076:
077: // default constructor
078: TCBKeyFrame() {
079: tension = continuity = bias = 0.0f;
080: }
081:
082: public TCBKeyFrame(TCBKeyFrame kf) {
083: this (kf.knot, kf.linear, kf.position, kf.quat, kf.scale,
084: kf.tension, kf.continuity, kf.bias);
085:
086: }
087:
088: /**
089: * Creates a key frame using the given inputs.
090: *
091: * @param k knot value for this key frame
092: * @param l the linear flag (0 - Spline Interp, 1, Linear Interp
093: * @param pos the position at the key frame
094: * @param q the rotations at the key frame
095: * @param s the scales at the key frame
096: * @param t tension (-1.0 < t < 1.0)
097: * @param c continuity (-1.0 < c < 1.0)
098: * @param b bias (-1.0 < b < 1.0)
099: */
100: public TCBKeyFrame(float k, int l, Point3f pos, Quat4f q,
101: Point3f s, float t, float c, float b) {
102:
103: knot = k;
104: linear = l;
105: position = new Point3f(pos);
106: quat = new Quat4f(q);
107: scale = new Point3f(s);
108:
109: // Check for valid tension continuity and bias values
110: if (t < -1.0f || t > 1.0f) {
111: throw new IllegalArgumentException(J3dUtilsI18N
112: .getString("TCBKeyFrame0"));
113: }
114:
115: if (b < -1.0f || b > 1.0f) {
116: throw new IllegalArgumentException(J3dUtilsI18N
117: .getString("TCBKeyFrame1"));
118: }
119:
120: if (c < -1.0f || c > 1.0f) {
121: throw new IllegalArgumentException(J3dUtilsI18N
122: .getString("TCBKeyFrame2"));
123: }
124:
125: // copy valid tension, continuity and bias values
126: tension = t;
127: continuity = c;
128: bias = b;
129: }
130:
131: /**
132: * Prints information comtained in this key frame
133: * @param tag string tag for identifying debug message
134: */
135: public void debugPrint(String tag) {
136: System.out.println("\n" + tag);
137: System.out.println(" knot = " + knot);
138: System.out.println(" linear = " + linear);
139: System.out.println(" position(x,y,z) = " + position.x + " "
140: + position.y + " " + position.z);
141:
142: System.out.println(" tension = " + tension);
143: System.out.println(" continuity = " + continuity);
144: System.out.println(" bias = " + bias);
145: }
146: }
|