ChatCon Helpfile

Index:
  1. Introduction
  2. Options and Settings
  3. Bugs, Errors and Contact Information




1.0 Introduction  top

The Anarchy Online ChatConverter (ChatCon) is the offline standalone-version of Khuri's ChatConverter (www.ao-universe.com).
It was programmed by Gambler, with the aid of Khuri.

This Program is Freeware! You may distribute it as you wish, however you must include this helpfile with the program itself. Additionally claiming money for distribution is forbidden (for example copying on magazine-CDs), unless you have a written approval by the programmers!
(please see Section 3)

We do not take any responsibility for any problems you might encounter using this program! Use it on your own risk!
If you find bugs or encounter greater problems however, please refer to Section 3 of this helpfile.


1.1 How does it work  top

This document explains all parts of the ChatCon and how they work. To use the ChatCon, you first need to insert a chatlog on the textbox saying "Input".
To log your chat ingame, simply right-click your chatwindow, and choose "Log Messages". Saved Logfiles are stored local on your HD in your directory
/Anarchy Online/prefs/AccountName/CharID/Chat/Windows/WindowID/Log.txt

The CharID and WindowID you need to find out yourself. For the CharID, you can hit SHIFT+F9 ingame, and look for a line saying
CharID: 50000:NUMBER - the number after the : is your CharID.

The three main buttons should be self-explanatory.

Load a logfile directly. Select the Log.txt and hit open.
Convert the currently loaded Logfile (or what you copied into the Input-Textarea) with the selected options.
Save the content of the Output-Textarea in a new TXT-file; you need to convert your logfile first, to get the output.



2.0 Options and Settings  top

2.1 Converting-Type  top

You can convert your logfiles to UBB-Code and HTML-Code.
UBB-Code is a structure a lot of web-forums out there use. You should experience no trouble posting logfiles converted with this options in most forums.
HTML-Code can be used if you want to copy your converted logfile on a website directly.

2.2 Show Channelname  top

Unchecking this option has the effect that you won't see the channelname in front of the charactername anymore.
Unchecking might be useful, if you only have one channel.
Example (checked):
[Vicinity] Khuri: This is a chatline
Example (UNchecked):
Khuri: This is a chatline

2.3 Use Colors for Channels  top

Checking this option will colorize the different channelnames of your chat, using preset colortags similar to the ingame-colors.
Note that this option only works if you have Show Channelname enabled!
You can adjust the colos in the Options. Go on the menu File -> Options
Example (checked):
[Vicinity] Khuri: This is a chatline
Example (UNchecked):
[Vicinity] Khuri: This is a chatline

2.3.1 Change Color of Channels  top

The colors are set in HEX. To change a color simply overwrite it or Doubleclick it, a Color dialog will show up so that you can see the color you want to choose.
To add a new Channelname, simply press your arrow-down key and a new blank line will appear. If you want to delete an entry just clear the line.

2.3.2 Restore Default Color of Channels  top

In case you messed up all your colors, simply click the "Restore Default" button and confirm.

2.4 Show Time  top

Checking this option will show the time when the chatline was created between the Channel- and the Charactername.
On standart, it shows the time in Year:Month:Day:hour_minute_second format.
Example (checked):
[Vicinity] 2006:9:12:20_10_12 Khuri: This is a chatline
Example (UNchecked):
[Vicinity] Khuri: This is a chatline

2.4.1 Change Time Display  top

You can adjust the displaying of the time in the Options. Go on the menu File -> Options -> Customize Time Display
There is several variables for the time. You can adjust the display the way you like it to be displayed.
Y = Year
M = Month
D = Day
h = Hour
m = Minute
s = Second

Those are the chars used for the time display. Feel free to use any other char you want as a separator.
Example:
YMD = 2006101
Y.M.D = 2006.10.1

2.5 Mark Removed Links  top

