History / Gui Editor Guide

docs: retire what 4.0 replaced, and move governance to the repo Contributing had routed every contributor through an Open Source Software Agreement on garagegames.com, which no longer exists -- so there was no working description anywhere of how to contribute. Following Torque3D's lead, the process now lives beside the code in CONTRIBUTING.md and this page is the welcoming introduction that points at it. Pull-Requests-Coding-Standards carried the same dead instruction and lost it too. What replaces the agreement is the rule Torque3D uses: your contribution must be legally yours to give, and compatible with the MIT license. Steering-Committee-Charter is deleted. It described a six-member body with a chair, monthly meetings and quorum rules, and required a GarageGames representative to chair it and approve any transfer of the project. Torque3D never amended its copy either -- it left it behind and governs through CONTRIBUTING.md and a code of conduct. If the team grows it will likely organize into functional roles as Torque3D has, rather than reinstate this. Changelog is deleted; it stopped in 2013 while claiming to be updated on every push, and now lives in the engine repo where an entry can be written in the same pull request as the change. Retired to stubs, each naming what replaced it rather than 404ing: Video Tutorials, made for 1.x/3.x and predating all three editors; Intro to the GUI Parts 1 and 2, written for 2.0 against a Torque2D-2.0\modules\ layout -- between them the last six photobucket images on the wiki. GUI-Guide and Gui-Editor-Guide cover that ground now, which was not true when the legacy banner was written. Torquescript-overview called TorqueScript "a proprietary scripting language", which is wrong for an MIT engine, and recommended buying Torsion plus two editors last updated for Mac OS X Leopard. Now VS Code and the two real TorqueScript extensions, including the gotcha that they override C# highlighting because .cs is shared. Torsion is gone as a recommendation from three other pages, along with Scripting-Tutorial's walkthrough of its UI. Directory-structure had two rows that were simply false -- engine/compilers/ holds only android-studio now, and space/ and test/ do not exist. Replaced with real rows for PlanetX/, tests/ and images/. Home.md: the version banner said "between 3.5 and 4.0" on the eve of Early Access 4, seven orphaned pages are linked, and the retired tutorials are out. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014Xh3XULt9PtdCtsaYHGnYE

greenfire27 committed Aug 18, 2026

Gui docs: split the editor out, and fix the sizing names The GUI Guide now says who it is for. It is the reference for building a screen by hand in script, and it says so at the top, with a short pitch for the editor and a link for people who would rather drag controls around. Themes get a paragraph in the same place: what they are, that a hand-coder does not need one, and how to pull a profile out of one if they want it. Everything else about themes moved to the new page. The sizing options are the important correction. HorizSizing and VertSizing were named for the wrong edge -- "right" pinned the LEFT one -- and 4.0 EA3 renamed them anchorLeft/anchorRight/anchorTop/anchorBottom and scale. The section is rewritten around the new names, in a table, with the everyday choice called out. The old names follow it rather than leading, since they still load and nobody has to change anything they have already written; what they DO need to know is that files are now saved with the new spelling and an older engine cannot read them. Then the control changes, all of them aimed at someone writing script: - List box and drop down save their rows now, so the TAML shape is written out and the "build it in onWake" advice is no longer the only way. getItemList/setItemList too. - GuiControl grows a Methods list it never had. applySizing is the answer to "I set fill in script and nothing happened", which is worth a page on its own; childrenReordered, pullIntoView, rendersChildren, canBeChildOf. - Tree view had no Settings section at all: IndentSize, IconImage, IconSize, plus onGetItemIcon, refreshItem, getItemIcon. - Tab book gains addPage, and a note that an empty book used to render as nothing whatsoever. - Frame set gains getFrameLayout/setFrameLayout and why you would want them (a frame dies with the control in it). - Button no longer seeds "Button" as a caption, which is why a blank one would not stay blank -- and why check boxes said "Button" too. - Scroll control leaves room for its own bar, so a child that sizes across is no longer drawn under it. The Gui Editor Guide is new: opening it, what each panel is for, placing and arranging controls, the Explorer's eye and padlock columns, why the properties pane hides fields, the menus and their shortcuts, which save format loses what, and the Profile Editor's profiles, borders and cursors. Written for someone who has not built a GUI before. Home.md had no GUI entry in its reference list at all. Both pages are in it now. And Intro to the GUI Part 1 still recommended GuiImageButtonCtrl, which 4.0 EA3 deletes -- a profile's imageAsset was already indexed by control state, so a plain button does it -- so that carries a correction note. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JDKWjuEF5Nuw791mpU7aPF

greenfire27 committed Aug 8, 2026