Difference between revisions of "IPad Manual"

From Sim Innovations Wiki
Jump to navigation Jump to search
m (Color wheel)
 
(25 intermediate revisions by the same user not shown)
Line 3: Line 3:
=== Installation ===
=== Installation ===


Information on how to install both Air Manager and the X-plane or FSX/P3D plugin, please go [[Air Manager Installation|here]].
For information on how to install Air Manager for iPad, please go [[IPad_Installation |here]].


=== Release notes ===
=== Release notes ===


If you are looking for the release notes for both Air Manager and it's plugins, go [[Air Manager Release Notes|here]].
If you are looking for the release notes for both Air Manager and it's plugins, go [[IPad_Release_notes|here]].


== X-plane and FSX Plugin ==
== Install the Flight Simulator plugin(s) ==


The X-plane and FSX plugin are the bridge between the simulator and Air Manager. The plugin acts as a TCP/IP host, this can be either local or remote. Multiple instances of Air Manager running remote may connect to the same plugin. The FSX plugin works with both FSX and Prepar3D.
In order to connect Air Manager to your flight simulator, you have to install our plugin to your Flight Simulator.<br/>
Information on how to install the flight simulator plugins can be found [[Flight Simulator Plugins Installation | here]].


== Air Manager ==
== User Manual ==


=== Tab: Instruments ===
=== Showing and hiding the menu ===


==== Ribbon menu: Instruments ====
Air Manager can be active in two modes:
* '''Viewing mode''' : All instruments are showing full screen. No additional information is present on the screen.
* '''Edit mode''' : You can configure the active instruments, by adding, removing, moving, scaling and searching the instruments.


[[File:Am21instruments.png|300px|thumb|Instruments]]
It is possible to switch between these modes.
* Viewing mode -> Edit mode : Drag a single finger from the left side of the iPad inwards. It is best to start on the far edge of the iPad screen.
* Edit mode -> Viewing mode : Press the button on the top left part of the screen, that says 'Hide menu'.


In this tab you can start instruments and create instrument panels.  
<ins>When starting Air Manager for the first time, it will be in viewing mode and you will see a black screen (empty panel). Switch to edit mode to add instruments or panels.</ins>


The left side displays a list off all the instruments in the current group. This is called the instrument list.
==== Viewing mode ====
The right side shows detailed information about the instrument you have selected in the instrument list.


===== Adding new instrument(s) =====
The viewing mode is used in normal operation, where you want to only show the instruments you have selected. It is not possible to do stuff like adding, removing or reposition the instruments.
Touch gestures and sent to manipulate the instruments buttons, switches and dials.


Click the Add button, and a window will come up. In the pop-up window you can select the instruments you would like to add. You can select multiple instruments by holding the control-key on your keyboard.
==== Edit mode ====


===== Instrument settings =====
Within edit mode, you are able to add, remove, search and reposition individual instruments.


This section describes all instrument settings. These settings can be changed by selecting an instrument in the instrument list.
* Add an instrument
* Remove an instrument
* Search for an instrument
* Reposition reposition an instrument
* Resize an instrument
* Make instrument fill up available space


* ''''Name'''' : The name of the instrument, you can change this name to whatever you like. Default are the aircraft and instrument type name.
=== Using the menu ===
* ''''Type'''' : The default aircraft and instrument type name.
* ''''Window left'''' : The X-coordinate of the instrument, in other words: how many pixels from the left does the instrument start.
* ''''Window top'''' : The Y-coordinate of the instrument, in other words: how many pixels from the top does the instrument start.
* ''''Window width'''' : The width of the instrument in pixels.
* ''''Window height'''' : The height of the instrument in pixels.
* ''''Preserve aspect ratio'''' : Preserves the aspect ratio when you change either the width or the height.
* ''''Window lock'''' : Locks the position of the instrument, now it can't be moved by clicking and dragging.
* ''''Always on top'''' : When selecting this the instrument will always be on top.
Notes:
<pre style="white-space: normal;">By dragging the instrument to the right place on your desktop, the X and Y coordinates are updated.</pre>


<pre style="white-space: normal;"> Window lock, Always on top and closing the instrument can also be done by right clicking on the instrument.</pre>


===== Show / hide instrument(s) =====
==== Showing active instruments ====


