Quartz Composer Plug-In は、Dashboard のウィジェットで Quartz Composer のコンポジションファイルを再生するためのものだ。ウィジェットで、Quartz Composer のパワーをそのまま使うことができる。
プラグインのインストール
このプラグインは、Web Kit プラグインタイプだ。つまり、ウィジェットの内部ではなくて、システムディレクトリにインストールする。プラグインをダウンロードしたら、/Library/Internet Plug-Ins か、ユーザディレクトリの ~/Library/Internet Plug-Ins にインストールする。
もし、このプラグインを使ったウィジェットを配布しようと思ったら、ユーザにプラグインをインストールしてもらわないといけない。ちょっと面倒だけどね。
ウィジェットのHTML
ウィジェットで Quartz Composer のコンポジションファイルを配置するには、embed タグを使う。src 属性に、.qtz ファイルを指定するだけでいい。たとえば、次のようにする。
<embed id="composition" src="SlideShow.qtz"></embed>これで、SlideShow.qtz というコンポジションファイルが配置される。
ただし、デフォルトの状態では、アニメーションが止まっている。そこで、JavaScript を使って、プラグインオブジェクトの start() メソッドを呼び出す。
id plugin = document.getElementById("composition");
plugin.start();これで再生が始まる。プラグインオブジェクトのメソッドの一覧は、ここにある。
プラグインオブジェクトのメソッド
start
plugin.start()
アニメーションをスタートします。
stop
plugin.stop()
アニメーションをストップします。
setValueForInputKey
plugin.setValueForInputKey(value, key)
指定したインプットキーkeyに、値valueを指定します。
valueForInputKey
plugin.valueForInputKey(key)
指定したインプットキーkeyの値を取得します。
valueForOutputKey
plugin.valueForOutputKey(key)
指定したアウトプットキーkeyの値を取得します。
inputKeys
plugin.inputKeys()
インプットキーの配列を取得します。
outputKeys
plugin.outputKeys()
アウトプットキーの配列を取得します。
システム条件
OS は、もちろん、Mac OS X 10.4 (Tiger) 以降が必要だ。
また、マシンは、Quartz Composer を起動できるグラフィックチップを持っている必要がある。Quartz Composer が起動できれば問題ない。警告文が表示されて起動できない場合は、このプラグインも使えない。
ライセンス
ライセンスは、修正 BSD ライセンスだ。
プラグインファイルは、コピーライトが含まれているのでそれを変更しなければ、自由に再配布、改変を行える。許可を取る必要は無い。
ソースコードも、コピーライトを変更しなければ、自由に再配布、改変を行える。許可を取る必要は無い。
ダウンロード
version 1.0
(2005/7/11 公開）
プラグインファイル
QuartzComposerPlugIn1.0.plugin.zip (8 Kb)
ソースコード
QuartzComposerPlugInSrc1.0.zip (16 Kb)
サンプルウィジェット
QCSlideShow.zip (28 Kb)
