カラーピッカー (ColorPicker) は、単独のUI要素に多くの色を追加できるようにする特化されたUI要素です。
| ColorPicker | カラーピッカー (ColorPicker) は、単独のUI要素に多くの色を追加できるようにする特化されたUI要素です。 |
| XML定義 | |
| XMLタグ | |
| 属性 | |
| texture | 表示するテクスチャの名前。 |
| columnsPerRow | 一列あたりの色数。 |
| 要素 | |
| ColorTexCoords | カラーピッカー上のテクスチャの基準座標を設定します。 |
| ColorTexDims | 色を適用するテクスチャのサイズを明確に指定します。 |
| ColorSize | 各色の縦幅と横幅を設定します。 |
| ColorSpacing | 各色間の間隔の広さを設定します。 |
| ウィンドウ コールバック | |
| コールバック | |
| OnPointMouseOver | ユーザーがカラーポイントにマウスカーソルを重ねた時に呼び出されます。 |
| 関数 | |
| 関数 | |
| ColorPickerGetCoordinatesForColor() | カラーピッカー上でクリックされた色に基づいて、そのカラー矩形の左上角のX及びY座標を返します。 |
| ColorPickerGetColorAtPoint() | カラーピッカー上でクリックされた座標に基づいて、色情報を返します。 |
| ColorPickerGetColorById() | カラーピッカー上でクリックされた色IDに基づいて、色情報を返します。 |
| ColorPickerCreateWithColorTable() | カラーピッカーにカラーテーブルを作成します。 |
| ColorPickerAddColor() | カラーピッカーに色を追加します。 |
| ColorPickerAddColorAtPosition() | 位置を指定してカラーピッカーに色を追加します。 |
| ColorPickerClear() | カラーピッカーから全ての色を消去します。 |
| ColorPickerGetColorSpacing() | 与えられたカラーピッカーの間隔の広さを返します。 |
| ColorPickerGetTexDims() | 与えられたカラーピッカーのテクスチャサイズを返します。 |
| ColorPickerGetColorSize() | 与えられたカラーピッカーのカラーサイズを返します。 |
| XMLタグ | |
| 属性 | |
| texture | 表示するテクスチャの名前。 |
| columnsPerRow | 一列あたりの色数。 |
| 要素 | |
| ColorTexCoords | カラーピッカー上のテクスチャの基準座標を設定します。 |
| ColorTexDims | 色を適用するテクスチャのサイズを明確に指定します。 |
| ColorSize | 各色の縦幅と横幅を設定します。 |
| ColorSpacing | 各色間の間隔の広さを設定します。 |
| コールバック | |
| OnPointMouseOver | ユーザーがカラーポイントにマウスカーソルを重ねた時に呼び出されます。 |
| 関数 | |
| ColorPickerGetCoordinatesForColor() | カラーピッカー上でクリックされた色に基づいて、そのカラー矩形の左上角のX及びY座標を返します。 |
| ColorPickerGetColorAtPoint() | カラーピッカー上でクリックされた座標に基づいて、色情報を返します。 |
| ColorPickerGetColorById() | カラーピッカー上でクリックされた色IDに基づいて、色情報を返します。 |
| ColorPickerCreateWithColorTable() | カラーピッカーにカラーテーブルを作成します。 |
| ColorPickerAddColor() | カラーピッカーに色を追加します。 |
| ColorPickerAddColorAtPosition() | 位置を指定してカラーピッカーに色を追加します。 |
| ColorPickerClear() | カラーピッカーから全ての色を消去します。 |
| ColorPickerGetColorSpacing() | 与えられたカラーピッカーの間隔の広さを返します。 |
| ColorPickerGetTexDims() | 与えられたカラーピッカーのテクスチャサイズを返します。 |
| ColorPickerGetColorSize() | 与えられたカラーピッカーのカラーサイズを返します。 |
カラーピッカー上でクリックされた色に基づいて、そのカラー矩形の左上角のX及びY座標を返します。
| ColorPickerWindowName | (string) カラーピッカーの名前。 |
| r | (integer) 赤色の値。 |
| g | (integer) 緑色の値。 |
| b | (integer) 青色の値。 |
| left, top | (integer) カラーピッカーウインドウ上のカラー矩形の左上角のX及びY座標。 |
local left, top = ColorPickerGetCoordinatesForColor( "myColorPicker", r, g, b )
カラーピッカー上でクリックされた色IDに基づいて、色情報を返します。
| ColorPickerWindowName | (string) カラーピッカーの名前。 |
| Id | (integer) ユーザー指定の色ID。 |
| r | (integer) 赤色の値。 |
| g | (integer) 緑色の値。 |
| b | (integer) 青色の値。 |
| id | (integer) 色ID。 |
| x | (integer) 色のX座標。 |
| y | (integer) 色のY座標。 |
注意: 色が見つからない場合は nil を戻します。
local color = ColorPickerGetColorById( "myColorPicker", colorId )
カラーピッカーにカラーテーブルを作成します。
| ColorPickerWindowName | (string) カラーピッカーの名前。 |
| Colors | (table) 赤値、緑値、青値およびIDの情報を格納したテーブル。IDはユーザー定義であり、カラーピッカーにとって実質的意味は持ちませんが、RGB値と比較せずにLua内で色を追えるので便利な方法です。各カラーテーブルには、追加で色の左上角のX, Y座標を含めることもできます。色が並ぶ順番はテーブルの順番に依存します。例: Colors = { {r=143, g=57, b=54, id=5 }, {r=50, g=10, b=113, id=17, x=100, y=200}, ... } |
| Stride | (integer) 一行あたりの色の列数。 |
| OffsetX | (integer) X軸上の各色間のピクセル量。 |
| OffsetY | (integer) Y軸上の各色間のピクセル量。 |
| nil | 戻り値無し。 |
ColorPickerCreateWithColorTable( "myColorPicker", Colors, 4, 5, 5 )
位置を指定してカラーピッカーに色を追加します。
| ColorPickerWindowName | (string) カラーピッカーの名前。 |
| r | (integer) 赤色の値 (0 から 255)。 |
| g | (integer) 緑色の値 (0 から 255)。 |
| b | (integer) 青色の値 (0 から 255)。 |
| id | (integer) 色から特定できるユーザ定義のID。固有の値である必要はありません。 |
| x | (integer) その色が位置する左上角の座標 (X)。 |
| y | (integer) その色が位置する左上角の座標 (Y)。 |
| nil | 戻り値無し。 |
ColorPickerAddColorAtPosition( "myColorPicker", 115, 40, 213, 1, 0, 0 )