Merge branch 'processing:main' into store-installs

Author: Stefterv

.all-contributorsrc

@@ -1493,6 +1493,16 @@
         "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",

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. 

CONTRIBUTING.md

@@ -69,22 +69,37 @@ If there hasn’t been any activity after two weeks, feel free to gently follow
 
 Before opening a pull request, please make sure to discuss the related issue and get assigned to it first. This helps us stay aligned and avoid unnecessary work. Thank you!
 
-## New Features
+## Adding New Features to Processing
 
-In most cases, the best way to contribute a new feature is to create a library. The [Processing Library Template](https://github.com/processing/processing-library-template) is a great way to get started. For more instructions, see the [library template documenation](https://processing.github.io/processing-library-template/).
+If you have an idea for something Processing doesn’t yet support, **creating a library** is often the best way to contribute.  The [Processing Library Template](https://github.com/processing/processing-library-template) provides a starting point for developing, packaging, and distributing Processing libraries. For more instructions, see the [library template documentation](https://processing.github.io/processing-library-template/).
 
+Once your library is complete, you can submit it to the official [Processing Contributions](https://github.com/processing/processing-contributions) repository. This makes it discoverable through the PDE’s Contribution Manager. Follow the guidelines in the [Processing Library Guidelines](https://github.com/processing/processing4/wiki/Library-Guidelines).
+
+### Libraries as the Starting Point for Features
 Nearly all new features are first introduced as a Library or a Mode, or even as an example. The current [OpenGL renderer](http://glgraphics.sourceforge.net/) and Video library began as separate projects by Andrés Colubri, who needed a more performant, more sophisticated version of what we had in Processing for work that he was creating. The original `loadShape()` implementation came from the “Candy” library by Michael Chang (“mflux“). Similarly, Tweak Mode began as a [separate project](http://galsasson.com/tweakmode/) by Gal Sasson before being incorporated. PDE X was a Google Summer of code [project](https://github.com/processing/processing-experimental) by Manindra Moharana that updated the PDE to include basic refactoring and better error checking.
 
-Developing features separately from the main software has several benefits:
+### Why Develop Outside the Core?
+Working outside the main Processing codebase has several advantages:
 
 * It’s easier for the contributor to develop the software without it needing to work for tens or hundreds of thousands of Processing users.
 * It provides a way to get feedback on that code independently of everything else, and the ability to iterate on it rapidly.
 * This feedback process also helps gauge the level of interest for the community, and how it should be prioritized for the software.
 * We can delay the process of “normalizing” the features so that they’re consistent with the rest of Processing (function naming, structure, etc).
 
-A major consideration for any new feature is the level of maintenance that it might require in the future. If the original maintainer loses interest over time (which is normal) and the feature breaks (which happens more often than we'd like), it sits on the issues list unfixed, which isn’t good for anyone.
+### What Guides the Inclusion of New Features?
+We take maintenance seriously. A feature added to the core becomes a long-term responsibility. If it breaks, it needs fixing. Sometimes the original developer is no longer active (which is normal), and the burden falls on others.
+
+Processing is a massive project that has existed for more than 20 years. Part of its longevity comes from the effort that’s gone into keeping things as simple as we can, and in particular, making a lot of difficult decisions about *what to leave out*. 
+
+Adding a new feature always has to be weighed against the potential confusion of one more thing—whether it’s a menu item, a dialog box, a function that needs to be added to the reference, etc. Adding a new graphics function means making it work across all the renderers that we ship (Java2D, OpenGL, JavaFX, PDF, etc) and across platforms (macOS, Windows, Linux).
+
+It may also mean new interface elements, updates to the reference, and more documentation.
+
+So when we consider a new feature, we ask ourselves:
+
+> Does this solve a problem for many users? Is it worth the added complexity and extra maintenance work?
 
-Processing is a massive project that has existed for more than 20 years. Part of its longevity comes from the effort that’s gone into keeping things as simple as we can, and in particular, making a lot of difficult decisions about *what to leave out*. Adding a new feature always has to be weighed against the potential confusion of one more thing—whether it’s a menu item, a dialog box, a function that needs to be added to the reference, etc. Adding a new graphics function means making it work across all the renderers that we ship (Java2D, OpenGL, JavaFX, PDF, etc) and across platforms (macOS, Windows, Linux). Does the feature help enough people that it's worth making the reference longer? Or the additional burden of maintaining that feature? It's no fun to say “no,” especially to people volunteering their time, but we often have to.
+These are not easy decisions, especially when volunteers are offering their time and ideas. But we have to make them carefully to keep Processing sustainable.
 
 ## Editor
 

README.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 -->
@@ -292,6 +293,7 @@ Add yourself to the contributors list [here](https://github.com/processing/proce
     </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>

build/shared/lib/theme/Alloys/agpalilik.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #0066C5
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #C0FFFF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/armanty.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #834548
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FFEBEC
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/bacubirito.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #49D0A7
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #1A0300
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/bondoc.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #431D29
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FFF2FF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/brahin.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #47502C
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FBFFD7
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/esquel.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #978FAC
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #540000
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/gancedo.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #9D0038
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FFE8FF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/hoba.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #F07D44
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #3E0000
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/imilac.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #E9E9E9
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #00003B
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/jepara.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #FF6E38
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #000049
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/mbozi.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #FF8F2F
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #470000
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/morito.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #697982
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #EFFFFF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/omolon.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #4E535A
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FAFFFF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/seymchan.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #00593B
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #B7FFEA
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/tagish.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #A55134
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FFFDFB
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Alloys/youxi.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #008A50
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #CBFFEF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/antimony.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #092D38
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #E1FFFF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/bauxite.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #4A4E59
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FAFEFF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/beryl.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #00926F
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #001E00
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/calcite.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #B9BDC4
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #000009
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/feldspar.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #BD8A68
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #270000
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/fluorite.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #402563
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FFEFFF
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/gabbro.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #7A896D
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #000700
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/galena.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #6C7076
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #000009
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/garnet.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #973542
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #FFEFF2
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/jasper.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #CC383C
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #fbb5b5
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/kyanite.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #5E93BF
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #000833
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/malachite.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #313E38
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #F2FFFA
 
 # transparency (0..100) for line numbers in gutter

build/shared/lib/theme/Minerals/olivine.txt

@@ -161,7 +161,7 @@ editor.scrollbar.color = #869F36
 
 ## PdeTextAreaPainter - extras added to the editor ##
 
-editor.gutter.text.font = processing.mono,bold,16
+editor.gutter.text.font = processing.mono,bold,12
 editor.gutter.text.color = #000D00
 
 # transparency (0..100) for line numbers in gutter