Layar#

Perkenalan#

Metode Screen mengontrol bagaimana EXP Brain menampilkan teks, angka, dan grafik di layarnya.

Secara default, font untuk pencetakan ke Brain adalah monospaced kecil yang memiliki 7 baris dan 20 kolom.

Untuk menggambar, resolusi Brain adalah 159 x 107 piksel.

Diagram grid berlabel dari layar VEX Brain yang menunjukkan baris, kolom, dimensi piksel, dan koordinat, dengan garis merah yang menguraikan grid.

Berikut adalah daftar metode yang tersedia:

Cetak Kursor – Menampilkan teks dan mengelola kursor cetak.

  • print – Mencetak teks, angka, atau nilai variabel pada posisi kursor saat ini.

  • print_at – Mencetak teks, angka, atau nilai variabel pada koordinat x dan y tertentu.

  • set_cursor – Memindahkan kursor ke baris dan kolom tertentu.

  • set_origin – Mengatur titik asal yang digunakan untuk pencetakan dan penggambaran berbasis koordinat.

  • next_row – Memindahkan kursor ke baris berikutnya.

  • clear_row – Menghapus baris teks.

  • row – Mengembalikan baris tempat teks akan dicetak.

  • column – Mengembalikan kolom tempat teks akan dicetak.

  • get_string_width – Mengembalikan lebar string dalam piksel menggunakan font saat ini.

  • get_string_height – Mengembalikan tinggi string dalam piksel menggunakan font saat ini.

Mutator – Mengubah pengaturan layar, warna, dan perilaku penggambaran.

  • clear_screen – Menghapus semua gambar dan teks dari layar Otak.

  • set_font – Mengatur jenis font yang digunakan untuk mencetak teks di layar Otak.

  • set_pen_width – Mengatur ketebalan garis yang digambar dan garis luar bentuk.

  • set_pen_color – Mengatur warna teks, piksel, garis, dan garis luar bentuk.

  • set_fill_color – Mengatur warna isian untuk bentuk yang digambar dan latar belakang teks yang dicetak.

Menggambar – Buat bentuk, garis, dan grafik di layar Brain.

  • draw_pixel – Menggambar satu piksel pada koordinat.

  • draw_line – Menggambar garis antara dua titik.

  • draw_rectangle – Menggambar persegi panjang menggunakan warna pena dan warna isian saat ini.

  • draw_circle – Menggambar lingkaran menggunakan warna pena dan warna isian saat ini.

  • draw_image_from_file – Menggambar gambar dari kartu SD.

  • render – Mengalihkan gambar ke double buffered dan merender layar Otak.

  • set_clip_region – Mengatur wilayah klip untuk menggambar persegi panjang yang diberikan.

Cetak Kursor#

print#

print mencetak teks, angka, atau nilai variabel pada layar Brain di posisi kursor dan font saat ini.

Penggunaan:

brain.screen.print(text, sep, precision)

Parameter

Keterangan

text

Teks, angka, atau nilai variabel yang akan dicetak.

sep

Opsional. Sebuah string untuk disisipkan di antara nilai. Ini harus ditulis sebagai argumen kata kunci (sep=). Nilai defaultnya adalah “”.

precision

Opsional. Jumlah tempat desimal yang akan ditampilkan saat mencetak angka sederhana. Ini harus ditulis sebagai argumen kata kunci (precision=). Nilai defaultnya adalah 2.

 
brain.screen.print("Hello, Robot!")

Tangkapan layar EXP Brain yang menunjukkan tulisan "Hello Robot" di layar.

# Print the number 1 on the Brain's screen at current
# cursor position.
brain.screen.print(1)

# Print the numbers 1, 2, 3 and 4 on the Brain's screen at
# current cursor position separated by a '-'.
brain.screen.print(1, 2, 3, 4, sep='-')

set_cursor#

set_cursor memindahkan kursor ke baris dan kolom tertentu di layar Brain. Panggilan print berikutnya akan mulai mencetak di lokasi tersebut. Jarak antar baris dan kolom akan memperhitungkan font yang dipilih. Posisi kursor default adalah Baris 1, Kolom 1.

Penggunaan:

brain.screen.set_cursor(row, column)

Parameter

Keterangan

row

Baris tempat kursor akan dipindahkan.

column

Kolom tempat kursor akan dipindahkan.

 
# Display text starting at Row 3 Column 10.
brain.screen.set_cursor(3, 10)
brain.screen.print("R3, C10")

Tangkapan layar EXP Brain yang menunjukkan "R3, C10" tercetak di layar.

set_origin#

