| 1 |
# -*- text -*- |
| 2 |
# README $Id: README,v 4.3 2008/10/27 15:34:11 hut66au Exp $ |
| 3 |
# |
| 4 |
|
| 5 |
Introduction |
| 6 |
|
| 7 |
Imview is an image viewing package intended for image analysis, i.e: |
| 8 |
getting numbers (measurements) out of images. It is designed to |
| 9 |
interface easily to image analysis packages such as Khoros or Z-IMAGE |
| 10 |
(http://www.cmis.csiro.au/IAP/zimage.htm), to perform as an external |
| 11 |
viewer. |
| 12 |
|
| 13 |
It has facilities for histogram-based segmentation, comparing images |
| 14 |
before and after a series of filtering, etc. It supports many different |
| 15 |
image format and pixel types (integer and floating point, 1 to 64 bits). |
| 16 |
|
| 17 |
It can also perform more than adequately as a general-purpose image |
| 18 |
display application, but this is not the emphasis. |
| 19 |
|
| 20 |
Imview is free software distributed under the GNU public licence. |
| 21 |
|
| 22 |
Version 1.1.x: |
| 23 |
|
| 24 |
Imview version 1.1.x is the currently unstable version based on FLTK 1.1.x |
| 25 |
|
| 26 |
Roadmap |
| 27 |
|
| 28 |
IMVIEW consists of a main executable and a few support files. Among the |
| 29 |
support files there are: |
| 30 |
|
| 31 |
.lut files: these are simple Colour Look-Up Table text |
| 32 |
files that associate a grey-level index to |
| 33 |
an RGB colour (false colours). |
| 34 |
.html files: these are the online documentation (very |
| 35 |
slim at this stage) |
| 36 |
.jpg file: this is the splash screen. Replace it or |
| 37 |
delete if you don't like it! Let me know |
| 38 |
if you make a better one. |
| 39 |
|
| 40 |
The main executable (imview) is a semi-static executable linked against |
| 41 |
a number of imaging libraries (JPEG, PNG, TIFF, ImageMagick) and the GUI |
| 42 |
toolkit (FLTK). |
| 43 |
|
| 44 |
Installer: |
| 45 |
|
| 46 |
Imview is provided both in source and binary form. All binary formats |
| 47 |
come with an installer. If you downloaded the RPM then use the rpm |
| 48 |
installer to make use of it, otherwise Under Unix: untar the file and |
| 49 |
type ./setup Under Windows: simply execute the file. |
| 50 |
|
| 51 |
NOTE: |
| 52 |
|
| 53 |
under windows 9x (95, 98 and me) you must make sure that TCP/IP is |
| 54 |
installed. If you have an internet connection you will be fine. TCP/IP |
| 55 |
is always present with Unix, NT, Win2k and WinXP. |
| 56 |
|
| 57 |
Documentation: |
| 58 |
|
| 59 |
Imview should be very simple to use, but full documentation is available |
| 60 |
in HTML, PS or PDF format, see the following web sites |
| 61 |
|
| 62 |
http://www.cmis.csiro.au/Hugues.Talbot/imview |
| 63 |
http://www.esiee.fr/~talboth/ |
| 64 |
|
| 65 |
or |
| 66 |
|
| 67 |
http://imview.sourceforge.net/ |
| 68 |
|
| 69 |
To compile imview: |
| 70 |
|
| 71 |
See the INSTALL text file. Essentially you will need the FLTK library |
| 72 |
(http://www.fltk.org), and supporting imaging libraries if they are not |
| 73 |
present on your system. |
| 74 |
|
| 75 |
On Unix imview uses the POSIX thread library, TCP/IP sockets and the |
| 76 |
SYSV IPC if present. Under windows an implementation of POSIX threads is |
| 77 |
provided (SYSV IPC is not used, sockets are used instead). |
| 78 |
|
| 79 |
The directory structure: |
| 80 |
|
| 81 |
imview. The main source repository |
| 82 |
|-- check For regression testing (an interesting concept for GUIs) |
| 83 |
|-- client Network client code (to remote-control imview) |
| 84 |
|-- distrib To make distributions |
| 85 |
| |-- binaries Generic binary distributions |
| 86 |
| |-- redhat Specific to the RedHat RPM system |
| 87 |
| | |-- BUILD |
| 88 |
| | |-- CVS |
| 89 |
| | |-- RPMS |
| 90 |
| | |-- SOURCES |
| 91 |
| | |-- SPECS |
| 92 |
| | `-- SRPMS |
| 93 |
| | |
| 94 |
| `-- windows Uses the Inno Setup installer for Windows |
| 95 |
| |
| 96 |
|-- doc Documentation (online one only, full documentation is separate) |
| 97 |
|-- export Used for making snapshots |
| 98 |
|-- fluid Interface files (FLUID is the fast light user interface designer) |
| 99 |
|-- io I/O library (all these different image formats) |
| 100 |
|-- obj Compilation subdirectory |
| 101 |
| `-- NT-msvc++ MSVC++ project files |
| 102 |
| `-- fluid |
| 103 |
|-- server Imview server (for remote control) |
| 104 |
|-- stl Missing bits of the STL for egcs/gcc-2.95.x |
| 105 |
| `-- sstream |
| 106 |
`-- support Support files (LUT, etc). |