Getting Started - Linux

   Before You Start...

   These instructions assume you have some tools installed on your
   system. Here is a list:

wget

You can check if you have wget installed with the command:

wget --version

       If you don't have it, you may download it from <a href="http://wget.sunsite.dk/">http://wget.sunsite.dk/</a>.

<a href="http://www.perl.org/">Perl</a>

You can check if you have Perl installed with the command:

perl --version

       If you don't have it, you may download it from <a href="http://www.perl.org/">http://www.perl.org/</a>.

<a href="http://sources.redhat.com/bzip2/">bzip2</a>

You can check if you have bzip2 installed with the command:

bzip2 --version

       If you don't have it, you may download it from <a href="http://sources.redhat.com/bzip2/">http://sources.redhat.com/bzip2/</a>.

<a href="http://gcc.gnu.org/">GNU Compiler Collection</a>

LDraw tools for Linux come in source code form, so you need the GNU Compiler collection (at least gcc and make) to translate the programs to executable form. These tools usually come in the "development" section of your Linux distribution.

   Step 1 (latest update 2006-01-06):

   Download and install the LDraw Parts Library.

user$ <strong>cd /tmp</strong>
user$ <strong>wget <a href="/files/unix-complete.tgz">http://www.ldraw.org/files/unix-complete.tgz</a></strong>
...
user$ <strong>su -</strong>
Password:
root# <strong>cd /usr/local/share/</strong>
root# <strong>tar xzf /tmp/unix-complete.tgz && echo OK</strong>
...
OK
root# <strong>mkdir -p ldraw/bitmap</strong>
root# <strong>chmod a+w ldraw/bitmap</strong>
root# <strong>chown -R root.root ldraw</strong>
root# <strong>exit</strong>
exit
user$

   Step 2 (latest update 2006-01-06):

To view ldraw model use <a href=http://ldview.sf.net target=_top>LDView</a>. You can install RPM or tar.gz version (available on <a href=http://sourceforge.net/project/showfiles.php?group_id=120592&package_id=131411 target=_top>sf.net</a>), or build from source. To install LDView3.tgz (root permission is not required):

user$ <strong>tar zxvf LDView3.tgz</strong>
user$ <strong>cd LDView3</strong>
user$ <strong>./LDView</strong>

To install from RPM (root privilege is required):

root# <strong>rpm -i ldview-3.0-1.i386.rpm</strong>

To build from source:

user$ <strong>su -</strong>
root# <strong>cvs -z3 -d:pserver:[email protected]/cvsroot/ldview co LDView</strong>
root# <strong>cd LDView/QT</strong>
root# <strong>./makeall</strong>
root# <strong>make install</strong>
root# <strong>exit</strong>
user$ <strong>LDView</strong>

   Step 3 (latest update 2002-05-23):

   Install LDGLite. LDGLite is a rather
   efficient tool for showing building instructions "on the fly", when you
   download them as ".dat", ".ldr" or
   ".mpd" files from the web.

user$ <strong>cd /tmp</strong>
user$ <strong>wget <a href="http://ldglite.sourceforge.net/ldglitesrc0_9_5.zip">http://ldglite.sourceforge.net/ldglitesrc0_9_5.zip</a></strong>
...
user$ <strong>unzip -uoa ldglitesrc0_9_5.zip</strong>
...
user$ <strong>cd ldglite</strong>
user$ <strong>make -f makefile.linux && echo OK</strong>
...
OK

   There is a small risk that you may run into errors at this point, if
   your system lacks some libraries. These errors will probably be of the
   form .../bin/ld: cannot find -lX11. If you don't know how to
   handle this, please contact an experienced Linux system
   administrator.

user$ <strong>su</strong>
Password:
root# <strong>chown root.root l3glite l3gledit ldglite readme.txt</strong>
root# <strong>mv l3glite l3gledit ldglite /usr/local/bin</strong>
root# <strong>mv readme.txt /usr/local/share/ldraw/ldglite.readme</strong>
root# <strong>exit</strong>
exit
user$ <strong>cd ..</strong>
user$ <strong>rm -rf ldglite</strong>

   Now you should be ready to run LDGLite - as the command ldglite - but
   since the LDraw library has been placed differently from what LDGLite
   expects, you have to set the environment variable LDRAWDIR to that
   directory (/usr/local/share/ldraw). You can do that in your runtime
   configuration scripts, just before you run ldglite, or you can create a
   script that sets LDRAWDIR and then calls ldglite. I have chosen the last
   of these three solutions (where I also make sure that there is no limits
   on the stack size):

