Softpedia >Mac >Developer Tools >LOVE >  Changelog

LOVE Changelog

What's new in LOVE 11.0.0

Apr 3, 2018
  • Added Object:release.
  • Added Data:clone.
  • Added queueable audio sources.
  • Added audio input support.
  • Added Source filters: low gain, high gain and band pass.
  • Added audio effect APIs (reverb, echo, etc.)
  • Added variants of SoundData:getSample/setSample which take a channel parameter.
  • Added variants of all table-with-fields-returning get* functions, the new variants take an existing table to fill in.
  • Added a variant to World:update, which accepts the number of iterations to run. The defaults are now 8 and 3.
  • Added Body:isTouching.
  • Added RopeJoint:setMaxLength.
  • Added a click count argument to love.mousepressed and love.mousereleased.
  • Added variants of love.filesystem.mount which accept a Data or FileData object containing zipped data.
  • Added love.filesystem.get/setCRequirePath, and use that to find c libraries for require.
  • Added variants of File:read and love.filesystem.read which take an enum to determine whether they return a FileData or a string.
  • Added love.data module. It includes hex/base64 encoding functions, MD5 and SHA hashing, string packing, compression APIs, and more.
  • Added Channel:hasRead, which checks if a message has been read. Takes an id, which Channel:push will now return.
  • Added variants of Channel:demand and Channel:supply which take a timeout argument.
  • Added Transform objects to love.math.
  • Added support for different ImageData formats, including RGBA8 (the default), RGBA16, RGBA16F, and RGBA32F.
  • Added the ability to load Radiance HDR, OpenEXR, and 16 bit PNG images.
  • Added love.graphics.getImageFormats (replaces love.graphics.getCompressedImageFormats).
  • Added the ability to specify a per-object pixel density scale factor when creating Images, Canvases, Fonts, and Videos. Affects drawing.
  • Added Texture:getPixelWidth/Height and love.graphics.getPixelWidth/Height.
  • Added Texture:getPixelDensity, love.graphics.getPixelDensity, and Font:getPixelDensity.
  • Added Texture:getMipmapCount, getFormat, getLayerCount, getDepth, and getTextureType.
  • Added Array, Cubemap, and Volume texture types and corresponding Image and Canvas APIs.
  • Added love.graphics.getTextureTypes, returns a table with fields indicating support for each texture type.
  • Added mipmapping support to Canvases, including both auto-generated mipmaps and manually rendering to a specific mipmap level.
  • Added 'stencil8', 'depth24stencil8', 'depth32fstencil8', 'depth16', 'depth24', and 'depth32f' pixel formats for Canvases.
  • Added variant of love.graphics.newCanvas which accepts a table of settings.
  • Added optional 'readable' boolean field to the table passed into love.graphics.newCanvas.
  • Added optional 'depthstencil' field to the table passed into love.graphics.setCanvas, for using a depth/stencil Canvas.
  • Added optional 'depth' and 'stencil' boolean fields to the table passed into setCanvas, for enabling depth and stencil buffers if 'depthstencil' isn't used.
  • Added shadow sampler support for Canvases.
  • Added love.graphics.setDepthMode for using the depth buffer for depth testing/writes. Depth values of rendered objects can only be set via shaders.
  • Added love.graphics.setMeshCullMode, for culling back- or front-facing triangles when drawing a Mesh.
  • Added love.graphics.setFrontFaceWinding.
  • Added variant of love.graphics.getCanvasFormats which takes a 'readable' boolean.
  • Added love.graphics.drawLayer and SpriteBatch:add/setLayer for easily drawing layers of Array Textures.
  • Added variants of love.graphics.print and printf which take a Font argument.
  • Added variants of love.graphics.clear to control how the active depth and stencil buffers are cleared.
  • Added love.graphics.applyTransform and love.graphics.replaceTransform.
  • Added love.graphics.transformPoint and love.graphics.inverseTransformPoint.
  • Added love.graphics.getStackDepth.
  • Added love.graphics.flushBatch for manually flushing automatically batched draws.
  • Added SpriteBatch:setDrawRange.
  • Added per-shader opt in support for the GLSL 3.30 and GLSL ES 3.00 shading languages.
  • Added 'void effect()' pixel shader entry point.
  • Added love.graphics.validateShader.
  • Added Shader:hasUniform.
  • Added support for non-square shader uniform matrices on desktop platforms and on mobile GLSL 3.
  • Added Shader:send(matrixname, is_column_major, matrix, ...) which specifies how to interpret the matrix table arguments.
  • Added Shader:send variants which accept a Data object.
  • Added 'borderellipse' and 'borderrectangle' ParticleSystem distributions.
  • Added variant of ParticleSystem:setEmissionArea which accepts an area angle and a flag for whether particle directions are relative to the center of the area.
  • Added ParticleSystem:set/getAreaSpreadAngle and set/getAreaSpreadIsRelativeDirection.
  • Added love.graphics.captureScreenshot (replaces love.graphics.newScreenshot).
  • Added 'glsl3', 'instancing', 'fullnpot','pixelshaderhighp', and 'shaderderivatives' graphics features.
  • Added 'anisotropy' graphics limit.
  • Added Mesh instancing support via love.graphics.drawInstanced and Mesh:attachAttribute.
  • Added a Mesh:attachAttribute variant that takes a different target attribute name.
  • Added Mesh:detachAttribute.
  • Added a variant of Mesh:setVertexMap which accepts a Data object.
  • Added love.window.updateMode.
  • Added love.window.isMinimized.
  • Added love.window.restore.
  • Added the ability to prevent love from creating a stencil buffer for the window.
  • Added cycle detection to Variant's table serialization, cycles now cause an error, rather than a stack overflow.
  • Added love.graphics.newShader File and FileData variants.
  • Added a default love.threaderror callback, which raises the error in the main thread.
  • Added checks for invalid constants passed to love.keyboard.isDown/isScancodeDown.
  • Added deprecation warnings, on by default for non-fused games.
  • Added love.filesystem.getInfo.
  • Added 'drawcallsbatched' to love.graphics.getStats.
  • Added support for header-less DEFLATE to love.data.compress/decompress.
  • Deprecated love.filesystem.exists / isFile / isDirectory / isSymlink / getLastModified / getSize (use getInfo instead).
  • Deprecated love.math.compress / decompress (use love.data.compress / decompress instead).
  • - All renamed APIs are formally deprecated rather than completely removed.
  • Renamed love.window.getPixelScale to love.window.getDPIScale.
  • Renamed love.mouse.hasCursor to love.mouse.isCursorSupported.
  • Renamed ParticleSystem:setAreaSpread to ParticleSystem:setEmissionArea.
  • Renamed love.errhand to love.errorhandler.
  • Renamed Source/SoundData/Decoder:getChannels to getChannelCount.
  • Renamed PrismaticJoint/RevoluteJoint:hasLimitsEnabled to areLimitsEnabled.
  • Renamed love.audio.getSourceCount to love.audio.getActiveSourceCount.
  • Renamed all get[Object]List functions to get[Object]s.
  • Removed the default source type for love.audio.newSource.
  • Removed variant of love.filesystem.newFileData which takes base64 data, use love.data.decode instead.
  • Removed the no-argument variant of Text:set, use Text:clear instead.
  • Removed love.graphics.getCompressedImageFormats, use love.graphics.getImageFormats instead.
  • Removed the 'void effects(...)' pixel shader entry point. Use the new 'void effect()' instead.
  • Removed Shader:getExternVariable, use Shader:hasUniform instead.
  • Removed love.graphics.newScreenshot, use love.graphics.captureScreenshot instead.
  • Removed deprecated enet function host:socket_get_address.
  • Removed functions deprecated in LÖVE 0.10.2:
  • Removed Shader:sendInt, Shader:sendBoolean, Shader:sentFloat, Shader:sendMatrix, and Shader:sendTexture (use Shader:send instead).
  • Removed love.window.isCreated (use love.window.isOpen instead).
  • Improved performance when drawing textures, shapes, lines, and points by automatically batching their draw calls together when possible.
  • Improved performance of Shader:send when the Shader is not active.
  • Improved performance of love.math.randomNormal when LuaJIT's JIT compiler is enabled.
  • Improved performance of love.filesystem.lines and File:lines, especially when reading from a file inside a zip/.love.
  • Changed all color values to be in the range 0-1, rather than 0-255.
  • Changed high-dpi functionality to require much less code (often none at all) for graphics to appear at the correct sizes and positions.
  • Changed love.graphics.print and friends to ignore carriage returns.
  • Changed the 'multiply' blend mode to error if not used with the 'premultiplied' blend alpha mode, since the formula only works with that anyway.
  • Changed some love.graphics, love.window, and love.event APIs to cause an error if a Canvas is active.
  • Changed stenciling functionality with a Canvas active to require stencil=true (or a custom stencil-formatted Canvas) to be set in setCanvas.
  • Changed Mesh:setDrawRange to take 'start' and 'count' parameters instead of 'min' and 'max'.
  • Changed the 'vsync' field of love.window.setMode and t.window in love.conf. It's now an integer with 0 disabling vsync.
  • Changed the audio playback APIs drastically.
  • Changed enet to no longer set the 'enet' global, again matching luasocket.
  • Changed Source seeking behaviour, all kinds of Sources now behave similarly when seeking past the boundaries.
  • Changed love.timer.step, it now returns dt.
  • Changed love.run and love.errhand to return a function for their main loop, which gets called until love quits.
  • Updated and improved command line argument handling.
  • Updated the boot sequence to show an error instead of the no-game screen, if a nonexistant folder is passed in as the source game directory.
  • Updated 'love.exe --version' on Windows to print to the parent console.
  • Updated Android print rerouting and JIT compilation disabling to apply inside threads.
  • Updated invalid enum value error messages to show a list of the valid enum values.
  • Updated Source:seek to work if the Source isn't playing.
  • Updated love.event.poll to stop allocating memory unnecessarily.
  • Updated love.math.random to have improved numeric distribution.
  • Updated love.graphics to support Core Profile OpenGL 3.3+ when available.
  • Updated shaders to always expose derivative functions (dFdx, dFdy, fwidth) when available in OpenGL ES.
  • Updated shaders to allow using VERTEX and PIXEL in shader code.
  • Updated love.graphics.circle/ellipse/arc/rectangle to take transformation scale into account when determining the number of segments to use.
  • Updated Font glyph generation to improve antialiasing.
  • Updated Canvas:newImageData to return an ImageData with a format that matches the Canvas' as closely as possible.
  • Updated love.graphics.newImage to treat file names ending with "@2x", "@3x", etc. as a pixel density scale factor if none is explicitly supplied.
  • Updated the error message when bad values are given to love.graphics.line.
  • Updated the maximum love.graphics transformation/state stack depth from 64 to 128.
  • Updated the default error handler to allow copying the error to the clipboard when the user decides to do so.
  • Updated love.filesystem.setRequirePath to support multiple template '?' characters in each path.
  • Updated luasocket to version 3.0rc1.
  • Updated love.joystick.loadGamepadMappings so it doesn't error when given an empty string.
  • Updated love.joystick.setGamepadMapping to use the controller's name for the new mapping when possible.
  • Fixed error in default error handler when the error message contains non UTF-8 bytes.
  • Fixed a memory leak when sending love objects to threads which never load that object's module.
  • Fixed a memory leak in enet when peer:send fails.
  • Fixed os.execute always returning -1 in Linux.
  • Fixed the default reference angle for WeldJoint, PrismaticJoint, and RevoluteJoint.
  • Fixed Fixture:getShape to reuse the existing internal Fixture-owned shape.
  • Fixed MouseJoint:setFrequency to error instead of crashing if a frequency of 0 is set.
  • Fixed love.system.set/getClipboardText to error instead of crashing, when a window hasn't been created.
  • Fixed Joystick:getGamepadMapping to work with xinput controllers.
  • Fixed love.joystick.setGamepadMapping's replacement code.
  • Fixed baseline calculation when rendering text.
  • Fixed VaryingTexCoords and love_ScreenSize in shaders to be 'highp' in OpenGL ES, when supported.
  • Fixed ParticleSystem:setParticleLifetime to error if a negative value is given.
  • Fixed Shader:send and Shader:sendColor ignoring the last argument for an array.
  • Fixed a crash when love.graphics.pop is called after a love.window.setMode while the transformation stack was not empty.
  • Fixed love.window.isMaximized.
  • Fixed video playback to work with a wider range of Ogg Theora files.
  • Fixed video seeking to be faster.
  • Fixed BezierCurves to error instead of hanging in some situations.
  • Fixed compilation of luasocket with newer luajit 2.1.0 beta versions.

