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

sile-typesetter / sile / 6934957716

20 Nov 2023 07:35PM UTC coverage: 57.468% (-3.2%) from 60.703%
6934957716

push

github

web-flow
Merge c91d9a7d4 into 34e2e5335

60 of 79 new or added lines in 1 file covered. (75.95%)

717 existing lines in 27 files now uncovered.

8957 of 15586 relevant lines covered (57.47%)

5715.38 hits per line

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

75.79
/shapers/base.lua
1
-- local smallTokenSize = 20 -- Small words will be cached
2
-- local shapeCache = {}
3
-- local _key = function (options)
4
--   return table.concat({ options.family;options.language;options.script;options.size;("%d"):format(options.weight);options.style;options.variant;options.features;options.variations;options.direction;options.filename }, ";")
5
-- end
6

7
SILE.settings:declare({ parameter = "shaper.variablespaces", type = "boolean", default = true })
13✔
8
SILE.settings:declare({ parameter = "shaper.spaceenlargementfactor", type = "number or integer", default = 1.2 })
13✔
9
SILE.settings:declare({ parameter = "shaper.spacestretchfactor", type = "number or integer", default = 1/2 })
13✔
10
SILE.settings:declare({ parameter = "shaper.spaceshrinkfactor", type = "number or integer", default = 1/3 })
13✔
11

12
SILE.settings:declare({
13✔
13
    parameter = "shaper.tracking",
14
    type = "number or nil",
15
    default = nil
×
16
  })
17

18
-- Function for testing shaping in the repl
19
-- luacheck: ignore makenodes
20
-- TODO, figure out a way to explicitly register things in the repl env
21
makenodes = function (token, options)
22
  return SILE.shaper:createNnodes(token, SILE.font.loadDefaults(options or {}))
×
23
end
24

25
local function shapespace (spacewidth)
26
  spacewidth = SU.cast("measurement", spacewidth)
1,268✔
27
  -- In some scripts with word-level kerning, glue can be negative.
28
  -- Use absolute value to ensure stretch and shrink work as expected.
29
  local absoluteSpaceWidth = math.abs(spacewidth:tonumber())
1,268✔
30
  local length = spacewidth * SILE.settings:get("shaper.spaceenlargementfactor")
1,268✔
31
  local stretch = absoluteSpaceWidth * SILE.settings:get("shaper.spacestretchfactor")
1,268✔
32
  local shrink = absoluteSpaceWidth * SILE.settings:get("shaper.spaceshrinkfactor")
1,268✔
33
  return SILE.length(length, stretch, shrink)
634✔
34
end
35

36
local shaper = pl.class()
13✔
37
shaper.type = "shaper"
13✔
38
shaper._name = "base"
13✔
39

40
-- Return the length of a space character
41
-- with a particular set of font options,
42
-- giving preference to document.spaceskip
43
-- Caching this has no significant speedup
44
function shaper:measureSpace (options)
13✔
UNCOV
45
  local ss = SILE.settings:get("document.spaceskip")
×
UNCOV
46
  if ss then
×
47
    SILE.settings:temporarily(function ()
×
48
      SILE.settings:set("font.size", options.size)
×
49
      SILE.settings:set("font.family", options.family)
×
50
      SILE.settings:set("font.filename", options.filename)
×
51
      ss = ss:absolute()
×
52
    end)
53
    return ss
×
54
  end
UNCOV
55
  local items, width = self:shapeToken(" ", options)
×
UNCOV
56
  if not width and not items[1] then
×
57
    SU.warn("Could not measure the width of a space")
×
58
    return SILE.length()
×
59
  end
UNCOV
60
  return shapespace(width and width.length or items[1].width)
×
61
end
62

63
function shaper:measureChar (char)
13✔
64
  local options = SILE.font.loadDefaults({})
496✔
65
  options.tracking = SILE.settings:get("shaper.tracking")
992✔
66
  local items = self:shapeToken(char, options)
496✔
67
  if #items > 0 then
496✔
68
    return { height = items[1].height, width = items[1].width }
496✔
69
  else
70
    SU.error("Unable to measure character", char)
×
71
  end
72
end
73

