てことで、小ネタ続きですが、XMLやFlashVarsで受け取った値でハマりがちなポイントの一つであるBooleanの判定についてのTipsになります。

Booleanとは？

Booleanをわからない人はこのエントリに興味を示さないと思いますが、前提として触れておきます。

Booleanは日本語で真偽値と表し、その名の通り true または false のどちらかの値をとります。
たとえばこんな感じ。

var isLogin :Boolean = false;
// --------
isLogin = true;

使われるシーンとしては、ログインしているかどうか、サウンドがOnかOffか、などフラグとして使われます。

また if 文や switch 文、for 文、while文のステートメントも、比較(==とか)の結果Booleanに置き換えられます。

var isLogin:Boolean = ( data.nickname != null );

値は2極値なので、value = !value のようにして反転することもできます。

ただし、undefinedとはちがうので、キャストすれば Boolean( undefined ) はfalseになりますが、undefined == false は成り立ちません。

同じような問題で空の文字列( "" )をキャストすると、値自体はありますが長さが0なので false になります。

XMLやFlashVarsの値は何か？

以上をふまえて、XMLやFlashVarsで何が問題になるのかというと、両方とも値の型が文字列(String)であることに起因したミスが発生します。

たとえばXML設定ファイルを読み込んでその中に<isLogin>false</isLogin>という文字列があったとします。

Boolean( xml.isLogin.toString() ) としても "false" という文字列を評価するためBoolean的には true になります。また "false" じゃないことが "true" であることを保証するわけでもないので注意が必要です。

文字列のBoolean値は "true" のみを真とする

まとめると、これを確実に評価するには、 xml.isLogin.toString() == "true" のように明示的に ”true”という文字列以外はすべて false という評価をする必要があります。

FlashVarsとかローカルだと存在しないし値がfalseになる要因が増えるとバグのもとになりやすいし、デバッグの効率が著しく落ちます。

ということで小さなコトではあるんですが、他の人のソースとか見てると以外に "true"以外という考え方ができてないがゆえに、思わぬデータに弱い判定になってしまっているのを見受けられたので書いてみました。

Asdocって？

ASDocはJavadocを模したActionScriptのドキュメントです。
主にはこのクラスのプロパティとメソッドは〜でというAdobeのリファレンスでおなじみこの形の物になります。
Flex sdkをいれるとasdocというコマンドラインツールがあるので、その子にソースフォルダを指定するとAdobeのリファレンスと同じものが自動出力されるという便利ツールです。
 

記述方法

とても簡単。
書きたいメソッドやプロパティの上に下記の様に書き込みます。

        /**
         * ここに概要とかを書きます。
         * @example ソース例のコメント
         * <listing version="3.0">this.is.code.area("listingで囲まれた部分にこんな風にコードを書けます");</listing>
         * @param パラメータ
        * @see com.kayac.level0.Murai
        * @return String
         */

使ってみよう！

Flashやってる人は基本的にcmd.exeやterminal.appをいじる人ばかりではないので神様が作ったGUIツールを使いましょう。

使うアプリはGrantSlinner先生のairアプリASDocrです。
英語ですがそれは我慢するとして、最短の設定をご紹介。

まずはインストール。神様のサイトに行きます。
http://gskinner.com/blog/archives/2010/01/asdocr_simple_a.html
MacのdmgかWinのexeをダウンロード。インストールします。

立ち上げて設定。

ASDocタブ

asdocのpathを設定。
Macだと
/Applications/Adobe Flash Builder Beta 2/sdks/4.0.0/bin/asdoc
とかです。

Basicタブ

configuration Name:
設定した内容をテンプレにして保存しておけます。
その名前。上のコンボボックスで選択切り替え可能です。

source-path:
出力したいソースフォルダのルートパスを指定

output:
ASDocの書き出し先

Outputタブ

main-title:
ASDocのタイトル
API Wrapper Refference とか。

footer:
フッターに入る内容
Takashi Murai - KAYAC inc とか。

window-title:
API Wrapper Refference と僕はmain-titleと共通しています。

templates-path:
flex sdkの中のtemplateのパスです。
 

後は適宜好みで設定ですね。
このASdocがあると概要の整理や急な引き継ぎ、大きいプロジェクトならジョインした新たな仲間への共有も簡単です。