New in LOVE 0.10.1 (Jun 22, 2016)

  • Added a new love.conf flag t.externalstorage, which determines whether files are saved in internal or external storage on Android devices.
  • Added a new variant of love.graphics.arc which can draw different types of arcs ("pie", "open", or "closed").
  • Added "lighten" and "darken" BlendModes. They can only be used with the "premultiplied" BlendAlphaMode.
  • Added the "lighten" GraphicsFeature constant.
  • Added the ability to avoid clearing specific Canvases when calling love.graphics.clear, if multiple Canvases are active at once via love.graphics.setCanvas.
  • Added Text:getDimensions.
  • Added optional "collideconnected" argument to love.physics.newMotorJoint.
  • Fixed a Lua error in the no-game screen if the window's height is too small.
  • Fixed the default error handler to reset the mouse Cursor.
  • Fixed love.filesystem functions crashing when called if liblove is used directly without calling love.filesystem.init.
  • Fixed audio on Android to pause when the app is inactive, and resume when the app becomes active again.
  • Fixed the Video decoding thread hanging after Video:seek or when a Video finishes.
  • Fixed Video:isPlaying to always return false after it finishes playing.
  • Fixed RandomGenerator:random crashing if a nil 'self' is used.
  • Fixed loading BMFont files which have characters with 0 width or height (a space character, for example).
  • Fixed love.graphics.newFont causing crashes if FileData is passed in.
  • Fixed love.graphics.clear(colortable) causing crashes on OpenGL ES 2 systems when a Canvas is active.
  • Fixed a driver bug on some Android devices which caused all objects to show up as black.
  • Fixed a driver bug on Windows with AMD graphics cards where love.graphics.clear would not always work.
  • Fixed Shader:sendColor incorrectly converting alpha values from sRGB to linear RGB when gamma-correct rendering is enabled.
  • Fixed love.graphics.newMesh(vertices) double-converting colors from sRGB to linear RGB when gamma-correct rendering is enabled.
  • Fixed love.graphics.new* crashing when there is no graphics context/window.
  • Updated the Windows executable to prefer the high-powered AMD graphics card on systems which have switchable Intel+AMD GPUs.
  • Updated love.touch.getTouches to return the list of IDs in the relative order that the touches initially happened, instead of being in a random order.
  • Updated the error messages caused by invalid or bad arguments to ImageData and SoundData methods to be more descriptive.

