Dokunmatik LED#

giriiş #

VEX IQ Dokunmatik LED hem bir ışık hem de bir düğmedir. Robotun hazır olduğunu belirtmek, hangi modun seçildiğini göstermek veya başka bir sensör tarafından algılanan bir renkle eşleşmek gibi geri bildirim vermek için farklı renklerde yanabilir ve dokunulduğunu algılayarak bir dokunuşla robotun davranışını başlatmanıza veya değiştirmenize olanak tanır.

Sınıf Oluşturucu #

touchled( 
  int32_t index );

Sınıf Yıkıcısı #

Temas ettiği touchled yok eder ve ilgili kaynakları serbest bırakır.

virtual ~touchled();

Parametreler #

Parametre	Tip	Tanım
`index`	`int32_t`	Dokunmatik LED’in bağlı olduğu Akıllı Bağlantı Noktası, `PORTx`şeklinde yazılır; burada `x` bağlantı noktası numarasıdır (örneğin, `PORT1`).

Örnek #

// Create a touchled instance in Port 1
touchled TouchLED1 = touchled(PORT1);

Üye Fonksiyonları #

touchled sınıfı aşağıdaki üye fonksiyonlarını içerir:

pressing – Dokunmatik LED’e basılıp basılmadığını döndürür.
setColor – Dokunmatik LED’in rengini ayarlar.
setFade – Renklerin birbirine ne kadar hızlı geçiş yapacağını ayarlar.
setBrightness – Dokunmatik LED’in parlaklığını ayarlar.
pressed – Dokunmatik LED’e basıldığında çağrılacak bir fonksiyonu kaydeder.
released – Dokunmatik LED bırakıldığında çağrılacak bir fonksiyonu kaydeder.
on – Dokunmatik LED’i açar.
off – Dokunmatik LED’i kapatır.
setBlink – Dokunmatik LED’i süresiz olarak açıp kapatın.
installed – Dokunmatik LED’in Beyne bağlı olup olmadığını döndürür.

Herhangi bir touchled üye fonksiyonunu çağırmadan önce, aşağıda gösterildiği gibi touchled örneği oluşturulmalıdır:

