Filer2 manual.

version 1.3

  1. Purpose of the programm
  2. System requirements
  3. Distributive
  4. Description
    1. Common user interface
    2. Settings, changing the User Interface (UI)
  5. Desc editing
    1. Preparing file of variables
    2. Editing of the desc and saving results
  6. .sue archives management
    1. Preparing archive manager
    2. Working with .sue archive manager
    3. Using "QucikPack"

  1. Purpose of the program

    The main purpose of the Filer2 is editing of the text files with the similar structure. Particullary finding into the several files the repeatable strings like:
    "parameter_name" "value1" "value2"..."value9",
    or:
    "parameter_name" "value", separeted by the spacebar.
    The SuddenStrike text files (so-called descs) have this structure .



  2. System requirements (tested at) :

    Celeron 1700 Mhz
    256 Mb Ram
    VideoCard SVGA
    OS: WinXP professional edition



  3. Distributive consist:

    1. Filer2.exe - executable file.
    2. Variables.var - variables text file, contain string's templateswith paramteres for searching into the desc. One could change this file.
    3. ReadMe.txt - short description of the programm
    4. Filer2.ini - store some parameters of the programm, not required. If missed deafult settings wiil be used.



  4. Description of the programm

    1. Common interface elements

      The programm provide Single Document Interface. Application's window contain: text editor #1 at the left side and multiple page dialog box (with 11 pages). On the first page located table with the name and full path of the opened descs. On the next 10 pages presented tables with the informations from the descs, where every row is corresponding to the one of the descs and the columns are corresponding to the parameters of the desc. At the twelfth page located text editor #2. For text editor #1 and all tables horizontal and vertical scroolbars are available, for text editor#2 only vertical one. TabStop switching between controls also supported.

      View of the Filer2, " Export/Import table "

      View of the Filer2.

      Filer2 have 5 menus: "File", "Settings","Utilites","Tasks", "About".

      At the "File" menu items are:
      -Open desc (Ctrl+O)
      -Save all (Ctrl+E)
      -Save current (Ctrl+S)
      -Export table
      -Import table

      " FILE " menu

      At the "Settings" menu items are:
      -Open variables
      -Save variables
      -Font
      -Path to editor
      -Path to game

      " SETTINGS " menu

      At the "About" is only one item: "Version".

      At the "Utilites" menu items are:
      -CONMAN (Ctrl+N) --- CONsole MANager
      -DAN (Ctrl+D) --- Desc ANlyzer

      " Utilites" menu

      At the "Tasks" menu items are:
      -Quick Pack
      -Start Editor (F8)
      -Start Game (F9)

      " Tasks" menu

    2. Settings, changing the UI

      Between text editor#1 and multiple page dialog box splitter located. Workspace of the window could be redistributed by this splitter.

      At the "Settings" - "Font" menu one can change the font parameters for multiple page dialog box elements (In the .ini file saved only size of the selected font).

      Using menu items "Path to editor" and "Path to game" one can define paths to executable files of editor and game, after that game and editor can be started by the hotkeys F8 and F9 respective.



  5. Desc editing

    1. Creating variables file

      For it's basic function Filer2 require specially formatted text file (extension not nedeed). At this file must exists 9 section for parameters contains up to 9 values and 1 section for parameters with 1 value. Variables file could be edited inside the Filer2.

      Declaration of the section have the common view:

      [sectionN]
      parameter_name1=number of the values
      parameter_name2=number of the values
      . . .
      parameter_nameX=number of the values

      Where "N"(from 1 till 9) - number of the section (corresponding to the first 9 tables). For every parameter in this sections allowed up to 9 values.

      Declaration of the text section have the common view:

      [section_text]
      parameter_name1=a
      parameter_name2=b
      . . .
      parameter_nameZ=c

      Where a,b,c some positive integer values.

      One can create variables file using internal program DescANlyzer. After chioce corresponding menu item "Utilites" DAN window will appear:

      Window of DescANlyzer
      Window of DescANlyzer

      After one press button "Open" file open dialog will appear. DAN check selected files and create possible list of "parameter_name = number of the values" pairs. In the edit field one set nuber of variable section, after press "Section" this number include to the text editor. For creating text section one need to enter "text" into the edit field. Next one select required parameters in the list (at the left side) then press "Add". After accomplishing all required to user sections press "Copy to Filer2". Variables file will copied to text editor#2 of Filer2 .

      ATTENTION!!! You can correct results of DAN work either in DAN text editor (before copying), or in the text editor#2 of Filer2.

    2. Editing of the desc and saving results

    Common order of the work:

    1. Choose and load the variables file (until ver. 1.1.0.2 automatically loaded variables.var from Filer2's folder)

    2. Opening text file/files (descs) using menu "File" - "Open desc". At the opening desc/descs search parameters names and number of the values listed in the variables file and copying to the corresponding table parameter name and chosen number of the values are proceed. The last desc of the selected ones still opened at the text editor#1. Full path to the currently opened in the text editor#1 file presented in the status bar.
      At the mouse left button click in some cell of the table #1 "File list" corresponding file will be opened in the text editor#1. After that one could edit the one desc and changes can be saved either pressing "Ctrl+S" or at menu "File" - "Save current"

    3. After complete editing opened descs press either "Ctrl+E" or at the menu "File"-"Save all". New values for the parameters from the tables will replace old ones in the descs files.



      ATTENTION!!!!
      Filer2 DOESN'T CONTROL ENTERED VALUES.



    4. At 1.3 added new feaure - export/import tables of descs. Press "File"-> "Export table" (after opening descs) or "Import table" . Give the name to the tabulated text file. This file format compatible for office table processors (e.g. Excel, Calc).

      Tabbed text file opened in the Calc of OpenOffice
      Tabbed text file opened in the Calc of OpenOffice

    5. For versions 1.3.x.x changes write directly to the descs without any backup!!!

  6. .sue archives management

    1. Preparing archive manager

      If one choose at the menu "File"->"ConMan" window of the .sue archive manager "ConMan" will appear. It's provide graphicall interface of the console utilites SUE.exe and UNSUE.exe .

      After starting ConMan first time one need to choose path to the utilites pushing for corresponding buttons ("SUE","UNSUE").

      Path for the utilites will be saved in the file "filer2.ini".

    2. Working with .sue archive manager

      For extracting .sue archive push the button "UNPACK", select archive in the appeared dialog box, after that UNSUE.exe will be executed, and ConMan window will be not available. Report of the proceeded unpacking will be presented at the right side in the text editor.

      For creating .sue archive require select the folder in the ConMan hierarchy tree (below the buttons) and open it (LBM double click). At the figure choosg "__NSM" folder was showed. First two symbols of the folder name will be deleted when create archive.

      Common view of the .sue archives manager ConMan

      Common view of the archive manager ConMan
      at the right side into the text editor presented report of the packing folder "__NSM",
      at the left side correctly selected folder "__NSM"

    3. Using "QucikPack"

      After packing something menu item "QucikPack" will be available. When one press it last packed folder will be repacked without opening ConMan.



Table of contents

Программное обеспечение / Software for modding
Main page

Created by Surgeon at 18.08.2007
NSM mod's site
E-mail: apicis@yandex.ru

Hosted by uCoz