efl/legacy/evas
Carsten Haitzler b57e34cc83 ok - that was screwy.. :) propt type problem - fixed :)
SVN revision: 3487
2000-09-16 00:24:38 +00:00
..
src ok - that was screwy.. :) propt type problem - fixed :) 2000-09-16 00:24:38 +00:00
test comment added to evas_free - compiler bug? eh? really odd 2000-09-16 00:17:37 +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 add font ascent/descent checking 2000-09-13 15:08:05 +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.