Cardinal/Makefile

#!/usr/bin/make -f
# DISTRHO Cardinal Plugin
# Copyright (C) 2021-2025 Filipe Coelho <falktx@falktx.com>
# SPDX-License-Identifier: GPL-3.0-or-later

ROOT = .
include $(ROOT)/Makefile.base.mk

# ---------------------------------------------------------------------------------------------------------------------
# Set version

# also set in:
# .github/ISSUE_TEMPLATE/bug.yaml
# src/CardinalCommon.cpp `CARDINAL_VERSION`
# src/CardinalPlugin.cpp `getVersion`
# utils/macOS/Info_{JACK,Native}.plist
# .github/ISSUE_TEMPLATE/bug.yaml src/CardinalCommon.cpp src/CardinalPlugin.cpp utils/macOS/Info_{JACK,Native}.plist
VERSION = 26.01

# ---------------------------------------------------------------------------------------------------------------------
# Build targets

all: cardinal carla deps dgl plugins gen resources

# ---------------------------------------------------------------------------------------------------------------------
# Build config

PREFIX  ?= /usr/local
DESTDIR ?=

# ---------------------------------------------------------------------------------------------------------------------
# Carla config

CARLA_EXTRA_ARGS = \
	CARLA_BACKEND_NAMESPACE=Cardinal \
	DGL_NAMESPACE=CardinalDGL \
	HAVE_FFMPEG=false \
	HAVE_FLUIDSYNTH=false \
	HAVE_PROJECTM=false \
	HAVE_ZYN_DEPS=false \
	HAVE_ZYN_UI_DEPS=false

ifneq ($(DEBUG),true)
CARLA_EXTRA_ARGS += EXTERNAL_PLUGINS=true
endif

# ---------------------------------------------------------------------------------------------------------------------
# DGL config

ifeq ($(WASM),true)
UI_TYPE = gles2
else
UI_TYPE = opengl
endif

# ---------------------------------------------------------------------------------------------------------------------
# Check for required system-wide dependencies

ifeq ($(SYSDEPS),true)

ifneq ($(shell $(PKG_CONFIG) --exists jansson && echo true),true)
$(error jansson dependency not installed/available)
endif
ifneq ($(shell $(PKG_CONFIG) --exists libarchive && echo true),true)
$(error libarchive dependency not installed/available)
endif
ifneq ($(shell $(PKG_CONFIG) --exists samplerate && echo true),true)
$(error samplerate dependency not installed/available)
endif
ifneq ($(shell $(PKG_CONFIG) --exists speexdsp && echo true),true)
$(error speexdsp dependency not installed/available)
endif

endif

ifeq ($(HEADLESS),true)
ifneq ($(STATIC_BUILD),true)

ifneq ($(shell $(PKG_CONFIG) --exists liblo && echo true),true)
$(error liblo dependency not installed/available)
endif

endif
endif

# --------------------------------------------------------------
# Check for X11+OpenGL dependencies (unless headless build)

ifneq ($(HAIKU_OR_MACOS_OR_WASM_OR_WINDOWS),true)
ifneq ($(HEADLESS),true)

ifneq ($(HAVE_OPENGL),true)
$(error OpenGL dependency not installed/available)
endif
ifneq ($(HAVE_X11),true)
$(error X11 dependency not installed/available)
endif
ifneq ($(HAVE_XCURSOR),true)
$(warning Xcursor dependency not installed/available)
endif
ifneq ($(HAVE_XEXT),true)
$(warning Xext dependency not installed/available)
endif
ifneq ($(HAVE_XRANDR),true)
$(warning Xrandr dependency not installed/available)
endif

else

CARLA_EXTRA_ARGS += HAVE_DBUS=false
CARLA_EXTRA_ARGS += HAVE_DGL=false
CARLA_EXTRA_ARGS += HAVE_OPENGL=false
CARLA_EXTRA_ARGS += HAVE_X11=false
CARLA_EXTRA_ARGS += HAVE_XCURSOR=false
CARLA_EXTRA_ARGS += HAVE_XEXT=false
CARLA_EXTRA_ARGS += HAVE_XRANDR=false

endif
endif

# --------------------------------------------------------------
# Check for optional system-wide dependencies