As the ingame-links do not work in normal HTML-output, the ChatCon will remove all ingame-links from the converted logfile, to prevent people clicking on broken-links.
Is this option activated, the script will insert a note in each line, stating it removed a link.
Example (checked):
Khuri: Link removed This is a chatline, and this a link
Example (UNchecked):
Khuri: This is a chatline, and this a link

2.6 Delete all Tags in Chatlines  top

This is an anti-spam option. Will will remove all HTML-tags from the chatlines, including colors and links.
Example (checked):
Khuri: This is a chatline
Example (UNchecked):
Khuri: This is a chatline

2.7 Filters  top

There is three filters for your chatlog. You can filter names, channels as well as only convert the chat from a single day or month.
Of course you can combine the use of all three filters at once if required. To activate a filter, check the box for it. To deactivate it, uncheck the box again.

2.7.1 Filter Persons  top

Select the names of the persons you only would like to appear in the converted Chatlog. All chatlines from other characters will be dropped in the output. To select multiple names, either hold down CTRL and click the names, or hold down the SHIFT-key to select a range of names at once.

2.7.2 Filter Channels  top

Select the names of the channels you only would like to appear in the converted Chatlog. All chatlines from other channels will be dropped in the output. To select multiple names, either hold down CTRL and click the names, or hold down the SHIFT-key to select a range of names at once.

2.7.3 Filter Time  top

Here you can select a time-range you wish to only convert from the logfile. The treeview can be filtered by year, month and single days. If you select a month, all days within this month will be converted, the same counts for selecting a year. Select the names of the persons you only would like to appear in the converted Chatlog. All chatlines from other dates will be dropped in the output.
To select multiple times, hold down CTRL and click the times



3.0 Bugs, Errors and Contact Information  top

3.1 Window Freezes/Windows reports program suspended  top

When you load a logfile or convert a logfile, a small window opens, showing you the total number of chatlines to process, as well as the current line it reads/converts.
During this processing time, the program window itself might start to give graphical bugs and/or the processing-bar might get stuck, and Windows reports the program suspended.
This usually happens if you click something or switch to another program window. As the main program window does not react on clicks and the like, Windows assumes the program suspended; in fact, the program keeps working in the background, and, depending on the size of your logfile and computer-speed, will show you the output after it is done processing. It might happen you *have* to click to make the progress-bar disappear then.
As said, the processing time depends on the size of your logfile, your selected filter options, and your computer's speed. If you should encounter this error, and there is no result after a couple of minutes, please close the program, start it again and try once more to load/convert your logfile.

3.2 The Progress Bar appears multiple times on converting  top

It might happen you see the Progress Bar appear multiple times on converting, starting by line zero a few times again. This is not a bug, but happens when you are using different filters at once with many options. For example, filtering Persons and Chatlines from the months january and march.

3.3 The Progress Bar seems to slow down while running  top

If you process a very huge logfile, it might happen that the speed of the Progress Bar seems to get slower the more chatlines are processed. This is no error, but happens as a lot of data is cached during the loading/converting.
We successfully converted a 10mb logfile. It took several minutes on an (currently) average PC, but it has been working. We're looking for ways to improve the compilation code in the future of course.

3.4 I found an Error that seems unnormal  top

First question: Can you repeat the error?
If you encounter a problem once, please try to repeat your actions. If you can successfully repeat that error, please try doing the same but load another logfile. If the error persists, please send us an email including the information as of what you did, and how to repeat that error.
If your problem does only happen on a specific logfile, and you don't mind giving out that logfile, please use a common compress-tool like WinZip and send us a copy of your logfile, including the information what options you selected to cause the error. If you do not wish to send us your logfile, please send us the information as of what you did, and how to repeat that error netherless.
Thank you for your help!

3.5 Contact Information  top

If you have questions, wish to send in Feedback or Report Errors, please either drop a line on the forums at www.ao-universe.com or send an email to chatcon@ao-universe.com.
Thank you for your feedback!




ChatCon Helpfile - 18. October 2006, written by Khuri