ShuriZma
/
fceux
mirror of https://github.com/TASEmulators/fceux.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #256 from mjbudd77/master 

Qt/SDL Release Preparation
This commit is contained in:
mjbudd77 2020-12-10 23:06:14 -05:00 committed by GitHub
parent f113f8b60d 3020099c29
commit 6cec8b33da
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
33 changed files with 61 additions and 858 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README
View File

@ -1,4 +1,4 @@
FCEUX SDL 2.2.3 SDL README FCEUX SDL 2.3.0 SDL README
========================== ==========================
Originally By Lukas Sabota (sf: punkrockguy318) Originally By Lukas Sabota (sf: punkrockguy318)
Updated By mjbudd77 Updated By mjbudd77

256
SConstruct
View File

@ -1,256 +0,0 @@
#
# SConstruct - build script for the SDL port of fceux
#
# You can adjust the BoolVariables below to include/exclude features
# at compile-time. You may also use arguments to specify the parameters.
# ie: scons RELEASE=1 GTK3=1
#
# Use "scons" to compile and "scons install" to install.
#
import os
import sys
import platform
opts = Variables(None, ARGUMENTS)
opts.AddVariables(
BoolVariable('DEBUG', 'Build with debugging symbols', 1),
BoolVariable('RELEASE', 'Set to 1 to build for release', 0),
BoolVariable('FRAMESKIP', 'Enable frameskipping', 1),
BoolVariable('OPENGL', 'Enable OpenGL support', 1),
BoolVariable('LUA', 'Enable Lua support', 1),
BoolVariable('GTK', 'Enable GTK2 GUI (SDL only)', 0),
BoolVariable('GTK3', 'Enable GTK3 GUI (SDL only)', 1),
BoolVariable('NEWPPU', 'Enable new PPU core', 1),
BoolVariable('CREATE_AVI', 'Enable avi creation support (SDL only)', 1),
BoolVariable('LOGO', 'Enable a logoscreen when creating avis (SDL only)', 1),
BoolVariable('SYSTEM_LUA','Use system lua instead of static lua provided with fceux', 0),
BoolVariable('SYSTEM_MINIZIP', 'Use system minizip instead of static minizip provided with fceux', 0),
BoolVariable('LSB_FIRST', 'Least signficant byte first (non-PPC)', 1),
BoolVariable('CLANG', 'Compile with llvm-clang instead of gcc', 0),
BoolVariable('SDL2', 'Compile using SDL2 instead of SDL 1.2 (experimental/non-functional)', 1)
)
AddOption('--prefix', dest='prefix', type='string', nargs=1, action='store', metavar='DIR', help='installation prefix')
prefix = GetOption('prefix')
env = Environment(options = opts)
if env['RELEASE']:
env.Append(CPPDEFINES=["PUBLIC_RELEASE"])
env['DEBUG'] = 0
# LSB_FIRST must be off for PPC to compile
if platform.system == "ppc":
env['LSB_FIRST'] = 0
# Default compiler flags:
env.Append(CCFLAGS = ['-Wall', '-Wno-write-strings', '-Wno-sign-compare', '-Wno-parentheses', '-Wno-unused-local-typedefs'])
env.Append(CXXFLAGS = ['-std=c++0x'])
if 'PLATFORM' in os.environ:
env.Replace(PLATFORM = os.environ['PLATFORM'])
if 'CC' in os.environ:
env.Replace(CC = os.environ['CC'])
if 'CXX' in os.environ:
env.Replace(CXX = os.environ['CXX'])
if 'WINDRES' in os.environ:
env.Replace(WINDRES = os.environ['WINDRES'])
if 'CFLAGS' in os.environ:
env.Append(CCFLAGS = os.environ['CFLAGS'].split())
if 'CXXFLAGS' in os.environ:
env.Append(CXXFLAGS = os.environ['CXXFLAGS'].split())
if 'CPPFLAGS' in os.environ:
env.Append(CPPFLAGS = os.environ['CPPFLAGS'].split())
if 'LDFLAGS' in os.environ:
env.Append(LINKFLAGS = os.environ['LDFLAGS'].split())
if 'PKG_CONFIG_PATH' in os.environ:
env['ENV']['PKG_CONFIG_PATH'] = os.environ['PKG_CONFIG_PATH']
if 'PKG_CONFIG_PATH' not in os.environ and env['PLATFORM'] == 'darwin':
env['ENV']['PKG_CONFIG_PATH'] = "/usr/local/lib/pkgconfig:/opt/X11/lib/pkgconfig"
if 'PKG_CONFIG_LIBDIR' in os.environ:
env['ENV']['PKG_CONFIG_LIBDIR'] = os.environ['PKG_CONFIG_LIBDIR']
print("platform: ", env['PLATFORM'])
# compile with clang
if env['CLANG']:
env.Replace(CC='clang')
env.Replace(CXX='clang++')
# special flags for cygwin
# we have to do this here so that the function and lib checks will go through mingw
if env['PLATFORM'] == 'cygwin':
env.Append(CCFLAGS = " -mno-cygwin")
env.Append(LINKFLAGS = " -mno-cygwin")
env['LIBS'] = ['wsock32'];
if env['PLATFORM'] == 'win32':
env.Append(CPPPATH = [".", "drivers/win/", "drivers/common/", "drivers/", "drivers/win/zlib", "drivers/win/directx", "drivers/win/lua/include"])
env.Append(CPPDEFINES = ["PSS_STYLE=2", "WIN32", "_USE_SHARED_MEMORY_", "NETWORK", "FCEUDEF_DEBUGGER", "NOMINMAX", "NEED_MINGW_HACKS", "_WIN32_IE=0x0600"])
env.Append(LIBS = ["rpcrt4", "comctl32", "vfw32", "winmm", "ws2_32", "comdlg32", "ole32", "gdi32", "htmlhelp"])
else:
conf = Configure(env)
# If libdw is available, compile in backward-cpp support
if conf.CheckLib('dw'):
conf.env.Append(CCFLAGS = "-DBACKWARD_HAS_DW=1")
conf.env.Append(LINKFLAGS = "-ldw")
if conf.CheckFunc('asprintf'):
conf.env.Append(CCFLAGS = "-DHAVE_ASPRINTF")
if env['SYSTEM_MINIZIP']:
assert env.ParseConfig('pkg-config minizip --cflags --libs'), "please install: libminizip"
assert env.ParseConfig('pkg-config zlib --cflags --libs'), "please install: zlib"
#assert conf.CheckLibWithHeader('z', 'zlib.h', 'c', 'inflate;', 1), "please install: zlib"
env.Append(CPPDEFINES=["_SYSTEM_MINIZIP"])
else:
assert env.ParseConfig('pkg-config zlib --cflags --libs'), "please install: zlib"
#assert conf.CheckLibWithHeader('z', 'zlib.h', 'c', 'inflate;', 1), "please install: zlib"
if env['SDL2']:
assert env.ParseConfig('pkg-config sdl2 --cflags --libs'), "please install: sdl2"
env.Append(CPPDEFINES=["_SDL2"])
#env.ParseConfig('pkg-config sdl2 --cflags --libs')
else:
if not conf.CheckLib('SDL'):
print('Did not find libSDL or SDL.lib, exiting!')
Exit(1)
env.ParseConfig('sdl-config --cflags --libs')
if env['GTK']:
if not conf.CheckLib('gtk-x11-2.0'):
print('Could not find libgtk-2.0, exiting!')
Exit(1)
# Add compiler and linker flags from pkg-config
config_string = 'pkg-config --cflags --libs gtk+-2.0'
env.ParseConfig(config_string)
env.Append(CPPDEFINES=["_GTK2"])
env.Append(CCFLAGS = ["-D_GTK"])
if env['GTK3']:
# Add compiler and linker flags from pkg-config
config_string = 'pkg-config --cflags --libs gtk+-3.0'
env.ParseConfig(config_string)
env.Append(CPPDEFINES=["_GTK3"])
env.Append(CCFLAGS = ["-D_GTK"])
### Just make every configuration use -ldl, it may be needed for some reason.
env.Append(LIBS = ["-ldl"])
### Lua platform defines
### Applies to all files even though only lua needs it, but should be ok
if env['LUA']:
env.Append(CPPDEFINES=["_S9XLUA_H"])
if env['PLATFORM'] == 'darwin':
# Define LUA_USE_MACOSX otherwise we can't bind external libs from lua
env.Append(CCFLAGS = ["-DLUA_USE_MACOSX"])
if env['PLATFORM'] == 'posix':
# If we're POSIX, we use LUA_USE_LINUX since that combines usual lua posix defines with dlfcn calls for dynamic library loading.
# Should work on any *nix
env.Append(CCFLAGS = ["-DLUA_USE_LINUX"])
if env['SYSTEM_LUA']:
lua_link_flags = ''
lua_include_dir = ''
if conf.CheckLib('luajit-5.1'):
lua_link_flags = "-lluajit-5.1"
lua_include_dir = "/usr/include/luajit-2.0"
elif conf.CheckLib('lua5.1'):
lua_link_flags = "-llua5.1"
lua_include_dir = "/usr/include/lua5.1"
elif conf.CheckLib('lua-5.1'):
lua_link_flags = "-llua-5.1"
lua_include_dir = "/usr/include/lua-5.1"
elif conf.CheckLib('lua'):
lua_link_flags = "-llua"
lua_include_dir = "/usr/include/lua"
if 'LUA_LINKFLAGS' in os.environ:
lua_link_flags = os.environ['LUA_LINKFLAGS']
if 'LUA_INCDIR' in os.environ:
lua_include_dir = os.environ['LUA_INCDIR']
if not lua_link_flags or not lua_include_dir:
print('Could not find liblua, exiting!')
Exit(1)
env.Append(LINKFLAGS = lua_link_flags.split())
env.Append(CCFLAGS = ["-I" + lua_include_dir])
else:
env.Append(CCFLAGS = ["-Isrc/lua/src"])
# "--as-needed" no longer available on OSX (probably BSD as well? TODO: test)
if env['PLATFORM'] != 'darwin':
env.Append(LINKFLAGS=['-Wl,--as-needed'])
### Search for gd if we're not in Windows
if (env['PLATFORM'] != 'win32' and env['PLATFORM'] != 'cygwin') and (env['CREATE_AVI'] or env['LOGO']):
gd = conf.CheckLib('gd', autoadd=1)
if gd == 0:
env['LOGO'] = 0
print('Did not find libgd, you won\'t be able to create a logo screen for your avis.')
if env['OPENGL'] and conf.CheckLibWithHeader('GL', 'GL/gl.h', 'c', autoadd=1):
conf.env.Append(CCFLAGS = "-DOPENGL")
conf.env.Append(CPPDEFINES = ['PSS_STYLE=1',"FCEUDEF_DEBUGGER"])
env = conf.Finish()
if sys.byteorder == 'little' or env['PLATFORM'] == 'win32':
env.Append(CPPDEFINES = ['LSB_FIRST'])
if env['FRAMESKIP']:
env.Append(CPPDEFINES = ['FRAMESKIP'])
print("base CPPDEFINES:",env['CPPDEFINES'])
print("base CCFLAGS:",env['CCFLAGS'])
if env['DEBUG']:
env.Append(CPPDEFINES=["_DEBUG"], CCFLAGS = ['-g', '-O0'])
else:
env.Append(CCFLAGS = ['-O2'])
if env['PLATFORM'] != 'win32' and env['PLATFORM'] != 'cygwin' and env['CREATE_AVI']:
env.Append(CPPDEFINES=["CREATE_AVI"])
else:
env['CREATE_AVI']=0;
Export('env')
fceux = SConscript('src/SConscript')
env.Program(target="fceux-net-server", source=["fceux-server/server.cpp", "fceux-server/md5.cpp", "fceux-server/throttle.cpp"])
# Installation rules
if prefix == None:
prefix = "/usr/local"
exe_suffix = ''
if env['PLATFORM'] == 'win32':
exe_suffix = '.exe'
fceux_src = 'src/fceux' + exe_suffix
fceux_dst = 'bin/fceux' + exe_suffix
fceux_net_server_src = 'fceux-net-server' + exe_suffix
fceux_net_server_dst = 'bin/fceux-net-server' + exe_suffix
auxlib_src = 'src/auxlib.lua'
auxlib_dst = 'bin/auxlib.lua'
fceux_h_src = 'output/fceux.chm'
fceux_h_dst = 'bin/fceux.chm'
env.Command(fceux_h_dst, fceux_h_src, [Copy(fceux_h_dst, fceux_h_src)])
env.Command(fceux_dst, fceux_src, [Copy(fceux_dst, fceux_src)])
env.Command(fceux_net_server_dst, fceux_net_server_src, [Copy(fceux_net_server_dst, fceux_net_server_src)])
env.Command(auxlib_dst, auxlib_src, [Copy(auxlib_dst, auxlib_src)])
man_src = 'documentation/fceux.6'
man_net_src = 'documentation/fceux-net-server.6'
share_src = 'output/'
image_src = 'fceux.png'
desktop_src = 'fceux.desktop'
env.Install(prefix + "/bin/", [fceux, fceux_net_server_src])
env.InstallAs(prefix + '/share/fceux/', share_src)
env.Install(prefix + '/share/fceux/', auxlib_src)
env.Install(prefix + '/share/pixmaps/', image_src)
env.Install(prefix + '/share/applications/', desktop_src)
env.Install(prefix + "/share/man/man6/", [man_src, man_net_src])
env.Alias('install', prefix)

