jV マニュアル & 使用例

12.4.1. アプレットコードの基本部分

<!-- applet コードで記述した場合（HTML4で非推奨） -->
<applet code="クラス名"
        archive="jarファイル"
        width="アプレットの横幅"
        height="アプレットの高さ">
  オプションパラメータ
</applet>
<!-- object コードで記述した場合（HTML4ではこちらを推奨） -->
<object code="java:クラス名"
        type="application/x-java-applet"
        codetype="application/java"
        archive="jarファイル"
        width="アプレットの横幅"
        height="アプレットの高さ">
  オプションパラメータ
</object>

applet要素 の code="クラス名" 属性

object要素 の classid="java:クラス名" 属性

旧型（Classic）Java Plug-inを使用する環境の場合「org.jdesktop.applet.util.JNLPAppletLauncher」、新型（Next Generation）Java Plug-inを使用する環境の場合「org.pdbj.viewer.gui.ViewerApplet」を指定します。JRE 1.5以前の環境（Mac OS X 10.4以前はJRE 1.6以降が提供されていないため必然的に該当）等では旧型で、それ以外の環境では新型のhtmlコードでアプレットが表示できます。

object の type="application/x-java-applet"

object の codetype="application/java"

object要素で記述する場合にのみ必要な属性です。

archive="jarファイル"

jVアプレット表示に必要となるjV本体、JOGL、アプレットランチャーのjarファイルを指定します。指定するファイルの詳細は以下の通りです。ファイルの指定は完全なURL（同一ウェブサーバ内のファイルを参照する場合、http://www.sample.org のようなプロトコル名＋完全修飾ドメイン名は省略可能）で行い、複数の指定はコンマで区切ります。サーバへのjV配置で示した事例の場合、指定値は以下のようになります。

archive="/jv/jv4_2_signed.jar,
        /jv/applet-launcher.jar,
        /jv/gluegen-rt.jar,
        /jv/lib/jogl.all.jar"

各指定値について以下に説明します。

jV本体

画像保存などのウェブクライアント側に変更を加える機能を利用できるようにするには、Java拡張機能を有効にする必要があります。Java拡張機能を利用するには署名されたjarファイル（jv4_2_signed.jar）を指定する必要があります。非署名版（jv4_2.jar）を指定すると、Java拡張機能が利用できなくなります。この事例の場合、指定値は /jv/jv4_2_signed.jar または /jv/jv4_2.jar となります

アプレットランチャー関係

アプレットランチャーを利用して環境に応じたJOGLを自動ダウンロードする機能も組み込む場合、applet-launcher.jar と gluegen-rt.jar の場所を示すURLも指定します。ウェブサーバ内のURLでも配布元のURLでも構いません。配布元のURLについてはアプレットランチャーについてを参照下さい。 この事例のようにあらかじめウェブサーバ内の /var/www/html/jv にダウンロードしてそちらを利用する場合、指定する値は以下のようになります。

• /jv/pplet-launcher.jar
• /jv/gluegen-rt.jar

JOGL

jV4.0以前とjV4.1以降では指定するファイル名が異なります。jV4.0以前では jogl.jar、jV4.1以降ではjogl.all.jar を指定します。この事例では /jv/lib/jogl.all.jarを指定することになります。

アプレットの横幅

アプレット領域の横幅を指定します。整数値で指定した場合はピクセル単位での絶対指定、数値の後に"%"を記した場合は親要素の横幅に対する相対指定となります。

アプレットの高さ

アプレット領域の高さを指定します。整数値で指定した場合はピクセル単位での絶対指定、数値の後に"%"を記した場合は親要素の高さに対する相対指定となります。

オプションパラメータ

追加で様々な指定を加えることができます。詳細は次項を参照下さい。

12.4.2. オプションパラメータ

if(navigator.userAgent.indexOf("Mac") != -1 ){
  document.write('<param name="newt" value="true"/>');
}

注

1. ファイルはgzip圧縮されたものでも扱えます。
2. URLは「http://」で始まるもののみ有効です。「ftp://」などはエラーになり「Can't Find PDBML File.」警告ダイアログが表示されます。

12.4.3. アプレットランチャーを使用したコード例

コードの前部は一般的なアプレットランチャーの指定とほぼ同じです。詳しくはアプレットランチャーのウェブサイトをご覧下さい。後方ではjVのパラメータ指定を行っています。コードの記述方法はウェブクライアントのJava環境（Java Runtime Environment）のバージョン等によって異なります。詳しくは下記事例をご覧下さい。下記各例はいずれも必要な各ファイルが html ファイル（あるいはhtmlコードを出力するcgi）と同一ディレクトリにある場合の事例です。必要なファイルが別の場所にある場合は適宜パス指定を追加して記述して下さい。

• Classic Java Plug-in環境（Mac OS X 10.4以前等JRE 1.5以前の環境）用 - applet要素 / object要素
• New Java Plug-in 非Mac環境（JRE 1.6以降の非Mac環境）用 - applet要素 / object要素(IE) / object要素(IE以外)
• New Java Plug-in Mac環境（Mac OS X 10.5 Update 7以降のJRE 1.6以降のMac環境）用 - applet要素 / object要素

注：

• JREのバージョンによってアプレットランチャーがうまく動作しない場合があります。詳しくはトラブルシューティングをご覧下さい。
• 各環境での動作する条件やコードをこちらに掲載しています。合わせてご覧下さい。

ウェブクライアントの環境により適用するhtmlコードを変えるには、cgi等を使いウェブサーバ側で制御する方法と、JavaScriptを用いてウェブクライアント側で制御する方法があります。以下に各コードで記述する事例を示します。

• PHP
• JavaScript

Classic Java Plug-in環境（Mac OS X 10.4以前等JRE 1.5以前の環境）用 - applet要素による記述

