EYECLOCK(1)

NAME
EyeClock - A clock application for X. The eyes follow the mouse pointer.

SYNOPSIS
eyeclock [ options ]

DESCRIPTION
EyeClock is a simple clock application for X11. You can put your favorite picture on the face of the clock. And you can move the eyes of the picture following the mouse pointer.

RESOURCES
You can use all of the standard X-Toolkit resources. Default resource file is "<XRoot>/lib/X11/app-defaults/EyeClock".

eyeclock.geometry : [WxH+X+Y]
    This resource specifies the placement of the window on the screen.

eyeclock.title : [titlename]
    This resource specifies the title of the clock.

eyeclock.iconName : [titlename]
    This resource specifies the title of the clock in icon.

eyeclock.iconPixmap : [XPM or Bitmap file]
    This resource specifies icon picture.

eyeclock.iconMask : [XPM or Bitmap file]
    This resource specifies mask picture of icon.

eyeclock.background : [color]
    This resource specifies background color of the clock. This resource is available when the face picture is not specified.

eyeclock.clock.geometry : [WxH+X+Y]
    This resource specifies the placement of the clock on the screen.

eyeclock.clock.root : [True : False]
    Pasting the clock to the root window or not.

eyeclock.clock.face : [XPM file]
    This resource specifies the face picture of the clock. All pictures in EyeClock are XPM format.

eyeclock.clock.interval : [milli seconds]
    This resource specifies the interval timer for milli seconds. Default value of interval timer is 100.

eyeclock.clock.Hand.geometry : [TxL+X+Y]
    This resource specifies the length, thickness, and placement of the hands of the clock. These parameters are specified by percentage of the clock size.

eyeclock.clock.Hand.active : [True : False]
    The hands are active or not.

eyeclock.clock.Hand.foreground : [color]
    This resource specifies color of hands.

eyeclock.clock.Hand.borderColor : [color]
    This resource specifies edge color of hands.

eyeclock.clock.Hand.borderWidth : [x]
    This resource specifies edge width of hands by percentage of the clock size.

eyeclock.clock.Hand.width : [x]
    This resource specifies the width of hands by percentage of the clock size.

eyeclock.clock.Hand.length : [x]
    This resource specifies the length of hands by percentage of the clock size.

Resources like "eyeclock.clock.hour.XXXXXXXX", "eyeclock.clock.minute.XXXXXXXX", "eyeclock.clock.second.XXXXXXXX" are equal to above resources. Resource like "eyeclock.clock.Hand.XXXXXXXX" effects all hands. Resource like "eyeclock.clock.hour.XXXXXXXX" effects only hour hand.

eyeclock.clock.Number.geometry : [WxH+X+Y]
    This resource specifies the placement of the numbers on the clock. X and Y specify the center of the numbers by percentage of the clock.

eyeclock.clock.Number.active : [True : False]
    The numbers are active or not.

eyeclock.clock.Number.length : [x]
    This resource specifies distance of the numbers from center of the clock.

eyeclock.clock.Number.figure : [XPM file]
    This resource specifies the picture of the numbers.

eyeclock.clock.Number.mask : [XPM file]
    This resource specifies the mask picture of the numbers. If mask pictures are not specified, EyeClock makes mask pictures automatically.

eyeclock.clock.Number.size : [WxH]
    This resource specifies the size of the pictures.

Resources like "eyeclock.clock.number1.XXXXXXXX", "eyeclock.clock.number2.XXXXXXXX", ... , and, "eyeclock.clock.number12.XXXXXXXX" are equal to above resources. Resource like "eyeclock.clock.Number.XXXXXXXX" effects all numbers. Resource like "eyeclock.clock.number1.XXXXXXXX" effects only number 1.

eyeclock.clock.Eye.geometry : [WxH+X+Y]
    This resource specifies the placement of the eyes.

eyeclock.clock.Eye.active : [True : False]
    The eyes are active or not.

eyeclock.clock.Eye.fillColor : [True : False]
    Being full of background color or not.

eyeclock.clock.Eye.fillPixmap : [True : False]
    Being full of mask picture or not.

