Index of /tcltk/carboncritlib

      Name                    Last modified       Size  Description


[DIR] Parent Directory        19-Apr-2008 02:54      -  
[   ] Makefile                25-Oct-2007 05:04     1k  
[   ] bgexec.tcl              29-Sep-2005 02:49   103k  
[   ] carboncritlib-1.0.ta..> 01-May-2005 16:51    39k  
[   ] carboncritlib-1.1.0...> 06-Oct-2007 11:10    42k  
[   ] carboncritlib-1.1.1...> 25-Oct-2007 05:42    41k  
[   ] carboncritlib-1.1.ta..> 25-Oct-2007 05:42    41k  
[   ] carboncritlib.tar.gz    25-Oct-2007 05:42    41k  
[   ] license.terms           01-May-2005 16:50     2k  
[   ] tclAuthorization.tcl    06-Oct-2007 10:15    10k  
[   ] tclCHUDtime.tcl         25-Oct-2007 05:32    18k  
[   ] tclCarbonHICommand.tcl  06-Oct-2007 10:58     6k  
[   ] tclCarbonHelp.tcl       06-Oct-2007 10:33     5k  
[   ] tclCarbonNotificatio..> 06-Oct-2007 10:17     5k  
[   ] tclCarbonProcesses.tcl  06-Oct-2007 10:17    11k  

CarbonCritLib 1.1
-----------------

RCS: @(#) $Id$

Copyright (c) 2005-2007, Daniel A. Steffen <das@users.sourceforge.net>

	http://rutherglen.ics.mq.edu.au/~steffen/tcltk/carboncritlib/

This is a collection of critcl bindiings to Carbon and other Mac OS X APIs, see
the *.tcl implementation files for full details.

BSD License: c.f. <http://www.opensource.org/licenses/bsd-license>


tclCarbonHICommand
------------------
wrapper for Mac OS X HICommand Carbon Event Manager services:

	carbon::processHICommand commandID toplevel
		takes a Carbon HICommand ID (4 char string, c.f.
		CarbonEvents.h), and either the name of a toplevel window (for
		window specific HICommands) or an empty string (for menu
		specific HICommands) and calls ProcessHICommand() with the
		resulting HICommandExtended structure.

	carbon::enableMenuCommand commandID disable
		takes a Carbon HICommand ID (4 char string, c.f. CarbonEvents.h)
		of a menu specific HICommand, and a flag specifing whether to
		enable (0) or disable (1) the associated menu item.

tclCarbonNotification
---------------------
wrapper for Mac OS X Notification Manager services:

	carbon::notification msg bounce
		installs a Carbon notification request with the given msg,
		setting the bounce flag will also cause the application icon in
		the dock to bounce. An empty msg will not post a notification
		dialog but only cause the application icon to bounce.
	
	carbon::endNotification
		removes a notification request installed with
		[carbon::notification].

tclCarbonProcesses
------------------
wrapper for Mac OS X Process Manager services:

	carbon::getCurrentProcess
		returns the process serial number of the current process.

	carbon::getFrontProcess
		returns the process serial number of the front process.

	carbon::getProcesses
		returns a list of process serial numbers of all processes.

	carbon::getProcessInformation psn
		returns a list of key-value pairs of process information for the
		given process serial number.

	carbon::getProcessForPID psn
		returns the process serial number of the process with the given
		pid.

	carbon::setFrontProcess psn ?frontWindowOnly?
		activates the process of given process serial number and brings
		all its windows to the front (or only the frontmost window if
		the frontWindowOnly flag is set).

	carbon::showHideProcess psn visible
		shows or hides the process of given process serial number,
		depending on the visible flag.

	carbon::setProcessName psn name
		sets the application menu name of the given process.

tclCarbonHelp
------------------
wrapper for Mac OS X Apple Help services: (based on Kevin Walzer's tclAppleHelp)

	carbon::registerHelpBook
		registers the main bundle's Info.plist help book.

	carbon::gotoHelpBook bookName
		loads a help book with the specified name.

tclAuthorization
----------------
wrapper for Mac OS X Authorization services:

	tclAuthorization::executeWithPrivileges /path/to/executable ?arg ...?
		takes an absolute path to an executable along with optional
		arguments for it, and runs that executable with an effective
		user id of root, after presenting a standard Mac OS X
		authorization dialog (whose prompt shows the given executable
		and arguments).
		If sucessful, the command returns a channel connected to stdin
		and stdout of the executable (stderr is unavailable). That
		channel needs be closed manually once the executable has exited
		or is no longer needed.

tclCHUDtime
-----------
wrapper for Mac OS X CHUD & getrusage timing services:

	chud::time mode ?options? command ?count?
		replacement for core [time] command using selected CHUD or BSD
		API. 'count' == 0 means measure overhead of selected API,
		'command' is ignored in that case.
		choices for 'mode':
			cpucycles|timebase|gettimeofday|rusage
		options for cpucycles:
			-processonly|-threadonly (ppc only)
			-usermodeonly (don't measure cycles in supervisor mode)
			-timebase (also return elapsed timebase)
			-reference (intel only, reference cpu cycles)
		options for rusage: -useronly|-systemonly

	chud::clicks
		replacement for core [clock clicks] command using high resolution
		timebase from CHUD framework.

	chud::granularity mode
		returns theoretical granularity (smallest possible increment) of
		selected timer API.

bgexec
------
wrapper of standalone unix bgexec stripped out from BLT:

	bgexec
		BLT bgexec enhanced with -input option



- das 2007-10-06