チームでFlash開発する方や，更新案件を持てない方など、是非試してみたください！

どうせ車輪の再発明なんだろうけど、それでも書いたほうが早いっていうことが多いですね。それにしてもJSFLってどうして何度かいても忘れるんでしょう。

さて、特に見どころもないですが、下記のような感じで座標のみをカンマ区切りでクリップボードにコピーできます。実行したら見た目何も起こりませんが、エディタに戻ってペーストしてみましょう。また区別がつきやすいようインスタンス名またはシンボル名がコメントで入ります。

なお複数選択したら改行されて同様にコピーされます。一応パフォーマンスを気にして最大100個までに絞ってますが任意でかえてください。

ソースコード

(function(){
var doc = fl.getDocumentDOM();
var list = doc.selection;

if(list.length==0) {
	return;
}
var maxLimit = 100;
var result = [];
var len = Math.min(list.length,maxLimit);
for( var i=0; i<len; ++i) {
	var element = list[i];
	result.unshift( "//"+(element.name || element.libraryItem.name)+"\n" + [ element.x, element.y ].join(", ") );
}

var str = result.join("\n");

fl.clipCopyString(str)	
})()

結果 

// インスタンス名ORシンボル名
56, 48

使いかた

上記のコードをテキストエディタで｢座標をコピー.jsfl｣とかして保存してください。文字コードはたぶんUTF-8がいいと思います。

インストール先はWinだと下記のような感じにファイルおけばいいです。Macもそれっぽいところにファイル置いてください。それぞれ設置後再起動が必要です。

\Users\y{UserName}\AppData\Local\Adobe\Flash CS3\{Language}\Configuration\Commands

JSFLネタはもう少しあるんですがまたの機会に。

さて、Eventについて疑問があったので簡単にテストしてみました。

IEventDispatcher.dispatchEventメソッド

EventDispatcherを継承しているか、IEventDispacherを実装していれば、dispatchEventを実装していることになります。

通常dispatchEventはTarget自身で発行し他者にEventを通知する流れになりますが、IEventDispatcher.dispatchEventはpubricメソッドであるため、メソッドのコールそのものは他のオブジェクトから操作することも可能です。

Progression4のソースコードなど読んでいるとたまに出てきますが、あまり一般的ではありません。(たぶん。他言語ではあるのかな？)。

またMouseEventのようにOSのイベントをキャッチして伝播されるようなものをdispatchEventするとどうなるのだろう、ってことでやってみました。

MouseEvent

livedocによるとMouseEventのコンストラクタに渡せる値は次のような感じです。

 MouseEvent(
    type:String, bubbles:Boolean = true, cancelable:Boolean = false,
    localX:Number = NaN, localY:Number = NaN,
    relatedObject:InteractiveObject= null,
    ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false,
    buttonDown:Boolean = false,
    delta:int = 0,
    commandKey:Boolean = false, controlKey:Boolean = false,// AIR only
    clickCount:int = 0// AIR only
)

オレオレMouseEventのテスト

イベントタイプと、座標などを入れたらMouseEventのふりができました。MouseEventにはステージ座標を取得するプロパティがありますが、これは自動的に計算されるみたいです。

試しにSpriteの座標をx=200としてみると、きちんと200ずれた位置に計算されるようです。表示されてない表示オブジェクトでも大丈夫な模様。

次に、DisplayObject以外のEventDispacherから、MouseEventを発行するとどうなるかやってみました。

座標が計算されないので、stageXとstageYが常に0になります。コンストラクタに渡したlocal座標はそのままでした。

これによって何ができるかというと特に用途が思いつかないのですが、オートメーション的なテストする時か何かでしょうか。

DoBetweenAS3コマンド

さて、BetweenAS3にoverwriteが実装されより実戦向きになってきたと聞いたのでそろそろTweenerから乗り換えてみようと思い、Progression4用にカスタムコマンドをつくりました。

※2010/2/19時点でwonderflにはoverwrite版は反映されていません

コンセプト

考え方としては、DoTweenerライクに使えるというか、インターフェイスを合わせることを重視してます。※(追記)transitionにIEasingインスタンスを指定する必要があります。一緒なのはパラメーター名だけ。

これによりBetweenAS3の魅力であるトゥイーンの加工とかがやりにくいんですが、とりあえずDoTweenerの速い版として取り入れたい人には、これでいいんじゃないかと思います。

