Merge branch 'processing:main' into gradle-preprocessor

Author: Stefterv

.all-contributorsrc

@@ -1484,6 +1484,26 @@
         "code"
       ]
     },
+    {
+      "login": "babaissarkar",
+      "name": "Subhraman Sarkar",
+      "avatar_url": "https://avatars.githubusercontent.com/u/8469888?v=4",
+      "profile": "https://github.com/babaissarkar",
+      "contributions": [
+        "code",
+        "a11y"
+      ]
+    },
+    {
+      "login": "SushantBansal-tech",
+      "name": "SushantBansal-tech",
+      "avatar_url": "https://avatars.githubusercontent.com/u/189839531?v=4",
+      "profile": "https://github.com/SushantBansal-tech",
+      "contributions": [
+        "ideas",
+        "code"
+      ]
+    }
   ],
   "repoType": "github",
   "repoHost": "https://github.com",

BUILD.md

@@ -8,6 +8,8 @@ First, [download the IntelliJ IDEA Community Edition](https://www.jetbrains.com/
 
 1. Clone the Processing4 repository to your machine locally
 1. Open the cloned repository in IntelliJ IDEA CE
+1. When prompted, select **Trust Project**. You can preview the project in Safe Mode but you won't be able to build Processing.
+1. IntelliJ may start loading Gradle dependencies automatically. Wait for this process to complete.
 1. In the main menu, go to File > Project Structure > Project Settings > Project.
 1. In the SDK Dropdown option, select a JDK version 17 or Download the jdk
 1. Click the green Run Icon in the top right of the window. This is also where you can find the option to debug Processing. 
@@ -31,7 +33,7 @@ Processing consists of three main components: `Core`, `Java`, and `App`. The `Co
 
 - **Java**: The part of Processing that compiles and runs `.pde` files. It supports different *modes* which implement support for different languages or versions of Processing. The default mode is `Java`.
 
-- `App`: This is the Processing Development Environment (PDE), the visual part of the editor that you see and work within when you use Processing.
+- **App**: This is the Processing Development Environment (PDE), the visual part of the editor that you see and work within when you use Processing.
 
 
 ### Examples

CONTRIBUTING.md

@@ -7,14 +7,14 @@ Processing is a flexible software sketchbook and a programming language designed
 
 This repository contains the source code for the [Processing](https://processing.org/) project for people who want to help improve the code.
 
-## Announcing Processing 4.3.1
+## Welcome to Processing 4.4!
 
-We’re excited to announce the release of Processing 4.3.1! This update brings tooling improvements and a friendlier experience for contributors. To learn more, read the [Processing 4.3.1 announcement](https://github.com/processing/processing4-carbon-aug-19/wiki/Announcing-Processing-4.3.1).
+We’re excited to announce the release of Processing 4.4! This update modernizes Processing under the hood to make future development easier. Key changes include switching the build system from Ant to Gradle, starting the transition from Swing to Jetpack Compose Multiplatform for the UI, and adding Kotlin support to the codebase. To learn more, check out [Changes in 4.4.0](https://github.com/processing/processing4/wiki/Changes-in-4.4).
 
-Processing was initiated in 2001 by Ben Fry and Casey Reas, who lead the development and maintenance of the project until 2023. We are grateful for their vision and dedication to the project. Processing is also indebted to over two decades of contributions from the broader Processing community. 
+We hope these updates will make it easier for more people to contribute to Processing. If you'd like to get involved, have a look at our [Contributor Guide](CONTRIBUTING.md).
 
-> [!NOTE] 
-> Due to platform limitations, the GitHub Contributors page for this repository does not show the complete list of contributors. However, the [git commit history](https://github.com/processing/processing4/commits/main/) provides a full record of the project's contributions. For contributor graphs before November 13th, refer to [this page](https://github.com/benfry/processing4/graphs/contributors). A comprehensive [list of all contributors](#contributors) is also included below. To see all commits by a contributor, click on the [💻](https://github.com/processing/processing4/commits?author=benfry) emoji below their name.
+## Acknowledgement
+Processing was initiated in 2001 by Ben Fry and Casey Reas, who led the development and maintenance of the project until 2023. We are grateful for their vision and dedication to the project. Processing is also indebted to over two decades of contributions from the broader Processing community.
 
 ## Using Processing
 
@@ -66,8 +66,9 @@ For licensing information about the Processing website see the [processing-websi
 Copyright (c) 2015-now The Processing Foundation
 
 ## Contributors
+The Processing project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification, recognizing all forms of contributions (not just code!). A list of all contributors is included below. You can add yourself to the contributors list [here](https://github.com/processing/processing4-carbon-aug-19/issues/839)!
 
-Add yourself to the contributors list [here](https://github.com/processing/processing4-carbon-aug-19/issues/839)!
+_Note: due to GitHub's limitations, this repository's [Contributors](https://github.com/processing/processing4/graphs/contributors) page only shows accurate contribution data starting from late 2024. Contributor graphs from before November 13th 2024 can be found on [this page](https://github.com/benfry/processing4/graphs/contributors). The [git commit history](https://github.com/processing/processing4/commits/main/) provides a full record of the project's contributions. To see all commits by a contributor, click on the [💻](https://github.com/processing/processing4/commits?author=benfry) emoji below their name._
 
 <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
 <!-- prettier-ignore-start -->
@@ -290,6 +291,10 @@ Add yourself to the contributors list [here](https://github.com/processing/proce
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/Rishab87"><img src="https://avatars.githubusercontent.com/u/138858208?v=4?s=120" width="120px;" alt="Rishab Kumar Jha"/><br /><sub><b>Rishab Kumar Jha</b></sub></a><br /><a href="https://github.com/processing/processing4/commits?author=Rishab87" title="Code">💻</a></td>
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/yehiarasheed"><img src="https://avatars.githubusercontent.com/u/157399068?v=4?s=120" width="120px;" alt="Yehia Rasheed"/><br /><sub><b>Yehia Rasheed</b></sub></a><br /><a href="https://github.com/processing/processing4/commits?author=yehiarasheed" title="Code">💻</a></td>
     </tr>
+    <tr>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/babaissarkar"><img src="https://avatars.githubusercontent.com/u/8469888?v=4?s=120" width="120px;" alt="Subhraman Sarkar"/><br /><sub><b>Subhraman Sarkar</b></sub></a><br /><a href="https://github.com/processing/processing4/commits?author=babaissarkar" title="Code">💻</a> <a href="#a11y-babaissarkar" title="Accessibility">️️️️♿️</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/SushantBansal-tech"><img src="https://avatars.githubusercontent.com/u/189839531?v=4?s=120" width="120px;" alt="SushantBansal-tech"/><br /><sub><b>SushantBansal-tech</b></sub></a><br /><a href="#ideas-SushantBansal-tech" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/processing/processing4/commits?author=SushantBansal-tech" title="Code">💻</a></td>
+    </tr>
   </tbody>
 </table>
 

README.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

SCHEMA.md

@@ -72,6 +72,7 @@ compose.desktop {
                 entitlementsFile.set(file("macos/entitlements.plist"))
                 runtimeEntitlementsFile.set(file("macos/entitlements.plist"))
                 appStore = true
+                jvmArgs("-Dsun.java2d.metal=true")
             }
             windows{
                 iconFile = rootProject.file("build/windows/processing.ico")
@@ -354,6 +355,7 @@ tasks.register<Download>("includeJdk") {
             into(composeResources(""))
         }
     }
+    finalizedBy("prepareAppResources")
 }
 tasks.register<Copy>("includeSharedAssets"){
     from("../build/shared/")
@@ -511,7 +513,6 @@ afterEvaluate {
         dependsOn(
             "includeCore",
             "includeJavaMode",
-            "includeJdk",
             "includeSharedAssets",
             "includeProcessingExamples",
             "includeProcessingWebsiteExamples",
@@ -539,7 +540,7 @@ afterEvaluate {
         }
     }
     tasks.named("createDistributable").configure {
-        dependsOn("signResources")
+        dependsOn("signResources", "includeJdk")
         finalizedBy("setExecutablePermissions")
     }
-}
+}

app/build.gradle.kts

@@ -0,0 +1,23 @@
+# The default is 8, which creates tiny nubby scroll bars
+ScrollBar.width = 16
+
+TitlePane.inactiveForeground = #000000
+
+
+# Better matched for macOS dark mode (but using everywhere)
+# https://github.com/JFormDesigner/FlatLaf/issues/497
+
+[dark]@background = #1e1e1e
+[dark]@foreground = #e0e0e0
+[dark]@accentColor = #107aff
+[dark]@accentFocusColor = #176896
+
+[dark]Component.arrowType = chevron
+
+[dark]CheckBox.icon.style = filled
+[dark]CheckBox.icon[filled].selectedBorderColor = @accentColor
+[dark]CheckBox.icon[filled].selectedBackground = @accentColor
+[dark]CheckBox.icon[filled].checkmarkColor = @foreground
+
+[dark]RadioButton.icon.style = filled
+[dark]RadioButton.icon[filled].centerDiameter = 6

app/src/main/resources/about-processing.svg

@@ -1,5 +1,9 @@
 package processing.app
 
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.Job
+import kotlinx.coroutines.launch
 import processing.app.ui.Editor
 import java.io.File
 import java.io.FileOutputStream
@@ -13,6 +17,8 @@ import java.util.*
 class Schema {
     companion object{
         private var base: Base? = null
+        val jobs = mutableListOf<Job>()
+
         @JvmStatic
         fun handleSchema(input: String, base: Base): Editor?{
             this.base = base
@@ -92,8 +98,9 @@ class Schema {
             }
 
         }
+
+        private val scope = CoroutineScope(Dispatchers.Default)
         private fun downloadFiles(uri: URI, urlList: String, targetFolder: File, extension: String = ""){
-            Thread{
                 targetFolder.mkdirs()
 
                 val base = uri.path.split("/")
@@ -128,15 +135,20 @@ class Schema {
                                 URL("https://$content").path.isNotBlank() -> "https://$content"
                                 else -> "https://$base/$content"
                             })
-                            url.openStream().use { input ->
-                                target.outputStream().use { output ->
-                                    input.copyTo(output)
+                            val download = scope.launch{
+                                url.openStream().use { input ->
+                                    target.outputStream().use { output ->
+                                        input.copyTo(output)
+                                    }
                                 }
                             }
+                            jobs.add(download)
+                            download.invokeOnCompletion {
+                                jobs.remove(download)
+                            }
                         }
 
                     }
-            }.start()
         }
 
 

app/src/main/resources/processing/app/laf/FlatLaf.properties

@@ -31,6 +31,8 @@
 import processing.app.Preferences;
 import processing.core.PApplet;
 
+import javax.swing.*;
+
 
 public class LinuxPlatform extends DefaultPlatform {
   String homeDir;
@@ -39,6 +41,9 @@ public class LinuxPlatform extends DefaultPlatform {
   public void initBase(Base base) {
     super.initBase(base);
 
+    JFrame.setDefaultLookAndFeelDecorated(true);
+    System.setProperty("flatlaf.menuBarEmbedded", "true");
+
     // Set X11 WM_CLASS property which is used as the application
     // name by Gnome 3 and other window managers.
     // https://github.com/processing/processing/issues/2534