Documentation

Waypoints

Getting started

Whether you are planning a new flight, preparing your flight computer for a competition, or just getting to know a new area, chances are that you will have to work with waypoints. Cloudstreet offers a number of simple-to-use, but yet powerful tools that will allow you to manage you Waypoint data with ease.

There are two principal areas of the application where you will usually interact with waypoints, the flight map and the waypoint panel. In the map, you can use the waypoint selector to switch between viewing the Crosscountry.aero airfield list, or a waypoint list you have created (including all types of waypoint and airfields you may have created). In the waypoint panel, you will be able to browse waypoint information, edit waypoint information and organize your waypoint data.

airfield-selector

The waypoint selector

 

waypoint-pane

The waypoint pane

To view the waypoint pane go to the My files page and select the Waypoints tab.

Basic waypoint concepts

Waypoint lists

Waypoints are organized into waypoint lists.

There are a number of reasons you may wish to use more than one waypoint list:

Each waypoint lists can contain any number of waypoints, but having very large lists may impact performance when editing or viewing a list.

To view a waypoint list, select it from the list selector:

waypoint-selector

To create a new list, press the + sign to the right of the selector.

Waypoint boxes

There are many ways to view waypoint information, but one of the most convenient ones for browsing through lists is the waypoint box:

waypoint-box

Editing waypoint data

You can edit as many waypoint lists at a time as you wish, editing waypoint data, creating or deleting waypoints within the lists. When you are satisfied with your changes, make sure you press the Save button to persist your changes. The button will turn orange to indicate that there is something to save.

save-orange

If you try to navigate away from the waypoint page without saving your changes, the application will warn you that there is unsaved data.

The waypoints panel

To view the waypoints panel go to the My files page and select the Waypoints tab.

waypoint-pane-expl

Waypoint lists

Waypoints are organized into waypoint lists. To specify what list you are currently working with, select it on the list selector at the top of the waypoints panel.

To create a new list press the + new list button at the right of the list selector or select "New" from the List menu to show the "new waypoint list" dialog. You then have the following options:

Click on the desired tab on the left of the dialog to select the desired option.

If you would like to import a file from a list, press the Choose Files button or simply drag and drop the desired file or files from your file explorer (or Finder on Mac).

To export a list select "Export list" from the List menu or press Ctrl+X. A dialog will show with the available export format options. Click on the file option box you desire to download the file.

You may specify which list loads by default when you first select the waypoints page by selecting the list and then choosing "Make default" from the List menu. You can also specify your home waypoint for each list on the List menu with the "Set home waypoint" option.

After edditing a list, you must save the changes to make them permanent. Please remember that when saving, you will save changes you have currently made in all of the lists. If you would like to save changes for one list, but drop changes you have made to another list, select the list you would like to maintain as is and use the "Revert to saved" option in the List menu to restore that list to the previously saved version.

You can delete entire lists that are of no use to you by selecting the "Delete" option of the List menu.

Browsing waypoints

You can view a waypoint list in a number of ways choosing the desired view mode from the waypoint panel toolbar:

In info view click on a waypoint box entry to view its details, or navigate with the arrow keys accross the list and press Enter to display the current waypoint info. In other views, to display the waypoint info, double-click on its box (table row in list format), or alternativelly its map icon on the map view. In map view, single-clicking on a waypoint will center the map around the selected waypoint.

If you are currently in the new waypoint or edit waypoint mode, you can return to waypoint browsing mode by clicking on the select mode button, or press the P key shortcut.

Creating waypoints

To create a waypoint press the new waypoint button.

If you are entering a waypoint on the map view mode, click the map on the new waypoint position to display the new waypoint dialog.

The new waypoint dialog will display, allowing you to specify the waypoint properties:

To save the waypoint press OK. Please note that this creates the waypoint in the current list, but does not save changes for the list permanently. When you have completed editing of the list, press the Save button to save all your waypoint list modifications.

After you have craeted a waypoint, you may continue adding new waypoints by filling the new waypoint dialog for the next waypoint, or clicking the map at a new location, if you are in map view mode. To finish creating waypoints click on the select mode button. You can also cancel the creation of a new waypoint by clicking the Cancel button or pressing the ESC key to return to the select mode.

Editing Waypoints

