Difference between revisions of "11.0"

m
(Updated changelog)
Line 17: Line 17:
 
* Added variants of all table-with-fields-returning get* functions, the new variants take an existing table to fill in.
 
* 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 a variant to [[World:update]] for controlling the number of internal iterations to perform.
 +
* Added [[Body:isTouching]].
 
* Added [[RopeJoint:setMaxLength]].
 
* Added [[RopeJoint:setMaxLength]].
 
* Added a click count argument to [[love.mousepressed]] and [[love.mousereleased]].
 
* 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]] / [[love.filesystem.isFile|isFile]] / [[love.filesystem.isDirectory|isDirectory]] / [[love.filesystem.isSymlink|isSymlink]] / [[love.filesystem.getLastModified|getLastModified]] / [[love.filesystem.getSize|getSize]]).
 
* Added [[love.filesystem.getInfo]] (replaces [[love.filesystem.exists]] / [[love.filesystem.isFile|isFile]] / [[love.filesystem.isDirectory|isDirectory]] / [[love.filesystem.isSymlink|isSymlink]] / [[love.filesystem.getLastModified|getLastModified]] / [[love.filesystem.getSize|getSize]]).
 
* Added [[love.filesystem.setCRequirePath]] and [[love.filesystem.getCRequirePath]], and use that to find C libraries for require.
 
