Difference between revisions of "11.0"
m |
m |
||
Line 116: | Line 116: | ||
** [[love.graphics.points]]. | ** [[love.graphics.points]]. | ||
** [[ImageData:setPixel]], [[ImageData:getPixel]], and [[ImageData:mapPixel]]. | ** [[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 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 [[love.graphics.print]] and friends to ignore carriage returns. |
Revision as of 19:02, 12 November 2017
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.
Contents
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 gain, high gain, 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 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 click count argument to love.mousepressed and love.mousereleased.
- 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 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, 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 Array, Cubemap, and Volume TextureTypes, 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 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 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 variants of love.graphics.clear to control how the active depth and stencil buffers are cleared.
- 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, is_column_major, 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 ParticleSystem:setAreaSpreadAngle, ParticleSystem:getAreaSpreadAngle, ParticleSystem:setAreaSpreadIsRelativeDirection, and ParticleSystem: setAreaSpreadIsRelativeDirection.
- 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.
Renamed APIs
All renamed APIs in 0.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 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 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.
Other Deprecations
- Deprecated love.filesystem.exists / isFile / isDirectory / isSymlink / getLastModified / getSize (use love.filesystem.getInfo instead).
Removals
- Removed the default source type for love.audio.newSource.
- Removed variant of love.filesystem.newFileData which takes base64 data, use love.math.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 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).
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.
Other changes
- 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.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 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 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 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 luasocket to version 3.0rc1.
Fixes
- Fixed a memory leak when sending love Objects to threads which never load that object's module.
- 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 VaryingTexCoords and love_ScreenSize in shaders to be 'highp' in OpenGL ES, when supported.
- Fixed ParticleSystem:setParticleLifetime to error if a negative value is given.
- Fixed Video playback to work with a wider range of Ogg Theora files.
- Fixed Video seeking to be faster.
- Fixed error in default error handler when the error message contains non UTF-8 bytes.