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

sile-typesetter / sile / 10717926895

05 Sep 2024 09:42AM UTC coverage: 40.279% (-29.5%) from 69.796%
10717926895

push

github

alerque
chore(deps): Bump pinned libtexpdf, packages license file

Closes #2100

6918 of 17175 relevant lines covered (40.28%)

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

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

15
function pagebuilder.collateVboxes (_, vboxlist)
11✔
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)
11✔
28
   local vboxlist = SU.required(options, "vboxlist", "in findBestBreak")
163✔
29
   local target = SU.required(options, "target", "in findBestBreak", "length")
163✔
30
   local restart = options.restart or false
163✔
31
   local force = options.force or false
163✔
32
   local i = 0
163✔
33
   local totalHeight = SILE.types.length()
163✔
34
   local bestBreak = nil
163✔
35
   local started = false
163✔
36
   if restart and restart.target == target then
163✔
37
      totalHeight = restart.totalHeight
×
38
      i = restart.i
×
39
      started = restart.started
×
40
   end
41
   local leastC = self.inf_bad
163✔
42
   SU.debug("pagebuilder", function ()
326✔
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
326✔
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
348✔
58
      i = i + 1
346✔
59
      if not vboxlist[i].is_vglue then
346✔
60
         started = true
161✔
61
         i = i - 1
161✔
62
         break
161✔
63
      end
64
   end
65
   local pi
66
   while i < #vboxlist do
1,138✔
67
      i = i + 1
1,015✔
68
      local vbox = vboxlist[i]
1,015✔
69
      SU.debug("pagebuilder", "Dealing with VBox", vbox)
1,015✔
70
      if vbox.is_vbox then
1,015✔
71
         totalHeight:___add(vbox.height)
430✔
72
         totalHeight:___add(vbox.depth)
860✔
73
      elseif vbox.is_vglue then
585✔
74
         totalHeight:___add(vbox.height)
968✔
75
      elseif vbox.is_insertion then
101✔
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
1,015✔
81
      SU.debug("pagebuilder", "I have", left, "left")
1,015✔
82
      -- if left < -20 then SU.error("\nCatastrophic page breaking failure!"); end
83
      pi = 0
1,015✔
84
      if vbox.is_penalty then
1,015✔
85
         pi = vbox.penalty
97✔
86
      end
87
      if
88
         vbox.is_penalty and vbox.penalty < self.inf_bad
1,015✔
89
         or (vbox.is_vglue and i > 1 and not vboxlist[i - 1].discardable)
918✔
90
      then
91
         local badness
92
         SU.debug("pagebuilder", "totalHeight", totalHeight, "with target", target)
404✔
93
         if totalHeight.length.amount < target.length.amount then -- TeX #1039
404✔
94
            -- Account for infinite stretch?
95
            badness = SU.rateBadness(self.inf_bad, left.length.amount, totalHeight.stretch.amount)
776✔
96
         elseif left.length.amount < totalHeight.shrink.amount then
16✔
97
            badness = self.awful_bad
16✔
98
         else
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
404✔
104
            if pi <= self.eject_penalty then
388✔
105
               c = pi
24✔
106
            elseif badness < self.inf_bad then
364✔
107
               c = badness + pi -- plus insert
34✔
108
            else
109
               c = self.deplorable
330✔
110
            end
111
         else
112
            c = badness
16✔
113
         end
114
         if c < leastC then
404✔
115
            leastC = c
57✔
116
            bestBreak = i
57✔
117
         else
118
            restart = { totalHeight = totalHeight, i = i, started = started, target = target }
347✔
119
         end
120

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

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