Operation Procedures
Procedures:

Register  CLOCK WERKS

Order CLOCK WERKS Directly From MAGMA CONCEPTS

Save configuration

Select Clock for Customizing

Set Local Time Zone

Customize Clock Styles

Customize Clock Colors

Select a city name from the internal database or enter customized city name and GMT offset

Add Customized City Name and GMT Offset

Delete a Clock

Copy a Clock

Apply Color to All Clocks

Using User-defined Bitmap for Clock Face

See also Contents


AddCityName
Add Customized City Name and GMT Offset to Database

The database file for storing world city names and GMT offset is CITYNAME.TXT.

It is located in the current working subdirectory where CLOCK WERKS.is installed (normally c:\windows\wclocks).

CITYNAME.TXT is a plain text file and can be edited by any text editor. Windows Notepad, for example, can be used to the edit this file. Other city names and GMT offset that are not listed in the original distribution.can be added by editing this file.

Just follow the format of other defined city names and GMT offsets to add new city names and GMT offsets.


Using User-defined Bitmap for Clock Face

User can use his or her bitmap file displayed as clock face. The feature is accessed by Options|Clock Style and select one of the following selections:

User Defined Digital 12 Hour: digital clock showing a bitmap from the file STARS.BMP* in the current working subdirectory. 12 hour format is used.

User Defined Digital 24 Hour: digital clock showing a bitmap from the file STARS.BMP* in the current working subdirectory. 24 hour format is used.

*User is allowed to copy his or her bitmap file to STARS.BMP. For best appearance, a 16-color 300x300 bitmap should be used.


Order  CLOCK WERKS
Order CLOCK WERKS (TM) Directly From MAGMA CONCEPTS

You can order additional copies of CLOCK WERKS from MAGMA CONCEPTS by contacting MAGMA CONCEPTS directly.

MAGMA CONCEPTS can be reached by mail, phone, or fax. The address is:

MAGMA CONCEPTS

P.O. BOX 621

Princeton Junction, NJ 08550

TEL: (609)799-1221

FAX: (609)799-1221

Price for Each Copy:     $19.95.

Site License is available. Please contact MAGMA Concepts for detail.

If the order is for individual user, please provide the following information:

User's Name.

Company Name. (if applicable)

Address.

If the order is for a site license, please provide the following information:

The site name applicable for the license.

The number of copies licensed for that site.

Company Name.

Company Address.

Customers will receive CLOCK WERKS on floppy diskettes. By default, 31/2 high density diskette will be used to ship the software. The following diskette format are available, 31/2 720K, 31/2 1.44M, 51/4 360K, or 51/4 1.2M. Since all documentation is provided on-line, no owner manual is offered unless requested by customer. Customer will receive notice about product upgrade information and new products from MAGMA CONCEPTS.


Set Local Time Zone

CLOCK WERKS is designed for world-wide use. The user is responsible for selecting the correct local time zone so that GMT time is displayed correctly, and therefore times for other cities are displayed correctly.

The local time zone can be set by using Options|Set Local Time Zone. User can pick from the list of cities the city that has the same time zone as the user's local time zone. Or  the user can enter to GMT offset for the local time zone.

The format for entering the GMT offset is [Sign]HH:MM

where  the optional Sign is either + or -, HH is the hour offset, and MM is the minute offset.

For example, -2:30 is used to set local time zone to be 2 hours 30 minutes behind GMT. Similarly  +5 (or +5:00 or 5:00) is used to set local time zone to be 5 hours before GMT.


True Clock Appearance Display
True-Clock-Appearance Display

Each clock is displayed as an analog or digital clock, the appearance of which imitates a true analog clock or a true digital clock.


CLOCK WERKS Features
CLOCK WERKS (TM) Features Highlight

Welcome to the world of CLOCK WERKS. The CLOCK WERKS enables you to:

(1) Concurrently display time of cities around world using true-clock-appearance display.

(2) Concurrently display up to 50 clocks for each activation of the application.

(3) Display hundreds of clocks by multiple activations of the application.

(4) Display clock face as analog, digital, or user-created bitmap file.

(5) Independently select each clock's display style.

(6) Independently customize each clock's color attributes.

(7) Save the current display configuration to default configuration file.

(8) Manually save the current display configuration to other files for multiple activations of CLOCK WERKS.

(9) Add new city name and GMT offset to database using text editor.


Contents
Contents:

CLOCK WERKS (TM) Features Highlight

DISCLAIMER OF WARRANTY

System Requirements

Installation

Contact MAGMA CONCEPTS

Register CLOCK WERKS

Unregistered Version vs. Registered Version

Order CLOCK WERKS Directly From MAGMA CONCEPTS

Getting On-line help

Conventions

Save Configuration to Default File

Save Configuration to Other Files

Select Clock for Customizing

Add Customized City Name and GMT Offset

Customize clock styles

Customize clock colors

Select a city name from the internal database or enter customized city name and GMT offset

Delete a Clock

Copy a Clock

Apply Color to All Clocks

Automatic Day-Night Color Change


Day Night Color Change
Automatic Day-Night Color Change

For analog clock style, the clock face color changes automatically according to the following rules:

Day time color is controlled by the color attributes Day Color, and night time color is controlled by the color attributes Night Color. Each can be changed by using Options|Change Colors.

If current time for a given clock is between 6:00AM and 6:00PM, the Day Color is used to display the clock's face, otherwise the Night Color is used to display the clock's face.


Conventions
Conventions:

Throughout this documentation, the menu selections are shown as MenuItem1|MenuItem2|MenuItem3...,

where MenuItem1 is the menu selection item from top menu, MenuItem2 is the menu selection under MenuItem1, and MenuItem3 is the menu selection under MenuItem2.


Save Configuration
Save configuration:

The current system setting can be saved manually by using menu option File|Save or File|Save as.

File|Save saves current configuration to CLOCKS.DAT in the current working subdirectory for CLOCK WERKS. No prompt is shown for this operation.

Each time user quits the application, the current configuration is saved in CLOCKS.DAT in the current working subdirectory for CLOCK WERKS.

File|Save as saves current configuration to a file selected by the user. The saved configuration can be loaded using File|Open.


Automatic Configuration Save
Save Configuration to Default File:

Each time user quits the application, the user is asked if he or she wants to save the current configuration. If the answer is yes, the current configuration is saved in CLOCKS.DAT in the current working subdirectory for CLOCK WERKS.

Using Customized Clock Definitions:

User has the option of using his or her own city names and GMT offset for these city names. In order to use this feature, the following steps are taken:

(1) use File|Save as to save current configuration to a file other than CLOCKS.DAT, so that later the current configuration can be restored by using File|Open and select this saved file.

(2) edit the file CLOCKS.DEF to include a list of clocks you wish to show in the panel. You must observe the following rules:

- If the first char of a line stars with #, the line is a comment line.

- City name field is separated from GMT or LOCAL offset by a "," (comma).

- The first clock name must be GMT, and the hour offset must start with LOCAL keyword and the number is the hour offset of GMT from local time.

- The following clock names can be any city names, and the hour offset must start with GMT keyword and the number is the hour offset of that city from GMT time.

The distribution file CLOCKS.DEF can be used as template to create your own CLOCKS.DEF.

(3) use File|New option to load CLOCKS.DEF into current configuration.

(4) Customize clock styles and customize colorsas you wish.


Customize Clock Styles
Customize clock styles:

First select a clock by single clicking its face.

Then use OPTION|CLOCK STYLES to select one of styles listed.

The following clock styles are supported currently:

Solid Analog:  analog clock. The face color for day and night automatically switches. Therefore, user can tell whether it is in the afternoon or in the evening.

Solid Digital 12 Hour: digital clock which displays using 12 hour format. PM is indicated by a small circle on the upper left corner of the display panel.

Solid Digital 24 Hour: digital clock which displays time using 24 hour format.

Summer Night Digital 12 Hour: digital clock showing a summer night background, using 12 hour format.

Summer Night Digital 24 Hour: digital clock showing a summer night background, using 24 hour format.

User Defined Digital 12 Hour: digital clock showing a bitmap from the file STARS.BMP* in the current working subdirectory. 12 hour format is used.

User Defined Digital 24 Hour: digital clock showing a bitmap from the file STARS.BMP* in the current working subdirectory. 24 hour format is used.

*User is allowed to copy his or her bitmap file to STARS.BMP. For best appearance, a 16-color 300x300 bitmap should be used.


Customize Clock Colors
Customize Clock Colors:

The color attributes of each clock can be independently changed. For a "Solid Analog" clock, five color attributes can be changed:

Day Color, Night Color, Tick Color, Pointer Color, and Text Color.

For a "Solid Digital" clock, five color attributes can be changed:

Face Color - Day, Face Color - Night, Digit Background Color, Digit Color, and Text Color.

For other clocks styles, certain color attributes won't apply. The actual color of the clock face may depend on the bitmap.

In order to change the color attribute of a clock, first highlight the clock by single-clicking on its face. Second, use OPTION|CHANGE COLORS to select a color attribute to change. A dialog box will display a list of available colors. Just click one of the color boxes, and then click OK button. The color change will take effect immediately.


Select City Name and Change GMT Offset
Select a city name from the internal database or enter customized city name and GMT offset:

The city name and GMT offset can be independently changed for each displayed clock., except the GMT reference clock.

In order to change the city name, use OPTION|CHANGE CITY NAME. A dialog box will let user to pick from the internal database or type his or her own city name and GMT offset. The internal database contains a list of major cities around the world and their GMT offset.

The GMT offset is specified by [sign]HH:MM, where sign is either + or -, and HH is the hour, and MM is the minute.

Once city name and GMT offset are verified to be correct, click the OK button. The clock will now show the new city name and new time.


