Mesafe Sensörü#

giriiş#

sonar sınıfı, VEX IQ Mesafe Sensörü (1. nesil) ile kullanılır. distance sınıfı ise VEX IQ Mesafe Sensörü (2. nesil) ile kullanılır.

Her iki mesafe sensörü de sensörün önünde bir nesne olup olmadığını algılayabilir ve o nesnenin ne kadar uzakta olduğunu gösterebilir. VEX IQ Mesafe Sensörü (2. nesil) ayrıca algılanan nesnenin göreceli hızını da gösterebilir ve nesnenin küçük, orta veya büyük olup olmadığını tahmin edebilir.

Sınıf Oluşturucuları#

1 — Bu yapıcı, bir VEX IQ Mesafe Sensörü (1. nesil) oluşturur.

sonar(
    int32_t index);

2 — Bu yapıcı, bir VEX IQ Mesafe Sensörü (2. nesil) oluşturur.

distance(
    int32_t index);

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

distance nesnesini yok eder ve ilgili kaynakları serbest bırakır.

1 — Bir VEX IQ Mesafe Sensörünü (1. nesil) imha eder.

~sonar();

2 — VEX IQ Mesafe Sensörünü (2. nesil) imha eder.

~distance();

Parametreler#

Parametre

Tip

Tanım

index

int32_t

Mesafe sensörünün bağlı olduğu akıllı port, PORTxşeklinde yazılır; burada x port numarasıdır (örneğin, PORT1).

Örnekler#

1 — 1. Portta bir VEX IQ Mesafe Sensörü (1. nesil) örneği oluşturun.

sonar Distance1 = sonar(PORT1);

2 — 1. Portta bir VEX IQ Mesafe Sensörü (2. nesil) örneği oluşturun.

distance Distance1 = distance(PORT1);

Üye Fonksiyonları#

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

  • foundObject — Mesafe Sensörünün şu anda bir nesne algılayıp algılamadığını döndürür.

  • distance — Mesafe Sensörü ile en yakın tespit edilen nesne arasındaki mesafeyi döndürür.

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

  • objectDistance — Mesafe Sensörü ile en yakın tespit edilen nesne arasındaki mesafeyi döndürür.

  • objectVelocity — Algılanan nesnenin Mesafe Sensörüne doğru veya ondan uzaklaşarak ne kadar hızlı hareket ettiğini döndürür.

  • objectSize — Tespit edilen nesnenin tahmini boyutunu döndürür.

  • isObjectDetected — Mesafe Sensörünün şu anda bir nesne algılayıp algılamadığını döndürür.

  • changed — Algılanan mesafe değeri değiştiğinde çalışan bir geri çağırma fonksiyonu kaydeder.

  • installed — Mesafe Sensörünün kurulu ve bağlı olup olmadığını döndürür.

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

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

// Create a VEX IQ Distance Sensor (2nd gen) instance in Port 1
distance Distance1 = distance(PORT1);

foundObject#

Mesafe sensörünün şu anda bir nesne algılayıp algılamadığını döndürür.

Available Functions
bool foundObject();

Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Mesafe sensörünün bir nesne algılayıp algılamadığını gösteren bir Boolean değer döndürür:

  • true — The Distance Sensor detects an object.
  • false — The Distance Sensor does not detect an object.
Notes - This is a VEX IQ Distance Sensor (1st gen) function.

distance#

Mesafe sensörü ile en yakın tespit edilen nesne arasındaki mesafeyi döndürür.

Available Functions
double distance( distanceUnits units );

Parameters

Parametre

Tip

Tanım

units

distanceUnits

Mesafe birimi:

  • mm — milimetre (24 mm ila 1000 mm)
  • cm — santimetre (2,4 cm ila 100 cm)
  • inches — inç (1 inç ila 40 inç)

Return Values

Mesafe Sensörü ile en yakın algılanan nesne arasındaki mesafeyi belirtilen birimlerde temsil eden double değerinde bir double değer döndürür.

Notes - This is a VEX IQ Distance Sensor (1st gen) function.

objectDistance#

Mesafe sensörü ile en yakın tespit edilen nesne arasındaki mesafeyi döndürür.

Available Functions
double objectDistance( distanceUnits units );

Parameters

Parametre

Tip

Tanım

units

distanceUnits

Mesafe birimi:

  • mm — milimetre (20 mm ila 2000 mm)
  • cm — santimetre (2 cm ila 200 cm)
  • inches — inç (0,78 inç ila 78 inç)

Return Values

Mesafe Sensörü ile en yakın algılanan nesne arasındaki mesafeyi belirtilen birimlerde temsil eden double değerinde bir double değer döndürür.

Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

objectVelocity#

Tespit edilen cismin göreceli hızını döndürür.

Hız, nesnenin Mesafe Sensörüne doğru veya ondan uzaklaşırken ne kadar hızlı hareket ettiğini gösterir. 0’a yakın bir değer, nesnenin sensöre göre fazla hareket etmediği anlamına gelir.

Available Functions
double objectVelocity();

Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Tespit edilen nesnenin göreceli hızını m/s (metre/saniye) cinsinden temsil eden double değerini döndürür.

Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

objectSize#

Mesafe Sensörü tarafından algılanan nesnenin tahmini boyutunu döndürür.

Mesafe sensörü, algılanan nesnenin sensörün görüş alanının ne kadarını kapladığına bağlı olarak nesnenin boyutunu tahmin eder.

Available Functions
sizeType objectSize();

Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Tespit edilen nesnenin tahmini boyutunu gösteren sizeType değerini döndürür:

  • none — No object is detected.
  • small — A small object is detected.
  • medium — A medium object is detected.
  • large — A large object is detected.
Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

isObjectDetected#

Mesafe sensörünün şu anda bir nesne algılayıp algılamadığını döndürür.

Available Functions
bool isObjectDetected();

Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Mesafe sensörünün bir nesne algılayıp algılamadığını gösteren bir Boolean değer döndürür:

  • true — The Distance Sensor detects an object.
  • false — The Distance Sensor does not detect an object.
Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

changed#

Algılanan mesafe değeri değiştiğinde çalışan bir geri çağırma fonksiyonu kaydeder.

Available Functions
void changed( void (* callback)(void) );

Parameters

Parametre

Tip

Tanım

callback

void (*)(void)

Algılanan mesafe değeri değiştiğinde çağrılacak bir fonksiyona işaretçi. Fonksiyon parametre almamalı ve void.

Return Values

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

Notes - This is a VEX IQ Distance Sensor (1st gen) or (2nd gen) function.

installed#

Mesafe sensörünün takılı ve bağlı olup olmadığını döndürür.

Available Functions
bool installed();

Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Mesafe sensörünün takılı ve bağlı olup olmadığını gösteren bir Boolean değeri döndürür:

  • true — The Distance Sensor is installed and connected.
  • false — The Distance Sensor is not installed or not connected.
Notes - This is a VEX IQ Distance Sensor (1st gen) or (2nd gen) function.