Deteksi Window dan Kontrol
Menyeret kotak seleksi secara manual di sekitar dialog atau tombol yang bertumpuk sering ikut menangkap piksel latar atau bayangan window. Snapdown membaca elemen di bawah kursor langsung dari Windows dan menawarkan batasnya yang tepat:
| Mekanisme | Sumber | Perilaku |
|---|---|---|
| Batas window | DWM extended frame bounds | Memakai DWMWA_EXTENDED_FRAME_BOUNDS sehingga bayangan tak kasatmata di sekitar window tidak ikut, dan hanya window yang terlihat yang ditangkap. |
| Hierarki kontrol | UI Automation | Membaca pohon aksesibilitas di bawah kursor: kontrolnya, panel yang menampungnya, lalu window aplikasinya. |
| Pratinjau | Garis tepi overlay | Memberi garis tepi pada target saat ini sebelum Anda mengklik. |
| Memperluas cakupan | Roda mouse | Bila ada lebih dari satu target bertumpuk di bawah kursor, roda mouse naik atau turun di rantai itu, dan sebuah badge menampilkan Scroll to widen · N / count. |
| Mengunci | Klik kiri | Mengunci persegi yang sedang ditandai tanpa perlu klik lalu seret. |
Bila sebuah aplikasi tidak menyediakan pohon UI Automation yang bisa dipakai, Snapdown kembali memakai batas window terluar, sehingga penangkapan tetap berjalan.
Seleksi Area dan Loupe Piksel
Mulailah dari satu area, bukan seluruh desktop. Area yang terfokus memberi reviewer atau agent konteks setempat yang dibutuhkan, tanpa panel lain, notifikasi, dan gangguan di sekitarnya. Ukuran gambar hasil ekspor juga jadi lebih kecil sebelum dikompresi.
Saat memilih area, loupe piksel memperbesar piksel di sekitar kursor. Pakai loupe untuk menempatkan tepi seleksi tepat di batas yang penting: bagian bawah tombol yang terpotong, garis pemisah satu piksel yang hilang, ujung kolom input, atau baseline yang tidak sejajar. Loupe dipakai untuk memilih bukti dengan akurat, bukan untuk mempercantik tangkapan setelahnya.
- Sertakan kontrolnya dan konteks di sekitarnya secukupnya agar statusnya bisa dikenali.
- Jangan sertakan sidebar, chrome browser, atau window lain yang tidak berkaitan, kecuali bagian itu termasuk kondisi reproduksi.
- Untuk masalah tata letak, tangkap kedua elemen yang hubungannya salah.
- Untuk masalah responsif, tulis lebar viewport atau faktor penskalaan di catatan.
Pin Bernomor
Pin bernomor adalah sisi visual dari catatan bernomor di Markdown. Pasang pin 1 di gambar lalu tulis catatannya; di Markdown yang disalin, pin itu menjadi baris 1. di bawah Marker Notes, lengkap dengan posisinya sebagai persentase gambar. Nomor yang sama terbaca di kedua tempat, tanpa perlu keterangan seperti “yang di dekat pojok kanan bawah”.
# Settings review 2026-09-24 10:15 ## Finding 1  ### Notes Dialog Settings pada skala tampilan 125% ### Marker Notes 1. [loc:48%,91%] Tombol Save terpotong di tepi bawah. Seharusnya: tombol terlihat utuh pada skala 125%. 2. [loc:22%,40%] Baseline label 6 px lebih rendah dari kolom inputnya. Seharusnya: label dan input sejajar pada baseline yang sama.
Letakkan pin di samping target, jangan menutupi teks atau ikon yang perlu diperiksa. Pin mengarahkan perhatian dan membiarkan bukti di bawahnya tetap terlihat. Penomoran mulai dari 1 di setiap temuan, jadi sebut pin sebagai “Temuan 2, pin 3”.
Alat di Ribbon
Toolbar punya tujuh alat: enam alat anotasi dan satu alat untuk memotong gambar (Crop). Klik ikon untuk memilih alat; alat yang aktif disorot.
| Alat | Kategori | Fungsinya |
|---|---|---|
| Marker | Anotasi | Memasang pin bernomor yang bertambah otomatis, mulai dari 1 di setiap temuan. Setiap pin menjadi satu catatan bernomor di Markdown. |
| Shape (kotak fokus) | Anotasi | Menggambar persegi di sekitar kontainer tata letak, area overflow, atau pesan error. |
| Callout | Anotasi | Menambahkan balon teks dengan ekor penunjuk. |
| Blur | Anotasi | Menyamarkan area di bawahnya dengan box blur 3-pass yang menyatu di gambar bundle, jadi token dan data pribadi tidak terbaca di yang Anda bagikan. Tangkapan aslinya tetap di vault sampai Anda menghapusnya. |
| Arrow | Anotasi | Menunjuk cacat perataan kecil atau garis pemisah yang hilang. |
| Text | Anotasi | Menulis teks bebas langsung di kanvas. |
| Crop | Memotong gambar | Menampilkan kotak crop yang masih bisa dibatalkan. Setelah dikonfirmasi, crop mengganti gambar sumber dan menghapus file sebelum di-crop. |
Anotasi menyatu di gambar bundle dengan warna merah tetap (#DC2626), sehingga tampilannya sama di pembaca bertema terang maupun gelap.
Blur untuk Data Sensitif
Sebelum mengekspor atau menempelkan tangkapan di mana pun, periksa apakah ada data pribadi, kredensial, API key, konten pelanggan, alamat email, token akses, atau URL internal. Alat blur menyamarkan area tersebut dan membiarkan tata letak di sekitarnya tetap cukup terlihat untuk ditinjau.
Tangkap Area Terkecil
Ambil hanya bagian layar yang membuktikan masalah.
Blur Nilai Sensitif
Blur setiap kredensial atau identitas yang harus tetap berada di bingkai untuk menunjukkan tata letak atau status.
Baca Juga Catatannya
Data rahasia sama mudahnya tertempel di Markdown seperti terlihat di screenshot.
Periksa yang Anda Serahkan
Baca Markdown yang disalin dan lihat gambarnya sekali sebelum mengirim bundle ke agent, issue tracker, atau rekan kerja.
Preset Ukuran Gambar
Model vision menghitung input gambar berdasarkan ukuran pikselnya, sehingga tangkapan 4K mentah memakai konteks jauh lebih banyak daripada yang dibutuhkan detailnya. Snapdown memperkecil dan meng-encode ulang setiap tangkapan saat disimpan, dengan salah satu dari lima preset tetap atau mode Auto dan Custom:
| Preset | Sisi terpanjang | Kualitas | Cocok untuk |
|---|---|---|---|
| Sharp | 2560 px | 90% | Review desain layar high-DPI, pemeriksaan tipografi, dan pemeriksaan aset sampai tingkat piksel. |
| Balanced | 1600 px | 75% | Serah-terima ke engineer dan laporan cacat desktop sehari-hari. |
| Small | 1280 px | 50% | Lampiran chat (Slack, Discord) dan koneksi lambat. |
| Agent Normal (default) | 1024 px | 80% | Ukuran dan kualitas default untuk diperiksa coding agent. |
| Agent Compact | 800 px | 80% | Gambar lebih kecil untuk model vision saat konteksnya terbatas. |
Auto memilih skala berdasarkan resolusi tangkapan. Custom memungkinkan Anda menentukan sendiri sisi terpanjang dan kualitasnya. Proses perubahan ukuran dan encode ulang berjalan di komputer Anda.
Keluaran: Markdown, Gambar, dan PDF
Bundle keluar dari Snapdown dengan salah satu dari tiga cara. Karena pin bernomor menyatu di gambar sekaligus tertulis di catatan, agent dan engineer membaca rujukan yang sama.
- Copy Markdown: dari menu baris bundle di Pustaka. Tempel di issue, pull request, atau chat agent. Tautan gambarnya berupa path lengkap ke vault Anda, jadi memuat nama pengguna Windows Anda, dan hanya agent yang berjalan di komputer yang sama yang bisa membukanya.
- Copy image: salin gambar satu temuan ke clipboard, dengan atau tanpa anotasi burn-in.
- Export PDF: dokumen siap cetak yang disusun dengan Typst bawaan Snapdown, jadi Anda tidak perlu memasang apa pun lagi.
Dua cara yang lebih cepat: Full Screen di bilah tangkap mengambil seluruh layar, bukan satu area, dan Copy Only di panel tangkap menyalin tangkapan ke clipboard tanpa menyimpan temuan. Settings > Agent Hand-off berisi instruksi yang ditambahkan Snapdown ke Markdown yang disalin; Anda bisa mengubahnya, mengembalikan default, atau tidak menyertakannya.