PageRenderTime 167ms CodeModel.GetById 81ms app.highlight 13ms RepoModel.GetById 67ms app.codeStats 1ms

/library/Zend/Pdf/Font.php

https://bitbucket.org/baruffaldi/webapp-urltube
PHP | 775 lines | 207 code | 158 blank | 410 comment | 13 complexity | f5bdc9285a419bf14fb202cd73dd22d8 MD5 | raw file
  1<?php
  2/**
  3 * Zend Framework
  4 *
  5 * LICENSE
  6 *
  7 * This source file is subject to the new BSD license that is bundled
  8 * with this package in the file LICENSE.txt.
  9 * It is also available through the world-wide-web at this URL:
 10 * http://framework.zend.com/license/new-bsd
 11 * If you did not receive a copy of the license and are unable to
 12 * obtain it through the world-wide-web, please send an email
 13 * to license@zend.com so we can send you a copy immediately.
 14 *
 15 * @package    Zend_Pdf
 16 * @subpackage Fonts
 17 * @copyright  Copyright (c) 2005-2008 Zend Technologies USA Inc. (http://www.zend.com)
 18 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 19 */
 20
 21/** Zend_Pdf_FileParserDataSource */
 22require_once 'Zend/Pdf/FileParserDataSource.php';
 23
 24/** Zend_Pdf_FileParserDataSource_File */
 25require_once 'Zend/Pdf/FileParserDataSource/File.php';
 26
 27/** Zend_Pdf_FileParserDataSource_String */
 28require_once 'Zend/Pdf/FileParserDataSource/String.php';
 29
 30/** Zend_Pdf_FileParser_Font_OpenType_TrueType */
 31require_once 'Zend/Pdf/FileParser/Font/OpenType/TrueType.php';
 32
 33/** Zend_Pdf_Resource_Font_Simple_Parsed_TrueType */
 34require_once 'Zend/Pdf/Resource/Font/Simple/Parsed/TrueType.php';
 35
 36/** Zend_Pdf_Resource_Font_Type0 */
 37require_once 'Zend/Pdf/Resource/Font/Type0.php';
 38
 39/** Zend_Pdf_Resource_Font_CidFont_TrueType */
 40require_once 'Zend/Pdf/Resource/Font/CidFont/TrueType.php';
 41
 42/** Zend_Pdf_Resource_Font_Simple_Standard_Courier */
 43require_once 'Zend/Pdf/Resource/Font/Simple/Standard/Courier.php';
 44
 45/** Zend_Pdf_Resource_Font_Simple_Standard_CourierBold */
 46require_once 'Zend/Pdf/Resource/Font/Simple/Standard/CourierBold.php';
 47
 48/** Zend_Pdf_Resource_Font_Simple_Standard_CourierBoldOblique */
 49require_once 'Zend/Pdf/Resource/Font/Simple/Standard/CourierBoldOblique.php';
 50
 51/** Zend_Pdf_Resource_Font_Simple_Standard_CourierOblique */
 52require_once 'Zend/Pdf/Resource/Font/Simple/Standard/CourierOblique.php';
 53
 54/** Zend_Pdf_Resource_Font_Simple_Standard_Helvetica */
 55require_once 'Zend/Pdf/Resource/Font/Simple/Standard/Helvetica.php';
 56
 57/** Zend_Pdf_Resource_Font_Simple_Standard_HelveticaBold */
 58require_once 'Zend/Pdf/Resource/Font/Simple/Standard/HelveticaBold.php';
 59
 60/** Zend_Pdf_Resource_Font_Simple_Standard_HelveticaBoldOblique */
 61require_once 'Zend/Pdf/Resource/Font/Simple/Standard/HelveticaBoldOblique.php';
 62
 63/** Zend_Pdf_Resource_Font_Simple_Standard_HelveticaOblique */
 64require_once 'Zend/Pdf/Resource/Font/Simple/Standard/HelveticaOblique.php';
 65
 66/** Zend_Pdf_Resource_Font_Simple_Standard_Symbol */
 67require_once 'Zend/Pdf/Resource/Font/Simple/Standard/Symbol.php';
 68
 69/** Zend_Pdf_Resource_Font_Simple_Standard_TimesBold */
 70require_once 'Zend/Pdf/Resource/Font/Simple/Standard/TimesBold.php';
 71
 72/** Zend_Pdf_Resource_Font_Simple_Standard_TimesBoldItalic */
 73require_once 'Zend/Pdf/Resource/Font/Simple/Standard/TimesBoldItalic.php';
 74
 75/** Zend_Pdf_Resource_Font_Simple_Standard_TimesItalic */
 76require_once 'Zend/Pdf/Resource/Font/Simple/Standard/TimesItalic.php';
 77
 78/** Zend_Pdf_Resource_Font_Simple_Standard_TimesRoman */
 79require_once 'Zend/Pdf/Resource/Font/Simple/Standard/TimesRoman.php';
 80
 81/** Zend_Pdf_Resource_Font_Simple_Standard_ZapfDingbats */
 82require_once 'Zend/Pdf/Resource/Font/Simple/Standard/ZapfDingbats.php';
 83
 84/** Zend_Pdf_Resource_Font_Extracted */
 85require_once 'Zend/Pdf/Resource/Font/Extracted.php';
 86
 87
 88/**
 89 * Abstract factory class which vends {@link Zend_Pdf_Resource_Font} objects.
 90 *
 91 * Font objects themselves are normally instantiated through the factory methods
 92 * {@link fontWithName()} or {@link fontWithPath()}.
 93 *
 94 * This class is also the home for font-related constants because the name of
 95 * the true base class ({@link Zend_Pdf_Resource_Font}) is not intuitive for the
 96 * end user.
 97 *
 98 * @package    Zend_Pdf
 99 * @subpackage Fonts
100 * @copyright  Copyright (c) 2005-2008 Zend Technologies USA Inc. (http://www.zend.com)
101 * @license    http://framework.zend.com/license/new-bsd     New BSD License
102 */
103abstract class Zend_Pdf_Font
104{
105  /**** Class Constants ****/
106
107
108  /* Font Types */
109
110    /**
111     * Unknown font type.
112     */
113    const TYPE_UNKNOWN = 0;
114
115    /**
116     * One of the standard 14 PDF fonts.
117     */
118    const TYPE_STANDARD = 1;
119
120    /**
121     * A PostScript Type 1 font.
122     */
123    const TYPE_TYPE_1 = 2;
124
125    /**
126     * A TrueType font or an OpenType font containing TrueType outlines.
127     */
128    const TYPE_TRUETYPE = 3;
129
130    /**
131     * Type 0 composite font.
132     */
133    const TYPE_TYPE_0 = 4;
134    
135    /**
136     * CID font containing a PostScript Type 1 font.
137     * These fonts are used only to construct Type 0 composite fonts and can't be used directly
138     */
139    const TYPE_CIDFONT_TYPE_0 = 5;
140
141    /**
142     * CID font containing a TrueType font or an OpenType font containing TrueType outlines.
143     * These fonts are used only to construct Type 0 composite fonts and can't be used directly
144     */
145    const TYPE_CIDFONT_TYPE_2 = 6;
146    
147
148  /* Names of the Standard 14 PDF Fonts */
149
150    /**
151     * Name of the standard PDF font Courier.
152     */
153    const FONT_COURIER = 'Courier';
154
155    /**
156     * Name of the bold style of the standard PDF font Courier.
157     */
158    const FONT_COURIER_BOLD = 'Courier-Bold';
159
160    /**
161     * Name of the italic style of the standard PDF font Courier.
162     */
163    const FONT_COURIER_OBLIQUE = 'Courier-Oblique';
164
165    /**
166     * Convenience constant for a common misspelling of
167     * {@link FONT_COURIER_OBLIQUE}.
168     */
169    const FONT_COURIER_ITALIC = 'Courier-Oblique';
170
171    /**
172     * Name of the bold and italic style of the standard PDF font Courier.
173     */
174    const FONT_COURIER_BOLD_OBLIQUE = 'Courier-BoldOblique';
175
176    /**
177     * Convenience constant for a common misspelling of
178     * {@link FONT_COURIER_BOLD_OBLIQUE}.
179     */
180    const FONT_COURIER_BOLD_ITALIC = 'Courier-BoldOblique';
181
182    /**
183     * Name of the standard PDF font Helvetica.
184     */
185    const FONT_HELVETICA = 'Helvetica';
186
187    /**
188     * Name of the bold style of the standard PDF font Helvetica.
189     */
190    const FONT_HELVETICA_BOLD = 'Helvetica-Bold';
191
192    /**
193     * Name of the italic style of the standard PDF font Helvetica.
194     */
195    const FONT_HELVETICA_OBLIQUE = 'Helvetica-Oblique';
196
197    /**
198     * Convenience constant for a common misspelling of
199     * {@link FONT_HELVETICA_OBLIQUE}.
200     */
201    const FONT_HELVETICA_ITALIC = 'Helvetica-Oblique';
202
203    /**
204     * Name of the bold and italic style of the standard PDF font Helvetica.
205     */
206    const FONT_HELVETICA_BOLD_OBLIQUE = 'Helvetica-BoldOblique';
207
208    /**
209     * Convenience constant for a common misspelling of
210     * {@link FONT_HELVETICA_BOLD_OBLIQUE}.
211     */
212    const FONT_HELVETICA_BOLD_ITALIC = 'Helvetica-BoldOblique';
213
214    /**
215     * Name of the standard PDF font Symbol.
216     */
217    const FONT_SYMBOL = 'Symbol';
218
219    /**
220     * Name of the standard PDF font Times.
221     */
222    const FONT_TIMES_ROMAN = 'Times-Roman';
223
224    /**
225     * Convenience constant for a common misspelling of
226     * {@link FONT_TIMES_ROMAN}.
227     */
228    const FONT_TIMES = 'Times-Roman';
229
230    /**
231     * Name of the bold style of the standard PDF font Times.
232     */
233    const FONT_TIMES_BOLD = 'Times-Bold';
234
235    /**
236     * Name of the italic style of the standard PDF font Times.
237     */
238    const FONT_TIMES_ITALIC = 'Times-Italic';
239
240    /**
241     * Name of the bold and italic style of the standard PDF font Times.
242     */
243    const FONT_TIMES_BOLD_ITALIC = 'Times-BoldItalic';
244
245    /**
246     * Name of the standard PDF font Zapf Dingbats.
247     */
248    const FONT_ZAPFDINGBATS = 'ZapfDingbats';
249
250
251  /* Font Name String Types */
252
253    /**
254     * Full copyright notice for the font.
255     */
256    const NAME_COPYRIGHT =  0;
257
258    /**
259     * Font family name. Used to group similar styles of fonts together.
260     */
261    const NAME_FAMILY =  1;
262
263    /**
264     * Font style within the font family. Examples: Regular, Italic, Bold, etc.
265     */
266    const NAME_STYLE =  2;
267
268    /**
269     * Unique font identifier.
270     */
271    const NAME_ID =  3;
272
273    /**
274     * Full font name. Usually a combination of the {@link NAME_FAMILY} and
275     * {@link NAME_STYLE} strings.
276     */
277    const NAME_FULL =  4;
278
279    /**
280     * Version number of the font.
281     */
282    const NAME_VERSION =  5;
283
284    /**
285     * PostScript name for the font. This is the name used to identify fonts
286     * internally and within the PDF file.
287     */
288    const NAME_POSTSCRIPT =  6;
289
290    /**
291     * Font trademark notice. This is distinct from the {@link NAME_COPYRIGHT}.
292     */
293    const NAME_TRADEMARK =  7;
294
295    /**
296     * Name of the font manufacturer.
297     */
298    const NAME_MANUFACTURER =  8;
299
300    /**
301     * Name of the designer of the font.
302     */
303    const NAME_DESIGNER =  9;
304
305    /**
306     * Description of the font. May contain revision information, usage
307     * recommendations, features, etc.
308     */
309    const NAME_DESCRIPTION = 10;
310
311    /**
312     * URL of the font vendor. Some fonts may contain a unique serial number
313     * embedded in this URL, which is used for licensing.
314     */
315    const NAME_VENDOR_URL = 11;
316
317    /**
318     * URL of the font designer ({@link NAME_DESIGNER}).
319     */
320    const NAME_DESIGNER_URL = 12;
321
322    /**
323     * Plain language licensing terms for the font.
324     */
325    const NAME_LICENSE = 13;
326
327    /**
328     * URL of more detailed licensing information for the font.
329     */
330    const NAME_LICENSE_URL = 14;
331
332    /**
333     * Preferred font family. Used by some fonts to work around a Microsoft
334     * Windows limitation where only four fonts styles can share the same
335     * {@link NAME_FAMILY} value.
336     */
337    const NAME_PREFERRED_FAMILY = 16;
338
339    /**
340     * Preferred font style. A more descriptive string than {@link NAME_STYLE}.
341     */
342    const NAME_PREFERRED_STYLE = 17;
343
344    /**
345     * Suggested text to use as a representative sample of the font.
346     */
347    const NAME_SAMPLE_TEXT = 19;
348
349    /**
350     * PostScript CID findfont name.
351     */
352    const NAME_CID_NAME = 20;
353
354
355  /* Font Weights */
356
357    /**
358     * Thin font weight.
359     */
360    const WEIGHT_THIN = 100;
361
362    /**
363     * Extra-light (Ultra-light) font weight.
364     */
365    const WEIGHT_EXTRA_LIGHT = 200;
366
367    /**
368     * Light font weight.
369     */
370    const WEIGHT_LIGHT = 300;
371
372    /**
373     * Normal (Regular) font weight.
374     */
375    const WEIGHT_NORMAL = 400;
376
377    /**
378     * Medium font weight.
379     */
380    const WEIGHT_MEDIUM = 500;
381
382    /**
383     * Semi-bold (Demi-bold) font weight.
384     */
385    const WEIGHT_SEMI_BOLD = 600;
386
387    /**
388     * Bold font weight.
389     */
390    const WEIGHT_BOLD = 700;
391
392    /**
393     * Extra-bold (Ultra-bold) font weight.
394     */
395    const WEIGHT_EXTRA_BOLD = 800;
396
397    /**
398     * Black (Heavy) font weight.
399     */
400    const WEIGHT_BLACK = 900;
401
402
403  /* Font Widths */
404
405    /**
406     * Ultra-condensed font width. Typically 50% of normal.
407     */
408    const WIDTH_ULTRA_CONDENSED = 1;
409
410    /**
411     * Extra-condensed font width. Typically 62.5% of normal.
412     */
413    const WIDTH_EXTRA_CONDENSED = 2;
414
415    /**
416     * Condensed font width. Typically 75% of normal.
417     */
418    const WIDTH_CONDENSED = 3;
419
420    /**
421     * Semi-condensed font width. Typically 87.5% of normal.
422     */
423    const WIDTH_SEMI_CONDENSED = 4;
424
425    /**
426     * Normal (Medium) font width.
427     */
428    const WIDTH_NORMAL = 5;
429
430    /**
431     * Semi-expanded font width. Typically 112.5% of normal.
432     */
433    const WIDTH_SEMI_EXPANDED = 6;
434
435    /**
436     * Expanded font width. Typically 125% of normal.
437     */
438    const WIDTH_EXPANDED = 7;
439
440    /**
441     * Extra-expanded font width. Typically 150% of normal.
442     */
443    const WIDTH_EXTRA_EXPANDED = 8;
444
445    /**
446     * Ultra-expanded font width. Typically 200% of normal.
447     */
448    const WIDTH_ULTRA_EXPANDED = 9;
449
450
451  /* Font Embedding Options */
452
453    /**
454     * Do not embed the font in the PDF document.
455     */
456    const EMBED_DONT_EMBED = 0x01;
457
458    /**
459     * Embed, but do not subset the font in the PDF document.
460     */
461    const EMBED_DONT_SUBSET = 0x02;
462
463    /**
464     * Embed, but do not compress the font in the PDF document.
465     */
466    const EMBED_DONT_COMPRESS = 0x04;
467
468    /**
469     * Suppress the exception normally thrown if the font cannot be embedded
470     * due to its copyright bits being set.
471     */
472    const EMBED_SUPPRESS_EMBED_EXCEPTION = 0x08;
473
474
475
476  /**** Class Variables ****/
477
478
479    /**
480     * Array whose keys are the unique PostScript names of instantiated fonts.
481     * The values are the font objects themselves.
482     * @var array
483     */
484    private static $_fontNames = array();
485
486    /**
487     * Array whose keys are the md5 hash of the full paths on disk for parsed
488     * fonts. The values are the font objects themselves.
489     * @var array
490     */
491    private static $_fontFilePaths = array();
492
493
494
495  /**** Public Interface ****/
496
497
498  /* Factory Methods */
499
500    /**
501     * Returns a {@link Zend_Pdf_Resource_Font} object by full name.
502     *
503     * This is the preferred method to obtain one of the standard 14 PDF fonts.
504     *
505     * The result of this method is cached, preventing unnecessary duplication
506     * of font objects. Repetitive calls for a font with the same name will
507     * return the same object.
508     *
509     * The $embeddingOptions parameter allows you to set certain flags related
510     * to font embedding. You may combine options by OR-ing them together. See
511     * the EMBED_ constants defined in {@link Zend_Pdf_Font} for the list of
512     * available options and their descriptions. Note that this value is only
513     * used when creating a font for the first time. If a font with the same
514     * name already exists, you will get that object and the options you specify
515     * here will be ignored. This is because fonts are only embedded within the
516     * PDF file once.
517     *
518     * If the font name supplied does not match the name of a previously
519     * instantiated object and it is not one of the 14 standard PDF fonts, an
520     * exception will be thrown.
521     *
522     * @param string $name Full PostScript name of font.
523     * @param integer $embeddingOptions (optional) Options for font embedding.
524     * @return Zend_Pdf_Resource_Font
525     * @throws Zend_Pdf_Exception
526     */
527    public static function fontWithName($name, $embeddingOptions = 0)
528        {
529        /* First check the cache. Don't duplicate font objects.
530         */
531        if (isset(Zend_Pdf_Font::$_fontNames[$name])) {
532            return Zend_Pdf_Font::$_fontNames[$name];
533        }
534
535        /**
536         * @todo It would be cool to be able to have a mapping of font names to
537         *   file paths in a configuration file for frequently used custom
538         *   fonts. This would allow a user to use custom fonts without having
539         *   to hard-code file paths all over the place. Table this idea until
540         *   {@link Zend_Config} is ready.
541         */
542
543        /* Not an existing font and no mapping in the config file. Check to see
544         * if this is one of the standard 14 PDF fonts.
545         */
546        switch ($name) {
547            case Zend_Pdf_Font::FONT_COURIER:
548                $font = new Zend_Pdf_Resource_Font_Simple_Standard_Courier();
549                break;
550
551            case Zend_Pdf_Font::FONT_COURIER_BOLD:
552                $font = new Zend_Pdf_Resource_Font_Simple_Standard_CourierBold();
553                break;
554
555            case Zend_Pdf_Font::FONT_COURIER_OBLIQUE:
556                $font = new Zend_Pdf_Resource_Font_Simple_Standard_CourierOblique();
557                break;
558
559            case Zend_Pdf_Font::FONT_COURIER_BOLD_OBLIQUE:
560                $font = new Zend_Pdf_Resource_Font_Simple_Standard_CourierBoldOblique();
561                break;
562
563            case Zend_Pdf_Font::FONT_HELVETICA:
564                $font = new Zend_Pdf_Resource_Font_Simple_Standard_Helvetica();
565                break;
566
567            case Zend_Pdf_Font::FONT_HELVETICA_BOLD:
568                $font = new Zend_Pdf_Resource_Font_Simple_Standard_HelveticaBold();
569                break;
570
571            case Zend_Pdf_Font::FONT_HELVETICA_OBLIQUE:
572                $font = new Zend_Pdf_Resource_Font_Simple_Standard_HelveticaOblique();
573                break;
574
575            case Zend_Pdf_Font::FONT_HELVETICA_BOLD_OBLIQUE:
576                $font = new Zend_Pdf_Resource_Font_Simple_Standard_HelveticaBoldOblique();
577                break;
578
579            case Zend_Pdf_Font::FONT_SYMBOL:
580                $font = new Zend_Pdf_Resource_Font_Simple_Standard_Symbol();
581                break;
582
583            case Zend_Pdf_Font::FONT_TIMES_ROMAN:
584                $font = new Zend_Pdf_Resource_Font_Simple_Standard_TimesRoman();
585                break;
586
587            case Zend_Pdf_Font::FONT_TIMES_BOLD:
588                $font = new Zend_Pdf_Resource_Font_Simple_Standard_TimesBold();
589                break;
590
591            case Zend_Pdf_Font::FONT_TIMES_ITALIC:
592                $font = new Zend_Pdf_Resource_Font_Simple_Standard_TimesItalic();
593                break;
594
595            case Zend_Pdf_Font::FONT_TIMES_BOLD_ITALIC:
596                $font = new Zend_Pdf_Resource_Font_Simple_Standard_TimesBoldItalic();
597                break;
598
599            case Zend_Pdf_Font::FONT_ZAPFDINGBATS:
600                $font = new Zend_Pdf_Resource_Font_Simple_Standard_ZapfDingbats();
601                break;
602
603            default:
604                throw new Zend_Pdf_Exception("Unknown font name: $name",
605                                             Zend_Pdf_Exception::BAD_FONT_NAME);
606        }
607
608        /* Add this new font to the cache array and return it for use.
609         */
610        Zend_Pdf_Font::$_fontNames[$name] = $font;
611        return $font;
612    }
613
614    /**
615     * Returns a {@link Zend_Pdf_Resource_Font} object by file path.
616     *
617     * The result of this method is cached, preventing unnecessary duplication
618     * of font objects. Repetitive calls for the font with the same path will
619     * return the same object.
620     *
621     * The $embeddingOptions parameter allows you to set certain flags related
622     * to font embedding. You may combine options by OR-ing them together. See
623     * the EMBED_ constants defined in {@link Zend_Pdf_Font} for the list of
624     * available options and their descriptions. Note that this value is only
625     * used when creating a font for the first time. If a font with the same
626     * name already exists, you will get that object and the options you specify
627     * here will be ignored. This is because fonts are only embedded within the
628     * PDF file once.
629     *
630     * If the file path supplied does not match the path of a previously
631     * instantiated object or the font type cannot be determined, an exception
632     * will be thrown.
633     *
634     * @param string $filePath Full path to the font file.
635     * @param integer $embeddingOptions (optional) Options for font embedding.
636     * @return Zend_Pdf_Resource_Font
637     * @throws Zend_Pdf_Exception
638     */
639    public static function fontWithPath($filePath, $embeddingOptions = 0)
640    {
641        /* First check the cache. Don't duplicate font objects.
642         */
643        $filePathKey = md5($filePath);
644        if (isset(Zend_Pdf_Font::$_fontFilePaths[$filePathKey])) {
645            return Zend_Pdf_Font::$_fontFilePaths[$filePathKey];
646        }
647
648        /* Create a file parser data source object for this file. File path and
649         * access permission checks are handled here.
650         */
651        $dataSource = new Zend_Pdf_FileParserDataSource_File($filePath);
652
653        /* Attempt to determine the type of font. We can't always trust file
654         * extensions, but try that first since it's fastest.
655         */
656        $fileExtension = strtolower(pathinfo($filePath, PATHINFO_EXTENSION));
657
658        /* If it turns out that the file is named improperly and we guess the
659         * wrong type, we'll get null instead of a font object.
660         */
661        switch ($fileExtension) {
662            case 'ttf':
663                $font = Zend_Pdf_Font::_extractTrueTypeFont($dataSource, $embeddingOptions);
664                break;
665
666            default:
667                /* Unrecognized extension. Try to determine the type by actually
668                 * parsing it below.
669                 */
670                $font = null;
671                break;
672        }
673
674
675        if (is_null($font)) {
676            /* There was no match for the file extension or the extension was
677             * wrong. Attempt to detect the type of font by actually parsing it.
678             * We'll do the checks in order of most likely format to try to
679             * reduce the detection time.
680             */
681
682            // OpenType
683
684            // TrueType
685            if ((is_null($font)) && ($fileExtension != 'ttf')) {
686                $font = Zend_Pdf_Font::_extractTrueTypeFont($dataSource, $embeddingOptions);
687            }
688
689            // Type 1 PostScript
690
691            // Mac OS X dfont
692
693            // others?
694        }
695
696
697        /* Done with the data source object.
698         */
699        $dataSource = null;
700
701        if (! is_null($font)) {
702            /* Parsing was successful. Add this font instance to the cache arrays
703             * and return it for use.
704             */
705            $fontName = $font->getFontName(Zend_Pdf_Font::NAME_POSTSCRIPT, '', '');
706            Zend_Pdf_Font::$_fontNames[$fontName] = $font;
707            $filePathKey = md5($filePath);
708            Zend_Pdf_Font::$_fontFilePaths[$filePathKey] = $font;
709            return $font;
710
711        } else {
712            /* The type of font could not be determined. Give up.
713             */
714            throw new Zend_Pdf_Exception("Cannot determine font type: $filePath",
715                                         Zend_Pdf_Exception::CANT_DETERMINE_FONT_TYPE);
716         }
717
718    }
719
720
721
722  /**** Internal Methods ****/
723
724
725  /* Font Extraction Methods */
726
727    /**
728     * Attempts to extract a TrueType font from the data source.
729     *
730     * If the font parser throws an exception that suggests the data source
731     * simply doesn't contain a TrueType font, catches it and returns null. If
732     * an exception is thrown that suggests the TrueType font is corrupt or
733     * otherwise unusable, throws that exception. If successful, returns the
734     * font object.
735     *
736     * @param Zend_Pdf_FileParserDataSource $dataSource
737     * @param integer $embeddingOptions Options for font embedding.
738     * @return Zend_Pdf_Resource_Font_OpenType_TrueType May also return null if
739     *   the data source does not appear to contain a TrueType font.
740     * @throws Zend_Pdf_Exception
741     */
742    protected static function _extractTrueTypeFont($dataSource, $embeddingOptions)
743    {
744        try {
745            $fontParser = new Zend_Pdf_FileParser_Font_OpenType_TrueType($dataSource);
746            
747            $fontParser->parse();
748            if ($fontParser->isAdobeLatinSubset) {
749                $font = new Zend_Pdf_Resource_Font_Simple_Parsed_TrueType($fontParser, $embeddingOptions);
750            } else {
751            	/* Use Composite Type 0 font which supports Unicode character mapping */
752                $cidFont = new Zend_Pdf_Resource_Font_CidFont_TrueType($fontParser, $embeddingOptions);
753                $font    = new Zend_Pdf_Resource_Font_Type0($cidFont);
754            }
755        } catch (Zend_Pdf_Exception $exception) {
756            /* The following exception codes suggest that this isn't really a
757             * TrueType font. If we caught such an exception, simply return
758             * null. For all other cases, it probably is a TrueType font but has
759             * a problem; throw the exception again.
760             */
761            $fontParser = null;
762            switch ($exception->getCode()) {
763                case Zend_Pdf_Exception::WRONG_FONT_TYPE:    // break intentionally omitted
764                case Zend_Pdf_Exception::BAD_TABLE_COUNT:    // break intentionally omitted
765                case Zend_Pdf_Exception::BAD_MAGIC_NUMBER:
766                    return null;
767
768                default:
769                    throw $exception;
770            }
771        }
772        return $font;
773    }
774
775}