{"id":21130228,"url":"https://github.com/neild001/SeekArc","last_synced_at":"2025-07-09T01:32:49.115Z","repository":{"id":11637207,"uuid":"14140189","full_name":"neild001/SeekArc","owner":"neild001","description":"Circular SeekBar view for Android","archived":false,"fork":false,"pushed_at":"2019-09-08T18:44:16.000Z","size":1151,"stargazers_count":892,"open_issues_count":50,"forks_count":296,"subscribers_count":39,"default_branch":"master","last_synced_at":"2025-01-14T05:05:05.357Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/neild001.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-05T11:56:15.000Z","updated_at":"2024-12-09T13:50:22.000Z","dependencies_parsed_at":"2022-09-06T03:02:02.036Z","dependency_job_id":null,"html_url":"https://github.com/neild001/SeekArc","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/neild001/SeekArc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neild001%2FSeekArc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neild001%2FSeekArc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neild001%2FSeekArc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neild001%2FSeekArc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/neild001","download_url":"https://codeload.github.com/neild001/SeekArc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neild001%2FSeekArc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264375448,"owners_count":23598376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T05:32:26.746Z","updated_at":"2025-07-09T01:32:48.779Z","avatar_url":"https://github.com/neild001.png","language":"Java","funding_links":[],"categories":["Libs"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"readme":"SeekArc\n=======\n\n# What is a SeekArc?\n\nSo what the heck is a SeekArc? Essentially it’s a SeekBar that has been wrapped around a circle. It acts like a SeekBar and generally has the same settings. You can even add a Listener to it as you would with a SeekBar. So if its in a circle why not call it a SeekCircle? The answer is that the SeekArc does have a few more setting than the SeekBar one of these is the sweepAngle, which means that the SeekArc doesn’t have to be drawn as a full circle, and can be drawn as a circle, semi-circle  or quarter arc or whatever you like. Supports min SDK 8. \n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg height=\"200px\" src=\"raw/arc_sweeps.png\"/\u003e\n\u003c/div\u003e\n\n[Video demo of the sample project](http://www.youtube.com/watch?v=MefE7mjM94M)\n\n# Using the SeekArc\n\nUsing the SeekArc is straightforward. There are a number of settings from sweep angle to rotation that can be set. One of the less obvious settings is the radius or diameter of the SeekArc. When I developed the SeekArc I thought about adding an attribute for defining the diameter of the circle. In the end I decided against this. I thought a more flexible approach would be to allow the SeekArc to expand to the size of  its container layout. This way the SeekArc can grow in size with a layout that has widths or heights of match parent. Also it is still possible to set the SeekArc to a specific size by setting the container layouts width and height to specific dp values. This sizing approach gives the best of both worlds. To further adjust how the arc fits in its container a padding attribute can also be used.\n\nTo help with understanding how to use the SeeekArc I’ve put together a sample app with a number of controls that can be used to adjust the attributes of the SeekArc. This is by far the best way to get a good understanding of how to use the SeekArc. From the sample app you’ll see that it is possible to set attributes such as:\n\n* Sweep angle\n* Rotation\n* Clockwise (which way do you want the progress to increase clockwise/anticlockwise),\n* Arc and progress width\n* Rounded corners \n* Touch inside enable/disable.\n* Enabled - enables/disables touch and the thumbnail \n\n\n## To use it in your code\n\nSimply add the View to your layout (There are several custom attributes) \n\n        \u003ccom.triggertrap.seekarc.SeekArc\n            android:id=\"@+id/seekArc\"\n            android:layout_width=\"match_parent\"\n            android:layout_height=\"wrap_content\"\n            android:layout_gravity=\"center\"\n            android:padding=\"30dp\"\n            seekarc:rotation=\"180\"\n            seekarc:startAngle=\"30\"\n            seekarc:sweepAngle=\"300\"\n            seekarc:touchInside=\"true\" /\u003e\n            \n            \n## Adding to your project\n\nThis library is not yet released in Maven Central, until then you can add as a library module or use JitPack.io. \n\nAdd remote maven url\n\n```groovy\n    repositories {\n        maven {\n            url \"https://jitpack.io\"\n        }\n    }\n```\n    \nNow add a library dependency (remember to check for latest release)\n\n```groovy\n    dependencies {\n        compile 'com.github.Triggertrap:SeekArc:v1.1'\n    }\n```\n\n\n\n#Recent changes \n\n## Version 1.1\nAfter a long hiatus we've recently integrated many of the PRs/changes submitted by others so a big thanks for all the contributions. We'll endevour to respond to PRs and updates quicker in future. The following changes have been included in v1.1.\n \n* converted to gradle\n* latest Android SDK/tools   \n* removed dependency on color that holo blue that caused issues on API \u003c 14. \n* changes to make compatible with scroll view changes including example in sample app\n* added 'enabled' option that if set to false disables touch and visibility of the thumbnail  \n* set color progress and arc programmatically\n* mProgress typo\n* fixed setting progress via xml \n* sample updates to show some of the new functionality\n* readme and jitpack.io notes\n\n## Version 1.0\n\n* init release\n\n# Sample Project\n\nYou can see the SeekArc working in the sample application. Just check out the library and sample application as two separate projects and import them into eclipse. Make sure that the Sample app is setup to correctly use the library project. The sample app will let you explore the attributes that can be set on the SeekArc. \n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg height=\"400px\" src=\"raw/sample_app.png\"/\u003e\n\u003c/div\u003e\n\n\n# License\n\n```\n\nThe MIT License (MIT)\n\nCopyright (c) 2013 Triggertrap Ltd\nAuthor Neil Davies \n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneild001%2FSeekArc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneild001%2FSeekArc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneild001%2FSeekArc/lists"}