Contact MAGMA CONCEPTS
Contact MAGMA CONCEPTS:

MAGMA CONCEPTS can be reached by mail, phone, or fax. The address is:

MAGMA CONCEPTS

P.O. BOX 621

Princeton Junction, NJ 08550

TEL: (609)799-1221

FAX: (609)799-1221


Register CLOCK WERKS
Register CLOCK WERKS (TM):

The CLOCK WERKS is shareware and can be downloaded from COMPUSERV. User must register CLOCK WERKS after the 30-day trial period. In order to do so, the user must first contact MAGMA CONCEPTS and provide the following items:

Registration fee of    $19.95.

Serial Number displayed under HELP|ABOUT.

User's Name.

Company Name.(if applicable)

Address.

MAGMA CONCEPTS can be reached by mail, phone, or fax. The address is:

MAGMA CONCEPTS

P.O. BOX 621

Princeton Junction, NJ 08550

TEL: (609)799-1221

FAX: (609)799-1221

MAGMA CONCEPTS will FAX back a REGISTRATION Number, which user enters into CLOCK WERKS database by using HELP|REGISTRATION.

Registered users will receive the registered version on a diskette. By default, 31/2 high density diskette will be used to ship the software. The user can choose from 31/2 720K, 31/2 1.44M, 51/4 360K, or 51/4 1.2M. Since all documentation is provided on-line, no owner manual is offered unless requested by users. Registered users will also receive notice about product upgrade information and new products from MAGMA CONCEPTS. .

Technical support can be obtained by sending mail to COMPUSERV ID 73261,2406. MAGMA CONCEPTS will try to solve problems as soon as possible.


Shareware Version
Unregistered Version vs. Registered Version:

Instead of providing a restricted version of CLOCK WERKS, the unregistered version is almost identical to the registered version during the 30-day trial period, except once registered with proper information entered, the HELP|ABOUT will show the correct user registration information and the title bar only displays CLOCK WERKS.

If after the 30-day trial period the user decides not to register CLOCK WERKS, the number of clocks that can be displayed becomes two, the title bar will indicate the expired condition, and the application can be run only once. All other features remain unchanged.


Getting Help
Getting On-line help:

Help on usage and registration can be obtained on-line by using menu HELP and select the interested category.


Select Clock
Select Clock for Customizing:

Single clicking a clock's face will toggle the selected status of that clock. Once selected, a highlight rectangle will be display around the clock surface. A clock must be selected first before any operation can be applied to it.


Delete Clock
Delete a Clock:

Select a clock first. Then use EDIT|DELETE to delete the clock from the display surface.


Copy Clock
Copy a Clock:

Select a clock first. Then use EDIT|COPY to copy the selected clock to a new clock which has the same configuration as the selected clock. This clock will be added to the end of current clock list.


Apply Color
Apply Color to All Clocks:

The color attributes of a selected clock can be applied to all clocks on the display. This is accomplished by use OPTION|APPLY COLOR TO ALL.


Installation
Installation:

For Microsoft Windows (TM) users, following these steps:

Assume C:\WINDOWS\WCLOCKS subdirectory is used for the installation. Other subdirectory may be used.

From DOS Prompt:

(1) Create subdirectory WCLOCKS in C:\WINDOWS by using the following commands:

C:>CD C:\WINDOWS

C:\WINDOWS>MD WCLOCKS

(2) Insert diskette in A: drive

(3) Copy all files in A: to C:\WINDOWS\WCLOCKS by using the following command:

COPY A:*.* C:\WINDOWS\WCLOCKS

(4) Start Windows(TM) 3.1. Open "Accessories" group.

(5) Select FILE, then NEW to create a new program item.

(6) Supply the following information:

Description: CLOCK WERKS

Command Line: C:\WINDOWS\WCLOCKS\WCLOCKS.EXE

Working Directory: C:\WINDOWS\WCLOCKS

(7) Push OK button to create the program item.

(8) Use CLOCK WERKS the same way as other Windows (TM) applications.

(9) The local time zone must be set by user within CLOCK WERKS application.

For IBM OS/2 Users, copy distribution files to a subdirectory. Then create a program item for CLOCK WERKS following instructions in the IBM OS/2 user manual.

The local time zone must be set by user within CLOCK WERKS application.


System Requirements
System Requirements:

Hardware requirements: IBM PC or Compatible.

Software Requirements: Microsoft Windows (TM) 3.1 or IBM OS/2 (TM) v2.0 above running Windows (TM).

CLOCK WERKS has been tested on the following platforms:

DOS 5.0 running Microsoft Windows (TM) 3.1, both VGA and Super VGA.

OS/2 V2.1 running Microsoft Windows application CLOCK WERKS.


Disclaimer of Warranty
DISCLAIMER OF WARRANTY:

THIS SOFTWARE AND DOCUMENTATION ON ITS USE ARE PROVIDED "AS IS" AND SOLD "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NONCRITICAL DATA BEFORE RELYING ON IT.  THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.