walkero
/
harfbuzz
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

[repacker] add more detailed comment about virtual links.

This commit is contained in:
Garret Rieger 2021-09-24 11:39:59 -07:00
parent 5bfc7d1015
commit 9643d77086
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
src/hb-serialize.hh
View File

@ -358,10 +358,16 @@ struct hb_serialize_context_t
assert (packed.tail ()->head == tail);
}
// Adds a virtual link from the current object to objidx. A virtual link is not associated with
// an actual offset field. They are solely used to enforce ordering constraints between objects.
// Adding a virtual link from object a to object b will ensure that object b is always packed after
// object a in the final serialized order.
//
// This is useful in certain situtations where there needs to be a specific ordering in the
// final serialization. Such as when platform bugs require certain orderings, or to provide
// guidance to the repacker for better offset overflow resolution.
void add_virtual_link (objidx_t objidx)
{
// This link is not associated with an actual offset and exists merely to enforce
// an ordering constraint.
if (unlikely (in_error ())) return;
if (!objidx)