hump Helper Utilities for More Productivity

Arithmetic (+, -, *, /) and comparative operators (==, <=, <) are defined:

• + and - only work on vectors. - is also the unary minus (e.g. print(-vector(1,2)) -- prints (-1,-2))
• a * b works on vectors and numbers:
  • If a is a number and b is a vector (or vice versa), the result the scalar multiplication.
  • If a and b both are vectors, then the result is the dot product.
• a / b is only defined for a being a vector and b being a number. Same as a * 1/b.

<= and < sort lexically, i.e. a < b is true if it holds: a.x < b.x or a.y < b.y if a.x == b.x

Warning: This will change the state of all references to this vector.

Warning: This will change the state of all references to this vector.

Treats both vectors as vectors of the xy-plane (z-coordinate =0) and calculates a vector perpendicular on them. Because the result is perpendicular on to the input vectors, it has the form (0,0,z). The z-coordinate is returned.

super's constructor can be accessed via super.construct(self). See example below.

Feline = Class{name = "Feline", function(self, size, weight)
self.size = size self.weight = weight
end}

function Feline:stats()
return string.format("size: %.02f, weight %.02f", self.size, self.weight)
end

function Feline:speak() print("meow") end


Cat = Class{name = "Cat", function(self, name, size, weight)
Feline.construct(self, size, weight)
self.name = name
end}
Inherit(Cat, Feline)

function Cat:stats()
return string.format("name: %s, %s", self.name, Feline.stats(self))
end


Tiger = Class{name = "tiger", function(self, size, weight)
Feline.construct(self, size, weight)
end}
Inherit(Tiger, Feline)

function Tiger:speak() print("ROAR!") end

felix = Cat("Felix", .8, 12)
hobbes = Tiger(2.2, 68)

print(felix:stats(), hobbes:stats())
felix:speak()
hobbes:speak()

Be careful when using metamethods like __add or __mul: When subclass inherits those methods from a superclass, but does not overwrite them, the result of the operation may be of the type superclass. Consider the following:

A = Class(function(self, x) self.x = x end)
function A:__add(other) return A(self.x + other.x) end
function A:print() print("A:", self.x) end

B = Class(function(self, x, y) A.construct(self, x) self.y = y end)
Inherit(B, A)
function B:print() print("B:", self.x, self.y) end
function B:foo() print("foo") end

one, two = B(1,2), B(3,4)
result = one + two
result:print()  -- prints "A:    4"
result:foo()    -- error: method does not exist

Calls leave() on the currently active gamestate.

Calls enter(current, ...) on the target gamestate, where current is the gamestate before the switch and ... are the additionals arguments given to Gamestate.switch.

It is an error to call this anywhere else than love.load(), since it overwrites the callbacks. Don't worry though, your callbacks will still be executed.

This is less intuitive than ringbuffer:insert(item, ...) since it appears the items are added at a random location. Use is only recommended before using ringbuffer:next() or ringbuffer:prev().

rb = Ringbuffer(1,2,5,6) -- rb = {1 ,2,5,6}, rb:get() == 1
rb:next() -- rb = {1, 2 ,5,6}, rb:get() == 2
rb:append(3,4) -- rb = {1, 2 ,5,6,3,4}, rb:get() == 2
rb:next() -- rb = {1,2, 5 ,6,3,4}, rb:get() == 5

Warning: May select the last scene when the current scene is the first scene in sequence.

Warning: May select the first scene when the current scene is the last scene in sequence.

Calls scene:draw() on currently active scene

Switches scene if current scene is finished (see scene:isFinished()).

This can be overwritten, though it is not advised to do so.

local sc = {}
-- moving and fading look cool
sc.idea = Scene(5)
function sc.idea:draw()
    local frac = (self.time / self.length) ^ 3
    love.graphics.setColor(255,255,255,160 - frac * 160)
    love.graphics.print("Idea", 200 + frac * 30, 200)
    love.graphics.setColor(255,255,255,255 - frac * 255)
    love.graphics.print("Max Power", 300 - frac * 40, 250)
end

sc.code = Scene(5)
function sc.code:draw()
    local frac = (self.time / self.length) ^ 3
    love.graphics.setColor(255,255,255,160 - frac * 160)
    love.graphics.print("Code", 200 + frac * 30, 200)
    love.graphics.setColor(255,255,255,255 - frac * 255)
    love.graphics.print("Max Power", 300 - frac * 40, 250)
end

sc.gfx = Scene(5)
function sc.gfx:draw()
    local frac = (self.time / self.length) ^ 3
    love.graphics.setColor(255,255,255,160 - frac * 160)
    love.graphics.print("GFX", 200 + frac * 30, 200)
    love.graphics.setColor(255,255,255,255 - frac * 255)
    love.graphics.print("also Max Power", 300 - frac * 40, 250)
end

sc.endscreen = Scene(-1) -- last scene. no looping
function sc.endscreen:enter()
    self.frac = 0
end

function sc.endscreen:update(dt)
    self.frac = math.min(1, self.time / 3) -- 3 sec fade in
end

function sc.endscreen:draw()
    love.graphics.setColor(255,255,255, self.frac * 255)
    love.graphics.print("The most awesome game in history", 280, 280)
end


-- create credit sequence
credits = Sequence(sc.idea, sc.code, sc.gfx)
credits:add(sc.endscreen)


-- show and update sequence
function love.draw()
    credits:draw()
end

function love.update(dt)
    credits:update(dt)
end