Changes between Version 20 and Version 21 of Processing/lagdevelopersfaq

Timestamp:

Sep 4, 2013, 5:04:08 PM (11 years ago)

Author:

besm

Comment:

--

Processing/lagdevelopersfaq

@@ -165 +165 @@
 === 2.5 How do I make laslib a shared library? [=#q2.5] ===
 
-It seems that laslib is mainly developed for Windows users so there are no targets for shared libraries in the Makefiles by default. At the same time shared libraries are needed by LAG to work correctly. To fix this you're going to need to modify the Makefiles and add {{{-fPIC}}} option to the compiler. You'll also have to change the name of the library from laslib to //liblaslib// for the linker to detect it. \\ \\
-You'll normally find modified Makefiles somewhere around, so you can copy them after downloading a new version of laslib and hopefully they will work. If this is not the case, below is the part that needs to be added to the Makefile inside laslib/src folder.
-
-{{{
-#!div style="font-size: 100%"
-  {{{#!sh
-all: static shared
-
-# these targets set the output directory for the object 
-# files and then call make again with the appropriate library targets.  
-# This is done so that the fpic flag is set correctly for the library 
-# we're building.
-static: 
-        test -d static || mkdir static
-        $(MAKE) liblaslib.a OBJDIR=static
-
-shared:
-        test -d shared || mkdir shared
-        $(MAKE) liblaslib.so.${VERSION} OBJDIR=shared EXTRA_COPTS=-fPIC
-
-liblaslib.a: ${TARGET_OBJS}
-        $(AR) $@ ${TARGET_OBJS}
-        cp -p $@ ../lib
-
-liblaslib.so.${VERSION}: ${TARGET_OBJS}
-        ${COMPILER} -shared -Wl,-soname,liblaslib.so.1 -o \
-        liblaslib.so.${VERSION} ${TARGET_OBJS}
-        cp -p $@ ../lib
-
-${TARGET_OBJS}: ${OBJDIR}/%.o: %.cpp
-        ${COMPILER} ${BITS} -c ${COPTS} ${EXTRA_COPTS} ${INCLUDE} $< -o $@
-
-  }}}
-}}}
-
-You're not likely to have to alter this part and if a newly downloaded version of laslib fails to build with modified Makefiles, the first thing to check is if {{{OBJ_LAS}}} (the list of object files) hasn't changed since the previous release.
+As of 2012, automatic installers should be deployed on all Fedora17+ machines within RSG, so hopefully you will not need to install it on your machine yourself. Somebody within the department ought to be keeping a relatively current version maintained in svn under tools/laslib/lastools-patched. If you are the LAG maintainer then this job may fall to you, for which you will need to learn about compiling dynamically linked libraries and Makefiles in Linux.
+
+If you need to install laslib locally on your machine as a shared library, you should use the patched version maintained by RSG to maintain a relatively even installation across all desktop machines. Check out the patched lastools package and enter the laslib subdirectory, and build and install using the makefile provided.
+
+{{{
+svn checkout http://rsg.pml.ac.uk/intranet/svnroots/arsf-internal/trunk/tools/laslib
+cd laslib/lastools-patched/laslib
+make
+make install
+ldconfig
+}}}
+
+
+For maintaining lastools, check back on the official release every now and then and figure out whether it has been updated (there is no version numbering). You will need to download this and (try to) apply the latest patch from the top laslib directory (lastools20120829.patch or something like that). This may fail, and you will need to try to resolve any issues preventing the patch from working. Then change the version in the makefile to the current date as a rudimentary versioning system for internal use. Next you will need to test the compilation, install it to your machine locally, and make sure it works, and debug any problems that arise. Once you've done that, move your patched version to lastools-patched, and the latest unpatched version to lastools. Derive a new patch from lastools-patched taking lastools as your reference, and label it accordingly. Package lastools-patched as laslib-YYYYMMDD.zip (set date as appropriate) as a tool for archiving, and you should be all set.
 
 ----