1,112
edits
FGCamera: Difference between revisions
Jump to navigation
Jump to search
no edit summary
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
{{WIP}} | {{WIP}} | ||
{{See also|FGCamera API}} | {{See also|FGCamera API}} | ||
{{ | {{Infobox Software | ||
<!-- | <!-- | ||
|image =Missionb.png | |image = Missionb.png | ||
--> | --> | ||
| | | title = FGCamera Add-on | ||
| | | initialrelease = Mar 2014 | ||
|description = Alternate Camera Manager System | | latestrelease = 1.2.4, Jan 7th, 2023 | ||
| | | description = Alternate Camera Manager System | ||
| | | developmentstatus = Under active development as of 08/2014 | ||
| developedby = Marius_A (since 03/2014 to 2017), Slawek Mikula (2017-2022), Roman Ludwicki (2023) | |||
| type = Addon | |||
| writtenin = Nasal | |||
| license = [[GNU General Public License]] v2 and later | |||
| website = https://github.com/PlayeRom/flightgear-addon-fgcamera | |||
<!-- | <!-- | ||
|topic-fgdata= {{Git link|gitorious|fg/missions-fgdata|topics/missions-integrate|pre=missions-fgdata/}} | |topic-fgdata= {{Git link|gitorious|fg/missions-fgdata|topics/missions-integrate|pre=missions-fgdata/}} | ||
| Line 15: | Line 20: | ||
}} | }} | ||
{{#ev:youtube|DMZB7QXpR9I|400|right|FGCamera v1.0 in action}} | <!-- {{#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://ezdok-camera.com/ EZdok Camera Addon] for Flight Simulator X. | '''FGCamera''' is an alternative FlightGear view system, written in Nasal, that adds features similar to [http://ezdok-camera.com/ EZdok Camera Addon] for Flight Simulator X. | ||
| Line 27: | Line 32: | ||
* Smooth/discrete transition between the views of the same camera type. | * Smooth/discrete transition between the views of the same camera type. | ||
= | = Installation = | ||
# [https://github.com/PlayeRom/flightgear-addon-fgcamera/releases Download] latest release. | |||
# Extract zip (if downloaded as a zip) to a given location. For example let's say we have <code>/myfolder/addons/fgcamera</code> with contents of this addon. | |||
# Add path to the addon in the Launcher application in 'Add-On' section OR run FlightGear with <code>--addon</code> option with path to FGCamera like <code>--addon="/myfolder/addons/fgcamera"</code>. | |||
{{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.}} | |||
== Installation obsolete version 1.2.0 without add-on compatibility == | |||
{{caution|create backup copies before overwriting.}} | {{caution|create backup copies before overwriting.}} | ||
# [https://drive.google.com/file/d/0B7ZpQgmbsSZGY183eDJBdEpZYXM/view?usp=sharing Download fgcamera_v1_2.zip] | # [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 HOME/aircraft-data/FGCamera; | ||
| Line 37: | Line 52: | ||
# 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) | # 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|make sure that ''File > Input Configuration > Click right mouse to cycle mouse behaviour'' (FG menu) is selected}} | ||
Old development version 1.3 of FGCamera can be downloaded [https://drive.google.com/open?id=0B7ZpQgmbsSZGNkJOYzZFb1RZUnc here]. | |||
= User Interface = | |||
[[File: Fgcamera menu item.jpg|thumb]] | [[File: Fgcamera menu item.jpg|thumb]] | ||
| Line 52: | Line 66: | ||
* Current camera settings. | * Current camera settings. | ||
== Main Dialog == | |||
[[File: Fgcamera main dialog.jpg|thumb]] | [[File: Fgcamera main dialog.jpg|thumb]] | ||
| Line 65: | Line 79: | ||
* "Close" closes the dialog (changes will not be saved to disk). | * "Close" closes the dialog (changes will not be saved to disk). | ||
== Camera Creation Dialog == | |||
[[File: Fgcamera new camera dialog.jpg|thumb]] | [[File: Fgcamera new camera dialog.jpg|thumb]] | ||
| Line 76: | Line 90: | ||
* "Cancel" – closes the dialog. | * "Cancel" – closes the dialog. | ||
== "Current camera settings" Dialog == | |||
[[File: Fgcamera camera settings dialog.jpg|thumb]] | [[File: Fgcamera camera settings dialog.jpg|thumb]] | ||
| Line 94: | Line 108: | ||
* "Cancel" – closes the dialog (current camera position will not be saved). | * "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}}. | * 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}}. | ||
| Line 109: | Line 123: | ||
Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml'' | Key assignments can be customized by editing ''FGROOT/Nasal/fgcamera/fgcamera_cfg.xml'' | ||
== Commands == | |||
Current version of FGCamera has the following 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-select'' - selects camera by index. If the camera does not exist, switches to camera 0; | ||
| Line 119: | Line 133: | ||
* ''fgcamera-reset-view'' - resets currently selected camera's position and orientation. | * ''fgcamera-reset-view'' - resets currently selected camera's position and orientation. | ||
=== fgcamera-select === | |||
Uses two arguments: | Uses two arguments: | ||
* '''camera-id''' - integer number (camera-id ≥ 0); | * '''camera-id''' - integer number (camera-id ≥ 0); | ||
| Line 138: | Line 152: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== fgcamera-adjust === | |||
Uses two arguments: | Uses two arguments: | ||
* '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1'''; | * '''velocity''' - camera movement velocity. Recommended values '''-1''', '''0''', '''1'''; | ||
| Line 205: | Line 219: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== fgcamera-next-category === | |||
Binding example: | Binding example: | ||
<syntaxhighlight> | <syntaxhighlight> | ||
| Line 215: | Line 229: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== fgcamera-prev-category === | |||
Binding example: | Binding example: | ||
<syntaxhighlight> | <syntaxhighlight> | ||
| Line 225: | Line 239: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== fgcamera-next-in-category === | |||
Binding example: | Binding example: | ||
<syntaxhighlight> | <syntaxhighlight> | ||
| Line 235: | Line 249: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== fgcamera-prev-in-category === | |||
Binding example: | Binding example: | ||
<syntaxhighlight> | <syntaxhighlight> | ||
| Line 245: | Line 259: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== fgcamera-reset-view === | |||
Binding example: | Binding example: | ||
<syntaxhighlight> | <syntaxhighlight> | ||
| Line 255: | Line 269: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
= Replay timestamps = | |||
{{WIP}} | {{WIP}} | ||
[FGCamera v1.2.1] | [FGCamera v1.2.1] | ||
| Line 290: | Line 304: | ||
</syntaxhighlight> | </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|60}} "AI/MP [[Scripted AI Missiles|Missile]] view" mode [http://forum.flightgear.org/viewtopic.php?f=27&t=24491]; | ||
* {{progressbar|80}} Dynamic view movement; | * {{progressbar|80}} Dynamic view movement; | ||
| Line 303: | Line 317: | ||
* {{progressbar|80}} reimplement current FGCamera functionality using [[Property rules]] (reduce Nasal usage); | * {{progressbar|80}} reimplement current FGCamera functionality using [[Property rules]] (reduce Nasal usage); | ||
= Gallery = | |||
{{#ev:youtube|Ow30k9WJSeI|300}} | {{#ev:youtube|Ow30k9WJSeI|300}} | ||
{{#ev:youtube|JfHf1OG7-TQ|300}} | {{#ev:youtube|JfHf1OG7-TQ|300}} | ||
| Line 312: | Line 326: | ||
{{#ev:youtube|BlH7AgUFC5M|300}} | {{#ev:youtube|BlH7AgUFC5M|300}} | ||
{{#ev:youtube|x-JPzLox-gI|300}} | {{#ev:youtube|x-JPzLox-gI|300}} | ||
{{#ev:youtube|YUG7G0IMpXc|300}} | <!-- {{#ev:youtube|YUG7G0IMpXc|300}} | ||
{{#ev:youtube|xsnWJe_xUgw|300}} | {{#ev:youtube|xsnWJe_xUgw|300}} --> | ||
= Support = | |||
[http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread] | [http://forum.flightgear.org/viewtopic.php?f=6&t=21685&start=30 FGCamera forum thread] | ||