App:Library:LVGL:docs:3rd party libraries:FreeType support

提供: robot-jp wiki
ナビゲーションに移動検索に移動

https://docs.lvgl.io/8.2/libs/freetype.html

FreeType support

Interface to FreeType to generate font bitmaps run time.

Install FreeType

英文 自動翻訳
  • Download Freetype from here
  • make
  • sudo make install
  • ここからFreetypeをダウンロードします
  • make
  • sudo make install


Add FreeType to your project

英文 自動翻訳
  • Add include path: /usr/include/freetype2 (for GCC: -I/usr/include/freetype2 -L/usr/local/lib)
  • Add library: freetype (for GCC: -L/usr/local/lib -lfreetype)
  • インクルードパスを追加: /usr/include/freetype2(GCCの場合-I/usr/include/freetype2 -L/usr/local/lib:)
  • ライブラリを追加: freetype(GCCの場合-L/usr/local/lib -lfreetype:)


Usage

英文 自動翻訳

Enable LV_USE_FREETYPE in lv_conf.h.

To cache the glyphs from the opened fonts, set LV_FREETYPE_CACHE_SIZE >= 0 and then use the following macros for detailed configuration:

  1. LV_FREETYPE_CACHE_SIZE:maximum memory(bytes) used to cache font bitmap, outline, character maps, etc. 0 means use the system default value, less than 0 means disable cache. Note: that this value does not account for managed FT_Face and FT_Size objects.
  2. LV_FREETYPE_CACHE_FT_FACES:maximum number of opened FT_Face objects managed by this cache instance.0 means use the system default value. Only useful when LV_FREETYPE_CACHE_SIZE >= 0.
  3. LV_FREETYPE_CACHE_FT_SIZES:maximum number of opened FT_Size objects managed by this cache instance. 0 means use the system default value. Only useful when LV_FREETYPE_CACHE_SIZE >= 0.


When you are sure that all the used font sizes will not be greater than 256, you can enable LV_FREETYPE_SBIT_CACHE, which is much more memory efficient for small bitmaps.

You can use lv_ft_font_init() to create FreeType fonts. It returns true to indicate success, at the same time, the font member of lv_ft_info_t will be filled with a pointer to an LVGL font, and you can use it like any LVGL font.

Font style supports bold and italic, you can use the following macros to set:

  1. FT_FONT_STYLE_NORMAL:default style.
  2. FT_FONT_STYLE_ITALIC:Italic style
  3. FT_FONT_STYLE_BOLD:bold style


They can be combined.eg:FT_FONT_STYLE_BOLD | FT_FONT_STYLE_ITALIC.

Note that, the FreeType extension doesn't use LVGL's file system. You can simply pass the path to the font as usual on your operating system or platform.

lv_conf.h で LV_USE_FREETYPE を有効化します。


開いているフォントのグリフをキャッシュするには、LV_FREETYPE_CACHE_SIZE >= 0 に設定した後、以下のマクロで詳細な設定を行います。

  1. LV_FREETYPE_CACHE_SIZE：フォントビットマップ、アウトライン、文字コード表などをキャッシュするために使用される最大メモリ（バイト）。0はシステムのデフォルト値を使用することを意味し、0未満はキャッシュを無効にすることを意味します。注：この値は、管理対象のFT_FaceおよびFT_Sizeオブジェクトを考慮していないことに注意してください。
  2. LV_FREETYPE_CACHE_FT_FACES：このキャッシュインスタンスによって管理される開かれたFT_Faceオブジェクトの最大数。0は、システムのデフォルト値を使用することを意味します。LV_FREETYPE_CACHE_SIZE>=0の場合にのみ役立ちます。
  3. LV_FREETYPE_CACHE_FT_SIZES：このキャッシュインスタンスによって管理される、開かれたFT_Sizeオブジェクトの最大数。0は、システムのデフォルト値を使用することを意味します。LV_FREETYPE_CACHE_SIZE>=0の場合にのみ役立ちます。


使用するフォントサイズがすべて256を超えないことが確実な場合は、LV_FREETYPE_SBIT_CACHEを有効にすると、小さなビットマップに対してより高いメモリ効率を実現することができます。


lv_ft_font_init() を使用すると、FreeType フォントを作成することができます。これは成功を示すtrueを返し、同時にlv_ft_info_t の fontメンバに LVGL フォントへのポインタが格納され、他の LVGL フォントと同様に使用できるようになります。

