Vector Menu lets you select items through directional mouse movements. You can choose visible items, then use familiar gesture paths without waiting for the menu to appear.
Basic customization—assigning commands, properties, and other menus to slots—follows much the same process as Pie Menu Editor. Its eight directions and extra top and bottom slots combine with Vector Menu’s own directional gestures and hierarchy navigation.
Feature in development
Vector Menu uses GPULayout, PME’s system for drawing Blender UI layouts on the GPU. Floating Panel uses the same system.
Vector Menu and GPULayout are in development. Supported widgets, layout APIs, and menu combinations are not identical to Blender’s native UI or Pie Menu. See the configuration guide below for current support.
Added in version 2.1: Added Vector Menu, including navigation into child Vector Menus and back to a parent.
Configuration guide — directional gestures and settings panels (for AI)
Name: Vector Menu / Type ID: VMENU. Fixed at ten slots: eight directions plus top and bottom extras. The arrangement resembles Pie Menu, but gesture behavior and supported targets differ.
Main Menu targets: Vector Menu, Floating Panel, Macro Operator, and Property Stack. PME Property references have requirements, such as a resolvable static single-select Enum; do not assume arbitrary Properties work in the same way.
Combinations: link child Vector Menus to build a hierarchy; expand Floating Panels for settings widgets. Do not use the ordinary Menu tab to make a Pie Menu a child.
Directional and extra slots: top and bottom extras are for interacting with visible UI, distinct from directional hierarchy navigation.
Input: Custom’s L provides the supported layout APIs. Do not assume full feature parity with Blender’s UILayout.
See slots for placement and usage for nesting. Do not suggest Pie Menu’s Confirm Threshold as a Vector Menu setting.
Select a Vector Menu in the list and assign its eight directions and extra slots. Distinguish slots used for hierarchy navigation from those containing UI for directly editing numbers, colors, or other values.
These are the shared controls for enabled state, selected menu, name, tags, and advanced settings. Vector Menu has no preview button in its editing area; invoke it through its actual Keymap to check it. See selected menu settings.
Choose the editor’s Keymap and trigger key. See the shared Hotkey settings for entering keys and modifiers.
Standard Open Modes are Press / Hold / Double Click / Tweak / Key Chords. Interaction takes place while the trigger key is held, so Click, which cannot provide its release, is not offered. Tweak uses PME’s drag detection; Click Drag (Experimental) uses Blender’s native drag event.
The first eight rows are directional slots; the two separated rows below are the top and bottom extras. From left to right are edit, icon, display name, linked-menu navigation, and slot operations. See the shared slot list.
Placement
Main uses
Eight directions
Run an action, enter a child Vector Menu, or place settings
Top and bottom extras
Interact with visible UI such as colors, numbers, and settings panels
Wrap several UI elements in one column or box when placing them in a single Custom slot. See Code Input and Execution for code constraints.
When a menu uses only one directional slot, its Custom body can place items around the menu in the same directions as a Pie Menu. Draw the items into L.menu_pie(), or draw a registered pie menu with L.menu_contents(). The items start at the slot’s own direction and follow Pie Menu order (W, E, S, N, NW, NE, SW, SE), wrapping after eight. The same line in the same slot of a Pie Menu gives the same directions.
# Tools, Sidebar, and Header toggles of the 3D Viewport around the menuL.menu_contents("WM_MT_region_toggle_pie")
Items drawn directly into L stay stacked in the slot, as before. The items also stay stacked, with a short red line in the slot that names the reason, when another directional slot or a top or bottom extra is used, when there are more than eight items, or when a panel is included.
Link child Vector Menus from a parent’s directional slots, grouping related actions in each child. Check the visible hierarchy, including returning to the parent, before trying gesture-only selection.
To adjust detailed settings in place, reference a Floating Panel from the Menu tab. It is placed with Expand Panel; width and position are configured on the destination slot. See Floating Panel Editor.
Open PME Preferences → Settings → Vector Menu and set Display Scale. This setting applies to all Vector Menus and takes effect the next time a menu opens. 1.00 is 100%; 1.50 is 150%.
Text, icons, spacing, outlines, and child menus scale together. Specify Width and position offsets as dimensions at 100%: for example, Width 320 becomes 480 at 150% display scale.
In the intended editor and mode, check normal selection, entering a child, returning to the parent, confirming, and canceling. When adding Property, color, or number controls, also check that using them does not interfere with gestures.