====== Pipeline Favorites ======
**Pipeline Favorites** is a very powerful way for you to list your pipeline scripts as a **Table of Contents** and easily access a existing pipelines that are frequently used in your workflow. Your list of pipeline scripts can be viewed or run from the **Pipeline Favorites** list box. The image below shows how you can access your pipeline favorite scripts from the **Pipeline** Menu.

{{:visual3d:documentation:pipeline:general_information:pipeline_favourites.png?600|}}\\
\\
Your list of favorites can also be accessed by clicking **Alt + W**.
==== Setup Default Script Folder ====
When Visual3D is installed, there are typically no pipelines made available to the favorites, so the list box is empty.

{{:PipelineFavoritesDlg1.jpg}}

The pipeline favorites is populated based on data in the default Script Repository Folder. The **Pipeline Folder** can be edited in the Program Options.

{{:ProgramOptions.jpg}}\\ \\
Any scripts or subfolders within your selected folder will be populated in the list box. 
==== Create Folders ====
On your computer, create a folder for each collection of pipelines in the default script folder. If the default script folder is populated, the pipeline list box will be populated when Visual3D is executed. Any folders within the default script folder that contain pipelines will be populated in the Favorites dialog. If scripts in the default folder aren't arranged into folders they will be populated alongside subfolders containing scripts. 

{{:visual3d:documentation:pipeline:general_information:favorites_list.png?300|}}

=== Viewing and Executing a Script from Favorites List ===

Each of these folders can be expanded to reveal the pipelines stored in the folder. Double clicking with the Left Mouse Button will execute the pipeline script. Execution results can be displayed after running by selecting "Display Results".

{{:visual3d:documentation:pipeline:general_information:expanded_list.png?300|}}

==== Examples ====

To illustrate how to use the pipeline favorites, we list here two pipeline examples that you will setup in your pipeline script folder.

=== Create Favorites Example_1 ===

Create a folder called **Popup_Example_1** in the default script folder. In a text editor, copy the following pipeline commands and save as **Example1.v3s** in the newly created **Popup_Example_1** folder.

<code>
!**************************************************************************
! Pipeline popup example 1 script
!************************************************************************** 

! Starting Fresh - Clear Workspace 
File_New 
;

Set_Pipeline_Parameter_To_Folder_Path 
/PARAMETER_NAME=FOLDER 
/PARAMETER_VALUE= 
! /PARAMETER_VALUE_SEARCH_FOR= 
! /PARAMETER_VALUE_REPLACE_WITH= 
! /PARAMETER_VALUE_APPEND= 
;

! Now ensure that the file open dialogs point to this folder not to the previously opened folders 
Set_Default_Folders 
! /PLUGINS= 
! /SEGMENT_GRAPHICS= 
! /PIPELINE= 
! /REPORT_TEMPLATE= 
/MODEL_TEMPLATE=::FOLDER 
/MOTION_FILE=::FOLDER 
! /DEFAULT_DATA= 
! /CMO_LIBRARY_PATH= 
! /DEFAULT_REPORT_TEMPLATE= 
! /DEFAULT_MODEL_TEMPLATE= 
;

Create_Hybrid_Model 
! /CALIBRATION_FILE= 
! /RANGE=ALL_FRAMES 
;

! Load the Model Template 
Apply_Model_Template 
! /MODEL_TEMPLATE= 
! /CALIBRATION_FILE= 
;

Open_File 
! /FILE_NAME= 
;

Assign_Model_File 
! /CALIBRATION_FILE= 
! /MOTION_FILE_NAMES= 
! /REMOVE_EXISTING_ASSIGNMENTS=FALSE 
;
</code>

=== Create Favorites Example_2: Build Model ===

Create a folder called **Popup_Example_2** in the default script folder. For this example, we will split the commands from **Example1.v3s** into two pipeline scripts. In a text editor, copy the following pipeline commands and save as **Build Model.v3s** in the newly created **Popup_Example_2** folder.

<code>
!**************************************************************************
! Pipeline popup example 2 build model script
!**************************************************************************

! Starting Fresh - Clear Workspace 
File_New 
;

Set_Pipeline_Parameter_To_Folder_Path 
/PARAMETER_NAME=FOLDER 
/PARAMETER_VALUE= 
! /PARAMETER_VALUE_SEARCH_FOR= 
! /PARAMETER_VALUE_REPLACE_WITH= 
! /PARAMETER_VALUE_APPEND= 
;

! now ensure that the file open dialogs point to this folder not to the previously opened folders 
Set_Default_Folders 
! /PLUGINS= 
! /SEGMENT_GRAPHICS= 
! /PIPELINE= 
! /REPORT_TEMPLATE= 
/MODEL_TEMPLATE=::FOLDER 
/MOTION_FILE=::FOLDER 
! /DEFAULT_DATA= 
! /CMO_LIBRARY_PATH= 
! /DEFAULT_REPORT_TEMPLATE= 
! /DEFAULT_MODEL_TEMPLATE= 
;

Create_Hybrid_Model 
! /CALIBRATION_FILE= 
! /RANGE=ALL_FRAMES 
;

! Load the Model Template 
Apply_Model_Template 
! /MODEL_TEMPLATE= 
! /CALIBRATION_FILE= 
;
</code>

=== Create Favorites Example 2: Open Movement Trial ===

In a text editor, copy the remaining two pipeline commands from **Popup_Example1.v3s** and save as **Open Movement Trial.v3s** in the newly created **Popup_Example_2** folder.

<code>
!**************************************************************************
! Pipeline popup example 2 Favorites Open Movement Trial
!**************************************************************************

Open_File 
! /FILE_NAME= 
;

Assign_Model_File 
! /CALIBRATION_FILE= 
! /MOTION_FILE_NAMES= 
! /REMOVE_EXISTING_ASSIGNMENTS=FALSE 
;
</code>

=== Executing a Pipeline from the Favorites Dialog ===

When Visual3D is launched, the Favorites Dialog should look as follows:

{{:visual3d:documentation:pipeline:general_information:popup_favorites.png?400|}}

Each of these items can be expanded.

{{:visual3d:documentation:pipeline:general_information:popup_favorites_expanded.png?400|}}


If the Display Pipeline Results is checked, the Processing Results will be displayed. 

{{:visual3d:documentation:pipeline:general_information:favorites_display_results.png?400|}}

For example the first example pipeline will generate these pipeline results:

{{:PopupWizard5.jpg}}