[HarfBuzz] hb-view hb-shape documentation

[Khaled Hosny]

Use --output-format=json, should be a bit more explanatory. Myself, I
often forget which number is which, but you basically get glyph name,
cluster value, X and Y advance and delta.

The glyph name is equivalent to glyph index, just a bit more readable.
The cluster value is basically the index of the corresponding character
in the input string (though the relation can be complex). The advances
and deltas are what HarfBuzz clients will use to calculate the absolute
glyph position, HarfBuzz itself does not do that.

Regards,
Khaled

On Thu, Sep 26, 2013 at 07:51:20PM +0200, Eduardo Castineyra wrote:
> Now I see it, thanks!
> 
> How should I interpret the outcome for hb-shape?
> 
> > hb-shape leelawad.ttf --text-file=thai.txt
> 
> [space=0+0|uni0E2B=1+1207|uni0E49=1 at 217,0+0|uni0E31=1 at 114,500+0|space=4+1122|uni0E2B=5+1207|uni0E31=5 at 114,0+0|space=7+1122|uni0E2B=8+1207|uni0E49=8 at 217,0+0|spac
> e=10+1122|uni0E2B=11+1207|uni0E31=11 at 114,0+0|uni0E49.sm=11 at 114,500+0]
> 
> What I would expect to see was the unicode, the index of the glyph
> inside the leelawad.ttf font, and the screen position of the glyph.
> But I don't what those numbers and symbols mean.
> 
> El 26/09/2013 19:27, Khaled Hosny escribió:
> >On Thu, Sep 26, 2013 at 06:48:26PM +0200, Eduardo Castineyra wrote:
> >>Hi,
> >>
> >>I was trying to use the hb-view and hb-shape tools but I don't get
> >>how do they work.
> >>
> >>This is the output I got from hb-view, is there any documentation to
> >>know what can I do with the outcome?
> >If you don't specify an output file name, hb-view will do some sort of
> >Unicode-art to draw the glyphs on the terminal. This works fine on
> >Unicode-capable terminals, but I guess Windows’s cmd.exe is not such a
> >one.  You can specify the output file name and format explicitly, see
> >hb-view --help.
> >
> >Regards,
> >Khaled