Windower 3.4

Windower 3.4, which is primarily a bugfix release, will also bring new features to expand on the control the user has over the Windower software.

The following bugs were fixed:

• Plugin Crashing: 3.3 had a MAJOR bug in its code that was causing plugins to randomly crash, behave incorrectly or downright cause the game to crash. This bug has been remedied 100% and now is now perfectly stable.
• Random Exec Failure: The bug found last summer of 2007 where script execution would sometimes fail for absolutely no reason should now be fixed.
• Modifier Key Sticking: Previously, alt-tabbing with buttons such as shift/alt/control would 'stick' so that when you come back to the game, windower THOUGHT those buttons were still down. Windower will now correctly handle the keys states and no longer stick.
• Screenshot Hangup: When taking screenshots before 3.4, using the JPG or PNG options would often lead to a small hang-up while the screenshot was being saved. This is no longer a problem in 3.4 and your game will smoothly take the screenshot without the hang-up.
• Screenshot Memory Leak: Previously when taking large numbers of screenshots a memory leak was clearly seen, causing the game to eat up alot of memory. This has been fixed.
• Toggleframe: The window_toggleframe command did not work properly unless 1 or 0 was specified. That has been fixed and will now properly toggle. Also, the size will readjust with what the game was launched with and keep the size the same so the text does not get distorted! (note, this will revert a WinControl size change when using this command). Additionally, //toggleframe has been added.
• Crash On Paste: When pasting large amounts of text, the game would crash. This has been fixed and will only paste the maximum character amount the game allows, thereby preventing a crash.
• Unbind Crashing: Previously unbinding keys would sometimes crash your game. This has been fixed.
• Exec Execution Order: A bug where using 'exec' inside of another exec would cause the first file to continue processing commands without waiting for the file it executed to finish, causing scripts to be executed out of order, has been fixed.
• Missing Keys in Console: The following key's have been fixed so that they can be typed into the console, where previously they could not: { } [ ]
• Priority: The priority plugin is no longer needed as 3.4 has the priority code built straight into it. You should no longer have any priority problems. You do not need the Priority.dll file for 3.4.

The following changes have been made/added to Windower:

• Accidental Resizing Prevention: Previously you could freely resize the window, and a lot of times it was done accidentally, resulting in hard to read text of the game. This has been changed so you will need to hold down Alt or Control to resize the window, and keep it proportional. If you wish to resize the window without proportion restriction, you can hold down shift while resizing. This does not affect the Maximize or Minimize buttons, as restoring the window returns it to the proper size without issue.
• Close Button: A new prompt has been added when clicking the X on the game prompting for confirmation on close, and gives you the option to do a Terminate instead of close to completely close the game. You are able to disable this prompt if you wish to not use it. Also, with addition to this feature, you may change the default close method used when the X button is clicked (which will also change the default button highlighted on the confirm box).

