Overview
wxLua is a set of bindings to the C++ wxWidgets cross-platform GUI library for the Lua programming language. You can write complex, graphical, interactive programs with wxLua to develop and deliver your software with the programming ease of an interpreted language like Lua. Nearly all of the functionality of wxWidgets is exposed to Lua, meaning that your programs can have windows, dialogs, menus, toolbars, controls, image loading and saving, drawing, sockets, streams, printing, clipboard access...and much more.

wxLua is released with the same license as wxWidgets. The license can be viewed at: http://wxlua.sourceforge.net/license.php

Download
The source code for wxLua, including several samples, can be found at its project page: http://wxlua.sourceforge.net/index.php

We've assembled the .dll files from the Lua for Windows binaries package into a .zip file in order to facilitate its use as a Lua module.

Installation
Here is how to make the wxLua module available to your AutoPlay Media Studio 8.0 project:

1. Download wxLua_module.zip and extract it to a temporary location.

2. Copy the four .dll files files to your project's Scripts folder.

3. Add the following require to your project, e.g. in Global Functions, before using any of the wxLua bindings:
require("wx") -- load the wxLua bindings

4. Add the following call to your code (at the end) where you want to start the wxWidgets event loop:
wx.wxGetApp():MainLoop() -- start the wxWidgest event loop

Usage
Although wxLua is quite advanced, it has extensive documentation which can be found here: http://wxlua.sourceforge.net/documentation.php

Note: The wxLua binaries package contains many sample scripts in a "samples" folder that serve as good examples for using wxLua. You may use those samples in AutoPlay either by copying and pasting their contents (the actual Lua script), or by renaming them to have only a single decimal point so they can be executed using require().

For example, to run the scribble.wx.lua sample, copy it into your project's Scripts folder as "scribble_wx.lua" and then run it using:
require("scribble_wx");

Example
Here is a simple Lua script which creates a wxFrame top level window and a menubar:

require"wx"



frame = wx.wxFrame(wx.NULL, wx.wxID_ANY, "wxLua Minimal Demo",

                   wx.wxDefaultPosition, wx.wxSize(450, 450),

                   wx.wxDEFAULT_FRAME_STYLE)



-- create a simple file menu

local fileMenu = wx.wxMenu()

fileMenu:Append(wx.wxID_EXIT, "E&xit", "Quit the program")



-- create a simple help menu

local helpMenu = wx.wxMenu()

helpMenu:Append(wx.wxID_ABOUT, "&About",

                "About the wxLua Minimal Application")



-- create a menu bar and append the file and help menus

local menuBar = wx.wxMenuBar()

menuBar:Append(fileMenu, "&File")

menuBar:Append(helpMenu, "&Help")



-- attach the menu bar into the frame

frame:SetMenuBar(menuBar)



-- create a simple status bar

frame:CreateStatusBar(1)

frame:SetStatusText("Welcome to wxLua.")



-- connect the selection event of the exit menu item to an

-- event handler that closes the window

frame:Connect(wx.wxID_EXIT, wx.wxEVT_COMMAND_MENU_SELECTED,

              function (event) frame:Close(true) end )

-- connect the selection event of the about menu item

frame:Connect(wx.wxID_ABOUT, wx.wxEVT_COMMAND_MENU_SELECTED,

        function (event)

            wx.wxMessageBox('This is the "About" dialog of the Minimal wxLua sample.',

                            "About wxLua",

                            wx.wxOK + wx.wxICON_INFORMATION,

                            frame)

        end )



-- finally, show the frame window

frame:Show(true)



wx.wxGetApp():MainLoop()