CONTENTS

Functions

Synopsis

return CSM TEXTURE CREATE( new image name As String, existing image media ID As Integer ) As Integer

Purpose

Use this function to create a new texture entry in the map file.  Once you've created a new texture with a name and image media ID, you can assign this texture to any surface of any mesh in your map file using CSM TEXTURE MESH.  Please note that if you're going to replace textures at runtime, the size of the texture must be a multiple of 16 for the width or height.  i.e.  16x32, 64x64, 128x64 etc.

Parameters

new image name

A string specifying the name to be assigned to the new texture entry.

existing image media ID

An image media ID to assign to the new texture.  This would be the same ID that is used when calling the LOAD IMAGE command.

Return value

Returns the texture index of the new texture entry.  Or -1 on failure.