2
TODO-SDL
View File

@ -61,7 +61,7 @@ Network play (who actually uses this???) | NO | NO
QT QT
=== ===
* Clean out rest of old GTK comments and #ifdefs * Clean out rest of old GTK comments and #ifdefs
* GUI Debug Tools TODO * GUI Debug Tools Pretty Much Done
* GUI should compile in windows as well.... but testing is not a priority since the windows gui already has a totally separate backend. * GUI should compile in windows as well.... but testing is not a priority since the windows gui already has a totally separate backend.
BUGS BUGS

2
_config.yml
View File

@ -23,7 +23,6 @@ exclude:
- NEWS - NEWS
- NewPPUtests.txt - NewPPUtests.txt
- README - README
- SConstruct
- STYLE-GUIDELINES-SDL - STYLE-GUIDELINES-SDL
- TODO-SDL - TODO-SDL
- _config.yml - _config.yml
@ -32,7 +31,6 @@ exclude:
- azure-pipelines.yml - azure-pipelines.yml
- changelog.txt - changelog.txt
- configure.ac - configure.ac
- debian-crossbuild.sh
- doxygen - doxygen
- fceux.desktop - fceux.desktop
- readme.md - readme.md

159
configure.ac
View File

@ -1,159 +0,0 @@
AC_INIT([fceux], [2.2.3])
AC_CONFIG_SRCDIR([src/fceu.cpp])
AM_INIT_AUTOMAKE
AC_PROG_CC
AC_PROG_CPP
AC_PROG_CXX
AC_PROG_INSTALL
AC_CONFIG_MACRO_DIR([m4])
AC_CHECK_FUNC(asprintf, AC_DEFINE([HAVE_ASPRINTF]))
## This is almost sure to not work
AC_ARG_WITH(nativewin32,
[AC_HELP_STRING([--with-nativewin32],
[use nativewin32])],
use_nativewin32=$withval,
use_nativewin32="no")
AM_CONDITIONAL(WIN32, false)
AM_CONDITIONAL(UNIX, false)
AM_CONDITIONAL(NATIVEWIN32,false)
AM_CONDITIONAL(OPENGL, false)
AM_CONDITIONAL(GTK2, false)
AM_CONDITIONAL(GTK3, false)
AM_CONDITIONAL(LUA, false)
AM_CONDITIONAL(LUA_BUILTIN, false)
AM_CONDITIONAL(SYSTEM_MINIZIP, false)
AM_CONDITIONAL(GD, false)
AM_CONDITIONAL(FRAMESKIP, true)
## Check for zlib
AC_CHECK_LIB([z], [zlibVersion],[], AC_MSG_ERROR([*** zlib not found!]))
LIBS="$LIBS -lz"
AC_CHECK_LIB([pthread], [pthread_create],[], AC_MSG_ERROR([*** pthread not found!]))
LIBS="$LIBS -lpthread"
## Platform specific setup
if expr x"$target" : 'x.*beos' > /dev/null; then
CFLAGS="-no-fpic $CFLAGS"
CPPFLAGS="-no-fpic $CPPFLAGS"
AC_DEFINE([PSS_STYLE],[1])
elif expr x"$target" : 'x.*mingw' > /dev/null; then
## Probably doesn't work
AC_DEFINE([PSS_STYLE],[2])
AC_DEFINE([WIN32])
AM_CONDITIONAL(WIN32, true)
if test x$use_nativewin32 = xyes; then
LIBS="$LIBS -mwindows -lddraw -ldinput -ldsound -lgdi32 -ldxguid -lwinmm -lshell32 -lwsock32 -lcomdlg32 -lole32"
AM_CONDITIONAL(NATIVEWIN32,true)
else
LIBS="$LIBS -ldsound -lwinmm"
fi
elif expr x"$target" : 'x.*darwin' > /dev/null; then
## Probably doesn't work
AC_DEFINE([MACOSX])
else
AM_CONDITIONAL(UNIX, true)
AC_DEFINE([UNIX])
AC_DEFINE([PSS_STYLE],[1])
fi
if test x$use_nativewin32 = xno; then
## Check for SDL
SDL_VERSION=1.2.0
AM_PATH_SDL($SDL_VERSION, [:],
AC_MSG_ERROR([*** SDL version $SDL_VERSION not found!]))
AC_DEFINE([SDL])
LIBS="$LIBS $SDL_LIBS"
CFLAGS="-Wall -fomit-frame-pointer $CFLAGS $SDL_CFLAGS"
CPPFLAGS="-Wall -fomit-frame-pointer $CPPFLAGS $SDL_CFLAGS"
## Check for OpenGL
AC_ARG_ENABLE([opengl],
AS_HELP_STRING([--enable-opengl], [Enable OpenGL support]))
AS_IF([test "x$enable_opengl" != "xno"], [
AC_CHECK_HEADER([GL/gl.h],[AC_DEFINE([OPENGL]) AM_CONDITIONAL(OPENGL, true)],
[
AC_CHECK_HEADER([OpenGL/gl.h],[AC_DEFINE([OPENGL]) AM_CONDITIONAL(OPENGL, true)],[])
AC_DEFINE([APPLEOPENGL])
])
LIBS="$LIBS -lGL -lGLU"
])
## Check for GTK2
AC_ARG_ENABLE([gtk2],
AS_HELP_STRING([--enable-gtk2], [Enable GTK2 GUI]))
AS_IF([test "x$enable_gtk2" = "xyes"], [
AM_PATH_GTK_2_0([2.24.0],AM_CONDITIONAL(GTK2, true),AC_MSG_ERROR([Gtk+ 2.24.0 or higher required.]))
AC_DEFINE([_GTK])
AC_DEFINE([GTK2])
])
## Check for GTK3
AC_ARG_ENABLE([gtk3],
AS_HELP_STRING([--enable-gtk3], [Enable GTK3 GUI]))
AS_IF([test "x$enable_gtk2" = "xyes" -a "x$enable_gtk3" = "xyes"], [
AC_MSG_ERROR([GTK2 and GTK3 cannot be simulatenously enabled.])
])
AS_IF([test "x$enable_gtk3" = "xyes"], [
AM_PATH_GTK_3_0([3.0.0],AM_CONDITIONAL(GTK3, true),AC_MSG_ERROR([Gtk+ 3.0.0 or higher required.]))
AC_DEFINE([_GTK])
AC_DEFINE([GTK3])
])
fi
## Check for system lua
AC_ARG_ENABLE([lua],
AS_HELP_STRING([--enable-lua], [Use lua libraries found on this system]))
AS_IF([test "x$enable_lua" = "xyes"], [
AC_SUBST(LUA, lua5.1)
AX_PROG_LUA([5.1],[5.2])
PKG_CHECK_MODULES([lua51], [lua51])
AX_LUA_LIBS([], AC_MSG_ERROR([Lua libs not found!]))
AC_DEFINE([_S9XLUA_H])
AM_CONDITIONAL(LUA, true)
LIBS="$LIBS $LUA_LIB"
])
## Check for lua builtin
AC_ARG_ENABLE([lua-builtin],
AS_HELP_STRING([--enable-lua-builtin], [Use lua5.1 included with fceux]))
AS_IF([test "x$enable_lua-builtin" = "xyes"], [
#AX_LUA_HEADERS([], AC_MSG_ERROR([Lua 5.1 headers not found!]))
AC_DEFINE([_S9XLUA_H])
AM_CONDITIONAL(LUA_BUILTIN, true)
])
## Check for gd
AC_ARG_ENABLE([gd],
AS_HELP_STRING([--enable-gd], [Use libgd for AVI creation]))
AS_IF([test "x$enable_gd" = "xyes"], [
#AX_LUA_HEADERS([], AC_MSG_ERROR([Lua 5.1 headers not found!]))
AX_CHECK_GD
LIBS="$LIBS $GD_LIBS"
AC_DEFINE([CREATE_AVI])
])
## Check for system minizip
AC_ARG_ENABLE([system-minizip],
AS_HELP_STRING([--enable-system-minizip], [Use minizip from system instead of fceux distribution]))
AS_IF([test "x$enable_system_minizip" = "xyes"], [
PKG_CHECK_MODULES([minizip], [minizip])
AM_CONDITIONAL(SYSTEM_MINIZIP, true)
LIBS="$LIBS $minizip_LIBS"
])
AC_C_BIGENDIAN([], [AC_DEFINE([LSB_FIRST])])
## Check for frameskip disable
AC_ARG_ENABLE([frameskip],
AS_HELP_STRING([--disable-frameskip], [Disable frameskip feature]))
AS_IF([test "x$disable_frameskip" != "xno"], [
AC_DEFINE([FRAMESKIP])
])
AC_OUTPUT([Makefile src/Makefile])

