<HTML>
	<HEAD>
		<TITLE>Reference manual for David Piuva's graphics engine</TITLE>
	</HEAD>
	<BODY>
		<link rel="stylesheet" type="text/css" href="PageStyle.css">
		<A href="../Manual.html">Back to main page</A>
<P>		<b>Texture</b>
<P>	<IMG SRC="Images/Border.png">
<P>		<IMG SRC="Images/Star.png"> int Texture_Load_InSB(void);
<P>		I have chosen to only allow 4 file extensions (*.dds, *.bmp, *.png and *.jpg) for images so that loading is fast but extensionless. Therefor, you can change the file format of an image without having to rewrite everything that is using it.
<P>		<IMG SRC="Images/PreCondition.png"> The string buffer must contain an extensionless filename with less than 256 characters of an image. The engine will look for YourFileName.dds, YourFileName.bmp, YourFileName.png and YourFileName.jpg.
<P>		<IMG SRC="Images/PostCondition.png"> The ID to the new or reused texture.
<P>		<IMG SRC="Images/SideEffect.png"> Loads the texture if it haven't been loaded yet and locks it from being deleted by the engine.
<P>	<IMG SRC="Images/Border.png">
<P>		<IMG SRC="Images/Trashcan.png"> void Texture_Unlock(int Texture);
<P>			Unlocking is affecting the use of Engine_RemoveUnusedResources.
<P>			<IMG SRC="Images/PreCondition.png"> Texture is a valid and locked texture reference.
<P>			<IMG SRC="Images/SideEffect.png"> Unlocks the texture to tell the garbage collection that you aren't using it and the engine can delete it when nothing else is using it.
<P>	<IMG SRC="Images/Border.png">
<P>		<IMG SRC="Images/LeftArrow.png"> int Texture_GetWidth(int Texture);
<P>		<IMG SRC="Images/PreCondition.png"> Texture is a valid texture reference.
<P>		<IMG SRC="Images/PostCondition.png"> Returns the width of the texture or 0 if failed.
<P>	<IMG SRC="Images/LightBorder.png">
<P>		<IMG SRC="Images/LeftArrow.png"> int Texture_GetHeight(int Texture);
<P>		<IMG SRC="Images/PreCondition.png"> Texture is a valid texture reference.
<P>		<IMG SRC="Images/PostCondition.png"> Returns the height of the texture or 0 if failed.
<P>	<IMG SRC="Images/Border.png">
<P>		<IMG SRC="Images/LeftArrow.png"> void Texture_GetFilename_OutSB(int Texture);
<P>		<IMG SRC="Images/PreCondition.png">  Texture is a valid texture reference.
<P>		<IMG SRC="Images/SideEffect.png"> Writes Texture's extensionless filename to the string buffer. If you for example loaded "MyImage.jpg", "MyImage" will be returned to the string buffer.
<P>	<IMG SRC="Images/Border.png">
<P>		<IMG SRC="Images/RightArrow.png"> void Texture_UseAsDefaultTexture(int Texture);
<P>			The default texture is used instead of (0,0,0,0) when a shader is sampling a texture or draw surface that do not exist. It works with both material shaders and post effect shaders.
<P>			<IMG SRC="Images/PreCondition.png"> Texture is a valid and locked texture reference or 0 for using (0,0,0,0) again.
<P>			<IMG SRC="Images/SideEffect.png"> Texture is used as the default texture. Giving 0 will set the default texture to NULL so that shaders will get (0,0,0,0) from sampling nothing.
<P>	<IMG SRC="Images/LightBorder.png">
<P>		<IMG SRC="Images/RightArrow.png"> void Texture_UseAsLightProjectionAtlas(int Texture);
<P>			The light projection atlas is used together with UV rectangles instead of one texture per light source because the texture registers are limited in graphics cards and one instance can be drawn with all light sources at the same time.
<P>			<IMG SRC="Images/PreCondition.png"> Texture is a valid and locked texture reference or 0 for using the default texture again.
<P>			<IMG SRC="Images/SideEffect.png"> Texture is used as the light projection atlas that will be used by image projecting spot lights. Giving 0 will use the default texture again.
<P>	<IMG SRC="Images/Border.png">
	</BODY>
</HTML>