* 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 [[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 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 a default [[love.threaderror]] callback, which raises the error in the main thread.
* Added [[love.data]] module. It includes hex/base64 [[love.data.encode|encoding functions]], MD5 and SHA [[love.data.hash|hashing]], [[love.data.pack|string packing]], and more.
+
* Added [[love.data]] module. It includes hex/base64 [[love.data.encode|encoding functions]], MD5 and SHA [[love.data.hash|hashing]], [[love.data.pack|string packing]], [[love.data.compress|compression APIs]], and more.
 
* Added [[Transform]] objects to [[love.math]].
 
* Added [[Transform]] objects to [[love.math]].
 
* Added support for different [[ImageData]] [[PixelFormat]]s, including RGBA8 (the default), RGBA16, RGBA16F, and RGBA32F.
 
* Added support for different [[ImageData]] [[PixelFormat]]s, including RGBA8 (the default), RGBA16, RGBA16F, and RGBA32F.
Line 32: Line 35:
 
* Added [[Texture:getPixelWidth]], [[Texture:getPixelHeight]], [[love.graphics.getPixelWidth]], and [[love.graphics.getPixelHeight]].
 
* Added [[Texture:getPixelWidth]], [[Texture:getPixelHeight]], [[love.graphics.getPixelWidth]], and [[love.graphics.getPixelHeight]].
 
* Added [[Texture:getDPIScale]], [[love.graphics.getDPIScale]], and [[Font:getDPIScale]].
 
* Added [[Texture:getDPIScale]], [[love.graphics.getDPIScale]], and [[Font:getDPIScale]].
 +
* Added [[Texture:getMipmapCount]], [[Texture:getFormat|getFormat]], [[Texture:getLayerCount|getLayerCount]], [[Texture:getDepth|getDepth]], and [[Texture:getTextureType|getTextureType]].
 
* Added Array, Cubemap, and Volume [[TextureType]]s, corresponding [[Texture]] APIs, and variants to [[love.graphics.newImage]] and [[love.graphics.newCanvas]] for creating different texture types.
 
* Added Array, Cubemap, and Volume [[TextureType]]s, corresponding [[Texture]] APIs, and variants to [[love.graphics.newImage]] and [[love.graphics.newCanvas]] for creating different texture types.
 
* Added [[love.graphics.getTextureTypes]], which returns a table with fields indicating support for each [[TextureType]].
 
* Added [[love.graphics.getTextureTypes]], which returns a table with fields indicating support for each [[TextureType]].
Line 39: Line 43:
 
* Added mipmapping support to [[Canvas]]es, including both auto-generated mipmaps and manually rendering to a specific mipmap level.
 
* Added mipmapping support to [[Canvas]]es, including both auto-generated mipmaps and manually rendering to a specific mipmap level.
 
* Added 'stencil8', 'depth24stencil8', 'depth32fstencil8', 'depth16', 'depth24', and 'depth32f' [[PixelFormat]]s for Canvases.
 
* Added 'stencil8', 'depth24stencil8', 'depth32fstencil8', 'depth16', 'depth24', and 'depth32f' [[PixelFormat]]s 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 'readable' boolean field to the table passed into [[love.graphics.newCanvas]].
 
* Added variant of [[love.graphics.getCanvasFormats]] which takes a 'readable' boolean.
 
* Added variant of [[love.graphics.getCanvasFormats]] which takes a 'readable' boolean.
Line 62: Line 67:
 
* Added [[Shader:send]] variants which accept a [[Data]] object.
 
* Added [[Shader:send]] variants which accept a [[Data]] object.
 
* Added 'borderellipse' and 'borderrectangle' [[ParticleSystem]] distributions.
 
* Added 'borderellipse' and 'borderrectangle' [[ParticleSystem]] distributions.
* Added [[ParticleSystem:setAreaSpreadAngle]], [[ParticleSystem:getAreaSpreadAngle]], [[ParticleSystem:setAreaSpreadIsRelativeDirection]], and [[ParticleSystem:getAreaSpreadIsRelativeDirection]].
+
* 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 [[love.graphics.captureScreenshot]] (replaces [[love.graphics.newScreenshot]]).
 
* Added 'glsl3', 'instancing', 'fullnpot','pixelshaderhighp', and 'shaderderivatives' [[GraphicsFeature]]s.
 
* Added 'glsl3', 'instancing', 'fullnpot','pixelshaderhighp', and 'shaderderivatives' [[GraphicsFeature]]s.
Line 81: Line 86:
 
* Renamed [[love.window.getPixelScale]] to [[love.window.getDPIScale]].
 
* Renamed [[love.window.getPixelScale]] to [[love.window.getDPIScale]].
 
* Renamed [[love.mouse.hasCursor]] to [[love.mouse.isCursorSupported]].
 
* 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 [[love.errhand]] to [[love.errorhandler]]. If love.errhand is defined and love.errorhandler isn't, it will continue to work.
 
* Renamed [[Source:getChannels|Source]]/[[SoundData:getChannels|SoundData]]/[[Decoder:getChannels]] to [[Source:getChannelCount|Source]]/[[SoundData:getChannelCount|SoundData]]/[[Decoder:getChannelCount]].
 
* Renamed [[Source:getChannels|Source]]/[[SoundData:getChannels|SoundData]]/[[Decoder:getChannels]] to [[Source:getChannelCount|Source]]/[[SoundData:getChannelCount|SoundData]]/[[Decoder:getChannelCount]].
 
* Renamed [[PrismaticJoint:hasLimitsEnabled]] and [[RevoluteJoint:hasLimitsEnabled]] to [[PrismaticJoint:areLimitsEnabled]] and [[RevoluteJoint:areLimitsEnabled]].
 
* Renamed [[PrismaticJoint:hasLimitsEnabled]] and [[RevoluteJoint:hasLimitsEnabled]] to [[PrismaticJoint:areLimitsEnabled]] and [[RevoluteJoint:areLimitsEnabled]].
 
* Renamed [[love.audio.getSourceCount]] to [[love.audio.getActiveSourceCount]].
 
* Renamed [[love.audio.getSourceCount]] to [[love.audio.getActiveSourceCount]].
* Renamed [[love.math.compress]] and [[love.math.decompress]] to [[love.data.compress]] and [[love.data.decompress]], and updated the argument order.
 
 
* Renamed all get[Object]List functions to get[Object]s.
 
* Renamed all get[Object]List functions to get[Object]s.
  
Line 91: Line 96:
 
=== Other Deprecations ===
 
=== Other Deprecations ===
 
* Deprecated [[love.filesystem.exists]] / [[love.filesystem.isFile|isFile]] / [[love.filesystem.isDirectory|isDirectory]] / [[love.filesystem.isSymlink|isSymlink]] / [[love.filesystem.getLastModified|getLastModified]] / [[love.filesystem.getSize|getSize]] (use [[love.filesystem.getInfo]] instead).
 
* Deprecated [[love.filesystem.exists]] / [[love.filesystem.isFile|isFile]] / [[love.filesystem.isDirectory|isDirectory]] / [[love.filesystem.isSymlink|isSymlink]] / [[love.filesystem.getLastModified|getLastModified]] / [[love.filesystem.getSize|getSize]] (use [[love.filesystem.getInfo]] instead).
 +
* Deprecated [[love.math.compress]] / [[love.math.decompress|decompress]] (use [[love.data.compress]] / [[love.data.decompress|decompress]] instead).
  
  
Line 143: Line 149:
  
 
* Updated and improved command line argument handling.
 
* 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 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 [[Source:seek]] to work if the [[Source]] isn't playing.
Line 163: Line 172:
 
* Fixed an error in the default [[love.errhand|error handler]] when the error message contains non UTF-8 bytes.
 
* Fixed an error in the default [[love.errhand|error handler]] when the error message contains non UTF-8 bytes.
 
* Fixed a memory leak when sending love [[Object]]s to threads which never load that object's module.
 
* Fixed a memory leak when sending love [[Object]]s 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 os.execute always returning -1 in Linux.
 
* Fixed the default reference angle for [[WeldJoint]], [[PrismaticJoint]], and [[RevoluteJoint]].
 
* Fixed the default reference angle for [[WeldJoint]], [[PrismaticJoint]], and [[RevoluteJoint]].

Revision as of 03:11, 21 January 2018

O.png The information on this page may not be accurate or up to date due to the information pertaining to a version that is currently in development.  

The codename for LÖVE 0.11.0 is not yet announced. It is currently not released.

Changes from 0.10.2

Additions


Renamed APIs

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


Other Deprecations


Removals


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.


Other changes

  • 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 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 '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 the love.audio playback APIs drastically.
  • 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 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.


Fixes