Love2D the cross-platform graphics programming library for the lua language, written in C++

Alex Szpakowski 87e20ccafb Fixed the display index parameter of love.window.getFullscreenModes, getDesktopDimensions, and setPosition to be 1-based instead of 0-based (resolves issue #1056.) %!s(int64=10) %!d(string=hai) anos
extra af06203a4a Moved the appveyor script to a subfolder and updated it to properly choose Visual Studio 2012 and to create a post-build zip file. %!s(int64=10) %!d(string=hai) anos
platform c3612acfde Fixed the use of getRealDirectory when auto-detecting the identity name. %!s(int64=10) %!d(string=hai) anos
src 87e20ccafb Fixed the display index parameter of love.window.getFullscreenModes, getDesktopDimensions, and setPosition to be 1-based instead of 0-based (resolves issue #1056.) %!s(int64=10) %!d(string=hai) anos
.hgignore 85de3c41fb Initial iOS implementation. %!s(int64=10) %!d(string=hai) anos
.hgtags 84294ac684 Added tag 0.9.2 for changeset a5e405cdf14d %!s(int64=10) %!d(string=hai) anos
CMakeLists.txt 5dbf589d47 Removed libjpeg-turbo as a dependency (closes issue #1031.) Removed jpeg support for ImageData:encode. stb_image now handles jpeg image loading. %!s(int64=10) %!d(string=hai) anos
changes.txt 9d635fa63a Updated the changelog %!s(int64=10) %!d(string=hai) anos
license.txt 85de3c41fb Initial iOS implementation. %!s(int64=10) %!d(string=hai) anos
readme.md f141cb3a16 Added a small 'contributing' section to the readme. %!s(int64=10) %!d(string=hai) anos

readme.md

LÖVE is an awesome framework you can use to make 2D games in Lua. It's free, open-source, and works on Windows, Mac OS X and Linux.

Documentation

We use our wiki for documentation. If you need further help, feel free to ask on our forums, and last but not least there's the irc channel #love on OFTC.

Compilation

###Windows Follow the instructions at the megasource repository page.

###*nix Run platform/unix/automagic from the repository root, then run ./configure and make.

$ platform/unix/automagic
$ ./configure
$ make

###Mac OS X Download the required frameworks from here and place them in /Library/Frameworks/.

Then use the Xcode project found at platform/xcode/love.xcodeproj to build the love-macosx target.

###iOS Download the required libraries from here and place the include and libraries folders into the platform/xcode/ios folder.

Then use the Xcode project found at platform/xcode/love.xcodeproj to build the love-ios target. Note that you must be registered in the iOS Developer Program in order to build for physical iOS devices.

Repository information

We use the 'default' branch for development, and therefore it should not be considered stable. Also used is the 'minor' branch, which is used for features in the next minor version and it is not our development target (which would be the next revision - version numbers are formatted major.minor.revision.)

We tag all our releases (since we started using mercurial), and have binary downloads available for them.

Experimental changes are developed in the separate love-experiments repository.

Contributing

The best places to contribute are through the Bitbucket issue tracker and the official IRC channel. For code contributions, pull requests and patches are welcome. Be sure to read the source code style guide.

Builds

Releases are found in the 'downloads' section on bitbucket, are linked on the site, and there's a ppa for ubuntu, ppa:bartbes/love-stable.

There are also unstable/nightly builds:

Dependencies

  • SDL2
  • OpenGL 2.1+ / OpenGL ES 2+
  • OpenAL
  • Lua / LuaJIT / LLVM-lua
  • FreeType
  • PhysicsFS
  • ModPlug
  • mpg123
  • Vorbisfile