5897172563

Committed 18 Aug 2023 12:08AM UTC coverage: 65.701% (-8.7%) from 74.359%

Build # 5897172563

Build Type

push

github

Committed by

web-flow

Commit Message

Merge e093e2956 into 83d142305

Run Details

10300 of 15677 relevant lines covered (65.7%)

6629.59 hits per line

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

84.21

/shapers/base.lua

-- local smallTokenSize = 20 -- Small words will be cached
-- local shapeCache = {}
-- local _key = function (options)
--   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 }, ";")
-- end

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

SILE.settings:declare({
    parameter = "shaper.tracking",
    type = "number or nil",
    default = nil
  })

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

local function shapespace (spacewidth)
  spacewidth = SU.cast("measurement", spacewidth)
  -- In some scripts with word-level kerning, glue can be negative.
  -- Use absolute value to ensure stretch and shrink work as expected.
  local absoluteSpaceWidth = math.abs(spacewidth:tonumber())
  local length = spacewidth * SILE.settings:get("shaper.spaceenlargementfactor")
  local stretch = absoluteSpaceWidth * SILE.settings:get("shaper.spacestretchfactor")
  local shrink = absoluteSpaceWidth * SILE.settings:get("shaper.spaceshrinkfactor")
  return SILE.length(length, stretch, shrink)
end

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

-- Return the length of a space character
-- with a particular set of font options,
-- giving preference to document.spaceskip
-- Caching this has no significant speedup
function shaper:measureSpace (options)
  local ss = SILE.settings:get("document.spaceskip")
  if ss then
    SILE.settings:temporarily(function ()
      SILE.settings:set("font.size", options.size)
      SILE.settings:set("font.family", options.family)
      SILE.settings:set("font.filename", options.filename)
      ss = ss:absolute()
    end)
    return ss
  end
  local items, width = self:shapeToken(" ", options)
  if not width and not items[1] then
    SU.warn("Could not measure the width of a space")
    return SILE.length()
  end
  return shapespace(width and width.length or items[1].width)
end

function shaper:measureChar (char)
  local options = SILE.font.loadDefaults({})
  options.tracking = SILE.settings:get("shaper.tracking")
  local items = self:shapeToken(char, options)
  if #items > 0 then
    return { height = items[1].height, width = items[1].width }
  else
    SU.error("Unable to measure character", char)
  end
end

-- Given a text and some font options, return a bunch of boxes
function shaper.shapeToken (_, _, _)
  SU.error("Abstract function shapeToken called", true)
end

-- Given font options, select a font. We will handle
-- caching here. Returns an arbitrary, implementation-specific
-- object (ie a PAL for Pango, font number for libtexpdf, ...)
function shaper.getFace (_)
  SU.error("Abstract function getFace called", true)
end

function shaper.addShapedGlyphToNnodeValue (_, _, _)
  SU.error("Abstract function addShapedGlyphToNnodeValue called", true)
end

function shaper.preAddNodes (_, _, _) end

function shaper:createNnodes (token, options)
  options.tracking = SILE.settings:get("shaper.tracking")
  local items, _ = self:shapeToken(token, options)
  if #items < 1 then return {} end
  local lang = options.language
  SILE.languageSupport.loadLanguage(lang)
  local nodeMaker = SILE.nodeMakers[lang] or SILE.nodeMakers.unicode
  local nodes = {}
  for node in nodeMaker(options):iterator(items, token) do
    table.insert(nodes, node)
  end
  return nodes
end

function shaper:formNnode (contents, token, options)
  local nnodeContents = {}
  -- local glyphs = {}
  local totalWidth = 0
  local totalDepth = 0
  local totalHeight = 0
  -- local glyphNames = {}
  local nnodeValue = { text = token, options = options, glyphString = {} }
  SILE.shaper:preAddNodes(contents, nnodeValue)
  local misfit = false
  if SILE.typesetter.frame and SILE.typesetter.frame:writingDirection() == "TTB" then
    if options.direction == "LTR" then misfit = true end
  else
    if options.direction == "TTB" then misfit = true end
  end
  for i = 1, #contents do
    local glyph = contents[i]
    if (options.direction == "TTB") ~= misfit then
      if glyph.width > totalHeight then totalHeight = glyph.width end
      totalWidth = totalWidth + glyph.height
    else
      if glyph.depth > totalDepth then totalDepth = glyph.depth end
      if glyph.height > totalHeight then totalHeight = glyph.height end
      totalWidth = totalWidth + glyph.width
    end
    self:addShapedGlyphToNnodeValue(nnodeValue, glyph)
  end
  table.insert(nnodeContents, SILE.nodefactory.hbox({
        depth = totalDepth,
        height = totalHeight,
        misfit = misfit,
        width = SILE.length(totalWidth),
        value = nnodeValue
    }))
  return SILE.nodefactory.nnode({
      nodes = nnodeContents,
      text = token,
      misfit = misfit,
      options = options,
      language = options.language
    })
end

function shaper.makeSpaceNode (_, options, item)
  local width
  if SILE.settings:get("shaper.variablespaces") then
    width = shapespace(item.width)
  else
    width = SILE.shaper:measureSpace(options)
  end
  return SILE.nodefactory.glue(width)
end

function shaper.debugVersions (_) end

