# pcb-rnd - plugin development - per plugin menus

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

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

## tmpasm

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}

## Create the menu variable

Menu patch requires the following lines around the top of the plugin code:

    #include <librnd/hid/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.

## plugin init

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.

## plugin uninit

On uninit the menu patch needs to be unloaded:

    	rnd_hid_menu_unload(rnd_gui, pluginname_cookie);

## make dep

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.