# Buku petunjuk &spectacle;

## Introduksi

&spectacle; adalah aplikasi sederhana untuk menangkap cuplikanlayar desktop. Hal ini bisa menangkap image dari seluruh desktop, monitor tunggal, jendela yang sedang aktif, jendela saat ini yang sedang di bawah mouse, atau bidang persegi pada layar. Image kemudian bisa dicetak, dikirim ke aplikasi lain untuk manipulasi, atau secara cepat disimpan sebagai apa.

Silakan laporkan masalah apa pun atau permintaan fitur ke &kde; Bug Treking System.

## Memulai &spectacle;

&spectacle; bisa dimulai dengan berbagai cara, seperti yang diterangjelaskan di bawah ini:

- Dalam menu peluncur aplikasi, &spectacle; bisa ditemukan di Aplikasi Utilitas Utilitas Tangkap Cuplikanlayar &spectacle;

- Menekan tombol Print pada keyboard akan segera meluncurkan &spectacle;. Sebagai tambahan, ada tiga lagi pintasan keyboard tersedia untuk mengambil cuplikanlayar dan menyimpannya di folder baku Anda tanpa menampilkan &GUI;:

  - Meta Print akan mengambil sebuah cuplikanlayar pada jendela yang aktif

  - &Shift;Print akan mengambil sebuah cuplikanlayar pada seluruh desktop Anda, &ie; semua monitor

  - Meta&Shift;Print akan mengambil sebuah cuplikanlayar bidang persegi

  Kamu bisa mengkonfigurasi lokasi baku simpanan dan nama file dengan memulai &spectacle; secara normal dan mengeklik pada tombol Konfigurasi..., kemudian menavigasi ke bagian Simpan.

- Baris perintah mini &krunner; (dipanggil dengan tombol &Alt;F2) mungkin juga dapat digunakan untuk memulai &spectacle;.

- &spectacle; bisa dimulai dari baris-perintah. &spectacle; yang memiliki set berbagai pilihan baris-perintah, termasuk mode latarbelakang yang bisa digunakan untuk skrip tangkapan cuplikanlayar tanpa menampilkan &GUI; atau memerlukan interaksi pengguna.

  Untuk memulai &spectacle; dari command prompt, ketiklah:

      % spectacle &

  Untuk menilik daftar penuh pilihan baris-perintah dan penjelasan mereka, ketiklah:

      % spectacle --help

## Menggunakan &spectacle;

Setelah &spectacle; mulai, Anda akan melihat jendela seperti berikut ini: &spectacle; Jendela Utama

&spectacle; meraih sebuah image pada seluruh desktop Anda segera setelah dimulai, tapi sebelum menampilkan dirinya pada layar. Ini memungkinkan Anda untuk menciptakan gambar cuplikanlayar desktop penuh secara cepat.

Snapshot diambil oleh &spectacle; yang telah ditampilkan di jendela pratinjau, yang mana terlokasi pada sisi sebelah kiri pada jendela aplikasi &spectacle;.

Image bisa disimpan ke lokasi pilihanmu dengan mengeklik pada tombol Simpan Sebagai atau mengetikkan &Ctrl;&Shift;S). Ini membuka dialog standar simpanan, yang mana kamu bisa memilih nama filenya, lokasi foldernya, dan formatnya yang cuplikanlayarmu akan kamu simpan di dalamnya. Kamu mungkin mau mengedit nama file ke apa pun yang kamu mau, termasuk nama cuplikanlayar yang disimpan sebelumnya.

Untuk menyimpan cuplikanlayar ke lokasi baku, klik pada panah disamping tombol Simpan Sebagai... dan tekan tombol Simpan (&Ctrl;S). Mode simpan baru akan diingat untuk lain kali. Lokasi simpanan baku dan nama file bisa dikonfigurasi, seperti yang diterangjelaskan nanti.

Untuk secara cepat menyimpan gambar dan mengeluarkan &spectacle;, klik pada kotak centang sebelah Keluar setelah Simpan atau Salin, kemudian klik porsi panah tombol Simpan Sebagai... dan tekan item Simpan (&Ctrl;S). Ini menyimpan image sebagai file PNG di dalam folder baku Gambar kamu, dan segera mengeluarkan aplikasi. Sebagaimana disebutkan di atas, mode simpan baru ini akan diingat.

### Mengambil Sebuah Cuplikanlayar

