cropiwa

CultureIwa

La bibliothèque est un widget hautement configurable pour le recadrage d'images.

Graduation

Ajoutez ceci dans votre bloc de dépendances.

 compile 'com.steelkiwi:cropiwa:1.0.3'

Échantillon

Veuillez consulter l'exemple d'application pour des exemples d'utilisation de la bibliothèque.

Wiki

La bibliothèque a une architecture modulaire, ce qui la rend hautement configurable. Pour plus d'informations sur la configuration CropIwaView reportez-vous aux sections ci-dessous.

L'une des fonctionnalités utiles est que vous n'avez pas besoin d'attendre un résultat : une fois la demande de recadrage effectuée, passez simplement à un autre écran et attendez le résultat sous forme de diffusion.

Usage:

Ajoutez CropIwa à votre XML :

< com .steelkiwi.cropiwa.CropIwaView
  android : id = " @+id/crop_view "
  android : layout_width = " match_parent "
  android : layout_height = " match_parent " />

Sauvegarde d'images

 cropView . crop ( new CropIwaSaveConfig . Builder ( destinationUri )
  . setCompressFormat ( Bitmap . CompressFormat . PNG )
  . setSize ( outWidth , outHeight ) //Optional. If not specified, SRC dimensions will be used
  . setQuality ( 100 ) //Hint for lossy compression formats
  . build ());

Rappels

Rappel enregistré dans la région recadrée. Une fois la demande de recadrage terminée, une diffusion est envoyée. Vous pouvez soit l'écouter en utilisant l'instance CropIwaView

 cropView . setCropSaveCompleteListener ( bitmapUri -> {
  //Do something
});

cropView . setErrorListener ( error -> {
  //Do something
});

ou travaillez directement avec un récepteur de diffusion. L'avantage est qu'il peut être utilisé depuis n'importe quelle partie de l'application, où vous avez accès à Context .

 CropIwaResultReceiver resultReceiver = new CropIwaResultReceiver ();
resultReceiver . setListener ( resultListener );
resultReceiver . register ( context );

//Don't forget to unregister it when you are done
resultReceiver . unregister ( context );

Vous pouvez vous abonner aux modifications apportées aux configurations de CropIwaView . Les auditeurs seront avertis à chaque fois que .apply() est appelé.

 cropIwaView . configureOverlay (). addConfigChangeListener ( listener );
cropIwaView . configureImage (). addConfigChangeListener ( listener )

Configuration de la vue de base

• Permettre à l’utilisateur de redimensionner une zone de recadrage. La valeur par défaut est vraie.

 app : ci_dynamic_aspect_ratio = "true|false"

cropView . configureOverlay ()
  . setDynamicCrop ( enabled )
  . apply ();

• Dessinez une grille 3x3. La valeur par défaut est vraie.

 app : ci_draw_grid = "true|false"

cropView . configureOverlay ()
  . setShouldDrawGrid ( draw )
  . apply ();

• Définissez le rapport hauteur/largeur d’une zone de recadrage initiale.

 app : ci_aspect_ratio_w = "16"
app : ci_aspect_ratio_h = "9"

cropView . configureOverlay ()
  . setAspectRatio ( new AspectRatio ( 16 , 9 ))
  . setAspectRatio ( AspectRatio . IMG_SRC ) //If you want crop area to be equal to the dimensions of an image
  . apply ();

• Position initiale de l'image. Le comportement est similaire à celui du scaleType d'ImageView.

 app : ci_initial_position = "centerCrop|centerInside"

cropView . configureImage ()
  . setImageInitialPosition ( position )
  . apply ();

• Définir l'échelle actuelle de l'image.

 //Value is a float from 0.01f to 1
cropIwaView . configureImage ()
  . setScale ( scale )
  . apply ();

• Activez le geste de pincement pour redimensionner une image.

 app : ci_scale_enabled = "true|false"

cropView . configureImage ()
  . setImageScaleEnabled ( enabled )
  . apply ();

• Activez le glisser du doigt pour traduire une image.

 app : ci_translation_enabled = "true|false"

cropView . configureImage ()
  . setImageTranslationEnabled ( enabled )
  . apply ();

• Choisir parmi les formes de zone de recadrage par défaut. La valeur par défaut est le rectangle.

 app : ci_crop_shape = "rectangle|oval"

cropView . configureOverlay ()
  . setCropShape ( new CropIwaRectShape ( cropView . configureOverlay ()))
  . setCropShape ( new CropIwaOvalShape ( cropView . configureOverlay ()))
  . apply ();

• Vous pouvez définir une échelle min-max. Le minimum par défaut est 0,7, le maximum par défaut est 3.

 app : ci_max_scale = "1f"

cropView . configureImage ()
  . setMinScale ( minScale )
  . setMaxScale ( maxScale )
  . apply ();

• Taille minimale de la zone de recadrage.

 app : ci_min_crop_width = "40dp"
app : ci_min_crop_height = "40dp"

cropView . configureOverlay ()
  . setMinWidth ( dps )
  . setMinHeight ( dps )
  . apply ();

• Dimensions.

 app : ci_border_width = "1dp"
app : ci_corner_width = "1dp"
app : ci_grid_width = "1dp"

cropView . configureOverlay ()
  . setBorderStrokeWidth ( dps )
  . setCornerStrokeWidth ( dps )
  . setGridStrokeWidth ( dps )
  . apply ();

• Couleurs.

 app : ci_border_color = "#fff"
app : ci_corner_color = "#fff"
app : ci_grid_color = "#fff"
app : ci_overlay_color = "#fff"

cropView . configureOverlay ()
  . setBorderColor ( Color . WHITE )
  . setCornerColor ( Color . WHITE )
  . setGridColor ( Color . WHITE )
  . setOverlayColor ( Color . WHITE )
  . apply ();

Configuration de la vue avancée

Vous pouvez travailler directement avec des objets Paint . Cela vous donne la possibilité, par exemple, de dessiner une grille avec un effet pointillé.

 Paint gridPaint = cropView . configureOverlay ()
  . getCropShape ()
  . getGridPaint ();
gridPaint . setPathEffect ( new DashPathEffect ( new float [] { interval , interval }, 0 ));

Vous pouvez obtenir d’autres Paint de la même manière.

 CropIwaOverlayConfig config = cropView . configureOverlay ();
CropIwaShape shape = config . getCropShape ();
shape . getGridPaint ();
shape . getBorderPaint ();
shape . getCornerPaint ();

Vous pouvez également créer des formes de zone de recadrage personnalisées. Étendez simplement CropIwaShape (pour un exemple, reportez-vous à CropIwaOvalShape) et définissez une instance de votre classe en utilisant :

 cropView . configureOverlay ()
  . setCropShape ( new MyAwesomeShape ())
  . apply ();

Licence

 Copyright © 2017 SteelKiwi, http://steelkiwi.com

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.