# &okteta; käsiraamat

Friedrich
W. H.
Kossebau

    &Friedrich.Kossebau.email;

Alex
Richardson

    &Alex.Richardson.email;

Marek
Laane

    bald@smail.ee

Tõlge eesti keelde
2008, 2010, 2011
&Friedrich.Kossebau; ja &Alex.Richardson;
&FDLNotice;
2013-11-28
0.12 (&kde; 4.12)

&okteta; on lihtne failide toorandmete redaktor. Niisuguseid rakendusi nimetatakse ka binaar- või hex-redaktoriteks.

KDE
&package;
Okteta
vaade
redigeerimine
bitid
baidid
binaar
kaheksandsüsteem
kuueteistkümnendsüsteem
binaarfailide redaktor
toorandmed

## Sissejuhatus

&okteta; on lihtne failide toorandmete redaktor.

Andmeid kuvatakse kahel viisil: baitide arvväärtustena ja väärtustele omistatud märkidena. Väärtusi ja märke võib lasta näidata kahes veerus (niisuguste redaktorite tavapärane kuvamisviis) või ridades, kus väärtus on märgi peal. Redigeerida saab nii väärtusi kui ka märke.

Lisaks tavapärastele redigeerimisvõimalustele pakub &okteta; veel teatavat valikut tööriistu, näiteks tabelit, mis dekodeerib andmed levinumatesse andmetüüpidesse, tabelit, mis näitab kõiki võimalikke baite koos nende märk- ja väärtusvastetega, infovaadet statistikaga, kontrollsumma kalkulaatorit, filtritööriista ja stringide ekstraktimise tööriista.

Kõiki laaditud andmetega ette võetud toiminguid saab piiramatult tühistada ja uuesti sooritada.

## Põhitõed

### &okteta; käivitamine

Kurjuta käsureale ``okteta`` või vali rakenduste käivitajas Rakendused Tööriistad Binaarfailide redaktor.

Kasutada saab tavapäraseid &Qt; ja &kde; käsureavõtmeid, mida saab näha käsuga ``okteta` `--help``.

&okteta; spetsiifilised võtmed on järgmised:

`<&URL;(id)>` - määratud &URL;-i(de)ga faili(de) avamine

### Kasutamine

&okteta; peaaken koosneb järgmistest komponentidest: menüüriba, tööriistariba, olekuriba, üks või mitu külgriba tööriistadega ning peavaade kaartideks jagatud andmevaadetega.

Faili avamisel või uue baidimassiivi loomisel näidatakse sisalduvaid baite üksteise järel ridades, kus iga rea juures on baitide arv. Neid kuvatakse kahel viisil: baitide arvväärtustena või väärtustele omistatud märkidena. Väärtusi ja märke võib lasta näidata kas eraldi kahes veerus või üksteise kõrval, nii et väärtus on märgi peal. Vasakul näidatakse iga rea esimese baidi suhtaadressi.

Kasutamine on sarnane enamiku tekstiredaktoritega: andmeid saab redigeerida, lõigata, kopeerida, asetada ja lohistada nagu ikka. Kursor tähistab aktiivset asukohta. Klahviga Insert saab lülitada ülekirjutamis- ja lisamisrežiimi vahel. Ülekirjutamisrežiim on tavalistest tekstiredaktoritest siiski rangem. see ei luba toiminguid, mis muudavad baidimassiivi suurust.

Erinevalt teistest tekstiredaktoritest on sisu kuvatud kahes variandis. Sisestamise mõttes on aktiivne ainult üks neist. Kaks omavahel seotud kursorit näitavad vastavalt väärtust ja märki ning aktiivne on see variant, mille kursor plingib. Kui aktiivsed on märgid, saab märke sisestada nagu igas tekstiredaktoris. Kui aktiivsed on väärtused, avab arvu kirjutamine tillukese redaktori, mis võimaldab sisestada ülejäänud väärtuse.

Otsingudialoog võimaldab kasutajal otsida konkreetset baidistringi kas väärtusena (16nd-, 10nd-, 8nd-, 2nd-süsteemis) või tekstina (8-bitine kodeering või UTF-8).

Korraga võib avada mitu baidimassiivi, kuid ainult üks neist saab olla aktiivne. Seda, milline baidimassiiv on aktiivne, saab valida menüüst Aknad.

## Tööriistad

### Ülevaade

&okteta; pakub mitmeid tööriistu: osad on mõeldud baidimassiivide analüüsimiseks ja käitlemiseks, mõned on üldisemad. Tööriistu saab nähtavale tuua või varjata vastavate kirjetega menüüs Tööriistad. Kõigil tööriistadel on pisike vaade, mis paikneb dokina ühel külgribadest või vabalt omaette aknana. Tööriistavaateid saab dokkida, dokist vabastada, ümber korraldada ja pinusse seada hiirega või tööriistavaate tiitliribal &HVNga; klõpsates ja seda vajalikku kohta liigutades, pärast mida tuleb &HVN; toimingu lõpetamiseks lahti lasta või toimingust loobuda klahvile &Esc; vajutades.

#### Analüsaatorid ja käitlejad

Väärtuse/märgitabel

  Tabel toob ära kõik võimalikud baidiväärtused nii märk- kui arvväärtusena.

  Valitud väärtuse saab sisestada kursori asukohta. Selleks tuleb klõpsata nupule Lisa või teha tabelis real topeltklõps.

Binaarfilter

  Filter võimaldab valitud baitidega ette võtta binaartoiminguid. Pärast toimingu (AND, OR, ROTATE...) valimist saab allpool olevas kastis soovi korral paika panna parameetrid. Filtri saab rakendada klõpsuga nupule Filtreeri.

Stringid

  See tööriist tuvastab valitud baitides stringid. Stringi miinimumpikkuse valimise järel hangitakse stringid klõpsuga nupule Hangi. Näidatavate stringide loendit saab piirata, kui sisestada sobiv filter.

Statistika

  Siin näeb valitud baitide statistikat. See näitab iga valikusse kuuluva baidi esinemissagedust. See arvutatakse välja, kui klõpsata nupule Loo.

Kontrollsumma

  See tööriist arvutab mitmesuguseid valitud baitide kontrollsummasid. Pärast algoritmi valimist ja vajaduse korral parameetrite määramist arvutatakse kontrollsumma välja, kui klõpsata nupule Arvuta.

Dekodeerimistabel

  Siin näeb baidi või baitide (alates kursorist) väärtust, mida esitatakse selliste levinud andmetüüpide, nagu täis- või murdarv, aga ka UTF-8 kohta. Tabeli real topeltklõpsu tehes käivitab redaktori, kus saab väärtusi muuta.

Struktuurid

  See tööriist võimaldab baidimassiive uurida ja muuta vastavalt kasutaja määratud struktuuridefinitsioonile. Üksikasjalikumalt kõneldakse selles omaette osas.

#### Üldised tööriistad

Failisüsteem

  See tööriist pakub põimitud failisirvijat, mille abil saab valida avatavaid faile.

Dokumendid

  See tööriist näitab kõiki viimati loodud või laaditud faile. Sümbolid tähistavad parajasti aktiivses vaates olevat faili, samuti näitavad, millistes failides on salvestamata muudatusi või millist salvestil leiduvat faili on muutnud mõni muu programm.

Järjehoidjad

  Selle tööriista abil saab hallata järjehoidjaid, mis on võimalik ka järjehoidjate menüü vahendusel.

  Järjehoidjad on praegu ainult ajutised ning neid ei salvestata, kui sulged baidimassiivi või rakenduse.

Failiinfo

  See tööriist näitab mõningat teavet aktiivse faili kohta, sealhulgas selle tüüpi, asukohta ja suurust.

Terminal

  Põimitud terminal; töökataloog ei ole seotud aktiivse failiga.

Märgistiku teisendamine

  See tööriist kirjutab baidid ümber, nii et vastavad märgid oleksid samad nagu teises märgistikus. Toetatud on ainult 8-bitised märgistikud ning vasteta märgid asendatakse praegu väärtusega 0.

### Struktuuride tööriist

#### Üldine

Struktuuride tööriist võimaldab baidimassiive analüüsida ja muuta vastavalt kasutaja loodud struktuuridefinitsioonidele, mida saab luua massiividest, ühendutest, primitiivide tüüpidest ja loendiväärtustest