eyeclock.clock.Eye.background : [color]
    This resource specifies background color of the eyes.

eyeclock.clock.Eye.move [XxY]
    This resource specifies speed of the eyes moving by percentage. Default value is 100x100.

eyeclock.clock.Eye.limit [XxY]
    This resource specifies limit of the eyes moving by percentage. Default value is 75x75.

eyeclock.clock.Eye.offset [XxY]
    This resource specifies offset of the eyes placement for adjustment. Default value is 0x0.

eyeclock.clock.Eye.coreFigure [XPM file]
    This resource specifies picture of the iris.

eyeclock.clock.Eye.coreMask [XPM file]
    This resource specifies mask picture of the iris. If mask pictures are not specified, EyeClock makes mask pictures automatically.

eyeclock.clock.Eye.eyeFigure [XPM file]
    This resource specifies picture of the eyes.

eyeclock.clock.Eye.eyeMask [XPM file]
    This resource specifies mask picture of the eyes. If mask pictures are not specified, EyeClock makes mask pictures automatically.

eyeclock.clock.Eye.coreSize [WxH]
    This resource specifies the size of the iris.

eyeclock.clock.Eye.eyeSize [WxH]
    This resource specifies the size of the eyes. Resources like "eyeclock.clock.left.XXXXXXXX", "eyeclock.clock.right.XXXXXXXX", "eyeclock.clock.eye3.XXXXXXXX", ... , and, "eyeclock.clock.eye8.XXXXXXXX" are equal to above resources. Resource like "eyeclock.clock.Eye.XXXXXXXX" effects all eyes. Resource like "eyeclock.clock.left.XXXXXXXX" effects only left eye.

OPTIONS
You can use all of the standard X-Toolkit options.

-display [displayname]
    This option specifies the name of the X server to use.

-geometry [WxH+X+Y]
    This option specifies the placement of the window on the screen.

-title [titlename]
    This option specifies the title of the clock.

-name [name]
    This option specifies the name of the application.

-background [color], -bg [color]
    This option specifies background color of the clock. This option is available when the face picture is not specified.

-icon-pixmap : [XPM file]
    This option specifies icon picture.

-icon-mask : [XPM file]
    This option specifies mask picture of icon.

-clock-geometry : [WxH+X+Y]
    This option specifies the placement of the clock on the screen.

-root
    Pasting the clock to the root window.

-no-root
    Not pasting the clock to the root window.

-face [XPM file]
    This option specifies the face picture of the clock. All pictures in EyeClock are XPM format.

-interval [milli seconds]
    This option specifies the interval timer for milli seconds. Default value of interval timer is 100.

-hands-geometry [TxL+X+Y]
    This option specifies the length, thickness, and placement of the hands of the clock. These parameters are specified by percentage of the clock size.

-hands-active
    The hands are active.

-hands-no-active
    The hands are not active.

-hands-foreground [color], -hands-fg [color]
    This option specifies color of hands.

-hands-bordercolor [color], -hands-bc [color]
    This resource specifies edge color of hands.

-hands-borderwidth [x], -hands-bw [x]
    This option specifies edge width of hands by percentage of the clock size.

-hands-width [x]
    This option specifies the width of the hands by percentage of the clock size.

-hands-length [x]
    This option specifies the length of the hands by percentage of the clock size.

Options like "-hour-XXXXXXXX", "-minute-XXXXXXXX", and, "-second-XXXXXXXX" are equal to above options. Option like "-hands-XXXXXXXX" effects all hands. Option like "-hour-XXXXXXXX" effects only hour hand.

-numbers-geometry [WxH+X+Y]
    This option specifies the placement of the numbers on the clock. X and Y specify the center of the numbers by percentage of the clock.

-numbers-active
    The numbers are active.

-numbers-no-active
    The numbers are not active.

-numbers-length [x]
    This option specifies distance of the numbers from center of the clock.

-numbers-figure [XPM file]
    This option specifies the picture of the numbers.

-numbers-mask [XPM file]
    This resource specifies the mask picture of the numbers. If mask pictures are not specified, EyeClock makes mask pictures automatically.

-numbers-size [WxH]
    This resource specifies the size of the pictures.

