NAME

SYNOPSIS

DESCRIPTION

XFaces can also be used to monitor other lists using the -e option or the listCommand resource.

OPTIONS

-c <columns>

Specify the number of images that faces will allow before starting a new row. This is also available as resource XFaces.frame.maxWidth.

-e <command>

Run <command> and use output for faces list. This is also available as XFaces.listCommand.

-f <facedb path>

This option set the default facedb search path to the colon separated list of directories specified in <facedb path>. Also available as resource XFaces.facedbPath.

-h <image height>

This option sets the height used internally by XFaces to layout images in a tiled fashion. This is also available as the resource XFaces.frame.tileHeight.

-p <update time>

Specify the amount of time to wait between checks for new mail. Also available as resource XFaces.update.

-s <spool file>

This option specifies an alternate mail spool file to watch. Also available as XFaces.spoolFile.

-w <image width>

This option sets the width used internally by XFaces to layout images in a tiled fashion. This is also available as the resource XFaces.frame.tileWidth.

-C

This option disables image compression. Image compression is used to only show a particular image only once in the display. Also available as resource XFaces.compressImages.

-K

This option insists that the order of the images in the display reflect the order of the images in the spool file or those returned by a <command>. Also available as resource XFaces.keepOrder.

-S

This option says not to shape extra space added to images that are smaller than the tile size.

-pop <hostname>

This option specifies the host name to use for a POP3 mailbox. Also available as XFaces.popHost.

X DEFAULTS

XFaces.allowShellResize: True

This will allow the XFaces window to resize to be the exact size that is required for the current images.

This program uses a very simple tiled layout widget to layout the images. Each image is displayed in an Athena Label widget. The name of the layout widget is frame and the following resources are available:

XFaces.frame.tileWidth: <tile width>

This resource specifies the width of the children that the Tiled widget is to manage. This size is enforced. The default is 64

XFaces.frame.tileHeight: <tile height>

This resource specifies the height of the children that the Tiled widget is to manage. This size is enforced. The default is 64.

XFaces.frame.setWidth: <force width>

This resource forces the width of the Tiled widget to be <width> tiles wide. If the value is zero then no width is forced. The default is 0.

XFaces.frame.setHeight: <force height>

This resource forces the height of the Tiled widget to be <height> tiles wide. If the value is zero then no height is forced. The default is 0.

XFaces.frame.minWidth: <minimum width>

This resource specifies the minimum width in tiles that the Tiled widget is allowed. If the value is zero then there is no minimum. The default is 0.

XFaces.frame.minHeight: <minimum height>

This resource specifies the minimum height in tiles that the Tiled widget is allowed. If the value is zero then there is no minimum. The default is 0.

XFaces.frame.maxWidth: <maximum width>

This resource specifies the maximum width in tiles that the Tiled widget is allowed. If the value is zero then there is no maximum. The default is 0. Note that since the Tiled widget lays out its children in row major order a value of 0 creates a horizontal list of images. If the value is specified as 1 a vertical list is created.

XFaces.frame.maxHeight: <maximum height>

This resource specifies the maximum height in tiles that the Tiled widget is allowed. If the value is zero then there is no maximum. The default is 0.

XFaces.frame.vertSpacing: <spacing>

This resource specifies the spacing in pixels that the Tiled widget places vertically between children.

XFaces.frame.horizSpacing

This resource specifies the spacing in pixels that the Tiled widget places horizontally between children.

XFaces.frame.internalWidth

This resource specifies the spacing in pixels that the Tiled widget places horizontally between its borders and its children.

XFaces.frame.internalHeight

This resource specifies the spacing in pixels that the Tiled widget places vertically between its borders and its children.

XFaces also introduces the following application resources:

XFaces.spoolFile: <mail spool file>

This can be used to specify the mail spool file to watch. The default is to append the users name onto the spoolDir resource.

XFaces.spoolDir: <mail spool directory>

This resource specifies the directory that contains user mail spool files. The default is /usr/spool/mail. On some machines (SVR4?) you may want to set this to /usr/mail.

XFaces.popHost: <hostname>

This resource specifies the name of a host to contact for a POP3 mailbox. Note that in order for this to work you need to create a file called .popauth in your home directory. The file needs to contain one line that contains your pop host login id followed by white space followed by your pop host password. Since this file contains a clear text password it is not the most secure method. I currently do not have access to a pop server that supports any other type of authentication.

XFaces.popPort: <port number>

This specifies what port number to use for POP. The default is the standard POP3 port 110.

XFaces.listCommand:<usercommand>

This resource specifies a user command that will be executed instead of looking at the spool file. If this resource is specified then value specified in the spoolFile is ignored. See the USER COMMANDS section for a description of the data format that XFaces expects from user commands.

XFaces.imagePath: <image path>

This resource specifies a colon-separated list of directories that specify the default directories to use for image files. The default is /usr/images.

XFaces.soundPath: <sound path>

This resource specifies a colon-separated list of directories that specify the default directories to use for sound files. The default is /usr/sounds.

XFaces.facedbPath: <facedb path>

This is a list of directories that contain a multi-level directory hierarchy. The first few levels are the host name where each part of the host name is a new directory level. Inside this is another directory using the users name. And finally, inside of this directory are the actual image and sound files for this user. The root of the face (for images and for sounds) is face. This file can be in any of the supported image/sound formats. See the description of the facedb search type under the imageSearch resource.

XFaces.machine: <machine file>

This resource specifies the name of a file that is used to alias machine names. Each facedb tree is allowed to contain one of these. The default is machine.tab. Any blank lines and lines starting with the # character are ignored. All other lines are expected to look like:

XFaces.people: <people file>