74
-- Given a text and some font options, return a bunch of boxes
75
function shaper.shapeToken (_, _, _)
13✔
76
  SU.error("Abstract function shapeToken called", true)
×
77
end
78

79
-- Given font options, select a font. We will handle
80
-- caching here. Returns an arbitrary, implementation-specific
81
-- object (ie a PAL for Pango, font number for libtexpdf, ...)
82
function shaper.getFace (_)
13✔
83
  SU.error("Abstract function getFace called", true)
×
84
end
85

86
function shaper.addShapedGlyphToNnodeValue (_, _, _)
13✔
87
  SU.error("Abstract function addShapedGlyphToNnodeValue called", true)
×
88
end
89

90
function shaper.preAddNodes (_, _, _) end
13✔
91

92
function shaper:createNnodes (token, options)
13✔
93
  options.tracking = SILE.settings:get("shaper.tracking")
1,264✔
94
  local items, _ = self:shapeToken(token, options)
632✔
95
  if #items < 1 then return {} end
632✔
96
  local lang = options.language
632✔
97
  SILE.languageSupport.loadLanguage(lang)
632✔
98
  local nodeMaker = SILE.nodeMakers[lang] or SILE.nodeMakers.unicode
632✔
99
  local nodes = {}
632✔
100
  for node in nodeMaker(options):iterator(items, token) do
3,906✔
101
    table.insert(nodes, node)
2,010✔
102
  end
103
  return nodes
632✔
104
end
105

106
function shaper:formNnode (contents, token, options)
13✔
107
  local nnodeContents = {}
1,362✔
108
  -- local glyphs = {}
109
  local totalWidth = 0
1,362✔
110
  local totalDepth = 0
1,362✔
111
  local totalHeight = 0
1,362✔
112
  -- local glyphNames = {}
113
  local nnodeValue = { text = token, options = options, glyphString = {} }
1,362✔
114
  SILE.shaper:preAddNodes(contents, nnodeValue)
1,362✔
115
  local misfit = false
1,362✔
116
  if SILE.typesetter.frame and SILE.typesetter.frame:writingDirection() == "TTB" then
2,724✔
UNCOV
117
    if options.direction == "LTR" then misfit = true end
×
118
  else
119
    if options.direction == "TTB" then misfit = true end
1,362✔
120
  end
121
  for i = 1, #contents do
6,168✔
122
    local glyph = contents[i]
4,806✔
123
    if (options.direction == "TTB") ~= misfit then
4,806✔
UNCOV
124
      if glyph.width > totalHeight then totalHeight = glyph.width end
×
UNCOV
125
      totalWidth = totalWidth + glyph.height
×
126
    else
127
      if glyph.depth > totalDepth then totalDepth = glyph.depth end
4,806✔
128
      if glyph.height > totalHeight then totalHeight = glyph.height end
4,806✔
129
      totalWidth = totalWidth + glyph.width
4,806✔
130
    end
131
    self:addShapedGlyphToNnodeValue(nnodeValue, glyph)
4,806✔
132
  end
133
  table.insert(nnodeContents, SILE.nodefactory.hbox({
4,086✔
134
        depth = totalDepth,
1,362✔
135
        height = totalHeight,
1,362✔
136
        misfit = misfit,
1,362✔
137
        width = SILE.length(totalWidth),
2,724✔
138
        value = nnodeValue
1,362✔
139
    }))
140
  return SILE.nodefactory.nnode({
1,362✔
141
      nodes = nnodeContents,
1,362✔
142
      text = token,
1,362✔
143
      misfit = misfit,
1,362✔
144
      options = options,
1,362✔
145
      language = options.language
1,362✔
146
    })
1,362✔
147
end
148

149
function shaper.makeSpaceNode (_, options, item)
13✔
150
  local width
151
  if SILE.settings:get("shaper.variablespaces") then
1,268✔
152
    width = shapespace(item.width)
1,268✔
153
  else
154
    width = SILE.shaper:measureSpace(options)
×
155
  end
156
  return SILE.nodefactory.glue(width)
634✔
157
end
158

159
function shaper.debugVersions (_) end
13✔
160

161
return shaper
13✔
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