NAME Apache::Icon - Lookup icon images SYNOPSIS use Apache::Icon (); my $icon = Apache::Icon->new($subr); my $img = $icon->find || $icon->default; my $alt = $icon->alt; DESCRIPTION This module rips out the icon guts of mod_autoindex and provides a Perl interface for looking up icon images. The motivation is to piggy-back the existing *AddIcon* and related directives for mapping file extensions and names to icons, while keeping things as small and fast as mod_autoindex does. METHODS new Create a new *Apache::Icon* object with the given *Apache::SubRequest* object. Example: for my $entry (sort $dh->read) { next if $entry eq '.'; my $subr = $r->lookup_file($entry); my $icon = Apache::Icon->new($subr); ... find Lookup icon image associated with the subrequest. my $img = $icon->find; default Lookup the default icon images. my $img = $icon->default; #DefaultIcon (unknown.gif) my $img = $icon->default("^^DIRECTORY^^"); #folder.gif my $img = $icon->default("^^BLANKICON^^"); #blank.gif alt Lookup the text alternative specified by the AddAlt directive. my $alt = $icon->alt || $img; DIRECTIVES Refer to the *mod_autoindex* documentation for directives listed here with no description. IconDouble This directive can be set to *On* or *Off*. The default is *On* if *mod_autoindex* is configured with the server, *Off* otherwise. When the directive is *On*, *mod_icon* directive handlers will return DECLINE_CMD after processing which allows *mod_autoindex* to also handle the various *Icon* and *Alt* directives. AddIcon AddIconByType AddIconByEncoding AddAlt AddAltByType AddAltByEncoding DefaultIcon SEE ALSO Apache::AutoIndex(3) AUTHOR Doug MacEachern C code based on mod_autoindex by the Apache Group