[Tclresource-commits] Help TclResourceHelp,1.2,1.3 TclResourceHelp.html,1.3,1.4
Status: Beta
Brought to you by:
bdesgraupes
Menu
▾
▴
[Tclresource-commits] Help TclResourceHelp,1.2,1.3 TclResourceHelp.html,1.3,1.4
|
From: Bernard D. <bde...@us...> - 2004-09-07 08:23:09
|
Update of /cvsroot/tclresource/Help In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv1330 Modified Files: TclResourceHelp TclResourceHelp.html Log Message: Updated to 1.1.4 Index: TclResourceHelp =================================================================== RCS file: /cvsroot/tclresource/Help/TclResourceHelp,v retrieving revision 1.2 retrieving revision 1.3 diff -u -d -r1.2 -r1.3 --- TclResourceHelp 6 Nov 2003 06:40:17 -0000 1.2 +++ TclResourceHelp 7 Sep 2004 08:22:49 -0000 1.3 @@ -1,393 +1,398 @@ --*-WWW-*- - _________________________________________________________________ - This is a manual page for the Tclresource extension for Tcl. + Abstract - _________________________________________________________________ +This is a manual page for the Tclresource extension for Tcl. - NAME - SYNOPSIS - INTRODUCTION - resource attributes resourceRef ?option resourceType? ?value? - - resource attributes resourceRef + 1. NAME + 2. SYNOPSIS + 3. INTRODUCTION + 3.1. resource attributes resourceRef ?option resourceType ? ?value ? + resource attributes resourceRef + resource attributes resourceRef value + resource attributes resourceRef option resourceType + resource attributes resourceRef option resourceType value + 3.2. resource close resourceRef + 3.3. resource delete ?options ? resourceType + 3.4. resource fork resourceRef + 3.5. resource files ?resourceRef ? + 3.6. resource id resourceType resourceName resourceRef + 3.7. resource list ?-ids ? resourceType ?resourceRef ? + 3.8. resource name resourceType resourceId resourceRef + 3.9. resource open ?(-datafork |-resourcefork )? fileName ?access ? + 3.10. resource read resourceType resourceId ?resourceRef ? + 3.11. resource types ?resourceRef ? + 3.12. resource update resourceRef + 3.13. resource write ?options ? resourceType data + 4. RESOURCE TYPES + 5. RESOURCE IDS + 6. RESOURCE ATTRIBUTES + 7. PORTABILITY ISSUES + 8. VERSION HISTORY + 9. KNOW ISSUES + 10. LICENSE AND DISCLAIMER + 11. SOURCE CODE + 12. SEE ALSO + 13. KEYWORDS +---------------------------------------------------------------------- - resource attributes resourceRef value - resource attributes resourceRef option resourceType +1. NAME +resource - Manipulate Macintosh resources - resource attributes resourceRef option resourceType value +2. SYNOPSIS - resource close resourceRef + package require resource 1.1 + resource subcommand ?arg arg ...? - resource delete ?options? resourceType - resource fork resourceRef +3. INTRODUCTION +The resource command provides some generic operations for dealing with +Macintosh resources. This command is only supported on the Macintosh +platform. Prior to system OSX, each Macintosh file consisted of two forks: a +data fork and a resource fork. Since the advent of system OSX, resources can +also be stored in the data fork (this is the recommended format for +portability reasons: resource forks tend to be otherwise deleted when copied +on another platform). You use the normal open, puts, close, etc. commands to +manipulate the data fork but you must use this command, however, to interact +with the resource map, even if it is stored in the data fork. In a resource +map, resources are categorized by type and, in each type, are designated by +an ID and possibly a name. See RESOURCE TYPES and RESOURCE IDS below for +details. - resource files ?resourceRef? +On OSX, the resource command is not a built-in command of Tcl anymore. It is +made available by this extension which much be explicitely loaded with a +package require instruction like this: - resource id resourceType resourceName resourceRef + package require resource 1.1 - resource list ?-ids? resourceType ?resourceRef? - resource name resourceType resourceId resourceRef +Subcommand indicates what operation to perform. Any unique abbreviation +for subcommand is acceptable. The valid subcommands are explained in the next +sections. - resource open ?(-datafork|-resourcefork)? fileName ?access? +3.1. resource attributes resourceRef ?option resourceType ? ?value ? + This command is used to get or set the attributes of the resource map or + the attributes of a particular resource in the resource map. It has four + different syntaxes: - resource read resourceType resourceId ?resourceRef? + resource attributes resourceRef + To get the attributes of the resource map specified by the resourceRef + argument. - resource types ?resourceRef? + resource attributes resourceRef value + To give the value value to the attributes of the resource map specified + by the resourceRef argument. - resource update resourceRef + resource attributes resourceRef option resourceType + To get the attributes of the resource specified by the argument option + in the resource map designated by the resourceRef argument. The option + can be one of: - resource write ?options? resourceType data + ¥ -id resourceId : if the -id option is given, the id resourceId (see RESOURCE IDS below) + is used to specify the resource whose attributes must be returned or set. + The id must be a number: to specify a name use the -name option. - RESOURCE TYPES - RESOURCE IDS - RESOURCE ATTRIBUTES - PORTABILITY ISSUES - VERSION HISTORY - KNOW ISSUES - LICENSE AND DISCLAIMER - SOURCE CODE - SEE ALSO - KEYWORDS + ¥ -name resourceName : if the -name option is specified, the resource named resourceName is + used. - _________________________________________________________________ -NAME + resource attributes resourceRef option resourceType value + To give the value value to the attributes of the resource specified by + the argument option in the resource map designated by the resourceRef + argument. The resource can be specified using either the -id or the + -name as indicated above. -resource - Manipulate Macintosh resources + Note that the resource attributes command is available only since + version 1.1 of the Tclresource extension. See RESOURCE ATTRIBUTES below + for details about the possible values for attributes. -SYNOPSIS +3.2. resource close resourceRef + Closes the given resource reference (obtained from resource open). + Resources from that resource file will no longer be available. - package require resource 1.1 - resource subcommand ?arg arg ...? +3.3. resource delete ?options ? resourceType + This command will delete the resource specified by options and type + resourceType (see RESOURCE TYPES below). The options give you several + ways to specify the resource to be deleted. -INTRODUCTION -The resource command provides some generic operations for dealing with -Macintosh resources. This command is only supported on the Macintosh -platform. Prior to system OSX, each Macintosh file consisted of two forks: -a data fork and a resource fork. Since the advent of system OSX, resources -can also be stored in the data fork (this is the recommended format for -portability reasons: resource forks tend to be otherwise deleted when -copied on another platform). You use the normal open, puts, close, etc. -commands to manipulate the data fork but you must use this command, -however, to interact with the resource map, even if it is stored in the -data fork. In a resource map, resources are categorized by type and, in -each type, are designated by an ID and possibly a name. See RESOURCE TYPES -and RESOURCE IDS below for details. On OSX, the resource command is not a -built-in command of Tcl anymore. It is made available by this extension -which much be explicitely loaded with a package require instruction like -this: +((li -id resourceId : if the -id option is given the id resourceId (see RESOURCE IDS below) is + used to specify the resource to be deleted. The id must be a number: to + specify a name use the -name option. +((li -name resourceName : if -name is specified, the resource named resourceName will be deleted. + If the -id is also provided, then there must be a resource with BOTH this + name and this id. If no name is provided, then the id will be used + regardless of the name of the actual resource. - package require resource 1.1 +((li -file resourceRef : if the -file option is specified then the resource will be deleted from + the file pointed to by resourceRef . Otherwise the first resource with the + given resourceName and or resourceId which is found on the resource file + path will be deleted. To inspect the file path, use the resource files + command. + -Subcommand indicates what operation to perform. Any unique abbreviation for -subcommand is acceptable. The valid subcommands are explained in the next -sections. -resource attributes resourceRef ?option resourceType? ?value? - This command is used to get or set the attributes of the resource map or - the attributes of a particular resource in the resource map. It has four - different syntaxes: +3.4. resource fork resourceRef + Returns which fork (either data fork or resource fork) contains + the resource map specified by the argument resourceRef . The return value + will be datafork , resourcefork or unknown . The value unknown is returned + for the resource maps listed by the command resource list which were not + opened explicitely by a resource open command but were already in memory. + Note that the resource fork command is available only since version 1.1 + of the Tclresource extension. -resource attributes resourceRef - To get the attributes of the resource map specified by the resourceRef - argument. -resource attributes resourceRef value - To give the value value to the attributes of the resource map specified - by the resourceRef argument. -resource attributes resourceRef option resourceType - To get the attributes of the resource specified by the argument option in - the resource map designated by the resourceRef argument. The option can - be one of: --id resourceId - If the -id option is given, the id resourceId (see RESOURCE IDS below) - is used to specify the resource whose attributes must be returned or - set. The id must be a number: to specify a name use the -name option. --name resourceName - If the -name option is specified, the resource named resourceName is - used. +3.5. resource files ?resourceRef ? + If resourceRef is not provided, this command returns a Tcl list of the + resource references for all the currently open resource files. The list + is in the normal Macintosh search order for resources. If resourceRef is + specified, the command will return the path to the file whose resource + fork is represented by that token. -resource attributes resourceRef option resourceType value - To give the value value to the attributes of the resource specified by - the argument option in the resource map designated by the resourceRef - argument. The resource can be specified using either the -id or the - -name as indicated above. +3.6. resource id resourceType resourceName resourceRef + Returns the id of the resource of type resourceType with name + resourceName in the resource map designated by the argument resourceRef . + This is the reverse of command [resource name]. - Note that the resource attributes command is available only since - version 1.1 of the Tclresource extension. See RESOURCE ATTRIBUTES below - for details about the possible values for attributes. -resource close resourceRef - Closes the given resource reference (obtained from resource open). - Resources from that resource file will no longer be available. -resource delete ?options? resourceType - This command will delete the resource specified by options and type - resourceType (see RESOURCE TYPES below). The options give you several - ways to specify the resource to be deleted. +3.7. resource list ?-ids ? resourceType ?resourceRef ? + List all of the resources ids of type resourceType (see RESOURCE TYPES + below). If resourceRef is specified then the command will limit the + search to that particular resource file. Otherwise, all resource files + currently opened by the application will be searched. A Tcl list of + either the resource name's or resource id's of the found resources will + be returned: each time the name of the resource is not empty, it is used + preferably to the id, unless the -ids option has been specified, in + which case only id's are returned. See the RESOURCE IDS section below for + more details about what a resource id is. + Note that the -ids option is only available since version 1.1 of the + Tclresource extension. --id resourceId - If the -id option is given the id resourceId (see RESOURCE IDS below) is - used to specify the resource to be deleted. The id must be a number: to - specify a name use the -name option. --name resourceName - If -name is specified, the resource named resourceName will be deleted. - If the -id is also provided, then there must be a resource with BOTH - this name and this id. If no name is provided, then the id will be used - regardless of the name of the actual resource. --file resourceRef - If the -file option is specified then the resource will be deleted from - the file pointed to by resourceRef. Otherwise the first resource with - the given resourceName and or resourceId which is found on the resource - file path will be deleted. To inspect the file path, use the resource - files command. -resource fork resourceRef - Returns which fork (either data fork or resource fork) contains the - resource map specified by the argument resourceRef. The return value will - be datafork, resourcefork or unknown. The value unknown is returned for - the resource maps listed by the command resource list which were not - opened explicitely by a resource open command but were already in - memory. +3.8. resource name resourceType resourceId resourceRef + Returns the (possibly empty) name of the resource of type resourceType + with ID resourceId in the resource map designated by the argument + resourceRef . This is the reverse of command [resource id]. - Note that the resource fork command is available only since version 1.1 - of the Tclresource extension. -resource files ?resourceRef? - If resourceRef is not provided, this command returns a Tcl list of the - resource references for all the currently open resource files. The list - is in the normal Macintosh search order for resources. If resourceRef is - specified, the command will return the path to the file whose resource - fork is represented by that token. -resource id resourceType resourceName resourceRef - Returns the id of the resource of type resourceType with name - resourceName in the resource map designated by the argument resourceRef. - This is the reverse of command [resource name]. -resource list ?-ids? resourceType ?resourceRef? - List all of the resources ids of type resourceType (see RESOURCE TYPES - below). If resourceRef is specified then the command will limit the - search to that particular resource file. Otherwise, all resource files - currently opened by the application will be searched. A Tcl list of - either the resource name's or resource id's of the found resources will - be returned: each time the name of the resource is not empty, it is used - preferably to the id, unless the -ids option has been specified, in which - case only id's are returned. See the RESOURCE IDS section below for more - details about what a resource id is. - Note that the -ids option is only available since version 1.1 of the - Tclresource extension. -resource name resourceType resourceId resourceRef - Returns the (possibly empty) name of the resource of type resourceType - with ID resourceId in the resource map designated by the argument - resourceRef. This is the reverse of command [resource id]. -resource open ?(-datafork|-resourcefork)? fileName ?access? - Open the resource map for the file fileName. On OSX, resources can be - stored either in the resource fork of the file or in the data fork of - the file. By default, resource open will try to find resources in the - data fork of the file, then, if none is found, in its resource fork. - This behavior can be modified with one of the -datafork or -resourcefork - switches which force the command to search only in the data fork or the +3.9. resource open ?(-datafork |-resourcefork )? fileName ?access ? + Open the resource map for the file fileName . On OSX, resources can be + stored either in the resource fork of the file or in the data fork of the + file. By default, resource open will try to find resources in the data + fork of the file, then, if none is found, in its resource fork. This + behavior can be modified with one of the -datafork or -resourcefork + switches which force the command to search only in the data fork or the resource fork respectively. Standard file access permissions may also be - specified with the access optional argument (see the manual entry for - open for details). A resource reference (resourceRef) is returned that - can be used by the other resource commands to refer to this opened - resource map. + specified with the access optional argument (see the manual entry for + open for details). A resource reference (resourceRef ) is returned that + can be used by the other resource commands to refer to this opened + resource map. - An error can occur if the file doesn't exist or the file does not have - resources in the data or the resource fork. However, if you open the - file with write permissions the file and/or resource fork will be - created instead of generating an error: the -datafork or -resourcefork - switches let you specify which kind of resource file should be created - (data fork resource file or resource fork resource file). If neither - -datafork nor -resourcefork are specified, a data fork resource file is - created by default. + An error can occur if the file doesn't exist or the file does not have + resources in the data or the resource fork. However, if you open the file + with write permissions the file and/or resource fork will be created + instead of generating an error: the -datafork or -resourcefork switches + let you specify which kind of resource file should be created (data fork + resource file or resource fork resource file). If neither -datafork nor + -resourcefork are specified, a data fork resource file is created by + default. - Note that the -datafork and -resourcefork switches are only available - since version 1.1 of the Tclresource extension. -resource read resourceType resourceId ?resourceRef? - Read the entire resource of type resourceType (see RESOURCE TYPES below) - and the name or id of resourceId (see RESOURCE IDS below) into memory and - return the result. If resourceRef is specified we limit our search to - that resource file, otherwise we search all open resource forks in the - application. It is important to note that most Macintosh resource use a - binary format and the data returned from this command may have embedded - NULLs or other non-ASCII data. -resource types ?resourceRef? - This command returns a Tcl list of all resource types (see RESOURCE TYPES - below) found in the resource file pointed to by resourceRef. If - resourceRef is not specified it will return all the resource types found - in every resource file currently opened by the application. -resource update resourceRef - This command updates the resource map designated by the resourceRef - argument. It performs three tasks: + Note that the -datafork and -resourcefork switches are only available + since version 1.1 of the Tclresource extension. - changing, adding, or removing resource data in the fork on disk to - match the resource map in memory; - compacting the resource fork, closing up any empty space created when - a resource was removed, made smaller, or made larger; - writing the resource map in memory to the resource fork. - Because the [resource close] command calls [resource update] before it - closes the resource fork, you need to call it directly only if you want - to update the file without closing it. +3.10. resource read resourceType resourceId ?resourceRef ? + Read the entire resource of type resourceType (see RESOURCE TYPES below) + and the name or id of resourceId (see RESOURCE IDS below) into memory and + return the result. If resourceRef is specified we limit our search to + that resource file, otherwise we search all open resource forks in the + application. It is important to note that most Macintosh resource use a + binary format and the data returned from this command may have embedded + NULLs or other non-ASCII data. - Note that the resource update command is available only since version - 1.1 of the Tclresource extension. -resource write ?options? resourceType data - This command will write the passed in data as a new resource of type - resourceType (see RESOURCE TYPES below). Several options are available - that describe where and how the resource is stored. --id resourceId - If the -id option is given the id resourceId (see RESOURCE IDS below) is - used for the new resource, otherwise a unique id will be generated that - will not conflict with any existing resource. However, the id must be a - number: to specify a name use the -name option. --name resourceName - If -name is specified the resource will be named resourceName, otherwise - it will have the empty string as the name. --file resourceRef - If the -file option is specified then the resource will be written in - the file pointed to by resourceRef, otherwise the most recently open - resource will be used. --force - If the target resource already exists, then by default Tcl will not - overwrite it, but raise an error instead. Use the -force flag to force - overwriting the existant resource. +3.11. resource types ?resourceRef ? + This command returns a Tcl list of all resource types (see RESOURCE + TYPES below) found in the resource file pointed to by resourceRef . If + resourceRef is not specified it will return all the resource types found + in every resource file currently opened by the application. -RESOURCE TYPES -Resource types are defined as a four character string that is then mapped to -an underlying id. For example, TEXT refers to the Macintosh resource type -for text. The type STR# is a list of counted strings. All Macintosh -resources must be of some type. See Macintosh documentation for a more -complete list of resource types that are commonly used. +3.12. resource update resourceRef + This command updates the resource map designated by the resourceRef + argument. It performs three tasks: + ¥ changing, adding, or removing resource data in the fork on disk to + match the resource map in memory; + ¥ compacting the resource fork, closing up any empty space created when + a resource was removed, made smaller, or made larger; + ¥ writing the resource map in memory to the resource fork. -RESOURCE IDS + Because the [resource close] command calls [resource update] before it + closes the resource fork, you need to call it directly only if you want + to update the file without closing it. + + Note that the resource update command is available only since version + 1.1 of the Tclresource extension. + + +3.13. resource write ?options ? resourceType data + This command will write the passed in data as a new resource of type + resourceType (see RESOURCE TYPES below). Several options are available + that describe where and how the resource is stored. + + ¥ -id resourceId : if the -id option is given the id resourceId (see RESOURCE IDS below) is + used for the new resource, otherwise a unique id will be generated that + will not conflict with any existing resource. However, the id must be a + number: to specify a name use the -name option. + + ¥ -name resourceName : if -name is specified the resource will be named resourceName , otherwise + it will have the empty string as the name. + + ¥ -file resourceRef : if the -file option is specified then the resource will be written in + the file pointed to by resourceRef , otherwise the most recently open + resource will be used. + + ¥ -force : if the target resource already exists, then by default Tcl will not + overwrite it, but raise an error instead. Use the -force flag to force + overwriting the existant resource. + + +4. RESOURCE TYPES +Resource types are defined as a four character string that is then mapped to +an underlying id. For example, TEXT refers to the Macintosh resource type +for text. The type STR# is a list of counted strings. All Macintosh +resources must be of some type. See Macintosh documentation for a more +complete list of resource types that are commonly used. + +5. RESOURCE IDS For this command the notion of a resource id actually refers to two ideas in -Macintosh resources. Every place you can use a resource Id you can use +Macintosh resources. Every place you can use a resource Id you can use either the resource name or a resource number. Names are always searched or -returned in preference to numbers. For example, the resource list command -will return names if they exist or numbers if the name is NULL. +returned in preference to numbers. For example, the resource list command +will return names if they exist or numbers if the name is NULL. -RESOURCE ATTRIBUTES +6. RESOURCE ATTRIBUTES +Resource maps and individual resources have attributes. The attributes for +resource maps are: + +.___________.___.___________________________________________. +|mapChanged |32 |Write map out at update | +|mapCompact |64 |Compact resource file when writing to disk | +|mapReadOnly|128|Resource file is read-only | +|___________|___|___________________________________________| -Resource maps and individual resources have attributes. The attributes for -resource maps are: -mapChanged 32 Write map out at update -mapCompact 64 Compact resource file when writing to disk -mapReadOnly 128 Resource file is read-only -The attributes are additional values. To set both the mapReadOnly and -mapChangedattributes for the resource map with reference resourceRef, one -would write: +The attributes are additional values. To set both the mapReadOnly and +mapChanged attributes for the resource map with reference resourceRef , one +would write: + resource attributes ((i resourceRef i)) 160 - resource attributes resourceRef 160 The allowable attributes for individual resources are: + +.____________.__.___________________________. +|resChanged |2 |Resource changed | +|resPreload |4 |Load in on OpenResFile | +|resProtected|8 |Protected | +|resLocked |16|Load it in locked | +|resPurgeable|32|Purgeable resource | +|resSysHeap |64|System or application heap | +|____________|__|___________________________| -resChanged 2 Resource changed -resPreload 4 Load in on OpenResFile -resProtected 8 Protected -resLocked 16 Load it in locked -resPurgeable 32 Purgeable resource -resSysHeap 64 System or application heap -PORTABILITY ISSUES - -The resource command is only available on Macintosh. On systems older than -OSX, the resource command was built in Tcl but it was removed from the -versions of Tcl compiled for OSX. It is now made available as an extension -which should be loaded in the scripts with the following instruction: +7. PORTABILITY ISSUES +The resource command is only available on Macintosh. On systems older than +OSX, the resource command was built in Tcl but it was removed from the +versions of Tcl compiled for OSX. It is now made available as an extension +which should be loaded in the scripts with the following instruction: package require resource 1.1 -Version 1.0 of the extension is simply a port to OSX of the old resource + +Version 1.0 of the extension is simply a port to OSX of the old resource command: it does not handle data fork resource files. Support for data fork resource files is introduced in version 1.1. -VERSION HISTORY - - 1.0 - 03/09/25 - First release of the extension for OSX. - 1.1 - 03/10/05 - Support for data fork resources, attributes, update, - name. +8. VERSION HISTORY + ¥ 1.0 - 03/09/25 - First release of the extension for OSX. + ¥ 1.1 - 03/10/05 - Support for data fork resources, attributes, update, name. + ¥ 1.1.4 - 04/09/07 - Fixed a bug related to permissions. Added a +complete tests suite. Better error messages. -KNOW ISSUES -The resource command has been ported to OSX as a Tcl extension by Bernard -Desgraupes. Please e-mail any bug or problem you encounter: -<bde...@ea...> -Version 1.0 corresponds strictly to the code provided in the Tcl source code -(tclMacResource.c). Version 1.1 added several improvements: +9. KNOW ISSUES +The [resource] command has been ported to OSX as a Tcl extension +by Bernard Desgraupes. Please e-mail any bug or problem you encounter: +<bde...@us...> - possibility of opening and writing to datafork resource files as well as - resource fork resource files. - new subcommand [resource attributes] to get/set the attributes of a - resource map or an individual resource. - new subcommand [resource update] to update a resource map without closing - it. - new subcommand [resource fork] to indicate which fork a resource map was - opened from. - new subcommands [resource name] and [resource id] returning the name of a - resource given its ID, and vice versa. - new -ids option for the [resource list] command + Version 1.0 strictly corresponds to the old [resource] command +included in the pre-OSX versions of Tcl. Version 1.1 added several improvements: + ¥ possibility of opening and writing to datafork resource files as well + as resource fork resource files. + ¥ new subcommand [resource attributes] to get/set the attributes of a resource + map or an individual resource. + ¥ new subcommand [resource update] to update a resource map without closing it. + ¥ new subcommand [resource fork] to indicate which fork a resource map was opened from. + ¥ new subcommands [resource name] and [resource id] returning the name of a resource +given its ID, and vice versa. + ¥ new -ids option for the [resource list] command -The Tclresource folder (Tclresource1.0, Tclresource1.1 etc) contains the -extension compiled as a dynamic library. For the Tcl interpreter to find it -automatically, it should be located on your system in /Library/Tcl/ -(administrator password required) or in your personal folder -~/Library/Tcl/. -LICENSE AND DISCLAIMER +The Tclresource folder (Tclresource1.0, Tclresource1.1 etc) contains +the extension compiled as a dynamic library. For the Tcl interpreter to +find it automatically, it should be located on your system in +/Library/Tcl/ (administrator password required) or in your personal +folder ~/Library/Tcl/. -This software is free software and distributed under the same licensing -terms as the Tcl language itself. See license.terms in the Tcl -distribution. The original code of the resource command has the following -copyright. +10. LICENSE AND DISCLAIMER +This software is free software and distributed under the same licensing terms +as the Tcl language itself. See license.terms in the Tcl distribution. +The original code of the resource command has the following copyright. Copyright © 1997 Sun Microsystems, Inc. Copyright © 1995-1997 Roger E. Critchlow Jr. -For the Tclresource extension: - +For the Tclresource extension: - Copyright © 2003 Bernard Desgraupes + Copyright © 2003-2004 Bernard Desgraupes -SOURCE CODE -Tclresource is an Open Source Project. Its source code is public and can be -found on the SourceForge site at the following address: -http://sourceforge.net/projects/tclresource +11. SOURCE CODE +Tclresource is an Open Source Project. Its source code is public and can +be found on the SourceForge site at the following address: +<http://sourceforge.net/projects/tclresource> -Tclresource binary releases are available at -http://sourceforge.net/project/showfiles.php?group_id=93101 or on my web -page at http://webperso.easyconnect.fr/bdesgraupes/tcl.html + Tclresource binary releases are available at +<http://sourceforge.net/project/showfiles.php?group_id=93101> or on my web +page at <http://webperso.easyconnect.fr/bdesgraupes/tcl.html> -The code is under CVS control. You can retrieve the latest stage of -development using any CVS client. See instructions at: -http://sourceforge.net/cvs/?group_id=93101 + The code is under CVS control. You can retrieve the latest stage of +development using any CVS client. See instructions at: +<http://sourceforge.net/cvs/?group_id=93101> -You can browse the cvs repository online at -http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/tclresource + You can browse the cvs repository online at +<http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/tclresource> -SEE ALSO +12. SEE ALSO open -KEYWORDS +13. KEYWORDS +open, resource + + + + + -open, resource Index: TclResourceHelp.html =================================================================== RCS file: /cvsroot/tclresource/Help/TclResourceHelp.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -d -r1.3 -r1.4 --- TclResourceHelp.html 6 Nov 2003 06:39:36 -0000 1.3 +++ TclResourceHelp.html 7 Sep 2004 08:22:49 -0000 1.4 @@ -1,69 +1,50 @@ <HTML> <HEAD> -<TITLE>TclResource Help</TITLE> +<TITLE>Resource Help </TITLE> <META NAME=GENERATOR CONTENT="Aida Mode"> </HEAD> <BODY> -<!-- :Title: Resource Help --> -<!-- :Project: Tclresource extension for Tcl --> -<!-- :Version: $Revision 1.1 $ --> -<!-- :Author: Bernard Desgraupes <A HREF="mailto:bde...@ea...">bde...@ea...</A> --> -<!-- :Homepage: <A HREF="http://webperso.easyconnect.fr/bdesgraupes/">http://webperso.easyconnect.fr/bdesgraupes/</A> --> -<!-- :Created: 2003-09-30 03:53:27 --> -<!-- :Modified: 2003-10-16 08:44:28 --> -<!-- :Keywords: resource, forks --> - - -<HR><BLOCKQUOTE><P><I> +<P><HR><BLOCKQUOTE><P><I> This is a manual page for the Tclresource extension for Tcl. </I></P></BLOCKQUOTE><HR> <UL> -<LI><A HREF="#anchor1">NAME</A> -<LI><A HREF="#anchor2">SYNOPSIS</A> -<LI><A HREF="#anchor3">INTRODUCTION</A> -<UL><LI><A HREF="#anchor4"><B>resource attributes</B> <I>resourceRef</I> ?<I>option</I> <I>resourceType</I>? ?<I>value</I>?</A></UL> -<UL><UL><LI><A HREF="#anchor5"><B>resource attributes</B> <I>resourceRef</I></A></UL></UL> -<UL><UL><LI><A HREF="#anchor6"><B>resource attributes</B> <I>resourceRef</I> <I>value</I></A></UL></UL> -<UL><UL><LI><A HREF="#anchor7"><B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I></A></UL></UL> -<UL><UL><LI><A HREF="#anchor8"><B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I> <I>value</I></A></UL></UL> -<UL><LI><A HREF="#anchor9"><B>resource close</B> <I>resourceRef</I></A></UL> -<UL><LI><A HREF="#anchor10"><B>resource delete</B> ?<I>options</I>? <I>resourceType</I></A></UL> -<UL><LI><A HREF="#anchor11"><B>resource fork</B> <I>resourceRef</I></A></UL> -<UL><LI><A HREF="#anchor12"><B>resource files</B> ?<I>resourceRef</I>?</A></UL> -<UL><LI><A HREF="#anchor13"><B>resource id</B> <I>resourceType</I> <I>resourceName</I> <I>resourceRef</I></A></UL> -<UL><LI><A HREF="#anchor14"><B>resource list</B> ?<I>-ids</I>? <I>resourceType</I> ?<I>resourceRef</I>?</A></UL> -<UL><LI><A HREF="#anchor15"><B>resource name</B> <I>resourceType</I> <I>resourceId</I> <I>resourceRef</I></A></UL> -<UL><LI><A HREF="#anchor16"><B>resource open</B> ?(<I>-datafork</I>|<I>-resourcefork</I>)? <I>fileName</I> ?<I>access</I>?</A></UL> -<UL><LI><A HREF="#anchor17"><B>resource read</B> <I>resourceType</I> <I>resourceId</I> ?<I>resourceRef</I>?</A></UL> -<UL><LI><A HREF="#anchor18"><B>resource types</B> ?<I>resourceRef</I>?</A></UL> -<UL><LI><A HREF="#anchor19"><B>resource update</B> <I>resourceRef</I></A></UL> -<UL><LI><A HREF="#anchor20"><B>resource write</B> ?<I>options</I>? <I>resourceType</I> <I>data</I></A></UL> -<LI><A HREF="#anchor21">RESOURCE TYPES</A> -<LI><A HREF="#anchor22">RESOURCE IDS</A> -<LI><A HREF="#anchor23">RESOURCE ATTRIBUTES</A> -<LI><A HREF="#anchor24">PORTABILITY ISSUES</A> -<LI><A HREF="#anchor25">VERSION HISTORY</A> -<LI><A HREF="#anchor26">KNOW ISSUES</A> -<LI><A HREF="#anchor27">LICENSE AND DISCLAIMER</A> -<LI><A HREF="#anchor28">SOURCE CODE</A> -<LI><A HREF="#anchor29">SEE ALSO</A> -<LI><A HREF="#anchor30">KEYWORDS</A> +<LI><A HREF="#M1">NAME</A> +<LI><A HREF="#M2">SYNOPSIS</A> +<LI><A HREF="#M3">INTRODUCTION</A> +<UL><LI><A HREF="#M4"><B>resource attributes</B> <I>resourceRef</I> ?<I>option</I> <I>resourceType</I> ? ?<I>value</I> ?</A></UL> +<UL><UL><LI><A HREF="#M5"><B>resource attributes</B> <I>resourceRef</I> </A></UL></UL> +<UL><UL><LI><A HREF="#M6"><B>resource attributes</B> <I>resourceRef</I> <I>value</I> </A></UL></UL> +<UL><UL><LI><A HREF="#M7"><B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I> </A></UL></UL> +<UL><UL><LI><A HREF="#M8"><B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I> <I>value</I> </A></UL></UL> +<UL><LI><A HREF="#M9"><B>resource close</B> <I>resourceRef</I> </A></UL> +<UL><LI><A HREF="#M10"><B>resource delete</B> ?<I>options</I> ? <I>resourceType</I> </A></UL> +<UL><LI><A HREF="#M11"><B>resource fork</B> <I>resourceRef</I> </A></UL> +<UL><LI><A HREF="#M12"><B>resource files</B> ?<I>resourceRef</I> ?</A></UL> +<UL><LI><A HREF="#M13"><B>resource id</B> <I>resourceType</I> <I>resourceName</I> <I>resourceRef</I> </A></UL> +<UL><LI><A HREF="#M14"><B>resource list</B> ?<I>-ids</I> ? <I>resourceType</I> ?<I>resourceRef</I> ?</A></UL> +<UL><LI><A HREF="#M15"><B>resource name</B> <I>resourceType</I> <I>resourceId</I> <I>resourceRef</I> </A></UL> +<UL><LI><A HREF="#M16"><B>resource open</B> ?(<I>-datafork</I> |<I>-resourcefork</I> )? <I>fileName</I> ?<I>access</I> ?</A></UL> +<UL><LI><A HREF="#M17"><B>resource read</B> <I>resourceType</I> <I>resourceId</I> ?<I>resourceRef</I> ?</A></UL> +<UL><LI><A HREF="#M18"><B>resource types</B> ?<I>resourceRef</I> ?</A></UL> +<UL><LI><A HREF="#M19"><B>resource update</B> <I>resourceRef</I> </A></UL> +<UL><LI><A HREF="#M20"><B>resource write</B> ?<I>options</I> ? <I>resourceType</I> <I>data</I> </A></UL> +<LI><A HREF="#M21">RESOURCE TYPES</A> +<LI><A HREF="#M22">RESOURCE IDS</A> +<LI><A HREF="#M23">RESOURCE ATTRIBUTES</A> +<LI><A HREF="#M24">PORTABILITY ISSUES</A> +<LI><A HREF="#M25">VERSION HISTORY</A> +<LI><A HREF="#M26">KNOW ISSUES</A> +<LI><A HREF="#M27">LICENSE AND DISCLAIMER</A> +<LI><A HREF="#M28">SOURCE CODE</A> +<LI><A HREF="#M29">SEE ALSO</A> +<LI><A HREF="#M30">KEYWORDS</A> </UL> -<HR> - - - - -<H2><A NAME="anchor1"></A> NAME</H2> -resource - Manipulate Macintosh resources - -<H2><A NAME="anchor2"></A> SYNOPSIS</H2> +<HR><P><H2><A NAME="M1"></A>NAME</H2> +resource - Manipulate Macintosh resources <P><H2><A NAME="M2"></A>SYNOPSIS</H2> <PRE> package require resource 1.1 resource subcommand ?arg arg ...? -</PRE> - -<H2><A NAME="anchor3"></A> INTRODUCTION</H2> +</PRE><P><H2><A NAME="M3"></A>INTRODUCTION</H2> The resource command provides some generic operations for dealing with Macintosh resources. This command is only supported on the Macintosh platform. Prior to system OSX, each Macintosh file consisted of two forks: a @@ -75,360 +56,221 @@ with the resource map, even if it is stored in the data fork. In a resource map, resources are categorized by type and, in each type, are designated by an ID and possibly a name. See RESOURCE TYPES and RESOURCE IDS below for -details. - -On OSX, the resource command is not a built-in command of Tcl anymore. It is +details. <P>On OSX, the resource command is not a built-in command of Tcl anymore. It is made available by this extension which much be explicitely loaded with a package require instruction like this: <PRE> - package require resource 1.1 -</PRE> - -<I>Subcommand</I> indicates what operation to perform. Any unique abbreviation -for <I>subcommand</I> is acceptable. The valid <I>subcommands</I> are explained in the next -sections. - -<DL> - <DT><A NAME="anchor4"></A> <B>resource attributes</B> <I>resourceRef</I> ?<I>option</I> <I>resourceType</I>? ?<I>value</I>?<DD> + package require resource 1.1 +</PRE><P><I>Subcommand</I> indicates what operation to perform. Any unique abbreviation +for <I>subcommand</I> is acceptable. The valid <I>subcommands</I> are explained in the next +sections. <P><H3><A NAME="M4"></A><B>resource attributes</B> <I>resourceRef</I> ?<I>option</I> <I>resourceType</I> ? ?<I>value</I> ?</H3> This command is used to get or set the attributes of the resource map or the attributes of a particular resource in the resource map. It has four - different syntaxes: -<DL> -<DT><A NAME="anchor5"></A> <B><B>resource attributes</B></B> <I>resourceRef</I><DD> - To get the attributes of the resource map specified by the <I>resourceRef</I> - argument. - -<DT><A NAME="anchor6"></A> <B><B>resource attributes</B></B> <I>resourceRef</I> <I>value</I><DD> - To give the value <I>value</I> to the attributes of the resource map specified - by the <I>resourceRef</I> argument. - -<DT><A NAME="anchor7"></A> <B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I><DD> - To get the attributes of the resource specified by the argument <I>option</I> - in the resource map designated by the <I>resourceRef</I> argument. The option - can be one of: -<DL> - -<DT><B>-id</B> <I>resourceId</I><DD> - If the <B>-id</B> option is given, the id <I>resourceId</I> (see RESOURCE IDS below) + different syntaxes:<P><H4><A NAME="M5"></A><B>resource attributes</B> <I>resourceRef</I> </H4> + To get the attributes of the resource map specified by the <I>resourceRef</I> + argument. <P><H4><A NAME="M6"></A><B>resource attributes</B> <I>resourceRef</I> <I>value</I> </H4> + To give the value <I>value</I> to the attributes of the resource map specified + by the <I>resourceRef</I> argument.<P><H4><A NAME="M7"></A><B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I> </H4> + To get the attributes of the resource specified by the argument <I>option</I> + in the resource map designated by the <I>resourceRef</I> argument. The option + can be one of:<P><UL> + <LI> <B>-id</B> <I>resourceId</I> : if the <B>-id</B> option is given, the id <I>resourceId</I> (see RESOURCE IDS below) is used to specify the resource whose attributes must be returned or set. - The id must be a number: to specify a name use the <B>-name</B> option. - - -<DT><B>-name</B> <I>resourceName</I><DD> - If the <B>-name</B> option is specified, the resource named <I>resourceName</I> is + The id must be a number: to specify a name use the <B>-name</B> option.<P> <LI> <B>-name</B> <I>resourceName</I> : if the <B>-name</B> option is specified, the resource named <I>resourceName</I> is used. - - -</DL> - -<DT><A NAME="anchor8"></A> <B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I> <I>value</I><DD> - To give the value <I>value</I> to the attributes of the resource specified by - the argument <I>option</I> in the resource map designated by the <I>resourceRef</I> - argument. The resource can be specified using either the <B>-id</B> or the - <B>-name</B> as indicated above. - - <P>Note that the <B>resource attributes</B> command is available only since +</UL><P><H4><A NAME="M8"></A><B>resource attributes</B> <I>resourceRef</I> <I>option</I> <I>resourceType</I> <I>value</I> </H4> + To give the value <I>value</I> to the attributes of the resource specified by + the argument <I>option</I> in the resource map designated by the <I>resourceRef</I> + argument. The resource can be specified using either the <B>-id</B> or the + <B>-name</B> as indicated above.<P><P> Note that the <B>resource attributes</B> command is available only since version 1.1 of the Tclresource extension. See RESOURCE ATTRIBUTES below - for details about the possible values for attributes. - -</DL> - -<DT><A NAME="anchor9"></A> <B>resource close</B> <I>resourceRef</I><DD> + for details about the possible values for attributes.<P><H3><A NAME="M9"></A><B>resource close</B> <I>resourceRef</I> </H3> Closes the given resource reference (obtained from resource open). - Resources from that resource file will no longer be available. - -<DT><A NAME="anchor10"></A> <B>resource delete</B> ?<I>options</I>? <I>resourceType</I><DD> - This command will delete the resource specified by <I>options</I> and type - <I>resourceType</I> (see RESOURCE TYPES below). The options give you several - ways to specify the resource to be deleted. - -<DL> - -<DT><B>-id</B> <I>resourceId</I><DD> - If the <B>-id</B> option is given the id <I>resourceId</I> (see RESOURCE IDS below) is + Resources from that resource file will no longer be available.<P><H3><A NAME="M10"></A><B>resource delete</B> ?<I>options</I> ? <I>resourceType</I> </H3> + This command will delete the resource specified by <I>options</I> and type + <I>resourceType</I> (see RESOURCE TYPES below). The options give you several + ways to specify the resource to be deleted.<P><UL> + <LI> <B>-id</B> <I>resourceId</I> : if the <B>-id</B> option is given the id <I>resourceId</I> (see RESOURCE IDS below) is used to specify the resource to be deleted. The id must be a number: to - specify a name use the <B>-name</B> option. - -<DT><B>-name</B> <I>resourceName</I><DD> - If <B>-name</B> is specified, the resource named <I>resourceName</I> will be deleted. - If the <B>-id</B> is also provided, then there must be a resource with BOTH this + specify a name use the <B>-name</B> option.<P> <LI> <B>-name</B> <I>resourceName</I> : if <B>-name</B> is specified, the resource named <I>resourceName</I> will be deleted. + If the <B>-id</B> is also provided, then there must be a resource with BOTH this name and this id. If no name is provided, then the id will be used - regardless of the name of the actual resource. - -<DT><B>-file</B> <I>resourceRef</I><DD> - If the <B>-file</B> option is specified then the resource will be deleted from - the file pointed to by <I>resourceRef</I>. Otherwise the first resource with the - given <I>resourceName</I> and or <I>resourceId</I> which is found on the resource file + regardless of the name of the actual resource.<P> <LI> <B>-file</B> <I>resourceRef</I> : if the <B>-file</B> option is specified then the resource will be deleted from + the file pointed to by <I>resourceRef</I> . Otherwise the first resource with the + given <I>resourceName</I> and or <I>resourceId</I> which is found on the resource file path will be deleted. To inspect the file path, use the resource files command. - -</DL> - -<DT><A NAME="anchor11"></A> <B>resource fork</B> <I>resourceRef</I><DD> + +</UL><P><H3><A NAME="M11"></A><B>resource fork</B> <I>resourceRef</I> </H3> Returns which fork (either data fork or resource fork) contains - the resource map specified by the argument <I>resourceRef</I>. The return value - will be <I>datafork</I>, <I>resourcefork</I> or <I>unknown</I>. The value <I>unknown</I> is returned - for the resource maps listed by the command <B>resource list</B> which were not + the resource map specified by the argument <I>resourceRef</I> . The return value + will be <I>datafork</I> , <I>resourcefork</I> or <I>unknown</I> . The value <I>unknown</I> is returned + for the resource maps listed by the command <B>resource list</B> which were not opened explicitely by a resource open command but were already in memory. - - <P>Note that the <B>resource fork</B> command is available only since version 1.1 - of the Tclresource extension. - -<DT><A NAME="anchor12"></A> <B>resource files</B> ?<I>resourceRef</I>?<DD> +<P> Note that the <B>resource fork</B> command is available only since version 1.1 + of the Tclresource extension.<P><H3><A NAME="M12"></A><B>resource files</B> ?<I>resourceRef</I> ?</H3> If resourceRef is not provided, this command returns a Tcl list of the resource references for all the currently open resource files. The list - is in the normal Macintosh search order for resources. If <I>resourceRef</I> is + is in the normal Macintosh search order for resources. If <I>resourceRef</I> is specified, the command will return the path to the file whose resource - fork is represented by that token. - -<DT><A NAME="anchor13"></A> <B>resource id</B> <I>resourceType</I> <I>resourceName</I> <I>resourceRef</I><DD> - Returns the id of the resource of type <I>resourceType</I> with name - <I>resourceName</I> in the resource map designated by the argument <I>resourceRef</I>. - This is the reverse of command [resource name]. - -<DT><A NAME="anchor14"></A> <B>resource list</B> ?<I>-ids</I>? <I>resourceType</I> ?<I>resourceRef</I>?<DD> - List all of the resources ids of type <I>resourceType</I> (see RESOURCE TYPES - below). If <I>resourceRef</I> is specified then the command will limit the + fork is represented by that token.<P><H3><A NAME="M13"></A><B>resource id</B> <I>resourceType</I> <I>resourceName</I> <I>resourceRef</I> </H3> + Returns the id of the resource of type <I>resourceType</I> with name + <I>resourceName</I> in the resource map designated by the argument <I>resourceRef</I> . + This is the reverse of command [resource name].<P><H3><A NAME="M14"></A><B>resource list</B> ?<I>-ids</I> ? <I>resourceType</I> ?<I>resourceRef</I> ?</H3> + List all of the resources ids of type <I>resourceType</I> (see RESOURCE TYPES + below). If <I>resourceRef</I> is specified then the command will limit the search to that particular resource file. Otherwise, all resource files currently opened by the application will be searched. A Tcl list of either the resource name's or resource id's of the found resources will be returned: each time the name of the resource is not empty, it is used - preferably to the id, unless the <I>-ids</I> option has been specified, in + preferably to the id, unless the <I>-ids</I> option has been specified, in which case only id's are returned. See the RESOURCE IDS section below for more details about what a resource id is. - - <P>Note that the <I>-ids</I> option is only available since version 1.1 of the - Tclresource extension. - -<DT><A NAME="anchor15"></A> <B>resource name</B> <I>resourceType</I> <I>resourceId</I> <I>resourceRef</I><DD> - Returns the (possibly empty) name of the resource of type <I>resourceType</I> - with ID <I>resourceId</I> in the resource map designated by the argument - <I>resourceRef</I>. This is the reverse of command [resource id]. - -<DT><A NAME="anchor16"></A> <B>resource open</B> ?(<I>-datafork</I>|<I>-resourcefork</I>)? <I>fileName</I> ?<I>access</I>?<DD> - Open the resource map for the file <I>fileName</I>. On OSX, resources can be +<P> Note that the <I>-ids</I> option is only available since version 1.1 of the + Tclresource extension.<P><H3><A NAME="M15"></A><B>resource name</B> <I>resourceType</I> <I>resourceId</I> <I>resourceRef</I> </H3> + Returns the (possibly empty) name of the resource of type <I>resourceType</I> + with ID <I>resourceId</I> in the resource map designated by the argument + <I>resourceRef</I> . This is the reverse of command [resource id].<P><H3><A NAME="M16"></A><B>resource open</B> ?(<I>-datafork</I> |<I>-resourcefork</I> )? <I>fileName</I> ?<I>access</I> ?</H3> + Open the resource map for the file <I>fileName</I> . On OSX, resources can be stored either in the resource fork of the file or in the data fork of the file. By default, resource open will try to find resources in the data fork of the file, then, if none is found, in its resource fork. This - behavior can be modified with one of the <I>-datafork</I> or <I>-resourcefork</I> + behavior can be modified with one of the <I>-datafork</I> or <I>-resourcefork</I> switches which force the command to search only in the data fork or the resource fork respectively. Standard file access permissions may also be - specified with the <I>access</I> optional argument (see the manual entry for - open for details). A resource reference (<I>resourceRef</I>) is returned that + specified with the <I>access</I> optional argument (see the manual entry for + open for details). A resource reference (<I>resourceRef</I> ) is returned that can be used by the other resource commands to refer to this opened - resource map. - - <P>An error can occur if the file doesn't exist or the file does not have + resource map.<P><P> An error can occur if the file doesn't exist or the file does not have resources in the data or the resource fork. However, if you open the file with write permissions the file and/or resource fork will be created - instead of generating an error: the <I>-datafork</I> or <I>-resourcefork</I> switches + instead of generating an error: the <I>-datafork</I> or <I>-resourcefork</I> switches let you specify which kind of resource file should be created (data fork - resource file or resource fork resource file). If neither <I>-datafork</I> nor - <I>-resourcefork</I> are specified, a data fork resource file is created by - default. - - <P>Note that the <I>-datafork</I> and <I>-resourcefork</I> switches are only available - since version 1.1 of the Tclresource extension. - -<DT><A NAME="anchor17"></A> <B>resource read</B> <I>resourceType</I> <I>resourceId</I> ?<I>resourceRef</I>?<DD> - Read the entire resource of type <I>resourceType</I> (see RESOURCE TYPES below) - and the name or id of <I>resourceId</I> (see RESOURCE IDS below) into memory and - return the result. If <I>resourceRef</I> is specified we limit our search to + resource file or resource fork resource file). If neither <I>-datafork</I> nor + <I>-resourcefork</I> are specified, a data fork resource file is created by + default.<P><P> Note that the <I>-datafork</I> and <I>-resourcefork</I> switches are only available + since version 1.1 of the Tclresource extension.<P><H3><A NAME="M17"></A><B>resource read</B> <I>resourceType</I> <I>resourceId</I> ?<I>resourceRef</I> ?</H3> + Read the entire resource of type <I>resourceType</I> (see RESOURCE TYPES below) + and the name or id of <I>resourceId</I> (see RESOURCE IDS below) into memory and + return the result. If <I>resourceRef</I> is specified we limit our search to that resource file, otherwise we search all open resource forks in the application. It is important to note that most Macintosh resource use a binary format and the data returned from this command may have embedded - NULLs or other non-ASCII data. - -<DT><A NAME="anchor18"></A> <B>resource types</B> ?<I>resourceRef</I>?<DD> + NULLs or other non-ASCII data.<P><H3><A NAME="M18"></A><B>resource types</B> ?<I>resourceRef</I> ?</H3> This command returns a Tcl list of all resource types (see RESOURCE - TYPES below) found in the resource file pointed to by <I>resourceRef</I>. If - <I>resourceRef</I> is not specified it will return all the resource types found - in every resource file currently opened by the application. - -<DT><A NAME="anchor19"></A> <B>resource update</B> <I>resourceRef</I><DD> - This command updates the resource map designated by the <I>resourceRef</I> + TYPES below) found in the resource file pointed to by <I>resourceRef</I> . If + <I>resourceRef</I> is not specified it will return all the resource types found + in every resource file currently opened by the application.<P><H3><A NAME="M19"></A><B>resource update</B> <I>resourceRef</I> </H3> + This command updates the resource map designated by the <I>resourceRef</I> argument. It performs three tasks: -<UL> +<UL> <LI> changing, adding, or removing resource data in the fork on disk to - match the resource map in memory; + match the resource map in memory; <LI> compacting the resource fork, closing up any empty space created when - a resource was removed, made smaller, or made larger; + a resource was removed, made smaller, or made larger; <LI> writing the resource map in memory to the resource fork. - -</UL> - - Because the [resource close] command calls [resource update] before it +</UL><P> Because the [resource close] command calls [resource update] before it closes the resource fork, you need to call it directly only if you want - to update the file without closing it. - - <P>Note that the <B>resource update</B> command is available only since version - 1.1 of the Tclresource extension. - -<DT><A NAME="anchor20"></A> <B>resource write</B> ?<I>options</I>? <I>resourceType</I> <I>data</I><DD> - This command will write the passed in <I>data</I> as a new resource of type - <I>resourceType</I> (see RESOURCE TYPES below). Several options are available - that describe where and how the resource is stored. -<DL> - -<DT><B>-id</B> <I>resourceId</I><DD> - If the <B>-id</B> option is given the id <I>resourceId</I> (see RESOURCE IDS below) is + to update the file without closing it.<P><P> Note that the <B>resource update</B> command is available only since version + 1.1 of the Tclresource extension.<P><H3><A NAME="M20"></A><B>resource write</B> ?<I>options</I> ? <I>resourceType</I> <I>data</I> </H3> + This command will write the passed in <I>data</I> as a new resource of type + <I>resourceType</I> (see RESOURCE TYPES below). Several options are available + that describe where and how the resource is stored.<P><UL> + <LI> <B>-id</B> <I>resourceId</I> : if the <B>-id</B> option is given the id <I>resourceId</I> (see RESOURCE IDS below) is used for the new resource, otherwise a unique id will be generated that will not conflict with any existing resource. However, the id must be a - number: to specify a name use the <B>-name</B> option. - - -<DT><B>-name</B> <I>resourceName</I><DD> - If <B>-name</B> is specified the resource will be named <I>resourceName</I>, otherwise - it will have the empty string as the name. - - -<DT><B>-file</B> <I>resourceRef</I><DD> - If the <B>-file</B> option is specified then the resource will be written in - the file pointed to by <I>resourceRef</I>, otherwise the most recently open - resource will be used. - - -<DT><B>-force</B><DD> - If the target resource already exists, then by default Tcl will not - overwrite it, but raise an error instead. Use the <B>-force</B> flag to force + number: to specify a name use the <B>-name</B> option.<P> <LI> <B>-name</B> <I>resourceName</I> : if <B>-name</B> is specified the resource will be named <I>resourceName</I> , otherwise + it will have the empty string as the name.<P> <LI> <B>-file</B> <I>resourceRef<... [truncated message content] |
