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

sile-typesetter / sile / 6915746301

18 Nov 2023 07:02PM UTC coverage: 56.433% (-12.3%) from 68.751%
6915746301

push

github

web-flow
Merge 8b3fdc301 into f64e235fa

8729 of 15468 relevant lines covered (56.43%)

932.75 hits per line

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

86.36
/pagebuilders/base.lua
1
local pagebuilder = pl.class()
18✔
2
pagebuilder.type = "pagebuilder"
18✔
3
pagebuilder._name = "base"
18✔
4

5
function pagebuilder:_init ()
18✔
6
  self.awful_bad = 1073741823
18✔
7
  self.inf_bad = 10000
18✔
8
  self.eject_penalty = -self.inf_bad
18✔
9
  self.deplorable = 100000
18✔
10
end
11

12
function pagebuilder.collateVboxes (_, vboxlist)
18✔
13
  local output = SILE.nodefactory.vbox()
2✔
14
  output:append(vboxlist)
2✔
15
  return output
2✔
16
end
17

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

90
      local c
91
      if badness < self.awful_bad then
1,465✔
92
        if pi <= self.eject_penalty then c = pi
1,449✔
93
        elseif badness < self.inf_bad then c = badness + pi -- plus insert
1,418✔
94
        else c = self.deplorable
1,348✔
95
        end
96
      else c = badness end
16✔
97
      if c < leastC then
1,465✔
98
        leastC = c
89✔
99
        bestBreak = i
89✔
100
      else
101
        restart = { totalHeight = totalHeight, i = i, started = started, target = target}
1,376✔
102
      end
103

104
      SU.debug("pagebuilder", "Badness:", c)
1,465✔
105
      if c == self.awful_bad or pi <= self.eject_penalty then
1,465✔
106
        SU.debug("pagebuilder", "outputting")
47✔
107
        local onepage = {}
47✔
108
        if not bestBreak then bestBreak = i end
47✔
109
        for j=1,bestBreak do
618✔
110
          onepage[j] = table.remove(vboxlist,1)
1,142✔
111
        end
112
        while(#onepage > 1 and onepage[#onepage].discardable) do onepage[#onepage] = nil end
95✔
113
        return onepage, pi
47✔
114
      end
115
    end
116
  end
117
  SU.debug("pagebuilder", "No page break here")
211✔
118
  if force and bestBreak then
211✔
119
    local onepage = {}
×
120
    for j=1,bestBreak do
×
121
      onepage[j] = table.remove(vboxlist,1)
×
122
    end
123
    return onepage, pi
×
124
  end
125
  return false, restart
211✔
126
end
127

128
return pagebuilder
18✔
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