ifeq ($(shell $(PKG_CONFIG) --exists fftw3f && echo true),true)
HAVE_FFTW3F = true
else
$(warning fftw3f dependency not installed/available)
endif

# --------------------------------------------------------------
# MOD builds

EXTRA_MOD_FLAGS  = -I../include/single-precision -fsingle-precision-constant -Wno-attributes
ifeq ($(MODDUO),true)
EXTRA_MOD_FLAGS += -mno-unaligned-access
endif
ifeq ($(WITH_LTO),true)
EXTRA_MOD_FLAGS += -ffat-lto-objects
endif

MOD_ENVIRONMENT += HEADLESS=true
MOD_ENVIRONMENT += STATIC_BUILD=true

# --------------------------------------------------------------
# Individual targets

cardinal: carla deps dgl plugins resources
	$(MAKE) all -C src $(CARLA_EXTRA_ARGS)

carla:
ifneq ($(STATIC_BUILD),true)
	$(MAKE) static-plugin -C carla $(CARLA_EXTRA_ARGS) \
		CAN_GENERATE_LV2_TTL=false \
		CUSTOM_DPF_PATH=$(CURDIR)/dpf \
		STATIC_PLUGIN_TARGET=true \
		USING_CUSTOM_DPF=true
endif

carla-win32:
ifneq ($(STATIC_BUILD),true)
	$(MAKE) all -C carla $(CARLA_EXTRA_ARGS) \
		CAN_GENERATE_LV2_TTL=false \
		CUSTOM_DPF_PATH=$(CURDIR)/dpf \
		DGL_NAMESPACE=CardinalDGL \
		HAVE_FRONTEND=true \
		HAVE_PYQT=true \
		HAVE_QT5=true \
		HAVE_QT5PKG=true \
		STATIC_PLUGIN_TARGET=true \
		USING_CUSTOM_DPF=true
ifeq ($(CPU_X86_64),true)
	$(MAKE) win32r -C carla $(CARLA_EXTRA_ARGS) \
		CAN_GENERATE_LV2_TTL=false \
		CUSTOM_DPF_PATH=$(CURDIR)/dpf \
		DGL_NAMESPACE=CardinalDGL \
		HAVE_FRONTEND=true \
		HAVE_PYQT=true \
		HAVE_QT5=true \
		HAVE_QT5PKG=true \
		STATIC_PLUGIN_TARGET=true \
		USING_CUSTOM_DPF=true
endif
endif

deps:
ifeq ($(SYSDEPS),true)
	$(MAKE) quickjs surge -C deps
else
	$(MAKE) all -C deps
endif
ifeq ($(HAVE_FFTW3F),true)
	$(MAKE) all -C deps/aubio
endif

dgl:
ifneq ($(HEADLESS),true)
	$(MAKE) $(UI_TYPE) -C dpf/dgl $(DGL_EXTRA_ARGS)
endif

plugins: deps
	$(MAKE) all -C plugins

resources:
	$(MAKE) resources -C plugins

loader-resources:
	$(MAKE) loader-resources -C plugins

mini-plugins: deps
	$(MAKE) mini -C plugins

mini-resources:
	$(MAKE) mini-resources -C plugins

ifneq ($(CROSS_COMPILING),true)
gen: cardinal resources dpf/utils/lv2_ttl_generator
	@$(CURDIR)/dpf/utils/generate-ttl.sh

loader-gen: loader loader-resources dpf/utils/lv2_ttl_generator
	@$(CURDIR)/dpf/utils/generate-ttl.sh

dpf/utils/lv2_ttl_generator:
	$(MAKE) -C dpf/utils/lv2-ttl-generator
else
gen:
loader-gen:
endif

# --------------------------------------------------------------
# extra rules, for quick testing

jack: carla deps dgl plugins resources
	$(MAKE) jack -C src $(CARLA_EXTRA_ARGS)

native: carla deps dgl plugins resources
	$(MAKE) native -C src $(CARLA_EXTRA_ARGS)

mini: carla deps dgl mini-plugins mini-resources
	$(MAKE) mini -C src $(CARLA_EXTRA_ARGS)

au: carla deps dgl plugins resources
	$(MAKE) au -C src $(CARLA_EXTRA_ARGS)

clap: carla deps dgl plugins resources
	$(MAKE) clap -C src $(CARLA_EXTRA_ARGS)

