# Podręcznik użytkownika programu &noatun-mianownik;

## Wprowadzenie

&noatun-mianownik; jest w pełni funkcjonalnym, bazującym na wtyczkach odtwarzaczem plików multimedialnych dla &kde;.

### Funkcjonalność

&noatun-mianownik; jest doskonałą nakładką graficzną dla &arts; — analogowego syntezatora czasu rzeczywistego. Aby dodać dodatkowe moduły dźwiękowe, wejdź na stronę http://noatun.kde.org/plugins/ lub http://mpeglib.sf.net. Domyślnie &arts; obsługuje MP3 i MPEG-1. Vorbis jest także obsługiwany, jeżeli jego biblioteki były dostępne podczas kompilacji &kde;.

## Korzystanie z &noatun-dopelniacz;

&noatun-mianownik; domyślnie startuje z wtyczką motywu Doskonały interfejs użytkownika. Interfejs ten został wybrany ze względu na największe podobieństwo do innych interfejsów programów środowiska &kde;.

&noatun-mianownik; jest unikalny dlatego, że każde dwie instalacje mogą różnić się między sobą oraz mogą posiadać różne interfejsy użytkownika. Istnieje jednak interfejs, który wybierany jest domyślnie. Masz pełną dowolność w doborze wtyczek, możesz dowolnie dostosować sobie &noatun-dopelniacz; tak, aby stał się Twoim idealnym odtwarzaczem!

### Format tytułu

W oknie ustawień ogólnych &noatun-dopelniacz; znajduje się pole Format tytułu. Możesz podać tam napis, określający jak ma wyglądać wyświetlany tytuł.

- Tekst będzie się pojawiał standardowo, dopóki nie jest otoczony znakami `$( )`.

- Tekst `$( )` zostanie zastąpiony właściwością &noatun-dopelniacz; o podanej w nawiasach nazwie.

- Jeśli wewnątrz `$( )` znajdują się cudzysłowy, przytaczany tekst będzie wyświetlany standardowo, ale tylko, jeśli właściwość podanej nazwie istnieje.

- Cudzysłowy mogą być zarówno na początku `$( )`, jak i na końcu lub jednocześnie na początku i na końcu

Na przykład `$(bitrate)` zostanie zastąpiony przez szybkość transmisji pliku, tak jak zostanie to odczytane przez wtyczkę Metatag. Jednakże, jeśli wstawisz cudzysłów w to pole, zostanie wyświetlony również tekst z cudzysłowów: na przykład `$(bitrate"kbps")` wyświetli szybkość transmisji pliku z dopiskiem `"kbps"`. Natomiast nic nie zostanie wyświetlone, jeśli właściwość bitrate nie istnieje.

## Używanie wtyczek &noatun-dopelniacz;

Możesz użyć różnych wtyczek, korzystając z menu Ustawienia Konfiguracja: &noatun-mianownik;.... Przejdź do zakładki Wtyczki i zaznacz na liście interesującą Cię wtyczkę. &noatun-mianownik; wymaga zaznaczenia przynajmniej jednej wtyczki odpowiadającej za wyświetlanie interfejsu użytkownika oraz dokładnie jednej obsługującej listę utworów.

### Czekolada mleczna

Czekolada mleczna jest małym, prostym interfejsem użytkownika . Przyciski działają jak w odtwarzaczu CD: przycisk wysuń otwiera listę utworów. Przycisk przekreślonej kartki usuwa zawartość bieżącej listy utworów, ale nie usuwa pliku (plików) z dysku, przycisk strzałki ustawia tryb powtarzania. Menu jest dostępne przez kliknięcie prawym przyciskiem myszy w dowolnym obszarze okna.

### Tacka systemowa

Tacka systemowa jest wtyczką tacki systemowej programu. Domyślnie wyświetlana blisko zegara.

Po kliknięciu prawym przyciskiem myszy na ikonę pokaże się małe menu, klikając lewym, przełączysz się do okna &noatun-dopelniacz;. Zauważ, że np. Lista utworów nie jest uważana za interfejs użytkownika.

### Eksport listy utworów do formatu HTML

Wtyczka ta umiejscowi twoją listę utworów w tabeli HTML. Strona właściwości pozwoli Ci na ustawianie kolorów i na wybranie obrazka tła.

Po ustawieniu opcji, wybranie z menu Działania pozycji Eksport listy utworów... otworzy dialogowe, w którym będzie można wskazać miejsce zapisu pliku z wyeksportowaną listą utworów.

### K-Jöfol

Ładowarka skórek K-Jöfol jest odpowiednikiem programu o tej samej nazwie w systemie &Windows;.

Implementacja &noatun-dopelniacz; ma niestety kilka ograniczeń. Skórki muszą zostać rozpakowane, aby móc z nich skorzystać.

