1 |
<?xml version="1.0" encoding="UTF-8"?>
|
2 |
<!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.0//EN" "https://www.web3d.org/specifications/x3d-3.0.dtd">
|
3 | <X3D profile='Immersive' version='3.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='https://www.web3d.org/specifications/x3d-3.0.xsd'> |
4 | <head> |
5 | <meta name='title' content='CoordinateInterpolator2dPrototype.x3d'/> |
6 | <meta name='description' content='CoordinateInterpolator2D prototype declaration, to interpolate across an array of Vector2FloatArray/MFVec2f values to produce an interpolated Vector2FloatArray - click text to see example.'/> |
7 | <meta name='creator' content='Don Brutzman, Jeff Weekley, Jane Wu'/> |
8 | <meta name='created' content='28 June 2001'/> |
9 | <meta name='modified' content='20 January 2020'/> |
10 | <meta name='reference' content='https://www.web3d.org/technicalinfo/specifications/vrml97/part1/concepts.html#4.6.8'/> |
11 | <meta name='reference' content='https://www.web3d.org/technicalinfo/specifications/vrml97/part1/nodesRef.html#CoordinateInterpolator'/> |
12 | <meta name='subject' content='CoordinateInterpolator2D'/> |
13 | <meta name='identifier' content='https://www.web3d.org/x3d/content/examples/Basic/development/CoordinateInterpolator2dPrototype.x3d'/> |
14 | <meta name='generator' content='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/> |
15 | <meta name='license' content='../license.html'/> |
16 | </head> |
17 | <Scene> |
18 | <WorldInfo title='CoordinateInterpolator2dPrototype.x3d'/> |
19 | <ProtoDeclare name='CoordinateInterpolator2D' appinfo='Provide interpolation capability for Vector2FloatArray/MFVec2f values' documentation='https://www.web3d.org/technicalinfo/specifications/vrml97/part1/concepts.html#4.6.8'> |
20 | <ProtoInterface> |
21 |
<field name='set_fraction' type='SFFloat' accessType='inputOnly'
appinfo='Regular interpolator-style input, the set_fraction eventIn receives an SFFloat event and causes the interpolator function to evaluate resulting in a value_changed eventOut with the same timestamp as the set_fraction event.'/> |
22 | <field name='set_key' type='MFFloat' accessType='inputOnly'/> |
23 |
<field name='key' type='MFFloat' accessType='inputOutput'
appinfo='keyValue holds the array of Vector2FloatArrays that match each animation key.'/> |
24 |
<field name='key_changed' type='MFFloat' accessType='outputOnly'
appinfo='Array sequentially increasing typically [0..1]. Must have the same number of keys as keyValues.'/> |
25 |
<field name='set_keyValue' type='MFVec2f' accessType='inputOnly'
appinfo='Array of integer values. Must have the same number of keys as keyValues.'/> |
26 |
<field name='keyValue' type='MFVec2f' accessType='inputOutput'
appinfo='keyValue holds the array of Vector2FloatArrays that match each animation key.'/> |
27 |
<field name='keyValue_changed' type='MFVec2f' accessType='outputOnly'
appinfo='Array of integer values. Must have the same number of keys as keyValues.'/> |
28 |
<field name='value_changed' type='MFVec2f' accessType='outputOnly'
appinfo='Regular interpolator-style output, the interpolator function averages between respective keyValue Vector2FloatArrays resulting in a Vector2FloatArray value_changed eventOut with the same timestamp as the set_fraction event.'/> |
29 | </ProtoInterface> |
30 | <ProtoBody> |
31 | <Group> |
32 | <Switch whichChoice='-1'> |
33 | |
34 | <IS> |
35 | <connect nodeField='key' protoField='key'/> |
36 | </IS> |
37 | </ScalarInterpolator> |
38 | <Shape> |
39 | <IndexedFaceSet> |
40 |
<!-- TextureCoordinate
KeyValueHolder is a DEF node that has 1 USE node: USE_1 -->
<TextureCoordinate DEF='KeyValueHolder'> |
41 | <IS> |
42 | <connect nodeField='point' protoField='keyValue'/> |
43 | </IS> |
44 | </TextureCoordinate> |
45 | </IndexedFaceSet> |
46 | <Appearance DEF='DefaultAppearance'> |
47 | <Material/> |
48 | </Appearance> |
49 | </Shape> |
50 | </Switch> |
51 | <Script DEF='InterpolationScript' directOutput='true'> |
52 | <field name='set_fraction' type='SFFloat' accessType='inputOnly'/> |
53 |
<field name='fraction' type='SFFloat' value='0.0' accessType='initializeOnly'
appinfo='local variable'/> |
54 | <field name='set_key' type='MFFloat' accessType='inputOnly'/> |
55 | <field name='keyHolderNode' type='SFNode' accessType='initializeOnly'> |
56 | <ScalarInterpolator USE='KeyHolder'/> |
57 | </field> |
58 | <field name='key_changed' type='MFFloat' accessType='outputOnly'/> |
59 | <field name='set_keyValue' type='MFVec2f' accessType='inputOnly'/> |
60 | <field name='keyValueHolderNode' type='SFNode' accessType='initializeOnly'> |
61 | <TextureCoordinate USE='KeyValueHolder'/> |
62 | </field> |
63 | <field name='keyValue_changed' type='MFVec2f' accessType='outputOnly'/> |
64 | <field name='value_changed' type='MFVec2f' accessType='outputOnly'/> |
65 | <IS> |
66 | <connect nodeField='set_fraction' protoField='set_fraction'/> |
67 | <connect nodeField='set_key' protoField='set_key'/> |
68 | <connect nodeField='key_changed' protoField='key_changed'/> |
69 | <connect nodeField='set_keyValue' protoField='set_keyValue'/> |
70 | <connect nodeField='keyValue_changed' protoField='keyValue_changed'/> |
71 | <connect nodeField='value_changed' protoField='value_changed'/> |
72 | </IS> |
<![CDATA[
ecmascript: // internal global persistent variables var previousFraction; var previousFractionIndex; var blockSize; var outputArray; function tracePrint (outputString) { var traceEnabled = false; if (traceEnabled) Browser.println ('[CoordinateInterpolator2D]' + outputString); } function alwaysPrint (outputString) { Browser.println ('[CoordinateInterpolator2D]' + outputString); } function initialize () { key = keyHolderNode.key; keyValue = keyValueHolderNode.point; previousFractionIndex = -1; previousFraction = 0; // check key array ranges [0..1] and is monotonically increasing // check that size of keyValue array is integer multiple of size of key array tracePrint ('key =' + key); tracePrint ('key.length= ' + key.length); tracePrint ('keyValue= ' + keyValue); tracePrint ('keyValue.length=' + keyValue.length); blockSize = keyValue.length/key.length; tracePrint ('blockSize=' + blockSize); if (blockSize != Math.round(blockSize)) { alwaysPrint ('*** warning: blockSize not an integer multiple. check sizes of key and keyValue'); } if (key[0] != 0) { alwaysPrint ('*** warning: key[0] != 0'); } if (key[key.length-1] != 1) { alwaysPrint ('*** warning: key[' + (key.length - 1) + '] != 1, reset from' + key[key.length-1] + ' to 1'); key[key.length-1] = 1; } for (index = 0; index < blockSize; index++) { if ((key[index] < 0) || (key[index] > 1)) { alwaysPrint ('*** warning: key[' + index + '] =' + key[index] + ', out of range [0..1]'); } } // instantiate default array, later computations just update it outputArray = new MFVec2f (); for (index = 0; index < blockSize; index++) { // dynamically grow outputArray to match initial block outputArray[index] = keyValue[index]; } tracePrint ('initial outputArray=' + outputArray); } function set_fraction (inputFloat, timestamp) { fraction = inputFloat; tracePrint ('previousFractionIndex=' + previousFractionIndex + ', fraction=' + fraction + ', previousFraction=' + previousFraction); if (fraction < 0) { tracePrint ('*** illegal fraction' + fraction + ' set to 0'); fraction = 0; previousFractionIndex = 0; // first } else if (fraction > 1) { alwaysPrint ('*** illegal fraction' + fraction + ' set to 1'); fraction = 1; previousFractionIndex = blockSize - 1; // last } else if (previousFractionIndex == -1) { previousFractionIndex = 0; // first tracePrint ('previousFractionIndex initialized for first event'); } else if ((fraction >= previousFraction) && (fraction >= key[previousFractionIndex+1])) { previousFractionIndex++; } else if (fraction < previousFraction) // regress, or loop repeat without reaching one { previousFractionIndex = 0; while ((fraction >= key[previousFractionIndex+1]) && (previousFractionIndex < blockSize)) { previousFractionIndex++; } tracePrint ('reset/reincrement previousFractionIndex to' + previousFractionIndex); } if (fraction == 1) // use final block { tracePrint ('(fraction == 1)'); for (index = 0; index < blockSize; index++) { // update outputArray with final four keyValues outputArray[4 - index] = keyValue[keyValue.length - index]; } previousFractionIndex = -1; // setup for restart tracePrint ('finished final fraction==1 block'); } // when fraction matches index, calculate value_changed from corresponding keyValue array else if (fraction == key[previousFractionIndex]) { tracePrint ('(fraction == key[previousFractionIndex])'); for (index = 0; index < blockSize; index++) { // update outputArray - need to interpolate next outputArray[index] = keyValue[blockSize * (previousFractionIndex) + index]; } } else // calculate value_changed by interpolating between adjacent keyValue arrays { partialFraction = fraction - key[previousFractionIndex]; deltaFraction = key[previousFractionIndex+1] - key[previousFractionIndex]; percentFraction = partialFraction / deltaFraction; // tracePrint ('deltaFraction =' + deltaFraction); // tracePrint ('partialFraction =' + partialFraction); tracePrint ('percentFraction =' + percentFraction); for (index = 0; index < blockSize; index++) { // no arithmetic operators provided for SFVec2f, treat element by element nextKeyValue = keyValue[blockSize * (previousFractionIndex + 1) + index]; priorKeyValue = keyValue[blockSize * (previousFractionIndex) + index]; deltaKeyValue = new SFVec2f ( nextKeyValue[0] - priorKeyValue[0], nextKeyValue[1] - priorKeyValue[1]); // tracePrint ('deltaKeyValue =' + deltaKeyValue); // update outputArray outputArray[index][0] = keyValue[blockSize * (previousFractionIndex) + index][0] + percentFraction * deltaKeyValue[0]; outputArray[index][1] = keyValue[blockSize * (previousFractionIndex) + index][1] + percentFraction * deltaKeyValue[1]; } } value_changed = outputArray; previousFraction = fraction; tracePrint ('value_changed=' + value_changed); } function set_key (inputArray, timestamp) { key = inputArray; // update key Vector2FloatArray keyHolderNode.key = key; // update holder initialize (timestamp); // reverify key, keyValue sizes key_changed = key; // eventOut } function set_keyValue (inputArray, timestamp) { keyValue = inputArray; // update keyValue Vector2FloatArray keyValueHolderNode.point = keyValue; // update holder initialize (timestamp); // reverify key, keyValue sizes keyValue_changed = keyValue; // eventOut }
]]>
|
|
74 | </Script> |
75 | </Group> |
76 | </ProtoBody> |
77 | </ProtoDeclare> |
78 | <!-- ====================================== --> |
79 | <!-- Example use --> |
80 | <Anchor description='CoordinateInterpolator2dExample' parameter='"target=_blank"' url=' "CoordinateInterpolator2dExample.x3d" "https://savage.nps.edu/Savage/Tools/Animation/CoordinateInterpolator2dExample.x3d" "CoordinateInterpolator2dExample.wrl" "https://savage.nps.edu/Savage/Tools/Animation/CoordinateInterpolator2dExample.wrl" '> |
81 | <Shape> |
82 | <Text string='"CoordinateInterpolator2dPrototype" "defines a prototype" "" "Click on this text to see" "CoordinateInterpolator2dExample" " scene"'> |
83 | <FontStyle justify='"MIDDLE" "MIDDLE"' size='0.7'/> |
84 | </Text> |
85 | <Appearance> |
86 | <Material diffuseColor='1 1 0.2'/> |
87 | </Appearance> |
88 | </Shape> |
89 | </Anchor> |
90 | </Scene> |
91 | </X3D> |
Event Graph ROUTE Table with 0 ROUTE connections total, showing X3D event-model relationships for this scene.
Each row shows an event cascade that may occur during a single timestamp interval between frame renderings, as part of the X3D execution model.
InterpolationScript
Script |
No ROUTE connection found for output events from this node. Contains SFNode fields with direct access to another node. |
Anchor |
description='CoordinateInterpolator2dExample' User-interaction hint for this node. |
<!--
Color legend: X3D terminology
<X3dNode
DEF='idName' field='value'/>
matches XML terminology
<XmlElement
DEF='idName' attribute='value'/>
(Light-blue background: event-based behavior node or statement)
(Grey background inside box: inserted documentation)
(Magenta background: X3D Extensibility)
<ProtoDeclare
name='ProtoName'>
<field
name='fieldName'/> </ProtoDeclare>
-->
<!-- For additional help information about X3D scenes, please see X3D Tooltips, X3D Resources, and X3D Scene Authoring Hints. -->