/*
 *  Flo's Open libRary (floor)
 *  Copyright (C) 2004 - 2026 Florian Ziesche
 *  
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; version 2 of the License only.
 *  
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *  
 *  You should have received a copy of the GNU General Public License along
 *  with this program; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#pragma once

#if defined(FLOOR_DEVICE_METAL)

// note that this is identical to sampler_t (when compiling in Metal mode), but also necessary here, b/c of conversion requirements
using metal_sampler_t = constant struct _sampler_t*;

//
namespace fl::metal_image {
	//////////////////////////////////////////
	// sampler type, as defined by apple
	// NOTE: only the constexpr version is supported right now
	struct sampler {
		enum ADDRESS_MODE {
			CLAMP_TO_ZERO		= 0,
			CLAMP_TO_EDGE		= 1,
			REPEAT				= 2,
			MIRRORED_REPEAT		= 3,
			CLAMP_TO_BORDER		= 4
		};
		enum FILTER_MODE {
			NEAREST				= 0,
			LINEAR				= 1,
			// Apple GPUs only
			BICUBIC				= 2,
		};
		enum MIP_FILTER_MODE {
			MIP_NONE			= 0,
			MIP_NEAREST			= 1,
			MIP_LINEAR			= 2
		};
		enum COORD_MODE {
			NORMALIZED			= 0,
			PIXEL				= 1
		};
		enum COMPARE_FUNCTION {
			NONE				= 0,
			LESS				= 1,
			LESS_EQUAL			= 2,
			GREATER				= 3,
			GREATER_EQUAL		= 4,
			EQUAL				= 5,
			NOT_EQUAL			= 6,
			ALWAYS				= 7,
			NEVER				= 8
		};
		enum BORDER_COLOR {
			TRANSPARENT_BLACK	= 0,
			OPAQUE_BLACK		= 1,
			OPAQUE_WHITE		= 2
		};
		enum REDUCTION {
			WEIGHTED_AVERAGE	= 0,
			MINIMUM				= 1,
			MAXIMUM				= 2
		};
		
		union {
			struct {
				// address modes
				uint64_t s_address : 3;
				uint64_t t_address : 3;
				uint64_t r_address : 3;
				
				// filter modes
				uint64_t mag_filter : 2;
				uint64_t min_filter : 2;
				uint64_t mip_filter : 2;
				
				// coord mode
				uint64_t coord_mode : 1;
				
				// compare function
				uint64_t compare_function : 4;
				
				// anisotropic filtering (N - 1)
				uint64_t anisotropy : 4;
				
				// LOD min/max clamping (half floats)
				uint64_t lod_clamp_min : 16;
				uint64_t lod_clamp_max : 16;
				
				// border color
				uint64_t border_color : 2;
				
				// reduction
				uint64_t reduction : 2;
				
				// currently unused/reserved
				uint64_t _unused : 3;
				
				// constant sampler flag
				uint64_t is_constant : 1;
			};
			uint64_t value;
		};
		
		// is_constant is no longer set with Metal 3.2+
#if FLOOR_DEVICE_METAL_MAJOR > 3 || (FLOOR_DEVICE_METAL_MAJOR == 3 && FLOOR_DEVICE_METAL_MINOR >= 2)
		static constexpr const uint64_t is_constant_init { 0u };
#else
		static constexpr const uint64_t is_constant_init { 1u };
#endif
		
		// must be known at compile-time for now
		constexpr sampler(const ADDRESS_MODE address_mode = CLAMP_TO_EDGE,
						  const COORD_MODE coord_mode_ = PIXEL,
						  const FILTER_MODE filter_mode = NEAREST,
						  const MIP_FILTER_MODE mip_filter_mode = MIP_NONE,
						  const COMPARE_FUNCTION compare_function_ = NEVER) :
		s_address(address_mode), t_address(address_mode), r_address(address_mode),
		coord_mode(coord_mode_),
		mag_filter(filter_mode), min_filter(filter_mode),
		mip_filter(mip_filter_mode),
		compare_function(compare_function_),
		anisotropy(filter_mode == NEAREST ? 0u : 15u),
		lod_clamp_min(0), lod_clamp_max(0x7BFF /* __HALF_MAX__ */),
		border_color(TRANSPARENT_BLACK),
		reduction(WEIGHTED_AVERAGE),
		_unused(0u), is_constant(is_constant_init) {}
		
		constexpr sampler(const sampler& s) :
		s_address(s.s_address), t_address(s.t_address), r_address(s.r_address),
		mag_filter(s.mag_filter), min_filter(s.min_filter), mip_filter(s.mip_filter),
		coord_mode(s.coord_mode),
		compare_function(s.compare_function),
		anisotropy(s.anisotropy),
		lod_clamp_min(0), lod_clamp_max(0x7BFF /* __HALF_MAX__ */),
		border_color(TRANSPARENT_BLACK),
		reduction(WEIGHTED_AVERAGE),
		_unused(0u), is_constant(is_constant_init) {}
		
		// provide metal_sampler_t conversion, so the builtin sampler_t can be initialized
		operator metal_sampler_t() const {
			return (metal_sampler_t)value;
		}
		
		// unavailable
		void operator=(const sampler&) = delete;
		void operator&() = delete;
	};
	static_assert(sizeof(sampler) == 8, "invalid sampler size");
	
} // namespace fl::metal_image

#endif