5
debian-crossbuild.sh
View File

@ -1,5 +0,0 @@
#!/bin/sh
if [ -f /usr/bin/i586-mingw32msvc-windres ]; then HOST=i586-mingw32msvc
else HOST=i586-mingw32
fi
PLATFORM=win32 CC=${HOST}-gcc CXX=${HOST}-g++ WRC=${HOST}-windres WINDRES=${HOST}-windres scons $@

2
pipelines/debpkg.pl
View File

@ -2,7 +2,7 @@
use strict; use strict;
my $VERSION="2.2.3"; my $VERSION="2.3.0";
my $INSTALL_PREFIX="/tmp/fceux"; my $INSTALL_PREFIX="/tmp/fceux";
my $CTL_FILENAME="$INSTALL_PREFIX/DEBIAN/control"; my $CTL_FILENAME="$INSTALL_PREFIX/DEBIAN/control";
my $ARCH="amd64"; my $ARCH="amd64";

4
pipelines/macOS_build.sh
View File

@ -7,8 +7,8 @@ uname -a
sw_vers sw_vers
FCEUX_VERSION_MAJOR=2 FCEUX_VERSION_MAJOR=2
FCEUX_VERSION_MINOR=2 FCEUX_VERSION_MINOR=3
FCEUX_VERSION_PATCH=3 FCEUX_VERSION_PATCH=0
SCRIPT_DIR=$( cd $(dirname $BASH_SOURCE[0]); pwd ); SCRIPT_DIR=$( cd $(dirname $BASH_SOURCE[0]); pwd );

