JSmol - Jmol JavaScript オブジェクト
JSmolの中核となるのはJmol JavaScriptオブジェクト(window.Jmol
)で、これにはJavaScriptの関数やユーティリティが含まれています。最初のJmolオブジェクトは2012年の初めにボブ・ハンソン(Bob Hanson)とポール・パイロット(Paul Pillot)によって開発されました。そしてこの年の後半にはJSmolに組み込まれました。ライブラリ JSmol.min.js はこのオブジェクトを提供するもので、以前はJmol Javaアプレットとともに排他的に用いられていた Jmol.js JavaScriptライブラリの後継となるものです。これを使えば、よりすっきりとした効率的な方法でウェブページ上のJmolとやりとりをすることができます。また、分子モデルの視覚化を抽象化することにより、JavaアプレットをJavaとは異なるHTML5 canvas要素(これはJmolでさえない場合もある)へとシームレスかつ選択的に置き換えることができます。
ウェブページ開発者はJSmolを使うと、もはやJavaアプレットをサポートしなくなったほとんどのウェブブラウザを対象とすることができます。これはJmolアプレットサロゲート(Jmol applet surrogate)を使っていて、互換性のある環境下でのJmol Javaアプレットをまだサポートしています。
JSmolはまた、画面の背後でRCSB PDBデータベース、米国国立がん研究センターのCACTVSサーバ、PubChemなどの公開データベースにアクセスする機能も備えています。
さらに、JSmolは以下のオブジェクトと簡単にやりとりすることができます。
- JSpecView HTML5 オブジェクト: これにより3DモデルをIR、NMR、UV/VIS、GC/MSスペクトルに関連付けることができます(より詳しい説明参照)
- JSME HTML5 オブジェクト: 簡単な化合物2d描画を使って3Dモデルを生成することができます(より詳しい説明参照)
JSmolはjQuery1.9や1.10と完全に互換性があります。(jQuery 2.0はサポートしていません。また原則として file:// を使ってローカルで実行するMSIEはサポートしないと報告されています。したがって、ローカル環境のMSIEでページを実行する必要がない場合は問題ありません。その場合、jQueryを少し修正する必要があります)。ライブラリはW3CとXHTMLで検証されています。
JSmolの主な機能
非Javaオプション | HTML5専用のオプションとJavaやHTML5/WebGLでは任意のオプション。これには、ページ上の画像やリンクをクリックするとapplet/canvas上の3Dモデリングを開始する初期「遅延アプレット」モード、初期画像が表示されている間に背後で読み込みを行う「画像+読み込み」モードなどさまざまなオプションが含まれます。 |
ライブラリファイル |
最低限j2sフォルダの中身とJSmol.min.jsファイルは必要。多言語化インタフェースを使うにはidiomaフォルダも必要。またjavaフォルダの中身も場合によって必要。 |
JavaScriptオブジェクト |
JavaScriptオブジェクト Jmol を一つつくる。これにはJmol._Applet 、Jmol._Image 、Jmol.controls などの関数や内部オブジェクトのセットが含まれています。 |
JavaScriptプロトタイプ |
Jmol.getApplet() または Jmol.getAppletHtml() を使って作成したオブジェクトは、Jmol._Applet のサブクラスとなるJavaScriptオブジェクトです。Jmol.getApplet() を使うと、applet/canvasそのものではなく、JavaScriptオブジェクトへの参照が得られます。appletやcanvasは div 要素群で囲み、より多様なオプションを使えるようにしています。 |
AJAX |
JSmolは、jQueryで提供されるAJAXを使ってクロスプラットフォームリソースへ簡単にアクセスする方法を実装しています。 |
RESTサービス |
JSmolはRCSBのキーワード検索結果にアクセスすることができます。例:caffeine(カフェイン)を参照する構造一覧。 |
スクリプト |
JSmolは、Jmolが提供していたのと同じスクリプト機能を提供します。JSmolは、applet/canvasがページを作成する前、または作成中にスクリプトコマンドをすぐに受け入れ、受け入れる準備ができるまでその内容をキャッシュします。 |
JSmol
現在あるJSmolの制限事項
バイナリファイルの読み込み
JmolページからJSmolページへの変換
「アダプタ」ライブラリJmol2.jsを用いた変換
JSmolを使わないJmolアップグレード
インストール
ファイルのダウンロード
特定のブラウザに対する配慮
ローカルファイルへのアクセス
WindowsのMSIE(Internet Explorer)
WindowsのChrome
初期設定
ブラウザに関する問題
ライブラリの読み込み
軽量版JSmol
最適構成
パラメータの設定
URLによるパラメータの設定
Jmol JavaScriptオブジェクトの各機能