{"id":22763071,"url":"https://github.com/andyb129/chompprogressview","last_synced_at":"2025-04-14T21:52:29.201Z","repository":{"id":57743561,"uuid":"66594804","full_name":"andyb129/ChompProgressView","owner":"andyb129","description":"A (semi) realistic chomping progress view that takes bites out of your delicious images! Nom! Nom!","archived":false,"fork":false,"pushed_at":"2018-03-14T21:01:25.000Z","size":2091,"stargazers_count":73,"open_issues_count":1,"forks_count":12,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-28T10:01:41.384Z","etag":null,"topics":["android","bite","chomp","loading-animations","pizza","progress-bar"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andyb129.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-25T21:32:12.000Z","updated_at":"2023-02-24T15:45:13.000Z","dependencies_parsed_at":"2022-08-26T01:50:17.785Z","dependency_job_id":null,"html_url":"https://github.com/andyb129/ChompProgressView","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyb129%2FChompProgressView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyb129%2FChompProgressView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyb129%2FChompProgressView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyb129%2FChompProgressView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andyb129","download_url":"https://codeload.github.com/andyb129/ChompProgressView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248968751,"owners_count":21191158,"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":["android","bite","chomp","loading-animations","pizza","progress-bar"],"created_at":"2024-12-11T11:06:43.800Z","updated_at":"2025-04-14T21:52:29.181Z","avatar_url":"https://github.com/andyb129.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chomp Progress View \n\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-ChompProgressView-green.svg?style=true)](https://android-arsenal.com/details/1/4249)\n\u003cbr\u003e\u003ca href=\"http://www.methodscount.com/?lib=uk.co.barbuzz%3Achompprogressview%3A0.0.2\"\u003e\u003cimg src=\"https://img.shields.io/badge/Methods and size-81 | 10 KB-e91e63.svg\"/\u003e\u003c/a\u003e\n\nA (semi) realistic chomping progress view that takes bites out of your delicious images! Nom! Nom!\n\n* Increment progress.\n* Change bite size.\n* Select a bite direction or just take random(ish) bites.  \n* (semi) realistic bites taken from images set in the view (use an image with a transparent background for best effect)\n\n\u003cp\u003e\n\u003ca href=\"https://play.google.com/store/apps/details?id=uk.co.barbuzz.chompprogressview.sample\"\u003e\u003cimg src=\"https://github.com/andyb129/ChompProgressView/blob/master/screenshots%2Fgoogle_play_badge.png\" height=\"80\" width=\"210\" alt=\"ChompProgressView\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp\u003e\n\u003cimg src=\"https://github.com/andyb129/ChompProgressView/blob/master/screenshots%2Fchomp_progress_anim.gif\" height=\"600\" alt=\"ChompProgressView\"/\u003e\n\u003c/p\u003e\n  \n\u003c!--![optional caption text](screenshots/chomp_progress_anim.gif)--\u003e\n\n### Setup\nTo use **ChompProgressView** in your projects, simply add the library as a dependency to your build.\n\n##### Gradle\n```\ndependencies {\n  compile 'uk.co.barbuzz:chompprogressview:0.0.2'\n}\n```\n\n##### Maven\n```\n\u003cdependency\u003e\n  \u003cgroupId\u003euk.co.barbuzz.chompprogressview\u003c/groupId\u003e\n  \u003cartifactId\u003echompprogressview\u003c/artifactId\u003e\n  \u003cversion\u003e0.0.2\u003c/version\u003e\n  \u003ctype\u003epom\u003c/type\u003e\n\u003c/dependency\u003e\n```\n\nAlternatively you can directly import the /library project into your Android Studio project and add it as a dependency in your build.gradle.\n\nThe library is currently configured to be built via Gradle only. It doesn't have any dependencies. :-)\n\n* Compiled SDK Version      - Oreo-27\n* Minimum SDK Version       - \u003e= Lollipop-14\n\n### Usage\nFor more detailed code example to use the library, Please refer to the `/sample` app.\n\n`ChompProgressView` can be added as a custom view to any layout.\n\n```\n\u003cuk.co.barbuzz.chompprogressview.ChompProgressView\n        android:id=\"@+id/chompProgressView\"\n        android:layout_width=\"match_parent\"\n        android:layout_height=\"match_parent\"\n        android:src=\"@drawable/pizza\"\n        app:biteRadius=\"200dp\"\n        app:chompProgress=\"0\"\n        app:chompMax=\"100\"\n        app:chompDirection=\"top\"/\u003e\n```\n\nYou can then either set the xml parameters to configure the view or do it programmatically as follows.\n```\nChompProgressView chompProgressView = (ChompProgressView) findViewById(R.id.chompProgressView);\n\nchompProgressView.setImageDrawableChomp(mPizzaDrawble)\nchompProgressView.setBiteRadius(400);\nchompProgressView.setChompMax(100);\nchompProgressView.setChompProgress(0);\n```\n**Remember to use the ```setImageDrawableChomp(Drawable)``` method instead of ```setImageDrawable(Drawable)``` as this stores the orginal drawable and calculates some bite information.**\n\nThe chomp direction can be changed between random bites and a specified direction as shown in the example below (```RANDOM``` is the default). This can also be set in the view attributes xml (see above).\n```\nmChompProgressImageView.setChompDirection(ChompProgressImageView.ChompDirection.TOP);\n```\n\nBite radius can be set (400 is the default) in code as follows or in the view attributes xml (see above).\n```\nmChompProgressImageView.setBiteRadius(400);\n```\n\nYou can also reset the image and progress/bites taken by calling the following method.\n```\nchompProgressView.removeBites();\n```\n\n### TODO\n1. Improve the overall drawing of the bite\n2. Make the takeBite() method of ChompProgressImageView more flexible with bite direction config\n\n### Thanks\n\nThis library was made after a conversation while eating free pizza at the great \u003ca href=\"https://www.meetup.com/swmobile/\"\u003eSW Mobile Meetup\u003c/a\u003e in Bristol UK.  Thanks for all the pizza inspiration! \n\nAlso thanks to the \u003ca href=\"https://thenounproject.com\"\u003enoun project\u003c/a\u003e for providing the pizza and lolly icons (Imogen Oh \u0026 Kristin McPeak respectively)\n\n### Licence\n```\nCopyright (c) 2016 Andy Barber\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n  http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandyb129%2Fchompprogressview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandyb129%2Fchompprogressview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandyb129%2Fchompprogressview/lists"}