lv2: carla deps dgl plugins resources
	$(MAKE) lv2 -C src $(CARLA_EXTRA_ARGS)

mapi: carla deps dgl plugins resources
	$(MAKE) mapi -C src $(CARLA_EXTRA_ARGS)

vst2: carla deps dgl plugins resources
	$(MAKE) vst2 -C src $(CARLA_EXTRA_ARGS)

vst2fx: carla deps dgl plugins resources
	$(MAKE) vst2fx -C src $(CARLA_EXTRA_ARGS)

vst3: carla deps dgl plugins resources
	$(MAKE) vst3 -C src $(CARLA_EXTRA_ARGS)

modgui:
	$(MAKE) modgui -C src/CardinalMiniSep

ifeq ($(HEADLESS)$(STATIC_BUILD),truetrue)
loader: deps dgl plugins loader-gen
	$(MAKE) loader -C src $(CARLA_EXTRA_ARGS)
	@$(CURDIR)/dpf/utils/generate-ttl.sh
else
loader:
	$(MAKE) loader HEADLESS=true STATIC_BUILD=true
endif

# --------------------------------------------------------------
# Packaging standalone for CI

unzipfx: deps/unzipfx/unzipfx2cat$(APP_EXT) CardinalJACK.zip CardinalNative.zip
	cat deps/unzipfx/unzipfx2cat$(APP_EXT) CardinalJACK.zip > CardinalJACK$(APP_EXT)
	cat deps/unzipfx/unzipfx2cat$(APP_EXT) CardinalNative.zip > CardinalNative$(APP_EXT)
	chmod +x CardinalJACK$(APP_EXT) CardinalNative$(APP_EXT)

CardinalJACK.zip: bin/Cardinal$(APP_EXT) bin/CardinalFX.lv2/resources
	mkdir -p build/unzipfx-jack
	ln -sf ../../bin/Cardinal$(APP_EXT) build/unzipfx-jack/Cardinal$(APP_EXT)
	ln -sf ../../bin/CardinalFX.lv2/resources build/unzipfx-jack/resources
	cd build/unzipfx-jack && \
		zip -r -9 ../../$@ Cardinal$(APP_EXT) resources

CardinalNative.zip: bin/CardinalNative$(APP_EXT) bin/CardinalFX.lv2/resources
	mkdir -p build/unzipfx-native
	ln -sf ../../bin/CardinalNative$(APP_EXT) build/unzipfx-native/Cardinal$(APP_EXT)
	ln -sf ../../bin/CardinalFX.lv2/resources build/unzipfx-native/resources
	cd build/unzipfx-native && \
		zip -r -9 ../../$@ Cardinal$(APP_EXT) resources

deps/unzipfx/unzipfx2cat:
	make -C deps/unzipfx -f Makefile.linux

deps/unzipfx/unzipfx2cat.exe:
	make -C deps/unzipfx -f Makefile.win32

# --------------------------------------------------------------
# Clean step

clean:
	$(MAKE) distclean -C carla $(CARLA_EXTRA_ARGS) CAN_GENERATE_LV2_TTL=false STATIC_PLUGIN_TARGET=true
	$(MAKE) clean -C deps
	$(MAKE) clean -C deps/aubio
	$(MAKE) clean -C dpf/dgl
	$(MAKE) clean -C dpf/utils/lv2-ttl-generator
	$(MAKE) clean -C plugins
	$(MAKE) clean -C src
	rm -rf bin build build-headless dpf/utils/lv2_ttl_generator.d

# --------------------------------------------------------------
# Install step

install:
	install -d $(DESTDIR)$(PREFIX)/bin
	install -d $(DESTDIR)$(PREFIX)/lib/lv2/Cardinal.lv2
	install -d $(DESTDIR)$(PREFIX)/lib/lv2/CardinalFX.lv2
	install -d $(DESTDIR)$(PREFIX)/lib/lv2/CardinalMini.lv2
	install -d $(DESTDIR)$(PREFIX)/lib/lv2/CardinalSynth.lv2
	install -d $(DESTDIR)$(PREFIX)/lib/clap/Cardinal.clap
	install -d $(DESTDIR)$(PREFIX)/lib/vst/Cardinal.vst
