Help.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>LDView Help</title>
<meta http-equiv = "content-language" content = "en"/>
<meta http-equiv = "content-type" content = "text/html; charset=iso-8859-1"/>
<link rel="icon" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAJBlWElmTU0AKgAAAAgABgEGAAMAAAABAAIAAAESAAMAAAABAAEAAAEaAAUAAAABAAAAVgEbAAUAAAABAAAAXgEoAAMAAAABAAIAAIdpAAQAAAABAAAAZgAAAAAAAACQAAAAAQAAAJAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAACCgAwAEAAAAAQAAACAAAAAA9t4+QgAAAAlwSFlzAAAWJQAAFiUBSVIk8AAAAgtpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IlhNUCBDb3JlIDUuNC4wIj4KICAgPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KICAgICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIKICAgICAgICAgICAgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPgogICAgICAgICA8dGlmZjpPcmllbnRhdGlvbj4xPC90aWZmOk9yaWVudGF0aW9uPgogICAgICAgICA8dGlmZjpQaG90b21ldHJpY0ludGVycHJldGF0aW9uPjI8L3RpZmY6UGhvdG9tZXRyaWNJbnRlcnByZXRhdGlvbj4KICAgICAgICAgPHRpZmY6UmVzb2x1dGlvblVuaXQ+MjwvdGlmZjpSZXNvbHV0aW9uVW5pdD4KICAgICAgICAgPHRpZmY6Q29tcHJlc3Npb24+MTwvdGlmZjpDb21wcmVzc2lvbj4KICAgICAgPC9yZGY6RGVzY3JpcHRpb24+CiAgIDwvcmRmOlJERj4KPC94OnhtcG1ldGE+CqZd9jAAAAiQSURBVFgJtVZ5bBTXGf/NzM6ud73GXi+28QFrbAOuuRSKISURTkTB0Bz8gZpKDS0IlUgp6h8NlVASVUJCcf5AaitVRWpVqhLRBghnVCDgEIwdAjYWDjanWdv4Nqyv9e56d3bn6PfeMoOXxFGbtE+aeW++9x2/913zBGC3ARpLluTixo03EYnE4Xa/z0gpY/HiXLS2vplC6++fwO3bAbz3XgMuXerme+fPb8bataXYt+8aduw4k8Lf1PQLVFYWoqamAe+++xnfE02OSCTBl6GQYpJS5mAwxr9jsQTq6rrQ0NANQQA3Vle3FZs2lfP9gwdb+fzss4Up8k6nDUuX5nHahx+2WXsWAEVROVFRNGtz6sKkDw2F8eKLH2D16r+jsPD32LPnEmfbu3cd7HYRp07dQzyuYtmyAuTmuiwVVVU+2rehvX0YN28GLLoFwOCBAAxzYbF882LPnnqwUMyd68GiRbkIBhVcuNDFhaqryyxhc33s2B2LxhYWgBTqf/GRSOhoaRnkEiUlHj4fP540smHDEwDr15em7JkmvjMApmh4OMr15eam85mFQdN0rFtXCpEs+HyZKC/PQW9vEM3NSbCckV7/EwAFBW6ur6cnyOdAYJInqdfr4llfXf31p2fM3xlAerqM5csLuOGOjjE+s5cZaxaG/xsA5t6amjXIznZRjxjCvXvDFoATJ+7y9fr1ZVizpgSBQASXL/da++bCZi4kiYqaRn5+BrlvK1vyYbdLmJhQsGXLSf49a5YbtbWbIUki5s/3UinO4PS33joPXU/KsHd/fwhNTX1YubKIE/fvv0558bjUnrDBAjBjhoOTHQ4bnn/eN4UF6OoahbmflibzE42MjODAgQ94CTY0OCm5WPyTh0gKGzh3rgMrViQBnD17P0Wn+UESyVbM3CnLEsyGYzLIMpCe7uBekKRh5OTcpZrvo5ofQ3Fxsnk9eGCj5uIhoEUYGJhPormPxZlLvn2aibt3P5F2OvGTnTuzhpqaioxIpMSYnCwxdL2UP2zNaGyP8TBe8wCPdXx7FKRoRkaG+Jtdu7ImFaWEGuU8esqmeeYZjIfxMhkmawKZbpam2yB65sKF8paaGu/7K1embac+L1dVsXpnifTVZErqESg5JVxvickvvOBa99pr6c91dibsgYDup/2v/8slBVPeGT6f/Mu9e7PrL14s4Cft6fYZL21w6UeO5Bm6UTrN6ZNeOXp0llG12ql3dszhfEwH08V0kpWMFEv0MTVtM75f6dj8880ZWyorHSsrKuzIzORFovvvK+LpY2F4PCIeDGjI8kooKZGRRd9MwXhQR6c/gZ5uFUbCwNiYhp1ve1BR4aQsNMRgUKV7Q5zKUmk8dCh04OpV5SCJhRgYKwSrVjmuvvOOZ+vGjelz5pU5kZYmqNTPBaoOsbMzjkky8rNtGfA6BbgdAgb7VPjbE+i8n8CjARUyXQ68mQKWLbGjh/YWVDhQVGQTSIfhdEra7NkOcfFiW9HsOXJ1V2fiR3192p8ZAH5Etnh9k/uZiYCG69cUzC3TqcRsNtZs2HCmi2i9q6LnbgKLVqVRNA087FERGNGpPDX6/4MBBtlCW1scYyEDWVlJWdJBTtJtvX1x3KK9tusx2/Kl9mfIC1y3BeAHy+1YME/Gl60JnDkRhq/UjtL5Mr5XbsfCCifWv6Jj/6EwlrTIcKWJcJInBLIRCusYHNLwKKAjrhoYHtexbXsmFiwgoNDh98dx40sFzY0xeDJElPls3IPcOr2sHGj8NN9YUUndkJTGwgY+vxrj8Z6Zb0M55UM5KQxOJHD4cBghMkKXG6h0i0uQUfrzgg6PPOL96etuuJwyOruiuNao4Farwt1cUS5TQ0uau3dfxa/fHuUflgeY+1RKIPZPcBD4H65zIho0UP9FDM2XY7hJipavSMMb25OXjlA4gREKAbsX5syU4HIxVZQbQwpOnRjHg444lIiBxWR4RqYIlYCyy5ZGN76p/wwLgM1GLiVlVDucCSSQRkCqX3VhvF/DtRYFX1yMokGKYnWVE745dmQkrwHcmwODCs5/Mokh4lVjOkqKbcjLpdYeNyhHkn2DtXtmg1qFNSwAMUosyU67xKRHk2hVhnZMR2aWgLUvuxCgMrtDWV93bhKCI4qXX0kHy9Pjx8Poe6DCQYoLyGhhocyNhicNsBQ0h10W+Onj5GlzWADO1sYGvR4pv3gOuTOLNJEHEgSKoU5QrPVRHTl5EnJm21BBZdbVq+Kv+4IYGFJRXGhDcYGE/FkSz4cw5RA7qWmcGWanDlFIHj3S0NyiWPcyyxmfX4kdbrymjKuaMdtpF7LTqayc2RJE1VBVlRKeeo5OHmGNxk0xLyySqP4p+x9qWLrIDk+2COZFFmM2KJIGGdVcTkGcCOnoJsCXGxX/Pw+H/9BwRdlBLBOMzwLACIMPtfpPLsSONTUrYdEm5CJh5FD3E10zKTMThk7KBXYygS4WgiFQx9MRJOWZlGQswcyHwqK73YIYmTTEdr+K6zfit/9xJLKv9mLsV6Pj+mnT+NMA2DcbIQJSd+Z89OO2W/FxQ8dMI468gnxJkKmOWWg4CMr4Dop7H3mBtWgzsejEVJoQblPTam6Jt310MvInCu/O0TH9Y6abW5jymuqBKWS+nOgf1OrP1EbPDj3Sg6NjWhE0ZBcV2CBSeNjopm44OKjB6xV5J2QeuHNPxZUmxV9bF/3jyX9Fd42McsPc3Vzoqdc3ATBZx9v9ibqzn8Zqh0f1h7396ly3Q/TMooTsp5IboBzwUNvtogq5WB/tutQQ+92J09Hf9g9oR0nBuKlkunlKkUzHApElFLndrJ15G19y/bjqubQ3cryS7057nMKgdrd3JP5ytSn+EWnhlz+SYfnC9E+5qn7Vxn8CwJRiJZu8BCYp85cutG+L0j+l3R//G5HaTUaan+adspW6/DeJQ+sv4WmmowAAAABJRU5ErkJggg==" type="image/png"/>
<style type="text/css"><!--
BODY
{
	margin: 20px;
	font-family: helvetica, arial, sans-serif;
}
TABLE
{
	border-collapse: collapse;
}
TABLE.SettingsList
{
	border: 2px solid #000000;
	background-color: #FFFFDD;
	padding: 0px;
}
TABLE.SettingsList TH
{
	background-color: #0080D0;
	color: #FFFFFF;
	border-bottom: 1px solid #000000;
	border-right: 1px solid #00558A;
	padding: 4px 8px;
	white-space: nowrap;
}
TABLE TD
{
	padding: 2px;
}
TABLE.SettingsList TD
{
	border-bottom: 1px solid #BFBFA5;
	border-right: 1px solid #BFBFA5;
	padding: 2px 8px;
}
TABLE.SampleData TD
{
	border-style: none;
}
.NoWrap
{
	white-space: nowrap;
}
.SectionHeader
{
	display: flex;
	border: 2px solid #000000;
	background-color: #0080D0;
	color: #FFFFFF;
	font-weight: bold;
	font-size: 150%;
	margin-bottom: 8px;
	padding: 1px 10px;
}
.MainTitle
{
	font-family: arial black, helvetica, arial, sans-serif;
	justify-content: center;
	font-size: 200%;
	font-variant: small-caps;
}
.SubHeader
{
	font-size: 135%;
	font-weight: bold;
}
.SubHeader2
{
	font-size: 125%;
	font-weight: bold;
}
.MenuTitle
{
	white-space: nowrap;
	text-align: right;
}
.FinePrint
{
	font-size: 81%;
}
.KeyTable
{
	display: flex;
}
.KeyTable .Column
{
	min-width: 200px;
	display: flex;
	flex-direction: column;
}
.KeyTable .Column.Right
{
	align-items: flex-end;
	margin-right: 10px;
}
.KeyTable .Column .Header
{
	font-weight: bold;
}
.KeyTable .Column DIV
{
	margin-bottom: 3px;
}
.Note
{
	display: flex;
}
.Note div:first-child
{
	font-style: italic;
	margin-right: 5px;
}
.Indent
{
	margin-left: 3em;
}
--></style>
</head>
<body bgcolor="#F8F8F8" vlink="#505050" link="#808080" alink="#0080D0">
<div class="SectionHeader MainTitle"><a name="TopOfFile"></a>LDView Help</div>
<p></p>
<div class="SectionHeader">Contents</div>
<ul>
<li><a href="#Intro">Introduction</a></li>
<li><a href="#MacNotes">LDView on macOS</a></li>
<li><a href="#LDrawLibrary">LDraw Parts Library</a></li>
<li><a href="#MouseControl">Mouse and Keyboard Control</a>
<ul>
<li><a href="#ExamineMode">Examine Mode</a></li>
<li><a href="#FlyMode">Fly-through Mode</a></li>
<li><a href="#WalkMode">Walk Mode</a></li>
</ul></li>
<li><a href="#StepSupport">Step Support</a></li>
<li><a href="#Menus">Menus</a>
<ul>
<li><a href="#FileMenu">File Menu</a></li>
<li><a href="#EditMenu">Edit Menu</a></li>
<li><a href="#ViewMenu">View Menu</a></li>
<li><a href="#StepMenu">Step Menu</a></li>
<li><a href="#ToolsMenu">Tools Menu</a></li>
<li><a href="#HelpMenu">Help Menu</a></li>
</ul></li>
<li><a href="#Toolbar">Toolbar</a></li>
<li><a href="#Fullscreen">Fullscreen Mode</a></li>
<li><a href="#SaveSnapshotOptions">Save Snapshot Options</a></li>
<li><a href="#Export">Exporting</a></li>
<li><a href="#CameraLocDialog">Camera Location Dialog</a></li>
<li><a href="#RotationCenterDialog">Rotation Center Dialog</a></li>
<li><a href="#LatLonDialog">Latitude/Longitude Dialog</a></li>
<li><a href="#ErrorWindow">Errors &amp; Warnings Window</a></li>
<li><a href="#PartsListDialog">Parts List Dialog</a></li>
<li><a href="#ModelTreeDialog">Model Tree Dialog</a></li>
<li><a href="#MPDDialog">MPD Model Selection Dialog</a></li>
<li><a href="#Prefs">Preferences</a>
<ul>
<li><a href="#GeneralTab">General Tab</a>
<ul>
<li><a href="#GeneralAABox">Antialiasing Box</a></li>
<li><a href="#GeneralCustomConfigBox">Custom Config Box</a></li>
<li><a href="#GeneralColorsBox">Colors Box</a></li>
<li><a href="#GeneralMiscBox">Misc Box</a></li>
</ul></li>
<li><a href="#GeometryTab">Geometry Tab</a>
<ul>
<li><a href="#GeometryModelBox">Model Box</a></li>
<li><a href="#GeometryWireframeBox">Wireframe Box</a></li>
<li><a href="#GeometryBFCBox">BFC Box</a></li>
<li><a href="#GeometryEdgeLinesBox">Edge Lines Box</a></li>
</ul></li>
<li><a href="#LDrawTab">LDraw Tab (Mac Only)</a>
</li>
<li><a href="#GeometryTab">Geometry Tab</a>
<ul>
<li><a href="#GeometryModelBox">Model Box</a></li>
<li><a href="#GeometryWireframeBox">Wireframe Box</a></li>
<li><a href="#GeometryBFCBox">BFC Box</a></li>
<li><a href="#GeometryEdgeLinesBox">Edge Lines Box</a></li>
</ul></li>
<li><a href="#EffectsTab">Effects Tab</a>
<ul>
<li><a href="#EffectsLightingBox">Lighting Box</a></li>
<li><a href="#EffectsStereoBox">Stereo Box</a></li>
<li><a href="#EffectsCutawayBox">Wireframe Cutaway Box</a></li>
<li><a href="#EffectsTransparencyBox">Transparency Box</a></li>
<li><a href="#EffectsMiscBox">Misc Box</a></li>
</ul></li>
<li><a href="#PrimitivesTab">Primitives Tab</a>
<ul>
<li><a href="#PrimitivesSubstitutionBox">Primitive Substitution Box</a></li>
<li><a href="#PrimitivesMiscBox">Misc Box</a></li>
</ul></li>
<li><a href="#UpdatesTab">Updates Tab</a>
<ul>
<li><a href="#InternetProxyBox">Internet Proxy Box</a></li>
<li><a href="#MissingPartsBox">Missing Parts Box</a></li>
</ul></li>
<li><a href="#PreferenceSetsTab">Preference Sets Tab</a></li>
<li><a href="#ScreenSaverTab">Screen Saver Tab</a></li>
</ul></li>
<li><a href="#CommandLine">Command Line</a>
<ul>
<li><a href="#CommandLineFilename">Specifying a Filename</a></li>
<li><a href="#SnapshotFilename">Specifying a Snapshot Filename</a></li>
<li><a href="#SaveSnapshots">Requesting One or More Snapshots</a></li>
<li><a href="#ExportFilename">Specifying an Export Filename</a></li>
<li><a href="#ExportFiles">Requesting One or More Exports</a></li>
<li><a href="#Verbose">Verbose Output</a></li>
<li><a href="#IniFile">Specifying an INI file</a></li>
<li><a href="#LDConfig">Specifying an Alternate to LDConfig.ldr</a></li>
<li><a href="#L3PCompatibility">L3P-compatible Options</a></li>
<li><a href="#CommandLinePrefs">Specifying Preferences</a></li>
<li><a href="#PrefList">List of All Preferences</a></li>
</ul></li>
<li><a href="#MetaCommands">LDView-specific LDraw Meta Commands</a></li>
<li><a href="#Notes">Notes</a></li>
<li><a href="#ScreenSaver">Using LDView as a Screen Saver</a></li>
<li><a href="#Website">Website</a></li>
</ul>
<p><br/>
<a name="Intro"></a></p>
<div class="SectionHeader">Introduction</div>
<p>
<i>Please note</i>: this help file mostly documents the Windows version of
LDView, with a few notes about the Qt (Linux) and Mac versions, and some
specific notes on different conventions in the Mac version.  For the most part,
the Qt and Mac versions have the same functionality as the Windows version, and
look and act the same (aside from having a mostly native UI look).  However,
certain features (such as FSAA support) are missing from the Qt and Mac
versions, and other features (such as full screen support) are present with less
functionality.  If you are using a non-Windows version of LDView, please don't
expect 100% of the features documented here to be present (although a very high
percentage are present).  Anywhere this document refers to the Qt version of
LDView, it is referring to the version made using the Qt user interface library.
The Qt-based version of LDView is currently only available in binary form as
various Linux binaries.  This version should work fine if compiled in other
Unix-like operating systems, though (as long Qt is supported on them).
</p>
<p>
LDView displays LDraw models, and consequently requires that LDraw be
installed.  LDraw can be downloaded from
<a href="http://www.ldraw.org/">ldraw.org</a>, along with the up-to-date parts
library.  If you install LDraw in any directory other than one of places LDView
looks by default, you will be asked the first time LDView loads if you already
have the LDraw library installed.  If you say that you do, you will be asked to
select the directory in which LDraw is installed.  Until you select the LDraw
directory, you will be unable to load a model.  If you respond that you don't
already have LDraw installed, you will be asked if you want LDView to download
it for you.
</p>
<p>
When you run LDView, it will open its main window and immediately present you
with an open file dialog (assuming you didn't specify a file as part of the
launch process).  Select the LDraw .ldr, .mpd, or .dat file you want to view.
It will then display the file in the window.  Note that you can resize this
window.  Also note that if you open a large model, it could take a substantial
amount of time to load.  During this time, the status bar will indicate the
progress of the load.  Hitting Escape, or choosing <a href="#CancelLoad">Cancel
Load</a> from the File menu, will cancel the load.
</p>
<p>
<a name="MacNotes"></a><br/></p>
<div class="SectionHeader">LDView on macOS</div>
<!-- Note: the # below isn't really right, but it works in both Safari and
Firefox.  Using Help.html in its place (the correct thing) doesn't work in
Safari until you click on the link a second time if you came into the page with
a # link already (like #MacNotes).  I'd say that's a bug in Safari. -->
<p><a href="#">Back to Top</a></p>
<p>
LDView on macOS uses the standard Mac convention of using the Command key
instead of the Control key for common activities.  Anywhere in this document
that you see the Control key mentioned, remember that the Command key should be
used instead.
</p>
<p>
The menu layout on macOS is also somewhat different.  The Preferences, About
LDView, and Exit menu items have been moved to their standard location in the
application (LDView) menu (with Exit being renamed to the standard of Quit
LDView).  The recent files list has been placed in a standard Open Recent
sub-menu of the File menu.
</p>
<p>
If your mouse only has one button, holding down Control while clicking is
equivalent to using the right mouse button (as is standard).  Additionally, if
you have a touch pad that supports two-finger dragging to scroll, this is
equivalent to using the mouse wheel (also as is standard). Pinch zooming also
works on such touch pads, as does two finger twisting to rotate the camera, when
you are in a mode that supports that. Finally, three-finger dragging is treated
the same as a middle button drag with a mouse.
</p>
<p>
<a name="LDrawLibrary"></a>
</p>
<div class="SectionHeader">LDraw Parts Library</div>
<p>
LDView displays LDraw models, and LDraw models (almost always) make use of parts
in the LDraw parts library. In order to display those models, LDView needs for
the LDraw parts library to be present on your computer, and needs to know where
on your computer the parts library is located.  (If you only want to use LDView
to view models that have been created in the LDraw file format that do not make
use of the LDraw parts library, please see the documentation for the
<a href="#VerifyLDrawSetting">VerifyLDrawDir setting</a>.)
</p>
<p>
The first time you run LDView, it probably won't be able to find the LDraw parts
library, even if the library is already present on your computer.  If this
happens, LDView will ask you if the library has already been installed.  If you
already have the LDraw parts library on your computer, answer Yes, and then show
LDView where to find the library.
</p>
<p>
If you don't already have the LDraw parts library on your computer, answer No,
and you will be asked if you would like LDView to download the library for you.
As long as you aren't using a proxy server for HTTP connections, you can answer
Yes, and you will be asked where you want the library to be put.  After this,
LDView will automatically download the latest version of the LDraw parts library
from LDraw.org.  Once the library has been downloaded and installed, you can
then view models.  Please note that the LDraw parts library is somewhat large
(over 6MB at the time this was written), so it could take a while to download if
you don't have a fast Internet connection.
</p>
<p>
If you use a proxy server for HTTP connections, tell LDView not to download the
LDraw parts library right now, and then go to the <a href="#UpdatesTab">Updates
tab</a> in LDView's preferences and configure your proxy server settings.
</p>
<p>
By default, if LDView encounters a request for a part that it cannot find, it
will attempt to download the part from the LDraw.org parts tracker.  The parts
tracker contains all the unofficial parts that have been submitted for
inclusion in the official LDraw parts library that have either not yet been
approved for inclusion, or have been approved, but not yet been included in an
official release of
the library.  Because unofficial parts can change in ways that aren't compatible
with old models (for example, being rotated), LDView generates a warning any
time it uses an unofficial file that it has downloaded.  Note that if the part
subsequently gets added to the official library, the official version will
automatically be used instead (once you update your parts library), and the
warning will go away.
</p>
<p>
<a name="MouseControl"></a>
</p>
<div class="SectionHeader">Mouse and Keyboard Control</div>
<p>
LDView has three different modes of user interaction:
<a href="#ExamineMode">Examine Mode</a>, <a href="#FlyMode">Fly-through
Mode</a>, and <a href="#WalkMode">Walk Mode</a>.  By default LDView is in
Examine Mode.  You can switch modes by selecting the mode you want from the
<a href="#ViewMenu">View Menu</a>.
</p>
<p>
<span class="SubHeader"><a name="ExamineMode">Examine Mode</a></span><br/>
Click the left mouse button and drag around to rotate the model.  If you let
go of the button while the mouse is in motion, the model will continue to
rotate on its own.
</p>
<p>
If you hold down the control key prior to clicking and dragging with the left
mouse button, or if you click the middle mouse button and drag, you will pan the
model instead of rotating it.  The model will be pulled in the direction you
move the mouse. If you accidentally lose the model completely, and can't find
it, you can use the <a href="#ResetView">Reset View</a> option on the View menu
to reset the view.
</p>
<p>
If you <a name="MouseLightDirection">hold down the shift key</a> prior to
clicking and dragging with the left mouse button, you will change the light
direction.  An arrow will be drawn to indicate the current light direction, and
moving the mouse will rotate the direction that the arrow points, as well as
updating the light direction.  If you have problems getting it back to its
default setting, you can choose one of the <a href="#LightDirection">preset
light directions</a> in the Effects tab of the preferences.
</p>
<p>
Click the right mouse button and move it up or down to zoom in or out.  The
speed at which it zooms in or out is based on how far you move the mouse from
where you initially clicked.  If you have a mouse with a scroll-wheel, you can
also use the scroll-wheel to zoom in and out.
</p>
<p>
If you hold down the control key while zooming (either with the right mouse
button or the scroll wheel), you will adjust the cutaway mode instead of
zooming in the camera.  Cutaway mode cuts away everything on the model that
is closer than a certain distance.  This distance is defined by a clipping
plane.  This allows you to look inside models without having to resort to
wireframe mode.  Zooming in with the control key pressed moves the clipping
plane away from the camera, causing more and more of the model to be cut away.
Zooming out moves the clipping plane toward the camera, causing less and less
to be cut away.  Please note that you will likely have to zoom in a ways before
the clipping plane reaches the model, so there will probably be no imediate
result.  If you want, you can have LDView draw the cutaway portion of the model
in wireframe, using the <a href="#WireframeCutaway">Wireframe cutaway</a>
option.  Note that this will slow things down considerably, since the entire
model has to be rendered twice.
</p>
<p>
<span class="SubHeader"><a name="FlyMode">Fly-through Mode</a></span><br/>
Click the left mouse button and move it around to turn the camera left, right,
up, and down.  The further you move the mouse from the point you clicked, the
faster the camera will turn. You can also use the arrow keys to do the same
thing.
</p>
<p>
The camera can be moved using the keyboard.  At any time, you can hold down
shift to double the speed at which you move.  The movement keys are as follows:
</p>
<p>
<div class="KeyTable">
	<div class="Column Right">
		<div class="Header">Movement Direction</div>
		<div>Forward:</div>
		<div>Backward:</div>
		<div>Left:</div>
		<div>Right:</div>
		<div>Up:</div>
		<div>Down:</div>
	</div>
	<div class="Column">
		<div class="Header">Key</div>
		<div>W</div>
		<div>S</div>
		<div>A</div>
		<div>D</div>
		<div>R</div>
		<div>F</div>
	</div>
