Difference between revisions of "11.0"

m
m (No-game screen)
(12 intermediate revisions by 3 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 15: Line 14:
 
* Added audio [[Source:setEffect|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 37: Line 38:
 
* 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 and corresponding [[Texture]] APIs.
 
* 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 [[Canvas]]es with different texture types.
+
* 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]]).
Line 65: 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 81: 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 102: Line 104:
 
=== 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 116: 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 130: 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 161: Line 172:
 
* 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.
  
 
=== Performance Improvements ===
 
=== Performance Improvements ===

Revision as of 15:14, 7 April 2018

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

Retrieved from "http://love2d.org/w/index.php?title=11.0&oldid=21393"