TABLE OF CONTENTS

iconobject.library/--background
iconobject.library/NewIconObject
iconobject.library/DisposeIconObject
iconobject.library/GetDefIconObject
iconobject.library/PutIconObject
iconobject.library/IsIconName
iconobject.library/Convert2IconObject


--background
	This library is an interface to the iconobject.datatype. Normaly
	it has comparable functions to icon.library. It was written because
	the datatypes.library was so slow while scaning the datatypes.

    NAME
	NewIconObject

    SYNOPSIS
	iconobject NewIconObject (Name, Taglist)
	                           A0      A1

	struct iconobject NewIconObject ( APTR Name , APTR Taglist );

    FUNCTION
	Reads an icon from disk. It cannot be use for drawings before a
	IDTM_Layout method was used.

    INPUTS
	Name - the filename (without an extention like .info)
	Taglist -
		IDTA_Text - text under the icon
		IDTA_InnerLeft
		IDTA_InnerTop
		IDTA_InnerRight
		IDTA_InnerBottom - offset from iconimage inside of the icon
		IDTA_FrameType - type of frame around the icon
		IDTA_TextPen - Outline pen for the icontext
		IDTA_TextMode - textmode
			IDTV_TextMode_Normal - standard text
			IDTV_TextMode_Outline - outline text
			IDTV_TextMode_Shadow - text with shadow (IDTA_TextPen
					       is the shadow color)
		IDTA_TextSkip - space between the icon and the text in pixels

    RESULT
	iconobject - iconobject.datatype object or NULL if it fails to open
		     the icon

    SEE ALSO


    NAME
	DisposeIconObject

    SYNOPSIS
	DisposeIconObject (iconobject)
	                       A0

	void DisposeIconObject ( struct iconobject );

    FUNCTION
	Disposes the iconobject. It's similar to intuitions DisposeObject().

    INPUTS
	iconobject - iconobject.datatype object

    RESULT

    SEE ALSO


    NAME
	GetDefIconObject

    SYNOPSIS
	iconobject GetDefIconObject (IconType,TagList)
	                                D0      A0

	struct iconobject GetDefIconObject ( ULONG IconType , APTR TagList );

    FUNCTION
	Reads a default icon from ram or disk.

    INPUTS
	IconType - diskobject icontype (see icon.library)
	TagList - the same tags like NewIconObject and:
		DTA_Name - you could give the icon a name

    RESULT
	iconobject - iconobject.datatype object or NULL if it fails.

    NOTE

    SEE ALSO


    NAME
	PutIconObject

    SYNOPSIS
	PutIconObject (iconobject,path,TagList)
	                   A0      A1    A2

	void PutIconObject ( struct iconobject, APTR path, APTR TagList );

    FUNCTION
	Writes an icon to disk. This function sends the IDTM_Write method

    INPUTS
	iconobject - iconobject.datatype object
	path - the path for the icon (without an extention)
	TagList -
		ICONA_NoNewImage - don't change the image (the readed image
				   will be rewritten)
		ICONA_NoPosition - save a non-position icon
		ICONA_NoUsePosition - use the current position of the icon-
				      object

    RESULT

    SEE ALSO


    NAME
	IsIconName

    SYNOPSIS
	pos IsIconName (filename)
	                   A0

	ULONG pos IsIconName ( APTR filename );

    FUNCTION
	Checks if the given filename could be an icon, because you don't know
	which extention it could have.

    INPUTS
	filename - the path to check

    RESULT
	pos - NULL if it's not an icon
	      ~0 if it's an icon, but it has no extention
	      >0 the position inside the filename where the extention begins

    SEE ALSO


    NAME
	Convert2IconObject

    SYNOPSIS
	iconobject Convert2IconObject (diskobject)
	                                   A0

	struct iconobject Convert2IconObject ( struct diskobject );

    FUNCTION
	Converts a icon.library - diskobject to a iconobject.datatype object.

    INPUTS
	diskobject - icon.library - diskobject

    RESULT
	iconobject - iconobject.datatype object

    NOTE
	THIS FUNCTION IS PRIVATE! IT SHOULD NOT BE USED!

    SEE ALSO