Skip to content

Commit df99446

Browse files
authored
Added feature description, use cases, and safety warning
1 parent 81d5127 commit df99446

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

SCHEMA.md

+10-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,14 @@
11
# Processing URI Schema Definition
22

3+
The Processing URI schema defines a custom protocol for launching and interacting with the Processing Development Environment (PDE) via specially formatted `pde://` links. These links can be used to open sketches, create new ones, load hosted or base64-encoded files, and set preferences, all through a simple URI-based interface.
4+
5+
This feature is primarily intended for integration with web platforms, tutorials, documentation, or third-party tools that want to streamline the experience of launching sketches in Processing from a web page.
6+
7+
Because these links can be generated dynamically, they support a range of interactive use cases. For example, an online editor could generate a unique link for each sketch, or a forum could create links based on user-submitted code snippets.
8+
9+
>[!WARNING]
10+
> Be cautious when opening `pde://` links from unknown sources. Always review the contents of a sketch before running it, especially if it was shared by someone you don’t know. To protect your system, Processing runs downloaded sketches in a temporary folder, but you should still treat untrusted code with care.
11+
312
## Local File Schema
413
```
514
pde:///path/to/sketch.pde
@@ -60,4 +69,4 @@ Sets and saves multiple preferences in a single operation.
6069
- URL-based operations automatically prepend https:// if no scheme is provided
6170
- All URLs and query parameters are decoded using UTF-8
6271
- File downloads occur asynchronously in a separate thread
63-
- Base64 and remote sketches are saved to temporary folders
72+
- Base64 and remote sketches are saved to temporary folders

0 commit comments

Comments
 (0)