= Welcome to Lucide = [[PageOutline]] Lucide is a plugin based document viewer for OS/2 and derivative operating systems, which currently supports PDF, !DjVu, and a number of image format files (JPG, through the included plugin, and many bitmap formats through the Generalised Bitmap Module, available [http://heikon.home.tlink.de/ here]. Support for new document types may be added as additional plugins. == Current Status == === Licensing === * Versions 1.30 and higher have been released and distributed under CDDL/LGPL (dual license model). * Versions up through 1.21 were only released in binary form, under a proprietary license. === Development & Release === Development of Lucide has been renewed as of December, 2015, in cooperation with Arca Noae, LLC and affiliated developers. Further details regarding new releases will be made as work progresses. For the latest releases, see '''Latest Versions''', below. == Additional software prerequisites == It is strongly recommended to install from RPM (using YUM or Arca Noae Package Manager), though zipped packages may be available for some prerequisites. If you use RPM, you should install the following with the single command for versions up through '''1.3.5''': {{{ yum install libc libgcc1 libgcc-fwd libstdc++6 libsupc++6 uclip }}} or use Arca Noae Package Manager's Quick install feature (YUM | Quick install...) and paste the following into the dialog box: {{{ libc libgcc1 libgcc-fwd libstdc++6 libsupc++6 uclip }}} For WPI: ||'''kLibc 0.6.6 Library'''||[ftp://ftp.netlabs.org/pub/gcc/libc-0_6_6-csd6.wpi WPI]||kLibc Runtime libraries|| ||'''GCC 4 Core Libraries'''||[ftp://ftp.netlabs.org/pub/gcc/gcc4core-1_3_1.wpi WPI]||GCC 4 runtime libraries|| ||'''UClip'''||[http://hobbes.nmsu.edu/download/pub/os2/util/clipbrd/uclip-0_3_0-os2.wpi WPI]||enhanced OS/2 clipboard support|| For version '''1.4.0''' and newer, the Quick install list is: {{{ libc libcx libgcc1 libgcc-fwd libstdc++6 libsupc++6 poppler poppler-data libjpeg djvulibre uclip }}} To have Japanese fonts working in '''1.5.0''' you need the poppler-data package. This is listed above. If you do not wish to add such support, you may omit it from the Quick install list. Libcx is not required for version 1.4.0. === Notes about RPM/YUM updates === From time to time, updates to various RPMs may break compatibility with some Lucide components. This is particularly true of the PDF plugin, which depends upon the poppler library, which may require a "legacy" package to be installed to satisfy its dependency. As of Lucide 1.5.0, the PDF plugin requires poppler 0.59.0. If updating poppler beyond 0.59.0, be sure to select the latest poppler-legacy--0.59.0- for your platform (e.g., poppler-legacy-70-0.59.0-3.oc00.L) to satisfy the PDF plugin's dependency. Newer legacy versions do not replace older ones, but merely provide additional backward compatibility. Thus, poppler-legacy-70-0.59.0-3.oc00.L may be installed alongside poppler-legacy-66-0.52.0-1.oc00.L as they provide different compatibilities (the "70-0.59.0" package does not update, upgrade, obsolete, or replace the "66-0.52.0" legacy package; they do different things). == Latest Versions == The latest '''stable''' version is '''1.5.0'''. Lucide is available for downloading in the following packages and formats: ||'''Component'''||'''Package'''||'''Version'''||'''Description'''|| ||Lucide executable and plugins||[ftp://ftp.netlabs.org/incoming/Lucide-1_5_0_GA.wpi WPI]||1.5.0||Updated on 2019/03/20|| ||Lucide executable and plugins||[ftp://ftp.netlabs.org/pub/lucide/Lucide_1_4_0_0.exe WPI]||1.4.0||Updated on 2017/04/21|| ||Lucide executable and plugins||[ftp://ftp.netlabs.org/pub/lucide/Lucide-1_3_5_GA.wpi WPI]||1.3.5||updated poppler lib|| ||Lucide executable and plugins||[ftp://ftp.netlabs.org/pub/lucide/Lucide-1_3_5_GA.zip ZIP]||1.3.5||updated poppler lib|| == User's Guide == Lucide has a new user's guide which will be included in the 1.4.0 release. It is a work in progress, and this is the first draft. Users of Lucide - experienced or new - are encouraged to read the help manual with View or !NewView (it is also accessible from Lucide's menu in 1.4.0, from many dialogs within the program, and is somewhat context-sensitive). There are fairly extensive sections not only on program usage, but also on PDF, !DjVu, and JPEG formats, PDF encryption types (whether supported by Lucide or not), and other interesting (we hope) bits. The guide itself constitutes over 80 hours of research and formatting. Comments welcome; please open a ticket if you find something missing or in error. If you would like to download it separately, it is available here (this draft may not match the current build in the latest release candidate): [ftp://ftp.netlabs.org/pub/lucide/Lucide_en.hlp Lucide User's Guide] == Mailing Lists == There are currently two mailing lists for Lucide: one for users, and one for developers. If you want to join either or both, please read [http://wiki.netlabs.org/index.php/Mailinglists the instructions] on the Netlabs Wiki. As the Gmane web service shut down at the end of July, 2016, you may access the list archives via NNTP, here: * news://news.gmane.org/gmane.org.netlabs.lucide.devel * news://news.gmane.org/gmane.org.netlabs.lucide.general == Bugs & Features == Lucide continues to be an ongoing project, with some features still to be added and some longer-standing issues to be addressed. If you encounter an issue or have an enhancement request, you are welcome to register it as a new [http://svn.netlabs.org/lucide/newticket ticket]. Please make sure you check the list of open tickets first, to see if your issue may have already been reported. Also, try to assign it to the correct component of the program; this is quite easy to do with TRAC. We will do our best to review tickets regularly and will leave comments if we need more info. Please revisit the [http://svn.netlabs.org/lucide/report/11 Feedback analysis] for overall status updates. If we leave a comment and still do not receive a response from the ticket creator, the issue will likely be closed in a reasonable amount of time. If you want an email notification when a ticket is changed you need to go into your preferences and on the "General" page add your name and email. This needs to be done separately for each project. Anonymous access to the ticket system has been restricted due to multiple spam attacks. In order to create a new ticket or comment on an existing one, you will need to log in with your Netlabs login id. If you do not have a login id, you may request one [http://www.netlabs.org/en/site/member/member.xml here]. Due to the inclusion of a forwarder in recent poppler builds, issues experienced before where the installation of a new poppler build would result in Lucide's PDF plugin not being loaded have essentially been resolved. The Lucide Project extends great thanks to the porting team for their consideration and work in this regard. (See updating notes above for cautions which still apply.) == Developers == We are currently seeking interested developers to make Lucide even more useful, adding features like tabbed viewing, more flexible print layouts, an even more intuitive user interface, better rendering performance for currently-supported document types, and of course, to build new plugins to handle more document types overall. === Creating New Plugins === The [wiki:Lucide-Plugin-API plugin API] uses SOM. This allows programmers to write their own plugins without the need to recompile them every time a new Lucide release is done. It's up to the developer to decide if the plugin he/she writes will be open source or not; Lucide, due to its being dual-licensed, will work with both type of plugins. Please read [wiki:Lucide-Plugin-Guide How to write your own plugins for Lucide]. === Plugin Source Code === You may download the sources for all of our plugins directly from the svn repository. If you have any problems, please post to the developer list. * The svn trunk contains source for all Lucide plugins. Note that one of the new design goals is to remove Lucide's dependence on special library builds and to utilize the system-installed ones. Thus, poppler, !DjVu, and jpeg sources are no longer included in this repository. === Building Lucide === * BuildingInstructions (current as of the 1.4.0 release cycle)