Tööriistal on oma seadistustedialoog, mille saab avada nupuga Seadistused. Seal saab seadistada mitmesuguseid valikuid, näiteks stiili, millega väärtusi kuvatakse (10nd-, 16nd- või 2nd-süsteem). Samuti saab määrata, millised struktuuridefinitsioonid laaditakse ja milliseid struktuure näidatakse vaates.

Struktuurid on defineeritud &okteta; struktuuridefinitsioonifailides (need on &XML;-failid laiendiga `.osd`). Lisaks sisaldab `.desktop`-fail struktuuridefinitsioonifaili metaandmeid, näiteks autor, kodulehekülg ja litsents.

Praegu puudub struktuuridefinitsioonide loomise või muutmise sisseehitatud toetus, mistõttu seda tuleb teha käsitsi, nagu kirjeldatakse järgmistes lõikudes.

#### Struktuuridefinitsioonide paigaldamine

##### Paigaldamine KNewStuffi abil

Lihtsaim viis uusi struktuuridefinitsioone paigaldada on kasutada &okteta;sse sisse ehitatud KNewStuffi toetust. Olemasoleva struktuuri paigaldamiseks avada struktuuritööriista seadistustedialoog. Vali seal kaart Struktuuride haldamine ja vajuta nupule Hangi uusi struktuure... Ilmub dialoog, mis võimaldab struktuure paigaldada ja eemaldada.

##### Struktuuridefinitsioonide käsitsi paigaldamine

Struktuuride tööriist otsib struktuuridefinitsioone kasutaja programmi andmete kataloogi (selle saab teada käsuga ``kde4-config` `--localprefix``) alamkataloogis `share/apps/okteta/structures/`. Kui sul pole veel ühtegi struktuuridefinitsiooni paigaldatud, võib olla vajalik see alamkataloog esmalt luua.

Iga struktuuridefinitsioon koosneb kahest failist. Üks sisaldab tegelikku definitsiooni, teine on aga metaandmetele (autor, versioon jne.) mõeldud `.desktop`-fail.

Selles alamkataloogis on oma alamkataloogid igale struktuuridefinitsioonile, mis sisaldavad nii definitsiooni `.desktop`-faili kui ka `.osd`- või `main.js` faili.

Kui näiteks programmi andmete kataloog on `.kde` ja struktuuridefinitsiooni nimi ExampleStructure, siis on olemas kataloog `.kde/share/apps/okteta/structures/ExampleStructure`, mis sisaldab faile `ExampleStructure.desktop` ja `ExampleStructure.osd`.

##### Äsja paigaldatud struktuuride kasutamine

Kui oled paigaldanud uue struktuuridefinitsiooni, tuleb &okteta; taaskäivitada. Siis ava struktuuri tööriista seadistustedialoog. Vali seal kaart Struktuuride haldamine ja kontrolli, et vastav struktuuridefinitsioon on märgitud. Seejärel vali kaart Struktuurid ja kontrolli, et soovitud element on ikka parempoolses nimekirjas.

#### Struktuuridefinitsioonide jagamine

Levinumate struktuuride jaoks võid muidugi definitsiooni ka ise luua, kuid selle asemel võib kasutada ka teiste loodud definitsioone, mida leiab näiteks veebileheküljelt kde-files.org.

Samuti võib jagada teistega enda loodud definitsioone. Selleks loo failiarhiiv (nt. zip-pakenduses tar-arhiiv `.tar.gz`), mis sisaldab alamkataloogi struktuuri definitsiooni ja `.desktop`-failiga. Eespool toodud näite põhjal oleks selleks kataloog `ExampleStructure` kogu oma sisuga. Selle vormingu kasutamine struktuuri definitsioonide jagamiseks võimaldab paigaldada neid otse &okteta;s ega nõua käsitsi paigaldamist.

#### Struktuuridefinitsioonide loomine

