This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
arma2:tools:patchpbo [2010-07-16 05:18] snakeman created patchpbo initial page. |
arma2:tools:patchpbo [2017-02-28 07:05] (current) snakeman fixed mikero tools homepage link to a new domain. |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== PatchPbo ====== | ====== PatchPbo ====== | ||
- | |||
- | PatchPbo will patch your existing pbo automatically for specified files, it also deletes any specified files inside a pbo if selected. This util is useful if you want to upgrade / patch a 500mb characters.pbo with just one new model change; no reason to upload that much, when you can just patch in few hundred kilobytes. | ||
Usage: | Usage: | ||
- | <code> | ||
- | patchPbo [-OverrideOption] <PatchPbo[.pbo]> <TargetPbo[.pbo]> | ||
- | </code> | ||
+ | To Merge a pbo | ||
<code> | <code> | ||
- | options : -a Arma | + | patchpbo OrigPbo[.pbo] [PatchPbo[.pbo]] |
- | -A Arma w sha-key (recommended) | + | |
- | -APrefixOverride (see note) | + | |
- | -r Resistance | + | |
- | -c cwc | + | |
- | -e elite | + | |
</code> | </code> | ||
- | If options not specified, output pbo will be determined by highest order input file. Eg if patch is a CWC and target is an ArmA file, output is ArmA. | + | Output will be to OrigPbo, and, original OrigPbo renamed to OrigPbo.old |
- | Prefix override for ArmA. | + | if not specified. OrigPbo_Patch.pbo is expected in same folder |
- | Unless specifically stated, the engine searches for a suitable prefix name as follows: | + | To Create a patch pbo |
<code> | <code> | ||
- | the name of the patchfile.pbo | + | patchPbo -C OldPbo[.pbo] NewPbo[.pbo] [[PatchPbo[.pbo]] |
- | the name of the targetfile.pbo | + | |
- | the name of the outputfile.pbo | + | |
</code> | </code> | ||
+ | Output will be to NewPbo_Patch.pbo if not specified | ||
- | Example: | + | Examples |
<code> | <code> | ||
- | patchpbo MyPatches APboFile | + | patchpbo -c My\Old\GreatAddon My\New\GreatAddon |
</code> | </code> | ||
- | The output is sent to ApboFile.patched.pbo | + | output to GreatAddon_Patch.pob in My\New folder |
+ | <code> | ||
+ | patchpbo MyGreatAddon | ||
+ | </code> | ||
+ | MyGreatAddon will be patched with MyGreatAddon_Patch.pbo in same folder | ||
- | NEITHER source files are affected. | + | The intention of patchpbo is to produce a 'no-brainer' difference file between original and new versions of, a pbo. I does NOT use delta comression and as a result can be exceptionally small. |
- | You can, as easily, reverse files to | + | This difference file can be downloaded by your users INSTEAD of a completely new pbo with dramatically reduced footprint and bandwidth (often as little as 1% the size !!!!) |
- | <code> | + | |
- | patchbpo ApboFile MyPatches | + | Bisig keys are garanteed to be the SAME as if you had supplied the new pbo. |
- | </code> | + | |
+ | Thus | ||
- | Output will be to MyPatches.patched.pbo | + | without patchpbo you would normally supply your new pbo AND it's bikey |
- | Patchpbo returns NON zero on any error encountered. | + | MyGreatAddon.pbo 1meg <<< the NEW pbo |
- | PatchPbo will STRIP resistance format out of pbo files as being entirely redundant. | + | MyGreatAddon.bikey |
- | PatchPbo RETAINS the original compression (if any) AND encryption (if any) of the original files. | + | WITH patchpbo you supply |
- | DELETING PBO's | + | MyGreatAddon_Patch.pbo 10k |
- | Simply supply a file of zero (0) length inside the <PatchPboFile> | + | MyGreatAddon.bikey the same bikey as your new addon |
- | If this routine discovers the same name in the target pbo, it will remove it. | + | Given that your users have a copy of patchpbo (and it's dll) all they have to do is |
- | **Importantly**, if it does NOT discover one in the target pbo, it considers this to be a genuine attempt to add a zero length file. Such files are often used as version flags. | + | patchpbo MyGreatAddon MyGreatAddon_Patch <<the ORIGINAL pbo |
- | Requires DePbo.dll - Check [[http://dev-heaven.net/projects/mikero-pbodll|Mikero tools homepage]] in Dev-Heaven. | + | Requires DePbo.dll - Check [[http://dev.withsix.com/projects/mikero-pbodll/files|Mikero tools homepage]] in Dev-Heaven. |