v3.6.3.12 - RC1

This is 3.6.3 RC1.

Contains all fixes from 3.6.2 Patch 10.

Own changes:

Editor:

• Added main menu commands for opening game's save folder and shared data folder.
• In New Game Wizard dialog added a checkbox "Remember this location" which lets save the last selected game location as a new default in editor's preferences.
• In General Settings added "Prioritize this turning direction" for Character behavior which tells which direction should characters take when turning by 180-degrees.
• In General Settings added "TextBoxes claim key and text input events" option that allows to pass all or certain key events to script while a TextBox control is active.
• Added Length and Format readonly properties for AudioClips, for information purposes.
• In Project Explorer added Copy/Paste context menu commands for: Characters, Cursors, Dialogs, GUIs, Inventory Items, Views.
• In Color Finder support 0xRRGGBB input color format.
• In Font pane added an option to display Font preview in right-to-left mode.
• In GUI Editor new Labels will be created non-Clickable by default. Historically engine would unconditionally disable all Labels on game startup, hence overriding project settings. Now this property is fully under user's control. (Older projects will have Labels disabled on import.)
• In Sprites Manager added "Assign sequential sprite numbers" context menu command, that lets apply new incremental IDs to a selected group of sprites.
• In Properties Grid added "Reset to Default" context menu command, which resets selected property's value to defaults.
• Translation compiler now supports "UniqueID" and "GameName" settings right in TRS file, used to match compiled translation with the game at runtime. Editor fills these settings when creating a new translation source.
• Improved error reporting for game text gathering actions such as "Create voice-acting script" and "Update translation". Now these errors correctly tell the script location which lets you go there.
• Fixed sprites loosing alpha channel when being copy/pasted in the Sprite Manager.

Script API:

• Added new game-wide option OPT_TURNORDERPRIORITY that defines which direction should characters take when turning by 180-degrees. This option uses TurnOrderPriority enum.
• Added new game-wide option OPT_TEXTBOXCLAIMSKEYS that defines what kind of key input events are claimed ("stolen") by the active TextBox control. This option uses TextBoxKeyClaimStyle enum.
• Added AudioClip.DefaultPriority, DefaultRepeat and DefaultVolume readonly properties.
• Added DrawingSurface.ColorDepth readonly property.
• Added DrawingSurface.GetPixelsCopy() and SetPixels() functions that allow to retrieve all or a portion of the drawing surface's pixels as a dynamic array, or assign its pixels from array.
• Added Game.Get/SetAudioTypeCrossfadeSpeed() functions.
• Added Game.GetAudioTypeVolume() function that returns a volume value previously set by Game.SetAudioTypeVolume().
• Added GUI.GetActiveTextInputControl() function that returns first found currently active TextBox control (or null if none is active).
• Added GUIControl.Translated property.
• Added System.LocaleName readonly property that tells which of the UTF8 locales is used for the game strings.
• Added GetPressedKeys() function that returns a dynamic array of pressed key codes.

Engine:

• Support loading and saving PNG image files (using DynamicSprite functions).
• Dont unconditionally disable all Labels (setting them non-clickable) on game start. Keep the property value from the editor instead.
• Only the first found active TextBox control will receive input events.
• Engine now supports Unicode control characters LRE (U+202A) and RLE (U+202B) when applying text direction (regardless of the global OPT_RIGHTTOLEFT option).
• Added "override_behavior" config section, its options are purposed to override game's backwards-compatible behavior and enforce new behavior when running old games. Currently supported options include: "smooth_walk" (allows smooth walk transitions), "gui_text_direction" (apply text direction to non-label gui controls), "dialog_opt_text_direction" (apply text direction to built-in dialog options).
• Fixed potential engine crash occuring if the game's spritefile contained less sprites than are defined by the game data, for any reason.
• Fixed DynamicSprite.CreateFromFile() failing to load indexed images with palette.
• Fixed Translation's font override defaulting auto outline thickness to 0 (must be 1).
• Fixed initial value of Character's AudioSpeed property.
• Fixed Character's AudioVolume property not working properly (regression since previous Beta).
• Fixed Dialogs ignoring explicit return TOPICNUMBER command (regression since previous Beta).
• Fixed dialog option numbering in RTL mode.
• Fixed scripts failing to link with the deprecated global Get*At functions.

Compatibility:

• Fixed a potential crash occuring in pre-3.6.3 games if they set Character.InventoryQuantity[] but did not call UpdateInventory().