Autor: Ruprt (ruprt@atlas.cz) člen ČSLA Studio
Download link: http://ofp.ruprt.cz/download/ofppbo_v141.zip
ČSLA Studio home page: http://games.tiscali.cz/flashpoint/
Total Commander© home page: http://www.ghisler.com/

Vytvořeno pro OFP komunitu. Freeware.
Tento zásuvný modul není produktem společnosti Bohemia Interactive Studio© ani C.Ghisler & Co.©. Přestože je zásuvný modul plně odzkoušen, jeho autor nenese žádnou odpovědnost za jakékoli škody vzniklé jeho používáním, což znamená, že použití je na vlastní nebezpečí :-)
Total Commander© je značkou registrovanou pro Christian Ghisler, C. Ghisler & Co., Switzerland.

Tento zásuvný modul je vytvořen pro použití s aplikací Total Commander© verze 5.51 a vyšší a operačním systémem Microsoft Windows 98, Microsoft Windows Millenium, Microsoft Windows 2000, Microsoft Windows XP a Microsoft Windows Vista©.

Instalace do Total Commander© verze 6.5 a vyšší je prováděna automaticky v případě, že na soubor ofppbo.zip v Total Commanderu dvakrát kliknete myší nebo se jej pokusíte otevřít klávesou Enter.
Pokud modul instalujete do Total Commander© verze nižší než 6.5, pak proveďte následující kroky :

1. Ve složce, ve které máte nainstalovaný Total Commander© (obvykle C:\TotalCmd\) vytvořte tři podsložky: Plugins\wcx\ofppbo.
2. Do této nově vytvořené podsložky (C:\TotalCmd\Plugins\wcx\ofppbo\) zkopírujte soubor ofppbo.wcx zabalený v souboru ofppbo.zip.
3. V Total Commanderu klikněte na položku menu Konfigurace->Nastavení a v okně "Obecné volby", které se Vám otevřelo, vyberte kartu "Archivátory".
4. Klikněte na tlačítko "Konfigurace knihoven DLL" v rámečku "Další archivátory" a otevře se Vám okno "Associace přípony s aplikací".
5. Do pole "Všechny soubory s příponou" zadejte text : .pbo
6. Klikněte na tlačítko "Najít" a v nově otevřeném dialogovém okně vyberte soubor C:\TotalCmd\Plugins\wcx\ofppbo\ofppbo.wcx, který jste si tam zkopírovali v bodu 2.
7. Nastavení potvrďte kliknutím na tlačítko OK.
8. Aplikaci Total Commander© zrestartujete. Zásuvný modul je nyní připraven k použití.

Pro tento zásuvný modul je možné manuálně upravit 8 typů nastavení prostřednictvím dialogového okna "OFPPBO plugin settings", které je přístupné po stisku kláves Alt+F5->tlačítko "Nastavení" (doporučený způsob). Abyste mohli nastavení změnit ručně, musíte editovat soubor pkplugin.ini ve složce C:\TotalCmd (nebo u starších verzí TC ve složce kde je uložen soubor wincmd.ini - obvykle C:\Windows, C:\Winnt). Zde postupujte velmi opatrně, neboť v tomto souboru jsou uložena nastavení i pro ostatní případné zásuvné moduly.

