File Menu: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
 
(66 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{learned|what a file menu is| how the file menu relates to the tygron Engine|how to access the File Menu|what functionality the File Menu provides|the general layout of the File Menu|what options are available in the Details Panel|what options are available in the Versions Panel|how to save your project|how to save your project with a new name|how to exit the editor}}
The File menu opens a properties pane and provides access to detailed project information, who can access this project, enables users to save the project, to save different versions of the project and enables users to exit their project. In the {{software}} the file menu is located on the left side of the Ribbon Bar.
 
==What is a File Menu==
 
A File menu is a graphical control element common to most file-handling computer programs. It often appears as the first item in the menu bar, and contains commands relating to the handling of files, such as open, save, print, etc. It may also contain a list of recently edited files.
 
In some operating systems, the file menu also offers commands for closing windows and exiting the current program.
 
==How does the File Menu relate to the Tygron Engine==
 
The File menu opens a properties pane and provides access to detailed project information, who can access this project, enables users to save the project, to save different versions of the project and enables users to exit their project. In the Tygron Engine the file menu is located on the left side of the Ribbon Bar.


==Accessing the File Menu==
==Accessing the File Menu==
[[File:Editor_file_ribbon_header.jpg|200px|left|File Pane]] Selecting the "File" Tab opens the File Menu properties window.<br clear=all>
[[File:Editor_file_ribbon_header.jpg|200px|left|File Pane]] Selecting the "File" Tab from the ribbon header opens the File Menu properties window.<br clear=all>


==File Menu Overview==
==File Menu Overview==
[[File:Editor_file_pane.jpg|450px|right|File Pane]]
[[File:Editor_file_pane.jpg|450px|right|File Pane]]


