Download AdeptVision Reference Guide, Rev A

Program Instruction
VDEF.FONT
Syntax
VDEF.FONT-I
VDEF.FONT
(op) font_num, $chars, height, black_chars
Function
Define, replace, or modify an Optical Character Recognition (OCR) font.
Usage Considerations
The VISION switch must be enabled, the vision processor must be idle, and vision
model training must not be active for this instruction to be executed.
Parameters
op
Optional real-valued expression defining the desired operation: 0 =
define or replace a font, 1 = modify an existing font. The default is 0.
font_num
Real-valued expression defining the number of the font being
defined, replaced, or modified. The number must in the range 1 to
99, inclusive.
$chars
String expression containing all of the characters in the font (in any
order). See below for more information.
height
Optional real-valued expression defining the typical height (in
pixels) of the tallest character in the font. The value must be in the
range 6 to 63 pixels. (Note: if characters in the font are wider than
they are tall, the maximum width should be specified instead of the
height.) This parameter is required if the operation (“op”) is 0;
otherwise, “height” is ignored.
black_chars
Optional real-valued expression that is interpreted as a boolean
(TRUE/FALSE) value. A TRUE value indicates that the characters in
the font are dark against a light background. A FALSE value
indicates the reverse situation. This parameter is required if the
operation (“op”) is 0. Otherwise, “black_chars” is ignored.
Details
This instruction defines an OCR font to the vision system. It tells the system what
characters are in the font, the approximate size of the characters in the font, and
the (relative) color of the characters. A font must be defined with this instruction
before the vision system is trained on the font (with the VTRAIN.MODEL
instruction).
62
AdeptVision Reference Guide, Rev A