Werner Lemberg | a723526 | 2005-08-30 00:22:46 +0000 | [diff] [blame] | 1 | Due to our use of `libtool' to generate and install the FreeType 2 |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 2 | libraries on Unix systems, as well as other historical events, it is |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 3 | generally very difficult to know precisely which release of the font |
| 4 | engine is installed on a given system. |
Werner Lemberg | 73c10ae | 2002-09-10 15:17:32 +0000 | [diff] [blame] | 5 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 6 | This file tries to explain why and to document ways to properly detect |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 7 | FreeType on Unix. |
Werner Lemberg | 73c10ae | 2002-09-10 15:17:32 +0000 | [diff] [blame] | 8 | |
Werner Lemberg | 51b6699 | 2002-08-27 16:51:02 +0000 | [diff] [blame] | 9 | |
Werner Lemberg | a723526 | 2005-08-30 00:22:46 +0000 | [diff] [blame] | 10 | 1. Version and Release numbers |
| 11 | ------------------------------ |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 12 | |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 13 | For each new public release of FreeType 2, there are generally *three* |
Werner Lemberg | a723526 | 2005-08-30 00:22:46 +0000 | [diff] [blame] | 14 | distinct `version' numbers to consider: |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 15 | |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 16 | * The official FreeType 2 release number, like 2.3.1 or 2.4.10. |
David Turner | 8291d25 | 2002-12-26 20:51:04 +0000 | [diff] [blame] | 17 | |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 18 | * The libtool (and Unix) specific version number, like 13.0.7. This |
| 19 | is what `freetype-config --version' returns. |
David Turner | 8291d25 | 2002-12-26 20:51:04 +0000 | [diff] [blame] | 20 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 21 | * The platform-specific shared object number, used for example when |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 22 | the library is installed as `/usr/lib/libfreetype.so.6.7.1'. |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 23 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 24 | The platform-specific number is, unsurprisingly, platform-specific and |
| 25 | varies with the operating system you are using (several variants of |
| 26 | Linux, FreeBSD, Solaris, etc.). You should thus _never_ use it, even |
| 27 | for simple tests. |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 28 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 29 | The libtool-specific number does not equal the release number but is |
| 30 | tied to it. |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 31 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 32 | The release number is available at *compile* time through the following |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 33 | macros defined in FT_FREETYPE_H: |
| 34 | |
Werner Lemberg | a723526 | 2005-08-30 00:22:46 +0000 | [diff] [blame] | 35 | - FREETYPE_MAJOR: major release number |
| 36 | - FREETYPE_MINOR: minor release number |
| 37 | - FREETYPE_PATCH: patch release number |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 38 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 39 | See below for a small autoconf fragment. |
| 40 | |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 41 | The release number is also available at *runtime* through the |
| 42 | `FT_Library_Version' API. |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 43 | |
| 44 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 45 | 2. History |
| 46 | ---------- |
| 47 | |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 48 | The following table gives, for all releases since 2.3.0, the |
| 49 | corresponding libtool number, as well as the shared object number found |
| 50 | on _most_ systems, but not all of them: |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 51 | |
Werner Lemberg | a723526 | 2005-08-30 00:22:46 +0000 | [diff] [blame] | 52 | |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 53 | release libtool so |
Werner Lemberg | e42dbce | 2003-11-09 08:37:14 +0000 | [diff] [blame] | 54 | ------------------------------- |
Werner Lemberg | c6a66b4 | 2012-12-20 08:31:56 +0100 | [diff] [blame] | 55 | 2.4.11 16.0.10 6.10.0 |
Werner Lemberg | 320613e | 2012-06-15 06:45:12 +0200 | [diff] [blame] | 56 | 2.4.10 15.0.9 6.9.0 |
Werner Lemberg | 50ed33e | 2012-03-08 21:02:06 +0100 | [diff] [blame] | 57 | 2.4.9 14.1.8 6.8.1 |
Werner Lemberg | 9d7f095 | 2011-11-14 20:37:12 +0100 | [diff] [blame] | 58 | 2.4.8 14.0.8 6.8.0 |
Werner Lemberg | 016eba9 | 2011-10-18 13:34:32 +0200 | [diff] [blame] | 59 | 2.4.7 13.2.7 6.7.2 |
Werner Lemberg | 29a7965 | 2011-07-29 06:23:27 +0200 | [diff] [blame] | 60 | 2.4.6 13.1.7 6.7.1 |
Werner Lemberg | da9dbf8 | 2011-06-25 07:16:22 +0200 | [diff] [blame] | 61 | 2.4.5 13.0.7 6.7.0 |
Werner Lemberg | 9ec31ce | 2010-11-28 16:07:49 +0100 | [diff] [blame] | 62 | 2.4.4 12.2.6 6.6.2 |
Werner Lemberg | a5a32c1 | 2010-10-03 20:36:03 +0200 | [diff] [blame] | 63 | 2.4.3 12.1.6 6.6.1 |
Werner Lemberg | 6a8691e | 2010-08-06 22:00:38 +0200 | [diff] [blame] | 64 | 2.4.2 12.0.6 6.6.0 |
Werner Lemberg | b69c6ac | 2010-07-18 06:20:09 +0200 | [diff] [blame] | 65 | 2.4.1 11.1.5 6.5.1 |
Werner Lemberg | 15ffc35 | 2010-07-12 22:07:16 +0200 | [diff] [blame] | 66 | 2.4.0 11.0.5 6.5.0 |
Werner Lemberg | b36d419 | 2010-02-13 07:57:56 +0100 | [diff] [blame] | 67 | 2.3.12 10.0.4 6.4.0 |
Werner Lemberg | d699c29 | 2009-10-10 20:25:48 +0200 | [diff] [blame] | 68 | 2.3.11 9.22.3 6.3.22 |
Werner Lemberg | 19dfcbd | 2009-10-06 12:00:43 +0200 | [diff] [blame] | 69 | 2.3.10 9.21.3 6.3.21 |
David Turner | cda6f49 | 2009-03-03 20:49:32 +0000 | [diff] [blame] | 70 | 2.3.9 9.20.3 6.3.20 |
Werner Lemberg | e22dd0b | 2009-01-14 06:52:18 +0000 | [diff] [blame] | 71 | 2.3.8 9.19.3 6.3.19 |
Werner Lemberg | be54a68 | 2008-06-29 07:43:41 +0000 | [diff] [blame] | 72 | 2.3.7 9.18.3 6.3.18 |
Werner Lemberg | 6174e17 | 2008-06-10 05:58:25 +0000 | [diff] [blame] | 73 | 2.3.6 9.17.3 6.3.17 |
Werner Lemberg | 3b0e500 | 2007-07-03 04:48:19 +0000 | [diff] [blame] | 74 | 2.3.5 9.16.3 6.3.16 |
Werner Lemberg | 14bf82e | 2007-04-10 04:09:49 +0000 | [diff] [blame] | 75 | 2.3.4 9.15.3 6.3.15 |
David Turner | 23553d6 | 2007-03-26 13:37:17 +0000 | [diff] [blame] | 76 | 2.3.3 9.14.3 6.3.14 |
David Turner | 121cad5 | 2007-03-08 16:43:50 +0000 | [diff] [blame] | 77 | 2.3.2 9.13.3 6.3.13 |
David Turner | 3eaef6c | 2007-01-30 10:40:23 +0000 | [diff] [blame] | 78 | 2.3.1 9.12.3 6.3.12 |
David Turner | d5ca747 | 2007-01-10 14:18:15 +0000 | [diff] [blame] | 79 | 2.3.0 9.11.3 6.3.11 |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 80 | |
| 81 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 82 | 3. Autoconf Code Fragment |
| 83 | ------------------------- |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 84 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 85 | Lars Clausen contributed the following autoconf fragment to detect which |
| 86 | version of FreeType is installed on a system. This one tests for a |
Werner Lemberg | a723526 | 2005-08-30 00:22:46 +0000 | [diff] [blame] | 87 | version that is at least 2.0.9; you should change it to check against |
Werner Lemberg | 77c34b8 | 2003-05-20 22:06:38 +0000 | [diff] [blame] | 88 | other release numbers. |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 89 | |
Werner Lemberg | 77c34b8 | 2003-05-20 22:06:38 +0000 | [diff] [blame] | 90 | |
| 91 | AC_MSG_CHECKING([whether FreeType version is 2.0.9 or higher]) |
| 92 | old_CPPFLAGS="$CPPFLAGS" |
| 93 | CPPFLAGS=`freetype-config --cflags` |
| 94 | AC_TRY_CPP([ |
Werner Lemberg | be67c4e | 2003-11-24 22:54:58 +0000 | [diff] [blame] | 95 | |
Werner Lemberg | e42dbce | 2003-11-09 08:37:14 +0000 | [diff] [blame] | 96 | #include <ft2build.h> |
| 97 | #include FT_FREETYPE_H |
Werner Lemberg | 77c34b8 | 2003-05-20 22:06:38 +0000 | [diff] [blame] | 98 | #if (FREETYPE_MAJOR*1000 + FREETYPE_MINOR)*1000 + FREETYPE_PATCH < 2000009 |
| 99 | #error Freetype version too low. |
| 100 | #endif |
Werner Lemberg | be67c4e | 2003-11-24 22:54:58 +0000 | [diff] [blame] | 101 | ], |
| 102 | [AC_MSG_RESULT(yes) |
| 103 | FREETYPE_LIBS=`freetype-config --libs` |
| 104 | AC_SUBST(FREETYPE_LIBS) |
| 105 | AC_DEFINE(HAVE_FREETYPE,1,[Define if you have the FreeType2 library]) |
| 106 | CPPFLAGS="$old_CPPFLAGS"], |
| 107 | [AC_MSG_ERROR([Need FreeType library version 2.0.9 or higher])]) |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 108 | |
Werner Lemberg | 56c368c | 2005-06-04 23:00:25 +0000 | [diff] [blame] | 109 | ------------------------------------------------------------------------ |
| 110 | |
Werner Lemberg | 50ed33e | 2012-03-08 21:02:06 +0100 | [diff] [blame] | 111 | Copyright 2002-2012 by |
Werner Lemberg | 56c368c | 2005-06-04 23:00:25 +0000 | [diff] [blame] | 112 | David Turner, Robert Wilhelm, and Werner Lemberg. |
| 113 | |
Werner Lemberg | a723526 | 2005-08-30 00:22:46 +0000 | [diff] [blame] | 114 | This file is part of the FreeType project, and may only be used, |
| 115 | modified, and distributed under the terms of the FreeType project |
| 116 | license, LICENSE.TXT. By continuing to use, modify, or distribute this |
| 117 | file you indicate that you have read the license and understand and |
Werner Lemberg | 56c368c | 2005-06-04 23:00:25 +0000 | [diff] [blame] | 118 | accept it fully. |
| 119 | |
David Turner | 621e488 | 2002-12-16 21:51:24 +0000 | [diff] [blame] | 120 | |
Werner Lemberg | a16c4a7 | 2003-04-21 13:30:27 +0000 | [diff] [blame] | 121 | --- end of VERSION.DLL --- |