diff --git a/README.es-ES.md b/README.es-ES.md new file mode 100644 index 0000000..916bc02 --- /dev/null +++ b/README.es-ES.md @@ -0,0 +1,119 @@ + + +# Chomp Progress View + +[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-ChompProgressView-green.svg?style=true)](https://android-arsenal.com/details/1/4249) +
+ +Una vista de progreso de masticación (semi)realista que le da mordiscos a tus deliciosas imágenes. ¡Ñam! ¡Ñam! + +* Incrementar el progreso. +* Cambiar el tamaño del mordisco. +* Seleccionar una dirección de mordisco o simplemente tomar mordiscos aleatorios. +* Mordiscos (semi)realistas aplicados a las imágenes configuradas en la vista (usa una imagen con fondo transparente para obtener el mejor efecto) + +

+ChompProgressView +

+

+ChompProgressView +

+ + + +### Configuración +Para utilizar **ChompProgressView** en tus proyectos, simplemente agrega la biblioteca como una dependencia en tu build. + +##### Gradle +``` +dependencies { + compile 'uk.co.barbuzz:chompprogressview:0.0.2' +} +``` + +##### Maven +``` + + uk.co.barbuzz.chompprogressview + chompprogressview + 0.0.2 + pom + +``` + +Como alternativa, puedes importar directamente el proyecto /library a tu proyecto de Android Studio y agregarlo como dependencia en tu build.gradle. + +La biblioteca está configurada actualmente para compilarse solo a través de Gradle. No tiene dependencias. :-) + +* Versión de SDK compilada - Oreo-27 +* Versión mínima de SDK - >= Lollipop-14 + +### Uso +Para ver un ejemplo de código más detallado sobre el uso de la biblioteca, consulta la aplicación `/sample`. + +`ChompProgressView` se puede agregar como una vista personalizada a cualquier diseño. + +``` + +``` + +Luego, puedes establecer los parámetros xml para configurar la vista o hacerlo programáticamente de la siguiente manera. +``` +ChompProgressView chompProgressView = (ChompProgressView) findViewById(R.id.chompProgressView); + +chompProgressView.setImageDrawableChomp(mPizzaDrawble) +chompProgressView.setBiteRadius(400); +chompProgressView.setChompMax(100); +chompProgressView.setChompProgress(0); +``` +**Recuerda utilizar el método ```setImageDrawableChomp(Drawable)``` en lugar de ```setImageDrawable(Drawable)``` ya que este almacena el drawable original y calcula cierta información sobre los mordiscos.** + +La dirección de mordisco se puede cambiar entre mordiscos aleatorios y una dirección específica, como se muestra en el ejemplo a continuación (```RANDOM``` es el valor predeterminado). Esto también se puede configurar en los atributos xml de la vista (ver arriba). +``` +mChompProgressImageView.setChompDirection(ChompProgressImageView.ChompDirection.TOP); +``` + +El radio del mordisco se puede establecer (400 es el valor predeterminado) en el código de la siguiente manera o en los atributos xml de la vista (ver arriba). +``` +mChompProgressImageView.setBiteRadius(400); +``` + +También puedes restablecer la imagen y el progreso/mordiscos realizados llamando al siguiente método. +``` +chompProgressView.removeBites(); +``` + +### TODO +1. Mejorar el dibujo general del mordisco +2. Hacer que el método takeBite() de ChompProgressImageView sea más flexible con la configuración de dirección de mordisco + +### Agradecimientos + +Esta biblioteca se creó tras una conversación mientras comíamos pizza gratis en el gran SW Mobile Meetup en Bristol, Reino Unido. ¡Gracias por toda la inspiración de pizza! + +También gracias al noun project por proporcionar los iconos de pizza y piruleta (Imogen Oh y Kristin McPeak, respectivamente) + +### Licencia +``` +Derechos de autor (c) 2016 Andy Barber + +Licenciado bajo la Licencia Apache, Versión 2.0 (la "Licencia"); +no podrá utilizar este archivo excepto en cumplimiento con la Licencia. +Puede obtener una copia de la Licencia en + + http://www.apache.org/licenses/LICENSE-2.0 + +Salvo que lo exija la ley aplicable o se acuerde por escrito, el software +distribuido bajo la Licencia se distribuye en una base "TAL CUAL", +SIN GARANTÍAS O CONDICIONES DE NINGÚN TIPO, ya sean expresadas o implícitas. +Consulte la Licencia para conocer el lenguaje específico que rige los permisos y +limitaciones de la Licencia. +```