mirror of
https://github.com/vrld/hump.git
synced 2024-11-23 12:24:19 +00:00
595 lines
28 KiB
HTML
595 lines
28 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
|
<title>hump - LÖVE Helper Utilities for More Productivity</title>
|
|
|
|
<style type="text/css">
|
|
body {
|
|
margin-top: 1.0em;
|
|
background-color: #f7fcfc;
|
|
font-family: "Helvetica,Arial,FreeSans";
|
|
color: #000000;
|
|
}
|
|
#container {
|
|
margin: 0 auto;
|
|
width: 800px;
|
|
}
|
|
h1 { font-size: 3.8em; color: #080303; margin-bottom: 10px; border-bottom: 2px solid #080303; }
|
|
h1 .small { font-size: 0.4em; }
|
|
h1 a { text-decoration: none }
|
|
h2 { font-size: 1.5em; color: #080303; border-top: 1px solid #a0a0a0; }
|
|
h3 { color: #080303; margin-bottom: 1em; background: #eee; margin-top: 3em; }
|
|
h4 { color: #080303; margin-top: 2em; }
|
|
a { color: #080303; }
|
|
.description { font-size: 1.2em; margin-bottom: 30px; margin-top: 30px; font-style: italic;}
|
|
.download { float: right; }
|
|
pre { background: #000; color: #fff; padding: 15px;}
|
|
hr { border: 0; width: 80%; border-bottom: 1px solid #aaa}
|
|
.footer { text-align:center; padding-top:30px; font-style: italic; }
|
|
|
|
ul.nav { display:inline; margin-left: 0; padding-left: 0; }
|
|
ul.nav li { display:inline; margin-right: 1em; }
|
|
|
|
a.top { font-size: 8pt; margin-left: 1em; float: right; }
|
|
|
|
.doc { padding-left: 1em; margin-bottom: 1em; border-left: 1px dotted #aaa; }
|
|
.function { display:block; font-weight:bold; font-family: fixed; background: #f9f9f9; border:1px solid #ddd; margin-left: -1em; }
|
|
|
|
.functionlist { border-left: 1px dotted #aaa; margin: -.6em 0 0 2em; }
|
|
.functionlist a { text-decoration: none; font-weight:bold; color: #506060; }
|
|
.functionlist a:hover { color: black; }
|
|
|
|
.doc table { margin-top: 5px; }
|
|
th { text-align: left; font-weight: normal; font-style: italic; text-decoration: underline; }
|
|
td { padding-left: 1em; }
|
|
.doc td em { font-size: .8em; font-weight:bold; font-style:normal; padding-right: .6em;}
|
|
|
|
.doc pre, code { color: black; padding: 0; font-family: fixed; border: 1px solid #ddd; background: #e7ecec; }
|
|
</style>
|
|
</head>
|
|
|
|
<body>
|
|
<a href="http://github.com/vrld/hump"><img style="position: absolute; top: 0; right: 0; border: 0;" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a>
|
|
|
|
<a name="top"></a>
|
|
<div id="container">
|
|
|
|
<h1><a href="http://github.com/vrld/hump">hump</a>
|
|
<span class="small"> Helper Utilities for More Productivity</span></h1>
|
|
|
|
<ul class="nav">
|
|
<li><a href="#intro">Introduction</a></li>
|
|
<li><a href="#doc">Documenation</a></li>
|
|
<li><a href="#license">License</a></li>
|
|
<li><a href="#download">Download</a></li>
|
|
</ul>
|
|
|
|
<a name="intro"></a>
|
|
<h2>Introduction<a class="top" href="#top">^ top</a></h2>
|
|
<p><em>Helper Utilities for a Multitude of Problems</em> is a set of lightweight helpers
|
|
for the excellent <a href="http://love2d.org/">LÖVE</a> Engine.</p>
|
|
|
|
<p>It currently features
|
|
<ul>
|
|
<li><em>vector.lua</em>: a mature vector type,</li>
|
|
<li><em>class.lua</em>: a simple and easy class system with function inheritance,</li>
|
|
<li><em>camera.lua</em>: a translate-, zoom- and rotatable camera and</li>
|
|
<li><em>gamestate.lua</em>: a gamestate system.</li>
|
|
</ul></p>
|
|
|
|
<p><em>hump</em> differs from other libraries in that every component is independent of the
|
|
remaining ones (apart from camera.lua, which depends on the vector type).
|
|
<em>hump</em>'s footprint is very small and thus should fit nicely into your projects.</p>
|
|
|
|
<a name="doc"></a>
|
|
<h2>Documentation<a class="top" href="#top">^ top</a></h2>
|
|
|
|
Below is the documentation of the various modules. You can directly jump to a
|
|
module by clicking these:
|
|
<ul>
|
|
<li><a href="#vector.lua">vector.lua</a></li>
|
|
<li><a href="#class.lua">class.lua</a></li>
|
|
<li><a href="#camera.lua">camera.lua</a></li>
|
|
<li><a href="#gamestate.lua">gamestate.lua</a></li>
|
|
</ul>
|
|
|
|
<div class="module">
|
|
<a name="vector.lua"></a>
|
|
<h3>vector.lua<a class="top" href="#doc">^ top</a></h3>
|
|
<p>A vector class implementing everything you want to do with vectors, and some more.</p>
|
|
<p>Overview (click item for more details):
|
|
<table class="functionlist">
|
|
<tr><td><a href="#vector.lua-vector">vector(x,y)</a></td><td>constructor</td></tr>
|
|
<tr><td><a href="#vector.lua-isvector">isvector(v)</a></td><td>type check</td></tr>
|
|
<tr><td><a href="#vector.lua-clone">Vector:clone()</a></td><td>deep copy</td></tr>
|
|
<tr><td><a href="#vector.lua-unpack">Vector:unpack()</a></td><td>element unfolding</td></tr>
|
|
<tr><td><a href="#vector.lua-operators">Operators</a></td><td>Arithmetics and ordering</td></tr>
|
|
<tr><td><a href="#vector.lua-permul">vector:permul(other)</a></td><td>per-element multiplication</td></tr>
|
|
<tr><td><a href="#vector.lua-len">vector:len()</a></td><td>vector length</td></tr>
|
|
<tr><td><a href="#vector.lua-len2">vector:len2()</a></td><td>squared vector length</td></tr>
|
|
<tr><td><a href="#vector.lua-dist">vector:dist(other)</a></td><td>distance to vector</td></tr>
|
|
<tr><td><a href="#vector.lua-normalized">vector:normalized()</a></td><td>normalize vector</td></tr>
|
|
<tr><td><a href="#vector.lua-normalize_inplace">vector:normalize_inplace()</a></td><td>normalize vector in-place</td></tr>
|
|
<tr><td><a href="#vector.lua-rotated">Vector:rotated(phi)</a></td><td>rotate vector</td></tr>
|
|
<tr><td><a href="#vector.lua-rotate_inplace">Vector:rotate_inplace(phi)</a></td><td>rotate vector in-place</td></tr>
|
|
</table></p>
|
|
|
|
<a name="vector.lua-vector"></a>
|
|
<div class="doc"><span class="function">function vector(x,y)<a class="top" href="#vector.lua">^ top</a></span>
|
|
Creates a new vector. Element access with <code>v.x</code> and <code>v.y</code>.
|
|
<table>
|
|
<tr><th>Parameters:</th><td><em>[number]</em><code>x</code>:</td><td>x coordinate</td></tr>
|
|
<tr><td> </td><td><em>[number]</em><code>y</code>:</td><td>y coordinate</td></tr>
|
|
<tr><th>Returns:</th><td colspan="2">the vector</td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="vector.lua-isvector"></a>
|
|
<div class="doc"><span class="function">function isvector(v)<a class="top" href="#vector.lua">^ top</a></span>
|
|
Tests for vector type.
|
|
<table>
|
|
<tr><th>Parameters:</th><td><code>v</code></td><td>variable to test</td></tr>
|
|
<tr><th>Returns:</th><td colspan="2"><code>true</code> if <code>v</code> is a vector</td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="vector.lua-clone"></a>
|
|
<div class="doc"><span class="function">function vector:clone()<a class="top" href="#vector.lua">^ top</a></span>
|
|
Clones a vector. Use when you do not want to create references.
|
|
<table>
|
|
<tr><th>Returns:</th><td colspan="2">New vector with the same coordinates.</td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="vector.lua-unpack"></a>
|
|
<div class="doc"><span class="function">function vector:unpack()<a class="top" href="#vector.lua">^ top</a></span>
|
|
Unpacks the vector.
|
|
<table>
|
|
<tr><th>Returns:</th><td colspan="2">the coordinate tuple <code>x, y</code></td></tr>
|
|
<tr><th colspan="3">Example:</th></tr>
|
|
<tr><td colspan="3"><pre>v = vector(1,2)
|
|
print(v:unpack()) -- prints "1 2"</pre></td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="vector.lua-operators"></a>
|
|
<div class="doc"><span class="function">Operators<a class="top" href="#vector.lua">^ top</a></span>
|
|
<p>Arithmetic (<code>+</code>, <code>-</code>, <code>*</code>, <code>/</code>) and
|
|
comparative operators (<code>==</code>, <code><=</code>, <code><</code>) are defined:</p>
|
|
|
|
<ul>
|
|
<li><code>+</code> and <code>-</code> <em>only</em> work on vectors. <code>-</code> is also
|
|
the unary minus (e.g. <code>print(-vector(1,2)) -- prints (-1,-2)</code>)</li>
|
|
<li><code>a * b</code> works on vectors and numbers:<ul>
|
|
<li>If <code>a</code> is a number and <code>b</code> is a vector (or vice versa),
|
|
the result the scalar multiplication.</li>
|
|
<li>If <code>a</code> and <code>b</code> both are vectors, then the result is the
|
|
<em>dot product</em>.</li></ul></li>
|
|
<li><code>a / b</code> is only defined for <code>a</code> being a vector and <code>b</code>
|
|
being a number. Same as <code>a * 1/b</code>.</li>
|
|
</ul>
|
|
|
|
<p><code><=</code> and <code><</code> sort lexically, i.e. <code>a < b</code>
|
|
is true if it holds: <code>a.x < b.x</code> or <code>a.y < b.y</code> if
|
|
<code>a.x == b.x</code></p>
|
|
</div>
|
|
|
|
<a name="vector.lua-permul"></a>
|
|
<div class="doc"><span class="function">function vector:permul(other)<a class="top" href="#vector.lua">^ top</a></span>
|
|
Perform element-wise multiplication.
|
|
</div>
|
|
|
|
<a name="vector.lua-len"></a>
|
|
<div class="doc"><span class="function">function vector:len()<a class="top" href="#vector.lua">^ top</a></span>
|
|
Get length of vector.
|
|
</div>
|
|
|
|
<a name="vector.lua-len2"></a>
|
|
<div class="doc"><span class="function">function vector:len2()<a class="top" href="#vector.lua">^ top</a></span>
|
|
Get squared length.
|
|
</div>
|
|
|
|
<a name="vector.lua-dist"></a>
|
|
<div class="doc"><span class="function">function vector:dist(other)<a class="top" href="#vector.lua">^ top</a></span>
|
|
Get distance to other vector.
|
|
|
|
<table><tr><th>Example:</th></tr>
|
|
<tr><td><pre>a,b = vector(0,1), vector(1,0)
|
|
print(a:dist(b)) -- prints 1.4142135623731</pre></td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="vector.lua-normalized"></a>
|
|
<div class="doc"><span class="function">function vector:normalized()<a class="top" href="#vector.lua">^ top</a></span>
|
|
Get normalized vector. The original vector remains unchanged.
|
|
</div>
|
|
|
|
<a name="vector.lua-normalize_inplace"></a>
|
|
<div class="doc"><span class="function">function vector:normalize_inplace()<a class="top" href="#vector.lua">^ top</a></span>
|
|
Normalize vector and return it.
|
|
<p><strong>Warning:</strong> This will change the state of all references to this vector.</p>
|
|
</div>
|
|
|
|
<a name="vector.lua-rotated"></a>
|
|
<div class="doc"><span class="function">function vector:rotated(phi)<a class="top" href="#vector.lua">^ top</a></span>
|
|
Get rotated vector. The original vector remains unchanged.
|
|
<table>
|
|
<tr><th>Parameters:</th><td><em>[number]</em><code>phi</code>:</td><td>Rotation angle in radians.</td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="vector.lua-rotate_inplace"></a>
|
|
<div class="doc"><span class="function">function vector:rotate_inplace(phi)<a class="top" href="#vector.lua">^ top</a></span>
|
|
Rotate the vector and return it.
|
|
<p><strong>Warning:</strong> This will change the state of all references to this vector.</p>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<div class="module">
|
|
<a name="class.lua"></a>
|
|
<h3>class.lua<a class="top" href="#doc">^ top</a></h3>
|
|
<p>class.lua provides a simple and easy to use class system. Albeit it's
|
|
limitations, class.lua offers multiple inheritance and minimal
|
|
reflection capabilities. Note that only methods will be inherited
|
|
and runtime changes of a superclass won't affect subclasses.</p>
|
|
<p>The module only consists of three functions:
|
|
<table class="functionlist">
|
|
<tr><td><a href="#class.lua-Class">Class(constructor)</a></td><td>define class</td></tr>
|
|
<tr><td><a href="#class.lua-Class2">Class{name = name, constructor}</a></td><td>define named class</td></tr>
|
|
<tr><td><a href="#class.lua-Interface">Interface(name)</a></td><td>define interface</td></tr>
|
|
<tr><td><a href="#class.lua-Inherit">Inherit(class, super, ...)</a></td><td>subclassing</td></tr>
|
|
</table></p>
|
|
<p>For an example, <a href="#class.lua-Example">see below</a>. Also be sure to read the
|
|
<a href="#class.lua-Warning">warning</a> regarding metamethods.</p>
|
|
|
|
<a name="class.lua-Class"></a>
|
|
<div class="doc"><span class="function">function Class(constructor)<a class="top" href="#class.lua">^ top</a></span>
|
|
Creates a new unnamed class.
|
|
<table>
|
|
<tr><th>Parameters:</th><td><em>[optional function]</em><code>constructor</code></td>
|
|
<td>A function used to construct the class. The first parameter of this function
|
|
is the object, the others are parameters given upon construction.</td></tr>
|
|
<tr><th>Returns:</th><td colspan="2">the new class</td></tr>
|
|
<tr><th colspan="3">Example</th></tr>
|
|
<tr><td colspan="3"><pre>Feline = Class(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
|
|
|
|
garfield = Feline(.7, 45)
|
|
felix = Feline(.8, 12)
|
|
|
|
print("Garfield: " .. garfield:stats(), "Felix: " .. felix:stats())</pre></td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="class.lua-Class2"></a>
|
|
<div class="doc"><span class="function">function Class{name = name, constructor}<a class="top" href="#class.lua">^ top</a></span>
|
|
Create a named class, i.e. define a <code>__tostring</code> metamethod. Parameters are the same as above.
|
|
Great for debugging. Both <code>name</code> and <code>constructor</code> can be omitted (but why would you want to?)
|
|
|
|
<table><tr><th>Example:</th></tr>
|
|
<tr><td><pre>Feline = Class{name = "Feline", function(self, size, weight)
|
|
self.size = size self.weight = weight
|
|
end}
|
|
|
|
print(Feline) -- prints 'Feline'</pre></td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="class.lua-Interface"></a>
|
|
<div class="doc"><span class="function">function Interface(name)<a class="top" href="#class.lua">^ top</a></span>
|
|
Shortcut to <code>Class{name = name}</code>, i.e. a possibly named class without constructor.
|
|
</div>
|
|
|
|
<a name="class.lua-Inherit"></a>
|
|
<div class="doc"><span class="function">function Inherit(class, super, ...)<a class="top" href="#class.lua">^ top</a></span>
|
|
Add functions of <code>super</code> to <code>class</code>. Multiple interfaces can be defined.
|
|
<p><code>super</code>'s constructor can be accessed via super.construct(self). See example below.</p>
|
|
</div>
|
|
|
|
<a name="class.lua-Example"></a>
|
|
<h4>Example usage</h4>
|
|
<div class="doc"><span class="function">Everybody loves cats!<a class="top" href="#class.lua">^ top</a></span>
|
|
<pre>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()</pre>
|
|
</div>
|
|
|
|
<a name="class.lua-Warning"></a>
|
|
<h4>Warning</h4>
|
|
<div class="doc"><span class="function">Nothing is perfect<a class="top" href="#class.lua">^ top</a></span>
|
|
<p>Be careful when using metamethods like <code>__add</code> or <code>__mul</code>:
|
|
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:</p>
|
|
<pre>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</pre>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="module">
|
|
<a name="camera.lua"></a>
|
|
<h3>camera.lua<a class="top" href="#doc">^ top</a></h3>
|
|
<em>Depends on <a href="#vector.lua">vector.lua</a></em>
|
|
<p>Camera object to display only a partial region of the game world. The region
|
|
can be zoomed and rotated. You can transform camera coordinates to world coordinated
|
|
(e.g. get the location of the mouse in the game world). It is possible to have
|
|
more than one camera per game.</p>
|
|
|
|
<p>The module defined the following funtions:
|
|
<table class="functionlist">
|
|
<tr><td><a href="#camera.lua-Camera">Camera(pos, zoom, rotation)</a></td><td>create new camera</td></tr>
|
|
<tr><td><a href="#camera.lua-rotate">camera:rotate(phi)</a></td><td>rotate camera</td></tr>
|
|
<tr><td><a href="#camera.lua-translate">camera:translate(t)</a></td><td>move camera</td></tr>
|
|
<tr><td><a href="#camera.lua-draw">camera:draw(func)</a></td><td>apply camera transformations on function</td></tr>
|
|
<tr><td><a href="#camera.lua-apply">camera:apply()</a></td><td>apply camera transformations</td></tr>
|
|
<tr><td><a href="#camera.lua-deapply">camera:deapply()</a></td><td>revert camera transformations</td></tr>
|
|
<tr><td><a href="#camera.lua-transform">camera:transform(p)</a></td><td>get world coordinates</td></tr>
|
|
<tr><td><a href="#camera.lua-mousepos">camera:mousepos()</a></td><td>get world coordinates of mouse</td></tr>
|
|
</table></p>
|
|
|
|
<a name="camera.lua-Camera"></a>
|
|
<div class="doc"><span class="function">function Camera(pos, zoom, rotation)<a class="top" href="#camera.lua">^ top</a></span>
|
|
Create a new camera with position pos, zoom zoom and rotation rotation. Parameters:
|
|
<table>
|
|
<tr><th>Parameters:</th><td><em>[optional vector]</em><code>pos</code>:</td>
|
|
<td>Initial position of the camera. Defaults to <code>(0,0)</code>.</td></tr>
|
|
<tr><td> </td><td><em>[optional number]</em><code>zoom</code>:</td>
|
|
<td>Initial zoom. Defaults to <code>1</code>.</td></tr>
|
|
<tr><td> </td><td><em>[optional number]</em><code>rotation</code>:</td>
|
|
<td>Initial rotation in radians. Defaults to <code>0</code>.</td></tr>
|
|
<tr><th>Returns:</th><td colspan="2">a new camera object<td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="camera.lua-rotate"></a>
|
|
<div class="doc"><span class="function">function camera:rotate(phi)<a class="top" href="#camera.lua">^ top</a></span>
|
|
Rotate camera by <code>phi</code> radians. Same as <code>camera.rot = camera.rot + phi.</code>
|
|
</div>
|
|
|
|
<a name="camera.lua-translate"></a>
|
|
<div class="doc"><span class="function">function camera:translate(t)<a class="top" href="#camera.lua">^ top</a></span>
|
|
Translate (move) camera by vector <code>t</code>. Same as <code>camera.pos = camera.pos + t</code>.
|
|
</div>
|
|
|
|
<a name="camera.lua-draw"></a>
|
|
<div class="doc"><span class="function">function camera:draw(func)<a class="top" href="#camera.lua">^ top</a></span>
|
|
Apply camera transformation to drawings in function <code>func</code>.
|
|
Shortcut to <code>camera:apply()</code> and <code>camera:deapply()</code> (see below).
|
|
|
|
<table><tr><th>Example</th></tr>
|
|
<tr><td><pre>cam:draw(function() love.graphics.rectangle('fill', -100,-100, 200,200) end)</pre></td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="camera.lua-apply"></a>
|
|
<div class="doc"><span class="function">function camera:apply()<a class="top" href="#camera.lua">^ top</a></span>
|
|
Apply camera transformations to every drawing operation until the next <code>camera:deapply()</code>.
|
|
</div>
|
|
|
|
<a name="camera.lua-deapply"></a>
|
|
<div class="doc"><span class="function">function camera:deapply()<a class="top" href="#camera.lua">^ top</a></span>
|
|
Revert camera transformations for the rest of the drawing operations.
|
|
|
|
<table><tr><th>Example:</th><td>(equivalent to the <code>cam:draw()</code> example above)</td></tr>
|
|
<tr><td colspan="2"><pre>camera:apply()
|
|
love.graphics.rectangle('fill', -100,-100, 200,200)
|
|
camera:deapply()</pre></td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="camera.lua-transform"></a>
|
|
<div class="doc"><span class="function">function camera:transform(p)<a class="top" href="#camera.lua">^ top</a></span>
|
|
Transform vector <code>p</code> from camera coordinates to world coordinates.
|
|
You probably won't need this, but it is the basis to <code>camera:mousepos()</code>.
|
|
</div>
|
|
|
|
<a name="camera.lua-mousepos"></a>
|
|
<div class="doc"><span class="function">function camera:mousepos()<a class="top" href="#camera.lua">^ top</a></span>
|
|
Get mouse position in world coordinates, i.e. the position the users mouse is
|
|
currently pointing at when camera transformations are applied. Use this for any
|
|
mouse interaction with transformed objects in your game.
|
|
</div>
|
|
</div>
|
|
|
|
<div class="module">
|
|
<a name="gamestate.lua"></a>
|
|
<h3>gamestate.lua<a class="top" href="#doc">^ top</a></h3>
|
|
|
|
<p>Useful to separate different states of your game (hence "gamestate") like title screens,
|
|
level loading, main game, etc. Each gamestate can have it's own <code>update()</code>, <code>draw()</code>,
|
|
<code>keyreleased()</code>, <code>keypressed()</code> and <code>mousereleased()</code> which correspond
|
|
to the ones defined in love. See the <a href="#gamestate.lua-callbackList">callback list</a> for more details.</p>
|
|
|
|
<p>Additionally, each gamestate can define a <code>enter(pre, ...)</code> and <code>leave()</code> function,
|
|
which are called when using <code>Gamestate.switch(to, ...)</code>. <em>Do not attempt to use these functions
|
|
yourself to initialize the first gamestate,</em> use the <code>switch</code> function instead.</p>
|
|
|
|
<p>The module defines the following functions:
|
|
<table class="functionlist">
|
|
<tr><td><a href="#gamestate.lua-new">Gamestate.new()</a></td><td>New gamestate</td></tr>
|
|
<tr><td><a href="#gamestate.lua-switch">Gamestate.switch(to, ...)</a></td><td>Switch gamestate</td></tr>
|
|
<tr><td><a href="#gamestate.lua-update">Gamestate.update(dt)</a></td><td>Call update callback</td></tr>
|
|
<tr><td><a href="#gamestate.lua-draw">Gamestate.draw()</a></td><td>Call draw callback</td></tr>
|
|
<tr><td><a href="#gamestate.lua-keypressed">Gamestate.keypressed(key, unicode)</a></td><td>Call keypressed callback</td></tr>
|
|
<tr><td><a href="#gamestate.lua-keyreleased">Gamestate.keyreleased(key)</a></td><td>Call keyreleased callback</td></tr>
|
|
<tr><td><a href="#gamestate.lua-mousereleased">Gamestate.mousereleased(x,y,btn)</a></td><td>Call mousereleased callback</td></tr>
|
|
<tr><td><a href="#gamestate.lua-registerEvents">Gamestate.registerEvents()</a></td><td>Register all callbacks</td></tr>
|
|
</table></p>
|
|
|
|
<a name="gamestate.lua-new"></a>
|
|
<div class="doc"><span class="function">function Gamestate.new()<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Create a new gamestate.
|
|
<table><tr><th>Returns:</th><td>The new (but empty) gamestate object.</td></tr></table>
|
|
</div>
|
|
|
|
<a name="gamestate.lua-switch"></a>
|
|
<div class="doc"><span class="function">function Gamestate.switch(to, ...)<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Switch the gamestate.
|
|
<p>Calls <code>leave()</code> on the currently active gamestate.</p>
|
|
<p>Calls <code>enter(current, ...)</code> on the target gamestate, where <code>current</code>
|
|
is the gamestate before the switch and <code>...</code> are the additionals arguments given
|
|
to <code>Gamestate.switch</code>.</p>
|
|
<table>
|
|
<tr><th>Parameters:</th><td><em>[gamestate]</em><code>to</code>:</td><td>target gamestate.</td></tr>
|
|
<tr><td> </td><td><code>...</code>:</td><td>additional arguments to pass</td></tr>
|
|
<tr><th>Returns:</th><td colspan="2">the result of <code>to:enter(current, ...)</code></td></tr>
|
|
</table>
|
|
</div>
|
|
|
|
<a name="gamestate.lua-update"></a>
|
|
<div class="doc"><span class="function">function Gamestate.update(dt)<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Calls <code>update(dt)</code> on current gamestate.
|
|
</div>
|
|
|
|
<a name="gamestate.lua-draw"></a>
|
|
<div class="doc"><span class="function">function Gamestate.draw()<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Calls <code>draw()</code> on current gamestate.
|
|
</div>
|
|
|
|
<a name="gamestate.lua-keypressed"></a>
|
|
<div class="doc"><span class="function">function Gamestate.keypressed(key, unicode)<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Calls <code>keypressed(key, unicode)</code> on current gamestate.
|
|
</div>
|
|
|
|
|
|
<a name="gamestate.lua-keyreleased"></a>
|
|
<div class="doc"><span class="function">function Gamestate.keyreleased(key)<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Calls <code>keyreleased(key)</code> on current gamestate.
|
|
</div>
|
|
|
|
|
|
<a name="gamestate.lua-mousereleased"></a>
|
|
<div class="doc"><span class="function">function Gamestate.mousereleased(x,y,btn)<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Calls <code>mousereleased(x,y,btn)</code> on the current gamestate.
|
|
</div>
|
|
|
|
<a name="gamestate.lua-registerEvents"></a>
|
|
<div class="doc"><span class="function">function Gamestate.registerEvents()<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
Registers all above events so you don't need to call then in your <code>love.*</code> routines.
|
|
<p>It is an error to call this anywhere else than <code>love.load()</code>, since it overwrites the
|
|
callbacks. Dont worry though, your callbacks will still be executed.</p>
|
|
</div>
|
|
|
|
<a name="gamestate.lua-callbackList"></a>
|
|
<h4>List of callbacks</h4>
|
|
<div class="doc"><span class="function">Each gamestate can have a list of callbacks:<a class="top" href="#gamestate.lua">^ top</a></span>
|
|
<table>
|
|
<tr><td><code>enter(previous, ...)</code></td>
|
|
<td>Gets called upon entering the state. <em>Don't call this yourself, use
|
|
<code>Gamestate.switch</code> instead.</em></td></tr>
|
|
<tr><td><code>leave()</code></td>
|
|
<td>Gets called upon leaving the state. The same warning as with <code>enter</code> applies.</td></tr>
|
|
<tr><td><code>update(dt)</code></td>
|
|
<td>Manully called by <code>Gamestate.update</code>, or automatically like <code>love.update</code>
|
|
when using <code>Gamestate.registerEvents()</code>.</td></tr>
|
|
<tr><td><code>draw()</code></td>
|
|
<td>Manully called by <code>Gamestate.draw</code>, or automatically like <code>love.draw</code></td></tr>
|
|
<tr><td><code>keypressed(key, unicode)</code></td>
|
|
<td>Manully called by <code>Gamestate.keypressed</code>, or automatically like <code>love.keypressed</code></td></tr>
|
|
<tr><td><code>keyreleased(key)</code></td>
|
|
<td>Manully called by <code>Gamestate.keyreleased</code>, or automatically like <code>love.keyreleased</code></td></tr>
|
|
<tr><td><code>mousereleased(x,y,btn)</code></td>
|
|
<td>Manully called by <code>Gamestate.mousereleased</code>, or automatically like <code>love.mousereleased</code></td></tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<a name="license"></a>
|
|
<h2>License<a class="top" href="#top">^ top</a></h2>
|
|
|
|
<p>Yay, <em>free software</em>:</p>
|
|
|
|
<blockquote><p>Copyright (c) 2010 Matthias Richter</p>
|
|
<p>Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:</p>
|
|
|
|
<p>The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.</p>
|
|
|
|
<p>Except as contained in this notice, the name(s) of the above copyright holders
|
|
shall not be used in advertising or otherwise to promote the sale, use or
|
|
other dealings in this Software without prior written authorization.</p>
|
|
|
|
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE.</p></blockquote>
|
|
|
|
<a name="download"></a>
|
|
<h2>Download<a class="top" href="#top">^ top</a></h2>
|
|
|
|
<p>You can download this project in either
|
|
<a href="http://github.com/vrld/hump/zipball/master">zip</a> or
|
|
<a href="http://github.com/vrld/hump/tarball/master">tar</a> formats.</p>
|
|
<p>You can also clone the project with <a href="http://git-scm.com">Git</a> by running:
|
|
<pre>$ git clone git://github.com/vrld/hump</pre></p>
|
|
|
|
<div class="footer">
|
|
get the source code on GitHub : <a href="http://github.com/vrld/hump">vrld/hump</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
</body>
|
|
</html>
|