</div>
</p>
<p>
In addition to the above movement keys, the following keys effect the camera
rotation:
</p>
<p>
<div class="KeyTable">
	<div class="Column Right">
		<div class="Header">Rotation</div>
		<div>Rotate Clockwise:</div>
		<div>Rotate Counter-Clockwise:</div>
	</div>
	<div class="Column">
		<div class="Header">Key</div>
		<div>E</div>
		<div>Q</div>
	</div>
</div>
</p>
<p>
<span class="SubHeader"><a name="WalkMode">Walk Mode</a></span><br/>
Click the left mouse button and move it around to turn the camera left, right,
up, and down.  The further you move the mouse from the point you clicked, the
faster the camera will turn. You can also use the arrow keys to do the same
thing.
</p>
<p>
The camera can be moved using the keyboard. Unlike in Fly-Through Mode, where
the camera moves exactly in the direction it is pointed, in Walk Mode it
maintains the same altitude while otherwise moving in the direction it is
pointed. It also keeps the model right side up. The movement keys are as
follows:
</p>
<p>
<div class="KeyTable">
	<div class="Column Right">
		<div class="Header">Movement Direction</div>
		<div>Forward:</div>
		<div>Backward:</div>
		<div>Left:</div>
		<div>Right:</div>
		<div>Up:</div>
		<div>Down:</div>
	</div>
	<div class="Column">
		<div class="Header">Key</div>
		<div>W</div>
		<div>S</div>
		<div>A</div>
		<div>D</div>
		<div>R</div>
		<div>F</div>
	</div>
