• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

sile-typesetter / sile / 11989714398

23 Nov 2024 07:09PM UTC coverage: 47.176% (-21.4%) from 68.563%
11989714398

push

github

web-flow
Merge 33c9fdb99 into f0ddaed08

0 of 12 new or added lines in 1 file covered. (0.0%)

4058 existing lines in 28 files now uncovered.

8954 of 18980 relevant lines covered (47.18%)

4499.72 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

82.65
/pagebuilders/base.lua
1
--- SILE pagebuilder class.
2
-- @interfaces pagebuilders
3

4
local pagebuilder = pl.class()
4✔
5
pagebuilder.type = "pagebuilder"
4✔
6
pagebuilder._name = "base"
4✔
7

8
function pagebuilder:_init ()
4✔
9
   self.awful_bad = 1073741823
4✔
10
   self.inf_bad = 10000
4✔
11
   self.eject_penalty = -self.inf_bad
4✔
12
   self.deplorable = 100000
4✔
13
end
14

15
function pagebuilder.collateVboxes (_, vboxlist)
4✔
16
   local output = SILE.types.node.vbox()
2✔
17
   output:append(vboxlist)
2✔
18
   return output
2✔
19
end
20

21
-- Note: Almost 1/3 of the time in a typical SILE in taken iterating through
22
-- this function. As a result there are some micro-optimizations here that
23
-- make it a-typical of preferred coding styles. In particular note that
24
-- we absolutize heavily iterated lengths as early as possible and make
25
-- make direct calls to their integer amounts, assumed to be in points by
26
-- the point they are called **without actually checking**!
27
function pagebuilder:findBestBreak (options)
4✔
28
   local vboxlist = SU.required(options, "vboxlist", "in findBestBreak")
95✔
29
   local target = SU.required(options, "target", "in findBestBreak", "length")
95✔
30
   local restart = options.restart or false
95✔
31
   local force = options.force or false
95✔
32
   local i = 0
95✔
33
   local totalHeight = SILE.types.length()
95✔
34
   local bestBreak = nil
95✔
35
   local started = false
95✔
36
   if restart and restart.target == target then
95✔
37
      totalHeight = restart.totalHeight
×
38
      i = restart.i
×
39
      started = restart.started
×
40
   end
41
   local leastC = self.inf_bad
95✔
42
   SU.debug("pagebuilder", function ()
190✔
43
      return "Page builder for frame "
×
44
         .. SILE.typesetter.frame.id
×
45
         .. " called with "
×
46
         .. #vboxlist
×
47
         .. " nodes, "
×
48
         .. tostring(target)
×
49
   end)
50
   if SU.debugging("vboxes") then
190✔
51
      for j, box in ipairs(vboxlist) do
×
52
         SU.debug("vboxes", function ()
×
53
            return (j == i and " >" or "  ") .. j .. ": " .. box
×
54
         end)
55
      end
56
   end
57
   while not started and i < #vboxlist do
198✔
58
      i = i + 1
198✔
59
      if not vboxlist[i].is_vglue then
198✔
60
         started = true
95✔
61
         i = i - 1
95✔
62
         break
95✔
63
      end
64
   end
65
   local pi
66
   while i < #vboxlist do
522✔
67
      i = i + 1
459✔
68
      local vbox = vboxlist[i]
459✔
69
      SU.debug("pagebuilder", "Dealing with VBox", vbox)
459✔
70
      if vbox.is_vbox then
459✔
71
         totalHeight:___add(vbox.height)
220✔
72
         totalHeight:___add(vbox.depth)
440✔
73
      elseif vbox.is_vglue then
239✔
74
         totalHeight:___add(vbox.height)
392✔
75
      elseif vbox.is_insertion then
43✔
76
         -- TODO: refactor as hook and without side effects!
77
         target = SILE.insertions.processInsertion(vboxlist, i, totalHeight, target)
10✔
78
         vbox = vboxlist[i]
5✔
79
      end
80
      local left = target - totalHeight
459✔
81
      SU.debug("pagebuilder", "I have", left, "left")
459✔
82
      -- if left < -20 then SU.error("\nCatastrophic page breaking failure!"); end
83
      pi = 0
459✔
84
      if vbox.is_penalty then
459✔
85
         pi = vbox.penalty
39✔
86
      end
87
      if
88
         vbox.is_penalty and vbox.penalty < self.inf_bad
459✔
89
         or (vbox.is_vglue and i > 1 and not vboxlist[i - 1].discardable)
420✔
90
      then
91
         local badness
92
         SU.debug("pagebuilder", "totalHeight", totalHeight, "with target", target)
199✔
93
         if totalHeight.length.amount < target.length.amount then -- TeX #1039
199✔
94
            -- Account for infinite stretch?
95
            badness = SU.rateBadness(self.inf_bad, left.length.amount, totalHeight.stretch.amount)
368✔
96
         elseif left.length.amount < totalHeight.shrink.amount then
15✔
97
            badness = self.awful_bad
15✔
98
         else
UNCOV
99
            badness = SU.rateBadness(self.inf_bad, -left.length.amount, totalHeight.shrink.amount)
×
100
         end
101

102
         local c
103
         if badness < self.awful_bad then
199✔
104
            if pi <= self.eject_penalty then
184✔
105
               c = pi
17✔
106
            elseif badness < self.inf_bad then
167✔
107
               c = badness + pi -- plus insert
22✔
108
            else
109
               c = self.deplorable
145✔
110
            end
111
         else
112
            c = badness
15✔
113
         end
114
         if c < leastC then
199✔
115
            leastC = c
38✔
116
            bestBreak = i
38✔
117
         else
118
            restart = { totalHeight = totalHeight, i = i, started = started, target = target }
161✔
119
         end
120

121
         SU.debug("pagebuilder", "Badness:", c)
199✔
122
         if c == self.awful_bad or pi <= self.eject_penalty then
199✔
123
            SU.debug("pagebuilder", "outputting")
32✔
124
            local onepage = {}
32✔
125
            if not bestBreak then
32✔
126
               bestBreak = i
14✔
127
            end
128
            for j = 1, bestBreak do
232✔
129
               onepage[j] = table.remove(vboxlist, 1)
400✔
130
            end
131
            while #onepage > 1 and onepage[#onepage].discardable do
65✔
132
               onepage[#onepage] = nil
33✔
133
            end
134
            return onepage, pi
32✔
135
         end
136
      end
137
   end
138
   SU.debug("pagebuilder", "No page break here")
63✔
139
   if force and bestBreak then
63✔
UNCOV
140
      local onepage = {}
×
UNCOV
141
      for j = 1, bestBreak do
×
UNCOV
142
         onepage[j] = table.remove(vboxlist, 1)
×
143
      end
UNCOV
144
      return onepage, pi
×
145
   end
146
   return false, restart
63✔
147
end
148

149
return pagebuilder
4✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc