Binarize: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Added information from readme)
m (Added a new category)
Line 95: Line 95:




[[Category:Tools]]
[[Category:Tools]][[Category:Arma 3 Official Tools]]

Revision as of 14:35, 14 November 2013

Basic information

Author:
Bohemia Interactive
Compatibility:
Operation Flashpoint Arma 3
Download:
OFP Version at Breathe site ArmA Release Candidate on BIStudio FTP Part of Arma 3 Tools package on Steam

Description

Description:
Binarize is a model/world optimizing tool created by Bohemia Interactive. The purpose of the tool is to convert the file into the representation suitable for fast loading by the game engine. Some information important for editing, but not relevant for the game, may be discarded during the process, therefore the process in not always reversible (which is one of the reasons why BI does not provide a tools which would reverse the binarization).
Notes:
The term 'binarizing' is sometimes used to describe converting a file into an optimized / binary format, like when converting Config.cpp into Config.bin. This is in fact not done using Binarize, rather by another tool called CfgConvert.

Usage

Line call:
binarize [options] source destination mask
Options:
Path to textures
  • -textures=<path>
Files or masks of files to be excluded from binarization
  • -exclude=<filename>
Additonal config is loaded from this folder
  • -addon=<addon folder>

Licenses

Licensing:
Bohemia Interactive End User License Agreement


Additional information

Current directory

Binarize converts p3d and wrp using provided config files. It's important to use defined current directory as there are many files used from there.

   cd \
   (current directory / current_dir)


Config files

Binarize uses following config files:

   current_dir\binarize\bin\config.cpp
   current_dir\addon_folder\config.cpp (one or more addon folders can be defined using -adddon option)
   source_dir\config.cpp (and all config.cpp that are located in subfolders of the source directory)


p3d Objects

Binarize takes all textures and materials used in binarized p3d object and copies them into path defined by "-textures=<path>" with full path to the texture added as it is defined in the object.

During processing the object, binarize will use class CfgModels from all used config.cpp files and creates independent sections from any named selection listed in CfgModels.

Some proxy models used there must be present in the current directory during binarization.


Wrp Worlds

When you binarize worlds, any object defined in config.cpp files under class "ReplaceObjects" can be replaced accordingly.

All models used in the wrp file shall be available under the correct path in the current directory.

Binarize takes all textures and materials used in binarized wrp object and copies them into path defined by "-textures=<path>" with full path to the textures and materials added as it is defined in the world.