New in LOVE 0.10.0 (Dec 23, 2015)

  • Added an iOS port.
  • Added an Android port.
  • Added the flag t.accelerometerjoystick to love.conf. Disables accelerometer-as-joystick functionality on mobile devices when false.
  • Added the flag t.gammacorrect to love.conf (replaces t.window.srgb.) Enabling it globally enables gamma-correct rendering, when supported.
  • Added video playback support for Ogg Theora videos, via love.graphics.newVideo and Video objects.
  • Added love.video module. It is not used for displaying videos on-screen, only decoding them.
  • Added love.touch module. Note that it has important differences from the touch implementation in the LÖVE 0.9 Android and iOS ports.
  • Added love.touchpressed, love.touchreleased, and love.touchmoved.
  • Added love.system.vibrate.
  • Added love.filesystem.setRequirePath and love.filesystem.getRequirePath.
  • Added an optional program exit argument to love.event.quit.
  • Added love.filedropped and love.directorydropped event callback functions.
  • Added love.lowmemory event callback function, called when the app is running out of memory on mobile operating systems.
  • Added love.textedited event callback function, called when the user is compositing text (e.g. via an IME.)
  • Added love.wheelmoved event callback function (replaces "wu" and "wd" constants for love.mousepressed.)
  • Added love.mouse.hasCursor.
  • Added a boolean argument to love.mousepressed and love.mousereleased indicating whether the button event originated from a touch press.
  • Added optional x/y/width/height arguments to love.keyboard.setTextInput. They tell the system where text will show up so on-screen keyboards can avoid that area.
  • Added Source:getType (replaces Source:isStatic.)
  • Added Source:getDuration and Decoder:getDuration.
  • Added an optional string argument containing raw pixel byte data to the width/height variant of love.image.newImageData.
  • Added love.graphics.ellipse.
  • Added rounded-rectangle support to love.graphics.rectangle.
  • Added love.graphics.points (replaces love.graphics.point.)
  • Added love.graphics.intersectScissor.
  • Added an optional argument to love.graphics.setBlendMode which indicates whether to treat the colors of drawn objects as having pre-multiplied alpha.
  • Added love.graphics.getSupported (replaces love.graphics.isSupported.)
  • Added love.graphics.getSystemLimits (replaces love.graphics.getSystemLimit.)
  • Added love.graphics.stencil and love.graphics.set/getStencilTest (replaces love.graphics.setStencil.)
  • Added love.graphics.isActive.
  • Added color arguments to love.graphics.clear. It no longer always uses the background color value.
  • Added love.graphics.discard.
  • Added love.graphics.isGammaCorrect.
  • Added the "clampzero" WrapMode.
  • Added the ability to specify custom mipmaps when creating an image, via love.graphics.newImage(filename, {mipmaps={mip1, mip2, ...}})
  • Added optional x/y/width/height arguments to Image:refresh and Canvas:newImageData.
  • Added Image:getFlags.
  • Added one- and two-channel Canvas formats: r8, rg8, r16f, rg16f, r32f, and rg32f.
  • Added support for different formats in each Canvas when using multi-canvas rendering. Added the "multicanvasformats" Graphics Feature constant.
  • Added support for OpenGL ES 2 and 3.
  • Added support for loading ETC, EAC, PVRTC, and ASTC compressed textures on systems that support them.
  • Added custom vertex attribute support for Meshes via new variants of love.graphics.newMesh.
  • Added Mesh:setVertexAttribute and Mesh:getVertexAttribute.
  • Added Mesh:getVertexFormat.
  • Added Mesh:flush.
  • Added an optional 'startvertex' argument to Mesh:setVertices.
  • Added the ability for love.graphics.newMesh and Mesh:setVertices to accept a Data object.
  • Added Mesh:setAttributeEnabled and Mesh:isAttributeEnabled.
  • Added Mesh:attachAttribute.
  • Added SpriteBatch:attachAttribute.
  • Added Shader:sendColor.
  • Added new shader functions: gammaCorrectColor, gammaToLinear, and linearToGamma. The functions also have 'precise' and 'fast' variants.
  • Added Text objects and love.graphics.newText.
  • Added per-character color support to love.graphics.print/printf and to Text objects.
  • Added BMFont bitmap font file support to love.graphics.newFont and love.font.
  • Added kerning support for TrueType/OpenType and BMFont Fonts.
  • Added an optional font hinting argument to love.graphics.newFont when loading TrueType fonts.
  • Added an optional spacing argument to love.graphics.newImageFont, which applies additional spacing to all rendered glyphs.
  • Added Font:setFallbacks.
  • Added love.window.maximize.
  • Added love.window.close.
  • Added love.window.requestAttention.
  • Added love.window.setDisplaySleepEnabled and love.window.isDisplaySleepEnabled.
  • Added BezierCurve:renderSegment and BezierCurve:removeControlPoint.
  • Added BezierCurve:getSegment.
  • Added love.math.compress and love.math.decompress.
  • Added Channel:performAtomic.
  • Changed love.mousepressed, love.mousereleased, and love.mouse.isDown to use button numbers instead of named button constants.
  • Changed love.keypressed to be love.keypressed(key, scancode, isrepeat).
  • Changed love.keyreleased to be love.keyreleased(key, scancode).
  • Changed Font:getWrap's second return value to be a table containing the text split into lines.
  • Changed love.graphics.newImage's optional second argument to be a table of flags (flags are "mipmaps" and "linear".)
  • Changed the arguments for the standard variants of love.graphics.newMesh to newMesh(vertices [, drawmode, usage]) and newMesh(vertexcount [, drawmode, usage]).
  • Changed ImageData:encode to return a FileData object. ImageData:encode's first parameter is now the format to encode to, and the second parameter is an optional filename to write to.
  • Renamed the "normal" Fullscreen Type to "exclusive".
  • Renamed the DistanceModel constants "inverse clamped", "linear clamped", and "exponent clamped" to "inverseclamped", "linearclamped", and "exponentclamped".
  • Renamed the "additive", "subtractive", and "multiplicative" BlendModes to "add", "subtract", and "multiply".
  • Renamed the KeyConstant and Scancode representing the spacebar from " " to "space".
  • Renamed File:eof to File:isEOF.
  • Renamed Canvas:getImageData to Canvas:newImageData.
  • Renamed love.image's CompressedData type to CompressedImageData.
  • Removed callback variant of love.filesystem.getDirectoryItems.
  • Removed the "wu" and "wd" constants for love.mousepressed (replaced by love.wheelmoved.)
  • Removed the named mouse button constants (replaced by button numbers.)
  • Removed Source:isStatic (replaced by Source:getType.)
  • Removed image loading support for all (non-compressed texture) file formats except for PNG, JPEG, TGA, and BMP.
  • Removed JPEG encoding support from ImageData:encode.
  • Removed love.graphics.point (replaced by love.graphics.points.)
  • Removed love.graphics.setPointStyle and love.graphics.getPointStyle.
  • Removed love.graphics.isSupported (replaced by love.graphics.getSupported.)
  • Removed love.graphics.getSystemLimit (replaced by love.graphics.getSystemLimits.)
  • Removed love.graphics.setStencil (replaced by love.graphics.stencil and love.graphics.setStencilTest.)
  • Removed the "canvas", "shader", "npot", "subtractive", and "mipmap" Graphics Feature constants (the features always have guaranteed support now.)
  • Removed the "multicanvas" Graphics Feature constant (use love.graphics.getSystemLimits instead.)
  • Removed the "srgb" Graphics Feature constant (use love.graphics.isGammaCorrect() or love.graphics.getCanvasFormats().srgb instead.)
  • Removed the "srgb" flag in love.window.setMode and in the t.window table in love.conf (Replaced by t.gammacorrect.)
  • Removed the "premultiplied" blend mode (love.graphics.setBlendMode("alpha", "premultiplied") now does the same thing.)
  • Removed Canvas:getPixel (use Canvas:newImageData instead.)
  • Removed Canvas:clear (use love.graphics.clear instead.)
  • Removed Mesh:getVertices.
  • Removed Mesh:setVertexColors and Mesh:hasVertexColors (use Mesh:setAttributeEnabled("VertexColor", enable) instead.)
  • Fixed utf8.char.
  • Fixed detection of fused love games.
  • Fixed World:getCallbacks and World:getContactFilter when used in coroutines.
  • Fixed crashes when objects which store Lua callback functions are garbage collected after being used in coroutines.
  • Fixed memory leaks in love.physics if World:destroy is never called. When a World is GCed it now destroys all objects it owns.
  • Fixed love.keyboard.getKeyFromScancode crashing when an invalid scancode is given.
  • Fixed decoding of 8-bit WAV files.
  • Fixed a crash issue when rewinding streaming ogg Sources, when certain versions of libvorbis are used.
  • Fixed love.audio.stop() not rewinding streaming Sources.
  • Fixed the stencil buffer in Canvases when an unsupported MSAA value is used to create the Canvas.
  • Fixed Canvas:renderTo to restore the previous Canvas if an error occurs in the passed function.
  • Fixed love.graphics.draw(canvas) to cause an error if that Canvas is the active one.
  • Fixed Mesh:getVertexMap to return nil rather than an empty table, if no vertex map has been set.
  • Fixed love.graphics.getColorMask.
  • Fixed the default offset for particles when ParticleSystem:setQuads or ParticleSystem:setTexture is used.
  • Fixed love.graphics.shear resetting all love.graphics transformations.
  • Fixed the "add" and "subtract" blend modes to no longer modify the alpha of the Canvas / screen.
  • Improved the performance of World:rayCast and World:queryBoundingBox.
  • Improved the performance of love.graphics.line and other line drawing functions, when the "smooth" LineStyle is used.
  • Improved the performance of Shader:send when matrices are used.
  • Improved the performance of ImageData and SoundData methods when LuaJIT's JIT compiler is enabled, by using efficient FFI code.
  • Improved the performance of love.math.noise, love.math.gammaToLinear, love.math.linearToGamma, love.math.random, and RandomGenerator:random when LuaJIT's JIT compiler is enabled.
  • Updated the compatibility warning notice to use a message box and to show the version specified in love.conf.
  • Updated the compatibility warning notice to display before main.lua is loaded.
  • Updated the __tostring metamethod of love objects to output the pointer value, similar to tostring(table).
  • Updated World:setCallbacks, World:setContactFilter, World:queryBoundingBox, and World:rayCast to have improved argument type checking.
  • Updated threads to load love.filesystem automatically.
  • Updated love.filesystem to enable symlinks by default.
  • Updated love.math.setRandomSeed and RandomGenerator:setSeed to produce better results for the first few random() calls.
  • Updated love.math.random and RandomGenerator:random to produce slightly better results in general.
  • Updated Source methods that deal with spatial audio to error rather than failing silently if the Source isn't mono.
  • Updated the 3D and 4D variants of love.math.noise to use Perlin noise rather than Simplex noise, to avoid patent issues.
  • Updated ImageFonts to no longer treat separator pixels as spacing.
  • Updated the default font to use less memory.
  • Updated the behavior of text wrapping with love.graphics.printf and Font:getWrap to work better.
  • Updated love.graphics.print and love.graphics.printf to no longer automatically round the x and y position arguments.
  • Updated some error messages for love.graphics.newImage to be more descriptive.
  • Updated love.graphics color functions to automatically apply love.math.gammaToLinear to color values when gamma-correct rendering is enabled.
  • Updated the 'normal' Canvas format to internally use 'srgb' rather than 'rgba8' when gamma-correct rendering is enabled.
  • Updated love.graphics.setColor to affect all drawn objects, including ParticleSystems, SpriteBatches, and Meshes.
  • Updated the default fullscreen type to be "desktop" rather than "exclusive".
  • Updated the minimum runtime system requirements of LOVE to require OpenGL 2.1 or OpenGL ES 2 support.
  • Updated the pixel shader effect function so screen_coords.y is 0 at the top of the screen instead of the bottom.
  • Updated Images to require setting the mipmaps flag to true on creation in order to use mipmaps.
  • Updated Images to allow mipmaps for non-power-of-two sizes.
  • Removed functions deprecated in LOVE 0.9.1 and 0.9.2:
  • Removed love.graphics.getMaxImageSize and love.graphics.getMaxPointSize (replaced by love.graphics.getSystemLimits.)
  • Removed Mesh:set/getImage, SpriteBatch:set/getImage, and ParticleSystem:set/getImage (replaced by set/getTexture.)
  • Removed SpriteBatch:bind/unbind.
  • Removed Canvas:getFSAA and the "fsaa" flag in love.conf and love.window.setMode (replaced by Canvas:getMSAA and "msaa".)
  • Removed the "dxt" and "bc5" Graphics Feature constant (replaced by love.graphics.getCompressedImageFormats.)
  • Removed the "hdrcanvas" Graphics Feature constant (replaced by love.graphics.getCanvasFormats.)
  • Removed love.window.getWidth/getHeight/getDimensions (use love.graphics.getWidth/getHeight/getDimensions or love.window.getMode instead.)