Click the eye-icon on the left of the instrument name to show the instrument. Clicking the eye-icon in the Instrument ribbon menu will show or hide all of the selected instruments. Showing and hiding multiple instruments at once can be done by selecting multiple instruments in the instrument list. Hold the control-key to select multiple instruments.
==== Adding an instrument ====


It is also possible to show or hide all the instruments in the list at once. This can be done by clicking the ''''Show'''' (eye-icon) in the Group ribbon menu.
Press the instrument on the menu to add the instrument. By default, new instruments will be shown on the top left part of the screen.
 
===== Removing instrument(s) =====
 
Select the instrument you want to delete from the instrument list and click the ''''Remove'''' button in the Instrument ribbon menu, or by pressing the delete-key on your keyboard. Select multiple instruments to delete multiple instruments at once.
 
==== Ribbon menu: Group ====
 
===== Selecting a group =====
 
The group icon (colored cubes) on the left side of the Group ribbon menu lets you select the different groups you've created.
 
===== Add a group =====
 
Click the ''''Add'''' button and a new window will come up. The pop-up window has two options:
* ''''Blank Group'''' : This will create a blank group with the name that you have specified.
* ''''Premade Group'''' : Lets you select one of the premade groups. All the necessary instruments will be downloaded automatically.
 
===== Remove a group =====
 
Click the ''''Remove'''' button and select yes to remove the current group. Only the group will be removed, the instruments will not be removed from your computer.
 
===== Show / hide a group =====
 
Click the ''''Show'''' button (open eye-icon) to show all the instruments in the group at once. Click the ''''Hide'''' button (eye-icon with the red cross) to hide all the instruments in the group at once.
 
===== Configure =====
 
Click the ''''Configure'''' button to change the group settings.
* ''''Name'''' : This is the group name that is also shown in the group drop-down list.
* ''''Aircraft'''' : The name of the aircraft, this is optional.
* ''''Preferred window width'''' : This is the width of the group, this is optional and not a setting that will influence the group, it is only for information.
* ''''Preferred window height'''' : This is the height of the group, this is optional and not a setting that will influence the group, it is only for information.
* ''''Compatible with ...'''' : This shows the simulators that are compatible with this group, this is optional and not a setting that will influence the group, it is only for information.
* ''''Description'''' : Description, this is optional.
 
===== Aircraft switch =====
 
Automatic instrument panel switching automatically starts the group of instruments that is linked to an aircraft. Click the ''''Aircraft Switch'''' button to show the aircraft switch settings. Here you can turn on or off aircraft switching and link an aircraft with a group. Select an aircraft and select a group from the drop-down list to link them. Air Manager remembers all the aircraft you've flown, you can delete an aircraft from the list by selecting the aircraft and hitting the delete key on your keyboard.
 
===== Lock =====
This locks the instruments, so you can not drag them around anymore. This prevents you from mistakenly dragging around instruments, especially with touch input.
----
 
=== Tab: Online ===
 
[[File:Am21online.png|300px|thumb|Online]]
 
You can download instruments online for free, from the build in 'store'.
 
After Air Manager has booted it will contact an online server, which contains all available instruments. The number of available instruments is displayed between brackets in the tab.
 
==== Instrument information ====
 
Click the instrument preview image to show a pop-up windows which contains more information about the instrument. The simulator icons on the top of an instrument tile show you which simulators the instrument is compatible with.
 
==== Download an instrument ====
 
Click ''''Get'''' to download an instrument. The button will display ''''Downloading'''', and ''''Remove'''' as soon as it has finished downloading. The instrument is now available for use.


==== Removing an instrument ====
==== Removing an instrument ====


