Difference between revisions of "Using the Project Explorer"

From Flowcode Help
Jump to navigationJump to search
 
(28 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<sidebar>Sidebar: Taking Flowcode Further</sidebar>
+
==Introduction==
[[File:Gen_Using_the_Project_Explorer_01.png|right]]
+
 
 
The '''Project Explorer''' allows the user to quickly and easily manage their program by giving an overview of the current project. [[Editing and Deleting Macros|Macros]] and [[Editing Variables|Variables]] can easily be added, edited or deleted.
 
The '''Project Explorer''' allows the user to quickly and easily manage their program by giving an overview of the current project. [[Editing and Deleting Macros|Macros]] and [[Editing Variables|Variables]] can easily be added, edited or deleted.
  
 +
Which tabs appear and in what order can be selected via [[Global_Settings#UI Trees|File > Global settings > UI Trees tab]]
 +
 +
Icons and Macros can be dragged into the project code window.
 +
 +
[[File:ProjectExplorer.jpg]]
 +
 +
 +
 +
==Icons==
 +
 +
Lists the programming icons allowing you to drag new code icons onto your project.
 +
 +
 +
==Ports==
 +
 +
The Project Explorer shows the available ports for the currently selected device.
 +
 +
You can directly reference these ports in calculations or other expressions and connect components to these ports, by right-clicking the port or clicking on the arrow next to the port name you can select 'List occurrences' which will use the [[Using the Icon Lists Pane|Icon lists pane]] to show where the ports are being used and referenced.
 +
 +
You will also be able to see all the pins that have components connected to them.
 +
 +
[[File:ProjectExplorer_Ports.png]]
 +
 +
 +
==Panels==
 +
 +
Since you can have multiple 2d panels open, this tab will show all the panels that have been added.
 +
 +
There is an option to add more panels if required.
 +
 +
Each panel can be right-clicked on to rename, change the colour, gridlines, etc by selecting properties.
 +
 +
[[file:ProjectExplorer_Panels.png]]
 +
 +
The red exclamation mark is warning you the panel has been closed.
 +
 +
To open the panel, either right-click on the panel name and select show, or double-click on the panel name.
 +
 +
 +
==Variables==
  
Users can hover over items in the Project Explorer which causes an arrow to appear, when this arrow is clicked, a menu will appear with various selectable options.  
+
This section shows all the global constants and [[Creating Variables|variables]] used in the project.
 +
 +
Globals are visible to any macro in the project.  
  
 +
You can add, edit and delete both global constants and variables from this section.
  
'''Ports'''
+
You can also use the 'List occurrences' option previously mentioned to list where these variables are being used.
  
The project explorer shows the available ports for the currently selected device. You can directly reference these ports in calculations or other expressions and connect components to these ports, by right clicking the port or clicking on the arrow next to the port name you can select 'List occurrences' which will use the [[Using the Icon Lists Pane|Icon lists pane]] to show where the ports are being used and referenced.
+
If the speed of the simulation is changed to Fast (with updates) via the '''[[Simulation_Debugger|Simulation debugger]]''', (for this you will need to have the simulation paused) or via '''[[Project_Options#Project Description|Project_Options]]
 +
Then when the simulation is running all the global and local variables (only if within the appropriate call macro) values will be shown.
  
 +
If the simulator is paused then the variable's values can be changed by left-clicking the variable's current values.
  
'''Globals'''
 
  
This section shows all the global constants and variables used in the project. Globals are visible to any macro in the project. You can add, edit and delete both global constants and variables from this section. You can also use the 'List occurrences' option previously mentioned to show where these variables are being used.
+
As well as global variables,  local variables present within the Macro which you currently have selected, if you change the currently selected macro by clicking on another Macro tab in the main flowchart window, this Project Manager tab will update to show you the new local variables associated with the newly selected Macro.
  
  
'''Macros'''
+
==Macros==
  
Displayed is a list of all the macros in the current project, each macro can be expanded and the specific parameters, constants and variables associated with that macro are shown. You can navigate straight to the specific macros, showing them as flowcharts or as source as well as adding, deleting and editing any parameters, constants or variables associated with each macro. Macros in the Project Explorer can be dragged and dropped into the main flowchart.
+
Displayed is a list of all the [[Creating a New Macro|user macros]] in the current project, each macro can be expanded and the specific parameters, constants and variables associated with that macro are shown.
  
 +
You can navigate straight to the specific macros, showing them as flowcharts or as source as well as adding, deleting and editing any parameters, constants or variables associated with each macro.
  
'''[[Component|Components]]'''
+
Macros in the Project Explorer can be dragged and dropped into the main flowchart.
  
In this section there will be a list of all the components used in the project, you will be able to edit the properties, connections and custom code of each individual component. Components in the Project Explorer can be dragged and dropped into the main flowchart.
+
==Components==
  
'''[[Event Reference|Events]]'''
+
This section contains list of all the [[Components|components]] used in the current project, you will be able to edit the [[Component Properties|properties]], connections and custom code of each individual [[Component|component]]. Components in the Project Explorer can be dragged and dropped into the main flowchart.
  
This section allows you to create event macros with ease, it lists all of the available events and shows which event macros you have created, you can use this menu to navigate your existing event macros as well as creating new ones, it also allows you to delete your existing event macros or show them in your flowchart.
 
  
 +
==Events==
  
===Video instructions===
+
Finally, the last section allows you to create [[Simulation Events|event macros]] with ease, it lists all of the available [[Simulation_Functionality#Events|events]] and shows which event macros you have created, you can use this menu to navigate your existing event macros as well as creating new ones, it also allows you to delete your existing event macros or show them in your flowchart.
  
View the [http://www.youtube.com/watch?v=FThkBO3yh-g&list=PLQDWBb7bxuCgg6aJgPJcfXBMzZdLILceQ Introducing the Project Explorer] video to learn more about the Project Explorer, from the basic fundamentals to it's full capabilities which highlights how to use the Project Explorer panel effectively.
+
==Video instructions==
  
<div align="center">
+
View the [http://www.youtube.com/watch?v=FThkBO3yh-g&list=PLQDWBb7bxuCgg6aJgPJcfXBMzZdLILceQ Introducing the Project Explorer] video to learn more about the Project Explorer, including the basic fundamentals as well as the capabilities of each section, the video highlights how to use the Project Explorer panel effectively.
{{#ev:youtube|FThkBO3yh-g|640}}
 
</div>
 

Latest revision as of 16:40, 20 March 2023

Introduction

The Project Explorer allows the user to quickly and easily manage their program by giving an overview of the current project. Macros and Variables can easily be added, edited or deleted.

Which tabs appear and in what order can be selected via File > Global settings > UI Trees tab

Icons and Macros can be dragged into the project code window.

ProjectExplorer.jpg


Icons

Lists the programming icons allowing you to drag new code icons onto your project.


Ports

The Project Explorer shows the available ports for the currently selected device.

You can directly reference these ports in calculations or other expressions and connect components to these ports, by right-clicking the port or clicking on the arrow next to the port name you can select 'List occurrences' which will use the Icon lists pane to show where the ports are being used and referenced.

You will also be able to see all the pins that have components connected to them.

ProjectExplorer Ports.png


Panels

Since you can have multiple 2d panels open, this tab will show all the panels that have been added.

There is an option to add more panels if required.

Each panel can be right-clicked on to rename, change the colour, gridlines, etc by selecting properties.

ProjectExplorer Panels.png

The red exclamation mark is warning you the panel has been closed.

To open the panel, either right-click on the panel name and select show, or double-click on the panel name.


Variables

This section shows all the global constants and variables used in the project.

Globals are visible to any macro in the project.

You can add, edit and delete both global constants and variables from this section.

You can also use the 'List occurrences' option previously mentioned to list where these variables are being used.

If the speed of the simulation is changed to Fast (with updates) via the Simulation debugger, (for this you will need to have the simulation paused) or via Project_Options Then when the simulation is running all the global and local variables (only if within the appropriate call macro) values will be shown.

If the simulator is paused then the variable's values can be changed by left-clicking the variable's current values.


As well as global variables, local variables present within the Macro which you currently have selected, if you change the currently selected macro by clicking on another Macro tab in the main flowchart window, this Project Manager tab will update to show you the new local variables associated with the newly selected Macro.


Macros

Displayed is a list of all the user macros in the current project, each macro can be expanded and the specific parameters, constants and variables associated with that macro are shown.

You can navigate straight to the specific macros, showing them as flowcharts or as source as well as adding, deleting and editing any parameters, constants or variables associated with each macro.

Macros in the Project Explorer can be dragged and dropped into the main flowchart.

Components

This section contains list of all the components used in the current project, you will be able to edit the properties, connections and custom code of each individual component. Components in the Project Explorer can be dragged and dropped into the main flowchart.


Events

Finally, the last section allows you to create event macros with ease, it lists all of the available events and shows which event macros you have created, you can use this menu to navigate your existing event macros as well as creating new ones, it also allows you to delete your existing event macros or show them in your flowchart.

Video instructions

View the Introducing the Project Explorer video to learn more about the Project Explorer, including the basic fundamentals as well as the capabilities of each section, the video highlights how to use the Project Explorer panel effectively.