Skip to content

Add headless flag for build.sh & update to raylib 6.0 #556

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Archizzle wants to merge 7 commits into
base: 4.0
Choose a base branch
from
Open

Add headless flag for build.sh & update to raylib 6.0 #556

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
3a35197
add headless flag for build.sh
Archizzle May 9, 2026
9719b45
fix syntax for DrawCircleGradient in go and checkers envs
Archizzle May 9, 2026
82d85c4
hide verbose warnings of raylib compilation for memory/headless backend
Archizzle May 18, 2026
03778a4
add --save-frames and --gif-path for exporting frames
Archizzle May 19, 2026
6a3087b
remove exporting individual frames to directory. add ffmpeg support f…
Archizzle May 19, 2026
a011383
uncap render speed for headless backend.
Archizzle May 19, 2026
30103dd
print progress for headless rendering
Archizzle May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
137 changes: 105 additions & 32 deletions build.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,18 +10,21 @@ set -e
# ./build.sh breakout --fast # Standalone executable (optimized)
# ./build.sh breakout --web # Emscripten web build
# ./build.sh breakout --profile # Kernel profiling binary
# ./build.sh breakout --headless # Use raylib 6.0 PLATFORM_MEMORY software renderer
# ./build.sh all # Build all envs with default and --float

if [ -z "$1" ]; then
echo "Usage: ./build.sh ENV_NAME [--float] [--debug] [--local|--fast|--web|--profile|--cpu|--all]"
echo "Usage: ./build.sh ENV_NAME [--float] [--headless] [--debug] [--local|--fast|--web|--profile|--cpu|--all]"
exit 1
fi
ENV=$1
shift

HEADLESS=0
for arg in "$@"; do
case $arg in
--float) PRECISION="-DPRECISION_FLOAT" ;;
--headless) HEADLESS=1 ;;
--debug) DEBUG=1 ;;
--local) MODE=local ;;
--fast) MODE=fast ;;
Expand Down Expand Up @@ -50,22 +53,60 @@ if [ "$ENV" = "all" ]; then
exit 0
fi

RAYLIB_VERSION="6.0"
RAYLIB_RELEASE_PATH="6.0"

has_lib() {
printf 'int main(void) { return 0; }\n' | ${CC:-cc} -x c - -o /tmp/pufferlib_libcheck "$1" >/dev/null 2>&1
}

append_if_lib_exists() {
local lib=$1
if has_lib "$lib"; then
RAYLIB_DESKTOP_LINUX_LIBS+=("$lib")
fi
}

# Linux/mac
PLATFORM="$(uname -s)"
if [ "$PLATFORM" = "Linux" ]; then
RAYLIB_NAME='raylib-5.5_linux_amd64'
RAYLIB_NAME="raylib-${RAYLIB_VERSION}_linux_amd64"
OMP_LIB=-lomp5
SANITIZE_FLAGS=(-fsanitize=address,undefined,bounds,pointer-overflow,leak -fno-omit-frame-pointer)
STANDALONE_LDFLAGS=(-lGL)
SHARED_LDFLAGS=(-Bsymbolic-functions)
RAYLIB_DESKTOP_LINUX_LIBS=(-ldl)
append_if_lib_exists -lGL
append_if_lib_exists -lX11
append_if_lib_exists -lXrandr
append_if_lib_exists -lXinerama
append_if_lib_exists -lXi
append_if_lib_exists -lXcursor
STANDALONE_LDFLAGS=("${RAYLIB_DESKTOP_LINUX_LIBS[@]}")
SHARED_LDFLAGS=(-Bsymbolic-functions "${RAYLIB_DESKTOP_LINUX_LIBS[@]}")
else
RAYLIB_NAME='raylib-5.5_macos'
RAYLIB_NAME="raylib-${RAYLIB_VERSION}_macos"
OMP_LIB=-lomp
SANITIZE_FLAGS=()
STANDALONE_LDFLAGS=(-framework Cocoa -framework IOKit -framework CoreVideo -framework OpenGL)
SHARED_LDFLAGS=(-framework Cocoa -framework OpenGL -framework IOKit -undefined dynamic_lookup)
fi

