- add a note to the README on how to get font suitcases and dfont files
authorTony Cook <tony@develop=help.com>
Thu, 23 Dec 2004 23:02:51 +0000 (23:02 +0000)
committerTony Cook <tony@develop=help.com>
Thu, 23 Dec 2004 23:02:51 +0000 (23:02 +0000)
  working on OS X.

Changes
README

diff --git a/Changes b/Changes
index c3b2257..77d032c 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 4918d0a..706cfc1 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
 ========================