4
readme.md
View File

@ -7,8 +7,8 @@ An open source NES Emulator for Windows and Unix that features solid emulation a
Interim builds: Interim builds:
* Win32: [fceux.zip](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux.zip?branch=master&job=Windows%2032) * Win32: [fceux.zip](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux.zip?branch=master&job=Windows%2032)
* Win64: [fceux64.zip](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux64.zip?branch=master&job=Windows%2064) * Win64: [fceux64.zip](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux64.zip?branch=master&job=Windows%2064)
* Ubuntu: [fceux-2.2.3-amd64.deb](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.2.3-amd64.deb?branch=master&job=Ubuntu) * Ubuntu: [fceux-2.3.0-amd64.deb](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.3.0-amd64.deb?branch=master&job=Ubuntu)
* MacOSX: [fceux-2.2.3-Darwin.dmg](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.2.3-Darwin.dmg?branch=master&job=MacOS) * MacOSX: [fceux-2.3.0-Darwin.dmg](https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.3.0-Darwin.dmg?branch=master&job=MacOS)
* Status: [Appveyor](https://ci.appveyor.com/project/zeromus/fceux/) * Status: [Appveyor](https://ci.appveyor.com/project/zeromus/fceux/)
But you might like mesen more: https://github.com/SourMesen/Mesen But you might like mesen more: https://github.com/SourMesen/Mesen

42
src/SConscript
View File

@ -1,42 +0,0 @@
import glob
file_list = glob.glob('*.cpp')
file_list.remove('lua-engine.cpp') # use logic below for this
subdirs = Split("""
boards
drivers/common
fir
input
utils
""")
#palettes
Import('env')
Export('env')
if env['LUA']:
file_list.append('lua-engine.cpp')
if env['SYSTEM_LUA'] == 0:
subdirs.append('lua')
if env['CREATE_AVI']:
subdirs.append('drivers/videolog')
for dir in subdirs:
subdir_files = SConscript('%s/SConscript' % dir)
file_list.append(subdir_files)
if env['PLATFORM'] == 'win32':
platform_files = SConscript('drivers/win/SConscript')
else:
platform_files = SConscript('drivers/sdl/SConscript')
file_list.append(platform_files)
print(env['LINKFLAGS'])
if env['PLATFORM'] == 'win32':
fceux = env.Program('fceux.exe', file_list)
else:
fceux = env.Program('fceux', file_list)
Return('fceux')

6
src/boards/SConscript
View File

@ -1,6 +0,0 @@
import glob
source_list = glob.glob('*.cpp')+glob.glob('*.c')
for x in range(len(source_list)):
source_list[x] = 'boards/' + source_list[x]
Return('source_list')

2
src/drivers/Qt/AboutWindow.cpp
View File

@ -119,7 +119,7 @@ AboutWindow::AboutWindow(QWidget *parent)
mainLayout->addLayout( hbox1 ); mainLayout->addLayout( hbox1 );
hbox1 = new QHBoxLayout(); hbox1 = new QHBoxLayout();
lbl = new QLabel( tr("© 2016 FceuX Development Team") ); lbl = new QLabel( tr("© 2020 FceuX Development Team") );
hbox1->addWidget( lbl ); hbox1->addWidget( lbl );
hbox1->setAlignment( Qt::AlignCenter ); hbox1->setAlignment( Qt::AlignCenter );

7
src/drivers/Qt/ConsoleDebugger.cpp
View File

@ -2071,7 +2071,6 @@ void QAsmView::updateAssemblyView(void)
uint8 opcode[3]; uint8 opcode[3];
char asmTxt[256]; char asmTxt[256];
dbg_asm_entry_t *a, *d; dbg_asm_entry_t *a, *d;
//GtkTextIter iter, next_iter;
char pc_found = 0; char pc_found = 0;
start_address_lp = starting_address = X.PC; start_address_lp = starting_address = X.PC;
@ -2112,12 +2111,6 @@ void QAsmView::updateAssemblyView(void)
} }
//asmText->clear(); //asmText->clear();
//gtk_text_buffer_get_start_iter( textbuf, &iter );
//textview_lines_allocated = gtk_text_buffer_get_line_count( textbuf ) - 1;
//printf("Num Lines: %i\n", textview_lines_allocated );
for (int i=0; i < 0xFFFF; i++) for (int i=0; i < 0xFFFF; i++)
{ {
line.clear(); line.clear();

4
src/drivers/Qt/config.cpp
View File

@ -206,7 +206,6 @@ InitConfig()
config->addOption('y', "yres", "SDL.YResolution", 0); config->addOption('y', "yres", "SDL.YResolution", 0);
config->addOption("SDL.LastXRes", 0); config->addOption("SDL.LastXRes", 0);
config->addOption("SDL.LastYRes", 0); config->addOption("SDL.LastYRes", 0);
config->addOption('b', "bpp", "SDL.BitsPerPixel", 32);
config->addOption("doublebuf", "SDL.DoubleBuffering", 1); config->addOption("doublebuf", "SDL.DoubleBuffering", 1);
config->addOption("autoscale", "SDL.AutoScale", 1); config->addOption("autoscale", "SDL.AutoScale", 1);
config->addOption("keepratio", "SDL.KeepRatio", 1); config->addOption("keepratio", "SDL.KeepRatio", 1);
@ -243,9 +242,6 @@ InitConfig()
config->addOption("autoInputPreset", "SDL.AutoInputPreset", 0); config->addOption("autoInputPreset", "SDL.AutoInputPreset", 0);
// allow for input configuration
//config->addOption('i', "inputcfg", "SDL.InputCfg", InputCfg);
// display input // display input
config->addOption("inputdisplay", "SDL.InputDisplay", 0); config->addOption("inputdisplay", "SDL.InputDisplay", 0);

15
src/drivers/Qt/fceuWrapper.cpp
View File

@ -387,7 +387,6 @@ static const char *DriverUsage =
"Option Value Description\n" "Option Value Description\n"
"--pal {0|1} Use PAL timing.\n" "--pal {0|1} Use PAL timing.\n"
"--newppu {0|1} Enable the new PPU core. (WARNING: May break savestates)\n" "--newppu {0|1} Enable the new PPU core. (WARNING: May break savestates)\n"
"--inputcfg d Configures input device d on startup.\n"
"--input(1,2) d Set which input device to emulate for input 1 or 2.\n" "--input(1,2) d Set which input device to emulate for input 1 or 2.\n"
" Devices: gamepad zapper powerpad.0 powerpad.1\n" " Devices: gamepad zapper powerpad.0 powerpad.1\n"
" arkanoid\n" " arkanoid\n"
@ -405,8 +404,6 @@ static const char *DriverUsage =
"--(x/y)scale x Multiply width/height by x. \n" "--(x/y)scale x Multiply width/height by x. \n"
" (Real numbers >0 with OpenGL, otherwise integers >0).\n" " (Real numbers >0 with OpenGL, otherwise integers >0).\n"
"--(x/y)stretch {0|1} Stretch to fill surface on x/y axis (OpenGL only).\n" "--(x/y)stretch {0|1} Stretch to fill surface on x/y axis (OpenGL only).\n"
"--bpp {8|16|32} Set bits per pixel.\n"
"--opengl {0|1} Enable OpenGL support.\n"
"--fullscreen {0|1} Enable full screen mode.\n" "--fullscreen {0|1} Enable full screen mode.\n"
"--noframe {0|1} Hide title bar and window decorations.\n" "--noframe {0|1} Hide title bar and window decorations.\n"
"--special {1-4} Use special video scaling filters\n" "--special {1-4} Use special video scaling filters\n"
@ -435,7 +432,6 @@ static const char *DriverUsage =
"--players x Set the number of local players in a network play\n" "--players x Set the number of local players in a network play\n"
" session.\n" " session.\n"
"--rp2mic {0|1} Replace Port 2 Start with microphone (Famicom).\n" "--rp2mic {0|1} Replace Port 2 Start with microphone (Famicom).\n"
"--nogui Don't load the GTK GUI\n"
"--4buttonexit {0|1} exit the emulator when A+B+Select+Start is pressed\n" "--4buttonexit {0|1} exit the emulator when A+B+Select+Start is pressed\n"
"--loadstate {0-9|>9} load from the given state when the game is loaded\n" "--loadstate {0-9|>9} load from the given state when the game is loaded\n"
"--savestate {0-9|>9} save to the given state when the game is closed\n" "--savestate {0-9|>9} save to the given state when the game is closed\n"
@ -548,16 +544,7 @@ int fceuWrapperInit( int argc, char *argv[] )
g_config->save(); g_config->save();
} }
// update the input devices
//g_config->getOption("SDL.InputCfg", &s);
//if (s.size() != 0)
//{
// InitVideo(GameInfo);
// InputCfg(s);
//}
// update the input devices
UpdateInput(g_config); UpdateInput(g_config);
// check for a .fcm file to convert to .fm2 // check for a .fcm file to convert to .fm2