set_origin mengatur titik asal yang digunakan untuk menggambar dan mencetak berbasis koordinat pada layar Brain. Secara default, titik asalnya adalah pojok kiri atas layar.

Penggunaan:

brain.screen.set_origin(x, y)

Parameter

Keterangan

x

Posisi x titik asal relatif terhadap pojok kiri atas, dari 0 hingga 159.

y

Posisi y titik asal relatif terhadap pojok kiri atas, dari 0 hingga 107.

next_row#

next_row memindahkan kursor ke kolom 1 pada baris berikutnya di layar Brain.

Penggunaan:

brain.screen.next_row()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

 
# Display two lines of text.
brain.screen.print("Line 1")
brain.screen.next_row()
brain.screen.print("Line 2")

Tangkapan layar EXP Brain yang menunjukkan teks "3" pada baris 3.

clear_row#

clear_row menghapus satu baris teks pada layar Brain.

Penggunaan:

brain.screen.clear_row(row)

Parameter

Keterangan

row

Opsional. Baris yang akan dihapus. Secara default, baris kursor saat ini adalah baris yang akan dihapus.

color

Opsional. ColorType yang valid, nilai heksadesimal, atau string web.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Anda juga dapat menentukan warna kustom.

 
# Clear Brain's screen to black.
brain.screen.clear_row()

# Clear Brain's screen to blue using predefined color.
brain.screen.clear_row(2, Color.BLUE)

row#

row mengembalikan baris tempat teks akan dicetak sebagai bilangan bulat.

Penggunaan:

brain.screen.row()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

 
# Display the cursor's current row.
brain.screen.set_cursor(3, 10)
brain.screen.print(brain.screen.row())

Tangkapan layar EXP Brain yang menunjukkan teks "3" pada baris 3.

column#

column mengembalikan kolom tempat teks akan dicetak sebagai bilangan bulat.

Penggunaan:

brain.screen.column()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

 
# Display the cursor's current column.
brain.screen.set_cursor(3, 10)
brain.screen.print(brain.screen.column())

Tangkapan layar EXP Brain yang menunjukkan teks "10" pada kolom 10.

get_string_width#

get_string_width mengembalikan lebar string dalam piksel sebagai bilangan bulat, menggunakan font saat ini.

Penggunaan:

brain.screen.get_string_width(string)

Parameter

Keterangan

string

Tali untuk mengukur.

get_string_height#

get_string_height mengembalikan tinggi string dalam piksel sebagai bilangan bulat, menggunakan font saat ini.

Penggunaan:

brain.screen.get_string_height(string)

Parameter

Keterangan

string

Tali untuk mengukur.

Mutator#

clear_screen#

clear_screen menghapus semua gambar dan teks dari layar Otak.

Penggunaan:

brain.screen.clear_screen(color)

Parameter

Keterangan

color

Opsional. ColorType yang valid, nilai heksadesimal, atau string web.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Anda juga dapat menentukan warna kustom.

 
# Print VEXcode on the Brain's screen.
brain.screen.print("VEXcode")

# Clear screen to black.
brain.screen.clear_screen()

# Print VEXcode on the Brain's screen.
brain.screen.print("VEXcode")

# Clear screen to blue using predefined color.
brain.screen.clear_screen(Color.BLUE)

set_font#

set_font mengatur font yang digunakan untuk menampilkan teks di layar Brain. Font ini akan berlaku untuk semua teks yang dicetak setelah metode ini dijalankan.

Penggunaan:

brain.screen.set_font(fontname)

Parameter

Keterangan

fontname

Ukuran font (contoh di bawah):

  • MONO12
  • MONO15
  • MONO20
  • MONO30
  • MONO40
  • MONO60
  • PROP20
  • PROP30
  • PROP40
  • PROP60
Catatan: Ukuran ekstra kecil dan kecil tidak tersedia untuk font proporsional.

Layar Otak mencetak angka dan huruf dengan ukuran font MONO 12. Menampilkan A sampai Z dan semua angka. Di bagian bawah layar, tertulis 9 baris, 26 kolom.
MONO12

Layar Otak mencetak angka dan huruf dengan ukuran font MONO 15. Menampilkan A sampai T dan semua angka. Di bagian bawah layar, tertulis 7 baris, 22 kolom.
MONO15

Layar Otak mencetak angka dan huruf dengan ukuran font MONO 20. Menampilkan A sampai P dan semua angka. Di bagian bawah layar, tertulis 5 baris, 16 kolom.
MONO20

