Getting Started - Linux

From LDraw.org Wiki
Jump to navigation Jump to search

Step 1: Download and Install the LDraw parts Library

Basic setup (applies to any Linux distribution or operating system - Recommended approach):

  • Download the latest complete.zip from LDraw.org download page.
  • Extract the complete.zip archive in the directory of your choice - your home directory is recommended (~/ldraw/) to avoid any file permission conflict or having to tamper with your system as 'root'.

Tip:
To avoid cluttering your home directory and potentially or mistakenly deleting your LDraw parts database, we suggest making the 'ldraw' directory hidden by appending a period ('.') to the directory name like so: $ mv ldraw .ldraw
Feel free to move the LDraw parts directory to a 'safer' location, such as a separate partition or a different part of your system to prevent any such unwanted changes: the library is portable and any editor, viewer, renderer or utility can be directed to its location on your system.


Updating your parts list:

If, for any reason you have decided to alter the original parts directory (~/ldraw/parts.lst), Nathanel Titane has made a Linux native 'mklist.exe' equivalent: 'make-list'. The make-list utility operates exactly like its Windows counterpart, and generates a 'parts.lst' file that can be either sorted by part number or part description.

  • Download the make-list utility (right click: 'Save link as...')
  • Save the utility as 'make-list' to your LDraw parts library directory (~/ldraw/).
  • Run the utility like so: $ ./make-list and follow the prompts.

Note:
Make sure that the file is set as executable before attempting to run it: $ sudo chmod +x make-list
If present, the previous version of the 'parts.lst' file will be backed up.


Installer package approach (applies to any Red Hat or Debian based Linux distribution, provided packages exist and are maintained:

deb:

  • To be determined - Online queries do suggest that a new package for Debian based systems is being created and submitted for approval via the Debian package overview server page

rpm:

  • Download the latest (2013-02) version of the parts library packaged by Eli Carter from the Retractile blog page.
  • Install ldraw_parts-creativecommons-201302-ec4.noarch.rpm using your preferred package manager or command package management tool (yum, rpm).

Note:
This method will unpack the parts library under a more conventional system directory (/usr/share/ldraw) that is only modifiable via 'root' access.

Step 2: Install an editor

Hybrid setup - Installing MLCad via Wine:

  • Install Wine via your distribution's package manager or application repository.
    • deb: $ sudo apt-get install wine
    • rpm: $ sudo yum-install wine
  • Download the MLCad archive.
  • Extract the MLCad_V3.40.zip archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
    • Run MLCad by selecting MLCAD.exe and follow the usual prompts (LDraw parts library directory location and file type registration setup)
    • Select Wine as the default method to open an executable on your system and proceed with the previously mentioned steps.

Note:
MLCad runs exceptionally well (Platinum status on the Wine's AppDB scale) provided similar instructions are provided on the MLCad website.
The author of this Wiki, Nathanel Titane, has been running MLCad as his main LDraw editor on Linux for over 8 years without a single issue.
Any encountered problem, whatever it may be, should be troubleshooted or reported to the Wine developers as they are responsible for maintaining Wine's underlying code base that makes running Windows executables on Linux distributions possible.


Linux native editors:


LeoCad:

Leonardo Zide's LeoCAD is readily available for install for both Debian and Red Hat based distributions. You can install the editor by looking for and installing the leocad package using your preferred package manager or command package management tool (apt, dpkg / yum, rpm).

  • Install LeoCAD:
    • deb: $ sudo apt-get install leocad
    • rpm: $ sudo yum-install leocad
  • Run LeoCad and point it to the LDraw parts library:
    • Go to View > Preferences... and set your library directory by either typing it in the field or browsing to it via '...'. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.

Note:
LeoCAD can use either a zip file or a regular folder as its parts library directory.
You can start Leocad with a different library setup using: $ leocad -l <library directory path>
LeoCAD also supports setting the library path as a system environment variable like so: $ set LEOCAD_LIB=<library directory path>


LDCad:

  • Go to LDCad's download page
  • Select and download the latest generic archive of the LDCad editor.
  • Extract the archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
  • Run LDCad, follow the prompts and point it to the LDraw parts library. Make sure to select the topmost directory (normally 'ldraw') that contains the 'parts' directory.

Note:
LDCad assumes you are running on a GTK based or compatible desktop environment such as gnome. Make sure you have installed the required packages and libraries to avoid any issues.


LDGLite:

LDglite is only available as a standalone 64bit binary for Linux. Compared to the other editors, it does pale in comparison to the amount of features present on the more modern ones. If for curiosity's sake you still want to install it, proceed as follows:

  • Download the LDGLite binary archive
  • Extract the archive in the directory of your choice - your home directory is recommended to avoid any file permission conflict or having to tamper with your system as 'root'.
  • Run LDGlite, right click on its background to get started.

Note:
Make sure that the binary is set as executable before attempting to run it: $ sudo chmod +x ldglite
This specific standalone requires libraries such as the dri accelerated opengl libraries, glut, glu, libpng and zlib to be installed. If, for whatever reason LDGlite fails to start by clicking on the binary, you may run it via a terminal and verify its output, like so: ./ldglite


Konstruktor:

Konstruktor, created by Park Joon Kyu, is one of the latest attempts to develop a modern, fully integrated and platform independant LDraw model editor. It features a fully modular panel interface as well as full HD POV-Ray rendering capabilities of the model being edited. There is no ETA as to when it will be ready, although development continues, to provide a premium alternative to other editors, if those fail to satisfy. You may visit the temporary webpage here or skip directly to its GitHub repository to test it out, file bugs or help with its development in any other way.


Related applications:

LDView:

LDView, by TRavis Cobbs, is a real-time 3D viewer for displaying LDraw models using hardware-accelerated 3D graphics. It is an essential tool in the creation of a model as it can be used to view and debug, in real-time and with full 3D graphics capacity, the model currently being edited (using the auto-update polling preference). It can also generate snapshots of the displayed content or of specific selected views of the given model. LDView is native to the Linux platform and is readily available for install for both Debian and Red Hat based distributions.

  • Download the latest installer package from LDView's downloads page.
  • Install LDView by using your preferred package manager or command package management tool (apt, dpkg / yum, rpm).

Note:
deb: Your system may complain about either missing packages or unresolved dependencies. You may resolve these by forcing an install fix like so: $ sudo apt-get -f install
rpm: LDView's Linux maintainer, Peter Bartfai, has an LDView repository set up using the OpenSuse build server system, from which you can get the latest LDView version, provided you add the yum repository information as follows:

$ sudo cat > /etc/yum.repos.d/ldview.repo << FILE
[ldview]
name=LDView Repository
baseurl=http://download.opensuse.org/repositories/home:/pbartfai/Fedora_$(rpm -E %fedora)/
gpgkey=http://download.opensuse.org/repositories/home:/pbartfai/Fedora_$(rpm -E %fedora)/repodata/repomd.xml.key
enabled=1
gpgcheck=0
FILE

Tip: The variable "$(rpm -E %fedora)" refers to rpm's way (on the Fedora distribution) of finding the current version and attributing the proper number to the URL. Note: The OpenSuse build server team automatically generates the configurations for upcoming or newer versions of any supported Red Hat distribution, ONLY when those distribution versions are finalized, stable and made available to the public.


LPub:


Step 3: 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. Take a look at the tutorials on the wiki or on the main website for further help.

Help

Forums are also a great way to discuss techniques, issues or features of editors or applications used to create or edit your LDraw model files. If you require any further help with any of this content, please visit the LDraw.org Forums, sign up, and ask a large group of users for help.