Bitmap Filename Resolution Functions

Functions
BMMExport int	BMMGetFullFilename (BitmapInfo *bi)
	These functions search the system for a bitmap.
BMMExport BOOL	BMMGetFullFilename (const MCHAR *namein, MCHAR *nameout, size_t nameoutSize)
	Resolves the given input name (namein) into the given output (nameout)

Detailed Description

Function Documentation

BMMGetFullFilename() [1/2]

BMMExport int BMMGetFullFilename

(

BitmapInfo *

bi

)

These functions search the system for a bitmap.

The input parameter contains the name of the bitmap that is searched for (bi->Name() or namein). If the filename from the input is incorrect, and the bitmap is found somewhere else, these functions set the output (bi->Name() or nameout) with the correct path. When using the second version, you must specify the size in characters of the nameout buffer using nameoutSize. If the buffer is not big enough to hold the output (including a null terminator), the result is truncated.

The order of the search is as follows:

• The full UNC path/filename indicated in the input object.
• The path where the current 3ds Max file was loaded from.
• The directory tree under the directory where the current Max files was loaded.
• The Map path.

  Returns

  TRUE if the file was found; otherwise FALSE. Resolves the filename in the given BitmapInfo (bi->Name())

BMMGetFullFilename() [2/2]

BMMExport BOOL BMMGetFullFilename	(	const MCHAR *	namein,
		MCHAR *	nameout,
		size_t	nameoutSize
	)

Resolves the given input name (namein) into the given output (nameout)