Aby zainstalować skórki (w formacie ZIP), możesz skorzystać z instalatora skórek, który znajduje się w oknie preferencji &noatun-dopelniacz;.

Niektóre skórki są spakowane niepoprawnie. Instalator skórek nie może być przygotowany na wszystko, więc jeśli instalacja jakiejś skórki się nie powiedzie, możesz spróbować skorzystać z tych poleceń:

    % cd $KDEHOME/share/apps/noatun
    % mkdir kjskins (jeśli trzeba)
    % cd kjskins
    % mkdir nowa_skórka ; cd nowa_skórka
    % unzip /ścieżka/do/nowa_skórka.zip

Możesz także stworzyć własną skórkę, korzystając z samouczka, znajdującego się na stronie http://www.angelfire.com/mo/nequiem/tutorial.html.

### Podzielona lista nagrań

Podzielona lista nagrań ma prosty, klasyczny interfejs. Podwójne kliknięcie na wpis rozpoczyna odtwarzanie (podobnie zaznacznie i naciśnięcie klawisza Enter). Jeżeli chcesz, możesz również przeciągać nazwy plików lub adresy &URL; na obszar listy. Dzięki temu tworzenie Twojej listy nagrań będzie niezwykle proste.

Od &kde; 3.0, podzielona lista nagrań (SPL) przechowuje dane w formacie &XML;, ale potrafi również automatycznie zaimportować listę utworów z pliku m3u, jeżeli nie istnieje plik w formacie &XML;. Oznacza to, że możesz zapisywać dane w pliku m3u, i usunąć pliki w formacie &XML;, aby automatycznie generować listy odtwarzania.

Nazwa "Podzielona lista nagrań" jest trochę błędna, ponieważ lista ta tak naprawdę nie jest nigdzie podzielona. Nazwa pochodzi z oryginalnego projektu (wczesne wersje &noatun-dopelniacz;), który miał listę podzieloną.

### Motywy WinAmpa

Jeśli używasz motywów (skórek) Winampa, powinieneś czuć się jak u siebie. Klikając na licznik czasu zostaniesz przełączony pomiędzy trybem odliczania w górę i w dół. Wskazując obszar wyśietlania napisu spowodujesz jego zatrzymanie/wznowienie. Możesz również kliknąć dwa razy na na pasek tytułu, aby przejść do trybu zminimalizowanego. Kliknięcie Prawym przyciskiem myszy (lub na ikonie w lewym górnym rogu okna) uruchomi standardowe menu podręczne &noatun-dopelniacz;.

Możesz zainstalować nowe skórki w `$KDEHOME/share/apps/noatun/skins/winamp`, tworząc dla nich folder, a nastepnie rozpakowując skórki w to miejsce. Pliki skórek Winampa z rozszerzeniem `.wsz` są tak naprawdę plikami zip. Niekiedy musisz najpierw zmienić ich nazwę, aby móc je rozpakować.

### Metatag

Metatag jest wtyczką, która wczytuje informacje o plikach, dzięki użyciu wtyczek KFile, tych samych, które pozwalają podglądać informacje o plikach w &konqueror-miejscownik;, gdy przesuniesz kursor myszy nad plik. Poza wczytywaniem znaczników, obsługiwana jest ich zmiana przez wybranie z menu Działania opcji Edytor Znaczników. Możliwa jest zmiana znaczników ID3, jak i OggVorbis. Wtyczka obsługuje również czytanie szybkości transmisji pliku.

### Keyz

Wtyczka skrótów klawiszowych.

Wtyczka pozwala na dodawanie skrótów klawiszowych do niektórych działań &noatun-dopelniacz;. Największą zaletą wtyczki jest to, że skróty będą działały niezależnie od tego, czy okno &noatun-dopelniacz; jest aktywne. Nareszcie wszystkie klawiatury multimedialne stają się użyteczne.

### Sterowanie przez podczerwień

Jeśli posiadasz pilota do swojego komputera (takiego jak pilot do kart telewizyjnych z tunerami Brooktree) i Twój pilot na podczerwień jest obsługiwany przez program LIRC, powinieneś mieć możliwość zdalnego sterowania programem.

Aby przypisać zdarzenia do przycisku, włącz wtyczkę i przejdź do zakładki Sterowanie podczerwienią w oknie ustawień &noatun-dopelniacz;. Wybierz przyciski z listy, następnie wybierz zdarzenia dostępne na liście poniżej. Jeśli chcesz, aby zdarzenia, takie jak zwiększanie głośności dźwięku, powtarzały się przy przytrzymywaniu przycisku pilota, zaznacz odpowiednie pole i ustaw odstęp pomiędzy powtórzeniami działania.

