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

sile-typesetter / sile / 11170735472

03 Oct 2024 10:32PM UTC coverage: 58.612% (-4.5%) from 63.103%
11170735472

push

github

web-flow
Merge bcab25790 into 783083345

15 of 64 new or added lines in 5 files covered. (23.44%)

828 existing lines in 41 files now uncovered.

10478 of 17877 relevant lines covered (58.61%)

2029.7 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()
30✔
5
pagebuilder.type = "pagebuilder"
30✔
6
pagebuilder._name = "base"
30✔
7

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

15
function pagebuilder.collateVboxes (_, vboxlist)
30✔
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)
30✔
28
   local vboxlist = SU.required(options, "vboxlist", "in findBestBreak")
590✔
29
   local target = SU.required(options, "target", "in findBestBreak", "length")
590✔
30
   local restart = options.restart or false
590✔
31
   local force = options.force or false
590✔
32
   local i = 0
590✔
33
   local totalHeight = SILE.types.length()
590✔
34
   local bestBreak = nil
590✔
35
   local started = false
590✔
36
   if restart and restart.target == target then
590✔
37
      totalHeight = restart.totalHeight
×
38
      i = restart.i
×
39
      started = restart.started
×
40
   end
41
   local leastC = self.inf_bad
590✔
42
   SU.debug("pagebuilder", function ()
1,180✔
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
1,180✔
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
1,470✔
58
      i = i + 1
1,450✔
59
      if not vboxlist[i].is_vglue then
1,450✔
60
         started = true
570✔
61
         i = i - 1
570✔
62
         break
570✔
63
      end
64
   end
65
   local pi
66
   while i < #vboxlist do
9,403✔
67
      i = i + 1
8,872✔
68
      local vbox = vboxlist[i]
8,872✔
69
      SU.debug("pagebuilder", "Dealing with VBox", vbox)
8,872✔
70
      if vbox.is_vbox then
8,872✔
71
         totalHeight:___add(vbox.height)
2,746✔
72
         totalHeight:___add(vbox.depth)
5,492✔
73
      elseif vbox.is_vglue then
6,126✔
74
         totalHeight:___add(vbox.height)
11,710✔
75
      elseif vbox.is_insertion then
271✔
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
8,872✔
81
      SU.debug("pagebuilder", "I have", left, "left")
8,872✔
82
      -- if left < -20 then SU.error("\nCatastrophic page breaking failure!"); end
83
      pi = 0
8,872✔
84
      if vbox.is_penalty then
8,872✔
85
         pi = vbox.penalty
267✔
86
      end
87
      if
88
         vbox.is_penalty and vbox.penalty < self.inf_bad
8,872✔
89
         or (vbox.is_vglue and i > 1 and not vboxlist[i - 1].discardable)
8,667✔
90
      then
91
         local badness
92
         SU.debug("pagebuilder", "totalHeight", totalHeight, "with target", target)
3,889✔
93
         if totalHeight.length.amount < target.length.amount then -- TeX #1039
3,889✔
94
            -- Account for infinite stretch?
95
            badness = SU.rateBadness(self.inf_bad, left.length.amount, totalHeight.stretch.amount)
7,744✔
96
         elseif left.length.amount < totalHeight.shrink.amount then
17✔
97
            badness = self.awful_bad
17✔
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
3,889✔
104
            if pi <= self.eject_penalty then
3,872✔
105
               c = pi
42✔
106
            elseif badness < self.inf_bad then
3,830✔
107
               c = badness + pi -- plus insert
115✔
108
            else
109
               c = self.deplorable
3,715✔
110
            end
111
         else
112
            c = badness
17✔
113
         end
114
         if c < leastC then
3,889✔
115
            leastC = c
149✔
116
            bestBreak = i
149✔
117
         else
118
            restart = { totalHeight = totalHeight, i = i, started = started, target = target }
3,740✔
119
         end
120

121
         SU.debug("pagebuilder", "Badness:", c)
3,889✔
122
         if c == self.awful_bad or pi <= self.eject_penalty then
3,889✔
123
            SU.debug("pagebuilder", "outputting")
59✔
124
            local onepage = {}
59✔
125
            if not bestBreak then
59✔
126
               bestBreak = i
16✔
127
            end
128
            for j = 1, bestBreak do
931✔
129
               onepage[j] = table.remove(vboxlist, 1)
1,744✔
130
            end
131
            while #onepage > 1 and onepage[#onepage].discardable do
119✔
132
               onepage[#onepage] = nil
60✔
133
            end
134
            return onepage, pi
59✔
135
         end
136
      end
137
   end
138
   SU.debug("pagebuilder", "No page break here")
531✔
139
   if force and bestBreak then
531✔
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
531✔
147
end
148

149
return pagebuilder
30✔
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