Kamera#

Perkenalan #

Drone VEX AIR dilengkapi dengan dua Sensor Penglihatan yang berfungsi sebagai kamera onboard—satu di bagian depan dan satu di bagian bawah. Sensor ini dapat menangkap gambar dan video selama penerbangan. Dalam VEXcode AIR, kata “kamera” selalu mengacu pada salah satu Sensor Penglihatan ini. Misalnya, dalam perintah seperti drone.camera.start_recording(FORWARD_CAMERA), camera mengacu pada Sensor Penglihatan, dan FORWARD_CAMERA memilih yang menghadap ke depan.

Untuk mentransfer rekaman video dan gambar dari Pengontrol Drone VEX AIR, sambungkan pengontrol ke komputer Anda. Pengontrol akan muncul sebagai perangkat penyimpanan massal (mirip dengan drive USB), memungkinkan Anda untuk menyalin file secara langsung. Setelah mengakhiri proyek, tunggu sekitar satu menit hingga pengontrol selesai mengunduh gambar atau rekaman dari drone sebelum mencoba menyalinnya.

Berikut adalah daftar semua metode yang tersedia:

Tindakan

start_recording – Merekam video dari Sensor Penglihatan.
stop_recording – Menghentikan perekaman dari Sensor Penglihatan.
capture_image – Mengambil gambar dari Sensor Visi.

Mutator

show_camera – Menampilkan Sensor Visi yang dipilih pada Pengontrol Drone VEX AIR.
hide_camera – Menyembunyikan umpan Sensor Penglihatan pada pengontrol.
set_overlay_reticle – Menampilkan atau menyembunyikan reticle overlay.
set_overlay_telemetry – Menampilkan atau menyembunyikan data telemetri.

Penangkap

is_recording – Mengembalikan apakah Sensor Penglihatan sedang merekam.
get_recording_time – Mengembalikan waktu yang dihabiskan untuk merekam.

Tindakan #

start_recording #

start_recording memulai perekaman dengan Sensor Penglihatan yang ditentukan.

Untuk informasi tentang melihat dan mengambil rekaman, silakan.

Penggunaan:

drone.camera.start_recording(camera)

Parameter	Keterangan
`camera`	Sensor Penglihatan yang digunakan untuk merekam: `DOWNWARD_CAMERA` atau `FORWARD_CAMERA`.

# Press button 7 to end recording
def end_recording():
    drone.camera.stop_recording(FORWARD_CAMERA)
    drone.land()

controller.button7.pressed(end_recording)

# Record a video as you fly around
controller.screen.show_camera(FORWARD_CAMERA)
drone.take_off(climb_to=500)
drone.camera.start_recording(FORWARD_CAMERA)
while True:
    # Move with controller
    drone.move_with_vectors(
        forward=controller.axis4.position(),
        rightward=controller.axis3.position(),
        upward=controller.axis1.position(),
        rotation=controller.axis2.position()
    )
    wait(5, MSEC)

stop_recording #

stop_recording menghentikan perekaman Sensor Penglihatan yang ditentukan.

Untuk informasi tentang melihat dan mengambil rekaman, silakan.

Penggunaan:

drone.camera.stop_recording(camera)

Parameter	Keterangan
`camera`	Sensor Penglihatan untuk menghentikan perekaman dengan: `DOWNWARD_CAMERA` atau `FORWARD_CAMERA`.

# Press button 7 to end recording
def end_recording():
    drone.camera.stop_recording(FORWARD_CAMERA)
    drone.land()

controller.button7.pressed(end_recording)

# Record a video as you fly around
controller.screen.show_camera(FORWARD_CAMERA)
drone.take_off(climb_to=500)
drone.camera.start_recording(FORWARD_CAMERA)
while True:
    # Move with controller
    drone.move_with_vectors(
        forward=controller.axis4.position(),
        rightward=controller.axis3.position(),
        upward=controller.axis1.position(),
        rotation=controller.axis2.position()
    )
    wait(5, MSEC)

capture_image #

capture_image mengambil gambar dengan Sensor Penglihatan yang ditentukan.

Untuk informasi tentang melihat dan mengambil gambar yang ditangkap, silakan kunjungi di sini.

Penggunaan:

drone.camera.capture_image(camera)

Parameter	Keterangan
`camera`	Sensor Penglihatan untuk mengambil gambar: `DOWNWARD_CAMERA` atau `FORWARD_CAMERA`.

# Press button 7 to take pictures
def take_picture():
    drone.camera.capture_image(FORWARD_CAMERA)

controller.button7.pressed(take_picture)

# Take pictures while you control the drone
controller.screen.show_camera(FORWARD_CAMERA)
drone.take_off(climb_to=500)
while True:
    # Move with controller
    drone.move_with_vectors(
        forward=controller.axis4.position(),
        rightward=controller.axis3.position(),
        upward=controller.axis1.position(),
        rotation=controller.axis2.position()
    )
    wait(5, MSEC)

