Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5   8.0   8.1    Statistic  


Locates first pixel in the row with given color.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
GraphicsMagick 5.0 Yes Yes Yes Yes Yes

MBS( "GMImage.FindColorInRow"; ImageRef; x; y; color { ; Invert; Tolerance } )


Parameter Description Example value
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 value.
This can be a string in the following format "HSL h s l a", "YUV y u v a", "RGB r g b a", "MONO m a", "GRAY g a" or "COLOR R G B a". Alpha value a is optional. Range of values is 0 to 1.0 except if you use COLOR where RGB values are 0 to 255.
Starting with version 5.4 of our plugin, you can use hex notation. # followed by 2 digits for red, green, blue and optional alpha, e.g. #FF0000 for full red.
"RGB 1 0 0"
Invert Optional
If 0, we find first pixel matching your color. If 1 we find first pixel not matching the color. Default is 0.
Tolerance Optional
The tolerance for comparison. Normally a small value like 3. So if color is 255, 255, 255 and pixel is 252, 252, 252 we have a match for tolerance being 3.


Returns position or error.


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.


Finds color in row:

MBS("GMImage.FindColorInRow"; $img; $x; $y; $ColorToSearch; 1; 3)

See also

Example Databases

GMImage.FindColorInColumn   -   GMImage.Flip

Feedback: Report problem or ask question.

MBS FileMaker blog