126
src/drivers/Qt/input.cpp
View File

@ -469,58 +469,6 @@ std::string GetFilename (const char *title, bool save, const char *filter)
fname = GetOpenFileName (&ofn); fname = GetOpenFileName (&ofn);
#endif #endif
//#ifdef _GTK
// int fullscreen = 0;
// g_config->getOption ("SDL.Fullscreen", &fullscreen);
// if (fullscreen)
// ToggleFS ();
//
// GtkWidget *fileChooser;
//
// GtkFileFilter *filterX;
// GtkFileFilter *filterAll;
//
// filterX = gtk_file_filter_new ();
// gtk_file_filter_add_pattern (filterX, filter);
// gtk_file_filter_set_name (filterX, filter);
//
//
// filterAll = gtk_file_filter_new ();
// gtk_file_filter_add_pattern (filterAll, "*");
// gtk_file_filter_set_name (filterAll, "All Files");
//
// if (save)
// fileChooser = gtk_file_chooser_dialog_new ("Save as", NULL,
// GTK_FILE_CHOOSER_ACTION_SAVE,
// "_Cancel",
// GTK_RESPONSE_CANCEL,
// "_Save",
// GTK_RESPONSE_ACCEPT, NULL);
// else
// fileChooser = gtk_file_chooser_dialog_new ("Open", NULL,
// GTK_FILE_CHOOSER_ACTION_OPEN,
// "_Cancel",
// GTK_RESPONSE_CANCEL,
// "_Open",
// GTK_RESPONSE_ACCEPT, NULL);
//
// // TODO: make file filters case insensitive
// //gtk_file_chooser_add_filter(GTK_FILE_CHOOSER(fileChooser), filterX);
// gtk_file_chooser_add_filter (GTK_FILE_CHOOSER (fileChooser), filterAll);
// int response = gtk_dialog_run (GTK_DIALOG (fileChooser));
//
// // flush gtk events
// while (gtk_events_pending ())
// gtk_main_iteration_do (TRUE);
//
// if (response == GTK_RESPONSE_ACCEPT)
// fname = gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (fileChooser));
//
// gtk_widget_destroy (fileChooser);
//
// while (gtk_events_pending ())
// gtk_main_iteration_do (TRUE);
//#endif
FCEUI_ToggleEmulationPause (); FCEUI_ToggleEmulationPause ();
return fname; return fname;
} }
@ -530,71 +478,6 @@ std::string GetFilename (const char *title, bool save, const char *filter)
*/ */
std::string GetUserText (const char *title) std::string GetUserText (const char *title)
{ {
#ifdef _GTK
/* prg318 - 10/13/11 - this is broken in recent build and causes
* segfaults/very weird behavior i'd rather remove it for now than it cause
* accidental segfaults
* TODO fix it
*/
#if 0
//
// GtkWidget* d;
// GtkWidget* entry;
//
// d = gtk_dialog_new_with_buttons(title, NULL, GTK_DIALOG_MODAL, GTK_STOCK_OK, GTK_RESPONSE_OK);
//
// entry = gtk_entry_new();
//
// GtkWidget* vbox = gtk_dialog_get_content_area(GTK_DIALOG(d));
//
// gtk_container_add(GTK_CONTAINER(vbox), entry);
//
// gtk_widget_show_all(d);
//
// gtk_dialog_run(GTK_DIALOG(d));
//
// // flush gtk events
// while(gtk_events_pending())
// gtk_main_iteration_do(TRUE);
//
// std::string input = gtk_entry_get_text(GTK_ENTRY(entry));
//
// if (FCEUI_EmulationPaused() == 0)
// FCEUI_ToggleEmulationPause(); // pause emulation
//
// int fullscreen = 0;
// g_config->getOption("SDL.Fullscreen", &fullscreen);
// if(fullscreen)
// ToggleFS(); // disable fullscreen emulation
//
// FILE *fpipe;
// std::string command = "zenity --entry --title=\"";
// command.append(title);
// command.append("\" --text=\"");
// command.append(title);
// command.append(":\"");
//
// if (!(fpipe = (FILE*)popen(command.c_str(),"r"))) // If fpipe is NULL
// FCEUD_PrintError("Pipe error on opening zenity");
// int c;
// std::string input;
// while((c = fgetc(fpipe)))
// {
// if (c == EOF || c == '\n')
// break;
// input += c;
// }
// pclose(fpipe);
// gtk_widget_destroy(d);
//
//
// while(gtk_events_pending())
// gtk_main_iteration_do(TRUE);
//
// FCEUI_ToggleEmulationPause(); // unpause emulation
// return input;
#endif // #if 0
#endif
return ""; return "";
} }
@ -926,9 +809,6 @@ static void KeyboardCommands (void)
{ {
if ( Hotkeys[HK_SELECT_STATE_0 + i].getRisingEdge() ) if ( Hotkeys[HK_SELECT_STATE_0 + i].getRisingEdge() )
{ {
#ifdef _GTK
setStateMenuItem(i);
#endif
FCEUI_SelectState (i, 1); FCEUI_SelectState (i, 1);
} }
} }
@ -936,17 +816,11 @@ static void KeyboardCommands (void)
if ( Hotkeys[HK_SELECT_STATE_NEXT].getRisingEdge() ) if ( Hotkeys[HK_SELECT_STATE_NEXT].getRisingEdge() )
{ {
FCEUI_SelectStateNext (1); FCEUI_SelectStateNext (1);
#ifdef _GTK
setStateMenuItem( CurrentState );
#endif
} }
if ( Hotkeys[HK_SELECT_STATE_PREV].getRisingEdge() ) if ( Hotkeys[HK_SELECT_STATE_PREV].getRisingEdge() )
{ {
FCEUI_SelectStateNext (-1); FCEUI_SelectStateNext (-1);
#ifdef _GTK
setStateMenuItem( CurrentState );
#endif
} }
if ( Hotkeys[HK_BIND_STATE].getRisingEdge() ) if ( Hotkeys[HK_BIND_STATE].getRisingEdge() )