Click the ''''Remove'''' button of the instrument you wish to remove. This can only be done with instrument you already have and are on the latest version (don't require an update).
To remove an instrument, tap the instrument within the menu (Note that you can press the 'active' tab bar button on the bottom left of the screen to show all currently active instruments.
 
==== Updating an instrument ====
 
If there is an instrument update available, the button will show ''''Update''''. Hit the button to update this instrument. To update them all at once, click the ''''Update All'''' button in the Online ribbon menu.
 
----
 
=== Tab: Create/Edit===
 
[[File:Am21createedit.png|300px|thumb|Create/Edit]]
 
In this tab you can create new or edit existing instruments.
On the left you see a list containing all the instruments that you have. When you select an instrument and click ''''Run'''', you will see a list of all the datarefs (X-Plane) and variables (FSX/P3D) that the instrument contains. Here you can send data to the instrument to simulate data coming from the simulator. Fill in the necessary data and press send. The third screen, bottom right, is a debug console. When using '''print(variable)''' in your script, the printed data will be visible in the debug console. Go to the [[Air Manager 2.x Instrument Logic API|logic API]] page To read more about the print function.
 
==== Ribbon menu: Instrument ====
 
===== Create an new instrument =====
Click the ''''New'''' button to start creating an new instrument. The pop-up window gives you the option to create blank instrument, this means no images and code whatsoever, you'll start from scratch. By choosing to clone an existing instrument, you will get a exact copy of the instrument you chose to clone.
 
===== Delete an instrument =====
Not satisfied with your creation or whatever: select the instrument you want to delete and hit the ''''Delete'''' button or press the delete-key on your keyboard. Note that this not only removes the instrument from the list, but it deletes the whole instrument from your computer.
 
==== Ribbon menu: Test ====
 
===== Run =====
Select the instrument you want to test and click ''''Run''''. When the instrument is running, click Run again to reload. You can now send data to your instrument trough the datarefs and variables.
 
===== Stop =====
Click the ''''Stop'''' button to stop the currently running instrument.
 
==== Ribbon menu: Edit ====
 
===== Open Instrument directory =====
 
The ''''Directory'''' button will open the directory containing the selected instrument. In this folder you'll also find the resources folder, which contains all the resources (images, sounds, fonts).
 
===== Edit the logic script =====
 
The ''''Logic Script'''' button opens the instrument logic script in the script/text editor that you've selected as default Lua script editor. If pressing this button gives an error, you've most likely not selected a default program to edit Lua script.
 
===== Edit instrument information =====
 
Instrument details may be edited from this window. This information is automatically written to the info.xml file in the instrument directory.
 
* ''''Aircraft''''                : The name of the aircraft this instrument is part of
* ''''Type''''                    : The type of instrument (e.g. speedometer, altimeter)
* ''''Author''''                  : The name of the author
* ''''Version''''                : Version (1 = V0.01, 100 = V1.00, 200 = V2.00)
* ''''Preferred window width''''  : Default width of the instrument in pixels
* ''''Preferred window height'''' : Default height of the instrument in pixels
* ''''Compatible with...''''      : This tells if the instrument is compatible with a specific simulator
* ''''Description''''            : Extra information
 
==== Ribbon menu: Help ====
 
===== Creation tutorial =====
 
Press the ''''Create'''' button and your browser will take you to the instrument creation tutorial page on our wiki.
 
===== Logic API =====
 
Press the ''''Logic API'''' button and your browser will take you to the page containing all the Air Manager 2.x logic API.
 
===== X-Plane Datarefs =====
 
Press the ''''Datarefs'''' button and your browser will take you to a page containing all the X-Plane datarefs. This is a non-official dataref page, click [http://www.xsquawkbox.net/xpsdk/docs/DataRefs.html this link] to go to the official squawkbox dataref page.
 
===== X-Plane Commands =====
 
Press the ''''Commands'''' button and your browser will take you to a page containing all of the available X-Plane commands. This list is hosted on our wiki, you can also find the commands list in your X-Plane folder: ''X-Plane 10\Resources\plugins\commands.txt''
 
===== FSX/P3D Variables =====
 
Press the ''''Variables'''' button and your browser will take you to the Microsoft Developer Network page containing all the FSX variables. These variables also work with Prepar3D, to see the official Prepar3D variables list click [http://www.prepar3d.com/SDKv2/LearningCenter/utilities/variables/simulation_variables.html here].
 
===== FSX/P3D Events =====
 
Press the ''''Events'''' button and your browser will take you to the Microsoft Developer Network page containing all the FSX events. These events also work with Prepar3D, to see the official Prepar3D variable list click [http://www.prepar3d.com/SDKv2/LearningCenter/utilities/variables/event_ids.html here].
 
===== Github =====
Sim Innovations uses GitHub as a social collaboration platform focused on the development of instruments. Our GitHub contains multiple instrument projects, which are called repositories. Please contact us via email or via Github if you want to contribute to a project or start your own project.
----


=== Tab: Settings ===
==== Searching instruments ====


[[File:Am21settings.png|300px|thumb|Settings]]
To search an instrument, press the search bar on the top left part of the screen, and start typing in keywords for the instrument you are looking for. E.g. these can be keywords  like 'Boeing' or 'altimeter'. A space will separate the keywords.


Change all Air Manager settings from this tab. On the top you see two buttons:
==== Reposition and resize instruments ====
* ''''Clear Cache'''' : Pressing the Clear Cache button deletes all the cache. Cache is used to store (OSM) map data and data from the instrument store. Normally you wouldn't have to press this button, unless you think the amount of cache becomes too high.
* ''''Clear Persistence'''' : Persistence data is data that is stored by user input. Stored frequencies in a Com radio for example. Press the Clear Persistence button to reset all persistence data to it's default value.


==== General settings ====
To reposition an instrument, press the instrument with one finger, and slide your finger to the desired instrument location.
To resize an instrument, make a pinching gesture on the instrument you want to scale.
To make an instrument use all it's surrounding space, double tap on the instrument. It will go as wide and high as it can go, without overlapping other instruments, and by respecting the instrument aspect ratio.


* ''''Flight simulator'''' : Select the flight simulator you are using, this can be X-Plane, FSX or Prepar3D. When you choose a different simulator, be sure to switch this setting, or your instruments will not respond.
==== Add a (pre-made) panel ====
* ''''Input mode'''' : This lets you choose between different input modes. By default this is your mouse, but if you have a touchscreen, you can control buttons, switches and dials with your touchscreen. Choose 'Off' to disable any input.
* ''''Show instruments on Air Manager boot'''' : This toggles the option to let the instruments in the last selected group start automatically when Air Manager boots. When this option is ticked, Air Manager will also automatically minimize to the task bar only showing the instruments. This can be useful when you have a fixed simulator and you want Air Manager to start the same every time.
* ''''Snap instruments'''' : This toggles the option to let instruments snap to screen corners and to the edges of other instruments.


==== Flight simulator connection ====
Above the canvas you see a big + sign, click this button to add a new panel. Either a blank panel, or one of the pre-made panels.


* ''''Flight simulator and Air Manager running on the same computer'''' : Use this option when Air Manager is running on the same computer as the flight simulator software.
==== Edit panel settings ====
* ''''Flight simulator running on remote computer...'''' : Use this option when the flight simulator software is running on a different computer than Air Manager. You will only have to fill in the IP address of the computer that is running the simulator software, Air Manager will automatically setup a connection with the plugin. Air Manager does not have to be installed on the computer that is running the simulator software, only the plugin needs to be installed (X-Plane) or running (FSX/P3D) on the computer that is running the simulator software.


==== Caching ====
Select the panel you want to edit, and click Edit below the panel name. This will bring up a window that lets you edit the panel name, the background color by using the color wheel or remove the panel.
* ''''Cache OpenStreetMap data'''' : This toggles the option to cache OpenStreetMap data. If you fly in the same area as the cached data, then Air Manager does not have to download OpenStreetMap data anymore. This can be useful when you have a slow or unstable internet connection. Here you can also see the amount of cached data.


== Communication between the plugin and Air Manager ==
==== Settings ====


Communication between the plugin and Air Manager is done by using the standard UDP protocol (Ethernet).
You can find the Air Manager settings within the iPad Settings app on your iPad. This is the regular place where you change all your iPad settings and preferences.
Once in the iPad Settings app, scroll down until you see the Air Manager text and logo, and select it. On the right you will be presented with the Air Manager settings.


The plugins will act as a server using '''UDP port 5555''' for the X-Plane plugin and '''UDP port 5556''' for the FSX/P3D plugin. Air Manager acts as a client, which will try to connect on "localhost", using the same ports. If you are not running the simulator software and Air Manager on the same computer, make sure both computers are connected to the same network and there is no firewall blocking the UDP ports.
* Show splash screen: The splash screen is presented to you when you start the app for the first time. Turn this on if you want to see it again.
You can have as many copies of Air Manager connect to the same plugin.
* Show FPS: Let Air Manager show the current frames per second on the top left of the screen.
* High FPS (60 Hz): Normally the number of frames per second is limited to 30, this limits the frames per second to 60.
* Automatically connect to Flight Simulator: Automatically detects the Air Manager plugin from the sim you are running. You don't need to set the IP address and flight simulator. Turn this off if you want to set the IP address and flight simulator manually.
* Manual network address: Fill in the IP address or DNS name of the computer on which your flight simulator is running. This only works when ''Automatically connect to Flight Simulator'' is turned off.
* Manual flight simulator: Choose which flight simulator you want Air Manager to connect to. This only works when ''Automatically connect to Flight Simulator'' is turned off.

Latest revision as of 13:02, 5 June 2020

Introduction

Installation

For information on how to install Air Manager for iPad, please go here.

Release notes

If you are looking for the release notes for both Air Manager and it's plugins, go here.

Install the Flight Simulator plugin(s)

In order to connect Air Manager to your flight simulator, you have to install our plugin to your Flight Simulator.
Information on how to install the flight simulator plugins can be found here.

User Manual

Showing and hiding the menu

Air Manager can be active in two modes:

  • Viewing mode : All instruments are showing full screen. No additional information is present on the screen.
  • Edit mode : You can configure the active instruments, by adding, removing, moving, scaling and searching the instruments.

It is possible to switch between these modes.

  • Viewing mode -> Edit mode : Drag a single finger from the left side of the iPad inwards. It is best to start on the far edge of the iPad screen.
  • Edit mode -> Viewing mode : Press the button on the top left part of the screen, that says 'Hide menu'.

When starting Air Manager for the first time, it will be in viewing mode and you will see a black screen (empty panel). Switch to edit mode to add instruments or panels.

Viewing mode

The viewing mode is used in normal operation, where you want to only show the instruments you have selected. It is not possible to do stuff like adding, removing or reposition the instruments. Touch gestures and sent to manipulate the instruments buttons, switches and dials.

Edit mode

Within edit mode, you are able to add, remove, search and reposition individual instruments.

  • Add an instrument
  • Remove an instrument
  • Search for an instrument
  • Reposition reposition an instrument
  • Resize an instrument
  • Make instrument fill up available space

Using the menu

Showing active instruments

Adding an instrument

Press the instrument on the menu to add the instrument. By default, new instruments will be shown on the top left part of the screen.

Removing an instrument

To remove an instrument, tap the instrument within the menu (Note that you can press the 'active' tab bar button on the bottom left of the screen to show all currently active instruments.

Searching instruments

To search an instrument, press the search bar on the top left part of the screen, and start typing in keywords for the instrument you are looking for. E.g. these can be keywords like 'Boeing' or 'altimeter'. A space will separate the keywords.

Reposition and resize instruments

To reposition an instrument, press the instrument with one finger, and slide your finger to the desired instrument location. To resize an instrument, make a pinching gesture on the instrument you want to scale. To make an instrument use all it's surrounding space, double tap on the instrument. It will go as wide and high as it can go, without overlapping other instruments, and by respecting the instrument aspect ratio.

Add a (pre-made) panel

Above the canvas you see a big + sign, click this button to add a new panel. Either a blank panel, or one of the pre-made panels.

Edit panel settings

Select the panel you want to edit, and click Edit below the panel name. This will bring up a window that lets you edit the panel name, the background color by using the color wheel or remove the panel.

Settings

You can find the Air Manager settings within the iPad Settings app on your iPad. This is the regular place where you change all your iPad settings and preferences. Once in the iPad Settings app, scroll down until you see the Air Manager text and logo, and select it. On the right you will be presented with the Air Manager settings.

  • Show splash screen: The splash screen is presented to you when you start the app for the first time. Turn this on if you want to see it again.
  • Show FPS: Let Air Manager show the current frames per second on the top left of the screen.
  • High FPS (60 Hz): Normally the number of frames per second is limited to 30, this limits the frames per second to 60.
  • Automatically connect to Flight Simulator: Automatically detects the Air Manager plugin from the sim you are running. You don't need to set the IP address and flight simulator. Turn this off if you want to set the IP address and flight simulator manually.
  • Manual network address: Fill in the IP address or DNS name of the computer on which your flight simulator is running. This only works when Automatically connect to Flight Simulator is turned off.
  • Manual flight simulator: Choose which flight simulator you want Air Manager to connect to. This only works when Automatically connect to Flight Simulator is turned off.
Retrieved from "http://siminnovations.com/wiki/index.php?title=IPad_Manual&oldid=3806"