return shaper

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 })	53✔
8	SILE.settings:declare({ parameter = "shaper.spaceenlargementfactor", type = "number or integer", default = 1.2 })	53✔
9	SILE.settings:declare({ parameter = "shaper.spacestretchfactor", type = "number or integer", default = 1/2 })	53✔
10	SILE.settings:declare({ parameter = "shaper.spaceshrinkfactor", type = "number or integer", default = 1/3 })	53✔
11
12	SILE.settings:declare({	53✔
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)	5,342✔
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())	5,342✔
30	local length = spacewidth * SILE.settings:get("shaper.spaceenlargementfactor")	5,342✔
31	local stretch = absoluteSpaceWidth * SILE.settings:get("shaper.spacestretchfactor")	5,342✔
32	local shrink = absoluteSpaceWidth * SILE.settings:get("shaper.spaceshrinkfactor")	5,342✔
33	return SILE.length(length, stretch, shrink)	2,671✔
34	end
35
36	local shaper = pl.class()	53✔
37	shaper.type = "shaper"	53✔
38	shaper._name = "base"	53✔
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)	53✔
45	local ss = SILE.settings:get("document.spaceskip")	2✔
46	if ss then	2✔
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
55	local items, width = self:shapeToken(" ", options)	2✔
56	if not width and not items[1] then	2✔
57	SU.warn("Could not measure the width of a space")	×
58	return SILE.length()	×
59	end
60	return shapespace(width and width.length or items[1].width)	2✔
61	end
62
63	function shaper:measureChar (char)	53✔
64	local options = SILE.font.loadDefaults({})	1,450✔
65	options.tracking = SILE.settings:get("shaper.tracking")	2,900✔
66	local items = self:shapeToken(char, options)	1,450✔
67	if #items > 0 then	1,450✔
68	return { height = items[1].height, width = items[1].width }	1,450✔
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 (_, _, _)	53✔
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 (_)	53✔
83	SU.error("Abstract function getFace called", true)	×
84	end
85
86	function shaper.addShapedGlyphToNnodeValue (_, _, _)	53✔
87	SU.error("Abstract function addShapedGlyphToNnodeValue called", true)	×
88	end
89
90	function shaper.preAddNodes (_, _, _) end	53✔
91
92	function shaper:createNnodes (token, options)	53✔
93	options.tracking = SILE.settings:get("shaper.tracking")	6,634✔
94	local items, _ = self:shapeToken(token, options)	3,317✔
95	if #items < 1 then return {} end	3,317✔
96	local lang = options.language	3,317✔
97	SILE.languageSupport.loadLanguage(lang)	3,317✔
98	local nodeMaker = SILE.nodeMakers[lang] or SILE.nodeMakers.unicode	3,317✔
99	local nodes = {}	3,317✔
100	for node in nodeMaker(options):iterator(items, token) do	18,903✔
101	table.insert(nodes, node)	8,952✔
102	end
103	return nodes	3,317✔
104	end
105
106	function shaper:formNnode (contents, token, options)	53✔
107	local nnodeContents = {}	6,210✔
108	-- local glyphs = {}
109	local totalWidth = 0	6,210✔
110	local totalDepth = 0	6,210✔
111	local totalHeight = 0	6,210✔
112	-- local glyphNames = {}
113	local nnodeValue = { text = token, options = options, glyphString = {} }	6,210✔
114	SILE.shaper:preAddNodes(contents, nnodeValue)	6,210✔
115	local misfit = false	6,210✔
116	if SILE.typesetter.frame and SILE.typesetter.frame:writingDirection() == "TTB" then	12,420✔
117	if options.direction == "LTR" then misfit = true end	2✔
118	else
119	if options.direction == "TTB" then misfit = true end	6,208✔
120	end
121	for i = 1, #contents do	27,332✔
122	local glyph = contents[i]	21,122✔
123	if (options.direction == "TTB") ~= misfit then	21,122✔
124	if glyph.width > totalHeight then totalHeight = glyph.width end	2✔
125	totalWidth = totalWidth + glyph.height	2✔
126	else
127	if glyph.depth > totalDepth then totalDepth = glyph.depth end	21,120✔
128	if glyph.height > totalHeight then totalHeight = glyph.height end	21,120✔
129	totalWidth = totalWidth + glyph.width	21,120✔
130	end
131	self:addShapedGlyphToNnodeValue(nnodeValue, glyph)	21,122✔
132	end
133	table.insert(nnodeContents, SILE.nodefactory.hbox({	18,630✔
134	depth = totalDepth,	6,210✔
135	height = totalHeight,	6,210✔
136	misfit = misfit,	6,210✔
137	width = SILE.length(totalWidth),	12,420✔
138	value = nnodeValue	6,210✔
139	}))
140	return SILE.nodefactory.nnode({	6,210✔
141	nodes = nnodeContents,	6,210✔
142	text = token,	6,210✔
143	misfit = misfit,	6,210✔
144	options = options,	6,210✔
145	language = options.language	6,210✔
146	})	6,210✔
147	end
148
149	function shaper.makeSpaceNode (_, options, item)	53✔
150	local width
151	if SILE.settings:get("shaper.variablespaces") then	5,338✔
152	width = shapespace(item.width)	5,338✔
153	else
154	width = SILE.shaper:measureSpace(options)	×
155	end
156	return SILE.nodefactory.glue(width)	2,669✔
157	end
158
159	function shaper.debugVersions (_) end	53✔
160
161	return shaper	53✔

sile-typesetter / sile / 5897172563

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