File: README.libmorph

package info (click to toggle)
xmorph 1%3A20011220
  • links: PTS
  • area: main
  • in suites: woody
  • size: 3,468 kB
  • ctags: 1,534
  • sloc: ansic: 16,401; sh: 2,651; makefile: 556; tcl: 516
file content (59 lines) | stat: -rw-r--r-- 1,833 bytes parent folder | download
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

(this README was written by	A Mennucci, Mar 2001)

hi 

most of the code in libmorph is
   Written and Copyright (C) 1994-2000 by Michael J. Gourlay

libmorph contains the code to:
 handle images with colors in rrr..ggg...bbb.. ordering
 load and save images in TGA format (although 'save' is rumored to not work ok)
 meshes: load, save, change, copy, backup, ....
 warp images, according to the George Wolberg's "Digital Image Warping"
                            IEEE Computer Society Press order number 1944

there is no explicit documentation, but 
the code is well commented and easy to use

libmorph DOESN'T contain the code to:
 view and edit meshes using GTK+ : this is contained in 'gtkmorph/morph-gtk.c'
 view and edit meshes using X toolkits : this is  in 'xmorph/morph_cb.c'

otherwise libmorph would have to be linked to the specific libraries

--------
some changes are 
  Written and Copyright (C) 2000-2001 by A C G Mennucci

here is a list

--- varia in mesh.c mesh.h

various routines to access data in the meshes (I like them better than
accessing the arrays themselves: it makes for more clean programmins)

--- relax.c

this routines smooths meshes

--- Ref counting
I have modified the meshes code in libmorph to use reference counting

this is good for porting libmorph in python (or any language that
needs garbage collecting) or for easier use in GTK .

this way, a program should call meshAlloc(this) to alloc a mesh, but
call meshUnref(this) to free it.

For this reason the function meshFree is deprecated.

if a program doesnt use reference counting (xmorph doesnt) and uses
meshFree then it should define NDEBUG_LIBMORPH_REF_COUNT or NDEBUG to
avoid the warning

if a program defines
#define LIBMORPH_STRICTLY_REF_COUNT
then the function meshFree will abort if the reference counting is not zero
----