mirror of
https://github.com/photonstorm/phaser
synced 2024-11-26 06:30:38 +00:00
Preparing for 2.0.4 development.
This commit is contained in:
photonstorm
parent
cdff873cf7
commit
0d15350755
5 changed files with 14 additions and 158 deletions
160
README.md
160
README.md
|
|
@ -1,10 +1,10 @@
|
||||||
|
|
||||||
|
|
||||||
# Phaser 2.0.3
|
# Phaser 2.0.4-dev
|
||||||
|
|
||||||
Phaser is a fast, free and fun open source game framework for making desktop and mobile browser HTML5 games. It uses [Pixi.js](https://github.com/GoodBoyDigital/pixi.js/) internally for fast 2D Canvas and WebGL rendering.
|
Phaser is a fast, free and fun open source game framework for making desktop and mobile browser HTML5 games. It uses [Pixi.js](https://github.com/GoodBoyDigital/pixi.js/) internally for fast 2D Canvas and WebGL rendering.
|
||||||
|
|
||||||
Version: 2.0.3 "Allorallen" - Released: 11th April 2014
|
Version: 2.0.4 "Mos Shirare" - Released: -in development-
|
||||||
|
|
||||||
By Richard Davey, [Photon Storm](http://www.photonstorm.com)
|
By Richard Davey, [Photon Storm](http://www.photonstorm.com)
|
||||||
|
|
||||||
|
|
@ -22,19 +22,8 @@ By Richard Davey, [Photon Storm](http://www.photonstorm.com)
|
||||||
[](https://bitdeli.com/free "Bitdeli Badge")
|
[](https://bitdeli.com/free "Bitdeli Badge")
|
||||||
|
|
||||||
|
|
||||||
## What's new in 2.0.3?
|
## What's new in 2.0.4?
|
||||||
|
|
||||||
In this release we have upgraded both pixi.js to v1.5.2 and p2.js to v0.5.0. This improves features and stability across the whole framework, and as always you'll find the complete list of improvements below.
|
|
||||||
|
|
||||||
We've taken some time to enhance the Particle Emitter adding a few substantial features such as the ability for Particles to now change scale or alpha over time using any of the easing functions, or apply a blend mode. These small additions now allow you to create visually more impressive effects than before, and while we still have a complete overhaul of the particle system on our roadmap it's a welcome boost in the meantime.
|
|
||||||
|
|
||||||
Along with the p2.js update we have also refined the Phaser P2 classes, making tweaks that help overall performance, such as splitting the world bounds into separate bodies. The World now has a default contact material, which allows for easier setting of responses when objects collide with no materials set. All in all it's a powerful update.
|
|
||||||
|
|
||||||
What's interesting is that loads of the new features and bug fixes in this release have come direct from the community. Of course we've been busy and working hard on Phaser as well, but the volume of contributors now is fantastic. We've have always listed their names next to the issues they helped resolve, but now we're doing so with their github usernames directly so they appear on the revisions change log.
|
|
||||||
|
|
||||||
As promised with the 2.0.0 release we have done all of this without changing existing API calls in the core Phaser classes. New features are introduced either via the creation of new optional parameters or by creating new methods. Where a feature has been deprecated we have flagged it as such in the docs, but left it in so as to not break existing code.
|
|
||||||
|
|
||||||
Some of you may not be aware, but the `phaser.min.js` file in the build folder contains all 3 physics systems bundled in. We've refined our build process so that it's easy for you to create custom builds now via grunt, but if you know you only need Arcade Physics (and not P2 or Ninja) then you can use `phaser-arcade-physics.min.js` which is found in the `build/custom` folder. This will save you 180KB from the minified file size, so please use it if you can.
|
|
||||||
|
|
||||||
|
|
||||||
## Welcome to Phaser
|
## Welcome to Phaser
|
||||||
|
|
@ -65,153 +54,16 @@ There is also an [un-official Getting Started Guide](http://www.antonoffplus.com
|
||||||
|
|
||||||
## Change Log
|
## Change Log
|
||||||
|
|
||||||
Version 2.0.3 - "Allorallen" - 11th April 2014
|
Version 2.0.4 - "Mos Shirare" - in development
|
||||||
|
|
||||||
### Updates
|
### Updates
|
||||||
|
|
||||||
* Updated to [Pixi.js 1.5.2](https://github.com/GoodBoyDigital/pixi.js/releases/tag/v1.5.2)
|
|
||||||
* Updated to [p2.js 0.5.0](https://github.com/schteppe/p2.js/releases/tag/v0.5.0)
|
|
||||||
* Return the result of P2.Body.setCircle for further chaining and manipulation (fix #659)
|
|
||||||
* Updated the PhysicsEditor plugin to maintain position, radius, mask bits, category bits and sensor flags (thanks @georgiee, #674)
|
|
||||||
* Further TypeScript defs tweaks (thanks @clark-stevenson)
|
|
||||||
* Lowered the default size of SpriteBatch from 10000 to 2000 as this yields faster results on mobile (pixi.js update)
|
|
||||||
* Fix for 'jagged' strokes on custom fonts (thanks @nickryall, #677)
|
|
||||||
* The State.update function (and thus the update of any sub-classed Sprites or other objects) is now called before Stage, Tweens, Sound, Input, etc (#662)
|
|
||||||
* The Phaser jshint process is now running on Travis (thanks @xtian, #656)
|
|
||||||
* The Phaser Gruntfile is now split up into option tasks (thanks @xtian, #638)
|
|
||||||
* Key.reset now clears any callbacks associated with the onDown and onUp events and nulls the onHoldCallback if set. Key.reset is called by Keyboard.reset when changing state.
|
|
||||||
* If you pass `null` to Tilemap.putTile as the tile parameter it will pass the call over to Tilemap.removeTile.
|
|
||||||
* TypeScript definitions updated for latest changes (thanks @clark-stevenson)
|
|
||||||
* Keyboard.stop nulls the function references after removing the event listeners (thanks @bmceldowney, #691)
|
|
||||||
* Tilemap.hasTile allows for multi-layer type parameter (thanks @Raeven0, #680)
|
|
||||||
* Grunt update to dev dependencies (thanks @xtian, #695)
|
|
||||||
* Emitter now emits Phaser.Particle objects instead of Phaser.Sprites, which can be extended as required.
|
|
||||||
* Emitter has had various local properties removed that were already declared in Phaser.Group which it extends.
|
|
||||||
* PluginManager parent parameter removed as it's redundant. Also most core functions tidied up and jsdocs fixed.
|
|
||||||
* p2.World.defaultRestitution has been deprecated and is now p2.World.restitution.
|
|
||||||
* p2.World.defaultFriction has been deprecated and is now p2.World.friction.
|
|
||||||
* p2.World now uses 4 bodies for the world boundaries, rather than 1 body with 4 shapes. This stops the bounds triggering narrowphase with every single body in the world.
|
|
||||||
* p2.World bounds are now included in the callback events such as beginContact and impact events.
|
|
||||||
* Thanks to @STuFF the Classes drop-down list in the API docs now indents the sub-classes.
|
|
||||||
|
|
||||||
### New Features
|
### New Features
|
||||||
|
|
||||||
* Added ability to retrieve a single p2 fixture from the cache (thanks @georgiee, #674)
|
|
||||||
* Timers can now have a start delay value (thanks @georgiee, #660)
|
|
||||||
* CacheAsBitmap added to Display Object, so works for Sprite, Image, Button. Allows you to cache complex display hierarchies for speed.
|
|
||||||
* CacheAsBitmap added to Graphics Object. Allows you to cache complex graphics structures hierarchies for speed.
|
|
||||||
* Added generateTexture function to display objects. Create a texture from the current object display hierarchy for use as a texture elsewhere.
|
|
||||||
* Added optional FilterArea to display object (for optimisation)
|
|
||||||
* Graphics chaining functions.
|
|
||||||
* Added Pointer.positionUp which records the last point at which the pointer left the screen (thanks @Cryszon, #676)
|
|
||||||
* Phaser.Point.centroid static function added to calculate the centroid or midpoint of an array of points (thanks @lewster32, #675)
|
|
||||||
* SoundManager.remove(sound) now lets you remove a sound from the SoundManager, destroying it in the process.
|
|
||||||
* Sound.destroy will remove a sound and all local references it holds, optionally removing itself from the SoundManager as well.
|
|
||||||
* SoundManager.removeByKey(key) will remove all sounds from the SoundManager that have a key matching the given value.
|
|
||||||
* ArcadePhysics.Body.hitTest(x, y) will return a boolean based on if the given world coordinate are within the Body or not.
|
|
||||||
* StateManager.restart allows you to quickly restart the *current* state, optionally clearing the world and cache.
|
|
||||||
* Tilemap.removeTile(x, y, layer) lets you remove the tile at the given coordinates and updates the collision data.
|
|
||||||
* Tilemap.removeTileWorldXY lets you remove the tile at the given pixel value coordinates and updates the collision data.
|
|
||||||
* Key.enabled boolean allows you to toggle if a Key processes its update method or dispatches any events without deleting and re-creating it.
|
|
||||||
* Emitter now has minParticleAlpha and maxParticleAlpha values for setting a random alpha on emitted particles.
|
|
||||||
* Emitter.particleAnchor allows you to control the anchor of emitted Particles. Defaults to 0.5 (same as before) but now under your control.
|
|
||||||
* Emitter.setAlpha allows you to quickly set the min and max alpha values.
|
|
||||||
* Emitter.setScale allows you to quickly set the min and max scale values.
|
|
||||||
* Emitter.blendMode lets you set the blendMode of any emitted Particle (needs a browser that supports canvas blend modes)
|
|
||||||
* Group.customSort allows you to sort the Group children based on your own sort function.
|
|
||||||
* Emitter.setScale has a new 'rate' parameter which allows particles to change in scale over time, using any Easing value or timescale.
|
|
||||||
* Emitter.setScale now allows you to scale the x and y axis of the particles independently.
|
|
||||||
* Emitter.setAlpha has a new 'rate' parameter which allows particles to change alpha over time, using any Easing value or timescale.
|
|
||||||
* Emitter.bringToTop and Emitter.sendToBack are booleans that let you optionally set the display order of the Particle when emitted.
|
|
||||||
* Emitter now calls the Phaser.Particle.onEmit function, which is left empty for you to override and add in custom behaviours.
|
|
||||||
* p2.World has a new contactMaterial property, which can be configured like a normal P2 Contact Material and is applied when two bodies hit that don't have defined materials.
|
|
||||||
* Group.remove has a new 'destroy' parameter (false by default), which will optionally call destroy on the item removed from the Group.
|
|
||||||
* Group.removeAll has a new 'destroy' parameter (false by default), which will optionally call destroy on the items removed from the Group.
|
|
||||||
* Group.removeBetween has a new 'destroy' parameter (false by default), which will optionally call destroy on the items removed from the Group.
|
|
||||||
* @georgiee created a new P2.FixtureList class to allow easy access the fixtures of a created P2 Body:
|
|
||||||
|
|
||||||
This is especially useful in combination with PhysicsEditor and P2.Body#addPhaserPolygon.
|
|
||||||
|
|
||||||
You can configure your whole collision grouping in PhysicsEditor and then you can later change the mask bits easily with this class. You can also access parts (groups) and named fixtures by a group index or a fixture key - both properties can be set in PhysicsEditor with the custom phaser exporter.
|
|
||||||
|
|
||||||
Use cases:
|
|
||||||
|
|
||||||
* Configure collision bits in PhysicsEditor and you want to change them later.
|
|
||||||
* Place a sensor in your fixture and access this single fixture later (to disable temporarily)
|
|
||||||
* Create a small body with threes fixtures (circle, circle + polygon/convex). Now you want that the polygon part to behave like rubber and assign a bouncing (restitution > 1) material. Assign a fixture key in PhysicsEditor and access the fixture like this. (see the image for the fixture I described)
|
|
||||||
|
|
||||||
### Bug Fixes
|
### Bug Fixes
|
||||||
|
|
||||||
* If you inputEnable = false a gameobject you couldn't re-enable it again using inputEnable = true, only directly via the handler (thanks @nickrall, fix #673)
|
|
||||||
* Fixed setTexture bug with TilingSprite (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed anchor point bug in canvas with TilingSprite (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed positionOffset not begin correct in TilingSprite (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed issue where filters were not being applied to TilingSprite (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed SpriteBatch canvas transform bug (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed Cached textures issue when using base64 encoded images (@cacheflowe) (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed issue where visibility was not being respected in sprite batch (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed bug in gl.bindTexture which tried to use an undefined private var. (@photonstorm) (pixi.js 1.5.2 bug fix)
|
|
||||||
* Fixed the 'short cut' version of Math.floor in setTransform if roundPixels is true. (@photonstorm) (pixi.js 1.5.2 bug fix)
|
|
||||||
* SoundManager.boot will check to see if the AudioContext was created before carrying on (thanks @keyle, fix #669)
|
|
||||||
* Fixed bug where move up and move down method in groups did not work (thanks @jonthulu, fix #684)
|
|
||||||
* Fixed bug in Group.next when cursor is at the last child (thanks @jonthulu, fix #688)
|
|
||||||
* Emitter.minParticleScale and maxParticleScale wasn't resetting the Body size correctly.
|
|
||||||
* Group.removeBetween now properly iterates through the children.
|
|
||||||
* P2.World had a type in the restitution method title. Now fixed.
|
|
||||||
* Objects with an InputHandler now deactivate it when the object is removed from a Group but not destroyed (fix #672)
|
|
||||||
* Fixed the vectors used in the BlurX and BlurY filters (thanks @nickryall, fix #668)
|
|
||||||
|
|
||||||
### p2.js v0.5.0
|
|
||||||
|
|
||||||
* Added property .enableIslandSleeping to World.
|
|
||||||
* Added property .useFrictionGravityOnZeroGravity to World.
|
|
||||||
* Renamed .useWorldGravityForFrictionApproximation in World to .useWorldGravityAsFrictionGravity to keep things more uniform.
|
|
||||||
* Sleep improvements.
|
|
||||||
* Added property .frictionIterations to GSSolver, and removed .skipFrictionIterations.
|
|
||||||
* Upgraded to gl-matrix 2.1.0.
|
|
||||||
* Removed QuadTree.
|
|
||||||
* Removed mat2.
|
|
||||||
* Added Utils.extend.
|
|
||||||
* Added methods .setStiffness and .setRelaxation methods to Constraint.
|
|
||||||
* Removed properties .stiffness, .relaxation and .useGlobalEquationParameters from GSSolver.
|
|
||||||
* Added methods .setGlobalStiffness, .setGlobalRelaxation, .setGlobalEquationParameters to World.
|
|
||||||
* Renamed property .eps to .epsilon for Equation.
|
|
||||||
* Removed property .useBoundingBoxes from NaiveBroadphase in favor of the new property .boundingVolumeType in Broadphase.
|
|
||||||
* Added methods .getMaxForce and .setMaxForce to LockConstraint.
|
|
||||||
* Changed property names .bi, .bj, .ni, .ri, .rj to .bodyA, .bodyB, .normalA, .contactPointA, .contactPointB in Equation, ContactEquation and FrictionEquation classes.
|
|
||||||
* Removed IslandSolver in favor of the new property World.islandSplit.
|
|
||||||
* Changed constructors of the Constraints so they all take an options object as last parameter.
|
|
||||||
* Added property .collideConnected to Constraint.
|
|
||||||
* Added property .islandSplit to World.
|
|
||||||
* Added methods .disableBodyCollision and .enableBodyCollision to World.
|
|
||||||
* Added properties .useWorldGravityForFrictionApproximation and .frictionGravity to World.
|
|
||||||
* Added Heightfield class.
|
|
||||||
* Removed properties .defaultFriction and .defaultRestitution from World, in favor of .defaultContactMaterial.
|
|
||||||
* Added property .enabled to Equation.
|
|
||||||
* Added property .surfaceVelocity to ContactMaterial.
|
|
||||||
* Added property .sensor to Shape.
|
|
||||||
* World now emits events 'beginContact', 'endContact' and 'preSolve'.
|
|
||||||
* Added property .gravityScale to Body.
|
|
||||||
* Renamed class SAP1DBroadphase to SAPBroadphase.
|
|
||||||
* Added property .interpolatedPosition to Body`.
|
|
||||||
* Added method .internalStep to World.
|
|
||||||
* Added property .applyGravity to World.
|
|
||||||
* Renamed method .computeC to .computeInvC in Equation, and made it compute the inverse.
|
|
||||||
* Added static method Utils.splice.
|
|
||||||
* Added property .world to Body.
|
|
||||||
* Added property .fixedRotation to Body.
|
|
||||||
* Added class AABB.
|
|
||||||
* Added properties .aabb and .aabbNeedsUpdate to Body, as well as a method .updateAABB.
|
|
||||||
* Added property .useBoundingBoxes to NaiveBroadphase.
|
|
||||||
* Added static method Broadphase.aabbCheck.
|
|
||||||
* Added method .computeAABB to Shape.
|
|
||||||
* Added static method Broadphase.canCollide.
|
|
||||||
* Body now inherits from EventEmitter, and dispatches events 'sleep','sleepy' and 'wakeup'.
|
|
||||||
* Added properties .allowSleep, .sleepState, .sleepSpeedLimit, .sleepTimeLimit, .lastTimeSleepy as well as methods .sleep, .wakeUp and .sleepTick to Body.
|
|
||||||
* Added enums Body.AWAKE, Body.SLEEPY, Body.SLEEPING.
|
|
||||||
* Added property .enableBodySleeping to World.
|
|
||||||
* Added options .disableRotationalLock, .lowerLimit, .upperLimit to PrismaticConstraint constructor.
|
|
||||||
* Added methods .enableMotor, .disableMotor to PrismaticConstraint as well as properties .motorEnabled, .motorSpeed, .motorEquation.
|
|
||||||
|
|
||||||
|
|
||||||
There is an extensive [Migration Guide](https://github.com/photonstorm/phaser/blob/master/resources/Migration%20Guide.md) available for those converting from Phaser 1.x to 2.x. In the guide we detail the API breaking changes and approach to our new physics system.
|
There is an extensive [Migration Guide](https://github.com/photonstorm/phaser/blob/master/resources/Migration%20Guide.md) available for those converting from Phaser 1.x to 2.x. In the guide we detail the API breaking changes and approach to our new physics system.
|
||||||
|
|
@ -254,11 +106,11 @@ Nice and easy :)
|
||||||
|
|
||||||
Thanks to a community member Phaser is now available on [CDNJS](http://cdnjs.com). You can include the following in your html:
|
Thanks to a community member Phaser is now available on [CDNJS](http://cdnjs.com). You can include the following in your html:
|
||||||
|
|
||||||
`http://cdnjs.cloudflare.com/ajax/libs/phaser/2.0.3/phaser.min.js`
|
`http://cdnjs.cloudflare.com/ajax/libs/phaser/2.0.4/phaser.min.js`
|
||||||
|
|
||||||
Or if you prefer you can leave the protocol off, so it works via http and https:
|
Or if you prefer you can leave the protocol off, so it works via http and https:
|
||||||
|
|
||||||
`//cdnjs.cloudflare.com/ajax/libs/phaser/2.0.3/phaser.min.js`
|
`//cdnjs.cloudflare.com/ajax/libs/phaser/2.0.4/phaser.min.js`
|
||||||
|
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "phaser",
|
"name": "phaser",
|
||||||
"version": "2.0.3",
|
"version": "2.0.4",
|
||||||
"homepage": "http://phaser.io",
|
"homepage": "http://phaser.io",
|
||||||
"authors": [
|
"authors": [
|
||||||
"photonstorm <rich@photonstorm.com>"
|
"photonstorm <rich@photonstorm.com>"
|
||||||
|
|
|
||||||
|
|
@ -2,6 +2,10 @@
|
||||||
|
|
||||||
There is an extensive [Migration Guide](https://github.com/photonstorm/phaser/blob/master/resources/Migration%20Guide.md) available for those converting from Phaser 1.x to 2.x. In the guide we detail the API breaking changes and approach to our new physics system.
|
There is an extensive [Migration Guide](https://github.com/photonstorm/phaser/blob/master/resources/Migration%20Guide.md) available for those converting from Phaser 1.x to 2.x. In the guide we detail the API breaking changes and approach to our new physics system.
|
||||||
|
|
||||||
|
## Version 2.0.4 - "Mos Shirare" - in development
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Version 2.0.3 - "Allorallen" - 11th April 2014
|
## Version 2.0.3 - "Allorallen" - 11th April 2014
|
||||||
|
|
||||||
### Updates
|
### Updates
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"name": "Phaser",
|
"name": "Phaser",
|
||||||
"version": "2.0.3",
|
"version": "2.0.4",
|
||||||
"release": "Allorallen",
|
"release": "Mos Shirare",
|
||||||
"description": "A fast, free and fun HTML5 Game Framework for Desktop and Mobile web browsers.",
|
"description": "A fast, free and fun HTML5 Game Framework for Desktop and Mobile web browsers.",
|
||||||
"author": "Richard Davey",
|
"author": "Richard Davey",
|
||||||
"logo": "https://raw.github.com/photonstorm/phaser/master/phaser-logo-small.png",
|
"logo": "https://raw.github.com/photonstorm/phaser/master/phaser-logo-small.png",
|
||||||
|
|
|
||||||
|
|
@ -11,7 +11,7 @@
|
||||||
var Phaser = Phaser || {
|
var Phaser = Phaser || {
|
||||||
|
|
||||||
VERSION: '<%= version %>',
|
VERSION: '<%= version %>',
|
||||||
DEV_VERSION: '2.0.3',
|
DEV_VERSION: '2.0.4',
|
||||||
GAMES: [],
|
GAMES: [],
|
||||||
|
|
||||||
AUTO: 0,
|
AUTO: 0,
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue