API Docs for: 最后更新日期:2014年8月25日
Google搜索   
Show:

File: display/LDisplayObject.js

/** @language japanese
 * <p>LDisplayObject クラスは、表示リストに含めることのできるすべてのオブジェクトに関する基本クラスです。表示リストでは、ランタイムに表示されるすべてのオブジェクトを管理します。LDisplayObjectContainer クラスは、表示リスト内で表示オブジェクトを配置するために使用します。LDisplayObjectContainer オブジェクトは子表示オブジェクトを持つことができます。これに対して、他の表示オブジェクト(例えば LShape、LTextField オブジェクト)は「リーフ」ノードです。つまり、親と兄弟だけを持ち、子はありません。</p>
 * <p>LDisplayObject クラスは、基本機能(例えばオブジェクトの x 方向および y 方向の位置)に加えて、オブジェクトの拡張プロパティ(例えば変換マトリックス)をサポートします。</p>
 * <p>LDisplayObject は抽象基本クラスであるため、LDisplayObject を直接呼び出すことはできません。</p>
 * <p>すべての表示オブジェクトは LDisplayObject クラスから継承します。</p>
 * @class LDisplayObject
 * @extends LEventDispatcher
 * @constructor
 * @since 1.6.0
 * @public
 */
var LDisplayObject = (function () {
	function LDisplayObject () {
		var s = this;
		LExtends(s, LEventDispatcher, []);
		s.name = "instance" + s.objectIndex;
		/** @language japanese
		 * 親 LDisplayObjectContainer のローカル座標を基準にした LDisplayObject インスタンスの x 座標を示します。変形されている LDisplayObjectContainer にオブジェクトが含まれる場合、そのオブジェクトの座標系は、それを囲む LDisplayObjectContainer のローカル座標系になります。したがって、反時計回りに 90 度回転した LDisplayObjectContainer の場合、その LDisplayObjectContainer の子は、反時計回りに 90 度回転した座標系を継承します。オブジェクトの座標は、基準点の位置を参照します。
		 * @property x
		 * @type float
		 * @default 0
		 * @since 1.6.0
		 * @public
		 */
		s.x = 0;
		/** @language japanese
		 * 親 LDisplayObjectContainer のローカル座標を基準にした LDisplayObject インスタンスの y 座標を示します。変形されている LDisplayObjectContainer にオブジェクトが含まれる場合、そのオブジェクトの座標系は、それを囲む LDisplayObjectContainer のローカル座標系になります。したがって、反時計回りに 90 度回転した LDisplayObjectContainer の場合、その LDisplayObjectContainer の子は、反時計回りに 90 度回転した座標系を継承します。オブジェクトの座標は、基準点の位置を参照します。
		 * @property y
		 * @type float
		 * @default 0
		 * @since 1.6.0
		 * @public
		 */
		s.y = 0;
		s.width = 0;
		s.height = 0;
		/** @language japanese
		 * 基準点から適用されるオブジェクトの水平スケール(パーセンテージ)を示します。 デフォルトの基準点は (0,0) です。1.0 は縮尺 100% と同等です。
		 * @property scaleX
		 * @type float
		 * @default 1
		 * @since 1.6.0
		 * @public
		 */
		s.scaleX = 1;
		/** @language japanese
		 * オブジェクトの基準点から適用されるオブジェクトの垂直スケール(パーセンテージ)を示します。 デフォルトの基準点は (0,0) です。1.0 は縮尺 100% です。
		 * @property scaleY
		 * @type float
		 * @default 1
		 * @since 1.6.0
		 * @public
		 */
		s.scaleY = 1;
		/** @language japanese
		 * 指定されたオブジェクトのアルファ透明度値を示します。有効な値は 0(完全な透明)~ 1(完全な不透明)です。デフォルト値は 1 です。alpha が 0 に設定されている表示オブジェクトは、表示されない場合でも、アクティブです。
		 * @property alpha
		 * @type float
		 * @default 0
		 * @since 1.6.0
		 * @public
		 */
		s.alpha = 1;
		/** @language japanese
		 * 表示オブジェクトが可視かどうかを示します。非可視の表示オブジェクトは無効になります。例えば、ある LInteractiveObject インスタンスが visible=false に設定されている場合、これをクリックすることはできません。
		 * @property visible
		 * @type Boolean
		 * @default true
		 * @since 1.6.0
		 * @public
		 */
		s.visible = true;
		/** @language japanese
		 * LDisplayObject インスタンスの元の位置からの回転角を度単位で示します。時計回りに回転させる場合は 0 ~ 180 の値を指定します。反時計回りに回転させる場合は 0 ~ -180 の値を指定します。この範囲を超える値は、360 を加算または減算して、範囲内に収まる値になるように調整されます。例えば、my_video.rotate = 450 というステートメントは my_video.rotate = 90 と同義です。
		 * @property rotate
		 * @type float
		 * @default 0
		 * @since 1.6.0
		 * @public
		 */
		s.rotate = 0;
		/** @language japanese
		 * 呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。ステージの拡大および縮小時にマスクが確実に機能するためには、表示リストのアクティブな部分に mask 表示オブジェクトが含まれている必要があります。mask オブジェクト自体は描画されません。マスクを除去するには mask を null に設定します。
		 * @property mask
		 * @type LDisplayObject
		 * @default null
		 * @since 1.6.0
		 * @public
		 */
		s.mask = null;
		/** @language japanese
		 * 使用するブレンドモードを指定する LBlendMode クラスの値です。内部的には、2 つの方法でビットマップを描画できます。ブレンドモードを有効にした場合、または外部クリッピングマスクを使用する場合には、ビットマップで塗りつぶされた四角形シェイプをベクターレンダーに追加することによってビットマップが描画されます。このプロパティを無効な値に設定しようとすると、ランタイムは値を LBlendMode.NORMAL に設定します。
		 * @property blendMode
		 * @type String
		 * @default null
		 * @since 1.8.0
		 * @public
		 */
		s.blendMode = null;
		/** @language japanese
		 * 表示オブジェクトに現在関連付けられている各フィルターオブジェクトが格納されているインデックス付きの配列です。
		 * @property filters
		 * @type Array
		 * @default null
		 * @since 1.6.0
		 * @public
		 */
		s.filters = null;
	}
	var p = {
		_createCanvas:function(){
			var s = this;
			if (!s._canvas) {
				s._canvas = document.createElement("canvas");
				s._context = s._canvas.getContext("2d");
			}
		},
		ll_show : function () {
			var s = this, c = LGlobal.canvas;
			if (!s._canShow()) {
				return;
			}
			if (!LGlobal.box2d && typeof s._ll_loopframe == "function") {
				s._ll_loopframe();
			}
			c.save();
			s._showReady(c);
			if (s.blendMode) {
				c.globalCompositeOperation = s.blendMode;
			}
			if (s.filters) {
				s._ll_setShadow();
			}
			s._rotateReady();
			if (s.mask != null && s.mask.ll_show) {
				s.mask.ll_show();
				c.clip();
			}
			s._transformRotate();
			s._transformScale();
			s._coordinate(c);
			if (s.alpha < 1) {
				c.globalAlpha = s.alpha;
			}
			s._ll_show(c);
			c.restore();
			if (LGlobal.box2d != null && typeof s._ll_loopframe == "function") {
				s._ll_loopframe();
			}
		},
		_canShow : function () {
			return this.visible;
		},
		_coordinate : function (c) {
			var s = this;
			if (s.x != 0 || s.y != 0) {
				c.transform(1, 0, 0, 1, s.x, s.y);
			}
		},
		_rotateReady : function () {},
		_showReady : function (c) {},
		_ll_show : function (c) {},
		_ll_setShadow : function () {
			var s = this, f = s.filters, i, l;
			if (!f) {
				return;
			}
			for (i = 0, l = f.length; i < l; i++) {
				f[i].ll_show();
			}
		},
		_transformRotate : function () {
			var s = this, c;
			if (s.rotate == 0) {
				return;
			}
			c = LGlobal.canvas, rotateFlag = Math.PI / 180, rotateObj = new LMatrix();
			if ((typeof s.rotatex) == UNDEFINED) {
				s.rotatex = 0;
				s.rotatey = 0;
			}
			if (s.box2dBody) {
				rotateFlag = 1;
			}
			rotateObj.a = Math.cos(s.rotate * rotateFlag);
			rotateObj.b = Math.sin(s.rotate * rotateFlag);
			rotateObj.c = -rotateObj.b;
			rotateObj.d = rotateObj.a;
			rotateObj.tx = s.x + s.rotatex;
			rotateObj.ty = s.y + s.rotatey;
			rotateObj.transform(c).setTo(1, 0, 0, 1, -rotateObj.tx, -rotateObj.ty).transform(c);
		},
		_transformScale : function () {
			var s = this,c = LGlobal.canvas, scaleObj;
			if (s.scaleX == 1 && s.scaleY == 1) {
				return;
			}
			scaleObj = new LMatrix();
			if (s.scaleX != 1) {
				scaleObj.tx = s.x;
			}
			if (s.scaleY != 1) {
				scaleObj.ty = s.y;
			}
			scaleObj.a = s.scaleX;
			scaleObj.d = s.scaleY;
			scaleObj.transform(c).setTo(1, 0, 0, 1, -scaleObj.tx, -scaleObj.ty).transform(c);
		},
		copyProperty : function (a) {
			var s = this, k;
			for (k in a) {
				if (typeof a[k] == "number" || typeof a[k] == "string" || typeof a[k] == "boolean") {
					if (k == "objectindex" || k == "objectIndex") {
						continue;
					}
					s[k] = a[k];
				} else if (Array.isArray(a[k])) {
					s[k] = a[k].slice();
				} 
			}
			if (a.mask) {
				s.mask = a.mask.clone();
			}
		},
		getAbsoluteScale : function () {
			var s = this, sX, sY, p;
			sX = s.scaleX;
			sY = s.scaleY;
			p = s.parent;
			while (p && p != "root") {
				sX *= p.scaleX;
				sY *= p.scaleY;
				p = p.parent;
			}
			return {scaleX : sX, scaleY : sY};
		},
		/** @language japanese
		 * canvasの左上からの座標を取得する。
		 * @method getRootCoordinate
		 * @return {LPoint} LPointプロジェクット。
		 * @since 1.7.7
		 * @public
		 */
		getRootCoordinate : function () {
			var s = this, sx, sy, p;
			sx=s.x;
			sy=s.y;
			p = s.parent;
			while (p && p != "root") {
				sx *= p.scaleX;
				sy *= p.scaleY;
				sx += p.x;
				sy += p.y;
				p = p.parent;
			}
			return new LPoint(sx,sy);
		},
		/** @language japanese
		 * targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
		 * @method getBounds
		 * @param {LDisplayObject} targetCoordinateSpace 使用する座標系を定義する表示オブジェクトです。
		 * @return {LRectangle} targetCoordinateSpace オブジェクトの座標系を基準とする、表示オブジェクトの領域を定義する矩形です。
		 * @since 1.7.7
		 * @public
		 */
		getBounds : function (d) {
			if (typeof d == UNDEFINED) {
				return new LRectangle(0, 0, 0, 0);
			}
			var s = this, x = 0, y = 0, w = 0, h = 0, sp, dp;
			if (s.objectIndex != d.objectIndex) {
				sp = s.getRootCoordinate();
				dp = d.getRootCoordinate();
				x = sp.x - dp.x;
				y = sp.y - dp.y;
			}
			if (d.getWidth) {
				w = d.getWidth();
			}
			if (d.getHeight) {
				h = d.getHeight();
			}
			return new LRectangle(x, y, w, h);
		},
		getDataCanvas : function () {
			var s = this, _o, o, _c, c;
			s._createCanvas();
			o = LGlobal.canvasObj;
			c = LGlobal.canvas;
			_o = s._canvas;
			_c = s._context;
			s.width = s.getWidth();
			s.height = s.getHeight();
			_o.width = s.width;
			_o.height = s.height;
			_c.clearRect(0, 0, s.width, s.height);
			LGlobal.canvasObj = s._canvas;
			LGlobal.canvas = s._context;
			s.ll_show();
			s._canvas = _o;
			s._context = _c;
			LGlobal.canvasObj = o;
			LGlobal.canvas = c;
			return s._canvas;
		},
		/** @language japanese
		 * base64でエンコードされた画像の文字列を取得する。
		 * @method getDataURL
		 * @return {Base64 Image} base64でエンコードされた画像の文字列。
		 * @since 1.7.7
		 * @public
		 */
		getDataURL : function () {
			var s = this, r = s.getDataCanvas();
			return r.toDataURL();
		},
		ismouseonShapes : function (shapes, mx, my) {
			var s = this, parent = s, m, child, j, v, arg;
			if (typeof shapes == UNDEFINED) {
				shapes = s.shapes;
			}
			m = s.getRootMatrix();
			for (j = shapes.length - 1; j >= 0; j--) {
				child = shapes[j];
				arg = child.arg;
				v = s._changeShape(child.type, arg, m);
				if (child.type == LShape.VERTICES) {
					if (LGlobal.hitPolygon(v, mx, my)) {
						return true;
					}
				} else if (child.type == LShape.RECT) {
					if (LGlobal.hitPolygon(v, mx, my)) {
						return true;
					}
				} else if (child.type == LShape.ARC) {
					if ((v[0] - mx) * (v[0] - mx) + (v[1] - my) * (v[1] - my) < v[3]) {
						return true;
					}
				}
			}
			return false;
		},
		_changeShape : function (type, arg, m) {
			var v, arg = arg, r2, i, l, v1, v2;
			if (type == LShape.VERTICES) {
				v = [];
				for (i = 0, l = arg.length; i < l; i++) {
					v[i] = m.toArray([arg[i][0], arg[i][1], 1]);
				}
			} else if (type == LShape.RECT) {
				v = [[arg[0], arg[1]], [arg[0] + arg[2], arg[1]], [arg[0] + arg[2], arg[1] + arg[3]], [arg[0], arg[1] + arg[3]]];
				for (i = 0, l = v.length; i < l; i++) {
					v[i] = m.toArray([v[i][0], v[i][1],1]);
				}
			} else if (type == LShape.ARC) {
				v1 = m.toArray([arg[0], arg[1], 1]);
				v2 = m.toArray([arg[0] + arg[2], arg[1], 1]);
				r2 = (v1[0] - v2[0]) * (v1[0] - v2[0]) + (v1[1] - v2[1]) * (v1[1] - v2[1]);
				v = [v1[0], v1[1], Math.sqrt(r2), r2];
			}
			return v;
		},
		getRootMatrix : function () {
			var parent = this, m = new LMatrix();
			while (parent && parent != "root") {
				if (parent.scaleX != 1 || parent.scaleY != 1) {
					m.scale(parent.scaleX, parent.scaleY);
				}
				if (parent.rotate != 0) {
					m.rotate(parent.rotate);
				}
				if (parent.x != 0 || parent.y != 0) {
					m.translate(parent.x, parent.y);
				}
				parent = parent.parent;
			}
			return m;
		},
		/** @language japanese
		 * オブジェクト自体は、親コンテナから除去される。
		 * @method remove
		 * @since 1.7.7
		 * @public
		 */
		remove : function () {
			var s = this, p = s.parent;
			if (!p || p == "root") {
				return;
			}
			p.removeChild(s);
		}
	};
	for (var k in p) {
		LDisplayObject.prototype[k] = p[k];
	}
	return LDisplayObject;
})();
/** @language japanese
 * [ブロードキャストイベント] 再生ヘッドが新しいフレームに入るときに送出されます。
 * <p><a href="LEvent.html#property_ENTER_FRAME">LEvent.ENTER_FRAME</a></p>
 * @event LEvent.ENTER_FRAME
 */