|
@@ -1,17 +1,13 @@
|
|
|
= MotionPath
|
|
|
-:author:
|
|
|
-:revnumber:
|
|
|
-:revdate: 2016/03/17 20:48
|
|
|
-:relfileprefix: ../../
|
|
|
-:imagesdir: ../..
|
|
|
-ifdef::env-github,env-browser[:outfilesuffix: .adoc]
|
|
|
+:revnumber: 2.0
|
|
|
+:revdate: 2020/07/24
|
|
|
|
|
|
|
|
|
A MotionPath describes the motion of a spatial between waypoints. The path can be linear or rounded. You use MotionPaths to remote-control a spatial, or the camera.
|
|
|
|
|
|
[TIP]
|
|
|
====
|
|
|
-If you want to remote-control a whole cutscene with several spatials moving at various times, then we recommened you use MotionPaths together with <<jme3/advanced/cinematics#,Cinematics>>.
|
|
|
+If you want to remote-control a whole cutscene with several spatials moving at various times, then we recommened you use MotionPaths together with xref:cinematic/cinematics.adoc[Cinematics].
|
|
|
====
|
|
|
|
|
|
|
|
@@ -23,14 +19,14 @@ If you want to remote-control a whole cutscene with several spatials moving at v
|
|
|
|
|
|
== What Are Way Points?
|
|
|
|
|
|
-When shooting a movie scene, the director tells actors where to walk, for example, by drawing a series of small crosses on the floor. Cameramen often mount the camera on rails (so called dolly track) so they can follow along complex scenes more easily.
|
|
|
+When shooting a movie scene, the director tells actors where to walk, for example, by drawing a series of small crosses on the floor. Cameramen often mount the camera on rails (so called dolly track) so they can follow along complex scenes more easily.
|
|
|
|
|
|
In JME3, you use MotionPaths to specify a series of positions for a character or the camera. The MotionPath automatically updates the transformation of the spatial in each frame to make it move from one point to the next.
|
|
|
|
|
|
-* *A way point* is one positions on a path.
|
|
|
-* *A MotionPath* contains a list of all way points of one path.
|
|
|
+* *A way point* is one positions on a path.
|
|
|
+* *A MotionPath* contains a list of all way points of one path.
|
|
|
|
|
|
-The final shape of the path is computed using a linear interpolation or a link:http://www.mvps.org/directx/articles/catmull/[Catmull-Rom] spline interpolation on the way points.
|
|
|
+The final shape of the path is computed using a linear interpolation or a link:http://www.mvps.org/directx/articles/catmull/[Catmull-Rom] spline interpolation on the way points.
|
|
|
|
|
|
|
|
|
== Create a MotionPath
|
|
@@ -50,11 +46,11 @@ You can configure the path as follows.
|
|
|
[cols="2", options="header"]
|
|
|
|===
|
|
|
|
|
|
-a| MotionPath Method
|
|
|
-a| Usage
|
|
|
+a| MotionPath Method
|
|
|
+a| Usage
|
|
|
|
|
|
a|path.setCycle(true)
|
|
|
-a|Sets whether the motion along this path should be closed (true) or open-ended (false).
|
|
|
+a|Sets whether the motion along this path should be closed (true) or open-ended (false).
|
|
|
|
|
|
a|path.addWayPoint(vector)
|
|
|
a|Adds individual waypoints to this path. The order is relevant.
|