Difference between revisions of "11.0"

m
m (Additions)
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{notice|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.}}
+
[[File:11.0-NoGame.png|thumb|no-game screen]]
 
+
The codename for LÖVE 11.0 is '''Mysterious Mysteries'''. It is currently '''<span style="color:#0000ff;">released</span>'''.
The codename for LÖVE 0.11.0 is not yet announced. It is currently '''<span style="color:#ff0000;">not released</span>'''.
+
  
 
== Changes from [[0.10.2]] ==
 
== Changes from [[0.10.2]] ==
Line 12: Line 11:
 
* Added [[love.audio.newQueueableSource|queueable audio Sources]].
 
* Added [[love.audio.newQueueableSource|queueable audio Sources]].
 
* Added [[RecordingDevice|microphone recording]] support.
 
* Added [[RecordingDevice|microphone recording]] support.
* Added low pass, high pass, and band pass [[Filter]]s to love.audio [[Source]]s.
+
* Added low pass, high pass, and band pass [[Source:setFilter|filters]] to love.audio [[Source]]s.
* Added audio [[Effect]] APIs (reverb, echo, etc.)
+
* Added audio [[Source:setEffect|effect]] APIs (reverb, echo, etc.)
 
* Added variants of [[SoundData:getSample]] and [[SoundData:setSample]] which take a channel index parameter.
 
* 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 [[Source]]s.
 +
* 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 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.
Line 36: Line 37:
 
* 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 [[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 and corresponding [[Texture]] APIs.
 +
* Added  [[love.graphics.newArrayImage]], [[love.graphics.newVolumeImage|newVolumeImage]], [[love.graphics.newCubeImage|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 [[love.graphics.getTextureTypes]], which returns a table with fields indicating support for each [[TextureType]].
 
* Added [[(Image):replacePixels|Image:replacePixels]] (replaces [[(Image):refresh|Image:refresh]]).
 
* Added [[(Image):replacePixels|Image:replacePixels]] (replaces [[(Image):refresh|Image:refresh]]).
 
* Added [[love.graphics.drawLayer]], [[SpriteBatch:addLayer]], and [[SpriteBatch:setLayer]] for easily drawing layers of [[TextureType|Array Textures]]
 
* Added [[love.graphics.drawLayer]], [[SpriteBatch:addLayer]], and [[SpriteBatch:setLayer]] for easily drawing layers of [[TextureType|Array Textures]]
* Added variants of [[love.graphics.print]] and [[love.graphics.printf]] which take a [[Font]] argument..
+
* Added variants of [[love.graphics.print]] and [[love.graphics.printf]] which take a [[Font]] argument.
 
* 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.
Line 64: Line 66:
 
* Added [[Shader:hasUniform]] (replaces [[Shader:getExternVariable]]).
 
* Added [[Shader:hasUniform]] (replaces [[Shader:getExternVariable]]).
 
* Added support for non-square [[Shader]] uniform matrices on desktop platforms and on mobile GLSL 3.
 
* 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]](matrixname, matrixlayout, matrix, ...) which specifies how to interpret the matrix table arguments.
 
* 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.
Line 80: Line 82:
 
* Added [[love.window.isMinimized]].
 
* Added [[love.window.isMinimized]].
 
* Added [[love.window.restore]].
 
* Added [[love.window.restore]].
 
+
* Added support for header-less DEFLATE to [[love.data.compress]]/[[love.data.decompress|decompress]].
  
 
=== Renamed APIs ===
 
=== Renamed APIs ===
All renamed APIs in 0.11.0 are deprecated rather than removed, until the next major release.
+
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.window.getPixelScale]] to [[love.window.getDPIScale]].
 
* Renamed [[love.mouse.hasCursor]] to [[love.mouse.isCursorSupported]].
 
* Renamed [[love.mouse.hasCursor]] to [[love.mouse.isCursorSupported]].
Line 101: Line 103:
 
=== Removals ===
 
=== Removals ===
 
* Removed the default source type for [[love.audio.newSource]].
 