1
src/drivers/Qt/input.h
View File

@ -74,7 +74,6 @@ int DTestButtonJoy(ButtConfig *bc);
void FCEUD_UpdateInput(void); void FCEUD_UpdateInput(void);
void UpdateInput(Config *config); void UpdateInput(Config *config);
//void InputCfg(const std::string &);
std::string GetUserText(const char* title); std::string GetUserText(const char* title);
const char* ButtonName(const ButtConfig* bc); const char* ButtonName(const ButtConfig* bc);

6
src/drivers/Qt/sdl-video.cpp
View File

@ -58,9 +58,6 @@ static int s_srendline, s_erendline;
static int s_tlines; static int s_tlines;
static int s_inited = 0; static int s_inited = 0;
//#ifdef OPENGL
//static int s_useOpenGL = 0;
//#endif
static double s_exs = 1.0, s_eys = 1.0; static double s_exs = 1.0, s_eys = 1.0;
static int s_eefx = 0; static int s_eefx = 0;
static int s_clipSides = 0; static int s_clipSides = 0;
@ -152,9 +149,6 @@ int InitVideo(FCEUGI *gi)
// load the relevant configuration variables // load the relevant configuration variables
g_config->getOption("SDL.Fullscreen", &s_fullscreen); g_config->getOption("SDL.Fullscreen", &s_fullscreen);
g_config->getOption("SDL.DoubleBuffering", &doublebuf); g_config->getOption("SDL.DoubleBuffering", &doublebuf);
//#ifdef OPENGL
// g_config->getOption("SDL.OpenGL", &s_useOpenGL);
//#endif
g_config->getOption("SDL.SpecialFilter", &s_sponge); g_config->getOption("SDL.SpecialFilter", &s_sponge);
g_config->getOption("SDL.XStretch", &xstretch); g_config->getOption("SDL.XStretch", &xstretch);
g_config->getOption("SDL.YStretch", &ystretch); g_config->getOption("SDL.YStretch", &ystretch);

6
src/drivers/common/SConscript
View File

@ -1,6 +0,0 @@
import glob
source_list = glob.glob('*.cpp') + glob.glob('*.c')
for x in range(len(source_list)):
source_list[x] = 'drivers/common/' + source_list[x]
Return('source_list')

31
src/drivers/sdl/SConscript
View File

@ -1,31 +0,0 @@
# Fix compliation error about 'XKeysymToString' by linking X11 explicitly
# Thanks Antonio Ospite!
Import('env')
config_string = 'pkg-config --cflags --libs x11'
env.ParseConfig(config_string)
Export('env')
source_list = Split(
"""
input.cpp
cheat.cpp
config.cpp
memview.cpp
ramwatch.cpp
debugger.cpp
glxwin.cpp
sdl.cpp
sdl-joystick.cpp
sdl-sound.cpp
sdl-throttle.cpp
sdl-video.cpp
unix-netplay.cpp
""")
Import('env')
if env['GTK'] or env['GTK3']:
source_list.append('gui.cpp')
source_list = ['drivers/sdl/' + source for source in source_list]
Return('source_list')

14
src/drivers/videolog/SConscript
View File

@ -1,14 +0,0 @@
my_list = Split("""
nesvideos-piece.cpp
rgbtorgb.cpp
""")
Import('env')
if env['LOGO']:
env.Append(CCFLAGS = "-DHAVE_GD")
for x in range(len(my_list)):
my_list[x] = 'drivers/videolog/' + my_list[x]
Return('my_list')

62
src/drivers/win/SConscript
View File

@ -1,62 +0,0 @@
Import('env')
my_list = Split("""
archive.cpp
args.cpp
aviout.cpp
cdlogger.cpp
cheat.cpp
common.cpp
config.cpp
debugger.cpp
debuggersp.cpp
directories.cpp
gui.cpp
guiconfig.cpp
help.cpp
input.cpp
joystick.cpp
keyboard.cpp
log.cpp
main.cpp
mapinput.cpp
memview.cpp
memviewsp.cpp
memwatch.cpp
monitor.cpp
netplay.cpp
ntview.cpp
OutputDS.cpp
palette.cpp
ppuview.cpp
pref.cpp
replay.cpp
sound.cpp
state.cpp
tasedit.cpp
texthook.cpp
throttle.cpp
timing.cpp
tracer.cpp
video.cpp
wave.cpp
Win32InputBox.cpp
window.cpp
""")
# TODO this is probably .obj if built on a Windows system...
my_list.append('res.o')
env.Command('res.o', 'res.rc', env['WINDRES'] + ' -Isrc/drivers/win -DLVS_OWNERDATA=0x1000 -o $TARGET $SOURCE')
subdirs = Split("""
directx
zlib""")
for x in range(len(my_list)):
my_list[x] = 'drivers/win/' + my_list[x]
for dir in subdirs:
subdir_files = SConscript('%s/SConscript' % dir)
my_list.append(subdir_files)
Return('my_list')

10
src/drivers/win/directx/SConscript
View File

@ -1,10 +0,0 @@
my_list = Split("""
dsound.lib
dxguid.lib
ddraw.lib
dinput.lib
""")
for x in range(len(my_list)):
my_list[x] = 'drivers/win/directx/' + my_list[x]
Return('my_list')

20
src/drivers/win/zlib/SConscript
View File

