Skip to content

Commit e05934a

Browse files
committed
Add note about unique object names to KeyframeTrack.html
1 parent 7a56654 commit e05934a

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

docs/api/en/animation/KeyframeTrack.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -126,10 +126,13 @@ <h3>[property:String name]</h3>
126126
</p>
127127

128128
<p>
129-
Note: The track's name does not necessarily have to be unique. Multiple
130-
tracks can drive the same property. The result should be based on a
131-
weighted blend between the multiple tracks according to the weights of
132-
their respective actions.
129+
Note: The track’s name does not necessarily have to be unique. Multiple tracks
130+
can drive the same property, resulting in a weighted blend between the tracks
131+
according to the weights of their respective actions. However, if object names
132+
used for targeting are not unique within the subtree, tracks referencing
133+
those objects by name will only animate the first object encountered, even if
134+
the path is unique. To reliably target distinct objects use UUIDs, or ensure
135+
object names remain unique.
133136
</p>
134137

135138
<h3>[property:Float32Array times]</h3>

0 commit comments

Comments
 (0)