Difference between revisions of "Vessel template wizard"

From OrbiterWiki
Jump to navigation Jump to search
(Added category.)
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This page describes Vessel template wizard
+
This page describes Vessel template wizard for [[Orbiter|Orbiter Space Flight Simulator]].
  
 
== Description ==
 
== Description ==
The goal of this wizard is to makes creting new vessel project easier. It automatizes configuration setting, adds template code for vessel and sample scenario to test it.  
+
The goal of this wizard is to makes creating new vessel project easier. It automatizes configuration setting, adds template code for vessel and sample scenario to test it.
If you have an idea how to make vessel template wizard better or you a problem using it, contact [http://www.orbiter-forum.com/member.php?u=389 Xantcha at Orbiter-Forum].
+
 
 +
If you have an idea how to make vessel template wizard better or you have have a problem using it, contact [http://www.orbiter-forum.com/member.php?u=389 Xantcha at Orbiter-Forum].
  
 
== Installing ==
 
== Installing ==
To install wizard, download it [http://orbiter-forum.com/attachment.php?attachmentid=581&d=1212767169 here] then extract content of zip into your visual studio directory.  
+
To install wizard, download it [http://orbiter-forum.com/attachment.php?attachmentid=990&d=1218538300 here] (vc expresss 2005 version) or [http://orbiter-forum.com/attachment.php?attachmentid=991&d=1218538300 here] (vc express 2008) then extract content of zip into your visual studio directory.  
 
== Usage ==
 
== Usage ==
 
* Start new project. In opened dialog you should see "Orbiter Addon" project type with "New Orbiter Vessel" template. Choose it, name your project, choose directory for it and click OK to launch template wizard.
 
* Start new project. In opened dialog you should see "Orbiter Addon" project type with "New Orbiter Vessel" template. Choose it, name your project, choose directory for it and click OK to launch template wizard.
Line 34: Line 35:
 
* '''Create scenario and vessel config''': vessel configuration file and scenario to test it
 
* '''Create scenario and vessel config''': vessel configuration file and scenario to test it
 
==== Path customization ====
 
==== Path customization ====
Clicking on '''custoize path...''' will call this dialog
+
Clicking on '''customize path...''' will call this dialog
 
[[Image:orbitertemplate_folder_selection.jpg]]
 
[[Image:orbitertemplate_folder_selection.jpg]]
  
Orbiter path or PlatformSDK paths are used for derieving this directories. If directories you want to use differ from standard layout (z.b. your orbitersdk library is not in orbiter\orbitersdk directory) you may want to change them manully. In that case don't change orbiter path and orbitersdk path since doing this will automatically reset relevant directories.
+
Orbiter path or PlatformSDK paths are used for deriving these directories. If directories you want to use differ from standard layout (z.b. your orbitersdk library is not in orbiter\orbitersdk directory) you may want to change them manually. In that case don't change orbiter path and orbitersdk path since doing this will automatically reset relevant directories.
 
 
== Compatibility ==
 
This wizard was created and tested for with Microsoft VC++ 2005 Express. Hovewer it probably should work with other version of MS VC. If you will try using it in another version of VC do following: find where you have "VCWizards" and "VCProjects" folders and copy corresponding template's folders into them.
 
Please, note here what your expirience was. This will make compatibility issue clearer and will help making updated version of template wizard more compatible.
 
  
[[Category:Tutorials]][[Category:Addon tutorials]]
+
[[Category: Articles]]
 +
[[Category:Tutorials]]
 +
[[Category:Add-on tutorials]]

Latest revision as of 12:15, 16 October 2022

This page describes Vessel template wizard for Orbiter Space Flight Simulator.

Description[edit]

The goal of this wizard is to makes creating new vessel project easier. It automatizes configuration setting, adds template code for vessel and sample scenario to test it.

If you have an idea how to make vessel template wizard better or you have have a problem using it, contact Xantcha at Orbiter-Forum.

Installing[edit]

To install wizard, download it here (vc expresss 2005 version) or here (vc express 2008) then extract content of zip into your visual studio directory.

Usage[edit]

  • Start new project. In opened dialog you should see "Orbiter Addon" project type with "New Orbiter Vessel" template. Choose it, name your project, choose directory for it and click OK to launch template wizard.

orbitertemplate new project.jpg


  • After that you will see new dialog, set necessary settings and click finish.

orbitertemplate wizard gui.jpg

Wizard setting details[edit]

  • Vessel Class: Class name for your vessel.
  • Author: Your name. Will be used only in file description.
  • Platform SDK path: Path to platform SDK. Change if you have non-default path to it. This option is saved, so you don't need to type it here every time.
  • Orbiter path: Path to orbiter installation. This option is saved, so you don't need to type it here every time.
  • Add calbacks for: options in that group add cllback methods to vessel class. (Check OrbiterAPI reference manual for more information)
    • Prestep: adds clbkPreStep method
    • Postsep: adds clbkPostStep method
    • BufferedKey: adds clbkConsumeBufferedKey method
    • DirectKey: adds clbkConsumeDirectKey method
    • Save/Load State: adds clbkLoadStateEx and clbkSaveStateEx methods
    • HUD: adds clbkDrawHUD method
  • AddSample code for: options in that group add sample code in clbkClassCaps method
    • Engine: Main, retro and hover engine definitons. (from ShuttlePB code)
    • Engine particles: Exhaust particles for engines. (from ShuttlePB code)
    • RCS: thruster definitions for Reaction control system. (modified ShuttlePB code)
  • Use ShuttlePB code: ignore "Add sample code settings" and use ShuttlePB's sample code
  • Create scenario and vessel config: vessel configuration file and scenario to test it

Path customization[edit]

Clicking on customize path... will call this dialog orbitertemplate folder selection.jpg

Orbiter path or PlatformSDK paths are used for deriving these directories. If directories you want to use differ from standard layout (z.b. your orbitersdk library is not in orbiter\orbitersdk directory) you may want to change them manually. In that case don't change orbiter path and orbitersdk path since doing this will automatically reset relevant directories.