1,112
edits
FGCamera: Difference between revisions
Jump to navigation
Jump to search
no edit summary
No edit summary |
No edit summary |
||
| Line 6: | Line 6: | ||
| title = FGCamera Add-on | | title = FGCamera Add-on | ||
| initialrelease = Mar 2014 | | initialrelease = Mar 2014 | ||
| latestrelease = 1.2. | | latestrelease = 1.2.7, Nov 9, 2024 | ||
| description = Alternate Camera Manager System | | description = Alternate Camera Manager System | ||
| developmentstatus = Under active development as of 08/2014 | | developmentstatus = Under active development as of 08/2014 | ||
| developedby = Marius_A (since 03/2014 to 2017), Slawek Mikula (2017-2022), Roman Ludwicki (2023) | | developedby = Marius_A (since 03/2014 to 2017), Slawek Mikula (2017-2022), Roman Ludwicki (2023-now) | ||
| type = Addon | | type = Addon | ||
| writtenin = Nasal | | writtenin = Nasal | ||
| Line 64: | Line 64: | ||
[[File: FGCaaera-main-dialog.png|thumb|Main Dialog]] | [[File: FGCaaera-main-dialog.png|thumb|Main Dialog]] | ||
First top section has following buttons: | |||
* "Import..." button allows you to load a camera preset for a specific aircraft. This is a good option for a start, where you don't have to create cameras from scratch, and you can always modify the loaded set. | |||
* "New camera..." button for create a new camera (opens new camera creation dialog). | |||
* "Options..." button opens FGCamera's global settings dialog. | * "Options..." button opens FGCamera's global settings dialog. | ||
* "?" button opens help dialog. | * "?" button opens help dialog. | ||
In the next section, the list of cameras shows all the cameras that are created for the currently selected aircraft. Each camera has its own index, which is also an assigned key from {{key press|1}}, {{key press|2}} to {{key press|0}} for switching between cameras. Group (or category) of each camera is displayed as a suffix in square brackets (zero as default <code>[0]</code>). The active camera (currently selected view) is marked by <code><-</code>. | |||
You can change order of the selected camera by using "Up" and "Dn" buttons. | |||
In the bottom you have "Current camera" section with controls assigned to selected camera: | |||
* The active camera be renamed using input box below the list of cameras. The second input box is used to define camera group. | * The active camera be renamed using input box below the list of cameras. The second input box is used to define camera group. | ||
* | * Combobox to change current group of the selected camera (thanks to this you will be able to switch between cameras of the same group only using a mini-dialog), | ||
* "Copy camera" button creates a copy of currently selected camera, | |||
* "Confirm position" button, which you have to click after changing the position and rotation of the camera, to store the position and not lose it when switching to another camera. '''NOTE! This is needed to clearly indicate that you want to change the camera position and not that you were just looking around'''. | |||
* "Config..." button opens configuration dialog of current selected camera. | * "Config..." button opens configuration dialog of current selected camera. | ||
* "Delete" button removes the active camera. | * "Delete" button removes the active camera. | ||
* " | |||
* " | Bottom row of buttons: | ||
* "Save & close" button saves all the cameras data to disk and close main dialog. | |||
* "Save" button saves all the cameras data to disk. | |||
* "Close" closes the dialog (changes will not be saved to disk). | * "Close" closes the dialog (changes will not be saved to disk). | ||
| Line 94: | Line 104: | ||
* Keys | * Keys | ||
** "Use Ctrl with numeric key" – By default, FGCamera overrides the default number key assignments, {{key press|0}} to {{key press|9}}, using them to switch between cameras. This means you won't be able to use the number keys to control the aircraft, such as the {{key press|5}} key to return the controls to neutral position, etc. Then you can enable this option to make FGCamera override the number keys with the {{key press|Ctrl}} key held down. Then FlightGear's default number keys will work, and switching between cameras will be done with {{key press|Ctrl|0}} to {{key press|Ctrl|9}}. By default, this option is disabled. | ** "Use Ctrl with numeric key" – By default, FGCamera overrides the default number key assignments, {{key press|0}} to {{key press|9}}, using them to switch between cameras. This means you won't be able to use the number keys to control the aircraft, such as the {{key press|5}} key to return the controls to neutral position, etc. Then you can enable this option to make FGCamera override the number keys with the {{key press|Ctrl}} key held down. Then FlightGear's default number keys will work, and switching between cameras will be done with {{key press|Ctrl|0}} to {{key press|Ctrl|9}}. By default, this option is disabled. | ||
* Extra handlers – these handlers are optional and most users don't need them, so they are disabled by default. However, you can always enable them as needed. | |||
** "Linux Track" – enable/disable Linux Track handler. | |||
** "TrackIR" – enable/disable TrackIR handler. | |||
Bottom row of buttons: | |||
* "Save" – save all camera configurations and options to a file and close the window. NOTE! This button works like "Save" in the main "FGCamera" window, i.e. it also saves the cameras. | |||
* "Close" – just close the Options window (without saving to disk). | |||
=== "Create new camera" Dialog === | === "Create new camera" Dialog === | ||
| Line 107: | Line 125: | ||
* "Cancel" – closes the dialog. | * "Cancel" – closes the dialog. | ||
=== "Current | === "Current Camera Config" Dialog === | ||
[[File:FGCamera-current-camera-settings-dialog.png|thumb|"Current | [[File:FGCamera-current-camera-settings-dialog.png|thumb|"Current Camera Config" Dialog]] | ||
* "Show popup tip" – if selected, shows view name when the camera is selected. | * "Show popup tip" – if selected, shows view name when the camera is selected. | ||
* "Show 2D panel" – if selected, shows preferred 2D panel when the camera is selected. You can also choose between two panels to show. | * "Show 2D panel" – if selected, shows preferred 2D panel when the camera is selected. You can also choose between two panels to show. | ||
* "Show dialog" – if selected, shows preferred GUI dialog when the camera is selected. First, type the name of the dialog, such as <code>map</code> for map display, then check the checkbox. To find | * "Show dialog" – if selected, shows preferred GUI dialog when the camera is selected. First, type the name of the dialog, such as <code>map</code> for map display, then check the checkbox. To find the available dialog names in FlightGear, use "..." (browse) button. However, the aircraft may have additional dialogs defined. To find out what they are named, search the aircraft source code for the keyword <code>dialog-name</code>. | ||
* "Field of view" – default field of view in degrees. If you want a wider field of view, use a larger value. Default is 65 degrees. | * "Field of view" – default field of view in degrees. If you want a wider field of view, use a larger value. Default is 65 degrees. | ||
* "View movement" – group of inputs that controls view movement between preset views. | * "View movement" – group of inputs that controls view movement between preset views. | ||
| Line 125: | Line 143: | ||
* "DHM" – if selected, enables Dynamic Head Movement configured by "DHM..." button. | * "DHM" – if selected, enables Dynamic Head Movement configured by "DHM..." button. | ||
* "RND" – if selected, enables Random movement generator configured by "RND..." button. | * "RND" – if selected, enables Random movement generator configured by "RND..." button. | ||
* " | * "Nasal" – if selected, enables Nasal scripts configured by "Nasal..." button. | ||
* "Close" – closes the dialog | * "Close" – just closes the dialog. | ||
==== "Dynamic Head Movement" Dialog ==== | ==== "Dynamic Head Movement" Dialog ==== | ||
When selecting "DHM" on the | When selecting "DHM" on the Current Camera Config dialog, user is moved to the options regarding dynamic head movement. There you can define various options regarding this effect. When enabled and configured the camera will move according to defined options the same as normally would move the head of the pilot in the aircraft. | ||
==== "Random View Generator" Dialog ==== | ==== "Random View Generator" Dialog ==== | ||
When selecting "RND" on the | When selecting "RND" on the Current Camera Config dialog, one is moved to the Random View Generator dialog. There you can define predefined random movement. This option can simulate various aircrafts and situations. When selecting "Import" button, you can import predefined Random setting according to plane types e.g. for General Aircraft (GA) type. Using Ground/Air buttons you can define different random generator according to the aircraft state (in Air/on the Ground). | ||
When pressing "Generator 1...", 2, 3 button you can define additional random signal generators, that can feed the data to main random generator engine. | When pressing "Generator 1...", 2, 3 button you can define additional random signal generators, that can feed the data to main random generator engine. | ||
When pressing "Curves" button, you can define additional output gain regarding velocity in knots. | When pressing "Curves" button, you can define additional output gain regarding velocity in knots. | ||
==== "Execute Nasal Script" Dialog ==== | |||
Clicking the "Nasal..." button in the Current Camera Config dialog will open a new window for entering Nasal scripts. | |||
This window is divided into two parts. In the upper part we can enter a script to be executed upon entry to the current camera. In the lower part we can enter a script to exit the current camera. | |||
Each part has a checkbox, checking it means enabling the script execution. This way you can control which scripts are executed, independently from the main checkbox in the Current Camera Config dialog. | |||
For example for Cessna 172P, where when entering the camera we have a script that turns on the flashlight (if ALS is enabled) and when leaving the camera we have the flashlight turned off. | |||
Writing a script in the GUI of the current version of FlightGear is very inconvenient, so for each editor field we have the following buttons: | |||
* "Copy" – copy the script from the editor to the clipboard; | |||
* "Paste" – paste the script from the clipboard to the editor; | |||
* "Clear" – remove everything that the editor window contains. | |||
For writing scripts I recommend using an external editor and here using only the above buttons. | |||
= Keyboard shortcuts = | = Keyboard shortcuts = | ||