Differences

This shows you the differences between two versions of the page.

--- visual3d:documentation:reports:3d_animation_viewer [2024/06/19 12:53] – sgranger
+++ visual3d:documentation:reports:3d_animation_viewer [2024/07/17 15:46] (current) – created sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{==== changing the data file being animated ====
+====== 3D Animation Viewer ======
-changingdatafiles.png\\
+=== Changing the data file being animated ===
+{{:changingdatafiles.png}}\\
-visual3d pipeline commands and animations use the [[visual3d:overview:workspace#active_files|active_file]]. the user can select the active file using the data file combo box.
-==== 3d viewer animation controls ====
+Visual3D pipeline commands and animations use the [[Visual3D:Getting_Started:Workspace#Active_Files|ACTIVE_FILE]]. The user can select the ACTIVE FILE using the data file combo box.
-roll your mouse over the image below for a brief introduction to the various parts of the visual3d™ animation control .
+=== 3D Viewer Animation Controls ===
-animationcontrols.png\\
+Roll your mouse over the image below for a brief introduction to the various parts of the Visual3D™ Animation Control .
+{{:animationcontrols.png}}\\
-the animation controls provide functions that are similar to standard video controls.
-==== controlling the 3d animation window. ====
+The animation controls provide functions that are similar to standard video controls.
-controlling the position and orientation of the camera in the 3d viewer.
+=== Controlling the 3D animation window. ===
-  * the **left mouse button** is used to modify the orientation of the 3d view of the scene. holding down the left mouse button and moving the mouse vertically rotates the scene about the horizontal axis of the scene view, moving the mouse horizontally rotates the scene about an axis parallel to gravity.
+Controlling the position and orientation of the camera in the 3D viewer.
-  * the **right mouse button** is used to modify the scaling of the scene. holding down the right mouse button and moving the mouse outward moves the camera closer to the center of the scene (increases the size of the image displayed).
-  * holding down the **center mouse button** (on a three-button mouse), or both the **left mouse button and right mouse buttons** together, allows the user to shift (translate) the scene from side to side and up or down.
-==== setting the sensitivity of the mouse movements ====
+  * The **left mouse button** is used to modify the orientation of the 3D view of the scene. Holding down the left mouse button and moving the mouse vertically rotates the scene about the horizontal axis of the scene view, moving the mouse horizontally rotates the scene about an axis parallel to gravity.
+  * The **right mouse button** is used to modify the scaling of the scene. Holding down the right mouse button and moving the mouse outward moves the camera closer to the center of the scene (increases the size of the image displayed).
+  * Holding down the **center mouse button** (on a three-button mouse), or both the **left mouse button and right mouse buttons** together, allows the user to shift (translate) the scene from side to side and up or down.
-mousesensitivity.png\\
+=== Setting the sensitivity of the mouse movements ===
+{{:mousesensitivity.png}}\\
-the sensitivity of the 3d transformations of the scene relative to the physical movement of the mouse is determined by several factors. the user does not need to figure out these factors but can modify the effective sensitivity by selecting "modify the mouse rotation sensitivity" under the "properties" menu and determining the preferred sensitivity by trial and error. the sensitivity value is saved to the registry.
-[[visual3d:documentation:dialogs:program_options#3d_view_options|program options]]
+The sensitivity of the 3D transformations of the scene relative to the physical movement of the mouse is determined by several factors. The user does not need to figure out these factors but can modify the effective sensitivity by selecting "Modify the mouse rotation sensitivity" under the "Properties" menu and determining the preferred sensitivity by trial and error. The sensitivity value is saved to the Registry.
-controls what items are displayed in the 3d viewer.
+[[Visual3D:Documentation:Dialogs:Program_Options#3D_View_Options|Program Options]]
+Controls what items are displayed in the 3D viewer.
 \\
-[[#color_map_signal_to_muscle|color map signal to muscle]]
+[[#Color_Map_Signal_To_Muscle|Color Map Signal To Muscle]]
-color a segment or a muscle based on a color lookup table and a signal
+Color a segment or a muscle based on a color lookup table and a signal
-====== animating multiple c3d files ======
+===== Animating Multiple C3D Files =====
-select the following file menu option.
+Select the following file menu option.
-multipleanimationdisplaymenu.png\\
+{{:MultipleAnimationDisplayMenu.png}}\\
-the following dialog will appear allowing you to select the files to be displayed simultaneously. note that the currently active motion file will also be displayed.
+The following dialog will appear allowing you to select the files to be displayed simultaneously. Note that the currently active motion file will also be displayed.
-multipleanimationdisplaydialog.png\\
+{{:MultipleAnimationDisplayDialog.png}}\\
-an example of the resulting animation is as follows:
+An example of the resulting animation is as follows:
-multipleanimationdisplay.gif
+{{:MultipleAnimationDisplay.gif}}
-====== color map signal to muscle ======
+===== Color Map Signal To Muscle =====
-color a segment or a muscle based on a color lookup table and a signal
+Color a segment or a muscle based on a color lookup table and a signal
-under the model menu item, select **color item with signal**
+Under the model menu item, select **Color Item With Signal**
-mapcolorsdlg.png\\
+{{:MapColorsDlg.png}}\\
-select the segment (or muscle) that is to be colored.
+Select the segment (or muscle) that is to be colored.
-select the signal
+Select the signal
-==== pipeline command: map_signal_to_muscle ====
+=== Pipeline Command: Map_Signal_To_Muscle ===
-map a signal to a muscle. the range of the signal is mapped to the default look up table that determines the color that the muscle will be rendered in the 3d animation viewer for a given value of the signal.
+Map a Signal to a Muscle. The range of the signal is mapped to the default look up table that determines the color that the muscle will be rendered in the 3D animation viewer for a given value of the signal.
-|**map_signal_to_muscle**|                                                                            |
+|**Map_Signal_To_Muscle**|                                                                            |
-|**/calibration_file=**  |the name of the link model (standing trial)                                 |
+|**/Calibration_File=**  |The name of the Link Model (Standing Trial)                                 |
-|**/muscle_names=**      |the type of the muscle to be colored by a signal                            |
+|**/Muscle_Names=**      |The type of the muscle to be colored by a signal                            |
-|**/signal_types=**      |the type of signal to be evaluated                                          |
+|**/Signal_Types=**      |The type of signal to be evaluated                                          |
-|**/signal_names=**      |the names of the signals to be evaluated                                    |
+|**/Signal_Names=**      |The names of the signals to be evaluated                                    |
-|**/signal_folder=**     |the name of the signal folder                                               |
+|**/Signal_Folder=**     |The name of the signal folder                                               |
-|**/component=**         |(x, y, z, or magnitude)the component of the signal used to color the muscle.|
+|**/Component=**         |(X, Y, Z, or Magnitude)The component of the signal used to color the muscle.|
-====== camera tracking ======
+===== Camera Tracking =====
-**(have the camera track a segment in the 3d viewer rather than stay stationary in the laboratory.)**
+**(Have the camera track a segment in the 3D viewer rather than stay stationary in the laboratory.)**
-[[https://www.c-motion.com/support/swf_demo.php?swf=setcameraperspective.swf|shockwave demo]]
+[[https://www.c-motion.com/support/SWF_Demo.php?swf=SetCameraPerspective.swf|Shockwave Demo]]
-the default animation viewer allows the user to interactively set the position and orientation of the camera. the scene stays stationary. if the motion capture volume is quite large and the segment of interest is quite specific (e.g. focusing on the pelvis), it can be a nuisance to follow the subject through the volume.
+The default animation viewer allows the user to interactively set the position and orientation of the camera. The scene stays stationary. If the motion capture volume is quite large and the segment of interest is quite specific (e.g. focusing on the pelvis), it can be a nuisance to follow the subject through the volume.
-  * select the position and orientation of the camera with respect to the laboratory coordinate system\\
+  * Select the position and orientation of the camera with respect to the laboratory coordinate system\\
-setcameraperspective.png
+{{:SetCameraPerspective.png}}
-  * select set **camera perspective** from the **view menu**
+  * Select Set **Camera Perspective** from the **View Menu**
-  * save the current camera perspective\\
+  * Save the Current Camera Perspective\\
-savecameraperspective.gif
+{{:SaveCameraPerspective.gif}}
-  * overwrite the existing perspective
+  * Overwrite the existing perspective
-  * select the pelvis segment and select **move camera to track segment cg**\\
+  * Select the pelvis segment and select **Move Camera to Track Segment CG**\\
-trackpelvis.gif
+{{:TrackPelvis.gif}}
-  * play the animation. when the pelvis segment is in view the camera will be focused on the segment. the scene will shift so that the pelvis segments remains in view.\\
+  * Play the animation. When the pelvis segment is in view the camera will be focused on the segment. The scene will shift so that the pelvis segments remains in view.\\
-trackpelvisview.gif
+{{:TrackPelvisView.gif}}
-====== modify the properties of the animated markers ======
+===== Modify the Properties of the Animated Markers =====
-you can modify the size of the targets, landmarks, and joints in three ways.
+You can modify the size of the targets, landmarks, and joints in three ways.
-===== marker size =====
+==== Marker Size ====
-first, by defining the default size of all markers
+First, by defining the default size of all markers
-defaultmarkersize.jpg
+{{:DefaultMarkerSize.jpg}}
-setmarkersize.jpg
+{{:SetMarkerSize.jpg}}
-second, by scaling the size in the data tree. select a signal in the data tree using the right mouse button, then select the item "draw target size"
+Second, by scaling the size in the Data Tree. Select a signal in the data tree using the right mouse button, then select the item "Draw Target Size"
-drawtargetsize.jpg
+{{:DrawTargetSize.jpg}}
-third, by scaling the size by selecting "draw target properties"
+Third, by scaling the size by selecting "Draw Target Properties"
-drawtargetproperties.jpg
+{{:DrawTargetProperties.jpg}}
-setanimationdrawsize.jpg
+{{:SetAnimationDrawSize.jpg}}
-fourth, use a pipeline command. note that this uses the same dialog as above.
+Fourth, use a pipeline command. Note that this uses the same dialog as above.
-[[visual3d:documentation:pipeline:other_commands:set_animation_draw_properties|set_animation_draw_properties]]
+[[Visual3D:Documentation:Pipeline:Other_Commands:Set_Animation_Draw_Properties|Set_Animation_Draw_Properties]]
-/signal_types=
+/SIGNAL_TYPES=
-! /signal_folder=original
+! /SIGNAL_FOLDER=ORIGINAL
-! /signal_names=
+! /SIGNAL_NAMES=
-! /target_size=normal
+! /TARGET_SIZE=NORMAL
-! /override_target_color=true
+! /OVERRIDE_TARGET_COLOR=TRUE
-/target_color=#80ff80
+/TARGET_COLOR=#80FF80
-/draw_trail=true
+/DRAW_TRAIL=TRUE
-! /override_trail_color=true
+! /OVERRIDE_TRAIL_COLOR=TRUE
-/trail_color=#ffff80
+/TRAIL_COLOR=#FFFF80
-/trail_all_frames=true
+/TRAIL_ALL_FRAMES=TRUE
-! /trail_behind=
+! /TRAIL_BEHIND=
-! /trail_ahead=
+! /TRAIL_AHEAD=
 **;**
-===== marker colors =====
+==== Marker Colors ====
-motion capture marker data are displayed in the data tree with four elements (z,y,z, residual).
+Motion Capture marker data are displayed in the data tree with four elements (z,y,z, residual).
-the residual value is a result value from the 3d tracking software. in the c3d file format:
+The residual value is a result value from the 3D tracking software. In the C3D file format:
 a residual value less than zero indicates that the data is unreliable
-a residual value equal to 0 indicates that the data were processed prior to get into visual3d or the original data processing was manual or unknown.
+a residual value equal to 0 indicates that the data were processed prior to get into Visual3D or the original data processing was manual or unknown.
-the default animation view displays the markers as grey spheres.
+The default animation view displays the markers as grey spheres.
+To distinguish the "ORIGINAL" markers that have been processed (e.g. a residual value equal to zero) Visual3D draws them in **red.**
+If the user selects to color the markers by residual, the color of the marker changes from green (near zero residual) to yellow.
+==== Segment Primitives ====
-to distinguish the "original" markers that have been processed (e.g. a residual value equal to zero) visual3d draws them in **red.**
+Segment Primitives can be a useful tool in visualizing the position and orientation of segments in relation to each other. Segment Primitives can either be drawn using the pipeline, or by using the Draw Segment Primitives Dialog, both methods are described [[Visual3D:Documentation:Pipeline:Model_Commands:Drawing_Segment_Primiatives|here]]
-if the user selects to color the markers by residual, the color of the marker changes from green (near zero residual) to yellow.
-===== segment primitives =====
-segment primitives can be a useful tool in visualizing the position and orientation of segments in relation to each other. segment primitives can either be drawn using the pipeline, or by using the draw segment primitives dialog, both methods are described [[visual3d:documentation:pipeline:model_commands:drawing_segment_primiatives|here]]
+===== Example 3D Viewer 1 =====
-====== example 3d viewer 1 ======
+**Draw a Line between 2 Markers**
-**draw a line between 2 markers**
+As of version 4.0 Visual3D does not provide the capability to draw a simple line in the 3D viewer. If only a few lines are being drawn, and the movement trial has been assigned to a Visual3D model, it is possible to create a virtual muscle. The virtual muscle is displayed as a small cylinder in the 3D viewer.
-as of version 4.0 visual3d does not provide the capability to draw a simple line in the 3d viewer. if only a few lines are being drawn, and the movement trial has been assigned to a visual3d model, it is possible to create a virtual muscle. the virtual muscle is displayed as a small cylinder in the 3d viewer.
+In the following example, draw a line between markers S1 and S2, and another line between markers L1 and L2.
-in the following example, draw a line between markers s1 and s2, and another line between markers l1 and l2.
+=== Step 1- Create landmarks ===
-==== step 1- create landmarks ====
+Visual3D muscles are connections between landmarks, so create landmarks coincident with the 4 markers.
-visual3d muscles are connections between landmarks, so create landmarks coincident with the 4 markers.
+{{:Landmark_S1.jpg}}\\
-landmark_s1.jpg\\
+Create similar landmarks for S2, L1, & L2
-create similar landmarks for s2, l1, & l2
+=== Step 2 Create Muscles ===
-==== step 2 create muscles ====
+Switch to the Muscles Tab in Model Builder Mode.
-switch to the muscles tab in model builder mode.
+Enter the name S1S2 into the Name Edit Box.
-enter the name s1s2 into the name edit box.
+Select Create Muscle.
-select create muscle.
+{{:CreateMuscle.jpg}}\\
-createmuscle.jpg\\
+=== Step 3 Add Landmarks to Muscle Definition ===
-==== step 3 add landmarks to muscle definition ====
+Select the landmark in the bottom combo box below
-select the landmark in the bottom combo box below
+select Append Landmark.
-select append landmark.
+Do this for each of the two landmarks.
-do this for each of the two landmarks.
+{{:Muscle_S1S2.jpg}}\\
-muscle_s1s2.jpg\\
+Now do the same for a muscle names L1L2 comprised of landmarks L_L1 & L_L2
-now do the same for a muscle names l1l2 comprised of landmarks l_l1 & l_l2
+=== Step 4 Check the view option to display muscles ===
-==== step 4 check the view option to display muscles ====
+{{:ViewMuscles.jpg}}
-viewmuscles.jpg
-}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}