Ketika kamu membuka &spectacle;, itu segera mengambil cuplikanlayar seluruh layar sebagai kenyamanan dan menampilkan sebuah pratinjau dalam jendela utama. Kamu bisa menyimpan cuplikanlayar ini menggunakan tombol pada bagian bawah jendela, atau ambil yang baru menggunakan kendali sebelah kanan pratinjau.

Untuk membuang cuplikanlayar saat ini dan mengambil cuplikanlayar lainnya, tekan tombol Ambil Cuplikanlayar Baru (&Ctrl;N).

Anda mungkin mau mengkonfigurasi pilihan tertentu pada sisi sebelah kanan pada jendela aplikasi sebelum mengambil sebuah cuplikanlayar. Opsi tersebut memungkinkan Anda untuk memilih area layar yang mau dijadikan tangkapan, setel tundaan sebelum penangkapan image, dan konfigurasi apakah kursor mouse dan/atau dekorasi jendela harus ditangkap sepanjang cuplikanlayar.

#### Mode Tangkap

Setelan mode tangkap memungkinkan Anda untuk menyetel area layar yang seharusnya ditangkap, dan apakah senarusnya tertunda antara menekan tombol Ambil Cuplikanlayar Baru (&Ctrl;N) dan pengambilan cuplikanlayar. Anda juga dapat mengaktifkan kotak centang Saat Klik, yang menonaktifkan fungsi tunda dan hanya mengambil cuplikanlayar setelah Anda klik di mana pun pada layar setelah mengeklik tombol Ambil Cuplikanlayar Baru (&Ctrl;N).

Kotak kombo Area memungkinkan Anda untuk menyetel area pada layar yang seharusnya ditangkap. Ada lima pilihan untuk memilih dari, seperti yang diterangjelaskan di bawah.

- Opsi Layar Penuh (Semua Monitor) mengambil sebuah cuplikanlayar pada seluruh desktop Anda, tersebar diseluruh semua output, termasuk semua monitor, proyektor dan sebagainya.

- Opsi Layar Saat Ini mengambil sebuah cuplikanlayar pada output yang saat ini berisi titik mouse.

- Opsi Jendela Aktif mengambil sebuah cuplikanlayar dari jendela yang saat ini sedang fokus. Itu tentu saja menggunakan sebuah tundaan dengan mode ini, untuk memberikan Anda waktu untuk memilih dan mengaktifkan sebuah jendela sebelum cuplikanlayar diambil.

- Opsi Jendela Bawah Kursor mengambil sebuah cuplikanlayar dari jendela yang di bawah kursor mouse. Jika kursornya berada di atas sembulan menu, &spectacle; mencoba untuk mengambil sebuah cuplikanlayar pada menu serta jendela induknya.

  Sementara ini sebagian besar bekerja dalam waktu, dalam kasus tertentu mungkin gagal untuk mendapatkan informasi tentang induk jendela. Dalam kasus ini, &spectacle; kembali ke cara lama untuk menangkap image secara otomatis, dan menangkap sebuah image hanya sembulan menu. Kamu juga bisa memaksa cara lama penangkapan image dengan mengeklik kotak centang Tangkap sembulan saat ini saja di bawah Opsi

- Opsi Bidang Persegi memungkinkan Anda untuk memilih sebuah bidang persegi pada desktop dengan mouse Anda. Bidang ini mungkin tersebar di berbagai output.

  Mode ini tidak segera mengambil sebuah cuplikanlayar tetapi memungkinkan Anda untuk membentuk sebuah persegi pada layar Anda, yang bisa dipindah dan diubah ukurannya sesuai yang diperlukan. Setelah pemilihan persegi yang diinginkan sudah tergambar, klik ganda di mana saja pada layar, atau menekan tombol &Enter; pada keyboard akan menangkap cuplikanlayar.

  Kamu bisa menggunakan tuts panah untuk memindah dan menyetel persegi. Menekan tuts panah akan memindah persegi. Menahan tuts &Shift; selagi menekan tuts panah akan memindah persegi secara perlahan, untuk penalaan-baik pemilihanmu. Menahan tuts &Alt; selagi menekan tuts panah akan menyetel ukurannya persegi.

Kotak spin Tunda memungkinkan Anda untuk menyetel tundaan antara menekan tombol Ambil Cuplikanlayar Baru (&Ctrl;N) dengan pengambilan cuplikanlayar. Tundaan ini bisa disetel naikkan 1 detik menggunakan tombol kotak spin atau keyboard.

