Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Recognizes text and returns result as JSON.

Component Version macOS Windows Linux Server iOS SDK
Vision 13.2 ✅ Yes ❌ No ❌ No ✅ Yes, on macOS ✅ Yes
MBS( "Vision.RecognizeTextJSON"; Image { ; Recognition Levels; Languages; CustomWords; PageLimit } )   More


Parameter Description Example Flags
Image The image to analyze.
Can be container value with JPEG, PNG or other image formats supported by Vision framework.
Recognition Levels Can be "Fast" or "Accurate".
macOS and iOS only. Ignored on Windows.
"Accurate" Optional
Languages Specify the languages used for the detection.
The order of the languages in the array defines the order in which languages will be used during the language processing.
The languages are specified as ISO language codes.
"en_US" Optional
CustomWords An array of strings that will be used at the word recognition stage in addition to the recognition languages. The customWords list takes precedence over the standard lexicon.
macOS and iOS only. Ignored on Windows.
"FileMaker¶Claris" Optional
PageLimit The maximum page count allowed for PDF pages.
Default is 1 to only look on first page.
It is highly recommended to use a limit to only get text from first n pages due to the time it takes to render pages and recognize text.
Pass 0 for no limit.
1 Optional


Returns JSON or error.


Recognizes text and returns result as JSON.
Same as Vision.RecognizeText, but with output as JSON.

See also OCR.GetTextAsJSON for cross platform OCR functions and WindowsOCR.Result for Windows text recognition.


Recognize text:

Set Field [ Vision::Result ; MBS( "Vision.RecognizeTextJSON"; Vision::Image; "Accurate") ]

Example result:
[ { "Height" : 38.423806662128612, "Text" : "This gift card belongs to", "Confidence" : 1, "X" : 78.596402532565676, "Width" : 219.87482312802641, "Y" : 167.57112121991196 }, { "Height" : 52.155108398437484, "Text" : "Jonathon", "Confidence" : 1, "X" : 84.337137077320179, "Width" : 135.1397418776852, "Y" : 200.04041162109377 } ]

See also

Example Databases

Blog Entries

This function checks for a license.

Created 9th March 2023, last changed 6th September 2023

Vision.RecognizeText - Vision.SupportedRecognitionLanguages