「App:Library:LVGL:docs:3rd party libraries:FreeType support」の版間の差分

提供: robot-jp wiki
ナビゲーションに移動検索に移動
(ページの作成:「https://docs.lvgl.io/8.2/libs/freetype.html __NOTOC__ {| class="wikitable" !英文 !自動翻訳 |- | | |} ---- :App:Library:LVGL:docs:3rd party libraries|戻…」)
 
 
(同じ利用者による、間の5版が非表示)
1行目: 1行目:
 
https://docs.lvgl.io/8.2/libs/freetype.html
 
https://docs.lvgl.io/8.2/libs/freetype.html
 
__NOTOC__
 
__NOTOC__
 +
= FreeType support =
 +
Interface to FreeType to generate font bitmaps run time.
 +
 +
== Install FreeType ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
* Download Freetype from here
 +
* <code style="color: #bb0000;">make</code>
 +
* <code style="color: #bb0000;">sudo make install</code>
 +
|
 +
* ここからFreetypeをダウンロードします
 +
* <code style="color: #bb0000;">make</code>
 +
* <code style="color: #bb0000;">sudo make install</code>
 +
|}
 +
 +
 +
== Add FreeType to your project ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
* Add include path: <code style="color: #bb0000;">/usr/include/freetype2</code> (for GCC: <code style="color: #bb0000;">-I/usr/include/freetype2 -L/usr/local/lib</code>)
 +
* Add library: <code style="color: #bb0000;">freetype</code> (for GCC: <code style="color: #bb0000;">-L/usr/local/lib -lfreetype</code>)
 +
|
 +
* インクルードパスを追加: <code style="color: #bb0000;">/usr/include/freetype2</code>(GCCの場合<code style="color: #bb0000;">-I/usr/include/freetype2 -L/usr/local/lib</code>:)
 +
* ライブラリを追加: <code style="color: #bb0000;">freetype</code>(GCCの場合<code style="color: #bb0000;">-L/usr/local/lib -lfreetype</code>:)
 +
|}
 +
 +
 +
== Usage ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
Enable <code style="color: #bb0000;">LV_USE_FREETYPE</code> in <code style="color: #bb0000;">lv_conf.h</code>.
 +
 +
To cache the glyphs from the opened fonts, set <code style="color: #bb0000;">LV_FREETYPE_CACHE_SIZE >= 0</code> and then use the following macros for detailed configuration:
 +
 +
# <code style="color: #bb0000;">LV_FREETYPE_CACHE_SIZE</code>: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.
 +
# <code style="color: #bb0000;">LV_FREETYPE_CACHE_FT_FACES</code>: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.
 +
# <code style="color: #bb0000;">LV_FREETYPE_CACHE_FT_SIZES</code>: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 <code style="color: #bb0000;">LV_FREETYPE_SBIT_CACHE</code>, which is much more memory efficient for small bitmaps.
 +
 +
You can use <code style="color: #bb0000;">lv_ft_font_init()</code> to create FreeType fonts. It returns <code style="color: #bb0000;">true</code> to indicate success, at the same time, the <code style="color: #bb0000;">font</code> member of <code style="color: #bb0000;">lv_ft_info_t</code> 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:
 +
 +
# <code style="color: #bb0000;">FT_FONT_STYLE_NORMAL</code>:default style.
 +
# <code style="color: #bb0000;">FT_FONT_STYLE_ITALIC</code>:Italic style
 +
# <code style="color: #bb0000;">FT_FONT_STYLE_BOLD</code>:bold style
 +
 +
 +
They can be combined.eg:<code style="color: #bb0000;">FT_FONT_STYLE_BOLD | FT_FONT_STYLE_ITALIC</code>.
 +
 +
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.
 +
|<code style="color: #bb0000;">lv_conf.h</code> で <code style="color: #bb0000;">LV_USE_FREETYPE</code> を有効化します。
 +
 +
 +
