| English | 日本語 |
|---|
Commodore 64で日本語表示及び日本語かな漢字変換を実現するためのプロジェクトです。
本プロジェクトは、Commodore 64（C64）で完全な日本語環境を提供するROMカートリッジとライブラリのセットです。「漢字ROMカートリッジを挿しておくと日本語の表示と入力が簡単に出来る」ことを目指しています。
MagicDesk形式のカートリッジ（最大1MB）に以下のデータを格納：
- 日本語フォントデータ: 美咲フォント（8x8ピクセル）によるJIS X 0208全角文字とJIS X 0201半角文字
- かな漢字変換辞書: SKK形式辞書のバイナリ版（送りなし・送りあり対応）
- 文字列リソース: ゲームやアプリケーション用の固定文字列データ
カートリッジのデータを活用するためのライブラリ：
- jtxt.p8: 日本語表示ライブラリ（テキストモード/ビットマップモード両対応）
- ime.p8: かな漢字変換ライブラリ（ローマ字入力、候補選択）
汎用的なライブラリ：
- swiftlink.p8: SwiftLink RS-232通信ライブラリ(各種ボーレート対応、ハードウェアフロー制御)
- 日本語表示: 漢字・ひらがな・カタカナを8x8ピクセルのビットマップフォントで表示
- かな漢字変換: ローマ字入力から日本語への変換、複数候補からの選択
- Shift-JIS対応: 標準的な文字コードでテキストデータを扱える
- 高速アクセス: ROM配置により高速な文字描画と辞書検索を実現
- 省メモリ設計: 8ビット機の限られたRAMでも動作
- Python 3.x
- Prog8コンパイラ v11.4.1以降（64tassアセンブラを含む）
- GNU Make
- curl（フォントダウンロード用）
- unzip（フォント展開用）
- VICEエミュレータ（推奨: x64sc）
- または実機のCommodore 64 + MagicDesk対応カートリッジ（詳細は後述）
ビルド済みのバイナリを使ってすぐに試したい場合：
Releasesページから最新版をダウンロードしてください。
c64jpkanji.crt- ROMカートリッジファイルc64jp_programs.d64- サンプルプログラム集
# VICEエミュレータの場合
x64sc -cartcrt c64jpkanji.crt -8 c64jp_programs.d64
# カートリッジ装着後、D64をマウントしてプログラムを選択実行
LOAD"$",8
LIST
# 実行したいプログラムを選んでロード・実行
LOAD"HELLO",8,1
RUN- カートリッジの準備: CRTファイルを対応フラッシュカートリッジ（EasyFlash3、Ultimate 64等）に書き込み
- ディスクイメージの転送: D64ファイルをSD2IECやUltimate等でマウント
- プログラムの選択:
LOAD"$",8でディレクトリを表示 - プログラムの実行:
LOAD"プログラム名",8,1でロードしてRUN
HELLO- 基本的な日本語表示デモHELLO BITMAP- ビットマップモード表示IME TEST- かな漢字変換デモMODEM TEST- SwiftLink通信テスト
git clone https://github.com/h-o-soft/c64jp.git
cd c64jp# デフォルトプログラム（hello.p8）のビルドと実行
make run
# 日本語IMEテストプログラムの実行
make TARGET=ime_test run
# 文字列リソース付きで実行
make TARGET=hello_resource run-strings| ターゲット | 説明 |
|---|---|
make |
デフォルトプログラム（hello.p8）をビルド |
make run |
ビルドして実行（基本カートリッジ使用） |
make run-strings |
文字列リソース付きカートリッジで実行 |
make run-no-crt |
カートリッジなしで実行 |
make clean |
ビルド成果物を削除 |
make clean-all |
フォントファイルを含む全ての生成ファイルを削除 |
| ターゲット | 説明 |
|---|---|
make dict |
辞書を更新してCRTファイルを作成 |
make crt |
基本CRTファイルのみ作成 |
make fonts |
フォントファイルのみ作成 |
| ターゲット | 説明 |
|---|---|
make run-modem |
モデムエミュレーション設定で実行 |
make ime |
IMEテストを実行（make TARGET=ime_test runのエイリアス） |
make stateful |
文字列リソーステストを実行 |
| ターゲット | 説明 |
|---|---|
make oscar-build |
Oscar64でhelloサンプルをビルド |
make oscar-hello |
helloサンプルをビルドして実行 |
make oscar-qe-build |
Oscar64でQEエディタをビルド |
make oscar-qe-run |
QEエディタをビルドして実行 |
make oscar-crt-build |
EasyFlash CRTをビルド |
make oscar-crt-run |
EasyFlash CRTをビルドして実行 |
make oscar-clean |
Oscar64ビルド成果物を削除 |
make oscar-term-build |
Oscar64でターミナルをビルド |
make oscar-term-crt |
ターミナルMagicDesk CRTをビルド |
詳しくは c/oscar64_term/README.md を参照してください。
# ビルドするプログラムを指定
make TARGET=hello run
# 辞書ファイルを指定
make DICT_FILE=mydict.txt dict
# エミュレータを変更
make EMU_COMMAND=ccs64 EMU_CARTRIDGE_OPT=-cart run
# 追加オプションを指定
make EMU_EXTRA_OPTS='-warp -autostartprgmode 1' runc64-kanji-rom/
├── Makefile # メインビルドファイル
├── prog8/ # Prog8ソースコード
│ └── src/
│ ├── jtxt.p8 # 日本語表示ライブラリ
│ ├── ime.p8 # かな漢字変換ライブラリ
│ ├── swiftlink.p8 # SwiftLink通信ライブラリ
│ └── *.p8 # 各種テストプログラム
├── c/ # C言語版
│ ├── oscar64_lib/ # Oscar64共有ライブラリ（jtxt, IME, c64uネットワーク）
│ ├── oscar64/ # Oscar64 helloサンプル
│ ├── oscar64_qe/ # Oscar64 QEエディタ
│ ├── oscar64_crt/ # Oscar64 EasyFlash CRT版
│ ├── oscar64_term/ # ターミナル（Ultimate II+ネットワーク）
│ └── src/ # llvm-mos版ソース
├── fontconv/ # フォント変換ツール（美咲フォント→バイナリ）
│ ├── mkfont.py # フォント変換スクリプト
│ └── Makefile # フォントビルド用
├── dicconv/ # 辞書変換ツール（SKK辞書→バイナリ）
│ └── dicconv.py # SKK辞書変換スクリプト
├── stringresources/ # 文字列リソース管理
│ └── convert_string_resources.py
├── createcrt/ # CRTファイル作成
│ └── create_crt.py # MagicDesk CRT作成スクリプト
└── crt/ # 生成されたCRTファイル
日本語文字の画面表示を担当。ROMカートリッジ内のフォントデータを使用して高速描画。
init(start_char, char_count, mode)- ライブラリ初期化putc(char)/bputc(char)- 1文字出力（Shift-JIS対応）puts(str)/bputs(str)- 文字列出力locate(x, y)/blocate(x, y)- カーソル位置設定cls()/bcls()- 画面クリアset_color(fg)/bcolor(fg, bg)- 色設定
ローマ字入力から日本語への変換を担当。ROMカートリッジ内の辞書データを使用。
- ローマ字→ひらがな変換
- ひらがな→漢字変換（辞書検索）
- 変換候補の表示と選択
- 送りなし・送りあり両対応
日本語とは関係ないがSwiftLinkを使いRS-232シリアル通信を行うライブラリ。
- 各種設定による初期化
- データの送受信
- ハードウェアフロー制御によるデータロス防止
- フォント作成: 美咲フォントPNGから8x8ビットマップデータを生成
- 辞書変換: SKK形式テキスト辞書をバイナリ形式に変換
- 文字列リソース作成: テキスト/CSVファイルからインデックス付きバイナリを生成（オプション）
- CRT作成: フォント、辞書、文字列リソースを含むMagicDesk形式CRTファイルを生成
- プログラムコンパイル: Prog8ソースコード（jtxt.p8、ime.p8使用）をPRGファイルにコンパイル
- 実行: VICEエミュレータでCRTをロードしてプログラムを実行
本プロジェクトで作成されるカートリッジファイルは MagicDesk形式 のCRTファイルです。実機での動作には、以下のいずれかの方法でCRTファイルを実機に転送する必要があります：
- EasyFlash3: CRTファイルを直接書き込み可能
- Ultimate 64/1541 Ultimate: SDカードからCRTファイルを直接マウント
- その他のフラッシュカートリッジ: MagicDesk形式対応のものを使用
MagicDesk形式はI/O領域の $DE00 を使用するため、同じアドレス範囲を使用する他の機器との競合に注意が必要です：
- 本プロジェクトの
swiftlink.p8は $DF00 をベースアドレスとして設定 - REU使用時の注意: REUは$DF00〜$DF0Aを使用するため、REUとSwiftlinkを併用する場合はSwiftlinkを$DF80に移動する必要があります
- Ultimate 64環境でREU併用時の推奨設定：
- カートリッジ: $DE00（デフォルト）
- REU: $DF00〜$DF0A（REUが使用）
- Swiftlink: $DF80（競合回避のため）
Swiftlinkのベースアドレスを変更する場合：
// swiftlink.p8内で以下を変更
const uword SWIFTLINK_BASE = $DF80 ; $DF00から$DF80に変更
変更後は再ビルドが必要です：
make clean
make TARGET=modem_test run| ハードウェア | 対応状況 | 備考 |
|---|---|---|
| EasyFlash3 | ✅ 対応 | CRT直接書き込み |
| Ultimate 64 | ✅ 対応 | SDカードマウント |
| 1541 Ultimate-II+ | ✅ 対応 | SDカードマウント |
| Kung Fu Flash | ✅ 対応 | SDカードマウント |
| Final Cartridge III | ❌ 非対応 | MagicDesk非対応 |
make fonts # フォントファイルを作成make dict # 辞書とCRTファイルを作成# エミュレータパスを確認
which x64sc
# 別のエミュレータを使用
make EMU_COMMAND=/path/to/emulator run# クリーンビルド
make clean-all
make run- カートリッジファイルがMagicDesk形式で正しく作成されているか確認
- フラッシュカートリッジがMagicDesk形式に対応しているか確認
- 実機の電源を一度切ってからカートリッジを挿入し直す
- I/Oアドレス競合の可能性を確認（上記「I/Oアドレスの競合について」参照）
- ハードウェアジャンパー設定を確認
- モデムケーブルの接続を確認
MITライセンス - 詳細はLICENSEファイルを参照してください。
- 美咲フォント: 門真なむ氏作成
- ライセンス: MITライセンス
- 美咲フォントはROMカートリッジに含まれます
- 各辞書ファイルのライセンスに従ってください
- 本プロジェクトは naist-jdic SKK dictionary をベースとした辞書を使用しています。
プルリクエストを歓迎します。大きな変更の場合は、まずissueを開いて変更内容について議論してください。
Hiroshi OGINO / H.O SOFT Inc.
- ライブラリの最適化: AIが書いた複雑で冗長なコードを整理しメモリ使用量と速度を改善
- アセンブラ呼び出し対応: ライブラリをアセンブラから直接利用可能にする
- ROMからのライブラリ展開: jtxt及びimeをカートリッジROMに格納し、起動時に$A000〜$BFFF等のRAMに展開してライブラリとして利用可能にすることでアプリケーションメモリを解放(要検討項目)
- 辞書の改良: より高精度な変換のための辞書データ強化(特に固有名詞の追加)
- 通信アプリ: エスケープシーケンスの簡易的な対応
- 美咲フォントの作者である門真なむ氏に感謝します
- Prog8の作者Irmen de Jong氏に感謝します
- 64tassアセンブラの開発者に感謝します
- Commodore 64コミュニティの皆様に感謝します