Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Perenderan terminal

Status: Saat ini Cakupan: pemilihan profil terminal TUI, penimpaan, dan batas kapabilitas visual Terakhir ditinjau: 2026-10-03 Pemilik: pengelola TUI AX Code

AX Code memilih profil terminal dari lingkungan saat mulai. Profil mengendalikan penyiapan terminal, bukan resolusi monitor atau ketajaman font.

TERM_PROGRAM yang eksplisit lebih diutamakan daripada penanda terminal luar yang diwarisi. Jenis terminal terbatas seperti dumb, linux, dan vt100 juga tetap kompatibel. Identitas Ubuntu atau WSL saja tidak mengaktifkan profil lanjutan.

Profil lanjutan memakai layar alternatif, utas perenderan native, dan deteksi kapabilitas terminal. Profil kompatibel memakai layar utama tanpa utas perenderan native. Keduanya mengaktifkan interaksi mouse (lihat Penangkapan mouse) serta negosiasi protokol papan ketik dan menargetkan 60 FPS; laju bingkai sebenarnya bergantung pada beban kerja dan terminal.

Windows Terminal mempertahankan efek visual 24-bit pada kedua profil ketika sesi langsungnya teridentifikasi. Dukungan warna tidak berarti grafis piksel atau dukungan Nerd Font. Mode lanjutan tidak mengubah font, ukuran font, atau skala tampilan.

Penangkapan mouse

AX Code menangkap masukan mouse terminal secara bawaan agar kontrol di dalam TUI tetap dapat diklik: penanda pintasan kaki (model cepat, otonom, sandbox), opsi dialog dan pelengkapan otomatis, klik untuk fokus, pemilihan seret, dan gulir roda di dalam TUI. Saat penangkapan aktif, terminal menyerahkan mouse ke program yang berjalan, jadi menu klik kanan milik terminal dan pemilihan teks native tidak ditampilkan. Banyak terminal tetap menampilkannya dengan pengubah — biasanya Shift ditambah klik kanan, kadang Option atau Alt — bergantung pada terminal dan apakah tmux, screen, atau Zellij berada di antaranya.

Atur mouse ke false di tui.json untuk mengembalikan mouse ke terminal:

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1 menonaktifkan penangkapan apa pun nilai tui.json. Variabel ini ada karena berkas tui.json di tingkat proyek adalah masukan yang tidak dipercaya: sebuah repositori tidak boleh dapat menahan perilaku mouse milik terminal bertentangan dengan keinginan pengguna. Variabel itu hanya menonaktifkan penangkapan; ia tidak pernah dapat memaksanya aktif.

Menolak ikut serta adalah pertukaran, bukan kemenangan murni:

• Kembali: menu klik kanan native terminal, pemilihan teks native, dan salin/tempel. Gulir balik milik terminal menangani roda pada profil kompatibel.
• Hilang: penanda pintasan kaki, klik untuk fokus, opsi dialog dan pelengkapan otomatis yang dapat diklik, pemilihan seret, dan — pada profil lanjutan (layar alternatif), yang tidak punya gulir balik terminal — gulir roda di dalam TUI. Kontrol papan ketik tetap tersedia untuk tindakan itu.

Saat penangkapan aktif, klik kanan membuka menu konteks milik TUI, bukan milik terminal: menu Salin / Tempel kecil di posisi klik. Salin aktif ketika ada pilihan di layar, Tempel ketika masukan teks terfokus — termasuk prompt dan masukan di dalam dialog. Menu tertutup pada Escape, pada penekanan tombol apa pun, pada gulir, atau pada klik di luarnya. Setelah penangkapan mati, terminal yang menangani klik.

Menimpa profil

Atur AX_CODE_TUI_ADVANCED_TERMINAL=1 untuk meminta mode lanjutan atau 0 untuk meminta mode kompatibel. Penimpaan eksplisit lebih diutamakan daripada deteksi otomatis, termasuk sesi jarak jauh dan yang dimultipleks. Hapus variabel untuk memulihkan pemilihan otomatis. true/false, yes/no, dan on/off juga diterima.

PowerShell, untuk shell saat ini dan proses anaknya:

$env:AX_CODE_TUI_ADVANCED_TERMINAL = "1"
ax-code

# Use compatible mode if startup or rendering has problems.
$env:AX_CODE_TUI_ADVANCED_TERMINAL = "0"
ax-code

# Restore automatic selection.
Remove-Item Env:AX_CODE_TUI_ADVANCED_TERMINAL -ErrorAction SilentlyContinue

Bash atau Zsh, untuk satu peluncuran:

AX_CODE_TUI_ADVANCED_TERMINAL=1 ax-code
AX_CODE_TUI_ADVANCED_TERMINAL=0 ax-code

Jika berkas awal shell Anda mengekspor variabel itu, hapus ekspor tersebut dan jalankan unset AX_CODE_TUI_ADVANCED_TERMINAL untuk memulihkan pemilihan otomatis.

Animasi piksel

Animasi pembuka dan penutup memakai piksel hanya ketika perender mengonfirmasi grafis Kitty, dimensi piksel yang valid, TTY lokal, layar alternatif, dan tanpa multiplekser. Kapabilitas yang hilang atau kegagalan grafis memakai cadangan teks. Mode lanjutan otomatis tidak melewati pemeriksaan ini.

Semua bingkai animasi piksel — Digital Code, Foliage, dan adegan penanda — dibatasi ke 1920x1080. Bingkai animasi ini diperbarui pada jadwal 20 FPS, terpisah dari target 60 FPS perender. Lihat Animasi pembuka dan penutup TUI untuk pratinjau.

Sesi Windows Terminal dengan dukungan Sixel yang terkonfirmasi (dan tanpa grafis Kitty) menampilkan satu bingkai pembuka Sixel statis, dibatasi ke 640x360 dan 256 KiB, alih-alih cadangan teks. AX_CODE_SIXEL_SPLASH=0 menonaktifkannya; =1 mengizinkan terminal Sixel mana pun menampilkannya (jalur uji). Pembongkaran mengecat ulang wilayah pembuka dengan latar overlay karena Sixel tidak punya penghapusan id gambar.

Font Windows Terminal

AX Code tidak dapat mengubah font terminal. Ikon jenis berkas (glif pemakaian privat Nerd Font) hanya terender di Windows Terminal dengan font yang sudah ditambal terpasang. Font yang disarankan adalah Cascadia Code NF: pasang, lalu atur sebagai font profil di Pengaturan > Profil > Tampilan > Wajah font. Petunjuk sekali di dalam aplikasi mengarahkan pengguna Windows Terminal ke penyiapan ini; petunjuk tidak pernah muncul ketika ikon sudah terender atau ketika AX_CODE_NERD_FONT=0 menolak ikut serta.