Bileşen Fonksiyonları

Cihaz Fonksiyonları

Bu fonksiyonlar cihazı Bileşen Sistemi ile uyumlu hale getirmek için kullanılır.

device.SetLedLimit()

Bu fonksiyon bir int değeri alır ve cihazdaki tüm bileşen kanalları için üst LED sınırını ayarlar. Arka uçtaki güvenlik kontrolleri için kullanılır ve kullanıcıların cihazlarını kaldırabileceğinden fazla güç çekimiyle aşırı yüklenmesini önler. Üretici firmanın cihaz için belirlediği maksimum değere ayarlanmalıdır.

Parametre	Açıklama	Tür	Örnek
LedLimit	Cihazdaki tüm kanallar için istenen LED sınırı	Int	80

const DeviceMaxLedLimit = 233;
  device.SetLedLimit(DeviceMaxLedLimit);

device.getLedCount()

Bu fonksiyon, cihazdaki tüm kanallardaki tüm bileşenlerin mevcut toplam LED sayısını döndürür. Birincil kullanım amacı, herhangi bir bileşen seçilip seçilmediğini kontrol etmektir; çünkü 0 LED, 0 Bileşen anlamına gelir.

Döndürülen	Açıklama	Tür	Örnek
LedCount	Tüm kanalların mevcut LED sayısı	Int	64

let ColorData = []
    if(LightingMode == "Forced"){
        // işlem yap
    }else if(device.getLedCount() == 0){
        // işlem yap
    }else{
        // işlem yap
    }

device.addChannel()

Bu fonksiyon cihaza yeni bir Bileşen Kanalı ekler. İlk kanal eklendiğinde cihaz sayfasında Bileşen Yapılandırma kullanıcı arayüzü görünür. Bu fonksiyon, kullanıcıyı cihazın güvenli LED sınırını aşma konusunda uyarmak için isteğe bağlı ancak önerilen bir LedLimit alır. Bu sınır birden fazla yerde kullanıldığından ayarlanması şiddetle tavsiye edilir.

Parametre	Açıklama	Tür	Örnek
ChannelName	Bu kanala referans vermek için kullanılacak ChannelName	String	”Channel 1”
LedLimit	Kanalın güvenli çalışma LED Sınırı.	Int	204

// Kanal Adı, LED Sınırı
var ChannelArray = [
    ["Channel 1", 204],
    ["Channel 2", 204],
]

function SetupChannels(){
    device.SetLedLimit(DeviceMaxLedLimit);
    for(let i = 0; i < ChannelArray.length; i++){
        device.addChannel(ChannelArray[i][0],ChannelArray[i][1]);
    }
}

device.removeChannel()

Bu fonksiyon cihazdan bir kanalı kaldırır. Normal koşullar altında SignalRGB kapandığında kanallar temizleneceğinden bu fonksiyona ihtiyaç duyulmamalıdır. Ancak kanallar eklenti dosyasının sıcak yeniden yüklemeleri arasında kalıcı olduğundan, eklentiyi geliştirirken sorun yaşıyorsanız initialize fonksiyonunda bunları temizlemek isteyebilirsiniz.

Parametre	Açıklama	Tür	Örnek
ChannelName	Kaldırılacak ChannelName	String	”Channel 1”

device.createChannel("Channel1")
  // İşlem yap
  device.removeChannel("Channel1")

device.getChannelNames()

Bu fonksiyon, cihazda bulunan tüm kanalların adlarını döndürür. Buradaki birincil kullanım, hata ayıklama amaçlıdır; çünkü Kanal Adları, cihazın paketleri için kanal diziniyle birlikte eklentinin mantığında saklanmalıdır. Ancak istenirse küçük bir performans kaybıyla cihazdaki tüm kanallar üzerinde yineleme yapmak için de kullanılabilir.

Döndürülen	Açıklama	Tür	Örnek
Channel Names	Cihazdaki tüm Kanal adlarının listesi	1D Dizi	[“Channel 1”,“Channel 2”]

let channels = device.getChannelNames();

device.channel()

Bu, ComponentChannel’larla etkileşime geçmenin kapısıdır. Verilen ChannelName ile eşleşen bir ComponentChannel varsa ona referans döndürür; yoksa null döndürür.

Dikkat

Bu referansların geçerliliği garanti edilmez; bunun yerine her render döngüsünde yeni bir referans almanız gerekir.

Parametre	Açıklama	Tür	Örnek
ChannelName	Referans alınacak ChannelName	String	”Channel 1”

Döndürülen	Açıklama	Tür
ComponentChannel	ComponentChannel Nesnesi	ComponentChannel | Null

let components = device.channel("Channel 1").getComponentNames();

ComponentChannel

Bu fonksiyonlar belirli bir ComponentChannel referansını kontrol etmek ve etkileşim kurmak için kullanılır.

channel.SetLedLimit()

Benzer device.ledLimit() fonksiyonu gibi, bu fonksiyon da bu ComponentChannel için maksimum güvenli LED sınırını ayarlar.

Parametre	Açıklama	Tür	Örnek
LedLimit	Kanal için istenen LED Sınırı	Int	16

device.channel("Channel 1").SetLedLimit(204);

channel.LedCount()

Bu, ComponentChannel’da kullanıcı tarafından yapılandırılan LED sayısını döndürür.

Döndürülen	Açıklama	Tür	Örnek
LedCount	Kanalın mevcut LED Sayısı	Int	16

let ChannelLedCount = device.channel("Channel 1").LedCount();

channel.getColors()

Bu fonksiyon, cihazın LED haritası ve koordinatlarına göre bir RGB renk verisi dizisi döndürür. Bu fonksiyonun dönüş değeri büyük ölçüde doğru argümanların ayarlanmasına bağlıdır.

Parametreler	Açıklama	Tür	Örnek	Varsayılan
ArrayOrder	İstenen dizi formatı	String	”Inline"	"Seperate”
ColorOrder	İstenen Renk sırası	String	”RGB"	"RGB”

Dizi Sırası	Açıklama	Tür	Örnek
Inline	Renk verilerini sırayla düz bir diziye biçimlendirir	1D Dizi	[R,G,B,R,G,B]
Seperate	Renk verilerini 3 ayrı kanala biçimlendirir	2D Dizi	[[R,R], [G,G], [B,B]]

ColorOrder, “RGB”nin 3 harfli bir kombinasyonudur; örn. “BGR”, “GBR”, “RBG”. Inline ArrayOrder kullanılırken renklerin sırasını belirler. Geçersiz değerler “RGB”ye geri döner.

Döndürülen	Açıklama	Tür	Örnek
RGB Data	İstenen formatta döndürülen RGB renk verisi	Dizi	Dizi Sırası Tablosuna Bakın

RGBData = device.channel("Channel 1").getColors("Inline", "GRB");

channel.shouldPulseColors()

Bu fonksiyon, bu cihaz kanalının ‘nabız atıp atmaması’ gerektiği konusunda bir boolean döndürür. Bu, hiçbir Bileşen seçilmemiş olması veya ekleme Bileşen Kurulum kullanıcı arayüzünün gösterilmesi nedeniyle istenebilir.

Beklenen nabız rengini almak için device.getChannelPulseColor() kullanılabilir.

Döndürülen	Tür	Açıklama
ShouldPulse	boolean	Bu kanal nabız atmalı mı

channel.getComponent()

channel.getComponentColors()

channel.getComponentNames()

channel.getComponentData()

channel.getComponentColors()

Yardımcı Fonksiyonlar

device.getChannelPulseColor()

device.createColorArray()