TGB 1.7 Gui Tutorial

#1 Hopefully someone gives you a good pointer to the GUI tutorial. Personally, i don't know of one. And the old one was always way, way, way underdocumented and pretty confusing. It took me forever to figure out how to use a drop down box

There used to be a tutorial on a pirate-map looking main menu. Here's a snippet of how i'm doing it in my current game:

game.cs

function startGame(%level)
{
	//--- Weird screen res for iPhone compatibility
	setScreenMode( 960, 640, 32 , false );

	//--- Sound only seems to come from channel 0
	//--- TGB *ALWAYS* defaults to 0.8, even when you change it in the IDE
	//--- And it's not 20% quieter, it's 1/2 volume (and 0.5 is basically off)
	alxSetChannelVolume(0, 1);

	// TODO: read this from a config file
	$runWithSplashScreens = false;
	$runWithMenus = true;

	if ($runWithSplashScreens)
	{
		// i'm not going to show you the code for this right now
		// since you want to just see a main menu
		$gameFlowManager = getGameFlowManager();
		$gameFlowManager.begin();
	}
	else if ($runWithMenus)
	{
		showMainMenu();
	}
	else
	{
		startPlaying();
	}
}

function startPlaying()
{
	initializeGame();  // game specific stuff
	safeLoadLevel("mapLevel");  // a function i wrote
}

gameFlowManager.cs

function showMainMenu()
{
	// this is the magic function you want
	Canvas.setContent(MainMenu);
	
	alxStopAll();
	if ($musicIsEnabled)
		$backgroundMusic = alxPlay(mainMenuMusic);
}

MainMenu is a GUI with a 800x600 image in the background (or somesuch; they all resize to your game). It has a panel and on the panel are buttons (assigning a button a panel used to require a magic password no one knew, specifically right clicking on it until it highlights, signifying that it was the container; this is why documentation is so important, no one was going to guess that). The buttons all have a name (if you assign one) and an automatic onClick event

mainMenu.cs

function MainMenu::exit(%this)
{
	quit();
}

function MainMenu::loadGame(%this)
{
   MessageBoxOK("You pressed load!", "Sorry, i haven't written Load yet");
}

function MainMenu::newGame(%this)
{
	//--- Stop playing the main menu background music
	alxStopAll();
	
	startPlaying();
}

function MainMenu::showAchievements(%this)
{
	safeLoadLevel("achievementsLevel");
}

function MainMenu::showCredits(%this)
{
	Canvas.pushDialog("creditsGUI");
}

function MainMenu::showHelp(%this)
{
	Canvas.pushDialog("helpGUI");
}

#2 This helped A LOT.

I'm still a bit foggy on the GUI builder thing, but with your code snippets it's definitely helped figure out the bulk part of it.

Anybody else with an actual tutorial is always welcome to contribute though. Every little bit helps. :)

#3 Stashing this for the future too :) Thanks BW!