para

#| Basic PDF core font support
unit class PDF::Content::Font::CoreFont;



head

code

=begin code :lang<raku>
use PDF::Content::Font::CoreFont;
my PDF::Content::Font::CoreFont $font .= load-font( :family<Times-Roman>, :weight<bold> );
say $font.encode("¶Hi");
say $font.stringwidth("RVX"); # 2166
say $font.stringwidth("RVX", :kern); # 2111
=end code



use PDF::Content::FontObj;
also does PDF::Content::FontObj;

use Font::AFM :UnitsPerEM;
use PDF::Content::Font;
use PDF::Content::Font::Enc::Type1;
use PDF::COS::Dict;
use PDF::COS::Name;

method units-per-EM { UnitsPerEM }

has Font::AFM $.metrics handles <kern>;
has PDF::Content::Font::Enc::Type1 $.encoder handles <encode decode encode-cids enc>;
has PDF::Content::Font $!dict;
class Cache {
    use PDF::Content::Font::Encodings :zapf-glyphs;
    constant %CharSet = %Font::AFM::Glyphs.invert.Hash;

    has Lock $!lock .= new;
    has %!fonts;
    method core-font(Str:D $font-name, PDF::Content::Font::CoreFont $class?, :$enc!, PDF::Content::Font :$dict, |c) {
        $!lock.protect: {
            ($dict.defined ?? $dict.font-obj !! %!fonts{$font-name.lc~'-*-'~$enc}) //= do {
                    my Font::AFM $metrics .= core-font( $font-name );
                    my Str %glyphs = $font-name eq 'zapfdingbats'
                                      ?? %$zapf-glyphs
                                      !! $metrics.Wx.keys.map: {%CharSet{$_} => $_ };
                    $metrics.glyphs = %glyphs;
                    my $encoder = PDF::Content::Font::Enc::Type1.new: :$enc, :%glyphs;
                    $class.new( :$encoder, :$metrics, :$dict, |c);
            }
        }
    }
}
my Cache $global-cache .= new;

submethod TWEAK(PDF::Content::Font :$!dict) {
    PDF::Content::Font.make-font($_, self)
        with $!dict;
}

our proto method load-font(|c --> ::?CLASS:D) {*};

multi method load-font( Str :$family!, |c) {
    $.load-font( $family, |c );
}

#| get the height of 'X' for the font
multi method height(Numeric $pointsize = UnitsPerEM, Bool :$ex! where .so --> Numeric) {
    $!metrics.XHeight * $pointsize / UnitsPerEM;
}

#| compute the overall font-height
multi method height(Numeric $pointsize = UnitsPerEM, Bool :$from-baseline, Bool :$hanging --> Numeric) {
    my List $bbox = $!metrics.FontBBox;
    my Numeric $height = $!metrics.Ascender
        if $hanging;
    $height //= $bbox[3];
    unless $from-baseline {
        my Numeric $descent = $!metrics.Descender
            if $hanging;
        $descent //= $bbox[1];
        $height -= $descent;
    }
    $height * $pointsize / UnitsPerEM;
}

#| compute the width of a string
method stringwidth(Str $str, $pointsize = 0, Bool :$kern

False


#| Core font base encoding: WinAnsi, MacRoman or MacExpert
method encoding returns Str {
    my Str %enc-name = :win<WinAnsi>, :mac<MacRoman>, :mac-extra<MacExpert>;
    %enc-name{self.enc};
}

method shape(Str $text, Bool :$kern = True) {
    my @shaped;
    my uint8 @cids;
    my $prev-glyph;
    my Hash $wx   = $!metrics.Wx;
    my Hash $kern-data = $!metrics.KernData if $kern;
    my $width = 0;
    my $encoder := $.encoder;

    for $!metrics.ligature-subs($text).ords -> $ord {
        my $glyph-name := $encoder.lookup-glyph($ord);
        next unless $glyph-name && $glyph-name ne '.notdef';
        my uint8 $cid = $encoder.protect: { $encoder.charset{$ord} // $encoder.add-encoding($ord) };

        if $cid {
            $width += $wx{$glyph-name};
            if $kern && $prev-glyph {
                if (my $kp := $kern-data{$prev-glyph}) && (my $kx := $kp{$glyph-name}) {
                    $width += $kx;
                    @shaped.push: $.encode-cids: @cids;
                    @shaped.push: Complex.new(-$kx, 0) ;
                    @cids = ();
                }
            }
            @cids.push: $cid;
        }
        $prev-glyph := $glyph-name;
    }
    @shaped.push($.encode-cids: @cids) if @cids;
    @shaped, $width;
}

sub name(PDF::COS::Name() $name) {
    $name;
}
method !encoding-name {
    name($_ ~ 'Encoding')
        with self.encoding;
}

method !make-dict {
    my $dict = {
        :Type( name 'Font' ), :Subtype( name 'Type1' ),
        :BaseFont( name( $!metrics.FontName ) ),
    };
    $dict<Encoding> = $_ with self!encoding-name;
    $dict;
}

#| produce a PDF Font dictionary for this core font
method to-dict returns PDF::COS::Dict {
    $!encoder.lock.protect: {
        $!dict //= PDF::Content::Font.make-font(
            PDF::COS::Dict.COERCE(self!make-dict),
            self);
    }
}

#| return the font name
method font-name returns Str { $!metrics.FontName }
#| return the underline position for the font
method underline-position returns Numeric { $!metrics.UnderlinePosition }
#| return the underline thickness for the font
method underline-thickness returns Numeric { $!metrics.UnderlineThickness }

method !load-core-font(Str:D $font-name, Cache:D :$cache = $global-cache, |c) is hidden-from-backtrace {
    $cache.core-font: $font-name, self, |c;
}

multi method load-font(Str:D $font-name! where /:i ^[ZapfDingbats|WebDings]/, :$enc='zapf', |c) {
    self!load-core-font('zapfdingbats', :$enc, |c );
}

multi method load-font(Str:D $font-name! where /:i ^Symbol/, :$enc='sym', |c) {
    self!load-core-font('symbol', :$enc, |c );
}

multi method load-font(Str:D $font-name!, :$enc = 'win', Cache:D :$cache = $global-cache, |c) {
    do with $.core-font-name($font-name, |c) {
        self!load-core-font($_, :$enc, :$cache, |c );
    } // self.WHAT;
}

#| PDF Font type (always 'Type1' for core fonts)
method type returns Str  { 'Type1' }
#| whether font is embedded (always False for core fonts)
method is-embedded  returns Bool { False }
#| whether font is subset (always False for core fonts)
method is-subset    returns Bool { False }
#| whether font is a core font (always True for core fonts)
method is-core-font returns Bool { True }

#| finish a PDF rendered font
method cb-finish returns PDF::COS::Dict {
    my $dict := self.to-dict;

    if $!encoder.differences -> $Differences {
        my $Encoding = %(
            :Type( name 'Encoding' ),
            :$Differences,
           );
        $Encoding<BaseEncoding> = $_
            with self!encoding-name;
        $!encoder.protect: {
            $dict<Encoding> = $Encoding;
        }
    }

    $dict;
}



root

FontObj

Color

React

=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<AI|file:../mcp/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>
    =item2 L<Hand these documents to an AI assistant|file:../mcp/index.podlite>

=end nested
=begin nested :!nested
=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>

=end nested
=end React


Built with L<Podlite|https://podlite.org> — the markup and publishing tools behind this site.


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


CoreFont

Synopsis

Methods

PDF::Content v0.9.11

Authors

License

Dependencies

Test Dependencies

Provides

Documentation