Struktuuridefinitsioone saab luua kahel moel. Esiteks võib kirjutada definitsiooni &XML;-is, teiseks saab kasutada JavaScripti. Viimane võimalus lubab luua keerukamaid struktuure selliste omadustega, nagu näiteks struktuuri valideerimine. &XML;-i kasutamine pakub vähem võimalusi, aga kui vajad ainult staatilist struktuuri, siis on see ilmselt lihtsam viis. Kui vajad aga dünaamilist struktuuri, see tähendab struktuuri, mille puhul massiivi pikkused sõltuvad struktuuri teistest väärtustest või struktuuri ülesehitus muutub, kui mõne liikme väärtus muutub, siis lihtsalt tuleb kirjutada struktuuridefinitsioon JavaScriptis. Reeglist on üks erand: kui tegemist on massiiviga, mille pikkus peab olema täpselt võrdne teise struktuuri väärtusega, siis võib kasutada ka &XML;-i. Aga kui see on näiteks length - 1 või midagi sellist, siis peab kasutama JavaScripti.

#### Struktuuridefinitsioon &XML;-faili vormingus

`.osd` &XML;-failil on üks juurelement: <data> ilma atribuutideta. Selle elemendi sees peab olema üks järgmistest elementidest:

<primitive>

  Primitiivi andmetüübi loomiseks, nt. int ja float. See element ei luba alamelemente ja sel võivad olla järgmised atribuudid:

  type

    Primitiivi tüüp. See peab olema üks järgnevatest:

    - char 8-bitise ASCII märgi korral

    - int8, int16, int32, int64 vastava suurusega märgiga täisarvu korral

    - uint8, uint16, uint32, uint64 vastava suurusega märgita täisarvu korral

    - bool8, bool16, bool32, bool64 vastava suurusega märgita tõeväärtuse (0 = väär, kõik teised väärtused = tõene) korral

    - float 32-bitise IEEE754 murdarvu korral

    - double 64-bitise IEEE754 murdarvu korral

<bitfield>

  Bitivälja loomiseks. See element ei luba alamelemente ja sel võivad olla järgmised atribuudid:

  width

    Bitivälja kasutatud bittide arv. Peab olema vahemikus 1 kuni 64.

  type

    Bitivälja tüüp. Peab olema üks järgnevatest:

    - unsigned bitivälja korral, milles väärtust interpreteeritakse märgita väärtusena (väärtus vahemikus 0 kuni 2width - 1)

    - signed bitivälja korral, milles väärtust interpreteeritakse märgiga väärtusena (väärtus vahemikus -2width - 1 kuni 2width - 1 - 1)

    - bool bitivälja korral, milles väärtust interpreteeritakse tõeväärtusena

    Pea alati meeles lisada <bitfield> järele täidis, sest vastasel juhul algab järgmine element (välja arvatud stringid ja massiivid, sest need lisavad täidise automaatselt) baidi keskel. Mõistagi ei ole täidis vajalik, kui see ongi sinu taotlus.

<enum>

  Primitiivi tüübi loomiseks, milles väärtused kuvatakse võimaluse korral väärtustiku liikmetena. See element ei luba alamelemente (küll aga läheb failis vaja sellele viitamiseks silti <enumDef>). Sel on järgmised atribuudid:

  enum

    Väärtuse taga seisev väärtustik. Peab sobima kokku ühe failis esineva sildi <enumDef> atribuudiga name.

  type

    Loendi tüüp. Vaata <primitive> atribuudi tüüpi. Ainuke erinevus on see, et Double ja Float on siinkohal ülearused.

<flags>

  Sama, mis <enum>, ainult et väärtused esitatakse kõigi väärtustiku väärtuste korral bitikaupa disjunktsioonina (bitwise-or).

<struct>

  Struktuuri loomiseks. Kõik teised elemendid (kaasa arvatud <struct>) võivad olla selle järglased ja on sel juhul tulemusena saada struktuuri koosseisus

<union>

  Ühenduse loomiseks. Põhimõtteliselt sama, mis <struct>, aga kõik järglaselemendid algavad samalt suhtaadressilt. Kasulik sama jada interpreteerimiseks erinevatel viisidel.

<array>

  Massiivi loomiseks. See element lubab täpselt üht järglast (massiivi taga seisev tüüp), mis võib olla suvaline element, isegi <array> ise. Samuti on sel järgmised atribuudid:

  length

    Massiivi elementide arv kümnendnumbrina. See võib aga olla ka string, mis vastab eelnevalt defineeritud elemendi <primitive>, <enum> või <flags> nimeatribuudile. Sel juhul on pikkuseks selle elemendi väärtus. Praegu on piiranguks 10000, sest pikemad massiivid võtaksid liiga palju mälu ja aeglustaksid liialt rakendust.

