「App:Library:LVGL:docs:Overview:Colors」の版間の差分
(ページの作成:「https://docs.lvgl.io/8.2/overview/style.html __NOTOC__ {| class="wikitable" !英文 !自動翻訳 |- | | |} :戻る : Previous」) |
|||
(同じ利用者による、間の8版が非表示) | |||
1行目: | 1行目: | ||
− | https://docs.lvgl.io/8.2/overview/ | + | https://docs.lvgl.io/8.2/overview/color.html |
__NOTOC__ | __NOTOC__ | ||
+ | = Colors = | ||
{| class="wikitable" | {| class="wikitable" | ||
!英文 | !英文 | ||
6行目: | 7行目: | ||
|- | |- | ||
| | | | ||
+ | The color module handles all color-related functions like changing color depth, creating colors from hex code, converting between color depths, mixing colors, etc. | ||
+ | |||
+ | The type <code style="color: #bb0000;">lv_color_t</code> is used to store a color. Its fields are set according to <code style="color: #bb0000;">LV_COLOR_DEPTH</code> in <code style="color: #bb0000;">lv_conf.h</code>. (See below) | ||
+ | |||
+ | |||
+ | You may set <code style="color: #bb0000;">LV_COLOR_16_SWAP</code> in <code style="color: #bb0000;">lv_conf.h</code> to swap bytes of ''RGB565'' colors. | ||
+ | |||
+ | |||
+ | You may need this when sending 16-bit colors via a byte-oriented interface like SPI. | ||
+ | |||
+ | As 16-bit numbers are stored in little-endian format (lower byte at the lower address), the interface will send the lower byte first. | ||
+ | |||
+ | |||
+ | However, displays usually need the higher byte first. | ||
+ | |||
+ | A mismatch in the byte order will result in highly distorted colors. | ||
+ | |カラーモジュールは、色深度の変更、16進コードからの色の作成、色深度間の変換、色の混合など、すべての色関連機能を処理します。 | ||
+ | |||
+ | タイプ <code style="color: #bb0000;">lv_color_t</code> は、色を格納するために使用されます。 そのフィールドは<code style="color: #bb0000;">lv_conf.h</code>の <code style="color: #bb0000;">LV_COLOR_DEPTH</code> に従って設定されます。(下記参照) | ||
+ | |||
+ | |||
+ | <code style="color: #bb0000;">lv_conf.h</code>で <code style="color: #bb0000;">LV_COLOR_16_SWAP</code> 設定して、RGB565色のバイトを交換できます。 | ||
+ | |||
+ | |||
+ | SPIのようなバイト指向のインターフェースを介して16ビットカラーを送信する場合にこれが必要になることがあります。 | ||
+ | |||
+ | 16ビットの数値はリトルエンディアン形式(下位アドレスの下位バイト)で格納されるため、インターフェイスは下位バイトを最初に送信します。 | ||
+ | |||
+ | |||
+ | ただし、通常、ディスプレイには最初に上位バイトが必要です。 | ||
+ | |||
+ | バイト順序の不一致は、非常に歪んだ色になります。 | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | == Creating colors == | ||
+ | === RGB === | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | Create colors from Red, Green and Blue channel values: | ||
+ | <syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | //All channels are 0-255 | ||
+ | lv_color_t c = lv_color_make(red, green, blue); | ||
+ | |||
+ | //From hex code 0x000000..0xFFFFFF interpreted as RED + GREEN + BLUE | ||
+ | lv_color_t c = lv_color_hex(0x123456); | ||
+ | |||
+ | //From 3 digits. Same as lv_color_hex(0x112233) | ||
+ | lv_color_t c = lv_color_hex3(0x123); | ||
+ | </syntaxhighlight> | ||
+ | |赤、緑、青のチャンネル値から色を作成します。 | ||
+ | <syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | //All channels are 0-255 | ||
+ | lv_color_t c = lv_color_make(red, green, blue); | ||
+ | |||
+ | //From hex code 0x000000..0xFFFFFF interpreted as RED + GREEN + BLUE | ||
+ | lv_color_t c = lv_color_hex(0x123456); | ||
+ | |||
+ | //From 3 digits. Same as lv_color_hex(0x112233) | ||
+ | lv_color_t c = lv_color_hex3(0x123); | ||
+ | </syntaxhighlight> | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | === HSV === | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | Create colors from Hue, Saturation and Value values: | ||
+ | <syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | //h = 0..359, s = 0..100, v = 0..100 | ||
+ | lv_color_t c = lv_color_hsv_to_rgb(h, s, v); | ||
+ | |||
+ | //All channels are 0-255 | ||
+ | lv_color_hsv_t c_hsv = lv_color_rgb_to_hsv(r, g, b); | ||
+ | |||
+ | |||
+ | //From lv_color_t variable | ||
+ | lv_color_hsv_t c_hsv = lv_color_to_hsv(color); | ||
+ | </syntaxhighlight> | ||
+ | |色相、彩度、値の値から色を作成します。 | ||
+ | <syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | //h = 0..359, s = 0..100, v = 0..100 | ||
+ | lv_color_t c = lv_color_hsv_to_rgb(h, s, v); | ||
+ | |||
+ | //All channels are 0-255 | ||
+ | lv_color_hsv_t c_hsv = lv_color_rgb_to_hsv(r, g, b); | ||
+ | |||
+ | |||
+ | //From lv_color_t variable | ||
+ | lv_color_hsv_t c_hsv = lv_color_to_hsv(color); | ||
+ | </syntaxhighlight> | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | === Palette === | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | LVGL includes Material Design's palette of colors. | ||
+ | |||
+ | In this system all named colors have a nominal main color as well as four darker and five lighter variants. | ||
+ | |||
+ | The names of the colors are as follows: | ||
+ | |||
+ | * <code style="color: #bb0000;">LV_PALETTE_RED</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_PINK</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_PURPLE</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_DEEP_PURPLE</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_INDIGO</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_BLUE</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_LIGHT_BLUE</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_CYAN</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_TEAL</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_GREEN</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_LIGHT_GREEN</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_LIME</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_YELLOW</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_AMBER</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_ORANGE</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_DEEP_ORANGE</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_BROWN</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_BLUE_GREY</code> | ||
+ | * <code style="color: #bb0000;">LV_PALETTE_GREY</code> | ||
+ | |||
+ | To get the main color use <code style="color: #bb0000;">lv_color_t c = lv_palette_main(LV_PALETTE_...)</code>. | ||
+ | |||
+ | |||
+ | For the lighter variants of a palette color use <code style="color: #bb0000;">lv_color_t c = lv_palette_lighten(LV_PALETTE_..., v)</code>. | ||
+ | |||
+ | |||
+ | <code style="color: #bb0000;">v</code> can be 1..5. | ||
+ | |||
+ | |||
+ | For the darker variants of a palette color use <code style="color: #bb0000;">lv_color_t c = lv_palette_darken(LV_PALETTE_..., v)</code>. | ||
+ | |||
+ | |||
+ | <code style="color: #bb0000;">v</code> can be 1..4. | ||
+ | |LVGLには、マテリアルデザインの色のパレットが含まれています。 | ||
+ | |||
+ | このシステムでは、すべての名前の付いた色に、名目上のメインカラーと、4つの暗い色と5つの明るい色があります。 | ||
+ | |||
+ | 色の名前は次のとおりです。 | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_RED</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_PINK</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_PURPLE</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_DEEP_PURPLE</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_INDIGO</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_BLUE</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_LIGHT_BLUE</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_CYAN</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_TEAL</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_GREEN</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_LIGHT_GREEN</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_LIME</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_YELLOW</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_AMBER</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_ORANGE</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_DEEP_ORANGE</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_BROWN</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_BLUE_GREY</code> | ||
+ | *<code style="color: #bb0000;">LV_PALETTE_GREY</code> | ||
+ | |||
+ | |||
+ | メインカラーを取得するには、<code style="color: #bb0000;">lv_color_t c = lv_palette_main(LV_PALETTE_...)</code>を使用します。 | ||
+ | |||
+ | |||
+ | パレットカラーの明るいバリエーションには、<code style="color: #bb0000;">lv_color_t c = lv_palette_lighten(LV_PALETTE_..., v)</code>を使用します。 | ||
+ | |||
+ | |||
+ | <code style="color: #bb0000;">v</code> は1..5にすることができます。 | ||
+ | |||
+ | |||
+ | パレットカラーの暗いバリエーションには、<code style="color: #bb0000;">lv_color_t c = lv_palette_darken(LV_PALETTE_..., v)</code>)を使用します。 | ||
+ | |||
+ | |||
+ | <code style="color: #bb0000;">v</code> は1..4にすることができます。 | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | === Modify and mix colors === | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | The following functions can modify a color: | ||
+ | <syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | // Lighten a color. 0: no change, 255: white | ||
+ | lv_color_t c = lv_color_lighten(c, lvl); | ||
+ | |||
+ | // Darken a color. 0: no change, 255: black | ||
+ | lv_color_t c = lv_color_darken(lv_color_t c, lv_opa_t lvl); | ||
+ | |||
+ | // Lighten or darken a color. 0: black, 128: no change 255: white | ||
+ | lv_color_t c = lv_color_change_lightness(lv_color_t c, lv_opa_t lvl); | ||
+ | |||
+ | |||
+ | // Mix two colors with a given ratio 0: full c2, 255: full c1, 128: half c1 and half c2 | ||
+ | lv_color_t c = lv_color_mix(c1, c2, ratio); | ||
+ | </syntaxhighlight> | ||
+ | |次の関数で色を変更できます。 | ||
+ | <syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | // Lighten a color. 0: no change, 255: white | ||
+ | lv_color_t c = lv_color_lighten(c, lvl); | ||
+ | |||
+ | // Darken a color. 0: no change, 255: black | ||
+ | lv_color_t c = lv_color_darken(lv_color_t c, lv_opa_t lvl); | ||
+ | |||
+ | // Lighten or darken a color. 0: black, 128: no change 255: white | ||
+ | lv_color_t c = lv_color_change_lightness(lv_color_t c, lv_opa_t lvl); | ||
+ | |||
+ | |||
+ | // Mix two colors with a given ratio 0: full c2, 255: full c1, 128: half c1 and half c2 | ||
+ | lv_color_t c = lv_color_mix(c1, c2, ratio); | ||
+ | </syntaxhighlight> | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | === Built-in colors === | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
| | | | ||
+ | <code style="color: #bb0000;">lv_color_white()</code> and <code style="color: #bb0000;">lv_color_black()</code> return <code style="color: #bb0000;">0xFFFFFF</code> and <code style="color: #bb0000;">0x000000</code> respectively. | ||
+ | |<code style="color: #bb0000;">lv_color_white()</code> と <code style="color: #bb0000;">lv_color_black()</code> は、それぞれ <code style="color: #bb0000;">0xFFFFFF</code> と <code style="color: #bb0000;">0x000000</code> を返します。 | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | == Opacity == | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | To describe opacity the <code style="color: #bb0000;">lv_opa_t</code> type is created from <code style="color: #bb0000;">uint8_t</code>. | ||
+ | |||
+ | Some special purpose defines are also introduced: | ||
+ | |||
+ | * <code style="color: #bb0000;">LV_OPA_TRANSP</code> Value: 0, means no opacity making the color completely transparent | ||
+ | * <code style="color: #bb0000;">LV_OPA_10</code> Value: 25, means the color covers only a little | ||
+ | * <code style="color: #bb0000;">LV_OPA_20 ... OPA_80</code> follow logically | ||
+ | * <code style="color: #bb0000;">LV_OPA_90</code> Value: 229, means the color near completely covers | ||
+ | * <code style="color: #bb0000;">LV_OPA_COVER</code> Value: 255, means the color completely covers (full opacity) | ||
+ | |||
+ | You can also use the <code style="color: #bb0000;">LV_OPA_*</code> defines in <code style="color: #bb0000;">lv_color_mix()</code> as a mixing ''ratio''. | ||
+ | |不透明度を説明するために、<code style="color: #bb0000;">lv_opa_t</code>タイプは<code style="color: #bb0000;">uint8_t</code>から作成されます。 | ||
+ | |||
+ | いくつかの特別な目的の定義も導入されています。 | ||
+ | *<code style="color: #bb0000;">LV_OPA_TRANSP</code> Value: 0, 不透明度なしを意味し、色は完全に透明になります。 | ||
+ | *<code style="color: #bb0000;">LV_OPA_10</code> Value: 25, 色が少ししか隠れないことを意味する。 | ||
+ | *<code style="color: #bb0000;">LV_OPA_20 ... OPA_80</code> 論理的に続く | ||
+ | *<code style="color: #bb0000;">LV_OPA_90</code> Value: 229, 完全に近い色であることを意味する。 | ||
+ | *<code style="color: #bb0000;">LV_OPA_COVER</code> Value: 255, 色が完全に隠れる(完全な不透明度)ことを意味します。 | ||
+ | |||
+ | |||
+ | 混合比として<code style="color: #bb0000;">lv_color_mix()</code>と定義されている<code style="color: #bb0000;">LV_OPA_*</code>を使用することもできます。 | ||
+ | |||
|} | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | == Color types == | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | The following variable types are defined by the color module: | ||
+ | |||
+ | * <code style="color: #bb0000;">lv_color1_t</code> Monochrome color. Also has R, G, B fields for compatibility but they are always the same value (1 byte) | ||
+ | * <code style="color: #bb0000;">lv_color8_t</code> A structure to store R (3 bit),G (3 bit),B (2 bit) components for 8-bit colors (1 byte) | ||
+ | * <code style="color: #bb0000;">lv_color16_t</code> A structure to store R (5 bit),G (6 bit),B (5 bit) components for 16-bit colors (2 byte) | ||
+ | * <code style="color: #bb0000;">lv_color32_t</code> A structure to store R (8 bit),G (8 bit), B (8 bit) components for 24-bit colors (4 byte) | ||
+ | * <code style="color: #bb0000;">lv_color_t</code> Equal to <code style="color: #bb0000;">lv_color1/8/16/24_t</code> depending on the configured color depth setting | ||
+ | * <code style="color: #bb0000;">lv_color_int_t</code> <code style="color: #bb0000;">uint8_t</code>, <code style="color: #bb0000;">uint16_t</code> or <code style="color: #bb0000;">uint32_t</code> depending on the color depth setting. Used to build color arrays from plain numbers. | ||
+ | * <code style="color: #bb0000;">lv_opa_t</code> A simple <code style="color: #bb0000;">uint8_t</code> type to describe opacity. | ||
+ | The <code style="color: #bb0000;">lv_color_t</code>, <code style="color: #bb0000;">lv_color1_t</code>, <code style="color: #bb0000;">lv_color8_t</code>, <code style="color: #bb0000;">lv_color16_t</code> and <code style="color: #bb0000;">lv_color32_t</code> types have four fields: | ||
+ | * <code style="color: #bb0000;">ch.red</code> red channel | ||
+ | * <code style="color: #bb0000;">ch.green</code> green channel | ||
+ | * <code style="color: #bb0000;">ch.blue</code> blue channel | ||
+ | * <code style="color: #bb0000;">full*</code> red + green + blue as one number | ||
+ | You can set the current color depth in ''lv_conf.h'', by setting the <code style="color: #bb0000;">LV_COLOR_DEPTH</code> define to 1 (monochrome), 8, 16 or 32. | ||
+ | |カラーモジュールでは以下の変数型が定義されている。 | ||
+ | *<code style="color: #bb0000;">lv_color1_t</code> モノクロの色。互換性のためにR, G, Bフィールドも持つが、常に同じ値(1バイト)である。 | ||
+ | *<code style="color: #bb0000;">lv_color8_t</code> 8 ビットカラーの R(3 bit),G(3 bit),B(2 bit) 成分を格納する構造体(1 byte)。 | ||
+ | *<code style="color: #bb0000;">lv_color16_t</code> 16 ビット色用の R(5 ビット),G(6 ビット),B(5 ビット)成分を格納する構造体(2 バイト) | ||
+ | *<code style="color: #bb0000;">lv_color32_t</code> 24 ビット色用の R(8 ビット),G(8 ビット),B(8 ビット) 成分を格納する構造体(4 バイト)。 | ||
+ | *<code style="color: #bb0000;">lv_color_t</code> 色深度の設定に応じて <code style="color: #bb0000;">lv_color1/8/16/24_t</code> に等しくなる。 | ||
+ | *<code style="color: #bb0000;">lv_color_int_t</code> <code style="color: #bb0000;">uint8_t</code>, <code style="color: #bb0000;">uint16_t</code> or <code style="color: #bb0000;">uint32_t</code> (色深度設定に依存)。プレーンな数値から色配列を構築するために使用される。 | ||
+ | *<code style="color: #bb0000;">lv_opa_t</code> 不透明度を表すためのシンプルな <code style="color: #bb0000;">uint8_t</code>型。 | ||
+ | <code style="color: #bb0000;">lv_color_t</code>, <code style="color: #bb0000;">lv_color1_t</code>, <code style="color: #bb0000;">lv_color8_t</code>, <code style="color: #bb0000;">lv_color16_t</code> , <code style="color: #bb0000;">lv_color32_t</code> 型は、4つのフィールドを持ちます。 | ||
+ | *<code style="color: #bb0000;">ch.red</code> 赤チャンネル | ||
+ | *<code style="color: #bb0000;">ch.green</code> 緑チャンネル | ||
+ | *<code style="color: #bb0000;">ch.blue</code> 青チャンネル | ||
+ | *<code style="color: #bb0000;">full*</code> 赤+緑+青を1つの数値で表す。 | ||
+ | |||
+ | |||
+ | <code style="color: #bb0000;">LV_COLOR_DEPTH</code> 定義に1(白黒)、8、16、32を設定することで、lv_conf.hで現在の色深度を設定することができます。 | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | === Convert color === | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | You can convert a color from the current color depth to another. | ||
+ | |||
+ | The converter functions return with a number, so you have to use the <code style="color: #bb0000;">full</code> field to map a converted color back into a structure: | ||
+ | <syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | lv_color_t c; | ||
+ | c.red = 0x38; | ||
+ | c.green = 0x70; | ||
+ | c.blue = 0xCC; | ||
+ | |||
+ | lv_color1_t c1; | ||
+ | c1.full = lv_color_to1(c); /*Return 1 for light colors, 0 for dark colors*/ | ||
+ | |||
+ | lv_color8_t c8; | ||
+ | c8.full = lv_color_to8(c); /*Give a 8 bit number with the converted color*/ | ||
+ | |||
+ | lv_color16_t c16; | ||
+ | c16.full = lv_color_to16(c); /*Give a 16 bit number with the converted color*/ | ||
+ | |||
+ | lv_color32_t c24; | ||
+ | c32.full = lv_color_to32(c); /*Give a 32 bit number with the converted color*/ | ||
+ | </syntaxhighlight> | ||
+ | |You can convert a color from the current color depth to another. | ||
+ | |||
+ | The converter functions return with a number, so you have to use the field to map a converted color back into a structure: | ||
+ | |||
+ | 現在の色深度から別の色に変換することができます。 | ||
+ | |||
+ | 変換関数は数値で返すので、変換された色を構造体にマッピングして戻すには、<code style="color: #bb0000;">full</code> フィールドを使用する必要があります。<syntaxhighlight lang="C++" style="border:1px dashed gray;"> | ||
+ | lv_color_t c; | ||
+ | c.red = 0x38; | ||
+ | c.green = 0x70; | ||
+ | c.blue = 0xCC; | ||
+ | |||
+ | lv_color1_t c1; | ||
+ | c1.full = lv_color_to1(c); /*Return 1 for light colors, 0 for dark colors*/ | ||
+ | |||
+ | lv_color8_t c8; | ||
+ | c8.full = lv_color_to8(c); /*Give a 8 bit number with the converted color*/ | ||
+ | |||
+ | lv_color16_t c16; | ||
+ | c16.full = lv_color_to16(c); /*Give a 16 bit number with the converted color*/ | ||
+ | |||
+ | lv_color32_t c24; | ||
+ | c32.full = lv_color_to32(c); /*Give a 32 bit number with the converted color*/ | ||
+ | </syntaxhighlight> | ||
+ | |} | ||
+ | :[[App:Library:LVGL:docs:Overview#Colors|戻る : Previous]] | ||
+ | |||
+ | |||
+ | == API == | ||
+ | {| class="wikitable" | ||
+ | !英文 | ||
+ | !自動翻訳 | ||
+ | |- | ||
+ | | | ||
+ | '''Typedefs''' | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef lv_color_t (*lv_color_filter_cb_t)(const struct _lv_color_filter_dsc_t*, lv_color_t, lv_opa_t) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef struct _lv_color_filter_dsc_t lv_color_filter_dsc_t </span> | ||
+ | : | ||
+ | |||
+ | '''Enums''' | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">enum [anonymous] </span> | ||
+ | : Opacity percentages. '''''Values''':'' | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_TRANSP </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_0 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_10 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_20 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_30 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_40 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_50 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_60 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_70 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_80 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_90 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_100 </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_OPA_COVER </span> | ||
+ | :: | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">enum lv_palette_t </span> | ||
+ | : '''''Values''':'' | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_RED </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_PINK </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_PURPLE </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_DEEP_PURPLE </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_INDIGO </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_BLUE </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_LIGHT_BLUE </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_CYAN </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_TEAL </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_GREEN </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_LIGHT_GREEN </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_LIME </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_YELLOW </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_AMBER </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_ORANGE </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_DEEP_ORANGE </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_BROWN </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_BLUE_GREY </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_GREY </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator _LV_PALETTE_LAST </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">enumerator LV_PALETTE_NONE </span> | ||
+ | :: | ||
+ | |||
+ | '''Functions''' | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_COLOR_DEPTH) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_COLOR_16_SWAP) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef LV_CONCAT3 (uint, LV_COLOR_SIZE, _t) lv_color_int_t</span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef LV_CONCAT3 (lv_color, LV_COLOR_DEPTH, _t) lv_color_t</span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint8_t lv_color_to1(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint8_t lv_color_to8(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint16_t lv_color_to16(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint32_t lv_color_to32(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint8_t lv_color_brightness(lv_color_t color) </span> | ||
+ | : Get the brightness of a color | ||
+ | : '''Parameters''' | ||
+ | :: '''color''' -- a color | ||
+ | : '''Returns''' | ||
+ | :: the brightness [0..255] | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_make(uint8_t r, uint8_t g, uint8_t b) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_hex(uint32_t c) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_hex3(uint32_t c) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_color_filter_dsc_init(lv_color_filter_dsc_t *dsc, lv_color_filter_cb_t cb) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_lighten(lv_color_t c, lv_opa_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_darken(lv_color_t c, lv_opa_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_change_lightness(lv_color_t c, lv_opa_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_hsv_to_rgb(uint16_t h, uint8_t s, uint8_t v) </span> | ||
+ | : Convert a HSV color to RGB | ||
+ | : '''Parameters''' | ||
+ | ::* '''h''' -- hue [0..359] | ||
+ | ::* '''s''' -- saturation [0..100] | ||
+ | ::* '''v''' -- value [0..100] | ||
+ | : '''Returns''' | ||
+ | :: the given RGB color in RGB (with LV_COLOR_DEPTH depth) | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_hsv_t lv_color_rgb_to_hsv(uint8_t r8, uint8_t g8, uint8_t b8) </span> | ||
+ | : Convert a 32-bit RGB color to HSV | ||
+ | : '''Parameters''' | ||
+ | ::* '''r8''' -- 8-bit red | ||
+ | ::* '''g8''' -- 8-bit green | ||
+ | ::* '''b8''' -- 8-bit blue | ||
+ | : '''Returns''' | ||
+ | :: the given RGB color in HSV | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_hsv_t lv_color_to_hsv(lv_color_t color) </span> | ||
+ | : Convert a color to HSV | ||
+ | : '''Parameters''' | ||
+ | :: '''color''' -- color | ||
+ | : '''Returns''' | ||
+ | :: the given color in HSV | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_chroma_key(void) </span> | ||
+ | : Just a wrapper around LV_COLOR_CHROMA_KEY because it might be more convenient to use a function is some cases | ||
+ | : '''Returns''' | ||
+ | :: LV_COLOR_CHROMA_KEY | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_palette_main(lv_palette_t p) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_white(void) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_black(void) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_palette_lighten(lv_palette_t p, uint8_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_palette_darken(lv_palette_t p, uint8_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color1_t </span> | ||
+ | : '''Public Members''' | ||
+ | : <span style="background-color: #eeeeee;">uint8_t full </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t blue </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t green </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t red </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">u<nowiki>nion lv_color1_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color8_t </span> | ||
+ | |||
+ | : '''Public Members''' | ||
+ | : <span style="background-color: #eeeeee;">uint8_t blue </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t green </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t red </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">s<nowiki>truct lv_color8_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t full </span> | ||
+ | :: | ||
+ | |||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color16_t </span> | ||
+ | : '''Public Members''' | ||
+ | : <span style="background-color: #eeeeee;">uint16_t blue </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint16_t green </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint16_t red </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint16_t green_h </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint16_t green_l </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">struct<nowiki> lv_color16_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint16_t full </span> | ||
+ | :: | ||
+ | |||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color32_t </span> | ||
+ | : '''Public Members''' | ||
+ | : <span style="background-color: #eeeeee;">uint8_t blue </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t green </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t red </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t alpha </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">str<nowiki>uct lv_color32_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint32_t full </span> | ||
+ | :: | ||
+ | |||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">struct lv_color_hsv_t </span> | ||
+ | : '''Public Members''' | ||
+ | : <span style="background-color: #eeeeee;">uint16_t h </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t s </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">uint8_t v </span> | ||
+ | :: | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">struct _lv_color_filter_dsc_t </span> | ||
+ | : '''Public Members''' | ||
+ | : <span style="background-color: #eeeeee;">lv_color_filter_cb_t filter_cb </span> | ||
+ | :: | ||
+ | : <span style="background-color: #eeeeee;">void *user_data</span> | ||
+ | |'''Typedefs''' | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef lv_color_t (*lv_color_filter_cb_t)(const struct _lv_color_filter_dsc_t*, lv_color_t, lv_opa_t) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef struct _lv_color_filter_dsc_t lv_color_filter_dsc_t </span> | ||
+ | : | ||
+ | |||
+ | '''Enums''' | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">enum [anonymous] </span> | ||
+ | : 不透明度のパーセンテージ。 '''''Values''':'' | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_TRANSP </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_0 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_10 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_20 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_30 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_40 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_50 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_60 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_70 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_80 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_90 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_100 </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_OPA_COVER </span> | ||
+ | :: | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">enum lv_palette_t </span> | ||
+ | :'''''Values''':'' | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_RED </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_PINK </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_PURPLE </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_DEEP_PURPLE </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_INDIGO </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_BLUE </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_LIGHT_BLUE </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_CYAN </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_TEAL </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_GREEN </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_LIGHT_GREEN </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_LIME </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_YELLOW </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_AMBER </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_ORANGE </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_DEEP_ORANGE </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_BROWN </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_BLUE_GREY </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_GREY </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator _LV_PALETTE_LAST </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">enumerator LV_PALETTE_NONE </span> | ||
+ | :: | ||
+ | |||
+ | '''Functions''' | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_COLOR_DEPTH) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_COLOR_16_SWAP) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef LV_CONCAT3 (uint, LV_COLOR_SIZE, _t) lv_color_int_t</span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">typedef LV_CONCAT3 (lv_color, LV_COLOR_DEPTH, _t) lv_color_t</span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint8_t lv_color_to1(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint8_t lv_color_to8(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint16_t lv_color_to16(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint32_t lv_color_to32(lv_color_t color) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint8_t lv_color_brightness(lv_color_t color) </span> | ||
+ | : 色の明るさを取得します | ||
+ | :'''Parameters''' | ||
+ | ::'''color''' -- 色 | ||
+ | :'''Returns''' | ||
+ | :: 明るさ [0..255] | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_make(uint8_t r, uint8_t g, uint8_t b) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_hex(uint32_t c) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_hex3(uint32_t c) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_color_filter_dsc_init(lv_color_filter_dsc_t *dsc, lv_color_filter_cb_t cb) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_lighten(lv_color_t c, lv_opa_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_darken(lv_color_t c, lv_opa_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_change_lightness(lv_color_t c, lv_opa_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_color_hsv_to_rgb(uint16_t h, uint8_t s, uint8_t v) </span> | ||
+ | : HSV色をRGBに変換する | ||
+ | :'''Parameters''' | ||
+ | ::*'''h''' -- 色相(Hue)[0..359] | ||
+ | ::*'''s''' -- 彩度(Saturation・Chroma) [0..100] | ||
+ | ::*'''v''' -- 明度(Value・Brightness)[0..100] | ||
+ | :'''Returns''' | ||
+ | :: RGBで指定されたRGBカラー(LV_COLOR_DEPTH深度を使用) | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_hsv_t lv_color_rgb_to_hsv(uint8_t r8, uint8_t g8, uint8_t b8) </span> | ||
+ | : 32ビットRGBカラーをHSVに変換します | ||
+ | :'''Parameters''' | ||
+ | ::*'''r8''' -- 8-bit red | ||
+ | ::*'''g8''' -- 8-bit green | ||
+ | ::*'''b8''' -- 8-bit blue | ||
+ | :'''Returns''' | ||
+ | :: HSVで指定されたRGBカラー | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_hsv_t lv_color_to_hsv(lv_color_t color) </span> | ||
+ | : 色をHSVに変換する | ||
+ | :'''Parameters''' | ||
+ | ::'''color''' -- 色 | ||
+ | :'''Returns''' | ||
+ | :: HSVで指定された色 | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_chroma_key(void) </span> | ||
+ | : 関数を使用する方が便利な場合があるため、LV_COLOR_CHROMA_KEYのラッパーにすぎない場合があります。 | ||
+ | :'''Returns''' | ||
+ | :: LV_COLOR_CHROMA_KEY | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_palette_main(lv_palette_t p) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_white(void) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_color_t lv_color_black(void) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_palette_lighten(lv_palette_t p, uint8_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_color_t lv_palette_darken(lv_palette_t p, uint8_t lvl) </span> | ||
+ | : | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color1_t </span> | ||
+ | :'''Public Members''' | ||
+ | :<span style="background-color: #eeeeee;">uint8_t full </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t blue </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t green </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t red </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">u<nowiki>nion lv_color1_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color8_t </span> | ||
+ | |||
+ | :'''Public Members''' | ||
+ | :<span style="background-color: #eeeeee;">uint8_t blue </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t green </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t red </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">s<nowiki>truct lv_color8_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t full </span> | ||
+ | :: | ||
+ | |||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color16_t </span> | ||
+ | :'''Public Members''' | ||
+ | :<span style="background-color: #eeeeee;">uint16_t blue </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint16_t green </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint16_t red </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint16_t green_h </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint16_t green_l </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">struct<nowiki> lv_color16_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint16_t full </span> | ||
+ | :: | ||
+ | |||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">union lv_color32_t </span> | ||
+ | :'''Public Members''' | ||
+ | :<span style="background-color: #eeeeee;">uint8_t blue </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t green </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t red </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t alpha </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">str<nowiki>uct lv_color32_t::[anonymous] ch</nowiki> </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint32_t full </span> | ||
+ | :: | ||
+ | |||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">struct lv_color_hsv_t </span> | ||
+ | :'''Public Members''' | ||
+ | :<span style="background-color: #eeeeee;">uint16_t h </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t s </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">uint8_t v </span> | ||
+ | :: | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">struct _lv_color_filter_dsc_t </span> | ||
+ | :'''Public Members''' | ||
+ | :<span style="background-color: #eeeeee;">lv_color_filter_cb_t filter_cb </span> | ||
+ | :: | ||
+ | :<span style="background-color: #eeeeee;">void *user_data</span> | ||
+ | |} | ||
− | + | [[App:Library:LVGL#Overview|戻る : Previous]] |
2022年7月2日 (土) 10:19時点における最新版
https://docs.lvgl.io/8.2/overview/color.html
Colors
英文 | 自動翻訳 |
---|---|
The color module handles all color-related functions like changing color depth, creating colors from hex code, converting between color depths, mixing colors, etc. The type
As 16-bit numbers are stored in little-endian format (lower byte at the lower address), the interface will send the lower byte first.
A mismatch in the byte order will result in highly distorted colors. |
カラーモジュールは、色深度の変更、16進コードからの色の作成、色深度間の変換、色の混合など、すべての色関連機能を処理します。
タイプ
16ビットの数値はリトルエンディアン形式(下位アドレスの下位バイト)で格納されるため、インターフェイスは下位バイトを最初に送信します。
バイト順序の不一致は、非常に歪んだ色になります。 |
Creating colors
RGB
英文 | 自動翻訳 |
---|---|
Create colors from Red, Green and Blue channel values: //All channels are 0-255
lv_color_t c = lv_color_make(red, green, blue);
//From hex code 0x000000..0xFFFFFF interpreted as RED + GREEN + BLUE
lv_color_t c = lv_color_hex(0x123456);
//From 3 digits. Same as lv_color_hex(0x112233)
lv_color_t c = lv_color_hex3(0x123);
|
赤、緑、青のチャンネル値から色を作成します。
//All channels are 0-255
lv_color_t c = lv_color_make(red, green, blue);
//From hex code 0x000000..0xFFFFFF interpreted as RED + GREEN + BLUE
lv_color_t c = lv_color_hex(0x123456);
//From 3 digits. Same as lv_color_hex(0x112233)
lv_color_t c = lv_color_hex3(0x123);
|
HSV
英文 | 自動翻訳 |
---|---|
Create colors from Hue, Saturation and Value values: //h = 0..359, s = 0..100, v = 0..100
lv_color_t c = lv_color_hsv_to_rgb(h, s, v);
//All channels are 0-255
lv_color_hsv_t c_hsv = lv_color_rgb_to_hsv(r, g, b);
//From lv_color_t variable
lv_color_hsv_t c_hsv = lv_color_to_hsv(color);
|
色相、彩度、値の値から色を作成します。
//h = 0..359, s = 0..100, v = 0..100
lv_color_t c = lv_color_hsv_to_rgb(h, s, v);
//All channels are 0-255
lv_color_hsv_t c_hsv = lv_color_rgb_to_hsv(r, g, b);
//From lv_color_t variable
lv_color_hsv_t c_hsv = lv_color_to_hsv(color);
|
Palette
英文 | 自動翻訳 |
---|---|
LVGL includes Material Design's palette of colors. In this system all named colors have a nominal main color as well as four darker and five lighter variants. The names of the colors are as follows:
To get the main color use
|
LVGLには、マテリアルデザインの色のパレットが含まれています。
このシステムでは、すべての名前の付いた色に、名目上のメインカラーと、4つの暗い色と5つの明るい色があります。 色の名前は次のとおりです。
|
Modify and mix colors
英文 | 自動翻訳 |
---|---|
The following functions can modify a color: // Lighten a color. 0: no change, 255: white
lv_color_t c = lv_color_lighten(c, lvl);
// Darken a color. 0: no change, 255: black
lv_color_t c = lv_color_darken(lv_color_t c, lv_opa_t lvl);
// Lighten or darken a color. 0: black, 128: no change 255: white
lv_color_t c = lv_color_change_lightness(lv_color_t c, lv_opa_t lvl);
// Mix two colors with a given ratio 0: full c2, 255: full c1, 128: half c1 and half c2
lv_color_t c = lv_color_mix(c1, c2, ratio);
|
次の関数で色を変更できます。
// Lighten a color. 0: no change, 255: white
lv_color_t c = lv_color_lighten(c, lvl);
// Darken a color. 0: no change, 255: black
lv_color_t c = lv_color_darken(lv_color_t c, lv_opa_t lvl);
// Lighten or darken a color. 0: black, 128: no change 255: white
lv_color_t c = lv_color_change_lightness(lv_color_t c, lv_opa_t lvl);
// Mix two colors with a given ratio 0: full c2, 255: full c1, 128: half c1 and half c2
lv_color_t c = lv_color_mix(c1, c2, ratio);
|
Built-in colors
英文 | 自動翻訳 |
---|---|
|
lv_color_white() と lv_color_black() は、それぞれ 0xFFFFFF と 0x000000 を返します。
|
Opacity
英文 | 自動翻訳 |
---|---|
To describe opacity the Some special purpose defines are also introduced:
You can also use the |
不透明度を説明するために、lv_opa_t タイプはuint8_t から作成されます。
いくつかの特別な目的の定義も導入されています。
|
Color types
英文 | 自動翻訳 |
---|---|
The following variable types are defined by the color module:
The
|
カラーモジュールでは以下の変数型が定義されている。
|
Convert color
英文 | 自動翻訳 |
---|---|
You can convert a color from the current color depth to another. The converter functions return with a number, so you have to use the lv_color_t c;
c.red = 0x38;
c.green = 0x70;
c.blue = 0xCC;
lv_color1_t c1;
c1.full = lv_color_to1(c); /*Return 1 for light colors, 0 for dark colors*/
lv_color8_t c8;
c8.full = lv_color_to8(c); /*Give a 8 bit number with the converted color*/
lv_color16_t c16;
c16.full = lv_color_to16(c); /*Give a 16 bit number with the converted color*/
lv_color32_t c24;
c32.full = lv_color_to32(c); /*Give a 32 bit number with the converted color*/
|
You can convert a color from the current color depth to another.
The converter functions return with a number, so you have to use the field to map a converted color back into a structure: 現在の色深度から別の色に変換することができます。 変換関数は数値で返すので、変換された色を構造体にマッピングして戻すには、full フィールドを使用する必要があります。 lv_color_t c;
c.red = 0x38;
c.green = 0x70;
c.blue = 0xCC;
lv_color1_t c1;
c1.full = lv_color_to1(c); /*Return 1 for light colors, 0 for dark colors*/
lv_color8_t c8;
c8.full = lv_color_to8(c); /*Give a 8 bit number with the converted color*/
lv_color16_t c16;
c16.full = lv_color_to16(c); /*Give a 16 bit number with the converted color*/
lv_color32_t c24;
c32.full = lv_color_to32(c); /*Give a 32 bit number with the converted color*/
|
API
英文 | 自動翻訳 |
---|---|
Typedefs typedef lv_color_t (*lv_color_filter_cb_t)(const struct _lv_color_filter_dsc_t*, lv_color_t, lv_opa_t) typedef struct _lv_color_filter_dsc_t lv_color_filter_dsc_t Enums enum [anonymous]
enum lv_palette_t
Functions LV_EXPORT_CONST_INT(LV_COLOR_DEPTH) LV_EXPORT_CONST_INT(LV_COLOR_16_SWAP) typedef LV_CONCAT3 (uint, LV_COLOR_SIZE, _t) lv_color_int_t typedef LV_CONCAT3 (lv_color, LV_COLOR_DEPTH, _t) lv_color_t static inline uint8_t lv_color_to1(lv_color_t color) static inline uint8_t lv_color_to8(lv_color_t color) static inline uint16_t lv_color_to16(lv_color_t color) static inline uint32_t lv_color_to32(lv_color_t color) static inline uint8_t lv_color_brightness(lv_color_t color)
static inline lv_color_t lv_color_make(uint8_t r, uint8_t g, uint8_t b) static inline lv_color_t lv_color_hex(uint32_t c) static inline lv_color_t lv_color_hex3(uint32_t c) static inline void lv_color_filter_dsc_init(lv_color_filter_dsc_t *dsc, lv_color_filter_cb_t cb) lv_color_t lv_color_lighten(lv_color_t c, lv_opa_t lvl) lv_color_t lv_color_darken(lv_color_t c, lv_opa_t lvl) lv_color_t lv_color_change_lightness(lv_color_t c, lv_opa_t lvl) lv_color_t lv_color_hsv_to_rgb(uint16_t h, uint8_t s, uint8_t v)
lv_color_hsv_t lv_color_rgb_to_hsv(uint8_t r8, uint8_t g8, uint8_t b8)
lv_color_hsv_t lv_color_to_hsv(lv_color_t color)
static inline lv_color_t lv_color_chroma_key(void)
lv_color_t lv_palette_main(lv_palette_t p) static inline lv_color_t lv_color_white(void) static inline lv_color_t lv_color_black(void) lv_color_t lv_palette_lighten(lv_palette_t p, uint8_t lvl) lv_color_t lv_palette_darken(lv_palette_t p, uint8_t lvl) union lv_color1_t
union lv_color8_t
struct _lv_color_filter_dsc_t
|
Typedefs
typedef lv_color_t (*lv_color_filter_cb_t)(const struct _lv_color_filter_dsc_t*, lv_color_t, lv_opa_t) typedef struct _lv_color_filter_dsc_t lv_color_filter_dsc_t Enums enum [anonymous]
enum lv_palette_t
Functions LV_EXPORT_CONST_INT(LV_COLOR_DEPTH) LV_EXPORT_CONST_INT(LV_COLOR_16_SWAP) typedef LV_CONCAT3 (uint, LV_COLOR_SIZE, _t) lv_color_int_t typedef LV_CONCAT3 (lv_color, LV_COLOR_DEPTH, _t) lv_color_t static inline uint8_t lv_color_to1(lv_color_t color) static inline uint8_t lv_color_to8(lv_color_t color) static inline uint16_t lv_color_to16(lv_color_t color) static inline uint32_t lv_color_to32(lv_color_t color) static inline uint8_t lv_color_brightness(lv_color_t color)
static inline lv_color_t lv_color_make(uint8_t r, uint8_t g, uint8_t b) static inline lv_color_t lv_color_hex(uint32_t c) static inline lv_color_t lv_color_hex3(uint32_t c) static inline void lv_color_filter_dsc_init(lv_color_filter_dsc_t *dsc, lv_color_filter_cb_t cb) lv_color_t lv_color_lighten(lv_color_t c, lv_opa_t lvl) lv_color_t lv_color_darken(lv_color_t c, lv_opa_t lvl) lv_color_t lv_color_change_lightness(lv_color_t c, lv_opa_t lvl) lv_color_t lv_color_hsv_to_rgb(uint16_t h, uint8_t s, uint8_t v)
lv_color_hsv_t lv_color_rgb_to_hsv(uint8_t r8, uint8_t g8, uint8_t b8)
lv_color_hsv_t lv_color_to_hsv(lv_color_t color)
static inline lv_color_t lv_color_chroma_key(void)
lv_color_t lv_palette_main(lv_palette_t p) static inline lv_color_t lv_color_white(void) static inline lv_color_t lv_color_black(void) lv_color_t lv_palette_lighten(lv_palette_t p, uint8_t lvl) lv_color_t lv_palette_darken(lv_palette_t p, uint8_t lvl) union lv_color1_t
union lv_color8_t
struct _lv_color_filter_dsc_t
|