├── app ├── .gitignore ├── src │ └── main │ │ ├── res │ │ ├── values │ │ │ ├── strings.xml │ │ │ ├── styles.xml │ │ │ ├── colors.xml │ │ │ └── themes.xml │ │ ├── mipmap-hdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-mdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-xhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-xxhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-xxxhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── drawable │ │ │ ├── bg_goal_missed.xml │ │ │ ├── bg_goal_outline.xml │ │ │ ├── bg_goal_state_indicator.xml │ │ │ ├── ic_baseline_card_giftcard_24.xml │ │ │ └── ic_launcher_background.xml │ │ └── layout │ │ │ └── activity_main.xml │ │ ├── AndroidManifest.xml │ │ └── java │ │ └── com │ │ └── mackhartley │ │ └── dashedviewexample │ │ └── MainActivity.kt ├── proguard-rules.pro └── build.gradle ├── dashedview ├── .gitignore ├── consumer-rules.pro ├── src │ ├── main │ │ ├── AndroidManifest.xml │ │ ├── java │ │ │ └── com │ │ │ │ └── mackhartley │ │ │ │ └── dashedview │ │ │ │ ├── DashInfo.kt │ │ │ │ ├── DashColorGenerator.kt │ │ │ │ ├── DashDirection.kt │ │ │ │ ├── MathUtils.kt │ │ │ │ └── DashedView.kt │ │ └── res │ │ │ └── values │ │ │ └── attrs.xml │ └── test │ │ └── java │ │ └── com │ │ └── mackhartley │ │ └── dashedview │ │ └── DashedViewTests.kt ├── proguard-rules.pro └── build.gradle ├── .idea ├── .gitignore ├── compiler.xml ├── codeStyles │ ├── codeStyleConfig.xml │ └── Project.xml ├── misc.xml ├── gradle.xml └── jarRepositories.xml ├── settings.gradle ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── .github ├── ISSUE_TEMPLATE │ ├── feature_request.md │ └── bug_report.md └── workflows │ ├── ktlint.yml │ ├── stale.yml │ └── buildAndTest.yml ├── .gitignore ├── CONTRIBUTING.md ├── ktlint.gradle ├── gradle.properties ├── gradlew.bat ├── CODE_OF_CONDUCT.md ├── gradlew ├── README.md └── LICENSE /app/.gitignore: -------------------------------------------------------------------------------- 1 | /build -------------------------------------------------------------------------------- /dashedview/.gitignore: -------------------------------------------------------------------------------- 1 | /build -------------------------------------------------------------------------------- /dashedview/consumer-rules.pro: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.idea/.gitignore: -------------------------------------------------------------------------------- 1 | # Default ignored files 2 | /shelf/ 3 | /workspace.xml 4 | -------------------------------------------------------------------------------- /settings.gradle: -------------------------------------------------------------------------------- 1 | include ':dashedview' 2 | include ':app' 3 | rootProject.name = "DashedViewExample" -------------------------------------------------------------------------------- /app/src/main/res/values/strings.xml: -------------------------------------------------------------------------------- 1 | 2 | DashedViewExample 3 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /app/src/main/res/mipmap-hdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-mdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-hdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-mdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xhdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxhdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MackHartley/DashedView/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /.idea/compiler.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /dashedview/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | -------------------------------------------------------------------------------- /app/src/main/res/drawable/bg_goal_missed.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /.idea/codeStyles/codeStyleConfig.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 6 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/feature_request.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Feature request 3 | about: Suggest an improvement for DashedVi 4 | title: '' 5 | labels: enhancement 6 | assignees: '' 7 | 8 | --- 9 | 10 | **Describe the new feature or improvement you would like to see.** 11 | -------------------------------------------------------------------------------- /app/src/main/res/drawable/bg_goal_outline.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /app/src/main/res/drawable/bg_goal_state_indicator.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Fri May 14 22:43:13 CDT 2021 2 | distributionBase=GRADLE_USER_HOME 3 | distributionPath=wrapper/dists 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-bin.zip 7 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 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 | .idea/vcs.xml 16 | app/release/* -------------------------------------------------------------------------------- /.github/workflows/ktlint.yml: -------------------------------------------------------------------------------- 1 | name: ktlint 2 | 3 | on: 4 | pull_request: 5 | paths: 6 | - "**/*.kt" 7 | - ".github/workflows/ktlint.yml" 8 | 9 | jobs: 10 | ktlint: 11 | runs-on: ubuntu-latest 12 | 13 | steps: 14 | - name: "checkout" 15 | uses: actions/checkout@v2 16 | 17 | - name: "ktlint" 18 | uses: "vroy/gha-kotlin-linter@v1" 19 | -------------------------------------------------------------------------------- /.idea/misc.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 9 | -------------------------------------------------------------------------------- /dashedview/src/main/java/com/mackhartley/dashedview/DashInfo.kt: -------------------------------------------------------------------------------- 1 | package com.mackhartley.dashedview 2 | 3 | /** 4 | * Contains all information required to draw a single dash (aka line). 5 | * 6 | * [Pair.first] contains the x value 7 | * [Pair.second] contains the y value 8 | */ 9 | data class DashInfo( 10 | val startPoint: Pair, 11 | val endPoint: Pair 12 | ) 13 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing 2 | 3 | If you find a bug or have a feature request you are free to open a Github Issue at any time. These will be addressed promptly after being created. 4 | 5 | If you are interested in contributing to the repo that's great! Before doing so, contact me via direct message or a Github Issue to let me know what you would like to add. That way we can avoid overwritting each other's work in the event I am also working on the library. 6 | -------------------------------------------------------------------------------- /dashedview/src/main/res/values/attrs.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | -------------------------------------------------------------------------------- /.github/workflows/stale.yml: -------------------------------------------------------------------------------- 1 | 2 | name: Mark stale issues and pull requests 3 | 4 | on: 5 | schedule: 6 | - cron: "30 1 * * *" 7 | 8 | jobs: 9 | stale: 10 | 11 | runs-on: ubuntu-latest 12 | 13 | steps: 14 | - uses: actions/stale@v3 15 | with: 16 | repo-token: ${{ secrets.GITHUB_TOKEN }} 17 | stale-issue-message: 'This issue has been inactive and is now considered stale.' 18 | stale-pr-message: 'This PR has been inactive and is now considered stale.' 19 | stale-issue-label: 'no-issue-activity' 20 | stale-pr-label: 'no-pr-activity' 21 | -------------------------------------------------------------------------------- /app/src/main/res/values/styles.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 14 | -------------------------------------------------------------------------------- /ktlint.gradle: -------------------------------------------------------------------------------- 1 | repositories { 2 | jcenter() 3 | } 4 | 5 | configurations { 6 | ktlint 7 | } 8 | 9 | dependencies { 10 | ktlint "com.github.shyiko:ktlint:0.29.0" 11 | } 12 | 13 | task ktlint(type: JavaExec, group: "verification") { 14 | description = "Check Kotlin code style." 15 | classpath = configurations.ktlint 16 | main = "com.github.shyiko.ktlint.Main" 17 | args "src/**/*.kt" 18 | } 19 | 20 | task ktlintFormat(type: JavaExec, group: "formatting") { 21 | description = "Fix Kotlin code style deviations." 22 | classpath = configurations.ktlint 23 | main = "com.github.shyiko.ktlint.Main" 24 | args "-F", "src/**/*.kt" 25 | } -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/bug_report.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Bug report 3 | about: Create a report to help improve DashedView 4 | title: '' 5 | labels: bug 6 | assignees: '' 7 | 8 | --- 9 | 10 | **Describe the bug** 11 | A clear and concise description of what the bug is. 12 | 13 | **To Reproduce** 14 | Steps to reproduce the behavior: 15 | 1. Go to '...' 16 | 2. Click on '....' 17 | 3. Scroll down to '....' 18 | 4. See error 19 | 20 | **Expected behavior** 21 | A clear and concise description of what you expected to happen. 22 | 23 | **Screenshots** 24 | If applicable, add screenshots to help explain your problem. 25 | 26 | **Additional context** 27 | Add any other context about the problem here. 28 | -------------------------------------------------------------------------------- /app/proguard-rules.pro: -------------------------------------------------------------------------------- 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 -------------------------------------------------------------------------------- /app/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /dashedview/proguard-rules.pro: -------------------------------------------------------------------------------- 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 -------------------------------------------------------------------------------- /app/src/main/res/values/colors.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | #FFBB86FC 4 | #FF6200EE 5 | #FF3700B3 6 | #FF03DAC5 7 | #FF018786 8 | #FF000000 9 | #FFFFFFFF 10 | 11 | #00f 12 | #f00 13 | #777 14 | #5aa 15 | 16 | #ff595e 17 | #ffca3a 18 | #8ac926 19 | #1982c4 20 | #6a4c93 21 | -------------------------------------------------------------------------------- /app/src/main/res/values/themes.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 16 | -------------------------------------------------------------------------------- /app/src/main/res/drawable/ic_baseline_card_giftcard_24.xml: -------------------------------------------------------------------------------- 1 | 7 | 10 | 11 | -------------------------------------------------------------------------------- /.idea/gradle.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 23 | 24 | -------------------------------------------------------------------------------- /.idea/jarRepositories.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 9 | 10 | 14 | 15 | 19 | 20 | 24 | 25 | -------------------------------------------------------------------------------- /dashedview/src/main/java/com/mackhartley/dashedview/DashColorGenerator.kt: -------------------------------------------------------------------------------- 1 | package com.mackhartley.dashedview 2 | 3 | import androidx.annotation.ColorInt 4 | 5 | interface DashColorGenerator { 6 | /** 7 | * This method allows you to set the paint color for a dash based on its index. 8 | * This could be used to set alternating colors (eg: blue, red, blue...) by using a modulus 9 | * operator. It could also be used to set dash colors in a gradient fashion (eg: lighter dashes 10 | * followed by darker dashes). 11 | * 12 | * @param curIndex - Current index of the dash that is being drawn 13 | * @param numDashes - The number of dashes that will be drawn. Note, sometimes the first or last 14 | * dash will be drawn out of the view depending on the [DashedView] configuration. 15 | * 16 | * @return The color value to display for this index. Make sure to return a [ColorInt] instead 17 | * of a normal [Int]. 18 | * For example, instead of returning R.color.my_color, return ContextCompat.getColor(context, R.color.my_color) 19 | */ 20 | @ColorInt 21 | fun getPaintColor(curIndex: Int, numDashes: Int): Int 22 | } -------------------------------------------------------------------------------- /dashedview/src/main/java/com/mackhartley/dashedview/DashDirection.kt: -------------------------------------------------------------------------------- 1 | package com.mackhartley.dashedview 2 | 3 | /** 4 | * Indicates the direction that dashes are pointing. 5 | * 6 | * [LeftToRight] means the angle of all dashes drawn is between 0 and 89 degrees inclusive. 7 | * [Vertical] means the angle of all dashes drawn is equal to 90 degrees. 8 | * [RightToLeft] means the angle of all dashes drawn is between 91 and 179 degrees inclusive. 9 | * 10 | * [isHorizontal] indicates that a given configuration has an angle of 0 degrees. This is important 11 | * to know for certain trigonometric calculations. 12 | */ 13 | sealed class DashDirection( 14 | val isHorizontal: Boolean 15 | ) { 16 | class LeftToRight(isHorizontal: Boolean) : DashDirection(isHorizontal) 17 | class RightToLeft(isHorizontal: Boolean) : DashDirection(isHorizontal) 18 | object Vertical : DashDirection(false) 19 | } 20 | 21 | fun getDashDirection(dashAngle: Int): DashDirection { 22 | return when { 23 | dashAngle == 0 -> DashDirection.LeftToRight(true) 24 | dashAngle < 90 -> DashDirection.LeftToRight(false) 25 | dashAngle == 90 -> DashDirection.Vertical 26 | else -> DashDirection.RightToLeft(false) 27 | } 28 | } -------------------------------------------------------------------------------- /gradle.properties: -------------------------------------------------------------------------------- 1 | # Project-wide Gradle settings. 2 | # IDE (e.g. Android Studio) users: 3 | # Gradle settings configured through the IDE *will override* 4 | # any settings specified in this file. 5 | # For more details on how to configure your build environment visit 6 | # http://www.gradle.org/docs/current/userguide/build_environment.html 7 | # Specifies the JVM arguments used for the daemon process. 8 | # The setting is particularly useful for tweaking memory settings. 9 | org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8 10 | # When configured, Gradle will run in incubating parallel mode. 11 | # This option should only be used with decoupled projects. More details, visit 12 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects 13 | # org.gradle.parallel=true 14 | # AndroidX package structure to make it clearer which packages are bundled with the 15 | # Android operating system, and which are packaged with your app"s APK 16 | # https://developer.android.com/topic/libraries/support-library/androidx-rn 17 | android.useAndroidX=true 18 | # Automatically convert third-party libraries to use AndroidX 19 | android.enableJetifier=true 20 | # Kotlin code style for this project: "official" or "obsolete": 21 | kotlin.code.style=official -------------------------------------------------------------------------------- /dashedview/build.gradle: -------------------------------------------------------------------------------- 1 | plugins { 2 | id 'com.android.library' 3 | id 'kotlin-android' 4 | } 5 | 6 | android { 7 | compileSdkVersion 29 8 | buildToolsVersion "29.0.3" 9 | 10 | defaultConfig { 11 | minSdkVersion 21 12 | targetSdkVersion 29 13 | versionCode 1 14 | versionName "1.0" 15 | 16 | testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" 17 | consumerProguardFiles "consumer-rules.pro" 18 | } 19 | 20 | buildTypes { 21 | release { 22 | minifyEnabled false 23 | proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' 24 | } 25 | } 26 | compileOptions { 27 | sourceCompatibility JavaVersion.VERSION_1_8 28 | targetCompatibility JavaVersion.VERSION_1_8 29 | } 30 | kotlinOptions { 31 | jvmTarget = '1.8' 32 | } 33 | } 34 | 35 | dependencies { 36 | 37 | implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version" 38 | implementation 'androidx.core:core-ktx:1.3.2' 39 | implementation 'androidx.appcompat:appcompat:1.2.0' 40 | implementation 'com.google.android.material:material:1.3.0' 41 | testImplementation 'junit:junit:4.+' 42 | androidTestImplementation 'androidx.test.ext:junit:1.1.2' 43 | androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0' 44 | } -------------------------------------------------------------------------------- /app/build.gradle: -------------------------------------------------------------------------------- 1 | plugins { 2 | id 'com.android.application' 3 | id 'kotlin-android' 4 | } 5 | 6 | android { 7 | compileSdkVersion 29 8 | buildToolsVersion "29.0.3" 9 | 10 | defaultConfig { 11 | applicationId "com.mackhartley.dashedviewexample" 12 | minSdkVersion 21 13 | targetSdkVersion 29 14 | versionCode 1 15 | versionName "1.0" 16 | 17 | testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" 18 | } 19 | 20 | buildTypes { 21 | release { 22 | minifyEnabled false 23 | proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' 24 | } 25 | } 26 | compileOptions { 27 | sourceCompatibility JavaVersion.VERSION_1_8 28 | targetCompatibility JavaVersion.VERSION_1_8 29 | } 30 | kotlinOptions { 31 | jvmTarget = '1.8' 32 | } 33 | } 34 | 35 | dependencies { 36 | 37 | implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version" 38 | implementation 'androidx.core:core-ktx:1.3.2' 39 | implementation 'androidx.appcompat:appcompat:1.2.0' 40 | implementation 'com.google.android.material:material:1.3.0' 41 | implementation 'androidx.constraintlayout:constraintlayout:2.0.4' 42 | testImplementation 'junit:junit:4.+' 43 | androidTestImplementation 'androidx.test.ext:junit:1.1.2' 44 | androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0' 45 | 46 | implementation project(":dashedview") 47 | } -------------------------------------------------------------------------------- /.github/workflows/buildAndTest.yml: -------------------------------------------------------------------------------- 1 | name: Tests 2 | on: 3 | push: 4 | branches: 5 | - master 6 | pull_request: 7 | branches: 8 | - master 9 | 10 | jobs: 11 | run_tests: 12 | runs-on: macos-latest 13 | 14 | # Workflow steps 15 | steps: 16 | 17 | # Cancel any previously started (but currently unfinished) workflows 18 | - name: Cancel Previous Runs 19 | uses: styfle/cancel-workflow-action@0.8.0 20 | with: 21 | access_token: ${{ github.token }} 22 | 23 | # Check out repo (under $GITHUB_WORKSPACE) so the job can access it 24 | - uses: actions/checkout@v2 25 | 26 | # Set up JDK 27 | - name: Set up JDK 1.8 28 | uses: actions/setup-java@v1 29 | with: 30 | java-version: 1.8 31 | 32 | # Cache 33 | - name: Cache Gradle packages 34 | uses: actions/cache@v2 35 | with: 36 | path: | 37 | ~/.gradle/caches 38 | ~/.gradle/wrapper 39 | key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} 40 | restore-keys: | 41 | ${{ runner.os }}-gradle- 42 | 43 | # Verify project can build and basic junit unit tests pass 44 | - name: Build With Gradle and Run Unit Tests 45 | run: ./gradlew build 46 | 47 | # Clean up cache 48 | - name: Cleanup Gradle Cache 49 | # Remove some files from the Gradle cache, so they aren't cached by GitHub Actions. 50 | # Restoring these files from a GitHub Actions cache might cause problems for future builds. 51 | run: | 52 | rm -f ~/.gradle/caches/modules-2/modules-2.lock 53 | rm -f ~/.gradle/caches/modules-2/gc.properties 54 | -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | set DIRNAME=%~dp0 12 | if "%DIRNAME%" == "" set DIRNAME=. 13 | set APP_BASE_NAME=%~n0 14 | set APP_HOME=%DIRNAME% 15 | 16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 17 | set DEFAULT_JVM_OPTS= 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windows variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | 53 | :win9xME_args 54 | @rem Slurp the command line arguments. 55 | set CMD_LINE_ARGS= 56 | set _SKIP=2 57 | 58 | :win9xME_args_slurp 59 | if "x%~1" == "x" goto execute 60 | 61 | set CMD_LINE_ARGS=%* 62 | 63 | :execute 64 | @rem Setup the command line 65 | 66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 67 | 68 | @rem Execute Gradle 69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 70 | 71 | :end 72 | @rem End local scope for the variables with windows NT shell 73 | if "%ERRORLEVEL%"=="0" goto mainEnd 74 | 75 | :fail 76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 77 | rem the _cmd.exe /c_ return code! 78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 79 | exit /b 1 80 | 81 | :mainEnd 82 | if "%OS%"=="Windows_NT" endlocal 83 | 84 | :omega 85 | -------------------------------------------------------------------------------- /dashedview/src/main/java/com/mackhartley/dashedview/MathUtils.kt: -------------------------------------------------------------------------------- 1 | package com.mackhartley.dashedview 2 | 3 | import kotlin.math.abs 4 | import kotlin.math.cos 5 | import kotlin.math.sin 6 | import kotlin.math.tan 7 | 8 | /** 9 | * Calculates the X axis translation required to get the end point for any start point. 10 | */ 11 | internal fun calculateEndPointXTranslation( 12 | dashAngle: Int, 13 | viewHeight: Float 14 | ): Float { 15 | // Check for 0 degrees. If present, just return viewHeight to avoid a divide by 0 error 16 | if (getDashDirection(dashAngle).isHorizontal) return viewHeight 17 | val dashAngleRadians = Math.toRadians(dashAngle.toDouble()) 18 | val endPointXTranslation = viewHeight / tan(dashAngleRadians) 19 | return endPointXTranslation.toFloat() 20 | } 21 | 22 | /** 23 | * Modifies a provided [xTranslation] value so it can be properly applied to a start point or 24 | * end point based on the current dash angle. 25 | */ 26 | internal fun calculateModifiedXTranslation( 27 | xTranslation: Double, 28 | dashAngle: Int, 29 | isEndPoint: Boolean 30 | ): Float { 31 | // Modify the translation based on the angle at which dashes are drawn. 32 | val modifiedXTranslation = when (getDashDirection(dashAngle)) { 33 | is DashDirection.LeftToRight -> xTranslation * -1 34 | is DashDirection.RightToLeft -> xTranslation 35 | is DashDirection.Vertical -> 0.0 36 | } 37 | 38 | // One more modification required. Start points and end points need opposite x translations. 39 | val finalModifiedXTranslation = 40 | if (isEndPoint) modifiedXTranslation * -1 41 | else modifiedXTranslation 42 | 43 | return finalModifiedXTranslation.toFloat() 44 | } 45 | 46 | /** 47 | * Calculates how much horizontal space should be between two dashes. 48 | * 49 | * This method should not be called for horizontal lines. If it is, it will return a safe value 50 | * to avoid a divide by 0 error. 51 | */ 52 | internal fun calculateHorizontalOffset(dashAngle: Int, width: Float): Float { 53 | if (getDashDirection(dashAngle).isHorizontal) return width 54 | val radians = Math.toRadians((90 - dashAngle).toDouble()) 55 | return width / (cos(radians)).toFloat() 56 | } 57 | 58 | /** 59 | * Calculates how much vertical space should be between two dashes. 60 | * 61 | * This method should not be called for vertical lines. If it is, it will return a safe value 62 | * to avoid a divide by 0 error. 63 | */ 64 | internal fun calculateVerticalOffset(dashAngle: Int, width: Float): Float { 65 | if (getDashDirection(dashAngle) is DashDirection.Vertical) return width 66 | val complementaryAngle = Math.toRadians(abs(90 - dashAngle).toDouble()) 67 | val halfVerticalLengthDashCrossSection = width / (2 * sin(complementaryAngle)) 68 | return halfVerticalLengthDashCrossSection.toFloat() * 2f 69 | } -------------------------------------------------------------------------------- /.idea/codeStyles/Project.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 11 | 20 | 22 | 23 | 135 | 136 | 138 | 139 | -------------------------------------------------------------------------------- /app/src/main/java/com/mackhartley/dashedviewexample/MainActivity.kt: -------------------------------------------------------------------------------- 1 | package com.mackhartley.dashedviewexample 2 | 3 | import android.graphics.Color 4 | import android.os.Bundle 5 | import androidx.appcompat.app.AppCompatActivity 6 | import androidx.core.content.ContextCompat 7 | import com.mackhartley.dashedview.DashedView 8 | import com.mackhartley.dashedview.DashColorGenerator 9 | 10 | class MainActivity : AppCompatActivity() { 11 | override fun onCreate(savedInstanceState: Bundle?) { 12 | super.onCreate(savedInstanceState) 13 | setContentView(R.layout.activity_main) 14 | 15 | // Gives an example of a gradient 16 | val misc1 = findViewById(R.id.misc_example_1) 17 | misc1.setDashColorGenerator( 18 | object : DashColorGenerator { 19 | override fun getPaintColor(curIndex: Int, numDashes: Int): Int { 20 | val alphaValue = 255 * ((curIndex + 1).toFloat() / (numDashes + 1).toFloat()) 21 | val gradientAppliedColor = Color.argb(alphaValue.toInt(), 255, 0, 255) 22 | return gradientAppliedColor 23 | } 24 | } 25 | ) 26 | 27 | // Gives an example of a gradient 28 | val misc2 = findViewById(R.id.misc_example_2) 29 | misc2.setDashColorGenerator( 30 | object : DashColorGenerator { 31 | override fun getPaintColor(curIndex: Int, numDashes: Int): Int { 32 | val color = ContextCompat.getColor(applicationContext, R.color.design_default_color_secondary) 33 | 34 | val red = Color.red(color) 35 | val green = Color.green(color) 36 | val blue = Color.blue(color) 37 | val alphaValue = 255 * ((curIndex + 1).toFloat() / (numDashes + 1).toFloat()) 38 | val gradientAppliedColor = Color.argb(alphaValue.toInt(), red, green, blue) 39 | return gradientAppliedColor 40 | } 41 | } 42 | ) 43 | 44 | // Gives an example of a gradient 45 | val misc3 = findViewById(R.id.misc_example_3) 46 | misc3.setDashColorGenerator( 47 | object : DashColorGenerator { 48 | override fun getPaintColor(curIndex: Int, numDashes: Int): Int { 49 | val alphaValue = 255 * ((curIndex + 1).toFloat() / (numDashes + 1).toFloat()) 50 | val gradientAppliedColor = Color.argb(alphaValue.toInt(), 0, 0, 0) 51 | return gradientAppliedColor 52 | } 53 | } 54 | ) 55 | 56 | // Gives an example of an alternating color pallet 57 | val misc4 = findViewById(R.id.misc_example_4) 58 | misc4.setDashColorGenerator( 59 | object : DashColorGenerator { 60 | override fun getPaintColor(curIndex: Int, numDashes: Int): Int { 61 | return when { 62 | curIndex % 2 == 0 -> ContextCompat.getColor( 63 | this@MainActivity.applicationContext, 64 | R.color.barber1 65 | ) 66 | else -> ContextCompat.getColor( 67 | this@MainActivity.applicationContext, 68 | R.color.barber2 69 | ) 70 | } 71 | } 72 | } 73 | ) 74 | 75 | // Gives an example of an alternating color pallet 76 | val misc5 = findViewById(R.id.misc_example_5) 77 | misc5.setDashColorGenerator( 78 | object : DashColorGenerator { 79 | override fun getPaintColor(curIndex: Int, numDashes: Int): Int { 80 | return when { 81 | curIndex % 5 == 0 -> ContextCompat.getColor( 82 | this@MainActivity.applicationContext, 83 | R.color.rainbow1 84 | ) 85 | curIndex % 5 == 1 -> ContextCompat.getColor( 86 | this@MainActivity.applicationContext, 87 | R.color.rainbow2 88 | ) 89 | curIndex % 5 == 2 -> ContextCompat.getColor( 90 | this@MainActivity.applicationContext, 91 | R.color.rainbow3 92 | ) 93 | curIndex % 5 == 3 -> ContextCompat.getColor( 94 | this@MainActivity.applicationContext, 95 | R.color.rainbow4 96 | ) 97 | else -> ContextCompat.getColor( 98 | this@MainActivity.applicationContext, 99 | R.color.rainbow5 100 | ) 101 | } 102 | } 103 | } 104 | ) 105 | } 106 | } -------------------------------------------------------------------------------- /CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Covenant Code of Conduct 2 | 3 | ## Our Pledge 4 | 5 | We as members, contributors, and leaders pledge to make participation in our 6 | community a harassment-free experience for everyone, regardless of age, body 7 | size, visible or invisible disability, ethnicity, sex characteristics, gender 8 | identity and expression, level of experience, education, socio-economic status, 9 | nationality, personal appearance, race, religion, or sexual identity 10 | and orientation. 11 | 12 | We pledge to act and interact in ways that contribute to an open, welcoming, 13 | diverse, inclusive, and healthy community. 14 | 15 | ## Our Standards 16 | 17 | Examples of behavior that contributes to a positive environment for our 18 | community include: 19 | 20 | * Demonstrating empathy and kindness toward other people 21 | * Being respectful of differing opinions, viewpoints, and experiences 22 | * Giving and gracefully accepting constructive feedback 23 | * Accepting responsibility and apologizing to those affected by our mistakes, 24 | and learning from the experience 25 | * Focusing on what is best not just for us as individuals, but for the 26 | overall community 27 | 28 | Examples of unacceptable behavior include: 29 | 30 | * The use of sexualized language or imagery, and sexual attention or 31 | advances of any kind 32 | * Trolling, insulting or derogatory comments, and personal or political attacks 33 | * Public or private harassment 34 | * Publishing others' private information, such as a physical or email 35 | address, without their explicit permission 36 | * Other conduct which could reasonably be considered inappropriate in a 37 | professional setting 38 | 39 | ## Enforcement Responsibilities 40 | 41 | Community leaders are responsible for clarifying and enforcing our standards of 42 | acceptable behavior and will take appropriate and fair corrective action in 43 | response to any behavior that they deem inappropriate, threatening, offensive, 44 | or harmful. 45 | 46 | Community leaders have the right and responsibility to remove, edit, or reject 47 | comments, commits, code, wiki edits, issues, and other contributions that are 48 | not aligned to this Code of Conduct, and will communicate reasons for moderation 49 | decisions when appropriate. 50 | 51 | ## Scope 52 | 53 | This Code of Conduct applies within all community spaces, and also applies when 54 | an individual is officially representing the community in public spaces. 55 | Examples of representing our community include using an official e-mail address, 56 | posting via an official social media account, or acting as an appointed 57 | representative at an online or offline event. 58 | 59 | ## Enforcement 60 | 61 | Instances of abusive, harassing, or otherwise unacceptable behavior may be 62 | reported to the community leaders responsible for enforcement at 63 | contact.mhartley@gmail.com. 64 | All complaints will be reviewed and investigated promptly and fairly. 65 | 66 | All community leaders are obligated to respect the privacy and security of the 67 | reporter of any incident. 68 | 69 | ## Enforcement Guidelines 70 | 71 | Community leaders will follow these Community Impact Guidelines in determining 72 | the consequences for any action they deem in violation of this Code of Conduct: 73 | 74 | ### 1. Correction 75 | 76 | **Community Impact**: Use of inappropriate language or other behavior deemed 77 | unprofessional or unwelcome in the community. 78 | 79 | **Consequence**: A private, written warning from community leaders, providing 80 | clarity around the nature of the violation and an explanation of why the 81 | behavior was inappropriate. A public apology may be requested. 82 | 83 | ### 2. Warning 84 | 85 | **Community Impact**: A violation through a single incident or series 86 | of actions. 87 | 88 | **Consequence**: A warning with consequences for continued behavior. No 89 | interaction with the people involved, including unsolicited interaction with 90 | those enforcing the Code of Conduct, for a specified period of time. This 91 | includes avoiding interactions in community spaces as well as external channels 92 | like social media. Violating these terms may lead to a temporary or 93 | permanent ban. 94 | 95 | ### 3. Temporary Ban 96 | 97 | **Community Impact**: A serious violation of community standards, including 98 | sustained inappropriate behavior. 99 | 100 | **Consequence**: A temporary ban from any sort of interaction or public 101 | communication with the community for a specified period of time. No public or 102 | private interaction with the people involved, including unsolicited interaction 103 | with those enforcing the Code of Conduct, is allowed during this period. 104 | Violating these terms may lead to a permanent ban. 105 | 106 | ### 4. Permanent Ban 107 | 108 | **Community Impact**: Demonstrating a pattern of violation of community 109 | standards, including sustained inappropriate behavior, harassment of an 110 | individual, or aggression toward or disparagement of classes of individuals. 111 | 112 | **Consequence**: A permanent ban from any sort of public interaction within 113 | the community. 114 | 115 | ## Attribution 116 | 117 | This Code of Conduct is adapted from the [Contributor Covenant][homepage], 118 | version 2.0, available at 119 | https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. 120 | 121 | Community Impact Guidelines were inspired by [Mozilla's code of conduct 122 | enforcement ladder](https://github.com/mozilla/diversity). 123 | 124 | [homepage]: https://www.contributor-covenant.org 125 | 126 | For answers to common questions about this code of conduct, see the FAQ at 127 | https://www.contributor-covenant.org/faq. Translations are available at 128 | https://www.contributor-covenant.org/translations. 129 | -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env sh 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Attempt to set APP_HOME 10 | # Resolve links: $0 may be a link 11 | PRG="$0" 12 | # Need this for relative symlinks. 13 | while [ -h "$PRG" ] ; do 14 | ls=`ls -ld "$PRG"` 15 | link=`expr "$ls" : '.*-> \(.*\)$'` 16 | if expr "$link" : '/.*' > /dev/null; then 17 | PRG="$link" 18 | else 19 | PRG=`dirname "$PRG"`"/$link" 20 | fi 21 | done 22 | SAVED="`pwd`" 23 | cd "`dirname \"$PRG\"`/" >/dev/null 24 | APP_HOME="`pwd -P`" 25 | cd "$SAVED" >/dev/null 26 | 27 | APP_NAME="Gradle" 28 | APP_BASE_NAME=`basename "$0"` 29 | 30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 31 | DEFAULT_JVM_OPTS="" 32 | 33 | # Use the maximum available, or set MAX_FD != -1 to use that value. 34 | MAX_FD="maximum" 35 | 36 | warn () { 37 | echo "$*" 38 | } 39 | 40 | die () { 41 | echo 42 | echo "$*" 43 | echo 44 | exit 1 45 | } 46 | 47 | # OS specific support (must be 'true' or 'false'). 48 | cygwin=false 49 | msys=false 50 | darwin=false 51 | nonstop=false 52 | case "`uname`" in 53 | CYGWIN* ) 54 | cygwin=true 55 | ;; 56 | Darwin* ) 57 | darwin=true 58 | ;; 59 | MINGW* ) 60 | msys=true 61 | ;; 62 | NONSTOP* ) 63 | nonstop=true 64 | ;; 65 | esac 66 | 67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 68 | 69 | # Determine the Java command to use to start the JVM. 70 | if [ -n "$JAVA_HOME" ] ; then 71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 72 | # IBM's JDK on AIX uses strange locations for the executables 73 | JAVACMD="$JAVA_HOME/jre/sh/java" 74 | else 75 | JAVACMD="$JAVA_HOME/bin/java" 76 | fi 77 | if [ ! -x "$JAVACMD" ] ; then 78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 79 | 80 | Please set the JAVA_HOME variable in your environment to match the 81 | location of your Java installation." 82 | fi 83 | else 84 | JAVACMD="java" 85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 86 | 87 | Please set the JAVA_HOME variable in your environment to match the 88 | location of your Java installation." 89 | fi 90 | 91 | # Increase the maximum file descriptors if we can. 92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then 93 | MAX_FD_LIMIT=`ulimit -H -n` 94 | if [ $? -eq 0 ] ; then 95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 96 | MAX_FD="$MAX_FD_LIMIT" 97 | fi 98 | ulimit -n $MAX_FD 99 | if [ $? -ne 0 ] ; then 100 | warn "Could not set maximum file descriptor limit: $MAX_FD" 101 | fi 102 | else 103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 104 | fi 105 | fi 106 | 107 | # For Darwin, add options to specify how the application appears in the dock 108 | if $darwin; then 109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 110 | fi 111 | 112 | # For Cygwin, switch paths to Windows format before running java 113 | if $cygwin ; then 114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 116 | JAVACMD=`cygpath --unix "$JAVACMD"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Escape application args 158 | save () { 159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done 160 | echo " " 161 | } 162 | APP_ARGS=$(save "$@") 163 | 164 | # Collect all arguments for the java command, following the shell quoting and substitution rules 165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" 166 | 167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong 168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then 169 | cd "$(dirname "$0")" 170 | fi 171 | 172 | exec "$JAVACMD" "$@" 173 | -------------------------------------------------------------------------------- /dashedview/src/test/java/com/mackhartley/dashedview/DashedViewTests.kt: -------------------------------------------------------------------------------- 1 | package com.mackhartley.dashedview 2 | 3 | import org.junit.Assert.assertEquals 4 | import org.junit.Assert.assertTrue 5 | import org.junit.Test 6 | 7 | class DashedViewTests { 8 | 9 | companion object { 10 | const val DELTA = 0.0001f 11 | } 12 | 13 | @Test 14 | fun get_dash_direction_left_right_correctly() { 15 | val dashDirection = getDashDirection(45) 16 | assertTrue(dashDirection is DashDirection.LeftToRight) 17 | assertTrue(!dashDirection.isHorizontal) 18 | } 19 | 20 | @Test 21 | fun get_dash_direction_left_right_horizontal_correctly() { 22 | val dashDirection = getDashDirection(0) 23 | assertTrue(dashDirection is DashDirection.LeftToRight) 24 | assertTrue(dashDirection.isHorizontal) 25 | } 26 | 27 | @Test 28 | fun get_dash_direction_right_left_correctly() { 29 | val dashDirection = getDashDirection(135) 30 | assertTrue(dashDirection is DashDirection.RightToLeft) 31 | assertTrue(!dashDirection.isHorizontal) 32 | } 33 | 34 | @Test 35 | fun get_dash_direction_vertical_correctly() { 36 | val dashDirection = getDashDirection(90) 37 | assertTrue(dashDirection is DashDirection.Vertical) 38 | } 39 | 40 | @Test 41 | fun calculate_end_point_x_trans_left_right() { 42 | val angle = 45 43 | val viewHeight = 100f 44 | val xTranslation = calculateEndPointXTranslation(angle, viewHeight) 45 | assertEquals(xTranslation, 100f) 46 | } 47 | 48 | @Test 49 | fun calculate_end_point_x_trans_right_left() { 50 | val angle = 135 51 | val viewHeight = 100f 52 | val xTranslation = calculateEndPointXTranslation(angle, viewHeight) 53 | assertEquals(xTranslation, -100f) 54 | } 55 | 56 | @Test 57 | fun calculate_end_point_x_trans_vertical() { 58 | val angle = 90 59 | val viewHeight = 100f 60 | val xTranslation = calculateEndPointXTranslation(angle, viewHeight) 61 | assertEquals(xTranslation, 0f, DELTA) 62 | } 63 | 64 | @Test 65 | fun calculate_end_point_x_trans_horizontal() { 66 | val angle = 0 67 | val viewHeight = 100f 68 | val xTranslation = calculateEndPointXTranslation(angle, viewHeight) 69 | assertEquals(xTranslation, viewHeight) 70 | } 71 | 72 | @Test 73 | fun calculate_modified_x_trans_start_point_left_right() { 74 | val xTranslation = 5.0 75 | val dashAngle = 45 76 | val isEndPoint = false 77 | val modifiedValue = calculateModifiedXTranslation(xTranslation, dashAngle, isEndPoint) 78 | assertEquals(modifiedValue, -5.0f) 79 | } 80 | 81 | @Test 82 | fun calculate_modified_x_trans_start_point_right_left() { 83 | val xTranslation = 5.0 84 | val dashAngle = 135 85 | val isEndPoint = false 86 | val modifiedValue = calculateModifiedXTranslation(xTranslation, dashAngle, isEndPoint) 87 | assertEquals(modifiedValue, 5.0f) 88 | } 89 | 90 | @Test 91 | fun calculate_modified_x_trans_end_point_left_right() { 92 | val xTranslation = 5.0 93 | val dashAngle = 45 94 | val isEndPoint = true 95 | val modifiedValue = calculateModifiedXTranslation(xTranslation, dashAngle, isEndPoint) 96 | assertEquals(modifiedValue, 5.0f) 97 | } 98 | 99 | @Test 100 | fun calculate_modified_x_trans_end_point_right_left() { 101 | val xTranslation = 5.0 102 | val dashAngle = 135 103 | val isEndPoint = true 104 | val modifiedValue = calculateModifiedXTranslation(xTranslation, dashAngle, isEndPoint) 105 | assertEquals(modifiedValue, -5.0f) 106 | } 107 | 108 | @Test 109 | fun calculate_modified_x_trans_vertical() { 110 | val xTranslation = 5.0 111 | val dashAngle = 90 112 | val isEndPoint = true 113 | val modifiedValue = calculateModifiedXTranslation(xTranslation, dashAngle, isEndPoint) 114 | assertEquals(modifiedValue, 0f, DELTA) 115 | } 116 | 117 | @Test 118 | fun calculate_horizontal_offset_left_right_dash() { 119 | val angle = 60 120 | val width = 10f 121 | val horizontalOffset = calculateHorizontalOffset(angle, width) 122 | assertEquals(horizontalOffset, 11.547006f, DELTA) 123 | } 124 | 125 | @Test 126 | fun calculate_horizontal_offset_right_left_dash() { 127 | val angle = 120 128 | val width = 10f 129 | val horizontalOffset = calculateHorizontalOffset(angle, width) 130 | assertEquals(horizontalOffset, 11.547006f, DELTA) 131 | } 132 | 133 | @Test 134 | fun calculate_horizontal_offset_vertical_dash() { 135 | val angle = 90 136 | val width = 10f 137 | val horizontalOffset = calculateHorizontalOffset(angle, width) 138 | assertEquals(horizontalOffset, 10.0f, DELTA) 139 | } 140 | 141 | @Test 142 | fun calculate_horizontal_offset_horizontal_dash() { 143 | val angle = 0 144 | val width = 10f 145 | val horizontalOffset = calculateHorizontalOffset(angle, width) 146 | assertEquals(horizontalOffset, 10.0f, DELTA) 147 | } 148 | 149 | @Test 150 | fun calculate_vertical_offset_left_right_dash() { 151 | val angle = 60 152 | val width = 10f 153 | val horizontalOffset = calculateVerticalOffset(angle, width) 154 | assertEquals(horizontalOffset, 20.0f, DELTA) 155 | } 156 | 157 | @Test 158 | fun calculate_vertical_offset_right_left_dash() { 159 | val angle = 60 160 | val width = 10f 161 | val horizontalOffset = calculateVerticalOffset(angle, width) 162 | assertEquals(horizontalOffset, 20.0f, DELTA) 163 | } 164 | 165 | @Test 166 | fun calculate_vertical_offset_vertical_dash() { 167 | val angle = 90 168 | val width = 10f 169 | val horizontalOffset = calculateVerticalOffset(angle, width) 170 | assertEquals(horizontalOffset, 10.0f, DELTA) 171 | } 172 | 173 | @Test 174 | fun calculate_vertical_offset_horizontal_dash() { 175 | val angle = 0 176 | val width = 10f 177 | val horizontalOffset = calculateVerticalOffset(angle, width) 178 | assertEquals(horizontalOffset, 10.0f, DELTA) 179 | } 180 | } -------------------------------------------------------------------------------- /app/src/main/res/drawable/ic_launcher_background.xml: -------------------------------------------------------------------------------- 1 | 2 | 7 | 10 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 55 | 60 | 65 | 70 | 75 | 80 | 85 | 90 | 95 | 100 | 105 | 110 | 115 | 120 | 125 | 130 | 135 | 140 | 145 | 150 | 155 | 160 | 165 | 170 | 171 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |

2 | 3 |

4 |

DashedView

5 |

The easiest way to create a dashed or striped background on Android

6 | 7 |

8 | 9 | 10 | 11 | ktlint 12 | Featured in Android Weekly 13 |

14 | 15 | The `DashedView` library allows you to create views with a dashed (or striped) background. Below are some examples of views created with this library. You can click on any example to see its code. 16 | 17 |

18 | Screen Shot 2021-05-21 at 11 42 53 PM 19 | Screen Shot 2021-05-21 at 11 42 18 PM 20 |
21 | card1 22 | card2 23 |
24 |

25 | 26 | There is also a demo app for this library which allows you to see the look and feel of the `DashedView` on your own device: 27 | 28 |

29 | Get it on Google Play 30 |

31 | 32 |

Quick Start Guide

33 | 34 | If you don't have this already, add it to your **root** build.gradle file: 35 | ``` 36 | allprojects { 37 | repositories { 38 | ... 39 | maven { url 'https://jitpack.io' } 40 | } 41 | } 42 | ``` 43 | 44 | Then you can add the dependency to your **app** build.gradle file: 45 | ``` 46 | dependencies { 47 | ... 48 | implementation 'com.github.MackHartley:DashedView:1.0.0' 49 | } 50 | ``` 51 | 52 | Once that's finished you can declare a `DashedView` via XML: 53 | ``` 54 | 62 | ``` 63 | 64 |

