# Podręcznik użytkownika aplikacji &ksnapshot-mianownik;

## Wprowadzenie

&ksnapshot-mianownik; są prostym w obsłudze apletem do robienia zrzutów ekranu. Przy ich pomocy możesz przechwytywać obrazy całego pulpitu, pojedynczego okna, albo tylko fragmentu okna. Możesz je później zapisać w różnorodnych formatach.

Jakiekolwiek problemy lub sugestie związane z aplikacją zgłaszaj do Systemu śledzenia błędów &kde;

## Korzystanie z &ksnapshot-dopelniacz;

Ten rozdział opisuje sposób korzystania z &ksnapshot-dopelniacz; do robienia zrzutów ekranu.

### Uruchamianie &ksnapshot-dopelniacz;

&ksnapshot-mianownik; mogą być uruchomione na jeden z wielu sposobów, wymienionych poniżej.

- Możesz uruchomić &ksnapshot-biernik;, wybierając z Menu K Programy Grafika &ksnapshot-mianownik; (Program do zrzutów ekranu).

- Możesz uruchomić &ksnapshot-dopelniacz; wpisując, co następuje, w wierszu poleceń:

      % ksnapshot &

- Linia polecenia &krunner; (wywołana przez &Alt;F2) może również służyć do uruchomienia &ksnapshot-dopelniacz;

Jak tylko uruchomisz &ksnapshot-mianownik;, zobaczysz takie okno: Okno podglądu &ksnapshot-dopelniacz;

### Robienie zrzutu ekranu

&ksnapshot-mianownik; przechwytują widok pulpitu natychmiast po uruchomieniu, ale jeszcze przed wyświetleniem się na ekranie. To pozwala na szybkie tworzenie zrzutów ekranu.

Zrzut ekranu, zrobiony przez &ksnapshot-biernik; jest wyświetlany w oknie podglądu, które znajduje się w górnej części okna aplikacji &ksnapshot-mianownik;. Poniżej znajduje się przykładowe okno podglądu &ksnapshot-dopelniacz;. Podgląd będzie się różnił, w zależności od tego, co było wyświetlone na pulpicie.

Okno podglądu &ksnapshot-dopelniacz;

Zrzut zapisać można, klikając na przycisku Zapisz jako.... Zostanie wtedy otwarte standardowe okno zapisywania &kde;, gdzie można wybrać nazwę pliku, położenie i format wykonanego zrzutu. Jeśli wykonano więcej niż jeden zrzut ekranu, nazwa pliku jest automatycznie dopasowana, aby uniknąć nadpisywania poprzednich zrzutów. Możesz jednak zmienić nazwę pliku na jakąkolwiek inną, również na nazwę poprzednio zapisanego zrzutu.

Aby dokonać zrzutu pojedynczego okna, z rozwijanej listy Tryb zrzutów wybierz Okno pod kursorem, a następnie kliknij przycisk Nowy zrzut.

W zależności od ustawienia w oknie Opóźnienie:, możesz albo uzyskać krzyżyk, jako wskaźnik myszy (dla opcji Bez opóźnienia), albo pracować ze zwykłym kursorem dopóki nie minie określony czas i nie zostanie zrobiony zrzut.

Przy wybranej opcji Bez opóźnienia, zrzut jest robiony natychmiast, gdy tylko klikniesz na oknie.

&ksnapshot-mianownik; wyświetlą nowy zrzut w obszarze podglądu. Możesz teraz wybrać, czy zapisać zrzut (klikając na Zapisz jako ...), czy zrobić nowy, wciskając przycisk Nowy zrzut.

Aby zrobić nowy zrzut całego pulpitu, z listy rozwijanej wybierz opcję Pełny ekran, a następnie kliknij przycisk Nowy zrzut, dzięki czemu &ksnapshot-mianownik; przechwycą cały pulpit.

Aby zrobić nowy zrzut całego pulpitu, z rozwijanej listy wybierz Obszar i ustaw Opóźnienie na Bez opóźnienia, a następnie kliknij przycisk Nowy zrzut. Kursor myszy zmieni się w krzyżyk, który umożliwi zaznaczenie obszaru do przechwycenia.

Aby wykonać nowy zrzut fragmentu okna, z rozwijanej listy wybierz Część okna i kliknij przycisk Nowy zrzut. Jeśli wybrana jest opcja Bez opóźnienia, kursor myszy zmieni się w krzyżyk, a pojedyncze kliknięcie lewym przyciskiem myszy wewnątrz okna spowoduje podświetlenie fragmentu okna czerwoną linią i wykonanie zrzutu.

### Cechy dodatkowe

#### Opóźnienie

Opcja Opóźnienie: pozwala na określenie czasu, w sekundach, jaki upłynie między kliknięciem na przycisk Nowy zrzut, a momentem dokonania przez aplikację zrzutu.

Jeśli określiłeś opóźnienie, nie musisz klikać myszą, aby dokonać zrzutu. To umożliwia Ci np. otworzenie menu rozwijanego i zrobienie jego zdjęcia.

#### Wyłącz dekorację okna

Dołącz dekorację okna jest ustawione domyślnie w trybie Okno pod kursorem.

Jeśli chcesz dokonać tylko zrzutu aplikacji, bez otaczających dekoracji okna, zdezaktywuj tą opcję i dokonaj nowego zrzutu.

#### Kopiuj do schowka

Jeśli chcesz edytować swój zrzut ekranu w programie do przeglądania lub edycji grafiki bez zapisywania obrazka, kliknij Kopiuj do schowka i wklej obrazek do odpowiedniego programu.

#### Przyciski

Na dole okna &ksnapshot-dopelniacz; znajdują się dwa dodatkowe przyciski. Ich funkcje są opisane poniżej.

Pomoc

- Otwiera menu, w którym możesz znaleźć Podręcznik użytkownika aplikacji &ksnapshot-mianownik;, złożyć raport o błędzie, zmienić język programu lub uzyskać informacje o &kde; i o aplikacji &ksnapshot-mianownik;.

Zamknij

- Zamyka aplikację &ksnapshot-mianownik;.

## Interfejs &DBus;

&ksnapshot-mianownik; obsługuje skrypty. Mechanizm ten korzysta z interfejsu &DBus;. Ten rozdział wyjaśnia różne wywołania &DBus;, których można używać, oraz podaje przykłady ich użycia.

Jak we wszystkich wywołaniach &DBus; musisz podać program, który ma być wykorzystany, oraz dany interfejs. Dla &ksnapshot-dopelniacz; należy podać nazwę programu, czyli `ksnapshot-` wraz z numerem procesu.

Aby uruchomić &ksnapshot-biernik; i uzyskać poprawny argument, użyj `dcopstart ksnapshot`, co zwraca argument (jak `ksnapshot-20594`) w standardowym wyjściu.

Możesz pobrać listę dostępnych interfejsów &DCOP;, używając poprawnych argumentów, jak w poniższym przykładzie:

    $ dcop `dcopstart ksnapshot` interface
    QCStringList interfaces()
    QCStringList functions()
    QString url()
    void slotGrab()
    void slotPrint()
    void slotSave()
    bool save(QString filename)
    void slotSaveAs()
    void slotCopy()
    void setTime(int newTime)
    int timeout()
    void setURL(QString newURL)
    void setGrabMode(int grab)
    int grabMode()
    void slotMovePointer(int x,int y)
    void exit()

W poniższych przykładach procesem jest zawsze `ksnapshot-23151`.

### Dostęp &DCOP; do ustawień

Dla każdego ustawienia, które możesz kontrolować za pomocą &GUI-dopelniacz;, możesz uzyskać stan danego ustawienia i zmienić to ustawienie za pomocą &DCOP;.

Bieżący tryb zrzutów możesz uzyskać, używając `grabMode`, jak poniżej:

    $ dcop ksnapshot-23151 interface grabMode

Spowoduje to zwrócenie `0` dla przechwytywania całego ekranu, `1` dla okna lub `2` dla obszaru.

Możesz ustawić tryb zrzutów, używając `setGrabMode`, co wymaga argumentu identyfikującego wymagany trybu (jak dla `grabMode`). Możesz więc ustawić tryb przechwytywania okna (`1`), używając:

    $ dcop ksnapshot-23151 interface setGrabMode 1