* 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|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 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 the no-argument variant of [[Text:set]], use [[Text:clear]] instead.
Line 108: Line 113:
 
* Removed [[Shader:getExternVariable]], use [[Shader:hasUniform]] instead.
 
* Removed [[Shader:getExternVariable]], use [[Shader:hasUniform]] instead.
 
* Removed [[love.graphics.newScreenshot]], use [[love.graphics.captureScreenshot]] 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 deprecated [[enet]] function host:socket_get_address.
 
* Removed functions deprecated in LÖVE 0.10.2:
 
* Removed functions deprecated in LÖVE 0.10.2:
Line 115: Line 121:
  
 
=== Other changes ===
 
=== 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:
 
* 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]].
 
** [[love.graphics.setColor]], [[love.graphics.getColor]], [[love.graphics.setBackgroundColor]], and [[love.graphics.getBackgroundColor]].
 
** [[SpriteBatch:setColor]] and [[SpriteBatch:getColor]].
 
** [[SpriteBatch:setColor]] and [[SpriteBatch:getColor]].
 
** [[ParticleSystem:setColors]] and [[ParticleSystem:getColors]].
 
** [[ParticleSystem:setColors]] and [[ParticleSystem:getColors]].
 +
** [[love.graphics.clear]].
 
** [[love.graphics.newMesh]], [[Mesh:setVertex]], and [[Mesh:getVertex]].
 
** [[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]].
 
** The colored text variants of [[love.graphics.print]], [[love.graphics.printf]], [[love.graphics.newText]], [[Text:set]], [[Text:setf]], [[Text:add]], and [[Text:addf]].
Line 129: Line 137:
 
* Changed [[love.graphics.print]] and friends to ignore carriage returns.
 
* 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 '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 [[TextureType|type]] or has mipmaps.
 
* Changed some [[love.graphics]], [[love.window]], and [[love.event]] APIs to cause an error if a [[Canvas]] is active.
 
* 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 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 [[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 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 [[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]]s 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|love.audio.pause()]] to return a list of [[Source]]s that have been paused by that call.
 
* Changed [[Source]] seeking behaviour, all kinds of Sources now behave similarly when seeking past the boundaries.
 
* 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.timer.step]] to return the calculated delta time.
Line 149: Line 161:
 
* Updated [[love.math.random]] to have improved numeric distribution.
 
* Updated [[love.math.random]] to have improved numeric distribution.
 
* Updated [[love.graphics]] to support Core Profile OpenGL 3.3+ when available.
 
* Updated [[love.graphics]] to support Core Profile OpenGL 3.3+ when available.
 +
* Updated [[SpriteBatch]]es to automatically grow their buffer when they run out of space.
 
* Updated [[Shader]]s to always expose derivative functions (dFdx, dFdy, fwidth) when available in OpenGL ES.
 
* Updated [[Shader]]s to always expose derivative functions (dFdx, dFdy, fwidth) when available in OpenGL ES.
 
* Updated [[Shader]]s to allow using VERTEX and PIXEL as variable names in shader code.
 
* Updated [[Shader]]s to allow using VERTEX and PIXEL as variable names in shader code.
Line 160: Line 173:
 
* Updated [[love.filesystem.setRequirePath]] to support multiple template '?' characters in each path.
 
* Updated [[love.filesystem.setRequirePath]] to support multiple template '?' characters in each path.
 
* Updated [[socket|luasocket]] to version 3.0rc1.
 
* Updated [[socket|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.
  
  
Line 193: Line 208:
  
 
[[Category:Versions]]
 
[[Category:Versions]]
 +
{{#set:InternalVersion=110}}
 +
{{#set:Codename=Mysterious Mysteries}}
 +
{{#set:Status=<span style="color:#0000ff;">Released</span>}}
 +
{{#set:ReleaseDate=2018-04-01}}

Latest revision as of 12:25, 17 December 2019

no-game screen

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

Changes from 0.10.2

Additions

Renamed APIs

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


Other Deprecations


Removals


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