Difference between revisions of "12.0"

m
 
(27 intermediate revisions by 5 users not shown)
Line 3: Line 3:
 
The codename for LÖVE 12.0 is TBD. It is currently '''<span style="color:#ff0000;">not released</span>'''.
 
The codename for LÖVE 12.0 is TBD. It is currently '''<span style="color:#ff0000;">not released</span>'''.
  
−
== Changes from [[11.4]] ==
+
== Changes from [[11.5]] ==
  
 
=== Additions ===
 
=== Additions ===
 
'''General'''
 
'''General'''
 
* Added support for launching a specific .lua file as the main file.
 
* Added support for launching a specific .lua file as the main file.
 +
* Added basic usage instructions printed to the console when '--help' is used as a command-line parameter, and when the no-game screen is run.
 
* Added [[love.parsedGameArguments]] and [[love.rawGameArguments]] tables, in the main thread.
 
* Added [[love.parsedGameArguments]] and [[love.rawGameArguments]] tables, in the main thread.
 
* Added [[love.markDeprecated]].
 
* Added [[love.markDeprecated]].
Line 13: Line 14:
 
* Added [[love.system.getPreferredLocales]].
 
* Added [[love.system.getPreferredLocales]].
 
* Added [[love.localechanged]] callback.
 
* Added [[love.localechanged]] callback.
−
* Added [[love.dropbegan]] and [[love.dropcompleted]] callbacks.
 
 
* Added t.highdpi startup flag in [[love.conf]], replacing t.window.highdpi and the highdpi flag of [[love.window.setMode]].
 
* Added t.highdpi startup flag in [[love.conf]], replacing t.window.highdpi and the highdpi flag of [[love.window.setMode]].
 
* Added support for highdpi mode in Windows.
 
* Added support for highdpi mode in Windows.
−
* Added [[HTTPS]] Lua module.
+
* Added [[love.window.focus]].
 +
* Added [[love.window.getPointer]].
 +
* Added [[lua-https|HTTPS]] Lua module.
 +
* Added variants of enet's [[enet.peer:send|peer:send]] and [[enet.host:broadcast|host:broadcast]] methods that take light userdata and size parameters.
 +
* Added support in love [[Object]]s for Lua 5.4's '<toclose>' syntax, when love is compiled with Lua 5.4.
 +
 
 +
 
 +
''' Data '''
 +
* Added [[Data]] methods for getting number values.
 +
* Added [[ByteData]] methods for setting number values.
 +
* Added optional byte offset and size parameters to [[Data:getString]].
 +
* Added [[ByteData:setString]].
 +
* Added a variant of [[love.data.pack]] which takes an existing [[ByteData]] object.
  
  
Line 23: Line 35:
 
* Added [[love.filesystem.mountCommonPath]], [[love.filesystem.unmountCommonPath|unmountCommonPath]], and [[love.filesystem.getFullCommonPath|getFullCommonPath]].
 
* Added [[love.filesystem.mountCommonPath]], [[love.filesystem.unmountCommonPath|unmountCommonPath]], and [[love.filesystem.getFullCommonPath|getFullCommonPath]].
 
* Added 'readonly' field to [[love.filesystem.getInfo]]'s returned table.
 
* Added 'readonly' field to [[love.filesystem.getInfo]]'s returned table.
−
* Added an optional load mode parameter to [[love.filesystem.load]]=] to only allow binary chunks, text chunks, or both.
+
* Added an optional load mode parameter to [[love.filesystem.load]] to only allow binary chunks, text chunks, or both.
 
* Added [[love.filesystem.openFile]] (replaces [[love.filesystem.newFile]]).
 
* Added [[love.filesystem.openFile]] (replaces [[love.filesystem.newFile]]).
  
Line 36: Line 48:
  
 
''' Input '''
 
''' Input '''
 +
* Added a [[love.sensor]] module, for getting data from device sensors such as an accelerometer or gyroscope.
 +
* Added [[love.sensorupdated]] callback.
 +
* Added [[love.joysticksensorupdated]] callback.
 +
* Added [[Joystick:hasSensor]].
 +
* Added [[Joystick:setSensorEnabled]] and [[Joystick:isSensorEnabled]].
 +
* Added [[Joystick:getSensorData]].
 
* Added [[Joystick:setPlayerIndex]] and [[Joystick:getPlayerIndex]].
 
