Processing for Visual Studio Code
What this extension is
This is a Visual Studio Code extension created by Tobiah Zarlez to add Processing language support.
What this extension isn't
This extension does not allow you to debug Java or Processing projects.
Can you add a feature I want?
Possibly! Let us know, we'd love to hear your suggestions.
Installation Instructions
- Open Visual Studio Code
- Open the Command Pallet (
CTRL+SHIFT+Pfor Windows/Linux orCMD+SHIFT+Pon Mac) enter the command “Install Extension” - Search for “Processing Language” and click on this extension.
- Restart Visual Studio Code
Feature list
Syntax highlighting
Open any .pde file, or choose "Processing" from the drop down menu in the bottom right corner.
Snippets
Once the language has been set, you will see code snippets pop up automatically as you type!
Commands
Installing this extension will add the following commands to your command pallette (CTRL+SHIFT+P, or opened by View -> Command Pallette). These commands can be selected and run from there, to complete the corresponding tasks.
Command: Create Task File
Adds a .vscode/tasks.json file to your project folder, that has the contents of the ProcessingTasks.json located in the root folder of this project.
When you run this task (Keyboard shortcut: Ctrl+Shift+B), it will compile and run your project!
If you would like to see output from the compiler, comment out the line "showOutput": "never",
NOTE: Processing must be added to your path, or you must set the "processing.path" setting!
Follow these instructions to add Processing to your path, or these alternate instructions instead to modify the path setting.
See "Requirements" for full details.
Command: Run Processing Project
This is a shortcut for running the .vscode/tasks.json file. Same as pressing Ctrl+Shift+B
Note: Must have ran the "Create Processing Task File" command first, see above!
Command: Open Extension Documentation
Opens this documentation.
By default uses processing.org's documentation. Can change to p5js's if preferred using the processing.docs setting.
Command: Open Documentation for Selection
Use the pallet command "Processing: Open Documentation for Selection" to open the processing documentation for the current selection.
By default uses processing.org's documentation. Can change to p5js's if preferred using the processing.docs setting.
Command: Search Processing Website
Use the pallet command "Processing: Search Processing Website" to quickly search whatever you want on the processing website.
By default uses processing.org's documentation. Can change to p5js's if preferred using the processing.docs setting.
By default uses Google for search. Can change to DuckDuckGo if preferred using the processing.search setting.
Requirements
Installing the extension will give you instant access to syntax highlighting and snippets.
However, in order to compile and run your processing project from Visual Studio Code, you will need to do three things:
- Set up your
.vscode/tasks.jsonfile. (See: "Command: Create Task File") - Add Processing to your path OR Modify your
.vscode/tasks.jsonfile. (See: "Add Processing to path" or "alternate method") - Have a
<File>.pdewhose filename matches the name of the project's folder (General Processing Requirement). Your file cannot contain any spaces or it will not run correctly.
Add Processing to path
In order to automatically compile and open from Visual Studio Code, I recommend adding Processing to your path.
What does that mean?
That means you should be able to type the processing from anywhere on your machine, and it will open Processing.
How do I do that?
It's easier than you might think!
Windows
- Open the "Advanced System Settings" by running sysdm.cpl
- In the "System Properties" window, click on the Advanced tab.
- In the "Advanced" section, click the Environment Variables button.
- Edit the "Path" variable. Append the processing path (Example:
;C:\Program Files\Processing-3.0.1\) to the variable value. Each entry is separated with a semicolon.
Mac
Open Processing, and click the Tools -> Install "processing-java" menu item.
Note: You will have to install processing-java for all users for this to work
Linux
Set your PATH to where your processing application is located.
Example: export PATH=$PATH:/opt/processing/processing-2.0b4
You also need to create an alias for processing-java in /bin/ instead of /usr/bin/.
Example: sudo ln -s /opt/processing/processing-java /bin/processing-java
Then what?
Once you've installed Processing to your path, you need to add the appropriate .vscode/tasks.json file to every Processing project.
See the command "Create Task File"
Alternate Method
What if you cannot, or do not want to add Processing to your path?
You can modify the processing.path setting to follow the path to wherever processing is installed on your machine. Be sure to remember to keep the processing-java at the end of the path!
To change settings in VSCode, here is a link to the official documentation.
(Remember, for Windows be sure to turn any "\" into "\\"!)
Example:
"processing.path": "C:\\Program Files\\processing-3.0.1\\processing-java",NOTE: This is untested on Mac and Linux
If needed: Overwrite default terminal
You may need to also overwrite your default terminal in order to get your task file to run correctly.
Following the instructions on the official VSCode documentation, all you have to do is add a few extra lines to your task file once you generate it.
For example, if you are running Windows and want the task file to use Command Prompt ('cmd.exe') you can add an 'options' parameter under the 'windows' portion:
"windows": {
"options": {
"shell": {
"executable": "cmd.exe",
"args": [
"/d", "/c"
]
}
},
"args": [
"--force",
{
"value": "--sketch=${workspaceRoot}",
"quoting": "strong"
},
{
"value": "--output=${workspaceRoot}\\out",
"quoting": "strong"
},
"--run"
]
}To Do List
- Take nice looking (Animated?) screen shots for README/Instructions
Credits
Syntax highlighting and snippets code based on the Processing Sublime Text plugin.
Other resources
Here are some other resources I recommend: