mirrors/fltk
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fixed typos, added Debian and Ubuntu installation notes.

Browse Source 
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9206 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Albrecht Schlosser 2011-12-10 15:28:13 +00:00
parent 15e00887fe
commit b5a0625dcd
1 changed files with 32 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
README.Cairo.txt
View File

@ -1,4 +1,4 @@
README.Cairo.txt - 2010-10-25 - Cairo rendering support for FLTK README.Cairo.txt - 2011-12-10 - Cairo rendering support for FLTK
---------------------------------------------------------------- ----------------------------------------------------------------
@ -19,36 +19,36 @@ README.Cairo.txt - 2010-10-25 - Cairo rendering support for FLTK
iINTRODUCTION INTRODUCTION
=============== ==============
Cairo is a software library used to provide a vector graphics-based, Cairo is a software library used to provide a vector graphics-based,
device-independent API for software developers. It is designed to provide device-independent API for software developers. It is designed to provide
primitives for 2-dimensional drawing across a number of different primitives for 2-dimensional drawing across a number of different
wbackends. Cairo is designed to use hardware acceleration when available. backends. Cairo is designed to use hardware acceleration when available.
CAIRO SUPPORT FOR FLTK 1.3 CAIRO SUPPORT FOR FLTK 1.3
============================= ============================
It is now possible to integrate cairo rendering in your fltk application It is now possible to integrate cairo rendering in your fltk application
more easily and transparently. more easily and transparently.
In 1.3, we provide minimum support for Cairo, In 1.3, we provide minimum support for Cairo,
In particular, no "total" cairo rendering layer support is achieved, in particular, no "total" cairo rendering layer support is achieved,
as in fltk2. as in fltk2.
Configuration Configuration
--------------- ---------------
All the changes are *inactive* as long as the new configuration All the changes are *inactive* as long as the new configuration
option --enable-cairo is not added to the configure command. option --enable-cairo is not added to the configure command.
For non configure based platforms/ide, the FLTK_HAVE_CAIRO preprocess var. For non configure based platforms/ide, the FLTK_HAVE_CAIRO preprocess
has to be defined. variable has to be defined.
All configure based build files has now this feature integrated, All configure based build files have now this feature integrated,
also vc2005 build files have 2 new build modes "Release Cairo" and also vc2005 build files have 2 new build modes "Release Cairo" and
"Debug Cairo". "Debug Cairo".
Others IDE's will be updated progressively. Other IDE's will be updated progressively.
Currently supported features Currently supported features
@ -68,12 +68,12 @@ This function is intended to be used in your overloaded draw() method.
This feature should be only necessary in the following cases: This feature should be only necessary in the following cases:
- Intensive and almost systematic use of cairo contexts in an fltk application - Intensive and almost systematic use of cairo contexts in an fltk application
- Creation of a new cairo based scheme for fltk ... - Creation of a new cairo based scheme for fltk ...
- Other uses of cairo necessiting the flk internals instrumentation - Other uses of cairo necessitating the fltk internal instrumentation
to automatically making possible the use of a cairo context to automatically making possible the use of a cairo context
in any fltk window. in any fltk window.
- A new cairo demo that is available in the test subdirectory and has been - A new cairo demo that is available in the test subdirectory and has been
used as a testcase durings the multiplatform tests. used as a testcase during the multiplatform tests.
For more details, please have a look to the doxygen documentation, For more details, please have a look to the doxygen documentation,
in the Modules section. in the Modules section.
@ -95,7 +95,7 @@ void Fl::cairo_make_current(Fl_Window*)
*** POST 1.3 potential cairo use: *** POST 1.3 potential cairo use:
// Set cr to something you made yourself. This lets you reuse functions // Set cr to something you made yourself. This lets you reuse functions
// that use cr, and also tells fltk that cr is not one of it's own and // that use cr, and also tells fltk that cr is not one of its own and
// thus cannot be destroyed or reused for a different window: // thus cannot be destroyed or reused for a different window:
void Fl::cairo_make_current(cairo_t*) void Fl::cairo_make_current(cairo_t*)
@ -104,9 +104,10 @@ drawing is done using Cairo. In this case when a widget draw() method is
called, it is exactly as though cairo_make_current(window) has been done. called, it is exactly as though cairo_make_current(window) has been done.
*** ***
Note that it should be possible to compile so FLTK_HAVE_CAIRO works even if Note that it should be possible to compile so FLTK_HAVE_CAIRO works even
FLTK_USE_CAIRO does not, and so that turning on FLTK_USE_CAIRO does not break any if FLTK_USE_CAIRO does not, and so that turning on FLTK_USE_CAIRO does not
programs written for FLTK_HAVE_CAIRO. break any programs written for FLTK_HAVE_CAIRO.
PLATFORM SPECIFIC NOTES PLATFORM SPECIFIC NOTES
========================= =========================
@ -137,18 +138,28 @@ on the various supported operating systems.
collect2: ld returned 1 exit status collect2: ld returned 1 exit status
make[1]: *** [cairo_test] Error 1 make[1]: *** [cairo_test] Error 1
..remove "-lpixman-1" from fltk's Makefile, i.e. change this line: ..remove "-lpixman-1" from fltk's makeinclude file, i.e. change this line:
-CAIROLIBS = -lcairo -lpixman-1 -CAIROLIBS = -lcairo -lpixman-1
+CAIROLIBS = -lcairo +CAIROLIBS = -lcairo
..then another 'make' should finish the build without errors. ..then another 'make' should finish the build without errors.
You should be able to then run the test/cairo_test program. You should be able to then run the test/cairo_test program.
According to the cairo site, "For Debian and Debian derivatives including
Ubuntu" you need to install libcairo2.dev, ie:
sudo apt-get install libcairo2-dev
Tested and working with Ubuntu 11.10. Note that this also installs
libpixman-1-dev, so that dependencies on this should be resolved as well.
3.2 Windows 3.2 Windows
----------- -----------
TBD TBD
3.3 Mac OSX 3.3 Mac OSX
----------- -----------
TBD TBD
@ -159,3 +170,5 @@ on the various supported operating systems.
================== ==================
Dec 20 2010 - matt: restructured document Dec 20 2010 - matt: restructured document
Dec 09 2011 - greg: Updates for Centos 5.5 builds
Dec 10 2011 - Albrecht: Updates for Ubuntu and Debian, fixed typos.