Some plugins may need to create menu items. This should not be done in the central menu file, because the plugin may be disabled leaving defunct menu items in the menu system. Instead, each such plugin shall inject a menu patch file on load and remove the menu patch on plugin unload.
The menu file is normally not a menu patch file but a plain menu file since it only needs to extend the existing menu system and this is the easiest way to do so. It's recommended to insert menus under anchors because this method provides better stability over menu file changes.
The menu file is typically called: pluginname-menu.lht
The menu file must be registered in the tmpasm file. Add these lines in Plug.tmpasm to set the file name:
put /local/rnd/mod/MENUFILE {pluginname-menu.lht}
put /local/rnd/mod/MENUVAR {pluginname_menu}
Menu patch requires the following lines around the top of the plugin code:
#include <librnd/core/hid_menu.h> #include "menu_internal.c"
The menu file is translated to a variable named in MENUVAR above, typically pluginname_menu - this is the "internal" version embedded in the executable, fallback in case the menu file is not found.
Copy these lines in the plugin init callback:
rnd_hid_menu_load(rnd_gui, NULL, pluginname_cookie, 175, NULL, 0, pluginname_menu, "plugin: pluginname");
Replace 175 with the patch priority - in the most common setup this controls the order of newly created menu items under the same anchor.
On uninit the menu patch needs to be unloaded:
rnd_hid_menu_unload(rnd_gui, pluginname_cookie);
After committing all these, you will need to run make dep in src/. Before committing that, double check svn diff: it must not have any unrelated change, only files related to your plugin.