v4.0.0.7 (AGS 4.0 Alpha 12)

This is AGS 4.0 Alpha 12.

Contains fixes from 3.6.1 Patch 4 (except ones related to backwards compatibility).

Other changes:

Editor:

• Improved scrolling of drop-down lists in the Room's navigation bar: made scroll buttons larger, and support mouse wheel.
• Do not delete previously built game exe from Compiled/Windows folder when testing a game from the editor.
• Added "Open Recent" submenu in the File menu.
• Sync script editor's commands in Edit menu with the context menu.
• Added "Toggle Line Comment" command to Edit menu for scripts.
• Added "Word Wrap" command to Edit menu for scripts.
• Support to import and keep sprites as explicitly 8-bit images without converting to the game's default color depth. This lets to have chosen sprites used as 8-bit masks in a 16/32-bit game.
• Added TurnWhenFacing property to Characters.
• Fixed Character.Enabled and Visible properties not written correctly when the game is built.
• Fixed an unhandled exception occuring when rebuilding rooms if any script's header is missing.

Script API:

• Added MaskPathfinder struct, which lets to initialize a Pathfinder using a 8-bit sprite serving as a navigation mask.
• Added Character.TurnWhenFacing property.
• Added ColorFormat enum, and optional "color_format" parameter to DynamicSprite's functions: Create(), CreateFromBackground(), CreateFromDrawingSurface(), CreateFromExistingSprite() and CreateFromFile().
• Added readonly DrawingSurface.ColorDepth property.
• Added readonly Game.SpriteColorDepth[] indexed property.
• Added StringSplitOptions enum, and "options" parameter to String.Split().
• Expanded on_mouse_click callback, now supports two more parameters: click x,y coordinates.
• Global generated game objects (Characters, GUIs, etc) are now declared as object pointers in script (this complements recent similar change done to arrays of game objects).
• All the area-related GetAtScreenXY functions (for Hotspot, Region, Walkbehind and WalkableArea) now return a null pointer if no room viewport is found under given coordinates.

Engine:

• GetTextHeight() no longer reduces "width" parameter by -1. This was an ancient mistake in the engine kept for many years for backwards compatibility.
• Fixed a crash occuring when debugger requested a variable's value, but script contains no "table of contents".
• Fixed Character.MovePath and WalkPath not reacting to the "path" parameter being a null pointer, and proceeding with mistakes.
• Fixed a crash in SaveScreenShot (repeating regression in AGS 4).
• Fixed WalkableArea.GetAtScreenXY and GetAtRoomXY returning "garbage" values instead of a valid WalkableArea pointer.

v3.6.1 - P4 (3.6.1.26)

This is a 3.6.1 Patch 4.

Editor:

• Fixed extracting templates with very large files inside would cause "Out of memory" error.
• Fixed crash occuring when trying to import a non-existant GIF frame during Sprite Import.
• Fixed potential mistake with sprite transparency occuring when importing a 8-bit sprite into 16/32-bit game.

Compiler:

• Fixed "\t" (and few other less common escaped chars) not handled properly when they are inside string literals.
• Fixed a crash in compiler occuring if user script defined a variadic function.
  (User-defined variadic functions are not properly usable at the moment, but this at least prevents an unhandled exception.)

Scripting:

• Declare "UNICODE" macro for scripts if game is made in unicode mode.

Script API:

• Added a number of missing OPT_* constants used with Get/SetGameOption functions.

Engine:

• Fixed setting Screen.AutoSizeViewportOnRoomLoad to false in "game_start" could cause primary viewport and camera become initialized with zero width and height.
• Fixed setting camera's size in "game_start" would unexpectedly get camera clamped to 320x200.
• Fixed number of mistakes in Text Parser occuring when handling "multiwords".

v4.0.0.6 (AGS 4.0 Early Alpha 11)

This is AGS 4.0 Early Alpha 11.

Contains fixes from 3.6.1 Patch 3 (except ones related to backwards compatibility).

Other changes:

Editor:

• Added "Watch Variables" panel which lets to watch values of the selected script variables while running the game. This feature is working only if game is built in Debug mode.
• Support importing 1-bit (monochrome) and 4-bit images as sprites, room backgrounds and masks (converted to 8-bit).
• Ensure that Editor exports room backgrounds in their actual color depth.
• Improved scrolling of drop-down lists in the Room's navigation bar: made scroll buttons larger, and support mouse wheel.
• Fixed breakpoints not working in room scripts.

Script API:

• Added Pathfinder struct, which lets to search walkable paths in certain two-dimensional "space", and returns them as an array of Points.
• Added Room.PathFinder property that returns a Pathfinder object, searching paths over this room's walkable areas.
• Added Character.MovePath() and WalkPath(), which makes character to move along an arbitrary list of coordinates, and Character.GetPath() that returns current character's walking path.
• Added Object.MovePath() and Object.GetPath() functions, that work similar to Character's.
• Added GUI.ScaleX and ScaleY properties, GUI.SetScale() function.
• Added GUI.GUIToScreenPoint() and GUI.ScreenToGUIPoint() functions.
• Added Speech.SpeakingCharacter that returns currently speaking character (for blocking speech).

Engine:

• Ensure that Character.Speaking returns true even if character has no speech view.
• DynamicSprite.CreateFromFile() may now load 1-bit and 4-bit bitmaps, converting to 8-bit.
• Fixed VideoPlayer's looping mode not working.

Engine Plugin API:

• Added IAGSEngine.Log(), which lets plugins to print using engine's log system.

v3.6.1 - P3 (3.6.1.25)

This is a 3.6.1 Patch 3.

Editor:

• Fixed that after deleting a View's frame editor did not select next frame (regression in 3.6.1).
• Fixed "Delete last loop" button not appearing in the View Editor if the view is filled using "Assign sprites to view" command from the Sprite Manager.

Engine:

• Implemented an alternate solution for rendering "bad" TTF fonts that does not increase their loading times (after previous patch 2).
• Allow scene render during "load room" event if the last room transition was "Instant".
  This has to be done because number of games used this event for custom transitions.
• For games compiled in "Debug" mode "warnings.log" file will be written in "savegame dir" on platforms where modifying game directory is forbidden in principle (OSX, iOS, Android, Web).
• Fixed System.Log() was registered for plugins using a wrong argument list.

Compatibility:

• Fixed loading of 3.5.0 saves (broken in 3.6.1).

Windows:

• Fixed disk space check was testing space in the current directory instead of the save game location.

v4.0.0.5 (AGS 4.0 Early Alpha 10)

This is AGS 4.0 Early Alpha 10.

Contains updates and fixes from 3.6.1 up to Patch 2 (except ones related to backwards compatibility).

Other changes:

Editor:

• More panes in the Editor are DPI-aware (rescale well with the system font scaling).
• Editor tabs now display icons indicating their contents (may be disabled in Editor Preferences).
• Room panel tabs now display room names.
• Support reordering folders in Project Explorer with drag & drop.
• Support importing plain script files: ash, asc or both, - besides script modules (*.scm).
• Added "Controls transparency" slider to GUI edit pane.
• Fixed few problems occuring when importing old rooms into the new editor.
• Fixed some of the new files could be left after old room upgrade in case of a failure.
• Fixed import, palette remap and compilation of 8-bit room backgrounds in 8-bit games.
• Fixed double warning message when trying to close the Editor while a game test is running.

Script API:

• Added Character.MoveStraight() complementing WalkStraight().
• Added String.Join(), String.Split() and String.Trim() functions.
• Added System.GetEngineInteger() and System.GetEngineString() for returning diagnostic information about engine's runtime state. Possible arguments are defined by EngineValueID enum.

Engine:

• Overlay.X and Y properties of textual screen overlays, such as blocking speech, now treat assigned values correctly as screen coordinates and return values set by user consistently. They also return the assigned values without any offsets for textual overlays created using a TextWindow (having extra borders and padding).
• Added "--no-plugins" command-line argument that denies loading any plugins; also added respective config option.
• Fixed taking screenshots not working properly (regression in AGS 4.0).

v3.6.1 - P2 (3.6.1.24)

