> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runanywhere.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Segmentation

> Find and label regions in an image

Segmentation outlines objects in an image and labels them. Where a
[vision model](/kotlin/vlm) describes a picture in words, segmentation gives you the regions
themselves: a mask per object, with a class and a confidence.

```kotlin theme={null}
val result = RunAnywhere.segmentation.segment(
    ImageInput.bitmap(bitmap),
    SegmentationOptions(includeDiagnosticImage = true)
)
```

## Building the input

```kotlin theme={null}
ImageInput.bitmap(bitmap)      // the Android-native path
ImageInput.file(path)
ImageInput.bytes(data)
ImageInput.rawRgb(data, width, height)
```

## Options

| Field                    | Default | Meaning                                         |
| ------------------------ | ------- | ----------------------------------------------- |
| `includeDiagnosticImage` | `false` | Return a rendered overlay alongside the regions |

Turn the diagnostic image on while you are building the feature: it shows you what the model
actually found, which is much faster than reasoning about mask arrays. Turn it off in
production, since rendering it costs time and memory.

## What comes back

A `SegmentationResult` holds the regions found. Each carries its class label, a confidence,
and the mask itself, so you can draw an outline, crop to the object, or count instances.

## Segmentation or a vision model

| You want                            | Use                |
| ----------------------------------- | ------------------ |
| A sentence about the picture        | [VLM](/kotlin/vlm) |
| "Is there a dog in this"            | VLM                |
| The exact pixels of the dog         | Segmentation       |
| Object counts, or a crop            | Segmentation       |
| Anything you will draw on the image | Segmentation       |

## Availability

Segmentation needs a registered segmentation model and a backend that serves it. The namespace
existing does not mean the catalog has an entry, so check capabilities before putting it in
front of a user.