From 7f2b121005a6ab7e5ec7e12e8db705274cd965c7 Mon Sep 17 00:00:00 2001 From: EnterpriseGoose <58440950+EnterpriseGoose@users.noreply.github.com> Date: Thu, 21 Nov 2024 13:20:07 -0500 Subject: [PATCH 1/3] Update submission criteria to be more specific Add more details on what constitutes too much overlap and how the entire fill option is not supported (not just colored fills). --- docs/SUBMISSION_CRITERIA.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/SUBMISSION_CRITERIA.md b/docs/SUBMISSION_CRITERIA.md index 591e57e02..b245ec342 100644 --- a/docs/SUBMISSION_CRITERIA.md +++ b/docs/SUBMISSION_CRITERIA.md @@ -35,10 +35,10 @@ Make your own art! - **Your artwork must be generative.** You should have some variables at the top that are controlled by randomness functions such as `bt.randIntInRange()` that change the artwork -- **Your artwork should be drawable by Blot**, which means it shouldn't excessively cross a certain area multiple times +- **Your artwork should be drawable by Blot**, which means it shouldn't excessively cross a certain area multiple times. The general guideline is that crossing over one point any more than 5 times will rip the paper. -- **Your artwork should not rely on color.** Unfortunately, Blot doesn't have multi-color capabilities yet. Maybe you can be the first to add it! +- **Your artwork should not rely on the fill option.** (This includes color or filling with black) Unfortunately, Blot doesn't understand the fill option yet. Maybe you can be the first to add it! In the mean time, you can use thin stripes to effectively shade an area. ## Submitting If you feel like your art piece meets these requirements, you can find the submission instructions **[here.](https://github.com/hackclub/blot/blob/main/docs/GET_A_BLOT.md)** -Most artwork takes around 15-20 hours of work to get accepted, so make sure you really polish it before submitting. \ No newline at end of file +Most artwork takes around 15-20 hours of work to get accepted, so make sure you really polish it before submitting. From 0a9a84f0bc7dd860b5ad394ada3ee22c71b8cd9d Mon Sep 17 00:00:00 2001 From: EnterpriseGoose <58440950+EnterpriseGoose@users.noreply.github.com> Date: Thu, 21 Nov 2024 13:32:07 -0500 Subject: [PATCH 2/3] Update ASSEMBLY.md Made various changes: - Some steps I found when I was building the blot were mistyped or missing - Added a couple debugging tips so people can learn from my failures --- docs/assembly/ASSEMBLY.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/assembly/ASSEMBLY.md b/docs/assembly/ASSEMBLY.md index 36d006554..a2dfba179 100644 --- a/docs/assembly/ASSEMBLY.md +++ b/docs/assembly/ASSEMBLY.md @@ -192,7 +192,7 @@ And these tools: - __1 x__ 2.5mm allen key - __1 x__ 2mm allen key -We'll start by placing the timing belt pulley on to the shaft of the stepper motor. +We'll start by placing the timing belt pulley on to the shaft of the stepper motor. The top of the pulley should be flush with the top of the shaft. ![PXL_20240613_153208987.jpg](./assets/PXL_20240613_153208987.jpg) @@ -210,12 +210,14 @@ Secure the motor in place with the M3x10mm screws. ![PXL_20240613_153027084.jpg](./assets/PXL_20240613_153027084.jpg) -Place the rubber feet on the motor. +Place the rubber feet on the leg. ![Screenshot 2024-06-14 at 4.55.06 PM.png](./assets/Screenshot%202024-06-14%20at%204.55.06%20PM.png) ![PXL_20240613_153004363.jpg](./assets/PXL_20240613_153004363.jpg) +Repeat this for the other leg. + We're done! ### Pen Rail @@ -517,11 +519,11 @@ The first step to running your Blot is to flash the Blot firmware to the Xiao. [You can download the firmware here.](https://github.com/hackclub/blot/raw/main/hardware/motor-control-board/firmware/uf2/firmware.ino.uf2) -First hold down the boot button (right button with a small `B` next to it) on your Xiao and then plug it into your computer. +First hold down the boot button (right button with a small `B` next to it) on your Xiao and then plug it into your computer while still holding the button. -It should appear as a drive. +It should appear as a drive, at which point you can release the button. If it doesn't appear, try again until it appears. Next drop the firmware `.uf2` file onto drive. @@ -531,6 +533,8 @@ __Connecting__ To power the Blot plug it into the USB-C brick that comes with your machine. Any USB-C brick that can deliver at least 20W should work. The Blot expects 9V 1A. +Flip the power switch on the board to turn the Blot on. + ![PXL_20240710_153733136.jpg](./assets/PXL_20240710_153733136.jpg) Connect your Blot to the web editor by plugging the Xiao in over USB. @@ -670,6 +674,8 @@ Your Blot can draw quite precisely, poor performance is often due to: - Machine improperly homed. + - Ensure that your blot is all the way in the correct corner when you press set origin. Then ensure your blot starts in that same corner when you run your project. + - Paper sliding. - To secure the paper you can place one end beneath the Blot. From 22a8f91106be471c199cf10a2354f2a96705c96e Mon Sep 17 00:00:00 2001 From: EnterpriseGoose <58440950+EnterpriseGoose@users.noreply.github.com> Date: Thu, 21 Nov 2024 13:34:49 -0500 Subject: [PATCH 3/3] Update PULL_REQUEST_TEMPLATE.md Specify that it's not only color, but also the fill option as a whole that doesn't work on blot. --- .github/PULL_REQUEST_TEMPLATE.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index db8c95286..0dbc283a4 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -7,12 +7,12 @@ Next, make sure you go through **each item** in the following checklist. Delete - [ ] I am submitting art that... - [ ] is algorithmically generated (will meaningfully change each time the program is run) - [ ] is your own work that is not copied from somewhere else - - [ ] is drawable through the editor(does not use outside tools) + - [ ] is drawable through the editor (does not use outside tools) - [ ] doesn't call `Math.random()` (See the documentation on [randomness](https://github.com/hackclub/blot/blob/main/public/TOOLKIT.md#randomness)) - - [ ] is drawable on Blot itself (doesn't have lines overlap more than 5 times) + - [ ] is drawable on Blot itself - [ ] Doesn't overlap lines more than 5 times - [ ] Fits in the working area of 125x125mm - - [ ] Doesn't rely on colour to look good + - [ ] Doesn't rely on color or the fill option to look good (and has a toggle if you do use it) If you used based your art on something else, used a tutorial, or remixed it from something else, please link it here: