Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
119 changes: 119 additions & 0 deletions README.es-ES.md
Original file line number Diff line number Diff line change
@@ -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)
<br><a href="http://www.methodscount.com/?lib=uk.co.barbuzz%3Achompprogressview%3A0.0.2"><img src="https://img.shields.io/badge/Methods and size-81 | 10 KB-e91e63.svg"/></a>

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)

<p>
<a href="https://play.google.com/store/apps/details?id=uk.co.barbuzz.chompprogressview.sample"><img src="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/andyb129/ChompProgressView/blob/master/screenshots%2Fgoogle_play_badge.png" height="80" width="210" alt="ChompProgressView"/></a>
</p>
<p>
<img src="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/andyb129/ChompProgressView/blob/master/screenshots%2Fchomp_progress_anim.gif" height="600" alt="ChompProgressView"/>
</p>

<!--![optional caption text](screenshots/chomp_progress_anim.gif)-->

### 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
```
<dependency>
<groupId>uk.co.barbuzz.chompprogressview</groupId>
<artifactId>chompprogressview</artifactId>
<version>0.0.2</version>
<type>pom</type>
</dependency>
```

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.

```
<uk.co.barbuzz.chompprogressview.ChompProgressView
android:id="@+id/chompProgressView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:src="@drawable/pizza"
app:biteRadius="200dp"
app:chompProgress="0"
app:chompMax="100"
app:chompDirection="top"/>
```

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 <a href="https://www.meetup.com/swmobile/">SW Mobile Meetup</a> en Bristol, Reino Unido. ¡Gracias por toda la inspiración de pizza!

También gracias al <a href="https://thenounproject.com">noun project</a> 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.
```