6916166382

Committed 18 Nov 2023 08:38PM UTC coverage: 65.378% (-3.4%) from 68.751%

Build # 6916166382

Build Type

push

github

Committed by

web-flow

Commit Message

Merge 804f0a80a into f64e235fa

Run Details

10161 of 15542 relevant lines covered (65.38%)

5006.52 hits per line

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

86.36

/pagebuilders/base.lua

local pagebuilder = pl.class()
pagebuilder.type = "pagebuilder"
pagebuilder._name = "base"

function pagebuilder:_init ()
  self.awful_bad = 1073741823
  self.inf_bad = 10000
  self.eject_penalty = -self.inf_bad
  self.deplorable = 100000
end

function pagebuilder.collateVboxes (_, vboxlist)
  local output = SILE.nodefactory.vbox()
  output:append(vboxlist)
  return output
end

-- Note: Almost 1/3 of the time in a typical SILE in taken iterating through
-- this function. As a result there are some micro-optimizations here that
-- make it a-typical of preferred coding styles. In particular note that
-- we absolutize heavily iterated lengths as early as possible and make
-- make direct calls to their integer amounts, assumed to be in points by
-- the point they are called **without actually checking**!
function pagebuilder:findBestBreak (options)
  local vboxlist = SU.required(options, "vboxlist", "in findBestBreak")
  local target   = SU.required(options, "target", "in findBestBreak", "length")
  local restart  = options.restart or false
  local force    = options.force or false
  local i = 0
  local totalHeight = SILE.length()
  local bestBreak = nil
  local started = false
  if restart and restart.target == target then
    totalHeight = restart.totalHeight
    i = restart.i
    started = restart.started
  end
  local leastC = self.inf_bad
  SU.debug("pagebuilder", function ()
    return "Page builder for frame " .. SILE.typesetter.frame.id .. " called with " .. #vboxlist .. " nodes, " .. tostring(target)
  end)
  if SU.debugging("vboxes") then
    for j, box in ipairs(vboxlist) do
      SU.debug("vboxes", function ()
        return (j == i and " >" or "  ") .. j .. ": " .. box
      end)
    end
  end
  while not started and i < #vboxlist do
    i = i + 1
    if not vboxlist[i].is_vglue then
      started = true
      i = i - 1
      break
    end
  end
  local pi
  while i < #vboxlist do
    i = i + 1
    local vbox = vboxlist[i]
    SU.debug("pagebuilder", "Dealing with VBox", vbox)
    if vbox.is_vbox then
      totalHeight:___add(vbox.height)
      totalHeight:___add(vbox.depth)
    elseif vbox.is_vglue then
      totalHeight:___add(vbox.height)
    elseif vbox.is_insertion then
      -- TODO: refactor as hook and without side effects!
      target = SILE.insertions.processInsertion(vboxlist, i, totalHeight, target)
      vbox = vboxlist[i]
    end
    local left = target - totalHeight
    SU.debug("pagebuilder", "I have", left, "left")
    -- if left < -20 then SU.error("\nCatastrophic page breaking failure!"); end
    pi = 0
    if vbox.is_penalty then
      pi = vbox.penalty
    end
    if vbox.is_penalty and vbox.penalty < self.inf_bad
      or (vbox.is_vglue and i > 1 and not vboxlist[i-1].discardable) then
      local badness
      SU.debug("pagebuilder", "totalHeight", totalHeight, "with target", target)
      if totalHeight.length.amount < target.length.amount then -- TeX #1039
        -- Account for infinite stretch?
        badness = SU.rateBadness(self.inf_bad, left.length.amount, totalHeight.stretch.amount)
      elseif left.length.amount < totalHeight.shrink.amount then badness = self.awful_bad
      else badness = SU.rateBadness(self.inf_bad, -left.length.amount, totalHeight.shrink.amount)
      end

      local c
      if badness < self.awful_bad then
        if pi <= self.eject_penalty then c = pi
        elseif badness < self.inf_bad then c = badness + pi -- plus insert
        else c = self.deplorable
        end
      else c = badness end
      if c < leastC then
        leastC = c
        bestBreak = i
      else
        restart = { totalHeight = totalHeight, i = i, started = started, target = target}
      end

      SU.debug("pagebuilder", "Badness:", c)
      if c == self.awful_bad or pi <= self.eject_penalty then
        SU.debug("pagebuilder", "outputting")
        local onepage = {}
        if not bestBreak then bestBreak = i end
        for j=1,bestBreak do
          onepage[j] = table.remove(vboxlist,1)
        end
        while(#onepage > 1 and onepage[#onepage].discardable) do onepage[#onepage] = nil end
        return onepage, pi
      end
    end
  end
  SU.debug("pagebuilder", "No page break here")
  if force and bestBreak then
    local onepage = {}
    for j=1,bestBreak do
      onepage[j] = table.remove(vboxlist,1)
    end
    return onepage, pi
  end
  return false, restart
end

return pagebuilder

1	local pagebuilder = pl.class()	19✔
2	pagebuilder.type = "pagebuilder"	19✔
3	pagebuilder._name = "base"	19✔
4
5	function pagebuilder:_init ()	19✔
6	self.awful_bad = 1073741823	19✔
7	self.inf_bad = 10000	19✔
8	self.eject_penalty = -self.inf_bad	19✔
9	self.deplorable = 100000	19✔
10	end
11
12	function pagebuilder.collateVboxes (_, vboxlist)	19✔
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)	19✔
25	local vboxlist = SU.required(options, "vboxlist", "in findBestBreak")	280✔
26	local target = SU.required(options, "target", "in findBestBreak", "length")	280✔
27	local restart = options.restart or false	280✔
28	local force = options.force or false	280✔
29	local i = 0	280✔
30	local totalHeight = SILE.length()	280✔
31	local bestBreak = nil	280✔
32	local started = false	280✔
33	if restart and restart.target == target then	280✔
34	totalHeight = restart.totalHeight	×
35	i = restart.i	×
36	started = restart.started	×
37	end
38	local leastC = self.inf_bad	280✔
39	SU.debug("pagebuilder", function ()	560✔
40	return "Page builder for frame " .. SILE.typesetter.frame.id .. " called with " .. #vboxlist .. " nodes, " .. tostring(target)	×
41	end)
42	if SU.debugging("vboxes") then	560✔
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	687✔
50	i = i + 1	687✔
51	if not vboxlist[i].is_vglue then	687✔
52	started = true	280✔
53	i = i - 1	280✔
54	break	280✔
55	end
56	end
57	local pi
58	while i < #vboxlist do	4,346✔
59	i = i + 1	4,114✔
60	local vbox = vboxlist[i]	4,114✔
61	SU.debug("pagebuilder", "Dealing with VBox", vbox)	4,114✔
62	if vbox.is_vbox then	4,114✔
63	totalHeight:___add(vbox.height)	1,262✔
64	totalHeight:___add(vbox.depth)	2,524✔
65	elseif vbox.is_vglue then	2,852✔
66	totalHeight:___add(vbox.height)	5,298✔
67	elseif vbox.is_insertion then	203✔
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	4,114✔
73	SU.debug("pagebuilder", "I have", left, "left")	4,114✔
74	-- if left < -20 then SU.error("\nCatastrophic page breaking failure!"); end
75	pi = 0	4,114✔
76	if vbox.is_penalty then	4,114✔
77	pi = vbox.penalty	201✔
78	end
79	if vbox.is_penalty and vbox.penalty < self.inf_bad	4,114✔
80	or (vbox.is_vglue and i > 1 and not vboxlist[i-1].discardable) then	3,947✔
81	local badness
82	SU.debug("pagebuilder", "totalHeight", totalHeight, "with target", target)	1,556✔
83	if totalHeight.length.amount < target.length.amount then -- TeX #1039	1,556✔
84	-- Account for infinite stretch?
85	badness = SU.rateBadness(self.inf_bad, left.length.amount, totalHeight.stretch.amount)	3,080✔
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,556✔
92	if pi <= self.eject_penalty then c = pi	1,540✔
93	elseif badness < self.inf_bad then c = badness + pi -- plus insert	1,508✔
94	else c = self.deplorable	1,437✔
95	end
96	else c = badness end	16✔
97	if c < leastC then	1,556✔
98	leastC = c	91✔
99	bestBreak = i	91✔
100	else
101	restart = { totalHeight = totalHeight, i = i, started = started, target = target}	1,465✔
102	end
103
104	SU.debug("pagebuilder", "Badness:", c)	1,556✔
105	if c == self.awful_bad or pi <= self.eject_penalty then	1,556✔
106	SU.debug("pagebuilder", "outputting")	48✔
107	local onepage = {}	48✔
108	if not bestBreak then bestBreak = i end	48✔
109	for j=1,bestBreak do	662✔
110	onepage[j] = table.remove(vboxlist,1)	1,228✔
111	end
112	while(#onepage > 1 and onepage[#onepage].discardable) do onepage[#onepage] = nil end	97✔
113	return onepage, pi	48✔
114	end
115	end
116	end
117	SU.debug("pagebuilder", "No page break here")	232✔
118	if force and bestBreak then	232✔
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	232✔
126	end
127
128	return pagebuilder	19✔

sile-typesetter / sile / 6916166382

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

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