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

#array_to_type1(name, value) ⇒ String

Format an array value for Type 1 output

Parameters:

  • name (Symbol) —

    Array name

  • value (Array) —

    Array value

Returns:

  • (String) —

    Formatted Type 1 array definition



201
202
203
 
# File 'lib/fontisan/type1/private_dict.rb', line 201

def array_to_type1(name, value)
  "/#{name} [#{value.join(' ')}] def"
end

#boolean_to_type1(name, value) ⇒ String

Format a boolean value for Type 1 output

Parameters:

  • name (Symbol) —

    Value name

  • value (Boolean) —

    Boolean value

Returns:

  • (String) —

    Formatted Type 1 boolean definition



219
220
221
 
# File 'lib/fontisan/type1/private_dict.rb', line 219

def boolean_to_type1(name, value)
  "/#{name} #{value} def"
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

#scalar_to_type1(name, value) ⇒ String

Format a scalar value for Type 1 output

Parameters:

  • name (Symbol) —

    Value name

  • value (Numeric) —

    Numeric value

Returns:

  • (String) —

    Formatted Type 1 scalar definition



210
211
212
 
# File 'lib/fontisan/type1/private_dict.rb', line 210

def scalar_to_type1(name, value)
  "/#{name} #{value} def"
end

#to_type1_format ⇒ String

Convert PrivateDict to Type 1 text format

Generates the PostScript code for the Private dictionary section of a Type 1 font.

Examples:

Generate Type 1 format

priv = PrivateDict.new
priv.blue_values = [-10, 0, 470, 480]
puts priv.to_type1_format

Returns:

  • (String) —

    Type 1 Private dictionary text



177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
 
# File 'lib/fontisan/type1/private_dict.rb', line 177

def to_type1_format
  result = []
  result << array_to_type1(:BlueValues, @blue_values) unless @blue_values.empty?
  result << array_to_type1(:OtherBlues, @other_blues) unless @other_blues.empty?
  result << array_to_type1(:FamilyBlues, @family_blues) unless @family_blues.empty?
  result << array_to_type1(:FamilyOtherBlues, @family_other_blues) unless @family_other_blues.empty?
  result << scalar_to_type1(:BlueScale, @blue_scale)
  result << scalar_to_type1(:BlueShift, @blue_shift)
  result << scalar_to_type1(:BlueFuzz, @blue_fuzz)
  result << array_to_type1(:StdHW, @std_hw) unless @std_hw.empty?
  result << array_to_type1(:StdVW, @std_vw) unless @std_vw.empty?
  result << array_to_type1(:StemSnapH, @stem_snap_h) unless @stem_snap_h.empty?
  result << array_to_type1(:StemSnapV, @stem_snap_v) unless @stem_snap_v.empty?
  result << boolean_to_type1(:ForceBold, @force_bold) unless @force_bold == false
  result << scalar_to_type1(:lenIV, @len_iv)

  result.join("\n")
end