New in LOVE 0.9.2 (Mar 2, 2015)

  • Additions:
  • Added Lua 5.3's UTF-8 module, via utf8 = require("utf8").
  • Added Shader:getExternVariable.
  • Added several new Canvas texture formats.
  • Added love.graphics.getCanvasFormats.
  • Added love.graphics.getCompressedImageFormats.
  • Added ParticleSystem:setQuads.
  • Added ParticleSystem:setLinearDamping.
  • Added ParticleSystem:getLinearDamping.
  • Added SpriteBatch:flush.
  • Added love.graphics.getStats.
  • Added mirroredrepeat WrapMode.
  • Added love.audio.setDopplerScale and love.audio.getDopplerScale.
  • Added optional duration argument to Joystick:setVibration.
  • Added love.joystick.loadGamepadMappings and love.joystick.saveGamepadMappings.
  • Added Joint:setUserData and Joint:getUserData.
  • Added Joint:getBodies.
  • Added GearJoint:getJoints.
  • Added Body:getWorld.
  • Added Body:getJointList.
  • Added Contact:getFixtures and Body:getContactList.
  • Added Body:isDestroyed, Fixture:isDestroyed, Joint:isDestroyed, and World:isDestroyed.
  • Added love.mousemoved event callback.
  • Added love.mouse.setRelativeMode and love.mouse.getRelativeMode.
  • Added love.keyboard.getKeyFromScancode and love.keyboard.getScancodeFromKey.
  • Added love.window.getDisplayName.
  • Added love.window.minimize.
  • Added love.window.showMessageBox.
  • Added love.window.toPixels and love.window.fromPixels.
  • Added love.window.setPosition and love.window.getPosition.
  • Added x and y fields to the flags table in love.window.setMode and love.window.getMode, and to the t.window table in love.conf.
  • Added refreshrate field to the table returned by love.window.getMode.
  • Added love.filesystem.isSymlink, love.filesystem.setSymlinksEnabled, and love.filesystem.areSymlinksEnabled.
  • Added love.filesystem.getRealDirectory.
  • Deprecations:
  • Deprecated SpriteBatch:bind and SpriteBatch:unbind.
  • Deprecated all uses of the name 'FSAA' in favor of 'MSAA'.
  • Deprecated the hdrcanvas GraphicsFeature constant in favor of love.graphics.getCanvasFormats.
  • Deprecated the dxt and bc5 GraphicsFeature constants in favor of love.graphics.getCompressedImageFormats.
  • Deprecated love.window.getWidth, love.window.getHeight, and love.window.getDimensions in favor of the love.graphics equivalents or love.window.getMode.
  • Renamed APIs:
  • Renamed all cases of FSAA to MSAA. The FSAA names still exist for backward-compatibility.
  • Fixes:
  • Fixed crashes when LÖVE objects are garbage-collected in multiple threads simultaneously.
  • Fixed love.filesystem.setIdentity breaking in some situations when called multiple times.
  • Fixed the default love.filesystem identity when in Fused mode in Windows.
  • Fixed love.system.openURL sometimes blocking indefinitely on Linux.
  • Fixed love.joystick.setGamepadMapping.
  • Fixed the order of vertices in ChainShapes.
  • Fixed love.mouse.getPosition returning outdated values if love.mouse.setPosition was used in the same frame.
  • Fixed love.graphics.newFont to error when given an invalid size argument.
  • Fixed the file name, line number, and backtrace given if love.graphics.print errors.
  • Fixed a small memory leak if love.graphics.newCanvas errors.
  • Fixed Shader:getWarnings returning unnecessary information.
  • Fixed a potential crash when Shader objects are garbage collected.
  • Fixed a potential small memory leak triggered when love.graphics.newShader errors.
  • Fixed love.graphics.newMesh(vertexcount, ...) causing the Mesh to do instanced rendering.
  • Fixed Mesh:getVertexMap.
  • Fixed Image:refresh generating mipmaps multiple times if mipmap filtering is enabled.
  • Fixed Image:setMipmapFilter to not keep bad state around if it errors.
  • Fixed Mesh:setDrawRange when the Mesh has a vertex map set.
  • Fixed internal detection of the 'position' and 'effect' shader functions.
  • Fixed some cases of noncompliant shader code not properly erroring on some nvidia drivers.
  • Fixed Texture memory leak when Meshes are garbage collected.
  • Fixed the default line join mode to be 'miter' instead of an undefined value.
  • Fixed Canvas:getPixel to error if the coordinates are not within the Canvas' bounds.
  • Fixed detection of compressed textures to work regardless of the file's extension.
  • Fixed the default error handler screen's text size when highdpi mode is enabled on a Retina monitor in OS X.
  • Fixed the default error handler background color when sRGB mode is enabled for the window.
  • Fixed the state of wireframe mode when love.window.setMode is called.
  • Fixed love.window.setMode to fall back to the largest available mode if a width or height greater than the largest supported is specified and exclusive-fullscreen mode is used.
  • Other Changes:
  • Updated the Windows executable to always prefer the higher performance GPU on nvidia Optimus systems.
  • Updated the --console command-line argument in Windows to open the console before conf.lua is loaded.
  • Updated t.console and the --console command-line argument in Windows to use the existing console window, if LÖVE was launched from one.
  • Updated the love executable to verify that the love library version matches before using it.
  • Updated the Lua wrapper code for modules to avoid crashes when the module's instance is created, deleted, and recreated.
  • Updated internal code for handling garbage collection of love objects to be more efficient.
  • Updated love's initialization code to trigger a Lua error if love.conf has an error in it.
  • Updated love.filesystem.getSaveDirectory and friends to strip double-slashes ("//") from their returned paths.
  • Updated the error message when love.filesystem.write or File:open fails because the directory doesn't exist.
  • Updated error message when love.math.setRandomSeed(0) is attempted.
  • Updated the error message when invalid UTF-8 strings are used in love functions that expect UTF-8.
  • Updated love.physics.newChainShape to error if the number of arguments is invalid.
  • Updated love.physics.newPolygonShape and love.physics.newChainShape to accept a table of vertices.
  • Updated love.thread.newThread to accept a literal string of code.
  • Updated love-created threads to use names visible in external debuggers.
  • Updated SpriteBatch:unbind / SpriteBatch:flush to use less VRAM if the SpriteBatch has the static usage hint.
  • Updated love.graphics.newImage, love.image.newImageData, etc. to leave less temporary Lua-owned memory around.
  • Updated love.graphics.push to accept different stack types to push. Current types are "transform" and "all".
  • Updated love shaders to accept GLSL ES precision qualifiers (lowp, mediump, and highp) on variables, although they do nothing.
  • Updated the error message for love.graphics.newShader to be less cryptic if an invalid filename is given.
  • Updated compressed texture loading code to support BC6 and BC7 compressed textures (if the graphics driver supports them.)

