https://github.com/rosenpin/custom-analog-clock-view

A customizable analog clock widget for Android
https://github.com/rosenpin/custom-analog-clock-view

analog-clock android-clock android-library android-widget

Last synced: 19 days ago
JSON representation

A customizable analog clock widget for Android

• Host: GitHub
• URL: https://github.com/rosenpin/custom-analog-clock-view
• Owner: rosenpin
• License: gpl-3.0
• Created: 2016-07-20T01:56:30.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-02-26T09:21:05.000Z (10 months ago)
• Last Synced: 2024-11-26T23:32:54.764Z (30 days ago)
• Topics: analog-clock, android-clock, android-library, android-widget
• Language: Java
• Homepage:
• Size: 148 KB
• Stars: 69
• Watchers: 5
• Forks: 23
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Custom Analog Clock View

[![JitPack](https://jitpack.io/v/rosenpin/custom-analog-clock-view.svg)](https://jitpack.io/#rosenpin/custom-analog-clock-view)

[![Download](https://api.bintray.com/packages/rosenpin/maven/custom-analog-clock-view/images/download.svg) ](https://bintray.com/rosenpin/maven/custom-analog-clock-view/_latestVersion)



Based on [xxv](https://github.com/xxv)/[24AnalogWidget](https://github.com/xxv/24hAnalogWidget)

This is a super easy to implement and highly customizable analog clock library

## Dependency

Add this to your app build.gradle file

```` gradle

dependencies {

    compile 'com.tomerrosenfeld.customanalogclockview:custom-analog-clock-view:1.1'

}

````

## How to use

In your layout:

```xml

````

In your activity:

```java

CustomAnalogClock customAnalogClock = (CustomAnalogClock) findViewById(R.id.analog_clock);

customAnalogClock.setAutoUpdate(true);

````

#### And you're basically done!

 Default clock 



# Customization

To adjust the size of the clock

```java 

setScale(float scale)

``` 

So for example

```java 

setScale(0.5f) //to make the clock smaller

setScale(2f) //to make the clock larger

``` 

You can completely change the look of the widget by using the init function:

```java 

init(Context context, @DrawableRes int watchFace, @DrawableRes int hourHand, @DrawableRes int minuteHand, int alpha, boolean is24, boolean hourOnTop)

``` 

So for example:

````java 

customAnalogClock.init(MainActivity.this, R.drawable.default_face, R.drawable.default_hour_hand, R.drawable.default_minute_hand, 0, false, false);

````

In this example, we are creating an analog clock with custom drawables, the background is `R.drawable.default_face`, the hour hand is `R.drawable.default_hour_hand` and the minute hand is `R.drawable.default_minute_hand`.

In addition to that, we chose to keep the clock 12H, like a standard clock, if you want to make it 24H, pass `true` for is24.

The alpha parameter sets the opacity of the hour hand, set it to 0 to make it completely visible (alpha can vary between 1-254).

The hourOnTop parameter determines the hour hand placement. If set to true, the hour hand will appear on top of the minutes hand, otherwise, the minute hand will show up on top.

I suggest that you base your clock drawables on my default ones:

[The Face](/custom-analog-clock-view/src/main/res/drawable-xhdpi/default_face.png)

[The Hour Hand](/custom-analog-clock-view/src/main/res/drawable-xhdpi/default_hour_hand.png)

[The Minute Hand](/custom-analog-clock-view/src/main/res/drawable-xhdpi/default_minute_hand.png)

Using this library I was easily able to create these analog clock widgets:

| Pebble Theme | S7 Theme | Default |

|:-:|:-:|:-:|

| ![Pebble Theme](http://i.imgur.com/w3jfrsT.png) | ![S7 Theme](http://i.imgur.com/1vjYhFd.png) | ![Flat style](http://i.imgur.com/AB2EIAD.png) |

## Licensing

Custom Analog Clock View is licensed under the [GNU v3 Public License.](LICENSE)