Getting Started - Linux: Difference between revisions

From LDraw.org Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:
Basic Setup (applies to any Linux distribution or operating system - Recommended approach):
Basic Setup (applies to any Linux distribution or operating system - Recommended approach):
* Download the latest <code>complete.zip</code> from [http://www.ldraw.org/downloads-2/downloads.html LDraw.org download page].
* Download the latest <code>complete.zip</code> from [http://www.ldraw.org/downloads-2/downloads.html LDraw.org download page].
* Extract the <code>complete.zip</code> archive in the directory of your choice - your home directory is recommended (<code>~/ldraw/</code>)to avoid any file permission conflict or having to tamper with your system as 'root'.
* Extract the <code>complete.zip</code> archive in the directory of your choice - your home directory is recommended (<code>~/ldraw/</code>) to avoid any file permission conflict or having to tamper with your system as 'root'.


Installer package approach (applies to any Red Hat or Debian based Linux distribution, provided packages exist and are maintained:
Installer package approach (applies to any Red Hat or Debian based Linux distribution, provided packages exist and are maintained:
Line 26: Line 26:
*Download the [http://mlcad.lm-software.com/MLCad_V3.40.zip MLCad archive].
*Download the [http://mlcad.lm-software.com/MLCad_V3.40.zip MLCad archive].
* Extract the <code>MLCad_V3.40.zip</code> 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'.
* Extract the <code>MLCad_V3.40.zip</code> 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 <code>MLCAD.exe</code> and following the usual prompts (LDraw parts library directory location and preferences setup)
**Run MLCad by selecting <code>MLCAD.exe</code> 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 Linux and proceed with the previously mentioned steps.
**Select Wine as the default method to open an executable on your Linux and proceed with the previously mentioned steps.


'''Note:'''
'''Note:'''
'''MLCad runs exceptionally well ([http://appdb.winehq.org/objectManager.php?sClass=application&iId=1354 Platinum] status on the Wine's AppDB scale) provided similar instructions are provided on the [http://mlcad.lm-software.com/Linux.htm MLCad website] and that the author of this wiki 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 Wines underlying code base that makes running Windows executables on Linux distributions possible.'''
'''MLCad runs exceptionally well ([http://appdb.winehq.org/objectManager.php?sClass=application&iId=1354 Platinum] status on the Wine's AppDB scale) provided similar instructions are provided on the [http://mlcad.lm-software.com/Linux.htm MLCad website] and that the author of this wiki 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 Wines underlying code base that makes running Windows executables on Linux distributions possible.'''
* Go to [http://www.melkert.net/LDCad http://www.melkert.net/LDCad] and download the Linux version of LDCad
* Unzip the package into the directory of your choice
* Run LDCad
* When asked for the location of the LDraw Library, use the directory where you unzipped <code>complete.zip</code>.


Linux native editors:
Linux native editors:
Line 50: Line 45:
'''You can start Leocad with a different library setup using: <code>$ leocad -l <library directory path></code>'''
'''You can start Leocad with a different library setup using: <code>$ leocad -l <library directory path></code>'''
'''LeoCAD also supports setting the library path as a system environment variable like so: <code>$ set LEOCAD_LIB=<library directory path></code>'''
'''LeoCAD also supports setting the library path as a system environment variable like so: <code>$ set LEOCAD_LIB=<library directory path></code>'''
LDCad:
* Go to [http://www.melkert.net/LDCad/download 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:

Revision as of 15:35, 12 June 2014

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'.

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).

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: $ apt-get install wine
    • rpm: $ 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 Linux 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 and that the author of this wiki 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 Wines 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 (dpkg, yum).

  • Install LeoCAD:
    • deb: $ apt-get install leocad
    • rpm: $ 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:

Konstruktor:

  • The Konstruktor editor is also under development and may offer an alternative to LDCad.

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.