Difference between revisions of "0.10.0"
m (Updated changelog) |
(Reorganized some changes) |
||
| Line 23: | Line 23: | ||
* Added optional x/y/width/height arguments to [[love.keyboard.setTextInput]]. They tell the system where text will show up so on-screen keyboards can avoid that area. | * Added optional x/y/width/height arguments to [[love.keyboard.setTextInput]]. They tell the system where text will show up so on-screen keyboards can avoid that area. | ||
* Added [[Source:getType]] (replaces [[Source:isStatic]].) | * Added [[Source:getType]] (replaces [[Source:isStatic]].) | ||
| + | * Added an optional string argument containing raw pixel data to the width/height variant of [[love.image.newImageData]]. | ||
* Added [[love.graphics.ellipse]]. | * Added [[love.graphics.ellipse]]. | ||
* Added rounded-rectangle support to [[love.graphics.rectangle]]. | * Added rounded-rectangle support to [[love.graphics.rectangle]]. | ||
| Line 60: | Line 61: | ||
* Added [[love.math.compress]] and [[love.math.decompress]]. | * Added [[love.math.compress]] and [[love.math.decompress]]. | ||
* Added [[Channel:performAtomic]]. | * Added [[Channel:performAtomic]]. | ||
| + | |||
| + | |||
| + | === Changed APIs === | ||
| + | * Changed [[love.mousepressed]], [[love.mousereleased]], and [[love.mouse.isDown]] to use button numbers instead of named button constants. | ||
| + | * Changed [[love.keypressed]] to be [[love.keypressed]](key, scancode, isrepeat). | ||
| + | * Changed [[love.keyreleased]] to be [[love.keyreleased]](key, scancode). | ||
| + | * Changed [[Font:getWrap]]'s second return value to be a table containing the text split into lines. | ||
| + | * Changed [[love.graphics.newImage]]'s optional second argument to be a table of flags (flags are "mipmaps" and "linear".) | ||
| + | * Changed the arguments for the standard variants of [[love.graphics.newMesh]]. They're now [[love.graphics.newMesh]](vertices [, drawmode, usage]) and [[love.graphics.newMesh]](vertexcount [, drawmode, usage]). | ||
| + | * Changed [[ImageData:encode]] to return a [[FileData]] object containing the encoded image. [[ImageData:encode]]'s first parameter is now the format to encode to, and the second parameter is an optional filename to write to. | ||
| + | |||
| + | |||
| + | === Renamed APIs === | ||
| + | * Renamed the [[FullscreenType|fullscreen type]] "normal" to "exclusive". | ||
| + | * Renamed the [[DistanceModel]] constants "inverse clamped", "linear clamped", and "exponent clamped" to "inverseclamped", "linearclamped", and "exponentclamped". | ||
| + | * Renamed [[BlendMode|blend modes]] "additive", "subtractive", and "multiplicative" to "add", "subtract", and "multiply". | ||
| + | * Renamed the [[KeyConstant|key constant]] and [[Scancode]] representing the spacebar from " " to "space". | ||
| + | * Renamed [[(File):eof|File:eof]] to [[(File):isEOF|File:isEOF]]. | ||
| + | * Renamed [[Canvas:getImageData]] to [[Canvas:newImageData]]. | ||
| + | * Renamed [[love.image]]'s [[CompressedData]] type to [[CompressedImageData]]. | ||
| + | |||
=== Removals === | === Removals === | ||
| Line 90: | Line 112: | ||
** Removed [[love.window.getWidth]] and [[love.window.getHeight]] (use [[love.graphics.getWidth]] and [[love.graphics.getHeight]] or [[love.window.getMode]] instead.) | ** Removed [[love.window.getWidth]] and [[love.window.getHeight]] (use [[love.graphics.getWidth]] and [[love.graphics.getHeight]] or [[love.window.getMode]] instead.) | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Bugfixes === | === Bugfixes === | ||
| Line 114: | Line 128: | ||
* Fixed [[love.graphics.shear]] resetting all love.graphics transformations. | * Fixed [[love.graphics.shear]] resetting all love.graphics transformations. | ||
* Fixed the "add" and "subtract" [[BlendMode]]s to no longer modify the alpha of the Canvas / screen. | * Fixed the "add" and "subtract" [[BlendMode]]s to no longer modify the alpha of the Canvas / screen. | ||
| + | |||
| + | |||
| + | === Performance improvements === | ||
| + | * Improved the performance of [[World:rayCast]] and [[World:queryBoundingBox]]. | ||
| + | * Improved the performance of [[love.graphics.line]] and other line drawing functions, when the "smooth" [[LineStyle]] is used. | ||
| + | * Improved the performance of [[ImageData]] and [[SoundData]] methods when LuaJIT's JIT compiler is enabled, by using efficient FFI code. | ||
| + | |||
=== Other changes === | === Other changes === | ||
| Line 119: | Line 140: | ||
* Updated the compatibility warning notice to display before main.lua is loaded. | * Updated the compatibility warning notice to display before main.lua is loaded. | ||
* Updated the __tostring metamethod of love objects to output the pointer value, similar to tostring(table). | * Updated the __tostring metamethod of love objects to output the pointer value, similar to tostring(table). | ||
| − | |||
| − | |||
| − | |||
* Updated [[World:setCallbacks]], [[World:setContactFilter]], [[World:queryBoundingBox]], and [[World:rayCast]] to have improved argument type checking. | * Updated [[World:setCallbacks]], [[World:setContactFilter]], [[World:queryBoundingBox]], and [[World:rayCast]] to have improved argument type checking. | ||
* Updated threads to load [[love.filesystem]] automatically. | * Updated threads to load [[love.filesystem]] automatically. | ||
| Line 129: | Line 147: | ||
* Updated [[love.graphics.newImageFont]] to no longer treat separator pixels as spacing. | * Updated [[love.graphics.newImageFont]] to no longer treat separator pixels as spacing. | ||
* Updated the default font to use less memory. | * Updated the default font to use less memory. | ||
| − | + | * Updated love.graphics color functions to automatically apply [[love.math.gammaToLinear]] to color values when gamma-correct rendering is enabled. | |
| − | * Updated love.graphics color functions to automatically apply [[love. | ||
* Updated the "normal" [[CanvasFormat]] to internally use "srgb" rather than "rgba8" when gamma-correct rendering is enabled. | * Updated the "normal" [[CanvasFormat]] to internally use "srgb" rather than "rgba8" when gamma-correct rendering is enabled. | ||
* Updated [[love.graphics.setColor]] to affect all drawn objects, including [[ParticleSystem]]s, [[SpriteBatch]]es, and [[Mesh]]es, even when per-vertex or per-sprite colors are used. | * Updated [[love.graphics.setColor]] to affect all drawn objects, including [[ParticleSystem]]s, [[SpriteBatch]]es, and [[Mesh]]es, even when per-vertex or per-sprite colors are used. | ||
| Line 136: | Line 153: | ||
* Updated the minimum runtime system requirements of LOVE to require OpenGL 2.1 or OpenGL ES 2 support. | * Updated the minimum runtime system requirements of LOVE to require OpenGL 2.1 or OpenGL ES 2 support. | ||
* Updated the [[love.graphics.newShader|pixel shader effect]] function so screen_coords.y is 0 at the top of the screen instead of the bottom. | * Updated the [[love.graphics.newShader|pixel shader effect]] function so screen_coords.y is 0 at the top of the screen instead of the bottom. | ||
| − | |||
| − | |||
| − | |||
* Updated [[Image]]s to require setting the mipmaps flag to true on creation in order to use mipmaps. | * Updated [[Image]]s to require setting the mipmaps flag to true on creation in order to use mipmaps. | ||
* Updated [[Image]]s to allow mipmaps for non-power-of-two sizes. | * Updated [[Image]]s to allow mipmaps for non-power-of-two sizes. | ||
| − | |||
| − | |||
| − | |||
[[Category:Versions]] | [[Category:Versions]] | ||
Revision as of 15:01, 15 August 2015
|
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.10.0 is not yet announced. It is currently not released.
Contents
Changes from 0.9.2
Additions
- Added an iOS port.
- Added an Android port.
- Added the flag t.accelerometerjoystick to love.conf. Disables accelerometer-as-joystick functionality on mobile devices when false.
- Added the flag t.gammacorrect to love.conf (replaces t.window.srgb.) Enabling it globally enables gamma-correct rendering, when supported.
- Added love.touch module. Note that it has important differences from the touch implementation in the LÖVE 0.9.2 Android and iOS ports.
- Added love.touch.getPosition
- Added love.touch.getTouches
- Added love.touchpressed, love.touchreleased, and love.touchmoved.
- Added love.system.vibrate.
- Added love.filesystem.setRequirePath and love.filesystem.getRequirePath.
- Added love.filedropped and love.directorydropped event callback functions.
- Added love.lowmemory event callback function, called when the app is running out of memory on mobile operating systems.
- Added love.textedited event callback function, called when the user is compositing text (e.g. via an IME.)
- Added love.wheelmoved event callback function (replaces "wu" and "wd" constants for love.mousepressed.)
- Added love.mouse.hasCursor.
- Added a boolean argument to love.mousepressed and love.mousereleased indicating whether the button event originated from a touch press.
- Added optional x/y/width/height arguments to love.keyboard.setTextInput. They tell the system where text will show up so on-screen keyboards can avoid that area.
- Added Source:getType (replaces Source:isStatic.)
- Added an optional string argument containing raw pixel data to the width/height variant of love.image.newImageData.
- Added love.graphics.ellipse.
- Added rounded-rectangle support to love.graphics.rectangle.
- Added an optional boolean argument to love.graphics.setBlendMode which indicates whether the blend mode should multiply alpha with rgb for the source color. It is true by default.
- Added a new built-in shader variable: "mat3 NormalMatrix".
- Added love.graphics.getSupported (replaces love.graphics.isSupported.)
- Added love.graphics.getSystemLimits (replaces love.graphics.getSystemLimit.)
- Added love.graphics.stencil and love.graphics.setStencilTest (replaces love.graphics.setStencil.)
- Added love.graphics.isActive.
- Added color arguments to love.graphics.clear. It no longer always uses the background color value.
- Added love.graphics.discard.
- Added love.graphics.isGammaCorrect
- Added the ability to specify custom mipmaps when creating an image, via love.graphics.newImage(filename, {mipmaps={mip1, mip2, ...}}).
- Added optional x/y/width/height arguments to Image:refresh and Canvas:newImageData.
- Added Image:getFlags.
- Added one- and two-channel Canvas formats: r8, rg8, r16f, rg16f, r32f, and rg32f.
- Added support for different formats in each Canvas when using multi-canvas rendering. Added the "multicanvasformats" GraphicsFeature constant.
- Added support for OpenGL ES 2 and 3.
- Added support for loading ETC1/2, EAC, and PVRTC1 compressed textures.
- Added custom vertex attribute support for Meshes via new variants of love.graphics.newMesh.
- Added Mesh:setVertexAttribute and Mesh:getVertexAttribute, Mesh:getVertexFormat, and Mesh:flush.
- Added Mesh:setAttributeEnabled and Mesh:isAttributeEnabled.
- Added Mesh:attachAttribute.
- Added Shader:sendColor.
- Added new shader functions: gammaCorrectColor, gammaToLinear, and linearToGamma. The functions also have 'precise' and 'fast' variants.
- Added Text objects and love.graphics.newText.
- Added BMFont bitmap font file support to love.graphics.newFont and love.font.
- Added kerning support for TrueType/OpenType and BMFont Fonts.
- Added an optional font hinting argument to love.graphics.newFont when loading TrueType fonts.
- Added an optional spacing argument to love.graphics.newImageFont, which applies additional spacing to all rendered glyphs.
- Added Font:setFallbacks.
- Added love.window.maximize.
- Added love.window.close.
- Added love.window.requestAttention.
- Added BezierCurve:renderSegment and BezierCurve:removePoint.
- Added BezierCurve:getSegment.
- Added love.math.compress and love.math.decompress.
- Added Channel:performAtomic.
Changed APIs
- Changed love.mousepressed, love.mousereleased, and love.mouse.isDown to use button numbers instead of named button constants.
- Changed love.keypressed to be love.keypressed(key, scancode, isrepeat).
- Changed love.keyreleased to be love.keyreleased(key, scancode).
- Changed Font:getWrap's second return value to be a table containing the text split into lines.
- Changed love.graphics.newImage's optional second argument to be a table of flags (flags are "mipmaps" and "linear".)
- Changed the arguments for the standard variants of love.graphics.newMesh. They're now love.graphics.newMesh(vertices [, drawmode, usage]) and love.graphics.newMesh(vertexcount [, drawmode, usage]).
- Changed ImageData:encode to return a FileData object containing the encoded image. ImageData:encode's first parameter is now the format to encode to, and the second parameter is an optional filename to write to.
Renamed APIs
- Renamed the fullscreen type "normal" to "exclusive".
- Renamed the DistanceModel constants "inverse clamped", "linear clamped", and "exponent clamped" to "inverseclamped", "linearclamped", and "exponentclamped".
- Renamed blend modes "additive", "subtractive", and "multiplicative" to "add", "subtract", and "multiply".
- Renamed the key constant and Scancode representing the spacebar from " " to "space".
- Renamed File:eof to File:isEOF.
- Renamed Canvas:getImageData to Canvas:newImageData.
- Renamed love.image's CompressedData type to CompressedImageData.
Removals
- Removed love.filesystem.exists (use love.filesystem.isFile or love.filesystem.isDirectory instead.)
- Removed callback variant of love.filesystem.getDirectoryItems
- Removed the "wu" and "wd" constants for love.mousepressed (replaced by love.wheelmoved.)
- Removed the named mouse button constants (replaced by button numbers.)
- Removed Source:isStatic (replaced by Source:getType.)
- Removed image loading support for all (non-compressed texture) file formats except for PNG, JPEG, TGA, and BMP.
- Removed JPEG encoding support from ImageData:encode.
- Removed love.graphics.setPointStyle and love.graphics.getPointStyle.
- Removed love.graphics.isSupported (replaced by love.graphics.getSupported.)
- Removed love.graphics.getSystemLimit (replaced by love.graphics.getSystemLimits.)
- Removed love.graphics.setStencil (replaced by love.graphics.stencil and love.graphics.setStencilTest.)
- Removed the "canvas", "shader", "npot", "subtractive", and "mipmap" GraphicsFeature constants (the features always have guaranteed support now.)
- Removed the "srgb" GraphicsFeature constant (use love.graphics.isGammaCorrect or love.graphics.getCanvasFormats().srgb instead.)
- Removed the "srgb" flag in love.window.setMode and in the t.window table in love.conf (Replaced by t.gammacorrect.)
- Removed the "premultiplied" BlendMode (love.graphics.setBlendMode("alpha", false) now does the same thing.)
- Removed Canvas:getPixel (use Canvas:newImageData instead.)
- Removed Canvas:clear (use love.graphics.clear instead.)
- Removed Mesh:getVertices.
- Removed Mesh:setVertexColors and Mesh:hasVertexColors (use Mesh:setAttributeEnabled("VertexColor", enable) instead.)
- Removed functions deprecated in LOVE 0.9.x:
- Removed love.graphics.getMaxImageSize and love.graphics.getMaxPointSize (replaced by love.graphics.getSystemLimits.)
- Removed Mesh:setImage, Mesh:getImage, SpriteBatch:setImage, SpriteBatch:getImage, ParticleSystem:setImage, and ParticleSystem:getImage (replaced by set/getTexture.)
- Removed SpriteBatch:bind and SpriteBatch:unbind.
- Removed Canvas:getFSAA and the "fsaa" flag in love.conf and love.window.setMode (replaced by Canvas:getMSAA and the "msaa" flag.)
- Removed the "dxt" and "bc5" GraphicsFeature constants (replaced by love.graphics.getCompressedImageFormats.)
- Removed the "hdrcanvas" GraphicsFeature constant (replaced by love.graphics.getCanvasFormats.)
- Removed love.window.getWidth and love.window.getHeight (use love.graphics.getWidth and love.graphics.getHeight or love.window.getMode instead.)
Bugfixes
- Fixed utf8.char.
- Fixed detection of fused executables.
- Fixed World:getCallbacks and World:getContactFilter when used in coroutines.
- Fixed crashes when objects which store Lua callback functions are garbage collected after being used in coroutines.
- Fixed love.keyboard.getKeyFromScancode crashing when an invalid scancode is given.
- Fixed decoding of 8-bit WAV files.
- Fixed love.audio.stop() not rewinding streaming Sources.
- Fixed the stencil buffer in Canvases when an unsupported MSAA value is used to create the Canvas.
- Fixed Canvas:renderTo to restore the previous canvases if an error occurs in the passed function.
- Fixed love.graphics.draw(canvas) to cause a Lua error if that canvas is the active one.
- Fixed love.graphics.getColorMask.
- Fixed the default offset for particles when ParticleSystem:setQuads or ParticleSystem:setTexture is used.
- Fixed love.graphics.shear resetting all love.graphics transformations.
- Fixed the "add" and "subtract" BlendModes to no longer modify the alpha of the Canvas / screen.
Performance improvements
- Improved the performance of World:rayCast and World:queryBoundingBox.
- Improved the performance of love.graphics.line and other line drawing functions, when the "smooth" LineStyle is used.
- Improved the performance of ImageData and SoundData methods when LuaJIT's JIT compiler is enabled, by using efficient FFI code.
Other changes
- Updated the compatibility warning notice to use a message box and to show the version specified in love.conf.
- Updated the compatibility warning notice to display before main.lua is loaded.
- Updated the __tostring metamethod of love objects to output the pointer value, similar to tostring(table).
- Updated World:setCallbacks, World:setContactFilter, World:queryBoundingBox, and World:rayCast to have improved argument type checking.
- Updated threads to load love.filesystem automatically.
- Updated love.math.setRandomSeed and RandomGenerator:setSeed to produce better results for the first few random() calls.
- Updated Source methods that deal with spatial audio to error rather than failing silently if the Source isn't mono.
- Updated the 3D and 4D variants of love.math.noise to use Perlin noise rather than Simplex noise, to avoid patent issues.
- Updated love.graphics.newImageFont to no longer treat separator pixels as spacing.
- Updated the default font to use less memory.
- Updated love.graphics color functions to automatically apply love.math.gammaToLinear to color values when gamma-correct rendering is enabled.
- Updated the "normal" CanvasFormat to internally use "srgb" rather than "rgba8" when gamma-correct rendering is enabled.
- Updated love.graphics.setColor to affect all drawn objects, including ParticleSystems, SpriteBatches, and Meshes, even when per-vertex or per-sprite colors are used.
- Updated the default fullscreen type to be "desktop" rather than "exclusive".
- Updated the minimum runtime system requirements of LOVE to require OpenGL 2.1 or OpenGL ES 2 support.
- Updated the pixel shader effect function so screen_coords.y is 0 at the top of the screen instead of the bottom.
- Updated Images to require setting the mipmaps flag to true on creation in order to use mipmaps.
- Updated Images to allow mipmaps for non-power-of-two sizes.
