The ringmenu. It is not like a normal menu, more like a ring-shaped menu. You can choose the point you like with the mouse/gamepad by clicking in a certain direction.

the menu consists of two parts,
1. the ringmenu itself
2. the entrys of the menu.

the ringmenu itself is the object that controls everything and gives commands. it is visualized by a grey 32x32 circle with a picture on it (optional).
the entrys are also grey 32x32 circles which are placed in a ring around the main object. they have a picture on them, a red number for hotkeys and white smaller numbers for the amount.

so how do you create and control a ringmenu? therefore we have different commands:

global func CreateRingMenu(id symbol, int x, int y, object commander) this creates a ringmenu at the position x/y with a symbol (optional)(backpack, clonk, hut etc) for the calling object, which has to be a crew member. the command object is the object, at which the ringmenu will send the information, what has been selected.

public func SetMenu(object menuobject, object commandobject) re-set the menuobject (crewmember) and the commandobject.
func SetMenuIcon(id symbol) re-set or erase the icon shown.

public func AddItem(id new_item, int amount, extra) on of the most important functions. as the name may hints at, it adds an entry for the menu. new_item is the picture shown, the amount is the number that is shown next to the picture and extra can be anything you like, a string, numbers, an array, which is saved in the entry but not shown.

public func Select(int angle, bool alt) you send this to the menu to tell it what angle you have selected. alt is a bool, set it true if you have selected something on a different way (rightclick etc).
the menu will now send Selected(object this,object entry, bool alt) to the commandobject. this is the menu itself, the entry is the menupoint which was selected, and bool is the same as in above. if that call returns true, the menu is closed automatically.

public func SelectHotkey(int key, bool alt) same as above, the hotkey is the number shown in red next to the entry. only accepts 0-9.

public func Show() makes the menu visible/updates it.
public func Hide() makes the menu invisible, but does not remove it. can be shown again with Show().
public func Close() closes the menu, removing all entrys and the menuobject itself.
public func IsVisible() returns true if the menu is visible.

thats it. now to the entrys.

public func SetSymbol(id symbol) sets a new picture for the entry.
public func SetHotkey(int hotkey) sets a new hotkey fot the entry. only 0-9
public func SetAmount(int amount) sets a new amount for the entry.
public func SetExtraData(any extra) sets a new extradata for the entry.

GetSymbol() GetHotkey() GetAmount() GetExtraData() you know what they do

thats all with them.

heres an example of how the script could look like:

      menuitem=clonk->CreateRingMenu(Clonk,0,0,this);
      menuitem->AddItem(Bow);
      menuitem->AddItem(Arrow);
      menuitem->AddItem(Musket);
      menuitem->AddItem(LeadShot);

this creates a menu with a bow, arrows, musket and bullets, the menu itself looks like a clonk.
public func Selected(object menu, object selector, bool alt)
{
  for(var i=0; i<(selector->GetAmount()); i++)
  {
  var newobj=CreateObject(selector->GetSymbol());
  newobj->Enter(Contents());
  }
  selector->RemoveObject();
  menu->Show();
  if(choses==2) return 1;
  return 0;
}

this gives the contents of the command object, at which Selected was sent, items. after the selection, that menupoint is removed.

additional information: ill add the menu tomorrow, when i have debugged everything and cleaned up. also, the menu is getting really small with 30+ entrys

ringemenu looks like this: