BOOL AddFreeList( struct FreeList * freelist, APTR mem, unsigned long size );
Adds supplied memory chunk to the supplied freelist. The memory chunk must have been allocated by AllocMem(). All memory added into the freelist can later be deallocated through a single FreeFreeList() call.
freelist - pointer to freelist struct previously allocated by the programmer. mem - memory to add to the freelist. size - size of memory chunk to add to the freelist.
FALSE on failure, else TRUE.
UBYTE * BumpRevision( UBYTE * newname, UBYTE * oldname );
Computes the right copy revision for a file name.
newname - a buffer for the new string. Should be at leas 31 bytes. oldname - the old name to be revisioned.
pointer to the supplied buffer.o
VOID ChangeToSelectedIconColor( struct ColorRegister * cr );
Change a color register for selected icon state.
cr - colorregister to be changed.
BOOL DeleteDiskObject( UBYTE * name );
Deletes an icon description file.
name - name of the icon file without the ".info".
void DrawIconStateA( struct RastPort * rp, struct DiskObject * icon, STRPTR label, LONG leftEdge, LONG topEdge, ULONG state, struct TagItem * tags ); void DrawIconState( struct RastPort * rp, struct DiskObject * icon, STRPTR label, LONG leftEdge, LONG topEdge, ULONG state, TAG tag, ... );
Draw an icon like an image.
rp - rastport to draw into icon - the icon label - label string leftEdge, topEdge - drawing position state - drawing state, see intuition/imageclass.h
Only very limited implemented.
struct DiskObject * DupDiskObjectA( struct DiskObject * icon, struct TagItem * tags ); struct DiskObject * DupDiskObject( struct DiskObject * icon, TAG tag, ... );
UBYTE * FindToolType( CONST STRPTR * toolTypeArray, CONST STRPTR typeName );
Finds the supplied typeName inside the given toolTypeArray. Search is case-insensitive.
toolTypeArray - pointer to an array of tooltype strings. typeName - name of a specific tool-type.
NULL if the tooltype wasn't found and a pointer to the value of the tooltype otherwise.
void FreeDiskObject( struct DiskObject * diskobj );
Frees all memory for a DiskObject structure.
diskobj -- a pointer to a DiskObject structure. A NULL pointer will be ignored.
void FreeFreeList( struct FreeList * freelist );
Frees all memory chunks in the freelist (previously inserted into it via AddFreeList()).
freelist - pointer to FreeList struct. It is safe to use NULL.
struct DiskObject * GetDefDiskObject( LONG type );
Gets the default icon for the supplied type of icon.
type - type of icon to get default diskobject for.
DiskObject structure or NULL if an error occured. The error may be obtained by IoErr().
struct DiskObject * GetDiskObject( CONST_STRPTR name );
Opens an icon from disk.
name - filename without ".info" or NULL for an empty diskobject.
Pointer to diskobject.
struct DiskObject * GetDiskObjectNew( CONST_STRPTR name );
Tries to open the supplied info file via GetDiskObject(). If this does not succeed it will try to read the default info file for that type of file.
name - name of the file to read an icon for.
DiskObject - pointer to diskobject struct.
BOOL GetIconRectangleA( struct RastPort * rp, struct DiskObject * icon, STRPTR label, struct Rectangle * rectangle, struct TagItem * tags ); BOOL GetIconRectangle( struct RastPort * rp, struct DiskObject * icon, STRPTR label, struct Rectangle * rectangle, TAG tag, ... );
Query size of icon.
rp - reference RastPort (for font) icon - icon to be queried label - label string rectangle - resulting size
TRUE success
Only very limited implemented.
struct DiskObject * GetIconTagList( CONST_STRPTR name, struct TagItem * tags ); struct DiskObject * GetIconTags( CONST_STRPTR name, TAG tag, ... );
Opens an icon from disk.
name - object path (without .info extension). May be NULL when retrieving a default icon. tags - tag list containing tags described below.
ICONA_ErrorCode (LONG *) ICONGETA_GetDefaultType (LONG) - Default icon type to get. This overrides the "name" parameter. ICONGETA_GetDefaultName (STRPTR) - Name of default icon to get. This overrides the "name" parameter. ICONGETA_FailIfUnavailable (BOOL) - Find a default icon if there is no specific icon. ICONGETA_GetPaletteMappedIcon (BOOL) ICONGETA_IsDefaultIcon (LONG *) - Upon completion of this function, the referenced LONG will be set to a boolean value indicating whether the returned icon is a default icon. ICONGETA_RemapIcon (BOOL) ICONGETA_GenerateImageMasks (BOOL) ICONGETA_Label (STRPTR) ICONGETA_Screen (struct Screen *)
ULONG IconControlA( struct DiskObject * icon, struct TagItem * tags ); ULONG IconControl( struct DiskObject * icon, TAG tag, ... );
Set and get icon and icon.library options.
icon - icon to be queried
Number of processed tags.
BOOL LayoutIconA( struct DiskObject * icon, struct Screen * screen, struct TagItem * tags ); BOOL LayoutIcon( struct DiskObject * icon, struct Screen * screen, TAG tag, ... );
Adapt a palette-mapped icon for display.
Not implemented.
BOOL MatchToolValue( UBYTE * typeString, UBYTE * value );
Checks if the given tooltype has the supplied value. Search is case-insensitive.
typeString - string containing the tooltype. value - the value to match for.
TRUE if match, else FALSE.
struct DiskObject * NewDiskObject( ULONG type );
Creates an empty DiskObject structure.
type - WBDISK, WBDRAWER, WBTOOL, WBPROJECT, WBGARBAGE, WBDEVICE or WBKICK
BOOL PutDefDiskObject( struct DiskObject * icon );
Puts a new default icon for a certain type.
diskObject - diskObject struct describing icon to put as new default icon.
TRUE if success, else FALSE. Error may be obtained via IoErr().
BOOL PutDiskObject( CONST_STRPTR name, struct DiskObject * icon );
Writes icon to disk.
name - filename, ".info" will be appended. icon - diskobject to write
TRUE on success, FALSE on error
BOOL PutIconTagList( CONST_STRPTR name, struct DiskObject * icon, struct TagItem * tags ); BOOL PutIconTags( CONST_STRPTR name, struct DiskObject * icon, TAG tag, ... );