text: /****************************************************************************
  **
  ** Copyright (C) 2016 The Qt Company Ltd.
  ** Contact: https://www.qt.io/licensing/
  **
  ** This file is part of the QtGui module of the Qt Toolkit.
  **
  ** $QT_BEGIN_LICENSE:LGPL$
  ** Commercial License Usage
  ** Licensees holding valid commercial Qt licenses may use this file in
  ** accordance with the commercial license agreement provided with the
  ** Software or, alternatively, in accordance with the terms contained in
  ** a written agreement between you and The Qt Company. For licensing terms
  ** and conditions see https://www.qt.io/terms-conditions. For further
  ** information use the contact form at https://www.qt.io/contact-us.
  **
  ** GNU Lesser General Public License Usage
  ** Alternatively, this file may be used under the terms of the GNU Lesser
  ** General Public License version 3 as published by the Free Software
  ** Foundation and appearing in the file LICENSE.LGPL3 included in the
  ** packaging of this file. Please review the following information to
  ** ensure the GNU Lesser General Public License version 3 requirements
  ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
  **
  ** GNU General Public License Usage
  ** Alternatively, this file may be used under the terms of the GNU
  ** General Public License version 2.0 or (at your option) the GNU General
  ** Public license version 3 or any later version approved by the KDE Free
  ** Qt Foundation. The licenses are as published by the Free Software
  ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
  ** included in the packaging of this file. Please review the following
  ** information to ensure the GNU General Public License requirements will
  ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
  ** https://www.gnu.org/licenses/gpl-3.0.html.
  **
  ** $QT_END_LICENSE$
  **
  ****************************************************************************/
  
  #ifndef QFONTENGINE_CORETEXT_P_H
  #define QFONTENGINE_CORETEXT_P_H
  
  //
  //  W A R N I N G
  //  -------------
  //
  // This file is not part of the Qt API.  It exists purely as an
  // implementation detail.  This header file may change from version to
  // version without notice, or even be removed.
  //
  // We mean it.
  //
  
  #include <private/qfontengine_p.h>
  #include <private/qcore_mac_p.h>
  
  #ifdef Q_OS_OSX
  #include <ApplicationServices/ApplicationServices.h>
  #else
  #include <CoreText/CoreText.h>
  #include <CoreGraphics/CoreGraphics.h>
  #endif
  
  QT_BEGIN_NAMESPACE
  
  class QCoreTextFontEngine : public QFontEngine
  {
  public:
      QCoreTextFontEngine(CTFontRef font, const QFontDef &def);
      QCoreTextFontEngine(CGFontRef font, const QFontDef &def);
      ~QCoreTextFontEngine();
  
      glyph_t glyphIndex(uint ucs4) const override;
      bool stringToCMap(const QChar *str, int len, QGlyphLayout *glyphs, int *nglyphs, ShaperFlags flags) const override;
      void recalcAdvances(QGlyphLayout *, ShaperFlags) const override;
  
      glyph_metrics_t boundingBox(const QGlyphLayout &glyphs) override;
      glyph_metrics_t boundingBox(glyph_t glyph) override;
  
      QFixed ascent() const override;
      QFixed capHeight() const override;
      QFixed descent() const override;
      QFixed leading() const override;
      QFixed xHeight() const override;
      qreal maxCharWidth() const override;
      QFixed averageCharWidth() const override;
  
      void addGlyphsToPath(glyph_t *glyphs, QFixedPoint *positions, int numGlyphs,
                           QPainterPath *path, QTextItem::RenderFlags) override;
  
      bool canRender(const QChar *string, int len) const override;
  
      int synthesized() const override { return synthesisFlags; }
      bool supportsSubPixelPositions() const override { return true; }
  
      QFixed lineThickness() const override;
      QFixed underlinePosition() const override;
  
      void draw(CGContextRef ctx, qreal x, qreal y, const QTextItemInt &ti, int paintDeviceHeight);
  
      FaceId faceId() const override;
      bool getSfntTableData(uint /*tag*/, uchar * /*buffer*/, uint * /*length*/) const override;
      void getUnscaledGlyph(glyph_t glyph, QPainterPath *path, glyph_metrics_t *metrics) override;
      QImage alphaMapForGlyph(glyph_t, QFixed subPixelPosition) override;
      QImage alphaMapForGlyph(glyph_t glyph, QFixed subPixelPosition, const QTransform &t) override;
      QImage alphaRGBMapForGlyph(glyph_t, QFixed subPixelPosition, const QTransform &t) override;
      glyph_metrics_t alphaMapBoundingBox(glyph_t glyph, QFixed, const QTransform &matrix, GlyphFormat) override;
      QImage bitmapForGlyph(glyph_t, QFixed subPixelPosition, const QTransform &t) override;
      QFixed emSquareSize() const override;
      void doKerning(QGlyphLayout *g, ShaperFlags flags) const override;
  
      bool supportsTransformation(const QTransform &transform) const override;
      bool expectsGammaCorrectedBlending() const override;
  
      QFontEngine *cloneWithSize(qreal pixelSize) const override;
      Qt::HANDLE handle() const override;
      int glyphMargin(QFontEngine::GlyphFormat format) override { Q_UNUSED(format); return 0; }
  
      QFontEngine::Properties properties() const override;
  
      static bool ct_getSfntTable(void *user_data, uint tag, uchar *buffer, uint *length);
      static QFont::Weight qtWeightFromCFWeight(float value);
  
      static int antialiasingThreshold;
      static QFontEngine::GlyphFormat defaultGlyphFormat;
  
      static QCoreTextFontEngine *create(const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference);
  protected:
      void init();
      QImage imageForGlyph(glyph_t glyph, QFixed subPixelPosition, bool colorful, const QTransform &m);
      CTFontRef ctfont;
      CGFontRef cgFont;
      int synthesisFlags;
      CGAffineTransform transform;
      QFixed avgCharWidth;
      QFixed underlineThickness;
      QFixed underlinePos;
      QFontEngine::FaceId face_id;
      mutable bool kerningPairsLoaded;
  };
  
  CGAffineTransform qt_transform_from_fontdef(const QFontDef &fontDef);
  
  QT_END_NAMESPACE
  
  #endif // QFONTENGINE_CORETEXT_P_H
  