RAYLIB_PLATFORM="-DPLATFORM_DESKTOP"
RAYLIB_LINK_LDFLAGS=("${STANDALONE_LDFLAGS[@]}")
if [ "$HEADLESS" = "1" ]; then
if [ "$MODE" = "web" ]; then
echo "Error: --headless is not compatible with --web"
exit 1
fi
RAYLIB_NAME="raylib-${RAYLIB_VERSION}_memory"
RAYLIB_PLATFORM="-DPLATFORM_MEMORY"
RAYLIB_LINK_LDFLAGS=()
if [ "$PLATFORM" = "Linux" ]; then
SHARED_LDFLAGS=(-Bsymbolic-functions)
else
SHARED_LDFLAGS=(-undefined dynamic_lookup)
fi
fi

CLANG_WARN=(
-Wall
-ferror-limit=3
Expand All @@ -81,21 +122,60 @@ download() {
[ -d "$name" ] && return
echo "Downloading $name..."
case "$url" in
*.zip) curl -sL "$url" -o "$name.zip" && unzip -q "$name.zip" && rm "$name.zip" ;;
*) curl -sL "$url" -o "$name.tar.gz" && tar xf "$name.tar.gz" && rm "$name.tar.gz" ;;
*.zip) curl -fsL "$url" -o "$name.zip" && unzip -q "$name.zip" && rm "$name.zip" ;;
*) curl -fsL "$url" -o "$name.tar.gz" && tar xf "$name.tar.gz" && rm "$name.tar.gz" ;;
esac
}

RAYLIB_URL="https://github.com/raysan5/raylib/releases/download/5.5"
if [ "$MODE" = "web" ]; then
RAYLIB_NAME='raylib-5.5_webassembly'
download "$RAYLIB_NAME" "$RAYLIB_URL/$RAYLIB_NAME.zip"
build_raylib_from_source() {
local name=$1 platform=$2
if [ ! -d "$name" ]; then
echo "Downloading raylib ${RAYLIB_VERSION} source for $platform..."
curl -fsL "$RAYLIB_SOURCE_URL" -o "$name.tar.gz"
tar xf "$name.tar.gz"
rm "$name.tar.gz"
mv "raylib-${RAYLIB_RELEASE_PATH}" "$name"
fi
if [ ! -f "$name/src/libraylib.a" ] || [ ! -f "$name/src/.pufferlib_pic" ]; then
echo "Building raylib ${RAYLIB_VERSION} $platform..."
make -C "$name/src" clean >/dev/null 2>&1 || true
local custom_cflags="-fPIC"
if [ "$platform" = "PLATFORM_MEMORY" ]; then
custom_cflags="$custom_cflags -Wno-unused-label -Wno-unused-variable"
fi
make -C "$name/src" PLATFORM="$platform" RAYLIB_BUILD_MODE=RELEASE CUSTOM_CFLAGS="$custom_cflags"
touch "$name/src/.pufferlib_pic"
fi
}

