Add comprehensive reference examples for all Sprite public methods

[Copilot]

This PR implements a complete set of reference examples for all public methods in the Sprite class, following the existing pattern established by AnimatedSpriteAddAnimation.

Problem

The src/examples/java/reference directory was missing examples for many Sprite public methods. While some methods like SpriteAddCostume, SpriteMove, and SpriteSay had examples, dozens of other public methods lacked demonstration code, making it harder for users to understand how to use the full API.

Solution

Added 45 new examples covering all previously missing Sprite public methods:

Examples Added

• Movement & Navigation: SpriteGoToRandomPosition, SpriteGoToMousePointer, SpriteGoToSprite, SpritePointInDirection, SpritePointTowardsSprite
• Size & Appearance: SpriteSetWidth, SpriteSetHeight, SpriteChangeSize, SpriteGetSize, SpriteGetTint, SpriteGetTransparency
• Position Management: SpriteChangePosition, SpriteGetPosition, SpriteGetMouseX, SpriteGetMouseY
• Costume Features: SpriteAddCostumes (spritesheet support), SpritePreviousCostume, SpriteSetNineSlice, SpriteDisableNineSlice
• Collision Detection: SpriteGetTouchingSprite, SpriteGetTouchingSprites, SpriteGetHitbox, SpriteDisableHitbox, SpriteEnableHitbox
• Sound Management: SpriteStopSound, SpriteIsSoundPlaying
• Stamping Operations: SpriteStampToBackground, SpriteStampToUI, SpriteStampToForeground
• Time & Date Access: SpriteGetCurrentYear, SpriteGetCurrentMonth, SpriteGetCurrentDay, SpriteGetCurrentHour, SpriteGetCurrentMinute, SpriteGetCurrentSecond, SpriteGetDaysSince2000
• Utility Methods: SpriteClone, SpriteRemove, SpriteGetStage, SpriteGetWindow, SpriteGetText, SpriteIsUI, SpriteRemoveTimer
• Event Handlers: SpriteSetRun, SpriteSetWhenIReceive, SpriteSetWhenMouseClicked (package-based examples)

Implementation Details

• Consistent Pattern: All examples follow the established convention using GifRecorder for visual output
• Two Formats:
  • Simple methods use single-file examples (SpriteMethodName.java)
  • Complex event handlers use package-based examples (SpriteMethodName/MySprite.java, MyStage.java, MyWindow.java)
• Educational Focus: Each example demonstrates the specific method clearly with minimal, focused code
• Asset Reuse: Leverages existing assets like zeta_green_badge.png, gamma_purple_badge.png, and bump.wav

Example Usage

// Simple movement example
Sprite gamma = new Sprite("gamma", "assets/gamma_purple_badge.png");
gamma.goToRandomPosition(); // Now has a clear example

// Collision detection example  
Sprite touching = gamma.getTouchingSprite(Sprite.class);
if (touching != null) {
    gamma.say("Found touching sprite!");
}

// Event handler example
sprite.setWhenIReceive((s, message) -> {
    s.say("Received: " + message);
});

This provides complete API coverage, making it easier for developers to learn and use all Sprite functionality available in Scratch for Java.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• jogamp.org
  • Triggering command: /usr/lib/jvm/temurin-17-jdk-amd64/bin/java --enable-native-access=ALL-UNNAMED -classpath /usr/share/apache-maven-3.9.11/boot/plexus-classworlds-2.9.0.jar -Dclassworlds.conf=/usr/share/apache-maven-3.9.11/bin/m2.conf -Dmaven.home=/usr/share/apache-maven-3.9.11 -Dlibrary.jansi.path=/usr/share/apache-maven-3.9.11/lib/jansi-native -Dmaven.multiModuleProjectDirectory=/home/REDACTED/work/scratch-for-java/scratch-for-java org.codehaus.plexus.classworlds.launcher.Launcher compile -q (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
scratch-for-java-ba8s	Error			Sep 6, 2025 9:45am

[mikebarkmin]

Please use a new package for each one and in that a three file structure

MyWindow, MyStage and MySprite.java

[mikebarkmin]

Please move all examples which do not use a package to a package with the three files MyWindow MyStage and MySprite.