events要素の公式説明ドキュメント


events要素の公式説明ドキュメント

更新2018.3.28 krpano 1.19 pr 15
krpanoイベント–特定のイベント呼び出し時にactionまたは指定した機能を実行できます.
2種類のイベントがあります.
グローバルkrpanoイベント
name属性を持たない要素で定義されたイベントは、グローバルイベントです.通常、グローバルイベントは1つしかありません.同じイベントを定義する別のラベルがある場合、前に定義した同じイベントは上書きされます.
注-別のxmlファイルまたは他のシーンをロードすると、新しいxmlファイルまたはシーンで再定義されない限り、すべてのグローバルイベントは保持されます.
独立ローカルkrpanoイベント
name属性を持つ要素によって定義されたイベントは、独立したイベントです.すべてのタイプのイベントを含めることができますが、グローバルイベントは上書きされず、別途呼び出されます.これらの「命名」された要素は、keepプロパティ(デフォルトはfalse)を有します.これは、keep=”true”のない要素が、新しいパノラマロード時に自動的に除去されることを意味する.
ヒント–名前付きイベントは、他のプラグインまたはxmlコードに影響を及ぼさずに、独立したプラグインおよびコードで機能します.
<events onenterfullscreen=”” 		'          。'
		onexitfullscreen=””	'                    。'
		onxmlcomplete=””	'           , onxmlcomplete  ,    scene。'
		onpreviewcomplete=””	'              。'
		onloadcomplete=””	'            。          ,               '
		onnewpano=””		'              view   (type, imagesize, hfov, vfov)      。'
		onremovepano=””		'             (            )。'
		onnewscene=””		'           , onxmlcomplete  ,    scene。'
		onxmlerror=””		'    ,    '
		onloaderror=””		'    ,    '
		onkeydown=””		'       keycode   。    '
		onkeyup=””		'                 。          keycode   。'
		onclick=””		'               。'
		onsingleclick=””	'         。'
		ondoubleclick=””	'         '
		onmousedown=””		'                 。'
		onmouseup=””		'            。'
		onmousewheel=””		'             。'
		oncontextmenu=””	'                ,           (                   )           。'
		onidle=””		'           idletime           。'
		onviewchange=””		'                     。'
		onviewchanged=””	'                    。   –                       !'
		onresize=””		'           area            。'
		onautorotatestart=””	'             。'
		gyro_onavailable=””			''
		gyro_onunavailable=””		''
		gyro_onenable=””			''
		gyro_ondisable=””			''
		webvr_onavailable=””		''
		webvr_onunavailable=””		''
		webvr_onunknowndevice=””	''
		webvr_onentervr=””			''
		webvr_onexitvr=””			''

/>
onloaderror=""onxmlerror=""読み込みエラーが発生した場合、次のイベントが呼び出されます.
xmlロードまたは解析エラーの場合、onxmlerrorイベントが呼び出されます.onloaderrorイベントは、画像ロードエラー(すべてのタイプの画像がパノラマ、layer、またはホットスポットを含む)のときに呼び出される.これらのイベントが設定されていない場合は、デフォルトのエラー処理が実行されます.つまり、xml解析エラーの場合は致命的なエラー情報が表示され、画像ロードエラーの場合はkrpano情報ウィンドウに表示されます.onxmlerrorイベントおよびいくつかのカスタムエラー処理を使用して、xmlエラーが発生した場合でもviewerを引き続き使用できます.エラー情報はlasterror変数に格納されます.
注意–onxmlerrorイベントはhtml 5 viewerでのみ使用できます.
onkeydownキーボードキーが押されたときにイベントを呼び出します.
キーボードボタンが押されたときにイベントが呼び出されます.ボタン情報はkeycode変数に格納される.1つのキーが押し続けると、onkeydownの繰り返しイベントが自動的に送信されます.control.keydownrepeatを使用して遮蔽することができる.
onsingleclick ondoubleclickクリックとダブルクリックの特殊なイベントを検出します.
クリックとダブルクリックの特殊なイベントを検出します.通常のonclickイベントとは異なり(トリガは即時)、onsingleclickイベントのトリガは、2回目のクリックがダブルクリックイベントとして扱われるかどうかを確認する必要があるため、(最大400ミリ秒まで)少し遅延する可能性があります.したがって、1回のクリックイベント(通常のonclickイベントに比べて少し遅延してトリガーされる)が2回のクリックイベント–2つのクリック間の距離がマウスから遠すぎる場合があります.1つのダブルクリックイベント–2つのクリックの間隔が非常に短く、マウスがほとんど移動しません.mouse.clickxおよびmouse.clicky変数は、最新のマウスクリック座標を格納する.タッチスクリーンアプリケーションも同様にサポートされています(たとえば、シングルタッチと2回タッチ)
onmousewheel
このイベントは、マウスホイールが使用されているときに呼び出されます.マウスホイールデータは、wheeldeltaおよびwheeldelta_raw変数に格納される.マウスを持たないタッチスクリーンデバイスでは、このイベントは2指ジェスチャーでスケールしたときに呼び出されます.wheeldeltaデータは、スケーリングに基づいて正または負の値として決定されます.wheeldelta_touchscale変数は、この場合、より詳細な情報を提供します.
onviewchange
最終レンダリングが完了する前または現在の視点が変化したときに呼び出されます.このイベントでは、viewに設定された評価および視点制限の設定はまだ完了していない.これにより、最終レンダリングが完了する前にイベント内で視点を変更できます.注記–このイベントの使用は、レンダリングの品質とブラウズの速度に影響を与える可能性があります.
onresize
このイベントは、スクリーンウィンドウが変化したり、areaサイズが変化したりしたときに呼び出されます.また、新しいパノラマをロードすると、イベントも呼び出されます.新しいウィンドウサイズは、stagewidthstageheightの2つの変数に格納されます.新しいareaサイズは、area.pixelwidthおよびarea.pixelheightによって取得することができる.
onautorotatestart
自動回転が開始されるとイベントが呼び出されます.たとえばautorotate.enabledは、enabledがユーザインタラクションのないautorotate.waittimeの待機時間を経過したか、autorotate.start()を呼び出したように設定されます.特定の自動ローミングのユーザーインタフェースを表示したり、通常のユーザーインタフェースを非表示にしたりすることができます.
onautorotatestop
自動回転が停止するとイベントが呼び出されます.通常、ユーザは、disabledまたはstoppedによって回転または回転を中断する.onautorotatestartで変化したすべてのことを回復することができます.の
onautorotateoneround
このイベントは、360度回転したとき、またはローカルパノラマまたは平面パノラマが左から右に完全に横揺れたときに呼び出されます.ローミングで次のパノラマ(自動ローミングなど)に切り替えることができます.自動回転時に2つのパノラマ間でKEEPMOVINGパラメータを使用するとより効果的です.
onautorotatechange
autorotate.enabled設定が変更された場合にイベントが呼び出されます.自動回転ボタンの状態を更新できます.