## DiffPDF

- Základní použití
- Tlačítko Porovnat
- Režim porovnávání slov
- Režim porovnávání znaků
- Režim porovnávání vzhledu
- Rozdělení na oblasti
- Rozsahy stran
- Okraje
- Ukládání
- Dialog voleb
- Ukotvení oken
- Použití v příkazovém řádku

### Základní použití

Klepněte na tlačítko Soubor #1 pro výběr jednoho souboru PDF, a potom na tlačítko Soubor #2 pro výběr jiného souboru (ideálně velmi podobného) PDF. Pak klepněte na tlačítko Porovnat pro provedení srovnání, a když je toto dokončeno, pohybujte se dvojicemi porovnaných stran používajíce k tomu sdružené okno Pohled, nebo pomocí tlačítek Předchozí a Další. Jiným způsobem je přetažení dvou souborů — buď odděleně nebo společně — a jejich upuštění na zobrazovací panelyDiffPDF, potom klepněte na tlačítko Porovnat.

### Tlačítko Porovnat

Když je stisknuto tlačítko Porovnat, DiffPDF udělá rychlé prohledání každé dvojice stran (~100 dvojic stran za sekundu na autorově stroji). Aby prohlídka byla co nejrychlejší DiffPDF udělá velmi hrubé přezkoušení každé dvojice stran —, takže je možné, že takto označí některé nálezy nesprávně jako kladné (např. dvojice stran, které jsou ve skutečnosti stejné). Falešné kladné nálezy jsou ale docela zřídkavé. (Nejsou tu nikdy žádné falešné záporné nálezy — rozdíly nejsou nikdy opomenuty.)

### Režim porovnávání slov

Výchozím režimem je režim porovnávání slov, který dělá chytré srovnání slovo od slova u každé dvojice stran. Tento režim je celkem velkorysý, pokud jde o prázdná místa a pokouší se nevšímat si změn v rozložení (v rámci strany), jak jen to je možné. Stará se také o všechna dělítka (měkké dělení, znaménko minus atd.), totéž jako u prostého dělení. Tento režim je nejlepší pro jazyky s abecedou, jakými je například čeština nebo angličtina.

### Režim porovnávání znaků

Režim porovnávání znaků, který dělá chytré srovnání znak po znaku u každé dvojice stran. Tento režim je velkorysý, pokud jde o prázdná místa na koncích řádků a pokouší se nevšímat si změn v rozložení (v rámci strany), insofar as possible. jak jen to je možné. Stará se také o všechna dělítka (měkké dělení, znaménko minus atd.), totéž jako u prostého dělení. Tento režim je nejlepší pro logografické jazyky, jakými jsou například čínština nebo japonština.

### Režim porovnávání vzhledu

Režim porovnávání vzhledu lze použít na zjištění změn v písmech, diagramech, nebo u jakýchkoli jiných viditelných stránek dokumentu. Tento režim je naprosto přísný a porovnává každou dvojici stran pixel po pixelu. Ve výchozím nastavení ukazuje tento režim rozdíly pomocí zvýraznění, stejně jako to činí režimy porovnávání slov nebo znaků. Je nicméně možné porovnávat za použití skldebných režimů, což může být užitečné při zjišťování velmi malých a jemných rozdílů, jež nejsou hned zřejmé.

### Rozdělení na oblasti

Rozdělení na oblasti je pokusná vlastnost navržená s cílem dosahovat přesnějších výsledků (např. méně falešných kladných nálezů). Její hlavní užití je na strany, jež mají tabulky míchající abecední a logografický text, protože tyto mohou způsobit, že knihovna poppler PDF poskytne slova na straně pomíchaná. Varování: použítí rozdělení na oblasti na velké složité strany (větší než A4, více sloupců, tabulky) v režimu Znaky může být velmi pomalé. (v současnosti je pozornost u rozdělení na oblasti věnována funkčnosti nikoli výkonu.) Dále může v některých případech rozdělení na oblasti zapříčinit nárůst v nesprávných kladných nálezech — to se může objevit, protože kód rozdělení na oblasti přeuspořádá text, který je přiveden do porovnání sekvence a někdy je přeuspořádání chybné. Udělat to správně není jednoduchá záležitost; změna odchylek může pomoci.

Hodnota odchylky/R je největší vzdálenost mezi textovými (např. slovo) obdélníky pro obdélníky k umístění ve stejné oblasti. Nižší hodnoty vytvoří více oblastí; vyšší vytvoří méně oblastí. Více oblastí je náročnější na výpočty, ale může podat přesnější výsledky; méně oblastí může zmenšit počet falešných kladných nálezů. Hodnota odchylky/Y se používá na zaokrouhlení souřadnice y k nejbližšímu násobku této hodnoty. Například je-li Odchylka/Y 5 a slovo v poloze (452,137) je následováno horním indexem v poloze (468,140), s oběma bude nakládáno tak, jakoby měly souřadnici y 140.

### Rozsahy stran