Mengaktifkan kotak centang Saat Klik menimpa tundaan. Ketika kotak centang ini diaktifkan, menekan tombol Ambil Cuplikanlayar Baru (&Ctrl;N) menyembunyikan jendela &spectacle; dan mengubah kursor mouse menjadi sebuah silang. Cuplikanlayar telah ditangkap ketika mouse diklik kiri, atau digugurkan ketika tombol mouse yang lain diklik. Ingat Anda tidak bisa berinteraksi dengan desktop menggunakan mouse ketika kursor telah menjadi silang, tapi Anda bisa menggunakan keyboard.

#### Opsi

Setelan Opsi memungkinkanmu untuk memilih apakah kursor mouse seharusnya disertakan dalam cuplikanlayar, dan apakah menangkap dekorasi jendela bersamaan dengan image pada sebuah jendela aplikasi tunggal. Dalam mode Jendela Bawah Kursor, itu juga memungkinkanmu untuk memilih jika &spectacle; hanya akan menangkap image pada menu sembul saat ini di bawah kursor, atau juga menyertakan induk jendela. Yang terakhir, Keluar setelah Simpan atau Salin akan mengeluarkan &spectacle; sesudah operasi simpan atau salin.

- Mengaktifkan kotak centang Sertakan titik mouse menyertakan sebuah image dengan titik mouse di dalam cuplikanlayar.

- Opsi Sertakan bilah-judul dan tepi jendela hanya diaktifkan ketika antara mode Jendela Aktif atau mode Jendela Bawah Kursor telah dipilih dalam kotak kombo Area. Mencentang pilihan ini menyertakan tepi jendela dan dekorasi dalam cuplikanlayar, sementara menghilangkan centangnya memberikan image hanya konten jendela.

- Opsi Tangkap sembulan saat ini saja hanya diaktifkan ketika mode Jendela Bawah Kursor telah dipilih dalam kotak kombo Area. Mencentang pilihan ini hanya menangkap sembulan menu di bawah kursor, tanpa menyertakan induk jendela.

- Opsi Keluarkan setelah Simpan atau Salin akan mengeluarkan &spectacle; setelah operasi penyimpanan atau penyalinan apa pun. Ingat bahwa cuplikanlayar yang disalin hanya akan dipertahankan jika kamu telah menjalankan pengelola clipboard yang menerima image. KDE Klipper bisa dikonfigurasi dalam cara ini dengan mengeklik kanan pada ikonnya, memilih Konfigurasi Clipboard..., dan menghapus centang Abaikan image.

## Fungsionalitas Tambahan

### Tombol

Ada beberapa tombol berlokasi di bagian bawah jendela &spectacle;. Fungsi tersebut telah diterangjelaskan di bawah ini:

Bantuan

- Memberikan kamu item menu umum yang diterangjelaskan di Menu Bantuan pada &kde; Fundamental.

Konfigurasi...

- Memberikanmu akses terhadap jendela Konfigurasi &spectacle; yang mana kamu bisa mengubah setelan tangkapan, nama file dan lokasi simpanan baku.

Alat

- Pembukaan sebuah menu tarik-turun yang menawarkan berbagai alat:

  - Buka Folder Cuplikanlayar akan menyorot cuplikanlayar yang terakhir disimpan di dalam pengelola file baku

  - Akses ke dialog Cetak

  - Sebuah rentangan program eksternal untuk Perekaman Layar

Ekspor

- Pembukaan sebuah menu tarik-turun yang akan memperkenankanmu secara langsung membuka cuplikanlayar dengan semua program yang berhubungan dengan &MIME; tipe PNG (Portable Network Graphics). Tergantung pada program apa yang terpasang, kamu bisa membuka dan mengedit cuplikanlayar di aplikasi penampil atau aplikasi grafismu.

  Selanjutnya, jika Anda memiliki KIPI Plugins yang terpasang, Anda akan mampu untuk meng-email dan mengexpor cuplikanlayar secara langsung ke berbagai jaringan sosial dan situs web.

Salin ke Clipboard

- Penyalinan cuplikanlayar saat ini ke clipboard. Kamu juga bisa menggunakan pintasan keyboard &Ctrl;C untuk ini.

Simpan Sebagai

- Penyimpanan cuplikanlayar sebagai image PNG dalam folder Gambar bakumu dan segera mengeluarkan aplikasi.

### Konfigurasi

Gunakan tombol Konfigurasi... untuk membuka dialog konfigurasi.

