Difference between revisions of "Binarize"

From Bohemia Interactive Community
Jump to: navigation, search
m
(Notes about textures.lst)
Line 81: Line 81:
 
Some proxy models used there must be present in the current directory during binarization.
 
Some proxy models used there must be present in the current directory during binarization.
  
 
  
==== Wrp Worlds ====
+
==== textures.lst ====
  
 +
When this file is present at the root of the addon directory, every referenced textures will be converted.
 +
A3\Air_F\Data\0_CA.png
 +
A3\Air_F\Data\1_CA.png
 +
A3\Air_F\Data\2_CA.png
 +
A3\Air_F\Data\blank_CA.png
 +
A3\Air_F\Data\Minigun_TI_CA.tga
 +
The path to the texture must include the "project path", as used in Addon Builder.
 +
 +
 +
==== Wrp Worlds ====
  
 
When you binarize worlds, any object defined in config.cpp files under class "ReplaceObjects" can be replaced accordingly.
 
When you binarize worlds, any object defined in config.cpp files under class "ReplaceObjects" can be replaced accordingly.

Revision as of 13:18, 7 September 2015

Basic information

Author:
Bohemia Interactive
Compatibility:
Operation Flashpoint, Arma 3
Download:
ArmA Release Candidate*, Part of Arma 3 Tools package on Steam
* Cannot be used with Arma 3

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.


textures.lst

When this file is present at the root of the addon directory, every referenced textures will be converted.

A3\Air_F\Data\0_CA.png
A3\Air_F\Data\1_CA.png
A3\Air_F\Data\2_CA.png
A3\Air_F\Data\blank_CA.png
A3\Air_F\Data\Minigun_TI_CA.tga

The path to the texture must include the "project path", as used in Addon Builder.


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.