Layar Otak mencetak angka dan huruf dengan ukuran font MONO 30. Menampilkan A sampai J. Di bagian bawah layar, tertulis R:3 C:10.
MONO30

Layar Otak mencetak angka dan huruf dengan ukuran font MONO 40. Di bagian bawah layar, tertulis R:2 C:8.
MONO40

Layar Otak mencetak angka dan huruf dengan ukuran font MONO 60. Hanya MON60 yang ditampilkan.
MONO60

Layar Otak mencetak angka dan huruf dengan ukuran font PROP 20. Menampilkan A sampai W dan semua angka. Di bagian bawah layar, tertulis 5 baris, 16 kolom.
PROP20

Layar Otak mencetak angka dan huruf dengan ukuran font PROP 30. Menunjukkan A sampai P. Di bagian bawah layar, tertulis R:3 C:10.
PROP30

Layar Otak mencetak angka dan huruf dengan ukuran font PROP 40. Di bagian bawah layar, tertulis R:2 C:8.
PROP40

TLayar Otak mencetak angka dan huruf dengan ukuran font PROP 60. Hanya PROP60 yang ditampilkan.
PROP60

 

# Set the font type to MONO40.
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")

Tangkapan layar EXP Brain yang menunjukkan teks "VEX" dengan ukuran font lebih besar dari ukuran default.

set_pen_width#

set_pen_width mengatur ketebalan garis yang digambar dan garis luar bentuk.

Penggunaan:

brain.screen.set_pen_width(width)

Parameter

Keterangan

width

Lebar pena, dalam piksel, dari 0 hingga 32.

 
# Draw a rectangle with a pen width of 10.
brain.screen.set_pen_width(10)
brain.screen.draw_rectangle(20, 20, 75, 50)

Tangkapan layar EXP Brain yang menunjukkan persegi panjang dengan batas tebal.

set_pen_color#

set_pen_color mengatur warna teks, piksel, garis, dan garis luar bentuk.

Penggunaan:

brain.screen.set_pen_color(color)

Parameter

Keterangan

color

The pen and font color to use. This can be a valid ColorType, a hex value, or a web string.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
You can also specify a custom color.

 
# Draw a rectangle with orange borders.
brain.screen.set_pen_color(Color.ORANGE)
brain.screen.draw_rectangle(20, 20, 75, 50)

Tangkapan layar EXP Brain yang menunjukkan persegi panjang dengan batas oranye.

# Set pen color red using a hex value.
brain.screen.set_pen_color(0xFF0000)

# Set pen color blue using predefined color.
brain.screen.set_pen_color(Color.BLUE)

# Set pen color green using web string.
brain.screen.set_pen_color("#00FF00")

set_fill_color#

set_fill_color mengatur warna isian yang digunakan untuk menggambar persegi panjang dan lingkaran.

Penggunaan:

brain.screen.set_fill_color(color)

Parameter

Keterangan

color

Warna isian yang akan digunakan. Ini bisa berupa ColorType yang valid, nilai heksadesimal, atau string web.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Anda juga dapat menentukan warna kustom.

 
# Draw a purple rectangle.
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(20, 20, 75, 50)

Tangkapan layar EXP Brain yang menunjukkan persegi panjang berisi warna ungu.

# Set fill color red using a hex value.
brain.screen.set_fill_color(0xFF0000)

# Set fill color blue using predefined color.
brain.screen.set_fill_color(Color.BLUE)

# Set fill color green using web string.
brain.screen.set_fill_color("#00FF00")

Menggambar#

draw_pixel#

draw_pixel menggambar satu piksel pada koordinat x dan y yang dipilih menggunakan warna pena saat ini.

Penggunaan:

brain.screen.draw_pixel(x, y)

Parameter

Keterangan

x

Koordinat x untuk menggambar piksel, dari 0 hingga 159, dengan acuan ke titik asal layar.

y

Koordinat y untuk menggambar piksel, dari 0 hingga 107, dengan acuan terhadap titik asal layar.

 
# Draw the pixels marking the corners of a square.
brain.screen.draw_pixel(50, 50)
brain.screen.draw_pixel(50, 75)
brain.screen.draw_pixel(75, 50)
brain.screen.draw_pixel(75, 75)

Tangkapan layar EXP Brain yang menunjukkan berbagai piksel yang memperlihatkan sudut-sudut sebuah persegi.

draw_line#

draw_line menggambar garis dari koordinat layar pertama (x1, y1) ke koordinat layar kedua (x2, y2) menggunakan lebar pena dan warna pena saat ini.

Penggunaan:

brain.screen.draw_line(x1, y1, x2, y2)

Parameter

Keterangan

