├── .gitignore
├── .idea
├── externalDependencies.xml
├── ktfmt.xml
├── runConfigurations
│ ├── Run_application.xml
│ └── Run_web_application.xml
└── vcs.xml
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── build.gradle.kts
├── gradle.properties
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── settings.gradle.kts
├── showcase.gif
└── src
├── commonMain
└── kotlin
│ └── App.kt
├── jvmMain
└── kotlin
│ └── Main.kt
└── wasmJsMain
├── kotlin
└── Main.kt
└── resources
└── index.html
/.gitignore:
--------------------------------------------------------------------------------
1 | ### macOS template
2 | # General
3 | .DS_Store
4 | .AppleDouble
5 | .LSOverride
6 |
7 | # Icon must end with two \r
8 | Icon
9 |
10 | # Thumbnails
11 | ._*
12 |
13 | ### Gradle template
14 | .gradle
15 | build/
16 |
17 | ### Terraform template
18 | # Local .terraform directories
19 | **/.terraform/*
20 |
21 | # .tfstate files
22 | *.tfstate
23 | *.tfstate.*
24 |
25 | ### JetBrains template
26 | # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm
27 | # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
28 |
29 | *.iml
30 | *.ipr
31 | *.iws
32 | .idea/*
33 | out/
34 | local.properties
35 | .kotlin
36 | kotlin-js-store
37 |
38 | # IDEA/Android Studio project settings ignore exceptions
39 | !.idea/codeStyles/
40 | !.idea/copyright/
41 | !.idea/dataSources.xml
42 | !.idea/encodings.xml
43 | !.idea/externalDependencies.xml
44 | !.idea/fileTemplates/
45 | !.idea/icon.svg
46 | !.idea/icon.png
47 | !.idea/icon_dark.png
48 | !.idea/inspectionProfiles/
49 | !.idea/ktfmt.xml
50 | !.idea/runConfigurations/
51 | !.idea/scopes/
52 | !.idea/vcs.xml
53 |
54 | ### Kotlin template
55 | # Compiled class file
56 | *.class
57 |
58 | # Log file
59 | *.log
60 |
61 | # Package Files #
62 | *.jar
63 | *.war
64 | *.nar
65 | *.ear
66 | *.zip
67 | *.tar.gz
68 | *.rar
69 |
70 | # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
71 | hs_err_pid*
72 |
73 | ### Windows template
74 | # Windows thumbnail cache files
75 | Thumbs.db
76 | ehthumbs.db
77 | ehthumbs_vista.db
78 |
79 | # Dump file
80 | *.stackdump
81 |
82 | # Folder config file
83 | [Dd]esktop.ini
84 |
85 | # Recycle Bin used on file shares
86 | $RECYCLE.BIN/
87 |
88 | # Windows Installer files
89 | *.cab
90 | *.msi
91 | *.msix
92 | *.msm
93 | *.msp
94 |
95 | # Windows shortcuts
96 | *.lnk
97 |
98 | # Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
99 | !gradle-wrapper.jar
100 |
--------------------------------------------------------------------------------
/.idea/externalDependencies.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
--------------------------------------------------------------------------------
/.idea/ktfmt.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
--------------------------------------------------------------------------------
/.idea/runConfigurations/Run_application.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
11 |
16 |
17 |
18 | true
19 | true
20 | false
21 | false
22 |
23 |
24 |
--------------------------------------------------------------------------------
/.idea/runConfigurations/Run_web_application.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
11 |
16 |
17 |
18 | true
19 | true
20 | false
21 | false
22 |
23 |
24 |
--------------------------------------------------------------------------------
/.idea/vcs.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
1 | # Contributor Covenant Code of Conduct
2 |
3 | ## Our Pledge
4 |
5 | We as members, contributors, and leaders pledge to make participation in our
6 | community a harassment-free experience for everyone, regardless of age, body
7 | size, visible or invisible disability, ethnicity, sex characteristics, gender
8 | identity and expression, level of experience, education, socio-economic status,
9 | nationality, personal appearance, race, religion, or sexual identity
10 | and orientation.
11 |
12 | We pledge to act and interact in ways that contribute to an open, welcoming,
13 | diverse, inclusive, and healthy community.
14 |
15 | ## Our Standards
16 |
17 | Examples of behavior that contributes to a positive environment for our
18 | community include:
19 |
20 | * Demonstrating empathy and kindness toward other people
21 | * Being respectful of differing opinions, viewpoints, and experiences
22 | * Giving and gracefully accepting constructive feedback
23 | * Accepting responsibility and apologizing to those affected by our mistakes,
24 | and learning from the experience
25 | * Focusing on what is best not just for us as individuals, but for the
26 | overall community
27 |
28 | Examples of unacceptable behavior include:
29 |
30 | * The use of sexualized language or imagery, and sexual attention or
31 | advances of any kind
32 | * Trolling, insulting or derogatory comments, and personal or political attacks
33 | * Public or private harassment
34 | * Publishing others' private information, such as a physical or email
35 | address, without their explicit permission
36 | * Other conduct which could reasonably be considered inappropriate in a
37 | professional setting
38 |
39 | ## Enforcement Responsibilities
40 |
41 | Community leaders are responsible for clarifying and enforcing our standards of
42 | acceptable behavior and will take appropriate and fair corrective action in
43 | response to any behavior that they deem inappropriate, threatening, offensive,
44 | or harmful.
45 |
46 | Community leaders have the right and responsibility to remove, edit, or reject
47 | comments, commits, code, wiki edits, issues, and other contributions that are
48 | not aligned to this Code of Conduct, and will communicate reasons for moderation
49 | decisions when appropriate.
50 |
51 | ## Scope
52 |
53 | This Code of Conduct applies within all community spaces, and also applies when
54 | an individual is officially representing the community in public spaces.
55 | Examples of representing our community include using an official e-mail address,
56 | posting via an official social media account, or acting as an appointed
57 | representative at an online or offline event.
58 |
59 | ## Enforcement
60 |
61 | Instances of abusive, harassing, or otherwise unacceptable behavior may be
62 | reported to the community leaders responsible for enforcement at
63 | [@jetbrains](https://github.com/jetbrains).
64 | All complaints will be reviewed and investigated promptly and fairly.
65 |
66 | All community leaders are obligated to respect the privacy and security of the
67 | reporter of any incident.
68 |
69 | ## Enforcement Guidelines
70 |
71 | Community leaders will follow these Community Impact Guidelines in determining
72 | the consequences for any action they deem in violation of this Code of Conduct:
73 |
74 | ### 1. Correction
75 |
76 | **Community Impact**: Use of inappropriate language or other behavior deemed
77 | unprofessional or unwelcome in the community.
78 |
79 | **Consequence**: A private, written warning from community leaders, providing
80 | clarity around the nature of the violation and an explanation of why the
81 | behavior was inappropriate. A public apology may be requested.
82 |
83 | ### 2. Warning
84 |
85 | **Community Impact**: A violation through a single incident or series
86 | of actions.
87 |
88 | **Consequence**: A warning with consequences for continued behavior. No
89 | interaction with the people involved, including unsolicited interaction with
90 | those enforcing the Code of Conduct, for a specified period of time. This
91 | includes avoiding interactions in community spaces as well as external channels
92 | like social media. Violating these terms may lead to a temporary or
93 | permanent ban.
94 |
95 | ### 3. Temporary Ban
96 |
97 | **Community Impact**: A serious violation of community standards, including
98 | sustained inappropriate behavior.
99 |
100 | **Consequence**: A temporary ban from any sort of interaction or public
101 | communication with the community for a specified period of time. No public or
102 | private interaction with the people involved, including unsolicited interaction
103 | with those enforcing the Code of Conduct, is allowed during this period.
104 | Violating these terms may lead to a permanent ban.
105 |
106 | ### 4. Permanent Ban
107 |
108 | **Community Impact**: Demonstrating a pattern of violation of community
109 | standards, including sustained inappropriate behavior, harassment of an
110 | individual, or aggression toward or disparagement of classes of individuals.
111 |
112 | **Consequence**: A permanent ban from any sort of public interaction within
113 | the community.
114 |
115 | ## Attribution
116 |
117 | This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118 | version 2.0, available at
119 | https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
120 |
121 | Community Impact Guidelines were inspired by [Mozilla's code of conduct
122 | enforcement ladder](https://github.com/mozilla/diversity).
123 |
124 | [homepage]: https://www.contributor-covenant.org
125 |
126 | For answers to common questions about this code of conduct, see the FAQ at
127 | https://www.contributor-covenant.org/faq. Translations are available at
128 | https://www.contributor-covenant.org/translations.
129 |
--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
1 | # Contributions
2 |
3 | We're glad to accept contributions from the community.
4 |
5 | However, **before you open a PR**, please make sure there is a corresponding issue open.
6 | In the case of a new feature, a large refactoring, and similar non-trivial changes, it's necessary that a project
7 | maintainer greenlights it
8 | in advance on the issue page. Non pre-approved PRs that aren't bug fixes or trivial in nature will **not** be accepted.
9 |
10 | # How to contribute
11 |
12 | Prerequisites:
13 |
14 | - Familiarity with [pull requests](https://help.github.com/articles/using-pull-requests)
15 | and [issues](https://guides.github.com/features/issues/).
16 | - Knowledge of [Markdown](https://help.github.com/articles/markdown-basics/) for editing `.md` documents.
17 | - Knowledge of [Kotlin](https://kotlinlang.org), [Jetpack Compose](https://d.android.com/jetpack/compose), and
18 | [Compose Multiplatform](https://jetbrains.com/lp/compose)
19 |
20 | In particular, this community seeks the following types of contributions:
21 |
22 | - **Ideas**: participate in an issue thread or start your own to have your voice heard.
23 | - **Bug fixes**: bugs are inevitable, fixes are always welcome.
24 | - **Features**: see the [Contributions](#contributions) section above
25 |
26 | # Conduct
27 |
28 | We are committed to providing a friendly, safe and welcoming environment for
29 | all, regardless of gender, sexual orientation, disability, ethnicity, religion,
30 | or similar personal characteristic.
31 |
32 | Please avoid using overtly sexual nicknames or other nicknames that
33 | might detract from a friendly, safe and welcoming environment for all.
34 |
35 | Please be kind and courteous. There's no need to be mean or rude.
36 | Respect that people have differences of opinion and that every design or
37 | implementation choice carries a trade-off and numerous costs. There is seldom
38 | a right answer, merely an optimal answer given a set of values and
39 | circumstances. Try to assume that our community members are nice people
40 | and remember, [miscommunication happens](https://hiddenbrain.org/podcast/why-conversations-go-wrong/).
41 |
42 | Please keep unstructured critique to a minimum. If you have solid ideas you
43 | want to experiment with, make a fork and see how it works.
44 |
45 | We will exclude you from interaction if you insult, demean or harass anyone.
46 | That is not welcome behaviour. We interpret the term "harassment" as
47 | including the definition in the [Code of Conduct](CODE_OF_CONDUCT.md);
48 | if you have any lack of clarity about what might be included in that concept,
49 | please read the definition. In particular, we don't tolerate behavior that
50 | excludes people in socially marginalized groups.
51 |
52 | Private harassment is also unacceptable. No matter who you are, if you feel
53 | you have been or are being harassed or made uncomfortable by a community
54 | member, please contact [one of the maintainers](https://github.com/JetBrains/jewel/graphs/contributors)
55 | immediately.
56 | Whether you're a regular contributor or a newcomer, we care about
57 | making this community a safe place for you and we've got your back.
58 |
59 | Likewise any spamming, trolling, flaming, baiting or other attention-stealing
60 | behaviour is not welcome.
61 |
62 | # Communication
63 |
64 | GitHub issues, PRs and discussions are the primary way for communicating about specific proposed
65 | changes to this project.
66 |
67 | In all those contexts, please follow the conduct guidelines above. Language issues
68 | are often contentious and we'd like to keep discussion brief, civil and focused
69 | on what we're actually doing, not wandering off into too much imaginary stuff.
70 |
71 | # Inspiration
72 |
73 | This guide is inspired
74 | to [Juno Suárez' contribution guidelines](https://github.com/junosuarez/CONTRIBUTING.md/blob/master/CONTRIBUTING.md),
75 | licensed under CC-0 license.
76 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 |
2 | Apache License
3 | Version 2.0, January 2004
4 | http://www.apache.org/licenses/
5 |
6 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7 |
8 | 1. Definitions.
9 |
10 | "License" shall mean the terms and conditions for use, reproduction,
11 | and distribution as defined by Sections 1 through 9 of this document.
12 |
13 | "Licensor" shall mean the copyright owner or entity authorized by
14 | the copyright owner that is granting the License.
15 |
16 | "Legal Entity" shall mean the union of the acting entity and all
17 | other entities that control, are controlled by, or are under common
18 | control with that entity. For the purposes of this definition,
19 | "control" means (i) the power, direct or indirect, to cause the
20 | direction or management of such entity, whether by contract or
21 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
22 | outstanding shares, or (iii) beneficial ownership of such entity.
23 |
24 | "You" (or "Your") shall mean an individual or Legal Entity
25 | exercising permissions granted by this License.
26 |
27 | "Source" form shall mean the preferred form for making modifications,
28 | including but not limited to software source code, documentation
29 | source, and configuration files.
30 |
31 | "Object" form shall mean any form resulting from mechanical
32 | transformation or translation of a Source form, including but
33 | not limited to compiled object code, generated documentation,
34 | and conversions to other media types.
35 |
36 | "Work" shall mean the work of authorship, whether in Source or
37 | Object form, made available under the License, as indicated by a
38 | copyright notice that is included in or attached to the work
39 | (an example is provided in the Appendix below).
40 |
41 | "Derivative Works" shall mean any work, whether in Source or Object
42 | form, that is based on (or derived from) the Work and for which the
43 | editorial revisions, annotations, elaborations, or other modifications
44 | represent, as a whole, an original work of authorship. For the purposes
45 | of this License, Derivative Works shall not include works that remain
46 | separable from, or merely link (or bind by name) to the interfaces of,
47 | the Work and Derivative Works thereof.
48 |
49 | "Contribution" shall mean any work of authorship, including
50 | the original version of the Work and any modifications or additions
51 | to that Work or Derivative Works thereof, that is intentionally
52 | submitted to Licensor for inclusion in the Work by the copyright owner
53 | or by an individual or Legal Entity authorized to submit on behalf of
54 | the copyright owner. For the purposes of this definition, "submitted"
55 | means any form of electronic, verbal, or written communication sent
56 | to the Licensor or its representatives, including but not limited to
57 | communication on electronic mailing lists, source code control systems,
58 | and issue tracking systems that are managed by, or on behalf of, the
59 | Licensor for the purpose of discussing and improving the Work, but
60 | excluding communication that is conspicuously marked or otherwise
61 | designated in writing by the copyright owner as "Not a Contribution."
62 |
63 | "Contributor" shall mean Licensor and any individual or Legal Entity
64 | on behalf of whom a Contribution has been received by Licensor and
65 | subsequently incorporated within the Work.
66 |
67 | 2. Grant of Copyright License. Subject to the terms and conditions of
68 | this License, each Contributor hereby grants to You a perpetual,
69 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70 | copyright license to reproduce, prepare Derivative Works of,
71 | publicly display, publicly perform, sublicense, and distribute the
72 | Work and such Derivative Works in Source or Object form.
73 |
74 | 3. Grant of Patent License. Subject to the terms and conditions of
75 | this License, each Contributor hereby grants to You a perpetual,
76 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77 | (except as stated in this section) patent license to make, have made,
78 | use, offer to sell, sell, import, and otherwise transfer the Work,
79 | where such license applies only to those patent claims licensable
80 | by such Contributor that are necessarily infringed by their
81 | Contribution(s) alone or by combination of their Contribution(s)
82 | with the Work to which such Contribution(s) was submitted. If You
83 | institute patent litigation against any entity (including a
84 | cross-claim or counterclaim in a lawsuit) alleging that the Work
85 | or a Contribution incorporated within the Work constitutes direct
86 | or contributory patent infringement, then any patent licenses
87 | granted to You under this License for that Work shall terminate
88 | as of the date such litigation is filed.
89 |
90 | 4. Redistribution. You may reproduce and distribute copies of the
91 | Work or Derivative Works thereof in any medium, with or without
92 | modifications, and in Source or Object form, provided that You
93 | meet the following conditions:
94 |
95 | (a) You must give any other recipients of the Work or
96 | Derivative Works a copy of this License; and
97 |
98 | (b) You must cause any modified files to carry prominent notices
99 | stating that You changed the files; and
100 |
101 | (c) You must retain, in the Source form of any Derivative Works
102 | that You distribute, all copyright, patent, trademark, and
103 | attribution notices from the Source form of the Work,
104 | excluding those notices that do not pertain to any part of
105 | the Derivative Works; and
106 |
107 | (d) If the Work includes a "NOTICE" text file as part of its
108 | distribution, then any Derivative Works that You distribute must
109 | include a readable copy of the attribution notices contained
110 | within such NOTICE file, excluding those notices that do not
111 | pertain to any part of the Derivative Works, in at least one
112 | of the following places: within a NOTICE text file distributed
113 | as part of the Derivative Works; within the Source form or
114 | documentation, if provided along with the Derivative Works; or,
115 | within a display generated by the Derivative Works, if and
116 | wherever such third-party notices normally appear. The contents
117 | of the NOTICE file are for informational purposes only and
118 | do not modify the License. You may add Your own attribution
119 | notices within Derivative Works that You distribute, alongside
120 | or as an addendum to the NOTICE text from the Work, provided
121 | that such additional attribution notices cannot be construed
122 | as modifying the License.
123 |
124 | You may add Your own copyright statement to Your modifications and
125 | may provide additional or different license terms and conditions
126 | for use, reproduction, or distribution of Your modifications, or
127 | for any such Derivative Works as a whole, provided Your use,
128 | reproduction, and distribution of the Work otherwise complies with
129 | the conditions stated in this License.
130 |
131 | 5. Submission of Contributions. Unless You explicitly state otherwise,
132 | any Contribution intentionally submitted for inclusion in the Work
133 | by You to the Licensor shall be under the terms and conditions of
134 | this License, without any additional terms or conditions.
135 | Notwithstanding the above, nothing herein shall supersede or modify
136 | the terms of any separate license agreement you may have executed
137 | with Licensor regarding such Contributions.
138 |
139 | 6. Trademarks. This License does not grant permission to use the trade
140 | names, trademarks, service marks, or product names of the Licensor,
141 | except as required for reasonable and customary use in describing the
142 | origin of the Work and reproducing the content of the NOTICE file.
143 |
144 | 7. Disclaimer of Warranty. Unless required by applicable law or
145 | agreed to in writing, Licensor provides the Work (and each
146 | Contributor provides its Contributions) on an "AS IS" BASIS,
147 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148 | implied, including, without limitation, any warranties or conditions
149 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150 | PARTICULAR PURPOSE. You are solely responsible for determining the
151 | appropriateness of using or redistributing the Work and assume any
152 | risks associated with Your exercise of permissions under this License.
153 |
154 | 8. Limitation of Liability. In no event and under no legal theory,
155 | whether in tort (including negligence), contract, or otherwise,
156 | unless required by applicable law (such as deliberate and grossly
157 | negligent acts) or agreed to in writing, shall any Contributor be
158 | liable to You for damages, including any direct, indirect, special,
159 | incidental, or consequential damages of any character arising as a
160 | result of this License or out of the use or inability to use the
161 | Work (including but not limited to damages for loss of goodwill,
162 | work stoppage, computer failure or malfunction, or any and all
163 | other commercial damages or losses), even if such Contributor
164 | has been advised of the possibility of such damages.
165 |
166 | 9. Accepting Warranty or Additional Liability. While redistributing
167 | the Work or Derivative Works thereof, You may choose to offer,
168 | and charge a fee for, acceptance of support, warranty, indemnity,
169 | or other liability obligations and/or rights consistent with this
170 | License. However, in accepting such obligations, You may act only
171 | on Your own behalf and on Your sole responsibility, not on behalf
172 | of any other Contributor, and only if You agree to indemnify,
173 | defend, and hold each Contributor harmless for any liability
174 | incurred by, or claims asserted against, such Contributor by reason
175 | of your accepting any such warranty or additional liability.
176 |
177 | END OF TERMS AND CONDITIONS
178 |
179 | APPENDIX: How to apply the Apache License to your work.
180 |
181 | To apply the Apache License to your work, attach the following
182 | boilerplate notice, with the fields enclosed by brackets "[]"
183 | replaced with your own identifying information. (Don't include
184 | the brackets!) The text should be enclosed in the appropriate
185 | comment syntax for the file format. We also recommend that a
186 | file or class name and description of purpose be included on the
187 | same "printed page" as the copyright notice for easier
188 | identification within third-party archives.
189 |
190 | Copyright [yyyy] [name of copyright owner]
191 |
192 | Licensed under the Apache License, Version 2.0 (the "License");
193 | you may not use this file except in compliance with the License.
194 | You may obtain a copy of the License at
195 |
196 | http://www.apache.org/licenses/LICENSE-2.0
197 |
198 | Unless required by applicable law or agreed to in writing, software
199 | distributed under the License is distributed on an "AS IS" BASIS,
200 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201 | See the License for the specific language governing permissions and
202 | limitations under the License.
203 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Sandbox: Falling Sand Simulation in Kotlin Compose for Desktop
2 |
3 | This project demonstrates a simple falling sands simulation built with Kotlin and Jetpack Compose for Desktop.
4 |
5 | Features:
6 |
7 | * Sand particles fall under gravity.
8 | * Particles interact with each other and the bottom boundary, creating a dynamic simulation.
9 | * Colours!
10 |
11 | 
12 |
13 | ## Getting Started
14 |
15 | Prerequisites:
16 |
17 | * A recent version of IntelliJ IDEA Community
18 | * JDK 17 or later (JetBrains Runtime **strongly** recommended)
19 | * Kotlin compiler (included with most recent IntelliJ IDEA versions)
20 |
21 | ## Running the application
22 |
23 | 1. Open the project in your favorite IDE (e.g. IntelliJ IDEA).
24 | 2. Build and run the project. The simulation should launch.
25 |
26 | ## Licence
27 |
28 | This project is licenced under the Apache Licence, Version 2.0. See the [licence file](LICENSE) for details.
29 |
30 | ```
31 | Copyright 2024 Sebastiano Poggi
32 | Licensed under the Apache License, Version 2.0 (the "License");
33 | you may not use this file except in compliance with the License.
34 | You may obtain a copy of the License at
35 | http://www.apache.org/licenses/LICENSE-2.0
36 | Unless required by applicable law or agreed to in writing, software
37 | distributed under the License is distributed on an "AS IS" BASIS,
38 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
39 | See the License for the specific language governing permissions and
40 | limitations under the License.
41 | ```
42 |
43 | ## Contributing
44 |
45 | The code for this project is decent, but not great. There is a ton of performance optimisation that can be done, if you
46 | feel so inclined. I haven't really bothered too much. It's plenty fast on my Macbook.
47 |
48 | We welcome contributions to this project. Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines.
49 |
50 | ## Disclaimer
51 |
52 | This is a sample project for demonstration purposes only. It may not be production-ready and is intended to showcase the
53 | capabilities of Kotlin Compose for Desktop.
54 |
--------------------------------------------------------------------------------
/build.gradle.kts:
--------------------------------------------------------------------------------
1 | import org.jetbrains.compose.desktop.application.dsl.TargetFormat
2 |
3 | plugins {
4 | kotlin("multiplatform")
5 | kotlin("plugin.compose")
6 | id("org.jetbrains.compose")
7 | }
8 |
9 | group = "dev.sebastiano"
10 | version = "1.0"
11 |
12 | repositories {
13 | maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")
14 | google()
15 | mavenCentral()
16 | }
17 |
18 | kotlin {
19 | jvm()
20 |
21 | wasmJs {
22 | browser()
23 | binaries.executable()
24 | }
25 |
26 | sourceSets {
27 | commonMain.dependencies {
28 | implementation(compose.runtime)
29 | implementation(compose.foundation)
30 | implementation(compose.components.uiToolingPreview)
31 | }
32 | jvmMain.dependencies {
33 | implementation(compose.desktop.currentOs)
34 | }
35 | }
36 | }
37 |
38 | compose.desktop {
39 | application {
40 | mainClass = "MainKt"
41 |
42 | nativeDistributions {
43 | targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb)
44 | packageName = "falling-sand"
45 | packageVersion = "1.0.0"
46 | }
47 | }
48 | }
49 |
50 | compose.experimental {
51 | web.application {}
52 | }
53 |
--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
1 | org.gradle.jvmargs=-Xmx2048M -Dfile.encoding=UTF-8 -Dkotlin.daemon.jvm.options\="-Xmx2048M"
2 | org.gradle.daemon=true
3 | org.gradle.caching=true
4 | org.gradle.configuration-cache=true
5 | kotlin.code.style=official
6 | kotlin.version=2.0.0-RC2
7 | compose.version=1.6.10-rc01
8 | org.jetbrains.compose.experimental.wasm.enabled=true
9 |
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/rock3r/sandbox-demo/86dca16ef6e66290200d41168239a91105be47e2/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | distributionBase=GRADLE_USER_HOME
2 | distributionPath=wrapper/dists
3 | distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip
4 | zipStoreBase=GRADLE_USER_HOME
5 | zipStorePath=wrapper/dists
6 |
--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
1 | #!/bin/sh
2 |
3 | #
4 | # Copyright © 2015-2021 the original authors.
5 | #
6 | # Licensed under the Apache License, Version 2.0 (the "License");
7 | # you may not use this file except in compliance with the License.
8 | # You may obtain a copy of the License at
9 | #
10 | # https://www.apache.org/licenses/LICENSE-2.0
11 | #
12 | # Unless required by applicable law or agreed to in writing, software
13 | # distributed under the License is distributed on an "AS IS" BASIS,
14 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | # See the License for the specific language governing permissions and
16 | # limitations under the License.
17 | #
18 |
19 | ##############################################################################
20 | #
21 | # Gradle start up script for POSIX generated by Gradle.
22 | #
23 | # Important for running:
24 | #
25 | # (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
26 | # noncompliant, but you have some other compliant shell such as ksh or
27 | # bash, then to run this script, type that shell name before the whole
28 | # command line, like:
29 | #
30 | # ksh Gradle
31 | #
32 | # Busybox and similar reduced shells will NOT work, because this script
33 | # requires all of these POSIX shell features:
34 | # * functions;
35 | # * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
36 | # «${var#prefix}», «${var%suffix}», and «$( cmd )»;
37 | # * compound commands having a testable exit status, especially «case»;
38 | # * various built-in commands including «command», «set», and «ulimit».
39 | #
40 | # Important for patching:
41 | #
42 | # (2) This script targets any POSIX shell, so it avoids extensions provided
43 | # by Bash, Ksh, etc; in particular arrays are avoided.
44 | #
45 | # The "traditional" practice of packing multiple parameters into a
46 | # space-separated string is a well documented source of bugs and security
47 | # problems, so this is (mostly) avoided, by progressively accumulating
48 | # options in "$@", and eventually passing that to Java.
49 | #
50 | # Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
51 | # and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
52 | # see the in-line comments for details.
53 | #
54 | # There are tweaks for specific operating systems such as AIX, CygWin,
55 | # Darwin, MinGW, and NonStop.
56 | #
57 | # (3) This script is generated from the Groovy template
58 | # https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
59 | # within the Gradle project.
60 | #
61 | # You can find Gradle at https://github.com/gradle/gradle/.
62 | #
63 | ##############################################################################
64 |
65 | # Attempt to set APP_HOME
66 |
67 | # Resolve links: $0 may be a link
68 | app_path=$0
69 |
70 | # Need this for daisy-chained symlinks.
71 | while
72 | APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
73 | [ -h "$app_path" ]
74 | do
75 | ls=$( ls -ld "$app_path" )
76 | link=${ls#*' -> '}
77 | case $link in #(
78 | /*) app_path=$link ;; #(
79 | *) app_path=$APP_HOME$link ;;
80 | esac
81 | done
82 |
83 | APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
84 |
85 | APP_NAME="Gradle"
86 | APP_BASE_NAME=${0##*/}
87 |
88 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
89 | DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
90 |
91 | # Use the maximum available, or set MAX_FD != -1 to use that value.
92 | MAX_FD=maximum
93 |
94 | warn () {
95 | echo "$*"
96 | } >&2
97 |
98 | die () {
99 | echo
100 | echo "$*"
101 | echo
102 | exit 1
103 | } >&2
104 |
105 | # OS specific support (must be 'true' or 'false').
106 | cygwin=false
107 | msys=false
108 | darwin=false
109 | nonstop=false
110 | case "$( uname )" in #(
111 | CYGWIN* ) cygwin=true ;; #(
112 | Darwin* ) darwin=true ;; #(
113 | MSYS* | MINGW* ) msys=true ;; #(
114 | NONSTOP* ) nonstop=true ;;
115 | esac
116 |
117 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
118 |
119 |
120 | # Determine the Java command to use to start the JVM.
121 | if [ -n "$JAVA_HOME" ] ; then
122 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
123 | # IBM's JDK on AIX uses strange locations for the executables
124 | JAVACMD=$JAVA_HOME/jre/sh/java
125 | else
126 | JAVACMD=$JAVA_HOME/bin/java
127 | fi
128 | if [ ! -x "$JAVACMD" ] ; then
129 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
130 |
131 | Please set the JAVA_HOME variable in your environment to match the
132 | location of your Java installation."
133 | fi
134 | else
135 | JAVACMD=java
136 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
137 |
138 | Please set the JAVA_HOME variable in your environment to match the
139 | location of your Java installation."
140 | fi
141 |
142 | # Increase the maximum file descriptors if we can.
143 | if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
144 | case $MAX_FD in #(
145 | max*)
146 | MAX_FD=$( ulimit -H -n ) ||
147 | warn "Could not query maximum file descriptor limit"
148 | esac
149 | case $MAX_FD in #(
150 | '' | soft) :;; #(
151 | *)
152 | ulimit -n "$MAX_FD" ||
153 | warn "Could not set maximum file descriptor limit to $MAX_FD"
154 | esac
155 | fi
156 |
157 | # Collect all arguments for the java command, stacking in reverse order:
158 | # * args from the command line
159 | # * the main class name
160 | # * -classpath
161 | # * -D...appname settings
162 | # * --module-path (only if needed)
163 | # * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
164 |
165 | # For Cygwin or MSYS, switch paths to Windows format before running java
166 | if "$cygwin" || "$msys" ; then
167 | APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
168 | CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
169 |
170 | JAVACMD=$( cygpath --unix "$JAVACMD" )
171 |
172 | # Now convert the arguments - kludge to limit ourselves to /bin/sh
173 | for arg do
174 | if
175 | case $arg in #(
176 | -*) false ;; # don't mess with options #(
177 | /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
178 | [ -e "$t" ] ;; #(
179 | *) false ;;
180 | esac
181 | then
182 | arg=$( cygpath --path --ignore --mixed "$arg" )
183 | fi
184 | # Roll the args list around exactly as many times as the number of
185 | # args, so each arg winds up back in the position where it started, but
186 | # possibly modified.
187 | #
188 | # NB: a `for` loop captures its iteration list before it begins, so
189 | # changing the positional parameters here affects neither the number of
190 | # iterations, nor the values presented in `arg`.
191 | shift # remove old arg
192 | set -- "$@" "$arg" # push replacement arg
193 | done
194 | fi
195 |
196 | # Collect all arguments for the java command;
197 | # * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
198 | # shell script including quotes and variable substitutions, so put them in
199 | # double quotes to make sure that they get re-expanded; and
200 | # * put everything else in single quotes, so that it's not re-expanded.
201 |
202 | set -- \
203 | "-Dorg.gradle.appname=$APP_BASE_NAME" \
204 | -classpath "$CLASSPATH" \
205 | org.gradle.wrapper.GradleWrapperMain \
206 | "$@"
207 |
208 | # Use "xargs" to parse quoted args.
209 | #
210 | # With -n1 it outputs one arg per line, with the quotes and backslashes removed.
211 | #
212 | # In Bash we could simply go:
213 | #
214 | # readarray ARGS < <( xargs -n1 <<<"$var" ) &&
215 | # set -- "${ARGS[@]}" "$@"
216 | #
217 | # but POSIX shell has neither arrays nor command substitution, so instead we
218 | # post-process each arg (as a line of input to sed) to backslash-escape any
219 | # character that might be a shell metacharacter, then use eval to reverse
220 | # that process (while maintaining the separation between arguments), and wrap
221 | # the whole thing up as a single "set" statement.
222 | #
223 | # This will of course break if any of these variables contains a newline or
224 | # an unmatched quote.
225 | #
226 |
227 | eval "set -- $(
228 | printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
229 | xargs -n1 |
230 | sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
231 | tr '\n' ' '
232 | )" '"$@"'
233 |
234 | exec "$JAVACMD" "$@"
235 |
--------------------------------------------------------------------------------
/gradlew.bat:
--------------------------------------------------------------------------------
1 | @rem
2 | @rem Copyright 2015 the original author or authors.
3 | @rem
4 | @rem Licensed under the Apache License, Version 2.0 (the "License");
5 | @rem you may not use this file except in compliance with the License.
6 | @rem You may obtain a copy of the License at
7 | @rem
8 | @rem https://www.apache.org/licenses/LICENSE-2.0
9 | @rem
10 | @rem Unless required by applicable law or agreed to in writing, software
11 | @rem distributed under the License is distributed on an "AS IS" BASIS,
12 | @rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | @rem See the License for the specific language governing permissions and
14 | @rem limitations under the License.
15 | @rem
16 |
17 | @if "%DEBUG%" == "" @echo off
18 | @rem ##########################################################################
19 | @rem
20 | @rem Gradle startup script for Windows
21 | @rem
22 | @rem ##########################################################################
23 |
24 | @rem Set local scope for the variables with windows NT shell
25 | if "%OS%"=="Windows_NT" setlocal
26 |
27 | set DIRNAME=%~dp0
28 | if "%DIRNAME%" == "" set DIRNAME=.
29 | set APP_BASE_NAME=%~n0
30 | set APP_HOME=%DIRNAME%
31 |
32 | @rem Resolve any "." and ".." in APP_HOME to make it shorter.
33 | for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
34 |
35 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
36 | set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
37 |
38 | @rem Find java.exe
39 | if defined JAVA_HOME goto findJavaFromJavaHome
40 |
41 | set JAVA_EXE=java.exe
42 | %JAVA_EXE% -version >NUL 2>&1
43 | if "%ERRORLEVEL%" == "0" goto execute
44 |
45 | echo.
46 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
47 | echo.
48 | echo Please set the JAVA_HOME variable in your environment to match the
49 | echo location of your Java installation.
50 |
51 | goto fail
52 |
53 | :findJavaFromJavaHome
54 | set JAVA_HOME=%JAVA_HOME:"=%
55 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe
56 |
57 | if exist "%JAVA_EXE%" goto execute
58 |
59 | echo.
60 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
61 | echo.
62 | echo Please set the JAVA_HOME variable in your environment to match the
63 | echo location of your Java installation.
64 |
65 | goto fail
66 |
67 | :execute
68 | @rem Setup the command line
69 |
70 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
71 |
72 |
73 | @rem Execute Gradle
74 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
75 |
76 | :end
77 | @rem End local scope for the variables with windows NT shell
78 | if "%ERRORLEVEL%"=="0" goto mainEnd
79 |
80 | :fail
81 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
82 | rem the _cmd.exe /c_ return code!
83 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
84 | exit /b 1
85 |
86 | :mainEnd
87 | if "%OS%"=="Windows_NT" endlocal
88 |
89 | :omega
90 |
--------------------------------------------------------------------------------
/settings.gradle.kts:
--------------------------------------------------------------------------------
1 | pluginManagement {
2 | repositories {
3 | maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")
4 | google()
5 | gradlePluginPortal()
6 | mavenCentral()
7 | }
8 |
9 | plugins {
10 | kotlin("multiplatform").version(extra["kotlin.version"] as String)
11 | kotlin("plugin.compose").version(extra["kotlin.version"] as String)
12 | id("org.jetbrains.compose").version(extra["compose.version"] as String)
13 | }
14 | }
15 |
16 | rootProject.name = "falling-sand"
17 |
--------------------------------------------------------------------------------
/showcase.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/rock3r/sandbox-demo/86dca16ef6e66290200d41168239a91105be47e2/showcase.gif
--------------------------------------------------------------------------------
/src/commonMain/kotlin/App.kt:
--------------------------------------------------------------------------------
1 | import LookupResult.Empty
2 | import LookupResult.Occupied
3 | import LookupResult.OutOfBounds
4 | import androidx.compose.foundation.Canvas
5 | import androidx.compose.foundation.background
6 | import androidx.compose.foundation.clickable
7 | import androidx.compose.foundation.gestures.detectDragGestures
8 | import androidx.compose.foundation.layout.BoxScope
9 | import androidx.compose.foundation.layout.BoxWithConstraints
10 | import androidx.compose.foundation.layout.fillMaxSize
11 | import androidx.compose.foundation.layout.padding
12 | import androidx.compose.foundation.text.BasicText
13 | import androidx.compose.runtime.Composable
14 | import androidx.compose.runtime.LaunchedEffect
15 | import androidx.compose.runtime.MutableFloatState
16 | import androidx.compose.runtime.getValue
17 | import androidx.compose.runtime.mutableFloatStateOf
18 | import androidx.compose.runtime.mutableStateOf
19 | import androidx.compose.runtime.remember
20 | import androidx.compose.runtime.setValue
21 | import androidx.compose.ui.Alignment
22 | import androidx.compose.ui.Modifier
23 | import androidx.compose.ui.geometry.Offset
24 | import androidx.compose.ui.geometry.Size
25 | import androidx.compose.ui.graphics.Color
26 | import androidx.compose.ui.graphics.drawscope.DrawScope
27 | import androidx.compose.ui.input.pointer.PointerIcon
28 | import androidx.compose.ui.input.pointer.PointerInputChange
29 | import androidx.compose.ui.input.pointer.PointerInputScope
30 | import androidx.compose.ui.input.pointer.pointerHoverIcon
31 | import androidx.compose.ui.input.pointer.pointerInput
32 | import androidx.compose.ui.platform.LocalDensity
33 | import androidx.compose.ui.text.TextMeasurer
34 | import androidx.compose.ui.text.TextStyle
35 | import androidx.compose.ui.text.drawText
36 | import androidx.compose.ui.text.font.FontFamily
37 | import androidx.compose.ui.text.rememberTextMeasurer
38 | import androidx.compose.ui.unit.Dp
39 | import androidx.compose.ui.unit.DpSize
40 | import androidx.compose.ui.unit.IntOffset
41 | import androidx.compose.ui.unit.dp
42 | import androidx.compose.ui.unit.sp
43 | import androidx.compose.ui.unit.toOffset
44 | import kotlinx.coroutines.Dispatchers
45 | import kotlinx.coroutines.delay
46 | import kotlinx.coroutines.isActive
47 | import kotlinx.coroutines.launch
48 | import org.jetbrains.compose.ui.tooling.preview.Preview
49 | import kotlin.math.roundToInt
50 | import kotlin.random.Random
51 | import kotlin.time.Duration.Companion.seconds
52 |
53 | private const val DEBUG_DRAW = false
54 | private const val LOGGING = false
55 |
56 | @Composable
57 | fun app(cellSize: Int = 5) = BoxWithConstraints(Modifier.fillMaxSize()) {
58 | val widthPx = with(LocalDensity.current) { maxWidth.toPx().toInt() }
59 | val heightPx = with(LocalDensity.current) { maxHeight.toPx().toInt() }
60 | val cellSizePx = with(LocalDensity.current) { cellSize.dp.toPx() }
61 | val width = (widthPx / cellSizePx).toInt()
62 | val height = (heightPx / cellSizePx).toInt()
63 |
64 | LaunchedEffect(widthPx, heightPx) {
65 | println("Canvas size: $widthPx*$heightPx -> unit $cellSizePx, grid $width*$height")
66 | }
67 |
68 | Content(cellSize.dp, width, height, 60)
69 | }
70 |
71 | @Composable
72 | @Preview
73 | fun BoxScope.Content(unitSize: Dp, width: Int, height: Int, fps: Int) {
74 | var grid by remember(width, height) { mutableStateOf(createEmptyGrid(width, height)) }
75 |
76 | LaunchedEffect(width, height) {
77 | if (LOGGING) {
78 | println(
79 | "Initialised grid: ${grid.size}*${grid.first().size} " +
80 | "(lastIndices: ${grid.lastIndex}*${grid.first().lastIndex})"
81 | )
82 | }
83 | }
84 |
85 | // This is the core simulation loop
86 | LaunchedEffect(Unit) {
87 | launch(Dispatchers.Default) {
88 | while (isActive) {
89 | grid = doSimulation(grid)
90 | delay((1.0 / fps).seconds)
91 | }
92 | }
93 | }
94 |
95 | val measurer = rememberTextMeasurer()
96 | val hue = remember { mutableFloatStateOf(0f) }
97 | Canvas(
98 | modifier =
99 | Modifier.fillMaxSize().background(Color.White).pointerInput(Unit) {
100 | detectDragGestures { change, dragAmount ->
101 | handleDrag(change, dragAmount, unitSize, width, height, grid, hue)
102 | }
103 | }
104 | ) {
105 | if (DEBUG_DRAW) {
106 | drawDebugGridBounds(width, height, unitSize)
107 | }
108 |
109 | for ((x, column) in grid.withIndex()) {
110 | if (DEBUG_DRAW) {
111 | drawDebugColumn(x, unitSize, height, measurer)
112 | }
113 |
114 | for ((y, grain) in column.withIndex()) {
115 | if (DEBUG_DRAW) {
116 | drawDebugRow(y, unitSize, width, measurer)
117 | }
118 |
119 | if (grain == null) continue
120 | val topLeft = Offset(grain.x * unitSize.toPx(), grain.y * unitSize.toPx())
121 | drawRect(
122 | color = grain.color,
123 | topLeft = topLeft,
124 | size = DpSize(unitSize, unitSize).toSize()
125 | )
126 |
127 | if (LOGGING) {
128 | println("Grain ${grain.id} drawn at $topLeft")
129 | }
130 |
131 | if (DEBUG_DRAW) {
132 | // Draw grain ID on top of the grain
133 | drawText(
134 | measurer,
135 | grain.id.toString(),
136 | (grain.position.toOffset() * unitSize.toPx()) + Offset(2f, 2f),
137 | TextStyle.Default.copy(
138 | color = Color.Red,
139 | fontSize = 10.sp,
140 | fontFamily = FontFamily.Monospace,
141 | background = Color.White,
142 | )
143 | )
144 | }
145 | }
146 | }
147 | }
148 |
149 | BasicText(
150 | "Click here to clear",
151 | Modifier.padding(16.dp)
152 | .align(Alignment.TopEnd)
153 | .clickable { grid = createEmptyGrid(width, height) }
154 | .pointerHoverIcon(PointerIcon.Hand),
155 | TextStyle.Default.copy(color = Color.Gray, fontSize = 14.sp)
156 | )
157 | }
158 |
159 | private fun PointerInputScope.handleDrag(
160 | change: PointerInputChange,
161 | dragAmount: Offset,
162 | unitSize: Dp,
163 | width: Int,
164 | height: Int,
165 | grid: Array>,
166 | hue: MutableFloatState,
167 | ) {
168 | var startX = change.position.x.roundToInt()
169 | var startY = change.position.y.roundToInt()
170 | var endX = startX + dragAmount.x.toInt()
171 | var endY = startY + dragAmount.y.toInt()
172 |
173 | if (startX > endX) {
174 | val tmp = endX
175 | endX = startX
176 | startX = tmp
177 | }
178 |
179 | if (startY > endY) {
180 | val tmp = endY
181 | endY = startY
182 | startY = tmp
183 | }
184 |
185 | for (x in startX..endX) {
186 | for (y in startY..endY) {
187 | addGrain(
188 | Offset(x.toFloat(), y.toFloat()),
189 | unitSize,
190 | width,
191 | height,
192 | grid,
193 | hue.value,
194 | )
195 |
196 | hue.value += .005f
197 | if (hue.value > 360f) hue.value = 0f
198 | }
199 | }
200 | change.consume()
201 | }
202 |
203 | private fun PointerInputScope.addGrain(
204 | offset: Offset,
205 | unitSize: Dp,
206 | width: Int,
207 | height: Int,
208 | grid: Array>,
209 | hue: Float
210 | ) {
211 | val x = (offset.x / unitSize.toPx()).toInt()
212 | if (x !in 0 until width) return
213 |
214 | val y = (offset.y / unitSize.toPx()).toInt()
215 | if (y !in 0 until height) return
216 |
217 | val grain = grid[x][y]
218 | if (grain == null) {
219 | val newGrain = Grain(IntOffset(x, y), Color.hsv(hue, 1f, 1f))
220 | if (LOGGING) println("Adding grain $newGrain")
221 | grid[x][y] = newGrain
222 | }
223 | }
224 |
225 | private fun DrawScope.drawDebugRow(y: Int, unitSize: Dp, width: Int, measurer: TextMeasurer) {
226 | val yPx = y * unitSize.toPx()
227 | drawLine(
228 | if (y % 10 == 0) Color.DarkGray else Color.Gray,
229 | Offset(0f, yPx),
230 | Offset(width * unitSize.toPx(), yPx)
231 | )
232 | drawText(
233 | measurer,
234 | y.toString(),
235 | Offset(0f, yPx),
236 | TextStyle.Default.copy(color = Color.Gray, fontSize = 9.sp),
237 | size = Size(2 * unitSize.toPx(), unitSize.toPx())
238 | )
239 | }
240 |
241 | private fun DrawScope.drawDebugColumn(x: Int, unitSize: Dp, height: Int, measurer: TextMeasurer) {
242 | val xPx = x * unitSize.toPx()
243 | drawLine(
244 | if (x % 10 == 0) Color.DarkGray else Color.Gray,
245 | Offset(xPx, 0f),
246 | Offset(xPx, height * unitSize.toPx())
247 | )
248 | drawText(
249 | measurer,
250 | x.toString(),
251 | Offset(xPx, 0f),
252 | TextStyle.Default.copy(color = Color.Gray, fontSize = 9.sp),
253 | size = Size(unitSize.toPx(), unitSize.toPx())
254 | )
255 | }
256 |
257 | private fun DrawScope.drawDebugGridBounds(width: Int, height: Int, unitSize: Dp) {
258 | // Draw the background of the floor (last row)
259 | drawRect(
260 | Color.Red.copy(.5f),
261 | Offset(0f, (height - 1) * unitSize.toPx()),
262 | Size(width * unitSize.toPx(), unitSize.toPx())
263 | )
264 |
265 | // Draw the background of the left-hand wall (first column)
266 | drawRect(
267 | Color.Green.copy(.25f),
268 | Offset(0f, 0f),
269 | Size(unitSize.toPx(), height * unitSize.toPx())
270 | )
271 |
272 | // Draw the background of the right-hand wall (last column)
273 | drawRect(
274 | Color.Green.copy(.25f),
275 | Offset((width - 1) * unitSize.toPx(), 0f),
276 | Size(unitSize.toPx(), height * unitSize.toPx())
277 | )
278 |
279 | // Draw line at left wall (before first column)
280 | drawLine(Color.Blue, Offset(0f, 0f), Offset(0f, height * unitSize.toPx()), 3.dp.toPx())
281 |
282 | // Draw line at right wall (after last column)
283 | drawLine(
284 | Color.Blue,
285 | Offset(width * unitSize.toPx(), 0f),
286 | Offset(width * unitSize.toPx(), height * unitSize.toPx()),
287 | 3.dp.toPx()
288 | )
289 |
290 | // Draw line at the floor (below last row)
291 | drawLine(
292 | Color.Red,
293 | Offset(0f, height * unitSize.toPx()),
294 | Offset(width * unitSize.toPx(), height * unitSize.toPx()),
295 | 3.dp.toPx()
296 | )
297 | }
298 |
299 | private var id: Int = 0
300 |
301 | private fun nextId(): Int = ++id
302 |
303 | private data class Grain(
304 | var position: IntOffset,
305 | var color: Color,
306 | var age: Int = 0,
307 | var active: Boolean = true,
308 | val id: Int = nextId()
309 | ) {
310 | var x: Int
311 | get() = position.x
312 | set(value) {
313 | position = position.copy(x = value)
314 | }
315 |
316 | var y: Int
317 | get() = position.y
318 | set(value) {
319 | position = position.copy(y = value)
320 | }
321 | }
322 |
323 | private fun doSimulation(grid: Array>): Array> {
324 | val width = grid.size
325 | val height = grid[0].size
326 | val newGrid = createEmptyGrid(width, height)
327 | val maxY = height - 1
328 |
329 | for (row in grid) {
330 | for (grain in row) {
331 | if (grain == null) continue
332 |
333 | val x = grain.position.x
334 | val y = grain.position.y
335 | if (!grain.active) {
336 | newGrid[x][y] = grain
337 | continue
338 | }
339 |
340 | grain.age++
341 |
342 | val newY = y + 1 // TODO Increase based on grain.age
343 | val deltaX = if (Random.nextBoolean()) 1 else -1
344 |
345 | val lookupBelow = grid.lookup(x, newY)
346 | val lookupPlusDelta = grid.lookup(x + deltaX, newY)
347 | val lookupMinusDelta = grid.lookup(x - deltaX, newY)
348 |
349 | if (lookupBelow is Empty) {
350 | grain.y = newY
351 | } else if (lookupPlusDelta is Empty) {
352 | grain.x = x + deltaX
353 | grain.y = newY
354 | } else if (lookupMinusDelta is Empty) {
355 | grain.x = x - deltaX
356 | grain.y = newY
357 | }
358 |
359 | if (newY == maxY) {
360 | grain.active = false
361 | if (LOGGING) println("Grain ${grain.id} reached the bottom ($maxY)")
362 | }
363 |
364 | if (LOGGING) println("Updated grain $grain")
365 | newGrid[grain.x][grain.y] = grain
366 | }
367 | }
368 |
369 | return newGrid
370 | }
371 |
372 | private fun createEmptyGrid(width: Int, height: Int) = Array(width) { arrayOfNulls(height) }
373 |
374 | private inline fun Array>.lookup(x: Int, y: Int): LookupResult {
375 | if (x < 0 || x > lastIndex) return OutOfBounds
376 | if (y < 0 || y > first().lastIndex) return OutOfBounds
377 |
378 | return if (this[x][y] != null) Occupied else Empty
379 | }
380 |
381 | private sealed interface LookupResult {
382 | data object Empty : LookupResult
383 |
384 | data object Occupied : LookupResult
385 |
386 | data object OutOfBounds : LookupResult
387 | }
388 |
--------------------------------------------------------------------------------
/src/jvmMain/kotlin/Main.kt:
--------------------------------------------------------------------------------
1 | import androidx.compose.ui.Alignment
2 | import androidx.compose.ui.window.Window
3 | import androidx.compose.ui.window.WindowPosition
4 | import androidx.compose.ui.window.application
5 | import androidx.compose.ui.window.rememberWindowState
6 |
7 | fun main() = application {
8 | val state = rememberWindowState(position = WindowPosition.Aligned(Alignment.Center))
9 | Window(
10 | title = "Sandbox",
11 | onCloseRequest = ::exitApplication,
12 | resizable = false,
13 | state = state,
14 | ) {
15 | app()
16 | }
17 | }
18 |
--------------------------------------------------------------------------------
/src/wasmJsMain/kotlin/Main.kt:
--------------------------------------------------------------------------------
1 |
2 | import androidx.compose.ui.ExperimentalComposeUiApi
3 | import androidx.compose.ui.window.CanvasBasedWindow
4 |
5 | @OptIn(ExperimentalComposeUiApi::class)
6 | fun main() {
7 | CanvasBasedWindow("Falling sand") {
8 | app()
9 | }
10 | }
11 |
--------------------------------------------------------------------------------
/src/wasmJsMain/resources/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | Falling sand
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
--------------------------------------------------------------------------------