Kullanıcı Kontrolleri

Eklentideki Kullanıcı Kontrolleri, son kullanıcı tarafından değiştirilebilen global değişken biçimini alır. Aşağıda gösterildiği gibi ayar nesneleri dizisi döndüren ControllableParameters() aracılığıyla eklentiden dışa aktarılırlar.

export function ControllableParameters(){
    return [
        {"property":"LightingMode", "label":"Lighting Mode", "type":"combobox", "values":["Canvas","Forced"], "default":"Canvas"},
        {"property":"forcedColor", "label":"Forced Color","min":"0","max":"360","type":"color","default":"#009bde"},
        {"property":"SettingControl", "label":"Enable Setting Control","type":"boolean","default":"false"},
        {"property":"dpi1", "label":"DPI","step":"50", "type":"number","min":"200", "max":"18000","default":"800"}
    ];
}

Bu ayar nesnelerinin her zaman birkaç temel parametresi vardır. Bunlar tüm eklenti Kullanıcı Kontrolleri için geçerlidir.

Parametre	Değer	Tür
property	Kontrole atamak istediğiniz değişkenin adı.	String
label	Kullanıcıya gösterilecek etiket.	String
type	Kontrol türü. Şu anda geçerli seçenekler: boolean, number, hue, color, combobox ve textfield	String
default	Kontrol için varsayılan değer.	Değişken

Sayı Kaydırıcısı

Sayı kontrolü, kullanıcının bir kaydırıcı kullanarak sayının değerini seçmesine olanak tanır.

{"property":"dpi1", "label":"DPI","step":"50", "type":"number","min":"200", "max":"18000","default":"800"},

Bu kontrol aşağıdaki nitelikleri destekler:

Parametre	Değer	Tür
property	Kontrole atamak istediğiniz değişkenin adı.	String
label	Kullanıcıya gösterilecek etiket.	String
type	”number”	String
default	Kontrol için varsayılan değer.	String, Int
min	Kaydırıcı için minimum seçilebilir değer. Bu nitelik negatif değerleri destekler.	String, Int
max	Kaydırıcı için maksimum seçilebilir değer.	String, Int
step	Kaydırıcının artırıp azaltacağı adım değeri	String, Int

Boolean Anahtarı

Boolean kontrolü, kullanıcının geçiş kontrolü kullanarak bir boolean değişkenin değerini seçmesine olanak tanır.

{"property":"AngleSnap", "label":"Angle Snapping", "type":"boolean", "default":"0"},

Bu kontrol aşağıdaki nitelikleri destekler:

Parametre	Değer	Tür
property	Kontrole atamak istediğiniz değişkenin adı.	String
label	Kullanıcıya gösterilecek etiket.	String
type	”boolean”	String
default	Geçiş için varsayılan değer. Varsayılan durum olarak “açık” yapmak için bunu 1 olarak ayarlayın.	String, Int

Ton Kaydırıcısı

Ton seçici kontrolü, kullanıcının bir kaydırıcı kontrolüyle rengin ton bileşenini seçmesine olanak tanır.

Bu kontrol aşağıdaki nitelikleri destekler:

Parametre	Değer	Tür
property	Kontrole atamak istediğiniz değişkenin adı.	String
label	Kullanıcıya gösterilecek etiket.	String
type	”hue”	String, Int
default	Ton kaydırıcısı için varsayılan değer.	String
min	Minimum seçilebilir ton değeri. Bu değer 0 ile 359 arasında olmalıdır.	String, Int
max	Maksimum seçilebilir ton değeri. Bu değer 1 ile 360 arasında olmalıdır.	String, Int

Renk Seçici

Renk kontrolü, kullanıcının ton tekerleği, doygunluk kaydırıcısı ve parlaklık kaydırıcısı kullanarak renk seçmesine olanak tanır. Anahtar simgesi seçim için daha gelişmiş bir renk paleti açar.

{"property":"forcedColor", "label":"Forced Color","min":"0","max":"360","type":"color","default":"#009bde"},

Bu kontrol aşağıdaki nitelikleri destekler:

Parametre	Değer	Tür
property	Kontrole atamak istediğiniz değişkenin adı.	String
label	Kullanıcıya gösterilecek etiket.	String
type	”color”	String
default	Renk seçici için varsayılan değer. #RRGGBB biçiminde hex değeri olarak belirtilmesi gerekir	String
min	Minimum seçilebilir ton değeri. Bu değer 0 ile 359 arasında olmalıdır.	Int
max	Maksimum seçilebilir ton değeri. Bu değer 1 ile 360 arasında olmalıdır.	Int

Açılır Kutu

Açılır kutu kontrolü, kullanıcının önceden ayarlanmış değerler açılır menüsünden seçim yapmasına olanak tanır.

{"property":"SleepModeTime", "label":"Sleep After x Minutes", "type":"combobox", "values":[5,10,15,30,60], "default":10},

Bu kontrol aşağıdaki nitelikleri destekler:

Parametre	Değer	Tür
property	Kontrole atamak istediğiniz değişkenin adı.	String
label	Kullanıcıya gösterilecek etiket.	String
type	”combobox”	String
default	Açılır kutu için varsayılan değer. Bu değer values dizisinde olmalıdır	String, Int
values	Açılır menü için değerler dizisi. Geçerli türler string ve integer’dır.	[String, Int]

Metin Alanı

Metin alanı kontrolü, kullanıcının isteğe bağlı bir RegEx filtresiyle metin girmesine olanak tanır.

{"property":"textBox", "label":"Text Field", "type":"textfield", "default":"3"},

Bu kontrol aşağıdaki nitelikleri destekler:

Parametre	Değer	Tür
property	Kontrole atamak istediğiniz değişkenin adı.	String
label	Kullanıcıya gösterilecek etiket.	String
type	”textfield”	String
default	Metin alanı için varsayılan değer.	String, Int
filter	Kullanıcı girişini sınırlamak için isteğe bağlı RegEx filtresi	RegEx String

on*Changed Geri Çağırmaları

Bir kullanıcı bir kontrolü değiştirdiğinde, SignalRGB bir sonraki Render() çağrısından önce ilgili on[property]Changed() fonksiyonunu çağırır. Fonksiyon adı, ControllableParameters() içindeki özellik adıyla tam olarak eşleşmeli ve başına on, sonuna Changed eklenmelidir. Büyük/küçük harf duyarlıdır.

// ControllableParameters girişi:
{"property":"dpi1", "label":"DPI", "step":"50", "type":"number", "min":"200", "max":"18000", "default":"800"},

// Karşılık gelen geri çağırma:
export function ondpi1Changed() {
    setDpi(dpi1);
}

Yerleşik Geri Çağırmalar

Bu geri çağırmalar, karşılık gelen bir ControllableParameters girişi olmaksızın kullanılabilir:

Fonksiyon	Açıklama
onBrightnessChanged()	Kullanıcı cihazın ana parlaklık kaydırıcısını hareket ettirdiğinde çağrılır.