Next Previous Contents

2. Installation

2.1 How to obtain Viewer

Viewer is hosted by Sourceforge.net.

Our home page is at: http://lx-viewer.sourceforge.net

The file release page is at: http://sourceforge.net/project/showfiles.php?group_id=30996

2.2 Requirements

Library files

You must have the QT development libraries 3.0.5 (or newer) installed plus the OpenDWG Linux library files ad2.a and ad3.a. There are several OpenDWG header files which we have modified and provide. These files have the same name as the header files you will get from OpenDWG. It is important that you use our headers, not the ones from OpenDWG.

OpenDWG has several libraries available. LX-Viewer is built using the old C libraries, now known on the OD web site as "Legacy" libraries. Using these libraries we can open and save any drawing version from 2.5 to 2000. LX-Viewer is not compatible with the new "DrawingDirect" libraries and will not work with them.

2.3 Compilation, Installation and Running

Introduction

Once you have obtained the OpenDWG libraries and the tar.gz file containing LX-Viewer from SourceForge you are ready to begin. Installation must be done using the Root account. First step is to extract the tar.gz file into a temporary working directory. The name of this directory is not important and it can be deleted when the installation is complete.

The second step is to locate the files ad2.a and ad3.a in your OpenDWG downloads. The file ad2.a is in the Toolkit download and the file ad3.a is in the Viewkit download. Once you have located these files copy them into the OpenDWG directory that will be created inside your working directory when you extract the tar.gz file. You do not need any of the other files that came with the download from OpenDWG, and in fact using some of these files (especially odio.h) will cause LX-Viewer to not work. Once these steps have been done you are ready to build LX-Viewer.

Building

In order to compile and install Viewer on your system, use a console window and navigate to the working directory. Then type the following:

% qmake -o makefile lxv.pro
% make
% make install

The first step creates a make file and executes very quickly. The second step compiles and builds the files and takes a bit of time. The last step copies the newly built files to the proper directories and again executes very quickly. Once the third step is done the temporary directory can be deleted if you wish.

Since LX-Viewer uses qmake you should have not trouble compiling it. Should you run into problems please report them to the project team at: https://sourceforge.net/projects/lx-viewer

Installation Location

make install will create and install the program parts in the following directories:

/usr/local/lx-viewer   	   	: Will contain the executable file called lxv.
/usr/local/lx-viewer/docs   	: Will contain the manual pages.
/usr/local/lx-viewer/OpenDWG	: Will be created and the file adinit.dat will be placed there.
/usr/local/lx-viewer/graphics	: Will be created and the splash screen plus some icon files
				  will be placed there.

Running the program

To run the program type "/usr/local/lx-viewer/lxv" from a command line (x11 must be running first) and the program should start. The first time into the program a dialog will appear asking you for permission to create several files in your home directory. We recommend that you answer 'yes' to this request. Once the files and directories are created the dialog will not appear again unless you delete them from your home directory. All files created are placed in a directory called /lx-viewer or are in subdirectories below it. A record of the file and directories created will be written to the text window (F2 to show and hide this window).

Assuming you are working in a Desktop environment (KDE, Gnome) you can use the appropriate commands for your system to create a desktop shortcut. There is a desktop icon provided in /usr/local/lx-viewer/graphics that you may associate with your shortcut if you wish.

Changing the installation directory

As mentioned above; /usr/local/lx-viewer is the default location for installation of the program. This can be changed by editing the appropriate line in the file lxv.pro. This line is located at the top of the file and looks like this:

##  Set the installation location.  This can be modified if you wish
INSTALL_DEST = /usr/local/lx-viewer

By modifying this line you should be able to install LX-Viewer where ever you wish on your system.

Uninstalling LX_Viewer

Uninstalling is a simple matter as program parts are placed in only two locations. Shared components are installed in /usr/local/lx-viewer and user parts are stored in $HOME/lx-viewer. Each of these directories contains subdirectories with support files. Uninstalling LX-Viewer involves simply deleting these two directories and their contents. If you followed our installation directions there should be no other parts of the program hidden anywhere else on your system.


Next Previous Contents