x1

Koordinat x dalam piksel dari awal baris, dari 0 hingga 159, dengan acuan ke titik asal layar.

y1

Koordinat y dalam piksel dari awal garis, dari 0 hingga 107, dengan acuan ke titik asal layar.

x2

Koordinat x dalam piksel dari ujung garis, dari 0 hingga 159, dengan acuan ke titik asal layar.

y2

Koordinat y dalam piksel dari ujung garis, dari 0 hingga 107, dengan acuan terhadap titik asal layar.

 
# Draw a line from the top left to bottom right of the screen.
brain.screen.draw_line(0, 0, 159, 107)

Layar Otak menunjukkan garis diagonal tipis di tengah, dari sudut kiri atas ke sudut kanan bawah.

draw_rectangle#

draw_rectangle menggambar persegi panjang menggunakan lebar pena, warna pena, dan warna isi saat ini, kecuali jika parameter opsional color digunakan.

Penggunaan:

brain.screen.draw_rectangle(x, y, width, height, color)

Parameter

Keterangan

x

Koordinat x dalam piksel dari sudut kiri atas persegi panjang, dari 0 hingga 159, dengan acuan terhadap titik asal layar.

y

Koordinat y dalam piksel dari sudut kiri atas persegi panjang, dari 0 hingga 107, dengan acuan terhadap titik asal layar.

width

Lebar persegi panjang.

height

Tinggi persegi panjang tersebut.

color

Opsional. ColorType yang valid, nilai heksadesimal, atau string web.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Anda juga dapat menentukan warna kustom.

 
# Draw a rectangle on the screen.
brain.screen.draw_rectangle(20, 20, 80, 30)

Layar Otak menampilkan persegi panjang dengan batas putih tipis di layar.

# Draw a green rectangle on the screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_rectangle(10, 10, 20, 20)

# Draw a green rectangle on the screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_rectangle(50, 50, 20, 20, Color.RED)

draw_circle#

draw_circle menggambar lingkaran menggunakan lebar pena, warna pena, dan warna isi saat ini, kecuali jika parameter opsional color digunakan.

Penggunaan:

brain.screen.draw_circle(x, y, radius, color)

Parameter

Keterangan

x

Koordinat x dalam piksel dari pusat lingkaran, dari 0 hingga 159, dengan acuan terhadap titik asal layar.

y

Koordinat y dalam piksel dari pusat lingkaran, dari 0 hingga 107, dengan acuan terhadap titik asal layar.

radius

Jari-jari lingkaran.

color

Opsional. ColorType yang valid, nilai heksadesimal, atau string web.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Anda juga dapat menentukan warna kustom.

 
# Draw a circle on the screen.
brain.screen.draw_circle(80, 50, 20)

Layar Otak menampilkan lingkaran dengan garis putih tipis di tengahnya.

# Draw a green circle on the Brain's screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_circle(50, 50, 10)

# Draw a green circle on the Brain's screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_circle(100, 50, 10, Color.RED)

draw_image_from_file#

draw_image_from_file menggambar gambar dari kartu SD. Nama file yang Anda masukkan saat memanggil metode harus berada di kartu SD.

Penggunaan:

brain.screen.draw_image_from_file(filename, x, y)

Parameter

Keterangan

filename

Nama file gambar tersebut.

x

Koordinat x untuk sudut kiri atas gambar di layar.

y

Koordinat y untuk sudut kiri atas gambar di layar.

 
# Draw the vex.bmp image on the Brain's screen at coordinate 0, 0.
brain.screen.draw_image_from_file('vex.bmp', 0, 0)

render#

Perintah render mengalihkan penggambaran ke double buffered dan merender layar Brain. Setelah dipanggil, penggambaran lebih lanjut tidak akan muncul di layar Brain sampai perintah render dipanggil lagi.

  • True jika buffer berhasil ditampilkan di layar.

  • False jika buffer tidak berhasil ditampilkan di layar.

Penggunaan:

brain.screen.render()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

set_clip_region#

set_clip_region mendefinisikan area persegi panjang di layar tempat semua gambar dan teks akan dibatasi. Konten apa pun di luar area ini tidak akan ditampilkan.

Penggunaan:

brain.screen.set_clip_region(x, y, width, height)

Parameter

Keterangan

x

Posisi x dari sudut kiri atas persegi panjang, dengan acuan terhadap titik asal layar.

y

Posisi y dari sudut kiri atas persegi panjang, dengan acuan terhadap titik asal layar.

width

Lebar persegi panjang.

height

Tinggi persegi panjang tersebut.
On this page