* Added [[Joystick:setPlayerIndex]] and [[Joystick:getPlayerIndex]].
 +
* Added [[Joystick:getJoystickType]].
 
* Added [[Joystick:getGamepadType]].
 
* Added [[Joystick:getGamepadType]].
 
* Added new [[GamepadButton|Gamepad API buttons]]: "misc1", "paddle1", "paddle2", "paddle3", "paddle4". and "touchpad".
 
* Added new [[GamepadButton|Gamepad API buttons]]: "misc1", "paddle1", "paddle2", "paddle3", "paddle4". and "touchpad".
 
* Added [[love.keyboard.isModifierActive]].
 
* Added [[love.keyboard.isModifierActive]].
 +
* Added parameters to [[love.wheelmoved]]: precise X and Y movement numbers, and a direction enum.
 +
* Added [[love.mouse.getGlobalPosition]].
  
  
Line 47: Line 68:
  
 
''' Physics '''
 
''' Physics '''
−
* Added [[World:getFixturesInArea]].
+
* Added [[World:rayCastAny]] and [[World:rayCastClosest]].
 +
* Added [[World:getShapesInArea]].
 +
* Added [[World:queryShapesInArea]] (replaces [[World:queryBoundingBox]]).
 +
* Added [[Body:getShapes]] (replaces [[Body:getFixtures]]).
 +
* Added [[Body:getShape]] convenience method.
 +
* Added [[Contact:getShapes]] (replaces [[Contact:getFixtures]]).
 +
* Added [[Body:hasCustomMassData]].
 +
* Added convenience functions for creating a [[Body]] and [[Shape]] together:
 +
** Added [[love.physics.newCircleBody]].
 +
** Added [[love.physics.newRectangleBody]].
 +
** Added [[love.physics.newPolygonBody]].
 +
** Added [[love.physics.newEdgeBody]].
 +
** Added [[love.physics.newChainBody]].
 +
* Any joint that used to use spring-dampers now use stiffness and damping. The following functions have been added to support the old behaviour.
 +
** Added [[love.physics.computeLinearStiffness]].
 +
** Added [[love.physics.computeLinearFrequency]].
 +
** Added [[love.physics.computeAngularStiffness]].
 +
** Added [[love.physics.computeAngularFrequency]].
  
  
Line 55: Line 93:
 
* Added '--renderers a,b,c' and '--excluderenderers a,b,c' command line arguments.
 
* Added '--renderers a,b,c' and '--excluderenderers a,b,c' command line arguments.
 
* Added t.renderers and t.excluderenderers [[love.conf]] options.
 
* Added t.renderers and t.excluderenderers [[love.conf]] options.
 +
 +
 
* Added per-shader opt in support for the GLSL 4.30 (desktop) and GLSL ES 3.20 (mobile) shading languages, via <code>#pragma language glsl4</code>.
 
* Added per-shader opt in support for the GLSL 4.30 (desktop) and GLSL ES 3.20 (mobile) shading languages, via <code>#pragma language glsl4</code>.
 +
* Added new lower level 'vertexmain' and 'pixelmain' shader entry points.
 +
* Added ability to set point size within a vertex shader by setting the 'love_PointSize' variable.
 +
* Added [[Shader|Compute Shader]] support via [[love.graphics.newComputeShader]] and a new 'computemain' shader entry point.
 +
* Added [[love.graphics.dispatchThreadgroups]] and [[love.graphics.dispatchIndirect]] for running compute shaders.
 +
* Added [[Shader:hasStage]].
 +
* Added [[love.graphics.drawFromShader]].
 +
* Added [[love.graphics.drawFromShaderIndirect]].
 +
* Added [[love.graphics.drawIndirect]].
 +
 +
 
* Added [[love.graphics.newTexture]]. [[love.graphics.newImage|newImage]] and [[love.graphics.newCanvas|newCanvas]] still exist as convenience constructor functions.
 
* Added [[love.graphics.newTexture]]. [[love.graphics.newImage|newImage]] and [[love.graphics.newCanvas|newCanvas]] still exist as convenience constructor functions.
 +
* Added optional 'mipmapcount' field to the settings table in [[love.graphics.newTexture]]/[[love.graphics.newImage|newImage]]/[[love.graphics.newCanvas|newCanvas]].
 +