BetweenAS3をフルで活用したいのであれば、Sparkにすでにコミットされてるほうがいいと思います。

問題点

そうしたときに、名前を変えるべきかなーとかいろいろ悩むんですが、同名で行くならどっちの書式も使えるとかするべきか、どうしたらいいでしょうか？何か妙案あれば教えてほしいです。

というかDoBetweenAS3を名乗るのであれば、BetweenAS3に準じてる格好が正しいと思いますが、気持ち的な互換性を重視するのであればDoTweener2とでもしとけばいいんでしょうか。

うーん。

メリット

とりあえず導入にあたる気持ち的なハードルが低いです。個人的にこれ重視です。汎用性や柔軟性はまるでありませんが割り切ることで得られるものもありますよねってことで。

もうひとつが一応速いっていうことです。正直大量にオブジェクトを動かした時でないと、個別のTweenの速度的なパフォーマンスって見えづらいので、導入にコストがかかるならTweenerでいいじゃんっていうのが本音です。でもインターフェイス一緒なら一応速いほうがいいんじゃないっていうアイディアで取り入れられるのが、メリットといえばメリット。

たぶんふつうに使っても若干メモリにやさしいはずです。

何か改善点などあればぜひwonderflのサンプルをForkしてください。みんなでDoBetweenASを育てていったらいいんじゃないかと。

さて、みなさんFDTご存じですか？　僕も年末にセットアップした初心者ユーザーのひとりですが、色々と手に馴染んできた所で、ざっとまとめを書いてみたいと思います。
ちなみにタイトルはMacガン押しですが、もちろんWindowsでも使えます！

FDTって？

http://www.solutions.powerflasher.com/jp/
FDTはPowerFlasherという会社が作っているActionScript用改造Eclipseです。
AS3/AS2 MXMLを爆速でコーディングすることができます。

QuickFix(自動変数定義、自動import、自動クラス生成、自動プロパティ定義、自動メソッド定義 etc)

至れり尽くせりのコードフォーマットセッティング

賢いコード補完（文章中単語自動補完、定義済み変数補完、overrideメソッド、local変数、namespace etc)

強力なテンプレート機能（もちろんカスタム・自作可能）

リアルタイム構文エラー検知（コンパイルしないでも打ちながらエラーを検出してくれます）

と一通り便利な機能が揃っています。

正直今すぐできる！超簡単！では無い環境です。
インストールはボタンを押すだけの簡単仕様ですが、快適に使おうとすると細かいセッティングが項目が多くある複雑なソフトです。

ただ、しっかりセッティングして使い込みさえすれば相当なスピードでFlashをつくることができます。しかも膨大なEclipse拡張の資産が使えて、Mac純正対応。言うこと無しです。

Adobe純正のFlashBuilderも同じくEclipseベースなのですが、FDTの方がよりEclipseに近いイメージ。
私見ですが、FBは余計なセットアップを無くす事や”すぐ使える”という部分にコンセプトを置いている気がするので、ソフトウェアデザインの中で色々と機能が封印されているのかもしれません。
スキルがある職業FlasherやフレームワークとしてFlexを使わない人(ActionScriptプロジェクトばっかりな人)ならFBよりもFDTの方がオススメかもしれません。
実際、エディターとしての性能や使用感ならFBよりもFDTの方が高性能な印象があります。
fcshでのコンパイルがとても速いのも魅力の一つです。

最近の僕のオーサリングスタイルは、

1. Flashでパーツを作ってswc書き出し
2. FDTのプロジェクトに書き出したswcのパスを通す。
3. fcshでコンパイル

という流れ。
この方法だとMovieClipの中のインスタンス名もしっかり補完されるのでミスも減り、Flashとエディタをいったり来りもしないのでとても快適。
この方法ならsdkを切り替えればCS3で作ったflaのパーツであってもplayer10パブリッシュも出来ます。

Flashというソフトはレイヤー・タイムライン・各種描画ツール・描画モード・フィルタと、まるでグラフィックツールの用に直感的にGUIを作ることが出来る、他に類を見ない程のインターフェースビルダーなので使わないという手はありません。
でも、Flashの純正エディターの方ははなんだか。。という人はこれを気にエディタを変えてみるのもいいかもしれません。FDTも良いですが、FlashBuilder,FlashDevelopも素晴らしいエディタです。