/* This constructor is required when using VS Code.
Touch LED configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a Touch LED instance in Port 1
touchled TouchLED1 = touchled(PORT1);

pressing #

Dokunmatik LED’e basılıp basılmadığını döndürür.

Available Functions

bool pressing();

Parameters

Bu fonksiyon herhangi bir parametre kabul etmez.

Return Values

Dokunmatik LED’e basılıp basılmadığını gösteren bool boolean değeri döndürür.

true — The Touch LED is being pressed.
false — The Touch LED is not being pressed.

setColor #

Dokunmatik LED sensörünün LED ışığını belirli bir renge ayarlar.

Available Functions

1 — Dokunmatik LED’i vex::color kullanarak bir renge ayarlar.
void setColor( 
  vex::color  color );

2 — colorType kullanarak LED renklerini ayarlar.
void setColor( 
  colorType   color );

Parameters

Parametre

Tip

Tanım

color

colorType

Geçerli bir renk:

blue
blue_green
blue_violet
green
orange
purple
red
red_orange
red_violet
violet
white
yellow
sarı-yeşilyellow_green

yellow_orange

colorType::none
black
transparent

color

vex::color

Geçerli bir özel renk.

Return Values

Bu fonksiyon bir değer döndürmez.

setFade #

Dokunmatik LED Sensörünün solma ayarını belirler. Dokunmatik LED Sensörü, solma türünü kullanarak yeni renklere geçecektir.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Parametre	Tip	Tanım
`speed`	`fadeType`	Solma hızı şu şekilde ayarlanacaktır: `fast` `off` — solma yok `slow`

Parametre

Tip

Tanım

speed

fadeType

Solma hızı şu şekilde ayarlanacaktır:

fast
off — solma yok
slow

Return Values

Bu fonksiyon bir değer döndürmez.

setBrightness #

Dokunmatik LED’in parlaklığını ayarlar.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Parametre	Tip	Tanım
`value`	`uint32_t`	Dokunmatik LED’in parlaklık değeri yüzde olarak ayarlanabilir.

Return Values

Bu fonksiyon bir değer döndürmez.

pressed #

Dokunmatik LED’e basıldığında çağrılacak bir fonksiyonu kaydeder.

Available Functions

void pressed( void (* callback)(void) );

Parameters

Parametre	Tip	Tanım
`callback`	`void (*)(void)`	Dokunmatik LED’e basıldığında çağrılacak bir fonksiyona işaretçi. Fonksiyon parametre almamalı ve void döndürmelidir.

Return Values

Bu fonksiyon bir değer döndürmez.

Examples

Geri çağırma fonksiyonunu tanımlayın ( int main() dışında)

// Display a message when LED is pressed
void LEDPressed() {
  Brain.Screen.print("LED pressed");
}

Geri çağrıyı main() fonksiyonunun içine kaydedin int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDPressed when the value of the Touch LED is pressed.
  TouchLED1.pressed(LEDPressed);
}

released #

Dokunmatik LED bırakıldığında çağrılacak bir fonksiyonu kaydeder.

Available Functions

void released( void (* callback)(void) );

Parameters

Parametre	Tip	Tanım
`callback`	`void (*)(void)`	Dokunmatik LED bırakıldığında çağrılacak bir fonksiyona işaretçi. Fonksiyon parametre almamalı ve void döndürmelidir.

Return Values

Bu fonksiyon bir değer döndürmez.

Examples

Geri çağırma fonksiyonunu tanımlayın ( int main() dışında)

// Display a message when LED is released
void LEDReleased() {
  Brain.Screen.print("LED released");
}

Geri çağrıyı main() fonksiyonunun içine kaydedin int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDReleased when the value of the Touch LED is released.
  TouchLED1.released(LEDReleased);
}

on #

Dokunmatik LED sensörünün LED’ini renkler ve ayarlanmış bir parlaklık kullanarak açar.

Available Functions

1 — LED’i vex::color kullanarak bir renge ayarlar.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Ton kullanarak LED rengini ayarlar.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — LED rengini RGB değerlerine göre ayarlar.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Parametre	Tip	Tanım
`color`	`vex::color`	Geçerli bir renk: `blue` `blue_green` `blue_violet` `green` `orange` `purple` `red` `red_orange` `red_violet` `violet` `white` `yellow` sarı-yeşil`yellow_green` `yellow_orange` `colorType::none` `black` `transparent`
`brightness`	`uint32_t`	İsteğe bağlı. LED’in parlaklık seviyesini yüzde olarak ayarlama seçeneği (varsayılan değer 100’dür).
`hue`	`uint32_t`	LED’in renk tonu. Bu, onaltılık kod değeri (0x000000) olarak da gösterilebilir.
`red`	`uint8_t`	LED’in kırmızı değerini temsil eden bir tamsayı.
`green`	`uint8_t`	LED’in yeşil değerini temsil eden bir tamsayı.
`blue`	`uint8_t`	LED’in mavi değerini temsil eden bir tamsayı.

Return Values

Bu fonksiyon bir değer döndürmez.

off #

Dokunmatik LED’i kapatır.

Available Functions

void off( void );

Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Bu fonksiyon bir değer döndürmez.

setBlink #

Dokunmatik LED’i tekrar tekrar yanıp söndürür.

Available Functions

1 — Yanıp sönme rengini vex::color kullanarak ayarlar.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Yanıp sönme rengini onaltılık renk değeri kullanarak ayarlar.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — colorType kullanarak yanıp sönme rengini ayarlar.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Parametre	Tip	Tanım
`color`	`colorType`	Geçerli bir renk: `blue` `blue_green` `blue_violet` `green` `orange` `purple` `red` `red_orange` `red_violet` `violet` `white` `yellow` sarı-yeşil`yellow_green` `yellow_orange` `colorType::none` `black` `transparent`
`onTime`	`double`	İsteğe bağlı. LED’in yanıp sönme döngüsü başına açık kalacağı süre (saniye cinsinden), varsayılan değer 0,25 saniyedir.
`offTime`	`double`	İsteğe bağlı. LED’in yanıp sönme döngüsü başına kapalı kalacağı süre (saniye cinsinden), varsayılan değer 0,25 saniyedir.
`hue`	`uint32_t`	Onaltılık renk değeri (örneğin, kırmızı için `0xFF0000`).
`color`	`vex::color`	Geçerli bir özel renk.

Return Values

Bu fonksiyon bir değer döndürmez.

Notes - Calling [off](#off) will not stop the blinking behavior. To stop the blinking behavior, set the LED brightness to 0 with [setBrightness](#setbrightness).

installed #

Dokunmatik LED’in bağlı olup olmadığını döndürür.

Available Functions

bool installed();

Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Dokunmatik LED’in bağlı olup olmadığını gösteren bir Boolean değeri döndürür:

true — The sensor is connected and responding.
false — The sensor is not connected or not detected.