* Added optional 'computewrite' boolean field to the settings table in [[love.graphics.newTexture]]/[[love.graphics.newImage|newImage]]/[[love.graphics.newCanvas|newCanvas]].
 
* Added [[love.graphics.getTextureFormats]], which replaces [[love.graphics.getImageFormats|getImageFormats]] and [[love.graphics.getCanvasFormats|getCanvasFormats]].
 
* Added [[love.graphics.getTextureFormats]], which replaces [[love.graphics.getImageFormats|getImageFormats]] and [[love.graphics.getCanvasFormats|getCanvasFormats]].
 +
* Added [[Texture:isCanvas]] and [[Texture:isComputeWritable]].
 +
* Added [[Texture:isFormatLinear]], [[Texture:getMSAA]], [[Texture:generateMipmaps]], [[Texture:replacePixels]], and [[Texture:renderTo]] (moved from old Canvas and Image subclasses).
 +
* Added [[love.graphics.newTextureView]].
 +
* Added optional 'viewformats' field to the settings table in [[Texture]] constructors.
 +
* Added [[Texture:getViewFormats]].
 
* Added integer [[PixelFormat|pixel formats]] for [[Texture]]s and [[ImageData]].
 
* Added integer [[PixelFormat|pixel formats]] for [[Texture]]s and [[ImageData]].
−
* Added Graphics [[Buffer]] objects, including vertex, index, texel, and shader storage buffers.
+
* Added explicit sRGB format enums for compressed texture [[PixelFormat|pixel formats]].
 +
* Added [[ImageData:setLinear]], [[CompressedImageData:setLinear]], [[ImageData:isLinear]], and [[CompressedImageData:isLinear]].
 +
 
 +
 
 +
* Added [[GraphicsBuffer|Graphics Buffer]] objects, including vertex, index, texel, shader storage, and indirect draw/dispatch argument buffers.
 
* Added [[love.graphics.copyBuffer]], [[love.graphics.copyBufferToTexture|copyBufferToTexture]], and [[love.graphics.copyTextureToBuffer|copyTextureToBuffer]].
 
* Added [[love.graphics.copyBuffer]], [[love.graphics.copyBufferToTexture|copyBufferToTexture]], and [[love.graphics.copyTextureToBuffer|copyTextureToBuffer]].
−
* Added APIs for interacting with the [[Buffer]] objects owned by [[Mesh]]es.
+
* Added APIs for interacting with the [[GraphicsBuffer|Buffer]] objects owned by [[Mesh]]es.
 +
* Added variants of [[love.graphics.newMesh]] to construct a [[Mesh]] from existing [[GraphicsBuffer|Buffer]]s.
 
* Added [[Mesh:getAttachedAttributes]].
 
* Added [[Mesh:getAttachedAttributes]].
 +
* Added an optional start array index parameter to [[Mesh:attachAttribute]].
 
* Added integer [[BufferDataFormat|buffer data formats]].
 
* Added integer [[BufferDataFormat|buffer data formats]].
−
* Added [[love.graphics.readbackTexture]] and [[love.graphics.readbackTextureAsync]] (replaces [[Texture:newImageData]]).
+
* Added [[love.graphics.getQuadIndexBuffer]].
 +
 
 +
 
 +
* Added [[love.graphics.readbackTexture]] and [[love.graphics.readbackTextureAsync]] (replaces [[Canvas:newImageData]]).
 
* Added [[love.graphics.readbackBuffer]] and [[love.graphics.readbackBufferAsync]].
 
* Added [[love.graphics.readbackBuffer]] and [[love.graphics.readbackBufferAsync]].
 
* Added 'readback' [[BufferDataUsage|buffer data usage enum]], useful for advanced memory optimization when using [[love.graphics.readbackBuffer]].
 
* Added 'readback' [[BufferDataUsage|buffer data usage enum]], useful for advanced memory optimization when using [[love.graphics.readbackBuffer]].
−
* Added new lower level 'vertexmain' and 'pixelmain' shader entry points.
+
* Added debugname fields in the settings tables for [[Texture]]s, [[GraphicsBuffer|Buffer]]s, and [[Shader]]s.
−
* Added [[Shader|Compute Shader]] support via new 'computemain' shader entry point.
+
* Added [[Texture:getDebugName]] and [[Shader:getDebugName]].
−
* Added [[love.graphics.dispatchThreadgroups]] for running compute shaders.
+
 