Jeśli posiadasz kartę TV, przydatną sztuczką jest przypisanie przycisku Mute do Pauzy. Pozwoli To na wyciszenie Twojej karty TV podczas odtwarzania plików w &noatun-miejscownik; i na odwrót, co przydaje się zwłaszcza w czasie przerw na reklamy.

## Pytania, odpowiedzi i rady

## Najczęściej zadawane pytania

Muzyka przeskakuje kiedy poruszam oknem.

Być może musisz zwiększyć bufor &arts;, zgodnie z poniższymi wskazówkami:

- Uruchom &kcontrolcenter-mianownik;

- Przejdź do grupy Dźwięk

- Przejdź do sekcji System dźwiękowy

- Zwiększ bufor dźwięku — 384ms zwykle wystarcza dla większości komputerów.

Możesz rozważyć także uruchomienie systemu dźwiękowego z najwyższym możliwym priorytetem (czasu rzeczywistego), jeżeli zwiększenie bufora nie przyniosło rezultatu. Musisz być świadomy tego, że może to zablokować Twój system.

Nie mogę usunąć listy utworów i interfejsu użytkownika z listy wtyczek.

Ponieważ &noatun-mianownik; wymaga przynajmniej jednej aktywnej wtyczki interfejsu użytkownika oraz listy utworów, musisz włączyć inną wtyczkę interfejsu przed wyłączeniem starej. Dodanie nowej listy utworów automatycznie usunie starą.

Gdzie znajdę więcej wtyczek?

Niezależni programiści mogą umieszczać swoje wtyczki na stronie &noatun-dopelniacz;, skąd użytkownicy mogą je pobrać.

Jak napisać wtyczkę &noatun-dopelniacz;?

Dokumentacja wywołań API oraz przykładowy kod źródłowy dostępne są na stronie &noatun-dopelniacz;. W duchu wolnego oprogramowania, kod źródłowy &noatun-dopelniacz; i domyślnych wtyczek jest również dostępny.

## Autorzy i licencja

Prawa autorskie: 2000-2002 Charles Samuels charles@kde.org

Dokumentacja: 2002 Charles Samuels charles@kde.org

&noatun-mianownik; został stworzony przez następujących ludzi:

- Charles Samuels charles@kde.org

- Neil Stevens multivac@fcmail.com

- Stefan Westerfeld stefan@space.twc.de

- Martin Vogt mvogt@rhrk.uni-kl.de

- Malte Starostik malte.starostik@t-online.de

- Nikolas Zimmermann wildfox@kde.org

- Stefan Schimanski 1Stein@gmx.de

Polskie tłumaczenie: (c) 2005 Mandriva Polandbiuro@mandriva.pl

Uaktualnienie tłumaczenia Mandrivy: Marcin Kocur marcinkocur@op.pl

&underFDL; &underBSDLicense;

## Instalacja

### Jak zdobyć &noatun-dopelniacz;

&install.intro.documentation;

### Wymagania

&noatun-mianownik; wymaga przynajmniej procesora klasy Pentium 200 pod &Linux-narzednik;, procesora PowerPC pod &Linux-narzednik; 2.4.1 lub późniejszym. Program działa też na kilku innych platformach. Obsługa kolejnych platform będzie dodana w kolejnych wersjach.

Najłatwiej będzie przygotować wersje na platformy, które obsługują wątki pthread i system dźwiękowy OSS (ALSA jest również obsługiwana pod &Linux-narzednik;).

### Kompilacja i instalacja

&install.compile.documentation;

Jeśli napotkasz jakieś problemy, proszę napisz do autoracharles@kde.org.

Jeśli posiadasz tę dokumentację, prawdopodobnie masz już działającą wersję &noatun-dopelniacz;

## Słownik

Czekolada mleczna

Czekolada mleczna jest prostą, minimalną wtyczką interfejsu użytkownika

&arts;

&arts; jest analogowym syntezatorem czasu rzeczywistego. To potężny system dźwiękowy, używany przez &noatun-dopelniacz;

K-Jöfol

Wtyczka potrafi użyć skórek stosowanych oryginalnie pod odtwarzaczem o tej samej nazwie, działającym pod systemem &Windows;.

Keyz

Keyz to wtyczka, która pozwala na przypisanie skrótów klawiszowych dla wybranych akcji &noatun-dopelniacz;

Tacka systemowa

Tacka systemowa to wtyczka dokowania w tacce systemowej.

Noatun

Kaiman jest wtyczką ładującą skórki z odtwarzacza GQMPEG. Kaiman jest także poprzednikiem &noatun-dopelniacz; i był dystrybuowany w &kde; w wersji 2.0. Kiedy &noatun-mianownik; został dodany do &kde; 2.1, Kaiman został wtyczką ładowania skórek dla &noatun-dopelniacz;.

&documentation.index;