1.1.1 サポートされているブラウザとオペレーティングシステム

Firefox、Safari、Chrome、およびOperaは「Netscape」ブラウザとして知られています。これらのブラウザでWebPluginを使用するには、「ActiveX」APIを使用しているInternet Explorerとは別のAPIが必要です。このドキュメントで説明するWebPluginは、同じプラグインコンポーネントで両方のAPIタイプをサポートします。
WebPluginは、次のブラウザとオペレーティングシステムでサポートされています。

通常、具体的に記載されている場合を除き、WebPluginは各ブラウザの最新バージョンおよび旧バージョンをサポートします。

1.2.1 Windowsプラグインファイル

Internet Explorer（IE）とNetscape-plugin（NP）ブラウザのプラグイン操作をサポートするプラグインモジュールが1つあります。
Wacomタブレットドライバソフトウェアをインストールすると、必要なWebPluginコンポーネントがすべてシステムにインストールされ、WebPluginプロパティを使用できるjavascriptアプリケーションをすぐに作成し、（サポートされているタブレットで）ペンおよびタッチデータを取得できます。プログラムの例については、http://www.wacomeng.com/web/index.htmlを参照してください。
Wacomタブレットドライバのインストールでインストールされたプラグインコンポーネントに加え、スタンドアロンWebPluginインストーラがあります（Windowsのみ）。通常、WebPluginコンポーネントはWacomタブレットドライバソフトウェアと一緒に自動的にインストールされるので、スタンドアロンWebPluginインストーラは不要です。ただし、（誤ってアンインストールした、または旧バージョンのタブレットドライバソフトウェアがインストールされているなどの理由で）WebPluginがインストールされていない場合、WebPluginを取得する別のオプションがあります。詳細については、セクション1.2.2を参照してください。
WebPluginは、MIMEタイプによってHTML Webアプリケーションで識別できます。新旧のWebPlugin用のMIMEタイプがあります。
バージョン1.0.x.xのWebPluginはtype=”application/x-wacom-tablet”を使用します
バージョン2.0.0.xのWebPluginはtype=”application/x-wacomtabletplugin”を使用します

IEブラウザは、ActiveX APIを使用し、CLASSID（GUID）でWebPluginを識別します。新旧のWebPlugin GUIDがあります。
バージョン1.0.x.xのWebPluginはclassid=”449E4080-7C69-4767-A1AE-6AAE25B0B906″を使用します
バージョン2.0.0.xのWebPluginはclassid=”092dfa86-5807-5a94-bf3b-5a53ba9e5308″を使用します

1.3 Mac OSXプラグインファイル

• WebPAPIプロパティは、2.0.0.1より前のWebPluginの全バージョンでサポートされています。
• WebPAPIは現在、すべてのWacomプロフェッショナルおよびコンシューマタブレットでサポートされています。

function mousedrag(evt)
{
	var plugin = document.getElementById('wtPlugin');
	var pressure = plugin.penAPI.pressure;
	var plugin.penAPI.posX;
	var plugin.penAPI.posY;
	…
}

完全な例は、http://www.wacomeng.com/web/index.htmlにあります。

• プラグインMIMEタイプをtype=”application/x-wacom-tablet“からtype=”application/x-wacomtabletplugin“に変更します
• プロパティへのアクセスをplugin.<property>からplugin.penAPI.<property>に変更します

• WebTAPIは、2.0.0.1より前のバージョンのWebPluginではサポートされていません。
• WebTAPIは、5.2.5より前のWacomタブレットドライバ（Bambooタブレットドライバ）ではサポートされていません。
• WebTAPIは現在、以下のBambooタブレットでサポートされています。CTT-470、CTH-470、CTH-670。

アタッチイベントの登録

デタッチイベントの登録

アタッチイベント：

アタッチされたタッチデバイスの現在のリストを読み取る。
タッチデータの受信元デバイスを開く。
そのデバイスからタッチデータを受信するように登録する。

未処理フィンガーデータイベント：

タッチデータを読み取る。
アプリケーションでデータを使用する。

デタッチイベント：

アタッチされたタッチデバイスの現在のリストを取得する。
使用中のデバイスが存在しなくなった場合は、そのデバイスを閉じます。

実際のjavascriptの例については、下記のプロパティの例を参照してください。完全な例は、http://www.wacomeng.com/web/index.htmlにあります。

3.5.1 TouchRawFingerData

最初に見つかったタッチデバイスからユーザーに最新の未処理フィンガータッチデータを返します。

