RL tutorial merge - Revision history

Saint: 8 revisions

2013-12-05T13:53:41Z

8 revisions

Jeffleyda at 17:33, 3 August 2008

2008-08-03T17:33:25Z

Jeffleyda at 17:28, 3 August 2008

2008-08-03T17:28:30Z

Jeffleyda at 14:29, 12 March 2008

2008-03-12T14:29:22Z

Jeffleyda at 16:39, 12 February 2008

2008-02-12T16:39:47Z

Jeffleyda at 16:24, 12 February 2008

2008-02-12T16:24:51Z

Jeffleyda at 22:12, 31 January 2008

2008-01-31T22:12:26Z

Jeffleyda at 22:11, 31 January 2008

2008-01-31T22:11:32Z

Jeffleyda: ROMLister tutorial - creating a merged file

2008-01-07T16:03:30Z

ROMLister tutorial - creating a merged file

New page

Because no one single file out there adequately describes all the information about a particular ROM, we need to combine all the details from 3 separate files into 1 master file so ROMLister can work on it. When you first launch ROMLister or whenever you press the settings button from within the main screen, this is the dialog you will see.

[[Image:Rl_settings_blank.JPG|thumb|ROMLister Settings windows]]

The lower half of this window is the merge tool. The following steps will create a merged file:

1) Click on the MAME ListXML browse button. MAME.exe has a feature which generates a big text file which has descriptions of all the ROMs it supports. (We'll call the text file that MAME creates "listXML.xml" from here onward)

When you hit the browse button, it will ask you to select MAME.exe, and then ROMLister will have MAME create the listXML.xml file. This process takes upwards of a minute, and when MAME is finished, the path and filename will show up in the dialog.

If you have already created the listXML.xml file from other applications (some front ends use it) you can change the file type in the open browser to xml files and just point ROMLister to the listXML file instead of having MAME generate it for you.

2) If you have not already done so, download controls.xml from [http://fe.donkeyfly.com/controls/controls_dat.php controls.dat website] Be sure to get the XML version, not the .dat version.
Point the Controls.xml file browser to this file.

3) If you have not already done so, download catver.ini from [http://www.mameworld.net/catlist catver.ini website]
Point the catver.ini file browser to this file.

4) Click the Merge! button. ROMLister will pop up another dialog asking you what to call this new, merged file it's about to create. Let's call it merged.xml.

When ROMLister is finished merging, the path+filename of the final, merged file appears in the topmost Input XML file window. This is the input file that ROMLister will use from now on, and this file contains the best of all the information from the 3 files, and will greatly improve the amount of searchable items you can filter ROMs on.

5) Click the Set button and you'll go to the main ROMLister screen.

----

Creating a merged file is a one time process. ROMLister will remember the merged file next time you launch the application and take you straight to the main screen.

@@ Line 4: / Line 4: @@
 [[Image:Rl_settings_blank.JPG|thumb|ROMLister Settings windows]]
 The lower half of this window is the merge tool.  The following steps will create a merged file:
