DigiTechLog Dot Com » ライブラリ

AS3のTween系ライブラリ「TweenLite」の紹介の纏め

admin — Sun, 27 Feb 2011 14:11:40 +0000

TweenLiteというライブラリは、AS3のTween系の高速・軽量ライブラリです。基本は１ファイルしかありません。現時点まで最新版は１１．６２です。インターネット中ちょっと探してみましたが、日本語資料はあまりないようです。ここは見つかったTweenLiteについて日本語関連資料を纏めてみます。何か漏れれたらご遠慮なくコメントください。

TweenLite/TweenMaxで自前パラメータをTweenさせる

Tweenerを使わない理由を分析してから、TweenLiteを使ったサンプルソースコードを挙げて説明しました。

blendmode.add＆blur円の浮遊

spriteを使って、tweenLiteで動作をコントロールするサンプルです。

高速・軽量がウリのTweenLite(AS3)がリリース

TweenLiteというものの簡単の紹介文

gTween とTweenLite/Max が合体する？！

著名なトゥイーンライブラリ「TweenLite/Max」と「gTween」が合体するようについてエントリのまとめ

TweenLite.to とTweenLite.fomの違い

実際サンプルソースコードでTweenLite.to とTweenLite.fomの違い説明文

TweenLiteを試してみる

YuichiさんがＴｗｅｅｎＬｉｔｅを試してみた感想メモ

http://www.greensock.com/tweenlite/

日本語ＵＲＬではないですが、ＴｗｅｅｎＬｉｔｅの公式ＵＲＬです。

FZip: ZIP読込み、作成用AS3のライブラリ

admin — Sun, 18 Apr 2010 15:09:51 +0000

Flash技術はウェブ上に良く使われているのです。データ量が大きい場合、圧縮しなくてそのまま送受信するとネットの効果に影響があります。その前、Adobe AIRアプリケーション中に圧縮機能（ZIP:ByteArray）を利用してデータを通信(ActionScriptとJava)しますにアドビAIRアプリケーション中に使える圧縮機能を紹介しました。今回紹介するのはZIPファイルを読み込み、作成用AS3のオープンソースライブラリです。

実はnochumpにも一つのAS3 zipライブラリをリリースしていました、そのライブラリの圧縮スピードは結構早そうですが、FZipならファイルをロードしながら中身をアクセスできます。

2009の年末にリリースしたFZip 1.5バージョンには、Mac OS XにSWCs, JARsなども解析できました。

使い方は簡単です。

１、パッケージ導入

import deng.fzip.FZip;
import deng.fzip.FZipFile;

２、圧縮ファイルロードで展開できる

zip = new FZip();
zip.load(new URLRequest("sample.zip"));

３、圧縮ファイルにファイル追加API

addFile(name:String, content:ByteArray = null):FZipFile
addFileAt(index:uint, name:String, content:ByteArray = null):FZipFile
addFileFromString(name:String, content:String, charset:String = "utf-8"):FZipFile
addFileFromStringAt(index:uint, name:String, content:String, charset:String = "utf-8"):FZipFile

もっと詳しい情報はFZipの公式サイトにアクセスしてください。

７+ AS3で非同期処理のオープンソースのライブラリ一覧

admin — Fri, 12 Mar 2010 08:58:00 +0000

以前発表した「ActionScript Libraryリスト」には、「Thread – 疑似スレッド」、「ASDeferred – JSDeffered の AS3 版」、「Chain – 非同期処理をカンタンに」と「Command – fladdict 製 Command ライブラリ」の四つを紹介しましたね。

今回では、まず「非同期処理」ってなんということを簡単で記述します。簡単でといえば、

・「同期処理」とは一つの処理が終わるまで次の処理が行われない処理のことです。
・「非同期処理」とは前の処理とは関係なく次の処理が行われることです。

非同期処理はリッチクライアントのUIのプロセスバーが重いのはデータを取得・更新の時、毎回Valueを更新する時よく使われています。

次はAS3で非同期処理のオープンソースのライブラリ一覧です。

１）、flashrod Job