おっと、盛大に話がそれましたね。
うんちくは置いておいて、簡単にFDTのセットアップ手順をご紹介。

1.インストール

http://www.solutions.powerflasher.com/jp/
日本語ページがあります。とりあえずお試ししてみましょう。

http://www.solutions.powerflasher.com/jp/fdt/download/fdt-35-beta/
最新版をdownload。SnowLeopardの人は3.5じゃないとこまった事になります。

standAloneならそれぞれのOSのバージョンを。Eclipseに入れたい人は
http://fdt.powerflasher.com/update_beta/ をRemoteSiteに入れてInstallしましょう。

2.セットアップ・カスタマイズ

http://www.fdt.jp/
に行きましょう。上から順番に読んで行くと良いと思います。

で、主催の cellfusion氏のブログ、FDTタグを全部読みましょう。
Tipsからかゆいところに手が届く設定方法が色々載っています。
http://www.cellfusion.jp/mt/mt-search.cgi?blog_id=1&tag=FDT&limit=20&IncludeBlogs=

3.とりあえずHelloWorld

僕もこのBlogを見てHelloWorldしました。ありがとうございます。
http://log.taquo.com/ja/archives/tag/fdt

4.改造・テンプレート

Eclipseプラグイン一覧
http://www10.atwiki.jp/eclipse/

ついこの間templateページができました。
http://www.fdt.jp/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88

このテンプレートが曲者で、しっかり書くと恐ろしい速さで打てるようになります。
僕が作ったテンプレートもアップしてあるので是非 試してみてください。

Progression4 CastXXX & SceneObject template 一式 forked from @fumix
http://drp.ly/gIi6d

Tweener initObject template
http://drp.ly/nYqcD

色々書きましたが、とても奥深い開発環境です。
fcshやらadtやらeclipse.iniの編集やらsdkの切り替えやらantやら、思ったよりも色々とあります。
で、それらを全部超えると、progression4の3階層分ぐらいのシーンが10分ぐらいで書けたり、今まで2時間ハマっていたデバッグが1分で終わったり、コードが綺麗になったり、ソースを読むスピードが速くなったり、、、と成功体験が待っています。

一体僕はなんの営業なんだろうってぐらい書き綴ってしまいましたが、是非試してみてください。
 

html-template/index.template.html

	AC_FL_RunContent(
			"src", "${swf}",
			"width", "${width}",
			"height", "${height}",
			"align", "middle",
			"id", "${application}",
			"quality", "high",
			"bgcolor", "${bgcolor}",
			"name", "${application}",
			"allowScriptAccess","sameDomain",
			"type", "application/x-shockwave-flash",
			"pluginspage", "http://www.adobe.com/go/getflashplayer",
			"SeamlessTabbing", "false"
	);

			<embed src="${swf}.swf" quality="high" bgcolor="${bgcolor}"
				width="${width}" height="${height}" name="${application}" align="middle"
				play="true"
				loop="false"
				quality="high"
				allowScriptAccess="sameDomain"
				type="application/x-shockwave-flash"
				pluginspage="http://www.adobe.com/go/getflashplayer"
				SeamlessTabbing="false">
			</embed>

http://www.youtube.com/watch?v=LkrtYRxGyuo

いつ見ても美しいッス。

ユニクロカレンダーで綺麗な使われ方してましたね。

http://www.uniqlo.com/calendar/

盛り上がったのは昨年ですが、いまでも根強い人気がある撮影技法。

さて、落とし穴というか、浅い穴に自分からはまったような感じではありますが
ガイドレイヤーに書いたスクリプトは実行されるんですね…。今更ですが見落としてました。

表示させたくないけど残しておきたいMC等をバックアップとしてガイドレイヤーに退避しておく、といった事はおなじみかと思いますが、スクリプトに関してもなんとなく同じような感覚でいたら、危うく痛い目を見るところでした。恐ろしい。

ということでフレームスクリプトでも横着せずにコメントアウトするべし、という話でした。

コンポーネントが発行するイベントをリスナーに登録する場合、addEventListenerを使う他にMXMLでは

<mx:Canvas creationComplete = "creationCompleteHandler(event)"/>

このようにも記述することもできます。

これをカスタムコンポーネントでもできるようにしてみます。