LDMakeList

From LDraw.org Wiki
Revision as of 22:36, 15 January 2015 by Owen Burgoyne (talk | contribs) (Updated infobox details)
Jump to navigation Jump to search
LDMakeList
Developer(s) Tim Gould
Initial release unknown
Current version 2.14 (2013-10-06)
Development status Unknown
Operating system Microsoft Windows, Mac OS
Available in unknown
Type Library utility
License GNU GPL
Website LDMakeList
Software infobox

LDMakeList is a tool created by Tim Gould as a replacement for the default mklist.exe that is included with LDraw.

LDMakeList has a number of advantages over mklist.exe, including:

  • The ability to disregard parts whose names begin with certain characters, by using the -h command, meaning that colour aliases and other parts that are defined with leading character such as _ or ~ are not listed.
  • Different sorting options (eg. -d for description, -n for filename, -p to leave patterns at the end)
  • The ability to shorten long descriptions to ensure compatibility with older LDraw software

Mac

Instructions for Mac (NB. you probably require Maverick to run this)

  1. Save LDMakeList-2.14-Mac.tar (here) without changing its filename into your LDraw directory
  2. Double click on it in Finder, then go into the directory it creates
  3. Double click on RunLDMakeList, it will run with -d in the parent directory
  4. If you extract to anywhere else, first copy LDMakeList and RunLDMakeList into your LDraw directory, and then run[1]

NB Mac power users may also use Terminal.app, then cd into the LDraw directory, then run LDMakeList with any of the command line arguments listed below.

[1] This strips LDMakeList-Mac off the end of the script's directory if present, and runs there. If not present, it simply runs in the script's directory.

Usage

By running the executable file, the following information is supplied:

LDMakeList
Use -? for help, -v for version
Valid options are:
-d or -D : sort by _D_escription (default)
-n or -N : sort by file_N_ame
-p or -P : sort by description (_P_atterns at end of file)
-s or -S : use _S_hort descriptions*
-m or -M : include pri_M_itives in the list
-u or -U : include _U_nofficial part directory
-a or -A : exclude _A_liases from the list
-r or -R : _R_emove duplicate entries (experimental)
-o or -O : Include _o_fficial parts only
-l[DIRNAME] or -L[DIRNAME] : Read from _L_Draw director DIRNAME
-h[C] or -H[C] : -H_ide descriptions starting with character(s) [C]
-i[C] or -I[C] : str_I_p leading character(s) [C] from descriptions
-x or -X : do not write parts._x_ml file

eg. "LDMakeList -d -h=_ -i~" will generate a parts.lst file sorted
by description (-d), excluding colour = and some parts _ (-h=_),
and removing the ~ character (-i~) from the start of descriptions

The -L tag lets you select the base directory for your LDraw
installation (defaults to environment variable LDRAWDIR)
eg. "LDMakeList -d -L." sorts by descriptions in the present
directory

eg. "LDMakeList -u" will look in [LDRAWDIR]/Unofficial/Parts
as well as [LDRAWDIR]/Parts for part files

The -m tag is not recommended for beginner LDraw users

* The old limit for part descriptions is 64 characters and it is
possible that descriptions longer than this might break some
old software. This ensures that the output filenames are no
longer than 64 characters. Use if programs are giving errors.

Sort by [D]escription or [N]umber?

Selecting either D or N will arrange the data in the outputted parts.lst file in a certain order. The option to select D or N will not appear if the option -d or -n or -p is selected.

By running the application from the command line, the other switches can also be enabled or disabled.

External links