非同期処理の同期化を助ける非常にシンプルな方法です。引数なしのstartメソッドで実行が開始され、完了時にfinishedを送出するものを Jobとし、全てのクラスはJobを実装します。たとえ同期処理でも、完了時にfinishedを送出することが求められます。

合成可。SequenceやConcurrentはJobインターフェースを実装している。
並列実行可。Concurrentクラスを使う。
エラーについては扱っていない。
続行可。たとえエラーが発生しても、finishedイベントを送出するようJobを実装すればよい。
中止は扱っていない。
値の受け渡しは不可。Job側で結果を保持しておく、などの必要があり。
traceすらもJobの実装クラスになる。クロージャ渡せるようにしたい人は各自でといった感じ。
非同期処理の構築はコンストラクタでのみ行われ、その後の変更は不可。
Job#start()で明示的な実行を行う。
WaitやURLGetを除いた複合非同期処理は再実行不可。一度完了した頃には配列が空になるため。
進捗は通知されない。
完了通知はAS3のイベントモデルに準拠している。イベントからJobを作る汎用メソッドは特にない。

２）、fladdict Command

引数なしのexecuteメソッドで実行が開始され、完了時にcompleteを送出するものをICommandとし、全てのクラスは ICommandを実装します。たとえ同期処理でも、完了時にcompleteを送出することが求められますが、単に同期処理を追加したいだけであればわざわざクラスを作らずとも、Commandというクラスのコンストラクタにスコープと関数と引数を指定してやるだけで済みます。一方の非同期処理は AsyncCommandでラップでき、Commandと同様のコンストラクタ引数に加えて、イベントディスパッチャと完了を通知するイベント名を指定して作成します。

合成可。SerialCommandやParallelCommandはICommandインターフェースを実装している。
並列実行可。ParallelCommandクラスを使う。
エラーについては扱っていない。
続行可。たとえエラーが発生しても、completeイベントを送出するようなCommandを実装すればよい。AsyncCommandを利用する場合、ディスパッチャのエラーイベントについて関知しないことに注意。
ICommand.asを見るに、中止は予定しているように見えるが、未実装と思われる。
値の受け渡しは不可。Command側で結果を保持しておく、などの必要あり。
複合非同期処理の基底クラスであるBatchCommandには各種ショートカットメソッドがあり、後続の処理の追加を簡単にしている。
非同期処理の追加を実行中にもできるが、実行後に追加した処理は開始されないと思われる。
ICommand#execute()で明示的な実行を行う。
複合非同期処理の進捗状況を保存する_indexというカウンタがリセットされないため、再実行は想定していない操作と思われる。
進捗は通知されない。
完了通知はAS3のイベントモデルに準拠している。メソッドとその完了を告げるイベントをワンセットとして非同期処理を表現する AsyncCommandが提供されている。

３）、Mochikit Deferred

JSになってしまいますが、ASへの移植も容易なため紹介します。MochikitのDeferredは以下が大変参考になります。
http://d.hatena.ne.jp/brazil/20080721/1216580402

合成可。コールバックの戻り値がDeferredの場合、チェーンの実行は一時停止され、子チェーンの完了を待機。
並列実行可。DeferredListを使う。
エラーハンドラはaddErrBackで追加できる。ただし、ErrorEventが送出されたときにerrbackを呼ぶように作っておく必要はある。ハンドラ内で非Errorを返した場合、回復したものとしてコールバックチェーンを再開。
続行可。addBothで、エラーが起こるにせよ起こらないにせよ実行したい後続の処理を追加すればよい。
中止は可。何もしないと、現在の処理を終えてからようやく中止されるが、コンストラクタに適切なキャンセル関数を指定してやれば即座に中止する Deferredを作ることも可。
値はコールバック関数の引数で受け取り、戻り値で後続の処理に引き継ぐ。
クロージャを追加できる。第2引数以降を指定すれば、引数を束縛した関数を追加することもできる。
非同期処理の追加をいつでもできる。実行後であれば、追加した瞬間実行される。ただし、子チェーンであると判明したDeferredには以後コールバックの追加は許されない(Chained Deferreds can not be re-used)。Mochikitの実装でそれを許すと、処理の流れは2本に分岐してしまうからか？
Deferredを返す関数を呼び出して、非同期処理の実行を開始すると同時に、後追いでチェーンを構築するケースが多いと思う(暗黙的開始)。あるいは事前にチェーンを構築してcallbackを呼び出す(明示的開始)。
Deferredは1回しかcallbackが許されない(AlreadyCalledError)。Deferredを返す関数は毎回フレッシュなDeferredを使うのが原則と思われ、そのように実装している限りにおいて再実行は可能といえなくもないが、オブジェクトは再利用できていない。
進捗は通知されない。
完了通知をイベントに戻したければ、誰かにdispatchEventしてもらうことになる。イベントを一度だけリッスンしてDeferredを返す関数を定義しておけば、いろいろと便利になると思われる。