user$ <strong>su</strong>
Password:
root# <strong>cat > /usr/local/bin/ldglite-run << THE-END</strong>
? <strong>#!/bin/tcsh</strong>
? <strong>setenv LDRAWDIR /usr/local/share/ldraw</strong>
? <strong>limit stacksize unlimited</strong>
? <strong>/usr/local/bin/ldglite \$*</strong>
? <strong>THE-END</strong>
root# <strong>chmod a+x /usr/local/bin/ldglite-run</strong>
root# <strong>cat >> /etc/mailcap << THE-END</strong>
? <strong>application/x-ldraw;/usr/local/bin/ldglite-run -mc %s</strong>
? <strong>application/x-multi-part-ldraw;/usr/local/bin/ldglite-run -mc %s</strong>
? <strong>THE-END</strong>
root# <strong>exit</strong>
exit
user$

   Step 4 (latest update 2002-05-23):

   Now your browser should be ready to open LEGO building instructions
   directly in LDGLite, when you click on links to them on the internet. You
   can test it by clicking on <a href="http://jacob.sparre.dk/LEGO/Byggevejledninger/Tux/tux.dat">tux.dat</a>,
   which should open a window with building instructions for a penguin (Tux,
   the mascot of Linux). You may have to restart your browser to make it
   recognise the existence of LDGLite.

   Step 5:

   There are currently two ways to create LEGO building instructions on
   your computer. You can either write/edit the raw text LDraw files or you
   can use an interactive drawing program, where you can move pieces around
   on the screen. If you chose the former method, you should just use your
   usual text editor and skip this step. If you would like to try the latter
   method, you should install the program LeoCAD.

<a href="http://www.leocad.org/" target="_top"> <img src="/gallery/album47/leocad.png" width="150" height="128" alt="" border="0" align="right">LeoCAD </a>

   LeoCAD is a great 3D editor for Linux (and Windows) which has offered
   several improvements to the straight LDraw .dat format. It supports some
   basic animation (via keyframing) and can also export to 3DStudioMax,
   POV-Ray, and Alias Wavefront.

   To compile: (last update 2006-01-06)

user$ <strong>svn co http://svn.gerf.org/svn/leocad/tags/leocad-0-74 leocad</strong>
user$ <strong>cd leocad</strong>
user$ <strong>make</strong>
user# <strong>strip bin/leocad</strong>
user$ <strong>su -</strong>
Password:
root# <strong>cp bin/leocad /usr/local/bin/</strong>

LeoCAD has different part database, what is available at <a href=http://www.leocad.org/files target="_top">http://www.leocad.org/files</a>

root# <strong>cd /tmp</strong>
root# <strong>wget <a href=http://www.leocad.org/files/pieces.zip>http://www.leocad.org/files/pieces.zip</a></strong>
root# <strong>wget <a href=http://www.leocad.org/files/update18.zip>http://www.leocad.org/files/update18.zip</a></strong>
root# <strong>mkdir /usr/local/share/leocad</strong>
root# <strong>cd /usr/local/share/leocad</strong>
root# <strong>unzip /tmp/pieces.zip</strong>
root# <strong>unzip /tmp/update18.zip</strong>
root# <strong></strong>
root# <strong>leocad -l /usr/local/share/leocad</strong>

   Step 6:

   Dive In!

    Learning how to use your new editor or understanding the LDraw file
   format may be a challenge, but with a little practice you will get the
   hang of it. The <a href="http://www.leocad.org/manual/index.htm">LeoCAD
   Manual</a> by Leonardo Zide will help you getting started.

   Step 7:

   <a href="/article/140">Introduction to LDraw
   Utilities</a>

   There is a lot you can do with LDraw files beyond just creating LEGO
   models! Many contributors have developed utilities to make the most of
   the LDraw file format. Check out a brief introduction to a few utilities,
   and then move on to download them.

   Step 8:

   <a href="/modules.php?op=modload&name=Downloads&file=index">Download Software</a>

   Check out LDraw.org's (incomplete) list of software packages to
   download which supplement the standard editors. Download programs like
   L3P, POV-Ray, various file format converters and rendering tools.

   Help!

   Need help with any of this? Check out <a href="/article/7">LDraw.org's Help Section</a>,

or check out the <a href="http://news.lugnet.com/cad/" target="_top">Lugnet CAD</a>

   discussion groups and ask a large group of users for help.