harjot-oberai/Croller

A circular seekbar for Android, with a control knob! (for the lack of a better word).

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.harjot-oberai:Croller:1.0.0'
	}

	dependencies {
		implementation("com.github.harjot-oberai:Croller:1.0.0")
	}

	<dependency>
	    <groupId>com.github.harjot-oberai</groupId>
	    <artifactId>Croller</artifactId>
	    <version>1.0.0</version>
	</dependency>


                            
    libraryDependencies += "com.github.harjot-oberai" % "Croller" % "1.0.0"


                            
    :dependencies [[com.github.harjot-oberai/Croller "1.0.0"]]

Readme

Usage

Just add the following dependency in your app's build.gradle

dependencies {
      compile 'com.sdsmdg.harjot:croller:1.0.7'
}

XML

<com.sdsmdg.harjot.crollerTest.Croller
        android:id="@+id/croller"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_centerInParent="true"
        app:back_circle_color="#EDEDED"
        app:indicator_color="#0B3C49"
        app:indicator_width="10"
        app:is_continuous="true"
        app:label_color="#000000"
        app:main_circle_color="#FFFFFF"
        app:max="1000"
        app:progress_primary_color="#0B3C49"
        app:progress_secondary_color="#EEEEEE"
        app:start_offset="45" />

Java

Croller croller = (Croller) findViewById(R.id.croller);
        croller.setIndicatorWidth(10);
        croller.setBackCircleColor(Color.parseColor("#EDEDED"));
        croller.setMainCircleColor(Color.WHITE);
        croller.setMax(50);
        croller.setStartOffset(45);
        croller.setIsContinuous(false);
        croller.setLabelColor(Color.BLACK);
        croller.setProgressPrimaryColor(Color.parseColor("#0B3C49"));
        croller.setIndicatorColor(Color.parseColor("#0B3C49"));
        croller.setProgressSecondaryColor(Color.parseColor("#EEEEEE"));

Listeners

Progress Change Listener (if you only want to use the progress)

Croller croller = (Croller) findViewById(R.id.croller);
        croller.setOnProgressChangedListener(new Croller.onProgressChangedListener() {
            @Override
            public void onProgressChanged(int progress) {
                // use the progress
            }
        });

Croller Change Listener (if want start and stop tracking as well, similar to seekbar)

Croller croller.setOnCrollerChangeListener(new OnCrollerChangeListener() {
            @Override
            public void onProgressChanged(Croller croller, int progress) {
            	// use the progress
            }

            @Override
            public void onStartTrackingTouch(Croller croller) {
                // tracking started
            }

            @Override
            public void onStopTrackingTouch(Croller croller) {
            	// tracking stopped
            }
        });

Attributes

XML Attribute | Java set method | Functionality ------------ | ------------- | ------------- anticlockwise | setAntiClockwise(boolean anticlockwise) | Set the direction of rotation progress | setProgress(int progress) | Set the current progress of the seekbar label | setLabel(String str) | Set the label label_size | setLabelSize(int size) | Set the label size label_color | setLabelColor(int color) | Set the label color is_continuous | setIsContinuous(boolean bool) | Set whether seekbar is conitnuous or discrete max | setMax(int max) | Set the maximum value of the seekbar min | setMin(int min) | Set the minimum value of the seekbar (Default is 1) start_offset | setStartOffset(int offset) | Set the seekbar start offset angle from bottom horizontal center sweep_angle | setSweepAngle(int angle) | Set the total angle covered by the seekbar progress_primary_stroke_width | setProgressPrimaryStrokeWidth(float width) | Set the primary progress thickness for continuous type progress_secondary_stroke_width | setProgressSecondaryStrokeWidth(float width) | Set the secondary progress thickness for continuous type progress_primary_circle_size | setProgressPrimaryCircleSize(float size) | Set the primary progress circle size for discrete type progress_secondary_circle_size | setProgressSecondaryCircleSize(float size) | Set the secondary progress circle size for discrete type indicator_width | setIndicatorWidth(float width) | Set the progress indicator width indicator_color | setIndicatorColor(int color) | Set the progress indicator color progress_primary_color | setProgressPrimaryColor(int color) | Set the progress primary(active) color progress_secondary_color | setProgressSecondaryColor(int color) | Set the progress secondary(inactive) color progress_radius | setProgressRadius(float radius) | Set the radius of the progress arc main_circle_radius | setMainCircleRadius(float radius) | Set the main(front) circle radius back_circle_radius | setBackCircleRadius(float radius) | Set the back circle radius main_circle_color | setMainCircleColor(int color) | Set the main(front) circle color back_circle_color | setBackCircleColor(int color) | Set the back circle color

Examples

`is_continuous = false`

`is_continuous = true`

License

Croller is licensed under MIT license. View license.