# DrawImageBgra8RegionFiltered

Provider-selected sampling is an explicit fast path. Callers retain the deterministic prepared-image path whenever the current provider does not advertise the requested execution mode.

Last updated: 2026-09-09

Package: graphics.canvas | Status: source-declared

Tags: canvas, cpu, function, graphics, graphics.canvas, source-example, yeho

Draw 2D shapes, text, images, and composited interface content.

```yh
external DrawImageBgra8RegionFiltered(text resourceId, int generation, text contentIdentity, text payloadHex, int sourceWidth, int sourceHeight, int cropX, int cropY, int cropWidth, int cropHeight, int x, int y, int width, int height, int red, int green, int blue, int alpha, text filter) returns bool
```


## Use DrawImageBgra8RegionFiltered

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

Verification: type checked

```yh
using graphics.canvas

// Draw 2D shapes, text, images, and composited interface content.
text resourceId = "resource Id"
int generation = 1
text contentIdentity = "sample"
text payloadHex = "payload Hex"
int sourceWidth = 1
int sourceHeight = 1
int cropX = 1
int cropY = 1
int cropWidth = 1
int cropHeight = 1
int x = 1
int y = 1
int width = 1
int height = 1
int red = 1
int green = 1
int blue = 1
int alpha = 1
text filter = "filter"
bool result = DrawImageBgra8RegionFiltered(resourceId, generation, contentIdentity, payloadHex, sourceWidth, sourceHeight, cropX, cropY, cropWidth, cropHeight, x, y, width, height, red, green, blue, alpha, filter)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_canvas__drawimagebgra8regionfiltered"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.canvas"
version = "0.1.0"
path = "../../../yeho/packages/graphics/canvas"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/graphics.canvas--DrawImageBgra8RegionFiltered/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

Source: yeho/packages/graphics/canvas/canvas.yh

AI training permission: https://demonhunterlabs.com/ai-use