Annotation of nono/vm/keyboard.h, revision 1.1.1.9

1.1       root        1: //
                      2: // nono
1.1.1.4   root        3: // Copyright (C) 2020 nono project
                      4: // Licensed under nono-license.txt
1.1       root        5: //
                      6: 
                      7: #pragma once
                      8: 
                      9: #include "device.h"
1.1.1.6   root       10: #include "event.h"
                     11: #include "fixedqueue.h"
                     12: #include <mutex>
1.1       root       13: 
                     14: class Keyboard : public Device
                     15: {
1.1.1.4   root       16:        using inherited = Device;
1.1       root       17:  protected:
                     18:        Keyboard();
                     19:  public:
1.1.1.5   root       20:        virtual ~Keyboard() override;
1.1       root       21: 
1.1.1.6   root       22:        virtual void ResetHard() override;
                     23: 
                     24:        // キーを押した (外部から呼ばれる)
                     25:        void MakeKey(uint keycode);
                     26:        // キーを離した (外部から呼ばれる)
                     27:        void BreakKey(uint keycode);
1.1.1.9 ! root       28:        // 文字入力によるキーエミュレーション (外部から呼ばれる)
        !            29:        void CharInput(uint charcode);
1.1       root       30: 
1.1.1.2   root       31:        // マウス入力
                     32:        // x, y は X, Y の前回からの移動量。
                     33:        // X は画面右に動く方向をプラス、Y は画面下に動く方向をプラスとする。
                     34:        // 移動量が VM で扱える範囲内か、それを越えていたらどうするかは
                     35:        // 継承クラスが処理する。
                     36:        // rb, lb, mb はボタンの状態。true なら押下中。
                     37:        virtual void MouseInput(int x, int y, bool rb, bool lb, bool mb) = 0;
                     38: 
1.1.1.8   root       39:        // マウスデータを VM に送信する MD 処理
                     40:        virtual void MouseSendStart() = 0;
                     41: 
1.1.1.4   root       42:        // ホストからの制御コマンド
                     43:        virtual void Command(uint32 data) = 0;
                     44: 
1.1.1.6   root       45:        // 指定のキーの押し下げ状態取得 (ソフトウェアキーボードなどから)
                     46:        bool IsPressed(uint keycode) const {
                     47:                assert(keycode < pressed.size());
                     48:                return pressed[keycode];
                     49:        }
                     50: 
                     51:        // 全てのキーの押し下げ状態取得 (ソフトウェアキーボードなどから)
                     52:        const std::vector<bool>& GetPressed() const { return pressed; }
                     53: 
1.1.1.4   root       54:        // LED 状態取得 (ソフトウェアキーボードなどから)
                     55:        const std::vector<bool>& GetLED() const { return led; }
                     56: 
1.1.1.6   root       57:        // シフト状態なら true を返す
                     58:        // シフトキーは機種によって処理が異なるため、この関数を使って
                     59:        // 状態を取得すること。
                     60:        virtual bool IsShift() const = 0;
                     61: 
1.1       root       62:        // キー名を返す (主にデバッグ表示用)
1.1.1.7   root       63:        static const std::string GetKeyName(uint code);
1.1       root       64: 
1.1.1.4   root       65:  protected:
1.1.1.6   root       66:        // キーコードには、
                     67:        // o 共通キーコード(コードのみ)、
                     68:        // o 共通キーコード(コードと Make/Break フラグあり)、
                     69:        // o 機種依存キーコード
                     70:        // の3つがあり、どれも uint なので変数名で区別することにする。
                     71:        // o keycode .. 共通キーコード
                     72:        // o keystat .. フラグ付き共通キーコード
                     73:        // o mdkey   .. 機種依存キーコード
                     74: 
                     75:        // 共通キーコードを機種別のキーコードに変換する
                     76:        virtual uint KeyToMDKey(uint keycode) const = 0;
                     77: 
1.1.1.7   root       78:        // キーを1つ処理する
                     79:        virtual void KeyInput(uint keystat) = 0;
                     80: 
                     81:        // キーを処理する (共通部分)
                     82:        bool KeyInputCommon(uint keystat);
1.1.1.6   root       83: 
                     84:        // キーを VM に送信する MD 処理
                     85:        virtual void SendStart() = 0;
                     86: 
                     87:        // どのキーが押されているか (共通キーコード)
                     88:        std::vector<bool> pressed {};
                     89: 
                     90:        // 現在押されているキーの総数
                     91:        int num_of_pressed {};
                     92: 
                     93:        // ホストから来たキー入力をバッファする。
                     94:        // 実際には固定長でない普通のキューで構わないんだけど、モニタ用に中身を
                     95:        // 覗き見したいとか思うと、ほぼそのための FixedQueue を使うほうがいい。
                     96:        // 固定長である必要はないけど、無限に可変長である必要もないので。
                     97: 
                     98:        // UI からの入力を VM スレッドへ引き渡すためのバッファ。
                     99:        FixedQueue<uint, 8> inputqueue {};
                    100: 
                    101:        // 入力されたキーを VM へ送信するときのバッファ。
                    102:        FixedQueue<uint, 8> sendqueue {};
                    103: 
1.1.1.4   root      104:        // LED (true で点灯)。
                    105:        // GetLED() あたりが同じ形式で済むのでここにあるけど、機種によって
                    106:        // LED 数が違うので、何番がどのキーに対応するかの取り決めや、初期化も
                    107:        // 含めたコードはすべて派生クラス側で用意すること。
                    108:        std::vector<bool> led {};
                    109: 
1.1.1.8   root      110:        // マウス状態
                    111:        int mouse_x {};                 // 前回送信から現在までの積算値
                    112:        int mouse_y {};
                    113:        bool mouse_r {};                // 現在値
                    114:        bool mouse_l {};
                    115:        bool mouse_m {};
                    116:        bool prev_r {};                 // 前回送信時の値
                    117:        bool prev_l {};
                    118:        bool prev_m {};
                    119: 
1.1       root      120:  private:
1.1.1.6   root      121:        // キー入力を VM スレッドで処理するためのイベント
                    122:        void KeyInputCallback(Event& ev);
1.1.1.7   root      123:        Event keyinput_event { this };
1.1.1.6   root      124:        std::mutex mtx {};
                    125: 
1.1       root      126:        static std::vector<const char *> keyname;
1.1.1.9 ! root      127:        static std::vector<uint> char_key;
1.1       root      128: };
                    129: 