1. Vyberte soubor, který chcete zabali.
2. Stiskněte Alt+F5 a objeví se dialogové okno "Zkomprimovat soubory".
3. V tomto okně klikněte na tlačítko "Nastavení" umístěné ve skupinovém rámečku "Archivátor" a objeví se dialogové okno "OFPPBO plugin options".
4. V dialogovém okně "OFPPBO plugin options" maleznete 8 ovládacích prvků sdružených do třech skupinových rámečků, pomocí kterých můžete změnit chováni pluginu :
5. UseCompression checkbox (Compression settings group box) : určuje, zda-li se má při balení souborů do souboru *.pbo používat komprese(zaškrtnutí znamená Ano, jinak Ne). Pokud tuto možnost nezaškrtnete, pak budou zbylé dvě možnosti nastavení ignorovány. Výchozí nastavení je zaškrtnuto.
6. CompressAll checkbox (Compression settings group box) : určuje zda-li se má použít při balení komprese pro všechny typy souborů (zaškrtnuto znamená Ano, jinak Ne). Pokud tuto možnost zaškrtnete (Ano), pak bude zbývající možnost(CompressFormats) ignorována. Výchozí nastavení je nezaškrtnuto.
7. CompressFormats textbox (Compression settings group box) : Určuje typy(přípony) souborů, pro které bude při balení použita komprese (UseCompression musí být zaškrtnuto; CompressAll nezaškrtnuto). Výchozí nastavení : sqs,sqf,sqm,ext,csv,txt,htm,html,cpp,bin,p3d.
8. ForcePboSignature checkbox (PBO signature settings group box) : Pokud tuto možnost zaškrtnete, plugin bude do PBO archivů zapisovat hodnoty nastavení PboSignatureSuffixKey a PboSignatureSuffixValue (hned za PBO signaturu) jako tzv. příponu signatury. Pokud tuto možnost nezaškrtnete, signatura se zapisovat nebude. Výchozí nastavení je nezaškrtnuto. POZNÁMKA : Přípona PBO signatury je nepovinný pár klíč-hodnota zapisovaný za samotnou nepovinou PBO signaturu (prvních 21 bytů souboru PBO). Tato přípona se jeví užitečnou pro autorizování PBO souborů (podpis autora addonu např. Klíč přípony : Autor; Hodnota přípony: ČSLA studio) nebo pro stručný popis obsahu PBO souboru.
9. KeepOriginalSignatureSuffix checkbox (PBO signature settings group box) : Pokud je tato volba zaškrtnuta valstní nastavení přípony PBO signatury budou ignorována. Tato volba je aktivní pouze pokud manipulujete s již existujícím PBO archivem(např. přidáváte nový soubor do nebo mažete zabalený soubor z existujícího archivu). Abyste mohli toto nastavení využít musí být volba ForcePboSignature zaškrtnuta.
10. PboSignatureSuffixKey textbox (PBO signature settings group box) : Vlastní nastavení klíče páru klíč-hodnota přípony PBO signatury. Abyste mohli toto nastavení využít musí být volba ForcePboSignature zaškrtnuta.
11. PboSignatureSuffixValue textbox (PBO signature settings group box) : Vlastní nastavení hodnoty páru klíč-hodnota přípony PBO signatury. Abyste mohli toto nastavení využít musí být volba ForcePboSignature zaškrtnuta.
12. WriteCppComments checkbox (BIN decoding settings group box) : Pokud tuto volbu zaškrtnete všechny dekódované soubory BIN (a soubory stejně kódované) budou opatřeny komentáři. Tyto komentáře jsou kódové komentáře typu C++, které stručně popisují objekty souborů CPP(jako např. jména polí a jejich velikosti za koncem jejich těl apod.) Výchozí nastavení je zaškrtnuto.

Postup pro manuální změnu nastavení :

1. Otevřete (rozbalte) alespoň 1 soubor *.pbo v Total Commanderu. Toto je nezbytné, neboť patřičná inicializační sekce pro modul se vytvoří až po jeho prvním použití.
2. Otevřete soubor C:\TotalCmd\pkplugin.ini v textovém editoru (např. Poznámkový blok Windows).
3. Najděte sekci [OFPPBO_RUP], pod kterou naleznete 3 možnosti nastavení.
4. UseCompression : určuje, zda-li se má při balení souborů do souboru *.pbo používat komprese(1 znamená Ano, 0 znamená Ne). Pokud tuto možnost nastavíte na 0 (Ne), pak budou zbylé dvě možnosti nastavení ignorovány. Výchozí nastavení : 1.
5. CompressAll : určuje zda-li se má použít při balení komprese pro všechny typy souborů (1 znamená Ano, 0 znamená Ne). Pokud tuto možnost nastavíte na 1 (Ano), pak bude zbývající možnost(CompressFormats) ignorována. Výchozí nastavení : 0.
6. CompressFormats : Určuje typy(přípony) souborů, pro které bude při balení použita komprese (UseCompression musí být nastaveno na 1; CompressAll na 0). Výchozí nastavení : sqs,sqf,sqm,ext,csv,txt,htm,html,cpp,bin,p3d.
7. ForcePboSignature : Pokud má toto nastavení hodnotu 1, plugin bude do PBO archivů zapisovat hodnoty nastavení PboSignatureSuffixKey a PboSignatureSuffixValue (hned za PBO signaturu) jako tzv. příponu signatury. Pokud má toto nastavení hodnotu 0, signatura se zapisovat nebude. Výchozí nastavení je 0. POZNÁMKA : Přípona PBO signatury je nepovinný pár klíč-hodnota zapisovaný za samotnou nepovinou PBO signaturu (prvních 21 bytů souboru PBO). Tato přípona se jeví užitečnou pro autorizování PBO souborů (podpis autora addonu např. Klíč přípony : Autor; Hodnota přípony: ČSLA studio) nebo pro stručný popis obsahu PBO souboru.
8. KeepOriginalSignatureSuffix : Pokud má toto nastavení hodnotu 1 vlastní nastavení přípony PBO signatury budou ignorována. Tato volba je aktivní pouze pokud manipulujete s již existujícím PBO archivem(např. přidáváte nový soubor do nebo mažete zabalený soubor z existujícího archivu). Abyste mohli toto nastavení využít musí být volba ForcePboSignature nastavena na 1.
9. PboSignatureSuffixKey : Vlastní nastavení klíče páru klíč-hodnota přípony PBO signatury. Abyste mohli toto nastavení využít musí být volba ForcePboSignature nastavena na 1.
10. PboSignatureSuffixValue : Vlastní nastavení hodnoty páru klíč-hodnota přípony PBO signatury. Abyste mohli toto nastavení využít musí být volba ForcePboSignature nastavena na 1.
11. WriteCppComments : Pokud má toto nastavení hodnotu 1 všechny dekódované soubory BIN (a soubory stejně kódované) budou opatřeny komentáři. Tyto komentáře jsou kódové komentáře typu C++, které stručně popisují objekty souborů CPP(jako např. jména polí a jejich velikosti za koncem jejich těl apod.) Výchozí nastavení je 1.

