Ticket #163: mythtv-HOWTO-15.html.diff

File mythtv-HOWTO-15.html.diff, 9.7 KB (added by harywilke@…, 19 years ago)

mythtv-HOWTO-15.html diff file

  • docs/mythtv-HOWTO-15.html

     
    1515<H2><A NAME="s15">15.</A> <A HREF="mythtv-HOWTO.html#toc15">MythGame.</A></H2>
    1616
    1717<P>
    18 <A HREF="http://www.mameworld.net/">http://www.mameworld.net/</A> is
     18<B>MythGame</B> can used as a frontend to start any emulator that your host OS runs. This is an example of how to set up <B>xmame</B> on Linux. <A HREF="http://www.mameworld.net/">http://www.mameworld.net/</A> is
    1919an excellent resource for all things mame.</P>
    2020<P>Installation overview:
    2121<OL>
    22 <LI>Setup directory structure</LI>
    23 <LI>Download and install xmame</LI>
    24 <LI>Download and place files (artwork/catver.ini/etc..)</LI>
    25 <LI>Download and install mythgame plugin</LI>
    26 <LI>Setup mythgame from inside mythfrontend</LI>
    27 <LI>Hints: No joystick solution</LI>
     22<LI><A HREF="mythtv-HOWTO-15.html#ss15.1">Setup Directory Structure</A></LI>
     23<LI><A HREF="mythtv-HOWTO-15.html#ss15.2">Download and Install xmame</A></LI>
     24<LI><A HREF="mythtv-HOWTO-15.html#ss15.3">Download Extra Files (artwork/catver.ini/etc..)</A></LI>
     25<LI><A HREF="mythtv-HOWTO-15.html#ss15.4">Download and Install MythGame.</A></LI>
     26<LI><A HREF="mythtv-HOWTO-15.html#ss15.5">Setup xmame In MythGame</A></LI>
     27<LI><A HREF="mythtv-HOWTO-15.html#ss15.6">Hints:</A></LI>
    2828</OL>
    2929</P>
    3030<H2><A NAME="ss15.1">15.1</A> <A HREF="mythtv-HOWTO.html#toc15.1">Setup Directory Structure</A>
    … …  
    5454</PRE>
    5555</CODE></BLOCKQUOTE>
    5656</P>
    57 <P>Edit the Makefile with your favorite editor.  Adjust the options as required for your system.
     57<P>Edit the Makefile with your favorite editor.  Adjust the options as required for your system.</P>
     58<P>
    5859<BLOCKQUOTE><CODE>
    5960<PRE>
    6061$ joe Makefile
    6162</PRE>
    6263</CODE></BLOCKQUOTE>
    6364</P>
    64 <P>Then make and install xmame
     65<P>Then make and install xmame</P>
     66<P>
    6567<BLOCKQUOTE><CODE>
    6668<PRE>
    6769$ make
    … …  
    7274</PRE>
    7375</CODE></BLOCKQUOTE>
    7476</P>
    75 <P>After <B>mame</B> has been installed, we need to create some defaults.
     77<P>After <B>mame</B> has been installed, we need to create some defaults.</P>
     78<P>
    7679<BLOCKQUOTE><CODE>
    7780<PRE>
    7881$ mkdir ~/.xmame
    … …  
    8285</P>
    8386<P>Because some ROMS work better with different display toolkits, or possibly
    8487even older versions of xmame, it's convenient to keep all of your
    85 <B>xmame</B> binaries and to rename them to include the version number,
    86 then make a symbolic link to "xmame". If you want to test a different
    87 version of <B>xmame</B> at some point you only need to switch this link.</P>
     88<B>xmame</B> binaries and to rename them to include the version number. MythGame allows you to match individual roms to preferred binaries.</P>
    8889<P>
    8990<BLOCKQUOTE><CODE>
    9091<PRE>
    9192$ su
    9293(enter password)
    9394# mv /usr/local/bin/xmame.x11 /usr/local/bin/xmame-0.97.x11
    94 # ln -s /usr/local/bin/xmame-0.97.x11 /usr/local/bin/xmame
    9595# exit
     96
    9697</PRE>
    9798</CODE></BLOCKQUOTE>
    9899</P>
    … …  
    101102display toolkit you used. Also, you may need to remove and recreate
    102103<CODE>xmamerc</CODE> after upgrading since some of the default options may have
    103104changed.</P>
     105
     106<P>Edit <CODE>~/.xmame/xmamerc</CODE> to include your paths</P>
     107
     108<P>
     109<BLOCKQUOTE><CODE>
     110<PRE>
     111### Fileio Related ###
     112rompath                         /usr/local/share/xmame/roms
     113snapshot_directory              /usr/local/share/xmame/snaps
     114cheat_file                      /usr/local/share/xmame/cheat.dat
     115hiscore_file                    /usr/local/share/xmame/hiscore.dat
     116hiscore_directory               /usr/local/share/xmame/hiscore
     117history_file                    /usr/local/share/xmame/history.dat
     118maminfo_file                    /usr/local/share/xmame/mameinfo.dat
     119</PRE>
     120</CODE></BLOCKQUOTE>
     121</P>
     122
     123
    104124<P>Confirm that <B>xmame</B> works before running it inside MythTV. Place
    105125your ROM in the <CODE>/usr/local/share/xmame/roms</CODE> directory you created
    106126earlier.</P>
    107127<P><B>NOTE</B>: There are three public domain ROM sets available at
    108128<A HREF="http://www.mame.net/downmisc.html">http://www.mame.net/downmisc.html</A></P>
    109 <P>Launch <B>xmame</B> with your game of choice.  In this example, we are using Gauntlet.
     129<P>Launch <B>xmame</B> with your game of choice.  In this example, we are using Gauntlet.</P>
     130<P>
    110131<BLOCKQUOTE><CODE>
    111132<PRE>
    112 $ xmame gauntlet
     133$ xmame-0.97.x11 gauntlet
    113134</PRE>
    114135</CODE></BLOCKQUOTE>
    115136</P>
    116 <P>Some basic <B>mame</B> keyboard commands:
     137<P>Some basic <B>mame</B> keyboard commands:</P>
     138<P>
    117139<BLOCKQUOTE><CODE>
    118140<PRE>
    1191415 = Insert coin
    … …  
    143165<P>- Screenshots aka "snaps"</P>
    144166<P>These may be downloaded from
    145167<A HREF="http://www.classicgaming.com/mame32qa/">http://www.classicgaming.com/mame32qa/</A></P>
    146 <P>Screenshots are displayed when you are browsing your ROMS in <B>mythgame</B>.
     168<P>Screenshots are displayed when you are browsing your ROMS in <B>MythGame</B>.
    147169Unzip and place them in <CODE>/usr/local/share/xmame/snaps</CODE></P>
    148170<P>- <CODE>history.dat</CODE></P>
    149171<P>Download from
    … …  
    156178<P>Download from
    157179<A HREF="http://cheat.retrogames.com/">http://cheat.retrogames.com/</A></P>
    158180
    159 <H2><A NAME="ss15.4">15.4</A> <A HREF="mythtv-HOWTO.html#toc15.4">Download and Install Mythgame.</A>
     181<H2><A NAME="ss15.4">15.4</A> <A HREF="mythtv-HOWTO.html#toc15.4">Download and Install MythGame.</A>
    160182</H2>
    161183
    162 <P><B>mythgame</B> is part of the mythplugins package.  See the instructions
     184<P><B>MythGame</B> is part of the mythplugins package.  See the instructions
    163185in the
    164186<A HREF="mythtv-HOWTO-5.html#DownloadAndCompile">Downloading and Compiling</A>
    165187section to obtain mythplugins.</P>
    166 <P>Switch to the mythplugins directory:
     188<P>Switch to the mythplugins directory:</P>
     189<P>
    167190<BLOCKQUOTE><CODE>
    168191<PRE>
    169192$ cd ~/mythplugins-0.18.1
    170193</PRE>
    171194</CODE></BLOCKQUOTE>
    172195</P>
    173 <P>Compile and install mythgame:
     196<P>Compile and install MythGame:</P>
     197<P>
    174198<BLOCKQUOTE><CODE>
    175199<PRE>
    176200$ ./configure --disable-all --enable-mythgame
    … …  
    184208</CODE></BLOCKQUOTE>
    185209</P>
    186210
    187 <H2><A NAME="ss15.5">15.5</A> <A HREF="mythtv-HOWTO.html#toc15.5">Setup mythgame</A>
     211<H2><A NAME="ss15.5">15.5</A> <A HREF="mythtv-HOWTO.html#toc15.5">Setup xmame in MythGame</A>
    188212</H2>
    189213
    190214<P>Start <B>mythfrontend</B> and navigate to Utilities/Setup>Setup>Media
    191 Settings>Game Settings>General Settings</P>
    192 <P>On page one you can setup the display order of your games, on page 2 and 3
    193 you need to enter the paths to files and directories that xmame uses.</P>
     215Settings>Game Settings>Game Players. Select <CODE>(New Game Player)</CODE>.</P>
    194216<P>
    195 <BLOCKQUOTE><CODE>
    196 <PRE>
    197 MAME binary location:  /usr/local/bin/xmame               (path to xmame binary)
    198 MAME ROM location:     /usr/local/share/xmame/roms        (where you store all your roms)
    199 catver.ini file:       /usr/local/share/xmame/catver.ini  (Category and Version information for your ROMs)
    200 MAME screenshots path: /usr/local/share/xmame/snaps       (screenshots of ROMs in play)
    201 MAME hiscores path:    /usr/local/share/xmame/hiscore     (directory for mame to create hiscore.hi files)
    202 MAME hiscores file:    /usr/local/share/xmame/hiscore.dat (file that tells mame how to store hiscores)
    203 MAME flyers path:      /usr/local/share/xmame/flyers      (not used with mythgame)
    204 MAME cabinets path:    /usr/local/share/xmame/cabinets    (not used with mythgame)
    205 MAME history path:     /usr/local/share/xmame/history.dat (a little history about each game)
    206 MAME cheat files path: /usr/local/share/xmame/cheats
    207 MAME image downloader                                     (no longer used)
    208 </PRE>
    209 </CODE></BLOCKQUOTE>
     217<BLOCKQOUTE><PRE>
     218Player Name:    xmame-0.97.x11                  (Name by which you want your emulator or game called)
     219Type:           xmame                           (This is used for display purposes only and dosent effect the function of your system)
     220Command:        xmame -vidmod 1 -fullscreen     (Path and name of binary + any optional parameters)
     221Rom Path:       /usr/local/share/xmame/roms     (This tells <B>MythGame</B> what directories to scan for roms to be used with this emulator)
     222ScreenShots:    /usr/local/share/xmame/snaps    (This tells <B>MythGame</B> what directories to scan for snapshots to be used with these roms)
     223Working Directory:                              (Directory to change to before launching game or emulator. Blank in our case ignores this setting)
     224File Extensions:                                (List of all file extension to be used for this emulator. Blank menas any file under the Rom Path)
     225[] Allow games to span multiple roms/disks      (will treat game.1.rom game.2.rom game.3.rom as one game)
     226</PRE></BLOCKQOUTE>
    210227</P>
    211 <P>Setup options:</P>
    212 <P>Automatically download images - no longer used</P>
    213 <P>Show disclaimer - show warning about illegal ROMs before starting each ROM.</P>
    214 <P>Show game info - show info about the game, ie:year, maker, CPU, sound,
    215 screen resolution before starting the game</P>
    216228
     229
     230
     231
    217232<H2><A NAME="ss15.6">15.6</A> <A HREF="mythtv-HOWTO.html#toc15.6">Hints:</A>
    218233</H2>
    219 
    220 <P>No joystick causing failure to launch.</P>
    221 <P>By default, <B>mythgame</B> expects that you have a joystick installed.
    222 <B>xmame</B> will fail to launch because <B>mythgame</B> sends the
    223 option "-joytype 4" to <B>xmame</B> by default.  You may reset this using
    224 the following command:</P>
    225 <P><B>NOTE</B>: The following command will set the joytype to "0" for all
    226 hosts.  If you need to specify this on a per-host basis you can either
    227 modify the command below (if you know SQL), or use a tool which simplifies
    228 access to MySQL such as <B>phpMyAdmin</B>.
    229 <BLOCKQUOTE><CODE>
    230 <PRE>
    231 $ mysql -u root -e "update mythconverg.mamesettings set joytype=0"
    232 </PRE>
    233 </CODE></BLOCKQUOTE>
     234<P>
     235<LI>Rom name before options: %s can be used as a standin for rom names on the command line.</LI>
     236<LI>Multiple disk/rom games: %d1 %d2 etc can be used as standins for multiple disc games on the command line.</LI>
     237<LI>Associating a rom with an emulator: Browse to the desired rom and press 'M' to enter that roms settings page and select the emulator from the list.</LI>
     238<LI>Assign a Game Favorite Status: Browse to the desired game and press "/".</LI>
    234239</P>
    235240
    236241<HR>