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

sile-typesetter / sile / 5017842917

pending completion
5017842917

push

github

GitHub
Merge pull request #1738 from alerque/multi-inputs

16 of 16 new or added lines in 2 files covered. (100.0%)

9954 of 15641 relevant lines covered (63.64%)

6575.94 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()
41✔
2
pagebuilder.type = "pagebuilder"
41✔
3
pagebuilder._name = "base"
41✔
4

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

12
function pagebuilder.collateVboxes (_, vboxlist)
41✔
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)
41✔
25
  local vboxlist = SU.required(options, "vboxlist", "in findBestBreak")
530✔
26
  local target   = SU.required(options, "target", "in findBestBreak", "length")
530✔
27
  local restart  = options.restart or false
530✔
28
  local force    = options.force or false
530✔
29
  local i = 0
530✔
30
  local totalHeight = SILE.length()
530✔
31
  local bestBreak = nil
530✔
32
  local started = false
530✔
33
  if restart and restart.target == target then
530✔
34
    totalHeight = restart.totalHeight
×
35
    i = restart.i
×
36
    started = restart.started
×
37
  end
38
  local leastC = self.inf_bad
530✔
39
  SU.debug("pagebuilder", function ()
1,060✔
40
    return "Page builder for frame " .. SILE.typesetter.frame.id .. " called with " .. #vboxlist .. " nodes, " .. tostring(target)
×
41
  end)
42
  if SU.debugging("vboxes") then
1,060✔
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
1,398✔
50
    i = i + 1
1,388✔
51
    if not vboxlist[i].is_vglue then
1,388✔
52
      started = true
520✔
53
      i = i - 1
520✔
54
      break
520✔
55
    end
56
  end
57
  local pi
58
  while i < #vboxlist do
9,404✔
59
    i = i + 1
8,950✔
60
    local vbox = vboxlist[i]
8,950✔
61
    SU.debug("pagebuilder", "Dealing with VBox", vbox)
8,950✔
62
    if vbox.is_vbox then
8,950✔
63
      totalHeight:___add(vbox.height)
2,517✔
64
      totalHeight:___add(vbox.depth)
5,034✔
65
    elseif vbox.is_vglue then
6,433✔
66
      totalHeight:___add(vbox.height)
12,006✔
67
    elseif vbox.is_insertion then
430✔
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
8,950✔
73
    SU.debug("pagebuilder", "I have", left, "left")
8,950✔
74
    -- if left < -20 then SU.error("\nCatastrophic page breaking failure!"); end
75
    pi = 0
8,950✔
76
    if vbox.is_penalty then
8,950✔
77
      pi = vbox.penalty
428✔
78
    end
79
    if vbox.is_penalty and vbox.penalty < self.inf_bad
8,950✔
80
      or (vbox.is_vglue and i > 1 and not vboxlist[i-1].discardable) then
8,556✔
81
      local badness
82
      SU.debug("pagebuilder", "totalHeight", totalHeight, "with target", target)
3,486✔
83
      if totalHeight.length.amount < target.length.amount then -- TeX #1039
3,486✔
84
        -- Account for infinite stretch?
85
        badness = SU.rateBadness(self.inf_bad, left.length.amount, totalHeight.stretch.amount)
6,936✔
86
      elseif left.length.amount < totalHeight.shrink.amount then badness = self.awful_bad
18✔
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
3,486✔
92
        if pi <= self.eject_penalty then c = pi
3,468✔
93
        elseif badness < self.inf_bad then c = badness + pi -- plus insert
3,410✔
94
        else c = self.deplorable
3,177✔
95
        end
96
      else c = badness end
18✔
97
      if c < leastC then
3,486✔
98
        leastC = c
265✔
99
        bestBreak = i
265✔
100
      else
101
        restart = { totalHeight = totalHeight, i = i, started = started, target = target}
3,221✔
102
      end
103

104
      SU.debug("pagebuilder", "Badness:", c)
3,486✔
105
      if c == self.awful_bad or pi <= self.eject_penalty then
3,486✔
106
        SU.debug("pagebuilder", "outputting")
76✔
107
        local onepage = {}
76✔
108
        if not bestBreak then bestBreak = i end
76✔
109
        for j=1,bestBreak do
1,322✔
110
          onepage[j] = table.remove(vboxlist,1)
2,492✔
111
        end
112
        while(#onepage > 1 and onepage[#onepage].discardable) do onepage[#onepage] = nil end
159✔
113
        return onepage, pi
76✔
114
      end
115
    end
116
  end
117
  SU.debug("pagebuilder", "No page break here")
454✔
118
  if force and bestBreak then
454✔
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
454✔
126
end
127

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