123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477 |
- import { AnimationUtils } from './AnimationUtils.js';
- import { KeyframeTrack } from './KeyframeTrack.js';
- import { BooleanKeyframeTrack } from './tracks/BooleanKeyframeTrack.js';
- import { ColorKeyframeTrack } from './tracks/ColorKeyframeTrack.js';
- import { NumberKeyframeTrack } from './tracks/NumberKeyframeTrack.js';
- import { QuaternionKeyframeTrack } from './tracks/QuaternionKeyframeTrack.js';
- import { StringKeyframeTrack } from './tracks/StringKeyframeTrack.js';
- import { VectorKeyframeTrack } from './tracks/VectorKeyframeTrack.js';
- import { MathUtils } from '../math/MathUtils.js';
- import { NormalAnimationBlendMode } from '../constants.js';
- function AnimationClip( name, duration, tracks, blendMode ) {
- this.name = name;
- this.tracks = tracks;
- this.duration = ( duration !== undefined ) ? duration : - 1;
- this.blendMode = ( blendMode !== undefined ) ? blendMode : NormalAnimationBlendMode;
- this.uuid = MathUtils.generateUUID();
- // this means it should figure out its duration by scanning the tracks
- if ( this.duration < 0 ) {
- this.resetDuration();
- }
- }
- function getTrackTypeForValueTypeName( typeName ) {
- switch ( typeName.toLowerCase() ) {
- case 'scalar':
- case 'double':
- case 'float':
- case 'number':
- case 'integer':
- return NumberKeyframeTrack;
- case 'vector':
- case 'vector2':
- case 'vector3':
- case 'vector4':
- return VectorKeyframeTrack;
- case 'color':
- return ColorKeyframeTrack;
- case 'quaternion':
- return QuaternionKeyframeTrack;
- case 'bool':
- case 'boolean':
- return BooleanKeyframeTrack;
- case 'string':
- return StringKeyframeTrack;
- }
- throw new Error( 'THREE.KeyframeTrack: Unsupported typeName: ' + typeName );
- }
- function parseKeyframeTrack( json ) {
- if ( json.type === undefined ) {
- throw new Error( 'THREE.KeyframeTrack: track type undefined, can not parse' );
- }
- const trackType = getTrackTypeForValueTypeName( json.type );
- if ( json.times === undefined ) {
- const times = [], values = [];
- AnimationUtils.flattenJSON( json.keys, times, values, 'value' );
- json.times = times;
- json.values = values;
- }
- // derived classes can define a static parse method
- if ( trackType.parse !== undefined ) {
- return trackType.parse( json );
- } else {
- // by default, we assume a constructor compatible with the base
- return new trackType( json.name, json.times, json.values, json.interpolation );
- }
- }
- Object.assign( AnimationClip, {
- parse: function ( json ) {
- const tracks = [],
- jsonTracks = json.tracks,
- frameTime = 1.0 / ( json.fps || 1.0 );
- for ( let i = 0, n = jsonTracks.length; i !== n; ++ i ) {
- tracks.push( parseKeyframeTrack( jsonTracks[ i ] ).scale( frameTime ) );
- }
- const clip = new AnimationClip( json.name, json.duration, tracks, json.blendMode );
- clip.uuid = json.uuid;
- return clip;
- },
- toJSON: function ( clip ) {
- const tracks = [],
- clipTracks = clip.tracks;
- const json = {
- 'name': clip.name,
- 'duration': clip.duration,
- 'tracks': tracks,
- 'uuid': clip.uuid,
- 'blendMode': clip.blendMode
- };
- for ( let i = 0, n = clipTracks.length; i !== n; ++ i ) {
- tracks.push( KeyframeTrack.toJSON( clipTracks[ i ] ) );
- }
- return json;
- },
- CreateFromMorphTargetSequence: function ( name, morphTargetSequence, fps, noLoop ) {
- const numMorphTargets = morphTargetSequence.length;
- const tracks = [];
- for ( let i = 0; i < numMorphTargets; i ++ ) {
- let times = [];
- let values = [];
- times.push(
- ( i + numMorphTargets - 1 ) % numMorphTargets,
- i,
- ( i + 1 ) % numMorphTargets );
- values.push( 0, 1, 0 );
- const order = AnimationUtils.getKeyframeOrder( times );
- times = AnimationUtils.sortedArray( times, 1, order );
- values = AnimationUtils.sortedArray( values, 1, order );
- // if there is a key at the first frame, duplicate it as the
- // last frame as well for perfect loop.
- if ( ! noLoop && times[ 0 ] === 0 ) {
- times.push( numMorphTargets );
- values.push( values[ 0 ] );
- }
- tracks.push(
- new NumberKeyframeTrack(
- '.morphTargetInfluences[' + morphTargetSequence[ i ].name + ']',
- times, values
- ).scale( 1.0 / fps ) );
- }
- return new AnimationClip( name, - 1, tracks );
- },
- findByName: function ( objectOrClipArray, name ) {
- let clipArray = objectOrClipArray;
- if ( ! Array.isArray( objectOrClipArray ) ) {
- const o = objectOrClipArray;
- clipArray = o.geometry && o.geometry.animations || o.animations;
- }
- for ( let i = 0; i < clipArray.length; i ++ ) {
- if ( clipArray[ i ].name === name ) {
- return clipArray[ i ];
- }
- }
- return null;
- },
- CreateClipsFromMorphTargetSequences: function ( morphTargets, fps, noLoop ) {
- const animationToMorphTargets = {};
- // tested with https://regex101.com/ on trick sequences
- // such flamingo_flyA_003, flamingo_run1_003, crdeath0059
- const pattern = /^([\w-]*?)([\d]+)$/;
- // sort morph target names into animation groups based
- // patterns like Walk_001, Walk_002, Run_001, Run_002
- for ( let i = 0, il = morphTargets.length; i < il; i ++ ) {
- const morphTarget = morphTargets[ i ];
- const parts = morphTarget.name.match( pattern );
- if ( parts && parts.length > 1 ) {
- const name = parts[ 1 ];
- let animationMorphTargets = animationToMorphTargets[ name ];
- if ( ! animationMorphTargets ) {
- animationToMorphTargets[ name ] = animationMorphTargets = [];
- }
- animationMorphTargets.push( morphTarget );
- }
- }
- const clips = [];
- for ( const name in animationToMorphTargets ) {
- clips.push( AnimationClip.CreateFromMorphTargetSequence( name, animationToMorphTargets[ name ], fps, noLoop ) );
- }
- return clips;
- },
- // parse the animation.hierarchy format
- parseAnimation: function ( animation, bones ) {
- if ( ! animation ) {
- console.error( 'THREE.AnimationClip: No animation in JSONLoader data.' );
- return null;
- }
- const addNonemptyTrack = function ( trackType, trackName, animationKeys, propertyName, destTracks ) {
- // only return track if there are actually keys.
- if ( animationKeys.length !== 0 ) {
- const times = [];
- const values = [];
- AnimationUtils.flattenJSON( animationKeys, times, values, propertyName );
- // empty keys are filtered out, so check again
- if ( times.length !== 0 ) {
- destTracks.push( new trackType( trackName, times, values ) );
- }
- }
- };
- const tracks = [];
- const clipName = animation.name || 'default';
- const fps = animation.fps || 30;
- const blendMode = animation.blendMode;
- // automatic length determination in AnimationClip.
- let duration = animation.length || - 1;
- const hierarchyTracks = animation.hierarchy || [];
- for ( let h = 0; h < hierarchyTracks.length; h ++ ) {
- const animationKeys = hierarchyTracks[ h ].keys;
- // skip empty tracks
- if ( ! animationKeys || animationKeys.length === 0 ) continue;
- // process morph targets
- if ( animationKeys[ 0 ].morphTargets ) {
- // figure out all morph targets used in this track
- const morphTargetNames = {};
- let k;
- for ( k = 0; k < animationKeys.length; k ++ ) {
- if ( animationKeys[ k ].morphTargets ) {
- for ( let m = 0; m < animationKeys[ k ].morphTargets.length; m ++ ) {
- morphTargetNames[ animationKeys[ k ].morphTargets[ m ] ] = - 1;
- }
- }
- }
- // create a track for each morph target with all zero
- // morphTargetInfluences except for the keys in which
- // the morphTarget is named.
- for ( const morphTargetName in morphTargetNames ) {
- const times = [];
- const values = [];
- for ( let m = 0; m !== animationKeys[ k ].morphTargets.length; ++ m ) {
- const animationKey = animationKeys[ k ];
- times.push( animationKey.time );
- values.push( ( animationKey.morphTarget === morphTargetName ) ? 1 : 0 );
- }
- tracks.push( new NumberKeyframeTrack( '.morphTargetInfluence[' + morphTargetName + ']', times, values ) );
- }
- duration = morphTargetNames.length * ( fps || 1.0 );
- } else {
- // ...assume skeletal animation
- const boneName = '.bones[' + bones[ h ].name + ']';
- addNonemptyTrack(
- VectorKeyframeTrack, boneName + '.position',
- animationKeys, 'pos', tracks );
- addNonemptyTrack(
- QuaternionKeyframeTrack, boneName + '.quaternion',
- animationKeys, 'rot', tracks );
- addNonemptyTrack(
- VectorKeyframeTrack, boneName + '.scale',
- animationKeys, 'scl', tracks );
- }
- }
- if ( tracks.length === 0 ) {
- return null;
- }
- const clip = new AnimationClip( clipName, duration, tracks, blendMode );
- return clip;
- }
- } );
- Object.assign( AnimationClip.prototype, {
- resetDuration: function () {
- const tracks = this.tracks;
- let duration = 0;
- for ( let i = 0, n = tracks.length; i !== n; ++ i ) {
- const track = this.tracks[ i ];
- duration = Math.max( duration, track.times[ track.times.length - 1 ] );
- }
- this.duration = duration;
- return this;
- },
- trim: function () {
- for ( let i = 0; i < this.tracks.length; i ++ ) {
- this.tracks[ i ].trim( 0, this.duration );
- }
- return this;
- },
- validate: function () {
- let valid = true;
- for ( let i = 0; i < this.tracks.length; i ++ ) {
- valid = valid && this.tracks[ i ].validate();
- }
- return valid;
- },
- optimize: function () {
- for ( let i = 0; i < this.tracks.length; i ++ ) {
- this.tracks[ i ].optimize();
- }
- return this;
- },
- clone: function () {
- const tracks = [];
- for ( let i = 0; i < this.tracks.length; i ++ ) {
- tracks.push( this.tracks[ i ].clone() );
- }
- return new AnimationClip( this.name, this.duration, tracks, this.blendMode );
- },
- toJSON: function () {
- return AnimationClip.toJSON( this );
- }
- } );
- export { AnimationClip };
|