Gizmo

From X-Plugins

Jump to: navigation, search

Gizmo is a plugin for X-Plane that provides a rich scripting environment powered by the Lua language at its core.

Gizmo aims to provide content authors with a comprehensive set of tools to create compelling add ons for the X-Plane flight simulator.

By leveraging the following libraries, Gizmo offers an easy to use solution for enhancing X-Plane.

  • OpenAL Audio
  • Bullet Physics
  • cURL
  • LuaGL
  • PThreads


Contents

Download

X-Plane Plugin

  • Gizmo 10.3.4 - Mac

http://dl.dropbox.com/u/948813/Gizmo/10.3.4/Gizmo.plugin-Mac-10.3.4.21.22.zip

  • Gizmo 10.3.4 - Win

http://dl.dropbox.com/u/948813/Gizmo/10.3.4/Gizmo.plugin-Win-10.3.4.21.22.zip

Install

Macintosh

Extract and install the libcurl.framework package into /Library/Frameworks/


Windows DLL Package Installer

http://dl.dropbox.com/u/948813/Gizmo/10.3.4/Windows_pThreads.exe


Windows DLL "By Hand" Install Steps

Windows 64bit

Unzip and install the pthreadGC2.dll into your Windows\WoW64 folder.

Windows 32bit

Unzip and install the pthreadGC2.dll into your Windows\System32 folder.


Linux (Ubuntu)

  • Install liblua5.1
  • Install libcurl4-gnutls-dev (Sloppy, whatever, lib-curl is a surprising mess on Linux..)

Documentation

Gizmo for Players

Gizmo for Content Authors

What does Gizmo offer me?

  • "Built in" DRM.
    • 10 minute trial period of your product in the simulator.
    • Ability to generate time-limited licenses.
      • Allows for "Free Trial" periods.
      • Allows for "Re-Activation" by users.
    • HTTP based back end servers powered by Google's App Engine infrastructure.
    • Only licensed Gizmo authors can enhance their aircraft, stand out by providing advanced functionality.
  • Extensive, easy to use access to a broad feature set.
  • Agile development, working with Lua scripting is extremely productive.
  • Write one set of scripts, run everywhere. Gizmo works on Windows, Mac and Linux.
  • Ship your scripts as 128-bit encrypted byte-code! No need to expose your script source code to the world.
  • Minimal "user installation" hassles, Gizmo exposes many useful tools by default.

How can I start working with it?

To start working with Gizmo you need to be an authorized developer. Being a developer grants you access to the tools that generate keys that allow Gizmo to work with your ACF files.

If you think you have what it takes to produce next-gen content for X-Plane and you would like to work with Gizmo you can contact either http://X-Aviation.com or myself directly at br@x-plugins.com

Please note that at this time it is NOT possible to develop free, open, products with Gizmo. Gizmo is designed from the ground up to secure both itself and the products it enhances.

Developer Reference

Optimizing your Lua Scripts

As we are writing scripts for a flight sim it is important to strive for fast, efficient programming. This PDF will help you optimize your Lua usage: http://www.lua.org/gems/sample.pdf

Useful Math Functions

Useful math http://www.movable-type.co.uk/scripts/latlong.html TODO: Expose these as a Gizmo API module so they can run in C


LuaGL

http://luagl.luaforge.net/

Editor of Choice

Free, and available for all platforms. http://www.activestate.com/komodo_edit/


Hello World

<ACF>/scripts/init.lua 

sound.say("Hello World!");

The script example above will cause X-Plane to annunciate "Hello World!" using the built in text-to-speech engine that is used by the built in ATC system. It will also cause the text to be displayed at the top of the screen in a green font surrounded by a translucent green box. (Assuming sound options are configured as default.)


Scripting API Reference

Please see the Gizmo/api for more info on using Gizmo.

Retrieved from "http://www.x-plugins.com/wiki/Gizmo"