Classes

Lua does not support classes the way languages like C++, Java and ActionScript do. But Lua is a multi-paradigm language and have roots from prototype-based languages. In Lua, each object can define its own behaviour through metatables. Therefore, it is possible to emulate OO programming and classes in Lua.

Note: For the detailed discussion of object oriented programming in Lua, please refer to http://www.lua.org/pil/16.html

Gideros follows the same paradigm in its API design. Each instance created by Gideros API is a Lua table with a metatable attached.

Creating Instances

Instances in Gideros is created through new function. For example, to create a Sprite, Texture, Bitmap and a Timer instance:

<syntaxhighlight lang="lua"> local sprite = Sprite.new() local texture = Texture.new("image.png") local bitmap = Bitmap.new(texture) local timer = Timer.new(1000, 0) </source>

Inheritance

The Core.class function is used to create your own classes through inheritance (older versions of Gideros used the gideros.class function -- this function has now been deprecated). You can inherit from Gideros API's own classes (EventDispatcher, Sprite, etc.) or from your own classes. For example, you can create your own class that inherits from EventDispatcher class like so:

<syntaxhighlight lang="lua"> MyEventDispatcher = Core.class(EventDispatcher) </source>

You can also create a new class by using Core.class with no arguments:

<syntaxhighlight lang="lua"> MyOwnClass = Core.class() </source>

By using Inheritance, you can design and implement the visual elements of your game separately:

<syntaxhighlight lang="lua"> -- create your own start button class StartButton = Core.class(Sprite)

-- create your own menu class Menu = Core.class(Sprite)

-- create your own player class Player = Core.class(Sprite)

function Player:walk()

 -- walk logic

end

function Player:jump()

 -- jump logic

end

-- create and add a player instance to the stage stage:addChild(Player.new()) </source>

When an instance is created, init function is called to do the initialization:

<syntaxhighlight lang="lua"> Player = Core.class(Sprite)

function Player:init()

 -- do the initialization of Player instance
 self.health = 100
 self.speed = 3

end

-- after Player instance is created, init function is called local player = Player.new() </source>

Whether to use inheritance or not is related to your programming taste. It's possible to implement a whole game without creating custom classes. You can refer to "Jumping Ball" and "Jumping Balls" examples to see the difference between designing your code with classes or not.

Using classes makes it easier to reuse code.

Inheriting From Classes With Constructor Arguments

If you inherit from a class that takes a constructor argument, your new class has to pass in the arguments that the base class expects as its first arguments. You can then pass in any additional arguments:

<syntaxhighlight lang="lua"> MyBitmap = Core.class(Bitmap)

function MyBitmap:init(texture, additional args)

 ....

end </source>

Here's a very simple example:

<syntaxhighlight lang="lua"> A = Core.class()

function A:init(msg1)

 print("A:init("..msg1..")")

end

B = Core.class(A)

function B:init(msg1, msg2)

 print("B:init("..msg1..","..msg2..")")

end

B.new("hello","world") </source>

This example produces:

A:init(hello)
B:init(hello,world)

Adding Explicit Dependencies for Inherited Classes

You can put class definitions in different files, but if it doesn't work, it may be because the files are being loaded in the wrong order. You can specify file dependencies in the IDE. Select a file, right click, then select "Code Dependencies".

For example, if class A (in classA.lua) inherits from class B (in classB.lua) and you're getting a message like "attempt to index global 'B' (a nil value)" during the initialization process, select "classA.lua" and add a dependency on classB.lua.

Accessing Overridden Functions

If you inherit from a class and override one of its functions, you have to call the overridden function using syntax like "BaseClassName.function(self)". Here's an example: <syntaxhighlight lang="lua"> -- --------------------------------------

A = Core.class()

function A:init(msg1)

 self.text = "I'm an A"

end

function A:method()

  print(self.text .. " in A:method()")

end

-- --------------------------------------

B = Core.class(A)

function B:init(msg1, msg2)

 self.text = "I'm a B"

end

function B:method(arg1)

 print(self.text .. " in B:method()")
 --A:method()       <--- NOT THIS
  A.method(self)  

end

-- --------------------------------------

b = B.new("hello","world") b:method() </source>

This will produce:

I'm a B in B:method()
I'm a B in A:method()

If you try to use "A:method()" in "B:method()" you'll get an error about a nil value for the 'text' field. That's because you're using the "A" instance that was created in the "A = Core.class()" line (equivalent to "A.method(A)").

If you try to use "self:method()", you'll be recursively calling "B:method()"