Options like "-number1-XXXXXXXX", "-number2-XXXXXXXX", ... , and, "-number12-XXXXXXXX" are equal to above options. Option like "-numbers-XXXXXXXX" effects all numbers. Option like "-number1-XXXXXXXX" effects only number 1.

-eyes-geometry [WxH+X+Y]
    This option specifies the placement of the eyes.

-eyes-active
    The eyes are active.

-eyes-no-active
    The eyes are not active.

-eyes-fill-color
    Being full of background color.

-eyes-no-fill-color
    Not being full of background color.

-eyes-fill-pixmap
    Being full of mask picture.

-eyes-no-fill-pixmap
    Not being full of mask picture.

-eyes-background [color], -eyes-bg [color]
    This option specifies background color of the eyes.

-eyes-move [XxY]
    This option specifies speed of the eyes moving by percentage. Default value is 100x100.

-eyes-limit [XxY]
    This option specifies limit of the eyes moving by percentage. Default value is 75x75.

-eyes-offset [XxY]
    This option specifies offset of the eyes placement for adjustment. Default value is 0x0.

-eyes-core-figure [XPM file]
    This option specifies picture of the iris.

-eyes-core-mask [XPM file]
    This option specifies mask picture of the iris. If mask pictures are not specified, EyeClock makes mask pictures automatically.

-eyes-eye-figure [XPM file]
    This option specifies picture of the eyes.

-eyes-eye-mask [XPM file]
    This option specifies mask picture of the eyes. If mask pictures are not specified, EyeClock makes mask pictures automatically.

-eyes-core-size [WxH]
    This option specifies the size of the iris.

-eyes-eye-size [WxH]
    This option specifies the size of the eyes.

Options like "-left-XXXXXXXX", "-right-XXXXXXXX", "-eye3-XXXXXXXX", ... , and, "-eye8-XXXXXXXX" are equal to above options. Option like "-eyes-XXXXXXXX" effects all eyes. Option like "-left-XXXXXXXX" effects only left eye.

DEFAULT PICTURES
If you use below letters for picture in options or resources, you can use default pictures.

DefaultIconFace
    Default icon picture.

DefaultFace
    Default face of the clock.

DefaultLeftCore
    Default left core(iris) picture of the face.

DefaultRightCore
    Default right core(iris) picture of the face.

DefaultLeftEye
    Default left eye picture of the face.

DefaultRightEye
    Default right eye picture of the face.

DefaultNumber1 - DefaultNumber12
    Default number pictures of the clock.

DefaultRNumber1 - DefaultRNumber12
    Default number pictures of the clock. (Roman letters)

DefaultNumberBig
    Default number picture of the clock. (Large ball)

DefaultNumberSmall
    Default number picture of the clock. (Small ball)

DefaultNumberNeedle0 - DefaultNumberNeedle5
    Default number pictures of the clock. (Like needle)

KEY OPERATION

i   Iconify Window.

r   Resize the window to default size.

q, Ctrl-c
    Quit.

SIGNAL

SIGINT
    EyeClock will end by recerving SIGINT.

SIGHUP
    EyeClock will raise the window to the top by recerving SIGHUP.

PERIOD
EyeClock use the functions time(3) and localtime(3). Period of EyeClock depends on them.

SEE ALSO
X(1)

FILES

<XRoot>/lib/X11/EyeClock
    COPYRIGHT, README, XPM files, etc...

<XRoot>/lib/X11/app-defaults/EyeClock
    Specifies required resources.

AUTHOR
Programed by Sakai Hiroaki.
E-Mail : sakai@seki.ee.kagu.sut.ac.jp
http://www.seki.ee.kagu.sut.ac.jp/~sakai/myfreesoft.html

SPECIAL THANKS
Tsukuno Sawako, Morimi Asuka, and Kazuya Hirobe for drawing many sample pictures.
Umehara Taro for drawing a default face picture.
Tanaka Makoto for giving a sample picture.
Hashimoto Jun for many advices.
Sakai Takeyasu for many advices.

COPYRIGHT
EyeClock Copyright (C) 1998-1999 Sakai Hiroaki.
All Rights Reserved.