readme_by_artane.txt

   1 ** Qt porting for Common Source Code Project **
   2                                            Aug 02, 2015
   3               K.Ohta <whatisthis.sowhat _at_ gmail.com>
   4
   5 * If you can't read Japanese, read readme.qt.txt .
   6
   7 0. 概要
   8    このパッケージは、Common Source Code Project (以下、CSP)
   9    をQt5に移植したものと、Windows (Win32)向けに、Visual Studio 2015
  10    + Direct X9 + Direct Input 8でビルドしたもののセットです。
  11
  12 1. 背景
  13    CSPは、非常に優れた構造のエミュレータです（しかし、些か重くてコンパイラ
  14    がいい最適化をしないと重めですが）。
  15    しかし、このコードはM$ Visual C++依存の部分が非常に多いです。
  16    そこで、GNU/Linuxでこれを動かすためにQtに色々と移植していきましょう。
  17    と言う感じで作業をはじめました。
  18
  19 2. 最低限必要なもの(Qt版)
  20    a. Qt5 ツールキット
  21    b. OpenGL, 多分、最低OpenGL 2.0は必要です。
  22    c. gcc / g++ (4.7以降？)もしくは llvm clang / clang++ (3.5以降?)
  23       コンパイラツールチェーン。
  24    d. SDL2 (SDL 1.xではないので注意)
  25    e. CMake 2.8以降。
  26
  27 3. ビルドの方法
  28    ソースコードを解凍するか、git clone / pull した後で:
  29    $ cd {srctop}/source/build-cmake/{Machine name}/
  30    $ mkdir build
  31    $ cd build
  32
  33    To configure:
  34    $ cmake ..
  35    or
  36    $ ccmake ..
  37
  38    To build:
  39    $ make
  40
  41    To install:
  42    $ sudo make install
  43
  44 4. Qt固有の話
  45    ・R@Mを $HOME/emu{Machine Name/ に配置してください。
  46    　なお、このディレクトリは最初起動した後で作成されます。
  47    ・設定ファイルは、$HOME/.config/emu{Machine Name}/ に書き込まれます。
  48
  49 5. 移植状況
  50    a. 現在、Debian GNU/Linux "sid" の AMD64版でしかテストしていません。
  51    　 が、多分他のGNU/Linux OSやBSD系のOS (Mac含む) でもビルドすれば
  52    　 動くでしょう。WindowsとMinGWの組み合わせに関しては、CMakeがまだ
  53     　正しい設定をできてない状況です。
  54       Windowsの方は、Visual Studio 2013 か 2015 のCommunity Edition
  55       でビルドしてください。
  56    b. 今は、Qtの開発側が「Qt4おわりね」とアナウンスしたので、Qt4ではなく
  57       Qt5を使っています。
  58       添付してあるバイナリは、Qt 5.5でビルドしました。
  59
  60    c.以下のマシンがQtに移植出来ています。(2015年7月23日現在)
  61      ・Ascii MSX1/MSX2 (not PX-7).
  62      ・Casio FP-1100 .
  63      ・Casio FP-200 .
  64      ・Epson HC-20/40/80.
  65      ・Fujitsu FM-7/77/AV . (→ READ readme_fm7.jp.txt)
  66      ・Fujitsu FM16pi .
  67      ・Fujitsu FM-R50(i286/i386/i486)/R60/R70/R80/R250/R280 (Not tested enough).
  68      ・Gijyutu hyouronsya babbage2nd.
  69      ・NEC PC-6001/mk2/mk2SR .
  70      ・NEC PC-6601/SR .
  71      ・NEC PC8001mk2SR (Not tested enough).
  72      ・NEC PC8801MA .
  73      ・NEC PC-9801/E/U/VF/VM .
  74      ・NEC PC98DO .
  75      ・NEC PC98LT/HA .
  76      ・NEC HE PC-ENGINE.
  77      ・NEC TK-80BS .
  78      ・NEC HE PC Engine.
  79      ・Tomy PYUTA.
  80      ・Sega Game Gear/Master System (Mark3).
  81      ・Sharp X1/turbo/turboZ/Twin.
  82      ・Sharp MZ-700/800/1500 .
  83      ・Sharp MZ-80A/K/1200 .
  84      ・Sharp MZ-80B/2200/2500 .
  85      ・Shinko Sangyou YS-6464a .
  86      ・Toshiba J-3100SL .
  87      ・Z80 TV Game (Hand made)
  88
  89    d. Linux用ビルドでは、GCC 5.1をリンク時最適化(LTO)モードで使っています。
  90
  91 6. Upstream repositry:
  92       https://github.com/Artanejp/common_source_project-fm7
  93
  94 7. Upstream (Takeda Toshiyaさんのオリジナル)
  95       http://homepage3.nifty.com/takeda-toshiya/
  96
  97 お楽しみあれ!
  98 -- Ohta.