ifneq ($(VST3_BINARY_DIR),)
	install -d $(DESTDIR)$(PREFIX)/lib/vst3/Cardinal.vst3/$(VST3_BINARY_DIR)
	install -d $(DESTDIR)$(PREFIX)/lib/vst3/CardinalFX.vst3/$(VST3_BINARY_DIR)
	install -d $(DESTDIR)$(PREFIX)/lib/vst3/CardinalSynth.vst3/$(VST3_BINARY_DIR)
endif
	install -d $(DESTDIR)$(PREFIX)/share/cardinal
	install -d $(DESTDIR)$(PREFIX)/share/doc/cardinal/docs

	install -m 644 bin/Cardinal.lv2/*.*      $(DESTDIR)$(PREFIX)/lib/lv2/Cardinal.lv2/
	install -m 644 bin/CardinalFX.lv2/*.*    $(DESTDIR)$(PREFIX)/lib/lv2/CardinalFX.lv2/
	install -m 644 bin/CardinalMini.lv2/*.*  $(DESTDIR)$(PREFIX)/lib/lv2/CardinalMini.lv2/
	install -m 644 bin/CardinalSynth.lv2/*.* $(DESTDIR)$(PREFIX)/lib/lv2/CardinalSynth.lv2/

	install -m 644 bin/Cardinal.clap/*.*     $(DESTDIR)$(PREFIX)/lib/clap/Cardinal.clap/
	install -m 644 bin/Cardinal.vst/*.*      $(DESTDIR)$(PREFIX)/lib/vst/Cardinal.vst/

ifneq ($(VST3_BINARY_DIR),)
	install -m 644 bin/Cardinal.vst3/$(VST3_BINARY_DIR)/*      $(DESTDIR)$(PREFIX)/lib/vst3/Cardinal.vst3/$(VST3_BINARY_DIR)/
	install -m 644 bin/CardinalFX.vst3/$(VST3_BINARY_DIR)/*    $(DESTDIR)$(PREFIX)/lib/vst3/CardinalFX.vst3/$(VST3_BINARY_DIR)/
	install -m 644 bin/CardinalSynth.vst3/$(VST3_BINARY_DIR)/* $(DESTDIR)$(PREFIX)/lib/vst3/CardinalSynth.vst3/$(VST3_BINARY_DIR)/
endif

	install -m 755 bin/Cardinal$(APP_EXT)       $(DESTDIR)$(PREFIX)/bin/
	install -m 755 bin/CardinalMini$(APP_EXT)   $(DESTDIR)$(PREFIX)/bin/
	install -m 755 bin/CardinalNative$(APP_EXT) $(DESTDIR)$(PREFIX)/bin/

	cp -rL bin/Cardinal.lv2/resources/* $(DESTDIR)$(PREFIX)/share/cardinal/

	install -m 644 README.md            $(DESTDIR)$(PREFIX)/share/doc/cardinal/
	install -m 644 docs/*.md docs/*.png $(DESTDIR)$(PREFIX)/share/doc/cardinal/docs/

# --------------------------------------------------------------
# Tarball step, for releases

TAR_ARGS = \
	--exclude=".appveyor*" \
	--exclude=".ci*" \
	--exclude=".clang*" \
	--exclude=".drone*" \
	--exclude=".editor*" \
	--exclude=".git*" \
	--exclude="*.kdev*" \
	--exclude=".travis*" \
	--exclude=".vscode*" \
	--exclude="carla/source/native-plugins/external/zynaddsubfx*" \
	--exclude="src/Rack/dep/osdialog/osdialog_*" \
	--exclude="src/Rack/icon.*" \
	--exclude=bin \
	--exclude=build \
	--exclude=jucewrapper \
	--exclude=lv2export \
	--exclude=carla/data \
	--exclude=carla/source/frontend \
	--exclude=carla/source/interposer \
	--exclude=carla/source/libjack \
	--exclude=carla/source/native-plugins/resources \
	--exclude=carla/source/rest \
	--exclude=carla/source/tests.old \
	--exclude=carla/source/theme \
	--exclude=carla/resources \
	--exclude=deps/PawPaw \
	--exclude=deps/sysroot \
	--exclude=deps/unzipfx \
	--exclude=docs/.generate-plugin-licenses.sh \
	--exclude=docs/MODDEVICES.md \
	--exclude=dpf/cmake \
	--exclude=dpf/examples \
	--exclude=dpf/lac \
	--exclude=dpf/tests \
	--exclude=plugins/.kdev_include_paths \
	--exclude=plugins/todo.txt \
	--exclude=plugins/AriaModules/res/Arcane \
	--exclude=plugins/AudibleInstruments/design \
	--exclude=plugins/BaconPlugs/res/midi/beeth \
	--exclude=plugins/BogaudioModules/res-pp \
	--exclude=plugins/BogaudioModules/res-src \
	--exclude=plugins/Cardinal/orig \
	--exclude=plugins/GrandeModular/res-src \
	--exclude=plugins/surgext/surge/libs/JUCE \
	--exclude=plugins/surgext/surge/resources/data/patches_3rdparty \
	--exclude=plugins/surgext/surge/resources/data/patches_factory \
	--exclude=plugins/surgext/surge/resources/data/wavetables_3rdparty \
	--exclude=src/Rack/adapters \
	--exclude=src/Rack/dep/filesystem/cmake \
	--exclude=src/Rack/dep/filesystem/examples \
	--exclude=src/Rack/dep/filesystem/test \
	--exclude=src/Rack/dep/glfw/CMake \
	--exclude=src/Rack/dep/glfw/deps \
	--exclude=src/Rack/dep/glfw/docs \
	--exclude=src/Rack/dep/glfw/examples \
	--exclude=src/Rack/dep/glfw/src \
	--exclude=src/Rack/dep/glfw/tests \
	--exclude=src/Rack/dep/nanosvg/example \
	--exclude=src/Rack/dep/nanovg \
	--exclude=src/Rack/dep/rtaudio \
	--exclude=src/Rack/include/audio.hpp \
	--exclude=src/Rack/include/midi.hpp \
	--exclude=src/Rack/include/engine/Port.hpp \
	--exclude=src/Rack/src/core \
	--exclude=src/Rack/src/asset.cpp \
	--exclude=src/Rack/src/audio.cpp \
	--exclude=src/Rack/src/common.cpp \
	--exclude=src/Rack/src/context.cpp \
	--exclude=src/Rack/src/dep.cpp \
	--exclude=src/Rack/src/discord.cpp \
	--exclude=src/Rack/src/gamepad.cpp \
	--exclude=src/Rack/src/keyboard.cpp \
	--exclude=src/Rack/src/library.cpp \
	--exclude=src/Rack/src/midi.cpp \
	--exclude=src/Rack/src/network.cpp \
	--exclude=src/Rack/src/plugin.cpp \
	--exclude=src/Rack/src/rtaudio.cpp \
	--exclude=src/Rack/src/rtmidi.cpp \
	--exclude=src/Rack/src/app/AudioDisplay.cpp \
	--exclude=src/Rack/src/app/MenuBar.cpp \
	--exclude=src/Rack/src/app/MidiDisplay.cpp \
	--exclude=src/Rack/src/app/ModuleWidget.cpp \
	--exclude=src/Rack/src/app/Scene.cpp \
	--exclude=src/Rack/src/app/TipWindow.cpp \
	--exclude=src/Rack/src/dsp/minblep.cpp \
	--exclude=src/Rack/src/engine/Engine.cpp \
	--exclude=src/Rack/src/plugin/Model.cpp \
	--exclude=src/Rack/src/widget/OpenGlWidget.cpp \
	--exclude=src/Rack/src/window/Window.cpp \
	--exclude=src/Rack/res/Core \
	--exclude=src/Rack/res/icon.png \
	--transform='s,^\.\.,-.-.,' \
	--transform='s,^\.,cardinal-$(VERSION),' \
	--transform='s,^-\.-\.,..,' \

download:
	$(MAKE) download -C deps

tarball:
	$(MAKE) clean -C deps
	rm -f ../cardinal-$(VERSION).tar.xz
	tar -c --lzma $(TAR_ARGS) -f ../cardinal-$(VERSION).tar.xz .

tarball+deps: download
	rm -f ../cardinal+deps-$(VERSION).tar.xz
	tar -c --lzma $(TAR_ARGS) -f ../cardinal+deps-$(VERSION).tar.xz .

version:
	@echo $(VERSION)

# --------------------------------------------------------------

.PHONY: carla deps plugins