#### Umum

Umum

Salin lokasi file ke clipboard setelah penyimpanan

- Ketika cuplikanlayar disimpan, salin lokasi penyimpanan file tersebut ke clipboard. Anda kemudian bisa menempel di mana pun yang menerima input teks. Ingat Anda harus menjalankan pengelola clipboard dalam urutan untuk supaya alur tetap dalam clipboard setelah &spectacle; keluar.

Gunakan latarbelakang terang

- Gunakan sebuah warna latarbelakang terang untuk menopengi di area luar pangkasan dalam pemilihan bidang persegi. Ini mungkin membuat kursor gelap mudah terlihat.

Ingat area terpilih

- Menurut baku, &spectacle; tidak menampilkan inisial pemilihan ketika Anda mengambil sebuah cuplikanlayar dengan bidang persegi. Aktifkan pilihan ini untuk mengingat bidang yang dipilih terakhir pada layar, dan menyetelnya sebagai inisial pemilihan ketika Anda menggunakan pemilih bidang persegi dilain waktu.

#### Simpan

Ketika kamu menggunakan fungsi Simpan, &spectacle; menyimpan image dengan nama file baku, dalam folder Gambar kamu (yang ada di dalam folder berandamu). Nama file baku menyertakan tanggal dan waktu ketika image diambil.

Halaman Simpan memperkenankanmu untuk menyetel lokasi simpanan dan nama file baku. Mengeklik opsi ini menampilkan sebuah kotak dialog seperti berikut ini: Simpan

Lokasi Baku Simpanan

- Pada kotak teks Lokasi setellah folder di mana kamu ingin menyimpan cuplikanlayarmu ketika kamu menekan Simpan.

Simpanan Baku Nama File

- Setel sebuah nama file baku untuk menyimpan cuplikanlayar.

  Anda bisa menggunakan placeholder berikut ini di dalam nama file , yang akan digantikan dengan teks sebenarnya ketika file disimpan:

  - `%Y`: Tahun (4 digit)

  - `%y`: Tahun (2 digit)

  - `%M`: Bulan

  - `%D`: Hari

  - `%H`: Jam

  - `%m`: Menit

  - `%S`: Detik

  - `%T`: Judul jendela

  Jika file dengan nama ini sudah ada, sebuah angka serial akan dibubuhkan ke nama file . Contohnya, jika nama file nya adalah `Screenshot`, dan `Screenshot.png` sudah ada, image akan disimpan sebagai `Screenshot-1.png`.

  Mengetik sebuah ekstensi ke dalam nama file akan secara otomatis menyetel format image dengan benar dan menghapus ekstensi dari bidang nama file.

### Seret dan Jatuhkan

Sebuah image yang ditangkap bisa diseret ke dokumen atau aplikasi lainnya. Jika aplikasi mampu menangani image, sebuah salinan image penuh disematkan di situ.

Jika Anda seret cuplikanlayar ke dalam jendela pengelola file , sebuah sembulan dialog di mana Anda bisa mengedit nama file dan memilih format image dan file akan dimasukkan ke dalam folder sebenarnya.

Jika Anda seret cuplikanlayar ke kotak teks, alur ke file simpanan temporer disertakan. Ini berguna sebagai contoh untuk mengunggah sebuah cuplikanlayar melalui formulir web atau untuk melampirkan cuplikanlayar ke dalam laporan bug pada &kde; bugtracker.

Ini bekerja dengan semua klien yang tidak mengangkut data image, tetapi hanya melihat &URL; di dalam mimedata yang diseret.

## Kredit dan Lisensi

Hakcipta program © 2015 &Boudhayan.Gupta; &Boudhayan.Gupta.mail;.

Bagian dari kode yang berbasiskan langsung pada kode dari proyek &ksnapshot;. Hak cipta © 1997-2011 Pengembang &ksnapshot;. Notifikasi penyerahan hak cipta terperinci tersedia di header di dalam kode sumber.

Bagian dari kode yang berbasiskan langsung pada kode dari proyek &ksnapshot;. Hak cipta © 2008, 2013 Pengembang &ksnapshot;. Notifikasi penyerahan hak cipta terperinci tersedia di header di dalam kode sumber.

Dokumentasi berbasiskan pada dokumentasi asli &ksnapshot;:

- Hak cipta © 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

- Hakcipta © 2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;

Wantoyowantoyek@gmail.com

&underFDL; &underGPL;
&documentation.index;