1.1.1.3   root      130: extern std::unique_ptr<Keyboard> gKeyboard;
1.1       root      131: 
                    132: // 抽象化キーボードレイヤーでのキーコード。
                    133: // wxWidgets で受け取ったキーコードをこれに変換して VM に入力する。
                    134: // VM のキーボードデバイスがこれを当該機種ごとのキーコードなり何なりに
                    135: // 変換して入力する。
                    136: 
1.1.1.6   root      137: // keystat のフラグ
                    138: #define KC_FLAG_MAKE   (0x0000)        // 押した
                    139: #define KC_FLAG_BREAK  (0x8000)        // 離した
                    140: #define KC_IS_MAKE(x)  (((x) & KC_FLAG_BREAK) == 0)
                    141: #define KC_IS_BREAK(x) (((x) & KC_FLAG_BREAK) != 0)
                    142: 
1.1.1.9 ! root      143: // char 入力モードでの押下ならキーコードを UI に通知する必要があるため、
        !           144: // inputqueue 内でこの情報を保持するためのフラグ。
        !           145: #define KC_FLAG_POST   (0x4000)
        !           146: #define KC_IS_POST(x)  (((x) & KC_FLAG_POST) != 0)
        !           147: 
        !           148: // 文字入力エミュレーション時に同時押しするキーのためのモディファイヤフラグ。
        !           149: #define KM_SHIFT       (0x0100)
        !           150: #define KM_CTRL                (0x0200)
1.1.1.6   root      151: 
                    152: // keystat からキーコードだけ取り出す
