Egret EXP Release Note
===============================


Last Updated：30 July, 2015


Welcome to Egret Engine !


## Overview

Egret EXP community experience Edition is the first version of a community experience of Egret Engine v2.4. In this version, we focused primarily on the dirty rectangle rendering mechanism.


## Updated Items

This time’s update aggregates all the changes since the release of 2.0.


#### Programming Language

Egret currently support three types of languages, TypeScript, JavaScript and JavaScript 2.0 ( ES6 ).



#### Discarded functions
* Discarded the calling of explicitWidth, explicitHeight, measuredHeight, measuredWidth, and needDraw in DisplayObject.
* Discarded anchorX and anchorY. Please use anchorOffsetX and anchorOffsetY instead. 
* DisplayObject abandoned in hitTest method, no longer provide an override hit area method, if you want to call the point is within DisplayObject, please call hitTestPoint
* Discarded run, setTimeScale, getTimeScale, pause and resume in Ticker.
* Discarded ctrlKey, altKey and shiftKey in Event. 
* For Stage alpha, visible, x, y, scaleX, scaleY, rotation, cacheAsBitmap, scrollRect, filters, blendMode, touchEnabled or matrix can no longer be set. 

#### API changes
* Graphics collision is not the same, specifically by the
   Rectangle collision becomes completely
   Depending on the graphics graphic collisions.

* In TouchEvent, dispatchTouchEvent changed from 
  target:IEventDispatcher,type:string,touchPointID:number = 0, stageX:number = 0, stageY:number = 0, ctrlKey:boolean=false,altKey:boolean=false,shiftKey:boolean=false,touchDown:boolean=false  to 
  target:IEventDispatcher, type:string, bubbles?:boolean, cancelable?:boolean, stageX?:number, stageY?:number, touchPointID?:number, touchDown:boolean = false

* In TouchEvent, localX local’s implementation changed from
  localX localY VS currentTarget to
  localX localY VS target. If it was used，please implement by stageX stageY.

* fps implementation changes from
  controlling fps through Profiler to
  directly setting index.html. Open Close data-show-fps = "true", set fps position size color data-show-fps-style = "x: 0, y: 600, size: 50, textColor: 0xff0000"

* Screen adaptation of NO_SCALE inconsistent. From
  stage.stageWdith remains unchanged to
  stage.stageWidth range varies depending on the display


* Screen adaptation of NO_BORDER inconsistent. From
  matching height or width with a different anchor to
  a mode that after NO_BORDER matching, stage height and width will not change but extra part will be cut. If NO_BORDER was used, please replace it with FIXED_WIDTH or FIXED_HEIGHT. For details please refer to StageScaleMode.

* Texture scaling implementation changed from
  setting egret.MainContext.instance.rendererContext.texture_scale_factor with corresponding image and config file to
  just changing image size, which means config file stays unchanged in all texture scaling settings but image size changes.
  Also, the setting method is to set stage’s textureScaleFactor or directly set texture-scale-factor="1" in index.html. texture-scale-factor="2" means resource shrinks to its original’s half in height and width.

* Property stage display changed from
  calling stage.changeSize to
  calling egret.updateAllScreens().

* Container’s blank area can not be clicked anymore.

* Multi-touch changed from
  settingTouchContext.maxTouches to
  setting stage.maxTouches. Default value changed from 99 to 2.

* Entrance file changed from
  egret.loader calling to
  calling egret.runEgret() directly in index.html and configuring relevant file class name, scale mode and stage width and height and etc.

* js file loading changed from
  on-the-fly creating and loading to
  placing inindex.html through script commands.

* HTML file’s canvas creation changed from
  <div style="position:relative;" id="gameDiv"></div> to
  <div id="egret-sample" style="margin: auto;width: 100%;height: 100%;" class="egret-player"
       data-entry-class="Main"
       data-scale-mode="showAll"
       data-orientation="auto"
       texture-scale-factor="1"
       data-orientation="portrait"
       data-content-width="480"
       data-content-height="800"
       data-show-paint-rect="false"
       data-show-fps="true"
       data-show-fps-style="x:0,y:0,size:24,textColor:0xffffff"
       data-show-log="false" data-log-filter="">
  </div>
  which can set a few game parameters.

#### New functions
* In DisplayObject , mask can support Rectangle and DisplayObjec simultaneously. 

* Screen matching supports rotation and can assign landscape mode. 
  In index.html, 
     data-orientation="auto" sets portrait and landscape modes，for details please refer to    	OrientationMode;
     data-content-width="480" sets width     
 data-content-height="800" sets height

* Set dirty rectangle display area
  Set data-show-paint-rect="false" in index.html.
  
* Since parent class property calling is not supported, a new API is added. 
  egret.superSetter(this, "alpha", 1); replaces super.alpha = 1; in other languages.
  egret.superGetter(this, "alpha"); replaces super.alpha in other languages.

* Added Bitmap smoothing property, after setting the picture will be smoothed

* Added Bitmap pixelHitTest property, after setting the picture support pixel collision.

#### Functions not added
* webGL, filter
* native

#### Notes
* If methods and properties in engine were called , please refer to latest corresponding methods and properties.