3ds Max C++ API Reference
Bitmap Filename Resolution Functions

Functions

BMMExport int BMMGetFullFilename (BitmapInfo *bi)
 These functions search the system for a bitmap. More...
 
BMMExport BOOL BMMGetFullFilename (const MCHAR *namein, MCHAR *nameout, size_t nameoutSize)
 

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.

◆ BMMGetFullFilename() [2/2]

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