source/RELEASENOTE.txt

   1 ** Qt porting and FM-7/77/AV/AV40/EX for Common Source Code Project **
   2
   3                                                           Mar 04, 2016
   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 Visual Studio 2015 + DirectX9 + Direct Input 8 for Win32.
  10
  11 Additional INFO:
  12 GNU/Linux with AMD64 binaries and Win32 with MINGW binaries are avaiable, packed with 7zip'ed format:
  13
  14
  15   or
  16
  17
  18  MD5SUM:
  19  SHA256SUM:
  20  Source Code:
  21     https://github.com/Artanejp/common_source_project-fm7/releases/tag/SNAPSHOT_20160304
  22
  23
  24 2.Background
  25 Common Source Code Project (CSP) is good emulator writing.
  26 It also distributed with GPLv2, this is good for me.
  27 But codes are specified to M$ Visual C.
  28 I'm using GNU/Linux, and I starting to apply FM-7(or later).
  29 So, I start to port to GNU/Linux and using Qt4/Qt5.
  30
  31 What you need at least:
  32 a. Qt5 (neither Qt3 and Qt4) toolkit.
  33 b. Some OpenGL implementation, maybe at leaset OpenGL v2.x .
  34 c. gcc / g++ (4.7 or later? ) or llvm clang / clang++ (3.5 or later?) toolchain.
  35 d. SDL2 (not SDL1.x).
  36 e. CMake 2.8 or later.
  37
  38    * TIPS: If emufoo.exe don't show screen drawing, set environment
  39            variable QT_OPENGL to software (i.e. Using Windows as VirtualBox's gueat OS).
  40
  41
  42 3.How to build:
  43 After extracting (or git pulled) sourcecodes:
  44 $ cd {srctop}/source/build-cmake/{Machine name}/
  45 $ mkdir build
  46 $ cd build
  47
  48 To configure:
  49 $ cmake ..
  50 or
  51 $ ccmake ..
  52
  53 To build:
  54 $ make
  55
  56 To install:
  57 $ sudo make install
  58
  59 4.Qt specified notice:
  60 ・Place R@Ms under $HOME/emu{Machine Name}/ , this directory has made
  61 after first using.
  62 ・Config file, {foo}.ini is writteon on $HOME/.config/emu{Machine Name}/ .
  63
  64 5.Status
  65 a. I tested to build only under Debian GNU/Linux "sid".
  66    But, perhaps, will succed to build another GNU/Linux OSs or BSD OS variants.
  67    * On windows, using MinGW is already okay, but not tested drawing.
  68    * Cross building with GNU/Linux's MinGW32 and Qt5.5.1 (for MinGW) is available.
  69      Modify and use build-cmake/config_build_cross_win32.sh and related *.cmake files.
  70    * And, you can also build with M$ Visual Studio 2013 or 2015.
  71
  72 b. Now, I using Qt5 as toolkit, because authors of Qt announced
  73    "Qt4 is obsolete, will be updated no longer".
  74
  75 c. All of virtual machines are already ported to Qt (On Oct 29, 2015):
  76 d. Now using GCC-5.2 with Link Time Optimize to build for distrubuted binaries.
  77
  78 Upstream repositry:
  79 https://github.com/Artanejp/common_source_project-fm7
  80
  81 Upstream (Takeda Toshiya San's original code)
  82 http://homepage3.nifty.com/takeda-toshiya/
  83
  84 Changes:
  85
  86 * SNAPSHOT Mar 04, 2016
  87   * Merge upstream 2016-03-01. Applying new APIs.
  88   * [FM8] Fix wrong sequence of selecting BOOT ROMS when reading/writing $FD0F,
  89     Thanks for Anna_Wu .
  90   * [UI/Qt] Re-Working "Paste from clipboard", apply to new APIs.
  91   * [UI/Qt] Fix character encoding of config file
  92             when not using UTF-8 as local encoding.
  93   * [General] Enable to build with LLVM Clang at least 3.7. Another
  94               versions are not tested yet.
  95   * More usable dialog for setting sound volumes.
  96   * Fix debugger a bit.
  97   * Built with commit 2fc557e88d2715f5fda328ecf38af4b81714b81e or later.
  98
  99 -- Mar 04, 2016 22:56:53 +0900 K.Ohta <whatisthis.sowhat@gmail.com>
 100
 101 Upstream changes:
 102 -----
 103 3/1/2016
 104
 105 [ALL] use integer types defined in stdint.h (uint8 -> uint8_t, etc)
 106 [ALL] rename pair and scrntype to pair_t and scrntype_t
 107
 108 [COMMON] add get_long_full_path_name() and get_parent_dir()
 109 [COMMON] rename IsFileExists() in FILEIO class to IsFileExisting()
 110 [EMU] import Mr.Artane.'s fixes (Commits on Feb 27, 2016)
 111 [EMU] add get_osd()
 112 [EMU] add set_mouse_pointer(), set_mouse_button(), and get_mouse_button()
 113 [EMU] add get_access_lamp_status() and get_led_status()
 114 [EMU/DEBUGGER] avoid PostMessage() and GetAsyncKeyState()
 115 [WIN32/CONSOLE] add is_console_key_pressed() and close_debugger_console()
 116
 117 [VM/DATAREC] fix t77 image loader (thanks Mr.Artane.)
 118 [VM/DEVICE] add get_device_name() (thanks Mr.Artane.)
 119 [VM/DISK] import Mr.Artane.'s fixes for eFM7/77/77AV hacks
 120 [VM/MB8877] import Mr.Artane.'s fixes for eFM7/77/77AV hacks
 121 [VM/MC6809] add 16/32bit read/write functions for debugger (thanks Mr.Artane.)
 122 [VM/V99X8] fix macro to create color (thanks Mr.Artane.)
 123 [VM/Z80DMA] fix build issue for MinGW's (older) GCC (thanks Mr.Artane.)
 124
 125 [FM77AV] import Mr.Artane.'s fixes (Commits on Feb 27, 2016)
 126 [FM77AV] add eFM8 codes (thanks Mr.Artane.)
 127 [J3100] fix build issues (thanks Mr.Artane.)
 128
 129
 130 -----
 131
 132
 133 Have fun!
 134 -- Ohta.
 135