The File Menu provides access to detailed project information and properties of your project. The menu on the left side provides access to: Details, Versions, Save, Save As and Exit.
The File Menu provides access to detailed project information and properties of your project. The menu on the left side provides access to: [[File_Menu#Details|Details]], [[File_Menu#Versions|Versions]], [[File_Menu#Save|Save]], [[File_Menu#Save_As|Save As]], [[File_Menu#Exit|Exit]].


By default the "Details" menu item opens.
When opening the File Menu, the "Details" menu item opens.


[[File:Editor_file_pane_back.jpg|100px|Back]]
The white arrow on top takes you back to the main view of the editor.<br clear=all>
The white arrow on top takes you back to the main view of the editor.<br clear=all>


Line 29: Line 20:
===Project Name===
===Project Name===


The Details Panel provides access to the name of your project, as provided by the user when initially creating the project.
[[File:Editor_file_pane_project_name.jpg|thumb|200px|right|Project name]]
The name of your project is provided in the Details Panel. The project name is provided by the user when initially creating the project.


===Details===
===Details===


[[File:Editor_file_pane_details.jpg|450px|right|Bottom panel]]
[[File:Editor_file_pane_details.jpg|450px|right|Bottom panel]]
====Playable Stakeholders====
The number of playable stakeholders for your project.
====Language====
The language selected for your project, as provided by the user when initially creating the project.
Currently available Languages: EN / NL
====Map Size====
====Map Size====
 
The current map size of the project. The map size can be displayed in meters or in feet (m or ft). The Map Size was selected when initially creating the project.
The current map size of the project. The map size can be displayed in meters or in feet (m or ft). The Map Size was selected when initially creating the project.  
====Map Center====
 
The map center of your project in longitude /latitude or x / y, depending on the selected Export CRS EPSC Code.
Available map sizes range from 250m x 250m to 3.000m x 3.000m
====Export CRS EPSG Code====
 
The currently selected Coordinate Reference System (CRS) used when [[Export Geo data|exporting Geo data]]. The name is mentioned in the label next to the change CRS button. Clicking on the button opens the [[CRS Selection Panel]].
====Location====
====Timestamp Format====
 
The adjustable [[timestamp]] format used when showing a date in your project. For example, the date of [[Water Overlay]] or [[Heat Stress Overlay]] [[timeframe]] shown in the [[Legend panel]].
The location of your project, described in X, Y coordinates (What coordinates system is this?).  
====Max Attribute Decimals (3-12)====
 
The amount of decimals allowed for [[attributes]] in the [[editor]] interface.
====Project Time Zone====
The [[Time Zone]] of the project. The time zone is automatically selected based on the location when creating a new project. It can be changed however, using the choice box that lists the available time zones.
====Unit System====
====Unit System====
 
The current active Unit System. The Unit System determines which units are being used to display measurements. The Unit System is set when initially creating the project. Available unit systems: [https://en.wikipedia.org/wiki/United_States_customary_units|US Customary (feet)], [https://en.wikipedia.org/wiki/Metric_system| International (metric)], [https://en.wikipedia.org/wiki/Imperial_units| British Imperial System]
The current active Unit System. The Unit System .. which units are being used to display measurements. The Unit System was selected when initially creating the project.
 
Available unit systems: [https://en.wikipedia.org/wiki/United_States_customary_units|US Customary (feet)], [https://en.wikipedia.org/wiki/Metric_system| International (metric)], [https://en.wikipedia.org/wiki/Imperial_units| British Imperial System]
 
====Currency====
====Currency====
The current active [[Currency]]. The Currency was selected when initially creating the project.


The current active Currency. The Currency was selected when initially creating the project.
====Available languages====


Available currencies: US Dollar ($), Euro (€), British Pound Sterling<br clear=all>
The language selected for your project, as provided by the user when initially creating the project. Currently available Languages: EN / NL. Both can be selected, however only one can be active for a session.


----


===Edit Rights===
===Edit Rights===
:''See also: [[Permissions]]''


[[File:Editor_file_pane_rights.jpg|450px|right|Bottom panel]]
[[File:Q1-2016-EditorFilePaneRights.jpg|450px|right|Editor permission rights]]
 
[[File:Q1-2016-EditorFilePaneKeepAlive.jpg|450px|right|Keep editor session alive]]
<br clear=left>
The Edit Rights properties describe which users can access and edit the currently opened project.
The Edit Rights properties describe which users can access and edit the currently opened project.


Line 87: Line 68:
The dropdown-listbox next to the domain provides access to the parameters "None" and "Read" and "Write". This parameter controls if users inside your domain have access to the selected project and if they have read-only access, or can also write (save) the currently selected project.
The dropdown-listbox next to the domain provides access to the parameters "None" and "Read" and "Write". This parameter controls if users inside your domain have access to the selected project and if they have read-only access, or can also write (save) the currently selected project.


====Public (no account required)====
====Tygron Support====


[[File:Editor_file_pane_public.jpg|450px|right|File Pane]]
This parameter grants Tygron Support access to the project. By default the selected parameter is set to "None", so the project can not be viewed or changed by Tygron Support. If the selected parameter is set to "Read" or "Write", Tygron Support can respectively view and change the project data.


This parameter provides access to the [[public availability|public availability]] of the game. If the selected parameter is set to "None", the project is not public. If the selected parameter is set to "Read", the project is public.
Tygron Support will only ask for access after a support request has been made. This is to better shield any proprietary data that your project may contain.
 
When the public parameter is set to "Read", a URL will be generated, which will appear below the "Keep Editor Session Alive" parameter. The "Keep Editor Session Alive" must be checked to make a public game accessible.


====Keep Editor Session alive for one week after last user exit:====
====Keep Editor Session alive for one week after last user exit:====


In most cases, an Editor Session is only alive when there are users connected to a session. Sometimes, you want a session to be active, without anyone being connected all the time. This means a user in a different timezone for example can join this active session. You don't have to keep your own computer connected to the session at all times in this way.<br clear=all>
In most cases, an Editor Session is only alive when there are users connected to a session. Sometimes, you want a session to be active, without anyone being connected all the time. This means a user in a different timezone for example can join this active session. You don't have to keep your own computer connected to the session at all times in this way.<br clear=all>
----


==Versions==
==Versions==
[[File:Editor_file_pane_versions.jpg|450px|right|File Pane]]
[[File:Editor_file_pane_versions.jpg|450px|right|File Pane]]
Versions assist users in saving different versions of a certain project, instead of having to save to a different filename everytime.
[[Project Version|Versions]] assist users in saving different versions of a certain project, instead of having to save to a different filename every time.


The table displays a list of Versions available for this project. The table has 3 colums: Version, Text and Active. The "Version" column displays a linear number, the Text column displays the text as input by the user in the "Description" Field. The "Active" Column displays "Active" next to the Version row which is active.
The table displays a list of Versions available for this project. The table has 3 columns: Version, Text and Active. The "Version" column displays a linear number, the Text column displays the text as input by the user in the "Description" Field. The "Active" Column displays "Active" next to the Version row which is active.


The current project has 3 versions are available: 0 (Base Version), 1 (Version of 12 Aug 2015) and 2 (Version 2). Version 2 is the version which is active, as displayed in the "Active" column.
The current project has 2 versions are available: 0 (Base Version) and a second version 1 with a date; This is an automatically generated name.


===Switching Versions===
===Switching Versions===


You can revert to an old version by closing the Project and switch versions in the Main Menu.
You can revert to an old version by closing the [[Project]] and switch [[Project Version|versions]] in the [[Main Menu]].


"Main Menu" -> "Options" -> "My Account"
"Main Menu" -> "Options" -> "My Account"
<br clear=all>
<br clear=all>


----
==Save==
 
===Save===


Pressing "Save" saves your project data. A spinner will appear indicating that the project is saving. When succesfully saved the spinner will disappear and the screen will indicate a successful save message.  
Pressing "Save" saves your project data. A spinner will appear indicating that the project is saving. When succesfully saved the spinner will disappear and the screen will indicate a successful save message.  
Line 131: Line 106:
</gallery>
</gallery>


----
==Save As==
 
===Save As===
Pressing "Save As" facilitates users in saving the project with a new name.
Pressing "Save As" facilitates users in saving the project with a new name.


The same restrictions apply when creating a new project, between 3-15 characters.
The same restrictions apply when creating a new project, between 3-20 characters.


----
==Exit==


===Exit===
Pressing the exit button exits the Application.


Pressing the exit button exits the Application.  
[[File:Editor_file_pane_save_exit_confirmation_keepalive.jpg|Exiting a project [[session]] with keep alive selected.]][[File:Editor_file_pane_save_exit_confirmation.jpg|Exiting a project [[session]] without keep alive selected.]]


[[File:Editor_file_pane_save_exit_confirmation.jpg|File Pane]]
A popup-message is being displayed asking the user if he would like to save his project. The actions to select depend on whether the project [[session]] should be [[Keep alive|kept alive]].
* Keep alive:
** Pressing "Save" saves the project and exits the application, but keeps the session running on the server for you to join later.
** Pressing "Exit only" exits the application without saving the project. The session is kept running on the server for you to join later. Changes made are still in the session, however, will be lost when the session is closed.
** Pressing Cancel does not save the project and returns the user to the menu.
* Not Keep alive:
** Pressing "Save" saves the project and exits the application. When no other users are connected to the session, the session is closed as well.
** Pressing "Discard" exits the application without saving changes made to the project. When no other users are connected to the session, the session is closed as well.
** Pressing Cancel does not save the project and returns the user to the menu.


A popup-message is being displayed asking the user if he would like to save his project. Pressing "Yes" saves the project and exits the application, pressing "No" exits the application without saving the project.
{{editor ui nav}}

Latest revision as of 11:59, 1 February 2024

The File menu opens a properties pane and provides access to detailed project information, who can access this project, enables users to save the project, to save different versions of the project and enables users to exit their project. In the Tygron Platform the file menu is located on the left side of the Ribbon Bar.

Accessing the File Menu

File Pane

Selecting the "File" Tab from the ribbon header opens the File Menu properties window.

File Menu Overview

File Pane

The File Menu provides access to detailed project information and properties of your project. The menu on the left side provides access to: Details, Versions, Save, Save As, Exit.

When opening the File Menu, the "Details" menu item opens.

Back The white arrow on top takes you back to the main view of the editor.

Details Panel

The Details Panel provides access to project specific characteristics and details.

Project Name

Project name

The name of your project is provided in the Details Panel. The project name is provided by the user when initially creating the project.

Details

Bottom panel

Map Size

The current map size of the project. The map size can be displayed in meters or in feet (m or ft). The Map Size was selected when initially creating the project.

Map Center

The map center of your project in longitude /latitude or x / y, depending on the selected Export CRS EPSC Code.

Export CRS EPSG Code

The currently selected Coordinate Reference System (CRS) used when exporting Geo data. The name is mentioned in the label next to the change CRS button. Clicking on the button opens the CRS Selection Panel.

Timestamp Format

The adjustable timestamp format used when showing a date in your project. For example, the date of Water Overlay or Heat Stress Overlay timeframe shown in the Legend panel.

Max Attribute Decimals (3-12)

The amount of decimals allowed for attributes in the editor interface.

Project Time Zone

The Time Zone of the project. The time zone is automatically selected based on the location when creating a new project. It can be changed however, using the choice box that lists the available time zones.

Unit System

The current active Unit System. The Unit System determines which units are being used to display measurements. The Unit System is set when initially creating the project. Available unit systems: Customary (feet), International (metric), British Imperial System

Currency

The current active Currency. The Currency was selected when initially creating the project.

Available languages

The language selected for your project, as provided by the user when initially creating the project. Currently available Languages: EN / NL. Both can be selected, however only one can be active for a session.


Edit Rights

See also: Permissions
Editor permission rights
Keep editor session alive


The Edit Rights properties describe which users can access and edit the currently opened project.

Owner

The Owner is the user initially creating the project, often the e-mail address of the user.

The dropdown-listbox next to the user provides access to the parameters "Write" and "Read". This makes it possible to make your project read-only.

Other users in domain

Users are grouped inside a domain, a domain can consist, for example, out of people from the same organisation.

The dropdown-listbox next to the domain provides access to the parameters "None" and "Read" and "Write". This parameter controls if users inside your domain have access to the selected project and if they have read-only access, or can also write (save) the currently selected project.

Tygron Support

This parameter grants Tygron Support access to the project. By default the selected parameter is set to "None", so the project can not be viewed or changed by Tygron Support. If the selected parameter is set to "Read" or "Write", Tygron Support can respectively view and change the project data.

Tygron Support will only ask for access after a support request has been made. This is to better shield any proprietary data that your project may contain.

Keep Editor Session alive for one week after last user exit:

In most cases, an Editor Session is only alive when there are users connected to a session. Sometimes, you want a session to be active, without anyone being connected all the time. This means a user in a different timezone for example can join this active session. You don't have to keep your own computer connected to the session at all times in this way.

Versions

File Pane

Versions assist users in saving different versions of a certain project, instead of having to save to a different filename every time.

The table displays a list of Versions available for this project. The table has 3 columns: Version, Text and Active. The "Version" column displays a linear number, the Text column displays the text as input by the user in the "Description" Field. The "Active" Column displays "Active" next to the Version row which is active.

The current project has 2 versions are available: 0 (Base Version) and a second version 1 with a date; This is an automatically generated name.

Switching Versions

You can revert to an old version by closing the Project and switch versions in the Main Menu.

"Main Menu" -> "Options" -> "My Account"

Save

Pressing "Save" saves your project data. A spinner will appear indicating that the project is saving. When succesfully saved the spinner will disappear and the screen will indicate a successful save message.

"Project ... was successfully saved"

How to save your project:
  1. File -> Save
  2. Spinner appears
  3. Confirmation message


Save As

Pressing "Save As" facilitates users in saving the project with a new name.

The same restrictions apply when creating a new project, between 3-20 characters.

Exit

Pressing the exit button exits the Application.

Exiting a project session with keep alive selected.Exiting a project session without keep alive selected.

A popup-message is being displayed asking the user if he would like to save his project. The actions to select depend on whether the project session should be kept alive.

  • Keep alive:
    • Pressing "Save" saves the project and exits the application, but keeps the session running on the server for you to join later.
    • Pressing "Exit only" exits the application without saving the project. The session is kept running on the server for you to join later. Changes made are still in the session, however, will be lost when the session is closed.
    • Pressing Cancel does not save the project and returns the user to the menu.
  • Not Keep alive:
    • Pressing "Save" saves the project and exits the application. When no other users are connected to the session, the session is closed as well.
    • Pressing "Discard" exits the application without saving changes made to the project. When no other users are connected to the session, the session is closed as well.
    • Pressing Cancel does not save the project and returns the user to the menu.