Mutator #

show_camera #

show_camera mengatur mode layar saat ini ke umpan Sensor Visi yang ditentukan.

Penggunaan:

controller.screen.show_camera(camera)

Parameter	Keterangan
`camera`	Input Sensor Penglihatan untuk ditampilkan: `DOWNWARD_CAMERA` atau `FORWARD_CAMERA`.

# Switch camera feeds after 3 seconds
controller.screen.show_camera(DOWNWARD_CAMERA)
wait(3, SECONDS)
controller.screen.show_camera(FORWARD_CAMERA)

hide_camera #

hide_camera menyembunyikan umpan Vision Sensor yang ditentukan.

Penggunaan:

controller.screen.hide_camera()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

# Hide camera feed after 3 seconds
controller.screen.show_camera(FORWARD_CAMERA)
wait(3, SECONDS)
controller.screen.hide_camera()

set_overlay_reticle #

set_overlay_reticle mengaktifkan atau menonaktifkan reticle overlay. Reticle adalah penanda visual, seperti garis bidik, yang muncul di tampilan kamera untuk membantu membidik atau menyelaraskan objek.

Secara default, overlay reticle diatur ke True di awal proyek, hanya pada Vision Sensor yang menghadap ke bawah.

Usage:
controller.screen.set_overlay_reticle(state)

Parameter	Keterangan
`state`	Status reticle overlay: `True` mengaktifkan reticle overlay. `False` menonaktifkan reticle overlay.

# Hide the reticle when not aligning to a landing area
controller.screen.show_camera(DOWNWARD_CAMERA)
drone.take_off(climb_to=500)
controller.screen.set_overlay_reticle(False)
while True:
    # Move with controller
    drone.move_with_vectors(
        forward=controller.axis4.position(),
        rightward=controller.axis3.position(),
        upward=controller.axis1.position(),
        rotation=controller.axis2.position()
    )
    wait(5, MSEC)

set_overlay_telemetry #

set_overlay_telemetry mengaktifkan atau menonaktifkan visibilitas data telemetri drone pada layar pengontrol. Telemetri adalah data langsung dari drone saat sedang terbang atau menjalankan proyek.

Secara default, overlay data telemetri diatur ke True pada awal proyek.

Usage:
controller.screen.set_overlay_telemetry(state)

Parameter	Keterangan
`state`	Status data telemetri: `True` memungkinkan tampilan data telemetri di layar. `False` menonaktifkan tampilan data telemetri di layar.

# Clear the camera video for better visibility
controller.screen.show_camera(FORWARD_CAMERA)
drone.take_off(climb_to=500)
controller.screen.set_overlay_telemetry(False)
while True:
    # Move with controller
    drone.move_with_vectors(
        forward=controller.axis4.position(),
        rightward=controller.axis3.position(),
        upward=controller.axis1.position(),
        rotation=controller.axis2.position()
    )
    wait(5, MSEC)

Pencari #

is_recording #

is_recording mengembalikan nilai Boolean yang menunjukkan apakah Vision Sensor yang ditentukan saat ini sedang merekam.

True – Sensor Penglihatan yang ditentukan sedang merekam.
False – Sensor Penglihatan yang ditentukan tidak merekam.

Penggunaan:

drone.camera.is_recording(camera)

Parameter	Keterangan
`camera`	Sensor Penglihatan untuk memeriksa status perekaman: `DOWNWARD_CAMERA` atau `FORWARD_CAMERA`.

# Use button 7 to start and stop recording
def toggle_recording():
    if drone.camera.is_recording(FORWARD_CAMERA):
        drone.camera.stop_recording(FORWARD_CAMERA)
    else:
        drone.camera.start_recording(FORWARD_CAMERA)

controller.button7.pressed(toggle_recording)

# Make video recordings while you control the drone
controller.screen.show_camera(FORWARD_CAMERA)
drone.take_off(climb_to=500)
while True:
    # Move with controller
    drone.move_with_vectors(
        forward=controller.axis4.position(),
        rightward=controller.axis3.position(),
        upward=controller.axis1.position(),
        rotation=controller.axis2.position()
    )
    wait(5, MSEC)

get_recording_time #

get_recording_time mengembalikan jumlah waktu yang telah direkam oleh Vision Sensor tertentu sebagai bilangan desimal (float) dalam detik.

Penggunaan:

drone.camera.get_recording_time(camera)

Parameter	Keterangan
`camera`	Sensor Penglihatan untuk memeriksa waktu perekaman: `DOWNWARD_CAMERA` atau `FORWARD_CAMERA`.

# Record a video for 10 seconds
controller.screen.show_camera(FORWARD_CAMERA)
drone.camera.start_recording(FORWARD_CAMERA)
drone.take_off(climb_to=500)
while not (drone.camera.get_recording_time(FORWARD_CAMERA)) >= 10:
    wait(5, MSEC)
drone.camera.stop_recording(FORWARD_CAMERA)