RAYLIB_URL="https://github.com/raysan5/raylib/releases/download/${RAYLIB_RELEASE_PATH}"
RAYLIB_SOURCE_URL="https://github.com/raysan5/raylib/archive/refs/tags/${RAYLIB_RELEASE_PATH}.tar.gz"
if [ "$HEADLESS" = "1" ]; then
build_raylib_from_source "$RAYLIB_NAME" PLATFORM_MEMORY
RAYLIB_A="$RAYLIB_NAME/src/libraylib.a"
INCLUDES=(-I./$RAYLIB_NAME/src -I./$RAYLIB_NAME/src/external -I./src -I./vendor)
elif [ "$MODE" = "web" ]; then
RAYLIB_NAME="raylib-${RAYLIB_VERSION}_webassembly"
if download "$RAYLIB_NAME" "$RAYLIB_URL/$RAYLIB_NAME.zip"; then
RAYLIB_A="$RAYLIB_NAME/lib/libraylib.a"
INCLUDES=(-I./$RAYLIB_NAME/include -I./src -I./vendor)
else
echo "Error: prebuilt web raylib ${RAYLIB_VERSION} archive not found"
exit 1
fi
else
download "$RAYLIB_NAME" "$RAYLIB_URL/$RAYLIB_NAME.tar.gz"
if download "$RAYLIB_NAME" "$RAYLIB_URL/$RAYLIB_NAME.tar.gz"; then
RAYLIB_A="$RAYLIB_NAME/lib/libraylib.a"
INCLUDES=(-I./$RAYLIB_NAME/include -I./src -I./vendor)
else
echo "Prebuilt raylib ${RAYLIB_VERSION} archive not found; building from source..."
RAYLIB_NAME="raylib-${RAYLIB_VERSION}_desktop_source"
build_raylib_from_source "$RAYLIB_NAME" PLATFORM_DESKTOP
RAYLIB_A="$RAYLIB_NAME/src/libraylib.a"
INCLUDES=(-I./$RAYLIB_NAME/src -I./$RAYLIB_NAME/src/external -I./src -I./vendor)
fi
fi

RAYLIB_A="$RAYLIB_NAME/lib/libraylib.a"
INCLUDES=(-I./$RAYLIB_NAME/include -I./src -I./vendor)
LINK_ARCHIVES=("$RAYLIB_A")
EXTRA_SRC=""

Expand Down Expand Up @@ -139,9 +219,9 @@ if [ "$MODE" = "local" ] || [ "$MODE" = "fast" ]; then
"${INCLUDES[@]}"
"$SRC_DIR/$ENV.c" $EXTRA_SRC -o "$OUTPUT_NAME"
"${LINK_ARCHIVES[@]}"
"${STANDALONE_LDFLAGS[@]}"
"${RAYLIB_LINK_LDFLAGS[@]}"
-lm -lpthread -fopenmp
-DPLATFORM_DESKTOP
"$RAYLIB_PLATFORM"
)
echo "Compiling $ENV..."
${CC:-clang} "${CLANG_OPT[@]}" "${FLAGS[@]}"
Expand Down Expand Up @@ -208,13 +288,6 @@ if [ -z "$NCCL_LFLAG" ]; then
NCCL_LFLAG=$(python -c "import nvidia.nccl, os; print('-L' + os.path.join(nvidia.nccl.__path__[0], 'lib'))" 2>/dev/null || echo "")
fi

WHEEL_RPATH_FLAGS=()
for lib_flag in "$CUDNN_LFLAG" "$NCCL_LFLAG"; do
if [[ "$lib_flag" == -L* ]]; then
WHEEL_RPATH_FLAGS+=("-Wl,-rpath,${lib_flag#-L}")
fi
done

export CCACHE_DIR="${CCACHE_DIR:-$HOME/.ccache}"
export CCACHE_BASEDIR="$(pwd)"
export CCACHE_COMPILERCHECK=content
Expand All @@ -239,10 +312,10 @@ if [ ! -f "$BINDING_SRC" ]; then
fi