<applet name="jVwindow"
        height="600" width="600"
        archive="applet-launcher.jar, jogl.jar, gluegen-rt.jar, jv3.jar"
        code="org.jdesktop.applet.util.JNLPAppletLauncher">
  <-- height:アプレットの高さ、width:アプレットの幅
      archive:追加ファイルのURL
      code:アプレットランチャーを指定する固有コード -->
  <param name="subapplet.classname" value="org.pdbj.viewer.gui.ViewerApplet"/> <!-- jVアプレットのクラス名指定 -->
  <param name="subapplet.displayname" value="jV applet"/>
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</applet>
  

Classic Java Plug-in環境（Mac OS X 10.4以前等JRE 1.5以前の環境）用 - object要素による記述

<object name="jVwindow"
        height="600" width="600"
        classid="java:org.jdesktop.applet.util.JNLPAppletLauncher"
        type="application/x-java-applet"
        codetype="application/java"
        archive="applet-launcher.jar, jogl.jar, gluegen-rt.jar, jv3.jar">
  <-- height:アプレットの高さ、width:アプレットの幅
      classid:アプレットランチャーを指定する固有コード
      type,codetype:オブジェクトの種類の示す
      archive:追加ファイルのURL -->
  <param name="subapplet.classname" value="org.pdbj.viewer.gui.ViewerApplet"/> <!-- jVアプレットのクラス名指定 -->
  <param name="subapplet.displayname" value="jV applet"/>
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</object>
  

New Java Plug-in 非Mac環境（JRE 1.6以降の非Mac環境）用 - applet要素による記述

<applet name="jVwindow"
        height="600" width="600"
        code="org.pdbj.viewer.gui.ViewerApplet">
  <-- height:アプレットの高さ、width:アプレットの幅
      code:jVを指定する固有コード -->
  <param name="jnlp_href" value="http://pdbj.org/jv/jv-applet.jnlp"/> <!-- new Java Plug-in に必要 -->
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</applet>
  

New Java Plug-in 非Mac環境（JRE 1.6以降の非Mac環境）用 - object要素による記述（Internet Explorerの場合）

<object name="jVwindow"
        height="600" width="600"
        classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
        data="java:org.pdbj.viewer.gui.ViewerApplet">
  <-- height:アプレットの高さ、width:アプレットの幅
      classid:Java Plug-inであることを示すコード
      code:jVを指定する固有コード -->
  <param name="jnlp_href" value="http://pdbj.org/jv/jv-applet.jnlp"/> <!-- new Java Plug-in に必要 -->
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</object>
  

New Java Plug-in 非Mac環境（JRE 1.6以降の非Mac環境）用 - object要素による記述（Internet Explorer以外）

<object name="jVwindow"
        height="600" width="600"
        classid="org.pdbj.viewer.gui.ViewerApplet"
  <-- height:アプレットの高さ、width:アプレットの幅
      classid:Java Plug-inであることを示すコード
      code:jVを指定する固有コード -->
  <param name="jnlp_href" value="http://pdbj.org/jv/jv-applet.jnlp"/> <!-- new Java Plug-in に必要 -->
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</object>
  

New Java Plug-in Mac環境（Mac OS X 10.5 Update 7以降のJRE 1.6以降のMac環境）用 - applet要素による記述

<applet name="jVwindow"
        height="600" width="600"
        code="org.pdbj.viewer.gui.ViewerApplet">
  <-- height:アプレットの高さ、width:アプレットの幅
      code:jVを指定する固有コード -->
  <param name="jnlp_href" value="http://pdbj.org/jv/jv-applet.jnlp"/> <!-- new Java Plug-in に必要 -->
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="newt" value="true"/> <!-- 非Mac用との違いはこの1行が追加されているのみ -->
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</applet>
  

New Java Plug-in Mac環境（Mac OS X 10.5 Update 7以降のJRE 1.6以降のMac環境）用 - object要素による記述（Internet Explorer以外）

<object name="jVwindow"
        height="600" width="600"
        classid="org.pdbj.viewer.gui.ViewerApplet"
  <-- height:アプレットの高さ、width:アプレットの幅
      classid:Java Plug-inであることを示すコード
      code:jVを指定する固有コード -->
  <param name="jnlp_href" value="http://pdbj.org/jv/jv-applet.jnlp"/> <!-- new Java Plug-in に必要 -->
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="newt" value="true"/> <!-- 非Mac用との違いはこの1行が追加されているのみ -->
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</object>
  

JavaScript

実装したウェブページ例：例30

<object name="jVwindow"
        height="600" width="600"
        classid="org.pdbj.viewer.gui.ViewerApplet"
  <-- height:アプレットの高さ、width:アプレットの幅
      classid:Java Plug-inであることを示すコード
      code:jVを指定する固有コード -->
  <param name="jnlp_href" value="http://pdbj.org/jv/jv-applet.jnlp"/> <!-- new Java Plug-in に必要 -->
  <param name="noddraw.check" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="noddraw.check.silent" value="true"/> <!-- WindowsでDirectDrowを使わないための設定 -->
  <param name="progressbar" value="true"/> <!-- ロード中にプログレスバーを表示する -->
  <param name="jnlpNumExtensions" value="1"/>
  <param name="jnlpExtension1" value="jogl.jnlp"/>
  <param name="newt" value="true"/> <!-- 非Mac用との違いはこの1行が追加されているのみ -->
  <param name="pdbURL" value=""/>
  <param name="pdbmlURL" value="http://service.pdbj.org/XML/viewer/148l-noatom.xml.gz">
  <param name="polygonURL" value=""/>
  <param name="commands" value="set picking ident;background black;wireframe off;cartoon;color group"/>
</object>