<string>

  Eri kodeeringus stringi loomiseks. Vaikimisi on see NULL-lõpetusega C stiilis string. Siiski võib luua eri tüüpi stringe järgmiste atribuutidega:

  terminatedBy

    See atribuut määrab, millise Unicode'i märgiga string lõpetatakse. See peab olema kuueteistkümnendsüsteemi arv (lisaks võib sellele eelneda 0x). Kui kodeeringuks on ASCII, omavad tähendust ainult väärtused kuni 0x7f. Kui määratud pole see ega maxCharCount või maxByteCount, eeldatakse väärtuseks 0 (C stiilis string).

  maxCharCount

    Maksimaalne stringis lubatud märkide arv. Kui määratud on ka terminatedBy, siis lõpetab stringi see, milleni esimesena jõutakse. See on vastastikku välistav atribuudiga maxByteCount

  maxByteCount

    Stringi maksimaalne pikkus baitides. Kui määratud on ka terminatedBy, lõpetab stringi see, milleni esimesena jõutakse. See on vastastikku välistav atribuudiga maxCharCount. Selliste kodeeringute korral nagu ASCII on see võrdne atribuudiga maxCharCount.

  type

    Stringi kodeering. Võib olla üks järgnevatest:

    - ASCII

    - LATIN-1

    - UTF-8

    - UTF-16-LE või UTF-16-BE. Kui antud pole ei sufiksit -LE ega -BE, eeldatakse peeneotsalist (LE).

    - UTF-32-LE või UTF-32-BE. Kui antud pole ei sufiksit -LE ega -BE, eeldatakse peeneotsalist (LE).

Kõik elemendid lubavad ka atribuuti name, mis on hiljem nähtav struktuurivaates.

#### Näidisstruktuuridefinitsioon nii &XML;-is kui ka JavaScriptis

##### Ühine samm mõlemal juhul

Metaandmete fail näeb välja selline:

            [Desktop Entry]
            Encoding=UTF-8
            Icon=arrow-up
            Type=Service
            ServiceTypes=KPluginInfo

            Name=Simple test structure
            Comment=A very simple test structure containing only two items

            X-KDE-PluginInfo-Author=Alex Richardson
            X-KDE-PluginInfo-Email=foo.bar@email.org
            X-KDE-PluginInfo-Name=simplestruct
            X-KDE-PluginInfo-Version=1.0
            X-KDE-PluginInfo-Website=http://www.plugin.org/
            X-KDE-PluginInfo-Category=structure
            X-KDE-PluginInfo-License=LGPL
            X-KDE-PluginInfo-EnabledByDefault=false

Ikoon, mida &okteta; selle struktuuri puhul näitab, võib olla milline tahes, mille leiab käsuga ``kdialog` `--geticon``, või siis ikooni konkreetne asukoht

Need väljad peaksid olema üsna enesestmõistetavad, välja arvatud ehk `X-KDE-PluginInfo-Name`. Selle välja väärtus peab sobima nii kataloogi nimega, mis sisaldab faili, kui ka `.desktop`-faili nimega. &XML;-struktuuri definitsioone luues peab ka `.osd`-faili nimi sobima selle nimega.

Selles näites on meil kataloog `simplestruct`, mis sisaldab faili `simplestruct.desktop`. Struktuuride defineerimisel &XML;-is sisaldab kataloog ka faili `simplestruct.osd`. JavaScripti kasutamisel on selle asemel fail `main.js`.

##### Lihtne &XML;-i struktuuridefinitsioon

Alustuseks loome definitsiooni hästi lihtsale teststuktuurile, mis sisaldab ainult täisarvulisi andmetüüpe (üks märk, üks 32-bitine täisarv ja bitiväli). Need väljenduvad C/C++ keeles järgmiselt:

              struct simple {
                char aChar;
                int anInt;
                bool bitFlag :1;
                unsigned padding :7;
              };

