1 #ifndef DALI_INTERNAL_TEXT_ABSTRACTION_FONT_CLIENT_IMPL_H
2 #define DALI_INTERNAL_TEXT_ABSTRACTION_FONT_CLIENT_IMPL_H
5 * Copyright (c) 2019 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
22 #include <dali/public-api/object/base-object.h>
25 #include <dali/devel-api/text-abstraction/font-client.h>
33 namespace TextAbstraction
40 * Implementation of the FontClient
42 class FontClient : public BaseObject
57 * @copydoc Dali::TextAbstraction::FontClient::Get()
59 static Dali::TextAbstraction::FontClient Get();
62 * @copydoc Dali::TextAbstraction::FontClient::ClearCache()
67 * @copydoc Dali::TextAbstraction::FontClient::SetDpi()
69 void SetDpi( unsigned int horizontalDpi, unsigned int verticalDpi );
72 * @copydoc Dali::TextAbstraction::FontClient::GetDpi()
74 void GetDpi( unsigned int& horizontalDpi, unsigned int& verticalDpi );
77 * @copydoc Dali::TextAbstraction::FontClient::GetDefaultFontSize()
79 int GetDefaultFontSize();
82 * @copydoc Dali::TextAbstraction::FontClient::ResetSystemDefaults()
84 void ResetSystemDefaults();
87 * @copydoc Dali::TextAbstraction::FontClient::GetDefaultFonts()
89 void GetDefaultFonts( FontList& defaultFonts );
92 * @copydoc Dali::TextAbstraction::FontClient::GetDefaultPlatformFontDescription()
94 void GetDefaultPlatformFontDescription( FontDescription& fontDescription );
97 * @copydoc Dali::TextAbstraction::FontClient::GetSystemFonts()
99 void GetSystemFonts( FontList& systemFonts );
102 * @copydoc Dali::TextAbstraction::FontClient::GetDescription()
104 void GetDescription( FontId id, FontDescription& fontDescription );
107 * @copydoc Dali::TextAbstraction::FontClient::GetPointSize()
109 PointSize26Dot6 GetPointSize( FontId id );
112 * @copydoc Dali::TextAbstraction::FontClient::IsCharacterSupportedByFont()
114 bool IsCharacterSupportedByFont( FontId fontId, Character character );
117 * @copydoc Dali::TextAbstraction::FontClient::FindDefaultFont()
119 FontId FindDefaultFont( Character charcode,
120 PointSize26Dot6 requestedPointSize,
124 * @copydoc Dali::TextAbstraction::FontClient::FindFallbackFont()
126 FontId FindFallbackFont( Character charcode,
127 const FontDescription& preferredFontDescription,
128 PointSize26Dot6 requestedPointSize,
132 * @copydoc Dali::TextAbstraction::FontClient::GetFontId( const FontPath& path, PointSize26Dot6 requestedPointSize, FaceIndex faceIndex )
134 FontId GetFontId( const FontPath& path, PointSize26Dot6 requestedPointSize, FaceIndex faceIndex );
137 * @copydoc Dali::TextAbstraction::FontClient::GetFontId( const FontDescription& fontDescription, PointSize26Dot6 requestedPointSize, FaceIndex faceIndex )
139 FontId GetFontId( const FontDescription& fontDescription,
140 PointSize26Dot6 requestedPointSize,
141 FaceIndex faceIndex );
144 * @copydoc Dali::TextAbstraction::FontClient::GetFontId( const BitmapFont& bitmapFont )
146 FontId GetFontId( const BitmapFont& bitmapFont );
149 * @copydoc Dali::TextAbstraction::FontClient::IsScalable( const FontPath& path )
151 bool IsScalable( const FontPath& path );
154 * @copydoc Dali::TextAbstraction::FontClient::IsScalable( const FontDescription& fontDescription )
156 bool IsScalable( const FontDescription& fontDescription );
159 * @copydoc Dali::TextAbstraction::FontClient::GetFixedSizes( const FontPath& path, Dali::Vector< PointSize26Dot6>& sizes )
161 void GetFixedSizes( const FontPath& path, Dali::Vector< PointSize26Dot6>& sizes );
164 * @copydoc Dali::TextAbstraction::FontClient::GetFixedSizes()
166 void GetFixedSizes( const FontDescription& fontDescription,
167 Dali::Vector< PointSize26Dot6 >& sizes );
170 * @copydoc Dali::TextAbstraction::FontClient::HasItalicStyle()
172 bool HasItalicStyle( FontId fontId ) const;
175 * @copydoc Dali::TextAbstraction::FontClient::GetFontMetrics()
177 void GetFontMetrics( FontId fontId, FontMetrics& metrics );
180 * @copydoc Dali::TextAbstraction::FontClient::GetGlyphIndex()
182 GlyphIndex GetGlyphIndex( FontId fontId, Character charcode );
185 * @copydoc Dali::TextAbstraction::FontClient::GetGlyphMetrics()
187 bool GetGlyphMetrics( GlyphInfo* array, uint32_t size, GlyphType type, bool horizontal );
190 * @copydoc Dali::TextAbstraction::FontClient::CreateBitmap( FontId fontId, GlyphIndex glyphIndex, bool isItalicRequired, bool isBoldRequired, Dali::TextAbstraction::FontClient::GlyphBufferData& data, int outlineWidth )
192 void CreateBitmap( FontId fontId, GlyphIndex glyphIndex, bool isItalicRequired, bool isBoldRequired, Dali::TextAbstraction::FontClient::GlyphBufferData& data, int outlineWidth );
195 * @copydoc Dali::TextAbstraction::FontClient::CreateBitmap( FontId fontId, GlyphIndex glyphIndex, int outlineWidth )
197 PixelData CreateBitmap( FontId fontId, GlyphIndex glyphIndex, int outlineWidth );
200 * @copydoc Dali::TextAbstraction::FontClient::CreateVectorBlob()
202 void CreateVectorBlob( FontId fontId, GlyphIndex glyphIndex, VectorBlob*& blob, unsigned int& blobLength, unsigned int& nominalWidth, unsigned int& nominalHeight );
205 * @copydoc Dali::TextAbstraction::FontClient::GetEllipsisGlyph()
207 const GlyphInfo& GetEllipsisGlyph( PointSize26Dot6 requestedPointSize );
210 * @copydoc Dali::TextAbstraction::FontClient::IsColorGlyph()
212 bool IsColorGlyph( FontId fontId, GlyphIndex glyphIndex );
215 * @copydoc Dali::TextAbstraction::FontClient::CreateEmbeddedItem()
217 GlyphIndex CreateEmbeddedItem( const TextAbstraction::FontClient::EmbeddedItemDescription& description, Pixel::Format& pixelFormat );
220 * @brief Retrieves the pointer to the FreeType Font Face for the given @p fontId.
222 * @param[in] fontId The font id.
224 * @return The pointer to the FreeType Font Face.
226 FT_FaceRec_* GetFreetypeFace( FontId fontId );
229 * @brief Retrieves the type of font.
231 * @param[in] fontId The font id.
233 * @return FACE_FONT if the font has been loaded by FreeType, BITMAP_FONT if it's a font that has been loaded from images or INVALID if it's a non valid font.
235 FontDescription::Type GetFontType( FontId fontId );
238 * @copydoc Dali::TextAbstraction::FontClient::AddCustomFontDirectory()
240 bool AddCustomFontDirectory( const FontPath& path );
245 * Helper for lazy initialization.
249 // Undefined copy constructor.
250 FontClient( const FontClient& );
252 // Undefined assignment constructor.
253 FontClient& operator=( const FontClient& );
260 // Allows DPI to be set without loading plugin
261 unsigned int mDpiHorizontal;
262 unsigned int mDpiVertical;
264 }; // class FontClient
266 } // namespace Internal
268 inline static Internal::FontClient& GetImplementation(FontClient& fontClient)
270 DALI_ASSERT_ALWAYS( fontClient && "fontClient handle is empty" );
271 BaseObject& handle = fontClient.GetBaseObject();
272 return static_cast<Internal::FontClient&>(handle);
275 inline static const Internal::FontClient& GetImplementation(const FontClient& fontClient)
277 DALI_ASSERT_ALWAYS( fontClient && "fontClient handle is empty" );
278 const BaseObject& handle = fontClient.GetBaseObject();
279 return static_cast<const Internal::FontClient&>(handle);
282 } // namespace TextAbstraction
286 #endif // DALI_INTERNAL_TEXT_ABSTRACTION_FONT_CLIENT_IMPL_H