[Include] 3DMenu

[SDraw]

3DMenu

This include allows you to create new type of menu instead of standart menus or dialogs.

• Creating of menu for each player.
• Custom rotaion for menu.
• Setting params for every box like for object.
• Auto-calculatting of new lines and box position.
• Limits: MAX_PLAYERS menus and manual limited boxes (default is 16).

What you can do with this include

This include was made for selecting skins/vehicles. You can use it in anything else.

YouTube

YouTube

Changelog

- Added "playerid" and "rotation" params in Create3DMenu().
- Box limit is increased to 16.
- IDs of created boxes was changed. Now ID increases from up to down. Added OnPlayerChange3DMenuBox(playerid,MenuID,boxid) callback. Added FS to demonstrate functional.
- Removed param MenuID from CancelSelect3DMenu. Increased limit of menu - 1024.
- Updated fake natives. Forgot to remove MenuID from CancelSelect3DMenu.
- Now boxes move slowly! ^_^
- 2 different background colors for boxes (when selected and unselected)
- Some change in algorithm.
- Manual changed value of maximum boxes.
- Removed y_hook (due recursion in stack size and run-time error), fixed bug when player disconnected but he was selecting menu.

Requirements

- 0.3e or upper server
- Incognito's Streamer (0.3e and upper)

Functions

• Create3DMenu(Float: x,Float:y,Float:z,Float:rotation,boxes,playerid);
  • Creating 3DMenu in position with number of boxes for player.
    Note #1: Rotation should be equal from 0 to 360. Bigger or lower values will make menu works wrong.
    Note #2: This function returns ID of created menu.
    Note #3: Only for connected players.

• SetBoxText(MenuID,box,text[],materialsize,fontface[],fontsize,bold,fontcolor,selectcolor,unselectcolor ,textalignment);
  • Set box text, like object material text.
    Note #1: This function looks like SetObjectMaterialText.
    Note #2: If you set wrong box ID or menu ID, function will return -1.
    Note #3: selectcolour - background of box when it is choosen. unselectcolor - if not.[/I][/B].

• Select3DMenu(playerid,MenuID);
  • Start player select menu. Keys - box change: Y,N ; select - Space.
    Note #1: This function will return -1 if you set invalid menu ID.

• CancelSelect3DMenu(playerid);
  • Cancel player's selecting of menu.
    Note #1: This function will return -1 if player isn't choosing any menu.

• Destroy3DMenu(MenuID);
  • Destroying of menu.
    Note #1: If any player chooses menu with current ID, function CancelSelect3DMenu will be called automatically.
    Note #2: This function will return -1 if menu doesn't exist.

Callbacks

• OnPlayerChange3DMenuBox(playerid,MenuID,boxid);
  • This callback is called when player presses Y or N on selecting.
    Note #1: Param boxid is equal ID of new choosen box.

• OnPlayerSelect3DMenuBox(playerid,MenuID,boxid);
  • This callback is called when player presses Space on selecting.
    Note #1: Param boxid is equal ID of selected box.

Author
SDraw

Download
GitHub: 3DMenu.

Thanks to

- TheArcher for fake natives and check for defined FILTERSCRIPT.
- iPleomax for video with idea.
- Incognito for Streamer (and thread style ).

[HeLiOn_PrImE]

That is really nice....

[TheDominator]

Woah looks very nice, but you could try to improve the image.

[TzAkS.]

Its look great

[(SC)=Sky=]

Coool good job!

[Mr.Fames]

It looks great man really wonderful job.

[Ballu Miaa]

Nice work. Will surely use it or will make similar to this. Thanks. Rep +5 Added

[TheArcher]

Pretty cool. But this was iPleomax's idea. , good job though and thanks for share

Edit:

You could do

#if defined FILTERSCRIPT
hook OnFilterScriptInit()
{
	for(new i = 0; i < MAX_PLAYERS; i++)
	{
 		SelectedMenu[i] = -1;
		SelectedBox[i] = -1;
	}
	for(new i = 0; i < MAX_MENUS; i++)
	{
	    for(new b = 0; b < 4; b++) MenuObjects[i][b] = INVALID_OBJECT_ID;
	    MenuIsExist[i] = false;
	    MenuBoxes[i] = 0;
	}
}
hook OnFilterScriptExit()
{
	for(new i = 0; i < MAX_MENUS; i++)
	{
		if(MenuIsExist[i]) Destroy3DMenu(i);
	}
}
#else
hook OnGameModeInit()
{
	for(new i = 0; i < MAX_MENUS; i++)
	{
	    for(new b = 0; b < 4; b++) MenuObjects[i][b] = INVALID_OBJECT_ID;
	    MenuBoxes[i] = 0;
	    MenuIsExist[i] = false;
	}
}
hook OnGameModeExit()
{
	for(new i = 0; i < MAX_MENUS; i++)
	{
		if(MenuIsExist[i]) Destroy3DMenu(i);
	}
}
#endif

A better method to check before hooking.

[SDraw]

Yes, I saw the video of iPleomax...But it's not my fault that I released it early...

[Cacoby]

Please, make a example code, like this image, sorry for my bad english :S