To edit a waypoint press the button to enter edit mode. You can then click on waypoints (or double click in list and box mode) to edit waypoints. In info view, you can double-click on a waypoint box to immediately enter edit mode (double-clicking again on the box will take you our of edit mode.

To exit edit mode click on the select mode button or press the ESC key.

While in edit mode you can adjust the waypoint position by dragging the waypoint icon on the map. Please note that you can zoom and pan the map in the normal way, as well as choose different map canvas options.

If you wish to restore a waypoint's data to the currently saved version, you may press the revert button. This will restore the waypoint to the way it was before anhy changes were made on it. Reverting a waypoint will only work if you have not yet presed the Save button, since saving the data to the server will make changes permanent.

Deleting Waypoints

To delete a waypoint click its box (or row on the list or icon on the map) and press the delete button or DEL key. The waypoint will be marked for deletion and will appear with a red stripe accross the right side of its box. To make the deletetion from the list permanent, make sure to press the Save button to finalize your changes once you have finished modifying the list data.

If you wish to undelete a waypoint, you may press the revert button. Undeleting a waypoint will only work if you have not yet pressed the Save button to permanently save the waypoint data changes.

Modifying multiple waypoints

There are times where it is useful to perform the same changes to a number of waypoints. Rather than doing this one-by-one it may be convenient to first make a selection of waypoints and then perform the wanted action in one step. To do this, the waypoint panel allows you to select waypoints and them perform a number of actions collectivelly on them.

To select a waypoint, choose it by clicking its box (or row, or map icon), or navigate to it with the arrow keys and then press the select button or / key. You will notice that selected waypoints have a blue stripe painted on the side of their box.

To unselect a waypoint press the select button or / key on a selected waypoint.

You call also select all visible waypoints (Ctrl+A) deselect all waypoints (Ctrl+D) or invert the selection. All these options are available on the Waypoints menu.

Once you have defined your waypoint selection, you can do the following actions through the Waypoints menu:

You can also group modify the selection with the "Modify selected" option of the menu, or by pressing Ctrl+E.

The modify selected dialog allows you to perform a number of transformations on all of the selected waypoints at one. You can click on the different tabs on the left (Name, Code etc) to set the desired transformations before pressing OK to perform the changes.

This option is especially useful if you are importing a set of data that you need to modify to suit the format you normally use with your waypoints (e.g. changing waypoint names from capitals to Proper Case (i.e. first letter capitalized), or shortening or numbering specific waypoint sets.

Saving changes

Whether you are modifying a single waypoint, deleting waypoints, re-organizing waypoints into different lists or creating new lists, the waypoint panel allows you to do all your required changes without worrying about making a mistake. You will be allowed to switch between lists as much as you want, restore deleted waypoints and revert changed waypoint data. When you are satisfied with the end result, you the have to press the Save button to make all your changes permanent. This includes modifications made to all lists and additions of all lists. After you have saved your changes, you can no longer revert back to the data you had before saving.

An exception to this rule is when you delete an entire list. When you delete a list ("Delete" from the List menu) you will be asked if you want to proceed. If you choose to do so, the list will be permanently deleted without any further action needed on your part.

Please note that if you try to changes pages without having saved any changes you have made, your browser will ask you if you would like to proceed without saving. If you do so, all changes will be lost.

Filtering sorting and searching

There are a number of tools to help you work with big lists of waypoints.

The waypoint search box on the top left of the panel allows you to search for waypoints within the current list by partially entering the waypoint name.

The filter tool allows you to display only those waypoints in a list that meet certain criteria. To activate the filter press the filter button on the top left of the panel.

To filter according to a specific category, deselect the "Show all" option of the category you want and select the values you would like to display. To activate the filter press the OK button. When a list is filtered this will be indicated by the filter button being highlighted. To deactivate a filter click on the filter button and select the Reset button on the filter panel.

The filter tool is specific to every list. If you switch to a new list and want to apply the same filter, you will have to define it again for the new list. If you switch back to a list with a defined filter, this will be activated again. Filters are not saved, so when you reload the waypoints page, all filters will be deactivated.

Please note that if you set a filter and then press "Select all" (Ctrl+A key) only the currently visible waypoints will be selected. This is a useful feature when you want to edit waypoints in a list according to a set of conditions, as you may simply apply a filter, choose to "Select all" and then perform a group action on these waypoints.

A specific filter criterion that is worth mentioning is the distance filter. This allows you to do two different things, either to choose all waypoints which are up to a distance from a specified waypoint, or to choose all waypoints which are up to a specific distance from each other. The second feature is useful when you combine waypoint lists which may share a number of common waypoints. Selecting the "Distance from each other" filter option along with a small distance (300m is the default) allows you to quickly pick out waypoints that are too close to each other. You can then examine them for waypoints that are valid (e.g. a start gate close to the club house) or for waypoints that should be deleted (e.g. to different waypoints for the same airfield).

The selection can be further defined by the "In each grouping" option. The "Show all waypoints" allows you to display all wayoints that match the criterion. You may then browse the map and quickly examine for valid waypoints or waypoints that are not needed. An alternative to this is the "Skip most important waypoint". What this will do is to try to decide which is the most important waypoint in a group of conflicting waypoints (i.e. too close to each other) by examining the type and amount of information and then committing this waypoint from the selection. In this setting, a waypoint which is of airfield type will be preferred over a simple waypoint and one with more data will be preferred over a waypoint with less information. You may quickly delete overlapping waypoints without needing to examine every instance, by applying the distance filter and then selecting all visible waypoints and deleting them. A third option is "Skip first waypoint" which instead of trying to determine which is the best waypoint (and omitting it) will simply omit the first waypoint from each group.

You may sort a list or of waypoints by using the sorting tool, which is activated with the button. You may sort by:

When any other but the default is selected, the sort button is highlighted to indicate custom sorting. Like the filter, the sort tool is specific to each list. Each sort setting will be maintained only for the list it is selected for.

Keyboard shortcuts

There are keyboard shortcuts for most of the common functions on the waypoint panel. These shortcuts are displayed on the menus and also by placing the mouse over a button and waiting foe a tooltip to display.

In general, you can use the arrow keys to move around boxes. The ENTER key usually works as if you have clicked on a box or pressed the OK button, while the ESC key performs the same function as the Cancel button.