> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/image-transformations/operations/slice-image.md).

# Slice Image

Ce bloc fonctionnel découpe une image d'entrée en une grille de sous-images plus petites. Utilisez-le pour diviser de grandes images en tuiles pour une analyse individuelle, un traitement parallèle ou pour générer des galeries d'images.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

`Image Any` - Image principale à découper.

`Horizontal Percentage` - Nombre de découpes horizontales (colonnes). Si vide, la valeur par défaut est 1.

`Vertical Percentage` - Nombre de découpes verticales (lignes). Si vide, la valeur par défaut est 1.

## 📤 Sorties <a href="#outputs" id="outputs"></a>

`Image Any` - L'image principale avec des indices visuels optionnels (identique à l'entrée ou version annotée).

`Sliced Images` - Liste des sous-images générées (chaque tuile de la grille).

`Sliced Coordinates` - Liste des coordonnées des rectangles pour chaque découpe (utile pour remapper les résultats vers l'image d'origine).

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

Ce bloc utilise les entrées ci-dessus comme paramètres ajustables. Fournissez des valeurs pour `Horizontal Percentage` et `Vertical Percentage` afin de contrôler la disposition de la grille.

## ⚙️ Mécanisme d'exécution <a href="#running-mechanism" id="running-mechanism"></a>

* Lors de l'évaluation, le bloc lit l'`Image Any` fournie et les deux entrées de nombre de découpes.
* Il divise l'image en une grille en utilisant le nombre spécifié de colonnes et de lignes.
* Le bloc produit en sortie l'image complète, une liste des images de chaque tuile (dans l'ordre de lecture) et les coordonnées de chaque découpe pour pouvoir relier les détections à l'image d'origine.

## ✨ Fonctionnalités <a href="#features" id="features"></a>

* Découpage en grille simple sans besoin de recadrage manuel.
* Retourne à la fois les images découpées et leurs coordonnées pour un traitement ultérieur.
* Fonctionne avec n'importe quelle taille d'image ; les découpes sont calculées pour couvrir uniformément la surface de l'image.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Connectez un producteur d'images (caméra, chargeur de fichier, etc.) à `Image Any`.
2. Définissez le nombre souhaité de colonnes via `Horizontal Percentage`.
3. Définissez le nombre souhaité de lignes via `Vertical Percentage`.
4. Exécutez le scénario : le bloc fournira les images en tuiles et leurs coordonnées pour un traitement ultérieur.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Combinez avec `Show Image` pour prévisualiser rapidement des tuiles individuelles en connectant un élément de `Sliced Images` à un flux d'affichage.
* Utilisez `Image Resize` ou `Image Resizer` avant le découpage si vous avez besoin de tuiles de taille uniforme ou si vous souhaitez réduire le temps de traitement.
* Injectez chaque tuile dans des blocs de détection tels que `Find Object`, `Object Detection` ou `Mask Detection` pour effectuer une analyse par tuile, puis utilisez `Sliced Coordinates` pour remapper les résultats vers l'image d'origine.
* Après le traitement par tuile, utilisez `Collage Images` ou `Image Concatenate` pour créer un résumé visuel unique à partir des tuiles traitées.
* Pour enregistrer les résultats par tuile, connectez `Sliced Images` à `Image Logger` ou `Multi Image Write` pour une exportation organisée.

(astuce) Si vous avez seulement besoin d'une région unique plutôt que d'une grille, envisagez d'utiliser `Image ROI Select` ou `Image ROI` avant le découpage pour limiter la zone.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si les tuiles semblent étirées ou inattendues, essayez d'ajouter un `Image Resize` avant le bloc pour imposer des dimensions source cohérentes.
* Si vous recevez moins de tuiles que prévu, vérifiez que `Horizontal Percentage` et `Vertical Percentage` sont définis sur des entiers supérieurs à 0.
* Si les détecteurs en aval manquent des objets aux bordures des tuiles, ajoutez un petit chevauchement en redimensionnant ou en pré-recadrant avec `Image ROI` puis en découpant, de façon à ce que les objets traversant une frontière soient capturés dans au moins une tuile.