tyler
398be34aaf
- README: rewrite Build section for the hand-written Makefile (make / make DEBUG=1 / run / test / bench). Add a "System dependencies" table with the X11+GL dev packages per distro (apt/dnf/pacman/zypper/apk), since a clone won't build without them and the error is otherwise cryptic. Fix stale ./bin/Debug paths to ./bin/Release. - Makefile: add `make check-deps` — probes for the required X11/GL dev headers and prints the install command for the detected distro on failure (via /etc/os-release). - build_web.sh: auto-discover app modules from src/*.c (drop the hardcoded APP_MODULES list that had to be hand-synced), matching the desktop Makefile. Excludes the desktop platform backends. Remove the stale rspektrum.make reference. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
137 lines
5.3 KiB
Makefile
137 lines
5.3 KiB
Makefile
# rspektrum - hand-written Makefile (GNU make + gcc, no premake/lua).
|
|
#
|
|
# Quick start:
|
|
# make # release build -> bin/Release/rspektrum
|
|
# make DEBUG=1 # debug build -> bin/Debug/rspektrum
|
|
# make run # build + launch
|
|
# make test # build + run the DSP correctness tests
|
|
# make bench # build + run the FFT benchmark over mlnl_samples.wav
|
|
# make clean # remove build artifacts for the current config
|
|
#
|
|
# Override the toolchain or flags on the command line, e.g.
|
|
# make CC=clang
|
|
# make ARCH="-march=native" # bleeding-edge tune for your own machine
|
|
#
|
|
# Pure C project (raylib is vendored as source and compiled in). Linux/X11.
|
|
|
|
# ---- toolchain ----------------------------------------------------------
|
|
CC ?= gcc
|
|
AR ?= ar
|
|
|
|
# ---- config: release (default) or DEBUG=1 -------------------------------
|
|
# ARCH is the portable baseline tune; override to -march=native for a local
|
|
# build. x86-64-v3 == AVX2 + FMA (~2013+), the sweet spot for the float FFT.
|
|
ARCH ?= -march=x86-64-v3
|
|
|
|
ifdef DEBUG
|
|
BUILD := Debug
|
|
OPT := -g
|
|
DEFCONFIG := -DDEBUG
|
|
else
|
|
BUILD := Release
|
|
OPT := -O3 -ffast-math $(ARCH)
|
|
DEFCONFIG := -DNDEBUG
|
|
STRIP := -s
|
|
endif
|
|
|
|
BINDIR := bin/$(BUILD)
|
|
OBJDIR := obj/$(BUILD)
|
|
TARGET := $(BINDIR)/rspektrum
|
|
RAYLIB := $(BINDIR)/libraylib.a
|
|
|
|
# ---- shared flags -------------------------------------------------------
|
|
RAYLIB_SRC := build/external/raylib-master/src
|
|
DEFINES := $(DEFCONFIG) -DPLATFORM_DESKTOP -DGRAPHICS_API_OPENGL_33 -D_GLFW_X11
|
|
INCLUDES := -Isrc -Iinclude -I$(RAYLIB_SRC) -I$(RAYLIB_SRC)/external/glfw/include
|
|
CFLAGS := -std=c17 -Wall -Wshadow $(OPT) $(DEFINES) $(INCLUDES)
|
|
DEPFLAGS = -MMD -MP
|
|
LDLIBS := -lpthread -lm -ldl -lrt -lX11
|
|
LDFLAGS := $(STRIP)
|
|
|
|
# ---- sources ------------------------------------------------------------
|
|
# App: every src/*.c except the non-Linux platform backends.
|
|
APP_SRC := $(filter-out src/platform_win32.c src/platform_web.c,$(wildcard src/*.c))
|
|
APP_OBJ := $(patsubst src/%.c,$(OBJDIR)/app/%.o,$(APP_SRC))
|
|
|
|
# raylib: explicit list of the modules we link (matches the vendored tree).
|
|
RAY_MODULES := rcore rshapes rtextures rtext rmodels raudio rglfw
|
|
RAY_OBJ := $(patsubst %,$(OBJDIR)/raylib/%.o,$(RAY_MODULES))
|
|
|
|
DEPS := $(APP_OBJ:.o=.d) $(RAY_OBJ:.o=.d)
|
|
|
|
# ---- top-level targets --------------------------------------------------
|
|
.PHONY: all run test bench check-deps clean help
|
|
.DEFAULT_GOAL := all
|
|
|
|
all: $(TARGET)
|
|
|
|
$(TARGET): $(APP_OBJ) $(RAYLIB) | $(BINDIR)
|
|
@echo "Linking $@"
|
|
$(CC) $(LDFLAGS) -o $@ $(APP_OBJ) $(RAYLIB) $(LDLIBS)
|
|
|
|
$(RAYLIB): $(RAY_OBJ) | $(BINDIR)
|
|
@echo "Archiving $@"
|
|
$(AR) rcs $@ $(RAY_OBJ)
|
|
|
|
# ---- compile rules ------------------------------------------------------
|
|
$(OBJDIR)/app/%.o: src/%.c | $(OBJDIR)/app
|
|
@echo " CC $<"
|
|
$(CC) $(CFLAGS) $(DEPFLAGS) -c $< -o $@
|
|
|
|
$(OBJDIR)/raylib/%.o: $(RAYLIB_SRC)/%.c | $(OBJDIR)/raylib
|
|
@echo " CC $<"
|
|
$(CC) $(CFLAGS) $(DEPFLAGS) -c $< -o $@
|
|
|
|
# ---- dirs ---------------------------------------------------------------
|
|
$(BINDIR) $(OBJDIR)/app $(OBJDIR)/raylib:
|
|
@mkdir -p $@
|
|
|
|
# ---- convenience --------------------------------------------------------
|
|
run: $(TARGET)
|
|
./$(TARGET)
|
|
|
|
# DSP tests/benchmarks (fft.c is standalone, so they link it directly with the
|
|
# same release flags this Makefile uses).
|
|
test:
|
|
$(MAKE) -C bench test CC="$(CC)" CFLAGS="-O3 -ffast-math $(ARCH) -Wall"
|
|
|
|
bench:
|
|
$(MAKE) -C bench bench CC="$(CC)" CFLAGS="-O3 -ffast-math $(ARCH) -Wall"
|
|
|
|
clean:
|
|
rm -rf $(OBJDIR) $(TARGET) $(RAYLIB)
|
|
$(MAKE) -C bench clean
|
|
|
|
# Preflight: probe for the X11/GL dev headers the build needs and, if any are
|
|
# missing, print the install command for the detected distribution. Headers are
|
|
# required even though the X11 extension libs are dlopen'd at runtime.
|
|
check-deps:
|
|
@printf '#include <X11/Xlib.h>\n#include <X11/extensions/Xrandr.h>\n'\
|
|
'#include <X11/extensions/Xinerama.h>\n#include <X11/Xcursor/Xcursor.h>\n'\
|
|
'#include <X11/extensions/XInput2.h>\n#include <GL/gl.h>\n#include <GL/glx.h>\n'\
|
|
'int main(void){return 0;}\n' > .depcheck.c
|
|
@if $(CC) -fsyntax-only .depcheck.c >/dev/null 2>&1; then \
|
|
echo "check-deps: all required X11/GL dev headers found."; \
|
|
rm -f .depcheck.c; \
|
|
else \
|
|
rm -f .depcheck.c; \
|
|
echo "check-deps: MISSING X11/GL development headers. Install them:"; \
|
|
. /etc/os-release 2>/dev/null; \
|
|
case "$$ID $$ID_LIKE" in \
|
|
*debian*|*ubuntu*) echo " sudo apt install build-essential xorg-dev libgl1-mesa-dev" ;; \
|
|
*fedora*|*rhel*|*centos*) echo " sudo dnf install gcc make libX11-devel libXrandr-devel libXinerama-devel libXcursor-devel libXi-devel mesa-libGL-devel" ;; \
|
|
*arch*|*manjaro*) echo " sudo pacman -S base-devel libx11 libxrandr libxinerama libxcursor libxi mesa" ;; \
|
|
*suse*) echo " sudo zypper install gcc make libX11-devel libXrandr-devel libXinerama-devel libXcursor-devel libXi-devel Mesa-libGL-devel" ;; \
|
|
*alpine*) echo " sudo apk add build-base libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev mesa-dev" ;; \
|
|
*) echo " Install X11 + OpenGL dev headers for your distro (Xlib, Xrandr, Xinerama, Xcursor, Xi, GL/GLX). See README."; \
|
|
esac; \
|
|
exit 1; \
|
|
fi
|
|
|
|
help:
|
|
@echo "Targets: all (default), run, test, bench, check-deps, clean"
|
|
@echo "Configs: release (default), or 'make DEBUG=1'"
|
|
@echo "Vars: CC, AR, ARCH (e.g. ARCH=-march=native)"
|
|
|
|
-include $(DEPS)
|