From e1ebcac6460aa04c79ef840f25df331cf76a573a Mon Sep 17 00:00:00 2001
From: SamaaAhm <150807209+SamaaAhm@users.noreply.github.com>
Date: Mon, 8 Jan 2024 17:03:15 +0100
Subject: [PATCH 1/5] Tutorial for the AnimationRecorder module
---
.../example6/LUT_AnimationRecorder.xml | 12 +++
.../visualization/visualizationexample9.md | 93 ++++++++++++++++++
.../visualization/pathtracer/Example9_1.png | Bin 0 -> 99634 bytes
.../visualization/pathtracer/Example9_4.png | Bin 0 -> 225376 bytes
.../visualization/pathtracer/V9_10.png | Bin 0 -> 144367 bytes
.../visualization/pathtracer/V9_2.png | Bin 0 -> 217024 bytes
.../visualization/pathtracer/V9_3.png | Bin 0 -> 84289 bytes
.../visualization/pathtracer/V9_4.png | Bin 0 -> 225376 bytes
.../visualization/pathtracer/V9_5.png | Bin 0 -> 145422 bytes
.../visualization/pathtracer/V9_6.png | Bin 0 -> 161120 bytes
.../visualization/pathtracer/V9_7.png | Bin 0 -> 143216 bytes
.../visualization/pathtracer/V9_8.png | Bin 0 -> 208750 bytes
.../visualization/pathtracer/V9_9.png | Bin 0 -> 130189 bytes
13 files changed, 105 insertions(+)
create mode 100644 mevislab.github.io/content/examples/visualization/example6/LUT_AnimationRecorder.xml
create mode 100644 mevislab.github.io/content/tutorials/visualization/visualizationexample9.md
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/Example9_1.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/Example9_4.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_10.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_2.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_3.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_4.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_5.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_6.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_7.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_8.png
create mode 100644 mevislab.github.io/static/images/tutorials/visualization/pathtracer/V9_9.png
diff --git a/mevislab.github.io/content/examples/visualization/example6/LUT_AnimationRecorder.xml b/mevislab.github.io/content/examples/visualization/example6/LUT_AnimationRecorder.xml
new file mode 100644
index 000000000..cb3a4d185
--- /dev/null
+++ b/mevislab.github.io/content/examples/visualization/example6/LUT_AnimationRecorder.xml
@@ -0,0 +1,12 @@
+
+
+
+
+ 3
+ 1
+ 1
+ 0
+ 0 0.129412 0.12549 0.121569 0 41.0678 0 0 0 0 126.099 0.94902 0.54902 0.172549 0 126.101 0.85098 0.556863 0.172549 0.165644 532.897 0.852401 0.555088 0.174324 0.607362 815.437 0.855474 0.551246 0.178166 0.245399 1143.29 0.855474 0.551246 0.178166 0 2047 0.855474 0.551246 0.178166 0
+
+
+
diff --git a/mevislab.github.io/content/tutorials/visualization/visualizationexample9.md b/mevislab.github.io/content/tutorials/visualization/visualizationexample9.md
new file mode 100644
index 000000000..c6043213b
--- /dev/null
+++ b/mevislab.github.io/content/tutorials/visualization/visualizationexample9.md
@@ -0,0 +1,93 @@
+---
+title: "Example 9: Creating Dynamic 3D Animations using AnimationRecorder"
+date: 2024-01-08
+status: "OK"
+draft: false
+weight: 593
+tags: ["Advanced", "Tutorial", "Visualization", "3D", "Vessel Segmentation"]
+menu:
+ main:
+ identifier: "visualization_example9"
+ title: "Creating Dynamic 3D Animations using AnimationRecorder"
+ weight: 593
+ parent: "visualization"
+---
+# Example 9: Creating Dynamic 3D Animations using AnimationRecorder {#TutorialVisualizationExample9}
+
+## Introduction
+In this tutorial, our focus will be on using the `AnimationRecorder` module to generate dynamic and visually appealing animations of our 3D scenes. We'll be recording the results of our previous project, particularly the detailed visualizations of the muscles, bones and blood vessels created using `PathTracer`.
+
+## Steps to do
+
+Open the network of Example 6.2: Visualisation using `PathTracer`, add a `SoSeparator` and an `AnimationRecorder` into your workspace and connect them as shown down below.
+
+`SoSeparator`’s role is to isolate and organize scene components, enabling precise control over the animation's focus without affecting the entire scene.
+
+`AnimationRecorder`, equipped with a key frame editor, facilitates smooth transitions between different states of the 3D scene by allowing field additions via drag-and-drop. The tree view allows for easy reordering of fields and modules, enhancing overall organization.
+
+![ AnimationRecorder](/images/tutorials/visualization//pathtracer/Example9_1.png " AnimationRecorder")
+
+Define the following LUTs in `SoLUTEditor` of the knee or load this [XML file](/examples/visualization/example6/LUT_AnimationRecorder.xml) to use a pre-defined LUT.
+
+![ SoLUTEditor](/images/tutorials/visualization//pathtracer/V9_2.png " SoLUTEditor")
+
+
+Open the `AnimationRecorder` module and click on *New* to initiate a new animation, selecting a filename for the recorded video.
+
+At the bottom of the `AnimationRecorder` panel, you'll find the key frame editor, which is initially enabled. It contains the camera track with a key frame at position *0*. The key frame editor at the bottom serves as a control hub for playback and recording.
+
+![ AnimationRecorder](/images/tutorials/visualization//pathtracer/Example9_4.png " AnimationRecorder")
+
+Open the `AnimationRecorder` panel and locate the key frame editor. Move to the desired timepoint on the timeline, adjusting the camera to the preferred position in your 3D scene. Upon double-clicking on the timeline at the chosen timepoint, a Key frame will be added and a window labeled *Edit Camera Key Frame* will open.
+
+Within the *Edit Camera Key Frame* window, set the camera position as desired. Save each key frame by clicking on the *Store Current Camera State* button.
+Repeat this process for each timepoint where adjustments to the camera position are needed, thus creating a sequence of key frames. Ensure to set the *Duration* of the animation to *45* seconds.
+
+Before proceeding further, use the playback options situated at the base of the key frame editor. This allows for a quick review of the initial camera sequence, ensuring the adjustments align seamlessly for a polished transition between key frames.
+
+![ AnimationRecorder](/images/tutorials/visualization//pathtracer/V9_5.png " AnimationRecorder")
+
+## Modulating Knee Visibility with LUTRescale in Animation
+
+We want to showcase the complete scene, followed by the bones and vessels, then only the bones, and finally the entire scene once again. Add two `LUTRescale` modules to your workspace and connect them as illustrated down below. This configuration allows you to use the `LUTRescale` to modifiy the index range of the LUT loaded with `LUTLoad`, affecting the rendering of the `SoPathTracerVolume`. The rationale behind using `LUTRescale` is to control the transparency or visibility of elements in the scene at different intervals.
+
+![ LUTRescale](/images/tutorials/visualization//pathtracer/V9_3.png " LUTRescale")
+
+Now, let's shift our focus to highlighting bones and vessels within the animation. Right-click on the `LUTRescale` module, navigate to *Show Window*, and select *Automatic Panel*. This will bring up the control window for the ` LUTRescale` module. Find the field named *targetMax*. You can either drag or drop it directly from the *Automatic Panel*, or alternatively, locate the *Max* field in the *Output Index Range* box within the module panel and then drag and drop it onto the fields section in the `AnimationRecorder` module, specifically under the *Perspective Camera* field.
+
+By linking the *targetMax* field of the `LUTRescale` module to the `AnimationRecorder` in this manner, you establish a connection that allows you to synchronize the visibility of the knee muscles and structures in your animation.
+
+![ LUTRescale & AnimationRecorder](/images/tutorials/visualization//pathtracer/V9_6.png " LUTRescale & AnimationRecorder")
+
+## Animate Bones and Vessels
+
+To initiate the animation sequence, start by adding a key frame at position *0* for the *targetMax* field. Set the *Target Max* value in the *Edit Key Frame – [LUTRescale.targetMax]* window to *1*, and click on the *Store Current Field Value* button to save it.
+
+Next, proceed to add key frames at the same timepoints as the desired key frames of the *Perspective Camera* field's first sequence. For each selected key frame, progressively set values for the *Target Max* field, gradually increasing to *10*. This ensures specific synchronization between the visibility adjustments controlled by the `LUTRescale` module and the camera movements in the animation, creating a seamless transition. This gradual shift visually reveals the bones and vessels while concealing the knee structures and muscles.
+
+To seamlessly incorporate the new key frame at the same timepoints as the *Perspective Camera* field, you have two efficient options. Simply click on the key frame of the first sequence, and the line will automatically appear in the middle of the key frame. A quick double-click will effortlessly insert a key frame at precisely the same position. If you prefer more accurate adjustments, you can also set your frame manually using the *Edit Camera Key Frame - [LUTRescale.targetMax]* window. This flexibility allows for precise control over the animation timeline, ensuring key frames align precisely with your intended moments.
+
+![ LUTRescale & AnimationRecorder](/images/tutorials/visualization//pathtracer/V9_7.png " LUTRescale & AnimationRecorder")
+
+## Showcasing only Bones
+
+To control the visibility of the vessels, right-click on the ` LUTRescale1` module connected to the vessels. Open the *Show Window* and select *Automatic Panel*. Effortlessly drag and drop the *targetMax* field into the `AnimationRecorder` module's fields section.
+
+![ LUTRescale1 & AnimationRecorder](/images/tutorials/visualization//pathtracer/V9_8.png " LUTRescale1 & AnimationRecorder")
+
+Add key frames for both the *Perspective Camera* field and the *targetMax* in `LUTRescale1` at the same timepoints. Access the *Edit Camera Key Frame* window for the added key frame in the *Perspective Camera* field and save the *current camera state*. To exclusively highlight only bones, adjust the *Target Max* values from *1* to *10000* in *Edit Key Frame - [LUTRescale1.targetMax]*.
+
+![ LUTRescale1 & AnimationRecorder](/images/tutorials/visualization//pathtracer/V9_9.png " LUTRescale1 & AnimationRecorder")
+
+To feature everything again at the end, copy the initial key frame of each field and paste it at the end of the timeline. This ensures a comprehensive display of all elements in the closing frames of your animation.
+
+![ Final Animation Sequence Key Frames](/images/tutorials/visualization//pathtracer/V9_10.png " Final Animation Sequence Key Frames")
+
+Finally, use the playback and recording buttons at the bottom of the key frame editor to preview and record your animation.
+
+## Summary
+* The animation was created by placing key frames strategically at different timepoints in the timeline using the `AnimationRecorder` module.
+* Smooth transitions were ensured for both camera movements and visibility adjustments.
+* The `LUTRescale` module played a vital role in controlling vessel visibility and emphasizing bones.
+* Playback was utilized throughout the process for previewing and making necessary adjustments.
+* The final animation was recorded with a duration of 45 seconds.
\ No newline at end of file
diff --git a/mevislab.github.io/static/images/tutorials/visualization/pathtracer/Example9_1.png b/mevislab.github.io/static/images/tutorials/visualization/pathtracer/Example9_1.png
new file mode 100644
index 0000000000000000000000000000000000000000..78fd3fad5dcc7713a34a84043fd48e307d7e8ad8
GIT binary patch
literal 99634
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 |