FreeBASIC DevRtlInkey

fb_ConsoleInkey() および fb_ConsoleGetkey() は、これらが呼ばれるときはいつも、入力文字を検索するために、DJGPP の getch() 関数を使います。
getch() は、ASCII 文字だけでなく、特殊キーのための 2バイト・シーケンスも返します。これらは、SC_* スキャン・コードと一致するので、簡単に扱うことができます。

fb_ConsoleMultikey() は、キーボード情報を読み取るために、ポートI/O を使う、割り込みハンドラーをインストールします。そして、multikey() によってチェックされる、キーの状態テーブルを更新します。

fb_ConsoleInkey() と fb_ConsoleGetkey() は、待ち行列に入れられたキーを押す/放すのイベントを取得するために、必要なときはいつでも、Win32 API 関数 PeekConsoleInput() と ReadConsoleInput() を（間接的に）使います。
すべての現在の未定イベントは、呼び出しの間、取り扱われます。そして、MapVirtualKey() を含んでいる非常に複雑な内部の翻訳の後、fb_ConsoleInkey() と fb_ConsoleGetkey() が、それらが返すキーを読んだところから、キーは、バッファに入れられます。

SetConsoleCtrlHandler() は、コンソール-モードに SC_CLOSE イベントを提供するために、コンソール・クローズ/システム・シャットダウン イベントに、聞き耳をたてるのに、用いられます。（rtlib の win32 ポートは、唯一、こんなに遠くに行っているのかもしれません）

fb_ConsoleMultikey() は、古いバージョンの Windows（Windows 7以前）では、FindWindow()/GetForegroundWindow() ハックを使って、コンソールウィンドウがフォーカスされているかどうかを判断し、Yes(フォーカスされている)の場合は、単に GetAsyncKeyState() を使用します。
新しいバージョンの Windows では、GetAsyncKeyState() 関数を現在フォーカスされているウィンドウに制限する必要があります。新しいバージョンの Windows では、ウィンドウズ・ターミナルを使用している場合、FindWindow() ハックは問題を引き起こすため、無効にする必要があります。

The Unix port of the rtlib runs a console keyboard handler (and a console mouse handler) in a background thread, in order to provide input for multikey() (and getmouse()).

fb_ConsoleInkey() and fb_ConsoleGetkey() read input bytes through the __fb_con.keyboard_getch() hook. By default, __fb_con.keyboard_getch() points to a simple function that just uses fgetc() on /dev/tty (indirectly; the Unix rtlib initialization code opens the handle, and changes I/O settings etc., not only for the purpose of keyboard input, but mostly).

The terminal returns ASCII chars for simple key presses, and special escape sequences for extended keys. On the first call, various termcap lookups (via tgetstr()) are done to determine these terminal-specific escape sequences for certain key press events, and they are put into a lookup tree to allow easy & fast translation to the corresponding FB extended keycodes. By doing the termcap query the Unix rtlib can support all the different terminals (e.g. xterm vs. linux) quite well, although there still are some keys not working here and there.

Only one "event" (ASCII char or escape sequence) is read at a time, the resulting key is added to a key buffer, from where fb_ConsoleInkey() and fb_ConsoleGetkey() can read it.

fb_ConsoleMultikey() is currently implemented for the Linux port only, not under *BSD though. In console-input mode (used under 'console'/'linux' terminals), it dup()licates the rtlib's /dev/tty handle, and switches it over into medium raw mode. Then it overrides the background thread's __fb_con.keyboard_handler() hook to a function that read()s kernel key codes from the duplicated /dev/tty handle.

Called from the background thread, it reads a fixed amount of input at once, whenever it arrives. After somewhat complex translation, a key state table is updated to reflect the state of pressed/released keys, to be checked by fb_ConsoleMultikey() at any time, and the keys are added to a key buffer from where an overridden __fb_con.keyboard_getch() reads them, whenever called by fb_ConsoleInkey() or fb_ConsoleGetkey() [why is this done?]. Furthermore, the keys are sent to the Linux fbdev gfxlib2 driver, if it's active.

In X11 mode (used under 'xterm' terminal), fb_ConsoleMultikey() sets the background thread's __fb_con.keyboard_handler() to a function that checks whether the xterm has input focus (XGetInputFocus()) and if yes, simply uses XQueryKeymap() to update the key state table for fb_ConsoleMultikey().

DOS gfxlib2 ポート (すべての DOS gfx ドライバーに対して) は、DOS fb_ConsoleMultikey() によって使われる、同じキーボード割り込みハンドラーによって呼ばれる hook/callback をセットします。

gfx ウィンドウ・スレッドは、WM_KEYDOWN、WM_CHAR、WM_CLOSE を聞き、キーを翻訳し、次に、キーの状態テーブルを更新します。そして、fb_GfxInkey()/fb_GfxGetkey() バッファーにそれらを記入し、screenevent() のために、対応する EVENT を、& ポストに入れます。

The gfx window thread listens to KeyPress and other XEvent's, translates the keys, then posts them etc., just like the Win32 driver.

As mentioned above, the fbdev driver gets its input from the same keyboard handler code that's used by the Linux fb_ConsoleMultikey().