−
* Added [[Shader:hasStage]].
+
 
−
* Added [[love.graphics.drawShaderVertices]].
 
−
* Added [[love.graphics.getQuadIndexBuffer]].
 
 
* Added variants of [[love.graphics.applyTransform]] and [[love.graphics.replaceTransform|replaceTransform]] which accept x,y,angle,sx,sy,ox,oy parameters.
 
* Added variants of [[love.graphics.applyTransform]] and [[love.graphics.replaceTransform|replaceTransform]] which accept x,y,angle,sx,sy,ox,oy parameters.
−
* Added APIs to override the default orthographic projection: [[love.graphics.setOrthoProjection]], [[love.graphics.setPerspectiveProjection|setPerspectiveProjection]], and [[love.graphics.resetProjection|resetProjection]].
+
* Added APIs to override the default orthographic projection: [[love.graphics.setProjection]] and [[love.graphics.resetProjection|resetProjection]].
−
* Added ability to set point size within a vertex shader by setting the 'love_PointSize' variable.
 
 
* Added [[love.graphics.setBlendState]], which gives lower level control over blend operations than [[love.graphics.setBlendMode]].
 
* Added [[love.graphics.setBlendState]], which gives lower level control over blend operations than [[love.graphics.setBlendMode]].
−
* Added [[love.graphics.setStencilMode]] and [[love.graphics.getStencilMode|getStencilMode]]. Replaces [[love.graphics.stencil]] as well as [[love.graphics.setStencilTest]].
+
* Added high level [[love.graphics.setStencilMode]] and [[love.graphics.getStencilMode|getStencilMode]] functions. Replaces [[love.graphics.stencil]] and [[love.graphics.setStencilTest]].
 +
* Added lower level [[love.graphics.setStencilState]] and [[love.graphics.getStencilState]] functions.
 
* Added a variant of [[love.graphics.setColorMask]] which accepts a single boolean.
 
* Added a variant of [[love.graphics.setColorMask]] which accepts a single boolean.
 
* Added new 'clampone' [[WrapMode]].
 
* Added new 'clampone' [[WrapMode]].
 +
* Added 'clampone', 'texelbuffer', 'indexbuffer32bit', 'mipmaprange', and 'indirectdraw' [[GraphicsFeature]] enums.
 +
* Added 'copybuffer', 'copybuffertotexture', 'copytexturetobuffer', and 'copyrendertargettobuffer' [[GraphicsFeature]] enums.
 +
* Added 'buffers' and 'buffermemory' fields to the table returned by [[love.graphics.getStats]].
 +
* Added initial support for right-to-left (RTL) text when using TrueType and OpenType fonts.
 
* Added a variant of [[Font:getWidth]] which takes a codepoint number argument.
 
* Added a variant of [[Font:getWidth]] which takes a codepoint number argument.
 +
* Added optional settings table variants for [[love.graphics.newFont]], [[love.font.newRasterizer]], and [[love.font.newTrueTypeRasterizer]].
 +
* Added [[love.graphics.newTextBatch]] (renamed from [[love.graphics.newText]]).
 
* Added support for saving .exr image files via [[ImageData:encode]].
 
* Added support for saving .exr image files via [[ImageData:encode]].
  
  
 
=== Changes ===
 
=== Changes ===
 +
* Changed the primary build system for Linux to CMake instead of autotools.
 +
* Changed the minimum runtime macOS version to 10.15.
 +
* Changed the minimum runtime iOS version to 13.0.
 +
* Changed the minimum runtime Windows version to Windows 7 SP1 (64 bit).
 +
 +
 +
* Changed [[love.physics]] Shapes and Fixtures to be combined together, in [[Shape]] objects. Separate [[Fixture]]s no longer exist.
 +
* Changed [[love.physics.newCircleShape]], [[love.physics.newRectangleShape|newRectangleShape]], [[love.physics.newPolygonShape|newPolygonShape]], [[love.physics.newEdgeShape|newEdgeShape]], and [[love.physics.newChainShape|newChainShape]] to take a [[Body]] as their first parameter.
 +
* Changed [[love.physics]] callbacks that used to take [[Fixture]] parameters to now take [[Shape]] parameters.
 +
