KDE Native Widget Framework

2004-01-13

Contents

Introduction

Current status

How to get it

Contributing

Introduction

Native Widget Framework is a way to get the look of the host platform in OpenOffice.org. It does not affect the feel, because real KDE widgets are not used; the framework simply uses the QStyle API to draw its widgets the same way KDE/Qt would. It is currently developed for OOo 1.1, but it will be used in 2.0 as well.

Screenshots (version from 2004-01-06):

• Keramik style: Options/Print, Options/View.
• Qt SGI style: Options/View.

Current status

Push buttons, radio buttons, check boxes, drop down list boxes, combo boxes and line edits are currently implemented. Spin fields, scroll bars and tabs are implemented just partially.

How to get it

1. Build gcc 3.2.2. See the Detailed build guide on how to do it. Use /opt/gcc-3-2-2 as a prefix.
   NOTE: It won't work if you do not build it or if you use another prefix.
   
   
2. Set CVSROOT, PATH and LD_LIBRARY_PATH.

     ~/OOo $ export CVSROOT=:pserver:anoncvs@anoncvs.services.openoffice.org:/cvs
     ~/OOo $ export PATH="/opt/gcc-3-2-2/bin:/opt/gcc-3-2-2/jdk/bin:$PATH"
     ~/OOo $ export LD_LIBRARY_PATH="/opt/gcc-3-2-2/lib:/opt/gcc-3-2-2/jdk/lib:$LD_LIBRARY_PATH"
   
   

3. Checkout config_office and vcl from branch cws_srx645_nativewidget1 at 2004-01-12 and dmake, external, xml2cmp, mkdepend, sal, solenv, vos, tools, rscpp and instsetoo from branch OpenOffice_1_1.

     ~/OOo $ cvs checkout -r cws_srx645_nativewidget1 -D 2004-01-12 config_office vcl
     ~/OOo $ cvs checkout -r OpenOffice_1_1 dmake external xml2cmp mkdepend sal solenv vos tools rscpp instsetoo
   
   

4. Download OOo 1.1.0 solver for Linux and untar it.

     ~/OOo $ tar xvfz OOo_1.1.0_LinuxIntel_solver.tar.gz
   
   

5. Download and untar GPC (General Polygon Clipper) files to the external/gpc directory.

     ~/OOo $ cd external/gpc
     ~/OOo/external/gpc $ wget ftp://ftp.cs.man.ac.uk/pub/toby/gpc/gpc231.tar.Z
     ~/OOo/external/gpc $ tar xvfz gpc231.tar.Z
     ~/OOo/external/gpc $ mv gpc231/* ./
     ~/OOo/external/gpc $ cd ../..
   
   

6. Download the patch containing the KDE NWF, gunzip and apply it in the vcl subdirectory.

     ~/OOo $ cd vcl  
     ~/OOo/vcl $ gunzip salnativewidgets-kde.2004-01-12.diff.gz
     ~/OOo/vcl $ patch -p0 < salnativewidgets-kde.2004-01-12.diff
     ~/OOo/vcl $ cd ..  
   
   

7. Configure.

     ~/OOo $ cd config_office
     ~/OOo/config_office $ ./configure --with-gcc-home=/opt/gcc-3-2-2 --with-widgetset=kde
     ~/OOo/config_office $ cd ..
   
   

8. Bootstrap.

     ~/OOo $ . LinuxIntelEnv.Set.sh
     ~/OOo $ ./bootstrap
   
   

9. Build and deliver vcl.

     ~/OOo $ cd vcl
     ~/OOo/vcl $ build
     ~/OOo/vcl $ deliver
     ~/OOo/vcl $ cd ..
   
   

10. Create an installation set and install it (for example to ~/OpenOffice.org1.1.0).
    NOTE: You may expirience a deadlock; to avoid it, please unset SESSION_MANAGER environment variable before running setup.

      ~/OOo $ cd instsetoo
      ~/OOo/instsetoo $ build
      ~/OOo/instsetoo $ cd unxlngi4.pro/01/normal
      ~/OOo/unxlngi4.pro/01/normal $ unset SESSION_MANAGER
      ~/OOo/unxlngi4.pro/01/normal $ ./setup
    
    

11. Run and enjoy your OpenOffice.org with KDE NWF support.

      ~/OOo/unxlngi4.pro/01/normal $ cd ~/OpenOffice.org1.1.0/program
      ~/OpenOffice.org1.1.0/program $ unset SESSION_MANAGER
      ~/OpenOffice.org1.1.0/program $ ./soffice
    

Contributing

Please see the general participation info on the main page. You should have signed Sun's JCA and release your patches both under LGPL and SISSL (see Contributing To OpenOffice.org) so that they could be possibly included in the official OOo tree.