Kõigepealt tuleb kirjutada `.osd`-fail vastavalt eelnevas osas defineeritud failivormingule. Anname sellele nimeks `simplestruct.osd`:

               <?xml version="1.0" encoding="UTF-8"?>
              <data>
                <struct name="simple">
                  <primitive name="aChar" type="Char"/>
                  <primitive name="anInt" type="Int32"/>
                  <bitfield name="bitFlag" type="bool" width="1"/>
                  <bitfield name="padding" type="unsigned" width="7"/>
                </struct>
              </data>

mis on päris sarnane C/C++ definitsioonile.

Nüüd tuleb luua kataloog `simplestruct` struktuuri paigalduskataloogi, nagu eespool kirjeldatud, kopeerida kaks faili sellesse kataloogi ja taaskäivitada &okteta;.

##### Lihtne struktuur JavaScriptis

Eelneva struktuuri teostamiseks JavaScriptis loo `simplestruct.osd` asemel fail nimega `main.js`. Selle sisu peaks olema järgmine:

            function init() {
              var structure = struct({
                aChar : char(),
                anInt : int32(),
                bitFlag : bitfield("bool", 1),
                padding : bitfield("unsigned", 7),
              })
              return structure;
            }

&okteta; näidatav struktuur on alati funktsiooni `init` tagastatav väärtus.

Primitiivi tüübi loomiseks võib välja kutsuda järgmisi funktsioone:

- char()

- int8(), int16(), int32() või int64()

- uint8(), uint16(), uint32() või uint64()

- bool8(), bool16(), bool32() või bool64()

- float()

- double()

Bitivälja funktsioon kasutab kaht parameetrit, millest esimene on string, mille sisu on `bool`, `signed` või `unsigned`. Teine parameeter on täisarv, mis määrab laiuse bittides.

##### Keerulisemad struktuurid

Nüüd loome definitsiooni keerulisemale struktuurile, millele annamegi nimeks "complex" ja salvestame failina `complex.osd`. See struktuur sisaldab kaht massiivi (üks kindla pikkusega, teise pikkus määratakse käitusajal) ning pesastatud struktuuri ja ühendit.

              <?xml version="1.0" encoding="UTF-8"?>
              <data>
                <struct name="complex">
                  <primitive name="size" type="UInt8" />
                  <union name="aUnion">
                    <array name="fourBytes" length="4">
                      <primitive type="Int8" />
                    </array>
                  </union>
                  <struct name="nested">
                    <array name="string" length="size"> <!-- references the field size above -->
                      <primitive type="Char" />
                    </array>
                  </struct>
                </struct>
              </data>

Selle vasteks on pseudo-C/C++ korral

    struct complex {
                uint8_t size;
                union aUnion {
                  int8_t fourBytes[4];
                };
                struct nested {
                  char string[size] //not valid C++, references value of the uint8 size
                };
              };

Enne massiivi saavad mõistagi olla ainult dünaamilise pikkusega massiivide viidete väljad.

Nüüd loome faili `complex.desktop` samamoodi nagu eelmises näites (kontrolli, et `X-KDE-PluginInfo-Name` oleks ikka korrektselt määratud) ning järgime eelmist näidet ka mõlema faili paigaldamisel.

##### Täiendav teave

Mõningaid näidisstruktuuridefinitsioone leiab Giti hoidlast. Nende seas on näiteks PNG-failide failipäis ja ELF-faili päis. `.osd`-faili struktuuri kirjeldava &XML; skeemi leiab siit. Kui tunned veel millegi vastu huvi, võta ühendust autoriga aadressil &Alex.Richardson.email;.

## Liidese tutvustus

### Menüükirjed

Lisaks &kde; üldistele menüüdele, mida kirjeldab &kde; põhitõdede käsiraamatu peatükk Menüü, on rakendusel mõned spetsiifilised menüükirjed:

#### Menüü Fail

&Ctrl;N Fail Uus

  Loob uue baidimassiivi...

  - Tühi: ...sõna otseses mõttes tühjana.

  - Lõikepuhvrist: ...lõikepuhvri sisu põhjal.

  - Muster...: ...määratud mustriga.

  - Juhuslikud andmed: ...juhuslike andmetega.

  - Jada: ...kõigi baitidega vahemikus 0 kuni 255.