* Changed [[Shape:setDensity]] to no longer need [[Body:resetMassData]] afterward unless the Body already has custom mass data.
 +
* Changed the behaviour of attaching a [[Shape]] to a [[Body]] to no longer reset mass data if it's been customized.
 +
* Changed [[RevoluteJoint:getMotorTorque]] and [[WheelJoint:getMotorTorque]] to take 'dt' as a parameter instead of 'inverse_dt'.
 +
 +
 +
* Changed [[love.filesystem.exists]] to no longer be deprecated.
 +
* Changed [[love.data.hash]] to have a container type parameter.
 
* Changed the default font from Vera size 12 to Noto Sans size 13.
 
* Changed the default font from Vera size 12 to Noto Sans size 13.
 +
* Changed TrueType and OpenType font handling to have improved kerning and character combining support. 
 +
 +
 +
* [[love.textinput]] is now disabled by default due to upgrading to SDL3, which will mean you will need to use [[love.keyboard.setTextInput]] on all platforms now, not just mobile. 
 +
 +
 
* Changed the [[Texture]] class and implementation to no longer have separate [[Canvas]] and [[Image]] subclasses.
 
* Changed the [[Texture]] class and implementation to no longer have separate [[Canvas]] and [[Image]] subclasses.
 
* Changed [[Texture]]s created from image files and from [[ImageData]] to no longer hold onto a CPU copy of their pixel data after creation.
 
* Changed [[Texture]]s created from image files and from [[ImageData]] to no longer hold onto a CPU copy of their pixel data after creation.
 
* Changed [[love.graphics.newImage]] to error instead of loading a placeholder texture, when the image dimensions are too large for the system.
 
* Changed [[love.graphics.newImage]] to error instead of loading a placeholder texture, when the image dimensions are too large for the system.
 +
* Changed [[love.graphics.newImage]] to allow creating a mipmapped texture with less than the full mipmap range, instead of erroring.
 
* Changed [[love.graphics.newMesh]] to no longer default to the "fan" [[MeshDrawMode|Mesh draw mode]].
 
* Changed [[love.graphics.newMesh]] to no longer default to the "fan" [[MeshDrawMode|Mesh draw mode]].
 
* Changed the behaviour of [[Mesh]]es to no longer allow a vertex map or index buffer when the "fan" mesh draw mode is used.
 
* Changed the behaviour of [[Mesh]]es to no longer allow a vertex map or index buffer when the "fan" mesh draw mode is used.
−
* Changed [[love.window.setMode]] to no longer clear the contents of Canvases or otherwise recreate OpenGL resources.
+
* Changed love.graphics.draw(Mesh) to no longer error if the Mesh has no 'VertexPosition' attribute but does have custom vertex attributes.
 +
* Changed [[Mesh:getVertexFormat]] to use named fields, to match the new vertex format parameter setup in [[love.graphics.newMesh]].
 +
* Changed [[love.window.setMode]] to no longer clear the contents of Canvases or otherwise recreate graphics resources.
 +
* Changed [[love.graphics.rectangle]], [[love.graphics.polygon]], and other shape drawing APIs to provide texture coordinates to shaders, for filled shapes.
 
* Changed [[love.graphics.points]] to require 'love_PointSize' to be set in the vertex shader, if a custom shader is used.
 
* Changed [[love.graphics.points]] to require 'love_PointSize' to be set in the vertex shader, if a custom shader is used.
 +
* Changed [[love.graphics.setCanvas]] to always clear auto-generated temporary depth and stencil buffers when they're used.
 +
* Changed [[love.graphics.clear]] to no longer be affected by [[love.graphics.setScissor]] or [[love.graphics.setColorMask]].
 +
* Changed [[love.graphics.setDepthMode]] with the depth write parameter set to true to error if the active Canvases or window don't have a depth buffer.
 +
* Changed [[Shader]] code parsing to ignore shader entry point functions inside comments.
 +
* Changed position output coordinate space in vertex shaders to be consistent across all graphics APIs and regardless of whether a Canvas is active.
 +
** Clip-space output is y-up. Texture contents and pixel shader coordinates are y-down.
 +
 +
 
* Changed audio file decoding to choose the most appropriate decoder based on file contents instead of the file extension.
 
* Changed audio file decoding to choose the most appropriate decoder based on file contents instead of the file extension.
 