Usage ⚙️

65 | 66 | The table below explains the 5 XML attributes you can set on the `DashedView` class: 67 |
68 | 69 | | XML Attribute | Use | 70 | |---|---| 71 | | `dvDashAngle` | Sets the angle of the dashes. The angle is measured from the X axis of the view. | 72 | | `dvDashColor` | Sets the color of the dashes. | 73 | | `dvDashWidth` | Sets the width of the dashes. | 74 | | `dvSpaceBetweenDashes` | Sets the width of the space between each dash. | 75 | | `dvViewCornerRadius` | Sets the corner radius value for the `DashedView`. Useful when working with other views that have rounded corners. | 76 |
77 | 78 | The `DashedView` also has a public method that allows you to set custom coloring for individual dashes: 79 |
80 | 81 | | Public Method | Use | 82 | |---|---| 83 | | `setDashColorGenerator(...)` | This method takes a `DashColorGenerator` instance as a parameter which gives you access to the index of the current dash being drawn. Using that information you can specify logic for how each dash should be colored. | 84 | 85 | ``` 86 | interface DashColorGenerator { 87 | @ColorInt fun getPaintColor(curIndex: Int, numDashes: Int): Int 88 | } 89 | ``` 90 | To see an example of the `DashColorGenerator` click here. 91 | 92 |

