GetBrushTexture(brush[,index=0])

Parameters

brush - brush handle
index (optional) - index of texture applied to brush, from 0-7. Defaults to 0.

Description

Returns the texture that is applied to the specified brush.

The optional index parameter allows you to specify which particular texture you'd like returning, if there are more than one textures applied to a brush.

You should release the texture returned by GetBrushTexture after use to prevent leaks! Use FreeTexture to do this.

To find out the name of the texture, use TextureName

See also: TextureName, FreeTexture, GetEntityBrush, GetSurfaceBrush.

Example

; GetBrushTexture Example
; -----------------------

Graphics3D 640,480
SetBuffer BackBuffer()

camera=CreateCamera()

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

; Load mesh
crate=LoadMesh("media/wood-crate/wcrate1.3ds")
PositionEntity crate,0,0,100

; Get mesh surface
surf=GetSurface(crate,1)

; Get surface brush
crate_brush=GetSurfaceBrush(surf)

; Get brush texture
crate_tex=GetBrushTexture(crate_brush,0)

While Not KeyDown( 1 )

RenderWorld

; Display full texture name
Text 0,0,"Texture name, as returned by TextureName$():"
Text 0,20,TextureName$(crate_tex)

; Display trimmed texture name
Text 0,40,"Texture name with path stripped:"
Text 0,60,StripPath$(TextureName$(crate_tex))

Flip

Wend

End

Function StripPath$(file$)

If Len(file$)>0

For i=Len(file$) To 1 Step -1

mi$=Mid$(file$,i,1)
If mi$="\" Or mi$="/" Then Return name$ Else name$=mi$+name$

Next

EndIf

Return name$

End Function

Index

Click here to view the latest version of this page online