Compare commits
4 Commits
e9c939f033
...
crablang
| Author | SHA1 | Date | |
|---|---|---|---|
| 8d5a106ab3 | |||
| 4e7c53d79f | |||
| bb2b60de5b | |||
| 1159868e15 |
60
README.md
60
README.md
@@ -2,6 +2,8 @@
|
||||
|
||||
A fullscreen splash-screen wrapper for launching a game or app. It displays an image (or a fallback black screen), starts your executable, and closes when the process exits or loses focus after launch.
|
||||
|
||||
https://github.com/user-attachments/assets/22da49b4-0f1f-4208-8d0b-9eeef14e35e5
|
||||
|
||||
## Features
|
||||
|
||||
1. Fullscreen, borderless splash screen with hidden cursor (SDL2)
|
||||
@@ -39,6 +41,36 @@ sudo make install
|
||||
DESTDIR=/some/staging/path make install
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
gsplash <image_or_video_path> <game_executable> [game_arguments...]
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
gsplash assets/splash.jpg /path/to/game --fullscreen --profile=default
|
||||
|
||||
# Video splash (supported formats depend on ffmpeg build)
|
||||
gsplash assets/splash.mp4 /path/to/game --fullscreen --profile=default
|
||||
```
|
||||
|
||||
Gsplash allows you to configure how the image or video is displayed with 3 modes:
|
||||
|
||||
- `center` (default): letterbox
|
||||
- `crop`: fill screen by cropping
|
||||
- `stretch`: Distort to fill screen
|
||||
|
||||
You can set these by using the `-m` or `--mode` flag:
|
||||
|
||||
```bash
|
||||
build/gsplash [--mode=stretch|center|crop] <background> <executable> [args...]
|
||||
|
||||
build/gsplash -m stretch|center|crop <background> <executable> [args...]
|
||||
```
|
||||
|
||||
|
||||
## Testing
|
||||
|
||||
Gsplash includes several testing utilities to ensure proper functionality without requiring a heavy game binary.
|
||||
@@ -71,31 +103,3 @@ For manual testing, a `dummy_game` binary is built alongside `gsplash`. It mimic
|
||||
./build/gsplash path/to/image.png ./build/dummy_game 10
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
gsplash <image_or_video_path> <game_executable> [game_arguments...]
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
gsplash assets/splash.jpg /path/to/game --fullscreen --profile=default
|
||||
|
||||
# Video splash (supported formats depend on ffmpeg build)
|
||||
gsplash assets/splash.mp4 /path/to/game --fullscreen --profile=default
|
||||
```
|
||||
|
||||
Gsplash allows you to configure how the image or video is displayed with 3 modes:
|
||||
|
||||
- `center` (default): letterbox
|
||||
- `crop`: fill screen by cropping
|
||||
- `stretch`: Distort to fill screen
|
||||
|
||||
You can set these by using the `-m` or `--mode` flag:
|
||||
|
||||
```bash
|
||||
build/gsplash [--mode=stretch|center|crop] <background> <executable> [args...]
|
||||
|
||||
build/gsplash -m stretch|center|crop <background> <executable> [args...]
|
||||
```
|
||||
BIN
docs/assets/demo.mp4
Normal file
BIN
docs/assets/demo.mp4
Normal file
Binary file not shown.
Reference in New Issue
Block a user