Sensor Jarak#

Perkenalan#

Sonar sonar digunakan dengan Sensor Jarak VEX IQ (generasi ke-1). Jarak distance digunakan dengan Sensor Jarak VEX IQ (generasi ke-2).

Kedua sensor jarak dapat mendeteksi apakah suatu objek berada di depan sensor dan memberikan informasi seberapa jauh objek tersebut. Sensor Jarak VEX IQ (generasi ke-2) juga dapat memberikan informasi kecepatan relatif objek yang terdeteksi dan memperkirakan apakah objek tersebut kecil, sedang, atau besar.

Konstruktor Kelas#

1 — Konstruktor ini membuat Sensor Jarak VEX IQ (generasi ke-1).

sonar(
    int32_t index);

2 — Konstruktor ini membuat Sensor Jarak VEX IQ (generasi ke-2).

distance(
    int32_t index);

Destruktor Kelas#

Destroys the distance object and releases associated resources.

1 — Menghancurkan Sensor Jarak VEX IQ (generasi ke-1).

~sonar();

2 — Menghancurkan Sensor Jarak VEX IQ (generasi ke-2).

~distance();

Parameter#

Parameter

Jenis

Keterangan

index

int32_t

Port Pintar tempat Sensor Jarak terhubung, ditulis sebagai PORTx, di mana x adalah nomor port (misalnya, PORT1).

Contoh#

1 — Buat instance VEX IQ Distance Sensor (generasi ke-1) di Port 1.

sonar Distance1 = sonar(PORT1);

2 — Buat instance VEX IQ Distance Sensor (generasi ke-2) di Port 1.

distance Distance1 = distance(PORT1);

Fungsi Keanggotaan#

Kelas sonar mencakup fungsi anggota berikut:

  • foundObject — Mengembalikan apakah Sensor Jarak saat ini mendeteksi suatu objek.

  • distance — Mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi.

Kelas distance mencakup fungsi anggota berikut:

  • objectDistance — Mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi.

  • objectVelocity — Mengembalikan seberapa cepat objek yang terdeteksi bergerak mendekati atau menjauhi Sensor Jarak.

  • objectSize — Mengembalikan perkiraan ukuran objek yang terdeteksi.

  • isObjectDetected — Mengembalikan apakah Sensor Jarak saat ini mendeteksi suatu objek.

  • changed — Mendaftarkan fungsi callback yang dijalankan ketika nilai jarak yang terdeteksi berubah.

  • installed — Mengembalikan apakah Sensor Jarak terpasang dan terhubung.

Before calling any distance or sonar member functions, a distance or sonar instance must be created, as shown below:

/* 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#

Mengembalikan nilai boolean yang menunjukkan apakah Sensor Jarak saat ini mendeteksi suatu objek.

Available Functions 
bool foundObject();
Parameters

Fungsi ini tidak memerlukan parameter apa pun.

Return Values

Mengembalikan nilai Boolean yang menunjukkan apakah Sensor Jarak mendeteksi suatu objek:

  • 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#

Mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi.

Available Functions 
double distance( distanceUnits units );
Parameters

Parameter

Jenis

Keterangan

units

distanceUnits

Satuan jarak:

  • mm — milimeter (24 mm hingga 1000 mm)
  • cm — sentimeter (2,4 cm hingga 100 cm)
  • inches — inci (1 inci hingga 40 inci)
Return Values

Mengembalikan nilai double yang mewakili jarak antara Sensor Jarak dan objek terdekat yang terdeteksi dalam satuan yang ditentukan.

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

objectDistance#

Mengembalikan jarak antara Sensor Jarak dan objek terdekat yang terdeteksi.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Parameter

Jenis

Keterangan

units

distanceUnits

Satuan jarak:

  • mm — milimeter (20 mm hingga 2000 mm)
  • cm — sentimeter (2 cm hingga 200 cm)
  • inches — inci (0,78 inci hingga 78 inci)
Return Values

Mengembalikan nilai double yang mewakili jarak antara Sensor Jarak dan objek terdekat yang terdeteksi dalam satuan yang ditentukan.

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

objectVelocity#

Mengembalikan kecepatan relatif dari objek yang terdeteksi.

Kecepatan menunjukkan seberapa cepat objek bergerak mendekati atau menjauhi Sensor Jarak. Nilai mendekati 0 berarti objek tidak banyak bergerak relatif terhadap sensor.

Available Functions 
double objectVelocity();
Parameters

Fungsi ini tidak memerlukan parameter apa pun.

Return Values

Mengembalikan nilai double yang mewakili kecepatan relatif objek yang terdeteksi dalam m/s (meter per detik).

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

objectSize#

Mengembalikan perkiraan ukuran objek yang terdeteksi oleh Sensor Jarak.

Sensor Jarak memperkirakan ukuran objek berdasarkan seberapa banyak area pandang sensor yang ditempati oleh objek yang terdeteksi.

Available Functions 
sizeType objectSize();
Parameters

Fungsi ini tidak memerlukan parameter apa pun.

Return Values

Mengembalikan sizeType sizeType yang menunjukkan perkiraan ukuran objek yang terdeteksi:

  • 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#

Mengembalikan nilai boolean yang menunjukkan apakah Sensor Jarak saat ini mendeteksi suatu objek.

Available Functions 
bool isObjectDetected();
Parameters

Fungsi ini tidak memerlukan parameter apa pun.

Return Values

Mengembalikan nilai Boolean yang menunjukkan apakah Sensor Jarak mendeteksi suatu objek:

  • 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#

Mendaftarkan fungsi callback yang akan dijalankan ketika nilai jarak yang terdeteksi berubah.

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

Parameter

Jenis

Keterangan

callback

void (*)(void)

Pointer ke sebuah fungsi yang akan dipanggil ketika nilai jarak yang terdeteksi berubah. Fungsi tersebut tidak boleh menerima parameter dan harus mengembalikan void.
Return Values

Fungsi ini tidak mengembalikan nilai.

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

installed#

Mengembalikan nilai yang menunjukkan apakah Sensor Jarak terpasang dan terhubung.

Available Functions 
bool installed();
Parameters

Fungsi ini tidak memerlukan parameter apa pun.

Return Values

Mengembalikan nilai Boolean yang menunjukkan apakah Sensor Jarak terpasang dan terhubung:

  • 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.
On this page