@ -1,20 +0,0 @@
my_list = Split("""
adler32.c
compress.c
crc32.c
deflate.c
gzio.c
infblock.c
infcodes.c
inffast.c
inflate.c
inftrees.c
infutil.c
trees.c
uncompr.c
zutil.c
""")
for x in range(len(my_list)):
my_list[x] = 'drivers/win/zlib/' + my_list[x]
Return('my_list')

6
src/fir/SConscript
View File

@ -1,6 +0,0 @@
my_list = Split("""
""")
for x in range(len(my_list)):
my_list[x] = 'fir/' + my_list[x]
Return('my_list')

6
src/input/SConscript
View File

@ -1,6 +0,0 @@
import glob
source_list = glob.glob('*.cpp')
for x in range(len(source_list)):
source_list[x] = 'input/' + source_list[x]
Return('source_list')

8
src/lua/SConscript
View File

@ -1,8 +0,0 @@
import glob
source_list = glob.glob('src/*.c')
source_list.remove('src/lua.c')
source_list.remove('src/luac.c')
for x in range(len(source_list)):
source_list[x] = 'lua/' + source_list[x]
Return('source_list')

6
src/palettes/SConscript
View File

@ -1,6 +0,0 @@
import glob
source_list = glob.glob('*.c')
for x in range(len(source_list)):
source_list[x] = 'palettes/' + source_list[x]
Return('source_list')

25
src/utils/SConscript
View File

@ -1,25 +0,0 @@
import glob
#source_list = glob.glob('*.cpp')
source_list = Split(
"""
backward.cpp
ConvertUTF.c
xstring.cpp
crc32.cpp
endian.cpp
general.cpp
guid.cpp
md5.cpp
memory.cpp
""")
Import('env')
if env['SYSTEM_MINIZIP'] == 0:
source_list.append('unzip.cpp')
source_list.append('ioapi.cpp')
for x in range(len(source_list)):
source_list[x] = 'utils/' + source_list[x]
Return('source_list')

2
src/version.h
View File

@ -61,7 +61,7 @@
#endif #endif
#define FCEU_VERSION_NUMERIC 22020 #define FCEU_VERSION_NUMERIC 22020
#define FCEU_VERSION_STRING "2.2.3" FCEU_SUBVERSION_STRING FCEU_FEATURE_STRING FCEU_COMPILER #define FCEU_VERSION_STRING "2.3.0" FCEU_SUBVERSION_STRING FCEU_FEATURE_STRING FCEU_COMPILER
#define FCEU_NAME_AND_VERSION FCEU_NAME " " FCEU_VERSION_STRING #define FCEU_NAME_AND_VERSION FCEU_NAME " " FCEU_VERSION_STRING
#endif #endif

4
web/download.html
View File

@ -77,8 +77,8 @@
<ul> <ul>
<li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux.zip?branch=master&job=Windows%2032">Windows 32-bit</a></li> <li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux.zip?branch=master&job=Windows%2032">Windows 32-bit</a></li>
<li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux64.zip?branch=master&job=Windows%2064">Windows 64-bit</a></li> <li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux64.zip?branch=master&job=Windows%2064">Windows 64-bit</a></li>
<li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.2.3-amd64.deb?branch=master&job=Ubuntu">Ubuntu Linux</a></li> <li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.3.0-amd64.deb?branch=master&job=Ubuntu">Ubuntu Linux</a></li>
<li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.2.3-Darwin.dmg?branch=master&job=MacOS">Mac OS X</a></li> <li><a href="https://ci.appveyor.com/api/projects/zeromus/fceux/artifacts/fceux-2.3.0-Darwin.dmg?branch=master&job=MacOS">Mac OS X</a></li>
</ul> </ul>
<h3>Source Code</h3> <h3>Source Code</h3>

33
web/fceux-sdl-docs.html
View File

@ -23,7 +23,7 @@
<div id="page_content"> <div id="page_content">
<center><h1>FCEUX SDL Documentation</h1></center> <center><h1>FCEUX SDL Documentation</h1></center>
<center><i>Last updated October 11, 2011<br />Valid as of FCEUX 2.1.5</i><br></center> <center><i>Last updated December 9, 2020<br />Valid as of FCEUX 2.3.0</i><br></center>
<p> <p>
<b>Table of Contents:</b> <b>Table of Contents:</b>
<ul> <ul>
@ -36,6 +36,7 @@
<li /><a href="#features-ips">Automatic IPS Patching</a> <li /><a href="#features-ips">Automatic IPS Patching</a>
<li /><a href="#using">Using FCEUX</a> <li /><a href="#using">Using FCEUX</a>
<ul> <ul>
<li /><a href="#gui-styling">Qt GUI Style</a>
<li /><a href="#using-hotkeys">Hotkey Assignments</a> <li /><a href="#using-hotkeys">Hotkey Assignments</a>
<ul> <ul>
<li /><a href="#using-keys-vs">VS Unisystem</a> <li /><a href="#using-keys-vs">VS Unisystem</a>
@ -185,13 +186,25 @@ necessarily 100% accurate or complete):
<a name="using"><h2>Using FCEUX</h2></a> <a name="using"><h2>Using FCEUX</h2></a>
<p> <p>
</p>
<a name="gui-styling"><h3>Qt GUI Style</h3></a>
<p>
The Qt GUI can either use the standard system style/themes or custom stylesheets.
The available standard styles that are installed on the system will be listed when running the executable command line help.
To use a provided system style, use the --style command line argument.
To use a custom Qt stylesheet file, set an environment variable named FCEUX_QT_STYLESHEET that contains
the full path to the file. This will check for this at startup.
If the variable is defined and the file is readable by the program,
then the styling settings will be used by the GUI.<br>
<br>Bash Shell Setup Example:
<pre>
export FCEUX_QT_STYLESHEET=/home/me/myFceux.qss
</pre>
For information on Qt stylesheet syntax, see <a href=https://doc.qt.io/>Qt online documentation</a>
</p> </p>
<a name="using-hotkeys"><h3>Hotkey Assignments</h3></a> <a name="using-hotkeys"><h3>Hotkey Assignments</h3></a>
<p> <p>
<b>NOTE:</b>There is not a GUI available to remap these hotkeys for SDL. If you really <b>NOTE:</b> The GUI has a window to remap these hotkeys for SDL.
want to remap the hotkeys, you can edit the config file manually and replace the values
with SDL keysyms. Alternatively, you can use a tool like <a href="http://qjoypad.sourceforge.net/">qjoypad</a>
or <a href="http://joy2key.sourceforge.net/">joy2key</a> and even map hotkeys to joystick buttons/axes.
<p> <p>
<table border> <table border>
<tr><th>Key:</th><th>Action:</th></tr> <tr><th>Key:</th><th>Action:</th></tr>
@ -242,7 +255,7 @@ necessarily 100% accurate or complete):
</p> </p>
<a name="using-keys-gamepad"><h4>Gamepad</h4></a> <a name="using-keys-gamepad"><h4>Gamepad</h4></a>
<p> These are the default keys for the P1 gamepad. These can <p> These are the default keys for the P1 gamepad. These can
be remapped using the --inputcfg command line parameter or the GTK GUI be remapped the Qt GUI
<table border> <table border>
<tr><th>Key:</th><th nowrap>Button on Emulated Gamepad:</th></tr> <tr><th>Key:</th><th nowrap>Button on Emulated Gamepad:</th></tr>
<tr><td>D</td><td>B</td></tr> <tr><td>D</td><td>B</td></tr>
@ -292,8 +305,10 @@ necessarily 100% accurate or complete):
are taken in the form of "--parameter value". Most arguments that have are taken in the form of "--parameter value". Most arguments that have
both a parameter and a value will be saved in the configuration file. both a parameter and a value will be saved in the configuration file.
</p> </p>
<b>NOTE: </b>This list is incomplete! For a full list of options, run <b>NOTE: </b>This list is incomplete! For a full list of options, run:
fceux without any arguments. <pre>
fceux --help
</pre>
<p> <p>
<table border> <table border>
<tr><th>Argument:</th><th>Value Type:</th><th>Default value:</th><th>Description:</th></tr> <tr><th>Argument:</th><th>Value Type:</th><th>Default value:</th><th>Description:</th></tr>
@ -321,6 +336,8 @@ necessarily 100% accurate or complete):
<tr><td>Unknown</td><td>Original Author</td></tr> <tr><td>Unknown</td><td>Original Author</td></tr>
<tr><td><a href="mailto:ltsmooth42 _at_ gmail _dot_ com">Lukas Sabota</a></td> <tr><td><a href="mailto:ltsmooth42 _at_ gmail _dot_ com">Lukas Sabota</a></td>
<td>FCEUX SDL documentation revival.</td></tr> <td>FCEUX SDL documentation revival.</td></tr>
<tr><td>mjbudd77</td>
<td>FCEUX Qt/SDL documentation upates.</td></tr>
</table> </table>
</p> </p>
</div> </div>

