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

sile-typesetter / sile / 14684598788

26 Apr 2025 07:55PM UTC coverage: 29.023% (-36.3%) from 65.328%
14684598788

push

github

alerque
test(fonts): Update test to work on new ICU instead of old

5840 of 20122 relevant lines covered (29.02%)

379.34 hits per line

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

71.75
/core/frame.lua
1
SILE.frames = {}
13✔
2

3
-- Buggy, relies on side effects
4
-- luacheck: ignore solver frame
5
-- See https://github.com/sile-typesetter/sile/issues/694
6

7
local cassowary = require("cassowary")
13✔
8
local solver = cassowary.SimplexSolver()
13✔
9
local solverNeedsReloading = true
13✔
10

11
local widthdims = pl.Set({ "left", "right", "width" })
13✔
12
local heightdims = pl.Set({ "top", "bottom", "height" })
13✔
13
local alldims = widthdims + heightdims
13✔
14

15
SILE.framePrototype = pl.class({
26✔
16
   direction = "LTR-TTB",
17
   enterHooks = {},
13✔
18
   leaveHooks = {},
13✔
19

20
   -- This gets called by Penlght when creating the frame instance
21
   _init = function (self, spec, dummy)
22
      local direction = SILE.documentState.direction
43✔
23
      if direction then
43✔
24
         self.direction = direction
×
25
      end
26
      self.constraints = {}
43✔
27
      self.variables = {}
43✔
28
      self.id = spec.id
43✔
29
      for k, v in pairs(spec) do
266✔
30
         if not alldims[k] then
223✔
31
            self[k] = v
53✔
32
         end
33
      end
34
      self.balanced = SU.boolean(self.balanced, false)
86✔
35
      if not dummy then
43✔
36
         for method in pairs(alldims) do
301✔
37
            self.variables[method] = cassowary.Variable({ name = spec.id .. "_" .. method })
516✔
38
            self[method] = function (instance_self)
39
               instance_self:solve()
562✔
40
               return SILE.types.measurement(instance_self.variables[method].value)
562✔
41
            end
42
         end
43
         -- Add definitions of width and height
44
         for method in pairs(alldims) do
301✔
45
            if spec[method] then
258✔
46
               self:constrain(method, spec[method])
170✔
47
            end
48
         end
49
      end
50
   end,
51

52
   -- This gets called by us in typesetter before we start to use the frame
53
   init = function (self, typesetter)
54
      self.state = { totals = { height = SILE.types.measurement(0) } }
112✔
55
      self:enter(typesetter)
56✔
56
      self:newLine(typesetter)
56✔
57
      if self:pageAdvanceDirection() == "TTB" then
112✔
58
         self.state.cursorY = self:top()
110✔
59
      elseif self:pageAdvanceDirection() == "LTR" then
2✔
60
         self.state.cursorX = self:left()
×
61
      elseif self:pageAdvanceDirection() == "RTL" then
2✔
62
         self.state.cursorX = self:right()
2✔
63
      elseif self:pageAdvanceDirection() == "BTT" then
×
64
         self.state.cursorY = self:bottom()
×
65
      end
66
   end,
67

68
   constrain = function (self, method, dimension)
69
      self.constraints[method] = tostring(dimension)
180✔
70
      self:invalidate()
174✔
71
   end,
72

73
   invalidate = function ()
74
      solverNeedsReloading = true
257✔
75
   end,
76

77
   relax = function (self, method)
78
      self.constraints[method] = nil
4✔
79
   end,
80

81
   reifyConstraint = function (self, solver, method, stay)
82
      local constraint = self.constraints[method]
816✔
83
      if not constraint then
816✔
84
         return
×
85
      end
86
      constraint = SU.type(constraint) == "measurement" and constraint:tonumber() or SILE.frameParser:match(constraint)
1,632✔
87
      SU.debug("frames", "Adding constraint", self.id, function ()
1,632✔
88
         return "(" .. method .. ") = " .. tostring(constraint)
×
89
      end)
90
      local eq = cassowary.Equation(self.variables[method], constraint)
816✔
91
      solver:addConstraint(eq)
816✔
92
      if stay then
816✔
93
         solver:addStay(eq)
168✔
94
      end
95
   end,
96

97
   addWidthHeightDefinitions = function (self, solver)
98
      local vars = self.variables
204✔
99
      solver:addConstraint(cassowary.Equation(vars.width, cassowary.minus(vars.right, vars.left)))
612✔
100
      solver:addConstraint(cassowary.Equation(vars.height, cassowary.minus(vars.bottom, vars.top)))
612✔
101
   end,
102

103
   -- This is hideously inefficient,
104
   -- but it's the easiest way to allow users to reconfigure frames at runtime.
105
   solve = function (_)
106
      if not solverNeedsReloading then
562✔
107
         return
520✔
108
      end
109
      SU.debug("frames", "Solving...")
42✔
110
      solver = cassowary.SimplexSolver()
84✔
111
      if SILE.frames.page then
42✔
112
         for method, _ in pairs(SILE.frames.page.constraints) do
210✔
113
            SILE.frames.page:reifyConstraint(solver, method, true)
168✔
114
         end
115
         SILE.frames.page:addWidthHeightDefinitions(solver)
42✔
116
      end
117
      for id, frame in pairs(SILE.frames) do
246✔
118
         if not (id == "page") then
204✔
119
            for method, _ in pairs(frame.constraints) do
810✔
120
               frame:reifyConstraint(solver, method)
648✔
121
            end
122
            frame:addWidthHeightDefinitions(solver)
162✔
123
         end
124
      end
125
      solver:solve()
42✔
126
      solverNeedsReloading = false
42✔
127
   end,
128

129
   writingDirection = function (self)
130
      return self.direction:match("^(%a+)") or "LTR"
4,950✔
131
   end,
132

133
   pageAdvanceDirection = function (self)
134
      return self.direction:match("-(%a+)$") or "TTB"
555✔
135
   end,
136

137
   advanceWritingDirection = function (self, length)
138
      local amount = SU.cast("number", length)
1,204✔
139
      if amount == 0 then
1,204✔
140
         return
277✔
141
      end
142
      if self:writingDirection() == "RTL" then
1,854✔
143
         self.state.cursorX = self.state.cursorX - amount
×
144
      elseif self:writingDirection() == "LTR" then
1,854✔
145
         self.state.cursorX = self.state.cursorX + amount
1,842✔
146
      elseif self:writingDirection() == "TTB" then
12✔
147
         self.state.cursorY = self.state.cursorY + amount
12✔
148
      elseif self:writingDirection() == "BTT" then
×
149
         self.state.cursorY = self.state.cursorY - amount
×
150
      end
151
   end,
152

153
   advancePageDirection = function (self, length)
154
      local amount = SU.cast("number", length)
356✔
155
      if amount == 0 then
356✔
156
         return
72✔
157
      end
158
      if self:pageAdvanceDirection() == "TTB" then
568✔
159
         self.state.cursorY = self.state.cursorY + amount
562✔
160
      elseif self:pageAdvanceDirection() == "RTL" then
6✔
161
         self.state.cursorX = self.state.cursorX - amount
6✔
162
      elseif self:pageAdvanceDirection() == "LTR" then
×
163
         self.state.cursorX = self.state.cursorX + amount
×
164
      elseif self:pageAdvanceDirection() == "BTT" then
×
165
         self.state.cursorY = self.state.cursorY - amount
×
166
      end
167
   end,
168

169
   newLine = function (self, _)
170
      if self:writingDirection() == "LTR" then
322✔
171
         self.state.cursorX = self:left()
318✔
172
      elseif self:writingDirection() == "RTL" then
4✔
173
         self.state.cursorX = self:right()
×
174
      elseif self:writingDirection() == "TTB" then
4✔
175
         self.state.cursorY = self:top()
4✔
176
      elseif self:writingDirection() == "BTT" then
×
177
         self.state.cursorY = self:bottom()
×
178
      end
179
   end,
180

181
   lineWidth = function (self)
182
      SU.warn("Method :lineWidth() is deprecated, please use :getLineWidth()")
×
183
      return self:getLineWidth()
×
184
   end,
185

186
   getLineWidth = function (self)
187
      if self:writingDirection() == "LTR" or self:writingDirection() == "RTL" then
259✔
188
         return self:width()
128✔
189
      else
190
         return self:height()
1✔
191
      end
192
   end,
193

194
   pageTarget = function (self)
195
      SU.warn("Method :pageTarget() is deprecated, please use :getTargetLength()")
×
196
      return self:getTargetLength()
×
197
   end,
198

199
   getTargetLength = function (self)
200
      local direction = self:pageAdvanceDirection()
210✔
201
      if direction == "TTB" or direction == "BTT" then
210✔
202
         return self:height()
204✔
203
      else
204
         return self:width()
6✔
205
      end
206
   end,
207

208
   enter = function (self, typesetter)
209
      for i = 1, #self.enterHooks do
71✔
210
         self.enterHooks[i](self, typesetter)
1✔
211
      end
212
   end,
213

214
   leave = function (self, typesetter)
215
      for i = 1, #self.leaveHooks do
79✔
216
         self.leaveHooks[i](self, typesetter)
1✔
217
      end
218
   end,
219

220
   isAbsoluteConstraint = function (self, method)
221
      if not self.constraints[method] then
16✔
222
         return false
×
223
      end
224
      local constraint = SILE.frameParser:match(self.constraints[method])
16✔
225
      if type(constraint) ~= "table" then
16✔
226
         return true
4✔
227
      end
228
      if not constraint.terms then
12✔
229
         return false
12✔
230
      end
231
      for clv, _ in pairs(constraint.terms) do
×
232
         if clv.name and not clv.name:match("^page_") then
×
233
            return false
×
234
         end
235
      end
236
      return true
×
237
   end,
238

239
   isMainContentFrame = function (self)
240
      local tpt = SILE.documentState.thisPageTemplate
27✔
241
      local frame = tpt.firstContentFrame
27✔
242
      while frame do
27✔
243
         if frame == self then
27✔
244
            return true
15✔
245
         end
246
         if frame.next then
12✔
247
            frame = SILE.getFrame(frame.next)
×
248
         else
249
            return false
12✔
250
         end
251
      end
252
      return false
×
253
   end,
254

255
   __tostring = function (self)
256
      local str = "<Frame: " .. self.id .. ": "
×
257
      str = str .. " next=" .. (self.next or "nil") .. " "
×
258
      for method, dimension in pairs(self.constraints) do
×
259
         str = str .. method .. "=" .. dimension .. "; "
×
260
      end
261
      if self.hanmen then
×
262
         str = str .. "tate=" .. (self.tate and "true" or "false") .. "; "
×
263
         str = str .. "gridsize=" .. self.gridsize .. "; "
×
264
         str = str .. "linegap=" .. self.linegap .. "; "
×
265
         str = str .. "linelength=" .. self.linelength .. "; "
×
266
         str = str .. "linecount=" .. self.linecount .. "; "
×
267
      end
268
      str = str .. ">"
×
269
      return str
×
270
   end,
271
})
13✔
272

