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.

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.