1.1.1.9 ! root      153: #define KC_CODE(x)             ((x) & 0x00ff)
1.1.1.6   root      154: 
1.1       root      155: #define KC_none                        (0)
                    156: 
                    157: #define KC_BREAK               (0x01)  // [X68k] BREAK
                    158: #define KC_COPY                        (0x02)  // [X68k] COPY
                    159: #define KC_romaji              (0x03)  // [X68k] ローマ字
                    160: #define KC_code                        (0x04)  // [X68k] コード入力
                    161: #define KC_kigou               (0x05)  // [X68k] 記号入力
                    162: #define KC_touroku             (0x06)  // [X68k] 登録
                    163: #define KC_HELP                        (0x07)  // [X68k] HELP
                    164: #define KC_HOME                        (0x08)  // [X68k] HOME
                    165: #define KC_TAB                 (0x09)
                    166: #define KC_CTRL                        (0x0a)
                    167: #define KC_kana                        (0x0b)  // かな
                    168: #define KC_SHIFT_L             (0x0c)  // SHIFT(左)
                    169: #define KC_SHIFT_R             (0x0d)  // SHIFT(右)
                    170: #define KC_CAPS                        (0x0e)
                    171: #define KC_SF                  (0x0f)  // [LUNA] S.F
                    172: 
                    173: #define KC_ESC                 (0x10)
                    174: #define KC_BS                  (0x11)  // BackSpace
                    175: #define KC_enter               (0x12)  // Enter (Return)
                    176: #define KC_INS                 (0x13)  // [X68k] INS
                    177: #define KC_space               (0x14)
                    178: #define KC_DEL                 (0x15)
                    179: #define KC_XFER                        (0x16)  // [LUNA] XFER
                    180: #define KC_VALID               (0x17)  // [LUNA] VALID
                    181: #define KC_PF11                        (0x18)  // [LUNA] PF11
                    182: #define KC_PF12                        (0x19)  // [LUNA] PF12
                    183: #define KC_PF13                        (0x1a)  // [LUNA] PF13
                    184: #define KC_PF14                        (0x1b)  // [LUNA] PF14
                    185: #define KC_up                  (0x1c)  // cursor up
                    186: #define KC_left                        (0x1d)  // cursor left
                    187: #define KC_right               (0x1e)  // cursor right
                    188: #define KC_down                        (0x1f)  // cursor down
                    189: 
                    190: #define KC_ROLLUP              (0x20)  // [X68k] ROLL UP
                    191: #define KC_ROLLDOWN            (0x21)  // [X68k] ROLL DOWN
                    192: #define KC_1                   (0x22)
                    193: #define KC_2                   (0x23)
                    194: #define KC_3                   (0x24)
                    195: #define KC_4                   (0x25)
                    196: #define KC_5                   (0x26)
                    197: #define KC_6                   (0x27)
                    198: #define KC_7                   (0x28)
                    199: #define KC_8                   (0x29)
                    200: #define KC_9                   (0x2a)
                    201: #define KC_0                   (0x2b)
                    202: #define KC_minus               (0x2c)
                    203: #define KC_circum              (0x2d)  // ^~
                    204: #define KC_backslash   (0x2e)  // \|
                    205: #define KC_UNDO                        (0x2f)  // [X68k] UNDO
                    206: 
                    207: #define KC_OPT1                        (0x30)  // [X68k] OPT.1
                    208: #define KC_OPT2                        (0x31)  // [X68k] OPT.2
                    209: #define KC_Q                   (0x32)
                    210: #define KC_W                   (0x33)
                    211: #define KC_E                   (0x34)
                    212: #define KC_R                   (0x35)
                    213: #define KC_T                   (0x36)
                    214: #define KC_Y                   (0x37)
                    215: #define KC_U                   (0x38)
                    216: #define KC_I                   (0x39)
                    217: #define KC_O                   (0x3a)
                    218: #define KC_P                   (0x3b)
                    219: #define KC_at                  (0x3c)
                    220: #define KC_bracketleft (0x3d)  // '['
                    221: #define KC_hira                        (0x3e)  // [X68k] ひらがな
                    222: #define KC_zenkaku             (0x3f)  // [X68k] 全角
                    223: 
                    224: #define KC_A                   (0x42)
                    225: #define KC_S                   (0x43)
                    226: #define KC_D                   (0x44)
                    227: #define KC_F                   (0x45)
                    228: #define KC_G                   (0x46)
                    229: #define KC_H                   (0x47)
                    230: #define KC_J                   (0x48)
                    231: #define KC_K                   (0x49)
                    232: #define KC_L                   (0x4a)
                    233: #define KC_semicolon   (0x4b)
                    234: #define KC_colon               (0x4c)
                    235: #define KC_bracketright        (0x4d)  // ']'
                    236: 
                    237: #define KC_Z                   (0x52)
                    238: #define KC_X                   (0x53)
                    239: #define KC_C                   (0x54)
                    240: #define KC_V                   (0x55)
                    241: #define KC_B                   (0x56)
                    242: #define KC_N                   (0x57)
                    243: #define KC_M                   (0x58)
                    244: #define KC_comma               (0x59)
                    245: #define KC_period              (0x5a)
                    246: #define KC_slash               (0x5b)
                    247: #define KC_underscore  (0x5c)
                    248: 
                    249: #define KC_PAD_plus            (0x61)
                    250: #define KC_PAD_minus   (0x62)
                    251: #define KC_PAD_7               (0x63)
                    252: #define KC_PAD_8               (0x64)
                    253: #define KC_PAD_9               (0x65)
                    254: #define KC_PAD_4               (0x66)
                    255: #define KC_PAD_5               (0x67)
                    256: #define KC_PAD_6               (0x68)
                    257: #define KC_PAD_1               (0x69)
                    258: #define KC_PAD_2               (0x6a)
                    259: #define KC_PAD_3               (0x6b)
                    260: #define KC_PAD_0               (0x6c)
                    261: #define KC_PAD_decimal (0x6d)  // .
                    262: #define KC_PAD_enter   (0x6e)
                    263: #define KC_PAD_CLR             (0x6f)  // [X68k] CLR
                    264: 
                    265: #define KC_F1                  (0x72)
                    266: #define KC_F2                  (0x73)
                    267: #define KC_F3                  (0x74)
                    268: #define KC_F4                  (0x75)
                    269: #define KC_F5                  (0x76)
                    270: #define KC_F6                  (0x77)
                    271: #define KC_F7                  (0x78)
                    272: #define KC_F8                  (0x79)
                    273: #define KC_F9                  (0x7a)
                    274: #define KC_F10                 (0x7b)
                    275: #define KC_PAD_multiply        (0x7c)
                    276: #define KC_PAD_divide  (0x7d)
                    277: #define KC_PAD_equal   (0x7e)
                    278: #define KC_PAD_comma   (0x7f)
                    279: 
                    280: #define KC_XF1                 (0x80)  // [X68k] XF1
                    281: #define KC_XF2                 (0x81)  // [X68k] XF2
                    282: #define KC_XF3                 (0x82)  // [X68k] XF3
                    283: #define KC_XF4                 (0x83)  // [X68k] XF4
                    284: #define KC_XF5                 (0x84)  // [X68k] XF5
1.1.1.6   root      285: #define KC_SHIFT               (0x85)  // [X68k] SHIFT (左右の区別なし)
1.1       root      286: 
1.1.1.6   root      287: #define KC_max                 (0x86)
1.1.1.9 ! root      288: 
        !           289: // 文字入力モードの拡張部分
        !           290: #define CC_NUL                 (0x80)  // NUL (Ctrl + @)
        !           291: #define CC_F1                  (0x81)
        !           292: #define CC_F2                  (0x82)
        !           293: #define CC_F3                  (0x83)
        !           294: #define CC_F4                  (0x84)
        !           295: #define CC_F5                  (0x85)
        !           296: #define CC_F6                  (0x86)
        !           297: #define CC_F7                  (0x87)
        !           298: #define CC_F8                  (0x88)
        !           299: #define CC_F9                  (0x89)
        !           300: #define CC_F10                 (0x8a)
        !           301: 
        !           302: #define CC_up                  (0x8c)
        !           303: #define CC_left                        (0x8d)
        !           304: #define CC_right               (0x8e)
        !           305: #define CC_down                        (0x8f)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.