-) Click on the MAME ListXML browse button.  MAME.exe has a feature which generates a big text file which has descriptions of all the ROMs it supports.  (We'll call the text file that MAME creates "listXML.xml" from here onward)
+'''1)''' Click on the MAME ListXML browse button.  MAME.exe has a feature which generates a big text file which has descriptions of all the ROMs it supports.  (We'll call the text file that MAME creates "listXML.xml" from here onward)
 When you hit the browse button, it will ask you to select MAME.exe, and then ROMLister will have MAME create the listXML.xml file.  This process takes upwards of a minute, and when MAME is finished, the path and filename will show up in the dialog.
@@ Line 14: / Line 16: @@
-) If you have not already done so, download controls.xml from [http://fe.donkeyfly.com/controls/controls_dat.php controls.dat website] Be sure to get the XML version, not the .dat version.  If the site is down, [http://www.waste.org/~winkles/ROMLister/controls.zip  here ] is a copy of version 111.2:
+'''2)''' If you have not already done so, download controls.xml from [http://fe.donkeyfly.com/controls/controls_dat.php controls.dat website] Be sure to get the XML version, not the .dat version.  If the site is down, [http://www.waste.org/~winkles/ROMLister/controls.zip  here ] is a copy of version 111.2:
 Point the Controls.xml file browser to this file.
@@ Line 20: / Line 22: @@
 ''
-) If you have not already done so, download catver.ini. The official source for catver is:
+'''3)''' If you have not already done so, download catver.ini. The official source for catver is:
 [http://www.mameworld.net/catlist http://www.mameworld.net/catlist], however the file has not been updated in a couple years now.  I strongly suggest using this one instead:
 [http://www.progettoemma.net/public/ccount/click.php?id=6 http://www.progettoemma.net]
@@ Line 26: / Line 28: @@
 Point the file browser to this catver.ini file.
-) Click the Merge! button.  ROMLister will pop up another dialog asking you what to call this new, merged file it's about to create.  Let's call it merged.xml.
+'''4)''' Click the Merge! button.  ROMLister will pop up another dialog asking you what to call this new, merged file it's about to create.  Let's call it merged.xml.
 When ROMLister is finished merging, the path+filename of the final, merged file appears in the topmost Input XML file window.  This is the input file that ROMLister will use from now on, and this file contains the best of all the information from the 3 files, and will greatly improve the amount of searchable items you can filter ROMs on.
-) Click the Set button and you'll go to the main ROMLister screen.
+'''5)''' Click the Set button and you'll go to the main ROMLister screen.
 As of build 13, ROMLister creates a log file in the current directory (mergelog.txt) that contains information about all the games that MAME plays, but controls.xml doesn't have information on.  It will contain entries such as "Unable to find gorkans (clone of mrtnt) in controls.xml"

@@ Line 1: / Line 1: @@
 Because no one single source out there adequately describes all the information about all the possible games that MAME will play, we need to combine all a game's details from 3 separate files into 1 master file so ROMLister can get the best results for your searches.
-When you first launch ROMLister or whenever you press the settings button from within the main screen, this is the dialog you will see.
+When you first launch ROMLister or whenever you press the "Settings and Tools" button from within the main screen, this is the dialog you will see.
 [[Image:Rl_settings_blank.JPG|thumb|ROMLister Settings windows]]
@@ Line 31: / Line 31: @@
 ) Click the Set button and you'll go to the main ROMLister screen.
 ----

@@ Line 14: / Line 14: @@
-) If you have not already done so, download controls.xml from [http://fe.donkeyfly.com/controls/controls_dat.php controls.dat website] Be sure to get the XML version, not the .dat version.
+) If you have not already done so, download controls.xml from [http://fe.donkeyfly.com/controls/controls_dat.php controls.dat website] Be sure to get the XML version, not the .dat version.  If the site is down, [http://www.waste.org/~winkles/ROMLister/controls.zip  here ] is a copy of version 111.2:
 Point the Controls.xml file browser to this file.
 ''Controls.dat is out of date too.  If anyone knows of a more up to date source, please edit this section.

@@ Line 1: / Line 1: @@
-Because no one single source out there adequately describes all the information about a particular ROM, we need to combine all a game's details from 3 separate files into 1 master file so ROMLister can work on it.  When you first launch ROMLister or whenever you press the settings button from within the main screen, this is the dialog you will see.
+Because no one single source out there adequately describes all the information about all the possible games that MAME will play, we need to combine all a game's details from 3 separate files into 1 master file so ROMLister can get the best results for your searches.
 [[Image:Rl_settings_blank.JPG|thumb|ROMLister Settings windows]]
@@ Line 14: / Line 16: @@
 ) If you have not already done so, download controls.xml from [http://fe.donkeyfly.com/controls/controls_dat.php controls.dat website] Be sure to get the XML version, not the .dat version.
 Point the Controls.xml file browser to this file.
 ) If you have not already done so, download catver.ini. The official source for catver is:

← Older revision		Revision as of 22:12, 31 January 2008
Line 1:		Line 1:
−	Because no one single ~~file~~ out there adequately describes all the information about a particular ROM, we need to combine all ~~the~~ details from 3 separate files into 1 master file so ROMLister can work on it. When you first launch ROMLister or whenever you press the settings button from within the main screen, this is the dialog you will see.	+	Because no one single source out there adequately describes all the information about a particular ROM, we need to combine all a game's details from 3 separate files into 1 master file so ROMLister can work on it. When you first launch ROMLister or whenever you press the settings button from within the main screen, this is the dialog you will see.

	[[Image:Rl_settings_blank.JPG\|thumb\|ROMLister Settings windows]]		[[Image:Rl_settings_blank.JPG\|thumb\|ROMLister Settings windows]]

← Older revision	Revision as of 13:53, 5 December 2013
(No difference)

← Older revision		Revision as of 22:11, 31 January 2008
Line 27:		Line 27:

	Creating a merged file is a one time process. ROMLister will remember the merged file next time you launch the application and take you straight to the main screen.		Creating a merged file is a one time process. ROMLister will remember the merged file next time you launch the application and take you straight to the main screen.
		+
		+
		+	[[RL_tutorials \| Return to ROMLister tutorials]]