FlatOut language tools Download

Thumbnails:

Description:

This package is composed of two programs; a first one to extract all language strings from FlatOut/FlatOut2 files and export them to a LUA file, and a second one to rebuild the language files from the LUA file.

Those two applications not only allow you to modify strings, but also to add new strings...

• Extracting strings from FlatOut (fo2lgunpack.exe)
  
  Syntax: fo2lgunpack.exe [options]...
  where options are:
  --in|-i languages.dat : Input language file
  --out|-o { file_name } : Output LUA language file
  [--version|-V] : Show version
  [--help|-h] : This help
  
  The main source file is "languages.dat", and all necessary additional files (language0.dat, language1.dat, language2.dat, language3.dat, language4.dat, language5.dat, language6.dat, language7.dat, language8.dat, languages.bed) are searched into same directory as where languages.dat is.
  The output file can be anywhere on your hard disk.
  
  Example:
  fo2lgunpack.exe --in c:\FO2_unpacked\data\languages\languages.dat --out c:\temp\FO2_strings.lua
  
  This will create c:\temp\FO2_strings.lua from language files from directory c:\FO2_unpacked\data\languages
  
  

• Rebuilding FlatOut language files (fo2lgpack.exe)
  
  Syntax: fo2lgpack.exe [options]...
  where options are:
  --in|-i { file_name } : Input LUA language file
  --out|-o languages.dat : Output language file
  [--version|-V] : Show version
  [--help|-h] : This help
  
  This will read the input LUA file and rebuild FlatOut languages files. The output file is now languages.dat, and all other files will be created in same directory. Beware: there is no warning for overwriting, and no directory creation, so be sure all directories in path exist...
  
  In case there is an error in the LUA file, you'll receive the LUA parser error string, with the position of the faulty line - if you're lucky ;). (see Readme.txt for more information)
  
  Example:
  fo2lgpack.exe --in c:\temp\FO2_strings.lua --out c:\temp\FO2\languages.dat
  
  Will create all all languages files in (existing) c:\temp\FO2 directory, based on data content in c:\temp\FO2_strings.lua file.
  
  

• Editing the LUA file
  If everything was perfect in a perfect world, you'll just have to launch your favorite text editor and start changing the LUA file you just generated...
  Unfortunately, this is not that simple as the LUA file generated is made of "wide chars" (each character is coded on 2 bytes instead of just one ASCII byte as usual, because of "exotic" languages).
  
  After making some searching, I found only one editor being able to edit the LUA file without messing it: Xemacs, get the V21.5.7 binary installer.
  
  Edit: While writing this, I made another test with Notepad and WordPad, and they're able to open the file correctly - must be because of installation of "East Asian Language Support" (see below), but some of the (poor) features Notepad has are disabled (like jump to line), and moreover it's extremely slow, making it more or less unusable...
  
  A second thing you'll have to do is to install East Asian Language Support in Windows, because of the japanes language :). Basically it just installs a few new fonts, and some .dll for I don't know what. The whole procedure is explained here, but follow instructions for points 1, 2, and 4, and you'll be ready...
  
  If you do not install East Asian Language Support, then japanese/russian strings and some characters from other languages (including english!!) in LUA file will be displayed with "~" characters in Xemacs, and I think it will mess up everything if you save the file...
  
  ATTENTION: If you open the LUA file in your editor and see garbage (check thumbnails at top of page to see what's right and what's wrong...), or characters separated by what seems to be spaces or squares, then you have it all wrong... go get Xemacs! ;)
  
  (more on the LUA file syntax in Readme.txt...)
  
  
• Package content
  
  fo2lgpack.exe : Packing tool (rebuild language data in FlatOut)
  fo2lgunpack.exe : Unpacking tool (extract language data from FlatOut)
  launch_fo2lgpack.ini : fo2lgpack.exe configuration file for GUIlauncher
  launch_fo2lgunpack.ini : fo2lgunpack.exe configuration file for GUIlauncher
  Readme.txt : Detailed instructions on tools and LUA file format
  
  
  
• History
  
  20070605: V1.1 - Fix backslash escaping
  20070508: V1.0 - First release
  
  

GulBroz.

Submitted On:

11 Dec 2007

Submitted By:

GulBroz (GulBroz)

File Date:

05 Jun 2007

File Author:

GulBroz

File Version:

1.1

File Size:

194.77 Kb

File Type:

rar

Downloads:

945

Rating:

Total Votes:0

Be the first to comment! Please sign in or register.