FGCamera: Difference between revisions

Jump to navigation Jump to search
4,392 bytes added ,  7 January 2023
No edit summary
Line 59: Line 59:
[[File: Fgcamera menu item.jpg|thumb]]
[[File: Fgcamera menu item.jpg|thumb]]


Graphical user interface is used to create and manage camera views. FGCamera dialogs can be launched using menubar item ''View/FGCamera (experimental)''.
Graphical user interface is used to create and manage camera views. FGCamera dialogs can be launched using menubar item ''View -> FGCamera''.


Currently, there are three functional dialogs:
== Main Dialog ==
* Main,
[[File: Fgcamera main dialog.jpg|thumb|Main Dialog]]
* Camera creation,
* Current camera settings.


== Main Dialog ==
Main dialog contain following element:
[[File: Fgcamera main dialog.jpg|thumb]]


* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Options..." button opens FGCamera's global settings dialog.
* "Copy" button creates a copy of currently selected camera view,
* "Copy" button creates a copy of currently selected camera,
* "Create new camera..." button opens new camera creation dialog.
* "Create new camera..." button opens new camera creation dialog.
*The list of cameras shows all the camera views that are created for the currently selected aircraft. Each camera view has its own index. The active view (currently selected view) is marked by square brackets. Category of each camera is displayed as a suffix in square brackets.
* "?" button opens help dialog.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* 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|0}} to {{key press|9}} for switching between cameras. Group (or category) of each camera is displayed as a suffix in square brackets. The active view (currently selected view) is marked by <code><-</code>.
* Buttons "U" and "D" are used to rearrange camera views.
* The active camera be renamed using input box below the list of cameras. The second input box is used to define camera group.
* "Del" button removes the active camera.
* Buttons "Up" and "Down" are used to rearrange cameras order.
* "Save" button saves all the cameras data to disk.
* "Config..." button opens configuration dialog of current selected camera.
* "Delete" button removes the active camera.
* "OK" button saves all the cameras data to disk and close main dialog.
* "Apply" 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).


== Camera Creation Dialog ==
=== "FGCamera options" Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]
 
Clicking "Options..." button you can define behavior of following options:
 
* Mouse
** "Press and hold right mouse to look around in FGCamera" – FGCamera changes the right mouse button behavior to "Click right mouse to cycle mouse behavior" (see ''File -> Mouse Configuration''). Therefore, check this option if you want to look around while holding down the right mouse button. By default, this option is enabled.
** "Force "Press and hold right mouse to look around" in FG views" – Using FGCamera, you can always switch to FlightGear's default views using the {{key press|V}}/{{key press|Shift|V}} key. Check this option if you would like to look around in this mode by holding  down the right mouse button. By default, this option is enabled.
* Mini-dialog
** "Enable mini-dialog" – enable/disable displaying the mini-dialog, in the lower left corner of the screen. Enabled by default.
** "Mini-dialog type" – you can choose a "simple" mini-dialog or "slots" which additionally includes 0 to 9 buttons for changing cameras. By default, "simple" mini-dialog is using.
** "Auto hide mini-dialog" – enabling this option will cause that by default the mini-dialog will be hidden, only pointing the mouse cursor to the lower left corner of the screen will display the mini-dialog. By default, this option is disable.
* 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.
 
=== "Create new camera" Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb|"Create new camera" Dialog]]


* "Camera type" popup list is used to select camera type. Supported types:
* "Camera type" popup list is used to select camera type. Supported types:
** cockpit,
** "cockpit" – view from cockpit,
** aircraft (look at),
** "aircraft (look at) – view on aircraft,
** aircraft (look from),
** "aircraft (look from)" – view from the aircraft to the outside world,
** world (look from);
** "world (look at) n/a" – any perspective,
* "Create" – creates new camera view and selects it as an active camera.
** "world (look from)" – any perspective,
* "Create" – creates new camera and selects it as an active camera.
* "Cancel" – closes the dialog.
* "Cancel" – closes the dialog.


== "Current camera settings" Dialog ==
=== "Current camera settings" Dialog ===
[[File: Fgcamera camera settings dialog.jpg|thumb]]
[[File: Fgcamera camera settings dialog.jpg|thumb|"Current camera settings" Dialog]]


* Show popupTip - if selected, shows view name when the camera is selected;
* "Show popup tip" – if selected, shows view name when the camera is selected.
* Show dialog - if selected, shows preferred GUI dialog 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.
* FOV – field of view;
* "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 more dialog names, edit the <code>gui/menubar.xml</code> file in your FGData directory of your FlightGear installation and search this file for the <code><dialog-name></code> tag. The names putting there are the names of the dialogs you can enter to this option.
* View movement – group of inputs that controls view movement between preset views:
* "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.
** Transition time – time to move camera from current position to preset position.
* "View movement" – group of inputs that controls view movement between preset views.
* View adjustment – group of inputs that controls view adjustment behavior:
** Transition time" – time to move camera from current position to preset position. Default is 1 second.
** Linear velocity – translational velocity of camera in meters per second,
* "View adjustment" – group of inputs that controls view adjustment behavior:
** Angular velocity – angular velocity of camera in degrees per second.
** "Linear velocity" – translational velocity of camera in meters per second.
** Lowpass filter – "smoothness" of the camera movement.
** "Angular velocity" – angular velocity of camera in degrees per second.
** "Lowpass filter" – "smoothness" of the camera movement.
* Mouse look – group of inputs that controls mouse look behaviour:
* Mouse look – group of inputs that controls mouse look behaviour:
** Mouse sensitivity – self explanatory,
** "Mouse sensitivity" – self explanatory.
** Lowpass filter – "smoothness" of the camera movement.
** "Lowpass filter" – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "DHM" – if selected, enables Dynamic Head Movement configured by "DHM..." button.
* "Cancel" – closes the dialog (current camera position will not be saved).
* "RND" – if selected, enables Random movement generator configured by "RND..." button.
* "Store position" – saves current camera position (does not write to disk).
* "Close" – closes the dialog (current camera position will not be saved).
 
==== "Dynamic Head Movement" Dialog ====
 
When selecting "DHM" on the camera setting 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 ====
 
When selecting "RND" on the camera settings 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 "Curves" button, you can define additional output gain regarding velocity in knots.


= Controls =
= Controls =
1,092

edits

Navigation menu