2019-11-23 20:27:39 +08:00
|
|
|
/****************************************************************************
|
|
|
|
Copyright (c) 2013 Zynga Inc.
|
|
|
|
Copyright (c) 2013-2016 Chukong Technologies Inc.
|
|
|
|
Copyright (c) 2017-2018 Xiamen Yaji Software Co., Ltd.
|
2021-08-28 18:24:17 +08:00
|
|
|
Copyright (c) 2021 Bytedance Inc.
|
|
|
|
|
|
|
|
https://adxe.org
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
2021-08-28 18:24:17 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
2021-08-28 18:24:17 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
THE SOFTWARE.
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef _FontFreetype_h_
|
|
|
|
#define _FontFreetype_h_
|
|
|
|
|
|
|
|
/// @cond DO_NOT_SHOW
|
|
|
|
|
|
|
|
#include "2d/CCFont.h"
|
|
|
|
|
2021-09-20 18:24:11 +08:00
|
|
|
#include "ft2build.h"
|
2021-08-28 18:24:17 +08:00
|
|
|
#include <string>
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
#include FT_FREETYPE_H
|
|
|
|
#include FT_STROKER_H
|
|
|
|
|
|
|
|
NS_CC_BEGIN
|
|
|
|
|
|
|
|
class CC_DLL FontFreeType : public Font
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
static const int DistanceMapSpread;
|
|
|
|
|
2021-11-27 11:06:51 +08:00
|
|
|
static FontFreeType* create(std::string_view fontName,
|
2021-08-28 18:24:17 +08:00
|
|
|
float fontSize,
|
|
|
|
GlyphCollection glyphs,
|
2021-11-27 11:06:51 +08:00
|
|
|
std::string_view customGlyphs,
|
2021-08-28 18:24:17 +08:00
|
|
|
bool distanceFieldEnabled = false,
|
|
|
|
float outline = 0);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
static void shutdownFreeType();
|
|
|
|
|
2020-08-27 11:35:55 +08:00
|
|
|
/*
|
2021-08-28 18:24:17 +08:00
|
|
|
* @remark: if you want enable stream parsing, you need do one of follow steps
|
|
|
|
* a. disable .ttf compress on .apk, see:
|
|
|
|
* https://simdsoft.com/notes/#build-apk-config-nocompress-file-type-at-appbuildgradle
|
|
|
|
* b. uncomporess .ttf to disk by yourself.
|
|
|
|
*/
|
2020-10-06 12:31:17 +08:00
|
|
|
static void setStreamParsingEnabled(bool bEnabled) { _streamParsingEnabled = bEnabled; }
|
2020-08-27 11:40:44 +08:00
|
|
|
static bool isStreamParsingEnabled() { return _streamParsingEnabled; }
|
2020-08-27 11:35:55 +08:00
|
|
|
|
2021-08-28 18:24:17 +08:00
|
|
|
/*
|
|
|
|
**TrueType fonts with native bytecode hinting**
|
|
|
|
*
|
|
|
|
* All applications that handle TrueType fonts with native hinting must
|
|
|
|
* be aware that TTFs expect different rounding of vertical font
|
|
|
|
* dimensions. The application has to cater for this, especially if it
|
|
|
|
* wants to rely on a TTF's vertical data (for example, to properly align
|
|
|
|
* box characters vertically).
|
2021-08-28 20:22:01 +08:00
|
|
|
* - Since freetype-2.8.1 TureType matrics isn't sync to size_matrics
|
2021-08-28 18:24:17 +08:00
|
|
|
* - By default it's enabled for compatible with cocos2d-x-4.0 or older with freetype-2.5.5
|
|
|
|
* - Please see freetype.h
|
|
|
|
* */
|
|
|
|
static void setNativeBytecodeHintingEnabled(bool bEnabled) { _doNativeBytecodeHinting = bEnabled; }
|
|
|
|
static bool isNativeBytecodeHintingEnabled() { return _doNativeBytecodeHinting; }
|
|
|
|
|
|
|
|
bool isDistanceFieldEnabled() const { return _distanceFieldEnabled; }
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
float getOutlineSize() const { return _outlineSize; }
|
|
|
|
|
2021-08-28 18:24:17 +08:00
|
|
|
void renderCharAt(unsigned char* dest,
|
|
|
|
int posX,
|
|
|
|
int posY,
|
|
|
|
unsigned char* bitmap,
|
2021-09-05 20:45:32 +08:00
|
|
|
int32_t bitmapWidth,
|
|
|
|
int32_t bitmapHeight);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
FT_Encoding getEncoding() const { return _encoding; }
|
|
|
|
|
2021-08-28 18:24:17 +08:00
|
|
|
int* getHorizontalKerningForTextUTF32(const std::u32string& text, int& outNumLetters) const override;
|
|
|
|
|
2021-12-25 10:04:45 +08:00
|
|
|
unsigned char* getGlyphBitmap(uint32_t theChar,
|
|
|
|
int32_t& outWidth,
|
|
|
|
int32_t& outHeight,
|
|
|
|
Rect& outRect,
|
|
|
|
int& xAdvance);
|
2021-08-28 18:24:17 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
int getFontAscender() const;
|
|
|
|
const char* getFontFamily() const;
|
2021-11-27 11:06:51 +08:00
|
|
|
const std::string& getFontName() const { return _fontName; }
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2021-11-11 17:20:21 +08:00
|
|
|
virtual FontAtlas* newFontAtlas() override;
|
2019-11-23 20:27:39 +08:00
|
|
|
virtual int getFontMaxHeight() const override { return _lineHeight; }
|
|
|
|
|
2021-08-28 18:24:17 +08:00
|
|
|
static void releaseFont(const std::string& fontName);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2021-11-16 18:41:18 +08:00
|
|
|
static FT_Library getFTLibrary();
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
private:
|
|
|
|
static FT_Library _FTlibrary;
|
|
|
|
static bool _FTInitialized;
|
2020-08-27 11:40:44 +08:00
|
|
|
static bool _streamParsingEnabled;
|
2021-08-28 18:24:17 +08:00
|
|
|
static bool _doNativeBytecodeHinting;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
FontFreeType(bool distanceFieldEnabled = false, float outline = 0);
|
|
|
|
virtual ~FontFreeType();
|
|
|
|
|
2021-11-27 11:06:51 +08:00
|
|
|
bool loadFontFace(std::string_view fontName, float fontSize);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2021-11-16 18:41:18 +08:00
|
|
|
static bool initFreeType();
|
2021-08-28 18:24:17 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
int getHorizontalKerningForChars(uint64_t firstChar, uint64_t secondChar) const;
|
2021-11-11 15:56:07 +08:00
|
|
|
unsigned char* getGlyphBitmapWithOutline(unsigned int glyphIndex, FT_BBox& bbox);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2021-11-27 11:06:51 +08:00
|
|
|
void setGlyphCollection(GlyphCollection glyphs, std::string_view customGlyphs);
|
|
|
|
std::string_view getGlyphCollection() const;
|
2021-08-28 18:24:17 +08:00
|
|
|
|
2021-11-11 15:56:07 +08:00
|
|
|
FT_Face _fontFace;
|
2020-08-27 11:35:55 +08:00
|
|
|
std::unique_ptr<FT_StreamRec> _fontStream;
|
2019-11-23 20:27:39 +08:00
|
|
|
FT_Stroker _stroker;
|
|
|
|
FT_Encoding _encoding;
|
|
|
|
|
|
|
|
std::string _fontName;
|
2021-11-16 18:41:18 +08:00
|
|
|
float _fontSize;
|
2019-11-23 20:27:39 +08:00
|
|
|
bool _distanceFieldEnabled;
|
|
|
|
float _outlineSize;
|
2021-08-28 18:24:17 +08:00
|
|
|
int _ascender;
|
|
|
|
int _descender;
|
2019-11-23 20:27:39 +08:00
|
|
|
int _lineHeight;
|
|
|
|
|
|
|
|
GlyphCollection _usedGlyphs;
|
|
|
|
std::string _customGlyphs;
|
|
|
|
};
|
|
|
|
|
|
|
|
/// @endcond
|
|
|
|
|
|
|
|
NS_CC_END
|
|
|
|
|
|
|
|
#endif
|