** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **

                                                       May 16 , 2018
                            K.Ohta  (whatisthis.sowhat _at_ gmail.com)

1.About

This package is Qt5 porting of Common Source Code Project (CSP)
and built with Qt5, for Windows, built with MinGW(32bit).

Source Code:

   https://github.com/Artanejp/common_source_project-fm7/releases/tag/SNAPSHOT_20180516
   
Additional INFO:

   Binaries will be available, distibute from osdn.net.
   
   See, https://osdn.net/projects/csp-qt/  and
        https://osdn.net/projects/csp-qt/releases/ .
	
   Released at:


2.Background

Common Source Code Project (CSP) is good emulator writing.
It also distributed with GPLv2, this is good for me.

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/Qt5.

What you need at least:

a. Qt5 (neither Qt3 and Qt4) toolkit: Qt5.3 or later.

b. Some OpenGL implementation, maybe at leaset OpenGL v2.x .

c. gcc / g++ (5.0 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain.

d. SDL2 (not SDL1.x).

e. CMake 2.8 or later.

f. Needs ffmpeg.See https://ffmpeg.org/ .

g. FFMpeg has bundled only for Win32.Please install for other OSs if not working.

h. Built with Qt5.5 (for Ubuntu 16.04LTS) or Qt 5.10 (for Win32 and Debian/Sid).

i. Now, changed default drawing infrastructure to OpenGL ES2.You can change --opengl option via comman line (or GUI).

* 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).


3.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:
   
   銉籆onfig file (scancode.cfg and foo.ini) has placed (moved) to
     "~/.config/CommonSourceCodeProject/emufoo/"
     (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
   
   銉籅IOS, WAVS, BINS and SAVED STATES have placed (moved) to
     "~/CommonSourceCodeProject/emufoo/"
     (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
   
   銉籄ll of recorded products (PNG Screenshots, MOVIES, SOUNDS) 
     have *temporally* written to "~/.config/CommonSourceCodeProject/emufoo/"
     (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
   
   銉籄dded ToolTips and Japanese translations.(2017-01-24)
   
   銉籔lace R@Ms under $HOME/CommonSourceCodeProject/emu{Machine Name}/ , this directory has made
     after first using.
   
   銉籆onfig file, {foo}.ini is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/ .
   
   銉籗aved state file, {foo}.sta is written on $HOME/CommonSourceCodeProject/emu{Machine Name}/ .
   
   銉籏ey 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.
       
   銉籆ommon UI components (at src/qt/gui ) are moved to shared lib. libCSPgui.so .
   
   銉籌nstaller (bash) script is available now; src/tool/installer_unix.sh .
   
   銉籛hen you place specified WAV files(differ per VM) same directory as ROMs, you can sound sounds: i.e. FDD seek, CMT relay and buttons.
  
5.Status

a. I tested to build only under Debian GNU/Linux "sid",Ubuntu Linux 16.04LTS "Xenial" for AMD64 (x86_64)
and MinGW with GCC6 (Windows 32bit).

   But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants.
   
   * On windows, using MinGW is already okay, but not tested drawing.
   
   * 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.

b. Now, I using Qt5 as toolkit, because authors of Qt announced "Qt4 is obsolete, will be updated no longer".

c. All of virtual machines are already ported to Qt (On Oct 29, 2015).

d. Now using GCC-6.1 with Link Time Optimize to build for distrubuted binaries.

e. Implemented socket, networking for MZ-2500, but, not tested yet (锛浡葱旓絸)

Repositry:

   https://github.com/Artanejp/common_source_project-fm7

   https://osdn.net/projects/csp-qt/scm/git/common_source_project-fm7


Project Page:

   https://osdn.jp/projects/csp-qt/

Upstream (Takeda Toshiya San's original code):

   http://takeda-toshiya.my.coocan.jp/

Special thanks to:
   Ryu Takegami-san, to assist debugging FM-7/77/AV/40/EX .
   Haserin-san, to assist debugging FM-7/77/AV/40/EX .
   
Changes:

* To see older changes, read ChangeLog and 000_gitlog.txt.

* SNAPSHOT May 16, 2018
  * Upstream 2018-05-06 .
  * [EMU] Remove unneeded functions for only Qt version.
  * [Qt/OpenGL] Add OpenGL ES2 renderer.Still not display.
  * [Qt/Draw] Use Semaphore instead of mSecs waiting.Expect to improve real-time-drawing on multi thread.
  * [Qt/AVIO] Fix FTBFS with FFMPEG 4.0.Will be needed to apply to new API.Will fix.
  * [Qt/FM8] Fix number of bubble-casette: Start from 0, not 1.
  * [Qt/COMMAND_LINE] Add --opengl , --envvar and --dump-envvar .
  * [Qt/OSD] Fix around moving mouse pointer.
  * [Qt/UI] Not reset slot number when opening disk.
  * [Qt/UI] Fix around mouse problems.
  * [Build/CROSS] Add cross-compiling scripts and patch(es) to build Qt5.10.
  * [VM/MB8877] Keep command phase even changing (or removing) disk.Fix booting RELICS for FM-7 with single FDD drive.
  * [VM/MB8877] Reaset track (per drive) on reset.Fix booting RELICS for FM-7 with two FDDs.
  * [VM/MB8877] Check head loading READ/WRITE command.
  * [Win32] Built with Qt 5.10 and Angle-project's OpenGL ES2 renderer. 
  * Built with cf31c26aab576798a073e5d523bfc21b2091fd76 or later.

-- May 16, 2018 18:09:00 +0900 K.Ohta <whatisthis.sowhat@gmail.com>



Upstream changes:
* To see older upstream's changes, read history.txt.

5/6/2018

[COMMON] add is_absolute_path() and create_absolute_path() functions
[COMMON/FILEIO] add Gzopen() function to read/write compressed file by gzip

[EMU] support to save/load compressed state file
[EMU/DEBUGGER] support to switch the target cpu/device

[VM/I386] improve i386 core based on MAME 0.197
[VM/MB8877] improve for debugger
[VM/TMS9918] improve for debugger
[VM/UPD765A] improve for debugger
[VM/UPD765A] fix read/write commands to check density (thanks PC8801MA夵)
[VM/UPD765A] fix read diagnostics status for unformat/density mismatch case

[PC8801/PC88] fix underline/upperline attributes
[PC98XL] support NEC PC-98XL
[PC9801/MEMBUS] support NEC EMS
[PC9801/MEMBUS] support SASI/SCSI/IDE BIOS (only BIOS, not drives)
[X1/KEYBOAD] improve phantom keys (thanks Mr.Sato)

-----


Have fun!
-- Ohta.