* Changed [[Video]]s to stream audio from the file instead of loading all the video file into memory for use with audio decoding.
 
* Changed [[Video]]s to stream audio from the file instead of loading all the video file into memory for use with audio decoding.
−
* Changed [[love.filesystem.exists]] to no longer be deprecated.
 
−
* Changed [[RevoluteJoint:getMotorTorque]] to take 'dt' as a parameter instead of 'inverse_dt'.
 
 
* Changed [[love.math.perlinNoise]] and [[love.math.simplexNoise]] to use higher precision numbers for its internal calculations.
 
* Changed [[love.math.perlinNoise]] and [[love.math.simplexNoise]] to use higher precision numbers for its internal calculations.
 +
* Changed the <code>t.accelerometerjoystick</code> [[love.conf]] flag to be unset by default.
 +
* Changed the window 'depth' field in [[love.conf]] and [[love.window.setMode]]/[[love.window.updateMode|updateMode]]/[[love.window.getMode|getMode]] to be a boolean instead of a bit count number.
 +
 +
 
* Renamed 'display' field to 'displayindex' in [[love.window.setMode]]/[[love.window.updateMode|updateMode]]/[[love.window.getMode|getMode]] and [[love.conf]].
 
* Renamed 'display' field to 'displayindex' in [[love.window.setMode]]/[[love.window.updateMode|updateMode]]/[[love.window.getMode|getMode]] and [[love.conf]].
−
* Updated Box2D from 2.3 to 2.4.1.
+
* Renamed love.graphics [[Text]] objects to [[TextBatch]].
 +
 
 +
 
 +