This resource specifies the name of a file that is used to alias user names for specific hosts. Each facedb tree is allowed to contain one of these. The default is people.tab. Any blank lines and lines starting with the # character are ignored. All other lines are expected to look like:

XFaces.update: <update time>

How often to check for new mail in seconds. The default is 60.

XFaces.volume:

The volume at which to play sounds. The default is 33.

XFaces.fromField:

This resource specifies which mail header to use as the from header. The default is the old uucp "From_" header. (the _ is really a space character)

XFaces.noMailImage: <empty image>

The image to use when you have no mail. The default is "nomail". The imagePath is used to locate this file.

XFaces.noMailSound: <empty sound>

The sound to use when you have no mail. The default not to play a sound with no mail. The soundPath is used to locate this sound.

XFaces.lookupHostname: <flag>

If this resource is True then the host name part of the from address will be looked up and translated to the real hostname. The default value is False.

XFaces.keepOrder: <flag>

This boolean resource controls the image ordering in faces. For performance reasons the default is False. When scripts are being run you will usually want to specify this as True.

XFaces.compressImages: <flag>

Only show each image once in the image display. The default is True. When scripts are being run you will usually want to specify this as False.

XFaces.useSound: <flag>

Play sounds. The default is True. A user can disable sounds for his XFaces by setting this resource to False in his resources.

XFaces.useShape: <flag>

Use shaped images if available. This will also cause the background of the XFaces main window to become transparent where there is no image. This defaults to True.

XFaces.useCommands: <flag>

This resource tells XFaces if it needs to search for shell commands to run in addition to image and sounds. The default is False .

XFaces.useContentLength: <flag>

This resource enable code to use a Content-Length: mail header to specify how large the mail body is. After the headers this many bytes are skiped.

XFaces.shapeBorders: <flag>

This resource, when set to True will cause the borders of the Label widgets to be shaped out. The default is True.

XFaces.shapeInternal: <flag>

This resource when set to True will cause the internal width and height margins of the Label widgets to be shaped out. The default is True.

XFaces.closeness: <closeness value>

This resource controls how close a color must come to the actual color for the XPM library to accept it. The default is 40000.

XFaces.imageTypes: <image type list>

This resource specifies the default image types that are used to attempt to load an image file. The list also specifies the order the types are attempted. Valid types are:

XFaces.imageSearch: <search specs>

XFaces.soundSearch: <search specs>

XFaces.commandSearch: <search specs>

These resources have complete control of the search type , image types for images and path arguments for locating images, sounds and commands. The search spec is a multi line resource. Each line represents a new search. Each line is constructed as follows:

XFaces.beforeImageBindings: <spec>

XFaces.afterImageBindings: <spec>

XFaces.beforeSoundBindings: <spec>

XFaces.afterSoundBindings: <spec>

XFaces.beforeCommandBindings: <spec>

XFaces.afterCommandBindings: <spec>

These resources specify regular expressions that can be matched against the mail headers to locate an image or sound. These are multi-line resources. Each line is constructed as:

XFaces.ignoreMessageBindings:

These resources specify regular expressions that can be matched against the mail headers to locate an image or sound. These are multi-line resources. Each line is constructed as:

XFaces.annotationCount: <number of annotations>

XFaces.unknownAnnotationCount: <number of annotations>

This resource specifies the number of annotations that the user is specifing. The unknown annotations are applied on faces that were located via the facedb search when substituting "unknown" for the user name. For each annotation the following resources will be retrieved where N runs from 1 to annotationCount (or unknownAnnotationCount)

XFaces.mail.annotationN: <type>

XFaces.mail.unknownAnnotationN: <type>

This specifies what is to be placed into this annotation position for mail items. The values for type are:

none

An empty string.

user

The user part of the From address.

host

The host part of the From address.

user@host

The user and host parts of the From address.

count

The number of messages represented by this face.

*<header>

Any value beginning with a '*' is expected to be a header name and the contents of that header will be displayed. For instance "*subject:" will display the subject line.

XFaces.annotationAbove: <flag>

This really should be called something else! Anyway, when this resource is true and the image found is smaller than the tile size the extra space allocated will be placed on teh top instead of the bottom. The default value is False.

XFaces.background: <color>

This is the color of any extra image space allocated.

XFaces.shapeExtra: <flag>

This, if true, will cause any extra image space allocated to be shaped out.

XFaces.xbm.foreground: <color>

This is the foreground color for loaded X bitmaps.

XFaces.xbm.background: <color>

This is the background color for loaded X bitmaps.

XFaces.xpm.noneColor: <color>

This is the color used to represent the transparent pixels when the overrideNoneColor is True.

XFaces.xpm.overrideNoneColor: <flag>

When this value is set to true the transparent pixels in a Xpm image are replaced bu the color specified in the noneColor resource. The default value is False.

XFaces.xpm.filterCount: <count>

This resource specifies the number of external filters to look for. The filters are specified with the following resources:

USER COMMANDS

The first line consists of two tokens. The first is expected to be a user name and the second a host name. They are intended to describe the image that should be displayed by XFaces in an iconic state. Note: This is currently not implemented though the line is still expected.

The second line is expected as

Each line following is expected to contain two to six TAB separated fields. The fields are: user, host, annotation1, annotation2, annotation3, annotation4. See the annotationCount resource to see how to specify how and where each of the annotations are displayed.

Steve Kinzler maintains a distribution of scripts that can be used to generate faces lists in cs.indiana.edu:pub/faces/scripts.tar.Z.

SEE ALSO

AUTHOR

ACKNOWLEDGEMENTS

Thanks also go to James Ashton for the X-Faces header face compression / decompression code.