フォントスタイルは太字と斜体をサポートしています。次のマクロを使用して設定できます。

  1. FT_FONT_STYLE_NORMAL：デフォルトのスタイル。
  2. FT_FONT_STYLE_ITALIC：斜体
  3. FT_FONT_STYLE_BOLD：太字スタイル


これらは組み合わせることができます。例：FT_FONT_STYLE_BOLD | FT_FONT_STYLE_ITALIC。


FreeType拡張は、LVGLのファイルシステムを使用しないことに注意してください。あなたのオペレーティングシステムやプラットフォームで通常行われているように、単にフォントのパスを渡すことができます。


Example

英文 自動翻訳

Open a front with FreeType

LVGL docs 3rdPartyLibs FreeType 01.png


Learn more

英文 自動翻訳
  • FreeType tutorial
  • LVGL's font interface
  • FreeTypeチュートリアル
  • LVGLのフォントインターフェース


API

英文 自動翻訳

Enums

enum LV_FT_FONT_STYLE
Values:
enumerator FT_FONT_STYLE_NORMAL
enumerator FT_FONT_STYLE_ITALIC
enumerator FT_FONT_STYLE_BOLD

Functions

bool lv_freetype_init(uint16_t max_faces, uint16_t max_sizes, uint32_t max_bytes)
init freetype library
Parameters
  • max_faces -- Maximum number of opened FT_Face objects managed by this cache instance. Use 0 for defaults.
  • max_sizes -- Maximum number of opened FT_Size objects managed by this cache instance. Use 0 for defaults.
  • max_bytes -- Maximum number of bytes to use for cached data nodes. Use 0 for defaults. Note that this value does not account for managed FT_Face and FT_Size objects.
Returns
true on success, otherwise false.
void lv_freetype_destroy(void)
Destroy freetype library


bool lv_ft_font_init(lv_ft_info_t *info)
Creates a font with info parameter specified.
Parameters
info -- See lv_ft_info_t for details. when success, lv_ft_info_t->font point to the font you created.
Returns
true on success, otherwise false.
void lv_ft_font_destroy(lv_font_t *font)
Destroy a font that has been created.
Parameters
font -- pointer to font.
struct lv_ft_info_t
Public Members
const char *name
const void *mem
size_t mem_size
lv_font_t *font
uint16_t weight
uint16_t style


列挙型

列挙型LV_FT_FONT_STYLE
値：
列挙子FT_FONT_STYLE_NORMAL
列挙子FT_FONT_STYLE_ITALIC
列挙子FT_FONT_STYLE_BOLD

機能

bool lv_freetype_init（uint16_t max_faces、uint16_t max_sizes、uint32_t max_bytes）
initfreetypeライブラリ
パラメーター
  • max_faces-このキャッシュインスタンスによって管理される開かれたFT_Faceオブジェクトの最大数。デフォルトには0を使用します。
  • max_sizes-このキャッシュインスタンスによって管理される開かれたFT_Sizeオブジェクトの最大数。デフォルトには0を使用します。
  • max_bytes-キャッシュされたデータノードに使用する最大バイト数。デフォルトには0を使用します。この値は、管理対象のFT_FaceオブジェクトとFT_Sizeオブジェクトを考慮していないことに注意してください。
戻り値
成功した場合はtrue、それ以外の場合はfalse。
void lv_freetype_destroy（void）
FreeTypeライブラリを破棄します
bool lv_ft_font_init（lv_ft_info_t * info）
infoパラメータを指定してフォントを作成します。
パラメーター
info-詳細については、lv_ft_info_tを参照してください。成功すると、lv_ft_info_t->fontは作成したフォントを指します。
戻り値
成功した場合はtrue、それ以外の場合はfalse。
void lv_ft_font_destroy（lv_font_t * font）
作成されたフォントを破棄します。
パラメーター
font-フォントへのポインタ。
struct lv_ft_info_t
パブリックメンバー
const char * name
const void * mem
size_t mem_size
lv_font_t * font
uint16_tの重み
uint16_tスタイル


戻る : Previous
「https://robot-jp.com/wiki/index.php?title=App:Library:LVGL:docs:3rd_party_libraries:FreeType_support&oldid=3802」から取得