41
web/fceux-sdl-faq.html
View File

@ -23,31 +23,26 @@
<div id="page_content"> <div id="page_content">
<center><h1>FCEUX SDL FAQ</h1></center> <center><h1>FCEUX SDL FAQ</h1></center>
<center><i>Last updated February 10, 2012<br /></i> by punkrockguy318<br /> <center><i>Last updated December 9, 2020<br /></i> by mjbudd77<br />
</center> </center>
<p><b>Table of Contents:</b></p> <p><b>Table of Contents:</b></p>
<ul> <ul>
<li><a href="#svn">What is the subversion build and how can I get it?</a></li> <li><a href="#git">What is the git build and how can I get it?</a></li>
<li><a href="#config">How do I configure a gamepad?</a></li> <li><a href="#config">How do I configure a gamepad?</a></li>
<li><a href="#sound">My sound is stuttery/laggy. How can I fix this?</a></li> <li><a href="#sound">My sound is stuttery/laggy. How can I fix this?</a></li>
<li><a href="#timing">My game is skipping frames. How can I fix this?</a></li>
<li><a href="#hotkeys1">How can I change my hotkey bindings?</a></li> <li><a href="#hotkeys1">How can I change my hotkey bindings?</a></li>
<li><a href="#hotkeys2">Can I map hotkeys to my gamepad?</a></li> <li><a href="#hotkeys2">Can I map hotkeys to my gamepad?</a></li>
</ul> </ul>
<a name="subversion"><h3>What is the subversion build and how can I get it?</h3></a> <a name="git"><h3>What is the git build and how can I get it?</h3></a>
<p>The most recent changes to fceuX are reflected immediately in the fceux <p>The most recent changes to fceuX are reflected immediately in the fceux
sourceforge subversion server. You can checkout the source code to build github server. You can checkout the source code to build
fceuX with the most recent sources by running the following command:</p> fceuX with the most recent sources by running the following command:</p>
<p><b>svn co https://fceultra.svn.sourceforge.net/svnroot/fceultra/fceu fceux</b></p> <p><b>git clone https://github.com/TASVideos/fceux.git</b></p>
<p>Instructions for compiling and installing fceuX can be found in the "README-SDL" file.</p> <p>Instructions for compiling and installing fceuX can be found in the "README" file.</p>
<a name="config"><h3>How do I configure a gamepad?</h3></a> <a name="config"><h3>How do I configure a gamepad?</h3></a>
<p> <p>Using the Qt GUI, you can configure the gamepad by
<p>If you have the GTK GUI compiled into fceuX, you can configure the gamepad by
selecting "Options...Gamepad" in the menubar.</p> selecting "Options...Gamepad" in the menubar.</p>
<p>You can allso configure the first gamepad by running <b>fceux --inputcfg gamepad1</b> </p>
<p>When you configure a button you will be presented with a black window with a titlebar
indicating what button to map. FceuX will look for two
of the same keypress/joystick event in a row. If it doesn't find two of the same
keypresses in a row, it will allow you to map the button to two separate keys.</p>
</p> </p>
<a name="sound"><h3>My sound is stuttery/laggy. How can I fix this?</h3></a> <a name="sound"><h3>My sound is stuttery/laggy. How can I fix this?</h3></a>
<p>Try using different SDL audio drivers. You can set the SDL audio driver with <p>Try using different SDL audio drivers. You can set the SDL audio driver with
@ -58,11 +53,21 @@
you may want to try the latest version of fceuX to see if you are still having issues. FceuX you may want to try the latest version of fceuX to see if you are still having issues. FceuX
2.1.4 fixed the majority of the reported sound issues. 2.1.4 fixed the majority of the reported sound issues.
</p> </p>
<a name="timing"><h3>My game is skipping frames. How can I improve this?</h3></a>
<p>The Qt/SDL version of fceux runs two threads. One for the GUI and one for the emulation.
The realtime OS scheduling and priority of both of these threads can be tuned via the GUI
timing config options window (accessible via the menu bar). For Mac OSX systems, fceux must
have root permission to increase process priority. For Linux systems, add the following
lines to the <b>/etc/security/limits.conf</b> file to ensure that fceux users have the proper system
resource permissions (requires reboot after editing for changes to take place):
<pre>
* - priority 99
* - rtprio 99
* - nice -20
</pre>
</p>
<a name="hotkeys1"><h3>How can I change my emulator hotkey bindings?</h3></a> <a name="hotkeys1"><h3>How can I change my emulator hotkey bindings?</h3></a>
<p>You need to edit your ~/.fceux/fceux.cfg file. The SDL.Hotkeys.* values <p>SDL hotkey bindings can be remapped using the Qt GUI. Selecting "Options...HotKeys" in the menubar.
are SDL keysyms, which can be found in SDL_keysym.h (probably
/usr/include/SDL/SDL_keysym.h on your system). At the time of writing,
hotkeys are not mappable from the GUI in sdl (although it is planned for the future).
</p> </p>
<a name="hotkeys2"><h3>Can I map emulator hotkeys to my gamepad?</h3></a> <a name="hotkeys2"><h3>Can I map emulator hotkeys to my gamepad?</h3></a>
<p>If you want to map particular hotkeys (pause, save state, load state, etc) to buttons on <p>If you want to map particular hotkeys (pause, save state, load state, etc) to buttons on
@ -77,6 +82,8 @@
<tr><th>Name:</th><th>Contribution(s):</th></tr> <tr><th>Name:</th><th>Contribution(s):</th></tr>
<tr><td><a href="mailto:ltsmooth42 _at_ gmail _dot_ com">Lukas Sabota</a></td> <tr><td><a href="mailto:ltsmooth42 _at_ gmail _dot_ com">Lukas Sabota</a></td>
<td>Author of this document</td></tr> <td>Author of this document</td></tr>
<tr><td>mjbudd77</td>
<td>Qt/SDL Updates</td></tr>
</table> </table>
</p> </p>
</div> </div>