mirror of
https://github.com/processing/processing4.git
synced 2026-01-22 07:51:08 +01:00
Added feature description, use cases, and safety warning
This commit is contained in:
committed by
GitHub
parent
81d5127503
commit
df994466dc
11
SCHEMA.md
11
SCHEMA.md
@@ -1,5 +1,14 @@
|
||||
# Processing URI Schema Definition
|
||||
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
>[!WARNING]
|
||||
> 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.
|
||||
|
||||
## Local File Schema
|
||||
```
|
||||
pde:///path/to/sketch.pde
|
||||
@@ -60,4 +69,4 @@ Sets and saves multiple preferences in a single operation.
|
||||
- URL-based operations automatically prepend https:// if no scheme is provided
|
||||
- All URLs and query parameters are decoded using UTF-8
|
||||
- File downloads occur asynchronously in a separate thread
|
||||
- Base64 and remote sketches are saved to temporary folders
|
||||
- Base64 and remote sketches are saved to temporary folders
|
||||
|
||||
Reference in New Issue
Block a user