p98lib リファレンス

1. p98lib とは / IDE での始め方

p98lib は、PC-98(386以上)向けにゲームのようなグラフィック プログラムを書くための、最小限のCライブラリです。画面をグラフィックモードに 切り替える・矩形や絵を描く・キー入力を読む・ちらつかずに絵を動かす、といった 「よくやること」をひとまとめにしています。

このページは include/p98.h（ヘッダファイル）を読まなくても p98lib を使えるように、「何ができるか」から使い方のコードを見せる形で まとめたリファレンスです。関数の正式な一覧は最後の 「12. 関数の総覧」にあります。

IDE での使い方

1. 左のエクスプローラーのサンプル一覧から、p98lib/ で始まる もの（hello.c / walk.c / walk2.c）を 開きます。
2. 他のサンプルと同じように、エディタ下の実行ボタン（▷）を 押すだけでそのまま動きます。

自分で新しくプログラムを書いて p98lib を使いたいときは、ファイルの どこかに #include "p98.h" と書くだけで構いません （慣例として先頭に書きますが、行頭に空白があってもファイルの1行目でなくても 構いません）。それだけで、ビルドの内部処理が自動的に huge model（p98lib が 必要とするメモリモデル）とライブラリのリンクに切り替わります。特別な設定は要りません。

動く最小のプログラム

画面を初期化し、色5（緑+青）の矩形を1つ描いて表示し、しばらく待ってから 終了する、最小のプログラムです（サンプルの hello.c と同じ内容）。

#include "p98.h"

int main(void) {
    int i;

    p98_init();
    p98_clear(0);
    p98_fill_rect(100, 50, 200, 80, 5);
    p98_flip();

    for (i = 0; i < 60; i++) {
        p98_wait_vsync();
    }

    p98_quit();
    return 0;
}

ここで出てきた p98_init()・p98_clear()・ p98_fill_rect()・p98_flip()・ p98_wait_vsync()・p98_quit() の意味は、 次の章から順番に説明します。

2. 画面を出す・消す

3. 色とパレット

p98lib の描画関数（p98_clear() や p98_fill_rect() など）が受け取る「色」は、0〜15 の色番号です。これは RGBの値そのものではなく、4本のビット面のON/OFFの組み合わせを 表す番号です。

色番号の各ビットの意味は次のとおりです。

例えば 5（2進数で 0101）は bit0(青)+bit2(緑) が 立っているので「緑+青＝シアン」になります。10（1010）は bit1(赤)+bit3(輝度) なので「輝度+赤＝明るい赤」です。慣れないうちは、 欲しい色を「赤・緑・青のどれを混ぜるか」＋「輝度を足すか」で考えると 組み立てやすいです。

16色の既定パレット

p98_init() を呼ぶと、パレットは次の16色から始まります （8番だけ規則から外れて中間グレーです）。

パレットを変える

4. 描く

5. 表示を切り替える（ダブルバッファ）

画面には「今表示しているページ」と「今描いているページ」の2枚があります。 もし画面を1枚しか持たず、そこへ直接絵を描いていくと、 描いている途中の絵がそのまま見えてしまい、ちらつきの原因に なります。p98lib では、見えない裏側のページに絵を描き終えてから 表と裏を入れ替えることで、これを防ぎます。

毎フレームの定型は次のとおりです：描く → p98_wait_vsync() → p98_flip()。

#include "p98.h"

#define SC_ESC 0x00

int main(void) {
    int x = 0;
    int running = 1;

    p98_init();

    while (running) {
        p98_poll();
        if (p98_key_down(SC_ESC)) running = 0;

        p98_clear(0);
        p98_fill_rect(x, 180, 40, 40, 10);
        x = (x + 4) % 600;

        p98_wait_vsync();
        p98_flip();
    }

    p98_quit();
    return 0;
}

（p98_poll() と p98_key_down() は次の章で説明する キー入力の関数です。）

6. キー入力

p98_key_down（押されている間ずっと真）と p98_key_pressed（押した瞬間だけ真）は用途が違います。 例えば「押しっぱなしで歩き続ける」移動には p98_key_down を、 「押すたびに1回だけ色を変える」ような切り替えには p98_key_pressed を使います（samples/walk.c が この使い分けの実例です）。

scancode（実測済みの対応表）

上の6つは samples/walk.c で実際に使われ、動作確認済みの値です。 掲載した6つ以外のキーを使いたい場合は、PC-98のスキャンコード表 （WebNP2-wiki の Keyboard.md 等）を参照してください。

7. スプライト（絵を描く）

矩形の塗りつぶしだけでなく、あらかじめ用意したビットマップ（スプライト）を 画面へ描くこともできます。p98lib のスプライトは 4プレーン （青・赤・緑・輝度）+マスクという形式のデータを使います。

p98_sprite_t の中身

ビット順は MSBが左端のドット（p98_fill_rect と 同じ並び）で、1行は ceil(w/8) バイト、パディング無しで詰めて 並びます（1プレーン分の総バイト数は ceil(w/8)*h）。

8. 背景ページ＋差分復帰（動くものを速くする方法）

「5. 表示を切り替える」で触れたとおり、p98_flip() 方式では、 動くキャラクタを描くたびに背景を自分で描き直す必要があります。背景が 軽ければ問題になりませんが、背景が重い（タイルを敷き詰めるなど）場合、 毎フレーム全部描き直すのは無駄です。背景ページ＋差分復帰は、 背景を1回だけ裏の「背景ページ」に描いておき、動く部分だけ そこから復元してから新しい位置に描くことで、この無駄を減らす方法です。

典型的な使い方は「1. 背景ページへ一度だけ背景を描く → 2. 画面ページへ p98_copy_bgpage_to_screen() でコピー → 3. 以後は毎フレーム p98_draw_sprite_diff() でキャラクタだけを描く」という流れです （samples/walk2.c がこの流れの実例です）。

同時に動かせるのは1体分（直前の1矩形）だけである点に注意してください。

9. VRAM常駐スプライト（さらに速くする方法）

スプライトをあらかじめVRAMの余りへ「常駐」させておき、EGC（グラフィック用の 専用回路）に本来の転送機能を使わせることで、CPUでの1バイトずつの読み書きより 速く描く経路です。

10. つまずきやすいところ（まとめ）

• ファイルのどこかに #include "p98.h" を書かないと （慣例として先頭に書くが、1行目である必要はない）、p98lib としてビルドされず （huge model・ライブラリのリンクに切り替わらず）、リンクエラーになる。
• p98_poll() を毎フレーム呼ばないと、キー入力は一切取れない。
• p98_flip()（ダブルバッファ）と p98_init_bgpage() （背景ページ＋差分復帰）は併用できない。どちらか一方だけを使う。
• p98_quit() を呼ばずにプログラムを終わらせない。
• VRAM常駐の置き場は768バイト/プレーンしかない。 p98_vram_upload()/p98_vram_reupload()の戻り値を 見て、失敗したらCPU経路へフォールバックする。

11. サンプルとの対応

IDE のサンプル一覧にある p98lib/hello.c / walk.c / walk2.c は、この順に難易度が 上がっていきます。まず hello.c を読み、次に walk.c、最後に walk2.c という順番がおすすめです。

12. 関数の総覧

include/p98.h にある公開API（関数・型・定数）の一覧です。 辞書的に引きたいときに使ってください。

画面の初期化・終了

表示・描画

キーボード

スプライト（CPU合成/EGC）

背景ページ＋差分復帰

VRAM常駐スプライト（EGC転送）