Class: Prawn::Text::Formatted::Box
- Inherits:
-
Object
- Object
- Prawn::Text::Formatted::Box
- Defined in:
- lib/prawn/text/formatted/box.rb
Overview
Generally, one would use the Prawn::Text::Formatted#formatted_text_box convenience method. However, using Text::Formatted::Box.new in conjunction with #render(:dry_run => true) enables one to do look-ahead calculations prior to placing text on the page, or to determine how much vertical space was consumed by the printed text
Direct Known Subclasses
Experimental API collapse
-
#ascender ⇒ Object
readonly
The height of the ascender of the last line printed.
-
#at ⇒ Object
readonly
The upper left corner of the text box.
-
#descender ⇒ Object
readonly
The height of the descender of the last line printed.
-
#leading ⇒ Object
readonly
The leading used during printing.
-
#line_height ⇒ Object
readonly
The line height of the last line printed.
-
#text ⇒ Object
readonly
The text that was successfully printed (or, if
dry_run
was used, the text that would have been successfully printed).
Experimental API collapse
-
#available_width ⇒ Object
The width available at this point in the box.
-
#draw_fragment(fragment, accumulated_width = 0, line_width = 0, word_spacing = 0) ⇒ Object
fragment
is a Prawn::Text::Formatted::Fragment object. -
#everything_printed? ⇒ Boolean
True if everything printed (or, if
dry_run
was used, everything would have been successfully printed). -
#height ⇒ Object
The height actually used during the previous
render
. -
#initialize(formatted_text, options = {}) ⇒ Box
constructor
See Prawn::Text#text_box for valid options.
- #line_gap ⇒ Object
-
#nothing_printed? ⇒ Boolean
True if nothing printed (or, if
dry_run
was used, nothing would have been successfully printed). -
#render(flags = {}) ⇒ Object
Render text to the document based on the settings defined in initialize.
Extension API collapse
-
.extensions ⇒ Object
Example (see Prawn::Text::Core::Formatted::Wrap for what is required of the wrap method if you want to override the default wrapping algorithm):.
- #valid_options ⇒ Object
Constructor Details
#initialize(formatted_text, options = {}) ⇒ Box
See Prawn::Text#text_box for valid options
138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 |
# File 'lib/prawn/text/formatted/box.rb', line 138 def initialize(formatted_text, = {}) @inked = false Prawn.(, ) = .dup self.class.extensions.reverse_each { |e| extend e } @overflow = [:overflow] || :truncate @disable_wrap_by_char = [:disable_wrap_by_char] self.original_text = formatted_text @text = nil @document = [:document] @direction = [:direction] || @document.text_direction @fallback_fonts = [:fallback_fonts] || @document.fallback_fonts @at = ( [:at] || [@document.bounds.left, @document.bounds.top] ).dup @width = [:width] || @document.bounds.right - @at[0] @height = [:height] || default_height @align = [:align] || (@direction == :rtl ? :right : :left) @vertical_align = [:valign] || :top @leading = [:leading] || @document.default_leading @character_spacing = [:character_spacing] || @document.character_spacing @mode = [:mode] || @document.text_rendering_mode @rotate = [:rotate] || 0 @rotate_around = [:rotate_around] || :upper_left @single_line = [:single_line] @draw_text_callback = [:draw_text_callback] # if the text rendering mode is :unknown, force it back to :fill if @mode == :unknown @mode = :fill end if @overflow == :expand # if set to expand, then we simply set the bottom # as the bottom of the document bounds, since that # is the maximum we should expand to @height = default_height @overflow = :truncate end @min_font_size = [:min_font_size] || 5 if [:kerning].nil? [:kerning] = @document.default_kerning? end @options = { kerning: [:kerning], size: [:size], style: [:style] } super(formatted_text, ) end |
Instance Attribute Details
#ascender ⇒ Object (readonly)
The height of the ascender of the last line printed
126 127 128 |
# File 'lib/prawn/text/formatted/box.rb', line 126 def ascender @ascender end |
#at ⇒ Object (readonly)
The upper left corner of the text box
122 123 124 |
# File 'lib/prawn/text/formatted/box.rb', line 122 def at @at end |
#descender ⇒ Object (readonly)
The height of the descender of the last line printed
128 129 130 |
# File 'lib/prawn/text/formatted/box.rb', line 128 def descender @descender end |
#leading ⇒ Object (readonly)
The leading used during printing
130 131 132 |
# File 'lib/prawn/text/formatted/box.rb', line 130 def leading @leading end |
#line_height ⇒ Object (readonly)
The line height of the last line printed
124 125 126 |
# File 'lib/prawn/text/formatted/box.rb', line 124 def line_height @line_height end |
#text ⇒ Object (readonly)
The text that was successfully printed (or, if dry_run
was used, the text that would have been successfully printed)
107 108 109 |
# File 'lib/prawn/text/formatted/box.rb', line 107 def text @text end |
Class Method Details
.extensions ⇒ Object
Example (see Prawn::Text::Core::Formatted::Wrap for what is required of the wrap method if you want to override the default wrapping algorithm):
module MyWrap
def wrap(array)
initialize_wrap([{ :text => 'all your base are belong to us' }])
@line_wrap.wrap_line(:document => @document,
:kerning => @kerning,
:width => 10000,
:arranger => @arranger)
fragment = @arranger.retrieve_fragment
format_and_draw_fragment(fragment, 0, @line_wrap.width, 0)
[]
end
end
Prawn::Text::Formatted::Box.extensions << MyWrap
box = Prawn::Text::Formatted::Box.new('hello world')
box.render('why can't I print anything other than' +
'"all your base are belong to us"?')
331 332 333 |
# File 'lib/prawn/text/formatted/box.rb', line 331 def self.extensions @extensions ||= [] end |
Instance Method Details
#available_width ⇒ Object
The width available at this point in the box
241 242 243 |
# File 'lib/prawn/text/formatted/box.rb', line 241 def available_width @width end |
#draw_fragment(fragment, accumulated_width = 0, line_width = 0, word_spacing = 0) ⇒ Object
fragment
is a Prawn::Text::Formatted::Fragment object
254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 |
# File 'lib/prawn/text/formatted/box.rb', line 254 def draw_fragment( fragment, accumulated_width = 0, line_width = 0, word_spacing = 0 ) #:nodoc: case @align when :left x = @at[0] when :center x = @at[0] + @width * 0.5 - line_width * 0.5 when :right x = @at[0] + @width - line_width when :justify x = if @direction == :ltr @at[0] else @at[0] + @width - line_width end end x += accumulated_width y = @at[1] + @baseline_y y += fragment.y_offset fragment.left = x fragment.baseline = y if @inked draw_fragment_underlays(fragment) @document.word_spacing(word_spacing) do if @draw_text_callback @draw_text_callback.call( fragment.text, at: [x, y], kerning: @kerning ) else @document.draw_text!( fragment.text, at: [x, y], kerning: @kerning ) end end (fragment) end end |
#everything_printed? ⇒ Boolean
True if everything printed (or, if dry_run
was used, everything would have been successfully printed)
117 118 119 |
# File 'lib/prawn/text/formatted/box.rb', line 117 def everything_printed? @everything_printed end |
#height ⇒ Object
The height actually used during the previous render
247 248 249 250 |
# File 'lib/prawn/text/formatted/box.rb', line 247 def height return 0 if @baseline_y.nil? || @descender.nil? (@baseline_y - @descender).abs end |
#line_gap ⇒ Object
132 133 134 |
# File 'lib/prawn/text/formatted/box.rb', line 132 def line_gap line_height - (ascender + descender) end |
#nothing_printed? ⇒ Boolean
True if nothing printed (or, if dry_run
was used, nothing would have been successfully printed)
111 112 113 |
# File 'lib/prawn/text/formatted/box.rb', line 111 def nothing_printed? @nothing_printed end |
#render(flags = {}) ⇒ Object
Render text to the document based on the settings defined in initialize.
In order to facilitate look-ahead calculations, render
accepts a :dry_run => true
option. If provided, then everything is executed as if rendering, with the exception that nothing is drawn on the page. Useful for look-ahead computations of height, unprinted text, etc.
Returns any text that did not print under the current settings.
209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 |
# File 'lib/prawn/text/formatted/box.rb', line 209 def render(flags = {}) unprinted_text = [] @document.save_font do @document.character_spacing(@character_spacing) do @document.text_rendering_mode(@mode) do text = normalized_text(flags) @document.font_size(@font_size) do shrink_to_fit(text) if @overflow == :shrink_to_fit process_vertical_alignment(text) @inked = true unless flags[:dry_run] unprinted_text = if @rotate != 0 && @inked render_rotated(text) else wrap(text) end @inked = false end end end end unprinted_text.map do |e| e.merge(text: @document.font.to_utf8(e[:text])) end end |
#valid_options ⇒ Object
340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 |
# File 'lib/prawn/text/formatted/box.rb', line 340 def PDF::Core::Text::VALID_OPTIONS + [ :at, :height, :width, :align, :valign, :rotate, :rotate_around, :overflow, :min_font_size, :disable_wrap_by_char, :leading, :character_spacing, :mode, :single_line, :document, :direction, :fallback_fonts, :draw_text_callback ] end |