libcmo21/LibCmo/VxMath/VxMath.hpp

#include "../VTUtils.hpp"
#include "../CK2/CKTypes.hpp"
#include "VxTypes.hpp"

namespace LibCmo::VxMath {

	// ========== Structure copying ==========
	
	/**
	 * @brief Fills a memory buffer with a source buffer pattern.
	 * @param Count[in] Number of element to set in the destination buffer
	 * @param Dst[out] Destination buffer
	 * @param Stride[in] Amount in bytes between each element in the destination buffer
	 * @param SizeSrc[in] Size in bytes of an element int the Src buffer
	 * @param Src[in] Source buffer
	 * @remark This function can be used to initialized an array of structure when only some members should be modified.
	*/
	void VxFillStructure(CK2::CKDWORD Count, void* Dst, CK2::CKDWORD Stride, CK2::CKDWORD SizeSrc, const void* Src); 
	/**
	 * @brief copies an array of elements between two memory buffers.
	 * @param Count[in] Number of element to copy in the destination buffer
	 * @param Dst[out] Destination buffer
	 * @param OutStride[in] Amount in bytes between each element in the destination buffer
	 * @param SizeSrc[in] Size in bytes of an element
	 * @param Src[in] Source buffer.
	 * @param InStride[in] Amount in bytes between each element in the source buffer
	 * @remark This function can be used to initialized an array of structure when only some members should be modified.
	*/
	void VxCopyStructure(CK2::CKDWORD Count, void* Dst, CK2::CKDWORD OutStride, CK2::CKDWORD SizeSrc, const void* Src, CK2::CKDWORD InStride);
	
	// ========== Graphic Utilities ==========
	//
	///**
	// * @brief Copy origin image to dest image.
	// * Supporting for size scaling. If the size is matched, just a direct copy.
	// * @param dest[out] The dest image.
	// * @param origin[in] The origin image.
	//*/
	//void VxDoBlit(VxImageDescEx* dst, const VxImageDescEx* origin);

	///**
	// * @brief Counts number of bits to representing a value in dwMask
	//*/
	//CK2::CKDWORD VxGetBitCount(CK2::CKDWORD dwMask);
	///**
	// * @brief Counts number of bits to shift to acces a non zero value in dwMask.
	//*/
	//CK2::CKDWORD VxGetBitShift(CK2::CKDWORD dwMask);

	///**
	// * @brief scale the integer to a new range.
	// * @param val The int need to be scale
	// * @param srcBitCount The bit count which source integer consumed.
	// * @param dstBitCount The bit count which dest integer consumed.
	// * @remark This function usually used in image color factor assign with mask.
	// * @return The result integer.
	//*/
	//CK2::CKDWORD VxScaleFactor(CK2::CKDWORD val, CK2::CKDWORD srcBitCount, CK2::CKDWORD dstBitCount);

	/**
	 * @brief Sets the alpha component of an image.
	 * @param dst_desc[in] A pointer to a structure describing the destination image format.
	 * @param AlphaValue[in] A CKBYTE value containing the alpha value to set to the whole image
	 * @remark If the destination image does not have alpha information the function returns immediatly.
	*/
	void VxDoAlphaBlit(VxImageDescEx* dst_desc, CK2::CKBYTE AlphaValue);
	/**
	 * @brief Sets the alpha component of an image.
	 * @param dst_desc[in] A pointer to a structure describing the destination image format.
	 * @param AlphaValues[in] A BYTE array containing the alpha values for each pixel. This array should be allocated to Width*Height bytes.
	 * @remark If the destination image does not have alpha information the function returns immediatly.
	*/
	void VxDoAlphaBlit(VxImageDescEx* dst_desc, CK2::CKBYTE* AlphaValues);

}