<para>&khexedit; jest edytorem surowych danych w plikach binarnych. Udostępnia on funkcję wyszukiwania i zamieniania, wstawianie zakładek, wiele opcji konfiguracyjnych, mechanizm przeciągnij i upuść oraz wiele innych zaawansowanych narzędzi.</para>
<para>Należy wpisać <userinput><command>khexedit</command></userinput> w linii poleceń lub wybrać pozycję <guimenuitem>Edytor binarny</guimenuitem> z grupy <guisubmenu>Narzędzia</guisubmenu> w menu startowym środowiska KDE.</para>
<para>Dostępne są standardowe opcje linii poleceń &Qt; oraz &kde;. Można je wyświetlić za pomocą polecenia <userinput><command>khexedit</command> <option>--help</option></userinput>. </para>
<para><option>--offset</option> <replaceable><pozycja></replaceable> Skok do określonego przez <replaceable><pozycja></replaceable> miejsca w otwieranym pliku.</para>
<para>Główne okno programu &khexedit; składa się z następujących elementów: paska menu, paska narzędzi, kolumny z pozycją, okna edytowanych danych, okna tekstowego, paska wyszukiwania, pola konwersji i paska stanu. </para>
<para>Po otwarciu pliku, jego zawartość wyświetlana jest jako wartości bajtów w zapisie szesnastkowym w oknie edytora. Dane te mogą być zmieniane, wycinane, kopiowane, wklejane, przeciągane i upuszczane podobnie jak tekst w edytorze tekstu. Kursor określa bieżącą pozycję w pliku. Naciśnięcie klawisza <keycap>Insert</keycap> przełącza tryby wstawiania i nadpisywania. Dane mogą być wyświetlone również w zapisie ósemkowym, binarnym lub dziesiętnym, po wybraniu odpowiedniej pozycji z menu <guimenu>Widok</guimenu>.</para>
<para>Kolumna "pozycja" po lewej stronie okna edytora przedstawia pozycję poszczególnych wyświetlanych bajtów w pliku. Pole "tekst" po prawej stronie wyświetla odpowiedniki znakowe bajtów w kodzie <acronym>ASCII</acronym>. Pozycja kursora oraz dokonywane zmiany są widoczne jednocześnie w polu tekstowym i polu edycji danych (zmian można dokonywać zarówno w polu z danymi jak i polu tekstowym).</para>
<para>Pasek wyszukiwania pozwala użytkownikowi na znalezienie określonej wartości, którą można definiować szesnastkowo, ósemkowo, binarnie, dziesiętnie lub jako tekst.</para>
<para>Wiele dokumentów może być otwartych jednocześnie, jednak aktywny może być tylko jeden. Za pomocą menu <guimenu>Dokumenty</guimenu> użytkownik może dokonać wyboru aktywnego dokumentu.</para>
<listitem><para><action>Eksportuje wybrany dokument lub jego część.</action></para><para>Spowoduje otwarcie okna dialogowego z następującymi opcjami:</para>
<listitem><para>Zwykły tekst, tablica <acronym>HTML</acronym>, tekst sformatowany RTF, tabelka w C. Karta <guilabel>Opcje</guilabel> pozwala na określenie parametrów formatowania dla tabelki w C lub tabelki <acronym>HTML</acronym>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Cel</guilabel></term>
<listitem><para>Plik do którego zostaną zapisane wyeksportowane dane</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zakres</guilabel></term>
<listitem><para>Pozwala na wybranie zakresu danych do wyeksportowania - może to być cały dokument, jego zaznaczony fragment lub zakres od/do podanych pozycji.</para></listitem>
<listitem><para><guimenuitem>Kopiuj jako tekst</guimenuitem>: Kopiuje zaznaczone w dokumencie bajty jako znaki kodu <acronym>ASCII</acronym>.</para></listitem>
<listitem><para><guimenuitem>Wklej do nowego pliku</guimenuitem>.</para></listitem>
<listitem><para><guimenuitem>Wklej do nowego okna.</guimenuitem></para></listitem>
<listitem><para><action>Szuka w dokumencie podanego ciągu bajtów.</action> Wzorce wyszukiwania mogą być podane w zapisie szesnastkowym, oktalnym, binarnym lub tekstowym.</para>
<para>Opcje w wyświetlonym oknie dialogowym pozwalają na określenie początkowej pozycji, kierunku i zakresu wyszukiwania.</para></listitem>
<listitem><para><action>Wstawia do pliku podany ciąg bajtów.</action></para>
<para>Ustawiając opcje w wyświetlonym oknie dialogowym można określić długość wzorca, jego format (szesnastkowy, dziesiętny, ósemkowy, binarny lub tekstowy) oraz pozycję, w której należy go wstawić.</para>
<para>Jeżeli zaznaczona została opcja <guilabel>Powtarzaj wzorzec</guilabel>, to będzie on wstawiany wielokrotnie aż do osiągnięcia długości określonej w polu <guilabel>Rozmiar</guilabel>.</para></listitem>
<listitem><para>Pierwsze pięć pozycji tego menu pozwala na <action>wybranie formatu wyświetlania danych w edytorze</action>. Do wyboru są formaty: szesnastkowy, dziesiętny, ósemkowy, dwójkowy i tekstowy. Jeżeli wybrany zostanie format tekstowy to w edytorze nie wyświetli się dodatkowe pole tekstowe widoczne w innych formatach.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Widok</guimenu> <guimenuitem>Wyświetlaj kolumnę z pozycją</guimenuitem> </menuchoice></term>
<listitem><para><action>Włącza/wyłącza wyświetlanie kolumny z wyświetlaną pozycją wewnątrz pliku.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Widok</guimenu> <guimenuitem>Wyświetlaj pole tekstowe</guimenuitem> </menuchoice></term>
<listitem><para><action>Włącza/wyłącza wyświetlanie pola tekstowego.</action></para></listitem>
<listitem><para>Jeżeli opcja jest ustawiona to powoduje iż <action>wszystkie pozycje bajtu w pliku wyświetlane i interpretowane są jak liczby w systemie dziesiętnym</action> a nie szesnastkowym.</para></listitem>
<listitem><para>Jeżeli opcja jest ustawiona to powoduje iż <action> dla danych w formacie szesnastkowym wyświetlane są duże litery</action>.</para></listitem>
<listitem><para>Jeżeli opcja jest ustawiona to powoduje iż <action> dla pozycji bajtu w formacie szesnastkowym wyświetlane są duże litery</action>.</para></listitem>
<listitem><para>Pozwala na wybór kodowania dla znaków wyświetlanych w polu tekstowym. Możliwe sposoby kodowania to <acronym>EBCDIC</acronym> lub 7-bitowe <acronym>ASCII</acronym>. Możliwe w przyszłości będzie dodawanie kodowań zdefiniowanych przez użytkownika.</para></listitem>
<listitem><para>Ustawia zakładkę w określonej pozycji dokumentu. </para>
<para>Dla każdego dokumentu można zdefiniować dowolną liczbę zakładek. Każdy z otwartych dokumentów posiada własną listę zakładek wyświetlaną w dolnej części menu <guimenu>Zakładki</guimenu>. Wybranie zakładki z menu spowoduje przeniesienie kursora do odpowiedniej pozycji.</para></listitem>
<listitem><para><action>Podmienia zdefiniowaną w istniejącej zakładce pozycję, na bieżącą pozycję kursora.</action> Po otwarciu okna dialogowego z listą dostępnych zakładek użytkownik może wybrać zakładkę do zmiany.</para></listitem>
<listitem><para><action>Usuń zakładkę</action> wyświetli okno dialogowe z listą dostępnych zakładek, pozwalające na ich wybranie i usunięcie.</para></listitem>
<listitem><para>Lokalizuje napisy w kodzie <acronym>ASCII</acronym> znajdujące się w pliku binarnym. Można dla wyszukiwania określić parametry takie jak minimalna długość napisu, wrażliwość na wielkość liter oraz wzorzec wyszukiwania.</para></listitem>
<listitem><para><action>Wykonuje operacje na bitach.</action> Operację (logiczne "i", "lub" albo przesunięcie) oraz jej parametry należy ustawić w oknie dialogowym. Pola opcji pozwalają na na wybór zakresu działania operacji (zaznaczone bajty albo region poprzedzający i następujący po bieżącej pozycji kursora).</para></listitem>
<listitem><para>Otwiera okno z listą wartości oraz ich odpowiednikami w kodzie <acronym>ASCII</acronym> oraz pozwala na <action>wstawienie wybranej wartości w bieżącej pozycji kursora.</action></para></listitem>
<listitem><para><action>Wprowadzenie wartości w dowolnym polu spowoduje automatyczne przekonwertowanie jej na odpowiednik kodowany szesnastkowo, dziesiętnie, binarnie lub jako tekst</action>. Pole opcji pozwala na konwersję wartości znajdującej się w bieżącej pozycji kursora.</para></listitem>
<listitem><para>Zmienia sposób wyświetlania zakładek dla otwartych dokumentów. Zakładki mogą być wyświetlane ponad lub pod oknem edytora, mogą również być ukryte. Dla niektórych użytkowników zakładki są najwygodniejszym sposobem przełączania między dokumentami.</para></listitem>
<listitem><para><action>Zmienia sposób wyświetlania pola konwersji.</action> Może ono być schowane, zadokowane w głównym oknie edycyjnym lub wyświetlane niezależnie od niego.</para></listitem>
<listitem><para><action>Zmienia sposób wyświetlania pola wyszukiwania.</action> Może ono być schowane, zadokowane w głównym oknie edycyjnym lub wyświetlane niezależnie od niego.</para></listitem>
<listitem><para>Rozmiar wiersza i kolumny (w bajtach). Może być ustawiany dla każdego trybu wyświetlania osobno. Stały rozmiar wiersza. Blokada kolumny na końcu wiersza. Linie siatki pomiędzy wierszami i kolumnami. Rozmiar separatorów pól, odległości pomiędzy wierszami oraz marginesy.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Kursor</guilabel></term>
<listitem><para>Częstość migotania i kształt kursora. Zachowanie kursora gdy edytor przestaje być uaktywniony.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Czcionka</guilabel></term>
<listitem><para>Nazwa czcionki, styl oraz rozmiar, oraz znak wykorzystywany do wyświetlania znaków nie-drukowalnych w polu tekstowym.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Kolory</guilabel></term>
<listitem><para>Wszystkie używane przez &khexedit; kolory mogą być zmieniane przez użytkownika. Kolory dla linii parzystych i nieparzystych, kolumn, zakładek, separatorów i linii siatki. Jedynym wyjątkiem jest kolor zaznaczenia, który jest zdefiniowany w konfiguracji środowiska KDE.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pliki</guilabel></term>
<listitem><para>Otwarcie ostatniego lub wszystkich ostatnio edytowanych dokumentów po uruchomieniu. Odtworzenie pozycji kursora. Włączenie zabezpieczenia przed zapisem. Tworzenie kopii bezpieczeństwa przy zapisywaniu pliku. Zapisywanie listy <quote>Ostatnio otwieranych dokumentów</quote> przy wyjściu. Czyszczenie listy <quote>Ostatnio otwieranych dokumentów</quote>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Różne</guilabel></term>
<listitem><para>Automatycznie kopiowanie do schowka podczas zaznaczania. Rozpoczęcie pracy w trybie wstawiania zamiast nadpisywania. Potwierdzenie wyszukiwania od początku po osiągnięciu końca dokumentu. Przesuwanie kursora do następnego bajtu w trybie binarnym. Sygnał dźwiękowy przy wpisywaniu lub błędzie. Wyświetlanie zakładek w kolumnie z pozycją i w polach edytora. Ostrzeżenie gdy liczba drukowanych stron przekracza określony limit. Maksymalna liczba operacji cofnij.</para></listitem>
<para>Pasek narzędzi zawiera ikony dla następujących poleceń: </para>
<note><para>(Wszystkie ikony z wyjątkiem <guiicon>Przeciągnij dokument</guiicon> oraz <guiicon>Zmień stan ochrony przed zapisem</guiicon> zachowują się tak samo jak odpowiadające im polecenia menu).</para></note>
<listitem><para><guiicon>Przeciągnij dokument</guiicon> — po naciśnięciu przycisku można przenieść dokument do edytora tekstu lub nowego okna programu &khexedit;.</para></listitem>
<para>Pasek wyszukiwania może być wykorzystany do odszukania określonej wartości w pliku. W otwartym oknie należy wprowadzić poszukiwaną wartość, określić jej format (szesnastkowy, ósemkowy, binarny, dziesiętny lub tekstowy), a następnie wcisnąć przycisk <guibutton>Znajdź</guibutton>. Zaznaczenie pola opcji <guilabel>W tył</guilabel> spowoduje wyszukiwanie w kierunku początku dokumentu. Przy wyszukiwaniu tekstowym można ignorować wielkość liter naciskając przycisk <guilabel>Ignoruj wielkość liter</guilabel>. Kliknięcie przycisku po prawej stronie paska (<guiicon>X</guiicon>) spowoduje schowanie go. Aby go pokazać należy wybrać polecenie <guimenuitem>Pasek wyszukiwania</guimenuitem> z menu <guimenu>Ustawienia</guimenu>.</para>
<para>Pole konwersji wyświetla wartości wybranego bajtu w różnych formatach danych. Dla typów ośmiobitowych, pokazywana jest wartość bajtu znajdującego się w pozycji kursora, dla typów o większej liczbie bitów, wyświetlane są wartości rozpoczynające się w pozycji kursora. Kolumna po prawej stronie wyświetla różne rodzaje kodowań dla bieżącego bajtu. W polu konwersji dostępne są następujące opcje:</para>
<term><guilabel>Odczytaj jako 'little endian'</guilabel></term>
<listitem><para>Po zaznaczeniu, powoduje traktowanie wielobajtowych wartości jako zakodowanych metodą "little-endian" używaną przez procesory serii x86 i Alpha. W tej metodzie pierwszy bajt oznacza najmniej istotną część liczby (0a 4e = 0x4e0a = 19978). Jeżeli opcja jest wyłączona, to wartości wielobajtowe traktowane są jako zakodowane metodą "big-endian" używaną w procesorach PowerPC oraz Sparc (0a 4e = 0x0a4e = 2638).</para></listitem>
<term>Kodowanie/Zaznaczenie</term> <!-- fix this -->
<listitem><para>Jeżeli w dokumencie nie ma żadnego zaznaczenia, to w tym polu widoczne jest aktualnie wybrane kodowanie (więcej informacji o kodowaniu znajduje się w opisie menu <link linkend="view-encoding"><menuchoice> <guimenu>Widok</guimenu> <guimenuitem>Kodowanie dokumentu</guimenuitem> </menuchoice></link>), jeżeli jest zaznaczenie to wyświetlana tu jest jego początkowa i końcowa pozycja oraz rozmiar.</para>
<listitem><para>Znak wykrzyknika <computeroutput>!</computeroutput> znajdujący się w tym polu sygnalizuje iż bieżący plik uległ modyfikacji.</para></listitem>
<listitem><para>Pokazuje czy nowo wprowadzane wartości będą wstawiane w bieżącej pozycji kursora (<guilabel>WST</guilabel>) czy też będą nadpisywać istniejące dane (<guilabel>NAD</guilabel>). Przełączanie pomiędzy tymi dwoma trybami możliwe jest za pomocą klawisza <keycap>Insert</keycap>.</para></listitem>
<listitem><para>Wskazują na tryb wyświetlania zawartości pliku (szesnastkowy, ósemkowy, binarny, dziesiętny lub tekstowy). Przełączanie pomiędzy trybami odbywa się za pomocą menu Widok.</para></listitem>
<listitem><para>Wskazuje czy aktywny jest tryb umożliwiający modyfikację dokumentu (<guilabel>RW</guilabel>) lub tryb tylko do odczytu (<guilabel>R</guilabel>). Przełączanie pomiędzy trybami odbywa się za pomocą przycisku znajdującego się na końcu po prawej stronie paska narzędzi lub polecenia <guimenuitem>Uprawnienia</guimenuitem> w menu <guimenu>Plik</guimenu>.</para></listitem>
