X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=README.en.md;h=367ff6f8b7275f550ae28ee6aa4a91fe931d91d1;hb=e03a2d0b831c83a5d0c2ba9935be94f5bd6566e8;hp=38f32b8a84fa305753ee49aa8c6363d554323c8f;hpb=792d7fa9a2f713409e78d7118e6a01138826c733;p=csp-qt%2Fcommon_source_project-fm7.git diff --git a/README.en.md b/README.en.md index 38f32b8a8..367ff6f8b 100644 --- a/README.en.md +++ b/README.en.md @@ -1,77 +1,172 @@ -** Qt porting for Common Source Code Project ** - Sep 09, 2016 - K.Ohta +

** Qt porting for Common Source Code Project **

+
+

Feb 10, 2018
+K.Ohta

+
+## *If you can read Japanese, [japanese(日本語) writing is here](/README.md/).* + +About +==== -0. About This package is Qt5 porting of Common Source Code Project (CSP). + Building with GNU/Linux(64bit) and MinGW(32bit Windows). + +## Source code + + + +## Additional infomations -1. Background - Common Source Code Project (CSP) is good emulator writing. - But codes are specified to M$ Visual C. - I'm using GNU/Linux, and I starting to apply FM-7(or later). - So, I start to port to GNU/Linux and using Qt4. +You can get pre-compiled binaries from [osdn.net](http://osdn.net) and their mirrors. + + - * Note: You can build with MinGW32 and Qt 5.5.1(for MinGW). + + + +LICENSE +====== + +[GPL Version 2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html). + +Background +========== + +Common Source Code Project (CSP) is good emulator writing. + +But codes are specified to M$ Visual C. + +I'm using GNU/Linux, and I starting to apply FM-7(or later). + +So, I start to port to GNU/Linux and using Qt4. + +## Note: + +You can build with MinGW32 and Qt 5.5.1(for MinGW). - * TIPS: If emufoo.exe don't show screen drawing, set environment - variable QT_OPENGL to software (i.e. Using Windows as VirtualBox's gueat OS). +TIPS: + +* If emufoo.exe don't show screen drawing, set environment variable QT_OPENGL to software (i.e. Using Windows as VirtualBox's gueat OS). -2. What you need at least: - a. Qt5 (neither Qt3 and Qt4) toolkit. - b. Some OpenGL implementation, maybe at leaset OpenGL v3.0 . - c. gcc / g++ (4.7 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain. - d. SDL2 (not SDL1.x). - e. CMake 2.8 or later. - -3. How to build: - After extracting (or git pulled) sourcecodes: - $ cd {srctop}/source/build-cmake/{Machine name}/ - $ mkdir build - $ cd build +What you need at least: +===== + +* Qt5 (neither Qt3 and Qt4) toolkit. + +* Some OpenGL implementation, maybe at leaset OpenGL v3.0 . + +* gcc / g++ (5.4 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain. + +* SDL2 (not SDL1.x). + +* CMake 2.8 or later. + +How to build: +===== + +After extracting (or git pulled) sourcecodes: + + $ cd {srctop}/source/build-cmake/{Machine name}/ + $ mkdir build + $ cd build - To configure: - $ cmake .. - or - $ ccmake .. - - To build: - $ make - - To install: - $ sudo make install - -4.Qt specified notice (for non-Windows): - ・Place R@Ms under $HOME/emu{Machine Name}/ , this directory has made - after first using. - ・Config file, {foo}.ini is written on $HOME/.config/emu{Machine Name}/ . - ・Saved state file, {foo}.sta is written on $HOME/emu{Machine Name}/ . - ・Key code conversion file is written on $HOME/.config/emu{Machine Name}/scancode.cfg . - This file contains comma separated fields, written at hex-decimal (not decimal), - first is M$ Virtual Key Code, - second is Qt's scan code. +*To configure:* -5.Status -a. I tested to build only under Debian GNU/Linux "sid". - But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants. - * On windows, using MinGW is already okay. - * Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available. - Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files. - * And, you can also build with M$ Visual Studio 2013 or 2015. + $ cmake .. + + or - b. Now, I using Qt5 as toolkit, because authors of Qt announced - "Qt4 is obsolete, will be updated no longer". + $ ccmake .. + +*To build:* + + $ make + +*To install:* + + $ sudo make install + +Qt specified notice : +==== - c. All of virtual machines of upstream (@Dec 17, 2015) are already ported to Qt. - d. Now using GCC-5.2 with Link Time Optimize to build for distrubuted binaries. +* Config file (scancode.cfg and foo.ini) has placed (moved) to "~/.config/CommonSourceCodeProject/emufoo/" (for Windows, ".\CommonSourceCodeProject\emudfoo\" ). -6. Upstream repositry: - https://github.com/Artanejp/common_source_project-fm7 - https://www.pikacode.com/Artanejp/common_source_project-fm7/ +* BIOS, WAVS, BINS and SAVED STATES have placed (moved) to "~/CommonSourceCodeProject/emufoo/" (for Windows, ".\CommonSourceCodeProject\emudfoo\" ). + +* All of recorded products (PNG Screenshots, MOVIES, SOUNDS) have *temporally* written to "~/.config/CommonSourceCodeProject/emufoo/" (for Windows, ".\CommonSourceCodeProject\emudfoo\" ). + +* Added ToolTips.(2017-01-24) + +* Translated menu entries to Japanese.(2017-01-24) + +* Place R@Ms under $HOME/CommonSourceCodeProject/emu{Machine Name}/ , this directory has made after first using. + +* Key code conversion file is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/scancode.cfg . + + ** This file contains comma separated fields, written at hex-decimal (not decimal), + + ** First is M$ Virtual Key Code, + + ** Second is Qt's scan code. + +* Common components (i.e. source/src/qt/gui ) are packed to DLLs/shared libs. + +* Bash script for installation is available: source/src/tool/installer_unix.sh . + +* When you place some WAV files to directry same as R@M, you can some sounds; i.e. FDD's seek.See doc/VMs/*.txt . + +* ROMAJI-KANA conversion assitance feature has implemented to some VMs. + +Status +==== + +* I tested to build only under Debian GNU/Linux "sid".But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants. + + ** On windows, using MinGW is already okay. + + ** Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available. + + ** Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files. + + ** And, you can also build with M$ Visual Studio 2013 or 2015. + +* Now, I using Qt5 as toolkit, because authors of Qt announced "Qt4 is obsolete, will be updated no longer". + +* All of virtual machines of upstream (@Dec 17, 2015) are already ported to Qt. + +* Now using GCC-7.x with Link Time Optimize to build for distrubuted binaries. + +* Implemented MZ-2500's socket, but, still not test enough(；´Д｀) + +Repositry: +=== + + -7. Upstream (Takeda Toshiya San's original code) - http://takeda-toshiya.my.coocan.jp/ + + +Project Page: +== + + + +Upstream (Takeda Toshiya San's original code) +==== + + + +Special thanks to: +== + + Ryu Takegami : Assist to debug and give informations about eFM-8/7/77/AV/40/EX . Have fun! --- Ohta. + +--- Ohta. + +© 2018 Toshiya Takeda + +© 2018 K.Ohta +