Merge branch 'dev'

Author: programminghoch10

.idea/codeStyles/Project.xml

@@ -1,6 +1,117 @@
 # HangoverClock
-This is a clock app/widget using the previously tested new time display from my [Stopwatch](https://github.com/programminghoch10/Stopwatch)
 
-_Currently this app is in alpha stadium, don't expect it to work, maybe look at latest commits to know how good it works yet._
+Welcome to HangoverClock, the only clock which displays the real time in an unrealistic way!
 
-[Download APK](https://github.com/programminghoch10/HangoverClock/raw/master/app/release/app-release.apk)
+If you just want to see what this widget looks like now, 
+please click [here](https://github.com/programminghoch10/HangoverClock#the-next-generation)
+
+[Download the newest APK](https://github.com/programminghoch10/HangoverClock/raw/master/app/release/app-release.apk)
+or look at the
+[latest stable releases](https://github.com/programminghoch10/HangoverClock/releases)
+
+For Wear OS Users, please look [here](https://github.com/programminghoch10/HangoverClock/tree/wear)
+
+![HangoverClock Icon new](icon/clock.png)
+![HangoverClock Icon old](app/src/main/res/drawable-v24/clock.png)
+
+## What makes HangoverClock special?
+
+It all started with this meme:
+
+![Astrolodgermeme](pictures/astrolodgermeme.jpg)
+
+"You will meet your girlfriend today at 11" and the clock shows 10:65.
+
+I thought this needs to get real.
+Its obvious that 10:65 would actually be 11:05.
+
+My first test of this was my [Stopwatch](https://github.com/programminghoch10/Stopwatch).
+
+To describe how many minutes the clock should go over the full hour, I used the word "Overhang". 
+An Overhang of 0 would result in the clock being totally normal. 
+Any Overhang above 0 would result in the clock counting over 60 until the Overhang is reached, at which point it shows the real time again. 
+E.g. With an overhang of 10 the clock would go up to 10:69 and the next minute to 11:10.
+Of course you could also go insane with this setting, which results in ridiculous clocks like 03:384829323 
+(Yes my friend [@IlijazM](https://github.com/IlijazM) actually did that). 
+
+And because of that variable, which makes the clock unique, its named HangoverClock.
+
+## Good old times
+
+![HangoverClock Toxic Picture 1](pictures/toxic1.png)
+![HangoverClock Toxic Picture 2](pictures/toxic2.png)
+
+This was HangoverClock "Toxic". A simple widget which displayed the time.
+You were able to modify the Overhang, by clicking in the middle once. 
+Then the current overhang was displayed and you could increase or decrease it by clicking the + or - button.
+Also the text was always the same size, no matter how big the widget was resized too.
+
+So my friends inspired me saying the idea is amazing, but the clocks design sucks. So I needed to do something about it.
+
+## The next generation
+
+![HangoverClock Dynamite Picture 1](pictures/dynamite1.jpg)
+![HangoverClock Dynamite Picture 2](pictures/dynamite2.png)
+(background not included)
+
+Here is HangoverClock "Dynamite".
+
+Dynamite brings a lot of new features: 
+First of there are fonts. Around 20 fonts (more incoming) are just waiting for amazing clock widgets to be created.
+With the freely choosable color (16.777.216 combinations) you can select the most fitting for your background.
+And you can enable a date to be shown below the clock, which **also has the ability to overhang**!
+Also you can now choose whether to use 12 or 24h time format, or use the system setting.
+
+When creating the widget on your home launcher the app greets you with a settings menu, 
+which lets you easily set up the widget as you like it.
+
+Also you are now able to not choose one Overhang, but all 4 seperatly. Those are:
+* Minutes
+* Hours
+* Days
+* Months
+* _Seconds coming soon (maybe)_
+
+Same thing as always, 
+hours defines how much to go over 12/24h mark, 
+days defines how much to go over a month
+and months defines how much to go over a year.
+
+[@IlijazM](https://github.com/IlijazM) im expecting you to live in 2017 :)
+
+ 
+
+***Special info for 12h users:***
+
+Overhang calculation turns out to be really difficult and confusing in the 12h format.
+That's why whole calculation happens in 24h format and then gets later subtracted down,
+if the hour field is between or equal of 12+houroverhang and 24.
+Try setting houroverhang to 0 or 1 and watch what suits you better.
+*This behaviour is only relevant when using the date,* 
+so please remember that using the 12h setting may not reflect the real time!
+But maybe nobody will notice...
+
+## The Future
+
+I'm always trying to leave as much options open as possible, but at some point there are too much settings for the user to choose.
+Apple already learned that ;) So its probably not getting more customizable in regards to the current features,
+but I'm always thinking of new features.
+I'm always on the quest to make this the best HangoverClock ever.
+
+## Code Stuff
+
+* All calculations happen inside the Class WidgetGenerator. 
+* The only public method is generateWidget, which returns a Bitmap Image.
+* The fonts get dynamically collected from all available resource files 
+    and saved in a static String array within the ClockWidgetProvider class.
+* The sharedPreference keys are defined in preferencekeys.xml and their defaults in preferencekeydefaults.xml.
+  * sharedPreferences are saved in the format key and directly appended widget ID.
+  * If a key is not defined its default value is assumed and only gets saved when not default or when alwayssavepreferences bool is active.
+* if one of the widgets has seconds enabled, the setalarmmanager method will request intent for one second instead of one second.
+  * That behaviour is dependent on sharedPreferences key "increaserefreshrate".
+  * That key will be determined on every clock update by looping though all widgets and looking if any has seconds enabled.
+
+## Thanksgiving
+
+Thanks to all my friends, who motivated me to do this.
+Also thanks to my laptop, which crashed 2 times with literally nothing saved to disk.

.idea/codeStyles/codeStyleConfig.xml

@@ -6,8 +6,8 @@ android {
         applicationId "com.JJ.hangoverclock"
         minSdkVersion 16
         targetSdkVersion 28
-        versionCode 6
-        versionName "toxic"
+        versionCode 9
+        versionName "dynamite"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
     buildTypes {

.idea/misc.xml

@@ -1 +1 @@
-[{"outputType":{"type":"APK"},"apkData":{"type":"MAIN","splits":[],"versionCode":6,"versionName":"v1.0","enabled":true,"outputFile":"app-release.apk","fullName":"release","baseName":"release"},"path":"app-release.apk","properties":{}}]
+[{"outputType":{"type":"APK"},"apkData":{"type":"MAIN","splits":[],"versionCode":9,"versionName":"dynamite","enabled":true,"outputFile":"app-release.apk","fullName":"release","baseName":"release"},"path":"app-release.apk","properties":{}}]

README.md

@@ -1,28 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools"
-    android:installLocation="internalOnly"
-    package="com.JJ.hangoverclock">
+    package="com.JJ.hangoverclock"
+    android:installLocation="internalOnly">
 
     <application
         android:allowBackup="false"
         android:icon="@mipmap/clock_c"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/clock_c"
-        android:supportsRtl="false"
+        android:supportsRtl="true"
         android:theme="@style/AppTheme"
         tools:ignore="GoogleAppIndexingWarning">
-        <receiver android:name="ClockWidgetProvider" >
+        <activity android:name=".ConfigureWidget">
             <intent-filter>
-                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
-                <action android:name="com.JJ.hangoverclock.widgetupdate" />
+                <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" />
+            </intent-filter>
+        </activity>
+
+        <meta-data
+            android:name="preloaded_fonts"
+            android:resource="@array/preloaded_fonts" />
+        <receiver android:name=".BootReceiver">
+            <intent-filter>
+                <action android:name="android.intent.action.BOOT_COMPLETED" />
             </intent-filter>
-            <meta-data android:name="android.appwidget.provider"
-                android:resource="@xml/appwidgetproviderinfo" />
         </receiver>
-        <receiver android:name="BootReceiver">
+
+        <receiver android:name=".ClockWidgetProvider">
             <intent-filter>
-                <action android:name="android.intent.action.BOOT_COMPLETED"/>
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+                <action android:name="com.JJ.hangoverclock.widgetupdate" />
             </intent-filter>
+
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/appwidgetproviderinfo" />
         </receiver>
     </application>
-</manifest>
+
+</manifest>

app/build.gradle

@@ -5,7 +5,7 @@
 import android.content.Intent;
 
 public class BootReceiver extends BroadcastReceiver {
-
+    
     @Override
     public void onReceive(Context context, Intent intent) {
         ClockWidgetProvider clockWidgetProvider = new ClockWidgetProvider();