/*  					W3C Sample Code Library libwww Icon Management!  Icon Management!*//***	(c) COPYRIGHT MIT 1995.**	Please first read the full copyright statement in the file COPYRIGH.*//*Icons for directory listsings etc. are bound to MIMEcontent-types and content-encodings as describedin the format manager. These functions bind iconURLs to given content-type or encoding templates. Templatescontaining a slash are taken to be content-type templates, otherare content-encoding templates.This module is implemented by HTIcons.c, and it isa part of the  W3C Sample CodeLibrary.*/#ifndef HTICONS_H#define HTICONS_H#include "WWWLib.h"/**/typedef struct _HTIconNode HTIconNode;/*.  Add new Icons.All of these functions take an absolute URL and alternate text to use. Addan icon the list(  Generic Icons)*/extern BOOL HTIcon_add (const char * url, const char * prefix,				char * alt, char * type_templ);/*(  Specific Icons)We also have a special set of icons used to represent well-known things indirecctory listings.  Unknown IconAdd a unknown icon representing files that we can't figure out what is andhence can`'t come up with a better icon.*/extern BOOL HTIcon_addUnknown (const char * url, const char * prefix,				char * alt);/*  Empty IconIn order to aligned HTML pages for directory listings in preformatted mode,we need an empty (or blank) icon of the same size as the other icons.*/extern BOOL HTIcon_addBlank (const char * url, const char * prefix,				char * alt);/*  Parent IconAdd an icon representing a level up in a directory listing - the parentdirectory.*/extern BOOL HTIcon_addParent (const char * url, const char * prefix,				char * alt);/*  Directory IconThis icon represents a directory or a folder*/extern BOOL HTIcon_addDir (const char * url, const char * prefix,				char * alt);/*.  Find an Icon.This is a simplified file mode enumeration that can is used in directorylistings.*/typedef  enum _HTFileMode {    HT_IS_FILE,				/* Normal file */    HT_IS_DIR,				/* Directory */    HT_IS_BLANK,			/* Blank Icon */    HT_IS_PARENT			/* Parent Directory */} HTFileMode;extern HTIconNode * HTIcon_find (HTFileMode	mode,				 HTFormat	content_type,				 HTEncoding	content_encoding);/*.  Icon URL.When you want to add the icon reference into a directory listing, you canget the URL of the icon by using this method. Don't free or modify the stringreturned!*/extern char * HTIcon_url (HTIconNode * node);/*.  Alternative text.Get the alternative text (if any) for text based clients or if you don'twant to download the image right away. The string returned must be freedby the caller.*/extern char * HTIcon_alternative (HTIconNode * node, BOOL brackets);/*.  Delete all icons.Cleans up all memory used by icons. Should be called byHTLibTerminate() (but it isn't).*/extern void HTIcon_deleteAll (void);/*.  A Standard Set of Icons.The WWWFile interface does not define a defaultset of icons but the Library distribution files comes with a standardset of icons that can be used if desired. The Icons can be found in$(datadir)/www-icons.The set covers the types described belowand they can be set up using the HTIconInit()initialization function in the WWWInit startupinterface	 	   o 	     blank.xbm for the blank icon  o 	     directory.xbm for directory icon  o 	     back.xbm for parent directory  o 	     unknown.xbm for unknown icon  o 	     binary.xbm for binary files  o 	     text.xbm for ascii files  o 	     image.xbm for image files  o 	     movie.xbm for video files  o 	     sound.xbm for audio files  o 	     tar.xbm for tar and gtar files  o 	     compressed.xbm for compressed and gzipped files	 */#endif /* HTICONS *//*    @(#) $Id: HTIcons.html,v 2.25 2000/01/04 20:25:32 kahan Exp $*/