開いているフォントのグリフをキャッシュするには、<code style="color: #bb0000;">LV_FREETYPE_CACHE_SIZE >= 0</code> に設定した後、以下のマクロで詳細な設定を行います。
 +
 +
# <code style="color: #bb0000;">LV_FREETYPE_CACHE_SIZE</code>：フォントビットマップ、アウトライン、文字コード表などをキャッシュするために使用される最大メモリ（バイト）。0はシステムのデフォルト値を使用することを意味し、0未満はキャッシュを無効にすることを意味します。注：この値は、管理対象のFT_FaceおよびFT_Sizeオブジェクトを考慮していないことに注意してください。
 +
# <code style="color: #bb0000;">LV_FREETYPE_CACHE_FT_FACES</code>：このキャッシュインスタンスによって管理される開かれたFT_Faceオブジェクトの最大数。0は、システムのデフォルト値を使用することを意味します。LV_FREETYPE_CACHE_SIZE>=0の場合にのみ役立ちます。
 +
# <code style="color: #bb0000;">LV_FREETYPE_CACHE_FT_SIZES</code>：このキャッシュインスタンスによって管理される、開かれたFT_Sizeオブジェクトの最大数。0は、システムのデフォルト値を使用することを意味します。LV_FREETYPE_CACHE_SIZE>=0の場合にのみ役立ちます。
 +
 +
 +
使用するフォントサイズがすべて256を超えないことが確実な場合は、<code style="color: #bb0000;">LV_FREETYPE_SBIT_CACHE</code>を有効にすると、小さなビットマップに対してより高いメモリ効率を実現することができます。
 +
 +
 +
<code style="color: #bb0000;">lv_ft_font_init()</code> を使用すると、FreeType フォントを作成することができます。これは成功を示す<code style="color: #bb0000;">true</code>を返し、同時に<code style="color: #bb0000;">lv_ft_info_t</code> の <code style="color: #bb0000;">font</code>メンバに LVGL フォントへのポインタが格納され、他の LVGL フォントと同様に使用できるようになります。
 +
 +
フォントスタイルは太字と斜体をサポートしています。次のマクロを使用して設定できます。
 +
 +
# <code style="color: #bb0000;">FT_FONT_STYLE_NORMAL</code>：デフォルトのスタイル。
 +
# <code style="color: #bb0000;">FT_FONT_STYLE_ITALIC</code>：斜体
 +
# <code style="color: #bb0000;">FT_FONT_STYLE_BOLD</code>：太字スタイル
 +
 +
 +
これらは組み合わせることができます。例：<code style="color: #bb0000;">FT_FONT_STYLE_BOLD | FT_FONT_STYLE_ITALIC</code>。
 +
 +
 +
FreeType拡張は、LVGLのファイルシステムを使用しないことに注意してください。あなたのオペレーティングシステムやプラットフォームで通常行われているように、単にフォントのパスを渡すことができます。
 +
|}
 +
 +
 +
== Example ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
=== Open a front with FreeType ===
 +
[[file:LVGL docs 3rdPartyLibs FreeType 01.png|link=https://docs.lvgl.io/8.2/libs/freetype.html#open-a-front-with-freetype]]
 +
|
 +
|}
 +
 +
 +
== Learn more ==
 
{| class="wikitable"
 
{| class="wikitable"
 
!英文
 
!英文
6行目: 110行目:
 
|-
 
|-
 
|
 
|
 +
* FreeType tutorial
 +
* LVGL's font interface
 
|
 
|
 +
* FreeTypeチュートリアル
 +
* LVGLのフォントインターフェース
 
|}
 
|}
  
  
 +
== API ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
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スタイル
 +
|}
  
  
  
−
----
 
 
:[[App:Library:LVGL:docs:3rd party libraries|戻る : Previous]]
 
:[[App:Library:LVGL:docs:3rd party libraries|戻る : Previous]]

2022年6月29日 (水) 16:59時点における最新版

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」から取得