From e645f03803a1940fca705ba9dcb0adcd915553dc Mon Sep 17 00:00:00 2001 From: Stef Tervelde Date: Thu, 11 Sep 2025 16:43:30 +0200 Subject: [PATCH] Created VSCode Extension (markdown) --- VSCode-Extension.md | 64 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 VSCode-Extension.md diff --git a/VSCode-Extension.md b/VSCode-Extension.md new file mode 100644 index 0000000..ad7cad6 --- /dev/null +++ b/VSCode-Extension.md @@ -0,0 +1,64 @@ + +Create and run Processing sketches in Visual Studio Code. + +![Processing VS Code Extension Screenshot]( +https://github.com/processing/processing-vscode-extension/blob/main/.github/media/screenshot.png) + +This extension adds support for Processing sketches in VSCode. Includes familiar run and stop buttons, syntax highlighting, code suggestions, and easy access to your sketchbook and examples. If you prefer coding in VS Code, this extension makes it easier to work with Processing. + +## Requirements + +You will need **Processing 4.4.6 or later** installed on your computer ([Download Processing](https://processing.org)). + +**IMPORTANT:** Run Processing at least once after installing it. This creates the files the extension needs. + +## Features + +* Run and stop sketches directly in VS Code +* Browse your sketchbook and open example sketches +* Syntax highlighting for Processing code +* Code suggestions and error checking with the Processing Language Server +* Automatic detection of your Processing installation (no manual configuration required) + +## Install + +Install the extension from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/) or search for "Processing" in the [Extension Marketplace](https://code.visualstudio.com/docs/configure/extensions/extension-marketplace) within VS Code. + +## Getting Started + +1. Install the Processing extension for VS Code. +2. Click the Processing icon in the Activity Bar on the side of the VS Code window. +3. Open a sketch from your sketchbook or from the examples. +4. Click the Run button to start your sketch. + +When you run a sketch, a terminal will open at the bottom of VS Code to show the build output, and the Processing sketch window will appear. + +## Settings + +You can customize the extension in VS Code settings + +1. Open Settings via `Ctrl + ,` on Windows/Linux or `Cmd + ,` on macOS. +2. Search for "Processing" to find all available settings. +3. Modify the settings as needed: + - `processing.autosave`: Automatically saves your sketch before running it. Default: `true`. + - `processing.newWindow`: Opens sketches in a new VS Code window. If disabled, sketches open in the current window. Default: `true`. + - `processing.version`: Choose which installed Processing version to use. Default is `latest`, but you can specify a version (e.g., `4.4.6`). + +## Troubleshooting + +If something doesn’t work: + +* Close any running Processing sketches or editor windows +* Remove any other Processing extensions that might conflict with this one +* Close VSCode +* Check you have installed Processing 4.4.6 +* Run the Processing editor once +* Restart VSCode + +## Compatibility + +The extension has been tested on: + +* macOS (Apple Silicon) +* Windows 64-bit +* Linux 64-bit \ No newline at end of file