Class: Fontisan::Type1::PrivateDict

Inherits:
Object
  • Object
show all
Defined in:
lib/fontisan/type1/private_dict.rb

Overview

Type 1 Private Dictionary model

[‘PrivateDict`](lib/fontisan/type1/private_dict.rb) parses and stores the private dictionary from a Type 1 font, which contains hinting and spacing information used by the CharString interpreter.

The private dictionary includes:

  • BlueValues and OtherBlues (alignment zones for optical consistency)

  • StdHW and StdVW (standard stem widths)

  • StemSnapH and StemSnapV (stem snap arrays)

  • Subrs (local subroutines)

  • lenIV (CharString encryption IV length)

Examples:

Parse private dictionary from decrypted font data

priv = Fontisan::Type1::PrivateDict.parse(decrypted_data)
puts priv.blue_values
puts priv.std_hw

See Also:

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ PrivateDict

Initialize a new PrivateDict



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
 
# File 'lib/fontisan/type1/private_dict.rb', line 92

def initialize
  @blue_values = []
  @other_blues = []
  @family_blues = []
  @family_other_blues = []
  @blue_scale = 0.039625
  @blue_shift = 7
  @blue_fuzz = 1
  @std_hw = []
  @std_vw = []
  @stem_snap_h = []
  @stem_snap_v = []
  @force_bold = false
  @len_iv = 4
  @subrs = []
  @language_group = 0
  @expansion_factor = 0.06
  @initial_random_seed = 0
  @raw_data = {}
  @parsed = false
end

Instance Attribute Details

#blue_fuzz ⇒ Integer

Returns BlueFuzz.

Returns:

  • (Integer) —

    BlueFuzz



44
45
46
 
# File 'lib/fontisan/type1/private_dict.rb', line 44

def blue_fuzz
  @blue_fuzz
end

#blue_scale ⇒ Float

Returns BlueScale.

Returns:

  • (Float) —

    BlueScale



38
39
40
 
# File 'lib/fontisan/type1/private_dict.rb', line 38

def blue_scale
  @blue_scale
end

#blue_shift ⇒ Integer

Returns BlueShift.

Returns:

  • (Integer) —

    BlueShift



41
42
43
 
# File 'lib/fontisan/type1/private_dict.rb', line 41

def blue_shift
  @blue_shift
end

#blue_values ⇒ Array<Integer>

Returns BlueValues alignment zones.

Returns:

  • (Array<Integer>) —

    BlueValues alignment zones



26
27
28
 
# File 'lib/fontisan/type1/private_dict.rb', line 26

def blue_values
  @blue_values
end

#expansion_factor ⇒ Float

Returns ExpansionFactor for counter widening.

Returns:

  • (Float) —

    ExpansionFactor for counter widening



71
72
73
 
# File 'lib/fontisan/type1/private_dict.rb', line 71

def expansion_factor
  @expansion_factor
end

#family_blues ⇒ Array<Integer>

Returns FamilyBlues alignment zones.

Returns:

  • (Array<Integer>) —

    FamilyBlues alignment zones



32
33
34
 
# File 'lib/fontisan/type1/private_dict.rb', line 32

def family_blues
  @family_blues
end

#family_other_blues ⇒ Array<Integer>

Returns FamilyOtherBlues alignment zones.

Returns:

  • (Array<Integer>) —

    FamilyOtherBlues alignment zones



35
36
37
 
# File 'lib/fontisan/type1/private_dict.rb', line 35

def family_other_blues
  @family_other_blues
end

#force_bold ⇒ Boolean

Returns ForceBold flag.

Returns:

  • (Boolean) —

    ForceBold flag



59
60
61
 
# File 'lib/fontisan/type1/private_dict.rb', line 59

def force_bold
  @force_bold
end

#initial_random_seed ⇒ Integer

Returns InitialRandomSeed for randomization.

Returns:

  • (Integer) —

    InitialRandomSeed for randomization



74
75
76
 
# File 'lib/fontisan/type1/private_dict.rb', line 74

def initial_random_seed
  @initial_random_seed
end

#language_group ⇒ Integer

Returns LanguageGroup (0 for Latin, 1 for Japanese, etc.).

Returns:

  • (Integer) —

    LanguageGroup (0 for Latin, 1 for Japanese, etc.)



68
69
70
 
# File 'lib/fontisan/type1/private_dict.rb', line 68

def language_group
  @language_group
end

#len_iv ⇒ Integer

Returns lenIV (CharString encryption IV length).

Returns:

  • (Integer) —

    lenIV (CharString encryption IV length)



62
63
64
 
# File 'lib/fontisan/type1/private_dict.rb', line 62

def len_iv
  @len_iv
end

#other_blues ⇒ Array<Integer>

Returns OtherBlues alignment zones.

Returns:

  • (Array<Integer>) —

    OtherBlues alignment zones



29
30
31
 
# File 'lib/fontisan/type1/private_dict.rb', line 29

def other_blues
  @other_blues
end

#raw_data ⇒ Hash (readonly)

Returns Raw dictionary data.

Returns:

  • (Hash) —

    Raw dictionary data



77
78
79
 
# File 'lib/fontisan/type1/private_dict.rb', line 77

def raw_data
  @raw_data
end

#std_hw ⇒ Array<Float>

Returns StdHW (standard horizontal width).

Returns:

  • (Array<Float>) —

    StdHW (standard horizontal width)



47
48
49
 
# File 'lib/fontisan/type1/private_dict.rb', line 47

def std_hw
  @std_hw
end

#std_vw ⇒ Array<Float>

Returns StdVW (standard vertical width).

Returns:

  • (Array<Float>) —

    StdVW (standard vertical width)



50
51
52
 
# File 'lib/fontisan/type1/private_dict.rb', line 50

def std_vw
  @std_vw
end

#stem_snap_h ⇒ Array<Float>

Returns StemSnapH (horizontal stem snap array).

Returns:

  • (Array<Float>) —

    StemSnapH (horizontal stem snap array)



53
54
55
 
# File 'lib/fontisan/type1/private_dict.rb', line 53

def stem_snap_h
  @stem_snap_h
end

#stem_snap_v ⇒ Array<Float>

Returns StemSnapV (vertical stem snap array).

Returns:

  • (Array<Float>) —

    StemSnapV (vertical stem snap array)



56
57
58
 
# File 'lib/fontisan/type1/private_dict.rb', line 56

def stem_snap_v
  @stem_snap_v
end

#subrs ⇒ Array<String>

Returns Subrs (local subroutines).

Returns:

  • (Array<String>) —

    Subrs (local subroutines)



65
66
67
 
# File 'lib/fontisan/type1/private_dict.rb', line 65

def subrs
  @subrs
end

Class Method Details

.parse(data) ⇒ PrivateDict

Parse private dictionary from decrypted Type 1 font data

Examples:

Parse from decrypted font data

priv = Fontisan::Type1::PrivateDict.parse(decrypted_data)

Parameters:

  • data (String) —

    Decrypted Type 1 font data

Returns:

Raises:



87
88
89
 
# File 'lib/fontisan/type1/private_dict.rb', line 87

def self.parse(data)
  new.parse(data)
end

Instance Method Details

#[](key) ⇒ Object?

Get raw value from dictionary

Parameters:

  • key (String) —

    Dictionary key

Returns:

  • (Object, nil) —

    Value or nil if not found



136
137
138
 
# File 'lib/fontisan/type1/private_dict.rb', line 136

def [](key)
  @raw_data[key]
end

#effective_blue_values ⇒ Array<Float>

Get effective BlueValues for hinting

Returns BlueValues adjusted by BlueScale.

Returns:

  • (Array<Float>) —

    Scaled blue values



145
146
147
148
149
 
# File 'lib/fontisan/type1/private_dict.rb', line 145

def effective_blue_values
  return [] if @blue_values.empty?

  @blue_values.map { |v| v * @blue_scale }
end

#has_blues? ⇒ Boolean

Check if font has blues

Returns:

  • (Boolean) —

    True if BlueValues or OtherBlues are defined



154
155
156
 
# File 'lib/fontisan/type1/private_dict.rb', line 154

def has_blues?
  !@blue_values.empty? || !@other_blues.empty?
end

#has_stem_hints? ⇒ Boolean

Check if font has stem hints

Returns:

  • (Boolean) —

    True if StdHW, StdVW, or StemSnap arrays are defined



161
162
163
164
 
# File 'lib/fontisan/type1/private_dict.rb', line 161

def has_stem_hints?
  !@std_hw.empty? || !@std_vw.empty? ||
    !@stem_snap_h.empty? || !@stem_snap_v.empty?
end

#parse(data) ⇒ PrivateDict

Parse private dictionary from decrypted Type 1 font data

Parameters:

  • data (String) —

    Decrypted Type 1 font data

Returns:



118
119
120
121
122
123
 
# File 'lib/fontisan/type1/private_dict.rb', line 118

def parse(data)
  extract_private_dict(data)
  extract_properties
  @parsed = true
  self
end

#parsed? ⇒ Boolean

Check if dictionary was successfully parsed

Returns:

  • (Boolean) —

    True if dictionary has been parsed



128
129
130
 
# File 'lib/fontisan/type1/private_dict.rb', line 128

def parsed?
  @parsed
end