NumFingers	Int			//このデータパケットのフィンガー数
DeviceID	Int			// データの送信元デバイス
Status		Int			// データが有効かどうかを示す（下記を参照）
FingerList	FB::VariantList		// フィンガーデータのリスト
		FingerList[0]
			FB::VariantMap	// Finger1のデータ
			FingerID	Int	// データパケットで指定
			PosX		float	// APIから渡されたX座標（下記を参照）
			PosY		float	// APIから渡されたY座標（下記を参照）
			Width		float	// フィンガーコンタクトエリアの論理的な幅
			Height		float	// フィンガーコンタクトエリアの論理的な高さ
			Orientation	float	// フィンガーコンタクトの垂直線からの楕円の角度
			Confidence	Int	// ドライバが有効なタッチと判断した場合は1
			Sensitivity	Short	// 予約用（Ironwoodでは使用されません）
			FingerState	Int	// 現在の指の最後の動き（下記を参照）
		FingerList[1]
			FB::VariantMap	// Finger2のデータ
			FingerID	Int
			PosX		float
			PosY		float
			Width		float
			Height		float
			Orientation	float
			Confidence	Int
			Sensitivity	Short
			FingerState	Int
		...

var deviceID = plugin.touchAPI.TouchDeviceIDList[0];
var fingerdata = plugin.touchAPI.TouchRawFingerData(deviceID);
var numFingers = fingerdata.NumFingers;
var status = fingerdata.Status;
if ( status == 0 )
{
	var finger1= FingerData.FingerList[0];
	var finger1ID = finger1.FingerID;
	if (finger1.Confidence == 1 && finger1.FingerState != 0)
	{
		var finger1PosX = finger1.PosX;
		var finger1PosY = finger1.PosY;
		...
	}
	var finger2 = FingerData.FingerList[1];
	etc...
}

3.5.2 TouchDeviceCapabilities

指定したタッチデバイスの機能を返します。

Version		Int	// データ構造バージョン（Ironwoodリリースの場合は1）
DeviceID		Int	// このデバイスのID
DeviceType		Int	// この値は現在、常にゼロに設定されています		
MaxFingers		Int	// デバイスでサポートされている指の最大数
ReportedSizeX		Int	// X方向のタッチポイントの数
ReportedSizeY		Int	// Y方向のタッチポイントの数
PhysicalSizeX		float	// デバイスのアクティブタッチ面の幅（mm）
PhysicalSizeY		float	// デバイスのアクティブタッチ面の高さ（mm）
LogicalOriginX	float	// デバイスのMinX。現在の表示の0,0ポイントが基準になります。
LogicalOriginY	float	// デバイスのMinY。現在の表示の0,0ポイントが基準になります。
LogicalWidth		float   // デバイスの論理的な幅。MaxX = LogicalOriginX+LogicalWidth
LogicalHeight		float   // デバイスの論理的な高さ。MaxY = LogicalOriginY+LogicalHeight

var deviceID = plugin.touchAPI.TouchDeviceIDList[0];
var touchDeviceCaps = plugin.touchAPI.TouchDeviceCapabilities(deviceID);
var maxNumFingers = touchDeviceCaps.MaxFingers;
var maxXTouchPoints = touchDeviceCaps.ReportedSizeX;
var maxYTouchPoints = touchDeviceCaps.ReportedSizeY;
etc...

3.5.4 TouchDeviceIDList

アタッチされたタッチデバイスIDのリストを返します。

_touchDeviceIDList = plugin.touchAPI.TouchDeviceIDList;

3.5.5 Open

指定したデバイスにアタッチし、そのデバイスのデータがクライアントに送信されるようにクライアントのタッチAPIを初期化するメソッドです。クライアントは、タッチデータがシステムに渡されないように接続することも、タッチデータがクライアントに渡され、システムにデータが送信されるように接続することもできます。

//指定したdeviceIDのタッチデバイスを開きます。
//deviceIDはTouchDeviceIDListもしくは、TouchDeviceCapabilitiesから取得することができます。
deviceID	Int	
// 1: データがシステムに渡されます。0：データはシステムに渡されません。
passThru	Int

var caps = plugin.touchAPI.TouchDeviceCapabilities(-1);  // 最初のタッチデバイスの機能を取得します

var status = plugin.touchAPI.Open(-1, 0);		// 最初のデバイスを開きます。データをシステムに渡しません
var status = plugin.touchAPI.Open(caps.DeviceID, 0);	// 指定デバイスを開きます

3.5.6 Close

