Gentoo Packages

# Copyright 1999-2026 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2

# shellcheck disable=SC2207

# TODO
# - Package Hydra
# 	https://github.com/Ray-Tracing-Systems/HydraCore
# 	https://github.com/Ray-Tracing-Systems/HydraAPI
# - Package USD
# 	https://github.com/PixarAnimationStudios/OpenUSD
# - Package MaterialX
# 	https://github.com/AcademySoftwareFoundation/MaterialX
# - Package Audaspace
# 	https://github.com/neXyon/audaspace

EAPI=8

PYTHON_COMPAT=( python3_{12..14} )
# NOTE must match media-libs/osl
LLVM_COMPAT=( {20..20} )
LLVM_OPTIONAL=1

ROCM_SKIP_GLOBALS=1

inherit cuda rocm llvm-r2 edo
inherit eapi9-pipestatus check-reqs flag-o-matic multiprocessing pax-utils python-single-r1 toolchain-funcs virtualx
inherit cmake xdg-utils

# BENTOO-DIVERGENCE: files/content - blender-4.0.2-FindClang.patch and
# blender-4.1.1-FindLLVM.patch differ from ::gentoo's copies. They are the same
# patches REBASED onto this series: upstream CMake renamed the find-module
# variables (_CLANG_FIND_COMPONENTS became _clang_FIND_COMPONENTS and so on), so
# ::gentoo's copies no longer apply here. The filenames keep their historical
# versions because the applier never renames files/ on a bump.
DESCRIPTION="3D Creation/Animation/Publishing System"
HOMEPAGE="https://www.blender.org"

# NOTE BLENDER_VERSION
# https://projects.blender.org/blender/blender/src/branch/main/source/blender/blenkernel/BKE_blender_version.h
BLENDER_BRANCH="$(ver_cut 1-2)"

if [[ "${PV}" == *9999* ]]; then
	EGIT_LFS="yes"
	inherit git-r3
	EGIT_REPO_URI="https://projects.blender.org/blender/blender.git"
	EGIT_SUBMODULES=( '*' '-lib/*' )
	# using shallow causes long wait times.
	EGIT_LFS_CLONE_TYPE="single"

	if [[ "${PV}" == 9999* ]]; then
		EGIT_BRANCH="main"
	else
		EGIT_BRANCH="blender-v${BLENDER_BRANCH}-release"
	fi

else
	SRC_URI="
		https://download.blender.org/source/${P}.tar.xz
		test? (
			https://download.blender.org/source/blender-test-data-${BLENDER_BRANCH}.0.tar.xz
		)
	"
	KEYWORDS="~amd64 ~arm64"
fi

# assets is CC0-1.0
LICENSE="GPL-3+ cycles? ( Apache-2.0 ) CC0-1.0"
SLOT="${BLENDER_BRANCH}"

# NOTE +openpgl breaks on very old amd64 hardware
# potentially mirror cpu_flags_x86 + REQUIRED_USE
IUSE="
	alembic +bullet +color-management cuda +cycles +cycles-bin-kernels
	debug doc +embree +ffmpeg +fftw +fluid +gmp gnome hip hiprt jack
	jemalloc jpeg2k man +manifold +nanovdb ndof nls +oidn openal +openexr +opengl +openpgl
	+opensubdiv +openvdb optix osl pipewire +pdf +potrace +pugixml pulseaudio
	renderdoc +rubberband sdl +sndfile +tbb test +tiff +truetype valgrind vulkan wayland +webp X
"

if [[ "${PV}" == *9999* ]]; then
	IUSE+="experimental"
fi

RESTRICT="!test? ( test )"

REQUIRED_USE="${PYTHON_REQUIRED_USE}
	|| ( opengl vulkan )
	alembic? ( openexr )
	cuda? ( cycles )
	cycles? ( openexr tiff tbb )
	fluid? ( tbb )
	gnome? ( wayland )
	hip? ( cycles )
	hiprt? ( hip )
	nanovdb? ( openvdb )
	openvdb? ( tbb openexr )
	optix? ( cuda )
	osl? ( cycles pugixml )
	test? (
		color-management
		jpeg2k
	)
"

# Library versions for official builds can be found in the blender source directory in:
# build_files/build_environment/cmake/versions.cmake

# DEPENDENCY FLOORS, corrected 2026-09-06. opencolorio and openvdb carried
# >=2.5.0 and >=13.0.0, which made this ebuild unsolvable on EVERY arch: neither
# version exists in ::gentoo (2.4.2 and 12.0.1 are the newest). Both numbers came
# from build_files/build_environment/cmake/versions.cmake -- OPENCOLORIO_VERSION
# 2.5.0 at line 263, OPENVDB_VERSION 13.0.0 at line 430 -- which is the list of
# versions blender builds for its OWN precompiled library bundle, not a minimum
# the source enforces. The same file pins PYTHON_VERSION 3.13.13 while ::gentoo
# builds 5.0.0 against 3.14, so it is a known-bad source for ebuild floors.
#
# What the source actually asks for, in build_files/cmake/platform/platform_unix.cmake:
#   :455  find_package_wrapper(OpenColorIO 2.0.0 REQUIRED)   -> >=2.0.0
#   :400  find_package(OpenVDB)                              -> no version at all
#   :265  find_package_wrapper(OpenEXR REQUIRED)             -> no version at all
# openvdb and openexr are set to >=11.0.0 and >=3.3.5, the floors ::gentoo proves
# for blender-5.0.0, rather than dropping the bounds entirely. openexr had the
# same defect for a second reason: >=3.4.0 could only be met by openexr-3.4.4,
# which ::gentoo package.masks (needs media-libs/openjph, Gentoo bug #966735), so
# the floor selected a version nobody can install.
#
# VERIFIED TO THE RESOLUTION RUNG ONLY: `emerge -pv` now resolves the package,
# which it could not do before. A real compile against opencolorio 2.4.x and
# openvdb 12.x has NOT been run -- blender is a multi-hour build and this host
# cannot merge its dependencies. If 5.2 turns out to use an API newer than these
# floors, the failure moves from "no ebuilds to satisfy" to a compile error,
# which is worse to hit but better to diagnose than a package nobody can select.

