TwinPad is an input plugin for PSX (PSEmu Pro compliant plugin API) and a PCSX2 emulators. Based on the original work of Linuzappz and asadr back in 2004. It has GPLv2 or v3 license as the original plugin. Currently it supports only Windows platform from Windows XP to Windows 10. For now it supports Keyboard and Mouse using DirectInput 8.
The plugin features a unique function to record macros and replay them when needed. I call this feature Combo, please see the official PCSX2 forum page for details on usage here
TwinPad uses wxWidgets library, and it uses the latest development build of wxWidgets v3.1.0, You must use a version of wxWidgets starting from this commit 35f35ea (or 64e14e8 if you are using wxWidgets without precompiled headers). That first commit contains a fix to wxToolTip behavior under Windows, and it is crucial for TwinPad to work correctly.
Note: For more details about wxToolTip bug that was fixed at the aforementioned commit, click here.
Before you compile wxWidgets library, there are some modifications need to be done beforehand.
Now we need to setup wxWidgets and tell Visual Studio how to compile it:
- Open
setup.hfrom_custom_buildproject underSetup Headersand change the definedwxUSE_COMPILER_TLSvalue from 1 to 2. - Select and highlight all projects from Solution Explorer and click properties. Choose
Debugconfiguration and change the platform toolset to use Visual Studio 2015 - Windows XP (v140_XP). Click apply then change the configuration toReleaseand do the same. Then click OK. - Select and highlight all projects except for
_custom_build, right-click then properties. Go toC/C++section and chooseCommand Lineand under Additional Options, put/Zc:threadSafeInit-for both Debug and Release configurations. Note: This compiler option is also included in TwinPad project in the Common property sheet. - Build the Solution once for Debug, and another for Release.
Note: This compiler keyword was introduced in Visual Studio 2014 CTP to fix the buggy and remaining TLS issues in Windows XP, since it is out of support, it can't be fixed. Newer versions of Windows (Vista +) don't have these issues. For more information see this bug report, or here for the same issue but with code.
Note: If you are using Visual Studio 2013, there is no need for this. Except you might have to change the platform toolset to use Visual Studio 2013 - Windows XP (v120_XP) instead. For both TwinPad and wxWidgets. This is necessary to make TwinPad work under Windows XP! The plugin will throw Access Denied with error 998 for inaccessible memory location. wxWidgets have an issue with Thread Local Storage (TLS) when the library is used in a DLL (Dynamic Link Library) as you might have read in the
setup.hfile when changing wxUSE_COMPILER_TLS value. See this bug ticket. They fixed it for earlier versions of Visual Studio (v11) and when using Windows SDK v7.1, but it remains for newer Visual Studio v14 (2015) and newer Windows SDK v8.1
Note 2: If you are using wxWidgets development build downloaded via github terminal window, you might not have
setup.hfile. You have to copysetup0.hand paste then rename it tosetup.h. The file is found in\wxWidgets\include\wx\mswFor more information, read theinstall.txtfile included in wxWidgets for Microsoft Windows (MSW).
One last thing, almost done. You need to set Environment Variable for Windows so that Visual Studio can see wxWidgets directory using $(WXWIN) variable. By doing this, it makes wxWidgets installation portable to other computers or even yours if you decided to change the directory of wxWidgets, and you don't have to modify your project files to accommodate.
- Right click My Computer/This PC and select properties, or go to Control Panel and run System tool from there.
- Select Advanced System Options and then Environmental Variables.
- Under System Variables, create a new one and choose
WXWINfor the Variable Name and its Value the directory which wxWidgets is installed in (e.g,D:\wxWidgets). - Depending on the version of Windows, you might have to Log off or Restart the computer for the Environment Variable to be read by Visual Studio.
Copyright (C) 2002-2004 PADwin Team Copyright (C) 2006-2016 Rebel_X
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.