HAS-Motion Software Documentation

This is an old revision of the document!

---

add image to report 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|add image to report advanced pipeline tutorial]].\\ **\\ sample files may be downloaded [[https://www.has-motion.com/download/tutorial_report_addimage_simplepipeline.zip|here]].\\ creatingreport_tutorial_image_blank.cmo will be used in this tutorial\\ creatingreport_tutorial_image.cmo contains the completed cmo file\\ addimage.v3s is the pipeline script shown below\\ \\ \\ ====== add image to report - simple pipeline ====== **the following script will add the two images of the skeleton to page 3 of the report (seen below) by:**\\ 1) prompt the user for the desired file to export from a list of files in the workspace (default for this example is nwalk0001.c3d)\\ 2) prompt the user for the desired frame to export (default for this example is frame 239)\\ 3) set the view options:\\ a. turn off lab axes, targets, landmarks, & segment coordinate system axes b. set 3d viewer background to white\\ 4) get the trial (without .c3d extension) so the exported filename will contain the trial name\\ 5) set the camera perspective to the sagittal view and export image\\ 6) set the camera perspective to the a/p view and export image\\ 7) switch to report mode & plot the images\\ 8) set the view options back to default values:\\ a. turn on lab axes, targets, landmarks, & segment coordinate system axes\\ b. set 3d viewer background to black\\ **note:** these are not the "default" v3d values, these is my personal preference of what to see in the 3d viewer\\ | reportaddimage_finalreport.jpg | \\ \\ ===== sample script ===== <code> ! ================================================ ! export and add two images to the report ! ================================================ ! ------------------------------------------------ ! prompt the user for the desired image from a ! list of files in the workspace ! ------------------------------------------------ set_pipeline_parameter_to_list_of_tagged_files /parameter_name=files /tag_name=all_files /get_current_selected_files=false /use_short_filenames=true ; prompt_for_pipeline_parameter_value /pipeline_parameter_name=selected_file /prompt=select image file ! /data_type= /default_value=::files ; select_active_file /file_name=*&::selected_file ! /query= ; ! ------------------------------------------------ ! prompt the user for the desired frame ! ------------------------------------------------ prompt_for_pipeline_parameter_value /pipeline_parameter_name=export_frame /prompt=export frame: ! /data_type= /default_value=239 ; ! ------------------------------------------------ ! set the view options: ! turn off lab axes, targets, landmarks, ! segment coordinate system axes (scs) & ! set 3d viewer background to white ! ------------------------------------------------ set_view_options ! /view_graph_animation_frame_line= ! /view_force_platforms= ! /view_grf_butterfly= ! /view_grf= ! /view_grf_cofp= ! /view_freemoment_at_cop= ! /view_force_structure_vector= ! /view_custom_forces= ! /view_joints= /view_lab=false /view_lab_axes=false /view_landmarks=false ! /view_model_com= ! /view_muscles= ! /view_muscles_as_lines= ! /view_muscles_as_cylinders= /view_scs_axes=false ! /view_scs_axes_com= ! /view_segments= ! /view_kinematic_only_segments= ! /view_segment_colorization= ! /view_segment_geometry= ! /view_segment_lines= /view_targets=false ! /view_targets_with_residual_colormap= ! /view_com_trail= ! /view_landmark_trail= ! /view_segment_trail= ! /view_target_trail= ! /view_white_background=false /set_background_color=1+1+1 ; ! ------------------------------------------------ ! remove ".c3d" from the filename so the ! filename may be used in the export ! ------------------------------------------------ set_pipeline_parameter /parameter_name=selected_file_number /parameter_value=::selected_file /parameter_value_search_for=.c3d /parameter_value_replace_with= ! /parameter_value_prefix= ! /parameter_value_append= ; ! ------------------------------------------------ ! set the camera perspective to the sagittal ! view and export image ! ------------------------------------------------ set_camera_perspective ! /use_stationary_camera=true ! /segment= /camera_x_center=0.379 /camera_y_center=-1.228 /camera_z_center=-0.873 /camera_zoom=2.472 /camera_pan=0.825 /camera_tilt=-0.9 ; export_3d_animation_to_image /file_name=*&::selected_file /image_file_name=\\psf\home\desktop\wikitutorials\reporttutorial\addimage_pipeline\&::selected_file_number&_sag.png ! /append_frame_to_filename=false ! /append_c3dname_to_filename=false ! /image_format=png /start_frame=::export_frame ! /end_frame= ! /event_sequence= ! /exclude_events= ! /output_width=640 ! /output_height=480 ; ! ------------------------------------------------ ! set the camera perspective to the a/p ! view and export image ! ------------------------------------------------ set_camera_perspective ! /use_stationary_camera=true ! /segment= /camera_x_center=0.379 /camera_y_center=-1.228 /camera_z_center=-0.873 /camera_zoom=2.493 /camera_pan=-89.175 /camera_tilt=-1.05 ; export_3d_animation_to_image /file_name=*&::selected_file /image_file_name=\\psf\home\desktop\wikitutorials\reporttutorial\addimage_pipeline\&::selected_file_number&_ap.png ! /append_frame_to_filename=false ! /append_c3dname_to_filename=false ! /image_format=png /start_frame=::export_frame ! /end_frame= ! /event_sequence= ! /exclude_events= ! /output_width=640 ! /output_height=480 ; ! ------------------------------------------------ ! switch to report mode & plot the images ! ------------------------------------------------ switch_to_report_mode ! /show_animation=false /page_number=3 ; make_image_item /image_file=\\psf\home\desktop\wikitutorials\reporttutorial\addimage_pipeline\&::selected_file_number&_sag.png /page_number=3 /column_number=1 /row_number=1 ! /column_span=1 ! /row_span=1 ; make_image_item /image_file=\\psf\home\desktop\wikitutorials\reporttutorial\addimage_pipeline\&::selected_file_number&_ap.png /page_number=3 /column_number=1 /row_number=2 ! /column_span=1 ! /row_span=1 ; ! ------------------------------------------------ ! set the view options back to default values: ! (default values are lab dependent) ! turn on lab axes, targets, landmarks, ! segment coordinate system axes (scs) & ! set 3d viewer background to black ! ------------------------------------------------ set_view_options ! /view_graph_animation_frame_line= ! /view_force_platforms= ! /view_grf_butterfly= ! /view_grf= ! /view_grf_cofp= ! /view_freemoment_at_cop= ! /view_force_structure_vector= ! /view_custom_forces= ! /view_joints= ! /view_lab= /view_lab_axes=true /view_landmarks=true ! /view_model_com= ! /view_muscles= ! /view_muscles_as_lines= ! /view_muscles_as_cylinders= /view_scs_axes=true ! /view_scs_axes_com= ! /view_segments= ! /view_kinematic_only_segments= ! /view_segment_colorization= ! /view_segment_geometry= ! /view_segment_lines= /view_targets=true ! /view_targets_with_residual_colormap= ! /view_com_trail= ! /view_landmark_trail= ! /view_segment_trail= ! /view_target_trail= ! /view_white_background= ! /set_background_color=0+0+0 ; </code>