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.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5   7.6    Statistic  

GMImage.FindColorInRow

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 } )

Parameters

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.
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.
3

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


GMImage.FindColorInColumn   -   GMImage.Flip

Feedback: Report problem or ask question.




Links
MBS FileMaker blog