This is a 3.6.1 Patch 2.

Editor:

• Fixed few potential program errors for "Generate Keystore" in Android preferences.
• Fixed external processes (such as test game runs) were started using ShellExecute, which could theoretically lead to unintended results.

Engine:

• Fixed String.Replace crashing the engine if the resulting string exceeds 3000 bytes.
• Fixed releasing a mouse button could cause double "on_event" call (with eEventGUIMouseUp).
• Improved rendering of TTF fonts which have glyph sizes surpassing declared font's height.
  This fixes the look of text on gui controls, and automatic outlining on these fonts.
• Fixed a dialog shown with InputBox() function drawing typed text beyond text box'es border.
• Fixed custom dialog options in the "old mode" not triggering redraw when the active option changes.

v3.6.1 - P1 (3.6.1.23)

This is a 3.6.1 Patch 1. Unfortunately there was a serious problem found soon after 3.6.1 release announcement, releated to dynamic sprites (see below). This patch aims to fix that, and also fixes few less critical regressions.

Editor:

• Fixed View's frame preview sometimes drawn incorrectly, in case of certain panel sizes.
• Fixed folding in the script editor not working correctly if there's a commented closing bracket ("//}") inside this code section.
• Fixed Editor sometimes failing to update game exe's file information and/or icons, if user was importing any sprites during this working session.

Engine:

• Fixed room objects not updating under Direct3D/OpenGL renderer, if they were assigned a dynamic sprite, then that sprite was deleted, and a new one assigned with coincidentally same ID.
• Fixed room objects not updating under Software renderer, if they were assigned a dynamic sprite, and that sprite was modified while object was not visible on screen.
• Fixed inventory cursor's crosshair not displayed (when enabled in game settings).

3.6.1 Release

This is a stable 3.6.1 release. The contents of this update are listed in Changes.txt as usual.

If you're making games with this, please be sure to read "Upgrading to 3.6.1" article in the manual.

People who were working on this release:
@AlanDrake
@edmundito (fixes for OSX and iOS)
@ericoporto
@ivan-mogilko
@tag2015 (fixes)

v3.6.0 - P11 (3.6.0.58)

Editor:

• Fixed exception in Room Messages editor occuring if a certain game's Character is missing.

Engine:

• Fixed disabled GUIs not hiding their controls if "Hide all their controls" disabled style is set in General Settings, and game is run with Direct3D or OpenGL renderers.
• Fixed "greyed out" GUI controls leaving traces on parent GUIs when running with Software renderer.
• Fixed text parser in Dialog Options not working correctly if "new key handling" mode is on.
• Fixed DynamicSprite.SaveToFile() return value was inverse (regression in 3.6.0).
• Fixed engine crash in GetHotspotProperty() if the function is called with invalid ID.
• Fixed room Camera may fail to restore its position in the room after loading a save.
• Fixed fonts may not be assigned correct parameters when a new game is launched by calling RunAGSGame() in script (regression since 3.6.0 or 3.5.*).

Compatibility:

• Fixed engine refusing to load saves made by 3.2.0 engine, although being capable to do so.

v4.0.0.4 (AGS 4.0 Early Alpha 9)

This is AGS 4.0 Early Alpha 9.

Contains updates and fixes from 3.6.1 RC6 (except ones related to backwards compatibility).

Other changes:

Editor:

• Fixed 8-bit images imported and converted for a 32-bit game to not get their colors clamped to a low-precision palette.
• Fixed 8-bit rooms not being usable in the new Editor version (regression in AGS 4).
  NOTE: 8-bit backgrounds are still not working fully correct in this version, new imported bgs do not have their palette remapped.
• Fixed Room Editor can crash when working with non-32bit rooms (regression in AGS 4).

Script API:

• Added VideoPlayer struct, which provides means of playing non-blocking videos rendered onto a sprite that may be displayed on any game object.

Engine:

• Camera will not follow a disabled player character.
• Fixed error occuring when trying to make a screenshot while running Direct3D renderer (regression in AGS 4).
• Fixed sprites leaving traces on background while running Software renderer (regression in AGS 4).