by date
Plans and goals for TGB
Plans and goals for TGB
| Name: | Arthur Ogawa | |
|---|---|---|
| Date Posted: | Feb 18, 2007 | |
| Rating: |  5.0 out of 5 | |
| Public: | YES | |
| Comments: | YES | |
| RSS Feed: |  or Subscribe with  . | |
| Profile Page: | View profile page for Arthur Ogawa |
Blog post
My goal for my work with TGB is to help make it the best game development environment for the Three Worlds.
My plan is to work on documentation, sample applications, and other types of learning tools. The more people using TGB with ease and competence, the better it is for all of us.
I have undertaken to create on TDN a complete TGB class reference, including not only member fields, methods, and callbacks, but also sample code illustrating each one in a non-trivial way. I intend to also take a systematic look at the console functions (there are 400, arranged in 42 groups).
I have made a small start by working on the TGB Reference, the TGB GUI Overview, and several classes, including SimObject, SimSet, SimGroup, GuiControl, and GuiControlProfile.
I have also submitted a resource, the Gui Learning Project, which is my first attempt at supplying sample code. Keep your eyes on that resource; as I develop it further, it will treat more Gui elements.
I have in the works rough outlines of documentation for over 160 classes exposed in TorqueScript, from ActionMap to UnknownChunk. In each case, the member fields and methods have been taken from automated sources like dumpConsoleClasses(), but I have had to sleuth out the callbacks by looking at the C++ source directly. At least it's no longer a guessing game!
In this work, I have had the kind support of GarageGames, and, in particular, Matthew Langley. Aramanthia gave the TGB Gui Overview its start. In gathering example code, I have made extensive use of code put up by users and comments on the GG Forums. In future, I hope to interest people in joining me in this effort. Please hop in, the Wiki is always open!
My plan is to work on documentation, sample applications, and other types of learning tools. The more people using TGB with ease and competence, the better it is for all of us.
I have undertaken to create on TDN a complete TGB class reference, including not only member fields, methods, and callbacks, but also sample code illustrating each one in a non-trivial way. I intend to also take a systematic look at the console functions (there are 400, arranged in 42 groups).
I have made a small start by working on the TGB Reference, the TGB GUI Overview, and several classes, including SimObject, SimSet, SimGroup, GuiControl, and GuiControlProfile.
I have also submitted a resource, the Gui Learning Project, which is my first attempt at supplying sample code. Keep your eyes on that resource; as I develop it further, it will treat more Gui elements.
I have in the works rough outlines of documentation for over 160 classes exposed in TorqueScript, from ActionMap to UnknownChunk. In each case, the member fields and methods have been taken from automated sources like dumpConsoleClasses(), but I have had to sleuth out the callbacks by looking at the C++ source directly. At least it's no longer a guessing game!
In this work, I have had the kind support of GarageGames, and, in particular, Matthew Langley. Aramanthia gave the TGB Gui Overview its start. In gathering example code, I have made extensive use of code put up by users and comments on the GG Forums. In future, I hope to interest people in joining me in this effort. Please hop in, the Wiki is always open!
Submit your own resources!| Tom Eastman (Eastbeast314) (Feb 18, 2007 at 16:28 GMT) |
Make sure to occasionally blog about your progress so that I'll remember and go add some stuff. It would be really neat if every week you posted and said let's tackle these three links and then everyone could go in and merge their knowledge on a few methods or whatever.
Good luck :)
| Tank Dork (Feb 18, 2007 at 17:36 GMT) Resource Rating: 5 |
| Joe Rossi (Feb 19, 2007 at 02:36 GMT) |
| Mads Laumann (Feb 19, 2007 at 14:56 GMT) Resource Rating: 5 |
This is exactly what i have been looking for!
Great work, looking forward for future updates :)
| Justin DuJardin (Feb 19, 2007 at 17:10 GMT) Resource Rating: 5 |
This is one of the coolest initiatives i've seen a community member undertake in quite some time, shoot me an email sometime!
Cheers,
-Justin
| Arthur Ogawa (Feb 19, 2007 at 17:15 GMT) |
Quote:
I have made a small start by working on the TGB Reference, the TGB GUI Overview
If you have not looked at these Wiki pages since Friday, I suggest you look now. I have updated the Class Hierarchy in the two documents so that they are complete (with 12 pesky exceptions) as of 1.1.3. There are 170 classes in TGB 1.1.3!
I have updated the documentation for SimObject, SimSet, SimGroup, and GuiControl to include Callbacks and Usage notes. I revised the Glossary so that it has a complete list of the enumerated types of TGB.
Callbacks are not consistently part of the output from dumpConsoleClasses(), unfortunately (although some mysteriously appear anyway). I did a full source search for them and placed the updates in my local documentation tree. I am adding documentation of callbacks to a class's documentation as I revise it.
The goal of Usage notes is to exhibit each of the class member fields and methods in a context that makes the intended use of the class clear. The above Wiki pages now contain that information.
I have also taken a look at the TorqueScript Quick Reference (there are three web pages involved). I have added hyperlinks and made some emendments and edits. I have also added some code examples, so that it is more clear how things work. The third page documents the function calls in the engine that expose or implement TorqueScript features. One was missing: Con::executef(), which is how callbacks come about. It is now added to the list.
Does anybody know the history of these pages? Am I right that they are taken from Edward Maurina's book?
Edited on Feb 23, 2007 08:13 GMT
| Arthur Ogawa (Feb 27, 2007 at 04:54 GMT) |
GuiCanvas,
and for all of the button-like controls, namely:
GuiCheckBoxCtrl,
GuiBorderButtonCtrl,
GuiToolboxButtonCtrl,
guiT2DObjectCtrl,
GuiIconButtonCtrl,
GuiBitmapButtonTextCtrl,
GuiBitmapButtonCtrl,
GuiButtonBaseCtrl,
GuiBitmapBorderCtrl,
and
GuiRadioCtrl
I think in future, I will add reference pages for the classes as they come up in questions in the Forums. If you like what your are seeing, post a comment here, and I will write up the class documentation for your nominated class.
Also, please do not hesitate to contact me about any errors or shortcomings you see. And do feel free to get into the wiki and contribute your own comments and examples.
Edited on Feb 28, 2007 19:13 GMT
| Arthur Ogawa (Mar 01, 2007 at 16:56 GMT) |
But in any case, TGB users need a guide to console functions, and right not there is none as such. This needs looking in to. Of course.
Edited on Mar 01, 2007 16:57 GMT
| Joseph Euan (Mar 04, 2007 at 21:10 GMT) |
@Arthur - nice work on the TGB docs... I really need to get around to using TGB, people seem to doing some pretty sweet stuff with it. :)
| Simon Jensen (Mar 05, 2007 at 19:24 GMT) |
| Jackson Hyde (Mar 17, 2007 at 01:01 GMT) |
| Arthur Ogawa (Mar 17, 2007 at 03:15 GMT) |
My most recent item is a compendium of all of the console functions of TGE and TGB, including links to the TDN docs for each function. I am trying to understand better how the docs for the console functions need to be organized. Any help with this would be appreciated.
You must be a member and be logged in to either append comments or rate this resource.