New in LOVE 0.9.1 (Apr 2, 2014)

  • ADDITIONS:
  • Added love.getVersion.
  • Added love.system.openURL.
  • Added "screen" BlendMode.
  • Added Source:clone.
  • Added ParticleSystem:clone.
  • Added ParticleSystem:moveTo, has smoother emitter movement compared to ParticleSystem:setPosition.
  • Added ParticleSystem:setRelativeRotation.
  • Added love.graphics.setWireframe and love.graphics.isWireframe for debugging.
  • Added Mesh:setDrawRange and Mesh:getDrawRange.
  • Added Mesh:setTexture, SpriteBatch:setTexture, and ParticleSystem:setTexture. Accepts Canvases and Images.
  • Added high-dpi window support for Retina displays in OS X, via the 'highdpi' window flag.
  • Added love.window.getPixelScale.
  • Added love.graphics.getSystemLimit.
  • Added antialiasing support to Canvases.
  • Added Canvas:getFSAA.
  • Added love_ScreenSize built-in shader variable.
  • Added RandomGenerator:getState and RandomGenerator:setState.
  • Added CircleShape:getPoint and CircleShape:setPoint.
  • Added Body:setUserData and Body:getUserData.
  • Added some missing obscure KeyConstants.
  • Added optional callback argument to love.filesystem.getDirectoryItems.
  • Added support for gamma-correct rendering:
  • Added a boolean srgb window setting to love.conf and love.window.setMode.
  • Added variant of love.graphics.newImage which interprets the image in the sRGB colorspace.
  • Added a new TextureFormat "srgb" for use with Canvases.
  • Added love.graphics.isSupported("srgb")
  • Added love.math.gammaToLinear and love.math.linearToGamma.
  • DEPRECATIONS:
  • Deprecated Mesh:setImage, SpriteBatch:setImage, and ParticleSystem:setImage.
  • Deprecated love.graphics.getMaxImageSize and love.graphics.getMaxPointSize.
  • FIXES:
  • Fixed love.graphics.scale with negative values causing incorrect line widths.
  • Fixed Joystick:isDown using 0-based button index arguments.
  • Fixed love.graphics.setCanvas() to restore the proper viewport and scissor rectangles.
  • Fixed TrueType font glyphs which request a monochrome bitmap pixel mode.
  • Fixed love.graphics.reset causing crashes when called in between love.graphics.push/pop.
  • Fixed tab characters ("\t") to display properly with love.graphics.print.
  • Fixed love.graphics.isCreated to return false if love.window.setMode fails.
  • Fixed love.window.setMode to only destroy OpenGL resources after checking if a fullscreen size is supported.
  • Fixed loading BC4 compressed textures.
  • Fixed World:getBodyList and World:getJointList causing hard crashes.
  • Fixed Fixture:setUserData and Fixture:getUserData to work in coroutines.
  • Fixed Source:setPitch to error when infinity or NaN is given.
  • Fixed SoundData objects being initialized with garbage sample values.
  • Fixed 8-bit SoundData samples when used with love.audio Sources.
  • OTHER CHANGES:
  • Updated t.console in love.conf to create the console before modules are loaded in Windows.
  • Updated the default love.run code to make initial love.math.random calls more random.
  • Updated the error text for love.filesystem’s module searchers when require fails.
  • Updated the love.filesystem module searchers to be tried after package.preload instead of before.
  • Updated love.filesystem's C library loader to look in paths added via love.filesystem.mount, in Fused mode.
  • Updated love.graphics.newParticleSystem, love.graphics.newSpriteBatch, and love.graphics.newMesh to accept Canvases.
  • Updated Canvas drawing code, texture coordinates are no longer flipped vertically.
  • Updated Canvas:renderTo to work properly if a Canvas is currently active.
  • Updated ParticleSystem:setEmissionRate to accept non-integer numbers.
  • Updated Mesh vertex maps (index buffers) to use less VRAM space.
  • Updated love.graphics.newMesh and Mesh:setVertices to default the UV parameters to 0,0.
  • Updated fullscreen-desktop and resizable window modes in OS X to use Mac OS 10.7's fullscreen Spaces.
  • Updated Source:play to return a boolean indicating success.