• Console Opening While Chatting: «THIS FEATURE IS OPTIONAL AND DEFAULTED OFF» Previously if a key was set to be the console key it could not be used in game for any other purpose, including chat. In Windower versions prior to 3.3 the default key was ` (~) which prevented the use of those 2 characters in chat. This has been changed so console key will not toggle the console while you are typing into the game chat, so you could bind any key, say 'c' to be your console key now and still use it to type. However, if you bind a key like 'c' as your new console key, you will not be able to start any communication in your current locked chatmode with this as the first letter. For instance, if you use /cm p, you cannot start a new sentence with the letter 'c' or it will open your console. You would first have to type /p and then start your sentence.
• Error Messages: Error messages for failing to execute a script and failure to load a plugin will now display the error message as to why it failed to load.
• Multibind: You may now bind multiple binds at the same time to 1 command for situations that both binds do the same thing by piping the key. ex: bind !1|^1 thunder4 would bind Alt1 and Ctrl 1 to Thunder4
• Paste Insertion: Previously when pasting text into the game it always appended to the end of the message, now it will correctly insert into the location your caret is located at.

The following new commands were added to Windower:

• game_allowresize: This command, when set to 1, will disable the resizing restriction and you may freely resize the window proportionally without holding down Alt or Control. The shift key is still required to resize without proportion restrictions (1 for allowing resize without holding alt or control).
• game_exitprompt: This enables and disables the prompt asking for confirmation to close the game (0 for no prompt).
• game_exittype: This sets the exit type for the game, Terminate or Exit to POL (1 for Terminate).
• plugin_list: Lists all loaded plugins into the game chat log.
• plugin_unloadall: Unloads all loaded plugins.
• plugin_reload: Unloads and reloads a plugin.
• console_screendir: Changes the directory that screenshots are saved to (send 'console_screendir' without a path and it will default to the normal directory).
• listbinds: Lists all currently bound keys into the game chat log.
• listaliases: Lists all currently created aliases. (Command will fail if you have more than 40 aliases)
• clearbinds: Unbinds all currently bound keys.
• clearaliases: Clears all currently defined aliases.
• console_chatopen: Disables the ability to open the console when the chatbox is open when set to 1.
• fps_position: Repositions the FPS Counter.
• setkey: Sets the keystate of a key on the keyboard for the specified window.

The console has been upgraded to allow more basic features.

• Caret Added: A caret has been added showing your current cursor position of typing.
• Left/Right/Home/End: You may now use the Left/Right/Home/End keys to move the caret position when typing a command in the console.
• Paste: You may now paste commands into the console.

5 New modifier keys have been added to be used with keybinds similar to ! and ^

• @: Signifies this key is pressed while holding the Windows Key.
• #: Signifies this key is pressed while holding the Apps key. 1)
• $: Signifies this bind is only triggered if the games chat box is opened.
• %: Signifies this bind is only triggered if the games chat box is closed.

Example:

bind !@1 input /echo Pressed Alt-Win-1
bind @1 input /echo Pressed Win-1
bind #2 input /echo Pressed Apps-2
bind apps input /echo Pressed Apps
bind %h input /echo pressed H when not chatting
bind $h type h;input /echo pressed h while chatting.

• NOTICE: This will cause problem's with using the key “apps”, or either of the Windows keys as standalone binds. It's strongly encouraged you do not bind those keys.

The following keys are now bindable for users with multimedia keyboards.

	//@Aikar: new keys
	STRKEYMAPPING("mail",DIK_MAIL)
	STRKEYMAPPING("mmselect",DIK_MEDIASELECT)
	STRKEYMAPPING("mmstop",DIK_MEDIASTOP)
	STRKEYMAPPING("mute",DIK_MUTE)
	STRKEYMAPPING("mycomputer",DIK_MYCOMPUTER)
	STRKEYMAPPING("mmnext",DIK_NEXT)
	STRKEYMAPPING("mmnexttrack",DIK_NEXTTRACK)
	STRKEYMAPPING("mmplaypause",DIK_PLAYPAUSE)
	STRKEYMAPPING("power",DIK_POWER)
	STRKEYMAPPING("mmprevtrack",DIK_PREVTRACK)
	STRKEYMAPPING("mmstop",DIK_STOP)
	STRKEYMAPPING("mmvolup",DIK_VOLUMEDOWN)
	STRKEYMAPPING("mmvoldown",DIK_VOLUMEUP)
	STRKEYMAPPING("webback",DIK_WEBBACK)
	STRKEYMAPPING("webfav",DIK_WEBFAVORITES)
	STRKEYMAPPING("webforward",DIK_WEBFORWARD)
	STRKEYMAPPING("webhome",DIK_WEBHOME)
	STRKEYMAPPING("webrefresh",DIK_WEBREFRESH)
	STRKEYMAPPING("websearch",DIK_WEBSEARCH)
	STRKEYMAPPING("webstop",DIK_WEBSTOP)

The windower scripting engine has been improved upon to enable users to escape out byte codes and other symbols for input into chat.

This enables use of things like \t \r \n (while limited in use), however, the main goal here is the ability to input bytes from an ascii input.

you may now input byte codes as follow: \xFD\x02\x02\x01\x0B\xFD This would input the raw byte codes that make the game say Hello! in auto translate. Previously under 3.3 and lower, many auto translates included characters that would interfere with the scripting language or could not be simply pasted clearly into a script. This new introduction of escaped bytes will enable users to do better things with scripts.

Additionally, you may now escape ; and use that character in 'input' commands, and it will not treat it as a new line; example: input /echo hi\; this is still message 1;input /echo this is message 2

WARNING: The escape character is the standard choice of \, so this means if you use \ in your scripts you MUST escape the \ itself.

exec blm\blm.txt MUST be changed to blm\\blm.txt.

If you do not make this change, windower will try to execute blmblm.txt Refer to the news post for more information: http://forums.windower.net/index.php?showtopic=12274

Previous applications written to use Windower Helper WILL BE BROKEN!!!!

Application Developers are urged to update their application, and add support for the new MMF Name.

The Name of the MMF Files have changed:
“WindowerMMFTextHandler” in CreateTextHelper() to “WindowerMMFTextHandler_PID”
“WindowerMMFKeyboardHandler” in CreateKeyboardHelper() to “WindowerMMFKeyboardHandler_PID”
“WindowerMMFConsoleHandler” in CreateConsoleHelper() to “WindowerMMFConsoleHandler_PID”

Replace PID with the PID of the Process you are wanting to interact with. Finding the PID for the POL Process is up to you, but it's fairly easy.

This change was done to enable dualbox support to WindowerHelper, as the old file names did not provide clear dualbox support. You do not need a new WindowerHelper, simply changing the MMF File names in your source will be all that's needed to update your programs.

Additionally, keyboard_allowmmf has been defaulted to DISABLED. User's who wish to use 3rd party applications that can control their keyboard must explicitly allow it in their init.txt file or manually every load.

If you do not need Plugins or Windower Scripting support, you should use Windower Lite.