Fail Eksport

  Ekspordib valitud baidid faili...

  - Väärtused ... kodeerituna baidiväärtustena. Vaikimisi eraldab väärtusi üks tühimärk. Eraldusmärke saab muuta eksportimise dialoogis.

  - Märgid: ...kodeerituna lihttekstina.

  - Base64: ...kodeerituna Base64 vormingusse.

  - Base32: ...kodeerituna Base32 vormingusse.

  - Ascii85: ... kodeerituna Ascii85 vormingusse.

  - Uuencoding: ... kodeerituna Uuencoding vormingusse.

  - Xxencoding: ... kodeerituna Xxencoding vormingusse.

  - Intel Hex: ... kodeerituna Intel Hex vormingusse.

  - S-Record: ... kodeerituna S-Record vormingusse.

  - C massiiv: ...massiivina C programmeerimiskeeles.

  - Vaade lihttekstina: ...andmevaatena koos suhtaadresside, baidiväärtuste ja märkidega.

Fail Õigused Kirjutuskaitstud

  Selle määramise korral ei saa laaditud baidimassiivi muudatusi teha.

Fail Sulge kõik teised

  Sulgeb kõik baidimassiivid peale aktiivse.

#### Menüü Redigeerimine

Lihtsalt kopeerides ja lõigates andmed lõikepuhvrisse MIME tüübiga application/octetstream ei suuda &klipper; neid kuvada. Õieti ei suuda seda pea ükski muu rakendus, sest tegemist on puhaste toorandmetega. Niisiis tasub arvestada alammenüüga Kopeeri kui.

Redigeerimine Kopeeri kui

  Kopeerib valitud baidid mõnes muus vormingus lõikepuhvrisse. Saadaolevate vormingute kohta vaata menüükirje Fail Eksport juurest.

Redigeerimine Lisa
  Muster...

    Lisab kursori asukohta määratud baidistringi.

    Dialoogi valikud lubavad määrata mustri lisamiskordade arvu ja mustri vormingu (16nd-, 10nd-, 8nd- või 2nd-süsteem, märk või UTF-8).

&Ctrl;&Shift;A Redigeerimine Tühista valik

  Tühistab aktiivse valiku.

&Ctrl;E Redigeerimine Vali vahemik...

  Avab põimitud dialoogi valitava vahemiku määramiseks.

Ins Redigeerimine Ülekirjutamisrežiim

  Võimaldab valida lisamis- ja ülekirjutamisrežiimi vahel.

  Ülekirjutamisrežiim on äärmiselt range: andmete suurust ei ole võimalik muuta (baite ei saa lisada ega eemaldada).

&Ctrl;F Redigeerimine Otsi...

  Võimaldab otsida dokumendist määratud mustrit.Otsida saab 16nd-, 8nd-, 2nd-süsteemis või tekstimustreid.

  Dialoogi valikud lubavad määrata alguskoha, suuna ja otsinguvahemiku.

&Ctrl;G Redigeerimine Mine suhtaadressile...

  Liigutab kursori määratud suhtaadressile.

#### Menüü Vaade

Vaade Mittetrükitavate märkide näitamine

  Lülitab mittetrükitavate märkide näitamise sisse või välja. Kui see on väljas, näidatakse märgiveerus vastavates kohtades asendusmärke.

F11 Vaade Rea suhtaadressi näitamine

  Lülitab rea suhtaadressi näitamise vasakus paneelis sisse või välja.

Vaade Väärtuste või märkide näitamine

  Võimaldab valida, millist baiditõlgendust näidatakse. Valikud on järgmised:

  - Väärtused

  - Märgid

  - Väärtused ja märgid

Vaade Väärtuste kodeering

  Võimaldab valida väärtuste kodeeringu:

  - 16nd-süsteemis

  - 10nd-süsteemis

  - 8nd-süsteemis

  - 2nd-süsteemis

Vaade Märkide kodeering

  Võimaldab valida märkide kodeeringu alammenüüst.

Vaade Määra baitide arv rea kohta

  Näidatavate baitide valimine rea kohta dialoogis, kus vaikeväärtus on 16 baiti.

Vaade Määra baitide arv rühma kohta

  Vaikimisi näidatakse kuueteistkümnendväärtusi 4 baidist koosnevates rühmades. Selle menüükirjega saab dialoogis eelistust muuta.