echo "Compiling static library for $ENV..."
${CC:-clang} -c "${CLANG_OPT[@]}" $EXTRA_CFLAGS \
${CC:-clang} -c "${CLANG_OPT[@]}" \
-I. -Isrc -I$SRC_DIR -Ivendor \
-I./$RAYLIB_NAME/include -I$CUDA_HOME/include \
-DPLATFORM_DESKTOP \
"${INCLUDES[@]}" -I$CUDA_HOME/include \
"$RAYLIB_PLATFORM" \
-fno-semantic-interposition -fvisibility=hidden \
-fPIC -fopenmp \
"$BINDING_SRC" -o "$STATIC_OBJ"
Expand All @@ -260,11 +333,11 @@ if [ -z "$MODE" ]; then
$NVCC -c -arch=$ARCH -Xcompiler -fPIC \
-Xcompiler=-D_GLIBCXX_USE_CXX11_ABI=1 \
-Xcompiler=-DNPY_NO_DEPRECATED_API=NPY_1_7_API_VERSION \
-Xcompiler=-DPLATFORM_DESKTOP \
-Xcompiler=$RAYLIB_PLATFORM \
-std=c++17 \
-I. -Isrc \
-I$PYTHON_INCLUDE -I$PYBIND_INCLUDE -I$NUMPY_INCLUDE \
-I$CUDA_HOME/include $CUDNN_IFLAG $NCCL_IFLAG -I$RAYLIB_NAME/include \
-I$CUDA_HOME/include $CUDNN_IFLAG $NCCL_IFLAG "${INCLUDES[@]}" \
-Xcompiler=-fopenmp \
-DOBS_TENSOR_T=$OBS_TENSOR_T \
-DENV_NAME=$ENV \
Expand All @@ -275,7 +348,6 @@ if [ -z "$MODE" ]; then
${CXX:-g++} -shared -fPIC -fopenmp
build/bindings.o "$STATIC_LIB" "$RAYLIB_A"
-L$CUDA_HOME/lib64 $CUDNN_LFLAG $NCCL_LFLAG
"${WHEEL_RPATH_FLAGS[@]}"
-lcudart -lnccl -lnvidia-ml -lcublas -lcusolver -lcurand -lcudnn
$OMP_LIB $LINK_OPT
"${SHARED_LDFLAGS[@]}"
Expand All @@ -288,10 +360,11 @@ elif [ "$MODE" = "cpu" ]; then
echo "Compiling CPU training backend..."
${CXX:-g++} -c -fPIC -fopenmp \
-D_GLIBCXX_USE_CXX11_ABI=1 \
-DPLATFORM_DESKTOP \
"$RAYLIB_PLATFORM" \
-std=c++17 \
-I. -Isrc \
-I$PYTHON_INCLUDE -I$PYBIND_INCLUDE \
"${INCLUDES[@]}" \
-DOBS_TENSOR_T=$OBS_TENSOR_T \
-DENV_NAME=$ENV \
$PRECISION $LINK_OPT \
Expand All @@ -310,10 +383,10 @@ elif [ "$MODE" = "profile" ]; then
echo "Compiling profile binary ($ARCH)..."
$NVCC $NVCC_OPT -arch=$ARCH -std=c++17 \
-I. -Isrc -I$SRC_DIR -Ivendor \
-I$CUDA_HOME/include $CUDNN_IFLAG $NCCL_IFLAG -I$RAYLIB_NAME/include \
-I$CUDA_HOME/include $CUDNN_IFLAG $NCCL_IFLAG "${INCLUDES[@]}" \
-DOBS_TENSOR_T=$OBS_TENSOR_T \
-DENV_NAME=$ENV \
-Xcompiler=-DPLATFORM_DESKTOP \
-Xcompiler=$RAYLIB_PLATFORM \
$PRECISION \
-Xcompiler=-fopenmp \
tests/profile_kernels.cu vendor/ini.c \
Expand Down
24 changes: 12 additions & 12 deletions ocean/checkers/checkers.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -752,57 +752,57 @@ void c_render(Checkers *env) {
case AGENT_PAWN:
piece_color = BLUE;
DrawCircle(center_x, center_y, radius, piece_color);
DrawCircleGradient(center_x - radius / 3, center_y - radius / 3,
DrawCircleGradient((Vector2){center_x - radius / 3, center_y - radius / 3},
radius / 3, (Color){255, 255, 255, 80},
(Color){255, 255, 255, 10});
DrawCircleGradient(center_x, center_y, radius,
DrawCircleGradient((Vector2){center_x, center_y}, radius,

@daphne-cornelisse daphne-cornelisse Jun 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are you changing the env code?

@Archizzle Archizzle Jun 18, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Raylib 6.0 has a few changes for the API. I went through the changelog from 5.5 to 6.0 and this seemed to be the only breaking change. It might be better to use an IFDEF or something to check for the specific raylib version. Happy to revert it if it'd be better to pin 5.5 as the default.

https://github.com/raysan5/raylib/blob/aaacda6e147031f2af0cfb6c1fd7e64d761ddb1f/CHANGELOG#L225

(Color){255, 255, 255, 50},
(Color){255, 255, 255, 5});
break;

case AGENT_KING:
piece_color = BLUE;
DrawCircle(center_x, center_y, radius, piece_color);
DrawCircleGradient(center_x, center_y, radius,
DrawCircleGradient((Vector2){center_x, center_y}, radius,
(Color){255, 255, 255, 50},
(Color){255, 255, 255, 5});

DrawCircleGradient(center_x, center_y - king_offset / 2, radius,
DrawCircleGradient((Vector2){center_x, center_y - king_offset / 2}, radius,
(Color){20, 20, 20, 60}, (Color){20, 20, 20, 30});
DrawCircle(center_x, center_y - king_offset, radius, piece_color);
DrawCircleGradient(
center_x - radius / 3, center_y - radius / 3 - king_offset,
(Vector2){center_x - radius / 3, center_y - radius / 3 - king_offset},
radius / 3, (Color){255, 255, 255, 80}, (Color){255, 255, 255, 10});
DrawCircleGradient(center_x, center_y - king_offset, radius,
DrawCircleGradient((Vector2){center_x, center_y - king_offset}, radius,
(Color){255, 255, 255, 50},
(Color){255, 255, 255, 5});
break;

case OPPONENT_PAWN:
piece_color = RED;
DrawCircle(center_x, center_y, radius, piece_color);
DrawCircleGradient(center_x - radius / 3, center_y - radius / 3,
DrawCircleGradient((Vector2){center_x - radius / 3, center_y - radius / 3},
radius / 3, (Color){255, 255, 255, 80},
(Color){255, 255, 255, 10});
DrawCircleGradient(center_x, center_y, radius,
DrawCircleGradient((Vector2){center_x, center_y}, radius,
(Color){255, 255, 255, 50},
(Color){255, 255, 255, 5});
break;

case OPPONENT_KING:
piece_color = RED;
DrawCircle(center_x, center_y, radius, piece_color);
DrawCircleGradient(center_x, center_y, radius,
DrawCircleGradient((Vector2){center_x, center_y}, radius,
(Color){255, 255, 255, 50},
(Color){255, 255, 255, 5});

DrawCircleGradient(center_x, center_y - king_offset / 2, radius,
DrawCircleGradient((Vector2){center_x, center_y - king_offset / 2}, radius,
(Color){20, 20, 20, 60}, (Color){20, 20, 20, 30});
DrawCircle(center_x, center_y - king_offset, radius, piece_color);
DrawCircleGradient(
center_x - radius / 3, center_y - radius / 3 - king_offset,
(Vector2){center_x - radius / 3, center_y - radius / 3 - king_offset},
radius / 3, (Color){255, 255, 255, 80}, (Color){255, 255, 255, 10});
DrawCircleGradient(center_x, center_y - king_offset, radius,
DrawCircleGradient((Vector2){center_x, center_y - king_offset}, radius,
(Color){255, 255, 255, 50},
(Color){255, 255, 255, 5});
break;
Expand Down
4 changes: 2 additions & 2 deletions ocean/go/go.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -969,11 +969,11 @@ void c_render(CGo* env) {
int inner = (env->grid_square_size / 2) - 4;
int outer = (env->grid_square_size / 2) - 2;
if (position_state == 1) {
DrawCircleGradient(circle_x, circle_y, outer, STONE_GRAY, BLACK);
DrawCircleGradient((Vector2){circle_x, circle_y}, outer, STONE_GRAY, BLACK);

@daphne-cornelisse daphne-cornelisse Jun 17, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here

}
// if enemy draw circle tile for white
if (position_state == 2) {
DrawCircleGradient(circle_x, circle_y, inner, WHITE, GRAY);
DrawCircleGradient((Vector2){circle_x, circle_y}, inner, WHITE, GRAY);
}
}
// design a pass button
Expand Down
Loading