Skip to content

Commit f3c506d

Browse files
committed
add fan controller
1 parent 15021eb commit f3c506d

38 files changed

+931
-0
lines changed

21-fan-controller/.gitignore

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
*.iml
2+
.gradle
3+
/local.properties
4+
/.idea/caches
5+
/.idea/libraries
6+
/.idea/modules.xml
7+
/.idea/workspace.xml
8+
/.idea/navEditor.xml
9+
/.idea/assetWizardSettings.xml
10+
.DS_Store
11+
/build
12+
/captures
13+
.externalNativeBuild
14+
.cxx
15+
local.properties

21-fan-controller/README.md

+19
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Fan Controller
2+
3+
A fan control UI to learn how to create a custom view.
4+
5+
<p align="center">
6+
<img src="screenshot.png" style="width:528px;max-width: 100%;">
7+
</p>
8+
9+
## Features
10+
11+
- extending View to create a custom view.
12+
- initializing the custom view with drawing and painting values.
13+
- overriding OnDraw() to draw the view.
14+
- adding the custom view to a layout.
15+
- adding view interactivity with performClick().
16+
- using custom attributes for colors.
17+
- adding accessibility with TalkBack.
18+
19+
Based on [Creating Custom Views](https://developer.android.com/codelabs/advanced-android-kotlin-training-custom-views) by Google Codelabs (2022).

21-fan-controller/app/.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
/build

21-fan-controller/app/build.gradle

+43
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
plugins {
2+
id 'com.android.application'
3+
id 'org.jetbrains.kotlin.android'
4+
}
5+
6+
android {
7+
compileSdk 32
8+
9+
defaultConfig {
10+
applicationId "com.hfad.fancontroller"
11+
minSdk 21
12+
targetSdk 32
13+
versionCode 1
14+
versionName "1.0"
15+
16+
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
17+
}
18+
19+
buildTypes {
20+
release {
21+
minifyEnabled false
22+
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
23+
}
24+
}
25+
compileOptions {
26+
sourceCompatibility JavaVersion.VERSION_1_8
27+
targetCompatibility JavaVersion.VERSION_1_8
28+
}
29+
kotlinOptions {
30+
jvmTarget = '1.8'
31+
}
32+
}
33+
34+
dependencies {
35+
36+
implementation 'androidx.core:core-ktx:1.7.0'
37+
implementation 'androidx.appcompat:appcompat:1.4.1'
38+
implementation 'com.google.android.material:material:1.5.0'
39+
implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
40+
testImplementation 'junit:junit:4.13.2'
41+
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
42+
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
43+
}
+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Add project specific ProGuard rules here.
2+
# You can control the set of applied configuration files using the
3+
# proguardFiles setting in build.gradle.
4+
#
5+
# For more details, see
6+
# http://developer.android.com/guide/developing/tools/proguard.html
7+
8+
# If your project uses WebView with JS, uncomment the following
9+
# and specify the fully qualified class name to the JavaScript interface
10+
# class:
11+
#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12+
# public *;
13+
#}
14+
15+
# Uncomment this to preserve the line number information for
16+
# debugging stack traces.
17+
#-keepattributes SourceFile,LineNumberTable
18+
19+
# If you keep the line number information, uncomment this to
20+
# hide the original source file name.
21+
#-renamesourcefileattribute SourceFile
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
package com.hfad.fancontroller
2+
3+
import androidx.test.platform.app.InstrumentationRegistry
4+
import androidx.test.ext.junit.runners.AndroidJUnit4
5+
6+
import org.junit.Test
7+
import org.junit.runner.RunWith
8+
9+
import org.junit.Assert.*
10+
11+
/**
12+
* Instrumented test, which will execute on an Android device.
13+
*
14+
* See [testing documentation](http://d.android.com/tools/testing).
15+
*/
16+
@RunWith(AndroidJUnit4::class)
17+
class ExampleInstrumentedTest {
18+
@Test
19+
fun useAppContext() {
20+
// Context of the app under test.
21+
val appContext = InstrumentationRegistry.getInstrumentation().targetContext
22+
assertEquals("com.hfad.fancontroller", appContext.packageName)
23+
}
24+
}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
3+
package="com.hfad.fancontroller">
4+
5+
<application
6+
android:allowBackup="true"
7+
android:icon="@mipmap/ic_launcher"
8+
android:label="@string/app_name"
9+
android:roundIcon="@mipmap/ic_launcher_round"
10+
android:supportsRtl="true"
11+
android:theme="@style/Theme.FanController">
12+
<activity
13+
android:name=".MainActivity"
14+
android:exported="true">
15+
<intent-filter>
16+
<action android:name="android.intent.action.MAIN" />
17+
18+
<category android:name="android.intent.category.LAUNCHER" />
19+
</intent-filter>
20+
</activity>
21+
</application>
22+
23+
</manifest>
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
package com.hfad.fancontroller
2+
3+
import android.content.Context
4+
import android.graphics.*
5+
import android.util.AttributeSet
6+
import android.view.View
7+
import android.view.accessibility.AccessibilityNodeInfo
8+
import androidx.core.content.withStyledAttributes
9+
import androidx.core.view.AccessibilityDelegateCompat
10+
import androidx.core.view.ViewCompat
11+
import androidx.core.view.accessibility.AccessibilityNodeInfoCompat
12+
import kotlin.math.cos
13+
import kotlin.math.min
14+
import kotlin.math.sin
15+
16+
private enum class FanSpeed(val label: Int) {
17+
OFF(R.string.fan_off),
18+
LOW(R.string.fan_low),
19+
MEDIUM(R.string.fan_medium),
20+
HIGH(R.string.fan_high);
21+
22+
fun next() = when (this) {
23+
OFF -> LOW
24+
LOW -> MEDIUM
25+
MEDIUM -> HIGH
26+
HIGH -> OFF
27+
}
28+
}
29+
private const val RADIUS_OFFSET_LABEL = 30
30+
private const val RADIUS_OFFSET_INDICATOR = -35
31+
32+
class DialView @JvmOverloads constructor(
33+
context: Context, attrs: AttributeSet? = null, defStyleAttr: Int = 0
34+
) : View(context, attrs, defStyleAttr) {
35+
private var radius = 0.0f
36+
private var fanSpeed = FanSpeed.OFF
37+
private val pointPosition: PointF = PointF(0.0f, 0.0f)
38+
private val paint = Paint(Paint.ANTI_ALIAS_FLAG).apply {
39+
style = Paint.Style.FILL
40+
textAlign = Paint.Align.CENTER
41+
textSize = 55.0f
42+
typeface = Typeface.create("", Typeface.BOLD)
43+
}
44+
// custom attributes
45+
private var fanSpeedLowColor = 0
46+
private var fanSpeedMediumColor = 0
47+
private var fanSpeedMaxColor = 0
48+
49+
init {
50+
isClickable = true
51+
context.withStyledAttributes(attrs, R.styleable.DialView) {
52+
fanSpeedLowColor = getColor(R.styleable.DialView_fanColor1, 0)
53+
fanSpeedMediumColor = getColor(R.styleable.DialView_fanColor2, 0)
54+
fanSpeedMaxColor = getColor(R.styleable.DialView_fanColor3, 0)
55+
}
56+
updateContentDescription()
57+
58+
ViewCompat.setAccessibilityDelegate(this, object : AccessibilityDelegateCompat() {
59+
override fun onInitializeAccessibilityNodeInfo(host: View,
60+
info: AccessibilityNodeInfoCompat) {
61+
super.onInitializeAccessibilityNodeInfo(host, info)
62+
val customClick = AccessibilityNodeInfoCompat.AccessibilityActionCompat(
63+
AccessibilityNodeInfo.ACTION_CLICK,
64+
context.getString(if (fanSpeed != FanSpeed.HIGH)
65+
R.string.change else R.string.reset)
66+
)
67+
info.addAction(customClick)
68+
}
69+
})
70+
}
71+
72+
override fun performClick(): Boolean {
73+
if (super.performClick()) return true // calls onClickListener()
74+
fanSpeed = fanSpeed.next()
75+
contentDescription = resources.getString(fanSpeed.label)
76+
updateContentDescription()
77+
invalidate() // redraw
78+
return true
79+
}
80+
81+
override fun onSizeChanged(w: Int, h: Int, oldw: Int, oldh: Int) {
82+
radius = (min(w, h) / 2.0 * 0.8).toFloat()
83+
super.onSizeChanged(w, h, oldw, oldh)
84+
}
85+
86+
override fun onDraw(canvas: Canvas) {
87+
super.onDraw(canvas)
88+
// paint.color = if (fanSpeed == FanSpeed.OFF) Color.GRAY else Color.GREEN
89+
paint.color = when (fanSpeed) {
90+
FanSpeed.OFF -> Color.GRAY
91+
FanSpeed.LOW -> fanSpeedLowColor
92+
FanSpeed.MEDIUM -> fanSpeedMediumColor
93+
FanSpeed.HIGH -> fanSpeedMaxColor
94+
}
95+
// Draw the dial
96+
canvas.drawCircle((width / 2).toFloat(), (height / 2).toFloat(), radius, paint)
97+
// Draw the indicator circle
98+
val markerRadius = radius + RADIUS_OFFSET_INDICATOR
99+
pointPosition.computeXYForSpeed(fanSpeed, markerRadius)
100+
paint.color = Color.BLACK
101+
canvas.drawCircle(pointPosition.x, pointPosition.y, radius/12, paint)
102+
// Draw the text labels
103+
val labelRadius = radius + RADIUS_OFFSET_LABEL
104+
for (i in FanSpeed.values()) {
105+
pointPosition.computeXYForSpeed(i, labelRadius)
106+
val label = resources.getString(i.label)
107+
canvas.drawText(label, pointPosition.x, pointPosition.y, paint)
108+
}
109+
}
110+
111+
private fun PointF.computeXYForSpeed(pos: FanSpeed, radius: Float) {
112+
val startAngle = Math.PI * (9 / 8.0)
113+
val angle = startAngle + pos.ordinal * (Math.PI / 4)
114+
x = (radius * cos(angle)).toFloat() + width / 2
115+
y = (radius * sin(angle)).toFloat() + height / 2
116+
}
117+
118+
fun updateContentDescription() {
119+
contentDescription = resources.getString(fanSpeed.label)
120+
}
121+
}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
package com.hfad.fancontroller
2+
3+
import androidx.appcompat.app.AppCompatActivity
4+
import android.os.Bundle
5+
6+
class MainActivity : AppCompatActivity() {
7+
override fun onCreate(savedInstanceState: Bundle?) {
8+
super.onCreate(savedInstanceState)
9+
setContentView(R.layout.activity_main)
10+
}
11+
}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
<vector xmlns:android="http://schemas.android.com/apk/res/android"
2+
xmlns:aapt="http://schemas.android.com/aapt"
3+
android:width="108dp"
4+
android:height="108dp"
5+
android:viewportWidth="108"
6+
android:viewportHeight="108">
7+
<path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
8+
<aapt:attr name="android:fillColor">
9+
<gradient
10+
android:endX="85.84757"
11+
android:endY="92.4963"
12+
android:startX="42.9492"
13+
android:startY="49.59793"
14+
android:type="linear">
15+
<item
16+
android:color="#44000000"
17+
android:offset="0.0" />
18+
<item
19+
android:color="#00000000"
20+
android:offset="1.0" />
21+
</gradient>
22+
</aapt:attr>
23+
</path>
24+
<path
25+
android:fillColor="#FFFFFF"
26+
android:fillType="nonZero"
27+
android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
28+
android:strokeWidth="1"
29+
android:strokeColor="#00000000" />
30+
</vector>

0 commit comments

Comments
 (0)