leocad/docs/library.html
2018-02-24 18:08:50 -08:00

109 lines
5.2 KiB
HTML

<!doctype html>
<html>
<head>
<meta http-equiv="X-UA-Compatible" content="chrome=1">
<title>Parts Library | LeoCAD</title>
<link rel="stylesheet" href="../main.css">
</head>
<body>
<div class="container">
<!-- navbar start -->
<div class="nav-main">
<div class="wrap">
<a class="nav-home" href="../index.html"><img class="nav-logo" src="../leocad-32.png" width="32" height="32"> LeoCAD </a>
<ul class="nav-site nav-site-internal">
<li><a href="../download.html">Download</a></li>
<li><a href="start.html" class="active">Documentation</a></li>
<!-- <li><a href="../help.html">Help</a></li> -->
</ul>
<ul class="nav-site nav-site-external">
<li><a href="https://github.com/leozide/leocad">GitHub</a></li>
</ul>
</div>
</div>
<!-- navbar end -->
<section class="content wrap documentationContent">
<!-- docbar start -->
<div class="nav-docs">
<div class="nav-docs-section">
<h3>General Information</h3>
<ul>
<li><a href="start.html">Getting Started</a></li>
<li><a href="library.html" class="active">Parts Library</a></li>
<li><a href="compiling.html">Compiling Guide</a></li>
<li><a href="license.html">License</a></li>
<li><a href="history.html">Version History</a></li>
</ul>
</div>
<div class="nav-docs-section">
<h3>Tutorials</h3>
<ul>
<!--
<li><a href="">Choosing and Adding Pieces</a></li>
<li><a href="">Moving and Rotating Pieces</a></li>
<li><a href="camera.html">Camera and Viewport</a></li>
<li><a href="">Models</a></li>
<li><a href="">Flexible Parts</a></li>
Keyframing
POV-Ray
-->
<li><a href="tutorial1.html">Basic Tutorial</a></li>
<li><a href="rotation.html">Rotation Center</a></li>
</ul>
</div>
<!-- <li><a href="">Coordinate System</a></li>
<li><a href="">Configuration Shortcuts</a></li>
-->
<div class="nav-docs-section">
<h3>Reference</h3>
<ul>
<li><a href="meta.html">Meta Commands</a></li>
<li><a href="texmap.html">Texture Mapping</a></li>
</ul>
</div>
</div>
<!-- docbar end -->
<div class="inner-content">
<h2>Parts Library</h2>
<p>LeoCAD is completely compatible with LDraw's parts library. In fact, the library included in the installer packages is just a ZIP archive of LDraw's library without any changes.</p>
<p>This is mostly done to simplify things so that new users do not need to download and install a separate file or worry about updating their library. Many LeoCAD users are young people without a lot of computer experience, so the setup process is kept as simple as possible.</p>
<p>At the same time, there are also experienced users who like to maintain their own libraries with unofficial parts that they create or download from the internet. Those people can still use their LDraw library with LeoCAD, all they need to do is tell LeoCAD where to find it.</p>
<p>Note that there is a performance advantage for using a zip file for the library, as the application will take less time to start, and the models will load faster.</p>
<h2>Using a Custom Parts Library</h2>
<p>There are several ways to specify a custom library folder or file (in order of priority):</p>
<ul>
<li>Use the &ldquo;-l&rdquo; command line option, followed by the library path.</li>
<li>Set the &ldquo;LEOCAD_LIB&rdquo; environment variable.</li>
<li>Enter a new library path in the &ldquo;Preferences&rdquo; menu.</li>
</ul>
<p>Note that LeoCAD can use either a zip file or a regular folder for its library. Here are some examples:</p>
<div class="highlight"><code>
$ leocad -l C:\LDraw\<br>
$ set LEOCAD_LIB=C:\User\Downloads\complete.zip
</code></div>
<h2>Unofficial Parts</h2>
<p>You can easily use unofficial LDraw parts with LeoCAD:</p>
<p>If you are using LeoCAD's default library, then you will need to download the current unofficial parts from <a href="http://www.ldraw.org/library/unofficial/ldrawunf.zip">http://www.ldraw.org/library/unofficial/ldrawunf.zip</a> and then place &ldquo;ldrawunf.zip&rdquo; in the same folder where &ldquo; library.bin&rdquo; is located and restart LeoCAD. The next time the application starts, it will detect &ldquo;ldrawunf.zip&rdquo; and load it automatically.</p>
<p>If you are using your own custom library with loose files, then all you need to do is place the files in the &ldquo;unofficial&rdquo; folder. The parts should be visible the next time you start LeoCAD</s>.</p>
<h2>Default Library Path</h2>
<p>The default library path is different for each operating system:</p>
<p>Windows: The application looks for &ldquo;library.bin&rdquo; in the same folder where &ldquo;LeoCAD.exe&rdquo; is located.</p>
<p>Linux: The path is &ldquo;../share/leocad/library.bin&rdquo;, which is relative to the application binary folder. If you have the LeoCAD executable &ldquo;/usr/bin/leocad&rdquo;, the application will look for the library in &ldquo;/usr/share/leocad/library.bin&rdquo;.</p>
<p>macOS: The application bundle should have a &ldquo;library.bin&rdquo; file in the &ldquo;Contents/Resources&rdquo; folder.</p>
</div>
</section>
<!-- footer start -->
<footer class="wrap"><div class="right"> &copy; LeoCAD.org </div></footer>
<!-- footer end -->
</div>
</body>
</html>