More Examples 🖼️

93 | 94 |

95 | Click on any example to see it's code (You also need to look at MainActivity which sets custom dash coloring) 96 |
97 |
98 | heropic 99 | hero2 100 | Screen Shot 2021-05-21 at 11 44 19 PM 101 | Screen Shot 2021-05-23 at 3 48 04 PM 102 |
103 | Screen Shot 2021-05-23 at 3 47 38 PM 104 |

105 | 106 | # Contributing 🤝 107 | Feel free to open issues on this repo to report bugs or request features. Additionally if you'd like to contribute you can create a pull request (make sure to read contributing.mk). 108 | 109 | **Special thanks to all those who have supported this repo thus far!** 110 |

111 |
112 | 113 |
114 | 115 |

116 | 117 | # License 📄 118 | ``` 119 | Copyright 2021 Mack Hartley 120 | 121 | Licensed under the Apache License, Version 2.0 (the "License"); 122 | you may not use this file except in compliance with the License. 123 | You may obtain a copy of the License at 124 | 125 | http://www.apache.org/licenses/LICENSE-2.0 126 | 127 | Unless required by applicable law or agreed to in writing, software 128 | distributed under the License is distributed on an "AS IS" BASIS, 129 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 130 | See the License for the specific language governing permissions and 131 | limitations under the License. 132 | ``` 133 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright [2021] [Mack Hartley] 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | -------------------------------------------------------------------------------- /app/src/main/res/layout/activity_main.xml: -------------------------------------------------------------------------------- 1 | 2 | 10 | 11 | 15 | 16 | 22 | 23 | 31 | 32 | 43 | 44 | 58 | 59 | 71 | 72 | 73 | 74 | 80 | 81 | 91 | 92 | 103 | 104 | 119 | 120 | 126 | 127 | 137 | 138 | 141 | 142 | 153 | 154 | 162 | 163 | 164 | 165 | 166 | 167 | 178 | 179 | 182 | 183 | 197 | 198 | 206 | 207 | 218 | 219 | 220 | 221 | 222 | 223 | 229 | 230 | 243 | 244 | 256 | 257 | 269 | 270 | 282 | 283 | 295 | 296 | 297 | 298 | -------------------------------------------------------------------------------- /dashedview/src/main/java/com/mackhartley/dashedview/DashedView.kt: -------------------------------------------------------------------------------- 1 | package com.mackhartley.dashedview 2 | 3 | import android.content.Context 4 | import android.graphics.Canvas 5 | import android.graphics.Color 6 | import android.graphics.Paint 7 | import android.graphics.Path 8 | import android.util.AttributeSet 9 | import android.view.View 10 | import androidx.annotation.ColorInt 11 | import kotlin.math.abs 12 | import kotlin.math.cos 13 | import kotlin.math.sin 14 | import kotlin.math.tan 15 | 16 | class DashedView @JvmOverloads constructor( 17 | context: Context, 18 | attrs: AttributeSet? = null, 19 | defStyleAttr: Int = 0 20 | ) : View(context, attrs, defStyleAttr) { 21 | 22 | // Instance state 23 | private var dashWidth = DEFAULT_WIDTH 24 | private var spaceBetweenDashes = DEFAULT_SPACE_BETWEEN_DASHES 25 | private var dashAngle = DEFAULT_DASH_ANGLE 26 | private var cornerRadius = DEFAULT_CORNER_RADIUS 27 | @ColorInt private var dashColor = DEFAULT_DASH_COLOR 28 | private var dashColorGenerator: DashColorGenerator? = null 29 | 30 | private var lastWidth = width // Used for keeping track of view size 31 | private var lastHeight = height // Used for keeping track of view size 32 | 33 | private val dashPaint by lazy { 34 | Paint().apply { 35 | strokeCap = Paint.Cap.BUTT 36 | color = dashColor 37 | strokeWidth = dashWidth 38 | isAntiAlias = true 39 | } 40 | } 41 | 42 | private val roundedCornersClipPath by lazy { // This path is used to clip the progress background and drawable to the desired corner radius 43 | Path().apply { 44 | addRoundRect( 45 | VIEW_LEFT, 46 | VIEW_TOP, 47 | lastWidth.toFloat(), 48 | lastHeight.toFloat(), 49 | floatArrayOf(cornerRadius, cornerRadius, cornerRadius, cornerRadius, cornerRadius, cornerRadius, cornerRadius, cornerRadius), 50 | Path.Direction.CW 51 | ) 52 | } 53 | } 54 | 55 | companion object { 56 | const val DEFAULT_WIDTH = 12f 57 | const val DEFAULT_SPACE_BETWEEN_DASHES = 12f 58 | const val DEFAULT_DASH_ANGLE = 45 // Measured in degrees. Min 0, max 179. A value of 0 Degrees points to the right side of the view 59 | const val DEFAULT_CORNER_RADIUS = 0f 60 | const val DEFAULT_DASH_COLOR = Color.GRAY 61 | const val VIEW_LEFT = 0f 62 | const val VIEW_TOP = 0f 63 | } 64 | 65 | init { 66 | val attrRefs = context.obtainStyledAttributes(attrs, R.styleable.DashedView) 67 | 68 | val requestedWidth = attrRefs.getDimension(R.styleable.DashedView_dvDashWidth, DEFAULT_WIDTH) 69 | dashWidth = parseRequestedDashWidth(requestedWidth) 70 | 71 | val requestedAngle = attrRefs.getInteger(R.styleable.DashedView_dvDashAngle, DEFAULT_DASH_ANGLE) 72 | dashAngle = parseRequestedDashAngle(requestedAngle) 73 | 74 | spaceBetweenDashes = attrRefs.getDimension(R.styleable.DashedView_dvSpaceBetweenDashes, DEFAULT_SPACE_BETWEEN_DASHES) 75 | dashColor = attrRefs.getColor(R.styleable.DashedView_dvDashColor, DEFAULT_DASH_COLOR) 76 | cornerRadius = attrRefs.getDimension(R.styleable.DashedView_dvViewCornerRadius, DEFAULT_CORNER_RADIUS) 77 | attrRefs.recycle() 78 | } 79 | 80 | /** 81 | * [DashedView] only allows angles between 0 and 179 inclusive. Values outside of that range will 82 | * have a modulus operation applied to them. 83 | */ 84 | private fun parseRequestedDashAngle(requestedAngle: Int): Int { 85 | return requestedAngle % 180 86 | } 87 | 88 | private fun parseRequestedDashWidth(requestedWidth: Float): Float { 89 | return if (requestedWidth <= 0f) 1f 90 | else requestedWidth 91 | } 92 | 93 | override fun onDraw(canvas: Canvas?) { 94 | if (canvas != null) { 95 | 96 | // Apply the requested rounded corner value 97 | canvas.clipPath(roundedCornersClipPath) 98 | 99 | // Get list of coordinates for dashes that need to be drawn 100 | val dashesOriginatingFromXAxis = getDashesOriginatingFromXAxis( 101 | dashWidth = dashWidth, 102 | spaceBetweenDashes = spaceBetweenDashes, 103 | dashAngle = dashAngle, 104 | viewWidth = width.toFloat(), 105 | viewHeight = height.toFloat() 106 | ) 107 | val dashesOriginatingFromYAxis = getDashesOriginatingFromYAxis( 108 | dashWidth = dashWidth, 109 | spaceBetweenDashes = spaceBetweenDashes, 110 | dashAngle = dashAngle, 111 | viewWidth = width.toFloat(), 112 | viewHeight = height.toFloat() 113 | ) 114 | val dashDirection = getDashDirection(dashAngle) 115 | val allDashesToDraw = 116 | if (dashDirection.isHorizontal) dashesOriginatingFromYAxis // If horizontal, only draw dashes originating from Y axis 117 | else when (dashDirection) { 118 | is DashDirection.LeftToRight -> dashesOriginatingFromYAxis.reversed() + dashesOriginatingFromXAxis 119 | is DashDirection.RightToLeft -> dashesOriginatingFromXAxis.reversed() + dashesOriginatingFromYAxis 120 | is DashDirection.Vertical -> dashesOriginatingFromXAxis // If vertical, only draw dashes originating from X axis 121 | } 122 | 123 | // Loop through coordinate list and draw dashes 124 | for ((index, dashCoordinates) in allDashesToDraw.withIndex()) { 125 | val startPoint = dashCoordinates.startPoint 126 | val endPoint = dashCoordinates.endPoint 127 | updatePaintColorIfNeeded(dashColorGenerator, index, allDashesToDraw.size) 128 | 129 | canvas.drawLine(startPoint.first, startPoint.second, endPoint.first, endPoint.second, dashPaint) 130 | } 131 | } 132 | } 133 | 134 | private fun updatePaintColorIfNeeded( 135 | dashColorGenerator: DashColorGenerator?, 136 | index: Int, 137 | numDashes: Int 138 | ) { 139 | if (dashColorGenerator != null) { 140 | dashPaint.color = dashColorGenerator.getPaintColor(index, numDashes) 141 | } 142 | } 143 | 144 | /** 145 | * Generates dashes with start points originating from the X axis. 146 | */ 147 | private fun getDashesOriginatingFromXAxis( 148 | dashWidth: Float, 149 | spaceBetweenDashes: Float, 150 | dashAngle: Int, 151 | viewWidth: Float, 152 | viewHeight: Float 153 | ): List { 154 | 155 | // Check if horizontal config (0 degrees). If so, no dashes drawn from x axis 156 | val dashDirection = getDashDirection(dashAngle) 157 | if (dashDirection.isHorizontal) return emptyList() 158 | 159 | // Calculate start points 160 | val startPoints = mutableListOf>() 161 | val startYPosition = viewHeight 162 | val dashHorizontalOffset = calculateHorizontalOffset(dashAngle, dashWidth) 163 | val spaceHorizontalOffset = calculateHorizontalOffset(dashAngle, spaceBetweenDashes) 164 | 165 | var curXPosition: Float 166 | when (dashDirection) { 167 | is DashDirection.LeftToRight, 168 | is DashDirection.Vertical -> { 169 | curXPosition = VIEW_LEFT 170 | while (curXPosition <= viewWidth) { 171 | startPoints.add(Pair(curXPosition, startYPosition)) 172 | curXPosition += abs(dashHorizontalOffset + spaceHorizontalOffset) 173 | } 174 | } 175 | is DashDirection.RightToLeft -> { // If the dashes are pointing from right to left, then start drawing dashes from the bottom right corner of the view 176 | curXPosition = viewWidth 177 | while (curXPosition >= VIEW_LEFT) { 178 | startPoints.add(Pair(curXPosition, startYPosition)) 179 | curXPosition -= abs(dashHorizontalOffset + spaceHorizontalOffset) 180 | } 181 | } 182 | } 183 | startPoints.add(Pair(curXPosition, startYPosition)) // Add one more dash to ensure the view is fully covered by dashes 184 | 185 | // Calculate translation required to generate end point for a given start point 186 | // Apply translation to list of start points to get list of dash coordinates 187 | val endPointXTranslation = calculateEndPointXTranslation(dashAngle, viewHeight) 188 | val dashCoordinates = startPoints.map { 189 | DashInfo( 190 | startPoint = it, 191 | endPoint = 192 | generateEndPoint( 193 | startPoint = it, 194 | dashAngle = dashAngle, 195 | endPointXTranslation = endPointXTranslation, 196 | endPointYValue = VIEW_TOP, 197 | viewWidth = viewWidth 198 | ) 199 | ) 200 | } 201 | 202 | // Translate start and end points so all 4 corners of dash are drawn outside of the view 203 | val elongatedDashCoordinates = elongateDashesOriginatingFromXAxis( 204 | initialPositions = dashCoordinates, 205 | dashAngle = dashAngle, 206 | dashWidth = dashWidth 207 | ) 208 | 209 | return elongatedDashCoordinates 210 | } 211 | 212 | /** 213 | * Generates dashes with start points originating on the Y axis. 214 | */ 215 | private fun getDashesOriginatingFromYAxis( 216 | dashWidth: Float, 217 | spaceBetweenDashes: Float, 218 | dashAngle: Int, 219 | viewWidth: Float, 220 | viewHeight: Float 221 | ): List { 222 | 223 | // Check if vertical config (90 degrees). If so, no dashes should be drawn from the y axis 224 | val dashDirection = getDashDirection(dashAngle) 225 | if (dashDirection is DashDirection.Vertical) return emptyList() 226 | 227 | // Calculate start points 228 | val startPositions = mutableListOf>() 229 | val startXPosition = if (dashDirection is DashDirection.LeftToRight) VIEW_LEFT else viewWidth 230 | 231 | var curYPosition = viewHeight 232 | 233 | val dashVerticalOffset = calculateVerticalOffset(dashAngle, dashWidth) 234 | val spaceVerticalOffset = calculateVerticalOffset(dashAngle, spaceBetweenDashes) 235 | if (!dashDirection.isHorizontal) { // If dashes will be drawn from the x axis, then skip drawing a dash for the first y position because it is equal to the first x position 236 | curYPosition -= abs(dashVerticalOffset + spaceVerticalOffset) 237 | } 238 | while (curYPosition >= VIEW_TOP) { 239 | startPositions.add(Pair(startXPosition, curYPosition)) 240 | curYPosition -= abs(dashVerticalOffset + spaceVerticalOffset) 241 | } 242 | startPositions.add(Pair(startXPosition, curYPosition)) // Add one more dash to ensure the view is fully covered by dashes 243 | 244 | // Calculate translation required to generate end point for a given start point 245 | // Apply translation to list of start points to get list of dash coordinates 246 | val transition = calculateEndPointXTranslation(dashAngle, viewHeight) 247 | val dashCoordinates = startPositions.map { 248 | DashInfo( 249 | startPoint = Pair( 250 | it.first, 251 | it.second 252 | ), 253 | endPoint = generateEndPoint( 254 | startPoint = it, 255 | dashAngle = dashAngle, 256 | endPointXTranslation = transition, 257 | endPointYValue = it.second - viewHeight, // Subtract view height because each of these dashes has a different start point Y value 258 | viewWidth = viewWidth 259 | ) 260 | ) 261 | } 262 | 263 | // Translate start and end points so all 4 corners of dash are drawn outside of the view 264 | val elongatedDashCoordinates = elongateDashesOriginatingFromYAxis( 265 | initialPositions = dashCoordinates, 266 | dashAngle = dashAngle, 267 | dashWidth = dashWidth 268 | ) 269 | 270 | return elongatedDashCoordinates 271 | } 272 | 273 | /** 274 | * Elongate dashes enough so that all 4 corners of each dash are extended out of the view 275 | * canvas. This ensures the corners of the dashes/lines are not visible. This is more important 276 | * when dashes get thicker and resemble rectangles instead of dashes/lines. 277 | * 278 | * Affects Dashes that originate from the X axis. 279 | */ 280 | private fun elongateDashesOriginatingFromXAxis( 281 | initialPositions: List, 282 | dashAngle: Int, 283 | dashWidth: Float 284 | ): List { 285 | val hypotenuseRadians = Math.toRadians((abs(90 - dashAngle).toDouble())) 286 | val translationHypotenuse = (dashWidth * tan((hypotenuseRadians))) / 2 // This is the amount the point must move 287 | val xTranslation = translationHypotenuse * sin(Math.toRadians((abs(90 - dashAngle).toDouble()))) 288 | val yTranslation = translationHypotenuse * cos(Math.toRadians((abs(90 - dashAngle).toDouble()))) 289 | 290 | return initialPositions.map { 291 | DashInfo( 292 | Pair( 293 | it.startPoint.first + calculateModifiedXTranslation(xTranslation, dashAngle, false), 294 | it.startPoint.second + yTranslation.toFloat() 295 | ), 296 | Pair( 297 | it.endPoint.first + calculateModifiedXTranslation(xTranslation, dashAngle, true), 298 | it.endPoint.second - yTranslation.toFloat() 299 | ) 300 | ) 301 | } 302 | } 303 | 304 | /** 305 | * Elongate dashes enough so that all 4 corners of each dash are extended out of the view 306 | * canvas. This ensures the corners of the dashes/lines are not visible. This is more important 307 | * when dashes get thicker and resemble rectangles instead of dashes/lines. 308 | * 309 | * Affects Dashes that originate from the Y axis. 310 | */ 311 | private fun elongateDashesOriginatingFromYAxis( 312 | initialPositions: List, 313 | dashAngle: Int, 314 | dashWidth: Float 315 | ): List { 316 | val hypotenuseRadians = Math.toRadians(dashAngle.toDouble()) 317 | val translationHypotenuse = (dashWidth * tan(hypotenuseRadians)) / 2 // This is the amount the point must move 318 | val xTranslation = abs(translationHypotenuse * cos(hypotenuseRadians)).toFloat() 319 | val yTranslation = abs(translationHypotenuse * sin(hypotenuseRadians)).toFloat() 320 | 321 | // Depending on the direction of dashes the translation value needs to be negative 322 | val xTranslationModifier = when (getDashDirection(dashAngle)) { 323 | is DashDirection.LeftToRight -> -1 324 | is DashDirection.RightToLeft -> 1 325 | DashDirection.Vertical -> 0 326 | } 327 | 328 | return initialPositions.map { 329 | DashInfo( 330 | Pair( 331 | it.startPoint.first + (xTranslation * xTranslationModifier), 332 | it.startPoint.second + yTranslation 333 | ), 334 | it.endPoint // End point can remain unchanged for dashes drawn from Y Axis. Their top corners wont show 335 | ) 336 | } 337 | } 338 | 339 | /** 340 | * Generates the endpoint for a given start point based on the provided constraints. 341 | */ 342 | private fun generateEndPoint( 343 | startPoint: Pair, 344 | dashAngle: Int, 345 | endPointXTranslation: Float, 346 | endPointYValue: Float, 347 | viewWidth: Float 348 | ): Pair { 349 | return if (getDashDirection(dashAngle).isHorizontal) 350 | Pair(viewWidth, startPoint.second) 351 | else 352 | Pair(startPoint.first + endPointXTranslation, endPointYValue) 353 | } 354 | 355 | override fun onSizeChanged(w: Int, h: Int, oldw: Int, oldh: Int) { 356 | lastWidth = w 357 | lastHeight = h 358 | } 359 | 360 | fun setDashColorGenerator(newDashColorGenerator: DashColorGenerator) { 361 | dashColorGenerator = newDashColorGenerator 362 | } 363 | } --------------------------------------------------------------------------------