Vaade Dünaamiline paigutus

  Määrab andmekuva paigutuse reeglid. Sellega sätestatakse, kui palju baite, sõltuvalt vaate laiusest, real näidatakse. Võimalikud reeglid on järgmised:

  - Väljas: paigutus on fikseeritud aktiivse baitide arvuga rea kohta ning seda ei muudeta ka vaate suuruse muutmisel.

  - Ainult täielike baidirühmade murdmine: reale seatakse võimalikult palju baite, peaasi et baidirühmad on terviklikud.

  - Sees: sama, mis eelmine, kuid lubab ka ebatäielikke baidirühmi.

Vaade Vaaterežiim

  Võimaldab valida vaate paigutuse:

  - Veerud: väärtusi ja märke näidatakse klassikalise vaatena, mõlemad omaette veerus.

  - Read: märke näidatakse otse väärtuse all.

&Ctrl;&Shift;T Vaade Poolita rõhtsuunas

  Jagab parajasti fookuses vaate ala kaheks osaks ning lisab aktiivse vaate koopia uude, alumisse osasse.

&Ctrl;&Shift;L Vaade Poolita püstsuunas

  Jagab parajasti fookuses vaate ala kaheks osaks ning lisab aktiivse vaate koopia uude, parempoolsesse osasse.

&Ctrl;&Shift;R Vaade Sulge vaateala

  Sulgeb parajasti fookuses vaate ala.

Vaade Vaateprofiil

  Vaateseadistusi saab salvestada eraldi vaateprofiilidena. Parajasti valitud profiili saab uuendada otse aktiivse vaate seadistustes või siis luua aktiivse põhjal uue profiili. Kõiki vaateprofiile saab hallata dialoogis, mille avab menüükäsk Seadistused Vaateprofiilide haldamine...

#### Menüü Aknad

Näitab aktiivsete vaadete nimekirja, kust saab valida aktiivse akna.

#### Menüü Järjehoidjad

Ka ühte baidimassiivi võib lisada mitmeid järjehoidjaid. Igal baidimassiivil on oma järjehoidjad, mida näidatakse menüü Järjehoidjad allosas. Menüüst järjehoidjat valides viiakse kursor vajalikku kohta ning vastavalt liigub ka vaade.

Järjehoidjad on praegu ainult ajutised ning neid ei salvestata, kui sulged baidimassiivi või rakenduse.

&Ctrl;B Järjehoidjad Lisa järjehoidja

  Lisab asukoha baidimassiivis järjehoidjatesse.

&Ctrl;&Shift;B Järjehoidjad Eemalda järjehoidja

  Eemalda aktiivse järjehoidja. Seda käsku saab kasutada ainult siis, kui kursor asub järjehoidjaga asukohas.

Järjehoidjad Eemalda kõik järjehoidjad

  Puhastab järjehoidjate loendi.

&Alt;Up Järjehoidjad Liigu eelmisele järjehoidjale

  Liigutab kursori eelmisele järjehoidjale.

&Alt;Down Järjehoidjad Liigu järgmisele järjehoidjale

  Liigutab kursori järgmisele järjehoidjale.

#### Menüü Tööriistad

Siin näeb paigaldatud tööriistu. Kirjete abil saab nende näitamise sisse või välja lülitada. Kõigi tööriistade täpsema kirjelduse leiab sektsioonist Tööriistad.

#### Menüü Seadistused

Seadistused Vaateprofiilide haldamine...

  Dialoogi avamine vaikimisi vaateprofiili loomiseks, muutmiseks, kustutamiseks ja määramiseks.

## Autorid ja litsents

&okteta;

Rakenduse autoriõigus 2006-2012: &Friedrich.Kossebau; &Friedrich.Kossebau.email;

Dokumentatsiooni autoriõigus 2008, 2010: &Friedrich.Kossebau; &Friedrich.Kossebau.email;, &Alex.Richardson; &Alex.Richardson.email;

Tõlge eesti keelde: Marek Laane bald@smail.ee

&underFDL; &underGPL;

## Paigaldamine

### &okteta; hankimine

&install.intro.documentation;

### Kompileerimine ja paigaldamine

&install.compile.documentation;

&documentation.index;