efl/legacy/evas
Carsten Haitzler 289117a952 privatise data structs for evas... much cleaner. all structs are now internal
so you cant look into them. all defines now become enums too - cleaner. no
more bypassing the api is possible :)

also added better checks and --with- stuff for imlib2, gl and ttf


SVN revision: 3548
2000-09-26 19:16:48 +00:00
..
src privatise data structs for evas... much cleaner. all structs are now internal 2000-09-26 19:16:48 +00:00
test more on the new evas test. add some more api calls. 2000-09-25 19:47:44 +00:00
.cvsignore ignore more 2000-07-30 20:43:54 +00:00
AUTHORS evas........ 2000-07-30 20:21:14 +00:00
COPYING evas........ 2000-07-30 20:21:14 +00:00
Makefile.am evas-config scritp added 2000-08-22 04:26:18 +00:00
README add to the README 2000-08-20 23:04:55 +00:00
acconfig.h check for gl & glu now too - better checks 2000-08-13 06:31:54 +00:00
autogen.sh evas........ 2000-07-30 20:21:14 +00:00
configure.in privatise data structs for evas... much cleaner. all structs are now internal 2000-09-26 19:16:48 +00:00
evas-config.in get rid of replace 2000-08-22 21:25:52 +00:00
evas.spec Adding yet another spec file. 2000-09-01 03:16:12 +00:00

README

-------------------------------------------------------------------------------
 E V A S - 0.0.0
-------------------------------------------------------------------------------

This is the ``E Canvas'' - a rip off of some of the other canvas's floating
about - Tk and gnome too. it's at the Xlib level. it's intended to be
accelerated by hardware or highly optimised software where possible. It is
intended to be simple and allow for the building of interfaces ontop of it.

if you got this from cvs do:
./autogen.sh

otherwise do:
./configure

then to compile:
make

if you wish to install (as root):
make install

in the test directory you will find a test program:
cd test
./evas_test

this will by default try the GL engine - if you don't have hardware
accelerated OpenGL it will be SLOOOOOOOOOOOW. Also Mesa 3.2 and below have
known bugs that cause a segv. it's been fixed in 3.3.

If evas didnt find OpenGL it will have built a software only engine so you
don't need to do anything. You can force software rendering with:
./evas_test 640 480 software

you can change the window size by changing the 2 numbers (they are width and
height). if you dont append ``software'' as a parameter it will fall back to
GL rendering.


-------------------------------------------------------------------------------
MORE DETAILED DESCRIPTION:
-------------------------------------------------------------------------------

Evas? Canvas? What? OK.. you're baffled as to what that stuff is. Time to
explain.

A canvas is a high-level rendering engine. Instead of a program having to
handle exposes or updates then redraw bit by bit (draw line, draw box, 
paste image etc.) after having figured out what has changed and what need to
be re-rendered - what data loaded in maps to what... then finally order the
draw in the right way to optimize it - a canvas provides a high-level API to
this kind of thing and handles all the smarts inside.

The result is an application creates an Evas & attaches that evas to a window.
Now it just creates objects - create an image object, a text object, a line
object, a rectangle object etc. It just moves and resizes these objects around
by calling routines in Evas - Evas handles redrawing, scaling, ordering the
draws to acount for layers , clipping objects out that don't exist in the
visible Evas area etc.

This means less headache for tha application programmer. Now why do this as
a whole new library? Well - because the library can render the Evas as fast
as possible. It uses Imlib2 to do the grunt work of loading images - and
beyond that it can currently use either imlib2 or OpenGL to render to the
Evas - if you have decent hardware that's supported by OpenGL you will see
in the area of 10-50 times (in future even higher) speedups in rendering
using the GL backend instead of the Imlib2 one (even though Imlib2 is a
highly optimized software rendering engine). The good thing here is that the
application can choose what system to use. If that system isn't available or 
Evas didn't compile with it, it will fall back to the nearest approximation 
(it will ALWAYS have Imlib2 and X11 rendering backends - Imlib2 being able to
actually alpha blend, but X11 keeping the rendering server-side with pixmaps
and clip masks) so this means a highly optimized rendering subsystem to build
more complex things ontop of.