11.0

no-game screen

The codename for LÖVE 11.0 is Mysterious Mysteries. It is currently released.

Changes from 0.10.2

Additions

• Added formal deprecation warnings, on by default for non-fused games.
• Added love.setDeprecationOutput and love.hasDeprecationOutput.
• Added Object:release.
• Added Data:clone.
• Added queueable audio Sources.
• Added microphone recording support.
• Added low pass, high pass, and band pass filters to love.audio Sources.
• Added audio effect APIs (reverb, echo, etc.)
• Added variants of SoundData:getSample and SoundData:setSample which take a channel index parameter.
• Added variants of love.audio.play, love.audio.pause, and love.audio.stop which take a list of Sources.
• Added love.system.hasBackgroundMusic.
• 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 for controlling the number of internal iterations to perform.
• 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.getInfo (replaces love.filesystem.exists / isFile / isDirectory / isSymlink / getLastModified / getSize).
• Added love.filesystem.setCRequirePath and love.filesystem.getCRequirePath, 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 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 a default love.threaderror callback, which raises the error in the main thread.
• Added love.data module. It includes hex/base64 encoding functions, MD5 and SHA hashing, string packing, compression APIs, and more.
• Added Transform objects to love.math.
• Added support for different ImageData PixelFormats, 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, Texture:getPixelHeight, love.graphics.getPixelWidth, and love.graphics.getPixelHeight.
• Added Texture:getDPIScale, love.graphics.getDPIScale, and Font:getDPIScale.
• Added Texture:getMipmapCount, getFormat, getLayerCount, getDepth, and getTextureType.
• Added Array, Cubemap, and Volume TextureTypes and corresponding Texture APIs.
• Added love.graphics.newArrayImage, newVolumeImage, newCubeImage, and variants to love.graphics.newCanvas for creating different texture types.
• Added love.graphics.getTextureTypes, which returns a table with fields indicating support for each TextureType.
• Added Image:replacePixels (replaces Image:refresh).
• Added love.graphics.drawLayer, SpriteBatch:addLayer, and SpriteBatch:setLayer for easily drawing layers of Array Textures
• Added variants of love.graphics.print and love.graphics.printf which take a Font argument.
• 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' PixelFormats 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 variant of love.graphics.getCanvasFormats which takes a 'readable' boolean.
• Added optional 'depthstencil' field to the table passed into love.graphics.setCanvas, for using a depth/stencil formatted Canvas when rendering.
• Added optional 'depth' and 'stencil' boolean fields to the table passed into love.graphics.setCanvas, for enabling internal 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 currently 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 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 File and FileData variants of love.graphics.newShader.
• 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 (replaces Shader:getExternVariable).
• Added support for non-square Shader uniform matrices on desktop platforms and on mobile GLSL 3.
• Added Shader:send(matrixname, matrixlayout, 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 love.graphics.captureScreenshot (replaces love.graphics.newScreenshot).
• Added 'glsl3', 'instancing', 'fullnpot','pixelshaderhighp', and 'shaderderivatives' GraphicsFeatures.
• Added 'anisotropy' graphics GraphicsLimit.
• Added 'drawcallsbatched' field to love.graphics.getStats.
• Added hardware Mesh instancing support via love.graphics.drawInstanced and a new Mesh:attachAttribute variant.
• 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 the ability to prevent love from creating a stencil buffer for the window in love.conf and love.window.setMode.
• Added love.window.updateMode.
• Added love.window.isMinimized.
• Added love.window.restore.
• Added support for header-less DEFLATE to love.data.compress/decompress.

Renamed APIs

All renamed APIs in 11.0 are deprecated rather than removed, until the next major release.

• 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. If love.errhand is defined and love.errorhandler isn't, it will continue to work.
• Renamed Source/SoundData/Decoder:getChannels to Source/SoundData/Decoder:getChannelCount.
• Renamed PrismaticJoint:hasLimitsEnabled and RevoluteJoint:hasLimitsEnabled to PrismaticJoint:areLimitsEnabled and RevoluteJoint:areLimitsEnabled.
• Renamed love.audio.getSourceCount to love.audio.getActiveSourceCount.
• Renamed all get[Object]List functions to get[Object]s.

Other Deprecations

• Deprecated love.filesystem.exists / isFile / isDirectory / isSymlink / getLastModified / getSize (use love.filesystem.getInfo instead).
• Deprecated love.math.compress / decompress (use love.data.compress / decompress instead).

Removals

• Removed the default source type for love.audio.newSource.
• Removed Source:isStopped and Source:isPaused. Use Source:isPlaying instead.
• Removed Source:rewind. Use Source:stop or Source:seek(0) instead.
• Removed Source:resume and love.audio.resume. Use Source:play and love.audio.play instead.
• 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 Image:getData and Image:refresh, use Image:replacePixels 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 SpriteBatch:setBufferSize, spritebatches now automatically grow when they run out of space.
• Removed deprecated enet function host:socket_get_address.
• Removed functions deprecated in LÖVE 0.10.2:
  • Removed undocumented Shader:sendInt, Shader:sendBoolean, Shader:sentFloat, Shader:sendMatrix, and Shader:sendTexture methods (use Shader:send instead).
  • Removed love.window.isCreated (use love.window.isOpen instead).

Other changes

• Windows XP is no longer officially supported.
• Changed all color values to be in the range 0-1, rather than 0-255. This affects the following functions:
  • love.graphics.setColor, love.graphics.getColor, love.graphics.setBackgroundColor, and love.graphics.getBackgroundColor.
  • SpriteBatch:setColor and SpriteBatch:getColor.
  • ParticleSystem:setColors and ParticleSystem:getColors.
  • love.graphics.clear.
  • love.graphics.newMesh, Mesh:setVertex, and Mesh:getVertex.
  • The colored text variants of love.graphics.print, love.graphics.printf, love.graphics.newText, Text:set, Text:setf, Text:add, and Text:addf.
  • Shader:sendColor.
  • love.graphics.points.
  • ImageData:setPixel, ImageData:getPixel, and ImageData:mapPixel.
  • love.math.gammaToLinear and love.math.linearToGamma.

• 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' BlendMode to error if not used with the 'premultiplied' BlendAlphaMode, since the formula only works with that anyway.
• Changed the matrix variant of Shader:send to interpret the matrix as row-major by default, instead of column-major.
• Changed the variant of Canvas:newImageData which accepts x/y/width/height to also require slice and mipmap index parameters, which are used when the Canvas isn't a 2D type or has mipmaps.
• 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 love.graphics.setCanvas.
• Changed Mesh:setDrawRange to take 'start' and 'count' parameters instead of 'min' and 'max'.
• Changed the variant of love.image.newImageData which takes dimension arguments to take an optional PixelFormat argument as well.
• Changed the 'vsync' field of love.window.setMode and t.window in love.conf. It's now an integer with 0 disabling vsync.
• Changed Channel and love.event.push table serialization to accept non-flat tables and detect cycles, cycles now cause an error rather than a stack overflow.
• Changed Sources to either be playing or not playing, rather than playing, paused, or stopped. Source:stop now pauses and rewinds the Source.
• Changed love.audio.pause() to return a list of Sources that have been paused by that call.
• Changed Source seeking behaviour, all kinds of Sources now behave similarly when seeking past the boundaries.
• Changed love.timer.step to return the calculated delta time.
• Changed love.run and love.errorhandler to return a function for their main loop, which gets called until love quits.
• Changed enet to no longer set the 'enet' global.
• Changed love.keyboard.isDown and love.keyboard.isScancodeDown to error if an invalid enum value is given.

• 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.math.random to have improved numeric distribution.
• Updated love.graphics to support Core Profile OpenGL 3.3+ when available.
• Updated SpriteBatches to automatically grow their buffer when they run out of space.
• Updated Shaders to always expose derivative functions (dFdx, dFdy, fwidth) when available in OpenGL ES.
• Updated Shaders to allow using VERTEX and PIXEL as variable names in shader code.
• Updated love.graphics.circle, love.graphics.ellipse, love.graphics.arc, and love.graphics.rectangle to take transformation scale into account when determining the number of segments to use.
• Updated the error message when bad values are given to love.graphics.line.
• 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 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.

Performance Improvements

• 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.

Fixes

• Fixed an error in the 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.setClipboardText and love.system.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 Shader:send and Shader:sendColor ignoring the last argument for an array.
• Fixed VaryingTexCoords and love_ScreenSize in shaders to be 'highp' in OpenGL ES, when supported.
• Fixed a crash when love.graphics.pop is called after love.window.setMode while the transformation stack was not empty.
• Fixed ParticleSystem:setParticleLifetime to error if a negative value is given.
• 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.