</div>
</p>
<p>
<a name="StepSupport"></a>
</p>
<div class="SectionHeader">Step Support</div>
<p>
LDraw files may contain steps.  If so, you can view the steps in order to see
how to build the model.  However, by default, LDView displays the last step,
which shows the complete model.  Use one of the <i>Step</i> menu items or one of
the step toolbar controls to look at the steps.
</p>
<p>
Some programs support some advanced options for steps such as temporary buffers
(so that a sub-section of the model can be initally shown in one location and
then moved to another) and custom rotation angles.  LDView doesn't support this
advanced functionality.  It recognizes the <tt>ROTSTEP</tt> LDraw command, which
is used for steps with a custom rotation angle, but treats it just like a
standard step command.  It ignores all other advanced step commands.
</p>
<p>
LDView only shows the steps in the top-level model that it is displaying.  If
you want to see the steps in a sub-model of that model, you must load the
sub-model directly.  If you want to see the steps in the sub-models of an MPD
file, you must first select the sub-model using the <a href="#MPDDialog">MPD
Model Selection Dialog</a> (available from the <a href="#ToolsMenu">Tools
Menu</a> .  Once you have selected the sub-model as the main model, its steps
can be navigated just as if it were in its own file which you loaded directly.
</p>
<p>
<a name="Menus"></a>
</p>
<div class="SectionHeader">Menus</div>
<p>
The shortcut key for each menu item is shown in the menu when running LDView.
Note that these keys will continue to function even while in fullscreen mode
where there is no visible menu.
</p>
<table cellspacing="6">
	<tr>
		<td colspan="3"><span class="SubHeader2"><a name="FileMenu">File
		Menu</a></span></td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Open:</td>
		<td colspan="2">Open a new model file.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Save Snapshot:</td>
		<td colspan="2">Save a PNG or BMP snapshot of the current model with the
		current view.  See <a href="#SaveSnapshotOptions">here</a> for
		information about the extra settings in the save dialog.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Export:</td>
		<td colspan="2">Export the loaded LDraw model to various different file
		formats.  See <a href="#Export">here</a> for details.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Reload:</td>
		<td colspan="2">Reload the current model file.  (Use this if you are
		viewing a model you are in the process of making changes to in some
		other program, but don't want to use the polling feature below.)</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Cancel Load:</td>
		<td colspan="2">During a load, you can select this menu item to cancel
		the load.  It is likely that you will generally just use the keyboard
		accelerator, though, and hit the Escape key.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Polling:</td>
		<td colspan="2">Submenu containing polling options which allow you to have
		the model automatically reload when its file changes.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Disabled:</td>
		<td>Disable the polling feature completely.  You can still used the
		Reload option to reload the current model.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Prompt:</td>
		<td>Enables polling.  When a change is detected, a dialog is displayed
		asking you if you want to reload the model file.  This option only
		polls for changes when LDView is the foreground application.  The
		dialog will thus normally be presented to you when you switch to the
		running LDView application after making changes to your model in some
		other application.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Auto-update when active:</td>
		<td>Enables polling.  When a change is detected, the current model file
		is reloaded automatically.  This option only polls for changes when
		LDView is the foreground application.  The model will thus normally be
		automatically reloaded when you switch to the running LDView application
		after making changes to your model in some other application.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Auto-update immediately:</td>
		<td>Enables polling.  When a change is detected, the current model file
		is reloaded automatically.  This option polls for changes whether or not
		LDView is the foreground application.  The model will thus be
		automatically reloaded immediately after you save changes to your model
		in some other application.  Note that with large models, this reload
		can have a significant impact on your computer's CPU availability.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Check for Library Updates:</td>
		<td colspan="2">Checks to see if there are any library updates on
		LDraw.org that aren't yet installed, and downloads and installs them if
		any are found.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Page Setup:</td>
		<td colspan="2">Setup the page for printing.  This shows the standard
		Windows Page Setup Dialog with the addition of a check box which
		allows you to choose whether or not the background color should be
		printed (it isn't by default).</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Print:</td>
		<td colspan="2">Print the current model with the current view.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">&lt;Recent Files&gt;:</td>
		<td colspan="2">Shows the filenames of the 10 most recently loaded files.
		Select any one to load that file.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Exit:</td>
		<td colspan="2">Exit LDView.</td>
	</tr>
	<tr>
		<td colspan="3"><hr size="1" width="90%" noshade="noshade"/></td>
	</tr>
	<tr>
		<td colspan="3"><span class="SubHeader2"><a name="EditMenu">Edit
		Menu</a></span></td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Preferences:</td>
		<td colspan="2">Shows the <a href="#Prefs">Preferences Dialog</a>.</td>
	</tr>
	<tr>
		<td colspan="3"><hr size="1" width="90%" noshade="noshade"/></td>
	</tr>
	<tr>
		<td colspan="3"><span class="SubHeader2"><a name="ViewMenu">View
		Menu</a></span></td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Use Visual Style (requires restart):</td>
		<td colspan="2">This menu is not visible when running LDView in operating
		systems other than Windows, or in Windows versions prior to Windows XP.
		When present, it enables or disables the use of Windows XP Visual
		Styles.  You must restart LDView for changes in this option to become
		visible.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Switch to Fullscreen:</td>
		<td colspan="2">Switches to the currently selected
		<a href="#Fullscreen">fullscreen</a> video mode.
		If you are already in fullscreen mode, Ctrl+Enter switches back to
		windowed mode.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Toolbar:</td>
		<td colspan="2">Toggles the <a href="#Toolbar">toolbar</a> on and off.
		Note that the toolbar is never visible in full-screen mode.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle"><a name="StatusBar">Status Bar:</a></td>
		<td colspan="2">Toggles the permanent display of the status bar on and
		off.  Note that the status bar will always display when there is load
		progress to be indicated.  Also, except while displaying load progress,
		it is never visible in full-screen mode.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Always on Top:</td>
		<td colspan="2">Toggles Always on Top mode.  When this is enabled, the
		LDView window is kept above all other windows (with the exception of
		some other topmost windows).  When it is disabled (the default), LDView
		acts just like a normal Windows program.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle"><a name="ResetView">Reset View</a>:</td>
		<td colspan="2">Resets the model to the default view that is shown
		immediately after the initial load.  Any viewing angle can be saved as
		the default viewing angle using <a href="#SaveDefaultView">this</a>
		menu item.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Zoom to Fit:</td>
		<td colspan="2">Zooms the model in to fill the current window.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Right Side Up:</td>
		<td colspan="2">Rotates the model so that it is right side up.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Camera Location:</td>
		<td colspan="2">Shows the <a href="#CameraLocDialog">Camera Location
		Dialog</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Rotation Center:</td>
		<td colspan="2">Shows the <a href="#RotationCenterDialog">Rotation
		Center Dialog</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Viewing Angles:</td>
		<td colspan="2">Submenu containing preset viewing angles.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Front:</td>
		<td>Sets the view to show the front of the model.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Back:</td>
		<td>Sets the view to show the back of the model.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Left:</td>
		<td>Sets the view to show the left of the model.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Right:</td>
		<td>Sets the view to show the right of the model.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Top:</td>
		<td>Sets the view to show the top of the model.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Bottom:</td>
		<td>Sets the view to show the bottom of the model.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Specify latitude/longitude:</td>
		<td colspan="2">Shows the <a href="#LatLonDialog">Latitude/Longitude
		Dialog</a>.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle">Two-thirds:</td>
		<td>Sets the view to a two-thirds view of the model.  This is the
		default view until you change it to something else.</td>
	</tr>
	<tr valign="top">
		<td></td>
		<td class="MenuTitle"><a name="SaveDefaultView">Save Current as
		Default:</a></td>
		<td>Saves the current viewing angle as the default viewing angle.  Note
		that this only stores the viewing angle, not the viewing distance.  The
		viewing distance is still reset to the default distance when you change
		to the default view.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle"><a name="StandardSizes">Standard Sizes</a>:</td>
		<td colspan="2">Submenu containing preset window sizes.  Select any item
		in the list to change the main 3D view in LDView to that size.  Each
		size also contains two numbers in parentheses after the dimensions.
		These represent the aspect ratio.  So <b>(4:3)</b> represents a 4/3rds
		aspect ratio (just like a standard definition TV set), and <b>(16:9)</b>
		represents a 16 to 9 aspect ratio (just like a high definition TV
		set).  These are particularly useful when you intend to either
		<a href="#PovExport">export to POV</a> or use the
		<a href="#PovCamera"><i>Show POV-Ray Camera Info</i></a> command.
		<br/><br/>Note that only sizes that will fit on the screen are shown in the
		list.  Also, sizes that are close to the maximum size may only show up
		on the list if the toolbar and status bar are disabled, since these
		change the overall height of the LDView window.  Additionally, if you
		have multiple monitors, you might get a different list on each monitor,
		if the monitors have different resolutions, or one monitor has the task
		bar visible and the other doesn't.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Examine Mode:</td>
		<td colspan="2">Puts LDView in <a href="#ExamineMode">Examine Mode</a>.
		This is the default mode.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle"><a name="LatLonMode">Latitude/Longitude
		Rotation:</a></td>
		<td colspan="2">Toggle to enable or disable latitude/longitude rotation
		mode.  In latitude/longitude rotation mode, moving the mouse side to
		side changes the view's longitude, and moving the mouse up and down
		changes the view's latitude.  Also, the current latitude and longitude
		are shown in the bottom right of the status bar when in
		latitude/longitude rotation mode.
		<br/><br/>This is only available in Examine Mode.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Fly-through Mode:</td>
		<td colspan="2">Puts LDView in <a href="#FlyMode">Fly-through
		Mode</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Keep Right Side Up:</td>
		<td colspan="2">Keeps the model right side up while in Fly-Through
		Mode.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Walk Mode:</td>
		<td colspan="2">Puts LDView in <a href="#WalkMode">Walk Mode</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">XX-Bit Modes:</td>
		<td colspan="2">Submenu containing all of the available fullscreen video
		modes with a bit-depth of XX (where XX will usually be 15, 16, 24, or
		32).  There is a separate submenu for each bit-depth of 15 or greater
		bits supported by your video card.  There will be a dot beside the
		bit-depth menu which contains the currently selected fullscreen video
		mode.  In that submenu, there will be a dot next to the currently
		selected video mode.</td>
	</tr>
	<tr>
		<td colspan="3"><hr size="1" width="90%" noshade="noshade"/></td>
	</tr>
	<tr>
		<td colspan="3"><span class="SubHeader2"><a name="StepMenu">Step
		Menu</a></span></td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">First:</td>
		<td colspan="2">Displays the loaded model's first step.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Previous:</td>
		<td colspan="2">Displays the loaded model's previous step.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Next:</td>
		<td colspan="2">Displays the loaded model's next step.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Last:</td>
		<td colspan="2">Displays the loaded model's last step.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Go to Step:</td>
		<td colspan="2">Shows a dialog to go to a specific step.</td>
	</tr>
	<tr>
		<td colspan="3"><hr size="1" width="90%" noshade="noshade"/></td>
	</tr>
	<tr>
		<td colspan="3"><span class="SubHeader2"><a name="ToolsMenu">Tools
		Menu</a></span></td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Errors &amp; Warnings:</td>
		<td colspan="2">Shows the <a href="#ErrorWindow">Errors &amp; Warnings
		Window</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Parts List:</td>
		<td colspan="2">Shows the <a href="#PartsListDialog">Parts List
		Dialog</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Model Tree:</td>
		<td colspan="2">Shows the <a href="#ModelTreeDialog">Model Tree
		Dialog</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Model Bounding Box:</td>
		<td colspan="2">Displays a dialog box showing the minimum and maximum
		corners of an axis-aligned bounding box around the model, and draws
		that bounding box.  Close the dialog to turn off the bounding box
		display.  Note that you can still interact with the model while this
		dialog is visible.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">MPD Model Selection:</td>
		<td colspan="2">Shows the <a href="#MPDDialog">MPD Model
		Selection Dialog</a>.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle"><a name="ShowViewInfo">Show View Info:</a></td>
		<td colspan="2">This shows a dialog that contains the model's current
		rotation matrix and zoom level (camera distance).  Hitting OK copies
		this information to the clipboard in a format suitable for use with
		LDView on the command line.  Note that the camera's position and viewing
		angle aren't recorded at this time, so it's recommended that you
		not try to use this in Fly-through Mode or after having panned.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle"><a name="PovCamera">Show POV-Ray Camera
		Info:</a></td>
		<td colspan="2">This shows a dialog that contains information about the
		current camera position as is needed in POV-Ray.  Hitting OK copies a
		POV-Ray-compatible camera declaration into the clipboard.  This can be
		directly pasted into a POV-Ray file to replace the existing camera.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Use current aspect ratio for POV-Ray camera:</td>
		<td colspan="2">Toggle that controls whether the 3D view's current aspect
		ratio is used in the POV-Ray camera that is copied to the clipboard when
		using the <a href="#PovCamera"><i>Show POV-Ray Camera Info</i></a>
		command.  If this is checked, the current aspect ratio will be used.
		Otherwise, 4/3 is used.  Since POV images tend to be done at specific
		aspect ratios, this is most useful immediately after selecting a
		<a href="#StandardSizes">standard size</a> with the desired aspect
		ratio.</td>
	</tr>
	<tr>
		<td colspan="3"><hr size="1" width="90%" noshade="noshade"/></td>
	</tr>
	<tr>
		<td colspan="3"><span class="SubHeader2"><a name="HelpMenu">Help
		Menu</a></span></td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">OpenGL Driver Info:</td>
		<td colspan="2">This shows a dialog containing information about your
		OpenGL driver.  I may request this information from you if you are
		experiencing problems.  The text in the box can be selected, and then
		copied to the clipboard by hitting Ctrl+C.</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">Contents:</td>
		<td colspan="2">Displays this file in your web browser.  (Only works in
		Windowed mode; hitting F1 from Fullscreen mode will not have any
		effect.)</td>
	</tr>
	<tr valign="top">
		<td class="MenuTitle">About LDView:</td>
		<td colspan="2">Shows the About box, which contains version and
		copyright information about LDView.</td>
	</tr>
</table>
<p>
<br/>
<a name="Toolbar"></a>
</p>
<div class="SectionHeader">Toolbar</div>
<p>
The toolbar allows you to quickly access certain features and settings.  A
number of the buttons on the toolbar are dual-purpose.  Clicking the button
toggles a particular setting on and off, and clicking the arrow next to the
button shows a menu that allows you to set other settings related to the
main one.  The items in the menu are only enabled if the main setting is
toggled on.
</p>
<p>
In Windows, if you right click on the toolbar, you will get a menu that allows
you to enable or disable the two sections of the toolbar (<i>Main</i> and
<i>Steps</i>), as well as customize the main section.  In macOS, you can use
the standard toolbar customization UI.  The default toolbar buttons are designed
to be useful by a wide audience, but consequently won't necessarily have the
toolbar buttons that individual users will find most useful.  It is highly
recommended that you customize the toolbar to suit your usage of LDView.
</p>
<p>

<br/>
</p>
<p>
<a name="Fullscreen"></a>
</p>
<div class="SectionHeader">Fullscreen Mode</div>
<p>
You can switch to fullscreen mode via the View menu.  To do so, select a color
depth and resolution combination, and then select the <span class="NoWrap">View-&gt;Switch</span> to
Fullscreen menu option, or hit Ctrl+Enter.  To exit full screen mode, either
hit Ctrl+Enter again or hit Escape.  Note that this feature does not work
properly on all video cards.  If it doesn't work on your video card, you should
get an error dialog after the screen resolution is changed.  After you dismiss
the error dialog, it should automatically switch back to windowed mode.  While
in fullscreen mode you can spin the model around with the mouse, and zoom in
and out the same way you did in windowed mode.
</p>
<p>
As long as your video card supports 2D Windows functionality while in fullscreen
mode, the Open dialog and Preferences dialog can be accessed from fullscreen mode
via their keyboard shortcuts  (Ctrl+O for Open File; Ctrl+Shift+P for
Preferences).  If you are unsure, try Ctrl+O first, and if you don't see an
Open dialog, hit escape to dismiss the Open dialog that you can't see.  F5 for
reload also works--whether or not your video card supports 2D Windows
funtionality from fullscreen mode--but unless you are displaying a file that
someone else on your network is modifying, it's not likely to be very useful.
</p>
<p>
<br/>
<a name="SaveSnapshotOptions"></a>
</p>
<div class="SectionHeader">Save Snapshot Options</div>
<p>
When you save a snapshot, the following LDView-specific options show up at the
bottom of the standard save dialog box.
</p>
<p>
<i><b><a name="SaveSeriesCheck">Save snapshot series</a></b></i> (Default:
<i>Off</i>):<br/>
Enabling this option causes a unique number to automatically be appended to the
filename.  This allows you to save a number of shots of the same model without
having to enter a new filename each time.
</p>
<p>
<i><a name="SaveDigitsField">Number of Digits</a></i> (Default: <i>1</i>):<br/>
This option is only available when save snapshot series is enabled.  It controls
the number of digits in the number that is appended to the filename.  Zeroes are
added before the number to make up the number of digits you select here.  For
example, if you select 3 here, and the number is 5, then 005 will be used in the
filename instead of just 5.
</p>
<p>
<i><b><a name="SaveSpecificSizeCheck">Save image with specific size</a></b></i>
(Default: <i>Off</i>):<br/>
Enabling this option allows you to specify a width and height for the snapshot
image.  Otherwise, the snapshot created will have the same dimensions as the
LDView window.
</p>
<p>
<i><a name="SaveWidthField">Width</a></i> (Default: <i>1024</i>):<br/>
This option is only available when save image with specific size is enabled.  It
sets the width (in pixels) of the resulting snapshot image.
</p>
<p>
Note that if this is bigger than a certain threshold (which differs from one
video card to another), a number of tiles will be rendered and stitched together
automatically to form the full image.  This may cause the actual image width to
be slightly less than the requested width due to rounding.
</p>
<p>
<i><a name="SaveHeightField">Height</a></i> (Default: <i>768</i>):<br/>
This option is only available when save image with specific size is enabled.  It
sets the height (in pixels) of the resulting snapshot image.
</p>
<p>
Note that if this is bigger than a certain threshold (which differs from one
video card to another), a number of tiles will be rendered and stitched together
automatically to form the full image.  This may cause the actual image width to
be slightly less than the requested width due to rounding.
</p>
<p>
<i><a name="SaveZoomToFitCheck">Zoom to Fit</a></i> (Default: <i>Off</i>):<br/>
This option is only available when save image with specific size is enabled.
Enabling it causes the model to be zoomed to fill up the snapshot, as much as
possible.  (Most models will only fill the image in either the vertical
direction or the horizontal direction, but not both.)  Note that the viewing
angle is left the same, but the model may be panned so that it fits best.
</p>
<p>
The reason this requires the <i>Save image with specific size</i>
check box to be checked is that when you save with a different aspect ratio, it
can effect the cropping of the model.  When creating a snapshot the same size
as the LDView window, you can position the model exactly like you want manually,
and are free to use <i>Zoom to Fit</i> on the View menu prior to taking your
snapshot to produce the same result.
</p>
<p>
<i><b>Misc</b></i>
</p>
<p>
<i><a name="NoPBufferCheck">Don't use Pixel Buffer</a></i> (Default:
<i>Off</i>):<br/>
Enabling this option disables the use of a pixel buffer for snapshot rendering.
Use of a pixel buffer can result in a corrupt image on certain video cards with
certain video drivers.  If your snapshots are corrupted, enable this.
Otherwise, leave it disabled.
</p>
<p>
<i><a name="TransBGCheck">Transparent Background</a></i> (Default: 
<i>Off</i>):<br/>
Enabling this option causes the backround area of the snapshot to be
transparent, instead of using whatever background color is selected in LDView.
This allows the image to be placed over other images in an editor, or over an
arbitrary background in a web page.  This only works with PNG snapshots, as the
other file formats don't support transparency.
</p>
<p>
<i><a name="AutoCropCheck">Auto-crop</a></i> (Default: <i>Off</i>):<br/>
Enabling this option causes the image to be automatically cropped to be as small
as possible without cutting off any of the actual model.  Note that this can be
useful even when <i>Zoom to Fit</i> is checked, because <i>Zoom to Fit</i>
usually only uses the entire image size in one dimension.
</p>
<p>
<i><b><a name="AllStepsCheck">All Steps</a></b></i> (Default: <i>Off</i>):<br/>
Enabling this option causes LDView to create a separate snapshot image for each
step, with an optional suffix, plus the step number, appended to each image.
</p>
<p>
<i><a name="StepSuffixField">Suffix</a></i> (Default: <i>&lt;Empty&gt;</i>):<br/>
This option is only available when all steps is enabled.  Enabling it causes the
specified suffix to be appended to the filename you enter right before the step
number is appended.  This allows you to accept the default filename (the model's
filename) when creating step images, even if you want something like -Step
appended to the end.
</p>
<p>
<i><a name="StepsSameScaleCheck">Same Scale</a></i> (Default: <i>On</i>):<br/>
This option is only available when all steps and zoom to fit are enabled.
Enabling it causes all step images to be generated with the same scale.  That
scale is calculated by applying the zoom to fit operation to the last step.
</p>
<p>
<a name="Export"></a>
</p>
<div class="SectionHeader">Exporting</div>
<p>
The Export command allows you to export your LDraw model to various different
3D file formats.  Currently, the following formats are supported:
</p>
<table class="SettingsList">
	<tr>
		<th>Extension</th>
		<th>Description</th>
	</tr>
	<tr>
		<td><a href="#PovExport">.pov</a></td>
		<td>POV-Ray scene file</td>
	</tr>
	<tr>
		<td><a href="#StlExport">.stl</a></td>
		<td>Stereo Lithography file</td>
	</tr>
	<tr>
		<td><a href="#3dsExport">.3ds</a></td>
		<td>3D-Studio file</td>
	</tr>
</table>
<p>
When you select <i>Export</i> from the <i>File</i> menu, you are presented with
a Save dialog box.  This includes a type selection, where you select the desired
format for the export.  In Windows and on the Mac, there is an <i>Options</i>
button next to the type selection. Some file types have export options, and some
don't.  For those that do, the <i>Options</i> button is enabled.  For those that
don't, it is disable.  Click on it to set the export options for the currently
selected file type. The Qt version of LDView has an <i>Export Options</i> menu
item in the <i>File</i> menu that performs the same task as the <i>Options</i>
button.  This dialog will only contain entries for those types that have
options.
</p>
<p/>
<h3><a name="PovExport">POV-Ray scene file:</a></h3>
<p>
LDView's POV-Ray export has numerous options.  The ones that aren't
self-explanatory are all documented via tooltips in the Options dialog.  When
you perform a POV-Ray export, LDView creates a POV-Ray scene file using the
current camera angle from the LDView window, so camera placement before the
export is important.
</p>
<p/>
<h3><a name="StlExport">Stereo Lithography file:</a></h3>
<p>
LDView's STL export doesn't have an options.  The STL file that it creates is
monochrome.  This option is mainly intended to allow parts to be exported for
editing in 3rd-party 3D modeling software such as Blender.
</p>
<p/>
<h3><a name="3dsExport">3D-Studio file:</a></h3>
<p>
LDView's 3D-Studio export has a few options.  They should all be
self-explanatory.  Note that many programs that support 3D-Studio files may not
work very well with the files generated by LDView.  Better compatibility is
ongoing work.
<br/>
</p>
<p>
<a name="CameraLocDialog"></a>
</p>
<div class="SectionHeader">Camera Location Dialog</div>
<p>
The Camera Location Dialog allows you to move the camera to any point in space.
</p>
<p>
Enter the desired X, Y, and Z coordinates into the dialog, and then decide
whether you want the camera to point to the center of the model, the origin
(0, 0, 0) in the model's coordinate system, or continue pointing the same
direction it is already pointing. When the dialog first shows, the X, Y, and Z
fields are populated with the camera's current location (in the model's
coordinate system).
</p>
<p>
Check the <i>Look as Model Center</i> check box to have the camera point at the
center of the model<a href="#ModelCenterFinePrint">*</a> from its new location.
Check the <i>Look at Origin</i> check
box to have the camera point at the model's origin. Uncheck both check boxes to
have the camera continue to point in the same direction it is already pointing.
If either check box is checked, the camera will be rotated in such a way that
the top of the viewport points toward the top of the model (as if the <i>Right
Side Up</i> menu item had been selected).
</p>
<p>
<div class="Note">
	<div><a name="ModelCenterFinePrint">*</a></div>
	<div>It actually points at the rotation center. By default, this is the
	center of the model, but it can be moved with the <a
	href="RotationCenterDialog">Rotation Center Dialog</a>.</div>
</div>
</p>
<p>
<a name="RotationCenterDialog"></a>
</p>
<div class="SectionHeader">Rotation Center Dialog</div>
<p>
The Rotation Center Dialog allows you to set the center point around which the
model rotates.
</p>
<p>
Enter the desired X, Y, and Z coordinates into the dialog, and then hit
<i>OK</i>. When the dialog first shows, the X, Y, and Z fields are populated
with the currently set rotation center for this model. If the default one has
not been overridden, that will be the center of the model's bounding box. If the
default one has been overridden, it will be that value.
</p>
<p>
LDView remembers the custom rotation center for every model based on its full
path on the file system when it is loaded. If you set the rotation center for a
model and later want to switch back to the default calculated center, hit the
<i>Reset</i> button.
</p>
<p>
Since the size of the model (and hence the default zoom level) is calculated
based on how far all the geometry in the model is from its rotation center,
changing the rotation center from the default value will cause the default zoom
level to be zoomed out relative to the default center.
</p>
<p>
<div class="Note">
	<div>Note:</div>
	<div>If you specify <i>ModelCenter</i> (either on the command line or via
		the native preference storing system on your platform), that will
		override this setting. In that case, the <i>ModelCenter</i> value will
		always be used, and always show up as the default X, Y, and Z values in
		the dialog. Entering new values in the dialog will have no effect.</div>
</div>
</p>
<p>
<a name="LatLonDialog"></a>
</p>
<div class="SectionHeader">Latitude/Longitude Dialog</div>
<p>
The Latitude/Longitude dialog allows you to change the fiew to a specific
latitude, longitude, and optionally distance.
</p>
<p>
Enter the desired latitude and longitude to rotate the model around so that you
are looking at it from the given direction.  Consider an imaginary globe
surrounding the model, centered at the model's center, with the front of the
model lining up with the globe at a the 0 longitude location.  The numbers you
enter rotate the model around such that you're looking down on the globe at the
specified latitude and longitude, with the top of your head facing towards the
north.
</p>
<p>
If you check the <i>Distance</i> check box, the camera will be placed at the
specified distance from the center of the model.
</p>
<p>
The <i>Default</i> buttons reset their associated fields to their default
values.  The default latitude is 30, the default longitude is 45, and the
default distance depends on the model.
</p>
<p>The <i>Current</i> button next to the <i>Distance</i> field sets the distance
field based on the current camera location.  This is useful if you want to take
snapshots of multiple different sized models at the same scale, as you can set
things up for the biggest model, then use the <i>Current</i> button to determine
the appropriate distance, then use that for all the snapshots.
</p>
<p>
The <i>Latitude</i> and <i>Longitude</i> fields don't have a <i>Current</i>
button, because LDView's arbitrary rotations don't usual correspond to a view
that can be produced by this dialog.  However, if you switch to
<a href="#LatLonMode">Latitude/Longitude Rotation</a> mode, the
<a href="#StatusBar">Status Bar</a> shows the current latitude/longitude.
</p>
<p>
<br/>
<a name="ErrorWindow"></a>
</p>
<div class="SectionHeader">Errors &amp; Warnings Window</div>
<p>
The Errors &amp; Warnings window displays errors and warnings that were
encountered while loading an LDraw model.
</p>
<p>
On the left-hand side is a tree view which displays all of the errors. By
default, there is one collapsed entry per error, with a brief description of the
error.  Clicking on the plus sign to the left of the error shows you more
information about that error.  The first piece of information is the file that
contained the error.  If you double-click on this, it will open the
file using Notepad.  Following that are the line # that contained the error, and
the line of text itself.  Neither of these has any actions associated with it.
Certain errors may contain further information as well.
</p>
<p>
Below the tree view is the <i>Include Warnings</i> check box.  Checking this
will cause LDView to show both errors and warnings.  Unchecking it will hide all
the warnings.  Please note that warnings don't mean there is anything wrong with
the file, so warnings are hidden by default.
</p>
<p>
Beside the <i>Include Warnings</i> check box is the <i>Copy Error to
Clipboard</i> button.  Clicking this will cause all the text from the currently
selected error to copied into the clipboard, so that it can be pasted into
another application.
</p>
<p>
On the right-hand side of the window is a list view containing a set of check
boxes that determine what types of errors should be shown.  By default, all
types of errors are shown.  You can disable any errors you don't care about.
Following are the error types:
</p>
<p>
<i>General error</i><br/>
You probably won't ever see an error of this type.  It is used for rare
situations that shouldn't ever happen.  (For example, if you delete the LDraw
directory while a model is loading, you might get one of these.)
</p>
<p>
<i>Parse error</i><br/>
A line in the model file was invalid.
</p>
<p>
<i>File not found</i><br/>
The model referenced another model which could not be found in any of the
standard search locations (the current directory; the LDraw model, parts, and
p directories; entries in the <a href="#ExtraDirs">extra search directories</a>
list).
</p>
<p>
<i>Singular matrix</i><br/>
The model contains a reference to another model with one of the three dimensions
scaled to zero.  This is generally considered bad form, but is often done when
referencing another file that happens to be two-dimensional.
</p>
<p>
<i>Part transformed non-uniformly</i><br/>
The model contains a part which has been distorted in some way.  While parts are
rotated and moved around to make up a model, they should seldom if ever be
stretched or skewed.  This usually indicates that the model referencing the part
has a problem.
</p>
<p>
<i>Non-flat quad</i><br/>
The model contains a quadrilateral (quad) that isn't flat.  There are two
perfectly valid ways to split a quad into two triangles, and they result in
different geometry when the quad isn't flat.  Consequently, non-flat quads are
considered to be errors.  Note that there is a reasonable amount of leeway in
LDView's definition of "flat", so rounding in the file shouldn't trigger this
error.
</p>
<p>
<i>Concave quad</i><br/>
The model contains a concave quadrilateral.  Concave means that one of the four
points is inside the triangle formed by the other three points.  While not
technically an error, this is considered bad form, and may produce incorrect
results in other LDraw-compatible renderering programs.
</p>
<p>
<i>Bad vertex sequence</i><br/>
The model contains a quadrilateral whose points are specified in "bow-tie"
order.  In other words, if you visit the points in the order given, you'll end
up with two triangles that meet at a point.  Two of the vertices must be
swapped in order to create the quad that was desired.  Once again, this isn't
techically an error (unless it is in a BFC-certified portion of a file), but is
considered bad form, and may produce incorrect results in other
LDraw-compatible rendering programs.
</p>
<p>
<i>Co-linear points</i><br/>
The model contains a quad or a triangle that has three or four co-linear points.
When this is detected in a quad, the quad is turned into a triangle (or a line
if all four points are co-linear).  When it is detected in a triangle (all three
points are co-linear), the triangle is turned into a line.  Note that some
people might think that using co-linear points in a quad is a valid way to get
rid of T-junctions (a computer graphic term whose explanation isn't important
here).  However, since there are two legitimate ways to split a quad into two
triangles, and one of those ways results in a triangle and a line (instead of
two triangles), this is <b>not</b> a legitimate way to avoid T-junctions.
</p>
<p>
<i>BFC warning</i><br/>
The model contains back-face culling (BFC) information that seems unusual (but
is still valid).
</p>
<p>
<i>BFC error</i><br/>
The model contains back-face culling (BFC) information that is invalid.
</p>
<p>
<i>MPD error</i><br/>
The model contains multi-part DAT (MPD) information that is invalid.
</p>
<p>
<i>Whitespace</i><br/>
The model references a sub-model whose filename contains whitespace (spaces
and/or tabs).  While this will work in some programs (including LDView), it
won't work in others, and is discouraged.
</p>
<p>
<i>Part renamed</i><br/>
The model references a part that has been renamed to a new number (otherwise
known as "moved to").
</p>
<p>
<i>Unofficial part used</i><br/>
The model references a part that isn't present in the main LDraw directory, but
was found by LDView on the LDraw.org Parts Tracker and automatically downloaded.
</p>
<p>
<i>Model loop</i><br/>
One of the model's sub-models (or parts) contains a reference to one of its
ancestors.  For example, if you load Test1.ldr, and it has Test2.ldr as a
sub-model, and Test2.ldr has Test1.ldr as one of <b>its</b> sub-models, you will
get this error.  Similarly, if Test2.ldr has Test3.ldr as a sub-model, and
Test3.ldr has Test1.ldr as a sub-model, you will also get this error.
</p>
<p>
If <a href="#ShowErrors">Show errors after loading</a> is checked in the
preferences dialog, the Errors &amp; Warnings window will automatically be
displayed when a model is loaded that contains errors that are set to be shown.
It will not be shown if the only errors in the model have been unchecked in the
Errors &amp; Warnings window, the model only contains warnings, or the Errors
&amp; Warnings window isn't set to show automatically.
</p>
<p>
<br/>
<a name="PartsListDialog"></a>
</p>
<div class="SectionHeader">Parts List Dialog</div>
<p>
The Parts List Dialog is used to generate an HTML file containing a parts list
for the currently loaded LDraw model.
</p>
<p>
At the top, it contains a list of settings to use during parts list generation.
At the bottom, it contains a list of columns to include in
the parts list.  Check all the columns you want to include, uncheck all the
columns you don't want to include, and use the <i>Up</i> and <i>Down</i> buttons
to change the order of the columns.
</p>
<p>
<span class="SubHeader">Settings</span><br/>
</p>
<p>
<i>Show model</i><br/>
Check this to include a screenshot of the model at the top of the parts list.
The screenshot will be saved in a file with the same name as the parts list HTML
file, except that the .html extension will be replaced with .png.<br/>
</p><p>
<i>Overwrite existing snapshot</i><br/>
If this is checked, any existing snapshot file with a filename matching the .png
one described above will be overwritten with a newly generated snapshot.  If
this is unchecked, and an image file already exists with the given name, the
existing image will be used in the parts list; a new image will not be
generated.
</p>
<p>
<i>Generate external style sheet</i><br/>
Check this to have LDView generate and use an external CSS style sheet, instead
of including the style information inside the generated HTML file.  LDView will
then generate a file named LDViewPartsList.css and use that as the style sheet
for the file.
</p>
<p>
<div class="Note">
	<div>Note:</div>
	<div>
		If a file named LDViewPartsList.css exists in the directory where
		the parts list HTML is written, LDView will examine its contents.  If
		the contents match the default LDViewPartsList.css, then the file will
		be used.  Otherwise, LDView will fall back to putting the style
		information inside the HTML file.  <b>If you modify LDViewPartsList.css
		and then generate a new parts list, the new parts list will not use
		LDViewPartsList.css, no matter what this setting is set to.</b>
	</div>
