changes.txt 64 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175
  1. LOVE 0.11.0 []
  2. --------------
  3. Released: N/A
  4. * Added a variant to World:update, which accepts the number of iterations to run. The defaults are now 8 and 3.
  5. * Added a click count argument to love.mousepressed and love.mousereleased.
  6. * Added love.filesystem.get/setCRequirePath, and use that to find c libraries for require.
  7. * Added Channel:hasRead, which checks if a message has been read. Takes an id, which Channel:push will now return.
  8. * Added love.math.encode/decode, which support hex and base64.
  9. * Added love.math.hash, which supports MD5, SHA-1 and the SHA-2 family.
  10. * Added support for different ImageData formats, including RGBA8 (the default), RGBA16, RGBA16F, and RGBA32F.
  11. * Added the ability to load Radiance HDR, OpenEXR, and 16 bit PNG images.
  12. * Added love.graphics.getImageFormats (replaces love.graphics.getCompressedImageFormats).
  13. * Added the ability to specify a per-object pixel density scale factor when creating Images, Canvases, Fonts, and Videos. Affects drawing.
  14. * Added Texture:getPixelWidth/Height and love.graphics.getPixelWidth/Height.
  15. * Added Texture:getPixelDensity, love.graphics.getPixelDensity, and Font:getPixelDensity.
  16. * Added SpriteBatch:setDrawRange.
  17. * Added per-shader opt in support for the GLSL 3.30 and GLSL ES 3.00 shading languages.
  18. * Added love.graphics.validateShader.
  19. * Added Shader:hasUniform.
  20. * Added support for non-square shader uniform matrices on desktop platforms and on mobile GLSL 3.
  21. * Added Shader:send(matrixname, is_column_major, matrix, ...) which specifies how to interpret the matrix table arguments.
  22. * Added love.graphics.captureScreenshot (replaces love.graphics.newScreenshot).
  23. * Added love.window.updateMode.
  24. * Added the ability to prevent love from creating a stencil buffer for the window.
  25. * Added Object:release.
  26. * Added queueable audio sources.
  27. * Added audio input support.
  28. * Added Transform objects to love.math.
  29. * Added 'glsl3', 'instancing', 'fullnpot', and 'pixelshaderhighp' graphics features.
  30. * Added 'anisotropy' graphics limit.
  31. * Added Mesh instancing support.
  32. * Added a Mesh:attachAttribute variant that takes a different target attribute name.
  33. * Added Mesh:detachAttribute.
  34. * Added a variant of Mesh:setVertexMap which accepts a Data object.
  35. * Added Source filters: low gain, high gain and band pass.
  36. * Changed all color values to be in the range 0-1, rather than 0-255.
  37. * Changed high-dpi functionality to require much less code (often none at all) for things to appear at the correct sizes and positions.
  38. * Changed love.graphics.print and friends to ignore carriage returns.
  39. * Changed the 'multiply' blend mode to error if not used with the 'premultiplied' blend alpha mode, since the formula only works with that anyway.
  40. * Changed some love.graphics, love.window, and love.event APIs to cause an error if a Canvas is active.
  41. * Changed Mesh:setDrawRange to take 'start' and 'count' parameters instead of 'min' and 'max'.
  42. * Changed the 'vsync' field of love.window.setMode and t.window in love.conf. It's now an integer with 0 disabling vsync.
  43. * Changed the audio playback APIs drastically.
  44. * Changed enet to no longer set the 'enet' global, again matching luasocket.
  45. * Changed Source seeking behaviour, all kinds of Sources now behave similarly when seeking past the boundaries.
  46. * Fixed Joystick:getGamepadMapping to work with xinput controllers.
  47. * Improved performance when drawing textures, shapes, lines, and points by automatically batching their draw calls together when possible.
  48. * Improved performance of Shader:send when the Shader is not active.
  49. * Renamed love.window.getPixelScale to love.window.getPixelDensity.
  50. * Removed the default source type for love.audio.newSource.
  51. * Removed variant of love.filesystem.newFileData which takes base64 data, use love.math.decode instead.
  52. * Removed the no-argument variant of Text:set, use Text:clear instead.
  53. * Removed love.graphics.getCompressedImageFormats, use love.graphics.getImageFormats instead.
  54. * Removed Shader:getExternVariable, use Shader:hasUniform instead.
  55. * Removed love.graphics.newScreenshot, use love.graphics.captureScreenshot instead.
  56. * Removed deprecated enet function host:socket_get_address.
  57. * Removed functions deprecated in LÖVE 0.10.2:
  58. * Removed Shader:sendInt, Shader:sendBoolean, Shader:sentFloat, Shader:sendMatrix, and Shader:sendTexture (use Shader:send instead).
  59. * Removed love.window.isCreated (use love.window.isOpen instead).
  60. * Updated Source:seek to work if the Source isn't playing.
  61. * Updated love.math.random to have improved numeric distribution.
  62. * Updated love.graphics to support Core Profile OpenGL 3.3+ when available.
  63. * Updated love.graphics.circle/ellipse/arc/rectangle to take transformation scale into account when determining the number of segments to use.
  64. * Updated Canvas:newImageData to return an ImageData with a format that matches the Canvas' as closely as possible.
  65. * Updated love.graphics.newImage to treat file names ending with "@2x", "@3x", etc. as a pixel density scale factor if none is explicitly supplied.
  66. * Updated luasocket to version 3.0rc1.
  67. LOVE 0.10.3 [Super Toast]
  68. -------------------------
  69. Released: N/A
  70. * Added RopeJoint:setMaxLength.
  71. * Fixed Shader:send and Shader:sendColor ignoring the last argument for an array.
  72. * Fixed a crash when love.graphics.pop is called after a love.window.setMode while the transformation stack was not empty.
  73. * Fixed BezierCurves to error instead of hanging in some situations.
  74. * Improved command line argument handling.
  75. * Updated the default error handler to allow copying the error to the clipboard when the user decides to do so.
  76. * Updated love.filesystem.setRequirePath to support multiple template '?' characters in each path.
  77. LOVE 0.10.2 [Super Toast]
  78. -------------------------
  79. Released: 2016-10-31
  80. * Added lovec.exe in Windows. It is the same as love.exe but built with the Console subsystem, so it always uses or provides a console.
  81. * Added the ability to restart the game via love.event.quit("restart").
  82. * Added support for passing a table to love.mouse.isDown, love.keyboard.isDown, love.keyboard.isScancodeDown, Joystick:isDown, and Joystick:isGamepadDown.
  83. * Added love.window.isMaximized.
  84. * Added 'shaderswitches' field to the table returned by love.graphics.getStats.
  85. * Added Quad:getTextureDimensions.
  86. * Added 'ellipse' area distribution to ParticleSystems.
  87. * Added support for BC4-7 compressed texture formats in KTX files.
  88. * Added PrismaticJoint:getAxis and WheelJoint:getAxis.
  89. * Added 2-point version of love.physics.newRevoluteJoint.
  90. * Added table variants of Fixture:setCategory and Fixture:setMask.
  91. * Added getNextVertex and getPreviousVertex to ChainShape and EdgeShape.
  92. * Added optional reference angle arguments to RevoluteJoint, PrismaticJoint, and WeldJoint constructors.
  93. * Added RevoluteJoint:getReferenceAngle, PrismaticJoint:getReferenceAngle, and WeldJoint:getReferenceAngle.
  94. * Deprecated undocumented Shader:sendTexture, Shader:sendMatrix, Shader:sendInt, and Shader:sendFloat functions.
  95. * Fixed love on iOS 6.
  96. * Fixed os.execute always returning -1 on Linux.
  97. * Fixed the love.lowmemory callback to call collectgarbage() after the callback has fired, instead of before.
  98. * Fixed love.math.noise(nil) to error instead of returning nil.
  99. * Fixed an occasional crash when a Thread ends.
  100. * Fixed a hang at the end of video playback with some video files.
  101. * Fixed the video decoding thread to not do any work when there are no videos to decode.
  102. * Fixed love.graphics.newVideo(file) to no longer error if love.audio is disabled.
  103. * Fixed a rare bug in Source:play for streaming Sources if the associated OpenAL source object was previously used for a static Source.
  104. * Fixed corrupted Font glyphs in rare cases.
  105. * Fixed stencils inside Canvases on some OpenGL ES 2 devices.
  106. * Fixed an OpenGL error in OpenGL ES 3 when multiple render targets are used.
  107. * Fixed love.window.setMode crashing when called with a Canvas active.
  108. * Fixed love.window.maximize to update the reported window dimensions immediately.
  109. * Fixed gamma correction of ImageFonts and BMFonts with colored images.
  110. * Fixed the default shader improperly applying gamma correction to per-vertex colors when gamma correction is requested but not supported on OpenGL ES.
  111. * Fixed text coloring breaking because of an empty string.
  112. * Fixed large burst of particles when dramatically increasing the emission rate of a ParticleSystem.
  113. * Fixed SpriteBatch:setBufferSize to keep old sprite data if it can fit.
  114. * Fixed MouseJoint:getBodies unconditionally erroring.
  115. * Fixed memory leak in Text:set.
  116. * Fixed incorrect kerning caused by using kerning information for the wrong character in some fonts.
  117. * Fixed ImageData:setPixel/getPixel/mapPixel and SoundData:setSample/getSample to properly handle non-integer coordinates.
  118. * Improved performance of Channel methods by roughly 2x in many cases.
  119. * Improved performance of Shader:send when small numbers of arguments are given.
  120. * Updated love.filesystem.mount to accept a DroppedFile as the first parameter.
  121. * Updated Shader:send to do type and argument checking based on the specified uniform variable's information instead of the arguments to the function.
  122. * Updated Shader:send to accept a flat table for matrix uniforms.
  123. LOVE 0.10.1 [Super Toast]
  124. -------------------------
  125. Released: 2016-02-14
  126. * Added a new love.conf flag t.externalstorage, which determines whether files are saved in internal or external storage on Android devices.
  127. * Added a new variant of love.graphics.arc which can draw different types of arcs ("pie", "open", or "closed").
  128. * Added "lighten" and "darken" BlendModes. They can only be used with the "premultiplied" BlendAlphaMode.
  129. * Added the "lighten" GraphicsFeature constant.
  130. * Added the ability to avoid clearing specific Canvases when calling love.graphics.clear, if multiple Canvases are active at once via love.graphics.setCanvas.
  131. * Added Text:getDimensions.
  132. * Added optional "collideconnected" argument to love.physics.newMotorJoint.
  133. * Fixed a Lua error in the no-game screen if the window's height is too small.
  134. * Fixed the default error handler to reset the mouse Cursor.
  135. * Fixed love.filesystem functions crashing when called if liblove is used directly without calling love.filesystem.init.
  136. * Fixed audio on Android to pause when the app is inactive, and resume when the app becomes active again.
  137. * Fixed the Video decoding thread hanging after Video:seek or when a Video finishes.
  138. * Fixed Video:isPlaying to always return false after it finishes playing.
  139. * Fixed RandomGenerator:random crashing if a nil 'self' is used.
  140. * Fixed loading BMFont files which have characters with 0 width or height (a space character, for example).
  141. * Fixed love.graphics.newFont causing crashes if FileData is passed in.
  142. * Fixed love.graphics.clear(colortable) causing crashes on OpenGL ES 2 systems when a Canvas is active.
  143. * Fixed a driver bug on some Android devices which caused all objects to show up as black.
  144. * Fixed a driver bug on Windows with AMD graphics cards where love.graphics.clear would not always work.
  145. * Fixed Shader:sendColor incorrectly converting alpha values from sRGB to linear RGB when gamma-correct rendering is enabled.
  146. * Fixed love.graphics.newMesh(vertices) double-converting colors from sRGB to linear RGB when gamma-correct rendering is enabled.
  147. * Fixed love.graphics.new* crashing when there is no graphics context/window.
  148. * Updated the Windows executable to prefer the high-powered AMD graphics card on systems which have switchable Intel+AMD GPUs.
  149. * Updated love.touch.getTouches to return the list of IDs in the relative order that the touches initially happened, instead of being in a random order.
  150. * Updated the error messages caused by invalid or bad arguments to ImageData and SoundData methods to be more descriptive.
  151. LOVE 0.10.0 [Super Toast]
  152. -------------------------
  153. Released: 2015-12-22
  154. * Added an iOS port.
  155. * Added an Android port.
  156. * Added the flag t.accelerometerjoystick to love.conf. Disables accelerometer-as-joystick functionality on mobile devices when false.
  157. * Added the flag t.gammacorrect to love.conf (replaces t.window.srgb.) Enabling it globally enables gamma-correct rendering, when supported.
  158. * Added video playback support for Ogg Theora videos, via love.graphics.newVideo and Video objects.
  159. * Added love.video module. It is not used for displaying videos on-screen, only decoding them.
  160. * Added love.touch module. Note that it has important differences from the touch implementation in the LÖVE 0.9 Android and iOS ports.
  161. * Added love.touchpressed, love.touchreleased, and love.touchmoved.
  162. * Added love.system.vibrate.
  163. * Added love.filesystem.setRequirePath and love.filesystem.getRequirePath.
  164. * Added an optional program exit argument to love.event.quit.
  165. * Added love.filedropped and love.directorydropped event callback functions.
  166. * Added love.lowmemory event callback function, called when the app is running out of memory on mobile operating systems.
  167. * Added love.textedited event callback function, called when the user is compositing text (e.g. via an IME.)
  168. * Added love.wheelmoved event callback function (replaces "wu" and "wd" constants for love.mousepressed.)
  169. * Added love.mouse.hasCursor.
  170. * Added a boolean argument to love.mousepressed and love.mousereleased indicating whether the button event originated from a touch press.
  171. * 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.
  172. * Added Source:getType (replaces Source:isStatic.)
  173. * Added Source:getDuration and Decoder:getDuration.
  174. * Added an optional string argument containing raw pixel byte data to the width/height variant of love.image.newImageData.
  175. * Added love.graphics.ellipse.
  176. * Added rounded-rectangle support to love.graphics.rectangle.
  177. * Added love.graphics.points (replaces love.graphics.point.)
  178. * Added love.graphics.intersectScissor.
  179. * Added an optional argument to love.graphics.setBlendMode which indicates whether to treat the colors of drawn objects as having pre-multiplied alpha.
  180. * Added love.graphics.getSupported (replaces love.graphics.isSupported.)
  181. * Added love.graphics.getSystemLimits (replaces love.graphics.getSystemLimit.)
  182. * Added love.graphics.stencil and love.graphics.set/getStencilTest (replaces love.graphics.setStencil.)
  183. * Added love.graphics.isActive.
  184. * Added color arguments to love.graphics.clear. It no longer always uses the background color value.
  185. * Added love.graphics.discard.
  186. * Added love.graphics.isGammaCorrect.
  187. * Added the "clampzero" WrapMode.
  188. * Added the ability to specify custom mipmaps when creating an image, via love.graphics.newImage(filename, {mipmaps={mip1, mip2, ...}})
  189. * Added optional x/y/width/height arguments to Image:refresh and Canvas:newImageData.
  190. * Added Image:getFlags.
  191. * Added one- and two-channel Canvas formats: r8, rg8, r16f, rg16f, r32f, and rg32f.
  192. * Added support for different formats in each Canvas when using multi-canvas rendering. Added the "multicanvasformats" Graphics Feature constant.
  193. * Added support for OpenGL ES 2 and 3.
  194. * Added support for loading ETC, EAC, PVRTC, and ASTC compressed textures on systems that support them.
  195. * Added custom vertex attribute support for Meshes via new variants of love.graphics.newMesh.
  196. * Added Mesh:setVertexAttribute and Mesh:getVertexAttribute.
  197. * Added Mesh:getVertexFormat.
  198. * Added Mesh:flush.
  199. * Added an optional 'startvertex' argument to Mesh:setVertices.
  200. * Added the ability for love.graphics.newMesh and Mesh:setVertices to accept a Data object.
  201. * Added Mesh:setAttributeEnabled and Mesh:isAttributeEnabled.
  202. * Added Mesh:attachAttribute.
  203. * Added SpriteBatch:attachAttribute.
  204. * Added Shader:sendColor.
  205. * Added new shader functions: gammaCorrectColor, gammaToLinear, and linearToGamma. The functions also have 'precise' and 'fast' variants.
  206. * Added Text objects and love.graphics.newText.
  207. * Added per-character color support to love.graphics.print/printf and to Text objects.
  208. * Added BMFont bitmap font file support to love.graphics.newFont and love.font.
  209. * Added kerning support for TrueType/OpenType and BMFont Fonts.
  210. * Added an optional font hinting argument to love.graphics.newFont when loading TrueType fonts.
  211. * Added an optional spacing argument to love.graphics.newImageFont, which applies additional spacing to all rendered glyphs.
  212. * Added Font:setFallbacks.
  213. * Added love.window.maximize.
  214. * Added love.window.close.
  215. * Added love.window.requestAttention.
  216. * Added love.window.setDisplaySleepEnabled and love.window.isDisplaySleepEnabled.
  217. * Added BezierCurve:renderSegment and BezierCurve:removeControlPoint.
  218. * Added BezierCurve:getSegment.
  219. * Added love.math.compress and love.math.decompress.
  220. * Added Channel:performAtomic.
  221. * Changed love.mousepressed, love.mousereleased, and love.mouse.isDown to use button numbers instead of named button constants.
  222. * Changed love.keypressed to be love.keypressed(key, scancode, isrepeat).
  223. * Changed love.keyreleased to be love.keyreleased(key, scancode).
  224. * Changed Font:getWrap's second return value to be a table containing the text split into lines.
  225. * Changed love.graphics.newImage's optional second argument to be a table of flags (flags are "mipmaps" and "linear".)
  226. * Changed the arguments for the standard variants of love.graphics.newMesh to newMesh(vertices [, drawmode, usage]) and newMesh(vertexcount [, drawmode, usage]).
  227. * Changed ImageData:encode to return a FileData object. ImageData:encode's first parameter is now the format to encode to, and the second parameter is an optional filename to write to.
  228. * Renamed the "normal" Fullscreen Type to "exclusive".
  229. * Renamed the DistanceModel constants "inverse clamped", "linear clamped", and "exponent clamped" to "inverseclamped", "linearclamped", and "exponentclamped".
  230. * Renamed the "additive", "subtractive", and "multiplicative" BlendModes to "add", "subtract", and "multiply".
  231. * Renamed the KeyConstant and Scancode representing the spacebar from " " to "space".
  232. * Renamed File:eof to File:isEOF.
  233. * Renamed Canvas:getImageData to Canvas:newImageData.
  234. * Renamed love.image's CompressedData type to CompressedImageData.
  235. * Removed callback variant of love.filesystem.getDirectoryItems.
  236. * Removed the "wu" and "wd" constants for love.mousepressed (replaced by love.wheelmoved.)
  237. * Removed the named mouse button constants (replaced by button numbers.)
  238. * Removed Source:isStatic (replaced by Source:getType.)
  239. * Removed image loading support for all (non-compressed texture) file formats except for PNG, JPEG, TGA, and BMP.
  240. * Removed JPEG encoding support from ImageData:encode.
  241. * Removed love.graphics.point (replaced by love.graphics.points.)
  242. * Removed love.graphics.setPointStyle and love.graphics.getPointStyle.
  243. * Removed love.graphics.isSupported (replaced by love.graphics.getSupported.)
  244. * Removed love.graphics.getSystemLimit (replaced by love.graphics.getSystemLimits.)
  245. * Removed love.graphics.setStencil (replaced by love.graphics.stencil and love.graphics.setStencilTest.)
  246. * Removed the "canvas", "shader", "npot", "subtractive", and "mipmap" Graphics Feature constants (the features always have guaranteed support now.)
  247. * Removed the "multicanvas" Graphics Feature constant (use love.graphics.getSystemLimits instead.)
  248. * Removed the "srgb" Graphics Feature constant (use love.graphics.isGammaCorrect() or love.graphics.getCanvasFormats().srgb instead.)
  249. * Removed the "srgb" flag in love.window.setMode and in the t.window table in love.conf (Replaced by t.gammacorrect.)
  250. * Removed the "premultiplied" blend mode (love.graphics.setBlendMode("alpha", "premultiplied") now does the same thing.)
  251. * Removed Canvas:getPixel (use Canvas:newImageData instead.)
  252. * Removed Canvas:clear (use love.graphics.clear instead.)
  253. * Removed Mesh:getVertices.
  254. * Removed Mesh:setVertexColors and Mesh:hasVertexColors (use Mesh:setAttributeEnabled("VertexColor", enable) instead.)
  255. * Removed functions deprecated in LOVE 0.9.1 and 0.9.2:
  256. * Removed love.graphics.getMaxImageSize and love.graphics.getMaxPointSize (replaced by love.graphics.getSystemLimits.)
  257. * Removed Mesh:set/getImage, SpriteBatch:set/getImage, and ParticleSystem:set/getImage (replaced by set/getTexture.)
  258. * Removed SpriteBatch:bind/unbind.
  259. * Removed Canvas:getFSAA and the "fsaa" flag in love.conf and love.window.setMode (replaced by Canvas:getMSAA and "msaa".)
  260. * Removed the "dxt" and "bc5" Graphics Feature constant (replaced by love.graphics.getCompressedImageFormats.)
  261. * Removed the "hdrcanvas" Graphics Feature constant (replaced by love.graphics.getCanvasFormats.)
  262. * Removed love.window.getWidth/getHeight/getDimensions (use love.graphics.getWidth/getHeight/getDimensions or love.window.getMode instead.)
  263. * Fixed utf8.char.
  264. * Fixed detection of fused love games.
  265. * Fixed World:getCallbacks and World:getContactFilter when used in coroutines.
  266. * Fixed crashes when objects which store Lua callback functions are garbage collected after being used in coroutines.
  267. * Fixed memory leaks in love.physics if World:destroy is never called. When a World is GCed it now destroys all objects it owns.
  268. * Fixed love.keyboard.getKeyFromScancode crashing when an invalid scancode is given.
  269. * Fixed decoding of 8-bit WAV files.
  270. * Fixed a crash issue when rewinding streaming ogg Sources, when certain versions of libvorbis are used.
  271. * Fixed love.audio.stop() not rewinding streaming Sources.
  272. * Fixed the stencil buffer in Canvases when an unsupported MSAA value is used to create the Canvas.
  273. * Fixed Canvas:renderTo to restore the previous Canvas if an error occurs in the passed function.
  274. * Fixed love.graphics.draw(canvas) to cause an error if that Canvas is the active one.
  275. * Fixed Mesh:getVertexMap to return nil rather than an empty table, if no vertex map has been set.
  276. * Fixed love.graphics.getColorMask.
  277. * Fixed the default offset for particles when ParticleSystem:setQuads or ParticleSystem:setTexture is used.
  278. * Fixed love.graphics.shear resetting all love.graphics transformations.
  279. * Fixed the "add" and "subtract" blend modes to no longer modify the alpha of the Canvas / screen.
  280. * Improved the performance of World:rayCast and World:queryBoundingBox.
  281. * Improved the performance of love.graphics.line and other line drawing functions, when the "smooth" LineStyle is used.
  282. * Improved the performance of Shader:send when matrices are used.
  283. * Improved the performance of ImageData and SoundData methods when LuaJIT's JIT compiler is enabled, by using efficient FFI code.
  284. * Improved the performance of love.math.noise, love.math.gammaToLinear, love.math.linearToGamma, love.math.random, and RandomGenerator:random when LuaJIT's JIT compiler is enabled.
  285. * Updated the compatibility warning notice to use a message box and to show the version specified in love.conf.
  286. * Updated the compatibility warning notice to display before main.lua is loaded.
  287. * Updated the __tostring metamethod of love objects to output the pointer value, similar to tostring(table).
  288. * Updated World:setCallbacks, World:setContactFilter, World:queryBoundingBox, and World:rayCast to have improved argument type checking.
  289. * Updated threads to load love.filesystem automatically.
  290. * Updated love.filesystem to enable symlinks by default.
  291. * Updated love.math.setRandomSeed and RandomGenerator:setSeed to produce better results for the first few random() calls.
  292. * Updated love.math.random and RandomGenerator:random to produce slightly better results in general.
  293. * Updated Source methods that deal with spatial audio to error rather than failing silently if the Source isn't mono.
  294. * Updated the 3D and 4D variants of love.math.noise to use Perlin noise rather than Simplex noise, to avoid patent issues.
  295. * Updated ImageFonts to no longer treat separator pixels as spacing.
  296. * Updated the default font to use less memory.
  297. * Updated the behavior of text wrapping with love.graphics.printf and Font:getWrap to work better.
  298. * Updated love.graphics.print and love.graphics.printf to no longer automatically round the x and y position arguments.
  299. * Updated some error messages for love.graphics.newImage to be more descriptive.
  300. * Updated love.graphics color functions to automatically apply love.math.gammaToLinear to color values when gamma-correct rendering is enabled.
  301. * Updated the 'normal' Canvas format to internally use 'srgb' rather than 'rgba8' when gamma-correct rendering is enabled.
  302. * Updated love.graphics.setColor to affect all drawn objects, including ParticleSystems, SpriteBatches, and Meshes.
  303. * Updated the default fullscreen type to be "desktop" rather than "exclusive".
  304. * Updated the minimum runtime system requirements of LOVE to require OpenGL 2.1 or OpenGL ES 2 support.
  305. * Updated the pixel shader effect function so screen_coords.y is 0 at the top of the screen instead of the bottom.
  306. * Updated Images to require setting the mipmaps flag to true on creation in order to use mipmaps.
  307. * Updated Images to allow mipmaps for non-power-of-two sizes.
  308. LOVE 0.9.2 [Baby Inspector]
  309. ---------------------------
  310. Released: 2015-02-14
  311. * Added Lua 5.3's UTF-8 module (via utf8 = require("utf8")).
  312. * Added Shader:getExternVariable.
  313. * Added several new canvas texture formats.
  314. * Added love.graphics.getCanvasFormats.
  315. * Added love.graphics.getCompressedImageFormats.
  316. * Added ParticleSystem:setQuads.
  317. * Added ParticleSystem:setLinearDamping.
  318. * Added SpriteBatch:flush.
  319. * Added love.graphics.getStats.
  320. * Added "mirroredrepeat" wrap mode.
  321. * Added love.audio.setDopplerScale and love.audio.getDopplerScale.
  322. * Added optional duration argument to Joystick:setVibration.
  323. * Added love.joystick.loadGamepadMappings and love.joystick.saveGamepadMappings.
  324. * Added Joint:setUserData and Joint:getUserData.
  325. * Added Joint:getBodies.
  326. * Added GearJoint:getJoints.
  327. * Added Contact:getFixtures and Body:getContactList.
  328. * Added Body:getWorld.
  329. * Added Body:getJointList.
  330. * Added Body/Contact/Fixture/Joint/World:isDestroyed.
  331. * Added love.mousemoved event callback.
  332. * Added love.mouse.setRelativeMode and love.mouse.getRelativeMode.
  333. * Added Scancode enums, love.keyboard.getKeyFromScancode, and love.keyboard.getScancodeFromKey.
  334. * Added love.window.getDisplayName.
  335. * Added love.window.minimize.
  336. * Added love.window.showMessageBox.
  337. * Added 'refreshrate' field to the table returned by love.window.getMode.
  338. * Added love.window.toPixels and love.window.fromPixels.
  339. * Added love.window.setPosition and love.window.getPosition, and 'x' and 'y' fields to love.window.setMode and t.window in love.conf.
  340. * Added love.filesystem.isSymlink, love.filesystem.setSymlinksEnabled, and love.filesystem.areSymlinksEnabled.
  341. * Added love.filesystem.getRealDirectory.
  342. * Deprecated SpriteBatch:bind and SpriteBatch:unbind.
  343. * Deprecated all uses of the name 'FSAA' in favor of 'MSAA'.
  344. * Deprecated the 'hdrcanvas' graphics feature enum in favor of getCanvasFormats.
  345. * Deprecated the 'dxt' and 'bc5' graphics feature enums in favor of getCompressedImageFormats.
  346. * Fixed crashes when love objects are used in multiple threads.
  347. * Fixed love.filesystem.setIdentity breaking in some situations when called multiple times.
  348. * Fixed the default love.filesystem identity when in Fused mode in Windows.
  349. * Fixed love.system.openURL sometimes blocking indefinitely on Linux.
  350. * Fixed love.joystick.setGamepadMapping.
  351. * Fixed the order of vertices in ChainShapes.
  352. * Fixed love.mouse.getPosition returning outdated values if love.mouse.setPosition is used in the same frame.
  353. * Fixed love.graphics.newFont to error when given an invalid size argument.
  354. * Fixed the filename and backtrace given when love.graphics.print errors.
  355. * Fixed a small memory leak if love.graphics.newCanvas errors.
  356. * Fixed shader:getWarnings returning unnecessary information.
  357. * Fixed some cases of noncompliant shader code not properly erroring on some nvidia drivers.
  358. * Fixed a potential crash when Shader objects are garbage collected.
  359. * Fixed a potential small memory leak triggered when love.graphics.newShader errors.
  360. * Fixed love.graphics.newMesh(vertexcount, ...) causing the Mesh to do instanced rendering.
  361. * Fixed Mesh:getVertexMap.
  362. * Fixed Image:refresh generating mipmaps multiple times if mipmap filtering is enabled.
  363. * Fixed Image:setMipmapFilter to not keep bad state around if it errors.
  364. * Fixed Mesh:setDrawRange when the Mesh has a vertex map set.
  365. * Fixed internal detection of the 'position' and 'effect' shader functions.
  366. * Fixed Texture memory leak when Meshes are garbage collected.
  367. * Fixed the default line join mode to be 'miter' instead of an undefined value.
  368. * Fixed the default error handler text size when highdpi mode is enabled on a Retina monitor.
  369. * Fixed the default error handler background color when sRGB mode is enabled for the window.
  370. * Fixed love.window.setMode to fall back to the largest available mode if a width or height greater than the largest supported is specified and fullscreen is used.
  371. * Fixed the state of wireframe mode when love.window.setMode is called.
  372. * Fixed Canvas:getPixel to error if the coordinates are not within the Canvas' size.
  373. * Fixed detection of compressed textures to work regardless of the file's extension.
  374. * Renamed all cases of FSAA to MSAA. The FSAA names still exist for backward-compatibility.
  375. * Updated the Windows executable to automatically prefer the higher performance GPU on nvidia Optimus systems.
  376. * Updated the --console command-line argument in Windows to open the console before conf.lua is loaded.
  377. * Updated t.console and the --console command-line argument in Windows to use the existing Console window, if love was launched from one.
  378. * Updated the love executable to verify that the love library's version matches.
  379. * Updated the Lua wrapper code for modules to avoid crashes when the module's instance is created, deleted, and recreated.
  380. * Updated internal code for handling garbage collection of love objects to be more efficient.
  381. * Updated love's initialization code to trigger a Lua error if love.conf has an error in it.
  382. * Updated the paths returned by love.filesystem.getSaveDirectory and friends to strip double-slashes from the string.
  383. * Updated the error message when love.filesystem.write or File:open fails because the directory doesn't exist.
  384. * Updated the error message when love.math.setRandomseed(0) is attempted.
  385. * Updated the error message when invalid UTF-8 strings are used in love functions that expect UTF-8.
  386. * Updated love.physics.newPolygonShape and love.physics.newChainShape to accept a table of vertices.
  387. * Updated love.physics.newChainShape to error if the number of arguments is invalid.
  388. * Updated love.thread.newThread to accept a literal string of code directly.
  389. * Updated love-created threads to use names visible in external debuggers.
  390. * Updated SpriteBatch:unbind to use less VRAM if the SpriteBatch has the static usage hint.
  391. * Updated love.graphics.newImage, love.image.newImageData, etc. to leave less Lua-owned memory around.
  392. * Updated love.graphics.push to accept different stack types to push. Current types are "transform" and "all".
  393. * Updated love shaders to accept GLSL ES precision qualifiers on variables, although they do nothing.
  394. * Updated the error message for love.graphics.newShader to be less cryptic if an invalid filename is given.
  395. * Updated compressed texture loading code to allow BC6 and BC7 compressed textures (if the graphics driver supports them.)
  396. LOVE 0.9.1 [Baby Inspector]
  397. ---------------------------
  398. Released: 2014-04-01
  399. * Added Source:clone.
  400. * Added blend mode "screen".
  401. * Added ParticleSystem:clone.
  402. * Added ParticleSystem:moveTo, has smoother emitter movement compared to setPosition.
  403. * Added ParticleSystem:setRelativeRotation.
  404. * Added love.graphics.setWireframe for debugging.
  405. * Added Mesh:setDrawRange and Mesh:getDrawRange.
  406. * Added CircleShape:getPoint and CircleShape:setPoint.
  407. * Added Mesh/SpriteBatch/ParticleSystem:setTexture, accepts Canvases and Images.
  408. * Added high-dpi window support for Retina displays in OS X, via the 'highdpi' window flag.
  409. * Added love.window.getPixelScale.
  410. * Added love.graphics.getSystemLimit.
  411. * Added antialiasing support to Canvases.
  412. * Added Canvas:getFSAA.
  413. * Added 'love_ScreenSize' built-in variable in shaders.
  414. * Added love.getVersion.
  415. * Added support for gamma-correct rendering.
  416. * Added love.graphics.isSupported("srgb").
  417. * Added love.math.gammaToLinear and love.math.linearToGamma.
  418. * Added RandomGenerator:getState and RandomGenerator:setState.
  419. * Added Body:setUserData and Body:getUserData.
  420. * Added some missing obscure key constants.
  421. * Added optional callback function argument to love.filesystem.getDirectoryItems.
  422. * Added love.system.openURL.
  423. * Deprecated Mesh/SpriteBatch/ParticleSystem:setImage.
  424. * Deprecated love.graphics.getMaxImageSize and love.graphics.getMaxPointSize.
  425. * Fixed love.graphics.scale with negative values causing incorrect line widths.
  426. * Fixed Joystick:isDown using 0-based button index arguments.
  427. * Fixed Source:setPitch to error when infinity or NaN is given.
  428. * Fixed love.graphics.setCanvas() to restore the proper viewport and scissor rectangles.
  429. * Fixed TrueType font glyphs which request a monochrome bitmap pixel mode.
  430. * Fixed love.graphics.reset causing crashes when called in between love.graphics.push/pop.
  431. * Fixed tab characters ("\t") to display properly with love.graphics.print.
  432. * Fixed love.graphics.isCreated to return false when love.window.setMode fails completely.
  433. * Fixed love.window.setMode to not destroy OpenGL resources before checking whether a fullsceren size is supported.
  434. * Fixed World:getBodyList and World:getJointList causing hard crashes.
  435. * Fixed loading BC4 compressed textures.
  436. * Fixed SoundData objects being initialized with garbage values.
  437. * Fixed 8-bit SoundData samples when used in love.audio Sources.
  438. * Updated the error text for love.filesystem’s module searchers when require fails.
  439. * Updated the love.filesystem module searchers to be tried after package.preload instead of before.
  440. * Updated love.graphics.newParticleSystem, newSpriteBatch, and newMesh to accept Canvases.
  441. * Updated Canvas drawing code, texture coordinates are no longer flipped vertically.
  442. * Updated Canvas:renderTo to work properly if a Canvas is currently active.
  443. * Updated ParticleSystem:setEmissionRate to accept non-integer numbers.
  444. * Updated Source:play to return a boolean indicating success.
  445. * Updated t.console in conf.lua to create the console before modules are loaded in Windows.
  446. * Updated Mesh vertex maps (index buffers) to use less space in VRAM.
  447. * Updated love.graphics.newMesh and Mesh:setVertices to default the UV parameters to 0,0.
  448. * Updated Fixture:set/getUserData to work in Coroutines.
  449. * Updated fullscreen-desktop and resizable window modes in OS X to use Mac OS 10.7's fullscreen Spaces.
  450. * Updated love.filesystem's C library loader to look in paths added via love.filesystem.mount, in Fused mode.
  451. * Updated the default love.run code to make initial love.math.random calls more random.
  452. LOVE 0.9.0 [Baby Inspector]
  453. ---------------------------
  454. Released: 2013-12-13
  455. * Added better multiplayer networking support via ENet.
  456. * Added --fused command line argument, to simulate fusing.
  457. * Added liblove.
  458. * Added the ability to have exit values.
  459. * Added exit value of 1 in case of error by default.
  460. * Added basic support for the file:// uri scheme.
  461. * Added love.filesystem.isFused.
  462. * Added love.filesystem.getIdentity.
  463. * Added love.filesystem.append.
  464. * Added love.filesystem.getSize.
  465. * Added love.filesystem.mount and love.filesystem.unmount.
  466. * Added optional file search order parameter to love.filesystem.setIdentity.
  467. * Added File:isOpen and File:getMode.
  468. * Added Fie:setBuffer, File:getBuffer, and File:flush.
  469. * Added textinput event for unicode text input.
  470. * Added love.keyboard.setTextInput and love.keyboard.hasTextInput.
  471. * Added previously internal Rasterizer and GlyphData object methods.
  472. * Added support for UTF-8 ImageFonts.
  473. * Added Font:getAscent/getDescent/getBaseline.
  474. * Added Font:setFilter/getFilter.
  475. * Added Font:hasGlyphs.
  476. * Added angle, scale, and shear parameters to love.graphics.printf.
  477. * Added HDR canvas support.
  478. * Added mipmapping support (has isSupported test).
  479. * Added vertex shader support.
  480. * Added boolean support to Shader:send.
  481. * Added Canvas:getPixel.
  482. * Added blend mode "replace".
  483. * Added line join modes.
  484. * Added Mesh objects, allowing for arbitrary textured polygons.
  485. * Added multiple render target support to love.graphics.setCanvas.
  486. * Added love.graphics.setColorMask.
  487. * Added love.graphics.origin.
  488. * Added love.graphics.getRendererInfo.
  489. * Added love.graphics.getMaxImageSize.
  490. * Added SpriteBatch:getCount and SpriteBatch:getBufferSize.
  491. * Added SpriteBatch:getColor.
  492. * Added ParticleSystem:emit.
  493. * Added ParticleSystem:setInsertMode and ParticleSystem:getInsertMode.
  494. * Added many ParticleSystem getter methods.
  495. * Added DXT compressed texture support via love.image.newCompressedData.
  496. * Added love.image.isCompressed and Image:isCompressed.
  497. * Added Image/Canvas/ImageData:getDimensions.
  498. * Added anisotropic filtering support for Images, Canvases, and Fonts.
  499. * Added Image:refresh.
  500. * Added Image:getData.
  501. * Added SoundData:getDuration and SoundData:getSampleCount.
  502. * Added Source:isPlaying.
  503. * Added Source:setRelative and Source:isRelative.
  504. * Added Source:setCone and Source:getCone.
  505. * Added Source:getChannels.
  506. * Added new Channels API for love.thread.
  507. * Added limited table support to Channel:push.
  508. * Added Thread:getError.
  509. * Added Thread:isRunning.
  510. * Added threaderror event.
  511. * Added love.math module.
  512. * Added a platform-independent (good) random implementation to love.math.
  513. * Added RandomGenerator objects.
  514. * Added BezierCurve objects.
  515. * Added love.math.triangulate and love.math.isConvex.
  516. * Added love.math.noise.
  517. * Added love.timer.getAverageDelta.
  518. * Added Data:getString.
  519. * Added Contact:getChildren.
  520. * Added love.system module.
  521. * Added love.system.getClipboardText and love.system.setClipboardText.
  522. * Added love.system.getOS and love.system.getProcessorCount.
  523. * Added love.window module.
  524. * Added love.window.isVisible.
  525. * Added flags to love.window.setMode.
  526. * Added monitor choosing support to love.window.setMode.
  527. * Added support for resizable, borderless, and non-centered windows.
  528. * Added support for "fullscreen-desktop" mode.
  529. * Added window resize and visible events.
  530. * Added love.window.getDimensions.
  531. * Added love.window.getIcon.
  532. * Added t.window.icon to love.conf.
  533. * Added love.mousefocus and love.window.hasMouseFocus.
  534. * Added custom hardware cursors via love.mouse.newCursor.
  535. * Added love.mouse.setX/setY.
  536. * Added Joystick objects.
  537. * Added love.joystick.getJoystick.
  538. * Added joystick connect and disconnect events.
  539. * Added joystickaxis and joystickhat events.
  540. * Added unified Gamepad API for joysticks which have a similar layout to the Xbox controller.
  541. * Added joystick vibration support, works with most common gamepads.
  542. * OPTIONAL: Added support for Game Music Emu.
  543. * Fixed fused mode in OS X.
  544. * Fixed printing to the console in Windows before love.load is called.
  545. * Fixed the default love.run to not include the time taken by love.load in the first frame's dt.
  546. * Fixed the error screen not always appearing until the next input event.
  547. * Fixed love.event.clear.
  548. * Fixed love.mouse.setPosition when called in love.load.
  549. * Fixed scaling in several love.physics functions.
  550. * Fixed Box2D exception in World:update.
  551. * Fixed many uncaught Box2D / love.physics exceptions for Bodies and Joints.
  552. * Fixed ChainShape:getPoints running out of Lua stack space and crashing.
  553. * Fixed File:read reading past end of file.
  554. * Fixed love.filesystem.setIdentity not removing read access from old directories.
  555. * Fixed possible memory leak in utf-8 decoder.
  556. * Fixed spacing for the last character in an ImageFont.
  557. * Fixed line wrapping in love.graphics.printf.
  558. * Fixed love.graphics.printf to error if the wrap limit is negative.
  559. * Fixed love.graphics.print truncating strings with embedded zeros.
  560. * Fixed crashes with font drawing on some ATI cards.
  561. * Fixed artifacts when drawing lines at huge scale.
  562. * Fixed Fonts and Canvases ignoring default image filter.
  563. * Fixed scissor boxes when a canvas is set after love.graphics.setScissor is called.
  564. * Fixed love.graphics.getLineWidth returning incorrect values.
  565. * Fixed love.graphics.getColor on some Windows systems.
  566. * Fixed alpha blend mode.
  567. * Fixed multiplicative blend mode.
  568. * Fixed love.graphics.getPointStyle.
  569. * Fixed line numbers in shader errors.
  570. * Fixed Shader:send with Images and Canvases failing sometimes.
  571. * Fixed Shader:send to keep a reference to sent Images and Canvases.
  572. * Fixed crash when binding SpriteBatches multiple times.
  573. * Fixed SpriteBatches with more than 16,384 sprites.
  574. * Fixed particle draw order for ParticleSystems.
  575. * Fixed ParticleSystem:setSizes resetting the size variation.
  576. * Fixed the graphics viewport not matching the window size when using an unsupported fullscreen mode.
  577. * Fixed getMode and friends returning wrong values when using desktop size.
  578. * Fixed keyrepeat settings being lost after (indirect) setMode.
  579. * Fixed the icon being reset after setMode.
  580. * Fixed memory leak in the mp3 decoder.
  581. * Fixed sound issues with some versions of OpenAL soft, by enabling direct channels.
  582. * Fixed 'random' hangs in audio.
  583. * Fixed love.sound.newDecoder not accepting FileData.
  584. * Fixed case (in)sensitivity of sound file extension parsing.
  585. * Fixed looping support in tracker music formats.
  586. * Fixed skipping/looping issues when playing streaming audio Sources.
  587. * Fixed race condition in Source:play.
  588. * Fixed WAVE sound playback.
  589. * Moved love's startup to modules/love.
  590. * Moved window-related functions from love.graphics to love.window.
  591. * Renamed love's boot script to 'love.boot', which can be required.
  592. * Renamed love.filesystem.mkdir to love.filesystem.createDirectory.
  593. * Renamed love.filesystem.enumerate to love.filesystem.getDirectoryItems.
  594. * Renamed World:setAllowSleeping to World:setSleepingAllowed.
  595. * Renamed ChainShape:setPrevVertex to ChainShape:setPreviousVertex.
  596. * Renamed Joint:enableMotor to Joint:setMotorEnabled.
  597. * Renamed Joint:enableLimit and Joint:isLimitEnabled to Joint:setLimitsEnabled and Joint:hasLimitsEnabled.
  598. * Renamed t.screen to t.window in love.conf.
  599. * Renamed love.graphics.setCaption to love.window.setTitle.
  600. * Renamed PixelEffect to Shader (but now with vertex shaders).
  601. * Renamed love.graphics.setDefaultImageFilter to love.graphics.setDefaultFilter.
  602. * Renamed ParticleSystem:setSprite to ParticleSystem:setImage.
  603. * Renamed ParticleSystem:setGravity to ParticleSystem:setLinearAcceleration.
  604. * Renamed ParticleSystem:setLifetime/setParticleLife to setEmitter/ParticleLifetime.
  605. * Renamed ParticleSystem:count and all getNum* functions to get*Count.
  606. * Renamed Source:setDistance to Source:setAttenuationDistances.
  607. * Renamed SoundData:getBits and Decoder:getBits to SoundData:getBitDepth and Decoder:getBitDepth.
  608. * Renamed love.mouse.setGrab to love.mouse.setGrabbed.
  609. * Removed release mode.
  610. * Removed love.keyboard.getKeyRepeat (see love.keyboard.hasKeyRepeat).
  611. * Removed the unicode argument from love.keypressed (see love.textinput).
  612. * Removed love.graphics.drawTest.
  613. * Removed love.graphics.quad/triangle.
  614. * Removed love.graphics.setColorMode.
  615. * Removed love.graphics.newStencil.
  616. * Removed love.graphics.setLine/setPoint.
  617. * Removed love.graphics.drawq (functionality is merged into love.graphics.draw).
  618. * Removed SpriteBatch:addq/setq (functionality is merged into SpriteBatch:add/set).
  619. * Removed Quad:flip.
  620. * Removed ParticleSystem:isFull/isEmpty.
  621. * Removed ParticleSystem:getX/getY.
  622. * Removed love.graphics.checkMode.
  623. * Removed love.joystick.open and friends.
  624. * Removed love.joystick module functions which operated on individual joysticks (see Joystick objects).
  625. * Removed joystick ball support.
  626. * Removed thread names.
  627. * Removed old thread messaging API (see Channels).
  628. * Removed love.timer.getMicroTime.
  629. * Updated functions which return love objects to re-use the Lua-side object instead of always recreating it.
  630. * Updated the windows console, it now tries to re-use an active one first.
  631. * Updated error handling, error handlers now get resolved when the error occurs.
  632. * Updated order of sleep/present in love.run (now draws, *then* sleeps).
  633. * Updated love.filesystem to try to create the appdata directory if it doesn't exist yet.
  634. * Updated the default filesystem identity to omit file extension.
  635. * Updated love.filesystem.newFile to optionally open the file.
  636. * Updated most love.filesystem functions to return nil, error on internal failure.
  637. * Updated love.keyboard.setKeyRepeat to take a boolean argument instead of numbers.
  638. * Updated love.keypressed's second argument to be a boolean indicating key repeat.
  639. * Updated keyboard key constants for some more modern keyboard keys.
  640. * Updated window code to use adaptive vsync when available, if vsync is enabled.
  641. * updated love.graphics.print's x and y arguments to default to 0.
  642. * Updated the setFilter and setWrap methods, the second argument is now optional.
  643. * Updated Font and ParticleSystem rendering code, now more performant.
  644. * Updated SpriteBatch code, now more performant when adding/setting and (un)binding.
  645. * Updated Canvas code to support more systems.
  646. * Updated Canvas:getImageData and love.graphics.newScreenshot to be more efficient.
  647. * Updated love.graphics.newScreenshot to create a fully opaque image by default.
  648. * Updated error messages when sending bad values to Shaders.
  649. * Updated love.graphics.newParticleSystem to have a default buffer size of 1000.
  650. * Updated ImageData:setPixel to accept a table and default to 255 alpha.
  651. * Updated ImageData:mapPixel, is now more efficient and accepts optional x,y,w,h arguments.
  652. * Updated love.image memory handling, improves errors and thread-safety.
  653. * Updated all love object constructors to optionally accept FileData if they accept a filename.
  654. * Updated allocation for SoundData, it's more efficient and less wasteful.
  655. * Updated SoundData:set/getSample to error for invalid samples.
  656. * Updated Source:set* functions to default z to 0.
  657. * Updated Source:seek to error for negative offsets.
  658. * Updated Thread:start to accept arguments which get passed to the thread.
  659. * Updated love.timer.getFPS to be microsecond-accurate.
  660. * Updated love.timer.getTime to be microsecond-accurate and monotonic.
  661. * Updated Box2D to version 2.3.0.
  662. LOVE 0.8.0 [Rubber Piggy]
  663. -------------------------
  664. Released: 2012-04-02
  665. * Added release error screen.
  666. * Added alpha to love.graphics.setBackgroundColor.
  667. * Added Canvas:clear(r, g, b, a).
  668. * Added Canvas support to love.graphics.drawq.
  669. * Added Canvas:getWidth and Canvas:getHeight.
  670. * Added love.graphics.arc.
  671. * Added seek and tell to Source objects.
  672. * Added color interpolation to ParticleSystem.
  673. * Added automatic PO2 padding for systems not supporting the OpenGL extension.
  674. * Added UTF-8 support for fonts.
  675. * Added Box2D error handling for some commonly failing functions.
  676. * Added ability for fused release games to have their write dir in appdata.
  677. * Added shear transformation to drawing functions.
  678. * Added origin to font printing.
  679. * Added love.graphics.getMode.
  680. * Added per-sprite colors on SpriteBatches.
  681. * Added PixelEffects.
  682. * Added love.graphics.isSupported.
  683. * Added love.graphics.getCanvas.
  684. * Added love.event.quit.
  685. * Added stencil masks.
  686. * Added alternative SpriteBatch provider, it should work everywhere now.
  687. * Added a loader for binary modules.
  688. * Added Thread:getKeys.
  689. * Added option of fractions for Quads.
  690. * Added PNG, JPEG and GIF support to ImageData:encode.
  691. * Added 64-bit support for Mac OS X.
  692. * Added premultiplied blending mode.
  693. * Added functions to set/get default image filter modes.
  694. * Added SpriteBatch:set.
  695. * Added new events system, with support for custom events and long event names.
  696. * Added sound attenuation by distance.
  697. * Added SpriteBatch:getImage.
  698. * Added combine color mode.
  699. * Added automatic random seeding to love.run.
  700. * Added support for the subtract BlendMode on older graphics cards.
  701. * Added love._os field, which contains the OS the game is running on.
  702. * Fixed wrapping for single words.
  703. * Fixed tracebacks not showing filenames.
  704. * Fixed love.graphics.push/pop capable of causing overflows/underflows.
  705. * Fixed setScissor on Canvases.
  706. * Fixed several issues with audio, e.g. clicks and pops in mp3s.
  707. * Fixed crashes when bodies were destroyed during collisions.
  708. * Fixed bound SpriteBatches corrupting when drawing.
  709. * Fixed thread-safety issues with ImageData.
  710. * Fixed memory leaks in audio sources.
  711. * Fixed thread's set (previously send) accidentally changing the type.
  712. * Fixed SoundData allocating the wrong number of samples.
  713. * Fixed SpriteBatch support on Intel cards.
  714. * Fixed love.filesystem.lines() leaking.
  715. * Fixed most leaking on unclosed File objects.
  716. * Fixed crashes when operating on non-existent files.
  717. * Fixed a bug where empty files on windows would never reach eof.
  718. * Fixed crash when SoundData runs out of memory.
  719. * Fixed ordering of loaders, love should have priority over lua.
  720. * Fixed several miscellaneous memory leaks.
  721. * Fixed a few cases where strings with \0 in them would not be stored correctly.
  722. * Fixed love's startup time being in the first dt.
  723. * Fixed internal string conversions, they are faster now.
  724. * Fixed (bad) performance of ImageData:paste.
  725. * Fixed love.graphics.toggleFullscreen not maintaining graphics state.
  726. * Renamed SpriteBatch's lock/unlock to bind/unbind.
  727. * Renamed Framebuffer to Canvas.
  728. * Renamed love.thread.send/receive to set/get.
  729. * Renamed love.graphics.setRenderTarget to setCanvas.
  730. * Removed canvas auto-clearing.
  731. * Removed EncodedImageData.
  732. * Removed old syntax for require (with extension).
  733. * Removed love.graphics.setFont([file], [size]).
  734. * Removed Thread:kill.
  735. * Updated love.joystick to be 1-indexed.
  736. * Updated Sources to update more cleanly and control more intuitively.
  737. * Updated font engine.
  738. * Updated line drawing to a custom system.
  739. * Updated love.timer.sleep to use seconds, like the rest of love.
  740. * Updated love.timer to be more accurate.
  741. * Updated love.graphics.circle to have max(10, r) as default for segments.
  742. * Updated ImageData:encode to write to files directly.
  743. * Updated version compatibility system to actually do something.
  744. * Updated love.run's order, events are checked just before update.
  745. * Updated Box2D to version 2.2.1.
  746. LOVE 0.7.2 [Game Slave]
  747. -----------------------
  748. Released: 2011-05-04
  749. * Added Framebuffer:get/setWrap.
  750. * Added love.event.clear.
  751. * Added support for any number of arguments to love.keyboard.isDown, love.mouse.isDown and love.joystick.isDown.
  752. * Added SpriteBatch:setImage().
  753. * Fixed fused games not working.
  754. * Fixed ParticleSystem:setSize ignoring the variation argument.
  755. * Fixed some file-opening exceptions not being caught.
  756. * Fixed files loaded by libmodplug being too loud.
  757. * Fixed paths with periods in them not working.
  758. * Fixed love.graphics.getBlendMode not detecting subtractive and multiplicative blend modes.
  759. * Fixed crash when there was no memory available for newImageData(w, h).
  760. * Updated PhysicsFS version to 2.0.2 on Windows
  761. * Updated OpenAL Soft version to 1.13 on Windows
  762. * Updated libmodplug version to 0.8.8.1 on Windows
  763. * Updated FreeType version to 2.4.4 on Windows
  764. * Updated libmpg123 version to 1.13.2 on Windows
  765. * Windows binary no longer depends on VC2005 runtime.
  766. * Windows binary no longer depends on SSE2 support.
  767. LOVE 0.7.1 [Game Slave]
  768. -----------------------
  769. Released: 2011-02-14
  770. * Added source:isPaused()
  771. * Added error when initial window can't be created.
  772. * Added framebuffer filter modes.
  773. * Added love.filesystem.getLastModified.
  774. * Added filter modes for ImageFonts.
  775. * Added dead key support by using "unknown" key with correct unicode value.
  776. * Added 0 width and height in love.conf. (for current desktop resolution)
  777. * Added alpha support when encoding TGA images.
  778. * Fixed a lot of bugs regarding zero characters in threads.
  779. * Fixed handling of a directory named "love" in current directory.
  780. * Fixed a few unhandled errors in setScissor.
  781. * Fixed a bug where old physics callbacks were never dereferenced.
  782. * Fixed loss of mouse visibility settings on setMode.
  783. * Fixed creation of a framebuffer unbinding current framebuffer.
  784. * Fixed several race conditions in love.thread.
  785. * Fixed 'love .', so it won't use lovedir/. as save dir.
  786. * Fixed setLineHeight.
  787. * Fixed extended ascii and ImageFonts.
  788. * Fixed printf's line wrapping.
  789. * Fixed crash when playing sounds.
  790. * Fixed playback of mp3s with arbitrary sample rates.
  791. * Fixed handling of negative indices in love.joystick.
  792. * Fixed toggleFullscreen.
  793. * Fixed unexpected behaviour with hash tables to love.graphics.line.
  794. * Fixed mouse coordinates being capped after setMode.
  795. * Fixed setFont's error handling on a non-existant file.
  796. * Fixed issue where Windows builds would hard crash on Lua errors
  797. * Removed custom sample rates for Decoders.
  798. LOVE 0.7.0 [Game Slave]
  799. -----------------------
  800. Released: 2010-12-05
  801. * Added love.thread.
  802. * Added love.font.
  803. * Added love.graphics.Framebuffer.
  804. * Added Source:play, Source:pause, etc.
  805. * Added Source:isStatic().
  806. * Added get/setPosition, get/setVelocity, and get/setDirection to Source.
  807. * Added get/setGroupIndex to CircleShape and PolygonShape.
  808. * Added Font:getWrap.
  809. * Added identity field to love.conf.
  810. * Added love.quit callback.
  811. * Added love.focus callback.
  812. * Added extra meter parameter to love.physics.newWorld.
  813. * Added love.graphics.setIcon.
  814. * Added way to make the window desktop resolution.
  815. * Added subtractive and multiplicative blend modes.
  816. * Added body:getAllowSleeping.
  817. * Added shape:getBody.
  818. * Added love.filesystem.FileData for public usage.
  819. * Added base64 support for love.filesystem.FileData.
  820. * Added table support for love.graphics.setColor and love.graphics.setBackgroundColor.
  821. * Added love.graphics.hasFocus().
  822. * Added ?/init.lua to the loader.
  823. * Fixed the debug module not being an upvalue of the error handlers. (you can now override debug)
  824. * Fixed some cases when love.audio.pause and friends, were acting on everything, not just the passed Source.
  825. * Fixed setFixedRotation enabling other flags.
  826. * Fixed a bug in the loader (for require).
  827. * Fixed ParticleSystem::setSprite not retaining the new image.
  828. * Fixed setMode removing images settings (wrapping, filters).
  829. * Fixed shape:getBody, it's now exposed for LÖVE usage.
  830. * Fixed DistanceJoint:getType() returning "circle" - it now returns "distance".
  831. * Fixed SpriteBatches being unaffected by setColor
  832. * Fixed the audio bug.
  833. * Fixed invalid FSAA values crashing LÖVE.
  834. * Fixed a bunch of compiler warnings.
  835. * Fixed OS X not properly using UTIs for .love files.
  836. * Fixed the modplug decoder not properly handeling files that fail to load.
  837. * Fixed a memory leak in setFont.
  838. * Fixed bug where errors in threads wouldn't get picked up by demand.
  839. * Fixed part of the bug with newlines when scaling text (rotating still messes up the lines).
  840. * Fixed the bug where newImageFont would try to created ImageData out of ImageData.
  841. * Fixed error handler not resetting the blend mode.
  842. * Changed fonts, they're now po2 safe.
  843. * Changed the traceback in the error screen.
  844. * Changed font origin to top-left.
  845. * Changed linux save dir location to obey to Freedesktop.org's XDG specs. (~/.local/share/love by default.)
  846. * Removed font functions from love.graphics.
  847. * Removed love.physics.newWorld(w, h). Use love.physics.newWorld(x1, y1, x2, y2) instead.
  848. LOVE 0.6.2 [Jiggly Juice]
  849. -------------------------
  850. Released: 2010-03-06
  851. * Fixed a bug causing ImageFonts to cut off some pixels.
  852. * Fixed a bug where filled rectangles were too small.
  853. * Fixed a bug in Image:setFilter where it would switch the parameters.
  854. * Fixed a bug in ImageRasterizer where it wasn't using the data.
  855. * Image filter and wrap modes now use string constants as well.
  856. * Fixed double-transform bug in SpriteBatch.
  857. * Errors are reported on stdout again.
  858. * Another fix for the icons on ubuntu.
  859. LOVE 0.6.1 [Jiggly Juice]
  860. -------------------------
  861. Released: 2010-02-07
  862. * Added Shape:setGroupIndex and getGroupIndex.
  863. * Added Body:setFixedRotation and Body:getFixedRotation.
  864. * Added Body:setInertia.
  865. * Added CircleShape:getLocalCenter and CircleShape:getWorldCenter.
  866. * Added icons and file associations for the debs.
  867. * Added the demos folder to the Mac OS X DMG.
  868. * It's now possible to run a .love from Resources in Mac OS X, thanks to Steve Johnson.
  869. * Fixed a bug with multiple Sources on the same Music.
  870. * Fixed a bug so the mouse doesn't get crippled when the keyboard is disabled.
  871. * Fixed a bug where love.graphics.rectangle drew a too large rectangle.
  872. * Fixed a bug where memory wouldn't be released correctly.
  873. * Fixed epic physics typo (getRestituion->getRestitution).
  874. * Fixed crash on opening non-existent image.
  875. * The error screen redraws when an event occurs.
  876. * The default love.run() now gracefully handles disabled modules.
  877. * The debian packages should now successfully include icons, file associations, etc, and should give the correct architecture.
  878. * Added support for drawing polylines to love.graphics.line - the syntax is the same as love.graphics.polygon.
  879. * Removed Music and Sound. There are now only sources.
  880. * Improved the stability of love.audio/love.sound.
  881. LOVE 0.6.0 [Jiggly Juice]
  882. -------------------------
  883. Released: 2009-12-24
  884. * Lost track of 0.6.0 changes a long while ago. Don't trust the list below.
  885. * Added love.graphics.print()/printf().
  886. * Added unicode-translated parameter to love.keypressed().
  887. * Added love.event.
  888. * Added love.filesystem.setIdentity().
  889. * Added OpenAL dependency.
  890. * Fixed love.fileystem problems with internal \0 in strings.
  891. * Fixed love.filesystem.mkdir/remove not working when write directory not set.
  892. * Fixed position of Window.
  893. * Changed parameter order of draws().
  894. * Changed origin for images to top-left.
  895. * Changed love.filesystem.open to accept mode (removed from love.filesystem.newFile).
  896. * Changed love.filesystem.read() which now returns two parameters (data, length).
  897. * Changed love.filesystem.write() which now takes up to four parameters (file, data, length, mode).
  898. * Changed default color mode to "modulate".
  899. * Changed name of love.color_normal to "replace".
  900. * Changed name of love.blend_normal to "alpha".
  901. * Changed the conf file format.
  902. * Removed Color object.
  903. * Removed Animation.
  904. * Removed several constants.
  905. * Removed love.graphics.draw() for strings.
  906. * Removed love.system.
  907. * Removed SWIG.
  908. * Removed boost.
  909. * Removed SDL_mixer.
  910. LOVE 0.5.0 [Salted Nuts]
  911. ------------------------
  912. Released: 2009-01-02
  913. * Added love.joystick.
  914. * Added network support via LuaSocket.
  915. * Added support for loading of appended .love-file.
  916. * Added love.filesystem.lines().
  917. * Added a loader function to enable use of normal require().
  918. * Added love.filesystem.load().
  919. * Added love.filesystem.getSaveDirectory()
  920. * Added love.filesystem.getWorkingDirectory()
  921. * Added optional explicit destruction of Box2D objects.
  922. * Added shape:testSegment().
  923. * Added love.graphics.screenshot() (.bmp only).
  924. * Added default size (12) to font-related functions.
  925. * Added love.graphics.setFont( filename, size )
  926. * Added love.graphics.setLineStippe and related functions.
  927. * Added love.graphics.setPointSize and related functions.
  928. * Changed love.filesystem.read() to accept file name.
  929. * Changed love.filesystem.write() to accept file name.
  930. * Changed love.graphics.triangle() to accept CCW and CW ordering.
  931. * Fixed love.graphics.read adding bogus characters at the end of string.
  932. * Fixed epic swigfusion bug.
  933. * Fixed love.graphics.getFont so it returns nil if no font is present.
  934. * Fixed bug where love.graphics.getBlendMode() always returns blend_normal.
  935. * Fixed bug which caused error screen to be scissored (when enabled).
  936. * Fixed Body:setAngle to accept degrees like everything else.
  937. * Cleaned up love::File and love_physfs.
  938. * Cleaned up love::Reference so it stores its reference in _G.
  939. LOVE 0.4.0 [Taco Beam]
  940. ----------------------
  941. Released: 2008-08-29
  942. * Added love.physics. (YES!)
  943. * Added love.audio.setMode().
  944. * Added love.audio.setChannels().
  945. * Added love.graphics.polygon().
  946. * Added love.graphics.setScissor() and love.graphics.getScissor() to handle scissoring the graphical area.
  947. * Fixed missing constants related to image optimization.
  948. * Fixed memory leak related to love::File (thanks amnesiasoft!).
  949. LOVE 0.3.2 [Lemony Fresh]
  950. -------------------------
  951. Released: 2008-07-04
  952. * Added love.graphics.rectangle()
  953. * Added love.graphics.setLineWidth()
  954. * Added love.graphics.setLineStyle()
  955. * Added love.graphics.getLineWidth()
  956. * Added love.graphics.getLineStyle()
  957. * Added love.mouse.getPosition()
  958. * Added love.audio_loop
  959. * Added love.timer.getTime()
  960. * Changed love.graphics.quad() to accept CCW and CW ordering.
  961. * Fixed default color mode bug.
  962. * Fixed line width being applied unnecessarily.
  963. * Fixed line width bug related to fullscreen toggle.
  964. * Fixed music not looping.
  965. LOVE 0.3.1 [Space Meat]
  966. -----------------------
  967. Released: 2008-06-21
  968. * Fixed segfault related to graphics.
  969. * Fixed wait-forever bug related to audio.
  970. * Fixed error reporting not working across modules.
  971. * Fixed bug where games with a trailing "/" would not start.
  972. * Fixed bug which caused love.timer.sleep to delay for (way) too long.
  973. LOVE 0.3.0 [Mutant Vermin]
  974. --------------------------
  975. Released: 2008-06-17
  976. * Added ParticleSystem.
  977. * Added visual error reporting.
  978. * Added love.system for game control needs.
  979. * Added input grabbing.
  980. * Added functions in love.graphics for display management.
  981. * Added love.graphics.point().
  982. * Added functions in love.graphics for getting current color, font, etc.
  983. * Added love.filesystem.enumerate() for getting folder contents.
  984. * Added functions for setting the window caption.
  985. * Added version checking. An error occurs if the game is incompatible.
  986. * Fixed print() :)
  987. * Removed all keyboard shortcuts.
  988. * Save folders are now created only if required.
  989. * On Windows, the new save location is %APPDATA%\LOVE\game
  990. LOVE 0.2.1 [Impending Doom]
  991. ---------------------------
  992. Released: 2008-03-29
  993. * Added many functions in love.filesystem.
  994. * Added a dedicated save-folder for each game.
  995. * Added timer.sleep.
  996. * Added line heights to font objects.
  997. * Added love.graphics.getWidth/getHeight.
  998. * Added scaling and rotation for text.
  999. * Added variable spacing to ImageFont.
  1000. * Added support for variable line quality when drawing primitives.
  1001. * Added several functions for drawing sections of images. (love.graphics.draws)
  1002. * Added image optimization function and padding function.
  1003. * Added love.graphics.getWidth/Height.
  1004. * Split devices up into actual SWIG-modules. This means that:
  1005. - Functions are used like this: love.graphics.draw, not love.graphics:draw
  1006. - love.objects is no more. Objects are created by an appropriate device.
  1007. * How you draw primitives has been altered.
  1008. * draw(string, x, y, wrap, align) has become drawf(string, x, y, wrap, align)
  1009. * Changed getFps to getFPS.
  1010. * Escape is no more ... enter: Alt+F4.
  1011. * love.filesystem.include has been renamed to love.filesystem.require.
  1012. * ImageFonts now consider the spacing as well as the glyph size.
  1013. * Fixed a massive ImageFont bug which resulted in float-positioning failure.
  1014. * Fixed a bug when loading fonts where the specified size doesn't represent the true size of the font.
  1015. * Updated DevIL to version 1.6.8-rc2 (Windows)
  1016. * Updated FreeType to freetype-2.3.5-1 (Windows)
  1017. * Updated Lua to 5.1.3 (Windows)
  1018. * Updated SDL to 1.2.13 (Windows)
  1019. * Removed boost::filesystem.
  1020. LOVE 0.2.0 [Mini-Moose]
  1021. -----------------------
  1022. Released: 2008-02-06
  1023. * Added ImageFont
  1024. * Added Animation
  1025. * Added text formatting functions
  1026. * Added setCenter for Image and Animation.
  1027. * Added methods for rendering of scaled/rotated sprites.
  1028. * Added the drawing of basic shapes.
  1029. * Added default font and embedded resources.
  1030. * Added Ctrl+R for reload.
  1031. * Added blending and color modes.
  1032. * Fixed memory usage of Graphics.
  1033. * Fixed a bug where the set text color would change the color of any images rendered.
  1034. * Fixed CWD bug.
  1035. * Fixed titlebar. Game title is now displayed.
  1036. LOVE 0.1.1 [Santa-Power]
  1037. ------------------------
  1038. Initial release!
  1039. Released: 2008-01-13
  1040. * Image loading and rendering.
  1041. * Sound loading and playing.
  1042. * Font loading and rendering.
  1043. * Lua-scriptable games.
  1044. * Config files.
  1045. * Stuff is loadable from archive files.
  1046. * Keyboard, mouse, display, timer, etc. (Basic devices).