Table of contents目次

  1. Development environment 開発環境
  2. OpenJDK
  3. On Windows Windowsの場合
  4. On macOS macOSの場合
  5. Terminal ターミナル
  6. How to check version number of installed Java インストールされているJavaのバージョンの確認方法
  7. Start 起動する
  8. Specify CGROM.DAT CGROM.DATを指定する
  9. Start from a disk image file ディスクイメージファイルから起動する
  10. Start from a directory ディレクトリから起動する
  11. Quit 終了する

1. Development environment 開発環境

XEiJ development environment is a desktop PC that consists of an AMD Ryzen 9 3900X 12-Core Processor 3.79 GHz, AMD Radeon VII, RAM 32.0 GB and Windows 10 Pro. XEiJ の開発環境は、AMD Ryzen 9 3900X 12-Core Processor 3.79 GHz、AMD Radeon VII、RAM 32.0 GB、Windows 10 Pro で構成されるデスクトップ PC です。

2. OpenJDK

XEiJ runs under OpenJDK and uses Swing as its GUI. At the time of writing, the latest OpenJDK is 23, but please use the most recent OpenJDK possible. XEiJ は OpenJDK で動作します。GUI は Swing を使用します。 これを書いている時点で最新の OpenJDK は 23 ですが、可能な限り最新の OpenJDK を使用してください。

3. On Windows Windows の場合

  1. Open OpenJDK JDK 23 GA Release. OpenJDK JDK 23 GA Releaseを開きます。
  2. Download openjdk-23_windows-x64_bin.zip . openjdk-23_windows-x64_bin.zip をダウンロードします。
  3. Right click the icon of openjdk-23_windows-x64_bin.zip and select "Extract All...". openjdk-23_windows-x64_bin.zip のアイコンを右クリックして「すべて展開 ...」を選択します。

A dialog, Extract Compressed (Zipped) Folders, appears. 「圧縮 (ZIP 形式) フォルダーの展開」というダイアログが表示されます。

  1. Input C:\ into the field, Files will be extracted to this folder. 枠「ファイルを下のフォルダーに展開する」に C:\ を入力します。
  2. Click the Extract button. 「展開」ボタンをクリックします。

OpenJDK is extracted in C:\jdk-23. OpenJDK が C:\jdk-23 に展開されます。

If 7-Zip is installed, select 7-Zip -> Extract files... and enter C:\ in Destination folder. 7-Zip がインストールされている場合は「7-Zip」→「展開 ...」を選択して「展開先」に C:\ を入力します。

  1. Press Windows+Pause to open "System info". Windows+Pause を押して「システム情報」を開きます。
  2. Click "Advanced system settings". 「システムの詳細設定」をクリックします。
  3. Click "Environment Variables". 「環境変数」をクリックします。
  4. Select Path in "System variables" and click "Edit". 「システム環境変数」の Path を選択して「編集 ...」をクリックします。
  5. Click "New" and input C:\jdk-23\bin. 「新規」をクリックしてC:\jdk-23\binを入力します。
  6. Click "OK". 「OK」をクリックします。
  7. Click "OK". 「OK」をクリックします。
  8. Close open windows. 開いているウインドウを閉じます。

If an environment variable is corrupted, it is not easy to recover. Please check carefully to make sure that you are not trying to write to an adjacent line by mistake. It is safer to make backups before starting work. 環境変数を破損すると復旧は容易ではありません。 間違って隣の行に書き込もうとしていないかなどよく確認しながら行ってください。 バックアップを取ってから作業を行うとより安全でしょう。

4. On macOS macOS の場合

tantan and yunkya2 have published instructions for installing XEiJ on macOS. Thank you very much. ユーザーの方が macOS における XEiJ のインストール手順を公開してくださっています。 ありがとうございます。

5. Terminal ターミナル

The place where you type in commands by hand is often called a terminal. You can learn how to use them by searching for "Windows Terminal," "macOS Terminal," "Linux Terminal," etc. (Thanks DON) コマンドを手で打ち込む場所はターミナルと呼ばれることが多いようです。 「Windows ターミナル」「macOS ターミナル」「Linux ターミナル」などを検索するとそれらの使い方が分かります。(Thanks DON)

6. How to check version number of installed Java インストールされている Java のバージョンの確認方法

Enter the following command in the terminal. ターミナルで以下のコマンドを入力します。 

>java -version
openjdk version "23" 2024-09-17
OpenJDK Runtime Environment (build 23+37-2369)
OpenJDK 64-Bit Server VM (build 23+37-2369, mixed mode, sharing)

When XEiJ is running, you can check the version of Java that is running in the Java runtime environment information in the Config menu. XEiJ が動作しているときは設定メニューのJava 実行環境の情報で実行中の Java のバージョンを確認できます。

7. Start 起動する

Move to the directory where XEiJ.jar is located in the terminal and run java -jar XEiJ.jar to start XEiJ. ターミナルで XEiJ.jar があるディレクトリに移動して java -jar XEiJ.jar を実行すると XEiJ が起動します。 

>cd /(directory where XEiJ.jar is located)/
>java -jar XEiJ.jar

execute1.png

8. Specify CGROM.DAT CGROM.DAT を指定する

In the initial state, alternative CGROM data is used, and the font is different from that of the actual device. To use the same font as the actual device, take the CGROM data of the actual device as CGROM.DAT or CGROM30.DAT and specify it with the parameter cgrom. 初期状態では代替の CGROM データが使われており、実機とフォントが異なります。 実機と同じフォントにするには、実機の CGROM データを CGROM.DAT または CGROM30.DAT として取り出し、パラメータ cgromで指定します。

How to create CGROM30.DAT CGROM30.DAT の作り方

Once specified, the parameter is saved in the configuration file until it is overwritten or initialized. There is no need to specify the same parameter each time. 一度指定されたパラメータは上書きされるか初期化されるまで設定ファイルに保存されます。 同じパラメータを毎回指定する必要はありません。

9. Start from a disk image file ディスクイメージファイルから起動する

The parameter boot can be used to specify the boot device. For example, writing -boot=HUMAN302.XDF will set the boot device to FD0 and boot with HUMAN302.XDF inserted in FD0. パラメータ bootで起動デバイスを指定できます。 例えば、-boot=HUMAN302.XDF と書くと起動デバイスが FD0 になり、HUMAN302.XDF が FD0 に挿入された状態で起動します。 

>java -jar XEiJ.jar -cgrom=CGROM.DAT -boot=HUMAN302.XDF

execute2.png

SASI-HD and SCSI-HD image files can be booted using the same procedure. SASI-HD や SCSI-HD のイメージファイルも同じ手順で起動できます。

10. Start from a directory ディレクトリから起動する

XEiJ can make any directory on the host machine the boot drive of Human68k. For example, when the optical drive is E:, throw the CD-ROM version of Dennou Club into the optical drive and specify -boot=E: to boot Dennou Club. XEiJ はホストマシンの任意のディレクトリを Human68k の起動ドライブにすることができます。 例えば、光学ドライブが E: のとき、CD-ROM 版の電脳倶楽部を光学ドライブに放り込んで -boot=E: を指定すると電脳倶楽部が起動します。 

>java -jar XEiJ.jar -boot=E:

execute3.png

You can operate DSHELL in the seamless mouse mode. DSHELL はシームレスマウスモードで操作できます。

11. Quit 終了する

There are several ways to exit XEiJ. XEiJ を終了する方法は幾つかあります。