New in LOVE 0.9.0 (Dec 14, 2013)

  • Major changes:
  • Added three new modules: love.window, love.math, and love.system.
  • Reworked the love.joystick and love.thread modules.
  • Added new features to love.graphics, including polygon meshes and vertex shaders.
  • Integrated the ENet networking library via lua-enet.
  • Renamed many functions to be more consistent with the rest of the API.
  • Improved the performance of several APIs in love.graphics.
  • And a lot more!
  • Additions:
  • Added better multiplayer networking support with ENet (via the lua-enet library.)
  • Added --fused command line argument, to simulate fusing.
  • Added liblove.
  • Added the ability to have exit values.
  • Added exit value of 1 in case of error by default.
  • Added basic support for the file:// URI scheme.
  • Added love.timer.getAverageDelta.
  • Added Data:getString.
  • Added Contact:getChildren.
  • Added love.filesystem.isFused.
  • Added love.filesystem.getIdentity.
  • Added love.filesystem.append.
  • Added love.filesystem.getSize.
  • Added love.filesystem.mount and love.filesystem.unmount.
  • Added an optional file search order parameter to love.filesystem.setIdentity.
  • Added File:isOpen and File:getMode.
  • Added File:setBuffer, File:getBuffer, and File:flush.
  • Added textinput event for unicode text input.
  • Added love.keyboard.setTextInput and love.keyboard.hasTextInput.
  • Added previously internal Rasterizer and GlyphData methods.
  • Added support for UTF-8 Image Fonts.
  • Added Font:getAscent, Font:getDescent, and Font:getBaseline.
  • Added Font:setFilter and Font:getFilter.
  • Added Font:hasGlyphs.
  • Added angle, scale, and shear parameters to love.graphics.printf.
  • Added support for high dynamic range (HDR) Canvases.
  • Added mipmapping support to Images (has love.graphics.isSupported test).
  • Added vertex shader support.
  • Added boolean support to Shader:send.
  • Added Canvas:getPixel.
  • Added BlendMode "replace".
  • Added line join modes.
  • Added Mesh objects, allowing for arbitrary textured polygons.
  • Added multiple render target support to love.graphics.setCanvas.
  • Added love.graphics.setColorMask.
  • Added love.graphics.origin.
  • Added love.graphics.getRendererInfo.
  • Added love.graphics.getMaxImageSize.
  • Added SpriteBatch:getCount and SpriteBatch:getBufferSize.
  • Added SpriteBatch:getColor.
  • Added ParticleSystem:emit.
  • Added ParticleSystem:setInsertMode.
  • Added ParticleSystem:setAreaSpread.
  • Added ParticleSystem:isPaused and ParticleSystem:isStopped.
  • Added many ParticleSystem getter methods.
  • Added DXT compressed texture support to Images via love.image.newCompressedData.
  • Added love.image.isCompressed and Image:isCompressed.
  • Added Image:getDimensions, Canvas:getDimensions, and ImageData:getDimensions.
  • Added anisotropic filtering support for Images, Canvases, and Fonts.
  • Added Image:refresh.
  • Added Image:getData.
  • Added love.math module.
  • Added a platform-independent (good) random implementation to love.math.
  • Added RandomGenerator objects.
  • Added BezierCurve objects.
  • Added love.math.triangulate and love.math.isConvex.
  • Added love.math.noise.
  • Added love.system module.
  • Added love.system.getClipboardText and love.system.setClipboardText.
  • Added love.system.getOS and love.system.getProcessorCount.
  • Added love.window module.
  • Added love.window.isVisible.
  • Added flags to love.window.setMode.
  • Added monitor choosing support to love.window.setMode.
  • Added support for resizable, borderless, and non-centered windows.
  • Added support for "fullscreen-desktop" mode.
  • Added window resize and visible events.
  • Added love.window.getIcon.
  • Added t.window.icon to love.conf.
  • Added SoundData:getDuration and SoundData:getSampleCount.
  • Added Source:isPlaying.
  • Added Source:setRelative and Source:isRelative.
  • Added Source:setCone and Source:getCone.
  • Added Source:getChannels.
  • Added new Channels API for love.thread.
  • Added limited table support to Channel:push.
  • Added Thread:getError.
  • Added Thread:isRunning.
  • Added threaderror event.
  • Added love.mousefocus and love.window.hasMouseFocus.
  • Added custom hardware cursor support via love.mouse.newCursor.
  • Added love.mouse.setX and love.mouse.setY.
  • Added Joystick objects.
  • Added joystick add and remove events.
  • Added joystick axis and hat move events.
  • Added unified Gamepad API for joysticks which have a similar layout to the Xbox controller.
  • Added joystick vibration support.
  • OPTIONAL: Added support for Game Music Emu.
  • Removals:
  • Removed release mode (but Fused mode is still there.)
  • Removed love.keyboard.getKeyRepeat (see love.keyboard.hasKeyRepeat).
  • Removed the unicode argument from love.keypressed (see love.textinput).
  • Removed love.graphics.drawTest.
  • Removed love.graphics.quad and love.graphics.triangle.
  • Removed ColorModes and love.graphics.setColorMode.
  • Removed love.graphics.newStencil.
  • Removed love.graphics.setLine and love.graphics.setPoint.
  • Removed love.graphics.drawq (functionality is merged into love.graphics.draw).
  • Removed SpriteBatch:addq and SpriteBatch:setq (functionality is merged into SpriteBatch:add and SpriteBatch:set).
  • Removed Quad:flip.
  • Removed ParticleSystem:isFull and ParticleSystem:isEmpty.
  • Removed ParticleSystem:getX and ParticleSystem:getY.
  • Removed love.graphics.checkMode.
  • Removed love.joystick module functions which operated on individual joysticks (see Joystick objects).
  • Removed joystick ball support.
  • Removed thread names.
  • Removed old thread messaging API (see Channels).
  • Removed love.timer.getMicroTime.
  • Renamed APIs:
  • Renamed love's boot script to 'love.boot', which can be required.
  • Renamed love.filesystem.mkdir to love.filesystem.createDirectory.
  • Renamed love.filesystem.enumerate to love.filesystem.getDirectoryItems.
  • Renamed World:setAllowSleeping and World:getAllowSleeping to World:setSleepingAllowed and World:isSleepingAllowed.
  • Renamed ChainShape:setPrevVertex to ChainShape:setPreviousVertex.
  • Renamed Joint:enableMotor to Joint:setMotorEnabled.
  • Renamed Joint:enableLimit and Joint:isLimitEnabled to Joint:setLimitsEnabled and Joint:hasLimitsEnabled.
  • Renamed t.screen to t.window in love.conf.
  • Renamed love.graphics.setCaption to love.window.setTitle.
  • Renamed PixelEffect to Shader (but now with vertex shaders).
  • Renamed love.graphics.setDefaultImageFilter to love.graphics.setDefaultFilter.
  • Renamed ParticleSystem:setSprite to ParticleSystem:setImage.
  • Renamed ParticleSystem:setGravity to ParticleSystem:setLinearAcceleration.
  • Renamed ParticleSystem:setLifetime and ParticleSystem:setParticleLife to ParticleSystem:setEmitterLifetime and ParticleSystem:setParticleLifetime.
  • Renamed ParticleSystem:count and all getNum* functions to get*Count.
  • Renamed SoundData:getBits and Decoder:getBits to SoundData:getBitDepth and Decoder:getBitDepth.
  • Renamed Source:setDistance and Source:getDistance to Source:setAttenuationDistances and Source:getAttenuationDistances.
  • Renamed love.mouse.setGrab to love.mouse.setGrabbed.
  • Fixes:
  • Fixed fused mode in OS X.
  • Fixed printing to the console in Windows before love.load is called.
  • Fixed the default love.run to not include the time taken by love.load in the first frame's dt calculation.
  • Fixed the error screen not always appearing until the next input event.
  • Fixed love.event.clear.
  • Fixed love.mouse.setPosition when called in love.load.
  • Fixed scaling in several love.physics functions.
  • Fixed Box2D exception in World:update.
  • Fixed many uncaught Box2D / love.physics exceptions for Bodies and Joints.
  • Fixed ChainShape:getPoints running out of Lua stack space and crashing.
  • Fixed File:read reading past end of file.
  • Fixed love.filesystem.setIdentity not removing read access from old directories.
  • Fixed possible memory leak in UTF-8 decoder.
  • Fixed spacing for the last character in an Image Font.
  • Fixed line wrapping in love.graphics.printf.
  • Fixed love.graphics.printf to error if the wrap limit is negative.
  • Fixed love.graphics.print truncating strings with embedded zeros.
  • Fixed crashes with font drawing on some ATI cards.
  • Fixed artifacts when drawing lines at huge scale.
  • Fixed Fonts and Canvases ignoring default image filter.
  • Fixed love.graphics.getLineWidth returning incorrect values.
  • Fixed love.graphics.getColor on some Windows systems.
  • Fixed alpha BlendMode.
  • Fixed multiplicative BlendMode.
  • Fixed love.graphics.getPointStyle.
  • Fixed line numbers in Shader errors.
  • Fixed Shader:send with Images and Canvases failing sometimes.
  • Fixed Shader:send to keep a reference to sent Images and Canvases.
  • Fixed crash when binding SpriteBatches multiple times.
  • Fixed SpriteBatches with more than 16,384 sprites.
  • Fixed draw order for ParticleSystems.
  • Fixed ParticleSystem:setSizes resetting the size variation.
  • Fixed love.window.getMode and friends returning wrong values when using desktop size.
  • Fixed keyrepeat settings being lost after (indirect) love.window.setMode.
  • Fixed the icon being reset after love.window.setMode.
  • Fixed memory leak in the mp3 decoder.
  • Fixed sound issues with some versions of OpenAL soft, by enabling direct channels.
  • Fixed 'random' hangs in audio.
  • Fixed case (in)sensitivity of sound file extension parsing.
  • Fixed looping support in tracker music formats.
  • Fixed skipping/looping issues when playing streaming audio Sources.
  • Fixed a race condition in Source:play.
  • Fixed WAVE sound playback.
  • Other Changes:
  • Moved love's startup to modules/love.
  • Moved window-related functions from love.graphics to love.window.
  • Updated functions which return LOVE objects to re-use the Lua-side object instead of always recreating it.
  • Updated the windows console, it now tries to re-use an active one first.
  • Updated error handling, error handlers now get resolved when the error occurs.
  • Updated order of sleep/present in love.run (now draws, *then* sleeps).
  • Updated love.keyboard.setKeyRepeat to take a boolean argument instead of numbers.
  • Updated love.keypressed's second argument to indicate whether the keypress is a repeat.
  • Updated keyboard key constants with some modern keyboard keys.
  • Updated love.filesystem to try to create the appdata directory if it doesn't exist yet.
  • Updated the default filesystem identity to omit file extension.
  • Updated love.filesystem.newFile to optionally open the file.
  • Updated most love.filesystem functions to return nil, error on internal failure.
  • Updated love.graphics.print's x and y arguments to default to 0.
  • Updated the setFilter and setWrap methods, the second argument is now optional.
  • Updated Font and ParticleSystem rendering code, now more performant.
  • Updated SpriteBatch code, now more performant when adding/setting and (un)binding.
  • Updated Canvas code to support more systems.
  • Updated Canvas:getImageData and love.graphics.newScreenshot to be more efficient.
  • Updated love.graphics.newScreenshot to create a fully opaque image by default.
  • Updated error messages when sending bad values to Shaders.
  • Updated love.graphics.newParticleSystem to have a default buffer size of 1000.
  • Updated love.image.newImageData and love.graphics.newImage to accept FileData.
  • Updated ImageData:setPixel to accept a table and default to 255 alpha.
  • Updated ImageData:mapPixel, is now more efficient and now accepts optional x,y,w,h arguments.
  • Updated love.image memory handling, improves errors and thread-safety.
  • Updated love.audio.newSource, love.sound.newDecoder, and love.sound.newSoundData to accept FileData.
  • Updated allocation for SoundData, it's more efficient and less wasteful.
  • Updated SoundData:setSample and SoundData:getSample to error for invalid samples.
  • Updated Source:set* functions to default z to 0.
  • Updated Source:seek to error for negative offsets.
  • Updated Thread:start to accept arguments. The arguments are available in the thread via ... (the vararg expression.)
  • Updated love.timer.getFPS to be microsecond-accurate.
  • Updated love.timer.getTime to be microsecond-accurate and monotonic.
  • Updated Box2D to version 2.3.

