Bind hb_ot_layout_lookup_get_optical_bound()

Author: khaledhosny

config-override.h

@@ -11,4 +11,5 @@
 #undef HB_NO_VAR_COMPOSITES
 #undef HB_NO_NAME
 #undef HB_NO_LAYOUT_FEATURE_PARAMS
+#undef HB_NO_LAYOUT_RARELY_USED
 #define HB_BUFFER_MESSAGE_MORE 1

harfbuzz.symbols

@@ -79,6 +79,7 @@ _hb_ot_layout_table_get_feature_tags
 _hb_ot_layout_script_get_language_tags
 _hb_ot_layout_language_get_feature_tags
 _hb_ot_layout_feature_get_lookups
+_hb_ot_layout_lookup_get_optical_bound
 _hb_ot_layout_get_glyph_class
 _hb_ot_layout_feature_get_name_ids
 _hb_ot_name_list_names

src/font.ts

@@ -6,6 +6,7 @@ import {
   string_to_utf8_ptr,
 } from "./helpers";
 import type { FontExtents, GlyphExtents, SvgPathCommand } from "./types";
+import type { Direction } from "./buffer";
 import type { Face } from "./face";
 import type { FontFuncs } from "./font-funcs";
 import type { Variation } from "./variation";
@@ -453,4 +454,25 @@ export class Font {
   setFuncs(fontFuncs: FontFuncs): void {
     exports.hb_font_set_funcs(this.ptr, fontFuncs.ptr);
   }
+
+  /**
+   * Fetches the optical bound of a glyph positioned at the margin of text.
+   * The direction identifies which edge of the glyph to query.
+   * @param lookupIndex Index of the feature lookup to query.
+   * @param direction Edge of the glyph to query.
+   * @param glyph A glyph id.
+   * @returns Adjustment value. Negative values mean the glyph will stick out of the margin.
+   */
+  getLookupOpticalBound(
+    lookupIndex: number,
+    direction: Direction,
+    glyph: number,
+  ): number {
+    return exports.hb_ot_layout_lookup_get_optical_bound(
+      this.ptr,
+      lookupIndex,
+      direction,
+      glyph,
+    );
+  }
 }

test/index.test.js

@@ -520,6 +520,23 @@ describe("Font", function () {
     expect(font.glyph(0x10ffff)).to.equal(font.nominalGlyph(0x10ffff));
   });
 
+  it("getLookupOpticalBound returns some value", function () {
+    let blob = new hb.Blob(
+      fs.readFileSync(path.join(__dirname, "fonts/noto/NotoSans-Regular.ttf")),
+    );
+    let face = new hb.Face(blob);
+    let font = new hb.Font(face);
+    const kernIndex = face.getTableFeatureTags("GPOS").indexOf("kern");
+    const [lookupIndex] = face.getFeatureLookups("GPOS", kernIndex);
+    const glyph = font.glyphFromName("A");
+    const opticalBound = font.getLookupOpticalBound(
+      lookupIndex,
+      hb.Direction.LTR,
+      glyph,
+    );
+    expect(opticalBound).to.be.a("number");
+  });
+
   it("setVariations affects advances", function () {
     let blob = new hb.Blob(
       fs.readFileSync(