An example from the help file...
CreateSurface
Surfaces are sections of mesh which are then used to attach triangles to. You must have at least one surface per mesh in order to create a visible mesh, however you can use as many as you like. Splitting a mesh up into lots of sections allows you to affect those sections individually, which can be a lot more useful than if all the surfaces are combined into just one.
mesh = CreateMesh()
surf = CreateSurface(mesh)
v0 = AddVertex (surf, -5,-5,0, 0 ,0)
v1 = AddVertex (surf, 5,-5,0, 1 ,0)
v2 = AddVertex (surf, 0, 5,0, 0.5,1)
tri = AddTriangle (surf,v0,v2,v1)
Brush
A brush is a collection of properties such as Colour, Alpha, Shininess, Texture etc that are all stored as part of the brush. Then, all these properties can be applied to an entity, mesh or surface at once just by using PaintEntity, PaintMesh or PaintSurface.
When creating your own mesh, if you wish for certain surfaces to look differently from one another, then you will need to use brushes to paint individual surfaces. Using commands such as EntityColor, EntityAlpha will apply the effect to all surfaces at once, which may not be what you wish to achieve.
cube=CreateCube()
PositionEntity cube,0,0,5
; Load texture
tex=LoadTexture("media/b3dlogo.jpg")
; Create brush
brush=CreateBrush()
; Apply texture to brush
BrushTexture brush,tex
; And some shininess
BrushShininess brush,1
; Paint mesh with brush
PaintMesh cube,brush
I love my Altair 8800 Replica.
http://altairclone.com/