Learning_opencv-pygame

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #machine-learning #linux #docker #java #cli #kubernetes #security #pytorch #mcp #ios

Learning_opencv-pygame

(★ 9)

My notebooks

Learning_opencv-pygame Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Learning OpenCV & Pygame

Two beginner-friendly Python projects exploring computer vision and 2D game development:

1. **Object Joystick** — turn any colored object into a virtual keyboard controller using your webcam.
2. **Space Invaders** — a classic arcade clone built with Pygame.

---

## 1. Object Joystick (`Object-joystick/`)

A computer-vision-based "air joystick". Hold a colored object (e.g., a red cap or green marker) in front of your webcam and move it left / right / up / down — the script detects the motion and emits the corresponding arrow-key press to your operating system. Useful as a hands-free input device for any game or app that responds to arrow keys.

### How it works

1. **HSV tuning UI** — sliders let you live-tune the color range to match your object under your lighting (since RGB is sensitive to brightness, the script works in HSV color space).
2. **Detection** — for each frame: blur → HSV mask → erode/dilate to clean noise → contour detection.
3. **Motion tracking** — keeps a 20-frame history of the object's centroid using a `deque`. When the centroid shifts more than 100 px horizontally or 80 px vertically across 10 frames, the script identifies the dominant direction.
4. **Keystroke emission** — uses the `keyboard` library to fire `Left` / `Right` / `Up` / `Down` keypresses, so any game listening for arrow keys can be controlled hands-free.

### Running

```bash
pip install opencv-python numpy imutils keyboard
cd Object-joystick
python controller.py
```

1. The first window lets you adjust the HSV thresholds until only your colored object is visible in the mask.
2. Press `Esc` to close the tuning window — tracking starts immediately.
3. Move your object; the detected direction is overlaid on the video feed and sent as keystrokes.

> **Note:** The `keyboard` library on Linux/macOS may require root/sudo. On Windows it works out of the box.

---

## 2. Space Invaders (`spaceinvader/`)

A Pygame clone of the arcade classic. Move the ship with arrow keys, fire with `Space`, destroy 6 randomly-spawned enemies that descend the screen. Each hit increments your score; if any enemy reaches the bottom, it's game over.

### Features

- 6 enemies with randomized starting positions
- Collision detection (squared-distance check, no `sqrt` for speed)
- Sound effects: laser fire, explosion on hit, looping background music
- On-screen score counter and game-over banner
- `X_FACTOR` constant lets you scale game speed for slower / faster machines

### Running

```bash
pip install pygame
cd spaceinvader
python main.py
```

| Key | Action |
|---|---|
| ← / → | Move ship |
| Space | Fire bullet |
| Window close | Quit |

### File structure

```
spaceinvader/
├── main.py           # game loop
├── ship.png          # player sprite
├── spaceship.png     # window icon
├── enemy.ico         # enemy sprite
├── bullet.png        # bullet sprite
├── background.jpg    # background image
├── background.wav    # looping music
├── laser.wav         # bullet-fire SFX
└── explosion.wav     # enemy-hit SFX
```

---

## Why these projects?

These were my first real explorations into:

- **OpenCV** — frame capture, color spaces, contour detection, morphological operations.
- **Pygame** — sprite rendering, event loops, collision detection, audio mixing.

If you're picking up either library, the code is short, commented, and fully self-contained — feel free to fork and tinker.

## License

MIT — see [`LICENSE`](LICENSE) if present, otherwise free to use, modify, and share.

Learning_opencv-pygame

Learning_opencv-pygame Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Learning_opencv-pygame

Learning_opencv-pygame Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README