FlightGear wiki - User contributions [en]

Missions

2022-11-15T16:04:59Z

Marius A:

{{Tutorials Navigation}}
{{WIP}}
= Mission objects =

== Actions ==
=== mission-intro-action ===
=== mission-briefing-action ===
<syntaxhighlight lang="xml">
<object>
<type>mission-briefing-action</type>
<skill-level-0-label>...</skill-level-0-label>
<skill-level-1-label>...</skill-level-1-label>
<skill-level-2-label>...</skill-level-2-label>
<skill-level-0-objectives>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-0-objectives>
<skill-level-1-objectives>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-1-objectives>
<skill-level-2-objectives>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-2-objectives>
<skill-level-0-actions>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-0-actions>
<skill-level-1-actions>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-1-actions>
<skill-level-2-actions>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-2-actions>
</object>
</syntaxhighlight>

=== adjust-payload-action ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>adjust-payload-action</type>
<station-id>...</station-id>
<adjustment-type>...</adjustment-type> "set" or "add"; default: "set"
<weight>...</weight>
<units>kg</units> "kg" or "lb"; default: "lb"
</object>
</syntaxhighlight>

=== dialog-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>dialog-action</type>
<text>...</text>
<sound-file>...</sound-file> *.wav
<delay-sec>...</delay-sec>
</object>
</syntaxhighlight>

=== model ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>model</type>
<activated>...</activated> 0/1
<path>...</path>
<orientation>
<heading-deg>...</heading-deg>
<pitch-deg>...</pitch-deg>
<roll-deg>...</roll-deg>
</orientation>
<world-position>
<latitude-deg>...</latitude-deg>
<longitude-deg>...</longitude-deg>
<altitude-m>...</altitude-m>
<altitude-is-AGL>...</altitude-is-AGL> 0/1
</world-position>
</object>
</syntaxhighlight>

=== object-activation-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>object-activation-action</type>
<object-state>...</object-state> 0/1
<reference-list>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</reference-list>
</object>
</syntaxhighlight>

=== random-action ===

=== refuel-action ===

=== single-shot-sound-action ===

=== objective-status-action ===

== Triggers ==
=== airport-landing-trigger ===

=== area-landing-trigger ===

=== menu-prompt-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>menu-prompt-trigger</type>
<activated>...</activated>
<text>...</text>
<menu-item>
<text>...</text>
<actions>...</actions>
</menu-item>
<menu-item>...</menu-item>
</object>
</syntaxhighlight>

=== property-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>property-trigger</type>
<activated>...</activated>
<condition>...</condition>
<actions>...</actions>
</object>
</syntaxhighlight>

=== proximity-trigger ===

=== timer-trigger ===

== Areas ==

== Objectives ==
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>objective</type>
<text>...</text>
<briefing>...</briefing>
<optional>...</optional>
</object>
</syntaxhighlight>

= Mission examples =
{{#ev:youtube|d4CLKLp7Bn0}}
{{#ev:youtube|5mK6mZYGBcQ}}

= Adding extensions =

Missions

2022-11-15T15:50:29Z

Marius A:

{{Tutorials Navigation}}
{{WIP}}
= Mission objects =

== Actions ==
=== mission-briefing-action ===
<syntaxhighlight lang="xml">
<object>
<type>mission-briefing-action</type>
<skill-level-0-label>...</skill-level-0-label>
<skill-level-1-label>...</skill-level-1-label>
<skill-level-2-label>...</skill-level-2-label>
<skill-level-0-objectives>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-0-objectives>
<skill-level-1-objectives>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-1-objectives>
<skill-level-2-objectives>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-2-objectives>
<skill-level-0-actions>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-0-actions>
<skill-level-1-actions>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-1-actions>
<skill-level-2-actions>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</skill-level-2-actions>
</object>
</syntaxhighlight>

=== adjust-payload-action ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>adjust-payload-action</type>
<station-id>...</station-id>
<adjustment-type>...</adjustment-type> "set" or "add"; default: "set"
<weight>...</weight>
<units>kg</units> "kg" or "lb"; default: "lb"
</object>
</syntaxhighlight>

=== dialog-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>dialog-action</type>
<text>...</text>
<sound-file>...</sound-file> *.wav
<delay-sec>...</delay-sec>
</object>
</syntaxhighlight>

=== model ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>model</type>
<activated>...</activated> 0/1
<path>...</path>
<orientation>
<heading-deg>...</heading-deg>
<pitch-deg>...</pitch-deg>
<roll-deg>...</roll-deg>
</orientation>
<world-position>
<latitude-deg>...</latitude-deg>
<longitude-deg>...</longitude-deg>
<altitude-m>...</altitude-m>
<altitude-is-AGL>...</altitude-is-AGL> 0/1
</world-position>
</object>
</syntaxhighlight>

=== object-activation-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>object-activation-action</type>
<object-state>...</object-state> 0/1
<reference-list>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</reference-list>
</object>
</syntaxhighlight>

=== random-action ===

=== refuel-action ===

=== single-shot-sound-action ===

=== goal-resolution-action ===

== Triggers ==
=== airport-landing-trigger ===

=== area-landing-trigger ===

=== menu-prompt-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>menu-prompt-trigger</type>
<activated>...</activated>
<text>...</text>
<menu-item>
<text>...</text>
<actions>...</actions>
</menu-item>
<menu-item>...</menu-item>
</object>
</syntaxhighlight>

=== property-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>property-trigger</type>
<activated>...</activated>
<condition>...</condition>
<actions>...</actions>
</object>
</syntaxhighlight>

=== proximity-trigger ===

=== timer-trigger ===

== Areas ==

== Goals ==

= Mission examples =
{{#ev:youtube|d4CLKLp7Bn0}}
{{#ev:youtube|5mK6mZYGBcQ}}

= Adding extensions =

Missions

2017-10-22T19:40:46Z

Marius A: /* Mission examples */

{{Tutorials Navigation}}
{{WIP}}
= Mission objects =

== Actions ==
=== adjust-payload-action ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>adjust-payload-action</type>
<station-id>...</station-id>
<adjustment-type>...</adjustment-type> "set" or "add"; default: "set"
<weight>...</weight>
<units>kg</units> "kg" or "lb"; default: "lb"
</object>
</syntaxhighlight>

=== dialog-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>dialog-action</type>
<text>...</text>
<sound-file>...</sound-file> *.wav
<delay-sec>...</delay-sec>
</object>
</syntaxhighlight>

=== model ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>model</type>
<activated>...</activated> 0/1
<path>...</path>
<orientation>
<heading-deg>...</heading-deg>
<pitch-deg>...</pitch-deg>
<roll-deg>...</roll-deg>
</orientation>
<world-position>
<latitude-deg>...</latitude-deg>
<longitude-deg>...</longitude-deg>
<altitude-m>...</altitude-m>
<altitude-is-AGL>...</altitude-is-AGL> 0/1
</world-position>
</object>
</syntaxhighlight>

=== object-activation-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>object-activation-action</type>
<object-state>...</object-state> 0/1
<reference-list>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</reference-list>
</object>
</syntaxhighlight>

=== random-action ===

=== refuel-action ===

=== single-shot-sound-action ===

=== goal-resolution-action ===

== Triggers ==
=== airport-landing-trigger ===

=== area-landing-trigger ===

=== menu-prompt-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>menu-prompt-trigger</type>
<activated>...</activated>
<text>...</text>
<menu-item>
<text>...</text>
<actions>...</actions>
</menu-item>
<menu-item>...</menu-item>
</object>
</syntaxhighlight>

=== property-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>property-trigger</type>
<activated>...</activated>
<condition>...</condition>
<actions>...</actions>
</object>
</syntaxhighlight>

=== proximity-trigger ===

=== timer-trigger ===

== Areas ==

== Goals ==

= Mission examples =
{{#ev:youtube|d4CLKLp7Bn0}}
{{#ev:youtube|5mK6mZYGBcQ}}

= Adding extensions =

FGCamera

2017-07-21T18:45:06Z

Marius A: /* Download link / Installation */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}
{{WIP}}
{{Note|Also see [[FGCamera API]]}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGY183eDJBdEpZYXM/view?usp=sharing Download fgcamera_v1_2.zip]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Copy modified mice.xml from "FG ROOT/nasal/fgcamera" to "FG ROOT/";
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note|make sure that ''File>Input Configuration>Click right mouse to cycle mouse behaviour'' (FG menu) is selected}}
{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}
Current (development) version of FGCamera can be downloaded [https://drive.google.com/open?id=0B7ZpQgmbsSZGNkJOYzZFb1RZUnc here]

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Replay timestamps ==
{{WIP}}
[FGCamera v1.2.1]
<syntaxhighlight>
<PropertyList>
<timestamp>
...
</timestamp>
<timestamp>
...
</timestamp>
...
</PropertyList>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>7:15.0</jump-to> 
<camera-id>0</camera-id>
</timestamp>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>5:25.8</jump-to> 
<click-camera>
<latitude-deg>37.62122627018694</latitude-deg>
<longitude-deg>-122.3981490730425</longitude-deg>
<altitude-ft>27.42773406108862</altitude-ft>
</click-camera>
</timestamp>
</syntaxhighlight>

== Development status (Apr 2015) ==
* {{progressbar|60}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel;
* {{progressbar|40}} dedicated [[FGCamera API]] (e.g. for aircraft developers wanting to use fgcamera directly), intended to support versioning for stable APIs, without introducing regressions;
* {{progressbar|80}} reimplement current FGCamera functionality using [[Property rules]] (reduce Nasal usage);

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}
{{#ev:youtube|xsnWJe_xUgw|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

Missions

2017-06-01T18:45:24Z

Marius A:

{{WIP}}
= Mission objects =

== Actions ==
=== adjust-payload-action ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>adjust-payload-action</type>
<station-id>...</station-id>
<adjustment-type>...</adjustment-type> "set" or "add"; default: "set"
<weight>...</weight>
<units>kg</units> "kg" or "lb"; default: "lb"
</object>
</syntaxhighlight>

=== dialog-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>dialog-action</type>
<text>...</text>
<sound-file>...</sound-file> *.wav
<delay-sec>...</delay-sec>
</object>
</syntaxhighlight>

=== model ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>model</type>
<activated>...</activated> 0/1
<path>...</path>
<orientation>
<heading-deg>...</heading-deg>
<pitch-deg>...</pitch-deg>
<roll-deg>...</roll-deg>
</orientation>
<world-position>
<latitude-deg>...</latitude-deg>
<longitude-deg>...</longitude-deg>
<altitude-m>...</altitude-m>
<altitude-is-AGL>...</altitude-is-AGL> 0/1
</world-position>
</object>
</syntaxhighlight>

=== object-activation-action ===
<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>object-activation-action</type>
<object-state>...</object-state> 0/1
<reference-list>
<object-reference>...</object-reference>
<object-reference>...</object-reference>
...
</reference-list>
</object>
</syntaxhighlight>

=== random-action ===

=== refuel-action ===

=== single-shot-sound-action ===

=== goal-resolution-action ===

== Triggers ==
=== airport-landing-trigger ===

=== area-landing-trigger ===

=== menu-prompt-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>menu-prompt-trigger</type>
<activated>...</activated>
<text>...</text>
<menu-item>
<text>...</text>
<actions>...</actions>
</menu-item>
<menu-item>...</menu-item>
</object>
</syntaxhighlight>

=== property-trigger ===

<syntaxhighlight lang="xml">
<object>
<name>...</name>
<type>property-trigger</type>
<activated>...</activated>
<condition>...</condition>
<actions>...</actions>
</object>
</syntaxhighlight>

=== proximity-trigger ===

=== timer-trigger ===

== Areas ==

== Goals ==

= Mission examples =
{{#ev:youtube|d4CLKLp7Bn0}}

= Adding extensions =

Missions

2017-06-01T11:00:38Z

Marius A: Created page with "{{WIP}} = Mission objects = == Actions == === adjust-payload-action === <syntaxhighlight lang="xml"> <object> <name>...</name> <type>adjust-payload-action</type>..."

FGCamera API

2015-12-09T13:49:22Z

Marius A: /* camera(index) */

{{WIP}}
{{note|Not available for [[FGCamera]] v1.2 and earlier versions}}
<syntaxhighlight lang="nasal">
var fgcam_API = fgcamera.API("1.0 devel");
</syntaxhighlight>

== CameraList() ==

=== CameraCount() ===
Returns number of cameras in a list.

=== camera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcam_API.CameraList().CameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== name(name = nil) ====
Sets or returns the name of camera.

Example 1:
<syntaxhighlight lang="nasal">
var L = fgcam_API.CameraList();
L.CameraByName("Pilot view").name("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

Example 2:
<syntaxhighlight lang="nasal">
var n = fgcam_API.CameraList().CurrentCamera().name();
print(n);
</syntaxhighlight>
will print currently selected camera's name.

==== id(id = nil) ====
Sets or returns ID of camera.

Example:
<syntaxhighlight lang="nasal">
var reorder_cameras = func (dir) {
var c = fgcam_API.CameraList().CurrentCamera();
c.id(c.id() + dir);
}
</syntaxhighlight>

==== index() ====
Returns the index of camera.

==== category(category = nil) ====
Sets or returns category of camera.

==== dialog(show = nil, name = nil) ====

==== panel(show = nil, name = nil) ====

==== settings("view adjustment") ====

Example 1:
<syntaxhighlight lang="nasal">
fgcam_API.CameraList().CurrentCamera().settings("view adjustment")
.FOV(65)
.LinearVelocity(0.2)
.AngularVelocity(30)
.filter(0.5);
</syntaxhighlight>

Example 2:
<syntaxhighlight lang="nasal">
var s = fgcam_API.CameraList().CurrentCamera().settings("view adjustment");
var values = [s.FOV(), s.LinearVelocity(), s.AngularVelocity(), s.filter()];
</syntaxhighlight>

===== FOV(fov = nil) =====

===== LinearVelocity(v_l = nil) =====

===== AngularVelocity(v_a = nil) =====

===== filter(coeff = nil) =====

==== settings("view movement") ====

===== LinearInterpolation(linterp = nil) =====

===== chained(chained = nil) =====

===== filter(coeff = nil) =====

==== settings("mouse look") ====

===== sensitivity(sensitivity = nil) =====

===== filter(filter = nil) =====

==== settings("head tracker") ====

==== loadFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

==== effect("DHM") ====

===== HeadMass(mass = nil) =====

===== scale(scale = nil) =====

===== LoadRelease(release = nil) =====

===== ConstantG(dof, factor = nil) =====

===== ImpulseG(dof, factor = nil) =====

===== HeadBank(factor = nil) =====

===== HeadPitch(factor = nil) =====

===== damping(dof, damping = nil) =====

===== limit(dof, limit = nil) =====

==== effect("RND") ====

=== CameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== CameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== CurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcam_API.CameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcam_API.CameraList().saveToXML(output_path);
</syntaxhighlight>

FGCamera API

2015-12-09T13:38:03Z

Marius A: /* camera(index) */ added DHM effect

{{WIP}}
{{note|Not available for [[FGCamera]] v1.2 and earlier versions}}
<syntaxhighlight lang="nasal">
var fgcam_API = fgcamera.API("1.0 devel");
</syntaxhighlight>

== CameraList() ==

=== CameraCount() ===
Returns number of cameras in a list.

=== camera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcam_API.CameraList().CameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== name(name = nil) ====
Sets or returns the name of camera.

Example 1:
<syntaxhighlight lang="nasal">
var L = fgcam_API.CameraList();
L.CameraByName("Pilot view").name("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

Example 2:
<syntaxhighlight lang="nasal">
var n = fgcam_API.CameraList().CurrentCamera().name();
print(n);
</syntaxhighlight>
will print currently selected camera's name.

==== id(id = nil) ====
Sets or returns ID of camera.

Example:
<syntaxhighlight lang="nasal">
var reorder_cameras = func (dir) {
var c = fgcam_API.CameraList().CurrentCamera();
c.id(c.id() + dir);
}
</syntaxhighlight>

==== index(i = nil) ====
Sets or returns the index of camera.

==== category(category = nil) ====
Sets or returns category of camera.

==== settings("view adjustment") ====

Example 1:
<syntaxhighlight lang="nasal">
fgcam_API.CameraList().CurrentCamera().settings("view adjustment")
.FOV(65)
.LinearVelocity(0.2)
.AngularVelocity(30)
.filter(0.5);
</syntaxhighlight>

Example 2:
<syntaxhighlight lang="nasal">
var s = fgcam_API.CameraList().CurrentCamera().settings("view adjustment");
var values = [s.FOV(), s.LinearVelocity(), s.AngularVelocity(), s.filter()];
</syntaxhighlight>

===== FOV(fov = nil) =====

===== LinearVelocity(v_l = nil) =====

===== AngularVelocity(v_a = nil) =====

===== filter(coeff = nil) =====

==== settings("view movement") ====

===== LinearInterpolation(linterp = nil) =====

===== chained(chained = nil) =====

===== filter(coeff = nil) =====

==== settings("mouse look") ====

==== settings("head tracker") ====

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

==== effect("DHM") ====

===== HeadMass(mass = nil) =====

===== scale(scale = nil) =====

===== LoadRelease(release = nil) =====

===== ConstantG(dof, factor = nil) =====

===== ImpulseG(dof, factor = nil) =====

===== HeadBank(factor = nil) =====

===== HeadPitch(factor = nil) =====

===== damping(dof, damping = nil) =====

===== limit(dof, limit = nil) =====

=== CameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== CameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== CurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcam_API.CameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcam_API.CameraList().saveToXML(output_path);
</syntaxhighlight>

FGCamera

2015-04-18T10:17:24Z

Marius A: /* Development status (Mar 2015) */ using property rules

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}
{{WIP}}
{{Note|Also see [[FGCamera API]]}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGY183eDJBdEpZYXM/view?usp=sharing Download fgcamera_v1_2.zip]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Copy modified mice.xml from "FG ROOT/nasal/fgcamera" to "FG ROOT/";
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note|make sure that ''File>Input Configuration>Click right mouse to cycle mouse behaviour'' (FG menu) is selected}}
{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Replay timestamps ==
{{WIP}}
[FGCamera v1.2.1]
<syntaxhighlight>
<PropertyList>
<timestamp>
...
</timestamp>
<timestamp>
...
</timestamp>
...
</PropertyList>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>7:15.0</jump-to> 
<camera-id>0</camera-id>
</timestamp>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>5:25.8</jump-to> 
<click-camera>
<latitude-deg>37.62122627018694</latitude-deg>
<longitude-deg>-122.3981490730425</longitude-deg>
<altitude-ft>27.42773406108862</altitude-ft>
</click-camera>
</timestamp>
</syntaxhighlight>

== Development status (Apr 2015) ==
* {{progressbar|60}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel;
* {{progressbar|40}} dedicated [[FGCamera API]] (e.g. for aircraft developers wanting to use fgcamera directly), intended to support versioning for stable APIs, without introducing regressions;
* {{progressbar|80}} reimplement current FGCamera functionality using [[Property rules]] (reduce Nasal usage);

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}
{{#ev:youtube|xsnWJe_xUgw|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera API

2015-04-18T10:01:07Z

Marius A: API versioning

{{WIP}}
{{note|Not available for [[FGCamera]] v1.2 and earlier versions}}
<syntaxhighlight lang="nasal">
var fgcam_API = fgcamera.API("1.0 devel");
</syntaxhighlight>

== CameraList() ==

=== CameraCount() ===
Returns number of cameras in a list.

=== camera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcam_API.CameraList().CameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== name(name = nil) ====
Sets or returns the name of camera.

Example 1:
<syntaxhighlight lang="nasal">
var L = fgcam_API.CameraList();
L.CameraByName("Pilot view").name("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

Example 2:
<syntaxhighlight lang="nasal">
var n = fgcam_API.CameraList().CurrentCamera().name();
print(n);
</syntaxhighlight>
will print currently selected camera's name.

==== id(id = nil) ====
Sets or returns ID of camera.

Example:
<syntaxhighlight lang="nasal">
var reorder_cameras = func (dir) {
var c = fgcam_API.CameraList().CurrentCamera();
c.id(c.id() + dir);
}
</syntaxhighlight>

==== index(i = nil) ====
Sets or returns the index of camera.

==== category(category = nil) ====
Sets or returns category of camera.

==== settings("view adjustment") ====

Example 1:
<syntaxhighlight lang="nasal">
fgcam_API.CameraList().CurrentCamera().settings("view adjustment")
.FOV(65)
.LinearVelocity(0.2)
.AngularVelocity(30)
.filter(0.5);
</syntaxhighlight>

Example 2:
<syntaxhighlight lang="nasal">
var s = fgcam_API.CameraList().CurrentCamera().settings("view adjustment");
var values = [s.FOV(), s.LinearVelocity(), s.AngularVelocity(), s.filter()];
</syntaxhighlight>

===== FOV(fov = nil) =====

===== LinearVelocity(v_l = nil) =====

===== AngularVelocity(v_a = nil) =====

===== filter(coeff = nil) =====

==== settings("view movement") ====

===== LinearInterpolation(linterp = nil) =====

===== chained(chained = nil) =====

===== filter(coeff = nil) =====

==== settings("mouse look") ====

==== settings("head tracker") ====

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

=== CameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== CameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== CurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcam_API.CameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcam_API.CameraList().saveToXML(output_path);
</syntaxhighlight>

Expressions

2015-04-02T17:09:56Z

Marius A: /* Supported elements */ added <deg2rad>

{{Stub}}
'''Expressions''' (or '''SGExpressions''') are a feature of the SimGear library and provide a nice way of implementing complex math formulas using XML syntax.
They are supported in many systems within the FlightGear code.

{{caution|Expressions do not check if your math creates floating point exceptions (like division by zero conditions, taking the square root of a negative number, etc.). This can cause undefined behavior and may result in NaNs or even Cascading NaNs.}}

== Usage ==
Expressions are supported in
* [[Autopilot Configuration Reference#Expressions|Autopilot configuration files]]
* Particle system configuration files
* Animations (translate, rotate, scale, range, blend)
* The shader technique

== Sample Expressions ==
This is a sample expression for c = sqrt(a*a + b^2). Children/arguments are parsed in the order they appear in in the file (or the order in which they are set via property methods).
<syntaxhighlight lang="xml">
<expression>
<sqrt>
<sum>
<product>
<property>/value/a</property>
<property>/value/a</property>
</product>
<pow>
<property>/value/b</property>
<value>2</value>
</pow>
</sum>
</sqrt>
</expression>
</syntaxhighlight>

== Supported elements ==
<syntaxhighlight lang="xml">
<abs> 
<acos>
<asin>
<atan>
<atan2>
<ceil>
<clip>
<cos>
<cosh>
<difference> 
<div>
<exp>
<floor>
<log>
<log10>
<max>
<min>
<mod>
<pow>
<product> 
<property>
<rad2deg>
<deg2rad>
<sin>
<sinh>
<sqr>
<sqrt>
<sum>
<table>
<tan>
<tanh>
<value>
</syntaxhighlight>

== Related content ==
=== Source code ===
* {{Git link|gitorious|fg/simgear|master|simgear/structure/SGExpression.hxx}}
* {{Git link|gitorious|fg/simgear|master|simgear/structure/SGExpression.cxx}}

[[Category:XML]]

FGCamera

2015-03-31T21:06:18Z

Marius A: /* Download link / Installation */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}
{{WIP}}
{{Note|Also see [[FGCamera API]]}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGY183eDJBdEpZYXM/view?usp=sharing Download fgcamera_v1_2.zip]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Copy modified mice.xml from "FG ROOT/nasal/fgcamera" to "FG ROOT/";
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note|make sure that ''File>Input Configuration>Click right mouse to cycle mouse behaviour'' (FG menu) is selected}}
{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Replay timestamps ==
{{WIP}}
[FGCamera v1.2.1]
<syntaxhighlight>
<PropertyList>
<timestamp>
...
</timestamp>
<timestamp>
...
</timestamp>
...
</PropertyList>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>7:15.0</jump-to> 
<camera-id>0</camera-id>
</timestamp>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>5:25.8</jump-to> 
<click-camera>
<latitude-deg>37.62122627018694</latitude-deg>
<longitude-deg>-122.3981490730425</longitude-deg>
<altitude-ft>27.42773406108862</altitude-ft>
</click-camera>
</timestamp>
</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|60}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.
* {{progressbar|40}} dedicated [[FGCamera API]] (e.g. for aircraft developers wanting to use fgcamera directly), intended to support versioning for stable APIs, without introducing regressions

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}
{{#ev:youtube|xsnWJe_xUgw|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2015-03-31T20:47:28Z

Marius A: /* Download link / Installation */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}
{{WIP}}
{{Note|Also see [[FGCamera API]]}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGY183eDJBdEpZYXM/view?usp=sharing Download fgcamera_v1_2.zip]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Copy modified mice.xml from "FG ROOT/nasal/fgcamera" to "FG ROOT/";
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Replay timestamps ==
{{WIP}}
[FGCamera v1.2.1]
<syntaxhighlight>
<PropertyList>
<timestamp>
...
</timestamp>
<timestamp>
...
</timestamp>
...
</PropertyList>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>7:15.0</jump-to> 
<camera-id>0</camera-id>
</timestamp>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>5:25.8</jump-to> 
<click-camera>
<latitude-deg>37.62122627018694</latitude-deg>
<longitude-deg>-122.3981490730425</longitude-deg>
<altitude-ft>27.42773406108862</altitude-ft>
</click-camera>
</timestamp>
</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|60}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.
* {{progressbar|40}} dedicated [[FGCamera API]] (e.g. for aircraft developers wanting to use fgcamera directly), intended to support versioning for stable APIs, without introducing regressions

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}
{{#ev:youtube|xsnWJe_xUgw|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera API

2015-03-30T20:28:26Z

Marius A: /* settings("view adjustment") */

{{WIP}}
{{note|Not available for [[FGCamera]] v1.2 and earlier versions}}

== CameraList() ==

=== CameraCount() ===
Returns number of cameras in a list.

=== camera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcamera.CameraList().CameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== name(name = nil) ====
Sets or returns the name of camera.

Example 1:
<syntaxhighlight lang="nasal">
var L = fgcamera.CameraList();
L.CameraByName("Pilot view").name("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

Example 2:
<syntaxhighlight lang="nasal">
var n = fgcamera.CameraList().CurrentCamera().name();
print(n);
</syntaxhighlight>
will print currently selected camera's name.

==== id(id = nil) ====
Sets or returns ID of camera.

Example:
<syntaxhighlight lang="nasal">
var reorder_cameras = func (dir) {
var c = fgcamera.CameraList().CurrentCamera();
c.id(c.id() + dir);
}
</syntaxhighlight>

==== index(i = nil) ====
Sets or returns the index of camera.

==== category(category = nil) ====
Sets or returns category of camera.

==== settings("view adjustment") ====

Example 1:
<syntaxhighlight lang="nasal">
fgcamera.CameraList().CurrentCamera().settings("view adjustment")
.FOV(65)
.LinearVelocity(0.2)
.AngularVelocity(30)
.filter(0.5);
</syntaxhighlight>

Example 2:
<syntaxhighlight lang="nasal">
var s = fgcamera.CameraList().CurrentCamera().settings("view adjustment");
var values = [s.FOV(), s.LinearVelocity(), s.AngularVelocity(), s.filter()];
</syntaxhighlight>

===== FOV(fov = nil) =====

===== LinearVelocity(v_l = nil) =====

===== AngularVelocity(v_a = nil) =====

===== filter(coeff = nil) =====

==== settings("view movement") ====

===== LinearInterpolation(linterp = nil) =====

===== chained(chained = nil) =====

===== filter(coeff = nil) =====

==== settings("mouse look") ====

==== settings("head tracker") ====

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

=== CameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== CameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== CurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcamera.CameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcamera.CameraList().saveToXML(output_path);
</syntaxhighlight>

FGCamera API

2015-03-30T20:26:01Z

Marius A: /* LinearVelovity(v_l = nil) */

{{WIP}}
{{note|Not available for [[FGCamera]] v1.2 and earlier versions}}

== CameraList() ==

=== CameraCount() ===
Returns number of cameras in a list.

=== camera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcamera.CameraList().CameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== name(name = nil) ====
Sets or returns the name of camera.

Example 1:
<syntaxhighlight lang="nasal">
var L = fgcamera.CameraList();
L.CameraByName("Pilot view").name("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

Example 2:
<syntaxhighlight lang="nasal">
var n = fgcamera.CameraList().CurrentCamera().name();
print(n);
</syntaxhighlight>
will print currently selected camera's name.

==== id(id = nil) ====
Sets or returns ID of camera.

Example:
<syntaxhighlight lang="nasal">
var reorder_cameras = func (dir) {
var c = fgcamera.CameraList().CurrentCamera();
c.id(c.id() + dir);
}
</syntaxhighlight>

==== index(i = nil) ====
Sets or returns the index of camera.

==== category(category = nil) ====
Sets or returns category of camera.

==== settings("view adjustment") ====

Example 1:
<syntaxhighlight lang="nasal">
fgcamera.CameraList().CurrentCamera().settings("view adjustment")
.FOV(65)
.LinearVelovity(0.2)
.AngularVelocity(30)
.filter(0.5);
</syntaxhighlight>

Example 2:
<syntaxhighlight lang="nasal">
var s = fgcamera.CameraList().CurrentCamera().settings("view adjustment");
var values = [s.FOV(), s.LinearVelovity(), s.AngularVelocity(), s.filter()];
</syntaxhighlight>

===== FOV(fov = nil) =====

===== LinearVelocity(v_l = nil) =====

===== AngularVelocity(v_a = nil) =====

===== filter(coeff = nil) =====

==== settings("view movement") ====

===== LinearInterpolation(linterp = nil) =====

===== chained(chained = nil) =====

===== filter(coeff = nil) =====

==== settings("mouse look") ====

==== settings("head tracker") ====

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

=== CameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== CameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== CurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcamera.CameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcamera.CameraList().saveToXML(output_path);
</syntaxhighlight>

FGCamera API

2015-03-30T15:11:59Z

Marius A: /* camera(index) */

{{WIP}}
{{note|Not available for FGCamera v1.2 and earlier versions}}

== CameraList() ==

=== CameraCount() ===
Returns number of cameras in a list.

=== camera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcamera.CameraList().CameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== name(name = nil) ====
Sets or returns the name of camera.

Example 1:
<syntaxhighlight lang="nasal">
var L = fgcamera.CameraList();
L.CameraByName("Pilot view").name("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

Example 2:
<syntaxhighlight lang="nasal">
var n = fgcamera.CameraList().CurrentCamera().name();
print(n);
</syntaxhighlight>
will print currently selected camera's name.

==== id(id = nil) ====
Sets or returns ID of camera.

Example:
<syntaxhighlight lang="nasal">
var reorder_cameras = func (dir) {
var c = fgcamera.CameraList().CurrentCamera();
c.id(c.id() + dir);
}
</syntaxhighlight>

==== index(i = nil) ====
Sets or returns the index of camera.

==== category(category = nil) ====
Sets or returns category of camera.

==== settings("view adjustment") ====

Example 1:
<syntaxhighlight lang="nasal">
fgcamera.CameraList().CurrentCamera().settings("view adjustment")
.FOV(65)
.LinearVelovity(0.2)
.AngularVelocity(30)
.filter(0.5);
</syntaxhighlight>

Example 2:
<syntaxhighlight lang="nasal">
var s = fgcamera.CameraList().CurrentCamera().settings("view adjustment");
var values = [s.FOV(), s.LinearVelovity(), s.AngularVelocity(), s.filter()];
</syntaxhighlight>

===== FOV(fov = nil) =====

===== LinearVelovity(v_l = nil) =====

===== AngularVelocity(v_a = nil) =====

===== filter(coeff = nil) =====

==== settings("view movement") ====

===== LinearInterpolation(linterp = nil) =====

===== chained(chained = nil) =====

===== filter(coeff = nil) =====

==== settings("mouse look") ====

==== settings("head tracker") ====

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

=== CameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== CameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== CurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcamera.CameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcamera.CameraList().saveToXML(output_path);
</syntaxhighlight>

FGCamera API

2015-03-30T11:20:14Z

Marius A:

{{WIP}}
{{note|Not available for FGCamera v1.2 and earlier versions}}

== CameraList() ==

=== CameraCount() ===
Returns number of cameras in a list.

=== camera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcamera.CameraList().CameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== name(name = nil) ====
Sets or returns the name of camera.

Example 1:
<syntaxhighlight lang="nasal">
var L = fgcamera.CameraList();
L.CameraByName("Pilot view").name("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

Example 2:
<syntaxhighlight lang="nasal">
var n = fgcamera.CameraList().CurrentCamera().name();
print(n);
</syntaxhighlight>
will print currently selected camera's name.

==== id(id = nil) ====
Sets or returns ID of camera.

Example:
<syntaxhighlight lang="nasal">
var reorder_cameras = func (dir) {
var c = fgcamera.CameraList().CurrentCamera();
c.id(c.id() + dir);
}
</syntaxhighlight>

==== index(i = nil) ====
Sets or returns the index of camera.

==== category(category = nil) ====
Sets or returns category of camera.

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

=== CameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== CameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== CurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcamera.CameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcamera.CameraList().saveToXML(output_path);
</syntaxhighlight>

FlightGear Newsletter March 2015

2015-03-26T12:51:37Z

Marius A: /* Development news */ fgcamera

{{draft|newsletter|Please feel free to add content you think will be of interest to the FlightGear community.}}

{{Newsletter-header|March 2015}}
<div style="border-bottom:3px double #BBB;">
{| width="100%" |
| valign="top" width="33%" |
[[#Project restructuring|Project restructuring]]<br/>
{{Newsletter-cover-header|Development news}}<br/>
[[#Upcoming built-in GUI|Upcoming built-in GUI]]<br/>
[[#Environment-responsive glass|Environment-responsive glass]]<br/>
[[#Cockpit interior light and shadow|Cockpit interior light and shadow]]<br/>
[[#FlightGear goes to space, part III|FlightGear goes to space, part III]]<br/>
[[#New ATC-pie release|New ATC-pie release]]<br/>
[[#Variant-of tag added|Variant-of tag added]]<br/>
| valign="top" width="33%" |
{{Newsletter-cover-header|In the hanger}}<br/>
[[#c172p-detailed project|c172p-detailed project]]<br/>
{{Newsletter-cover-header|Scenery Corner}}<br/>
[[#Verona Villafranca 2D layout released|Verona Villafranca 2D layout released]]<br/>
{{Newsletter-cover-header|Community News}}<br/>
[[#FlightGear on YouTube|FlightGear on YouTube]]<br/>
[[#FlightGear Space Program|FlightGear Space Program]]<br/>
| valign="top" width="33%" |
{{Newsletter-cover-header|Contributing}}<br/>
[[#Translators required|Translators required]]<br/>
[[#FlightGear logos|FlightGear logos]]<br/>
[[#Screenshots|Screenshots]]<br/>
|}</div>

== Project restructuring ==
Due to two recent developments, large parts of the FlightGear project are moving. The first is the announcement that Gitorious.org will shut down in May this year ([https://about.gitlab.com/2015/03/03/gitlab-acquires-gitorious/ read more]) and the second is that Google Code will shut down in 2016 ([http://google-opensource.blogspot.co.uk/2015/03/farewell-to-google-code.html read more]). These developments have affected the source code (SimGear and FlightGear), bug tracker, and [[TerraSync]] SVN repository are moving. In addition, just previous to these developments, [[fgdata]] was split (see [[#fgdata split|below]] for details).

All repositories of the FlightGear project have been synchronized to [http://sourceforge.net/p/flightgear/_list/git SourceForge.net]<ref>{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33588398/
|title = <nowiki>[Flightgear-devel] [MasterCaution] (ding!) FlightGear is now at SourceForge</nowiki>
|author = Torsten Dreyer
|authorlink-wiki = User:T3r
|date = 2015-03-12
}}</ref>. '''No more work should be pushed to Gitorious any more.''' Except for fgdata, all others are mirrors of the original and a new clone is not necessary. All you have to do is update the URL(s) of your remote(s) and pull as usual.

Example for SimGear with read-only access:
<syntaxhighlight lang="bash">
git remote set-url origin <protocol>git.code.sf.net/p/flightgear/<sub-project>
</syntaxhighlight>

<code><nowiki><protocol></nowiki></code> can be either of <code><nowiki>git://</nowiki></code> (read-only access) or <code><nowiki>http://</nowiki></code> (read/write access). See http://sourceforge.net/p/flightgear/_list/git for a list of what <code><nowiki><sub-project></nowiki></code> should (they should also be lowercase).

Example for [[SimGear]] with read/write access:
<syntaxhighlight lang="bash">
git remote set-url origin http://git.code.sf.net/p/flightgear/simgear
</syntaxhighlight>

Several (but not all) of the [[:Category:Git|Git related articles]] on the wiki have been updated, including [[FlightGear Git: data developers]].

To get re-added as a contributor to the FlightGear repositories, you will have to do the following steps<ref name="a">{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33562106/
|title = <nowiki>[Flightgear-devel] FGData - The Next Generation is ready.</nowiki>
|author = Torsten Dreyer
|date = 2015-03-07
}}</ref>:
# [https://sourceforge.net/user/registration Register] a SourceForge.net
# Upload your public key.
# Send your SourceForge username to Curt, Clément, James, or Torsten D, stating which repo(s) you want to be re-added to.

The bug tracker has moved to http://sourceforge.net/p/flightgear/codetickets/<ref>{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33600886
|title = <nowiki>[Flightgear-devel] Bugtracker moving to sourceforge</nowiki>
|author = Torsten Dreyer
|date = 2015-03-16
}}</ref>. All old issues/feature requests have been preserved. The wiki template {{tl|Issue}} has been updated ([http://wiki.flightgear.org/index.php?title=Template:Issue&diff=82555&oldid=72743 diff]).

TerraSync is yet to be moved as of March 22.

=== FGData split ===
After lots of hard work by Torsten D, a new, more compact [[fgdata]] repository ([[base package]]) has now been created. Located at http://sourceforge.net/p/flightgear/fgdata/, this new fgdata has had all aircraft (except for the [[C172p]] and [[UFO]]) stripped from it, as well as the histories of the Scenery, AI, and Models directories<ref name="a">{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33562106/
|title = <nowiki>[Flightgear-devel] FGData - The Next Generation is ready.</nowiki>
|author = Torsten Dreyer
|date = 2015-03-07
}}</ref>. This has reduced its size to about 1.3 GB<ref>{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33562630/
|title = <nowiki>Re: [Flightgear-devel] FGData - The Next Generation is ready.</nowiki>
|author = Anders Gidenstam
|authorlink-wiki = User:AndersG
|date = 2015-03-07
}}</ref>. As almost all commit IDs have changed, you will have to get a fresh clone of this new fgdata<ref name="a">{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33562106/
|title = <nowiki>[Flightgear-devel] FGData - The Next Generation is ready.</nowiki>
|author = Torsten Dreyer
|date = 2015-03-07
}}</ref>. See above for information on getting re-added as a contributor.

{{note|For consistency reasons, fgdata development should now happen on the "next" branch and no longer in "master". "next" should be the default branch<ref>{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33562259/
|title = <nowiki>Re: [Flightgear-devel] FGData - The Next Generation is ready.</nowiki>
|author = Torsten Dreyer
|date = 2015-03-07
}}</ref>.}}

{{note|IAHM-COL has preserved the history of all aircraft at https://github.com/FGMEMBERS<ref>{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33562691/
|title = <nowiki>Re: [Flightgear-devel] FGData - The Next Generation is ready.</nowiki>
|author = IAHM-COL
|date = 2015-03-07
}}</ref>.}}

{{note|See [[FGAddon]] for obtaining aircraft other than the C172p and UFO.}}

<references/>

== Development news ==
=== Upcoming built-in GUI ===
[[File:Qt launcher for FlightGear 3.5 on Windows 7.jpg|thumb|The aircraft page of the Qt launcher for FlightGear 3.5 as rendered on Windows 7.]]
Development of a new GUI frontend for FlightGear has started, with the aim to replace [[FGRun]] and eventually the PLIB PUI. James Turner is currently prototyping this new launcher, based on [http://www.qt.io/qt-quick/ Qt Quick], at the suggestion and encouragement of Curt, Torsten D & others<ref>{{cite web
|url = http://sourceforge.net/p/flightgear/mailman/message/33245028
|title = <nowiki>[Flightgear-devel] Gui technologies</nowiki>
|author = James Turner
|authorlink-wiki = User:Zakalawe
|date = 2015-01-20
}}</ref>. There will also be the HTML5-based GUI called [[Phi]], which is being developed by Torsten D.

The reason for the announcement is that this would overlap some areas other developers are working on. This will hopefully avoid others unnecessarily expending energy on areas that might be affected.

{{inote|The parallel development of HTML and Qt-based UIs is happening by intention and is not the result of discoordination<ref>{{cite web
|url = http://forum.flightgear.org/viewtopic.php?p=229445#p229445
|title = Re: New Canvas GUI
|author = Torsten Dreyer
|authorlink-wiki = User:T3r
|date = Jan 10, 2015
}}</ref>. It is likely both will use a common service layer to provide necessary data<ref>{{cite web
|url = http://forum.flightgear.org/viewtopic.php?p=229303#p229303
|title = Re: New Canvas GUI
|author = Torsten Dreyer
|date = Jan 08, 2015
}}</ref>.}}

To learn more, see [[Integrated Qt5 Launcher]].

<references/>

=== Atmospheric light scattering ===
Two new cockpit interior effects have been added to the ALS rendering framework.

==== Environment-responsive glass ====
A new '''glass effect''' for the cockpit interior brings dynamical rendering of raindrop splashes as well as frost. In future, the effect will also include fogging and windshield wiper support with aircraft-supplied texture masks, all with a realistic interaction with the sunlight, including the enhanced visibility of dirt on glass when looking into the sun due to Mie scattering.

[[File:Glass01.jpg|400px|Frost effect]]
[[File:Glass07.jpg|400px|Raindrop splashes]]

Both frost and the correct splash dynamics of the raindrops need to be modeled by the aircraft developer, as the shader cannot have get the required information. See [[ALS technical notes#ALS glass effect|ALS glass effect]] for details.

==== Cockpit interior light and shadow ====
Do you like the way shadow and light move across the panel in flight when using [[Rembrandt]]? ALS is now able to do the same and more using the new '''model-interior''' effect which utilizes a cubemap representing the cockpit layout – at hardly any framerate cost. The effect is able to draw very sharp shadows without flickering, semi-shadows, dirty or tinted glass, and even render caustics from light refracted on curved glass surfaces.

[[File:Interior01.jpg|400px|Colored glass]]
[[File:Opacity04.jpg|400px|Caustics]]

All that's needed from aircraft modellers is a pre-computed cube map representing the cockpit. See [[ALS technical notes#Internal cockpit reflection|internal cockpit reflection]] and [[ALS technical notes#Interior shading|interior shading]] for more details.

=== FlightGear goes to space, part III ===
Independent of the [[FlightGear space program]], efforts are underway to provide the [[Space Shuttle]] with a flight dynamics model which has the characteristics of a real spacecraft and performance close to the real Shuttle.

[[File:Shuttle FG01.jpg|600px|The Space Shuttle]]

Currently, a plausible behaviour of the {{Wikipedia|Space Shuttle Solid Rocket Booster|{{Abbr|SRBs|Solid Rocket Boosters}}}} has been implemented. Only the main engines respond to throttle, but SRBs burn until exhausted when ignited. The ascent path is controlled by thrust vectoring on both main engines and SRBs. Callouts for important ascent milestones are implemented, such as thrust bucket<ref>Throttling down to prevent the exceeding of {{Wikipedia|maximum dynamic pressure}}.</ref>, SRB separation, orbital insertion, {{Abbr|MECO|Main Engines Cut-Off}}, etc. Balancing the top-heavy external tank to a good orbit is moderately challenging.

[[File:Shuttle FG02.jpg|300px|Launch]]
[[File:Shuttle FG03.jpg|300px|At 4,000 ft.]]

The best visuals can be obtained by switching to the Earthview orbital rendering engine at high altitude:

[[File:Shuttle FG04.jpg|300px|Crossing 30,000 ft.]]
[[File:Shuttle FG5.jpg|300px|Racing to orbital speed at 650,000 ft.]]

Stay tuned for more! Modelers interested in realism are very welcome to come aboard and help.

<references/>

=== New ATC-pie release ===
[[File:ATC-pie-logo.png|200px|left|ATC-pie logo.]]
Announced as beta in January and released as stable early February, [[ATC-pie]] has happily served a few [[ATC]] sessions in its first month of existance. In particular, it seems to have found comfortable homes for adoption in EKCH and LFOK already. Meanwhile, progress was made on its development to reach the important milestone of general and continuous ATC coordination on Flightgear with the '''handover feature''', released this month.

Beginning to populate the network with a new program without dividing the MP network (especially controllers) was a challenge as interesting as necessary. Collaborative work made this possible, enabling both [[OpenRadar]] and ATC-pie users to exchange strips in a transparent way, regardless of their software choice.

''See also [http://forum.flightgear.org/viewtopic.php?f=83&t=25573#p234276 the forum announcement] …''

=== Variant-of tag added ===
Aircraft developers can make use of a new tag in the [[Aircraft-set.xml]] file. Added to the <code><nowiki><sim></nowiki></code>, the <code><nowiki><variant-of></nowiki></code> tag states to the launcher the aircraft type that your aircraft is a variant of. For example, the [[British Aerospace Sea Harrier|BAe Sea Harrier FA2]] is a variant of the BAe Sea Harrier, and the ''Cessna 172P - Canvas Demo'' is a variant of the [[Cessna C172P|C172P]].

Syntax:
<syntaxhighlight lang="xml">
<sim>
...
<variant-of>[aircraft]</variant-of>
...
</sim>
</syntaxhighlight>

Example from the {{repo link|site=sf|path=Aircraft/777/777-200ER-set.xml|lines=11|text=Boeing 777-200ER}}:

<code><nowiki><variant-of>777-200</variant-of></nowiki></code>

=== Upcoming features of FGCamera ===
{{#ev:youtube|_KEq5hSKurE|300|right|Click-camera in action}}
{{#ev:youtube|xsnWJe_xUgw|300|right|Demonstration of AI object cameras}}
{{#ev:youtube|u7B4ZmcHimM|300|right|Replay timestamps}}
[[FGCamera]] v1.3 will have few notable features:
* "Click-camera" mode. Camera is activated by left-clicking on scenery while pressing modifier (customizable key/button). Previous view is restored by pressing modifier again (without LMB);
* AI-object camera mode. Each AI object can have pre-defined camera views;
* Replay timestamps. Camera views can be "tied" to specific replay timestamp. Timestamps are defined using *.xml files;
* "Chainable" cameras (automatic switching of cameras in the same category);
* [[FGCamera API|API]]. Cameras can be created and manipulated procedurally.

== In the hangar ==
=== c172p-detailed project ===
A new, more detailed version of the [[C172p]] is currently being worked on by wlbragg, gsagostinho, thevirtualfer, ludomotico, onox and others. It brings amazing new textures, controls, switches, and systems! Below are some of the results of their work:

[[File:Screenshots of the project c172p-detailed.jpg|800px|Some screenshots of the c172p-detailed project]]

''Find out more at [http://forum.flightgear.org/viewtopic.php?f=4&t=25157 Cessna 172P detailed] …''

== Scenery Corner ==
=== Verona Villafranca 2D layout released ===
{{usr|Elgaton}} has released the complete 2D layout for the [[Verona Villafranca Airport]] (LIPX). It is going to be submitted to the Airport Scenery Gateway at the end of March for inclusion into X-Plane and FlightGear. See the [http://forum.flightgear.org/viewtopic.php?f=5&t=21576 forum thread] for download links. 3D buildings will be added in the coming months.
<gallery mode="packed">
LIPX-RC2-panorama.png|Airport and the surrounding area
LIPX-RC2-top.png|Top view
LIPX-RC2-apron.png|The apron now features up-to-date stands
LIPX-B-CRJ700.png|Holding short in the [[Bombardier CRJ700 series|CRJ700]] at night
</gallery>

== Community News ==
=== FlightGear on YouTube ===
<big>''From the [https://www.youtube.com/user/3ZzOoOZz1/featured SMAAF GAMEZ] channel.''</big>

{{#ev:youtube|uvZF-Yv0yiM|||{{en|Video of several FlightGear aircraft using [[Changelog 3.4|FlightGear v3.4]].}}|frame}}

=== FlightGear Space Program ===
[[File:Fgspbadge.png|thumb|FGSP Cosmonaut Badge "The Owl"]]
[[File:spacetripready.png|link=FlightGear space program]]

Now is your time to become official cosmonaut of The FlightGear Space Program. Just download the famous [[Space Shuttle]] and select any of the available [[FlightGear space program missions|missions]]. Report your succesfull orbit flight tracker screenie and you'll receive a custom badge of the FlightGear Space Program.

The Space Shuttle can be downloaded from {{repo link|site=gith|proj=HerbyW/Antonov-Aircrafts|text=the GitHub repository}} either in a ZIP file or by cloning.

As an add-on also you can fly our Special Cargo Transport Missions with the heavily updated [[Antonov An-12|An-12]], [[Antonov An-22|An-22]], and [[An-225]].

''Find out more about space flight in FlightGear at [[FlightGear space program]] …''

== Contributing ==
=== Translators required ===
{|
|[[File:en.gif]]
|The FlightGear Wiki still needs help for translating it into various languages. If you are interested in making the FlightGear Wiki multi-language then start at [[Help:Translate]].
|-
|[[File:de.gif]]
|Das FlightGear Wiki benötigt immer noch Hilfe bei der Übersetzung in verschiedene Sprachen. Wenn Du Interesse daran hast, das FlightGear Wiki Mehrsprachig zu machen, dann fang doch mit [[:de:Help:Übersetzen|Help:Übersetzen]] an.
|-
|[[File:nl.gif]]
|De FlightGear Wiki kan nog steed hulp gebruiken bij het vertalen van artikelen. Als je interesse hebt om de wiki meertalig te maken, raden we je aan om een kijkje te nemen bij [[:nl:Help:Vertalen|Help:Vertalen]].
|-
|[[File:es.gif]]
|La FlightGear wiki todavía necesita ayuda para traducirla a varios lenguajes. Si estás interesado en hacer la FlightGear wiki multilingüe, entonces comienza en [[:es:Help:Traducir|Help:Traducir]].
|}

=== FlightGear logos ===
If you want some graphic elements for your FlightGear-related site (for example a hangar or YouTube channel), please feel free to visit [[FlightGear logos]] for a repository of logos. And if you have some art skills, please don't hesitate to contribute with your own design creations.

=== Screenshots ===
The FlightGear project always needs screenshots, which show features that were added since the last release. These should be of good quality, especially in content and technical image properties. It is therefore recommended to use the best viable filter settings ([[antialiasing]], texture sharpening, etc.). More info at [[Howto:Make nice screenshots]].

[[Category:FlightGear Newsletter|2015 03]]
[[Category:Changes after 3.4]]

FGCamera API

2015-03-22T19:10:36Z

Marius A:

{{WIP}}
{{note|Not available for FGCamera v1.2 and earlier versions}}

== getCameraList() ==

=== getCameraCount() ===
Returns number of cameras in a list.

=== getCamera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcamera.getCameraList().getCameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== setName(name) ====
Sets the name of camera. Returns camera object.

Example:
<syntaxhighlight lang="nasal">
var L = fgcamera.getCameraList();
L.getCameraByName("Pilot view").setName("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

==== getName() ====
Returns the name of camera.

Example:
<syntaxhighlight lang="nasal">
var n = fgcamera.getCameraList().getCurrentCamera().getName();
</syntaxhighlight>
will assign variable n to currently selected camera's name.

==== getID() ====
Returns ID of camera.

==== setID(id) ====
Sets ID of camera. Returns camera object.

==== getIndex() ====
Returns the index of camera.

==== setCategory(category) ====
Sets category of camera. Returns camera object.

==== getCategory() ====
returns category of camera.

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

=== getCameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== getCameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== getCurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

=== setFromXML(path) ===
Loads list of cameras from *.xml file.

Example:
<syntaxhighlight lang="nasal">
var input_path = getprop("/sim/fg-root" ~ "/Aircraft/Cub/fgcamera/cub_cameras.xml");
fgcamera.getCameraList().setFromXML(input_path);
</syntaxhighlight>

=== saveToXML(path) ===
Saves list of cameras to *.xml file

Example:
<syntaxhighlight lang="nasal">
var output_path = getprop("/sim/fg-home" ~ "/aircraft-data/fgcamera/cub_custom_cameras.xml");
fgcamera.getCameraList().saveToXML(output_path);
</syntaxhighlight>

FGCamera API

2015-03-20T11:44:27Z

Marius A: /* getName() */

FGCamera API

2015-03-20T11:34:22Z

Marius A:

{{WIP}}
{{note|Not available for FGCamera v1.2 and earlier versions}}

== getCameraList() ==

=== getCameraCount() ===
Returns number of cameras in a list.

=== getCamera(index) ===
Returns camera object, or nil (if camera does not exist).

==== select() ====
Selects the camera (FlightGear will switch to this camera).

==== reset() ====

==== copy() ====
Creates and returns a copy of camera object.

==== delete() ====
Removes the camera from cameras list.

Example:
<syntaxhighlight lang="nasal">fgcamera.getCameraList().getCameraByName("Pilot view").delete();</syntaxhighlight>
will delete camera named "Pilot view" from the cameras list.

==== setName(name) ====
Sets the name of camera. Returns camera object.

Example:
<syntaxhighlight lang="nasal">
var L = fgcamera.getCameraList();
L.getCameraByName("Pilot view").setName("Passenger view");
</syntaxhighlight>
will change the name of camera "Pilot view" to "Passenger view".

==== getName() ====
Returns the name of camera.

Example:
<syntaxhighlight lang="nasal">
var n = fgcamera.getCameraList().getCurrentCamera().getName();
</syntaxhighlight>
will assign currently selected camera's name to variable n.

==== getID() ====
Returns ID of camera.

==== setID(id) ====
Sets ID of camera. Returns camera object.

==== getIndex() ====
Returns the index of camera.

==== setCategory(category) ====
Sets category of camera. Returns camera object.

==== getCategory() ====
returns category of camera.

==== setFromXML(path) ====
loads camera settings from *.xml file.

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====
Saves camera settings to *.xml file.

=== getCameraByID(id) ===
Returns camera object, or nil if camera does not exist.

=== getCameraByName(name) ===
Returns camera object, or nil if camera does not exist.

=== getCurrentCamera() ===
Returns currently selected camera object with additional methods (see below)

==== storeOffsets() ====
Sets current camera location as default. Each time the camera is selected it will move to this location.

==== moveTo([x, y, z, heading, pitch, roll]) ====
Moves the camera to a new position.

=== clear() ===
Removes all the cameras from a list. Returns camera list object.

=== addCamera(name = nil, type = nil) ===
Creates new camera. Returns newly created camera object.

FGCamera API

2015-03-20T11:18:18Z

Marius A:

FGCamera API

2015-03-19T12:05:50Z

Marius A: /* getCameraList() */

{{WIP}}
{{note|Not available for FGCamera v1.2 and earlier versions}}

== getCameraList() ==

=== getCameraCount() ===

=== getCamera(index) ===

==== select() ====

==== reset() ====

==== copy() ====

==== delete() ====

==== setName(name) ====

==== getName() ====

==== getID() ====

==== setID(id) ====

==== getIndex() ====

==== setCategory(category) ====

==== getCategory() ====

==== setFromXML(path) ====

<syntaxhighlight>
<PropertyList>
<camera>
...
</camera>
</PropertyList>
</syntaxhighlight>

==== saveToXML(path) ====

=== getCameraByID(id) ===

=== getCameraByName(name) ===

=== getCurrentCamera() ===

==== storeOffsets() ====

==== moveTo([x, y, z, heading, pitch, roll]) ====

=== clear() ===

=== addCamera(name = nil, type = nil) ===

FGCamera API

2015-03-18T18:39:36Z

Marius A: Created page with "{{WIP}} {{note|Not available for FGCamera v1.2 and earlier versions}} == getCameraList() == === getCameraCount() === === getCamera(index) === ==== select() ==== ==== dele..."

{{WIP}}
{{note|Not available for FGCamera v1.2 and earlier versions}}

== getCameraList() ==

=== getCameraCount() ===

=== getCamera(index) ===

==== select() ====

==== delete() ====

==== setName(name) ====

==== getName() ====

==== getID() ====

==== setID(id) ====

==== getIndex() ====

==== setCategory(category) ====

==== getCategory() ====

=== getCurrentCamera() ===

==== storeOffsets() ====

==== moveTo([x, y, z, heading, pitch, roll]) ====

=== clear() ===

=== addCamera(name = nil, type = nil) ===

FGCamera

2015-03-16T09:55:10Z

Marius A: replay timestamps [wip]

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}
{{WIP}}
{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGY183eDJBdEpZYXM/view?usp=sharing Download fgcamera_v1_2.zip]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Replay timestamps ==
{{WIP}}
[FGCamera v1.2.1]
<syntaxhighlight>
<PropertyList>
<timestamp>
...
</timestamp>
<timestamp>
...
</timestamp>
...
</PropertyList>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>7:15.0</jump-to> 
<camera-id>0</camera-id>
</timestamp>
</syntaxhighlight>

<syntaxhighlight>
<timestamp>
<time-str>0:00.0</time-str>
<jump-to>5:25.8</jump-to> 
<click-camera>
<latitude-deg>37.62122627018694</latitude-deg>
<longitude-deg>-122.3981490730425</longitude-deg>
<altitude-ft>27.42773406108862</altitude-ft>
</click-camera>
</timestamp>
</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|10}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}
{{#ev:youtube|xsnWJe_xUgw|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2015-03-10T18:20:38Z

Marius A: /* Download link / Installation */ download link for v1.2

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}
{{WIP}}
{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGY183eDJBdEpZYXM/view?usp=sharing Download fgcamera_v1_2.zip]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|10}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2015-03-10T15:35:29Z

Marius A: WIP tag

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}
{{WIP}}
{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|10}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2015-03-10T15:31:25Z

Marius A: /* Download link / Installation */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
{{caution|create backup copies before overwriting.}}
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|10}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2015-03-10T15:27:38Z

Marius A: /* Development status (Mar 2015) */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|10}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{done}} Random camera movement (effects). Effects can be copied/pasted and imported from external files. New dialogs for RND effects management.
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2015-03-07T20:46:49Z

Marius A: /* Development status (Nov 2014) */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Mar 2015) ==
* {{progressbar|10}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{progressbar|100}} Random camera movement (effects);
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-11-17T15:18:55Z

Marius A: /* Download link / Installation */ Compatibility

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

{{note| FGCamera uses dedicated views with names "FGCamera1", "FGCamera2", "FGCamera3", "FGCamera4", "FGCamera5" with view numbers 120, 121, 122, 123, 124.
Some aircraft models check for specific view name, and other check for specific view numbers. To be fully compatible with fgcamera, aircraft model should check the property "/sim/current-view/internal" instead of view name or view number.}}

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Nov 2014) ==
* {{progressbar|10}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491];
* {{progressbar|80}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-11-03T07:36:47Z

Marius A: /* Development status (Oct 2014) */ progress update

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://www.ezdok-software.com/ EZdok Camera Addon] for Flight Simulator X.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Nov 2014) ==
* {{progressbar|10}} "[[Scripted AI Missiles|Missile]] view" mode;
* {{progressbar|80}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-30T13:58:57Z

Marius A: /* Development status (Oct 2014) */ progress update

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Oct 2014) ==
* {{progressbar|80}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|100}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FlightGear Newsletter October 2014

2014-10-30T13:54:07Z

Marius A: /* Development news */

{{draft|newsletter}}

{{Newsletter-header|October 2014}}
<div style="border-bottom:3px double #BBB;">
{| width="100%" |
| valign="top" width="33%" |
{{Newsletter-cover-header|Development news}}<br/>
{{Newsletter-cover-item|New scenery database server}}<br/>
| valign="top" width="33%" |

| valign="top" width="33%" |

|}
</div>

== Development news ==

=== Atmospheric Light Scattering ===

==== Rayleigh scattering ====

The ALS rendering framework has received another addition to its visuals - a model of Rayleigh scattering on air molecules and small aerosols in the atmosphere. The Rayleigh scattering model accounts for both out-scattering (shifting the color of distant bright light spots in the atmosphere towards the red) and in-scattering (shifting to color of distant objects to a homogeneous sky-blue). The amount of Rayleigh scattering is controlled by the air pollution slider on the Advanced Weather detailed configuration panel.

Rayleigh scattering together with the diffuse haze scattering can lead to quite impressive visuals, here some scenes from Nevada in World Scenery 2.0:

[[File:Rayleigh full.jpg|400px|Strong Rayleigh scattering]]
[[File:Rayleigh blue.jpg|400px|Different hazes in combination]]

==== Landing Lights ====

A generic implementation of landing lights for ALS is currently under development. The current set of lights is rather different from the 'true' rendering of lights the Rembrandt framework uses, and utilizes the fact that projective geometry is much simplified and rendering very fast when the origin of the light is close to the eye, i.e. <b>the lights project correctly from cockpit view only</b>.

The lights are property-controlled via <b>/sim/rendering/als-secondary-lights/</b>. There are two landing lights available which can be activated separately and displaced by offsets, and a searchlight which always follows the motion of the eye. Aircraft developers who want to equip their models with ALS-capable landing lights need to implement the logic for which view which light should be shown themselves.

Something to try: In heavy fog (visibility 200 m or less), the lights actually illuminate the fog, and the visuals of seeing the runway emerge out of white light cones in the fog is quite cool.

[[File:Landing light03.jpg|400px|Cessna 172 p using generic ALS landing lights]]
[[File:Als secondary light fog.jpg|400px|ALS generic lights illuminating dense fog]]

==== Rock effect ====

A completely rock effect has joined the ALS [[Procedural Texturing]] effect library. This allows to generate a wide range of rock colors and textures by specifying a handful of xml parameters. The effect in addition avoids all tiling artifacts on large rock surfaces and uses no texture memory on the GPU.

Since this is experimental technology, tests by interested users are highly appreciated - see the [[Procedural Texturing]] Wiki page for details.

[[File:Rock-crust.jpg|300px|No cracks]]
[[File:Rock-crack1.jpg|300px|Stretch factor 1]]
[[File:Rock-crack7.jpg|300px|Stretch factor 7]]

===FGCamera===
Version 1.2 of [[FGCamera]] will be available soon. New features:
* Fully functional with or without joystick,
* Views can be associated with 2d panels,
* Configurable dynamic head movement effect (using mass-spring-damper model).

{{#ev:youtube|11Xir9akuHc}}
{{#ev:youtube|RaHTUoyS56s}}

== Scenery corner ==
=== New scenery database server ===
The FlightGear scenery database ([http://scenemodels.flightgear.org Scenemodels] and [http://mapserver.flightgear.org Mapserver]) has been migrated to a new server. Running on two mirrored pairs of SSDs, the new system is faster than anything we had before.

[[Category:FlightGear Newsletter|2014 10]]

FGCamera

2014-10-12T12:28:52Z

Marius A: /* Development status (Oct 2014) */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{done}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility);
* {{progressbar|40}} Each camera view can open 2d panel.

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-10T14:24:30Z

Marius A: /* Development status (Oct 2014) */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|up}}, {{key press|down}}, {{key press|left}}, {{key press|right}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|Shift}} + {{key press|up}}, {{key press|Shift}} + {{key press|down}}.

* cycle through views in category: {{key press|Shift}} + {{key press|left}}, {{key press|Shift}} + {{key press|right}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{progressbar|70}} <s>Alternative config (presets) that supports "keyboard+mouse" flight controls;</s> modifying the script to fully support "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T15:05:36Z

Marius A: /* Download link / Installation */ Added download link to v1.1

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGV0VQVXZQdG8zYUE/view?usp=sharing Download fgcamera_v1_1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:55:23Z

Marius A: /* fgcamera-reset-view */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-reset-view</command>
</binding>

</syntaxhighlight>

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:53:46Z

Marius A: /* fgcamera-prev-in-category */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:52:57Z

Marius A: /* fgcamera-next-in-category */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-in-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-in-category ====
{{WIP}}

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:51:34Z

Marius A: /* fgcamera-prev-category */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-prev-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-next-in-category ====
{{WIP}}

==== fgcamera-prev-in-category ====
{{WIP}}

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:49:48Z

Marius A: /* fgcamera-next-category */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
Binding example:
<syntaxhighlight>

<binding>
<command>fgcamera-next-category</command>
</binding>

</syntaxhighlight>

==== fgcamera-prev-category ====
{{WIP}}

==== fgcamera-next-in-category ====
{{WIP}}

==== fgcamera-prev-in-category ====
{{WIP}}

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:37:28Z

Marius A: /* Commands */

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has the following commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
{{WIP}}

==== fgcamera-prev-category ====
{{WIP}}

==== fgcamera-next-in-category ====
{{WIP}}

==== fgcamera-prev-in-category ====
{{WIP}}

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:36:14Z

Marius A: /* Preconfigured keys */ Updating to v1.1

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

* cycle through categories: {{key press|↑Shift}} + {{key press|↑}}, {{key press|↑Shift}} + {{key press|↓}}.

* cycle through views in category: {{key press|↑Shift}} + {{key press|←}}, {{key press|↑Shift}} + {{key press|→}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera if default FGCamera key assignments are used }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has two commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
{{WIP}}

==== fgcamera-prev-category ====
{{WIP}}

==== fgcamera-next-in-category ====
{{WIP}}

==== fgcamera-prev-in-category ====
{{WIP}}

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T13:05:08Z

Marius A: /* "Current camera settings" Dialog */ updating to v1.1

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* Show popupTip - if selected, shows view name when the camera is selected;
* Show dialog - if selected, shows preferred GUI dialog when the camera is selected;
* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behavior:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has two commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
{{WIP}}

==== fgcamera-prev-category ====
{{WIP}}

==== fgcamera-next-in-category ====
{{WIP}}

==== fgcamera-prev-in-category ====
{{WIP}}

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T12:38:07Z

Marius A: /* Main Dialog */ (updating to v1.1)

{{infobox subsystem

|name = FGCamera
|started= 03/2014
|description = Alternate Camera Manager System
|status = Under active development as of 08/2014
|developers = * Marius_A (since 03/2014)

}}

{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}}
'''FGCamera''' is an alternative FlightGear view system that adds features similar to „EZdok Camera Addon“ for Flight Simulator X. FGCamera is written in Nasal.

'''Currently available features:'''
* 4 camera types:
** Virtual cockpit,
** Aircraft (look-at),
** Aircraft (look-from),
** World (look-from);
* Arbitrary number of preset views;
* Smooth/discrete transition between the views of the same camera type.

== Download link / Installation ==
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGTGlSeGRyOGV0bmM/edit?usp=sharing Download fgcamera_v1.rar]
# Delete (if exist) FG HOME/aircraft-data/FGCamera;
# Delete (if exist) FG ROOT/Nasal/fgcamera;
# Copy fgcamera folder (from downloaded archive) to FG ROOT/Nasal;
# Use FG ROOT/Nasal/fgcamera/fgcamera_cfg as config. If you use fgrun, open advanced settings, go to "General" and select config path (point to fgcamera_cfg.xml)

== User Interface ==
[[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)''.

Currently, there are three functional dialogs:
* Main,
* Camera creation,
* Current camera settings.

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

* "Options" button opens FGCamera's global settings dialog. This dialog is currently non functional.
* "Copy" button creates a copy of currently selected camera view,
* "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.
* The active view can be renamed using input box below the list of cameras. The second input box is used to define view category.
* Buttons "U" and "D" are used to rearrange camera views.
* "Del" button removes the active camera.
* "Save" button saves all the cameras data to disk.
* "Close" closes the dialog (changes will not be saved to disk).

=== Camera Creation Dialog ===
[[File: Fgcamera new camera dialog.jpg|thumb]]

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

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

* FOV – field of view;
* View movement – group of inputs that controls view movement between preset views:
** Transition time – time to move camera from current position to preset position.
* View adjustment – group of inputs that controls view adjustment behaviour:
** Linear velocity – translational velocity of camera in meters per second,
** 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 sensitivity – self explanatory,
** Lowpass filter – "smoothness" of the camera movement.
* "Apply" saves current camera position (does not write to disk).
* "Cancel" – closes the dialog (current camera position will not be saved).

== Controls ==
=== Preconfigured keys ===

* select preset views: {{key press|1}}, {{key press|2}}, {{key press|3}}, {{key press|4}}, {{key press|5}}, {{key press|6}}, {{key press|7}}, {{key press|8}}, {{key press|9}}, {{key press|0}}.

* adjust camera position: {{key press|↑}}, {{key press|↓}}, {{key press|←}}, {{key press|→}}, {{key press|Page Up}}, {{key press|Page Down}}.

{{note|'''to People using keyboard to fly (with or without mouse):''' throttle keys aren't working with the camera }}

Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml''

=== Commands ===
Current version of FGCamera has two commands:
* ''fgcamera-select'' - selects camera by index. If the camera does not exist, switches to camera 0;
* ''fgcamera-adjust'' - adjusts view position and orientation;
* ''fgcamera-next-category'' - cycles to next view category;
* ''fgcamera-prev-category'' - cycles to previous view category;
* ''fgcamera-next-in-category'' - cycles to next view in currently selected category;
* ''fgcamera-prev-in-category'' - cycles to previous view in currently selected category;
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation.

==== fgcamera-select ====
Uses two arguments:
* '''camera-id''' - integer number (camera-id ≥ 0);
* '''camera-type''' - currently non-functional, suggested value is "aircraft".

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="48">
<name> 0 </name>
<repeatable type="bool">false</repeatable>
<desc>Preset view 0</desc>
<binding>
<command>fgcamera-select</command>
<camera-id>0</camera-id>
<camera-type>aircraft</camera-type>
</binding>
</key>
</syntaxhighlight>

==== fgcamera-adjust ====
Uses two arguments:
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1''';
* '''dof''' - affected degree of freedom. Valid values:
** '''x''' - left/right,
** '''y''' - up/down,
** '''z''' - back/forward,
** '''h''' - heading,
** '''p''' - pitch,
** '''r''' - roll.

Keyboard binding example:
<syntaxhighlight lang="xml">
<key n="360">
<name> PageUp </name>
<desc>Camera Up</desc>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>y</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>y</dof>
</binding>
</mod-up>
</key>
</syntaxhighlight>

Joystick POV hat binding example:
<syntaxhighlight>
<axis>
<number><windows>6</windows></number>
<desc>View Direction</desc>
<low>
<binding>
<command>fgcamera-adjust</command>
<velocity>1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</low>
<high>
<binding>
<command>fgcamera-adjust</command>
<velocity>-1</velocity>
<dof>h</dof>
</binding>
<mod-up>
<binding>
<command>fgcamera-adjust</command>
<velocity>0</velocity>
<dof>h</dof>
</binding>
</mod-up>
</high>
</axis>
</syntaxhighlight>

==== fgcamera-next-category ====
{{WIP}}

==== fgcamera-prev-category ====
{{WIP}}

==== fgcamera-next-in-category ====
{{WIP}}

==== fgcamera-prev-in-category ====
{{WIP}}

==== fgcamera-reset-view ====
{{WIP}}

== Development status (Oct 2014) ==
* {{progressbar|20}} Dynamic view movement;
* {{progressbar|40}} Random camera movement (effects);
* {{not done}} Alternative config (presets) that supports "keyboard+mouse" flight controls;
* {{done}} View Categories;
* {{done}} Making view name popup-tips optional (customizable for each view);
* {{done}} Each camera view can open GUI dialog;
* {{progressbar|80}} Ability to load older version cameras (backward compatibility).

== Gallery ==
{{#ev:youtube|Ow30k9WJSeI|300}}
{{#ev:youtube|JfHf1OG7-TQ|300}}
{{#ev:youtube|cJEg5nWm4gw|300}}
{{#ev:youtube|kyMfg9g8sV8|300}}
{{#ev:youtube|YsXa6ZWNU3o|300}}
{{#ev:youtube|iRPAAnjYmkI|300}}
{{#ev:youtube|BlH7AgUFC5M|300}}
{{#ev:youtube|x-JPzLox-gI|300}}
{{#ev:youtube|YUG7G0IMpXc|300}}

== Support ==

[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread]

[[Category:Recording]]
[[Category:Nasal]]
[[Category:FlightGear add-ons]]

FGCamera

2014-10-05T12:26:10Z

Marius A: /* Commands */ (updating the article to v1.1)

File:Fgcamera camera settings dialog.jpg

2014-10-05T12:09:53Z

Marius A: Marius A uploaded a new version of "File:Fgcamera camera settings dialog.jpg"

=={{int:filedesc}}==
{{Information
|description={{en|1=Current camera settings dialog}}
|date=2014-08-11 11:41:44
|source={{own}}
|author=[[User:Marius A|Marius A]]
|permission=
|other_versions=
}}

=={{int:license-header}}==
{{self|cc-zero}}

[[Category:Screenshots of FlightGear dialogs]]

File:Fgcamera main dialog.jpg

2014-10-05T12:01:46Z

Marius A: Marius A uploaded a new version of "File:Fgcamera main dialog.jpg"

=={{int:filedesc}}==
{{Information
|description={{en|1=Main FGCamera dialog}}
|date=2014-08-11 11:41:02
|source={{own}}
|author=[[User:Marius A|Marius A]]
|permission=
|other_versions=
}}

=={{int:license-header}}==
{{self|cc-zero}}

[[Category:Screenshots of FlightGear dialogs]]

FGCamera

2014-10-02T10:55:18Z

Marius A: /* Development status (Oct 2014) */