1 ** Qt porting for Common Source Code Project **
3 K.Ohta <whatisthis.sowhat _at_ gmail.com>
6 This package is Qt5 porting of Common Source Code Project (CSP).
7 Building with GNU/Linux(64bit) and MinGW(32bit Windows).
10 Common Source Code Project (CSP) is good emulator writing.
11 But codes are specified to M$ Visual C.
12 I'm using GNU/Linux, and I starting to apply FM-7(or later).
13 So, I start to port to GNU/Linux and using Qt4.
15 * Note: You can build with MinGW32 and Qt 5.7(for MinGW).
17 * TIPS: If emufoo.exe don't show screen drawing, set environment
18 variable QT_OPENGL to software (i.e. Using Windows as VirtualBox's gueat OS).
20 2. What you need at least:
21 a. Qt5 (neither Qt3 and Qt4) toolkit.
22 b. Some OpenGL implementation, maybe at leaset OpenGL v2.1.
23 c. gcc / g++ (4.7 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain.
25 e. CMake 2.8 or later.
26 f. libav and libsw from ffmpeg (optional) http://ffmpeg.org/ .
29 After extracting (or git pulled) sourcecodes:
30 $ cd {srctop}/source/build-cmake/{Machine name}/
45 4.Qt specified notice (for non-Windows):
46 ・Place R@Ms under $HOME/emu{Machine Name}/ , this directory has made
48 ・Config file, {foo}.ini is written on $HOME/.config/emu{Machine Name}/ .
49 ・Saved state file, {foo}.sta is written on $HOME/emu{Machine Name}/ .
50 ・Key code conversion file is written on $HOME/.config/emu{Machine Name}/scancode.cfg .
51 This file contains comma separated fields, written at hex-decimal (not decimal),
52 first is M$ Virtual Key Code,
53 second is Qt's scan code.
54 ・Common UI components (at src/qt/gui ) are moved to shared lib. libCSPgui.so .
55 ・Installer (bash) script is available now; src/tool/installer_unix.sh .
58 a. I tested to build only under Debian GNU/Linux "sid".
59 But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants.
60 * On windows, using MinGW is already okay.
61 * Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available.
62 Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files.
63 * And, you can also build with M$ Visual Studio 2013 or 2015.
65 b. Now, I using Qt5 as toolkit, because authors of Qt announced
66 "Qt4 is obsolete, will be updated no longer".
68 c. All of virtual machines of upstream (@Apr 13, 2016) are ported to Qt.
69 d. Now using GCC-6 with Link Time Optimize to build for distrubuted binaries.
71 6. Upstream repositry:
72 https://osdn.jp/projects/csp-qt/
73 https://github.com/Artanejp/common_source_project-fm7
74 https://www.pikacode.com/Artanejp/common_source_project-fm7/
76 7. Upstream (Takeda Toshiya San's original code)
77 http://takeda-toshiya.my.coocan.jp/