FreeTexture texture  

Parameters:

texture - texture handle

Description:

Frees up a texture. This will allow the memory that it occupied before to be used for other purposes.

Freeing a texture means you will not be able to use it again; however, entities already textured with it will not lose the texture.

Example:

; FreeTexture Example
; -------------------

Graphics3D 640,480
SetBuffer BackBuffer()

camera=CreateCamera()

light=CreateLight()
RotateEntity light,90,0,0

cube=CreateCube()
PositionEntity cube,0,0,5

; Load texture
tex=LoadTexture("../media/b3dlogo.jpg")

; Texture cube with texture
EntityTexture cube,tex

While Not KeyDown( 1 )

; If spacebar pressed then free texture
If KeyHit( 57 )=True Then FreeTexture tex

pitch#=0
yaw#=0
roll#=0

If KeyDown( 208 )=True Then pitch#=-1
If KeyDown( 200 )=True Then pitch#=1
If KeyDown( 203 )=True Then yaw#=-1
If KeyDown( 205 )=True Then yaw#=1
If KeyDown( 45 )=True Then roll#=-1
If KeyDown( 44 )=True Then roll#=1

TurnEntity cube,pitch#,yaw#,roll#

RenderWorld
Text 0,0,"Press spacebar to free texture"
Text 0,20,"As you can see this will not effect already textured entities"
Flip

Wend

End

Index