summaryrefslogtreecommitdiff
path: root/old/README.ethumb
blob: 3494520e831ab2862d4acfaee4b70e9f953e1c13 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
Ethumb 1.7.99

******************************************************************************

 FOR ANY ISSUES PLEASE EMAIL:
 enlightenment-devel@lists.sourceforge.net

******************************************************************************
  
Ethumb - Thumbnail generation library


FEATURES
========

 * create thumbnails with a predefined frame (possibly an edje frame);
 * have an option to create fdo-like thumbnails;
 * have a client/server utility.


API
===

It's possible to set the following properties of thumbnails:

 * size
 * format (jpeg, png, eet...)
 * aspect:
    * have crop?
    * crop alignment?
 * video:
    * video_time
 * document:
    * page
 * frame: edje file, group and swallow part to use when generating
   thumbnails
 * directory: directory where to save thumbnails
 * category: to be used as DIRECTORY/CATEGORY/md5.format

Path generation should provide the following:

 * If no path to save the thumbnail is specified, the following is used:
   * if CATEGORY, return ~/.thumbnail/CATEGORY/md5.format
   * else if size (128x128 or 256x256), format (png), aspect (keep
     aspect, no crop) and no frame matches, return
     ~/.thumbnail/{normal,large}/md5.png
   * else return WxH-FORMAT-[framed-]ASPECT

Client server provides the following:
 * multiple client support
 * per-client configuration, avoid exchanging parameters over and over
   again
 * per-client queue, when client disconnect (ie: dies), remove whole
   queue
 * all clients have same priority, so queue is mixed for processing
 * cancel thumb generation request
 * communication over (for now) dbus and (future) ecore-ipc and unix
   sockets
 * interface of client library is independent of the communication
   method selected

------------------------------------------------------------------------------
COMPILING AND INSTALLING:

  ./configure
  make
(do this as root unless you are installing in your users directories):
  make install