1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
# encoding: utf-8
# prawn/core/destinations.rb : Implements destination support for PDF
#
# Copyright November 2008, Jamis Buck. All Rights Reserved.
#
# This is free software. Please see the LICENSE and COPYING files for details.
module Prawn
module Core
module Destinations #:nodoc:
# The maximum number of children to fit into a single node in the Dests tree.
NAME_TREE_CHILDREN_LIMIT = 20 #:nodoc:
# The Dests name tree in the Name dictionary (see Prawn::Document::Internal#names).
# This name tree is used to store named destinations (PDF spec 8.2.1).
# (For more on name trees, see section 3.8.4 in the PDF spec.)
#
def dests
names.data[:Dests] ||= ref!(Prawn::Core::NameTree::Node.new(self, NAME_TREE_CHILDREN_LIMIT))
end
# Adds a new destination to the dests name tree (see #dests). The
# +reference+ parameter will be converted into a Prawn::Reference if
# it is not already one.
#
def add_dest(name, reference)
reference = ref!(reference) unless reference.is_a?(Prawn::Core::Reference)
dests.data.add(name, reference)
end
# Return a Dest specification for a specific location (and optional zoom
# level).
#
def dest_xyz(left, top, zoom=nil, dest_page=page)
[dest_page.dictionary, :XYZ, left, top, zoom]
end
# Return a Dest specification that will fit the given page into the
# viewport.
#
def dest_fit(dest_page=page)
[dest_page.dictionary, :Fit]
end
# Return a Dest specification that will fit the given page horizontally
# into the viewport, aligned vertically at the given top coordinate.
#
def dest_fit_horizontally(top, dest_page=page)
[dest_page.dictionary, :FitH, top]
end
# Return a Dest specification that will fit the given page vertically
# into the viewport, aligned horizontally at the given left coordinate.
#
def dest_fit_vertically(left, dest_page=page)
[dest_page.dictionary, :FitV, left]
end
# Return a Dest specification that will fit the given rectangle into the
# viewport, for the given page.
#
def dest_fit_rect(left, bottom, right, top, dest_page=page)
[dest_page.dictionary, :FitR, left, bottom, right, top]
end
# Return a Dest specfication that will fit the given page's bounding box
# into the viewport.
#
def dest_fit_bounds(dest_page=page)
[dest_page.dictionary, :FitB]
end
# Same as #dest_fit_horizontally, but works on the page's bounding box
# instead of the entire page.
#
def dest_fit_bounds_horizontally(top, dest_page=page)
[dest_page.dictionary, :FitBH, top]
end
# Same as #dest_fit_vertically, but works on the page's bounding box
# instead of the entire page.
#
def dest_fit_bounds_vertically(left, dest_page=page)
[dest_page.dictionary, :FitBV, left]
end
end
end
end
|
