- add a note to the README on how to get font suitcases and dfont files

  working on OS X.

diff --git a/Changes b/Changes
index c3b22575c36972d053cd88a7fe039acf32cf0a21..77d032cabb7ea00c0dc3623b8e00033c4f3b89c0 100644 (file)
--- a/Changes
+++ b/Changes
@@ -970,6 +970,8 @@ Revision history for Perl extension Imager.
 - we were undefing the wrong macro (used as an include guard) when
   building the error code translation function for freetype 2.  This
   meant most errors came out as numbers.
+- add a note to the README on how to get font suitcases and dfont files
+  working on OS X.
 
 =================================================================
 

diff --git a/README b/README
index 4918d0aa5793f7fb681e5efe8b19f131430d65f7..706cfc11b3c69922664d7ceee4d757b48dd12c96 100644 (file)
--- a/README
+++ b/README
@@ -140,6 +140,33 @@ To see which directories should be in the include path, try:
 
   freetype-config --cflags
 
+
+Macintosh dfont and suitcase font support
+-----------------------------------------
+
+Through Freetype 2.1, Imager can use Macintosh DFON (.dfont) fonts and
+suitcase font files.
+
+If you want to be able to use more than just the first face in the
+font file though, you will need to configure freetype2 with the
+--with-old-mac-fonts option:
+
+  ./configure --with-old-mac-fonts
+
+You can use the index option to get to the other font faces in the
+file:
+
+  # get the second face from $file
+  my $font = Imager::Font->new(file=>$file, index=>1)
+    or die Imager->errstr;
+
+If you're using a suitcase font, you will also need to force the use
+of freetype 2 with the type argument:
+
+  my $font = Imager::Font->new(file=>$suitcase, type=>'ft2', index=>$index)
+    or die Imager->errstr;
+
+
 ========================
 3. External dependencies
 ========================