Pomocí zásuvného modulu ofppbo.wcx můžete prostřednictvím aplikace Total Commander© zabalit, rozbalit, komprimovat a dekomprimovat soubory PBO a dekódovat soubory BIN (případně zakódované soubory SQM, FPS, CFG, ArmASave apod.) hry Operation Flashpoint© a ArmedAssault©. Modul byl testován na všech dostupných souborech PBO i BIN (zabalených např. pomocí programů StuffPBO, MakePBO, CPP2BIN, PBO Manager, enginem hry OFP apod.), a to bez zjištění jakékoli chyby. V případě, že by se však přece jenom nějaká ta chyba našla, oznamte ji prosím na emilovou adresu autora.
V průběhu testů modulu bylo zjištěno nestandardní chování aplikace Total Commander© v případě, že pokud je nějaký soubor PBO otevřen a následně jsou z něj(nebo z jednoho jeho podaresářů) vymazány všechny soubory najednou, pak se po odstranění souborů obsah souboru PBO vizuálně neobnoví a je zobrazen původní obsah (před vymazáním), přičemž skutečný obsah je správný (již neobsahuje odstraněné soubory). Toto chování aplikace bylo konzultováno s autorem Total Commander© s tím, že je to záměr nikoli chyba, a to z důvodu zachování kompatibility s jinými pluginy. V tomto případě můžete tedy správný obsah souboru zobrazit jeho zavřením a novým otevřením.

Poznámka pro tvůrce externích programových nástrojů :
Modul lze použít i jako součást jiných programů, neboť exportuje funkce (OpenArchive, CloseArchive, ProcessFile, ReadHeader, PackFiles a DeleteFiles) potřebné pro operace balení, rozbalování, komprimaci a dekomprimaci. Logika a signatura těchto funcí je popsána ve WCX Writer's Reference, který lze stáhnout z http://www.totalcmd.net/plugring/packer_interface.html.
Podmínky pro takovéto externí použití modulu jsou:

1. K programu musí být přibaleny obě nezměněné jazykové verze tohoto ReadMe souboru,
2. Autor modulu musí být s použitím obeznámen prostřednictvím emailové zprávy.

Ovládání funkcí modulu je závislé na uživatelském rozhraní aplikace Total Commander© což znamená, že ovládání funkcí modulu je stejné jako pro ostatní archivátory TotalCommanderu.
Zde proto jenom stručně uvádím základní možnosti ovládání :
Otevření souboru PBO : Dvojitým kliknutím, nebo pokud je ukazatel na souboru PBO, stisknutím klávesy Enter.
Extrakce souborů z PBO : Klávesou F5 (Kopírování) nebo přetažením zabaleného souboru myší. Druhý panel TotalCommanderu musí být otevřen do cílové oblasti(složky).
Zabalení souboru do PBO : Při kliknutí pravým tlačítkem myši na soubor, který má být zabalen, vyberte z lokální nabídky položku "Zkomprimovat soubory". V následně otevřeném okně vyberte z rozbalovacího boxu typ archivátoru ".pbo" a klikněte na tlačítko OK. Klávesová zkratka pro tuto operaci je Alt+F5.
Přidání souboru do již existujícího archivu PBO : Otevřete existující soubor PBO v jednom panelu a z druhého panelu zkopírujte pomocí klávesy F5(nebo přetažením myší) soubor(y), který chcete do archivu přidat.
Zobrazení dekódovaného obsahu souboru BIN (nebo SQM, FPS, CFG apod.) : Obsah souboru BIN (případně zakódovaného souboru SQM) hry OFP můžete dekódovat a zobrazit pomocí klávesové zkratky Ctrl+PgDown. Po otevření postupujte jako při extrakci či zobrazení obsahu souboru PBO. Pozn.: Soubory BIN musí mít signaturu OFP (existují i jiné BINy). Při přidávání do archivu PBO se soubory CPP nekódují (nekonvertují do BIN).
Datum a čas extrahovaných souborů : Po extrakci souboru z archivu PBO je soubor uložen s časem extrakce, nikoli s časem uváděným v archivu PBO. Tuto variantu jsem zvolil z důvodu větší přehlednosti při vizuální kontrole mezi soubory extrahovaných a archivovaných souborů. Autor tak může lépe sledovat změny provedené ode dne extrakce souboru. Pozn.: Některé archivátory jako např. StuffPBO neukládají do archivu soubory s uvedením data a času(což je chyba, stejně jako přidávání podpisu na konec archivu). V takovém případě jsou soubory v archivu uváděny vždy s datem a časem otevření archivu.