Gauge class
class Gauge extends DisplayObject {
static const String DIRECTION_UP = 'DIRECTION_UP';
static const String DIRECTION_RIGHT = 'DIRECTION_RIGHT';
static const String DIRECTION_DOWN = 'DIRECTION_DOWN';
static const String DIRECTION_LEFT = 'DIRECTION_LEFT';
String _direction;
num _ratio;
BitmapData _bitmapData;
Rectangle _clipRectangle;
Gauge(BitmapData bitmapData, [String direction = DIRECTION_LEFT]) {
if (direction != DIRECTION_UP && direction != DIRECTION_DOWN &&
direction != DIRECTION_LEFT && direction != DIRECTION_RIGHT) {
throw new ArgumentError('Invalid Gauge direction!');
}
_direction = direction;
_ratio = 1.0;
_bitmapData = bitmapData;
_clipRectangle = new Rectangle.zero();
_updateMask();
}
//-------------------------------------------------------------------------------------------------
//-------------------------------------------------------------------------------------------------
num get ratio => _ratio;
set ratio(num value) {
if (value < 0.0) value = 0.0;
if (value > 1.0) value = 1.0;
_ratio = value;
_updateMask();
}
//-------------------------------------------------------------------------------------------------
BitmapData get bitmapData => _bitmapData;
set bitmapData(BitmapData value) {
_bitmapData = value;
_updateMask();
}
//-------------------------------------------------------------------------------------------------
_updateMask() {
if (_bitmapData == null) {
_clipRectangle.left = 0;
_clipRectangle.top = 0;
_clipRectangle.right = 0;
_clipRectangle.bottom = 0;
} else {
int bdWidth = _bitmapData.width;
int bdHeight = _bitmapData.height;
switch (_direction)
{
case DIRECTION_LEFT:
_clipRectangle.left = ((1.0 - _ratio) * bdWidth).toInt();
_clipRectangle.top = 0;
_clipRectangle.right = bdWidth;
_clipRectangle.bottom = bdHeight;
break;
case DIRECTION_UP:
_clipRectangle.left = 0;
_clipRectangle.top = ((1.0 - _ratio) * bdHeight).toInt();
_clipRectangle.right = bdWidth;
_clipRectangle.bottom = bdHeight;
break;
case DIRECTION_RIGHT:
_clipRectangle.left = 0;
_clipRectangle.top = 0;
_clipRectangle.right = (_ratio * bdWidth).toInt();
_clipRectangle.bottom = bdHeight;
break;
case DIRECTION_DOWN:
_clipRectangle.left = 0;
_clipRectangle.top = 0;
_clipRectangle.right = bdWidth;
_clipRectangle.bottom = (_ratio * bdHeight).toInt();
break;
}
}
}
//-------------------------------------------------------------------------------------------------
//-------------------------------------------------------------------------------------------------
Rectangle getBoundsTransformed(Matrix matrix, [Rectangle returnRectangle]) {
int width = (_bitmapData != null) ? _bitmapData.width : 0;
int height = (_bitmapData != null) ? _bitmapData.height : 0;
return _getBoundsTransformedHelper(matrix, width, height, returnRectangle);
}
//-------------------------------------------------------------------------------------------------
DisplayObject hitTestInput(num localX, num localY) {
if (_bitmapData != null && localX >= 0.0 && localY >= 0.0 && localX < _bitmapData.width && localY < _bitmapData.height)
return this;
return null;
}
//-------------------------------------------------------------------------------------------------
void render(RenderState renderState) {
if (_bitmapData != null)
_bitmapData.renderClipped(renderState, _clipRectangle);
}
}
Extends
EventDispatcher > DisplayObject > Gauge
Subclasses
Static Properties
Constructors
new Gauge(BitmapData bitmapData, [String direction = DIRECTION_LEFT]) #
Creates a new Object instance.
Object instances have no meaningful state, and are only useful through their identity. An Object instance is equal to itself only.
docs inherited from Object
Gauge(BitmapData bitmapData, [String direction = DIRECTION_LEFT]) {
if (direction != DIRECTION_UP && direction != DIRECTION_DOWN &&
direction != DIRECTION_LEFT && direction != DIRECTION_RIGHT) {
throw new ArgumentError('Invalid Gauge direction!');
}
_direction = direction;
_ratio = 1.0;
_bitmapData = bitmapData;
_clipRectangle = new Rectangle.zero();
_updateMask();
}
Properties
num alpha #
inherited from DisplayObject
num get alpha => _alpha;
set alpha(num value) {
if (value is num) {
if (value < 0.0) value = 0.0;
if (value > 1.0) value = 1.0;
_alpha = value;
}
}
BitmapData bitmapData #
BitmapData get bitmapData => _bitmapData;
set bitmapData(BitmapData value) {
_bitmapData = value;
_updateMask();
}
String compositeOperation #
inherited from DisplayObject
String get compositeOperation => _compositeOperation;
set compositeOperation(String value) {
_compositeOperation = value;
}
List<BitmapFilter> filters #
inherited from DisplayObject
List<BitmapFilter> get filters {
if (_filters == null) _filters = new List<BitmapFilter>();
return _filters;
}
set filters(List<BitmapFilter> value) {
_filters = value;
}
num height #
inherited from DisplayObject
num get height => getBoundsTransformed(this.transformationMatrix).height;
void set height(num value) {
this.scaleY = 1;
num normalHeight = this.height;
this.scaleY = (normalHeight != 0.0) ? value / normalHeight : 1.0;
}
Mask mask #
inherited from DisplayObject
Mask get mask => _mask;
set mask(Mask value) {
_mask = value;
}
final Point mousePosition #
inherited from DisplayObject
Point get mousePosition {
var stage = this.stage;
return (stage != null) ? this.globalToLocal(stage._mousePosition) : null;
}
final num mouseX #
inherited from DisplayObject
num get mouseX {
var mp = this.mousePosition;
return (mp != null) ? mp.x : 0.0;
}
final num mouseY #
inherited from DisplayObject
num get mouseY {
var mp = this.mousePosition;
return (mp != null) ? mp.y : 0.0;
}
String name #
inherited from DisplayObject
String get name => _name;
set name(String value) {
_name = value;
}
bool off #
inherited from DisplayObject
bool get off => _off;
set off(bool value) {
if (value is bool) _off = value;
}
final EventStream<Event> onAdded #
inherited from DisplayObject
EventStream<Event> get onAdded => DisplayObject.addedEvent.forTarget(this);
final EventStream<Event> onAddedToStage #
inherited from DisplayObject
EventStream<Event> get onAddedToStage => DisplayObject.addedToStageEvent.forTarget(this);
final EventStream<EnterFrameEvent> onEnterFrame #
inherited from DisplayObject
EventStream<EnterFrameEvent> get onEnterFrame => DisplayObject.enterFrameEvent.forTarget(this);
final EventStream<ExitFrameEvent> onExitFrame #
inherited from DisplayObject
EventStream<ExitFrameEvent> get onExitFrame => DisplayObject.exitFrameEvent.forTarget(this);
final EventStream<Event> onRemoved #
inherited from DisplayObject
EventStream<Event> get onRemoved => DisplayObject.removedEvent.forTarget(this);
final EventStream<Event> onRemovedFromStage #
inherited from DisplayObject
EventStream<Event> get onRemovedFromStage => DisplayObject.removedFromStageEvent.forTarget(this);
final EventStream<RenderEvent> onRender #
inherited from DisplayObject
EventStream<RenderEvent> get onRender => DisplayObject.renderEvent.forTarget(this);
final DisplayObjectContainer parent #
inherited from DisplayObject
DisplayObjectContainer get parent => _parent;
num pivotX #
inherited from DisplayObject
num get pivotX => _pivotX;
set pivotX(num value) {
if (value is num) _pivotX = value;
_transformationMatrixRefresh = true;
}
num pivotY #
inherited from DisplayObject
num get pivotY => _pivotY;
set pivotY(num value) {
if (value is num) _pivotY = value;
_transformationMatrixRefresh = true;
}
num ratio #
num get ratio => _ratio;
set ratio(num value) {
if (value < 0.0) value = 0.0;
if (value > 1.0) value = 1.0;
_ratio = value;
_updateMask();
}
final DisplayObject root #
inherited from DisplayObject
DisplayObject get root {
DisplayObject currentObject = this;
while (currentObject._parent != null)
currentObject = currentObject._parent;
return currentObject;
}
num rotation #
inherited from DisplayObject
num get rotation => _rotation;
set rotation(num value) {
if (value is num) _rotation = value;
_transformationMatrixRefresh = true;
}
num scaleX #
inherited from DisplayObject
num get scaleX => _scaleX;
set scaleX(num value) {
if (value is num) _scaleX = value;
_transformationMatrixRefresh = true;
}
num scaleY #
inherited from DisplayObject
num get scaleY => _scaleY;
set scaleY(num value) {
if (value is num) _scaleY = value;
_transformationMatrixRefresh = true;
}
Shadow shadow #
inherited from DisplayObject
Shadow get shadow => _shadow;
set shadow(Shadow value) {
_shadow = value;
}
num skewX #
inherited from DisplayObject
num get skewX => _skewX;
set skewX(num value) {
if (value is num) _skewX = value;
_transformationMatrixRefresh = true;
}
num skewY #
inherited from DisplayObject
num get skewY => _skewY;
set skewY(num value) {
if (value is num) _skewY = value;
_transformationMatrixRefresh = true;
}
final Stage stage #
inherited from DisplayObject
Stage get stage {
DisplayObject root = this.root;
return (root is Stage) ? root : null;
}
final Matrix transformationMatrix #
inherited from DisplayObject
Matrix get transformationMatrix {
/*
_transformationMatrix.identity();
_transformationMatrix.translate(-_pivotX, -_pivotY);
_transformationMatrix.scale(_scaleX, _scaleY);
_transformationMatrix.rotate(_rotation);
_transformationMatrix.translate(_x, _y);
*/
if (_transformationMatrixRefresh) {
_transformationMatrixRefresh = false;
num skewXrotation = _skewX + _rotation;
num skewYrotation = _skewY + _rotation;
num scaleX = _scaleX;
num scaleY = _scaleY;
num pivotX = _pivotX;
num pivotY = _pivotY;
// ToDo: https://bugzilla.mozilla.org/show_bug.cgi?id=661452
if (scaleX > -0.0001 && scaleX < 0.0001) scaleX = (scaleX >= 0) ? 0.0001 : -0.0001;
if (scaleY > -0.0001 && scaleY < 0.0001) scaleY = (scaleY >= 0) ? 0.0001 : -0.0001;
if (skewXrotation == 0.0 && skewYrotation == 0.0) {
_transformationMatrix.setTo(scaleX, 0.0, 0.0, scaleY, _x - pivotX * scaleX, _y - pivotY * scaleY);
} else {
num a, b, c, d;
num cosX = cos(skewXrotation);
num sinX = sin(skewXrotation);
if (skewXrotation == skewYrotation) {
a = scaleX * cosX;
b = scaleX * sinX;
c = - scaleY * sinX;
d = scaleY * cosX;
} else {
a = scaleX * cos(skewYrotation);
b = scaleX * sin(skewYrotation);
c = - scaleY * sinX;
d = scaleY * cosX;
}
num tx = _x - (pivotX * a + pivotY * c);
num ty = _y - (pivotX * b + pivotY * d);
_transformationMatrix.setTo(a, b, c, d, tx, ty);
}
}
return _transformationMatrix;
}
var userData #
inherited from DisplayObject
Gets or sets user-defined data associated with the display object.
dynamic userData = null
bool visible #
inherited from DisplayObject
bool get visible => _visible;
set visible(bool value) {
if (value is bool) _visible = value;
}
num width #
inherited from DisplayObject
num get width => getBoundsTransformed(this.transformationMatrix).width;
void set width(num value) {
this.scaleX = 1;
num normalWidth = this.width;
this.scaleX = (normalWidth != 0.0) ? value / normalWidth : 1.0;
}
num x #
inherited from DisplayObject
num get x => _x;
set x(num value) {
if (value is num) _x = value;
_transformationMatrixRefresh = true;
}
num y #
inherited from DisplayObject
num get y => _y;
set y(num value) {
if (value is num) _y = value;
_transformationMatrixRefresh = true;
}
Methods
StreamSubscription<Event> addEventListener(String eventType, EventListener eventListener, {bool useCapture: false, int priority: 0}) #
inherited from EventDispatcher
StreamSubscription<Event> addEventListener(String eventType, EventListener eventListener, {
bool useCapture: false, int priority: 0 }) {
return this.on(eventType)._subscribe(eventListener, useCapture, priority);
}
void addTo(DisplayObjectContainer parent) #
inherited from DisplayObject
void addTo(DisplayObjectContainer parent) {
parent.addChild(this);
}
void applyCache(int x, int y, int width, int height, {bool debugBorder: false}) #
inherited from DisplayObject
void applyCache(int x, int y, int width, int height, {bool debugBorder: false}) {
var pixelRatio = Stage.autoHiDpi ? _devicePixelRatio : 1.0;
if (_cacheTexture == null) {
_cacheTexture = new RenderTexture(width, height, true, Color.Transparent, pixelRatio);
} else {
_cacheTexture.resize(width, height);
}
_cacheRectangle = new Rectangle(x, y, width, height);
_cacheDebugBorder = debugBorder;
refreshCache();
}
void dispatchEvent(Event event) #
inherited from DisplayObject
void dispatchEvent(Event event) {
List<DisplayObject> ancestors = null;
if (event.captures || event.bubbles) {
for(DisplayObject ancestor = parent; ancestor != null; ancestor = ancestor.parent) {
if(ancestor._hasPropagationEventListeners(event)) {
if (ancestors == null) ancestors = [];
ancestors.add(ancestor);
}
}
}
if (ancestors != null && event.captures) {
for(int i = ancestors.length - 1 ; i >= 0; i--) {
ancestors[i]._dispatchEventInternal(event, this, EventPhase.CAPTURING_PHASE);
if (event.stopsPropagation) return;
}
}
_dispatchEventInternal(event, this, EventPhase.AT_TARGET);
if (event.stopsPropagation) return;
if (ancestors != null && event.bubbles) {
for(int i = 0; i < ancestors.length; i++) {
ancestors[i]._dispatchEventInternal(event, this, EventPhase.BUBBLING_PHASE);
if (event.stopsPropagation) return;
}
}
}
Rectangle getBounds(DisplayObject targetSpace) #
inherited from DisplayObject
Rectangle getBounds(DisplayObject targetSpace) {
Rectangle returnRectangle = new Rectangle.zero();
Matrix matrix = (targetSpace == null) ? transformationMatrix : transformationMatrixTo(targetSpace);
return (matrix != null) ? getBoundsTransformed(matrix, returnRectangle) : returnRectangle;
}
Rectangle getBoundsTransformed(Matrix matrix, [Rectangle returnRectangle]) #
Rectangle getBoundsTransformed(Matrix matrix, [Rectangle returnRectangle]) {
int width = (_bitmapData != null) ? _bitmapData.width : 0;
int height = (_bitmapData != null) ? _bitmapData.height : 0;
return _getBoundsTransformedHelper(matrix, width, height, returnRectangle);
}
Point globalToLocal(Point globalPoint) #
inherited from DisplayObject
Point globalToLocal(Point globalPoint) {
_tmpMatrix.identity();
for(var current = this; current != null; current = current._parent) {
_tmpMatrix.concat(current.transformationMatrix);
}
_tmpMatrix.invert();
return _tmpMatrix.transformPoint(globalPoint);
}
bool hasEventListener(String eventType) #
inherited from EventDispatcher
bool hasEventListener(String eventType) {
var eventStreams = _eventStreams;
if (eventStreams == null) return false;
var eventStream = eventStreams[eventType];
if (eventStream == null) return false;
return eventStream.hasSubscriptions;
}
DisplayObject hitTestInput(num localX, num localY) #
DisplayObject hitTestInput(num localX, num localY) {
if (_bitmapData != null && localX >= 0.0 && localY >= 0.0 && localX < _bitmapData.width && localY < _bitmapData.height)
return this;
return null;
}
bool hitTestObject(DisplayObject other) #
inherited from DisplayObject
bool hitTestObject(DisplayObject other) {
var stage1 = this.stage;
var stage2 = other.stage;
if (stage1 == null || stage2 == null || stage1 != stage2) return false;
var rect1 = this.getBounds(stage1);
var rect2 = other.getBounds(stage2);
return rect1.intersects(rect2);
}
bool hitTestPoint(num x, num y, [bool shapeFlag = false]) #
inherited from DisplayObject
bool hitTestPoint(num x, num y, [bool shapeFlag = false]) {
var stage = this.stage;
if (stage == null) return false;
if (shapeFlag) {
var matrix = stage.transformationMatrixTo(this);
if (matrix == null) return false;
var stagePoint = new Point(x, y);
var localPoint = matrix.transformPoint(stagePoint);
return this.hitTestInput(localPoint.x, localPoint.y) != null;
} else {
var rect = this.getBounds(stage);
return rect.contains(x, y);
}
}
Point localToGlobal(Point localPoint) #
inherited from DisplayObject
Point localToGlobal(Point localPoint) {
_tmpMatrix.identity();
for(var current = this; current != null; current = current._parent) {
_tmpMatrix.concat(current.transformationMatrix);
}
return _tmpMatrix.transformPoint(localPoint);
}
EventStream<Event> on(String eventType) #
inherited from EventDispatcher
EventStream<Event> on(String eventType) {
var eventStreams = _eventStreams;
if (eventStreams == null) {
eventStreams = new Map<String, EventStream>();
_eventStreams = eventStreams;
}
var eventStream = eventStreams[eventType];
if (eventStream == null) {
eventStream = new EventStream._internal(this, eventType);
eventStreams[eventType] = eventStream;
}
return eventStream;
}
void refreshCache() #
inherited from DisplayObject
void refreshCache() {
if (_cacheTexture == null) return;
var x = _cacheRectangle.x;
var y = _cacheRectangle.y;
var width = _cacheRectangle.width;
var height = _cacheRectangle.height;
var canvas = _cacheTexture.canvas;
var matrix = _cacheTexture.quad.drawMatrix..translate(-x, -y);
var renderContext = new RenderContextCanvas(canvas, Color.Transparent);
var renderState = new RenderState(renderContext, matrix);
renderContext.clear();
render(renderState);
if (_filters != null) {
var cacheBitmapData = new BitmapData.fromRenderTextureQuad(_cacheTexture.quad);
var bounds = this.getBoundsTransformed(_identityMatrix)..offset(-x, -y);
for(var filter in _filters) {
var filterOverlap = filter.overlap;
var filterBounds = bounds.clone();
filterBounds.offset(filterOverlap.x, filterOverlap.y);
filterBounds.inflate(filterOverlap.width, filterOverlap.height);
filter.apply(cacheBitmapData, filterBounds.align());
}
}
if (_cacheDebugBorder) {
canvas.context2D
..setTransform(1.0, 0.0, 0.0, 1.0, 0.0, 0.0)
..lineWidth = 1
..lineJoin = "miter"
..lineCap = "butt"
..strokeStyle = "#FF00FF"
..strokeRect(0.5, 0.5, canvas.width - 1, canvas.height - 1);
}
_cacheTexture.update();
}
void removeCache() #
inherited from DisplayObject
void removeCache() {
if (_cacheTexture != null) {
_cacheTexture.dispose();
_cacheTexture = null;
}
}
void removeEventListener(String eventType, EventListener eventListener, {bool useCapture: false}) #
inherited from EventDispatcher
void removeEventListener(String eventType, EventListener eventListener, {
bool useCapture: false }) {
this.on(eventType)._unsubscribe(eventListener, useCapture);
}
void removeEventListeners(String eventType) #
inherited from EventDispatcher
void removeEventListeners(String eventType) {
this.on(eventType).cancelSubscriptions();
}
void removeFromParent() #
inherited from DisplayObject
void removeFromParent() {
if (_parent != null)
_parent.removeChild(this);
}
void render(RenderState renderState) #
void render(RenderState renderState) {
if (_bitmapData != null)
_bitmapData.renderClipped(renderState, _clipRectangle);
}
void setTransform(num x, num y, [num scaleX, num scaleY, num rotation, num skewX, num skewY, num pivotX, num pivotY]) #
inherited from DisplayObject
void setTransform(num x, num y, [num scaleX, num scaleY, num rotation, num skewX, num skewY, num pivotX, num pivotY]) {
if (x is num) _x = x;
if (y is num) _y = y;
if (scaleX is num) _scaleX = scaleX;
if (scaleY is num) _scaleY = scaleY;
if (rotation is num) _rotation = rotation;
if (skewX is num) _skewX = skewX;
if (skewY is num) _skewY = skewY;
if (pivotX is num) _pivotX = pivotX;
if (pivotY is num) _pivotY = pivotY;
_transformationMatrixRefresh = true;
}
Matrix transformationMatrixTo(DisplayObject targetSpace) #
inherited from DisplayObject
Matrix transformationMatrixTo(DisplayObject targetSpace) {
if (targetSpace == _parent) {
return this.transformationMatrix.clone();
}
if (targetSpace != null && targetSpace._parent == this) {
return targetSpace.transformationMatrix.cloneInvert();
}
//------------------------------------------------
Matrix resultMatrix = new Matrix.fromIdentity();
DisplayObject resultObject = this;
while(resultObject != targetSpace && resultObject._parent != null) {
resultMatrix.concat(resultObject.transformationMatrix);
resultObject = resultObject._parent;
}
if (targetSpace == null && resultObject != null) {
resultMatrix.concat(resultObject.transformationMatrix);
resultObject = null;
}
if (resultObject == targetSpace)
return resultMatrix;
//------------------------------------------------
Matrix targetMatrix = new Matrix.fromIdentity();
DisplayObject targetObject = targetSpace;
while(targetObject != this && targetObject._parent != null) {
targetMatrix.concat(targetObject.transformationMatrix);
targetObject = targetObject._parent;
}
targetMatrix.invert();
if (targetObject == this) {
return targetMatrix;
}
if (targetObject != resultObject) {
return null;
}
resultMatrix.concat(targetMatrix);
return resultMatrix;
}