OSDN Git Service

[DOC] Update documents.
[csp-qt/common_source_project-fm7.git] / source / RELEASENOTE.txt
index cd7723b..3f2296d 100644 (file)
 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
 
-                                                          Mar 11, 2016
+                                                       September 30, 2018
                             K.Ohta  (whatisthis.sowhat _at_ gmail.com)
 
 1.About
 
 This package is Qt5 porting of Common Source Code Project (CSP)
-and Built with Visual Studio 2015 + DirectX9 + Direct Input 8 for Win32.
+and built with Qt5, for Windows, built with MinGW(32bit).
 
-Additional INFO:
-GNU/Linux with AMD64 binaries and Win32 with MINGW binaries are avaiable, packed with 7zip'ed format:
-
-
-  or
+Source Code:
 
+   https://github.com/Artanejp/common_source_project-fm7/releases/tag/SNAPSHOT_20180930
+   
+Additional INFO:
 
- MD5SUM: 
- SHA256SUM: 
- Source Code:
-    https://github.com/Artanejp/common_source_project-fm7/releases/tag/SNAPSHOT_20160311
+   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.
+
+a. Qt5 (neither Qt3 and Qt4) toolkit: Qt5.3 or later.
+
 b. Some OpenGL implementation, maybe at leaset OpenGL v2.x .
-c. gcc / g++ (4.7 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain.
+
+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.
 
-   * 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).
+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:
-・Place R@Ms under $HOME/emu{Machine Name}/ , this directory has made
-after first using.
-・Config file, {foo}.ini is writteon on $HOME/.config/emu{Machine Name}/ .
-
+   
+   ・Config file (scancode.cfg and foo.ini) has placed (moved) to
+     "~/.config/CommonSourceCodeProject/emufoo/"
+     (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
+   
+   ・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 and Japanese translations.(2017-01-24)
+   
+   ・Place R@Ms under $HOME/CommonSourceCodeProject/emu{Machine Name}/ , this directory has made
+     after first using.
+   
+   ・Config file, {foo}.ini is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/ .
+   
+   ・Saved state file, {foo}.sta is written on $HOME/CommonSourceCodeProject/emu{Machine Name}/ .
+   
+   ・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 UI components (at src/qt/gui ) are moved to shared lib. libCSPgui.so .
+   
+   ・Installer (bash) script is available now; src/tool/installer_unix.sh .
+   
+   ・When 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".
+
+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".
+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-5.2 with Link Time Optimize to build for distrubuted binaries.
+c. All of virtual machines are already ported to Qt (On Oct 29, 2015).
 
-Upstream repositry:
-https://github.com/Artanejp/common_source_project-fm7
+d. Now using GCC-6.1 with Link Time Optimize to build for distrubuted binaries.
 
-Upstream (Takeda Toshiya San's original code)
-http://homepage3.nifty.com/takeda-toshiya/
+e. Implemented socket, networking for MZ-2500, but, not tested yet (;´Д`)
 
-Changes:
+Repositry:
 
-* SNAPSHOT Mar 11, 2016
-  * "Pray for all people injured by Great East Japan Earthquake"
-  * Merge upstream 2016-03-05. Fix some FTBFSs with SCSI and FMR30/50.
-  * [Menu/Qt] Fix some unification spells at menu, thanks to Anna_Wu.
-  * [UI/Qt] Add icons a lot, from mate-icon-theme source package @
-    mate-desktop.org.
-  * [UI/Qt] Working "Paste from clipboard" with CR/LF.
-    Thanks to http://hanabi.2ch.net/test/read.cgi/i4004/1430836648/528 .
-  * [Win32] Fix character encoding at logging. Thanks to
-    Thanks to http://hanabi.2ch.net/test/read.cgi/i4004/1430836648/528,530 .
-  * [Qt/Sound] Update sound volume setting dialog.
-  * [Qt/BMJr] Fix not input some keys with Qt.
-  * [FM7] Detect 太陽の神殿 for FM-7 series to correct transfer
-    timing automatically.
-  * Fix bugs a bit.
-  * Built with commit 9bf4e859273593bffa3ce5b55382776df6171536 or later.
--- Mar 11, 2016 01:50:52 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
+   https://github.com/Artanejp/common_source_project-fm7
 
-Upstream changes:
------
-3/5/2016
+   https://osdn.net/projects/csp-qt/scm/git/common_source_project-fm7
+
+
+Project Page:
 
-[EMU] add force_out_debug_log() function
+   https://osdn.jp/projects/csp-qt/
 
-[VM/DEVICE] add definitions for SCSI signals
-[VM/I8237] suuport output signal to notify terminal count
-[VM/MB8877] support MB89311
-[VM/SCSI_HOST] support SCSI base host adaptor
-[VM/SCSI_DEV] support SCSI base device
-[VM/SCSI_HDD] support SCSI hard disk drive
-[VM/UPD71071] fix to clear registers at initialize() for debug mode
-[VM/UPD71071] fix initial mode and mask registers values in reset()
+Upstream (Takeda Toshiya San's original code):
 
-[FMR30] fix not to use pseudo bios class when ipl rom image is loaded
-[FMR30/SCSI] support SCSI host adaptor
-[FMR50] fix not to use pseudo bios class when ipl rom image is loaded
-[FMR50/BIOS] remove codes for unused memory card and power management bios
-[FMR50/SCSI] support SCSI host adaptor
+   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 September 30, 2018
+  * Upstream 2018-09-30 .
+  * [General/I18N] Update Japanese translations.
+  * [FMGEN] Initial implementation of OPN2 (YM2612) from OPNA.
+  * [VM/FMTOWNS] WORKING IN PROGRESS, WILL NOT BUILD due to still implement partly.
+  * Built with 699bbf012e9670269c408925525a5b4ea27dd418 (or later).
+
+-- September 30, 2018 15:50:18 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
+
+Upstream changes:
+* To see older upstream's changes, read history.txt.
+
+9/30/2018
+
+[COMMON/FILEIO] improve Fseek for compressed file by gzip
+[EMU] improve to mount/unmount hard disk image in reset() if not hot swappable
+[EMU/DEBUGGER] add commands for checkpoint
+[EMU/DEBUGGER] improve to read/write files in initial current directory
+
+[VM/DISK] improve for case 2D disk is inserted to 2DD drive (thanks Mr.Sato)
+[VM/HARDDISK] support Virtual98 hdd image
+[VM/HARDDISK] improve for solid image file
+[VM/IO] improve debug log
+[VM/MSM58321] fix pulse event (thanks Mr.Artane.)
+[VM/SCSI_DEV] add is_hot_swappable
+[VM/SCSI_HDD] improve to mount/unmount image in reset() if not hot swappable
+[VM/SASI_HDD] support SASI hard disk drive
+[VM/SN76489AN] fix save/load state function
+[VM/UPD71071] fix verify command
+
+[FM77L4] add eFM77L4 codes (thanks Mr.Artane.)
+[MZ80A] improve to switch 2D/2DD drive type
+[MZ80B] improve to switch 2D/2DD drive type
+[MZ1500] improve to switch 2D/2DD drive type
+[MZ2500] improve to switch 2D/2DD drive type
+[MZ2800/FLOPPY] improve to switch 2D/2DD drive type
+[MZ2800/SASI] support SASI I/F and HDD (partial)
+[PC98XA] support NEC PC-98XA
+[PC9801/MEMBUS] fix save/load state function
+[X1TURBO/FLOPPY] improve to switch 2D/2DD drive type (thanks Mr.Sato)
 
 -----