openFileSystemFolder()

a simple function to open up a file system folder window on a given directory

example uses
openFileSystemFolder("c:"); // does what you would expect
openFileSystemFolder("c:/tmp"); // also does what you would expect
openFileSystemFolder("common"); // opens the folder "common" in the current working directory.
openFileSystemFolder("common/foo.txt"); // formats harddrive. just kidding, it does nothing.


this is based on a TGE 1.3.5 codebase.
it works in windows vista (and therefore probably all previous flavours of windows),
but there's only non-functional stubs for Mac and Unix.

the core of this should work on all C-based flavours of torque,
but it might need some tweaking.

platform.h
add this line somewhere in the public section of the Platform struct:

static bool openFileSystemFolder(const char* folderPath);

winWindow.cc
find a nice spot and add this function:

// returns true on success, false otherwise
bool Platform::openFileSystemFolder(const char* folderPath)
{
   // convert forward slashes to backwards ones
   U32 destSize = dStrlen(folderPath) + 1;
   char* dest = strreplace(folderPath, destSize, "/", "");

   // http://msdn.microsoft.com/en-us/library/bb762153(VS.85).aspx
   int ret = (int)ShellExecute(NULL, "explore", dest, NULL, NULL, SW_SHOWNORMAL);

   delete [] dest;

   return ret > 32;
}

macCarbWindow.cc
find a nice place and add this stub:

// returns true on success, false otherwise
bool Platform::openFileSystemFolder(const char* folderPath)
{
   NSAutoreleasePool* pool = [[NSAutoreleasePool alloc] init];
   
   NSString *nsDir = [NSString stringWithCString:dir encoding:[NSString defaultCStringEncoding]];
   
   BOOL status = [[NSWorkspace sharedWorkspace] selectFile:nil inFileViewerRootedAtPath:nsDir];
   [pool release];
   
   return status;
}

alternate mac implementation:

// returns true on success, false otherwise
bool Platform::openFileSystemFolder(const char* folderPath)
{
   return [[NSWorkspace sharedWorkspace] openFile:[NSString stringWithUTF8String:folderPath]];  
}

x86UNIXWindow.cc
find a nice place and add this stub:

// returns true on success, false otherwise
bool Platform::openFileSystemFolder(const char* folderPath)
{
   Con::errorf("%s() - unimplemented", __FUNCTION__);
   return false;
}

game.cc
add this console function:

ConsoleFunction( openFileSystemFolder, bool, 2, 2, "( path )" )
{
    return Platform::openFileSystemFolder(argv[1]);
}