Możesz uzyskać bieżące ustawienia opóźnienia, używając `timeout`, jak poniżej:

    $ dcop ksnapshot-23151 interface timeout

Spowoduje to zwrócenie ustawienia opóźnienia w sekundach lub wartości zero dla braku opóźnienia (przechwytywania kliknięciem).

Możesz zmienić ustawienia opóźnienia, używając `setTime`, co wymaga argumentu identyfikującego okres opóźnienia. Możesz więc ustawić 4-sekundowe opóźnienie, używając:

    $ dcop ksnapshot-23151 interface setTime 4

Możesz uzyskać informacje o ścieżce zapisu zrzutów, używając `url`, jak poniżej:

    $dcop ksnapshot-23151 interface url

Spowoduje to zwrócenie nazwy pliku w postaci adresu &URL; (np. `file:///home/bradh/test2.png`).

Możesz ustawić ścieżkę zapisu, używając `setURL`, co wymaga argumentu identyfikującego nową ścieżkę. Możesz więc ustawić ścieżkę na `file:///home/bradh/snapshot.jpg`, używając:

    $ dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg

### Wykonywanie zrzutów ekranu z &DCOP;

Aby wykonać zrzut ekranu z &DCOP;, należy użyć `slotGrab`, jak poniżej:

    $ dcop ksnapshot-23151 interface slotGrab

Zostanie wykonany zrzut ekranu przy użyciu bieżącego trybu zrzutów i ustawień opóźnienia (jak opisano powyżej). Jeśli chcesz zapisać zrzut ekranu, możesz użyć określonej liczby wywołań. Jeśli chcesz zapisać obrazek do bieżącej ścieżki (zwróconej przez `url` lub zmienionej za pomocą `setURL`), możesz użyć `slotSave`, jak poniżej:

    $ dcop ksnapshot-23151 interface slotSave

Jeśli chcesz zezwolić użytkownikowi na określenie nazwy pliku (i ścieżki), możesz użyć `slotSaveAs`, co spowoduje pojawienie się standardowego okna zapisu pliku &kde;.

Jeśli chcesz zapisać obrazek pod inną nazwą (lub ścieżką) bez zmieniania ścieżki za pomocą `setURL`, możesz użyć `save`, podając jednocześnie adres żądany &URL; jako argument. Jeśli więc chcesz zapisać zrzut ekranu do `file:///tmp/tempshot.png`, wykonaj:

    $ dcop ksnapshot-23151 interface save file:///tmp/tempshot.png

Spowoduje to zwrócenie prawdy, jeśli zrzut zostanie poprawnie zapisany lub fałszu w przeciwnym wypadku. Zauważ również, że jeśli plik już istnieje, powinno pojawić się standardowe okno &kde;, pozwalające decydować o tym, czy nadpisać istniejący plik, czy zapisać go pod inną nazwą.

Oprócz zapisywania zrzutu, możesz również skopiować go do schowka, używając `slotCopy`, jak poniżej:

    $ dcop ksnapshot-23151 interface slotCopy

Jeśli potrzebujesz wybrać okno, które może nie być pod kursorem myszy, użyj `slotMovePointer`, podając pozycję x (w pikselach) oraz pozycję y (również w pikselach) jako argumenty. Aby więc przenieść kursor myszy do lewego górnego rogu ekrany (0,0), wykonaj:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Drukowanie zrzutów z &DCOP;

Możesz wydrukować bieżący zrzut ekranu (który może, ale nie musi być zapisany), używając `printSlot`, jak poniżej:

    $ dcop ksnapshot-23151 interface slotPrint

Zostanie wywołane normalne okno drukowania &kde;, które może wymagać interakcji użytkownika.

### Kontrola programu z &DCOP;

Możesz zakończyć pracę programu &ksnapshot-mianownik;, używając `exit`, jak poniżej.

    $ dcop ksnapshot-23151 interface exit

## Autorzy i licencja

Prawa autorskie

- 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

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

Dokumentacja bazuje na oryginale, copyright 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

Suse Polskasuse@suse.pl

Maciej Wikłomaciej.wiklo@wp.pl

&underFDL; &underGPL;
&documentation.index;