273
SILE.newFrame = function (spec, prototype)
13✔
274
   SU.required(spec, "id", "frame declaration")
43✔
275
   prototype = prototype or SILE.framePrototype
43✔
276
   local frame = prototype(spec)
43✔
277
   SILE.frames[spec.id] = frame
43✔
278
   return frame
43✔
279
end
280

281
SILE.getFrame = function (id)
13✔
282
   if type(id) == "table" then
25✔
283
      SU.error("Passed a table, expected a string", true)
×
284
   end
285
   local frame, last_attempt
286
   while not frame do
50✔
287
      frame = SILE.frames[id]
25✔
288
      id = id:gsub("_$", "")
25✔
289
      if id == last_attempt then
25✔
290
         break
291
      end
292
      last_attempt = id
25✔
293
   end
294
   return frame or SU.warn("Couldn't find frame ID " .. id, true)
25✔
295
end
296

297
SILE.parseComplexFrameDimension = function (dimension)
13✔
298
   local length = SILE.frameParser:match(SU.cast("string", dimension))
×
299
   if type(length) == "table" then
×
300
      local g = cassowary.Variable({ name = "t" })
×
301
      local eq = cassowary.Equation(g, length)
×
302
      solverNeedsReloading = true
×
303
      solver:addConstraint(eq)
×
304
      SILE.frames.page:solve()
×
305
      solverNeedsReloading = true
×
306
      return g.value
×
307
   end
308
   return length
×
309
end
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

© 2025 Coveralls, Inc