1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Various utilities
4 // Author: Stefan Csomor
8 // Copyright: (c) Stefan Csomor
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
13 // Note: this is done in utilscmn.cpp now.
14 // #pragma implementation "utils.h"
20 #include "wx/apptrait.h"
23 #include "wx/mac/uma.h"
34 # include "MoreFilesX.h"
36 # include "MoreFiles.h"
37 # include "MoreFilesExtras.h"
45 #include "ATSUnicode.h"
46 #include "TextCommon.h"
47 #include "TextEncodingConverter.h"
49 #include "wx/mac/private.h" // includes mac headers
51 #if defined(__MWERKS__) && wxUSE_UNICODE
55 // ---------------------------------------------------------------------------
56 // code used in both base and GUI compilation
57 // ---------------------------------------------------------------------------
59 // our OS version is the same in non GUI and GUI cases
60 static int DoGetOSVersion(int *majorVsn
, int *minorVsn
)
64 // are there x-platform conventions ?
66 Gestalt(gestaltSystemVersion
, &theSystem
) ;
67 if (minorVsn
!= NULL
) {
68 *minorVsn
= (theSystem
& 0xFF ) ;
70 if (majorVsn
!= NULL
) {
71 *majorVsn
= (theSystem
>> 8 ) ;
83 // defined in unix/utilsunx.cpp for Mac OS X
85 // get full hostname (with domain name if possible)
86 bool wxGetFullHostName(wxChar
*buf
, int maxSize
)
88 return wxGetHostName(buf
, maxSize
);
91 // Get hostname only (without domain name)
92 bool wxGetHostName(wxChar
*buf
, int maxSize
)
94 // Gets Chooser name of user by examining a System resource.
96 const short kComputerNameID
= -16413;
98 short oldResFile
= CurResFile() ;
100 StringHandle chooserName
= (StringHandle
)::GetString(kComputerNameID
);
101 UseResFile(oldResFile
);
103 if (chooserName
&& *chooserName
)
105 HLock( (Handle
) chooserName
) ;
106 wxString name
= wxMacMakeStringFromPascal( *chooserName
) ;
107 HUnlock( (Handle
) chooserName
) ;
108 ReleaseResource( (Handle
) chooserName
) ;
109 wxStrncpy( buf
, name
, maxSize
- 1 ) ;
117 // Get user ID e.g. jacs
118 bool wxGetUserId(wxChar
*buf
, int maxSize
)
120 return wxGetUserName( buf
, maxSize
) ;
123 const wxChar
* wxGetHomeDir(wxString
*pstr
)
125 *pstr
= wxMacFindFolder( (short) kOnSystemDisk
, kPreferencesFolderType
, kDontCreateFolder
) ;
126 return pstr
->c_str() ;
129 // Get user name e.g. Stefan Csomor
130 bool wxGetUserName(wxChar
*buf
, int maxSize
)
132 // Gets Chooser name of user by examining a System resource.
134 const short kChooserNameID
= -16096;
136 short oldResFile
= CurResFile() ;
138 StringHandle chooserName
= (StringHandle
)::GetString(kChooserNameID
);
139 UseResFile(oldResFile
);
141 if (chooserName
&& *chooserName
)
143 HLock( (Handle
) chooserName
) ;
144 wxString name
= wxMacMakeStringFromPascal( *chooserName
) ;
145 HUnlock( (Handle
) chooserName
) ;
146 ReleaseResource( (Handle
) chooserName
) ;
147 wxStrncpy( buf
, name
, maxSize
- 1 ) ;
155 int wxKill(long pid
, wxSignal sig
, wxKillError
*rc
)
161 WXDLLEXPORT
bool wxGetEnv(const wxString
& var
, wxString
*value
)
163 // TODO : under classic there is no environement support, under X yes
167 // set the env var name to the given value, return TRUE on success
168 WXDLLEXPORT
bool wxSetEnv(const wxString
& var
, const wxChar
*value
)
170 // TODO : under classic there is no environement support, under X yes
175 // Execute a program in an Interactive Shell
177 bool wxShell(const wxString
& command
)
183 // Shutdown or reboot the PC
184 bool wxShutdown(wxShutdownFlags wFlags
)
190 // Get free memory in bytes, or -1 if cannot determine amount (e.g. on UNIX)
191 long wxGetFreeMemory()
196 void wxUsleep(unsigned long milliseconds
)
198 clock_t start
= clock() ;
202 } while( clock() - start
< milliseconds
/ 1000.0 * CLOCKS_PER_SEC
) ;
205 void wxSleep(int nSecs
)
207 wxUsleep(1000*nSecs
);
210 // Consume all events until no more left
215 #endif // !__DARWIN__
223 wxToolkitInfo
& wxConsoleAppTraits::GetToolkitInfo()
225 static wxToolkitInfo info
;
226 info
.os
= DoGetOSVersion(&info
.versionMajor
, &info
.versionMinor
);
227 info
.name
= _T("wxBase");
235 wxToolkitInfo
& wxGUIAppTraits::GetToolkitInfo()
237 static wxToolkitInfo info
;
238 info
.os
= DoGetOSVersion(&info
.versionMajor
, &info
.versionMinor
);
239 info
.shortName
= _T("mac");
240 info
.name
= _T("wxMac");
241 #ifdef __WXUNIVERSAL__
242 info
.shortName
<< _T("univ");
243 info
.name
<< _T("/wxUniversal");
248 // Reading and writing resources (eg WIN.INI, .Xdefaults)
250 bool wxWriteResource(const wxString
& section
, const wxString
& entry
, const wxString
& value
, const wxString
& file
)
256 bool wxWriteResource(const wxString
& section
, const wxString
& entry
, float value
, const wxString
& file
)
259 buf
.Printf(wxT("%.4f"), value
);
261 return wxWriteResource(section
, entry
, buf
, file
);
264 bool wxWriteResource(const wxString
& section
, const wxString
& entry
, long value
, const wxString
& file
)
267 buf
.Printf(wxT("%ld"), value
);
269 return wxWriteResource(section
, entry
, buf
, file
);
272 bool wxWriteResource(const wxString
& section
, const wxString
& entry
, int value
, const wxString
& file
)
275 buf
.Printf(wxT("%d"), value
);
277 return wxWriteResource(section
, entry
, buf
, file
);
280 bool wxGetResource(const wxString
& section
, const wxString
& entry
, char **value
, const wxString
& file
)
286 bool wxGetResource(const wxString
& section
, const wxString
& entry
, float *value
, const wxString
& file
)
289 bool succ
= wxGetResource(section
, entry
, (char **)&s
, file
);
292 *value
= (float)strtod(s
, NULL
);
299 bool wxGetResource(const wxString
& section
, const wxString
& entry
, long *value
, const wxString
& file
)
302 bool succ
= wxGetResource(section
, entry
, (char **)&s
, file
);
305 *value
= strtol(s
, NULL
, 10);
312 bool wxGetResource(const wxString
& section
, const wxString
& entry
, int *value
, const wxString
& file
)
315 bool succ
= wxGetResource(section
, entry
, (char **)&s
, file
);
318 *value
= (int)strtol(s
, NULL
, 10);
324 #endif // wxUSE_RESOURCES
326 int gs_wxBusyCursorCount
= 0;
327 extern wxCursor gMacCurrentCursor
;
328 wxCursor gMacStoredActiveCursor
;
330 // Set the cursor to the busy cursor for all windows
331 void wxBeginBusyCursor(wxCursor
*cursor
)
333 if (gs_wxBusyCursorCount
++ == 0)
335 gMacStoredActiveCursor
= gMacCurrentCursor
;
336 cursor
->MacInstall() ;
338 //else: nothing to do, already set
341 // Restore cursor to normal
342 void wxEndBusyCursor()
344 wxCHECK_RET( gs_wxBusyCursorCount
> 0,
345 wxT("no matching wxBeginBusyCursor() for wxEndBusyCursor()") );
347 if (--gs_wxBusyCursorCount
== 0)
349 gMacStoredActiveCursor
.MacInstall() ;
350 gMacStoredActiveCursor
= wxNullCursor
;
354 // TRUE if we're between the above two calls
357 return (gs_wxBusyCursorCount
> 0);
364 wxString
wxMacFindFolder( short vol
,
366 Boolean createFolder
)
372 if ( FindFolder( vol
, folderType
, createFolder
, &vRefNum
, &dirID
) == noErr
)
375 if ( FSMakeFSSpec( vRefNum
, dirID
, "\p" , &file
) == noErr
)
377 strDir
= wxMacFSSpec2MacFilename( &file
) + wxFILE_SEP_PATH
;
387 // Check whether this window wants to process messages, e.g. Stop button
388 // in long calculations.
389 bool wxCheckForInterrupt(wxWindow
*wnd
)
395 void wxGetMousePosition( int* x
, int* y
)
400 LocalToGlobal( &pt
) ;
405 // Return TRUE if we have a colour display
406 bool wxColourDisplay()
411 // Returns depth of screen
415 SetRect(&globRect
, -32760, -32760, 32760, 32760);
416 GDHandle theMaxDevice
;
419 theMaxDevice
= GetMaxDevice(&globRect
);
420 if (theMaxDevice
!= nil
)
421 theDepth
= (**(**theMaxDevice
).gdPMap
).pixelSize
;
426 // Get size of display
427 void wxDisplaySize(int *width
, int *height
)
430 GetQDGlobalsScreenBits( &screenBits
);
433 *width
= screenBits
.bounds
.right
- screenBits
.bounds
.left
;
435 if (height
!= NULL
) {
436 *height
= screenBits
.bounds
.bottom
- screenBits
.bounds
.top
;
440 void wxDisplaySizeMM(int *width
, int *height
)
442 wxDisplaySize(width
, height
);
443 // on mac 72 is fixed (at least now ;-)
444 float cvPt2Mm
= 25.4 / 72;
447 *width
= int( *width
* cvPt2Mm
);
449 if (height
!= NULL
) {
450 *height
= int( *height
* cvPt2Mm
);
454 void wxClientDisplayRect(int *x
, int *y
, int *width
, int *height
)
457 GetQDGlobalsScreenBits( &screenBits
);
463 *width
= screenBits
.bounds
.right
- screenBits
.bounds
.left
;
465 if (height
!= NULL
) {
466 *height
= screenBits
.bounds
.bottom
- screenBits
.bounds
.top
;
471 GetThemeMenuBarHeight( &mheight
) ;
473 mheight
= LMGetMBarHeight() ;
475 if (height
!= NULL
) {
482 wxWindow
* wxFindWindowAtPoint(const wxPoint
& pt
)
484 return wxGenericFindWindowAtPoint(pt
);
491 wxString
wxGetOsDescription()
493 #ifdef WXWIN_OS_DESCRIPTION
494 // use configure generated description if available
495 return wxString(wxT("MacOS (")) + wxT(WXWIN_OS_DESCRIPTION
) + wxString(wxT(")"));
497 return wxT("MacOS") ; //TODO:define further
502 wxChar
*wxGetUserHome (const wxString
& user
)
508 bool wxGetDiskSpace(const wxString
& path
, wxLongLong
*pTotal
, wxLongLong
*pFree
)
518 int pos
= p
.Find(':') ;
519 if ( pos
!= wxNOT_FOUND
) {
528 wxMacStringToPascal( p
, volumeName
) ;
529 OSErr err
= XGetVolumeInfoNoName( volumeName
, 0 , &pb
) ;
530 if ( err
== noErr
) {
532 (*pTotal
) = wxLongLong( pb
.ioVTotalBytes
) ;
535 (*pFree
) = wxLongLong( pb
.ioVFreeBytes
) ;
539 return err
== noErr
;
541 #endif // !__DARWIN__
543 //---------------------------------------------------------------------------
544 // wxMac Specific utility functions
545 //---------------------------------------------------------------------------
549 char StringMac
[] = "\x0d\x80\x81\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d\x8e\x8f"
550 "\x90\x91\x92\x93\x94\x95\x96\x97\x98\x99\x9a\x9b\x9c\x9d\x9e\x9f"
551 "\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xab\xac\xae\xaf"
552 "\xb1\xb4\xb5\xb6\xbb\xbc\xbe\xbf"
553 "\xc0\xc1\xc2\xc4\xc7\xc8\xc9\xcb\xcc\xcd\xce\xcf"
554 "\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd8\xca\xdb" ;
556 char StringANSI
[] = "\x0a\xC4\xC5\xC7\xC9\xD1\xD6\xDC\xE1\xE0\xE2\xE4\xE3\xE5\xE7\xE9\xE8"
557 "\xEA\xEB\xED\xEC\xEE\xEF\xF1\xF3\xF2\xF4\xF6\xF5\xFA\xF9\xFB\xFC"
558 "\x86\xBA\xA2\xA3\xA7\x95\xB6\xDF\xAE\xA9\x99\xB4\xA8\xC6\xD8"
559 "\xB1\xA5\xB5\xF0\xAA\xBA\xE6\xF8"
560 "\xBF\xA1\xAC\x83\xAB\xBB\x85\xC0\xC3\xD5\x8C\x9C"
561 "\x96\x97\x93\x94\x91\x92\xF7\xFF\xA0\x80" ;
563 void wxMacConvertFromPC( const char *from
, char *to
, int len
)
568 for( int i
= 0 ; i
< len
; ++ i
)
570 c
= strchr( StringANSI
, *from
) ;
573 *to
= StringMac
[ c
- StringANSI
] ;
581 for( int i
= 0 ; i
< len
; ++ i
)
583 c
= strchr( StringANSI
, *from
) ;
586 *to
= StringMac
[ c
- StringANSI
] ;
598 void wxMacConvertToPC( const char *from
, char *to
, int len
)
603 for( int i
= 0 ; i
< len
; ++ i
)
605 c
= strchr( StringMac
, *from
) ;
608 *to
= StringANSI
[ c
- StringMac
] ;
616 for( int i
= 0 ; i
< len
; ++ i
)
618 c
= strchr( StringMac
, *from
) ;
621 *to
= StringANSI
[ c
- StringMac
] ;
633 TECObjectRef s_TECNativeCToUnicode
= NULL
;
634 TECObjectRef s_TECUnicodeToNativeC
= NULL
;
636 void wxMacSetupConverters()
638 // if we assume errors are happening here we need low level debugging
639 // since the high level assert will use the encoders that are not yet
642 const TextEncodingBase kEncoding
= CFStringGetSystemEncoding();
644 const TextEncodingBase kEncoding
= kTextEncodingMacRoman
;
646 OSStatus status
= noErr
;
647 status
= TECCreateConverter(&s_TECNativeCToUnicode
,
649 kTextEncodingUnicodeDefault
);
652 status
= TECCreateConverter(&s_TECUnicodeToNativeC
,
653 kTextEncodingUnicodeDefault
,
657 void wxMacCleanupConverters()
659 OSStatus status
= noErr
;
660 status
= TECDisposeConverter(s_TECNativeCToUnicode
);
662 status
= TECDisposeConverter(s_TECUnicodeToNativeC
);
665 wxWCharBuffer
wxMacStringToWString( const wxString
&from
)
668 wxWCharBuffer
result( from
.wc_str() ) ;
670 OSStatus status
= noErr
;
671 ByteCount byteOutLen
;
672 ByteCount byteInLen
= from
.Length() ;
673 ByteCount byteBufferLen
= byteInLen
*2 ;
674 wxWCharBuffer
result( from
.Length() ) ;
675 status
= TECConvertText(s_TECNativeCToUnicode
, (ConstTextPtr
)from
.c_str() , byteInLen
, &byteInLen
,
676 (TextPtr
)result
.data(), byteBufferLen
, &byteOutLen
);
677 result
.data()[byteOutLen
/2] = 0 ;
683 wxString
wxMacMakeStringFromCString( const char * from
, int len
)
685 OSStatus status
= noErr
;
687 wxChar
* buf
= result
.GetWriteBuf( len
) ;
689 ByteCount byteOutLen
;
690 ByteCount byteInLen
= len
;
691 ByteCount byteBufferLen
= len
*2 ;
693 status
= TECConvertText(s_TECNativeCToUnicode
, (ConstTextPtr
)from
, byteInLen
, &byteInLen
,
694 (TextPtr
)buf
, byteBufferLen
, &byteOutLen
);
696 memcpy( buf
, from
, len
) ;
699 result
.UngetWriteBuf() ;
703 wxString
wxMacMakeStringFromCString( const char * from
)
705 return wxMacMakeStringFromCString( from
, strlen(from
) ) ;
708 wxCharBuffer
wxMacStringToCString( const wxString
&from
)
711 OSStatus status
= noErr
;
712 ByteCount byteOutLen
;
713 ByteCount byteInLen
= from
.Length() * 2 ;
714 ByteCount byteBufferLen
= from
.Length() ;
715 wxCharBuffer
result( from
.Length() ) ;
716 status
= TECConvertText(s_TECUnicodeToNativeC
, (ConstTextPtr
)from
.wc_str() , byteInLen
, &byteInLen
,
717 (TextPtr
)result
.data(), byteBufferLen
, &byteOutLen
);
720 return wxCharBuffer( from
.c_str() ) ;
725 void wxMacStringToPascal( const wxString
&from
, StringPtr to
)
727 wxCharBuffer buf
= from
.mb_str( wxConvLocal
) ;
728 int len
= strlen(buf
) ;
733 memcpy( (char*) &to
[1] , buf
, len
) ;
736 wxString
wxMacMakeStringFromPascal( ConstStringPtr from
)
738 return wxString( (char*) &from
[1] , wxConvLocal
, from
[0] ) ;
747 // CFStringRefs (Carbon only)
751 // converts this string into a carbon foundation string with optional pc 2 mac encoding
752 void wxMacCFStringHolder::Assign( const wxString
&st
)
755 wxMacConvertNewlines13To10( &str
) ;
757 m_cfs
= CFStringCreateWithCharacters( kCFAllocatorDefault
,
758 (const unsigned short*)str
.wc_str(), str
.Len() );
760 m_cfs
= CFStringCreateWithCString( kCFAllocatorSystemDefault
, str
.c_str() ,
761 CFStringGetSystemEncoding() ) ;
766 wxString
wxMacCFStringHolder::AsString()
769 Size len
= CFStringGetLength( m_cfs
) ;
770 wxChar
* buf
= result
.GetWriteBuf( len
) ;
772 CFStringGetCharacters( m_cfs
, CFRangeMake( 0 , len
) , (UniChar
*) buf
) ;
774 CFStringGetCString( m_cfs
, buf
, len
+1 , CFStringGetSystemEncoding() ) ;
777 wxMacConvertNewlines10To13( buf
) ;
778 result
.UngetWriteBuf() ;
782 #endif //TARGET_CARBON
784 void wxMacConvertNewlines13To10( char * data
)
787 while( (buf
=strchr(buf
,0x0d)) != NULL
)
794 void wxMacConvertNewlines10To13( char * data
)
797 while( (buf
=strchr(buf
,0x0a)) != NULL
)
804 void wxMacConvertNewlines13To10( wxString
* data
)
806 size_t len
= data
->Length() ;
808 if ( len
== 0 || wxStrchr(data
->c_str(),0x0d)==NULL
)
811 wxString
temp(*data
) ;
812 wxStringBuffer
buf(*data
,len
) ;
813 memcpy( buf
, temp
.c_str() , (len
+1)*sizeof(wxChar
) ) ;
815 wxMacConvertNewlines13To10( buf
) ;
818 void wxMacConvertNewlines10To13( wxString
* data
)
820 size_t len
= data
->Length() ;
822 if ( data
->Length() == 0 || wxStrchr(data
->c_str(),0x0a)==NULL
)
825 wxString
temp(*data
) ;
826 wxStringBuffer
buf(*data
,len
) ;
827 memcpy( buf
, temp
.c_str() , (len
+1)*sizeof(wxChar
) ) ;
828 wxMacConvertNewlines10To13( buf
) ;
833 void wxMacConvertNewlines13To10( wxChar
* data
)
835 wxChar
* buf
= data
;
836 while( (buf
=wxStrchr(buf
,0x0d)) != NULL
)
843 void wxMacConvertNewlines10To13( wxChar
* data
)
845 wxChar
* buf
= data
;
846 while( (buf
=wxStrchr(buf
,0x0a)) != NULL
)
854 // ----------------------------------------------------------------------------
856 // ----------------------------------------------------------------------------
858 #if defined(__WXMAC__) && !defined(__DARWIN__) && defined(__MWERKS__) && (__MWERKS__ >= 0x2400)
860 // MetroNub stuff doesn't seem to work in CodeWarrior 5.3 Carbon builds...
862 #ifndef __MetroNubUtils__
863 #include "MetroNubUtils.h"
870 #if TARGET_API_MAC_CARBON
872 #include <CodeFragments.h>
874 extern "C" long CallUniversalProc(UniversalProcPtr theProcPtr
, ProcInfoType procInfo
, ...);
876 ProcPtr gCallUniversalProc_Proc
= NULL
;
880 static MetroNubUserEntryBlock
* gMetroNubEntry
= NULL
;
882 static long fRunOnce
= false;
884 /* ---------------------------------------------------------------------------
886 --------------------------------------------------------------------------- */
888 Boolean
IsMetroNubInstalled()
895 gMetroNubEntry
= NULL
;
897 if (Gestalt(gestaltSystemVersion
, &value
) == noErr
&& value
< 0x1000)
899 /* look for MetroNub's Gestalt selector */
900 if (Gestalt(kMetroNubUserSignature
, &result
) == noErr
)
903 #if TARGET_API_MAC_CARBON
904 if (gCallUniversalProc_Proc
== NULL
)
906 CFragConnectionID connectionID
;
909 ProcPtr symbolAddress
;
911 CFragSymbolClass symbolClass
;
913 symbolAddress
= NULL
;
914 err
= GetSharedLibrary("\pInterfaceLib", kPowerPCCFragArch
, kFindCFrag
,
915 &connectionID
, &mainAddress
, errorString
);
919 gCallUniversalProc_Proc
= NULL
;
923 err
= FindSymbol(connectionID
, "\pCallUniversalProc",
924 (Ptr
*) &gCallUniversalProc_Proc
, &symbolClass
);
928 gCallUniversalProc_Proc
= NULL
;
935 MetroNubUserEntryBlock
* block
= (MetroNubUserEntryBlock
*)result
;
937 /* make sure the version of the API is compatible */
938 if (block
->apiLowVersion
<= kMetroNubUserAPIVersion
&&
939 kMetroNubUserAPIVersion
<= block
->apiHiVersion
)
940 gMetroNubEntry
= block
; /* success! */
949 #if TARGET_API_MAC_CARBON
950 return (gMetroNubEntry
!= NULL
&& gCallUniversalProc_Proc
!= NULL
);
952 return (gMetroNubEntry
!= NULL
);
956 /* ---------------------------------------------------------------------------
957 IsMWDebuggerRunning [v1 API]
958 --------------------------------------------------------------------------- */
960 Boolean
IsMWDebuggerRunning()
962 if (IsMetroNubInstalled())
963 return CallIsDebuggerRunningProc(gMetroNubEntry
->isDebuggerRunning
);
968 /* ---------------------------------------------------------------------------
969 AmIBeingMWDebugged [v1 API]
970 --------------------------------------------------------------------------- */
972 Boolean
AmIBeingMWDebugged()
974 if (IsMetroNubInstalled())
975 return CallAmIBeingDebuggedProc(gMetroNubEntry
->amIBeingDebugged
);
980 extern bool WXDLLEXPORT
wxIsDebuggerRunning()
982 return IsMWDebuggerRunning() && AmIBeingMWDebugged();
987 extern bool WXDLLEXPORT
wxIsDebuggerRunning()
992 #endif // defined(__WXMAC__) && !defined(__DARWIN__) && (__MWERKS__ >= 0x2400)