| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
GMImage.FindColorInRow
Locates first pixel in the row with given color.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| GraphicsMagick | 5.0 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "GMImage.FindColorInRow"; ImageRef; X; Y; Color { ; Invert; Tolerance } ) More
Parameters
| Parameter | Description | Example | Flags |
|---|---|---|---|
| ImageRef | The image reference number. | 1 | |
| X | The x coordinate. Zero based from 0 to GMImage.GetWidth-1. | 10 | |
| Y | The y coordinate. Zero based from 0 to GMImage.GetHeight-1. | 10 | |
| Color | A color specification. Multiple formats are supported including various color names and # with hex number. See FAQ for details. |
"RGB 1 0 0" | |
| Invert | If 0, we find first pixel matching your color. If 1 we find first pixel not matching the color. Default is 0. | 0 | Optional |
| Tolerance | The tolerance for comparison. Normally a small value like 3. So if color is 65535, 65535, 65535 and pixel is 64764, 64764, 64764 we have a match for tolerance being 800. | 800 | Optional |
Result
Returns position or error.
Description
Locates first pixel in the row with given color.You can find first pixel matching your given color in the row starting with given x position and given tolerance. If you set Invert to 1, the plugin returns column for first pixel not matching color.
Returns -1 if not found.
Examples
Finds color in row:
MBS("GMImage.FindColorInRow"; $img; $x; $y; $ColorToSearch; 1; 3)
See also
Example Databases
Blog Entries
This function checks for a license.
Created 4th February 2015, last changed 30th June 2026
MarkDown version: GMImageFindColorInRow.md