４）、cho45 JSDeferred

Mochikitの実装をもっとシンプルにできそうなので作ったとのライブラリです。こちらもJSですが、AS3へ移植したものもあるようです(並列処理を直列に繋ぐためのショートカットメソッドDeferred#parallelが加えられている点を除き同じかと思わる)。Mochikitとの違いとして、単方向リストを使用したミニマルな実装であること、nextをメソッドチェーンすると最後に追加された Deferredを指すこと、上の例のように開始は即座でなく同期処理の後に先送りされること(さもないとチェインの構築が間に合わない？)、callや failによるチェーンの再実行が許可されていること、チェーンの実行後にハンドラを追加しても自動的には実行されないこと、などがあると思います。

合成可。コールバックの戻り値がDeferredの場合、このようにチェーンを繋ぎなおす。
並列実行可。Deferred.parallelを使う。
エラーハンドラはerrorで追加できる。ただし、ErrorEventが送出されたときにfailを呼ぶように作っておく必要はある。ハンドラの中で改めてthrowしなければ、回復したものとしてコールバックチェーンを再開。
続行可。エラーが起こる可能性がある処理の後に、何もしないエラーハンドラを追加すればよい。
中止は可。ただし、直列化された非同期処理の中止は、現在実行中のDeferredをライブラリ側で関知してくれないため、少々やりにくいと思われる。
値はコールバック関数の引数で受け取り、戻り値で後続の処理に引き継ぐ。
クロージャを追加できる。引数を束縛させる機能はないので、やりたければ自前でやる。
非同期処理の追加を実行中にもできるが、実行後に追加した処理は開始されないと思われる。
先頭のnextがディレイを噛ませた隙にチェーンを構築するケースが多いと思う(暗黙的開始)。あるいは事前にチェーンを構築してcallを呼び出す(明示的開始)。
チェーン先頭のDeferredを保持しておいて必要なときにcallすれば可。
進捗は通知されない。
完了通知をイベントに戻したければ、誰かにdispatchEventしてもらうことになる。イベントを一度だけリッスンしてDeferredを返す関数を定義しておけば、いろいろと便利になると思われる。

５）、voidelement Chain

JSDeferredのAS実装であるASDeferredをベースに、よく使う処理を簡単に書けるような工夫が施されています。直列処理の追加は、next(function() {…})のような基本的なメソッドに加え、イベントを一度だけ待つlistenや、アニメーションを行うtweenerといった各種ショートカットメソッドを直にメソッドチェーンできるようになっています。並列処理の追加は、辞書を渡すようになっており、それぞれの非同期処理にラベルをつけて結果を後から参照しやすくするついでに、定型的な処理であればそれも辞書で書いてしまおう、といった感じになっています。

合成可。コールバックの戻り値がChainの場合、このようにチェーンを繋ぎなおす。
並列実行可。parallelを使う。
エラーハンドラはerrorで追加できる。ライブラリで提供されているChainは、ErrorEventが送出されたときにエラーハンドラが呼ばれるようになっている。ハンドラの中で改めてthrowしなければ、回復したものとしてコールバックチェーンを再開。
続行可。エラーが起こる可能性がある処理の後に、何もしないエラーハンドラを追加すればよい。
中止は可。ただし、直列化された非同期処理の中止は、現在実行中のChainをライブラリ側で関知してくれないため、少々やりにくいと思われる。
値はコールバック関数の引数ではなく、this.dataで受け取り、戻り値で後続の処理に引き継ぐ。戻り値のない処理がチェーンの途中に挟まっても、最後に得たdataを辿れるよう双方向リストになっている。多分。
nextやerrorでクロージャを追加できる他、よく使う処理の追加は専用メソッドで行える。
非同期処理の追加を実行中にもできるが、実行後に追加した処理は開始されないと思われる。
先頭のChain.hogehogeがディレイを噛ませた隙にチェーンを構築するケースが多いと思う(暗黙的開始)。あるいは事前にチェーンを構築してexecuteを呼び出す(明示的開始)。
チェーン先頭のChainを保持しておいて必要なときにexecuteすれば可。
進捗は通知されない。
完了通知をイベントに戻したければ、誰かにdispatchEventしてもらうことになる。ListenerChainを利用すると、イベントから簡単にChainを作れる。

６）、secondlife Chain

AS3 でイベントチェインでよしなにしたい時って、結局非同期な並列処理の時が多い。それ以外は普通に関数で回すとわかりにくくなるので OO った方がよいかなー、と自分の中では落ち着いてる。特に無名関数の適用は、関数の引数を予めきちんと書かなくてはならなくて(…restでもいいけど)面倒だったりする。

AS3 では無名関数を使うところでJSより便利だなー、というところはあまり無い。そもそも組み込みの引数に無名関数渡すAPIが使いにくい。Array#forEach なんかは三つも引数書くのが冗長…。for each あるしね。実装側も無名関数が渡ってきて apply で適用しようとしても引数の型があわないとエラーになるし。無名関数の引数の数とかいちいち重いE4Xリフレクション使わないでも解りたい。あとバインドメソッドという無名関数とは違うメソッドクロージャ(this が確実にそのインスタンスに束縛される)を意識せずに使うことが出来るので、これでまた無名関数の利用価値が減ってしまった。唯一意識的に使うのはスコープあたりでゴニョゴニョしたい時かな。

話は飛んで Deferred の概念的なものは Event/EventDispatcher で代用することができて。AS3 では EventDispatcher が組み込みであって、かつだいたいの非同期処理はイベント終了時に大概なんらかのイベントを送出する。ほとんどの場合は Event.COMPLETE だ。足りないのは DeferredList 的なもの。並列処理をスムーズに行いたいよね。

で、組み込みの Event/EventDispatcher を使ってなんかうまく DeffererdList っぽいこと出来ないかな、と思ってて以前作ってほったらかしにしていた Chain クラスがあったのでちょっと書き直してそれなりに使えるようにしてみた。

７）、beinteractive Thread

addEventListenerを隠蔽し、非同期処理を同期処理の感覚で書けるライブラリということですが、むしろ状態遷移の多いリアルタイム処理をスマートに書けるようにするためのフレームワークといった感じで、今までのものとはちょっと異質です。個々のThreadは自分の依存するリソースやイベントのことだけ考えればよく、それらの待機は同期処理の感覚で行えるため、時間的しがらみを超えてコントローラを分割できるようになります。また、ロード中やオーバー待ちといった状態を一つのメソッドと対応付けできるので、状態遷移図を素直にコードに落とし込むようにしてプログラムが書けるのもメリットの一つかと思います。

合成可。SerialExecutorやParallelExecutorはThreadを継承している。
並列実行可。ParallelExecutorを使う。
エラーハンドラはerrorで追加できる。第一引数には補足するエラーの型を、第二引数にハンドラを指定。ハンドラが設定されていなかったり、ハンドラ中にさらにエラーが起きれば、親スレッドに伝播。ハンドラが無事終了すると回復したものとしてエラーが発生する前に実行されていた実行関数から再開するが、ハンドラ内でnextを呼び出した場合はそこから再開。
続行可。このようにする。SerialExecutorが途中でこけたとき、無視して続行するにはどうするんだろう？
中止はinterruptで可。ただし、割り込みハンドラを設定していない状態で待機中のThreadを中止しようすると InterruptedErrorとなる。自作Threadを中止に対応させるにはcheckInterruptedで割り込みされたか調べて行う。
値の受け渡しというか保持は、Threadごとの実装となる。例えば、URLLoaderThreadはloaderを保持する。それとは別に、遅延リソースの生産者と消費者を結合させないためにMonitorが使える。
スレッドを使うためのスレッドを書かなければいけないケースがほとんどだと思われる。まるでネズミk(ry
だんだん質問に答える意味がよく分からなくなってきたが、SerialExecutorのaddThreadは実行中にもできると思うけど実行後に追加した処理は開始されないと思われる。
Thread#startで開始。
startは一度しか呼び出せないので、新規のスレッドを作って再実行する。
進捗はIProgressを実装した各種Threadからイベントで通知される。それらのトータルの進捗を通知してほしければ、それぞれを MultiProgressにaddProgressしてやる。ただし、重みを指定する必要があるので、ファイルサイズの比は事前に調べておく。
Threadを使っていろいろと処理した後に、続きの処理はイベントドリブンにしたいとか万が一あれば、 EventDispatcherThreadを継承してdispatchEventする感じになると思われる。eventメソッドで特定のイベントが起きるまでThreadを待機させることができる。ただし、nextメソッドによって次の実行関数が設定された場合は待機しない。これをうまく利用して、読みやすい状態マシンを書くこともできるようだ。

as3soundeditorlib: オープンソースのActionScript 3サウンド編集ライブラリ

admin — Sun, 28 Feb 2010 12:25:10 +0000

as3soundeditorlibとは、MITライセンスを基づいて発表され、オープンソースのActionscript 3のサウンド編集ライブラリです。

MP3ファイルのスペクトラムやキューポインタを表示できて、キューポイントの間にナビとプレーバックもできるようです。

Application displays a spectrum of the mp3 file, displays cue points from a file, and allows navigation and playback of mp3 and navigation between cue points. MIT-license.

MIT Licenseは、マサチューセッツ工科大学を起源とする、ソフトウェアライセンスの代表的なものである。X11 LicenseまたはX Licenseと表記されることもある。MIT LicenseはGPLなどと違いコピーレフトでは無く、オープンソースであるか無いかに関わらず再利用を認めている。BSDライセンスをベースに作成されたBSDスタイルのライセンスの一つである。MIT Licenseは、数あるライセンスの中で非常に制限の緩いライセンスと言える。X Window System (X11)などのソフトウェアに適用されている。

as3soundeditorlibでサウンドファイルのキューポイントをXML形式でエクスポートも出来ます。

※最近発表されたHTML 5標準でもビデオ、声などを全部標準化するようになるようですね。AdobeのFlashに対して、将来的にはどうになるかもちょっと微妙だなー。

関連情報

・グーグルコードURL：http://code.google.com/p/as3soundeditorlib/

Box2DFlashAS3: 物理演算シミュレーションを可能にするActionScriptライブラリ

admin — Wed, 27 Jan 2010 15:11:38 +0000

Box2Dという物理エンジンを使ったActionScript3プログラミングをすれば、難解な数学や物理法則を理解する必要なくて実装できませね。Box2DをFlashで利用できるようにするため、「Box2DFlashAS3」というオープンソースのActionScript 3のライブラリが開発されました。

実際にどれだけ威力があるかというのはデモを見ればわかるほどの出来栄えで、ピタゴラスイッチ風なものとか、ドミノ倒しとか、いろいろなことができます。

世界の作成
床の作成
積み木の作成
シミュレーションの開始
描画

の様の流れで、Box2DFlashAS3 の単純なサンプルと使い方を解説するチュートリアルを参考できます。

開発用エンジンですから、利用方法は例を参考すればどうしても分かれるともいますね。

以下はにとよんさんが作られたサンプルです。

package {
import Engine.Dynamics.*;
import Engine.Collision.*;
import Engine.Collision.Shapes.*;
import Engine.Common.Math.*;
import flash.events.Event
import flash.display.*;
import flash.text.TextField;
[SWF(backgroundColor="#ffffff", width="350", height="200")]
public class Box2dSimpleSample extends Sprite {
private var m_world:b2World;
private var m_physScale:Number = 10;
private var count:int = 0; // loop counter
public function Box2dSimpleSample() {
stage.scaleMode = "noScale";
stage.align = "TL";
var text:TextField = new TextField();
text.text = "CLICK TO START!!!";
text.x = text.y = 100;
addChild(text);
stage.addEventListener("click", function(event:Event):void {
text.visible = false;
init();
});
addEventListener("enterFrame", function(event:Event):void {
Update();
});
}
private function init():void {
count = 0;
// Construct a world object
var worldAABB:b2AABB = new b2AABB();
worldAABB.minVertex.Set(-100.0, -100.0);
worldAABB.maxVertex.Set(100.0, 100.0);
var gravity:b2Vec2 = new b2Vec2(0.0, 10.0);
m_world = new b2World(worldAABB, gravity, true);
// Create floor
var wallSd:b2BoxDef = new b2BoxDef();
wallSd.extents.Set(300 / m_physScale / 2, 10 / m_physScale);
wallSd.localRotation = Math.random() * Math.PI / 8;
var wallBd:b2BodyDef = new b2BodyDef();
wallBd.position.Set(300 / m_physScale / 2, 250 / m_physScale);
wallBd.AddShape(wallSd);
m_world.CreateBody(wallBd);
// Add bodies
var sd:b2BoxDef = new b2BoxDef();
sd.density = 1;
sd.friction = 0.2;
var bd:b2BodyDef = new b2BodyDef();
bd.AddShape(sd);
for (var i:int = 0; i < 10; i++) {
sd.extents.Set(30 / m_physScale, 10 / m_physScale);
bd.position.Set(100 / m_physScale, (160 - 40 - i * 20) / m_physScale);
m_world.CreateBody(bd);
}
}
public function Update():void {
if(!m_world) {
return;
}
// Update physics
count++;
if(count > 300) {
init();
}
m_world.Step(1 / 30, 10);
// Render
graphics.clear();
for (var bb:b2Body = m_world.m_bodyList; bb; bb = bb.m_next) {
for (var s:b2Shape = bb.GetShapeList(); s != null; s = s.GetNext()) {
DrawShape(s);
}
}
}
public function DrawShape(shape:b2Shape):void {
if(shape.m_type == b2Shape.e_polyShape) {
var poly:b2PolyShape = shape as b2PolyShape;
var tV:b2Vec2 = b2Math.AddVV(poly.m_position, b2Math.b2MulMV(poly.m_R, poly.m_vertices[i]));
graphics.beginFill(0x999999, count > 290 ? (300 - count) / 10.0 : 1);
graphics.lineStyle(1,0xffffff,1);
graphics.moveTo(tV.x * m_physScale, tV.y * m_physScale);
for (var i:int = 0; i < poly.m_vertexCount; ++i) {
var v:b2Vec2 = b2Math.AddVV(poly.m_position, b2Math.b2MulMV(poly.m_R, poly.m_vertices[i]));
graphics.lineTo(v.x * m_physScale, v.y * m_physScale);
}
graphics.lineTo(tV.x * m_physScale, tV.y * m_physScale);
graphics.endFill();
}
}
}
}

関連情報

DigiTechLog Dot Com » ライブラリ

AS3のTween系ライブラリ「TweenLite」の紹介の纏め

Related Posts

FZip: ZIP読込み、作成用AS3のライブラリ

Related Posts

７+ AS3で非同期処理のオープンソースのライブラリ一覧

Related Posts

as3soundeditorlib: オープンソースのActionScript 3サウンド編集ライブラリ

Related Posts

Box2DFlashAS3: 物理演算シミュレーションを可能にするActionScriptライブラリ

Related Posts