/**
 * @file XTPMarkupGdiPlusTransformObject.h
 *
 * @copyright
 * (c) 1998-2025 Codejock Software, All Rights Reserved.
 *
 * This source file is the property of Codejock Software and must not be
 * redistributed by any means without the explicit written permission of
 * Codejock Software.
 *
 * The use of this source code is governed by the terms and conditions specified
 * in the Toolkit Pro license agreement. Codejock Software grants you, as a
 * single software developer, the limited right to use this software on one
 * computer only.
 *
 * Contact Information:
 * support@codejock.com
 * http://www.codejock.com
 *
 */

#if !defined(__XTPMARKUPGDIPLUSTRANSFORMOBJECT_H__)
#	define __XTPMARKUPGDIPLUSTRANSFORMOBJECT_H__

#	if _MSC_VER > 1000
#		pragma once
#	endif // _MSC_VER > 1000

#	include "Common/Base/Diagnostic/XTPDisableNoisyWarnings.h"

class CXTPMarkupTransformationMatrix;
class CXTPGdiPlus;

/**
 * @brief
 * Implements GDI+ markup matrix access and delegates the actual
 * transformation to a derived class.
 */
class _XTP_EXT_CLASS CXTPMarkupGdiPlusTransformObjectImpl
{
public:
	/**
	 * Handles object destruction
	 */
	virtual ~CXTPMarkupGdiPlusTransformObjectImpl()
	{
	}

protected:
	/**
	 * @brief
	 * Prevents a class from being instantiated.
	 */
	CXTPMarkupGdiPlusTransformObjectImpl();

	/**
	 * @brief
	 * An abstract method that performs a native GDI+ matrix transformation.
	 * @param pReserved Reserved. Not used.
	 * @param pMatrix   Native GDI+ matrix to transform instance pointer.
	 * @return
	 * TRUE if successful.
	 */
	virtual BOOL TransformMatrix(const CXTPGdiPlus* pReserved, GpMatrix* pMatrix) = 0;

	/**
	 * @brief
	 * Applies abstract transformation on a markup transformation matrix.
	 * @param pMatrix Pointer to a markup transformation matrix to be transformed.
	 * @return
	 * A pointer to the transformed markup matrix if successful,
	 * NULL if failed or not supported. It is the responsibility
	 * of the callee to delete the returned object.
	 */
	CXTPMarkupTransformationMatrix* ApplyTransform(const CXTPMarkupTransformationMatrix* pMatrix);
};

AFX_INLINE CXTPMarkupGdiPlusTransformObjectImpl::CXTPMarkupGdiPlusTransformObjectImpl()
{
}

/**
 * @brief
 * Base class for all GDI+ markup transformation objects.
 * @param BaseTransform A target transformation class.
 */
template<class BaseTransform>
class CXTPMarkupGdiPlusTransformObject
	: public BaseTransform
	, protected CXTPMarkupGdiPlusTransformObjectImpl
{
protected:
	/**
	 * @brief
	 * Prevents a class from being instantiated.
	 */
	CXTPMarkupGdiPlusTransformObject();

private:
	/**
	 * @brief
	 * Applies abstract transformation on a markup transformation matrix.
	 * @param pMatrix Pointer to a markup transformation matrix to be transformed.
	 * @return
	 * A pointer to the transformed markup matrix if successful,
	 * NULL if failed or not supported. It is the responsibility
	 * of the callee to delete the returned object.
	 */
	virtual CXTPMarkupTransformationMatrix*
		ApplyTransform(const CXTPMarkupTransformationMatrix* pMatrix);
};

template<class BaseTransform>
AFX_INLINE CXTPMarkupGdiPlusTransformObject<BaseTransform>::CXTPMarkupGdiPlusTransformObject()
{
}

template<class BaseTransform>
AFX_INLINE CXTPMarkupTransformationMatrix*
	CXTPMarkupGdiPlusTransformObject<BaseTransform>::ApplyTransform(
		const CXTPMarkupTransformationMatrix* pMatrix)
{
	return CXTPMarkupGdiPlusTransformObjectImpl::ApplyTransform(pMatrix);
}

#	include "Common/Base/Diagnostic/XTPEnableNoisyWarnings.h"
/** @cond */
#endif // !defined(__XTPMARKUPGDIPLUSTRANSFORMOBJECT_H__)
/** @endcond */