// Copyright 2019-2023, Collabora, Ltd.
// SPDX-License-Identifier: BSL-1.0
/*!
 * @file
 * @brief  Independent semaphore implementation.
 * @author Jakob Bornecrantz <jakob@collabora.com>
 * @ingroup comp_util
 */

#pragma once

#include "xrt/xrt_compositor.h"
#include "vk/vk_helpers.h"


#ifdef __cplusplus
extern "C" {
#endif


/*!
 * A simple implementation of the xrt_compositor_semaphore interface.
 *
 * @ingroup comp_util
 * @implements xrt_compositor_swapchain
 * @see comp_compositor
 */
struct comp_semaphore
{
	struct xrt_compositor_semaphore base;

	struct vk_bundle *vk;

	VkSemaphore semaphore;

	/*!
	 * Shared handle, the layer above compositor, such as IPC & st/oxr,
	 * doesn't consume this handle, instead it has dup  semantics. So we
	 * need to keep track of the handle and free it once done. This is
	 * because the platform may be required by the platform.
	 */
	xrt_graphics_sync_handle_t handle;
};


/*
 *
 * Helper functions.
 *
 */

/*!
 * Convenience function to convert an xrt_compositor_semaphore to a comp_semaphore.
 *
 * @ingroup comp_util
 * @private @memberof comp_semaphore
 */
static inline struct comp_semaphore *
comp_semaphore(struct xrt_compositor_semaphore *xcsem)
{
	return (struct comp_semaphore *)xcsem;
}


/*
 *
 * 'Exported' functions.
 *
 */

/*!
 * Creates a @ref comp_semaphore, used to implement compositor functionality.
 *
 * @ingroup comp_util
 */
xrt_result_t
comp_semaphore_create(struct vk_bundle *vk,
                      xrt_graphics_sync_handle_t *out_handle,
                      struct xrt_compositor_semaphore **out_xcsem);


#ifdef __cplusplus
}
#endif