Conversion tool that is able to convert from the game binary formats (.pmx) to the middle formats (.pix) in Euro Truck Simulator 2 & American Truck Simulator.
This software is used by blender add-on ConverterPIXWrapper which allows you easy use in Blender.
Parameters:
-h, --help prints help text
<base_path>
mode: converts entire base(directory or archive) to mid-formats
-b, --base <base_path>
specify base path and mount it (can be used multiple times)
-e, --export <export_path>
specifies export path
-m, --model <model_path> [<anim_path_1> <anim_path_2> <anim_path_3> ...]
mode: convert single model to mid-formats (model_path is relative to base, without extension)
--find-model-animations <model_path>
mode: finds and prints all matching animations file path to model (model_path is relative to base, without extension)
-t, --tobj <tobj_path>
mode: convert single tobj to mid-formats (tobj_path is relative to base)
-d, --debug-dds <dds_path>
mode: print debug info about given DDS file (dds_path is absolute path)
--extract-file <file_path>
mode: extracts given file and saves it in export path (file_path is relative to base)
--show-file <file_path>
mode: extracts given file and prints it to stdout (file_path is relative to base)
--extract-directory <dir_path>
mode: extracts given directory and saves it in export path (dir_path is relative to base)
--list-directory <dir_path>
mode: lists entries of given directory (dir_path is relative to base)
--list-directory-recursive <dir_path>
mode: lists entries of given directory recursively (dir_path is relative to base)
--calc-cityhash64 <string>
mode: calculate and print to stdout cityhash64 of given string
--calc-cityhash64-file <file_path>
mode: calculate and print to stdout cityhash64 of given file (file_path is absolute path)
--output-material-format147
switch: output materials in 1.47 mid-format
--output-dds-dxt10
switch: output DDS files in DXT10 format
Usage:
converter_pix -b C:\ets2_base -m /vehicle/truck/man_tgx/interior/anim s_wheel
# export into C:\ets2_base_exp single model with s_wheel animation.
# instead of exact animation name you can use * to convert every anim file from model directory.
# when anim name is not started by /, then converter is looking for it in model directory.
converter_pix C:\ets2_base
# will convert whole base, it will export it into: <base_path>_exp (C:\ets2_base_exp in this example).
# you can also specify export path using the -e parameter.
converter_pix C:\base.scs
# will convert whole base, it will export it into: <base_path>_exp (C:\base.scs_exp in this example).
converter_pix -b C:\base.scs -b C:\base_share.scs C:\base_vehicle.scs
# will convert whole base(base_vehicle.scs). It will export it into <base_path>_exp (C:\base_vehicle.scs_exp in this example).
# mounting other archives might be important as files inside base_vehicle.scs may depend on files in other archives.
converter_pix -b C:\ets2_base -t /material/environment/vehicle_reflection.tobj
# will convert tobj file and copy texture to export path.
converter_pix -b C:\ets2_base -m /model/mover/characters/models/generic/m_afam_01 /model/mover/characters/animations/man/walk/walk_01
# animations are located in another directory than the models. These animations can be used for multiple models.
converter_pix -b C:\ets2_base -b C:\mod_base -m /vehicle/truck/man_tgx/interior/model
# multiple base paths (you can specify more paths in the same way)
converter_pix -b C:\base.scs -extract_f /material/environment/vehicle_reflection.tobj
# will extract tobj file into <base_path>_exp (if path is not set by -e parameter). C:\base.scs_exp/material/environment/vehicle_reflection.tobj in this example.
converter_pix -b C:\base.scs -extract_d /material
# will extract entire directory into <base_path>_exp (if path is not set by -e parameter). C:\base.scs_exp/material in this example.
converter_pix -b C:\base.scs -listdir /material
# will show entries (files and subdirectories) of /material directory
converter_pix -b C:\def.scs -show_f /def/ui.sii
# will show content of /def/ui.sii file stored in def.scs archive
Note that animations will not be converted when converting the whole base. TBD
Supported formats: pmg(0x13, 0x14, 0x15), pmd(0x04), pma(0x03, 0x04, 0x05), ppd(0x15, 0x16, 0x17), pmc, tobj, mat, scs(hashfs, v1, v2, hash: CITY), zip(uncompressed & compressed)
This is Open-Source software under GNU LGPL License.
--- Copyright © 2024 Michał Wójtowicz a.k.a. mwl4 ---
--- All rights reserved ---
Enjoy
