[ Impressum ]

LiveCode arClock

www.Rozek.de > LiveCode > DropTools > arClock
 
The "arClock" is a small LiveCode [1] control in the form of a "DropTool" [2]. It mimics a minimalistic analog clock and can thus serve as an unobtrusive time display in a spare area of an application.

Download and Installation

The "arClock" is available as unencrypted LiveCode stack and can be downloaded from here:
As usual for a DropTool, the "arClock" should be copied into the "DropTools" subfolder next to the DropTools plugin after download.

Should the LiveCode development environment be already open and the "stsDropTools" plugin be loaded, the corresponding window should first be closed again. After (re)opening the plugin, the "arClock" should appear in the list of DropTools.

Usage Instructions

In the DropTools terminology, the "arClock" is a "prescripted DropTool" and can thus be transferred directly into a "DropStack" without additional measures. Time display begins as soon as the "arClock" has been copied into the "DropStack".

Custom Properties

The "arClock" supports the following custom properties:

LineColor

The LineColor of an "arClock" determines the color in which it is drawn. The LineColor may be specified as
  • a color name (such as "red") which LiveCode knows,
  • a comma-separated list of RGB values in the range 0...255 (such as "255,255,255") or
  • an HTML color spcification (such as "#FFFFFF")
When the LineColor is left empty, the "arClock" is drawn in white.

The LineColor may be set from within a script using

set the LineColor of group "arClock 1" to "#BB33FF"

(please, replace "arClock 1" with the actual name of your "arClock" instance in this statement). Alternatively, you may also set it manually by means of the DropTools Inspector.

LineThickness

The LineThickness of an "arClock" determines the thickness of all lines an "arClock" consists of. It must be specified as an integral number > 0. If the LineThickness remains empty, it's value is automatically chosen based on the actual size of the "arClock" in a way, that a visually appealing presentation is possible.

The LineThickness may be set from within a script using

set the LineThickness of group "arClock 1" to empty

(please, replace "arClock 1" with the actual name of your "arClock" instance in this statement). Alternatively, you may also set it manually by means of the DropTools Inspector.

System Requirements

The "arClock" needs LiveCode 6.x (or later) and DropTools 1.3 (or higher) and works regardless of the operating system.

Dependencies

The "arClock" does not depend on any other stack.

Known Bugs

There are currently no known bugs in the "arClock".

License Information

The "arClock" is licensed under a "Creative Commons Attribution 4.0 Unported license", which essentially means that you may both use and modify it (even in a commercial context) - provided that your changes have been marked as such and there is a reference to me as the original author at an appropriate place.

                       
Have fun with LiveCode and the "arClock"! Creative Commons License

Bibliography

[1]
(RunRev Ltd.)
LiveCode | Create apps for multiple platforms. Quickly. Easily. Free
LiveCode is a development environment for both stationary (Windows, Linux, MacOS X) and mobile (iOS, Android) applications modeled after the legendary Apple HyperCard. A visual editor allows fast design of user interfaces, a programming language inspired by the english language allows even non-professional programmers to develop professional applications and the concept of "modifying a running program" simplifies testing and troubleshooting.
[2]
Sons of Thunder Software
DropTools
Using "DropTools", custom LiveCode controls can be conveniently managed and integrated into own LiveCode stacks.