# BENTOO-DIVERGENCE: RDEPEND - sci-libs/ceres-solver, and it is REQUIRED here
# even though ::gentoo declares no ceres at all. SETTLED 2026-09-06 against the
# 5.2.1 tarball, which an earlier note here could not read and therefore guessed
# wrong about: the dependency is not inert.
#
#   build_files/cmake/platform/platform_unix.cmake:657
#       if(WITH_LIBMV)
#         find_package_wrapper(Ceres REQUIRED)
#
# and CMakeLists.txt:504 sets WITH_LIBMV ON by default. Neither this ebuild nor
# ::gentoo's passes -DWITH_LIBMV=OFF -- every mention on both sides is commented
# out -- so Ceres is looked up, REQUIRED, on Linux.
#
# ::gentoo is not wrong for its own versions; it is on 5.0.0, and blender
# REMOVED its bundled copy between the two releases. Counted in the tarballs:
# 5.0.0 carries 362 entries under extern/ceres, 5.2.1 carries one, and that one
# is build_files/build_environment/cmake/ceres.cmake, the recipe for blender's
# own precompiled library bundle rather than vendored source. There is no
# WITH_SYSTEM_CERES because from 5.2 there is no bundled Ceres to switch away
# from.
#
# Dropping it to buy ~arm64 would not have worked anyway. pkgcheck lists FOUR
# solutions for the ~arm64 NonsolvableDeps, and ceres is only one of them:
# >=media-gfx/openvdb-13.0.0[nanovdb] (::gentoo has 12.0.1),
# >=media-libs/opencolorio-2.5.0 (::gentoo has 2.4.2), >=media-libs/openexr-3.4.0
# (satisfiable) and this. The first two are also why NonsolvableDepsInStable
# fires on plain amd64 -- they are too old everywhere, not just on arm64.
#
# THE OPENVDB FLOOR WAS RAISED AGAIN, and this time from a compiler, not a
# resolver. >=11.0.0 took ::gentoo's proven 5.0.0 floor because 13.0.0 came
# from versions.cmake, which describes blender's own precompiled bundle rather
# than what the source enforces. That reasoning still holds in general -- but
# for openvdb the number it named was a real constraint, and 11.0.0 was too
# low. USE=nanovdb, which is default-on, does not build against openvdb 12.0.1:
#
#   nanovdb/util/Reduce.h:47: error: no matching function for call to
#   'parallel_reduce(...)': binding reference of type 'util::Range1D&' to
#   'const util::Range<1, long unsigned int>' discards qualifiers
#
# nanovdb/tools/CreateNanoGrid.h passes a lambda taking a NON-const Range1D& to
# tbb::parallel_reduce, which calls its functor with const Range&. It is a
# template, so it only fails once instantiated, and blender 5.2 is what
# instantiates it -- intern/cycles/util/nanovdb.cpp:224 asks for
# createNanoGrid<openvdb::FloatGrid, nanovdb::FpN>. That is why 5.0.0 never
# tripped over it and why no resolver could have predicted this.
#
# The floor is 12.1.0, not 13.0.0, because 12.1.0 is where the const lands
# upstream -- bisected across the tags: 12.0.1 has 'Range1D &r', 12.1.0,
# 12.1.1, 13.0.0 and master all have 'const Range1D &r'. Naming 13.0.0 would
# repeat the original mistake in the opposite direction: excluding a version
# that works because a bundle manifest happened to say so.
#
# What is actually compiled against here is 13.0.0, which this overlay carries
# because ::gentoo has nothing above 12.0.1. 12.1.x was never built by anyone
# here; it is admitted by the floor on the strength of the header, not of a
# build.
#
# ceres-solver is KEYWORDS="amd64 ~x86" in ::gentoo and this overlay does not
# carry a copy. Copying it here to add one keyword would recreate the
# duplication that cost sci-ml/ollama its place; the keyword has to come from
# ::gentoo.
# BENTOO-DIVERGENCE: DEPEND - same ceres-solver, through RDEPEND below.
RDEPEND="${PYTHON_DEPS}
	app-arch/zstd
	dev-cpp/gflags:=
	dev-cpp/glog:=
	dev-libs/boost:=[nls?]
	sci-libs/ceres-solver:=
	$(python_gen_cond_dep '
		dev-python/cattrs[${PYTHON_USEDEP}]
		dev-python/cython[${PYTHON_USEDEP}]
		dev-python/numpy[${PYTHON_USEDEP}]
		dev-python/requests[${PYTHON_USEDEP}]
		dev-python/zstandard[${PYTHON_USEDEP}]
	')
	media-libs/draco:=
	>=media-libs/freetype-2.13.3:=[brotli]
	media-libs/libepoxy:=
	media-libs/libjpeg-turbo:=
	>=media-libs/libpng-1.6.50:=
	media-libs/libsamplerate
	media-libs/meshoptimizer:=
	>=media-libs/openimageio-3.0.9.1:=
	virtual/glu
	virtual/libintl
	virtual/opengl[X?]
	virtual/zlib:=
	alembic? ( >=media-gfx/alembic-1.8.3-r2[boost(+),hdf(+)] )
	bullet? ( sci-physics/bullet:=[double-precision] )
	color-management? ( >=media-libs/opencolorio-2.0.0:= )
	cuda? ( dev-util/nvidia-cuda-toolkit:= )
	embree? ( media-libs/embree:=[raymask] )
	ffmpeg? ( media-video/ffmpeg:=[encode(+),lame(-),jpeg2k?,opus,theora,vorbis,vpx,x264,xvid] )
	fftw? ( sci-libs/fftw:3.0=[threads] )
	gmp? ( dev-libs/gmp:=[cxx] )
	gnome? ( gui-libs/libdecor )
	hip? (
		>=dev-util/hip-6.0:=
		hiprt? (
			dev-libs/hiprt:2.5=
		)
	)
	jack? ( virtual/jack )
	jemalloc? ( dev-libs/jemalloc:= )
	jpeg2k? ( >=media-libs/openjpeg-2.5.3:2= )
	manifold? ( >=sci-mathematics/manifold-3.2.1:= )
	ndof? (
		app-misc/spacenavd
		dev-libs/libspnav
	)
	nls? ( virtual/libiconv )
	openal? ( media-libs/openal )
	oidn? ( >=media-libs/oidn-2.1.0:= )
	openexr? (
		>=dev-libs/imath-3.2.0:=
		>=media-libs/openexr-3.3.5:0=
	)
	openpgl? ( media-libs/openpgl:= )
	opensubdiv? ( >=media-libs/opensubdiv-3.6.0-r2:=[opengl,cuda?,tbb?] )
	openvdb? (
		>=media-gfx/openvdb-12.1.0:=[nanovdb?]
		dev-libs/c-blosc:=
	)
	optix? (
		>=dev-libs/optix-8:=
		osl? (
			>=media-libs/osl-1.14[clang-cuda]
		)
	)
	osl? (
		>=media-libs/osl-1.14.7.0:=[${LLVM_USEDEP}]
		media-libs/mesa[${LLVM_USEDEP}]
	)
	pipewire? ( >=media-video/pipewire-1.1.0:= )
	pdf? ( >=media-libs/libharu-2.4.5:= )
	potrace? ( media-gfx/potrace )
	pugixml? ( dev-libs/pugixml )
	pulseaudio? ( media-libs/libpulse )
	rubberband? ( >=media-libs/rubberband-4.0.0:= )
	sdl? ( media-libs/libsdl2[sound,joystick] )
	sndfile? ( media-libs/libsndfile )
	tbb? ( dev-cpp/tbb:= )
	tiff? ( media-libs/tiff:= )
	valgrind? ( dev-debug/valgrind )
	wayland? (
		>=dev-libs/wayland-1.24.0
		>=dev-libs/wayland-protocols-1.15
		>=x11-libs/libxkbcommon-0.2.0
		dev-util/wayland-scanner
		media-libs/mesa[wayland]
		sys-apps/dbus
	)
	webp? ( media-libs/libwebp:= )
	vulkan? (
		media-libs/shaderc
		dev-util/spirv-tools
		dev-util/glslang
		media-libs/vulkan-loader
	)
	truetype? (
		media-libs/harfbuzz
	)
	renderdoc? (
		media-gfx/renderdoc
	)
	X? (
		x11-libs/libX11
		x11-libs/libXfixes
		x11-libs/libXi
		x11-libs/libXxf86vm
	)
"

DEPEND="${RDEPEND}
	dev-cpp/eigen:=
	test? (
		$(python_gen_cond_dep '
			media-libs/openimageio[jpeg2k,python,${PYTHON_SINGLE_USEDEP},tools]
		')
	)
"

if [[ "${PV}" == *9999* ]]; then
DEPEND+="
	test? (
		experimental? (
			wayland? (
				dev-libs/weston
			)
		)
	)
"
fi

BDEPEND="
	virtual/pkgconfig
	doc? (
		app-text/doxygen[dot]
		dev-python/sphinx[latex]
		dev-texlive/texlive-bibtexextra
		dev-texlive/texlive-fontsextra
		dev-texlive/texlive-fontutils
		dev-texlive/texlive-latex
		dev-texlive/texlive-latexextra
	)
	vulkan? (
		dev-util/spirv-headers
		dev-util/vulkan-headers
	)
	nls? ( sys-devel/gettext )
	wayland? (
		dev-util/wayland-scanner
	)
	X? (
		x11-base/xorg-proto
	)
"

# BENTOO-DIVERGENCE: PATCHES - FindClang rebased from ::gentoo's onto 4.0.2,
# plus an eigen-3.4 jacobiSvd fix for 5.1+. ::gentoo is on 5.0 and carries a
# system-glog patch this series does not need.
PATCHES=(
	"${FILESDIR}/${PN}-4.0.2-FindClang.patch"
	"${FILESDIR}/${PN}-4.1.1-FindLLVM.patch"
	"${FILESDIR}/${PN}-4.3.2-system-glog.patch"
	"${FILESDIR}/${PN}-5.1.0-eigen-3.4-jacobiSvd.patch"
	"${FILESDIR}/${PN}-5.2.1-cycles-explicit-instantiation.patch"
)

blender_check_requirements() {
	if use doc; then
		CHECKREQS_DISK_BUILD="4G" check-reqs_pkg_pretend
	fi
}

blender_get_version() {
	if [[ -n "${BV}" && -n "${BVC}" ]]; then
		return
	fi

	local status
	# Get blender version from blender itself.
	# mirrors build_files/cmake/macros.cmake function(get_blender_version)
	# NOTE maps x0y to x.y
	# TODO this can potentially break for x > 9 and y > 9
	BV="$(grep "define BLENDER_VERSION " source/blender/blenkernel/BKE_blender_version.h | cut -d ' ' -f 3)"
	status="$(pipestatus -v)" || die "fails to detect BLENDER_VERSION, (PIPESTATUS: ${status})"
	BV="$(printf "%d.%d" "${BV:0: -2}" "${BV: -2}")"

	if [[ "${PV}" != 9999* && "${BLENDER_BRANCH}" != "${BV}" ]]; then
		eerror "ebuild (${BLENDER_BRANCH}) and code (${BV}) version mismatch"
		die "blender_get_version"
	fi

	BVC="$(grep "define BLENDER_VERSION_CYCLE " source/blender/blenkernel/BKE_blender_version.h | cut -d ' ' -f 3)"
	status="$(pipestatus -v)" || die "fails to detect BLENDER_VERSION_CYCLE, (PIPESTATUS: ${status})"
}

pkg_pretend() {
	blender_check_requirements
}

pkg_setup() {
	blender_check_requirements
	python-single-r1_pkg_setup

	if use osl; then
		llvm-r2_pkg_setup
	fi
}

src_unpack() {
	if [[ "${PV}" == *9999* ]]; then
		if ! use test; then
			EGIT_SUBMODULES+=( '-tests/*' )
		fi
		git-r3_src_unpack
	else
		default

		# TODO
		if use test && [[ ${PV} != ${SLOT}.0 ]] ; then
			mv "blender-${BLENDER_BRANCH}.0/tests/"* "${S}/tests" || die
			rmdir -p "blender-${BLENDER_BRANCH}.0/tests/" || die
		fi
	fi

	# clear cmake_minimum_required
	rm -R "${S}/build_files/build_environment/patches" || die
}

src_prepare() {
	use cuda && cuda_src_prepare

	cmake_src_prepare

	blender_get_version

	# Prepare icons and .desktop files for slotting.
	sed \
		-e "s|blender.svg|blender-${BV}.svg|" \
		-e "s|blender-symbolic.svg|blender-${BV}-symbolic.svg|" \
		-e "s|blender.desktop|blender-${BV}.desktop|" \
		-e "s|org.blender.Blender.metainfo.xml|blender-${BV}.metainfo.xml|" \
		-i source/creator/CMakeLists.txt || die

	# 5.2 gave blender.svg a SECOND consumer, which source/creator no longer is
	# alone in being: windowmanager runs it through data_to_c to embed the icon
	# in the binary as blender_app_icon.svg.c, for the Wayland window icon.
	# The pattern is anchored on the path on purpose -- the loose "blender.svg"
	# used above also matches `datatoc_blender_svg`, an unrelated identifier
	# three lines below the reference.
	sed \
		-e "s|apps/blender\.svg|apps/blender-${BV}.svg|" \
		-i source/blender/windowmanager/CMakeLists.txt || die

	sed \
		-e "s|Name=Blender|Name=Blender ${BV}|" \
		-e "s|Exec=blender|Exec=blender-${BV}|" \
		-e "s|Icon=blender|Icon=blender-${BV}|" \
		-i release/freedesktop/blender.desktop || die

	sed \
		-e "/CMAKE_INSTALL_PREFIX_WITH_CONFIG/{s|\${CMAKE_INSTALL_PREFIX}|${T%/}\${CMAKE_INSTALL_PREFIX}|g}" \
		-i CMakeLists.txt \
		|| die CMAKE_INSTALL_PREFIX_WITH_CONFIG

	# WITH_SYSTEM_GLOG=yes
	cmake_run_in extern cmake_comment_add_subdirectory glog

	mv \
		"release/freedesktop/icons/scalable/apps/blender.svg" \
		"release/freedesktop/icons/scalable/apps/blender-${BV}.svg" \
		|| die
	mv \
		"release/freedesktop/icons/symbolic/apps/blender-symbolic.svg" \
		"release/freedesktop/icons/symbolic/apps/blender-${BV}-symbolic.svg" \
		|| die
	mv \
		"release/freedesktop/blender.desktop" \
		"release/freedesktop/blender-${BV}.desktop" \
		|| die

	mv \
		"release/freedesktop/org.blender.Blender.metainfo.xml" \
		"release/freedesktop/blender-${BV}.metainfo.xml" \
		|| die

	# Assert the rename above reached every consumer. This is a guard, not
	# decoration: the windowmanager reference handled just above appeared in
	# 5.2 and nothing caught it, because a missed one still CONFIGURES -- it
	# dies much later in src_compile with "missing and no known rule to make
	# it". Whatever the next release adds, it fails here, naming the file.
	local stale
	stale=$(grep -rl --include="CMakeLists.txt" --include="*.cmake" \
		-e "apps/blender\.svg" \
		-e "apps/blender-symbolic\.svg" \
		-e "freedesktop/blender\.desktop" \
		-e "org\.blender\.Blender\.metainfo\.xml" \
		. || true)
	[[ -z ${stale} ]] || die "unslotted resource name still referenced by: ${stale}"

	sed \
		-e "s#\(set(cycles_kernel_runtime_lib_target_path \)\${cycles_kernel_runtime_lib_target_path}\(/lib)\)#\1\${CYCLES_INSTALL_PATH}\2#" \
		-i intern/cycles/kernel/CMakeLists.txt \
		|| die

	if use hip; then
		# fix hardcoded path
		sed \
			-e "s#opt/rocm/hip/bin#$(hipconfig -p)/bin#g" \
			-i extern/hipew/src/hipew.c \
			|| die
	fi

	if use test; then
		# Without this the tests will try to use /usr/bin/blender and /usr/share/blender/ to run the tests.
		sed \
			-e "/string(REPLACE.*TEST_INSTALL_DIR/{s|\${CMAKE_INSTALL_PREFIX}|${T}\${CMAKE_INSTALL_PREFIX}|g}" \
			-i "build_files/cmake/testing.cmake" \
			|| die "REPLACE.*TEST_INSTALL_DIR"

		sed -e '1i #include <cstdint>' -i extern/gtest/src/gtest-death-test.cc || die
	else
		cmake_comment_add_subdirectory tests
	fi

	rm -rf extern/gflags || die
}

src_configure() {
	# -Werror=odr, -Werror=lto-type-mismatch
	# https://bugs.gentoo.org/859607
	# https://projects.blender.org/blender/blender/issues/120444
	filter-lto

	# Workaround for bug #922600
	append-ldflags "$(test-flags-CCLD -Wl,--undefined-version)"

	append-lfs-flags
	blender_get_version

	local mycmakeargs=(
		# we build a host-specific binary
		-DWITH_CPU_CHECK="no"

		-DWITH_STRICT_BUILD_OPTIONS="yes"
		-DWITH_LIBS_PRECOMPILED="no"
		-DBUILD_SHARED_LIBS="no" # quadriflow only?
		-DWITH_STATIC_LIBS=OFF

		# Build Options:
		-DWITH_ALEMBIC="$(usex alembic)"
		-DWITH_BOOST="yes"
		-DWITH_BULLET="$(usex bullet)"
		-DWITH_CYCLES="$(usex cycles)"
		-DWITH_DOC_MANPAGE="$(usex man)"
		-DWITH_FFTW3="$(usex fftw)"
		-DWITH_GMP="$(usex gmp)"
		-DWITH_GTESTS="$(usex test)"
		-DWITH_HARFBUZZ="$(usex truetype)"
		-DWITH_HARU="$(usex pdf)"
		-DWITH_HEADLESS="$(usex !X "$(usex !wayland)")"
		-DWITH_INPUT_NDOF="$(usex ndof)"
		-DWITH_INTERNATIONAL="$(usex nls)"
		-DWITH_MANIFOLD="$(usex manifold)"
		-DWITH_MATERIALX="no" # TODO: Package MaterialX
		-DWITH_NANOVDB="$(usex nanovdb)"
		-DWITH_OPENCOLORIO="$(usex color-management)"
		-DWITH_OPENGL_BACKEND="$(usex opengl)"
		-DWITH_OPENIMAGEDENOISE="$(usex oidn)"
		-DWITH_OPENSUBDIV="$(usex opensubdiv)"
		-DWITH_OPENVDB="$(usex openvdb)"
		-DWITH_OPENVDB_BLOSC="$(usex openvdb)"
		-DWITH_POTRACE="$(usex potrace)"
		-DWITH_PUGIXML="$(usex pugixml)"
		# -DWITH_QUADRIFLOW=ON
		-DWITH_RENDERDOC="$(usex renderdoc)"
		-DWITH_TBB="$(usex tbb)"
		-DWITH_UNITY_BUILD="no"
		-DWITH_USD="no" # TODO: Package USD
		-DWITH_VULKAN_BACKEND="$(usex vulkan)"
		-DWITH_XR_OPENXR="no"

		-DWITH_SYSTEM_BULLET="yes"
		-DWITH_SYSTEM_EIGEN3="yes"
		-DWITH_SYSTEM_FREETYPE="yes"
		-DWITH_SYSTEM_GFLAGS="yes"
		-DWITH_SYSTEM_GLOG="yes"

		# Compiler Options:
		# -DWITH_BUILDINFO="yes"

		# System Options:
		-DWITH_INSTALL_PORTABLE="no"
		-DWITH_MEM_JEMALLOC="$(usex jemalloc)"
		-DWITH_MEM_VALGRIND="$(usex valgrind)"

		# GHOST Options:
		-DWITH_GHOST_WAYLAND="$(usex wayland)"
		# -DWITH_GHOST_WAYLAND_APP_ID="blender-${BV}" # only visible with use wayland. see below
		-DWITH_GHOST_WAYLAND_DYNLOAD="no"
		-DWITH_GHOST_X11="$(usex X)"
		# -DWITH_GHOST_XDND=ON
		# -DWITH_X11_XFIXES=ON
		# -DWITH_X11_XINPUT=ON
		# -DWITH_GHOST_WAYLAND_DYNLOAD # visible wayland?
		# -DWITH_GHOST_WAYLAND_LIBDECOR # visible wayland?

		# Image Formats:
		# -DWITH_IMAGE_CINEON=ON
		-DWITH_IMAGE_OPENEXR="$(usex openexr)"
		-DWITH_IMAGE_OPENJPEG="$(usex jpeg2k)"
		-DWITH_IMAGE_WEBP="$(usex webp)" # unlisted

		# Audio:
		# -DWITH_AUDASPACE=OFF
		# -DWITH_SYSTEM_AUDASPACE=OFF
		-DWITH_CODEC_FFMPEG="$(usex ffmpeg)"
		-DWITH_CODEC_SNDFILE="$(usex sndfile)"
		# -DWITH_COREAUDIO=OFF
		-DWITH_JACK="$(usex jack)"
		# -DWITH_JACK_DYNLOAD=
		-DWITH_OPENAL="$(usex openal)"
		-DWITH_PIPEWIRE="$(usex pipewire)"
		# -DWITH_PIPEWIRE_DYNLOAD=
		-DWITH_PULSEAUDIO="$(usex pulseaudio)"
		# -DWITH_PULSEAUDIO_DYNLOAD=
		-DWITH_SDL="$(usex sdl)"
		# -DWITH_WASAPI=OFF

		# Python:
		# -DWITH_PYTHON=ON
		-DWITH_PYTHON_INSTALL="no"
		-DWITH_PYTHON_INSTALL_NUMPY="no"
		-DWITH_PYTHON_INSTALL_ZSTANDARD="no"
		# -DWITH_PYTHON_MODULE="no"
		-DWITH_PYTHON_SECURITY="yes"
		-DPYTHON_INCLUDE_DIR="$(python_get_includedir)"
		-DPYTHON_LIBRARY="$(python_get_library_path)"
		-DPYTHON_VERSION="${EPYTHON/python/}"
		# Both were vendored until 5.1 and are not any more: 5.2 ships only the
		# intern/{draco,meshoptimizer}_bridge/ glue, so these now resolve to
		# media-libs/draco and media-libs/meshoptimizer. WITH_STRICT_BUILD_OPTIONS
		# above turns each lookup into find_package(... REQUIRED), which is why
		# they are RDEPEND rather than optional -- without the system library the
		# package does not configure at all.
		-DWITH_DRACO="yes"
		-DWITH_MESHOPTIMIZER="yes"

		# Modifiers:
		-DWITH_MOD_FLUID="$(usex fluid)"
		-DWITH_MOD_OCEANSIM="$(usex fftw)"
		# -DWITH_MOD_REMESH=ON

		# Rendering:
		-DWITH_HYDRA="no" # TODO: Package Hydra

		# Rendering (Cycles):
		-DWITH_CYCLES_OSL="$(usex osl)"
		-DWITH_CYCLES_EMBREE="$(usex embree)"
		-DWITH_CYCLES_PATH_GUIDING="$(usex openpgl)"

		-DWITH_CYCLES_DEVICE_OPTIX="$(usex optix)"
		-DWITH_CYCLES_DEVICE_CUDA="$(usex cuda)"
		-DWITH_CYCLES_CUDA_BINARIES="$(usex cuda "$(usex cycles-bin-kernels)")"

		-DWITH_CYCLES_DEVICE_HIP="$(usex hip)"
		-DWITH_CYCLES_HIP_BINARIES="$(usex hip "$(usex cycles-bin-kernels)")"
		-DWITH_CYCLES_DEVICE_HIPRT="$(usex hip "$(usex hiprt)")"

		-DWITH_CYCLES_HYDRA_RENDER_DELEGATE="no" # TODO: package Hydra

		# -DWITH_CYCLES_STANDALONE=OFF
		# -DWITH_CYCLES_STANDALONE_GUI=OFF

		-DWITH_BLENDER_THUMBNAILER="yes"

		-DWITH_ASSERT_ABORT="$(usex debug)"
		-DWITH_ASSERT_RELEASE="no" # "$(usex debug)"

		# -DWITH_FREESTYLE=ON
		# -DWITH_IK_ITASC=ON
		# -DWITH_IK_SOLVER=ON
		# -DWITH_INPUT_IME=ON
		# -DWITH_LIBMV=ON
		# -DWITH_LIBMV_SCHUR_SPECIALIZATIONS=ON
		# -DWITH_UV_SLIM=ON
		-DWITH_NINJA_POOL_JOBS="yes"
		-DWITH_RUBBERBAND="$(usex rubberband)"
		# -DPOSTINSTALL_SCRIPT:PATH=""
		# -DPOSTCONFIGURE_SCRIPT:PATH=""
	)

	if has_version ">=dev-python/numpy-2"; then
		mycmakeargs+=(
			-DPYTHON_NUMPY_INCLUDE_DIRS="$(python_get_sitedir)/numpy/_core/include"
			-DPYTHON_NUMPY_PATH="$(python_get_sitedir)/numpy/_core/include"
		)
	fi

	# requires dev-vcs/git
	if [[ "${PV}" == *9999* && "${BVC}" == "alpha" ]]; then
		mycmakeargs+=(
			# -DWITH_BUILDINFO="no"
			-DWITH_EXPERIMENTAL_FEATURES="$(usex experimental)"
			# -DWITH_COMPILER_ASAN="yes"
			# -DWITH_STRSIZE_DEBUG="yes"
			# -DWITH_CYCLES_NATIVE_ONLY="yes"
			# -DWITH_LIBMV_SCHUR_SPECIALIZATIONS="no"
			# -DWITH_PYTHON_SAFETY="ON" # dev option

		)
	else
		mycmakeargs+=(
			-DWITH_BUILDINFO="yes"
			-DWITH_EXPERIMENTAL_FEATURES="OFF"
			-DWITH_PYTHON_SAFETY="OFF"
		)
	fi

	if use cuda; then
		# Ease compiling with required gcc similar to cuda_sanitize but for cmake
		if use cycles-bin-kernels; then
			local -x CUDAHOSTCXX="$(cuda_gccdir)"
			local -x CUDAHOSTLD="$(tc-getCXX)"

			if [[ -n "${CUDAARCHS}" ]]; then
				mycmakeargs+=(
					-DCYCLES_CUDA_BINARIES_ARCH="$(echo "${CUDAARCHS}" | sed -e 's/^/sm_/g' -e 's/;/;sm_/g')"
				)
			fi
		fi
	fi

	if use hip; then
		mycmakeargs+=(
			-DHIP_ROOT_DIR="$(hipconfig -p)"

			-DHIP_HIPCC_FLAGS="-fcf-protection=none"

			-DCMAKE_HIP_LINK_EXECUTABLE="$(get_llvm_prefix)/bin/clang++"

			-DCYCLES_HIP_BINARIES_ARCH="$(get_amdgpu_flags)"
		)

		if use hiprt; then
			mycmakeargs+=(
				# 5.2 dropped extern/hipew's hiprtew.cc dlopen wrapper, whose
				# hardcoded "libhiprt64.so" this ebuild used to rewrite in
				# src_prepare; Cycles now links HIPRT_LIBRARIES directly.
				# FindHIPRT.cmake searches HIPRT_ROOT_DIR under the lib64/lib/bin
				# suffixes, which is what reaches dev-libs/hiprt's slotted prefix,
				# and cmake.eclass's CMAKE_INSTALL_RPATH_USE_LINK_PATH puts that
				# directory in the RPATH so it also resolves at run time.
				-DHIPRT_ROOT_DIR="${ESYSROOT}/usr/lib/hiprt/2.5"
				-DHIPRT_COMPILER_PARALLEL_JOBS="$(makeopts_jobs)"
			)
		fi
	fi

	if use optix; then
		mycmakeargs+=(
			-DCYCLES_RUNTIME_OPTIX_ROOT_DIR="${ESYSROOT}/opt/optix"
			-DOPTIX_ROOT_DIR="${ESYSROOT}/opt/optix"
		)
	fi

	if use wayland; then
		mycmakeargs+=(
			-DWITH_GHOST_WAYLAND_APP_ID="blender-${BV}"
			-DWITH_GHOST_WAYLAND_LIBDECOR="$(usex gnome)"
		)
	fi

	# This is currently needed on arm64 to get the NEON SIMD wrapper to compile the code successfully
	use arm64 && append-flags -flax-vector-conversions

	# WITH_ASSERT_RELEASE filters this
	append-cflags "$(usex debug '-DDEBUG' '-DNDEBUG')"
	append-cxxflags "$(usex debug '-DDEBUG' '-DNDEBUG')"

	if tc-is-gcc; then
		# We disable these to respect the user's choice of linker.
		mycmakeargs+=(
			-DWITH_LINKER_GOLD="no"
		)
	fi

	if tc-is-clang || use osl; then
		mycmakeargs+=(
			-DWITH_CLANG="yes"
			-DWITH_LLVM="yes"
		)
	fi

	if use test; then
		local CYCLES_TEST_DEVICES=( "CPU" )
		if use cycles-bin-kernels; then
			use cuda && CYCLES_TEST_DEVICES+=( "CUDA" )
			use optix && CYCLES_TEST_DEVICES+=( "OPTIX" )
			use hip && CYCLES_TEST_DEVICES+=( "HIP" )
			use hiprt && CYCLES_TEST_DEVICES+=( "HIP-RT" )
		fi
		mycmakeargs+=(
			-DCMAKE_INSTALL_PREFIX_WITH_CONFIG="${T%/}/usr"
			-DCYCLES_TEST_DEVICES="$(local IFS=";"; echo "${CYCLES_TEST_DEVICES[*]}")"
		)

		# NOTE in lieu of a FEATURE/build_options
		if [[ "${EXPENSIVE_TESTS:-0}" -gt 0 ]]; then
			einfo "running expensive tests EXPENSIVE_TESTS=${EXPENSIVE_TESTS}"
			mycmakeargs+=(
				-DWITH_CYCLES_TEST_OSL="$(usex osl)"

				-DWITH_GPU_BACKEND_TESTS="yes"
				-DWITH_GPU_COMPOSITOR_TESTS="yes"

				-DWITH_GPU_DRAW_TESTS="yes"

				-DWITH_GPU_RENDER_TESTS="yes"
				-DWITH_GPU_RENDER_TESTS_HEADED="yes"
				# -DWITH_GPU_RENDER_TESTS_SILENT="yes"
				-DWITH_GPU_RENDER_TESTS_VULKAN="$(usex vulkan)"

				# Run Python script outside Blender, using system default Python3 interpreter,
				# NOT the one specified in `TEST_PYTHON_EXE`.
				-DWITH_SYSTEM_PYTHON_TESTS="yes"
				-DTEST_SYSTEM_PYTHON_EXE="${PYTHON}"

				# -DTEST_PYTHON_EXE="${T%/}/${EPYTHON}/bin/python"

				# -DWITH_LINUX_OFFICIAL_RELEASE_TESTS="yes" # Not needed?
			)

			if [[ "${PV}" == *9999* && "${BVC}" == "alpha" ]] && use experimental; then
				mycmakeargs+=(
					-DWITH_GPU_MESH_PAINT_TESTS="yes"
					# -DWITH_UI_TESTS="$(usex wayland)"
					-DWITH_UI_TESTS="yes"
					-DWITH_TESTS_EXPERIMENTAL="yes"

					# Enable user-interface tests using a headless display server.
					# Currently this depends on WITH_GHOST_WAYLAND and the weston compositor (Experimental)
					-DWITH_UI_TESTS_HEADLESS="$(usex !X "$(usex wayland)")"
					-DWESTON_BIN="${ESYSROOT}/usr/bin/weston"
				)
			fi
		else
			mycmakeargs+=(
				-DWITH_GPU_RENDER_TESTS="no"
			)
		fi
	fi

	cmake_src_configure
}

src_test() {
	# A lot of tests need to have access to the installed data files.
	# So install them into the image directory now.
	DESTDIR="${T%/}" cmake_build install

	blender_get_version
	# Define custom blender data/script file paths, or we won't be able to find them otherwise during testing.
	# (Because the data is in the image directory and it will default to look in /usr/share)
	local -x BLENDER_SYSTEM_RESOURCES="${T%/}/usr/share/blender/${BV}"

	# Sanity check that the script and datafile path is valid.
	# If they are not valid, blender will fallback to the default path which is not what we want.
	[[ -d "${BLENDER_SYSTEM_RESOURCES}" ]] || die "The custom resources path is invalid, fix the ebuild!"

	# TODO only picks first card
	addwrite "/dev/dri/card0"
	addwrite "/dev/dri/renderD128"

	[[ -c "/dev/udmabuf" ]] && addwrite "/dev/udmabuf"

	if use cuda; then
		cuda_add_sandbox -w
		addwrite "/proc/self/task"
		addpredict "/dev/char/"
	fi

	local -x CMAKE_SKIP_TESTS=(
		"^script_pyapi_bpy_driver_secure_eval$"
	)

	if [[ "${RUN_FAILING_TESTS:-0}" -eq 0 ]]; then
		einfo "not running failing tests RUN_FAILING_TESTS=${RUN_FAILING_TESTS}"
		CMAKE_SKIP_TESTS+=(
			# Does try to import from weird paths
			"^io_fbx_import$"
		)
	fi

	if ! has_version "media-libs/openusd"; then
		CMAKE_SKIP_TESTS+=(
			# from pxr import Usd # ModuleNotFoundError: No module named 'pxr'
			"^script_bundled_modules$"
		)
	fi

	if has_version ">=media-video/ffmpeg-8"; then
		CMAKE_SKIP_TESTS+=(
			# output change TODO
			"^sequencer_render_video_output$"
		)
	fi

	# For debugging, print out all information.
	local -x VERBOSE="$(usex debug "true" "false")"
	"${VERBOSE}" && einfo "VERBOSE=${VERBOSE}"

	local -x DEBUG="$(usex debug "true" "false")"
	"${DEBUG}" && einfo "DEBUG=${DEBUG}"

	# Show the window in the foreground.
	# local -x USE_WINDOW="true" # non-zero
	[[ -v USE_WINDOW ]] && einfo "USE_WINDOW=${USE_WINDOW}"

	# local -x USE_DEBUG="true" # non-zero
	[[ -v USE_DEBUG ]] && einfo "USE_DEBUG=${USE_DEBUG}"

	# Environment OPENIMAGEIO_CUDA=0 trumps everything else, turns off
	# Cuda functionality. We don't even initialize in this case.
	local -x OPENIMAGEIO_CUDA=0

	# Needed if openimageio wasn't build with -DNDEBUG
	local -x OPENIMAGEIO_DEBUG=0

	local -x CYCLESTEST_ARGS="-t 0"

	if [[ "${EXPENSIVE_TESTS:-0}" -gt 0 ]]; then
		einfo "running expensive tests EXPENSIVE_TESTS=${EXPENSIVE_TESTS}"
		if [[ "${PV}" == *9999* && "${BVC}" == "alpha" ]] &&
			use experimental && use wayland; then
				# This runs weston
				xdg_environment_reset
		fi

		if [[ "${USE_WINDOW}" == "true" ]]; then
			xdg_environment_reset
			# WITH_GPU_RENDER_TESTS_HEADED
			if use wayland; then
				local compositor exit_code
				local logfile=${T}/weston.log
				weston --xwayland --backend=headless --width=800 --height=600 --socket=wayland-5 --idle-time=0 2>"${logfile}" &
				compositor=$!
				local -x WAYLAND_DISPLAY=wayland-5
				sleep 1 # wait for xwayland to be up
				# TODO use eapi9-pipestatus
				local -x DISPLAY="$(grep "xserver listening on display" "${logfile}" | cut -d ' ' -f 5)"

				cmake_src_test

				exit_code=$?
				kill "${compositor}"
			elif use X; then
				virtx cmake_src_test
			fi
		else
			cmake_src_test
		fi
	else
		cmake_src_test
	fi

	# Clean up the image directory for src_install
	rm -fr "${T}/usr" || die
}

src_install() {
	blender_get_version

	# Pax mark blender for hardened support.
	pax-mark m "${BUILD_DIR}/bin/blender"

	cmake_src_install

	if use man; then
		# Slot the man page
		mv "${ED}/usr/share/man/man1/blender.1" "${ED}/usr/share/man/man1/blender-${BV}.1" || die
	fi

	if use doc; then
		# Define custom blender data/script file paths. Otherwise Blender will not be able to find them during doc building.
		# (Because the data is in the image directory and it will default to look in /usr/share)
		local -x BLENDER_SYSTEM_RESOURCES="${ED}/usr/share/blender/${BV}"

		# Workaround for binary drivers. # TODO
		addpredict /dev/ati
		addpredict /dev/dri
		addpredict /dev/nvidiactl

		cd "${CMAKE_USE_DIR}/doc/doxygen" || die
		sed -e "/^NUM_PROC_THREADS/s/1/$(makeopts_jobs)/" -i Doxyfile || die
		edob -m "Generating Blender C/C++ API docs ..." doxygen -u Doxyfile
		edob -m "Building API docs" doxygen

		cd "${CMAKE_USE_DIR}" || die
		einfo "Generating (BPY) Blender Python API docs ..."
		edo "${BUILD_DIR}"/bin/blender --background --python "doc/python_api/sphinx_doc_gen.py" -noaudio

		edo sphinx-build -j "$(makeopts_jobs)" doc/python_api/sphinx-in doc/python_api/BPY_API

		cd "${CMAKE_USE_DIR}" || die
		docinto "html/API/python"
		dodoc -r "doc/python_api/BPY_API/"

		docinto "html/API/blender"
		dodoc -r "doc/doxygen/html/"
	fi

	# Fix doc installdir
	docinto html
	dodoc "${CMAKE_USE_DIR}/release/text/readme.html"
	rm -r "${ED}/usr/share/doc/blender" || die

	python_optimize "${ED}/usr/share/blender/${BV}/scripts"

	mv "${ED}/usr/bin/blender-thumbnailer" "${ED}/usr/bin/blender-${BV}-thumbnailer" \
		|| die "blender-thumbnailer version rename failed"
	mv "${ED}/usr/bin/blender" "${ED}/usr/bin/blender-${BV}" || die "blender version rename failed"
}

pkg_postinst() {
	elog
	elog "Blender uses python integration. As such, may have some"
	elog "inherent risks with running unknown python scripts."
	elog
	elog "It is recommended to change your blender temp directory"
	elog "from /tmp to /home/user/tmp or another tmp file under your"
	elog "home directory. This can be done by starting blender, then"
	elog "changing the 'Temporary Files' directory in Blender preferences."
	elog

	if use osl && ! has_version "media-libs/mesa[${LLVM_USEDEP}]"; then
		ewarn ""
		ewarn "OSL is know to cause runtime segfaults if Mesa has been linked to"
		ewarn "an other LLVM version than what OSL is linked to."
		ewarn "See https://bugs.gentoo.org/880671 for more details"
		ewarn ""
	fi

	# build_files/cmake/Modules/FindPythonLibsUnix.cmake:39 --
	# set(_PYTHON_VERSION_SUPPORTED 3.13). Re-read that line on a series bump;
	# it moved from 3.11 to 3.13 without anything here noticing.
	#
	# Deliberately NOT `use python_single_target_python3_13`. `use` DIES on a
	# flag that is not in IUSE, and PYTHON_COMPAT moves out from under a
	# hardcoded one -- which is precisely how this block broke: it still tested
	# python3_11 after PYTHON_COMPAT became ( python3_{12..14} ), so EVERY merge
	# died here, after the package was already recorded as installed and before
	# the xdg cache updates below could run. EPYTHON is exported into the saved
	# environment, so it is readable in pkg_postinst and cannot fail that way.
	#
	# The comparison is inequality, not "newer than": PYTHON_COMPAT spans both
	# sides of the supported version now, and 3.12 is as unsupported as 3.14.
	local blender_python_supported="3.13"
	if [[ ${EPYTHON#python} != "${blender_python_supported}" ]]; then
		elog "You are building Blender against Python ${EPYTHON#python}, which is"
		elog "not the version upstream supports for this release"
		elog "(${blender_python_supported})."
		elog "If you experience breakages with e.g. plugins, switch to"
		elog "PYTHON_SINGLE_TARGET: python3_${blender_python_supported#3.} instead."
		elog "Bug: https://bugs.gentoo.org/737388"
		elog
	fi

	xdg_icon_cache_update
	xdg_mimeinfo_database_update
	xdg_desktop_database_update
}

pkg_postrm() {
	xdg_icon_cache_update
	xdg_mimeinfo_database_update
	xdg_desktop_database_update

	if [[ -z "${REPLACED_BY_VERSION}" ]]; then
		ewarn
		ewarn "You may want to remove the following directories"
		ewarn "- ~/.config/${PN}/${BV}/cache/"
		ewarn "- ~/.cache/cycles/"
		ewarn "It may contain extra render kernels not tracked by portage"
		ewarn
	fi
}

pkg_info () {
	debugvars () {
		local var
		for var in "${@}"; do
			[[ -v "${var}" ]] && echo "${var}: ${!var}"
		done
	}

	local blender_info_vars=(
		CUDACXX
		CUDAHOSTCXX
		CUDAHOSTLD
		CUDAARCHS
		CUDAFLAGS
		CUDA_PATH
		CUDA_VERBOSE
		NVCCFLAGS
		NVCC_PREPEND_FLAGS
		NVCC_APPPEND_FLAGS
	)

	debugvars "${blender_info_vars[@]}"
}