* Updated Box2D from 2.3 to [https://github.com/erincatto/box2d/blob/main/CHANGELOG.md#changes-for-version-241 2.4.1]
 
* Updated LuaSocket from 3.0-rc1 to 3.1.0.
 
* Updated LuaSocket from 3.0-rc1 to 3.1.0.
  
Line 105: Line 214:
 
=== Deprecations ===
 
=== Deprecations ===
 
* Deprecated usage of slashes instead of dots for module separators in require.
 
* Deprecated usage of slashes instead of dots for module separators in require.
 +
* Deprecated the <code>t.accelerometerjoystick</code> [[love.conf]] flag (replaced by the [[love.sensor]] module).
 
* Deprecated [[love.filesystem.newFile]] (replaced by [[love.filesystem.openFile]]).
 
* Deprecated [[love.filesystem.newFile]] (replaced by [[love.filesystem.openFile]]).
 
* Deprecated [[love.math.noise]] (replaced by [[love.math.perlinNoise]] and [[love.math.simplexNoise]]).
 
* Deprecated [[love.math.noise]] (replaced by [[love.math.perlinNoise]] and [[love.math.simplexNoise]]).
 +
* Deprecated the variants of [[love.physics.newCircleShape]], [[love.physics.newRectangleShape|newRectangleShape]], [[love.physics.newPolygonShape|newPolygonShape]], [[love.physics.newEdgeShape|newEdgeShape]], and [[love.physics.newChainShape|newChainShape]] that don't take a [[Body]] parameter.
 +
* Deprecated [[love.physics.newFixture]] (replaced by the new Shape constructor variants).
 +
* Deprecated [[Body:getFixtures]] (replaced by [[Body:getShapes]]).
 +
* Deprecated [[Contact:getFixtures]] (replaced by [[Contact:getShapes]]).
 +
* Deprecated [[World:queryBoundingBox]] (replaced by [[World:queryShapesInArea]]).
 +
* Deprecated [[ChainShape:getChildEdge]].
 +
* Deprecated the variants of [[love.data.hash]] which do not have a container type parameter.
 +
* Deprecated [[love.graphics.setNewFont]] (use [[love.graphics.newFont]] and [[love.graphics.setFont]] instead).
 +
* Deprecated [[love.graphics.newText]] (renamed to [[love.graphics.newTextBatch]]).
 
* Deprecated [[love.graphics.getImageFormats]] and [[love.graphics.getCanvasFormats]] (replaced by [[love.graphics.getTextureFormats]]).
 
* Deprecated [[love.graphics.getImageFormats]] and [[love.graphics.getCanvasFormats]] (replaced by [[love.graphics.getTextureFormats]]).
 +
* Deprecated [[love.graphics.stencil]] (replaced by [[love.graphics.setStencilMode]] or [[love.graphics.setStencilState]]).
 +
* Deprecated [[love.graphics.setStencilTest]] and [[love.graphics.getStencilTest]] (replaced by [[love.graphics.setStencilMode]] or [[love.graphics.setStencilState]]).
 +
* Deprecated [[love.window.close]].
 
* Deprecated t.window.highdpi in [[love.conf]] and the highdpi flag of [[love.window.setMode]] (replaced by t.highdpi in [[love.conf]]).
 
* Deprecated t.window.highdpi in [[love.conf]] and the highdpi flag of [[love.window.setMode]] (replaced by t.highdpi in [[love.conf]]).
−
* Deprecated the variants of [[Mesh:attachAttribute]] and [[SpriteBatch:attachAttribute]] which accept a [[Mesh]] (replaced by variants which accept a [[Buffer]]).
+
* Deprecated the variants of [[Mesh:attachAttribute]] and [[SpriteBatch:attachAttribute]] which accept a [[Mesh]] (replaced by variants which accept a [[GraphicsBuffer]]).
−
* Deprecated [[Texture:newImageData]] (replaced by [[love.graphics.readbackTexture]]).
+
* Deprecated [[Canvas:newImageData]] (replaced by [[love.graphics.readbackTexture]]).
  
  
 
=== Removals ===
 
=== Removals ===
 +
* Removed 32 bit Windows support for official builds.
 +
* Removed [[Fixture]] objects. All methods previously in Fixtures are now available in [[Shape]]s.
 
* Removed the variant of [[SpriteBatch:setColor]]() which turns off all previously set colors.
 
* Removed the variant of [[SpriteBatch:setColor]]() which turns off all previously set colors.
−
* Removed the no-argument variant of [[love.graphics.setColorMask]].
+
* Removed functions deprecated in LÖVE 11:
−
* Removed [[love.graphics.stencil]] (replaced by [[love.graphics.setStencilMode]]).
+
** Removed [[love.audio.getSourceCount]] (renamed to [[love.audio.getActiveSourceCount]]).
−
* Removed [[love.graphics.setStencilTest]] and [[love.graphics.getStencilTest]] (replaced by [[love.graphics.setStencilMode]] and [[love.graphics.getStencilMode]]).
+
** Removed [[Source:getChannels]] (renamed to [[Source:getChannelCount]]).
 +
** Removed [[Decoder:getChannels]] (renamed to [[Decoder:getChannelCount]]).
 +
** Removed [[love.filesystem.isDirectory]] (replaced by [[love.filesystem.getInfo]]).
 +
** Removed [[love.filesystem.isFile]] (replaced by [[love.filesystem.getInfo]]).
 +
** Removed [[love.filesystem.isSymlink]] (replaced by [[love.filesystem.getInfo]]).
 +
** Removed [[love.filesystem.getLastModified]] (replaced by [[love.filesystem.getInfo]]).
 +
** Removed [[love.filesystem.getSize]] (replaced by [[love.filesystem.getInfo]]).
 +
** Removed [[ParticleSystem:setAreaSpread]] and [[ParticleSystem:getAreaSpread]] (renamed to [[ParticleSystem:setEmissionArea]] and [[ParticleSystem:getEmissionArea]]).
 +
** Removed [[love.math.compress]] and [[love.math.decompress]] (replaced by [[love.data.compress]] and [[love.data.decompress]]).
 +
** Removed [[World:getBodyList]], [[World:getJointList]], and [[World:getContactList]] (renamed to [[World:getBodies]], [[World:getJoints]], and [[World:getContacts]]).
 +
** Removed [[Body:getFixtureList]], [[Body:getJointList]], and [[Body:getContactList]] (renamed to [[Body:getFixtures]], [[Body:getJoints]], and [[Body:getContacts]]).
 +
** Removed [[PrismaticJoint:hasLimitsEnabled]] (renamed to [[PrismaticJoint:areLimitsEnabled]]).
 +
** Removed [[RevoluteJoint:hasLimitsEnabled]] (renamed to [[RevoluteJoint:areLimitsEnabled]]).
  
  
 
=== Fixes ===
 
=== Fixes ===
 
* Fixed [[BezierCurve:render]] adding collinear points in some situations.
 
* Fixed [[BezierCurve:render]] adding collinear points in some situations.
−
* Fixed line rendering when the line has duplicate points.
 
 
* Fixed sound [[Decoder]]s to cause a Lua error instead of hard-crashing when memory for the decoding buffer can't be allocated.
 
* Fixed sound [[Decoder]]s to cause a Lua error instead of hard-crashing when memory for the decoding buffer can't be allocated.
−
* Fixed oversaturated colors on macOS when a P3-capable display is used.
 
  
  

Latest revision as of 17:30, 1 November 2024

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 12.0 is TBD. It is currently not released.

Changes from 11.5

Additions

General


Data


Filesystem


Audio


Input


Math


Physics


Graphics

  • Added a Metal backend to love.graphics, available on macOS 10.15+ and iOS 13+.
  • Added a Vulkan backend to love.graphics, available on Windows, Linux, and Android 7+.
  • Added '--renderers a,b,c' and '--excluderenderers a,b,c' command line arguments.
  • Added t.renderers and t.excluderenderers love.conf options.







Changes

  • Changed the primary build system for Linux to CMake instead of autotools.
  • Changed the minimum runtime macOS version to 10.15.
  • Changed the minimum runtime iOS version to 13.0.
  • Changed the minimum runtime Windows version to Windows 7 SP1 (64 bit).



  • Changed love.filesystem.exists to no longer be deprecated.
  • Changed love.data.hash to have a container type parameter.
  • Changed the default font from Vera size 12 to Noto Sans size 13.
  • Changed TrueType and OpenType font handling to have improved kerning and character combining support.



  • Changed the Texture class and implementation to no longer have separate Canvas and Image subclasses.
  • Changed Textures created from image files and from ImageData to no longer hold onto a CPU copy of their pixel data after creation.
  • Changed love.graphics.newImage to error instead of loading a placeholder texture, when the image dimensions are too large for the system.
  • Changed love.graphics.newImage to allow creating a mipmapped texture with less than the full mipmap range, instead of erroring.
  • Changed love.graphics.newMesh to no longer default to the "fan" Mesh draw mode.
  • Changed the behaviour of Meshes to no longer allow a vertex map or index buffer when the "fan" mesh draw mode is used.
  • Changed love.graphics.draw(Mesh) to no longer error if the Mesh has no 'VertexPosition' attribute but does have custom vertex attributes.
  • Changed Mesh:getVertexFormat to use named fields, to match the new vertex format parameter setup in love.graphics.newMesh.
  • Changed love.window.setMode to no longer clear the contents of Canvases or otherwise recreate graphics resources.
  • Changed love.graphics.rectangle, love.graphics.polygon, and other shape drawing APIs to provide texture coordinates to shaders, for filled shapes.
  • Changed love.graphics.points to require 'love_PointSize' to be set in the vertex shader, if a custom shader is used.
  • Changed love.graphics.setCanvas to always clear auto-generated temporary depth and stencil buffers when they're used.
  • Changed love.graphics.clear to no longer be affected by love.graphics.setScissor or love.graphics.setColorMask.
  • Changed love.graphics.setDepthMode with the depth write parameter set to true to error if the active Canvases or window don't have a depth buffer.
  • Changed Shader code parsing to ignore shader entry point functions inside comments.
  • Changed position output coordinate space in vertex shaders to be consistent across all graphics APIs and regardless of whether a Canvas is active.
    • Clip-space output is y-up. Texture contents and pixel shader coordinates are y-down.


  • Changed audio file decoding to choose the most appropriate decoder based on file contents instead of the file extension.
  • Changed Videos to stream audio from the file instead of loading all the video file into memory for use with audio decoding.
  • Changed love.math.perlinNoise and love.math.simplexNoise to use higher precision numbers for its internal calculations.
  • Changed the t.accelerometerjoystick love.conf flag to be unset by default.
  • Changed the window 'depth' field in love.conf and love.window.setMode/updateMode/getMode to be a boolean instead of a bit count number.



  • Updated Box2D from 2.3 to 2.4.1
  • Updated LuaSocket from 3.0-rc1 to 3.1.0.


Deprecations


Removals


Fixes

  • Fixed BezierCurve:render adding collinear points in some situations.
  • Fixed sound Decoders to cause a Lua error instead of hard-crashing when memory for the decoding buffer can't be allocated.



Retrieved from "https://love2d.org./w/index.php?title=12.0&oldid=29367"