doc/romaji_kana.en.txt

   1 * About ROMAJI-KANA conversion assitant feature.
   2                                        Oct 27, 2016
   3                   K.Ohta <whatisthis.sowhat _at_ gmail.com>
   4
   5 1.What is this?
   6 Using ROMAJI-KANA conversion at a few machines,
   7 regardless of lacking native ROMAJI-KANA conversion.
   8 This aims to be useful for older Japanese adventure-games.
   9
  10 2.How to use
  11  a. Check menu entry, "ROMA-KANA Conversion" at "Emulator" section.
  12  b. Press [PF12] to toggle enabling ROMAJI-KANA conversion.
  13     If enable , display "[R]" at head of status message.
  14     ** This feature has not all of VMs, now only a few VMs have. **
  15
  16 3.Supported VMs
  17 ・Basic Master Jr
  18 ・FM-8/7/77/AV/40/EX
  19 ・FP-1100
  20 ・FP-200
  21 ・MSX 1/2
  22 ・MZ-80B/2200/2500
  23 ・MULTI 8
  24 ・MYCOM Z80A
  25 ・MZ-80B/2200/2500
  26 ・PASOPIA/7
  27 ・PC-2001(Not checked)
  28 ・PC-6001/6601(But, code of Kana-key is differ, not works well)
  29 ・PC-8201
  30 ・PC-8801
  31 ・TK-80BS
  32 ・X1/Turbo/Z
  33
  34 4.Conversion code list
  35 母音
  36 A : あ
  37 I : い
  38 U : う
  39 E : え
  40 O : お
  41 xa : ぁ
  42 xi : ぃ
  43 xu : ぅ
  44 xe : ぇ
  45 xo : ぉ
  46
  47 母音
  48 k  : か行
  49 s  : さ行
  50 t  : た行
  51 n  : な行
  52 h  : は行
  53 m  : ま行
  54 y  : や行
  55 r  : ら行
  56 w  : わ行
  57 z  : ザ行
  58 j  : ザ行
  59 d  : ダ行
  60 b  : バ行
  61 p  : パ行
  62
  63 その他
  64 *y* : *ャ/ィ/ュ/ェ/ョ (例: pya -> ピャ)
  65 nn  : ン
  66 -   : ー(音引き)
  67 [   : 「
  68 ]   :  」
  69 ,   : 、
  70 .   : 。
  71 /   : ・(なかぐろ)
  72
  73 5.Implementation
  74 At CSP, when inputting from host's keyboard, RAW key code has
  75 converted to virtual keyboard code(VK_foo) of windows
  76 temporally and queueing.
  77 Now, snooping VK code before queueing, send to
  78 alphabet_to_kana() at src/romakana.cpp to convert ROMAJI to KATAKANA,
  79 result is put to array of wchar_t (UTF-8).
  80
  81 And, queueing this result (converted to QString, Qt native string type)
  82 to ROMAJI-KANA conversion queue.
  83 At emulation loop (i.e. calling emu->run()), when AUTO-KEY(Copy and Paste)
  84 FIFO has empty, dequeueing from ROMAJI-KANA conversion queue and enqueue
  85 these characters to AUTO-KEY fifo, then, process AUTO-KEY function.
  86
  87 Note:
  88 "romakana.cpp" use wchar_t and use UTF-8 to process internally,
  89 C++ compiler is required later than C++99?.
  90 And, you need convert coding result of ROMAJI-KANA conversion to
  91 internal coding EMU::auto_key_foo() (mostly Shift-JIS).
  92
  93 Sorry for irrational...(´・ω・｀)
  94
  95 Ohta.