</div>
</p>
<p>
<i>Show part images</i><br/>
Check this to include inline links to <a href="http://peeron.com">Peeron.com</a>
part images in your generated HTML file.  If you check this, you must have an
active Internet connection in order to see the images when you view the Parts
List in your web browser.  If you don't have an active Internet connection,
you should see the alternate text for the images, which says "View on
Peeron.com".  You can still generate a Parts List with image links using LDView
even when you don't have an active Internet connection; you only need the
active connection in order to see the images when you view the page.
</p>
<p>
<span class="SubHeader">Columns</span><br/>
</p>
<p>
<i>Part</i><br/>
This column has the part name and part image.  The image is only present if
<i>Show part images</i> is checked in the <i>Settings</i> box.  If Peeron.com
has a part image in the correct color, that will be used.  Otherwise, a generic
gray part image will be used, and the background color of the image will be set
to the part color.
</p>
<p>
<i>Color</i><br/>
This column shows the color of the part.  This includes the LDraw color number,
the color name (if known), and a color sample.  Note that even if you don't
include this column, parts are still separated by color in the list.  (If you're
including the part images, this looks fine; otherwise, it's recommended that you
don't disable this column.)
</p>
<p>
<i>Quantity</i><br/>
This column contains the quantity for each part in each color.  Note that the
total part count for the model is in the header at the top of the file, and is
not optional.
</p>
<p>
<i>Description</i><br/>
This column contains the part description (as found in the LDraw file for the
part).  This is the only column that is disabled by default.
</p>
<p>
<a name="ModelTreeDialog"></a>
</p>
<div class="SectionHeader">Model Tree Dialog</div>
<p>
The Model Tree Dialog shows a tree view of the contents of the loaded LDraw
model.  The lines in the tree are color-coded based on the LDraw line type that
they show.  It also lets you control which LDraw line types are shown.  By
default, all line types except for empty and unknown ones are shown.
</p>
<p>
Above the tree is a search field, along with previous and next buttons. You can
use this to search for text in the model tree. Note that only enabled line types
get searched. If you want to find a specific part in a model, it's probably best
to disable the Comment line type before searching, and then searching for the
part number, with the .dat extension (for example, "3001.dat"). When a match is
found, the associated line in the tree is highlighted. If the tree view isn't
the current keyboard focus, this can be tough to see. Hitting enter will focus
the tree view in this case. The tree view is automatically focused when the
previous and next buttons are used.
</p>
<p>
Underneath the tree is a check box that, when checked, causes LDView to
highlight the geometry in the main 3D window for whatever line is selected in
the tree view.  You can also choose the highlight color.  If you use this to
select a part in a model, the whole part will be highlighted.  If you use it to
select the geometry inside a part, only that geometry will be highlighted.  On
the Mac, you can select multiple lines in the tree view; if you do so, all of
the associated items will be highlighted in the 3D view.
</p>
<p>
When you select a line in the tree, you can copy it using Ctrl+C in Windows and
Cmd+C in macOS.
<br/>
</p>
<p>
<a name="MPDDialog"></a>
</p>
<div class="SectionHeader">MPD Model Selection Dialog</div>
<p>
The MPD Model Selection Dialog allows you to select the individual model files
inside a Multi-Part Dat (MPD) file.  When you select a model, it is shown as if
that model had been loaded directly into LDView.
</p>
<p>
If you hit <i>OK</i> while a sub-model is selected, the dialog will go away, and
LDView will continue to show that sub-model.  If you hit <i>Cancel</i>, the
dialog will go away, and LDView will revert back to showing the main model.
<br/>
</p>
<p>
<a name="Prefs"></a>
</p>
<div class="SectionHeader">Preferences</div>
<p>
Here is a brief description of the items in the Preferences dialog (accessed
through the Edit-&gt;Preferences menu item).
</p>
<p>
<span class="SubHeader"><a name="GeneralTab">General Tab</a></span><br/>
</p>
<p>
<i>Reset</i>:<br/>
This resets all the General preferences to their default values.  As with all
other preference changes, you must hit OK or Apply for the reset values to go
into effect.
</p>

<p>
<span class="SubHeader2"><a name="GeneralAABox">Antialiasing Box</a></span><br/>
<i><a name="FSAA">FSAA</a></i> (Default: <i>None</i>):<br/>
This allows you to select what level of full-scene antialiasing to use.  Note
that if your video card does not support full-scene antialiasing, then
<i>None</i> will be the only available item.  If your video card does support
full-scene antialiasing, then all available FSAA modes should be available to
choose from.
<br/>
If you have an nVIDIA&#174; video card with Quincunx support, then 2x Enhanced
and 4x Enhanced should show up as options.  These use nVIDIA's advanced FSAA
filter.</p>
<p>
<i>Antialiased lines</i> (Default: <i>Off</i>):<br/>
Enabling this option causes lines to be drawn using antialiasing.  This does not
effect wireframe mode.  Line antialiasing can significantly improve the visual
quality of lines, but it can also significantly impact the frame rate.  This
option may not have an effect if <a href="#FSAA">Full-scene
Antialiasing</a> is enabled.
</p>

<p>
<span class="SubHeader2"><a name="GeneralCustomConfigBox">Custom Config Box</a></span><br/>
<i><a name="CustomConfig">Text Field</a></i> (Default: <i>Blank</i>):<br/>
This text field allows you to enter or paste the full path to an LDraw file that
you want to use for custom config. It is expected that a custom config file
would normally contain custom color definitions that get loaded after the
standard ones in LDConfig.ldr (if that is enabled). It can thus override any
colors that are defined in LDConfig.ldr, as well as define new colors.<br/>
The file can contain any valid LDraw statements, including geometry, but any
geometry specified by this file will be drawn in addition to any file that is
loaded. The geometry will not be included in model size calculations, so it may
be cropped.
</p>

<p>
<span class="SubHeader2"><a name="GeneralColorsBox">Colors Box</a></span><br/>
<i>Background</i> (Default: <i>Black</i>):<br/>
This allows you to set the color used to draw the background behind the model.
</p>
<p>
<i>Default</i> (Default: <i>Black</i>):<br/>
This allows you to set the default color.  Normally this is only visible when
you load a part directly.  Most models don't ever use this color.<br/>
Note that edge lines on default-colored objects will be black unless you choose
the exact RGB value used by one of the standard LDraw colors.  The default
custom colors in the color dialog correspond to the first 16 standard LDraw
colors.  Resetting the General preferences also resets these colors.
</p>
<p>
<i>Transparent</i> (Default: <i>Off</i>):<br/>
Enabling this option causes default-colored items to be transparent.
</p>
<p>
<i><a name="ProcessLDConfig">Process LDConfig.ldr</a></i>
(Default: <i>On</i>):<br/>
This controls whether or not LDView processes the LDConfig.ldr file that is now
distributed as part of the LDraw parts library.  This file contains settings
that can effect how LDraw models are displayed.  Currently the only settings it
contains are color definitions.  Enabling this option will use the LDraw.org
standard color definitions; disabling it will use LDView's default color
definitions.
</p>
<p>
<i>Random colors</i> (Default: <i>Off</i>):<br/>
Enabling this option causes the colors used in the model to be randomized.
While it works fine to randomize the colors of the parts in a model, it is
designed to be used by parts authors to randomize the colors of the geometric
primitives inside a part to make it easier to see their shape.
</p>

<p>
<span class="SubHeader2"><a name="GeneralMiscBox">Misc Box</a></span><br/>
<i>Show frame rate</i> (Default: <i>Off</i>):<br/>
Enabling this option causes the frame rate to show up in the lower left-hand
corner of the window.  A number is only displayed while the model is in
constant motion.  The easiest way to do this is to spin it (see
<a href="#MouseControl">mouse control</a>).
</p>
<p>
<i>Show Axes</i> (Default: <i>Off</i>):<br/>
Enabling this option causes LDView to drawn the XYZ coordinate axes for the
model, with their origin at the model's origin.  The X axis is drawn in red,
the Y axis is drawn in green, and the Z axis is drawn in blue.  The positive
axes are all drawn in bright colors, and the negative axes are all drawn in
dark colors.
</p>
<p>
<a name="ShowErrors"><i>Show errors after loading</i></a> (Default:
<i>On</i>):<br/>
Enabling this option causes the <a href="#ErrorWindow">Errors &amp; Warnings
window</a> to automatically be displayed after loading a model that contains any
errors that have been selected for display in the Errors &amp; Warnings window.
</p>
<p>
</p>
<i>Fullscreen refresh override</i> (Default: <i>Off</i>):<br/>
When checked, this setting allows you to override the default refresh rate used
in fullscreen mode.  Enter a number in the field for the desired refresh rate.
Please note that if the refresh rate you enter is not supported another refresh
rate will be used.<br/><br/>
<table>
	<tr>
		<td valign="top"><table cellspacing="0" CELLPADDING="0"
		bgcolor="RED"><tr><td><b> WARNING: </b></td></tr></table></td>
		<td valign="top">If you enter a value that is too high, and have told
		Windows that you have a monitor which is capable of higher refresh than
		what you actually have, you can damage your monitor.</td>
	</tr>
</table>
<p>
<i>Field of view</i> (Default: <i>45</i>):<br/>
Enter a number in this field to control the field of view (in degrees).  Setting
this to the minimum value of 0.1 will produce an image that is essentially
orthographic.  Setting it to the maximum value of 90 will produce a wide-angle
view.
</p>
<p>
<i>Memory Usage</i> (Default: <i>High</i>):<br/>
This allows you to have some control over how much memory LDView uses.
Normally, setting this to High will result in the best performance.  However, if
you load a large model that uses more memory than you have available, setting
this to Medium or Low may improve performance.
<br/>
Please note that while the High setting usually results in noticeably faster
performance than the Medium setting, it usually consumes only marginally more
memory.  The Low setting should produce a much more considerable memory savings.
Note also that if you use LDView to perform command line rendering, or use it as
the renderer in LPub (which is actually command line rendering), the Low setting
will likely be at least as fast as the other settings, and will very likely
actually result in faster performance.
</p>

<p/>
<span class="SubHeader2">Default Save Directories Box</span><br/>
The default save directories box allows you to decide what directory to use by
default when saving files.  Each save operation has three possible options:
<table class="SettingsList">
<tr>
<td valign="top">Model</td>
<td>The default directory is the same directory as the currently loaded
model.</td>
</tr>
<tr>
<td nowrap="nowrap" valign="top">Last Saved</td>
<td>The default directory is whatever directory was used last for this file
type.  (The first time you save a file of a given type, the default directory
is the model's directory.)</td>
</tr>
<tr>
<td valign="top">Specified</td>
<td>The default directory is specified in the field to the right of the
drop-down box.  Use the <i>Browse...</i> button to browse for a directory,
or enter it in the field directly.</td>
</tr>
</table>

<p>
<span class="SubHeader"><a name="LDrawTab">LDraw Tab</a></span><br/>
</p>
<p>
<i>Reset</i>:<br/>
This resets all the LDraw preferences to their default values.  As with all
other preference changes, you must hit OK or Apply for the reset values to go
into effect.
</p>
<p>
<i>LDraw Zip</i><br/>
This allows you to manually select a zip file containing the LDraw library to be
used in preference to the LDraw Folder below. Each parts release from ldraw.org
contains a file named complete.zip that you can use here. Additionally, if a
file named ldrawunf.zip exists alongside this zip file, it will automatically be
scanned for unofficial parts.<br/>
You can type in a path, or hit the <i>Browse...</i> button. If you type in a
path that doesn't resolve to a zip file, you will get an error when you apply
your preferences changes.
</p>
<p>
<i>LDraw Folder</i><br/>
This allows you to manually select the LDraw folder.<br/>
You can type in a path, or hit the <i>Browse...</i> button. If you type in a
path that isn't an LDraw folder, you will get an error when you apply your
preferences changes.<br/>
Note that if you specify an LDraw Zip, the LDraw Folder is no longer required to
have parts and p subdirectories. It still must be valid, though, since that is
where automatically downloaded unofficial parts will be placed.
</p>
<p>
<i><a name="ExtraDirs">Extra Search Folders/Directories</a></i><br/>
Allows you to specify and organize any number of extra search directories. When
LDView loads a model, and the model references a part or sub-model, it searches
for that part or sub-model in a number of locations. No matter what you enter
here, it will search the directory the model is located in, as well as the P,
PARTS, and MODELS directories inside the LDraw directory (in that order).  If it
doesn't find the file in any of those directories, it will then search all the
directories listed in the Extra Search Dirs dialog accessed via this menu item.
It searches them in the order they are listed in the box, so you can move
directories in the box up and down to get them in the order you want them to be
in.
</p>
<p>
<i>Use LDView to generate thumbnails for LDraw files (Mac Only)</i> (Default:
<i>On</i>):<br/>
Enabling this option causes LDView to generate QuickLook thumbnails for LDraw
files in Finder, as well as Open and Save panels in typical Mac applications. It
can slow the system down if you view a folder full of LDraw models in Icon mode
in Finder, so you may want to disable it if this is causing problems. Note that
it only supports files with .ldr and .mpd file extensions (not the .dat
extension originally used by LDraw, and still used for LDraw part files).
</p>

<p>
<span class="SubHeader"><a name="GeometryTab">Geometry Tab</a></span><br/>
</p>
<p>
<i>Reset</i>:<br/>
This resets all the Geometry preferences to their default values.  As with all
other preference changes, you must hit OK or Apply for the reset values to go
into effect.
</p>

<p>
<span class="SubHeader2"><a name="GeometryModelBox">Model Box</a></span><br/>
<a name="SeamWidth"><i>Seam width</i></a> (Default: <i>On/0.50</i>):<br/>
Enabling this option allows you to set the width of the seams between pieces
using the up and down arrows to the right.  This setting produces the same effect
as the Seam Width option of
<a href="http://home16.inet.tele.dk/hassing/l3p.html">L3P</a>.  The field then
displays the current seam width.  Use the arrows to set the seam width to a range
of numbers between 0.00 and 5.00. Note that setting this to large values can
produce extremely odd results.
</p>
<p>
<i>Part bounding boxes only</i> (Default: <i>Off</i>):<br/>
Enabling this option makes it so that all parts in the model are drawn as just
bounding boxes.  A bounding box is the minimum axis-aligned box that can
completely contain the part.  Geometry that isn't detected as being inside a
part is drawn normally.
</p>

<p>
<span class="SubHeader2"><a name="GeometryWireframeBox">Wireframe Box</a></span><br/>
<i>Wireframe</i> (Default: <i>Off</i>):<br/>
Enabling this option causes the model to be drawn in wireframe.  Note that with
many 3D accelerators, this actually runs slower than when drawing as a solid.
</p>
<p>
<i>Fog</i> (Default: <i>Off</i>):<br/>
This option is only enabled if wireframe drawing is enabled.  Enabling it
causes fog to be used to make it so that the lines that are farther away are
drawn more dimly.
</p>
<p>
<i>Remove hidden lines</i> (Default: <i>Off</i>):<br/>
This option is only available if wireframe drawing is enabled.  Enabling it
causes the solid (non-transparent) portions of the model to hide lines that are
behind them, even though these portions themselves aren't actually drawn.
</p>
<p>
<i>Thickness</i> (Default: <i>0%</i>):<br/>
This option is only available if wireframe drawing is enabled.  It adjusts the
thickness of the lines used to draw the model in wireframe mode.
</p>

<p>
<span class="SubHeader2"><a name="GeometryBFCBox">BFC Box</a></span><br/>
<i>BFC</i> (Default: <i>On</i>):<br/>
Enabling this option turns on back-face culling (BFC).  BFC is a technique that
can improve rendering performance by not drawing the back faces of polygons.
(Only BFC-certified parts have their back faces removed.)
<br/>
Note that while this can improve rendering performance, it can also slow things
down, so don't assume that enabling this will always result in the best
performance.
</p>
<p>
<i>Red back faces</i> (Default: <i>Off</i>):<br/>
This option is only available while BFC is enabled.  Enabling it causes the back
faces of polygons to be drawn in red.  This is mainly useful for part authors to
allow them to correctly specify which direction faces should face in order to
BFC certify their part files.<br/>
<i>See also:</i> <a href="#ColoredFacesNotes">Colored faces notes</a>.
</p>
<p>
<i>Green front faces</i> (Default: <i>Off</i>):<br/>
This option is only available while BFC is enabled.  Enabling it causes the
front faces of polygons to be drawn in green.  This is mainly useful for part
authors to allow them to correctly specify which direction faces should face in
order to BFC certify their part files.<br/>
<i>See also:</i> <a href="#ColoredFacesNotes">Colored faces notes</a>.
</p>
<p>
<i>Blue neutral faces</i> (Default: <i>Off</i>):<br/>
This option is only available while BFC is enabled.  Enabling it causes the
faces of non BFC certified polygons to be drawn in blue.  This is mainly useful
for part authors to allow them to correctly specify which direction faces should
face in order to BFC certify their part files.<br/>
<i>See also:</i> <a href="#ColoredFacesNotes">Colored faces notes</a>.
</p>
<p>
<br/>
<i><a name="ColoredFacesNotes">Colored faces notes</a></i>:<br/>
<ol>
<li>Enabling any of the BFC colored faces (red, green, blue) disables transparency.</li>
<li>Parts whose main color is a transparent color will show green front faces and
red back faces on their opaque geometry when these options are enabled. When they
are drawn normally, the opaque geometry in these parts has BFC disabled.</li>
</ol>
</p>
<p>
<span class="SubHeader2"><a name="GeometryEdgeLinesBox">Edge Lines Box</a></span><br/>
<a name="DrawEdges"><i>Edge Lines</i></a> (Default: <i>Off</i>):<br/>
Enabling this option causes the edge lines that outline all the pieces to be
drawn.
</p>
<p>
<i>Show edges only</i> (Default: <i>Off</i>):<br/>
This option is only available if edge lines are enabled.  Enabling it causes
LDView to only show edge lines.  Unless you also select the Wireframe option,
the portions of the edge lines that are hidden by the model will still be
hidden, even thought the model isn't being shown.
</p>
<p>
<i>Conditional lines</i> (Default: <i>Off</i>):<br/>
This option is only available if edge lines are enabled.  Enabling it causes
conditional edge lines to be computed and drawn.  Conditional edge lines show up
as a silhouette of curved surfaces; they are only drawn when they are visually
at the edge of the surface from the current viewing angle.
</p>
<p>
</p>
<div class="Indent">
<p>
<i>Show all</i> (Default: <i>Off</i>):<br/>
This option is only available if edge lines and conditional lines are enabled.
Enabling it causes all conditional edge lines to be drawn, whether or not they
are on a silhouette.  This option is primarily designed for part authors, since
it is often difficult to notice missing conditional lines.
</p>
<p>
<i>Show control pts</i> (Default: <i>Off</i>):<br/>
This option is only available if edge lines and conditional lines are enabled.
Enabling it causes lines to be drawn from the first point of each conditional
line to each of its two control points.  This option is primarily designed for
part authors, so they can verify that the control points are in the correct
location.
</p>
</div>
<p>
<i>High quality</i> (Default: <i>On</i>):<br/>
This option is only available if edge lines are enabled.  Enabling it causes
edge lines to be drawn slightly closer to the eye than everything else,
resulting in much better looking lines.
</p>
<p>
<i>Always black</i> (Default: <i>Off</i>):<br/>
This option is only available if edge lines are enabled.  Enabling it causes
all edge lines to be drawn in black or dark gray.  This can be particularly
useful to part authors, as it causes the edge lines for the default color (light
gray) to be much more visible.  Dark gray edges are used on dark colors, and
black edges are used on all other colors.<br/>
If <a href="#ProcessLDConfig"><i>Process LDConfig.ldr</i></a> is checked in the
General Preferences, LDView will look for a entries in LDConfig.ldr with color
names of Black_Edge and Dark_Gray_Edge.  If it finds either entry, it will use
that color instead of black or dark gray.
</p>
<p>
<i>Thickness</i> (Default: <i>0%</i>):<br/>
This option is only available if edge lines are enabled.  It adjusts the
thickness of the lines used to draw the edges around the pieces.
</p>

<p>
<span class="SubHeader"><a name="EffectsTab">Effects Tab</a></span><br/>
</p>
<p>
<i>Reset</i>:<br/>
This resets all the Effects preferences to their default values.  As with all
other preference changes, you must hit OK or Apply for the reset values to go
into effect.
</p>

<p>
<span class="SubHeader2"><a name="EffectsLightingBox">Lighting Box</a></span><br/>
<i>Lighting</i> (Default: <i>On</i>):<br/>
Enabling this option enables lighting.  If you disable lighting, it is strongly
recommended that you enable <a href="#DrawEdges">edge lines</a>, unless you are
in <a href="#GeometryWireframeBox">wireframe</a> mode.
</p>
<p>
<a name="QualityLighting"><i>High quality</i></a> (Default: <i>Off</i>):<br/>
This option is only available if lighting is enabled.  Selecting this enables
high quality lighting.  The easiest way to see the difference between having
this option on and off is with a baseplate.  If you angle a baseplate until the
<a href="#Specular">specular highlight</a> becomes visible (it gets shiny), and
then switch back and forth, you will see that the highlight is located in a
specific location when high quality lighting is enabled, and covers the entire
surface when it is disabled.  Enabling this can significantly decrease
performance, especially with large models.
</p>
<p>
<i>Subdued</i> (Default: <i>Off</i>):<br/>
This option is only available if lighting is enabled.  Selecting this sets the
lighting to a subdued level.  Subdued lighting is about halfway in between
standard lighting and no lighting at all.  This can produce nice results when
<a href="#DrawEdges">edge lines</a> are enabled.
</p>
<p>
<a name="Specular"><i>Specular highlight</i></a> (Default: <i>On</i>):<br/>
This option is only available if lighting is enabled.  Selecting this turns on
the specular highlight.  This causes the model to appear shiny.
</p>
<p>
<a name="AlternateLighting"><i>Alternate setup</i></a> (Default:
<i>Off</i>):<br/>
This option is only available if lighting is enabled.  Selecting this causes
LDView to use an alternate lighting setup, which may improve performance on some
video cards, but will more likely decrease performance.  The alternate setup is
used automatically when <a href="#Specular">specular highlight</a> is enabled,
whether or not this option is enabled, since specular highlight only works
properly with the alternate setup.
</p>
<p>
<a name="LightDirection"><i>Light direction</i></a><br/>
Set the direction the light comes from to a pre-set angle.<br/>
Please note: If you <a href="#MouseLightDirection">change the light direction
with the mouse</a>, it is almost certain that none of the pre-set light
direction buttons will be highlighted.
</p>
<p>
<i>Upper left</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from the upper left.
</p>
<p>
<i>Above</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from above.
</p>
<p>
<i>Upper right</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from the upper right.
</p>
<p>
<i>Left</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from the left.
</p>
<p>
<i>Middle</i>(Default?: <i>Yes</i>):<br/>
Set the light direction to come from the middle (always pointing in exactly the
same direction the camera is pointing).
</p>
<p>
<i>Right</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from the right.
</p>
<p>
<i>Lower left</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from the lower left.
</p>
<p>
<i>Below</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from below.
</p>
<p>
<i>Lower right</i>(Default?: <i>No</i>):<br/>
Set the light direction to come from the lower right.
</p>
<p>
<i>Use LIGHT.DAT lights</i>(Default: <i>On</i>):<br/>
This option is only available if lighting is enabled.  Selecting this causes
LDView to put point light sources in the scene in the locations where LIGHT.DAT
is used as a part.  LDView uses the color assigned to the light part as the
color for the light source.  Note that at most 8 lights will be shown by LDView
(the first 8 in the file), and if the video card doesn't support 8, then less
will be shown. 
</p>
<p>
<i>Replace standard light</i>(Default: <i>On</i>):<br/>
This option is only available if lighting is enabled and Use LIGHT.DAT lights is
checked.  Selecting this causes LDView to not use its standard light source any
time a model is loaded that contains one or more LIGHT.DAT parts.  Models that
don't contain any LIGHT.DAT parts will still be illuminated using LDView's
standard light source.  Note that using both LIGHT.DAT lights and the standard
light source will often result in too much light, leading to a kind of
overexposure effect. 
</p>
<p>
<i>Hide LIGHT.DAT geometry</i>(Default: <i>Off</i>):<br/>
Selecting this causes LDView to not display the geometry from LIGHT.DAT parts.
Since the geometry is a small set of 3D coordinate axes, you often don't want to
see it.
</p>

<p>
<span class="SubHeader2"><a name="EffectsStereoBox">Stereo Box</a></span><br/>
<i>Stereo</i> (Default: <i>Off</i>):<br/>
Enabling this option turns on stereo mode.  Stereo mode draws two images: a
slightly different one for each eye.
</p>
<p>
<i>Cross-eyed</i> (Default?: <i>No</i>):<br/>
This option is only available if stereo is enabled.  Selecting this sets the
stereo mode to cross-eyed stereo.  The two images are drawn side by side, with
the image for the right eye on the left and the image for the left eye on the
right.  By crossing your eyes and then focusing, you can see a stereoscopic
image.  Many people find it difficult or even impossible to focus with their
eyes crossed.
</p>
<p>
<i>Parallel</i> (Default?: <i>No</i>):<br/>
This option is only available if stereo is enabled.  Selecting this sets the
stereo mode to parallel stereo.  The two images are drawn side by side, with the
image for the right eye on the right and the image for the left eye on the left.
By looking in the distance and then focusing, you can see a stereoscopic image.
This will only work if the distance between the two images is no greater than
the distance between your eyes, so the window will need to be kept fairly
narrow.  Many people find it difficult or even impossible to look at an image in
this way and then focus.
</p>
<p>
<i>Amount</i> (Default: <i>50%</i>):<br/>
This option is only available if stereo is enabled.  The slider controls the
stereo spacing.  A small value will result in a very subtle stereoscopic effect,
as if you were looking at a very large object from a very long distance.  (The
minimum value results in no stereoscopic effect at all.)  A large value will
result in a pronounced stereoscopic effect, as if you were looking at a small
object from a very short distance.
</p>

<p>
<span class="SubHeader2"><a name="EffectsCutawayBox">Wireframe Cutaway
Box</a></span><br/>
<a name="WireframeCutaway"><i>Wireframe cutaway</i></a> (Default:
<i>Off</i>):<br/>
Enabling this option causes the cutaway portion of the model to be drawn in
wireframe.  Hold down the Control key and click and drag up with the right mouse
button to increase the amount of the model that is cut away.  Control right drag
down to decrease the cutaway amount.
</p>
<p>
<i>Color</i> (Default?: <i>No</i>):<br/>
This option is only available if wireframe cutaway is enabled.  Selecting it
causes the wireframe cutaway to be drawn in color.
</p>
<p>
<i>Monochrome</i> (Default?: <i>No</i>):<br/>
This option is only available if wireframe cutaway is enabled.  Selecting it
causes the wireframe cutaway to be drawn in monochrome.  This isn't available on
all graphics cards.
</p>
<p>
<i>Opacity</i> (Default: <i>100%</i>):<br/>
This option is only available if wireframe cutaway is enabled.  The slider
controls the opacity of the wireframe cutaway.  When Color is selected as the
type of wireframe cutaway to draw this may be fixed at 100% on some graphics
cards.  Also, when color is selected and sort is not selected in the
transparency box, transparent pieces will ignore the opacity setting and be
drawn with the standard opacity for transparent pieces.
</p>
<p>
<i>Thickness</i> (Default: <i>0%</i>):<br/>
This option is only available if wireframe cutaway is enabled.  The slider
controls the thickness of the lines in the wireframe cutaway.
</p>

<p>
<span class="SubHeader2"><a name="EffectsTransparencyBox">Transparency
Box</a></span><br/>
<i>Sort transparent polygons</i> (Default: <i>On</i>):<br/>
Enabling this option causes transparent shapes to be drawn in back-to-front
order in order to produce a correct result.  If they aren't sorted, distant
transparent shapes can end up being drawn as if they were in front of less
distant transparent shapes.  Unfortunately, this can cause a significant
slowdown in some models.  This option is mutually exclusive with the use stipple
pattern option.
</p>
<p>
<i>Use stipple pattern</i> (Default: <i>Off</i>):<br/>
Enabling this option causes transparent shapes to be drawn using a stipple
(checkerboard) pattern.  This may be significantly faster on some video hardware,
but with potentially reduced quality.  Using the stipple pattern totally
eliminates the errors that may occur where far transparent objects are drawn in
front of closer ones.  This option is mutually exclusive with the sort
transparent polygons option.
</p>

<p>
<span class="SubHeader2"><a name="EffectsMiscBox">Misc Box</a></span><br/>
<i>Flat shading</i> (Default: <i>Off</i>):<br/>
Enabling this option causes flat shading to be used.  Note that while flat
shading is less complicated to draw, with a modern 3D accelerator this will not
likely improve the performance at all. Flat shading will only likely provide a
visual difference if you have either <a href="#QualityLighting">high quality
lighting</a> or <a href="#PrimitiveSubstitution">primitive substitution</a>
enabled, in which case turning on flat shading can produce odd results.  This
option is mutually exclusive with the smooth curves option.
</p>
<p>
<i>Smooth curves</i> (Default: <i>On</i>):<br/>
Enabling this option causes curved surfaces to be shaded as curved surfaces
instead of as facets.  Since this relies on information in the LDraw model file
that was originally designed for a different purpose, not all curved surfaces
will be effected.  This option is mutually exclusive with the flat shading
option.
</p>

<p>
<span class="SubHeader"><a name="PrimitivesTab">Primitives Tab</a></span><br/>
</p>
<p>
<i>Reset</i>:<br/>
This resets all the Primitives preferences to their default values.  As with all
other preference changes, you must hit OK or Apply for the reset values to go
into effect.
</p>

<p>
<span class="SubHeader2"><a name="PrimitivesSubstitutionBox">Primitive Substitution
Box</a></span><br/>
<a name="PrimitiveSubstitution"><i>Primitive substitution</i></a> (Default:
<i>On</i>):<br/>
Enabling this option causes LDView to use its own optimized version of many of
the primitives (such as cylinders, cones, etc).  As well as providing enhanced
performance, this also provides improved visual quality, since smooth shaded
primitives are generated where appropriate.
</p>
<p>
<i>Use texture mapping</i> (Default: <i>On</i>):<br/>
Enabling this options causes LDView to display texture maps referenced in LDraw
files.
</p>
<p>
<i>Offset</i> (Default: <i>5</i>):<br/>
This option is only available if texture mapping is enabled. It controls how far
textures are pulled toward the camera before being drawn. If they aren't pulled
far enough, they may flicker or disappear entirely. If they are pulled too far,
they may show up around corners where they aren't supposed to be visible.
</p>
<p>
<i>Texture studs</i> (Default: <i>On</i>):<br/>
This option is only available if primitive substitution is enabled.  Enabling
it causes a LEGO&#174; logo to be textured onto all the standard studs.
</p>
<p>
<i>Nearest filtering</i> (Default?: <i>No</i>):<br/>
This option is only available if primitive substitution and texture studs are
both enabled.  Selecting it causes nearest texel texture filtering to be used.
This is the lowest quality texture filtering.
</p>
<p>
<i>Bilinear filtering</i> (Default?: <i>No</i>):<br/>
This option is only available if primitive substitution and texture studs are
both enabled.  Selecting it causes bilinear texture filtering to be used.
This is the middle quality texture filtering.
</p>
<p>
<i>Trilinear filtering</i> (Default?: <i>Yes</i>):<br/>
This option is only available if primitive substitution and texture studs are
both enabled.  Selecting it causes trilinear texture filtering to be used.
This is the highest quality texture filtering.
</p>
<p>
<i>Anisotropic filtering</i> (Default?: <i>No</i>):<br/>
This option is only available if primitive substitution and texture studs are
both enabled, and your video card supports it.  Selecting it causes anisotropic
texture filtering to be used.  When anisotropic filtering is selected, you can
pick the filtering level on the slider to the right of the radio button.  This
is the highest quality texture filtering.
</p>
<p>
<i>Anisotropic filtering level</i> (Default: <i>Off</i>):<br/>
This option is only available if primitive substitution and texture studs are
both enabled, and anisotropic filtering is selected as the filtering type.  It
adjusts the anisotropic filtering level.  Higher numbers produce higher quality
filtering.
</p>
<p>
<i>Curve quality</i> (Default: <i>2</i>):<br/>
This option is only available if primitive substitution is enabled.  It adjusts
the quality of substituted primitives by changing the number of facets used to
draw curved primitives.  Changing this from its default value can lead to holes
in the model between the substitute primitives and other geometry.  Be very
careful with this setting.  Setting it too high can lead to huge slow-downs.
The default setting of 2 is fine for most models.
</p>
<p>
<div class="Note">
	<div>Note:</div>
	<div>
		Setting this to the minimum value will result in incorrect
		rendering of n-16 primitives.
	</div>
</div>
</p>
<p>
<span class="SubHeader2"><a name="PrimitivesMiscBox">Misc Box</a></span><br/>
<i>Low quality studs (faster)</i> (Default: <i>On</i>):<br/>
Enabling this option switches to using the low-resolution stud files instead of
the normal-resolution stud files.  This can produce significantly faster
rendering.
</p>
<p>
<i>Use hi-res primitives when available</i> (Default: <i>Off</i>):<br/>
Enabling this option causes LDView to attempt to load hi-res versions of
primitives before loading the standard ones.  The hi-res primitives are
otherwise known as 48-sided primitives, because they approximate circular
features with 48-sided features.  Since not all primitives have hi-res versions,
enabling this can create gaps between the standard resolution primitives and
the hi-res ones.
</p>

<p>
<span class="SubHeader"><a name="UpdatesTab">Updates Tab</a></span><br/>
</p>
<p>
<i>Reset</i>:<br/>
This resets all the Updates preferences to their default values.  As with all
other preference changes, you must hit OK or Apply for the reset values to go
into effect.
</p>

<p>
<span class="SubHeader2"><a name="InternetProxyBox">Internet Proxy
Box</a></span><br/>
<i>Direct connection to the Internet</i> (Default?: <i>Yes</i>):<br/>
Select this if you have a direct connection to the Internet and don't want to
use a proxy server.</p>
<p>
<i>Use simple Windows proxy configuration</i> (Default?: <i>No</i>):<br/>
Select this if you want to use the HTTP proxy setting that you configured in
Internet Explorer.
</p>
<p/>
<i>Notes:</i>
<ul>
<li>This only works if you have a proxy server manually configured in Internet
Explorer.  Automatic proxy configurations are not supported.</li>
<li>As might be expected, this option is only available in the Windows version
of LDView.</li>
</ul>
<p>
<i>Manual proxy configuration</i> (Default?: <i>No</i>):<br/>
Select this to manually configure your HTTP proxy server in the space provided
below.
</p>
<p>
<i>Proxy</i> (Default: <i>None</i>):<br/>
Set this to the name or IP address of your HTTP proxy server.  This can only be
entered if Manual proxy configuration is selected above.
</p>
<p>
<i>Port</i> (Default: <i>None</i>):<br/>
Set this to the port of your HTTP proxy server.  This can only be entered if
Manual proxy configuration is selected above.
</p>

<p>
<span class="SubHeader2"><a name="MissingPartsBox">Missing Parts
Box</a></span><br/>
<i>Automatically check LDraw.org for missing parts</i> (Default: <i>On</i>):<br/>
Enabling this causes LDView to automatically check the LDraw.org Parts Tracker
when it can't find a file.  If the part exists on the Parts Tracker, it will
automatically be downloaded and used.
</p>
<p>
<div class="Note">
	<div>Note:</div>
	<div>
		If LDView fails to connect to the LDraw.org server while checking
		for an unofficial part, it will automatically disable this setting.  You
		have to manually re-enable it once you have a working Internet
		connection again.
	</div>
</div>
</p>
<p>
<i>Days between missing part checks</i> (Default: <i>7</i>):<br/>
Set this to the number of days you want LDView to wait between checks to the
LDraw.org Parts Tracker when a part cannot be found.  This delay is used when
the part cannot be found on the Parts Tracker.  This number must be greater than
zero.
</p>
<p>
<i>Days between updated part checks</i> (Default: <i>7</i>):<br/>
Set this to the number of days you want LDView to wait between checks for
updates to an unofficial part that it has successfully downloaded from the
LDraw.org Parts Tracker.  Since unofficial parts can update on the Parts
Tracker, LDView will check for updates with the specified frequency when it
encounters unofficial parts in a model.  This number must be greater than zero.
</p>

<p>
<span class="SubHeader"><a name="PreferenceSetsTab">Preference Sets
Tab</a></span><br/>
</p>
<p>
<i>Use the following preference set</i>:<br/>
This list shows all of the available preference sets.  Until you create new ones,
there is only one item in this list, named &lt;Default&gt;.  Selecting an item
from this list will cause LDView to use the preferences stored in that set after
you hit Apply.  If you have made any changes to preferences on other tabs and
select a new preference set, it will prompt you whether you want to apply those
changes, abandon them, or cancel your selection.
</p>
<p>
<i>Hot Key</i>:<br/>
This allows you to assign a hot key to the currently selected preference set.
There are 10 possible hot keys: Ctrl + Shift + 1 through Ctrl + Shift + 0.  Once
a hot key has been assigned to a preference set, you can use it when viewing a
model to immediately switch to that preference set.
</p>
<p>
<i>Delete</i>:<br/>
This deletes the currently selected preference set.
</p>
<p>
<i>New</i>:<br/>
This creates a new preference set that will initially contain all the current
settings.
</p>
<p>
<span class="SubHeader2">OK/Apply</span><br/>
Changing certain of the options above will require the model to either be
reprocessed, or reloaded entirely.  If you change any of these options, there
will be a pause after you hit OK or Apply while it either reprocesses or
reloads the model.  During this pause the status bar will display progress.  If
the status bar is not set to be visible, it will be made visible temporarily.
</p>

<p>
<span class="SubHeader"><a name="ScreenSaverTab">Screen Saver Tab</a></span><br/>
</p>
<p>
<b>Note:</b> This tab is only available when configuring the
<a href="#ScreenSaver">LDView screen saver.</a>
</p>
<p>
<i>File</i>:<br/>
Select this to have the LDView Screen Saver always display a specific file.  Use
the Browse button to the right to select the file.
</p>
<p>
<i>Browse</i> (next to File):<br/>
Use this to select the file that the LDView Screen Saver will display.
</p>
<p>
<i>Directory</i>:<br/>
Select this to have the LDView Screen Saver randomly select a model file from
the specified directory each time it runs.  The file will be randomly selected
from all the DAT, MPD, and LDR files in the directory.  Use the Browse button to
the right to select the directory.
</p>
<p>
<i>Browse</i> (next to Directory):<br/>
Use this to select the directory that the LDView Screen Saver looks in for
models.
</p>
<p>
<i>Size</i>:<br/>
Use this to control how large the model that is displayed by the LDView Screen
Saver will be.
</p>
<p>
<i>Speed</i>:<br/>
Use this to control how fast the model that is displayed by the LDView Screen
Saver moves.
</p>
<p>
<i>Rotation Speed</i>:<br/>
Use this to control how fast the model that is displayed by the LDView Screen
Saver rotates.
</p>
<p>
<i>Random Preference Set</i>:<br/>
Causes the screen saver to randomly choose a preference set each time it runs.
Since the file/directory choice is part of the preference set, this also allows
you to have different models displayed with different settings.
</p>
<p>
<i>Sleep Mode work-around</i>:<br/>
This will only be enabled if it is supported by your operating system.  Check
this if your system won't go into sleep mode when using the LDView Screen Saver,
even though it is set to go into sleep mode.  It may solve the problem.<br/>
Note that if you have a screen saver password set and use this, you will have a
blank screen if you wake the computer up from sleep mode and then cancel the
password prompt.
</p>
<p>
<i>Reset</i>:<br/>
This resets all the Screen Saver preferences to their default values.  As with
all other preference changes, you must hit OK or Apply for the reset values to
go into effect.
</p>

<br/>
<p>
</p>
<a name="CommandLine"></a>
<div class="SectionHeader">Command Line</div>
LDView allows you to do a few things from the command line.  LDView must either
be in your path, in the current directory, or have its complete path specified
on the command line in order to run (just like any other program run from the
command line).  If you are unfamiliar with running programs from the command
line, I would strongly suggest skipping this section.  Even if you are familiar
with running programs from the command line, please note that since LDView is
a normal Windows program, and not a console program, the command prompt may
behave as though LDView has exited immediately after it launches.  It won't
necessarily wait for LDView to exit before giving you another prompt.
<p>
<span class="SubHeader"><a name="CommandLineFilename">Specifying a
Filename</a></span><br/>
</p>
<p>
You can specify a filename on the command line, and LDView will open that file
(if it exists) instead of presenting you with the initial Open dialog.  You must
either specify the complete pathname of the file, including the extension
(e.g. .ldr, .dat, .mpd), or be in the directory that contains the file when you
run LDView.  Note that if your filename contains spaces, the entire filename
must be enclosed in double quotes.  (This is standard for any Windows command
line with long filenames.)
</p>
<p>
If the model you are loading is an MPD, you can specify the MPD sub-model to
display by following the filename with a colon, followed by the sub-model name.
For example, to display the engine.ldr sub-model of LDView's 8464.mpd sample
model, you would use the following command line:
</p>
<p>
<pre>
	LDView 8464.mpd:engine.ldr
</pre>
</p>
<p>
Note that the above format for the filename can also be used when creating
snapshots or performing exports from the command line.
</p>
<p>
<span class="SubHeader"><a name="SnapshotFilename">Specifying a Snapshot
Filename</a></span><br/>
</p>
<p>
You can use the -SaveSnapshot command line option to have LDView take a
snapshot of your model and output it to the specified filename automatically.
After creating the snapshot, LDView will immediately exit.  Note that this
only works if you also <a href="#CommandLineFilename">specify a filename</a> for
the model you want to take a snapshot of.  For example:
</p>
<p>
</p>
<PRE>
	LDView MyModel.ldr -SaveSnapshot=MyModel.png
</PRE>
<p>
The image filename must have .png, .bmp, or .jpg as its extension, and the
appropriate image type will be created accordingly.  Remember that control may
return to the command prompt before LDView has finished executing.  So if your
video card allows this to run without displaying a window, you won't have a
good way of knowing when LDView has finished executing.
</p>
<p>
<span class="SubHeader"><a name="SaveSnapshots">Requesting One or More
Snapshots</a></span><br/>
</p>
<p>
You can use the -SaveSnapshots=1 command line option to have LDView take
snapshots of all the models you list on the command line. After creating the
snapshot or snapshots, LDView will immediately exit.  Note that this
only works if you also <a href="#CommandLineFilename">specify at least one
filename</a> for the models you want to take a snapshots of. For example:
</p>
<p>
</p>
<PRE>
	LDView MyModel.ldr MyOtherModel.ldr -SaveSnapshots=1
</PRE>
<p>
The model file's extension will be replaced with an appropriate extension for
the snapshot's image type. By default, it will use the same image type as the
most recently taken snapshot in the LDView UI, or PNG by default. To specify
an image type, use <a href="#SaveImageTypeSetting">-SaveImageType</a> or
<a href="#SnapshotSuffixSetting">-SnapshotSuffix</a>.
</p>
<p>
If you don't want to list all the model filenames on the command line, you can
use -SaveSnapshotsList=&lt;List Filename&gt; to provide the filename of a file
that contains a list of model filenames, one entry per line. Each entry in the
list file will be treated as if you had specified it on the command line while
using -SaveSnapshots=1. You do not have to specify -SaveSnapshots=1 if you
specify a value for -SaveSnapshotsList.
</p>
<p>
<span class="SubHeader"><a name="ZMap">Requesting a Z Map File</a></span><br/>
</p>
<p>
LDView has the ability to create a Z Map file alongside each snapshot it
generates. The Z Map file has the same filename as the snapshot, but with an
extension of .ldvz. To cause LDView to generate Z Maps, use
<span class="NoWrap">-SaveZMap=1</span> on the command line. The Z Map file has
the following format:
</p>
<p>
<table class="SettingsList">
	<tr>
		<th>
			Field
		</th>
		<th>
			# Bytes
		</th>
		<th>
			Description
		</th>
	</tr>
	<tr>
		<td nowrap="nowrap">
			Magic Number
		</td>
		<td align="right">
			4
		</td>
		<td>
			The file's magic number. Its value is "ldvz".
		</td>
	</tr>
	<tr>
		<td>
			Endian
		</td>
		<td align="right">
			4
		</td>
		<td>
			Indicates whether the file is big endian or little endian. The file
			will always match the endianness of the computer it was created on.
			A value of "BIGE" indicates big endian, and "LITE" indicates little
			endian. All integer and floating point values in the file use the
			endianness indicated here.
		</td>
	</tr>
	<tr>
		<td>
			Width
		</td>
		<td align="right">
			4
		</td>
		<td>
			A 32-bit integer representing the width of the file.
		</td>
	</tr>
	<tr>
		<td>
			Height
		</td>
		<td align="right">
			4
		</td>
		<td>
			A 32-bit integer representing the height of the file.
		</td>
	</tr>
	<tr>
		<td nowrap="nowrap">
			Z Map
		</td>
		<td align="right" nowrap="nowrap">
			Width * Height * 4
		</td>
		<td>
			A collection of 32-bit floating point Z values corresponding to all
			of the pixels in the associated snapshot. Each Z value is a number
			from 0.0 to 1.0, where 1.0 indicates a pixel that is as far away as
			possible from the camera, and 0.0 indicates a pixel that is as close
			as possible to the camera. The first <i>Width</i> values represent
			the top row of the snapshot image. Then next <i>Width</i> values
			represent the next row of the snapshot image, and so on.
		</td>
	</tr>
</table>
</p>
<p>
<span class="SubHeader"><a name="ExportFilename">Specifying an Export
Filename</a></span><br/>
</p>
<p>
You can use the -ExportFile command line option to have LDView export
your model and output it to the specified filename automatically.
After performing the export, LDView will immediately exit.  Note that this
only works if you also <a href="#CommandLineFilename">specify a filename</a> for
the model you want to export.  For example:
</p>
<p>
</p>
<PRE>
	LDView MyModel.ldr -ExportFile=MyModel.pov
</PRE>
<p>
The export filename must have .pov, .stl, or .3ds as its extension, and the
appropriate export type will be peformed accordingly.  Remember that control may
return to the command prompt before LDView has finished executing.  So if your
video card allows this to run without displaying a window, you won't have a
good way of knowing when LDView has finished executing.
</p>
<p>
<span class="SubHeader"><a name="ExportFiles">Requesting One or More
Exports</a></span><br/>
</p>
<p>
You can use the -Exportfiles=1 command line option to have LDView export
all the models you list on the command line. After performing the
export or exports, LDView will immediately exit.  Note that this
only works if you also <a href="#CommandLineFilename">specify at least one
filename</a> for the models you want to take a snapshots of. For example:
</p>
<p>
</p>
<PRE>
	LDView MyModel.ldr MyOtherModel.ldr -ExportFiles=1
</PRE>
<p>
The model file's extension will be replaced with an appropriate extension for
the export's file type. By default, it will use the same export type as the
most recently performed export in the LDView UI, or POV by default. To specify
an export type, use <a href="#SaveExportTypeSetting">-SaveExportType</a> or
<a href="#ExportSuffixSetting">-ExportSuffix</a>.
</p>
<p>
If you don't want to list all the model filenames on the command line, you can
use -ExportFilesList=&lt;List Filename&gt; to provide the filename of a file
that contains a list of model filenames, one entry per line. Each entry in the
list file will be treated as if you had specified it on the command line while
using -ExportFiles=1. You do not have to specify -ExportFiles=1 if you specify
a value for -ExportFilesList.
</p>
<p>
<span class="SubHeader"><a name="Verbose">Verbose Output</a></span><br/>
</p>
<p>
LDView is capable of printing out errors and warnings when snapshots or exports
are performed from the command line. By default, errors are printed. To prevent
non-critical errors from printing, use the -q command line option. To prevent
all errors from printing, either repeat the -q option (-q -q), or use the -qq
option. To show warnings as well as errors, use the -v option.
</p>
<p>
In Windows, this only works if you run LDView.com from the command line (instead
of LDView.exe or LDView64.exe). If you just use "LDView", LDView.com will be run
automatically.
</p>
<p>
<span class="SubHeader"><a name="IniFile">Specifying an INI file</a></span><br/>
</p>
<p>
You can use -IniFile=&lt;path&gt; to have LDView use the specified INI file for
its settings. This only works from the command line.
</p>
<p>
Example INI file:
</p>
<PRE>
[General]
LDrawDir=/home/travis/ldraw
LineSmoothing=1
UseQualityStuds=1
Seams=0
ShowHighlightLines=1
</PRE>
<p>
Note: if running in a Unix-like operating system, you must put a space after the
equals sign if you want to use a ~ path. For example:
</p>
<PRE>
	LDView -IniFile= ~/SpecialSettings.ini
</PRE>
<p>
<span class="SubHeader"><a name="LDConfig">Specifying an Alternate to
LDConfig.ldr</a></span><br/>
</p>
<p>
You can use -LDConfig=&lt;file&gt; to have LDView load an alternate file to
the default LDConfig.ldr. This only matters if the <a
href="#ProcessLDConfigSetting">ProcessLDConfig</a> setting is enabled. In that
case, LDView will try to find the specified file listed with this setting.
If &lt;file&gt; is a full path to a file, that file will be used in place of
LDConfig.ldr. If &lt;file&gt; is just a filename, or it is a relative path,
LDView will try to find the file using its standard LDraw file search path,
and if that fails, it will try to find the file in the LDraw directory. If it
does not find the file, the default LDConfig.ldr will be used instead.
</p>
<p>
Example:
</p>
<PRE>
	LDView -LDConfig=LDCfgalt.ldr
</PRE>
<p>
<div class="Note">
	<div>Note:</div>
	<div>If you just want to override a few colors from the standard
	LDConfig.ldr, you can do that by setting a
	<a href="#GeneralCustomConfigBox">Custom Config</a>.</div>
</div>
</p>
<p>
<span class="SubHeader"><a name="L3PCompatibility">L3P-compatible
Options</a></span><br/>
</p>
<p>
To make things easier for L3P users, LDView supports the -cg and -ca options
from L3P.  Unlike normal LDView settings (described <a
href="#CommandLinePrefs">below</a>, -cg and -ca don't have any equal sign
after the option name.
</p>
<p>
</p>
<table>
<tr>
<td valign="top" nowrap="nowrap"><tt>-ca&lt;a&gt;</tt></td>
<td>
Camera Angle:<br/>
This sets the horizontal camera angle to the value specified by &lt;a&gt;.  Note
that this is different from the FOV setting (-FOV=&lt;a&gt;).  The FOV setting
sets either the vertical or horizontal camera angle depending on the shape of
the image.  If the image is wider than it is tall, it sets the vertical camera
angle, while if the image is taller than it is wide, it sets the horizontal
camera angle.  This -ca setting always sets the horizontal camera angle, no
matter what shape the image is.
</td>
</tr>
<tr>
<td valign="top" nowrap="nowrap"><tt>-cg&lt;la&gt;,&lt;lo&gt;[,&lt;r&gt;]</tt></td>
<td><a name="CameraGlobe">Camera Globe position:</a><br/>
This places the camera on an imaginary globe at latitude &lt;la&gt; and
longitude &lt;lo&gt;, pointing at the model.  If the radius &lt;r&gt; is zero or
not specified, LDView will use its standard camera distance calculation as the
radius for the imaginary globe.  Otherwise, the camera distance will be set to
&lt;r&gt;.</td>
</tr>
</table>
<p>
Example:
</p>
<PRE>
	LDView -cg30,45,50000 -ca0.1
</PRE>
<p>
<span class="SubHeader"><a name="CommandLinePrefs">Specifying
Preferences</a></span><br/>
</p>
<p>
All of the options available in the Preferences dialog can be set from the
command line, if so desired.  These are all preceded with a - in order to
indicate that an option is being specified.  Command line settings override
settings in the Preferences dialog.  They may be saved as a persistent preference
if you modify them or other preferences via the Preferences dialog.  Otherwise,
the old values will be used the next time you run the program without specifying
a value for those options on the command line.  Preferences are set on the
command line in the following manner:
</p>
<PRE>
	LDView -&lt;setting 1&gt;=&lt;value 1&gt; -&lt;setting 2&gt;=&lt;value 2&gt; ...
</PRE>
For example, to set the default window size to be 640x480, you would do the
following:
<PRE>
	LDView -WindowWidth=640 -WindowHeight=480
</PRE>
Below is a list of all the possible settings.  Note that while most of these
settings correspond directly to the Preferences dialog interface, some may have
inverted logic from the dialog (as noted).  The Type column can be any one of the
following:
<p>
</p>
<table>
	<tr>
		<td align="right" valign="top">Integer:&#160;&#160;</td>
		<td>
			An integer value with a wide range of possibilities.  There may be
			limitations on the range of valid values; if so, they will be listed
			in parentheses. Using a value outside a listed range will produce
			undefined results.
		</td>
	</tr>
	<tr>
		<td align="right" valign="top">Decimal:&#160;&#160;</td>
		<td>
			A numeric value that can include a decimal point.  There may be
			limitations on the range of valid values; if so, they will be listed
			in parentheses. Using a value outside a listed range will produce
			undefined results.
		</td>
	</tr>
	<tr>
		<td align="right" valign="top">Boolean:&#160;&#160;</td>
		<td>
			An integer value representing either true or false.  1 represents
			true; 0 represents false.  Other values produce undefined results
			(usually interpreted as true, but not necessarily).
		</td>
	</tr>
	<tr>
		<td align="right" valign="top">Enumerant:&#160;&#160;</td>
		<td>
			An integer value with a fixed number of possible values, each of
			which corresponds to a choice that probably isn't related to the
			numeric value in any way.  If you use a number that isn't one of
			the options listed, it will produce undefined results.
		</td>
	</tr>
	<tr>
		<td align="right" valign="top">Color:&#160;&#160;</td>
		<td>
			An integer value representing a 24-bit RGB color.  The bottom 24
			bits of the value specify the RGB color desired.  The top 8 bits are
			ignored. It is suggested (but not required) that this be specified
			as a hexadecimal value by prefixing the number with 0x.  So, to have
			a bright blue color, you would specify 0xFF0000.  Note that in
			hexidecimal format, the order is 0xBBGGRR (2 blue digits, followed
			by 2 green digits, followed by 2 red digits).
		</td>
	</tr>
	<tr>
		<td align="right" valign="top">String:&#160;&#160;</td>
		<td>
			A free-form character string.
		</td>
	</tr>
</table>
<p>
The <i>Global?</i> column indicates whether the setting is a global setting, or
one that is preference set-specific.  Global settings apply to all preference
sets, while preference set-specific settings are saved with each preference set.
In general, settings that show up in the Preferences dialog are preference
set-specific, while others aren't.
</p>
<p>
<span class="SubHeader"><a name="PrefList">List of All Preferences</a></span><br/>
</p>
<p>
</p>
<table bgcolor="#FFFFDD" CELLPADDING="5" cellspacing="0" class="SettingsList">
	<tr>
		<th>Setting</th>
		<th>Type</th>
		<th>Global?</th>
		<th>Description</th>
	</tr>
	<tr>
		<td valign="top">
			AllowPrimitiveSubstitution
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Primitives-&gt;Primitive substitution</i> check
			box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="AnisoLevelSetting">AnisoLevel</a>
		</td>
		<td valign="top">
			Integer
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Anisotropic filtering</i> slider in the
			<i>Primitives-&gt;Primitive substitution</i> box.  Note that this
			value is ignored if the
			<a href="#TextureFilterTypeSetting">TextureFilterType</a> setting
			isn't set to trilinear/anisotropic.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Antialias
		</td>
		<td valign="top">
			Integer
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>General-&gt;Antialiasing-&gt;FSAA</i> combo
			box.  Selects which FSAA option to request:<br/>
			0: none (<i>Full-scene Antialiasing</i> check box not checked).<br/>
			2: 2x<br/>
			3: 2x Enhanced<br/>
			4: 4x<br/>
			5: 4x Enhanced<br/>
			16+: FSAA level * 8 (see below)<br/>
			Note that while all but the first option request FSAA to be used, it
			will only be used on graphics hardware that supports FSAA in
			addition to supporting the OpenGL extension that allows it to be set
			from a program other than the driver control panel.<br/>
			Any standard FSAA mode can be requested by taking the desired FSAA
			level and multiplying by 8.  For example, 6x FSAA on ATI cards can
			be requested by setting Antialias to 48.  If you request a mode that
			isn't supported by your video card, you end up with no antialiasing.
		</td>
	</tr>
	<tr>
		<td valign="top">
			AutoCrop
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivlent to the <a href="#AutoCropCheck"><i>Auto-crop</i></a> check
			box in the <a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a>
			dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			BackgroundColor3
		</td>
		<td valign="top">
			Color
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>General-&gt;Background color</i> button.  Note
			that it is easiest to specify in hex, in the form 0xRRGGBB, where
			RR, GG, and BB are hexidecimal numbers between 00 and FF.  (The 3
			was appended to the end of the name because it used to be in
			0xBBGGRR format, and would have caused a problem during the
			upgrade if it had used the same name.)
		</td>
	</tr>
	<tr>
		<td valign="top">
			BFC
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Geometry-&gt;BFC</i> check box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			BlackHighlights
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Always black</i> check box in the
			<i>Geometry-&gt;Edge Lines</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			BottomMargin
		</td>
		<td valign="top" nowrap="nowrap">
			Integer<br/>
			(0-???)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to 1000 times the value of the <i>Bottom</i> field in the
			<i>Margins</i> box on the Page Setup dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			BoundingBoxesOnly
		</td>
		<td valign="top" nowrap="nowrap">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to <i>Part bounding boxes only</i> check box in
			the <i>Geometry-&gt;Model</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CameraGlobe
		</td>
		<td valign="top" nowrap="nowrap">
			String<br/>
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Same as <a href="#CameraGlobe">-cg</a> L3P-compatible option.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CheckPartTracker
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Automatically check LDraw.org for missing
			parts</i> check box in the <i>Updates-&gt;Missing Parts</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CheckPartUpdateWait
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Days between updated part checks</i> field in
			the <i>Updates-&gt;Missing Parts</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CheckPartWait
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Days between missing part checks</i> field in
			the <i>Updates-&gt;Missing Parts</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="CommandLinesListSetting">CommandLinesList</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Only valid from the command line. Instructs LDView to use the lines
			in the specified file as independent command lines. Each line in the
			file is treated as its own separate command line. Also, optionally,
			the first line of the file can begin with "Common: " (without the
			quotes). If it does, everything else on that line will be added to
			every other command line in the file. All options except the
			CommandLinesList option from the original command line are also
			added to each new command line generated by the list file. If you
			want to generate snapshots from a bunch of different angles for one
			LDraw model, doing it using this option is much faster, since the
			LDraw file then only has to be loaded once, and then rendered at
			each angle and saved to a snapshot.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ConditionalHighlights
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Conditional lines</i> check box in the
			<i>Geometry-&gt;Edge Lines</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CurveQuality
		</td>
		<td valign="top" nowrap="nowrap">
			Integer<br/>
			(1-12)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Curve quality</i> slider in the
			<i>Primitives-&gt;Primitive substitution</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CustomColors/Color00 -<br/>
			CustomColors/Color15
		</td>
		<td valign="top" nowrap="nowrap">
			Color
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Controls the colors that show up in the <i>Custom colors</i> boxes
			on the Color dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CustomConfigPath
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the value in the text field in the
			<a href="#GeneralCustomConfigBox"><i>General-&gt;Custom
			config</i></a> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CutawayAlpha
		</td>
		<td valign="top" nowrap="nowrap">
			Integer<br/>
			(1-100)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Opacity</i> slider in the <i>Effects-&gt;Wireframe
			cutaway</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			CutawayMode
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Color</i> and <i>Monochrome</i> radio buttons
			and the <i>Wireframe cutaway</i> check box in the
			<i>Effects-&gt;Wireframe cutaway</i> box.  Selects the cutaway
			mode:<br/>
			0: None (<i>Wireframe cutaway</i> check box not checked)<br/>
			1: Color<br/>
			2: Monochrome
		</td>
	</tr>
	<tr>
		<td valign="top">
			CutawayThickness
		</td>
		<td valign="top">
			Decimal<br/>
			(0-5)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Thickness</i> slider in the
			<i>Effects-&gt;Wireframe cutaway</i> box. See
			<a href="#LineThicknesses">Note 6</a> about line thicknesses.
		</td>
	</tr>
	<tr>
		<td valign="top">
			DefaultColor3
		</td>
		<td valign="top">
			Color
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>General-&gt;Default color</i> button.  Note
			that it is easiest to specify in hex, in the form 0xRRGGBB, where
			RR, GG, and BB are hexidecimal numbers between 00 and FF.  (The 3
			was appended to the end of the name because it used to be in
			0xBBGGRR format, and would have caused a problem during the
			upgrade if it had used the same name.)
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="DefaultLatitudeSetting">DefaultLatitude</a>
		</td>
		<td valign="top">
			Float
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Latitude to use when view is reset when in
			<a href="#LatLonMode">Latitude/Longitude Rotation Mode.</a>  For
			command line snapshots, latitude to use if neither
			<a href="#DefaultLatLongSetting">DefaultLatLong</a> nor
			<span class="NoWrap"><a href="#CameraGlobe">-cg</a></span> command
			line arguments are used.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="DefaultLatLongSetting">DefaultLatLong</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Default camera latitude and longitude.  See the
			<a href="#DefaultLatLong">description</a> below for info on using
			this value on the command line.  Note that setting this value on
			the command line (or in the registry) overrides the
			<a href="#DefaultMatrixSetting">DefaultMatrix</a> setting.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="DefaultLongitudeSetting">DefaultLongitude</a>
		</td>
		<td valign="top">
			Float
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Longitude to use when view is reset when in
			<a href="#LatLonMode">Latitude/Longitude Rotation Mode.</a> For
			command line snapshots, longitude to use if neither
			<a href="#DefaultLatLongSetting">DefaultLatLong</a> nor
			<span class="NoWrap"><a href="#CameraGlobe">-cg</a></span> command
			line arguments are used.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="DefaultMatrixSetting">DefaultMatrix</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Default rotation matrix.  This is used to record the default viewing
			angle.  See the <a href="#DefaultMatrix">description</a> below for
			info on using this value on the command line.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="DefaultZoomSetting">DefaultZoom</a>
		</td>
		<td valign="top">
			Decimal<br/>(0.1-???)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Default zoom level.  Set it to a value greater than 1.0 to have the
			default view (and other standard views) be zoomed in closer, or a
			value less than 1.0 to have them be further away.  There is
			currently no way to change this setting using the LDView user
			interface.  Note that if you set it too high, the
			<a href="#ZoomMaxSetting">ZoomMax</a> setting will take over, and
			prevent the view from being zoomed in so far.
		</td>
	</tr>
	<tr>
		<td valign="top">
			DrawLightDats
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Use LIGHT.DAT lights</i> check box in the
			<i>Effects-&gt;Lighting</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Editor
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Sets the editor to use when you double click on the source file line
			in the Errors &amp; Warnings window.  The program listed must either
			be in the path, or the full path to the program must be given.  The
			default is "notepad.exe".  Note that there is no way to set this
			value in the LDView interface.
		</td>
	</tr>
	<tr>
		<td valign="top">
			EdgesOnly
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Draw only edges</i> check box in the
			<i>Geometry-&gt;Edge Lines</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			EdgeThickness
		</td>
		<td valign="top">
			Decimal<br/>
			(0-5)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Thickness</i> slider in the <i>Geometry-&gt;Edge
			Lines</i> box. See <a href="#LineThicknesses">Note 6</a> about line
			thicknesses.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ExamineMode
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Selects the examine rotation mode:<br/>
			0: Normal rotation<br/>
			1: Latitude/Longitude rotation<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ExportFileSetting">ExportFile</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Designed for use on the command line.  The value given is used as a
			filename, and LDView automatically creates an export of the
			specified model and outputs to this file.  See
			<a href="#SnapshotFilename">here</a> for more information.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ExportFilesSetting">ExportFiles</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Only valid from the command line.  Instructs LDView to create
			one or more exports, one for each LDraw file on the command line.
			The exports get the filename of the LDraw file with the extension
			replaced with an appropriate one based on the export
			type.  By default, exports are stored in the same directory as the
			model files.  However, this can be overridden with the
			<a href="#ExportsDirSetting">ExportsDir</a> setting.  Use the
			<a href="#ExportSuffixSetting">ExportSuffix</a> setting to
			specify the export type.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ExportsDir
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Exports</i> field in the
			<i>General-&gt;Default Save Directories</i> box.  Selects the
			default directory for export saves when
			<a href="#ExportsDirModeSetting">ExportsDirMode</a> is set to
			2.<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ExportsDirModeSetting">ExportsDirMode</a>
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Exports</i> popup in the
			<i>General-&gt;Default Save Directories</i> box.  Selects the mode
			for default save directory selection:<br/>
			0: Model directory<br/>
			1: Last Used<br/>
			2: Selected<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ExportSuffixSetting">ExportSuffix</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Suffix to use when determining what file format to use for the
			export.  This is designed to be used on the command line in
			conjunction with the
			<a href="#ExportFiles">-ExportFiles</a> option to specify the
			file type of the exports, or with the
			<a href="#ExportFilename">-ExportFile</a> option so that you
			can specify a temporary file on the command line without being
			forced to give the temporary file a known suffix.  Currently, the
			only values that are recognized are:<br/>
			.pov<br/>
			.stl<br/>
			.3ds<br/>
			(Note that the dot preceding the extension is required.)
		</td>
	</tr>
	<tr>
		<td valign="top">
			ExtraSearchDirs/Dir001 -<br/>
			ExtraSearchDirs/Dir999
		</td>
		<td valign="top" nowrap="nowrap">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Contains the list of extra search directories specified using the
			<a href="#ExtraDirs">Extra Dirs</a> setting.  Each entry specifies
			a directory, and the entries are sorted in the order they are put in
			by the user.  I think it's unlikely you'd want to manually set any
			of these, either on the command line or via the registry, but the
			keys are documented here for completeness.
		</td>
	</tr>
	<tr>
		<td valign="top">
			FOV
		</td>
		<td valign="top" nowrap="nowrap">
			Decimal<br/>(0.1-90.0)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Field of view</i> field in the
			<i>General-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="FullscreenDepthSetting">FullscreenDepth</a>
		</td>
		<td valign="top">
			Integer
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Color depth used for full-screen display.  This will normally be
			either 16 or 32, but other values (such as 15 and 24) may work on
			some video cards.  Future video cards will presumably even support
			64.  Use this setting with caution, and only specify one of the
			depths that shows up on the View menu; specifying an unsupported
			color depth may result in problems when you try to switch to
			full-screen mode.  Note that while I listed the type for this as an
			integer, and didn't specify a range, the only values that will
			actually work are the ones that show up on the View menu when LDView
			is run.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="FullscreenHeightSetting">FullscreenHeight</a>
		</td>
		<td valign="top">
			Integer
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Vertical resolution used for full-screen display.  As with the
			<a href="#FullScreenDepthSetting">FullscreenDepth</a> setting, care
			should be taken when specifying this option.  Also, you should
			always specify the
			<a href="#FullScreenWidthSetting">FullscreenWidth</a> setting when
			you specify this setting, and make sure the width, height, and
			depth combine to make a video mode supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			FullscreenRefresh
		</td>
		<td valign="top">
			Integer
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Fullscreen refresh override</i> check box and
			field in the <i>General-&gt;Misc</i> box.  Setting this to 0 causes the
			check box to not be checked.  Any other value checks the check box
			and is used as the override value.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="FullscreenWidthSetting">FullscreenWidth</a>
		</td>
		<td valign="top">
			Integer
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Horizontal resolution used for full-screen display.  As with the
			<a href="#FullScreenDepthSetting">FullscreenDepth</a> setting, care
			should be taken when specifying this option.  Also, you should
			always specify the
			<a href="#FullScreenHeightSetting">FullscreenHeight</a> setting when
			you specify this setting, and make sure the width, height, and
			depth combine to make a video mode supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			GreenFrontFaces
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Green front faces</i> check box in the
			<i>Geometry-&gt;BFC</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			HiResPrimitives
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Use hi-res primitives when available</i> check
			box in the <i>Primitives-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			HighlightModelEdgesNoDepth
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Causes LDView to ignore the other geometry while drawing the edge
			lines of the Model Tree highlight. This has the effect of making the
			edge lines for the highlight show through other solid geometry. This
			is enabled by default. There is currently no way to change this
			setting using the LDView user interface.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreAllOGLExtensions
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore all OpenGL extensions supported by your
			video card.  Some video drivers are buggy, and ignoring all or some
			OpenGL extensions that they claim to support may correct problems
			in LDView.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreAniso
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the GL_EXT_texture_filter_anisotropic OpenGL
			extension, even if it is supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreFramebufferObject
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the GL_EXT_framebuffer_object OpenGL
			extension, even if it is supported by your video card.  Note that
			this extension is only used in the Qt version of LDView.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreMultiDrawArrays
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the GL_EXT_multi_draw_arrays OpenGL
			extension, even if it is supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreMultisample
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the WGL_ARB_multisample OpenGL extension,
			even if it is supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreMultisampleFilterHint
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the GL_NV_multisample_filter_hint OpenGL
			extension, even if it is supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnorePBuffer
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#NoPBufferCheck"><i>Don't use Pixel
			Buffer</i></a> check box in the
			<a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a> dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnorePixelFormat
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the WGL_ARB_pixel_format OpenGL extension,
			even if it is supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreVAR
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the GL_NV_vertex_array_range OpenGL
			extension, even if it is supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IgnoreVBO
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to ignore the GL_ARB_vertex_buffer_object OpenGL
			extension, even if it is supported by your video card.
		</td>
	</tr>
	<tr>
		<td valign="top">
			IniFile
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Specifies an INI file to use for settings in place of whatever
			would normally be used (registry on Windows, Qt settings on Qt,
			User Defaults on Mac, ~/.ldviewrc on OSMesa). This only works when
			specified on the command line. See <a href="#IniFile">here</a> for
			more details.
		</td>
	</tr>
	<tr>
		<td valign="top">
			InstallPath
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Only used in screen saver mode (where command line options can't be
			given).  Used to find LDView data files (font and stud logo) when
			running as a screen saver.  Only included in this list for
			completeness.
		</td>
	</tr>
	<tr>
		<td valign="top">
			InventoryExternalCss
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Generate external style sheet</i> check box in
			the <i>Parts List</i> dialog.  Since you can't currently generate a
			Parts List HTML page from the command line, setting this setting
			from the command line has extremely limited value.
		</td>
	</tr>
	<tr>
		<td valign="top">
			InventoryPartImages
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Show part images</i> check box in the <i>Parts
			List</i> dialog.  Since you can't currently generate a Parts List
			HTML page from the command line, setting this setting from the
			command line has extremely limited value.
		</td>
	</tr>
	<tr>
		<td valign="top">
			InventoryShowFile
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Show generated web page</i> check box in the
			<i>Parts List</i> dialog.  Since you can't currently generate a
			Parts List HTML page from the command line, setting this setting
			from the command line has extremely limited value.
		</td>
	</tr>
	<tr>
		<td valign="top">
			InventoryShowModel
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Show model</i> check box in the <i>Parts
			List</i> dialog.  Since you can't currently generate a Parts List
			HTML page from the command line, setting this setting from the
			command line has extremely limited value.
		</td>
	</tr>
	<tr>
		<td valign="top">
			LastOpenPath
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Path used as the initial path for the first Open File dialog box
			displayed.  This is normally the last path that a file was opened
			from the last time LDView was run.
		</td>
	</tr>
	<tr>
		<td valign="top">
			LDConfig
		</td>
		<td valign="top" nowrap="nowrap">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Specifies an alternative file to use in place of the default
			LDConfig.ldr. See <a href="#LDConfig">here</a> for more details.
		</td>
	</tr>
	<tr>
		<td valign="top">
			LDrawDir
		</td>
		<td valign="top" nowrap="nowrap">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Specifies the full path to the directory containing LDraw.
		</td>
	</tr>
	<tr>
		<td valign="top">
			LeftMargin
		</td>
		<td valign="top">
			Integer<br/>
			(0-???)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to 1000 times the value of the <i>Left</i> field in the
			<i>Margins</i> box on the Page Setup dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Lighting
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Effects-&gt;Lighting</i> check box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			LightVector
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Sets the direction for the main light source.  This must be three
			decimal numbers, separated by commas.  Sample values:<br/>
			<table class="SampleData">
				<tr>
					<td align="right">0,0,1:</td>
					<td>Straight ahead (default)</td>
				</tr>
				<tr>
					<td align="right">-1,1,1:</td>
					<td>Upper left</td>
				</tr>
				<tr>
					<td align="right">1,1,1:</td>
					<td>Upper right</td>
				</tr>
				<tr>
					<td align="right">-1,-1,1:</td>
					<td>Lower left</td>
				</tr>
				<tr>
					<td align="right">1,-1,1:</td>
					<td>Lower right</td>
				</tr>
			</table>
		</td>
	</tr>
	<tr>
		<td valign="top">
			LineSmoothing
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>General-&gt;Antialiased lines</i> check box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="MaxRecentFilesSetting">MaxRecentFiles</a>
		</td>
		<td valign="top">
			Integer<br/>
			(0-99)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Controls how many recent files are recorded and displayed.  Note
			that there is no way to set this value in the LDView interface.
		</td>
	</tr>
	<tr>
		<td valign="top">
			MemoryUsage
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>General-&gt;Misc-&gt;Memory Usage</i> combo
			box.  Selects the memory usage mode:<br/>
			0: Low<br/>
			1: Medium<br/>
			2: High<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			ModelCenter
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Set this to override the default camera placement algorithm.  If you
			set this, the given value is used as the center of the model.  The
			default camera placement algorithm uses this location to center the
			model on the screen.  The value is specified as three
			comma-separated decimal numbers.  Example:<br/>
			-ModelCenter=0.0,0.0,0.0
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ModelSizeSetting">ModelSize</a>
		</td>
		<td valign="top">
			Decimal<br/>
			(Greater than 0.0)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Set this to override the default camera positioning algorithm.  If
			you set this, the given value is used as the diameter of the sphere
			that is considered to fully enclose the model.  The automatic camera
			distance algorithm positions the camera such that this entire sphere
			is visible in the default view.  Note that if you provide a value
			that is smaller than the actual calculated size, cropping of your
			model may occur. Note that specifying this will automatically force
			the <a href="#SaveZoomToFitSetting">SaveZoomToFit</a> setting to be
			disabled.
		</td>
	</tr>
	<tr>
		<td valign="top">
			MultiThreaded
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Set this to NO to disable multi-threading on muli-processor systems.
			In theory, this should only be useful for debugging purposes, and
			consequently cannot be set from the UI.
		</td>
	</tr>
	<tr>
		<td valign="top">
			NoLightGeom
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Hide LIGHT.DAT geometry</i> check box in the
			<i>Effects-&gt;Lighting</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			OneLight
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Alternate setup</i> check box in the
			<i>Effects-&gt;Lighting</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			OptionalStandardLight
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Replace standard light</i> check box in the
			<i>Effects-&gt;Lighting</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Orientation
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Sets the paper orientation during printing:<br/>
			1: Portrait<br/>
			2: Landscape
		</td>
	</tr>
	<tr>
		<td valign="top">
			PaperSize
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Sets the paper size during printing.  There are too many sizes to
			list all of them here, but here are some of the standard sizes:<br/>
			1: Letter (8.5 x 11 in)<br/>
			3: Tabloid (11 x 17 in)<br/>
			5: Legal (8.5 x 14 in)<br/>
			8: A3 (297 x 420 mm)<br/>
			9: A4 (210 x 297 mm)<br/>
			If you want to use another size, you can print using that size in
			LDView, and then look at the following key in the registry:<br/>
			HKEY_CURRENT_USER/Software/Travis Cobbs/LDView/PaperSize
		</td>
	</tr>
	<tr>
		<td valign="top">
			PartsListsDir
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Parts Lists</i> field in the
			<i>General-&gt;Default Save Directories</i> box.  Selects the
			default directory for parts list saves when
			<a href="#PartsListsDirModeSetting">PartsListsDirMode</a> is set to
			2.<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="PartsListsDirModeSetting">PartsListsDirMode</a>
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Parts Lists</i> popup in the
			<i>General-&gt;Default Save Directories</i> box.  Selects the mode
			for default save directory selection:<br/>
			0: Model directory<br/>
			1: Last Used<br/>
			2: Selected<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			PerformSmoothing
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Smooth curves</i> check box in the
			<i>Effects-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Poll
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Selects the polling mode:<br/>
			0: Disabled<br/>
			1: Prompt<br/>
			2: Auto-update when active<br/>
			3: Auto-update immediately
		</td>
	</tr>
	<tr>
		<td valign="top">
			PolygonOffset
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>High quality</i> check box in the
			<i>Geometry-&gt;Edge Lines</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			PovCameraAspect
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Tools-&gt;Use current aspect ratio for POV-Ray
			camera</i> menu item.
		</td>
	</tr>
	<tr>
		<td valign="top">
			PreferenceSet
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Activates the specified preference set.
		</td>
	</tr>
	<tr>
		<td valign="top">
			PrintBackground
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Print Background Color</i> check box in the
			Page Setup dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ProcessLDConfigSetting">ProcessLDConfig</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Process LDConfig.ldr</i> check box in the
			<i>General-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ProxyPortSetting">ProxyPort</a>
		</td>
		<td valign="top">
			Integer<br/>
			(0-65535)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Port</i> field in the <i>Updates-&gt;Internet
			Proxy</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="ProxyServerSetting">ProxyServer</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Proxy</i> field in the <i>Updates-&gt;Internet
			Proxy</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ProxyType
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Direct connection to the Internet</i>, <i>Use
			simple Windows proxy configuration</i>, and <i>Manual proxy
			configuration</i> radio buttons in the <i>Updates-&gt;Internet
			Proxy</i> box.  Selects the proxy type:<br/>
			0: No proxy<br/>
			1: Simple Windows proxy<br/>
			2: Manual proxy<br/>
			The Windows setting is only available in the Windows verion of
			LDView.  If you set this to 2 (manual), you must also make sure that
			the <a href="#ProxyServerSetting">ProxyServer</a> and
			<a href="#ProxyPortSetting">ProxyPort</a> settings are set
			correctly.
		</td>
	</tr>
	<tr>
		<td valign="top">
			RecentFiles/File01 -<br/>
			RecentFiles/File99
		</td>
		<td valign="top" nowrap="nowrap">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Contains the list of recent files.  Each entry specifies the full
			path to one of the files.  File01 contains the most recently
			opened file.  By default, only File01 - File10 are used.  You must
			set the <a href="#MaxRecentFilesSetting">MaxRecentFiles</a> setting
			to a value greater than 10 in order for any of the other entries
			to be used.  I don't see any reason you'd want to change any of
			these, but it is documented here for the sake of completeness, and
			for those people who peruse the registry trying to see how things
			work.
		</td>
	</tr>
	<tr>
		<td valign="top">
			RedBackFaces
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Red back faces</i> check box in the
			<i>Geometry-&gt;BFC</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			RemoveHiddenLines
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Remove hidden lines</i> check box in the
			<i>Geometry-&gt;Wireframe</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			RightMargin
		</td>
		<td valign="top">
			Integer<br/>
			(0-???)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to 1000 times the value of the <i>Right</i> field in the
			<i>Margins</i> box on the Page Setup dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveActualSize
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the inverse of the
			<a href="#SaveSpecificSizeCheck"><i>Save image with specific
			size</i></a> check box on the
			<a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a> dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveAlpha
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#TransBGCheck"><i>Transparent
			Background</i></a> check box in the
			<a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a> dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveDigits
		</td>
		<td valign="top">
			Integer<br/>
			(1-5)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#SaveDigitsField"><i>Number of
			Digits</i></a> field in the <a href="#SaveSnapshotOptions"><i>Save
			Snapshot</i></a> dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveDirSetting">SaveDir</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Only valid from the command line.  Used in conjunction with the
			<a href="#SaveSnapshotsSetting">SaveSnapshots</a> setting or the
			<a href="#ExportFilesSettings">ExportFiles</a> setting to
			specify the directory in which to store the output.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveExportTypeSetting">SaveExportType</a>
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Spefies the default type for exports:<br/>
			1: POV<br/>
			2: STL<br/>
			3: 3DS<br/>
			Note that command line exports using the -ExportFile command
			line option use the file extension, and ignore this setting.  If
			the <a href="#ExportSuffixSetting">ExportSuffix</a> setting is
			specified, that overrides the extension in the actual export
			filename.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveHeight
		</td>
		<td valign="top">
			Integer<br/>
			(1-9999)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#SaveHeightField"><i>Height</i></a> field
			in the <a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a>
			dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveImageTypeSetting">SaveImageType</a>
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Spefies the default image type for snapshot saves:<br/>
			1: PNG<br/>
			2: BMP<br/>
			3: JPG<br/>
			Note that command line snapshots using the -SaveSnapshot command
			line option use the file extension, and ignore this setting.  If
			the <a href="#SnapshotSuffixSetting">SnapshotSuffix</a> setting is
			specified, that overrides the extension in the actual snapshot
			filename.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveScaleFactor
		</td>
		<td valign="top">
			Decimal
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Only valid from the command line. Sets the scale factor used for
			snapshot saves. This has a number of effects. First of all, the
			generated image size will be multiplied by this factor. So, if you
			request 1024x1024, you will get a 2048x2048 snapshot. Secondly, if
			the output image format is PNG, the DPI of the generated image will
			be set to 72 * this scale factor. Finally, line widths will be
			multiplied by this scale factor, unless they are set to 0, in
			which case they will be 1 pixel wide.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveSeries
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#SaveSeriesCheck"><i>Save snapshot
			series</i></a> check box in the
			<a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a> dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveSnapshotSetting">SaveSnapshot</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Designed for use on the command line.  The value given is used as a
			filename, and LDView automatically takes a snapshot of the specified
			model and outputs to this file.  See
			<a href="#SnapshotFilename">here</a> for more information.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveSnapshotsSetting">SaveSnapshots</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Only valid from the command line.  Instructs LDView to create
			multiple snapshots, one for each LDraw file on the command line.
			The snapshots get the filename of the LDraw file with the extension
			replaced with an appropriate one based on the output image file
			type.  By default, images are stored in the same directory as the
			model files.  However, this can be overridden with the
			<a href="#SaveDirSetting">SaveDir</a> setting.  Use the
			<a href="#SnapshotSuffixSetting">SnapshotSuffix</a> setting to
			specify the image type.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveSnapshotsListSetting">SaveSnapshotsList</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Only valid from the command line.  Instructs LDView to create
			multiple snapshots, one for each LDraw file listed in the provided
			list file. The list file shold contain one LDraw filename per line.
			The snapshots get the filename of the LDraw file with the extension
			replaced with an appropriate one based on the output image file
			type.  By default, images are stored in the same directory as the
			model files.  However, this can be overridden with the
			<a href="#SaveDirSetting">SaveDir</a> setting.  Use the
			<a href="#SnapshotSuffixSetting">SnapshotSuffix</a> setting to
			specify the image type.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveStepsSetting">SaveSteps</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#AllStepsCheck"><i>All Steps</i></a>
			check box in the <a href="#SaveSnapshotOptions"><i>Save
			Snapshot</i></a> dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveStepsSameScaleSetting">SaveStepsSameScale</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#StepsSameScaleCheck"><i>Same
			Scale</i></a> check box in the
			<a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a> dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveStepsSuffixSetting">SaveStepsSuffix</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#StepSuffixField"><i>Suffix</i></a> field
			in the <a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a>
			dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveWidth
		</td>
		<td valign="top" nowrap="nowrap">
			Integer<br/>
			(1-9999)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <a href="#SaveWidthField"><i>Width</i></a> field
			in the <a href="#SaveSnapshotOptions"><i>Save Snapshot</i></a>
			dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SaveZMap
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Causes LDView to generate a <a href="#ZMap">Z Map file</a> for each
			snapshot saved.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SaveZoomToFitSetting">SaveZoomToFit</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Mostly equivalent to the <a href="#SaveZoomToFitCheck"><i>Zoom to
			Fit</i></a> check box in the <i>Save Snapshot</i> dialog box.<br/>
			<br/>
			In addition, if you use the
			<a href="#SaveSnapshotSetting">SaveSnapshot</a> setting and set
			this setting to 1 on the command line, the resulting image will be
			zoomed to fit.  Note that you can use this in combination with the
			<a href="#DefaultZoomSetting">DefaultZoom</a> setting on the command
			line to zoom in or out.  Setting DefaultZoom to 0.95, for instance,
			will provide a small margin all the way around the model. Note that
			this setting is automatically disabled if the
			<a href="#ModelSizeSetting">ModelSize</a> setting is specified.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Seams
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Seam Width</i> check box in the
			<i>Geometry-&gt;Model</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SeamWidth
		</td>
		<td valign="top" nowrap="nowrap">
			Integer<br/>
			(0-500)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to 100 times the value of the <i>Seam Width</i> field in
			the <i>Geometry-&gt;Model</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowAllType5
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Show all</i> check box under the <i>Conditional
			lines</i> check box in the <i>Geometry-&gt;Edge Lines</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowAxes
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Show Axes</i> check box in the
			<i>General-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Show errors after loading</i> check box in the
			<i>General-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError00
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>General Error</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError01
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Parse Error</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError02
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>File Not Found</i> check box in the Errors
			&amp; Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError03
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Singular Matrix</i> check box in the Errors
			&amp; Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError04
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Part transformed non-uniformly</i> check box in
			the Errors &amp; Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError05
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Non-flat quad</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError06
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Concave quad</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError07
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Bad vertex sequence</i> check box in the Errors
			&amp; Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError08
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Identical vertices</i> check box in the Errors
			&amp; Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError09
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Co-linear points</i> check box in the Errors
			&amp; Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError10
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>BFC Warning</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError11
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>BFC Error</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError12
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>MPD Error</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError13
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Whitespace</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError14
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Part renamed</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError15
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Unofficial part used</i> check box in the
			Errors &amp; Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrors/LDLError16
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Model loop</i> check box in the Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowErrorsMessageBox
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			If generating a snapshot or an export on the command line in Windows without
			using LDView.com, setting this to 1 will cause errors to be shown in a
			message box after the run has completed.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowFPS
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Show frame rate</i> check box in the
			<i>General-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowHighlightLines
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Geometry-&gt;Edge Lines</i> check box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowWarnings
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Include Warnings</i> check box Errors &amp;
			Warnings window.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ShowType5ControlPoints
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Show control pts</i> check box under the
			<i>Conditional lines</i> check box in the <i>Geometry-&gt;Edge
			Lines</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SnapshotSuffixSetting">SnapshotSuffix</a>
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Suffix to use when determining what file format to use for the
			snapshot.  This is designed to be used on the command line in
			conjunction with the
			<a href="#SaveSnapshots">-SaveSnapshots</a> option to specify
			the file type of the snapshots, or with the
			<a href="#SnapshotFilename">-SaveSnapshot</a> option so that you
			can specify a temporary file on the command line without being
			forced to give the temporary file a known suffix.  Currently, the
			only values that are recognized are:<br/>
			.bmp<br/>
			.png<br/>
			.jpg<br/>
			(Note that the dot preceding the extension is required.)
		</td>
	</tr>
	<tr>
		<td valign="top">
			SnapshotTNMetas
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			When used on the command line during snapshot saving, requests that
			Gnome-compatible metadata be written to PNG snapshots, as long as
			the LDraw file's filename is specified using a file:// URI.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SnapshotsDir
		</td>
		<td valign="top">
			String
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Snapshots</i> field in the
			<i>General-&gt;Default Save Directories</i> box.  Selects the
			default directory for snapshot saves when
			<a href="#SnapshotsDirModeSetting">SnapshotsDirMode</a> is set to
			2.<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="SnapshotsDirModeSetting">SnapshotsDirMode</a>
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Snapshots</i> popup in the
			<i>General-&gt;Default Save Directories</i> box.  Selects the mode
			for default save directory selection:<br/>
			0: Model directory<br/>
			1: Last Used<br/>
			2: Selected<br/>
		</td>
	</tr>
	<tr>
		<td valign="top">
			SortTransparent
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Sort</i> check box in the
			<i>Effects-&gt;Transparency</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			StatusBar
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Status Bar</i> menu item in the <i>View</i>
			menu.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Step
		</td>
		<td valign="top">
			Integer
		</td>
		<td valign="top">
			N/A
		</td>
		<td valign="top">
			Only available from the command line.  When used in conjunction with
			a command line snapshot save, causes the specified step to be saved
			in a model that has multiple steps.  When used on the command line
			without a snapshot save command line, causes LDView to immediately
			jump to the indicated step after loading the model.
		</td>
	</tr>
	<tr>
		<td valign="top">
			StereoMode
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Cross-eyed</i> and <i>Parallel</i> radio
			buttons and the <i>Stereo</i> check box in the
			<i>Effects-&gt;Stereo</i> box.  Selects the stereo mode:<br/>
			0: None (<i>Stereo</i> check box not checked)<br/>
			2: Cross-eyed<br/>
			3: Parallel
		</td>
	</tr>
	<tr>
		<td valign="top">
			StereoSpacing
		</td>
		<td valign="top">
			Integer<br/>
			(0-100)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Amt</i> slider in the <i>Effects-&gt;Stereo</i>
			box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			SubduedLighting
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Subdued</i> check box in the
			<i>Effects-&gt;Lighting</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Texmaps
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Use texture mapping</i> check box in the
			<i>Primitives-&gt;Primitive substitution</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="TextureFilterTypeSetting">TextureFilterType</a>
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Nearest filtering</i>, <i>Bilinear
			filtering</i>, <i>Trilinear filtering</i>, and <i>Anisotropic
			filtering</i> radio buttons in the <i>Primitives-&gt;Primitive
			 substitution</i> box.  Selects the texture mode:<br/>
			<table class="SampleData">
				<tr>
					<td align="right">9984:</td>
					<td>Nearest filtering</td>
				</tr>
				<tr>
					<td align="right">9985:</td>
					<td>Bilinear filtering</td>
				</tr>
				<tr>
					<td align="right" valign="top">9987:</td>
					<td>Trilinear filtering or Anisotropic filtering<br/>
					If <a href="#AnisoLevelSetting">AnisoLevel</a> is set to 1,
					this gives you trilinear filtering.  If it is set to a value
					greater than 1, and your video card supports anisotropic
					filtering, this gives you anisotropic filtering.</td>
				</tr>
			</table>
		</td>
	</tr>
	<tr>
		<td valign="top">
			TextureOffsetFactor
		</td>
		<td valign="top">
			Decimal<br>
			(1-10)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Offset</i> slider in the
			<i>Primitives-&gt;Primitive substitution</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			TextureStuds
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Texture studs</i> check box in the
			<i>Primitives-&gt;Primitive substitution</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Toolbar
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Toolbar</i> menu item in the <i>View</i> menu.
		</td>
	</tr>
	<tr>
		<td valign="top">
			TopMargin
		</td>
		<td valign="top" nowrap="nowrap">
			Integer<br/>
			(0-???)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to 1000 times the value of the <i>Top</i> field in the
			<i>Margins</i> box on the Page Setup dialog box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Topmost
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Always on Top</i> menu item in the <i>View</i>
			menu.
		</td>
	</tr>
	<tr>
		<td valign="top">
			TransDefaultColor
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Transparent</i> check box in the
			<i>General-&gt;Colors</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			UseFlatShading
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Flat shading</i> check box in the
			<i>Effects-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			UseQualityLighting
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>High quality</i> check box in the
			<i>Effects-&gt;Lighting</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			UseQualityStuds
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the inverse of the <i>Low quality studs (faster)</i>
			check box in the <i>Primitives-&gt;Misc</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			UseSpecular
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Specular highlight</i> check box in the
			<i>Effects-&gt;Lighting</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			UseStipple
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Stipple</i> check box in the
			<i>Effects-&gt;Transparency</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			UseStrips
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Set this to false on the command line to prevent LDView from using
			triangle strips, quad strips, or triangle fans during primitive
			substution. This will likely result in slightly slower rendering.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="VerifyLDrawSetting">VerifyLDrawDir</a>
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Allows you to run LDView without having LDraw installed, if you want
			to use it to view LDraw-format models that don't use the LDraw parts
			library.  If this is set to 0, LDView won't prompt for the location
			of the LDraw directory, even if it doesn't see it.  Note that there
			is no way to set this value in the LDView interface.
		</td>
	</tr>
	<tr>
		<td valign="top">
			ViewMode
		</td>
		<td valign="top">
			Enumerant
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Equivalent to the <i>Examine Mode</i> and <i>Fly-through Mode</i>
			menu items in the <i>View</i> menu.  Selects the viewing mode:<br/>
			0: Examine Mode<br/>
			1: Fly-through Mode
		</td>
	</tr>
	<tr>
		<td valign="top">
			VisualStyleEnabled
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Controls whether or not LDView uses the current Windows XP Visual
			Style when running in Windows XP.  Doesn't have any effect on
			earlier versions of Windows.  Set this to 0 if you prefer the
			legacy Windows look-and-feel.  Note that the main window border will
			still use the Windows XP style in Windows XP.  Note also that there
			is no way to set this value in the LDView interface.
		</td>
	</tr>
	<tr>
		<td valign="top">
			WindowHeight
		</td>
		<td valign="top">
			Integer<br/>
			(240-???)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Specifies the initial height of the LDView window.  Note that the
			height of the actual model viewing area will be smaller than this,
			due to the window borders, title bar, menu bar, toolbar, and status
			bar.  The maximum is dependent on the resolution of your display.
			Specifying a value greater than the maximum will result in a window
			that is the maximum allowable height.
		</td>
	</tr>
	<tr>
		<td valign="top">
			WindowMaximized
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Specifies whether or not LDView should start out with its window
			maximized.
		</td>
	</tr>
	<tr>
		<td valign="top">
			WindowWidth
		</td>
		<td valign="top" nowrap="nowrap">
			Integer<br/>
			(320-???)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Specifies the initial width of the LDView window.  Note that the
			width of the actual model viewing area will be smaller than this,
			due to the window borders.  The maximum is dependent on the
			resolution of your display.  Specifying a value greater than the
			maximum will result in a window that is the maximum allowable width.
		</td>
	</tr>
	<tr>
		<td valign="top">
			Wireframe
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Geometry-&gt;Wireframe</i> check box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			WireframeFog
		</td>
		<td valign="top">
			Boolean
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Fog</i> check box in the
			<i>Geometry-&gt;Wireframe</i> box.
		</td>
	</tr>
	<tr>
		<td valign="top">
			WireframeThickness
		</td>
		<td valign="top">
			Decimal<br/>
			(0-5)
		</td>
		<td valign="top">
			NO
		</td>
		<td valign="top">
			Equivalent to the <i>Thickness</i> slider in the
			<i>Geometry-&gt;Wireframe</i> box. See
			<a href="#LineThicknesses">Note 6</a> about line thicknesses.
		</td>
	</tr>
	<tr>
		<td valign="top">
			<a name="#ZoomMaxSetting">ZoomMax</a>
		</td>
		<td valign="top">
			Integer<br/>
			(1-???)
		</td>
		<td valign="top">
			YES
		</td>
		<td valign="top">
			Sets the maximum Zoom level.  See the
			<a href="#ZoomMax">description</a> below.
		</td>
	</tr>
</table>
<p>
</p>
<a name="MetaCommands"></a>
<div class="SectionHeader">LDView-specific LDraw Meta Commands</div>
<p>
All LDView-specific LDraw Meta Commands start with <tt>0 !LDVIEW</tt>, and are
then followed by a command name and optional parameters.  Example:
</p>
<p>
<pre>
	0 !LDVIEW BBOX_IGNORE NEXT
</pre>
</p>
<p>
The following is a table of all LDView-specific Meta Commands (which currently
only has one entry).
</p>
<table bgcolor="#FFFFDD" cellpadding="5" cellspacing="0" class="SettingsList">
	<tr>
		<th>Command</th>
		<th>Parameters</th>
		<th>Description</th>
	</tr>
	<tr valign="top">
		<td><tt>BBOX_IGNORE</tt></td>
		<td>
		<tt>BEGIN <i>or</i> END <i>or</i> NEXT</tt><br/>
		</td>
		<td>
			This command causes one or more lines in the LDraw file to be
			ignored for the purposes of LDView's bounding box calculations for
			its default viewing distance.  If you use
			<tt>BBOX_IGNORE BEGIN</tt>, every line up until a matching
			<tt>BBOX_IGNORE END</tt> command will be ignored.  If you use
			<tt>BBOX_IGNORE NEXT</tt>, the next line that includes geometry will
			be ignored.<br/><br/>
			This was requested so that train tracks could be placed under train
			models without causing it to zoom out too far, but can be used in
			any model.
		</td>
	</tr>
</table>
<p>
</p>
<a name="Notes"></a>
<div class="SectionHeader">Notes</div>
<table>
<tr>
<td align="right" valign="top">1.</td>
<td>
Many of the current features in LDView are the result of user comments and
suggestions.  I always welcome more comments at the e-mail address <a
href="#EMail">below</a>.
<p>
</p>
</td>
</tr>
<tr>
<td align="right" valign="top">2.</td>
<td>
A list of planned features and possible other future features can be found on
the LDView website <a
href="https://tcobbs.github.io/ldview/FutureFeatures.html">here</a>.
<p>
</p>
</td>
</tr>
<tr>
<td align="right" valign="top">3.</td>
<td>
<a name="ZoomMax"></a>
Advanced users can adjust the maximum zoom level.  This isn't something that is
generally useful except to LDraw part authors.  Currently it can only be done by
using the <a href="#ZoomMaxSetting">-ZoomMax</a> command line option, or
creating or modifying the following DWORD registry key:
<p>
<tt>HKEY_CURRENT_USER\Software\Travis Cobbs\LDView\ZoomMax</tt>
</p>
<p>
The default behavior can be achieved by setting it to 199 (decimal).  Increasing
the value above this allows you to zoom in further.  Doing this results in the
view position moving inside the model.  Decreasing the value below 199 limits
the amount you can zoom in.  Setting it to values less than 100 may produce odd
results, and setting it to zero will cause a division by zero which may produce
a crash, or possibly a corrupted display.
</p>
<p>
Setting it to values significantly larger than 199 may produce odd results as
well.  Anything between 199 and 1000 should be fine, other than the fact that
when the view position moves inside the model you get a cutaway effect.
</p>
<p>
Please note: this setting is not designed to position the camera when using the
command line to launch LDView and take a snapshot.  It only effects the maximum
interactive zoom level, so increasing it will not move the initial camera view
closer to the model.  Decreasing it below a certain threshold will move the
camera away, but this is a side effect of the fact that it won't allow you to be
closer than what you set it to.  If you want to change the default zoom level
of the camera, use the <a href="#DefaultZoomSetting">DefaultZoom</a> setting.
</p>
<p>
</p>
</td>
</tr>
<tr>
<td align="right" valign="top">4.</td>
<td>
<a name="DefaultMatrix"></a>
If you want LDView to render an image from a specific angle from the command
line, you can use the <a href="#DefaultMatrixSetting">-DefaultMatrix</a> command
line option.  (For an alternative way to do this, see the
<a href="#DefaultLatLongSetting">-DefaultLatLong</a> setting.)  The
-DefaultMatrix setting is used to directly specify the rotation matrix applied
to the model, which looks like this:
<p>
</p>
<table>
<tr>
	<td bgcolor="#000000">
	</td>
	<td>
		<table>
			<tr>
				<td align="center">
				<b>A</b>
				</td>
				<td align="center">
				<b>B</b>
				</td>
				<td align="center">
				<b>C</b>
				</td>
			</tr>
			<tr>
				<td align="center">
				<b>D</b>
				</td>
				<td align="center">
				<b>E</b>
				</td>
				<td align="center">
				<b>F</b>
				</td>
			</tr>
			<tr>
				<td align="center">
				<b>G</b>
				</td>
				<td align="center">
				<b>H</b>
				</td>
				<td align="center">
				<b>I</b>
				</td>
			</tr>
		</table>
	</td>
	<td bgcolor="#000000">
	</td>
</tr>
</table>
<p>
Note that this is the upper left 3x3 matrix of a standard 4x4 3D transformation
matrix.  It is specified on the command line like the following:
</p>
<p>
<tt>-DefaultMatrix=A,B,C,D,E,F,G,H,I</tt>
</p>
<p>
For example, to get a front view of your model, use the identity matrix, like
so:
</p>
<p>
<tt>-DefaultMatrix=1,0,0,0,1,0,0,0,1</tt>
</p>
<p>
If you want to decide on a viewing angle in LDView and then determine the matrix
for it that can be used above, use the <a href="#ShowViewInfo">View-&gt;Show
view info</a> menu item.
</p>
<p>
Note that if you use this to specify a default rotation matrix, the <i>Reset
View</i> command will reset the view back to your setting until you use the
<a href="#SaveDefaultView"><i>Save Current as Default</i></a> command to change
the default viewing angle to something else.
</p>
<p>
</p>
</td>
</tr>
<tr>
<td align="right" valign="top">5.</td>
<td>
<a name="DefaultLatLong"></a>
Another way to have LDView render an image from a specific angle from the
command line is to use the <a href="#DefaultLatLongSetting">-DefaultLatLong</a>
command line option.  (For an alternative way to do this, see the
<a href="#DefaultMatrixSetting">-DefaultMatrix</a> setting.)  The
-DefaultLatLong setting is a (mostly) user-friendly way of specifying the
viewing angle.  It is very similar to the -cg option in Lars C. Hassing's L3P
program.  (Note that -cg is also <a href="#CameraGlobe">supported</a> by
LDView.)  -DefaultLatLong specifies the latitude and longitude of the camera on
a virtual globe around the model.  It is specified like so:
<p>
<tt>-DefaultLatLong=latitude,longitude</tt>
</p>
<p>
You can produce LDView's standard two-thirds viewing angle by using the
following setting:
</p>
<p>
<tt>-DefaultLatLong=30,45</tt>
</p>
<p>
Note that the optional radius parameter of the -cg option isn't supported by
-DefaultLatLong.  However, you can use the
<a href="#DefaultZoomSetting">-DefaultZoom</a> setting to move the camera closer
to or farther from the model.  If you want to put the camera at a fixed
difference, use the <a href="#CameraGlobe">-cg</a> option.
</p></td>
</tr>
<tr>
<td align="right" valign="top">6.</td>
<td>
<a name="LineThicknesses"></a>
Specifying a line thickness of 0 results in a 1-pixel line thickness. All other
line thicknesses are multiplied by the scale factor. In the Windows version of
LDView running on Windows 10 Creators Update or later, and on the Mac version of
LDView, the scale factor is set automatically based on the scale factor provided
by the operating system for LDView's window. (Command line snapshots always have
a default scale factor of 1.0.) For example, when the LDView window is in on a
Retina display on a Mac, its scale factor is 2.0. Or if the LDView window is on
the internal display of a high-DPI laptop which is set to 250% in Windows, the
scale factor will be 2.5.
</td>
</tr>
</table>
<br/>
<p>
</p>
<a name="ScreenSaver"></a>
<div class="SectionHeader">Using LDView as a Screen Saver</div>
When you use the Windows Installer to install LDView, you are presented with an
option near the end to install it as a screen saver.  If you select this option,
you can use LDView as a screen saver.  Simply select it from the list of
available screen savers, and then configure it as desired.  When using LDView as
a screen saver, you can set most of the settings that are available in standard
LDView, and you can additionally set screen saver-specific settings.  At the
moment, Screen Saver mode is only supported in Windows.
<p>
If you don't use the install program to install LDView, or you don't check the
option to install it as a screen saver and later change your mind, you can
manually install it as a screen saver.  Simply copy LDView.exe into your
Windows System directory, and then rename the file to LDView.scr.  In Windows
95/98/Me, the Windows System directory is usually <tt>C:\WINDOWS\SYSTEM</tt>.
In Windows NT/2000, it is usually <tt>C:\WINNT\SYSTEM32</tt>.  In Windows XP,
it is usually <tt>C:\WINDOWS\SYSTEM32</tt>.  It is important that you use the
<tt>SYSTEM</tt> directory in Win95/98/Me and the <tt>SYSTEM32</tt> directory
otherwise.  If you are unsure where to put it, I strongly recommend that you
run the LDView install program, and make sure to check the option to have the
screen saver module installed.  You can re-install LDView over itself without
any problems, so you don't have to uninstall first.
</p>
<br/>
<p>
</p>
<a name="Website"></a>
<div class="SectionHeader">Website</div>
You can download an up-to-date copy of LDView at the LDView website at
<a href="https://tcobbs.github.io/ldview/">https://tcobbs.github.io/ldview/</a>.
<br/>
<br/>
<hr/>
If you have any comments, questions, or suggestions, please e-mail me at
<a name="EMail" HREF=
"mailto:ldview@gmail.com">ldview@gmail.com</a>.
<p>
LDView is Copyright &#169; 2009 Travis Cobbs and Peter Bartfai.
</p>
<p class="FinePrint">
LEGO&#174; and the LEGO logo are registered trademarks of the LEGO Group, which
does not sponser, endorse, or authorize this program.  You can find the official
Lego website at <a href="http://www.lego.com/">http://www.lego.com</a>.
</p>
</body>
</html>