systemutilities.h

Go to the documentation of this file.

//***************************************************************************
// Copyright 2008 Autodesk, Inc.  All rights reserved.
// Use of this software is subject to the terms of the Autodesk license agreement 
// provided at the time of installation or download, or which otherwise accompanies 
// this software in either electronic or hard copy form.
//***************************************************************************

#pragma once

#ifndef _STRBASICS_
#   include "strbasic.h"                // MCHAR
#endif

#include "strclass.h"

UtilExport bool IsDebugging();

UtilExport int  NumberOfProcessors();

UtilExport bool IsWindows9x();

UtilExport bool IsWindows98or2000();

UtilExport int  GetScreenWidth();

UtilExport int GetScreenHeight();

UtilExport bool IsGetACPAsian();

namespace MaxSDK
{
namespace Util
{
    UtilExport WORD GetLanguageID();

    UtilExport const MCHAR* GetLanguageTLA();

    UtilExport bool CopyToClipBoard(const MCHAR* text, HWND hwnd);

} // end namespace Util
} // end namespace MaxSDK

// CSIDL functions added 030110  --prs.

UtilExport HRESULT UtilGetFolderPath(
    HWND hwndOwner, // just calls SFGetFolderPath()
    int nFolder, 
    HANDLE hToken, 
    DWORD dwFlags, 
    LPTSTR pszPath);

// negative indices, refer to specCSID[] array in systemutilities.cpp



#define APP_MAP_DIR            -1
#define APP_FOLIAGE_DIR        -2
#define APP_XREF_DIR           -3
#define APP_PLUGIN_INI_DIR     -4
#define APP_STDPLUGS_DIR       -5
#define APP_PLUGINS_DIR        -6
#define APP_FILELINK_DIR       -7
#define APP_CATALOGS_DIR       -8
#define APP_CUI_SCRIPTS_DIR    -9   // added 030224  --prs.
// xavier robitaille | 03.02.05 | add textures dir. to bitmap paths
#ifdef TEXTURES_DIR_BMP_SEARCH_PATH
#define APP_INT_OFFSET         -1
#define APP_TEXTURES_DIR       -10
#else
#define APP_INT_OFFSET         0
#endif
#define APP_CUI_DIR                 -10 + APP_INT_OFFSET
#define APP_FX_DIR                  -11 + APP_INT_OFFSET    //!< Returns the hardware shader directory set in Configure Paths
#define APP_CUI_WRITE_DIR           -12 + APP_INT_OFFSET
#define APP_MARKET_DEF_WRITE_DIR    -13 + APP_INT_OFFSET
#define APP_LAST_SPEC_DIR           -13 + APP_INT_OFFSET



UtilExport bool IsUsingProfileDirectories();


UtilExport bool IsUsingRoamingProfiles();


UtilExport bool GetSpecDir(int index, const MCHAR *dirName, MCHAR *buf);    // get directory path


UtilExport bool TryCSIDLDir(int csidl, const MCHAR *dirName, MCHAR *buf);   // create directory path

UtilExport BOOL IsSSE();

namespace MaxSDK
{
namespace Util
{
    /* \brief scans a parent folder and all sub-folders for a file
       
       this function scans a directory tree (a parent folder and all sub-folders) in search of a file with the file name 'filename'.
       if filename is found, it returns true and an absolute path is saved in the parameter 'targetPath'. If 
       'filename' is not found, it returns false and the parameter targetpath is left unchanged

       param[in] treeroot absolute path to the parent directory
       param[in] filename the file that you are searching for
       param[out] the absolute path to the file you are searching for

       /returns true if if filename is successfully found, false otherwise
    */
    UtilExport bool ScanDirectoryTree(const MCHAR *treeroot, const MCHAR *filename, MSTR& targetpath );

} // end namespace Util
} // end namespace MaxSDK