|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| RPM/ | H | 06-Jul-2003 | - | 201 | 153 |
| autom4te.cache/ | H | 06-Jul-2003 | - | 11,533 | 10,443 |
| docs/api/ | H | 06-Jul-2003 | - | 981 | 831 |
| src/ | H | 03-May-2022 | - | 27,517 | 20,629 |
| test/ | H | 06-Jul-2003 | - | 1,168 | 831 |
| AUTHORS | H A D | 15-Aug-2001 | 1.7 KiB | 70 | 51 |
| COPYING | H A D | 04-Dec-1999 | 22.7 KiB | 439 | 367 |
| ChangeLog | H A D | 11-Aug-2001 | 10.2 KiB | 217 | 198 |
| FAQ | H A D | 09-Aug-2001 | 3.3 KiB | 120 | 62 |
| Hermes.spec | H A D | 05-Jul-2000 | 1.4 KiB | 52 | 37 |
| INSTALL | H A D | 29-Feb-2000 | 49 | 2 | 1 |
| INSTALL.BSD | H A D | 05-Jul-2000 | 1.2 KiB | 31 | 20 |
| INSTALL.DOS | H A D | 05-Jul-2000 | 1.5 KiB | 1 | 1 |
| INSTALL.Win32 | H A D | 15-Aug-2001 | 1.9 KiB | 48 | 36 |
| INSTALL.unix | H A D | 05-Jul-2000 | 1.7 KiB | 62 | 33 |
| Makefile.am | H A D | 04-Dec-1999 | 15 | 3 | 1 |
| Makefile.in | H A D | 06-Jul-2003 | 16.2 KiB | 531 | 450 |
| NEWS | H A D | 11-Oct-2001 | 1.6 KiB | 56 | 40 |
| README | H A D | 15-Aug-2001 | 4.4 KiB | 134 | 83 |
| TODO | H A D | 09-Aug-2001 | 1.4 KiB | 37 | 24 |
| TODO.Blitters | H A D | 22-Feb-2000 | 137 | 12 | 9 |
| TODO.conversion | H A D | 04-Dec-1999 | 2.6 KiB | 75 | 53 |
| acconfig.h | H A D | 05-Nov-2000 | 223 | 13 | 10 |
| aclocal.m4 | H A D | 06-Jul-2003 | 147.8 KiB | 4,481 | 3,970 |
| autogen.sh | H A D | 06-Jul-2003 | 4.6 KiB | 167 | 114 |
| config.guess | H A D | 15-Dec-2001 | 37.4 KiB | 1,309 | 1,131 |
| config.sub | H A D | 20-Feb-2001 | 26.8 KiB | 1,357 | 1,218 |
| configure | H A D | 06-Jul-2003 | 328.1 KiB | 11,191 | 9,089 |
| configure.in | H A D | 04-Jun-2003 | 4.1 KiB | 174 | 136 |
| depcomp | H A D | 06-Jul-2003 | 13 KiB | 465 | 298 |
| install-sh | H A D | 04-Dec-1999 | 5.5 KiB | 251 | 152 |
| ltconfig | H A D | 14-Feb-2001 | 95.4 KiB | 3,115 | 2,405 |
| ltmain.sh | H A D | 24-Aug-2001 | 153.6 KiB | 5,484 | 4,293 |
| missing | H A D | 05-Dec-1999 | 6.1 KiB | 189 | 152 |
| mkinstalldirs | H A D | 05-Dec-1999 | 732 | 41 | 23 |
README
1HERMES 1.3.3 (c)1998 Christian Nentwich (brn) (c.nentwich@cs.ucl.ac.uk)
2and quite a few assembler routines (c) Glenn Fielder (gaffer@gaffer.org)
3
4This library and all the files enclosed in this package are free software
5under the terms of the GNU Library General Public License (LGPL). Please
6refer to the included file COPYING.LIB for the exact terms.
7----------------------------------------------------------------------------
8
9WARNING: This file may be partly outdated. I do update it with the newest
10information but some sections need some brushing up.
11
12
13Table of Contents
14
15 1. Introduction
16
17 2. Usage
18
19 3. Where to get the newest HERMES
20
21 4. Prerequisites
22 Where to get NASM (not for Linux anymore!!)
23
24 5. Libraries that use HERMES
25
26 6. How to submit bug reports
27
28
29
30
311. Introduction
32
33 HERMES, named after the messenger of the gods, is a library whose
34only purpose is to convert graphic data from one pixel format to another in
35the fastest possible way. It was born out of the PTC library. One day the
36pixel format routines were removed from PTC and made a library on their own
37to speed up development and bug fixing and to encourage other people to use
38these routines and contribute to them.
39
40 What we have now is an extremely portable library (it doesn't do any I/O,
41so it should compile on a GameBoy :) that can be compiled using either a C
42or a C++ compiler, depending on what code you use it with. It is being
43developed using both GNU C and GNU C++ in order to ensure maximum
44compatibility with both languages.
45
46 Er, before I forget it, HERMES will also do surface clearing. And it will
47do it FAST (even with x86 and MMX routines if you're on those platforms)
48
49
50
512. Where to get the newest HERMES
52
53 The HERMES homepage is at
54
55 http://clanlib.org/hermes
56
57 Both stable releases and development versions can be found there. There is
58also a mailing list for general correspondance and a CVS server that is used
59for shared development. Have a look. :)
60
61
62
633. Usage
64
65 HERMES isn't very useful on its own. It wasn't meant to be, it is developed
66to be part of bigger graphics libraries. Check out the next point on
67libraries that use HERMES. Or, alternatively, maybe you wrote your own
68graphics library that holds an offscreen buffer and wants its contents
69copied to the screen. Then HERMES is your friend as well.
70
71 Maybe you will find Hermes useful in a program of yours.. If so, send me
72some e-mail, I'll be quite interested to hear what it is :)
73
74 The API of Hermes can be found in docs/api.
75
76
77
784. Prerequisites
79
80 First of all, you need a compiler. The library has been known to compile
81on the following, but it should compile on any system with a proper ANSI C
82compiler:
83
84 - Linux, RedHat 5.0 with gcc 2.7.2
85 - Linux, RedHat 5.0 with pgcc 1.0.3a
86 - Linux, RedHat 5.1 with egcs 1.0.2
87 - Linux, RedHat 5.1 with pgcc 1.1b
88 - Linux, Mandrake 6.0 with pgcc (egcs 1.1.2)
89 - FreeBSD 2.2.7 with gcc 2.7.2 (read INSTALL.BSD)
90 - Microsoft Window, Visual C++ 6 (read INSTALL.Win32)
91 - DOS, with WATCOM C v11 (read INSTALL.DOS)
92 - DOS, with DJGPP v2 (gcc 2.8.1) (read INSTALL.DOS)
93 - BeOS for Intel, with ? (has been reported to compile)
94 - IRIX 6.3 with gcc 2.7.2 | Support for those had to be suspended
95 - Solaris with gcc 2.7.2 | because of faulty automake / libtool
96 - SunOS with gcc 2.7.2 | that only work with GNU utilities...
97
98 If you want assembler routines with Watcom C or Visual C, you need to
99download and install NASM. Get it from
100
101 http://www.cryogen.com/Nasm
102
103The latest version is 0.97. Nasm is freely available and is quite a good
104assembler.
105
106!!! Please note that NASM is NOT required anymore for assembler support
107 under Linux or DJGPP !!!
108
109
110
1115. Libraries that use HERMES
112
113 - Prometheus Truecolour (PTC) obviously uses HERMES. You can get this
114 nice C++ library at http://www.gaffer.org/ptc. Or you can download
115 the X11 version at http://www.cs.ucl.ac.uk/students/c.nentwich/ptc
116
117 - Simple DirectMedia Layer (SDL) uses the MMX assembler routines of HERMES.
118
119 - ClanLib (http://www.clanlib.org) uses Hermes for format conversion.
120
121 - It could be you! :)
122
123
1246. How to submit bug reports
125
126 Well, first of all, make sure it *really* is HERMES's fault, not the fault
127 of the library you are using.
128
129 Then go to the Sourceforge Bug Tracker located at:
130
131 http://sourceforge.net/tracker/?group_id=32920&atid=406723
132
133 And enter all your information in a "New Bug Submission".
134 (make sure Category is set to Hermes!)