Ve výchozím nastavení porovnává DiffPDF každou dvojici stran dvou souborů PDF (nebo tolik dvojic stran, jako je číslo stran v kratším ze souborů PDF). Také je možné porovnat zvláštní strany nebo rozsahy stran. Pokud jsou například dvě verze souboru PDF, jedna se stranami 1-12 a druhá se stranami 1-13 kvůli zvláštní straně přidané jako strana 4, lze je porovnat zadáním dvou rozsahů stran, 1-12 pro první a 1-3, 5-13 pro druhý soubor. To povede k tomu, že DiffPDF porovná strany ve dvojicích (1, 1), (2, 2), (3, 3), (4, 5), (5, 6), atd. až po (12, 13).

### Okraje

Je možné, aby si DiffPDF nevšímal jakéhokoli textu, který je nad zadaným horním okrajem, pod zadaným dolním nalevo od zadaného levého okraje, a napravo od zadaného pravého okraje. Jeden nebo více těchto okrajů lze zadat nejprve zaškrtnutím zaškrtávacího okénka Vyloučit okraje a potom nastavením kteréhokoli z okrajů. Okraje lze nastavit klepnutím na pohled na stranu a použitím prvků představujících okraje.

### Ukládání

Použijte tlačítko Uložit jako pro vyvolání dialogu pro uložení. Tento dialog vám umožní uložit soubor`.pdf` se zvýrazněnými změnami, nebo jednotlivé obrázkové soubory (např. v `.png` nebo v různých jiných běžných formátech obrázků). Dialog podporuje uložení nynější, nebo všech levých stran, pravých stran nebo obou stran.

### Dialog voleb

Tento dialog je vyvolán klepnutím na tlačítko Volby. Dialog podporuje změnu barvy zvýraznění, zda použít pero nebo výplně nebo obojí, a neprůhlednost výplně. Velikost pole se používá při provádění porovnání v režimu vzhledu: čím menší velikost, tím je zvýraznění jemnější — a pomalejší na výpočty. Šířka vyznačovací čáry stanovuje tloušťku okrajových čar používaných na vyznačení svislé polohy rozdílů; čáry je možné vypnout použitím nastavení šířky vyznačovací čáry na 0.

### Ukotvení oken

Ovládací prvky, činnosti, okraje, rozdělení na oblasti a pohled na zápisy jsou ukotvených prvcích — tyto lze přetáhnout do jiných kotevních oblastí pro kotvení (v takovém případě se jejich tvar změní podle potřeby), nebo odtáhnout k volnému plavení. Okraje, rozdělení na oblasti a pohled na zápisy jde také zavřít; klepnutí pravým tlačítkem myši na oddělovač kotevní oblasti a zaškrtnutí zaškrtávacího okénka pro jejich opětovné otevření. Tyto pohledy lze ukázat v kartách: Pokud je dostatek místa, lze je z jejich karet odtáhnout a ukázat všechny v úplnosti.

### Použití v příkazovém řádku

I když je DiffPDF program s obrazovým uživatelským rozhraním, pokud se spustí v terminálu v příkazovém řádku s uvedením dvou souborů PDF, DiffPDF naběhne a okamžitě je porovná v režimu Slova, nebo v režimu Vzhled, jestliže jsou jejich názvy v příkazovém řádku uvozeny `-a` nebo `--appearance`, nebo v režimu Znaky, jestliže jsou jejich názvy v příkazovém řádku uvozeny `-c` nebo `--character`. Spusťte DiffPDF s `--help`, abyste viděli všechny volby pro příkazový řádek. (Toto nebude pracovat v případě systému Windows, ačkoli jiné volby pro příkazový řádek budou.) Zde je výstup `--help`:

    Použití: diffpdf [volby] [file1.pdf [file2.pdf]]

    Program s obrazovým uživatelským rozhraním, jenž porovnává dva soubory PDF a ukazuje rozdíly mezi nimi.

    Soubory jsou volitelné a obyčejně nastavené přes uživatelské rozhraní.

    Volby:
    --help             Ukázat tento text o používání a skončit (spustit
                       program bez této volby a stistnout F1 pro
                       nápovědu na internetu)
    --appearance  -a   Nastavit počáteční režim porovnávání na Vzhled
    --characters  -c   Nastavit počáteční režim porovnávání na Znaky
    --words       -w   Nastavit počáteční režim porovnávání na Slova
    --language=xx      Nastavit program, aby používal daný překladový
                       jazyk, například en pro anglický, cz pro český;
                       Angličtina se bude používat, pokud není dostupný žádný
                       překlad
    --debug=2          Zapsat text vedený do porovnání sekvence do
                       dočasných souborů (např. /tmp/page1.txt atd.)
    --debug=3          Stejně jako --debug=2, ale také zahrnuje souřadnice v
                        y, x

Vykreslení textu je uděláno postupem `TextItems::columnZoneYxOrder()` v souboru `textitem.cpp`: návrhy na vylepšení jsou vítány! (Všimněte si, že při použití `--debug3` jsou souřadnice výstup v y, x.)

Pokud hledáte zvláštní nástroj na porovnávání PDF v příkazovém řádku např. pro automatizované zkoušení, vyzkoušejte comparepdf.