このメソッドは、指定したデバイスからクライアントをデタッチし、そのデバイスからもタッチデバイスからも、データがこれ以上クライアントに送信されないようにします。

// -1 -> すべてのタッチデバイスを閉じます。または、deviceIDで指定したタッチデバイスを閉じます 
// TouchDeviceCapabilitiesから渡されます
deviceID	Int

var status = plugin.touchAPI.Close (-1);		// すべてのデバイスを閉じます
var status = plugin.touchAPI.Close (caps.DeviceID);	// 指定したデバイスを閉じます

3.5.7 Modes

このメソッドでは、さまざまな条件に対してプラグインを設定できます。現時点でサポートされている条件は次のとおりです。

1. CHILD_BIT:プラグインをブラウザの子プロセスまたはブラウザのメインスレッドで実行するようにAPIに指示します。この設定を使用すると、子プロセスでプラグインを開始するか、メインスレッドでプラグインを開始するブラウザでプラグインが実行されるようAPIに設定を指示できます。現在、ほとんどのブラウザ（Internet Explorer、Firefox、Chromeなど）は、別のプロセスでプラグインを開始します。これにより、失敗したプラグインでブラウザ全体がクラッシュすることを防ぐことができます。プラグインAPIは、デフォルトでは子プロセスで実行されることを想定していますが、その動作をオフにし、WebPluginをメインスレッドで実行するように切り替えることができます。
2. OBSERVER_BIT:タッチコンシューマまたはタッチオブザーバとして実行されるようにプラグインを設定します。この設定を使用すると、オブザーバモードまたはコンシューマモードで実行されるようにプラグインを設定できます。オブザーバモードで、プラグインはタッチデータを処理し、タッチデータをシステムに渡します。渡されたタッチデータは、別のアプリケーションやシステムでジェスチャーやカーソル移動を実行するために使用できます。コンシューマモードでは、プラグインはタッチデータを処理しますが、システムにはデータを渡しません。

mode	Int	// 条件のビット単位のOR:
		// CHILD_BIT:	0x00000001 -> プラグインが子ブラウザプロセスにあることを前提としています
		// OBSERVER_BIT:0x00000010 -> プラグインはデータをシステムに渡します（オブザーバ）
		// デフォルトでは、プラグインはコンシューマとして子ブラウザプロセスで実行されます。

// プラグインがブラウザのメインスレッドで実行され、コンシューマになるようにAPIに指示します
var status = plugin.touchAPI.Modes (0);
// プラグインが子プロセスで実行され、コンシューマになるようにAPIに指示します
var status = plugin.touchAPI.Modes (1);
// プラグインが子プロセスで実行され、オブザーバになるようにAPIに指示します
var status = plugin.touchAPI.Modes (3);

3.6.1 TouchDataEvent

サポートされているタッチデバイスからタッチデータを受信したときに生成されます。クライアントのハンドラは、このイベントを受信すると、データをクエリできます（下記を参照）。

if (window.addEventListener)
{
    obj.addEventListener("TouchDataEvent", touchDataHandler, false);
}
else
{
    obj.attachEvent("onTouchDataEvent", touchDataHandler);
}

function touchDataHandler()
{
    // TouchRawFingerDataを使用してキャッシュデータをクエリします
    // クライアント表示エリアでフィンガーデータを処理/描画します
}

3.6.2 TouchDeviceAttachEvent

サポートされているタッチデバイスがシステムにアタッチされたときに生成されます。

if (window.addEventListener)
{
    obj.addEventListener("TouchDeviceAttachEvent", touchDeviceAttachHandler, false);
}
else
{
    obj.attachEvent("onTouchDeviceAttachEvent ", touchDeviceAttachHandler);
}

function touchDeviceAttachHandler ()
{
    // タッチデバイスの現在のリストを取得し、最初のデバイスを開きます。
    _touchDeviceIDList = plugin.touchAPI.TouchDeviceIDList;
    _touchDeviceID = _touchDeviceIDList[0];
    plugin.touchAPI.Open(_touchDeviceID, 0);
}

3.6.3 TouchDeviceDetachEvent

サポートされているタッチデバイスがシステムからデタッチされたときに生成されます。

if (window.addEventListener)
{
    obj.addEventListener("TouchDeviceDetachEvent",touchDeviceDetachHandler,false);
}
else
{
    obj.attachEvent("onTouchDeviceDetachEvent", touchDeviceDetachHandler);
}

function touchDeviceDetachHandler ()
{
    // 現在のタッチデバイスへの接続を閉じます
    plugin().touchAPI.Close(_touchDeviceID);
}