source/RELEASENOTE.txt

   1 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
   2
   3                                                        December 18, 2018
   4                             K.Ohta  (whatisthis.sowhat _at_ gmail.com)
   5
   6 1.About
   7
   8 This package is Qt5 porting of Common Source Code Project (CSP)
   9 and built with Qt5, for Windows, built with MinGW(32bit).
  10
  11 Source Code:
  12
  13    https://github.com/Artanejp/common_source_project-fm7/releases/tag/SNAPSHOT_20181218
  14
  15 Additional INFO:
  16
  17    Binaries will be available, distibute from osdn.net.
  18
  19    See, https://osdn.net/projects/csp-qt/  and
  20         https://osdn.net/projects/csp-qt/releases/ .
  21
  22    Released at:
  23
  24
  25 2.Background
  26
  27 Common Source Code Project (CSP) is good emulator writing.
  28 It also distributed with GPLv2, this is good for me.
  29
  30 But codes are specified to M$ Visual C.
  31 I'm using GNU/Linux, and I starting to apply FM-7(or later).
  32
  33 So, I start to port to GNU/Linux and using Qt4/Qt5.
  34
  35 What you need at least:
  36
  37 a. Qt5 (neither Qt3 and Qt4) toolkit: Qt5.3 or later.
  38
  39 b. Some OpenGL implementation, maybe at leaset OpenGL v2.x .
  40
  41 c. gcc / g++ (5.0 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain.
  42
  43 d. SDL2 (not SDL1.x).
  44
  45 e. CMake 2.8 or later.
  46
  47 f. Needs ffmpeg.See https://ffmpeg.org/ .
  48
  49 g. FFMpeg has bundled only for Win32.Please install for other OSs if not working.
  50
  51 h. Built with Qt5.5 (for Ubuntu 16.04LTS) or Qt 5.10 (for Win32 and Debian/Sid).
  52
  53 i. Now, changed default drawing infrastructure to OpenGL ES2.You can change --opengl option via comman line (or GUI).
  54
  55 * 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).
  56
  57
  58 3.How to build:
  59
  60 After extracting (or git pulled) sourcecodes:
  61
  62 $ cd {srctop}/source/build-cmake/{Machine name}/
  63
  64 $ mkdir build
  65
  66 $ cd build
  67
  68 To configure:
  69
  70 $ cmake ..
  71
  72 or
  73
  74 $ ccmake ..
  75
  76 To build:
  77
  78 $ make
  79
  80 To install:
  81
  82 $ sudo make install
  83
  84 4.Qt specified notice:
  85
  86    ・Config file (scancode.cfg and foo.ini) has placed (moved) to
  87      "~/.config/CommonSourceCodeProject/emufoo/"
  88      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  89
  90    ・BIOS, WAVS, BINS and SAVED STATES have placed (moved) to
  91      "~/CommonSourceCodeProject/emufoo/"
  92      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  93
  94    ・All of recorded products (PNG Screenshots, MOVIES, SOUNDS)
  95      have *temporally* written to "~/.config/CommonSourceCodeProject/emufoo/"
  96      (for Windows, ".\CommonSourceCodeProject\emudfoo\" ).
  97
  98    ・Added ToolTips and Japanese translations.(2017-01-24)
  99
 100    ・Place R@Ms under $HOME/CommonSourceCodeProject/emu{Machine Name}/ , this directory has made
 101      after first using.
 102
 103    ・Config file, {foo}.ini is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/ .
 104
 105    ・Saved state file, {foo}.sta is written on $HOME/CommonSourceCodeProject/emu{Machine Name}/ .
 106
 107    ・Key code conversion file is written on $HOME/.config/CommonSourceCodeProject/emu{Machine Name}/scancode.cfg .
 108
 109      This file contains comma separated fields, written at hex-decimal (not decimal),
 110        first is M$ Virtual Key Code,
 111        second is Qt's scan code.
 112
 113    ・Common UI components (at src/qt/gui ) are moved to shared lib. libCSPgui.so .
 114
 115    ・Installer (bash) script is available now; src/tool/installer_unix.sh .
 116
 117    ・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.
 118
 119 5.Status
 120
 121 a. I tested to build only under Debian GNU/Linux "sid",Ubuntu Linux 16.04LTS "Xenial" for AMD64 (x86_64)
 122 and MinGW with GCC6 (Windows 32bit).
 123
 124    But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants.
 125
 126    * On windows, using MinGW is already okay, but not tested drawing.
 127
 128    * Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available.
 129      Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files.
 130
 131    * And, you can also build with M$ Visual Studio 2013 or 2015.
 132
 133 b. Now, I using Qt5 as toolkit, because authors of Qt announced "Qt4 is obsolete, will be updated no longer".
 134
 135 c. All of virtual machines are already ported to Qt (On Oct 29, 2015).
 136
 137 d. Now using GCC-6.1 with Link Time Optimize to build for distrubuted binaries.
 138
 139 e. Implemented socket, networking for MZ-2500, but, not tested yet (；´Д｀)
 140
 141 Repositry:
 142
 143    https://github.com/Artanejp/common_source_project-fm7
 144
 145    https://osdn.net/projects/csp-qt/scm/git/common_source_project-fm7
 146
 147
 148 Project Page:
 149
 150    https://osdn.jp/projects/csp-qt/
 151
 152 Upstream (Takeda Toshiya San's original code):
 153
 154    http://takeda-toshiya.my.coocan.jp/
 155
 156 Special thanks to:
 157    Ryu Takegami-san, to assist debugging FM-7/77/AV/40/EX .
 158    Haserin-san, to assist debugging FM-7/77/AV/40/EX .
 159    Developers of Ootake, give hints of emuPCEngine (from source code).
 160
 161 Changes:
 162
 163 * To see older changes, read ChangeLog and 000_gitlog.txt.
 164
 165 * SNAPSHOT December 18, 2018
 166   * Upstream 2018-12-09 .
 167   * [VM/PC9801] Add pseudo SASI (HDD) BIOS for PC-9801.WIP.
 168   * [VM/EVENT] Improve error message at cancel_event().
 169   * [VM/HUC2680] Improve around timer.Thanks to  Ootake v2.83.
 170   * [VM/PCENGINE] Improve process around NEC extended command (0xd*).
 171   * [VM/PCENGINE] PCE_ADPCM: Fix not sound data length >= 65536 bytes.This still don't fix some softwares.i.e. Megami-Paradise.
 172   * [VM/PCENGINE] Porting from Ootake v2.83.This still WORK-IN-PROGRESS.
 173   * [VM/PCENGINE] CDROM: Don't reset ADPCM more than once at CDROM makes "NOT BUSY".
 174   * [VM/PCENGINE] Most of CD-ROM^2 softwares maybe work.Excepts LASERSOFT's products and using "ARCADE card".
 175   * [VM/SCSI_CDROM] Add write_signal() to control CDDA from MACHINE.
 176   * [VM/SCSI_CDROM] Fix CD-DA buffer handling.Reading buffer should be per 2352 bytes.
 177   * [VM/SCSI_CDROM] CUE: More correctness cue parsing.
 178   * [VM/SCSI_CDROM] CUE: Set default pre-gap to 2Sec (150frames).Fix audio problems of most softwares.Maybe fixed issues on Manhole.
 179   * [VM/SCSI_CDROM] More correctness SEEK/Interrupt timing.
 180   * [VM/FM7] DISPLAY: Fix for logging "[EVENT] EVENT: device (name=DISPLAY SUBSYSTEM, id=25) tries to cancel event 6 that is not its own (owned by (name=PRINTER I/F id=20))!!!"
 181   * [Draw/Qt] OpenGL: Abondon depth test.
 182   * [UI/Qt] OOPS: Fix OOPs around mounting virtual D88/D77 image(s).
 183   * [UI/MENU] HARDDISK: OOPS: I missed update directory.
 184   * [UI/MENU] Fix oops dialog of opening virtual HDD.
 185   * Built with ee880845ec85aa431df3c7a937611e9c20dd591d (or later).
 186
 187 -- December 18, 2018 16:31:55 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
 188
 189 Upstream changes:
 190 * To see older upstream's changes, read history.txt.
 191
 192 12/9/2018
 193
 194 [VM/SCSI_CDROM] add vendor specific command for NEC CD-ROM^2
 195
 196 [PC8801/PC88] support CD-ROM drive (thanks M88/cdif)
 197 [PC8801/PC88] support Video Art Boad (thanks X88000)
 198
 199
 200 12/5/2018
 201
 202 [VM/MB8877] improve reset() to finish previous command and reset fdc completely
 203 [VM/Z80] add read_signal() to read irq status
 204
 205 [PC8801/PC88] improve to render scan line with black if color graphic mode
 206 [SMC70/MEMORY] support 640x400 and 160x100 graphic mode
 207 [SMC777/MEMORY] fix issue that text blink is not working
 208 [SMC777/MEMORY] improve inport 21h to read vsync irq status
 209 [SMC777/MEMORY] improve inport 51h to read cursor and space keys as joystick #1
 210 [VM/*] improve tape interfaces for each virtual machine
 211
 212
 213 12/4/2018
 214
 215 [CONFIG] remove fmgen_dll_path and add mame2151_dll_path/mame2608_dll_path
 216
 217 [VM/YM2203] remove HAS_YM2608 and YM2203_PORT_MODE to simplify code
 218
 219 [PC8801] support HMB-20 sound board
 220
 221
 222 12/2/2018-2
 223
 224 [PC8801/PC88] fix text/graph renderer again (thanks Mr.Bookworm)
 225
 226
 227 12/2/2018
 228
 229 [PC8801/PC88] fix not to apply reverse attribute to monochrome graphic screen
 230
 231
 232 12/1/2018
 233
 234 [PC8801] enable/disable drawing scan line when monitor type is hireso/standard
 235 [PC8801/PC88] improve text attributes/rederer (thanks ePC-8801MA\89ü)
 236 [PC8801/PC88] fix analog back color
 237 [PC8801/PC88] improve routine to change palette for each scan line
 238
 239
 240 11/28/2018
 241
 242 [WIN32/INPUT] support joystick with multiple axes and hat key
 243 [WIN32/INPUT] improve joystick to keyboard function for numpad key 5
 244
 245
 246 11/27/2018
 247
 248 [WIN32/INPUT] support joystick to keyboard function
 249 [WIN32/SCREEN] support Window x1.5 mode
 250
 251 [PC8801/PC88] support PC key, that is mapped to F11
 252
 253 -----
 254
 255
 256 Have fun!
 257 -- Ohta.
 258