gecko-dev/gfx/thebes/gfxHarfBuzzShaper.h

204 lines
7.4 KiB
C++

/* -*- Mode: C++; tab-width: 20; indent-tabs-mode: nil; c-basic-offset: 4 -*-
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef GFX_HARFBUZZSHAPER_H
#define GFX_HARFBUZZSHAPER_H
#include "gfxFont.h"
#include "harfbuzz/hb.h"
#include "nsUnicodeProperties.h"
#include "mozilla/gfx/2D.h"
class gfxHarfBuzzShaper : public gfxFontShaper {
public:
explicit gfxHarfBuzzShaper(gfxFont *aFont);
virtual ~gfxHarfBuzzShaper();
/*
* For HarfBuzz font callback functions, font_data is a ptr to a
* FontCallbackData struct
*/
struct FontCallbackData {
gfxHarfBuzzShaper* mShaper;
// initialized to a DrawTarget owned by our caller on every call to
// ShapeText
mozilla::gfx::DrawTarget* MOZ_NON_OWNING_REF mDrawTarget;
};
bool Initialize();
bool ShapeText(DrawTarget *aDrawTarget,
const char16_t *aText,
uint32_t aOffset,
uint32_t aLength,
Script aScript,
bool aVertical,
RoundingFlags aRounding,
gfxShapedText *aShapedText) override;
// get a given font table in harfbuzz blob form
hb_blob_t * GetFontTable(hb_tag_t aTag) const;
// map unicode character to glyph ID
hb_codepoint_t GetNominalGlyph(hb_codepoint_t unicode) const;
hb_codepoint_t GetVariationGlyph(hb_codepoint_t unicode,
hb_codepoint_t variation_selector) const;
// get harfbuzz glyph advance, in font design units
hb_position_t GetGlyphHAdvance(hb_codepoint_t glyph) const;
hb_position_t GetGlyphVAdvance(hb_codepoint_t glyph) const;
void GetGlyphVOrigin(mozilla::gfx::DrawTarget& aDT,
hb_codepoint_t aGlyph,
hb_position_t *aX, hb_position_t *aY) const;
// get harfbuzz horizontal advance in 16.16 fixed point format.
static hb_position_t
HBGetGlyphHAdvance(hb_font_t *font, void *font_data,
hb_codepoint_t glyph, void *user_data);
// get harfbuzz vertical advance in 16.16 fixed point format.
static hb_position_t
HBGetGlyphVAdvance(hb_font_t *font, void *font_data,
hb_codepoint_t glyph, void *user_data);
static hb_bool_t
HBGetGlyphVOrigin(hb_font_t *font, void *font_data,
hb_codepoint_t glyph,
hb_position_t *x, hb_position_t *y,
void *user_data);
hb_position_t GetHKerning(uint16_t aFirstGlyph,
uint16_t aSecondGlyph) const;
hb_bool_t GetGlyphExtents(hb_codepoint_t aGlyph,
hb_glyph_extents_t *aExtents) const;
bool UseVerticalPresentationForms() const
{
return mUseVerticalPresentationForms;
}
static hb_script_t
GetHBScriptUsedForShaping(Script aScript) {
// Decide what harfbuzz script code will be used for shaping
hb_script_t hbScript;
if (aScript <= Script::INHERITED) {
// For unresolved "common" or "inherited" runs,
// default to Latin for now.
hbScript = HB_SCRIPT_LATIN;
} else {
hbScript =
hb_script_t(mozilla::unicode::GetScriptTagForCode(aScript));
}
return hbScript;
}
static hb_codepoint_t
GetVerticalPresentationForm(hb_codepoint_t aUnicode);
protected:
nsresult SetGlyphsFromRun(gfxShapedText *aShapedText,
uint32_t aOffset,
uint32_t aLength,
const char16_t *aText,
bool aVertical,
RoundingFlags aRounding);
// retrieve glyph positions, applying advance adjustments and attachments
// returns results in appUnits
nscoord GetGlyphPositions(gfxContext *aContext,
nsTArray<nsPoint>& aPositions,
uint32_t aAppUnitsPerDevUnit);
void InitializeVertical();
bool LoadHmtxTable();
struct Glyf { // we only need the bounding-box at the beginning
// of the glyph record, not the actual outline data
mozilla::AutoSwap_PRInt16 numberOfContours;
mozilla::AutoSwap_PRInt16 xMin;
mozilla::AutoSwap_PRInt16 yMin;
mozilla::AutoSwap_PRInt16 xMax;
mozilla::AutoSwap_PRInt16 yMax;
};
const Glyf *FindGlyf(hb_codepoint_t aGlyph, bool *aEmptyGlyf) const;
// harfbuzz face object: we acquire a reference from the font entry
// on shaper creation, and release it in our destructor
hb_face_t *mHBFace;
// size-specific font object, owned by the gfxHarfBuzzShaper
hb_font_t *mHBFont;
// harfbuzz buffer for the shaping process
hb_buffer_t *mBuffer;
FontCallbackData mCallbackData;
// Following table references etc are declared "mutable" because the
// harfbuzz callback functions take a const ptr to the shaper, but
// wish to cache tables here to avoid repeatedly looking them up
// in the font.
// Old-style TrueType kern table, if we're not doing GPOS kerning
mutable hb_blob_t *mKernTable;
// Cached copy of the hmtx table.
mutable hb_blob_t *mHmtxTable;
// For vertical fonts, cached vmtx and VORG table, if present.
mutable hb_blob_t *mVmtxTable;
mutable hb_blob_t *mVORGTable;
// And for vertical TrueType (not CFF) fonts that have vmtx,
// we also use loca and glyf to get glyph bounding boxes.
mutable hb_blob_t *mLocaTable;
mutable hb_blob_t *mGlyfTable;
// Cached pointer to cmap subtable to be used for char-to-glyph mapping.
// This comes from GetFontTablePtr; if it is non-null, our destructor
// must call ReleaseFontTablePtr to avoid permanently caching the table.
mutable hb_blob_t *mCmapTable;
mutable int32_t mCmapFormat;
mutable uint32_t mSubtableOffset;
mutable uint32_t mUVSTableOffset;
// Cached copy of numLongMetrics field from the hhea table,
// for use when looking up glyph metrics; initialized to 0 by the
// constructor so we can tell it hasn't been set yet.
// This is a signed value so that we can use -1 to indicate
// an error (if the hhea table was not available).
mutable int32_t mNumLongHMetrics;
// Similarly for vhea if it's a vertical font.
mutable int32_t mNumLongVMetrics;
// Default y-coordinate for glyph vertical origin, used if the font
// does not actually have vertical-layout metrics.
mutable gfxFloat mDefaultVOrg;
// Whether the font implements GetGlyph, or we should read tables
// directly
bool mUseFontGetGlyph;
// Whether the font implements GetGlyphWidth, or we should read tables
// directly to get ideal widths
bool mUseFontGlyphWidths;
bool mInitialized;
bool mVerticalInitialized;
// Whether to use vertical presentation forms for CJK characters
// when available (only set if the 'vert' feature is not available).
bool mUseVerticalPresentationForms;
// these are set from the FindGlyf callback on first use of the glyf data
mutable bool mLoadedLocaGlyf;
mutable bool mLocaLongOffsets;
};
#endif /* GFX_HARFBUZZSHAPER_H */