Program copies data from AOK TS, Units tab, into your text document, OR sets objects properties from text document into AOK TS, Unit tab window objects. You can filter objects which you want to have in the results.
Controls/Hotkeys:
Win+w to read&write data from Units tab
Win+s to read&set your objects according your text document
Win+r to reload program
Settings:
Type name of the window, where to paste data or where to read from. This is txt document. If it is notepad document like coords.txt you can write coords or coords.txt, but if your window starts like PSPad - [S:\coords.txt* them you need to type PSPad or whole title to identify the Window.
Filter items - these are options for filtering units from list of objects in AOK TS
Filter name - if you type cliff, it will look for cliffs
Filter from ID - if you type ID, it will look for items starting from this ID.
Filter to ID - if you type the ending ID, it will look for all items greater or equal to this ID
If filter field is empty, this will not filter according this conditon.
Start from selected item? - This will start the search from selected item.
How many items? - How many objects do you want to retrieve. If you keep this field empty, then it will get all found items. If you set it as 1, then it will find only 1 item. If you set it any number bigger then 1 after your job is finished, your setting will appear again.
Change X, Change Y - Default empty, don't change anything. Number in this field is taken as relative number, it will be added to original value. If you insert this number within rounded brackets, all items will change to this number (it's evaluated as expression and taken as absolute number).
Next checkboxes defines which properties will be captured or set. You must keep same settings for both modes to keep compatibility of readback.
Test only - To see what items would be captured. It makes simultaneous reading of data.
Slower - to make the proccess slower (either test or reading of data. These are for your control)
General:
After submitting of settings, your settings is saved to file. There are your preferred choices saved. You can edit them later or delete the file to recreate it again.
To work correctly, you always need 2 windows opened, except test. You start your job with a hotkey (win+key). For example, hitting win+w will copy data from desired items into txt document. Then you change the data in txt file or you reload the program to realod the GUI window.
By default, the program selects Unit tab every time you press hotkey. But you can disable that behaviour in config by changing activeTab to activeTab=0 .
Remember, column with Unit Name must be always on its place in your txt document. You need not to capture unit ID, but when you run program to set objects, there must be the Unit ID in the first column.
If you reloaded program, then you change your settings in GUI Window. If you let the ID to be enabled, then no filters are used. Those objects will be set, which you defined in the txt table. Program will look for the ID, that you have it in your table.
Remember, the objects in the table must be ordered from the smallest ID to the biggest ID, otherwise, some objects would be skipped.
If you have the ID checkbox enabled, the same object as you just copied, will be set. Or you disable the ID checkbox and then different rule will be used to set your objects. Most likely you want to change only some number of items, most likely starting with actual item selected. This all you can configure in GUI window. The object data which you captured can be used for different purposes, in scripts or in next programs which I will prepare in future. It is expected, that if you will use more AHK programs (scripts), you should close the previous programs, because if they use same hotkey, it could run incorrect program. You could be surprised by unwanted actions.
For users of AHK script: If you need to start initial settings, just reload the script (right click on icon H, right in bar. You can pause the script too, but the problem will occur in the moment, if you run some actions and you click on different window. That is kind of danger.
You should not touch keyboard or mouse click on windows when the program does some actions).
AOKTSS Objects
Basic Description:
Program copies data from AOK TS, Units tab, into your text document, OR sets objects properties from text document into AOK TS, Unit tab window objects. You can filter objects which you want to have in the results.
Controls/Hotkeys:
Win+w to read&write data from Units tab
Win+s to read&set your objects according your text document
Win+r to reload program
Settings:
Type name of the window, where to paste data or where to read from. This is txt document. If it is notepad document like coords.txt you can write coords or coords.txt, but if your window starts like PSPad - [S:\coords.txt* them you need to type PSPad or whole title to identify the Window.
Filter items - these are options for filtering units from list of objects in AOK TS
Filter name - if you type cliff, it will look for cliffs
Filter from ID - if you type ID, it will look for items starting from this ID.
Filter to ID - if you type the ending ID, it will look for all items greater or equal to this ID
If filter field is empty, this will not filter according this conditon.
Start from selected item? - This will start the search from selected item.
How many items? - How many objects do you want to retrieve. If you keep this field empty, then it will get all found items. If you set it as 1, then it will find only 1 item. If you set it any number bigger then 1 after your job is finished, your setting will appear again.
Change X, Change Y - Default empty, don't change anything. Number in this field is taken as relative number, it will be added to original value. If you insert this number within rounded brackets, all items will change to this number (it's evaluated as expression and taken as absolute number).
Next checkboxes defines which properties will be captured or set. You must keep same settings for both modes to keep compatibility of readback.
Test only - To see what items would be captured. It makes simultaneous reading of data.
Slower - to make the proccess slower (either test or reading of data. These are for your control)
General:
After submitting of settings, your settings is saved to file. There are your preferred choices saved. You can edit them later or delete the file to recreate it again.
To work correctly, you always need 2 windows opened, except test. You start your job with a hotkey (win+key). For example, hitting win+w will copy data from desired items into txt document. Then you change the data in txt file or you reload the program to realod the GUI window.
By default, the program selects Unit tab every time you press hotkey. But you can disable that behaviour in config by changing activeTab to activeTab=0 .
Remember, column with Unit Name must be always on its place in your txt document. You need not to capture unit ID, but when you run program to set objects, there must be the Unit ID in the first column.
If you reloaded program, then you change your settings in GUI Window. If you let the ID to be enabled, then no filters are used. Those objects will be set, which you defined in the txt table. Program will look for the ID, that you have it in your table.
Remember, the objects in the table must be ordered from the smallest ID to the biggest ID, otherwise, some objects would be skipped.
If you have the ID checkbox enabled, the same object as you just copied, will be set. Or you disable the ID checkbox and then different rule will be used to set your objects. Most likely you want to change only some number of items, most likely starting with actual item selected. This all you can configure in GUI window. The object data which you captured can be used for different purposes, in scripts or in next programs which I will prepare in future. It is expected, that if you will use more AHK programs (scripts), you should close the previous programs, because if they use same hotkey, it could run incorrect program. You could be surprised by unwanted actions.
For users of AHK script: If you need to start initial settings, just reload the script (right click on icon H, right in bar. You can pause the script too, but the problem will occur in the moment, if you run some actions and you click on different window. That is kind of danger.
You should not touch keyboard or mouse click on windows when the program does some actions).
Last edit: rumburak24 2012-08-24