/completion-plugin

Completion for Pure Data

Primary LanguageTclBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Completion Plugin

This Gui-Plugin enables auto-completion for pure-data objects.

  • This is a Tk/Tcl pluging that runs Pd-Vanilla or compatible forks like Pd-ceammc.

Here is a link to previous repositories: original repo by Yvan Volochine. up to 0.47.1 repo by Henri Augusto.

Current version: 0.48.0 (compatible to Pure Data 0.53)

Gif

PD AutoComplete Plugin gif

How to install:

After you install the plugin you must restart Pure Data.

Deken (preferred)

  • just search for the completion-plugin on 'deken' <3
    • In Pd Vanilla, go to Help->Find Externals and search for 'completion*'. Then click to install the latest version.

Manually

  • just download the plugin and put the whole folder anywhere and add it to your pd paths in file->Preferences->Path

How to use:

Just hit the Alt_L key while typing into an object to trigger completion mode.

Use up and down to move through the suggestions. Use shift+arrows for faster navigation.

Search modes

There are three search modes

  • normal: search for exact matches
  • skip: search for anything containing the input chars in order. Ex: plf matches zexy/[p]o[l]y[f]un
  • monolithic: search for objects contained in multi-object ("monolithic") distributions (.dll, pd_darwin, .pdlinux). Those are read from monolithicLibs.txt. The respective library must be loaded! See this link on that matter.

How to use each one:

  • Just type normally to use normal
  • Start your search with an "." to use skip
  • Start your search with an "," to use monolithic

Externals scanning

The plugin intelligently scans the paths set by the user (file->preferences->path) to scan for externals without the need for the user to type their name on a file. Consequently the script doesn't need a list of objects.

It searches the static default paths (ex: C:/PureData/pd-0.53-2.msw/pd/extra/) for libraries and then searches any path you've set in file->preferences->path or that Deken have set for you.

duplicates

Some objects by design might be scanned twice as this reflects Pure Data objection instantiation.

If you've ser for example the following folder in file->preferences->path

C:/Users/Stravinsky/Dropbox/pd-0.53-2.msw/pd/extra/iemguts/

You can use the canvasargs external in two ways (regardless of the autocomplete plugin):

[canvasargs] [iemguts/canvasargs]

The first use the path you've set. The second uses the standard path. So the autocomplete plugin will show two options for canvasargs. Notice that the first method doesn't avoid naming conflicts while the seconds does. For that reason the latter may be preferred.

Extra keywords

You can define useful stuff in any .txt inside the folder custom_completions. I've already added some useful keywords like "anything", "adddollar", etc and even some constants like Pi and the golden ratio.

Settings

  • now you can configure the plugin under preferences->PD AutoComplete Settings.

  • auto complete library names:

    • on: [list-abs/list-clip]
    • off: [list-clip]
    • When the "autocomplete libraries" option is enabled: you can use shift+enter to type obj with the library
    • When the "autocomplete libraries" option is disabled: you can use shift+enter to type only the object name (withouh the library)

  • Number of lines to display: number of completion suggestions the plugin will display

  • Font size: the size of the font used for the suggestions window

  • Maximum scan depth: how deep the plugin will look inside a search path.

    • Example: the iemguts libraries's folder contains a subfolder "example" with some explanatory patches that you might not want to scan.
    • So if you set a path to the iemguts folder and use a value of 1 for max scan depth it will only scan the stuff inside the iemguts/ folder. If you set 2 or more it will also scan iemguts/examples

  • bkg color options: change the background color for each search mode.

  • rescan: update the completions after you installed/uninstalled externals.

  • default: reset the plugin settings to the default

  • save to file: save your settings to the HD. The settings are saved in the completion.cfg config file.

    • Even if you change the pluging settings the new settings won't be remembered between pd sessions unless you save them to the file.

Settings are applied immediately after you change them but are only saved when you click "save to file". That means, unless you save them to the file, the next time you run PD the plugin will use the previous settings.

Development

Please fill in an issue on the github repository if you find a bug.

Development Guide

There's a development guide to make it easier to tackle on the code.

Change log

You can find it here.