New in LOVE 0.8.0 (Apr 9, 2012)

  • Added release error screen.
  • Added alpha to love.graphics.setBackgroundColor.
  • Added Canvas:clear(r, g, b, a).
  • Added Canvas support to love.graphics.drawq.
  • Added Canvas:getWidth and Canvas:getHeight.
  • Added love.graphics.arc.
  • Added seek and tell to Source objects.
  • Added color interpolation to ParticleSystem.
  • Added automatic PO2 padding for systems not supporting the OpenGL extension.
  • Added UTF-8 support for fonts.
  • Added Box2D error handling for some commonly failing functions.
  • Added ability for fused release games to have their write dir in appdata.
  • Added shear transformation to drawing functions.
  • Added origin to font printing.
  • Added love.graphics.getMode.
  • Added per-sprite colors on SpriteBatches.
  • Added PixelEffects.
  • Added love.graphics.isSupported.
  • Added love.graphics.getCanvas.
  • Added love.event.quit.
  • Added stencil masks.
  • Added alternative SpriteBatch provider, it should work everywhere now.
  • Added a loader for binary modules.
  • Added Thread:getKeys.
  • Added option of fractions for Quads.
  • Added PNG, JPEG and GIF support to ImageData:encode.
  • Added 64-bit support for Mac OS X.
  • Added premultiplied blending mode.
  • Added functions to set/get default image filter modes.
  • Added SpriteBatch:set.
  • Added new events system, with support for custom events and long event names.
  • Added sound attenuation by distance.
  • Added SpriteBatch:getImage.
  • Added combine color mode.
  • Added automatic random seeding to love.run.
  • Added support for the subtract BlendMode on older graphics cards.
  • Added love._os field, which contains the OS the game is running on.
  • Fixed wrapping for single words.
  • Fixed tracebacks not showing filenames.
  • Fixed love.graphics.push/pop capable of causing overflows/underflows.
  • Fixed setScissor on Canvases.
  • Fixed several issues with audio, e.g. clicks and pops in mp3s.
  • Fixed crashes when bodies were destroyed during collisions.
  • Fixed bound SpriteBatches corrupting when drawing.
  • Fixed thread-safety issues with ImageData.
  • Fixed memory leaks in audio sources.
  • Fixed thread's set (previously send) accidentally changing the type.
  • Fixed SoundData allocating the wrong number of samples.
  • Fixed SpriteBatch support on Intel cards.
  • Fixed love.filesystem.lines() leaking.
  • Fixed most leaking on unclosed File objects.
  • Fixed crashes when operating on non-existent files.
  • Fixed a bug where empty files on windows would never reach eof.
  • Fixed crash when SoundData runs out of memory.
  • Fixed ordering of loaders, love should have priority over lua.
  • Fixed several miscellaneous memory leaks.
  • Fixed a few cases where strings with \0 in them would not be stored correctly.
  • Fixed love's startup time being in the first dt.
  • Fixed internal string conversions, they are faster now.
  • Fixed (bad) performance of ImageData:paste.
  • Fixed love.graphics.toggleFullscreen not maintaining graphics state.
  • Renamed SpriteBatch's lock/unlock to bind/unbind.
  • Renamed Framebuffer to Canvas.
  • Renamed love.thread.send/receive to set/get.
  • Renamed love.graphics.setRenderTarget to setCanvas.
  • Removed canvas auto-clearing.
  • Removed EncodedImageData.
  • Removed old syntax for require (with extension).
  • Removed love.graphics.setFont([file], [size]).
  • Removed Thread:kill.
  • Updated love.joystick to be 1-indexed.
  • Updated Sources to update more cleanly and control more intuitively.
  • Updated font engine.
  • Updated line drawing to a custom system.
  • Updated love.timer.sleep to use seconds, like the rest of love.
  • Updated love.timer to be more accurate.
  • Updated love.graphics.circle to have max(10, r) as default for segments.
  • Updated ImageData:encode to write to files directly.
  • Updated version compatibility system to actually do something.
  • Updated love.run's order, events are checked just before update.
  • Updated Box2D to version 2.2.1.
  • Updated sdl to 1.2.15 on Windows
  • Updated freetype to 2.4.9 on Windows
  • Updated libjpeg to 8d on Windows
  • Updated libmodplug to 0.8.8.4 on Windows
  • Updated libogg to 1.3.0 on Windows
  • Updated libpng to 1.5.10 on Windows
  • Updated mpg123 to 1.13.7 on Windows
  • Updated openal-soft to 1.14 on Windows
  • Updated zlib to 1.2.6 on Windows

New in LOVE 0.7.2 (May 20, 2011)

  • Added Framebuffer:get/setWrap.
  • Added love.event.clear.
  • Added support for any number of arguments to love.keyboard.isDown, love.mouse.isDown and love.joystick.isDown.
  • Added SpriteBatch:setImage().
  • Fixed fused games not working.
  • Fixed ParticleSystem:setSize ignoring the variation argument.
  • Fixed some file-opening exceptions not being caught.
  • Fixed files loaded by libmodplug being too loud.
  • Fixed paths with periods in them not working.
  • Fixed love.graphics.getBlendMode not detecting subtractive and multiplicative blend modes.
  • Fixed crash when there was no memory available for newImageData(w, h).
  • Updated PhysicsFS version to 2.0.2 on Windows
  • Updated OpenAL Soft version to 1.13 on Windows
  • Updated libmodplug version to 0.8.8.1 on Windows
  • Updated FreeType version to 2.4.4 on Windows
  • Updated libmpg123 version to 1.13.2 on Windows
  • Windows binary no longer depends on VC2005 runtime.
  • Windows binary no longer depends on SSE2 support.

New in LOVE 0.7.1 (Feb 15, 2011)

  • Added source:isPaused()
  • Added error when initial window can't be created.
  • Added framebuffer filter modes.
  • Added love.filesystem.getLastModified.
  • Added filter modes for ImageFonts.
  • Added dead key support by using "unknown" key with correct unicode value.
  • Added 0 width and height in love.conf. (for current desktop resolution)
  • Added alpha support when encoding TGA images.
  • Fixed a lot of bugs regarding zero characters in threads.
  • Fixed handling of a directory named "love" in current directory.
  • Fixed a few unhandled errors in setScissor.
  • Fixed a bug where old physics callbacks were never dereferenced.
  • Fixed loss of mouse visibility settings on setMode.
  • Fixed creation of a framebuffer unbinding current framebuffer.
  • Fixed several race conditions in love.thread.
  • Fixed 'love .', so it won't use lovedir/. as save dir.
  • Fixed setLineHeight.
  • Fixed extended ascii and ImageFonts.
  • Fixed printf's line wrapping.
  • Fixed crash when playing sounds.
  • Fixed playback of mp3s with arbitrary sample rates.
  • Fixed handling of negative indices in love.joystick.
  • Fixed toggleFullscreen.
  • Fixed unexpected behaviour with hash tables to love.graphics.line.
  • Fixed mouse coordinates being capped after setMode.
  • Fixed setFont's error handling on a non-existant file.
  • Fixed issue where Windows builds would hard crash on Lua errors
  • Removed custom sample rates for Decoders.

New in LOVE 0.7.0 (Dec 6, 2010)

  • Added love.thread.
  • Added love.font.
  • Added love.graphics.Framebuffer.
  • Added Source:play, Source:pause, etc.
  • Added Source:isStatic().
  • Added get/setPosition, get/setVelocity, and get/setDirection to Source.
  • Added get/setGroupIndex to CircleShape and PolygonShape.
  • Added Font:getWrap.
  • Added identity field to love.conf.
  • Added love.quit callback.
  • Added love.focus callback.
  • Added extra meter parameter to love.physics.newWorld.
  • Added love.graphics.setIcon.
  • Added way to make the window desktop resolution.
  • Added subtractive and multiplicative blend modes.
  • Added body:getAllowSleeping.
  • Added shape:getBody.
  • Added love.filesystem.FileData for public usage.
  • Added base64 support for love.filesystem.FileData.
  • Added table support for love.graphics.setColor and love.graphics.setBackgroundColor.
  • Added love.graphics.hasFocus().
  • Added ?/init.lua to the loader.
  • Fixed the debug module not being an upvalue of the error handlers. (you can now override debug)
  • Fixed some cases when love.audio.pause and friends, were acting on everything, not just the passed Source.
  • Fixed setFixedRotation enabling other flags.
  • Fixed a bug in the loader (for require).
  • Fixed ParticleSystem::setSprite not retaining the new image.
  • Fixed setMode removing images settings (wrapping, filters).
  • Fixed shape:getBody, it's now exposed for LÖVE usage.
  • Fixed DistanceJoint:getType() returning "circle" - it now returns "distance".
  • Fixed SpriteBatches being unaffected by setColor
  • Fixed the audio bug.
  • Fixed invalid FSAA values crashing LÖVE.
  • Fixed a bunch of compiler warnings.
  • Fixed OS X not properly using UTIs for .love files.
  • Fixed the modplug decoder not properly handeling files that fail to load.
  • Fixed a memory leak in setFont.
  • Fixed bug where errors in threads wouldn't get picked up by demand.
  • Fixed part of the bug with newlines when scaling text (rotating still messes up the lines).
  • Fixed the bug where newImageFont would try to created ImageData out of ImageData.
  • Fixed error handler not resetting the blend mode.
  • Changed fonts, they're now po2 safe.
  • Changed the traceback in the error screen.
  • Changed font origin to top-left.
  • Changed linux save dir location to obey to Freedesktop.org's XDG specs. (~/.local/share/love by default.)
  • Removed font functions from love.graphics.
  • Removed love.physics.newWorld(w, h). Use love.physics.newWorld(x1, y1, x2, y2) instead.

New in LOVE 0.6.2 (Mar 8, 2010)

  • Fixed a bug causing ImageFonts to cut off some pixels.
  • Fixed a bug where filled rectangles were too small.
  • Fixed a bug in Image:setFilter where it would switch the parameters.
  • Fixed a bug in ImageRasterizer where it wasn't using the data.
  • Image filter and wrap modes now use string constants as well.
  • Fixed double-transform bug in SpriteBatch.
  • Errors are reported on stdout again.
  • Another fix for the icons on Ubuntu.

New in LOVE 0.6.1 (Feb 18, 2010)

  • Added Shape:setGroupIndex and getGroupIndex.
  • Added Body:setFixedRotation and Body:getFixedRotation.
  • Added Body:setInertia.
  • Added CircleShape:getLocalCenter and CircleShape:getWorldCenter.
  • Added icons and file associations for the debs.
  • Added the demos folder to the Mac OS X DMG.
  • It's now possible to run a .love from Resources in Mac OS X, thanks to Steve Johnson.
  • Fixed a bug with multiple Sources on the same Music.
  • Fixed a bug so the mouse doesn't get crippled when the keyboard is disabled.
  • Fixed a bug where love.graphics.rectangle drew a too large rectangle.
  • Fixed a bug where memory wouldn't be released correctly.
  • Fixed epic physics typo (getRestituion->getRestitution).
  • Fixed crash on opening non-existent image.
  • The error screen redraws when an event occurs.
  • The default love.run() now gracefully handles disabled modules.
  • The debian packages should now successfully include icons, file associations, etc, and should give the correct architecture.
  • Added support for drawing polylines to love.graphics.line - the syntax is the same as love.graphics.polygon.
  • Removed Music and Sound. There are now only sources.
  • Improved the stability of love.audio/love.sound.

New in LOVE 0.5.0 (Jan 5, 2009)

  • Added love.joystick.
  • Added network support via LuaSocket.
  • Added support for loading of appended .love-file.
  • Added love.filesystem.lines().
  • Added a loader function to enable use of normal require().
  • Added love.filesystem.load().
  • Added love.filesystem.getSaveDirectory()
  • Added love.filesystem.getWorkingDirectory()
  • Added optional explicit destruction of Box2D objects.
  • Added shape:testSegment().
  • Added love.graphics.screenshot() (.bmp only).
  • Added default size (12) to font-related functions.
  • Added love.graphics.setFont( filename, size )
  • Added love.graphics.setLineStippe and related functions.
  • Added love.graphics.setPointSize and related functions.
  • Changed love.filesystem.read() to accept file name.
  • Changed love.filesystem.write() to accept file name.
  • Changed love.graphics.triangle() to accept CCW and CW ordering.
  • Fixed love.graphics.read adding bogus characters at the end of string.
  • Fixed epic swigfusion bug.
  • Fixed love.graphics.getFont so it returns nil if no font is present.
  • Fixed bug where love.graphics.getBlendMode() always returns blend_normal.
  • Fixed bug which caused error screen to be scissored (when enabled).
  • Fixed Body:setAngle to accept degrees like everything else.
  • Cleaned up love::File and love_physfs.
  • Cleaned up love::Reference so it stores its reference in _G.