Differences

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

--- visual3d:documentation:pipeline:report_commands:add_an_image_to_a_report [2024/06/26 20:07] – removed sgranger
+++ visual3d:documentation:pipeline:report_commands:add_an_image_to_a_report [2024/07/17 15:46] (current) – created sgranger
@@ Line 1: / Line 1: @@
+====== Add an Image to a Report ======
+\\
+**To complete this tutorial, please download the sample files [[https://www.has-motion.com/download/Tutorial_Report_AddImage.zip|here]].**
+CreatingReport_Tutorial_Image_blank.cmo will be used in this tutorial
+CreatingReport_Tutorial_Image.cmo contains the completed cmo file
+\\
+**All the steps in this tutorial may also be scripted in a pipeline. To see an example please view the [[Visual3D:Documentation:Pipeline:Report_Commands:Add_an_Image_to_a_Report_Simple_Pipeline|Simple Pipeline]] tutorial.\\
+\\
+More advanced pipelines can be made to add an image to a report, an example is shown [[Visual3D:Documentation:Pipeline:Report_Commands:Add_an_Image_to_a_Report_Advanced_Pipeline|here]].\\
+**\\
+===== Outline =====
+Adding an image to a report can be completely automated using a pipeline script, or images can be manually created.\\
+\\
+**To add an image to a report:**\\
+) The image must be exported from the **Signals and Events tab** by:\\
+a. Setting the 3D View Options\\
+b. Setting the camera perspective\\
+c. Exporting the image by going to File -> Export Animation Frame to Image\\
+) The image can then be added to the report by selecting **"Image"** as the item to add from the **Report tab**\\
+\\
+\\
+**NOTE:** Images are specific to the subject and are saved within the cmo file, not the report template.\\
+\\
+===== Export Animation Frame to Image =====
+\\
+==== Prepare the image for export ====
+\\
+Export the first image of the sagittal view of the subject.\\
+|1. **Set the current frame** to 239\\   |  {{:ReportAddImage_CurrentFrame.jpg}}|
+|2. Modify **3D Animation View Options**\\ \\ \\ a. Set the **Background** to White\\ \\ b. **Turn off:**\\ \\ Lab/Floor\\ \\ Lab Axes\\ \\ Landmarks\\ \\ Targets\\ \\ Segment Coordinate System Axes\\ \\ c. Close the 3D Animation View Options dialog box  |  {{:ReportAddImage_3DViewOptions.jpg}}|
+|3. Set the **camera perspective** to the sagittal view of the subject\\ \\ \\ **NOTE:** The perspective seen in the 3D viewer will the exported perspective.  |  {{:ReportAddImage_SkeletonSagittal.jpg}}  |
+==== Export the image ====
+\\
+|After setting the 3D viewer options, export the image by going to:\\ 1. The **File** drop down menu\\ 2. Selecting **Export Animation Frame to Image**\\ \\ \\ a.**Browse** to the location to export the image  |  {{:ReportAddImage_FileExportImage.jpg}}|
+\\
+==== Export Image 2 - A/P View ====
+Follow the same instructions as for the first image, but change the camera export perspective to the A/P view of the subject and export the image using a different name.
+===== Add the image to the report =====
+|1. Go to the **Reports** Tab\\   |  {{:ReportAddImage_ReportTab.jpg}}|
+|2. Add the **Sagittal view** image by setting **Image** as the "Item to add" and clicking **Add**.  |  {{:ReportAddImage_ItemImage.jpg}}|
+|Set the parameters to the following:\\ \\ \\ a. **Column:** 1\\ \\ b. **Row:** 1\\ \\ c. **Page:** 3\\ \\ c. **Image File Name:** Browse to the sagittal view exported image\\ \\ d. Select **OK**  |  {{:ReportAddImage_ImageSagittal.jpg}}|
+\\
+|3. Add the **A/P view** image by setting **Image** as the "Item to add" and clicking **Add**. Set the parameters to the following:\\ \\ \\ a. **Column:** 1\\ \\ b. **Row:** 2\\ \\ c. **Page:** 3\\ \\ c. **Image File Name:** Browse to the A/P view exported image\\ \\ d. Select **OK**  |  {{:ReportAddImage_ImageAP.jpg}}|
+\\
+|4. The images will be loaded into the report.  |  {{:ReportAddImage_FinalReport.jpg}}|