#

## 目次

- HSPLet の紹介
- 始める前に
- 使い方
- 使用上の注意
- HTML のカスタマイズ
- 拡張ライブラリの使用
- ギャラリへの投稿

## HSPLet の紹介

HSPLet はインタープリタ言語 HSP の Java によるランタイムの実装です。 HSPLet は Java によって記述されているので環境依存が少なく、多くのプラットフォームで HSP 製のプログラムを動作させることが出来ます。 また、アプレットとして HTML ページに埋め込むことも出来ます。

HSPLet のサポートおよび最新版の入手は Group Finity の Web サイト で行っています。

## 始める前に

HSPLet を使用するためには HSP のプログラムがコンパイルできる環境と知識が必要です。 HSP の開発環境は HSP の公式サイト で入手できます。

アプレットとして Web ページに表示するには FTP など、Web サイトの管理方法に関する知識が必要です。 もし自分のサイトを持っていないときやわからないときは連絡してもらえれば Group Finity のサイトで代理公開することもできます。

このドキュメントでは出来るだけそれ以外の環境、知識は必要ないように説明したいと思いますが、 わからない点があるときはお知らせください。 そのようなフィードバックはドキュメントの充実に大変役立ちます。

## 使い方

HSPLet をアプレットとして動作させる方法を説明します。

1. まず Java アプレットを実行できるように JRE をインストールします。 IE なら付属のサンプルを表示するだけで自動的にインストールされます。

   JRE をインストールすると *.jar をアプレットとして実行できるようになります。

2. 次に HSP コンパイラを使用して実行したいプログラムをコンパイルして *.ax を作成します。

3. HSPLet 付属の compiler.exe を起動して、*.ax ファイルをパックファイルに追加します。 コンパイルが完了すると *.jar（アプレットの本体）、*.html（アプレットを表示する HTML） ファイルが出来上がります。

4. *.html を表示するとプログラムを実行できます。

5. サーバーにアップロードするときは、*.jar、*.html を同じフォルダにおいてください、*.ax やパックファイルに詰め込んだファイルを一緒にアップロードする必要はありません。

## 使用上の注意

HSPLet 用にプログラムを書く際に注意しなければいけないことがいくつかあります。

- すべての命令がサポートされているわけではありません

  セキュリティ上問題のある命令や、プラットフォームに依存した命令、あるいは Java では実行できない命令などはサポートされていません。

  サポートされている命令の中でも、一部の機能しか使用されないものや HSPLet でしか機能しない拡張が行われているものなどもあります。 命令サポート状況のリストにリンクの付いているものは、付加説明があるので必ず読んでおいてください。

- アプレットとして使用するときは、codebase より上のディレクトリ上のファイルは読み込めません

  codebase は必ず必要な全てのファイル (hsplet.jar を含む) よりも上のディレクトリを指定するようにしてください。 （普通は codebase を意識する必要はありません。）

- 悪意がこめられているのではないかと思われるようなプログラムは組まない

  ダブルクリックしなければ実行されない exe ファイルと違って HSPLet はページを表示するだけで自動的に実行されます。 ページを表示した人が不快に感じるようなプログラムは組まないようにしましょう。 HSPLet や、ひいては HSP 全体に対して悪いイメージを持たれることになりかねません。

  特に別ウィンドウを表示するプログラムを作成するときは注意してください。

## HTML のカスタマイズ

オリジナルのテンプレートを使用したり、自動生成された HTML を修正するときは以下のことに注意してください。

- コメントを削除したり書き換えたりしない

  生成された HTML 内のコメントは IE と Firefox、Opera の両方で正しく表示するために重要な意味を持っています。 コメントだからといって修正したり削除すると正しく表示できなくなります。

- HSPLet への入手先のリンクは削除してもかまいませんが、より多くの方に HSPLet を使用してもらえるように何らかの形で残しておいてもらえると幸せです。

## 拡張ライブラリの使用

HSPLet では Windows に依存する DLL は使用できません。 その代わり、HSPLet 用に作成された専用のライブラリ（以降拡張ライブラリと呼びます）を使用することができます。 作成した拡張ライブラリに対応するクラスの jar ファイルを lib フォルダ内にコピーすると、 コンパイラにチェックボックスが表示されるので、チェックをつければ使用できます。

拡張ライブラリの作成法については src.zip 内に入っている winmm.java などを参考にしてください。

## ギャラリへの投稿

Group Finity の Web サイトでは HSPLet によるアプレットや、拡張ライブラリの投稿を受け付けています。 自信作ができたらぜひ投稿してください。 投稿の方法は メール または掲示板にて、 形式は、アプレットのファイル一式を投稿し、 Group Finity の Web サイト 内に置く形でも、実際に使用しているページにリンクを張る形でもかまいません。