Epson 5 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Epson 5, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Epson 5 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Epson 5. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Epson 5 should contain:
- informations concerning technical data of Epson 5
- name of the manufacturer and a year of construction of the Epson 5 item
- rules of operation, control and maintenance of the Epson 5 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Epson 5 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Epson 5, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Epson service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Epson 5.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Epson 5 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    Ver.5.3 Vision Guide 5.0 Properties and Results Reference EPSON RC+ 5.0 Option Rev.1 EM08ZR1778F[...]

  • Page 2

    EPSON RC+ 5.0 Option (Ver.5.3) Vision Guide 5.0 Properties and Results Reference Rev.1[...]

  • Page 3

    Vision Guide 5.0 Reference (Ver.5.3) Rev.1 i EPSON RC+ 5.0 Option (Ver.5.3) Vision Guide 5.0 Properties and Results Reference Rev.1 Copyright © 2007-2008 SEIKO EPSON CORPORATION. All rights reserved.[...]

  • Page 4

    FOREWORD Thank you for purchasing our robot products. This m anual contains the information necessary for the correct use of the EPSON RC+ software. Please carefully read this manual and other related m anuals when using this software. Keep this manual in a handy location for easy access at all tim es. W ARRANTY The robot and its optional parts are[...]

  • Page 5

    TRADEMARKS Microsoft, Windows, Windows logo, Visual Basic, and Visual C++ are either registered trademarks or tr adem arks of Microsoft Corpor ation in the United States and/or other countries. Other brand and product names are tradem ar ks or registered trademarks of the respective holders. TRADEMARK NOTIFICA TION IN THIS MANUAL Microsoft® Window[...]

  • Page 6

    MANUFACTURER & SUPPLIER SEIKO EPSON CORPORA T ION Japan & Others Suwa Minami Plant Factory Automation System s Dept. 1010 Fujimi, Fujim i-machi, Suwa-gun, Nagano, 399-0295 JAPAN TEL : +81-(0)266-61-1802 FAX : +81-(0)266-61-1846 SUPPLIERS North & South America EPSON AMERICA, INC. Factory Automation/Robotics 18300 Central Avenue Carson, C[...]

  • Page 7

    SAFETY PRECAUTIONS Installation of robots and robotic equipment should only be perform ed by qualified personnel in accordance with national and local codes. Please carefully read this manual and other related m anuals when using this software. Keep this manual in a handy location for easy access at all tim es. WARNING  This symbol indicates tha[...]

  • Page 8

    vi Vision Guide 5.0 Reference (Ver.5.3) Rev.1[...]

  • Page 9

    Vision Guide 5.0 Reference (Ver.5.3) Rev.1 vii TABLE OF CONTENTS Vision Properties and Re sults Refe rence ........................................................................................ .... 1 Overvi ew ....................................................................................................................... ... 1 Vision Prop[...]

  • Page 10

    Table of Contents EdgeThreshol d Proper ty ......................................................................................................... . 44 EdgeType Proper ty .............................................................................................................. .... 45 EndPntObjRes ult Pr operty ...............................[...]

  • Page 11

    Table of Contents OriginAngleEnabl ed Proper ty .................................................................................................. 95 OriginPntObjResu lt Property ................................................................................................... 9 6 OriginPoin t Proper ty ............................................[...]

  • Page 12

    Table of Contents SearchWin Proper ty............................................................................................................. .. 144 SearchWinHeight Proper ty .................................................................................................... 145 SearchWinLe ft Proper ty.........................................[...]

  • Page 13

    Table of Contents Y1 Pr operty.................................................................................................................... ........ 194 Y2 Pr operty.................................................................................................................... ........ 195 YAxisPntObjResu lt Proper ty ...................[...]

  • Page 14

    Table of Contents xii Vision Guide 5.0 Reference (Ver.5.3) Rev.1[...]

  • Page 15

    Vision Properties and Results Reference Overview This reference m anual explains all Vision Guide sequence, object, and calibration properties and results, and all Vision Guide SPEL+ comm ands. For more information on how to use Vision G uide, refer to the Vision Guide manual. Vision Properties and Results Format Description All Vision Guide proper[...]

  • Page 16

    AbortSeqOnFail Property AbortSeqOnFail Property Applies To Vision Objects: Blob, Geom etric, Correlation, Edge, Freame, Line, Point, Polar Description Allows the user to specify that if an object fails (i.e. is not found), then the entire sequence is aborted at that point and no further objects are processed. Usage VGet Sequence.Object . AbortSeqOn[...]

  • Page 17

    Accept Property Accept Property Applies To Vision Objects: Correlation, Edge, Geom etric, Polar Description The Accept property specifies the score that a feature m u st equal or exceed to be considered found. Usage VGet Sequence . Object . Accept , var VSet Sequence.Object. Accept , value Sequence Name of a sequence or string variable containing a[...]

  • Page 18

    AcquireState Result AcquireState Result Runtime only Applies To Vision Sequence Description The AcquireState result is used determine if a picture has been taken for a sequence whose RuntimeAcquire property has been set to Strobed. Usage VGet Sequence . AcquireState , var Sequence Name of a sequence or string variable containing a sequence nam e. v[...]

  • Page 19

    AllFound Result AllFound Result Applies To Vision Sequence Description The AllFound result returns whether or not all objects within the specified sequence were found. Usage VGet Sequence . AllFound , var Sequence Name of a sequence or string variable containing a sequence nam e. var Boolean variable that will contain the value of the result. Value[...]

  • Page 20

    Angle Result Angle Result Applies To Vision Objects: Blob, Correlation, Frame, G eometric, Line, Polar Description Returns the angle of the found object. Usage VGet Sequence.Object .Angle [(result)] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam [...]

  • Page 21

    AngleAccuracy Property AngleAccuracy Property Applies To Vision Objects: Correlation Description Specifies the accuracy of a corre lation search with rotation. Usage VGet Sequence.Object .AngleAccuracy, var VSet Sequence.Object .AngleAccuracy, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object[...]

  • Page 22

    AngleEnable Property AngleEnable Property Applies To Vision Objects: Correlation, Geom etric Description Specifies whether or not a correlation or geometric object will search for rotation of a feature. Usage VGet Sequence.Object .AngleEnable, var VSet Sequence.Object .AngleEnable, value Sequence Name of a sequence or string variable containing a s[...]

  • Page 23

    AngleMaxIncrement Property AngleMaxIncrement Property Applies To Vision Objects: Correlation Description The AngleMaxIncrement property specifies the m aximum angle increm ent amount for teaching a correlation model for searching with angle. The model training function selects an angular increm ent automatically and then uses the sm aller of the au[...]

  • Page 24

    AngleObject Property AngleObject Property Applies To Vision Objects: ImageOp Description Sets / returns the object to be used to determine the angle of rotation for the Im ageOp object Rotate operation. Usage VGet Sequence.Object .AngleObject, var VSet Sequence.Object .AngleObject, value Sequence Name of a sequence or string variable containing a s[...]

  • Page 25

    AngleOffset Property AngleOffset Property Applies To Vision Objects: Polar Description An angle value which is used as an offset to line up the Polar Search direction indicator (graphic line on the image display) with the part since it is virtually im possible and norm ally impractical to teach a polar object with the proper rotation of a part so t[...]

  • Page 26

    AngleRange Property AngleRange Property Applies To Vision Objects: Correlation, Geom etric Description Specifies the range within which to train a series of rotated models. Usage VGet Sequence.Object .AngleRange, var VSet Sequence.Object .AngleRange, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an[...]

  • Page 27

    AngleStart Property AngleStart Property Applies To Vision Objects: Correlation, Geom etric Description Sets / returns the starting search angle. Usage VGet Sequence.Object .AngleStart, var VSet Sequence.Object .AngleStart, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable c[...]

  • Page 28

    Area Result Area Result Applies To Vision Objects: Blob Description Returns the area of a blob. Usage VGet Sequence.Object .Area [( result )], var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist in the specified sequence. var Re[...]

  • Page 29

    BackColor Property BackColor Property Applies To Vision Objects: All Description Sets the background color for an object's label. Usage VGet Sequence.Object .BackColor, var VSet Sequence.Object .BackColor, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an[...]

  • Page 30

    CalComplete Result CalComplete Result Applies To Vision Calibration Description Returns the completion status of a calibration. Usage VGet Calibration . CalComplete, var Calibration Name of a calibration or string variable containing a calibration nam e. var Boolean variable that will contain the value of the result. Values False Calibration has no[...]

  • Page 31

    Calibration Property Calibration Property Applies To Vision Sequence Description Sets / returns the calibration used with the specified sequence. Usage VGet Sequence . Calibration , var VSet Sequence . Calibration , value Sequence Name of a sequence or string variable containing a sequence nam e. var String variable that will contain the value of t[...]

  • Page 32

    Camera Property Camera Property Applies To Vision Sequence Vision Calibration Description Specifies which camera to use for a vision sequence or calibration. Usage VGet { Sequence | Calibration }. Camera , var VSet { Sequence | Calibration }. Camera , value Sequence Name of a sequence or string variable containing a sequence nam e. Calibration Name[...]

  • Page 33

    CameraGain Property CameraGain Property Applies To Vision Sequence Description Specifies the gain settings for the camera used in the current sequence. The gain determ ines the dynamic range of the digital values that will be assigned to the video signal in the A/D converter on the camera. (Also known as Contrast.) Usage VGet Sequence . CameraGain [...]

  • Page 34

    CameraOffset Property CameraOffset Property Applies To Vision Sequence Description Specifies the offset for the camera used in the current sequence. The offset is the lower lim it of the digital values that will be assigned to the video signal in the A/D converter. (Also known as Brightness.) Usage VGet Sequence . CameraOffset , var VSet Sequence .[...]

  • Page 35

    CameraOrientation Property CameraOrientation Property Applies To Vision Calibration Description Sets / returns the CameraOrientation type for the specified calibration. Usage VGet Calibration . CameraOrientation , var VSet Calibration . CameraOrientation , value Calibration Name of a calibration or string variable containing a calibration nam e. va[...]

  • Page 36

    CameraX Result CameraX Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Point, Polar Description Returns the X position coordinate of the found part's position in the camera coordinate fram e. Usage VGet Sequence.Object .CameraX [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e.[...]

  • Page 37

    CameraX1 Result CameraX1 Result Applies To Vision Objects: Line Description Returns the starting point position (X1) of a Line object in Camera coordinates. Usage VGet Sequence.Object .CameraX1, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The[...]

  • Page 38

    CameraX2 Result CameraX2 Result Applies To Vision Objects: Line Description Returns the end point position (X2) of a Line object in Camera coordinates. Usage VGet Sequence.Object .CameraX2, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The obje[...]

  • Page 39

    CameraXYU Result CameraXYU Result Runtime Only Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Point, Polar Description Returns the CameraX, Cam eraY and Angle position coor dinates of the found part's position in the cam era coordinate frame. Usage VGet Sequence.Object .CameraXYU [( result )] , found, xVar, yVar, uVar Sequence[...]

  • Page 40

    CameraY Result CameraY Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Point, Polar Description Returns the Y position coordinate of the found part's position in the camera coordinate fram e. Usage VGet Sequence.Object .CameraY [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e.[...]

  • Page 41

    CameraY1 Result CameraY1 Result Applies To Vision Objects: Line Description Returns the starting point position Y coordinate (Y1) of a Line object in Camera coordinates. Usage VGet Sequence . Object .CameraY1, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an ob[...]

  • Page 42

    CameraY2 Result CameraY2 Result Applies To Vision Objects: Line Description Returns the ending point position (Y2) of a Line object in Camera coordinates. Usage VGet Sequence.Object .CameraY2, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The o[...]

  • Page 43

    Caption Property Caption Property Applies To Vision Objects: All Description Sets or returns the caption of the object. Usage VGet Sequence . Object . Caption , var VSet Sequence . Object . Caption , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam[...]

  • Page 44

    CenterPntObjResult Property CenterPntObjResult Property Applies To Vision Objects: Blob, Correlation, Geom etric, Polar Description Specifies which result to use from the CenterPointObject. Usage VGet Sequence.Object . CenterPntObjResult , var VSet Sequence.Object . CenterPntObjResult , value Sequence Name of a sequence or string variable containin[...]

  • Page 45

    CenterPntOffsetX Property CenterPntOffsetX Property Applies To Vision Objects: Blob, Correlation, Geom etric, Polar Description Sets or returns the X offset of the center of the search window after it is positioned with the CenterPointObject. Usage VGet Sequence.Object .CenterPntOffsetX, var VSet Sequence.Object .CenterPntOffsetX, value Sequence Na[...]

  • Page 46

    CenterPntOffsetY Property CenterPntOffsetY Property Applies To Vision Objects: Blob, Correlation, Geom etric, Polar Description Sets or returns the Y offset of the center of the search window after it is positioned with the CenterPointObject. Usage VGet Sequence.Object .CenterPntOffsetY, var VSet Sequence.Object .CenterPntOffsetY, value Sequence Na[...]

  • Page 47

    CenterPointObject Property CenterPointObject Property Applies To Vision Objects: Blob, Correlation, Geom etric, Polar Description Specifies the object whose position is used as the center for the specified object. Usage VGet Sequence.Object . CenterPointObject , var VSet Sequence.Object . CenterPointObject , value Sequence Name of a sequence or str[...]

  • Page 48

    CenterX Property CenterX Property Applies To Vision Objects: Polar Description Specifies the X Coordinate position to be used as the center point for the Polar object. Usage VGet Sequence.Object .CenterX, var VSet Sequence.Object .CenterX, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or [...]

  • Page 49

    CenterY Property CenterY Property Applies To Vision Objects: Polar Description Specifies the Y Coordinate position to be used as the center point for the Polar object. Usage VGet Sequence.Object .CenterY, var VSet Sequence.Object .CenterY, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or [...]

  • Page 50

    Compactness Result Compactness Result Applies To Vision Objects: Blob Description Returns the compactness of a blob. Usage VGet Sequence.Object .Compactness [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist in t[...]

  • Page 51

    Confusion Property Confusion Property Applies To Vision Objects: Correlation, Geom etric, Polar Description Indicates the am ount of confusion expected in the image to be searched. This is the highest shape score a feature can get that is not an instan ce of the feature for which you are sear ching. (i.e. Will there be patterns in the image which w[...]

  • Page 52

    Contrast Result Contrast Result Applies To Vision Objects: Edge Description Returns the contrast of the found Edge. Usage VGet Sequence.Object .Contrast, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist in the specified seque[...]

  • Page 53

    ContrastTarget Property ContrastTarget Property Applies To Vision Objects: Edge Description Sets the desired contrast for the edge search. Usage VGet Sequence.Object .ContrastTarget, var VSet Sequence.Object .ContrastTarget, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable[...]

  • Page 54

    ContrastVariation Property ContrastVariation Property Applies To Vision Objects: Edge Description ContrastVariation is the tolerance for the ContrastTarget property. Usage VGet Sequence.Object .ContrastVariation, var VSet Sequence.Object .ContrastVariation, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Nam[...]

  • Page 55

    CurrentResult Property CurrentResult Property Applies To Vision Objects: Blob, Correlation, Edge, Geom etric Description Defines which result to display in the Results list on the Object tab or which result to return data for when an object searches for multiple results. Usage VGet Sequence.Object . CurrentResult , var VSet Sequence.Object . Curren[...]

  • Page 56

    CurrentResult Property Example The following SPEL + language example runs a vision sequence called "m test" which contains a Blob object called "Blob01". "Blob01" has been defined to find m ultiple blobs (3) from within a single Search Window. (i.e. mtest.Blob01.Num berToFind = 3) The following program will run the seq[...]

  • Page 57

    DetailLevel Property DetailLevel Property Applies To Geometric Description Selects the level at which an edge is considered found during the geometric search. Usage VGet Sequence.Object. DetailLevel , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam [...]

  • Page 58

    EdgeThreshold Property EdgeThreshold Property Applies To Vision Objects: Edge Description Sets the threshold percentage for which edges with grayscale variation below this value are ignored. Usage VGet Sequence.Object .EdgeThreshold, var VSet Sequence.Object .EdgeThreshold, value Sequence Name of a sequence or string variable containing a sequence [...]

  • Page 59

    EdgeType Property EdgeType Property Applies To Vision Objects: Edge Description Sets / gets the type of edge to search for. Usage VGet Sequence.Object .EdgeType, var VSet Sequence.Object .EdgeType, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object name.[...]

  • Page 60

    EndPntObjResult Property EndPntObjResult Property Applies To Vision Objects: Edge, Line Description Specifies which result to use from the EndPointObject. Usage VGet Sequence.Object . EndPntObjResult , var VSet Sequence.Object . EndPntObjResult , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an obj[...]

  • Page 61

    EndPointObject Property EndPointObject Property Applies To Vision Objects: Edge, Line Description Specifies the vision object to use for the end point of a Line object. Usage VGet Sequence.Object . EndPointObject , var VSet Sequence.Object . EndPointObject , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Na[...]

  • Page 62

    EndPointType Property EndPointType Property Applies To Vision Objects: Edge, Line Description Specifies the type of end point to use for the line object. In most cases the end point type will be a point (which usually means the PixelX and PixelY position of the EndPointObject). However, when the EndPointObject for the current line is a 2nd Line obj[...]

  • Page 63

    EndPointType Property 6 - PerpToMidPnt Calculate the position on the 2nd line where the 2 lines intersect in a perpendicular fashion through the mid point of the first line and use this position as the end point. 7 - PerpToEndPnt Calculate the position on the 2nd line where the 2 lines intersect in a perpendicular fashion through the end point of t[...]

  • Page 64

    ExposureTime Property ExposureTime Property Applies To Vision Sequences Description Sets the electronic shutter time for a cam era that is running in asynchronous reset mode. Usage VGet Sequence . ExposureTime , var VSet Sequence . ExposureTime , value Sequence Name of a sequence or string variable containing a sequence nam e. var Long variable tha[...]

  • Page 65

    Extrema Result Extrema Result Runtime only Applies To Vision Objects: Blob Description Returns the blob extrema coordinates. Usage VGet Sequence.Object. Extrema [( result )] , varMinX, varMaxX, varMinY, varMaxY Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an objec[...]

  • Page 66

    Found Result Found Result Applies To Vision Objects: Blob, Correlation, Edge, Frame, G eometric, Line, Point, Polar Description Returns whether or not the object was found. Usage VGet Sequence.Object .Found [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable cont[...]

  • Page 67

    FoundColor Property FoundColor Property Applies To Vision Objects: All Description Selects the color for an object when it is found. Usage VGet Sequence.Object .FoundColor, var VSet Sequence.Object .FoundColor, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an[...]

  • Page 68

    FoundOnEdge Result FoundOnEdge Result Applies To Vision Objects: Blob, Correlation, Geom etric Description Returns True when a Blob, Correlation, or Geometric object is found too close to the edge of the search window. Usage VGet Sequence.Object .FoundOnEdge [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam[...]

  • Page 69

    Frame Property Frame Property Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, ImageOp, Line, Point, Polar Description Defines the current object searching positi on with respect to the specified frame. Usage VGet Sequence.Object .Frame, var VSet Sequence.Object .Frame, value Sequence Name of a sequence or string variable containing [...]

  • Page 70

    Graphics Property Graphics Property Applies To Vision Objects: All Description Specifies which graphics to display at runtime and de sign tim e. (i.e. Whether to show graphics for each object, just position information, or nothing at all.) This property can help remove screen clutter from complex vision sequences. Usage VGet Sequence.Object .Graphi[...]

  • Page 71

    Holes Result Holes Result Applies To Vision Objects: Blob Description Returns the number of holes found within a Blob object. Usage VGet Sequence.Object .Holes [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object name. The object must exist in[...]

  • Page 72

    ImageFile Property ImageFile Property Designtime only Applies To Vision Sequence Description Sets or returns the image file for the current sequence. Remarks Use the ImageFile property to view and search im ag es stored on disk with the SaveImage property . See Also Sequence Tab, Vision Sequences, SaveImage Property, Im ageSource Property 58 Vision[...]

  • Page 73

    ImageSource Property ImageSource Property Designtime only Applies To Vision Sequence Description Sets or returns the current image source for the sequence. Remarks ImageSource allows you to run a sequence from a cam era image or from an image file set with the ImageFile property. If the ImageFile property is set to a valid im age file , then the Im[...]

  • Page 74

    Iterations Property Iterations Property Applies To Vision Objects: ImageOp Description Sets/returns how many tim es to execute the image operation. Usage VGet Sequence.Object .Iterations, var VSet Sequence.Object .Iterations, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variabl[...]

  • Page 75

    Lamp Property Lamp Property Applies To Vision Calibration Description Sets / returns the output bit used for the calibration lamp. Usage VGet Calibration. Lamp, var VSet Calibration. Lamp, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer variable that will contain the value of the property. valu[...]

  • Page 76

    LampDelay Property LampDelay Property Applies To Vision Calibration Description Sets / returns the amount of tim e to wait for a calibration lamp to turn on. Usage VGet Calibration. LampDelay, var VSet Calibration. LampDelay, value Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will conta[...]

  • Page 77

    Length Result Length Result Applies To Vision Objects: Line Description Returns a length in millim eters of the distance between the starting and ending point of the line. Usage VGet Sequence.Object .Length, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an obje[...]

  • Page 78

    LineObject1 Property LineObject1 Property Applies To Vision Objects: Point Description Specifies the 1st Line object to use for defining the position of a Point object. (LineObject1 defines the line which is used by the PointType property for defining the position of the Point object. ) Usage VGet Sequence.Object .LineObject1, var VSet Sequence.Obj[...]

  • Page 79

    LineObject2 Property LineObject2 Property Applies To Vision Objects: Point Description Specifies the 2nd Line object to use for defining the position of a Point object when that position is defined by the intersection point of 2 lines. (LineObject1 and LineObject2 together define 2 lines w hose intersection point can be defined as the position of t[...]

  • Page 80

    MaxArea Property MaxArea Property (Maximum Area) Applies To Vision Objects: Blob Description Defines the upper Area lim it for the Blob Object. For a Blob to be found it must have an Area result below the value set for MaxArea property. Usage VGet Sequence.Object .MaxArea, var VSet Sequence.Object .MaxArea, value Sequence Name of a sequence or stri[...]

  • Page 81

    MaxLength Property MaxLength Property Applies To Vision Objects: Line Description Defines the upper length limit for the Line object. For a Line to be found it m ust have a Length result below the value set for MaxLength property. Usage VGet Sequence.Object .MaxLength, var VSet Sequence.Object .MaxLength , value Sequence Name of a sequence or strin[...]

  • Page 82

    MaxPixelLength Property MaxPixelLength Property Applies To Vision Objects: Line Description Defines the upper pixel length limit for the Line object. For a Line to be found it must have a PixelLength result below the value set for MaxPixelLength property. Usage VGet Sequence.Object .MaxPixelLength, var VSet Sequence.Object .MaxPixelLength , value S[...]

  • Page 83

    MaxX Result MaxX Result Applies To Vision Objects: Blob Description Returns the maxim um X pixel coordinate of the blob extrema. Usage VGet Sequence.Object .MaxX [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist[...]

  • Page 84

    MaxY Result MaxY Result Applies To Vision Objects: Blob Description Returns the maxim um Y pixel coordinate of the blob extrema. Usage VGet Sequence.Object .MaxY [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist[...]

  • Page 85

    MinArea Property MinArea Property Applies To Vision Objects: Blob Description Defines the lower Area lim it for the Blob object. For a Blob to be found it must have an Area result above the value set for MinArea property. Usage VGet Sequence.Object .MinArea, var VSet Sequence.Object .MinArea , value Sequence Name of a sequence or string variable co[...]

  • Page 86

    MinLength Property MinLength Property Applies To Vision Objects: Line Description Defines the lower length limit for the Line object. For a Line to be found it m ust have a Length result above the value set for MinLength property. Usage VGet Sequence.Object .MinLength, var VSet Sequence.Object .MinLength , value Sequence Name of a sequence or strin[...]

  • Page 87

    MinMaxArea Property MinMaxArea Property Runtime only Applies To Vision Objects: Blob Description Defines the lower and upper Area lim its for the Blob object. For a Blob to be found it must have an Area result greater than the MinArea property and less than the MaxArea property . (MinMaxArea property was added to allow easy manipulation of both the[...]

  • Page 88

    MinPixelLength Property MinPixelLength Property Applies To Vision Objects: Line Description Defines the lower length limit for the Line object. For a Line to be found it m ust have a PixelLength result above the value set for MinPixelLength property. Usage VGet Sequence.Object .MinPixelLength, var VSet Sequence.Object .MinPixelLength , value Sequen[...]

  • Page 89

    MinX Result MinX Result Applies To Vision Objects: Blob Description Returns the minim um X pixel coordinate of the blob extrema. Usage VGet Sequence.Object .MinX [( result )], var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist [...]

  • Page 90

    MinY Result MinY Result Applies To Vision Objects: Blob Description Returns the minim um Y pixel coordinate of the blob extrema. Usage VGet Sequence.Object .MinY [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist[...]

  • Page 91

    ModelObject Property ModelObject Property Applies To Vision Objects: Correlation, Geom etric, Polar Description Determines which m odel to use for searching. Usage VGet Sequence.Object .ModelObject, var VSet Sequence.Object .ModelObject, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or st[...]

  • Page 92

    ModelOK Property ModelOK Property Runtime only Applies To Vision Objects: Correlation, Geom etric, Polar Description Returns the status of an object's m odel. Usage VGet Sequence.Object .ModelOK, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam [...]

  • Page 93

    ModelOrgAutoCenter Property ModelOrgAutoCenter Property Applies To Vision Objects: Correlation, Geom etric Description A model has a fixed reference point by w hich we describe its location in an image. This point is referred to as the model' s origin. The ModelOrgAutoCenter pr operty causes the m odel origin to be placed at the center of the [...]

  • Page 94

    ModelOrgX Property ModelOrgX Property Applies To Vision Objects: Correlation, Geom etric Description A model has a fixed reference point by w hich we describe its location in an image. This point is referred to as the model origin. The ModelOrgX property contai ns the X coordinate value of the model origin. Usage VGet Sequence.Object .ModelOrgX, va[...]

  • Page 95

    ModelOrgY Property ModelOrgY Property Applies To Vision Objects: Correlation, Geom etric Description A model has a fixed reference point by w hich we describe its location in an image. This point is referred to as the model' s Origin. The ModelOrgY property contains the Y coordinate value of the model's origin. Usage VGet Sequence.Object [...]

  • Page 96

    ModelWin Property ModelWin Property Runtime only Applies To Vision Objects: Correlation, Geom etric Description Defines the position and size of the model window for Correlation and Geometric objects. Usage VGet Sequence.Object .ModelWin, LeftVar, TopVar, WidthVar, HeightVar Sequence Name of a sequence or string variable containing a sequence nam e[...]

  • Page 97

    ModelWinHeight Property ModelWinHeight Property Applies To Vision Objects: Correlation, Geom etric Description Defines the height of the model window used for Correlation and Geometric object models. Usage VGet Sequence.Object . ModelWinHeight , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object[...]

  • Page 98

    ModelWinLeft Property ModelWinLeft Property Applies To Vision Objects: Correlation, Geom etric Description Defines the left most position of the m odel window for Correlation and Geometric objects. Usage VGet Sequence.Object .ModelWinLeft, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or st[...]

  • Page 99

    ModelWinTop Property ModelWinTop Property Applies To Vision Objects: Correlation, Geom etric Description Defines the upper most position of the m odel window for Correlation and Geometric objects. Usage VGet Sequence.Object .ModelWinTop, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or stri[...]

  • Page 100

    ModelWinWidth Property ModelWinWidth Property Applies To Vision Objects: Correlation, Geom etric Description Defines the width of a model w indow. Usage VGet Sequence.Object . ModelWinWidth , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The ob[...]

  • Page 101

    ModelWinWidth Property See Also Anatomy of a V i sion Object, Correlation Object, ModelOrgAutoCenter Property, ModelOrgX Property, ModelOrgY Property, ModelWin Property, ModelWinHeight Property , ModelWinLeft Property, ModelWinTop Property, Object Tab Vision Guide 5.0 Reference (Ver.5.3) Rev.1 87[...]

  • Page 102

    Name Property Name Property Applies To Vision Sequence Vision Calibration Vision Objects: All Description All vision objects, Sequences, and Calibrations must have a nam e. The name is then used to refer to the individual vision object, Sequence or Calibration. Usage VGet Sequence.Object . Name , var Sequence Name of a sequence or string variable c[...]

  • Page 103

    NumberFound Result NumberFound Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric Description Returns the num ber of features found within a singl e Search Window for a Blob, Correlation, Edge, or Geometric object. Usage VGet Sequence.Object .NumberFound, var Sequence Name of a sequence or string variable containing a sequence na[...]

  • Page 104

    NumberFound Result Example The following SPEL + language example runs a vision sequence called mtest which contains a Correlation object called Corr01 . Corr01 has been defined to find multiple features (3). The following program will run the sequence and m ake sure that the proper number of features (3) was found for Corr01 and then print the Scor[...]

  • Page 105

    NumberToFind Property NumberToFind Property Applies To Vision Objects: Blob, Correlation, Edge, Geom etric Description Defines the number of features to search for within a single Search Window for a Blob, Correlation, Edge, or Geometric object. Usage VGet Sequence.Object .NumberToFind, var VSet Sequence.Object .NumberToFind, value Sequence Name of[...]

  • Page 106

    NumberToFind Property Example The following SPEL + language example runs a vision sequence called mtest which contains a Correlation object called Corr01 . The NumberToFind value for Corr01 is set using VSet. The following program will run the sequence and m ake sure that the proper number of features (3) was found for Corr01 and then print the Sco[...]

  • Page 107

    Operation Property Operation Property Applies To Vision Objects: ImageOp Description Sets which image operation to perform . Usage VGet Sequence.Object . Operation , var VSet Sequence.Object . Operation , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an objec[...]

  • Page 108

    Operation Property property. Otherwise, the rotation angle is determ ined by the Angle result of the AngleObject. The rotation is counter-clockwise for positive angles. 18 - FlipHoriz Flips the image from left to right. 19 - FlipVert Flips the image from top to bottom . 20 - FlipBoth Flips the image horizontally and vertically . Remarks The Operati[...]

  • Page 109

    OriginAngleEnabled Property OriginAngleEnabled Property Applies To Vision Objects: Frame Description Enables a single point frame to rotate with the angle of the origin object. Usage VGet Sequence.Object .OriginAngleEnabled, var VSet Sequence.Object .OriginAngleEnabled, value Sequence Name of a sequence or string variable containing a sequence nam [...]

  • Page 110

    OriginPntObjResult Property OriginPntObjResult Property Applies To Vision Objects: Frame Description Specifies which result to use from the OriginPointObject. Usage VGet Sequence.Object .OriginPntObjResult, var VSet Sequence.Object .OriginPntObjResult, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of [...]

  • Page 111

    OriginPoint Property OriginPoint Property Applies To Vision Objects: Frame Description Defines the vision object to be used as the origin point for a Frame object. Usage VGet Sequence.Object .OriginPoint, var VSet Sequence.Object .OriginPoint, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object[...]

  • Page 112

    OriginPoint Property See Also Frame Object, Object Tab, YAxisPoint Property 98 Vision Guide 5.0 Reference (Ver.5.3) Rev.1[...]

  • Page 113

    Perimeter Result Perimeter Result Applies To Vision Objects: Blob Description Returns the perimeter of a blob. Usage VGet Sequence.Object .Perimeter [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist in the speci[...]

  • Page 114

    PixelLength Result PixelLength Result Applies To Vision Objects: Line Description Returns the length in pixels of the distance between the starting and ending point of the line. Usage VGet Sequence.Object .PixelLength, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable contain[...]

  • Page 115

    PixelLine Result PixelLine Result Runtime only Applies To Vision Objects: Line Description Run time only result which returns the pixel coordinate position data of the starting (X1, Y1) and ending (X2, Y2) points of the specified Line object. Usage VGet Sequence.Object .PixelLine, X1, Y1, X2, Y2 Sequence Name of a sequence or string variable contai[...]

  • Page 116

    PixelX Result PixelX Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Point, Polar Description Returns the X position coordinate of the found part's position in pixel coordinates. Usage VGet Sequence.Object .PixelX [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name o[...]

  • Page 117

    PixelX1 Result PixelX1 Result Applies To Vision Objects: Line Description Returns the pixel X coordinate of the starting point of a Line object. Usage VGet Sequence.Object .PixelX1, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must [...]

  • Page 118

    PixelX2 Result PixelX2 Result Applies To Vision Objects: Line Description Returns the pixel X coordinate of the end point of a Line object. Usage VGet Sequence.Object .PixelX2, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist[...]

  • Page 119

    PixelXYU Result PixelXYU Result Runtime only Applies To Vision Objects: Blob, Correlation, Edge, Point, Polar Description Returns the PixelX, PixelY and Angle coordinates of the found part's position in the im age coordinate system. Usage VGet Sequence.Object .PixelXYU [( result )] , found, xVar, yVar, uVar Sequence Name of a sequence or strin[...]

  • Page 120

    PixelY Result PixelY Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Point, Polar Description Returns the Y position coordinate of the found part's position in pixel coordinates. Usage VGet Sequence.Object .PixelY [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name o[...]

  • Page 121

    PixelY1 Result PixelY1 Result Applies To Vision Objects: Line Description Returns the pixel Y coordinate of the starting point of a Line object. Usage VGet Sequence.Object .PixelY1, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must [...]

  • Page 122

    PixelY2 Result PixelY2 Result Applies To Vision Objects: Line Description Returns the pixel Y coordinate of the end point of a Line object. Usage VGet Sequence.Object .PixelY2, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist[...]

  • Page 123

    PointsTaught Property PointsTaught Property Applies To Vision Calibration Description Sets / returns the teach state of a vision calibration's points. Usage VGet Calibration . PointsTaught, var VSet Calibration .PointsTaught, value Calibration Name of a calibration or string variable containing a calibration nam e. var Boolean variable that wi[...]

  • Page 124

    PointType Property PointType Property Applies To Vision Objects: Point Description Defines whether the Point object will have its position based on either the position the Point object is placed on the Screen (0 - Screen), the midpoint of a lin e (1 - midpoint), or the intersection of 2 lines (2 - intersection). Usage VGet Sequence.Object .PointTyp[...]

  • Page 125

    PointType Property See Also Line Object, LineObject1 Property, LineObject2 Property, Object Tab Vision Guide 5.0 Reference (Ver.5.3) Rev.1 111[...]

  • Page 126

    Polarity Property Polarity Property Applies To Vision Objects: Blob, Edge, ImageO p Description For Blob and ImageOp objects, Polarity defines the differentiation betw een objects and background. For Edge objects, Polarity defines the transition of an edge. Usage VGet Sequence.Object .Polarity, var VSet Sequence.Object .Polarity, value Sequence Nam[...]

  • Page 127

    Radius Property Radius Property Applies To Vision Objects: Polar Description Defines the radius for a Polar object. See diagram below. Thickness Radius Usage VGet Sequence.Object .Radius, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object[...]

  • Page 128

    RejectOnEdge Property RejectOnEdge Property Applies To Vision Objects: Blob, Correlation, Geom etric Description Determines if an object is rejected if found on the edge of the search window . Usage VGet Sequence.Object .RejectOnEdge, var VSet Sequence.Object .RejectOnEdge, value Sequence Name of a sequence or string variable containing a sequence [...]

  • Page 129

    ReferenceType Property ReferenceType Property Applies To Vision Calibration Description Sets / returns the reference type for a calibration. Usage VGet Calibration. ReferenceType, var VSet Calibration. ReferenceType, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer variable that will contain the[...]

  • Page 130

    RobotAccel Property RobotAccel Property Applies To Vision Calibration Description Sets / returns the robot point to point motion acceleration used during the calibration cycle. Usage VGet Calibration. RobotAccel, var VSet Calibration. RobotAccel, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer [...]

  • Page 131

    RobotArm Property RobotArm Property Applies To Vision Calibration Description Sets / returns the robot arm used when teaching points for a vision calibration. Usage VGet Calibration. RobotArm, var VSet Calibration. RobotArm, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer variable that will con[...]

  • Page 132

    RobotLocal Property RobotLocal Property Applies To Vision Calibration Description Sets / returns the local coordinate system us ed when teaching points for a vision calibration. Usage VGet Calibration. RobotLocal, var VSet Calibration. RobotLocal, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer[...]

  • Page 133

    RobotSpeed Property RobotSpeed Property Applies To Vision Calibration Description Sets / returns the robot point to point motion speed used during the calibration cycle. Usage VGet Calibration. RobotSpeed, var VSet Calibration. RobotSpeed, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer variabl[...]

  • Page 134

    RobotTool Property RobotTool Property Applies To Vision Calibration Description Sets / returns the robot tool used when teaching points for a vision calibration. Usage VGet Calibration. RobotTool, var VSet Calibration. RobotTool, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer variable that wil[...]

  • Page 135

    RobotU Result RobotU Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Line, Polar Description Returns the U angle of the found part's position in the robot coordinate system . Usage VGet Sequence.Object .RobotU [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an[...]

  • Page 136

    RobotX Result RobotX Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Point, Polar Description Returns the X position coordinate of the found part's position in the robot coordinate system . Usage VGet Sequence.Object .RobotX [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Ob[...]

  • Page 137

    RobotX1 Result RobotX1 Result Applies To Vision Objects: Line Description Returns the X coordinate of the starting point position (X1) of a Line object in the robot coordinate system . Usage VGet Sequence.Object .RobotX1, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable cont[...]

  • Page 138

    RobotX2 Result RobotX2 Result Applies To Vision Objects: Line Description Returns the X coordinate of the ending point position (X2) of a Line object in the robot coordinate system . Usage VGet Sequence.Object .RobotX2, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable contai[...]

  • Page 139

    RobotXYU Result RobotXYU Result Runtime only Applies To Vision Objects: Blob, Correlation, Edge, Point, Polar Description Returns the RobotX, RobotY and RobotU position coordinates of the found part's position with respect to the robot coordinate system. Usage VGet Sequence.Object .RobotXYU [( result )] , found, xVar, yVar, uVar Sequence Name [...]

  • Page 140

    RobotY Result RobotY Result Applies To Vision Objects: Blob, Correlation, Edge, Geom etric, Point, Polar Description Returns the Y coordinate of the found part's position in the robot coordinate system . Usage VGet Sequence.Object .RobotY [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name[...]

  • Page 141

    RobotY1 Result RobotY1 Result Applies To Vision Objects: Line Description Returns the Y coordinate of the starting point position (Y1) of a Line object in the robot coordinate system . Usage VGet Sequence.Object .RobotY1, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable cont[...]

  • Page 142

    RobotY2 Result RobotY2 Result Applies To Vision Objects: Line Description Returns the Y coordinate of the ending point position (Y2) of a Line object in the robot coordinate system . Usage VGet Sequence.Object .RobotY2, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable contai[...]

  • Page 143

    RotationAngle Property RotationAngle Property Applies To Vision Objects: ImageOp Description Sets/returns the angle of rotation for the ImageOp object Rotate operation. Usage VGet Sequence.Object . RotationAngle , var VSet Sequence.Object . RotationAngle , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name[...]

  • Page 144

    Roughness Result Roughness Result Applies To Vision Objects: Blob Description Returns the roughness of a blob. Usage VGet Sequence.Object .Roughness [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist in the speci[...]

  • Page 145

    RuntimeAcquire Property RuntimeAcquire Property Applies To Vision Sequence Description The RuntimeA cquire property tells the vision sequence w h ich method to use to acquire an im age for use with that sequence. Usage VGet Sequence.Object . RuntimeAcquire , var VSet Sequence.Object . RuntimeAcquire , value Sequence Name of a sequence or string var[...]

  • Page 146

    RuntimeAcquire Property Remarks The RuntimeAcquire property is very important to unde rstand. There are 3 setting for the Runtim eAcquire property as explained in the Values section. The most com mon of the 3 is the Stationary setting since in most cases you will want to acquire a new im age at the beginning of each vision sequence. However, you ma[...]

  • Page 147

    RuntimeFreeze Property RuntimeFreeze Property Applies To Vision Sequence Description Defines whether or not to freeze the display of an image acquired during a vision sequence. Usage VGet Sequence . RuntimeFreeze , var VSet Sequence . RuntimeFreeze , value Sequence Name of a sequence or string variable containing a sequence nam e. var Boolean varia[...]

  • Page 148

    SaveImage Property SaveImage Property Designtime Only Applies To Vision Sequence Description Saves the currently displayed im age on disk. Remarks SaveImage allows you to save im ages to disk that can be used by the ImageFile property. The file can be saved in the following formats: MIM (default fo rm at for Vision Guide), BMP, TIF, or JPG. See Als[...]

  • Page 149

    Scale Result Scale Result Applies To Vision Objects: Geometric Description Returns the scale of the object found. Usage VGet Sequence.Object .Scale [( result )] , var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist in the specif[...]

  • Page 150

    ScaleEnable Property ScaleEnable Property Applies To Vision Objects: Geometric Description Enables the Scale result. Usage VGet Sequence.Object .ScaleEnable, var VSet Sequence.Object .ScaleEnable, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e.[...]

  • Page 151

    ScaleFactorMax Property ScaleFactorMax Property Applies To Vision Objects: Geometric Description Sets / returns the maxim um scale factor applied to the ScaleTarget value. Usage VGet Sequence.Object .ScaleFactorMax, var VSet Sequence.Object .ScaleFactorMax, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Nam[...]

  • Page 152

    ScaleFactorMin Property ScaleFactorMin Property Applies To Vision Objects: Geometric Description Sets / returns the minim um scale factor applied to the ScaleTarget value. Usage VGet Sequence.Object .ScaleFactorMin, var VSet Sequence.Object .ScaleFactorMin, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Nam[...]

  • Page 153

    ScaleTarget Property ScaleTarget Property Applies To Vision Objects: Geometric Description Sets / returns the expected scale of the model you are searching for. Usage VGet Sequence.Object .ScaleTarget, var VSet Sequence.Object .ScaleTarget, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or[...]

  • Page 154

    Score Result Score Result Applies To Vision Objects: Correlation, Edge, Geom etric, Polar Description Returns an integer value which represents the level at with the runtim e image matches the m odel for which it is searching. (In the case of the Edge object the Score result m easures the level at which a contrast between Light to Dark or Dark to L[...]

  • Page 155

    ScoreWeightContrast Property ScoreWeightContrast Property Applies To Vision Objects: Edge Description Sets the percentage of the score that depends on contrast. Usage VGet Sequence.Object .ScoreWeightContrast, var VSet Sequence.Object .ScoreWeightContrast, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name[...]

  • Page 156

    ScoreWeightStrength Property ScoreWeightStrength Property Applies To Vision Objects: Edge Description Sets the percentage of the score that depends on edge strength. Usage VGet Sequence.Object .ScoreWeightStrength, var VSet Sequence.Object .ScoreWeightStrength, value Sequence Name of a sequence or string variable containing a sequence nam e. Object[...]

  • Page 157

    SearchWidth Property SearchWidth Property Applies To Vision Objects: Edge Description The SearchWidth property specifies the wi dth of the search for Edge objects. Usage VGet Sequence . Object . SearchWidth , var VSet Sequence.Object. SearchWidth , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an o[...]

  • Page 158

    SearchWin Property SearchWin Property Runtime only Applies To Vision Objects: Blob, Correlation, ImageO p Description Defines the position and size of a search window. Usage VGet Sequence.Object .SearchWin, LeftVar, TopVar, WidthVar, HeightVar VSet Sequence.Object .SearchWin, LeftVar , TopVar, WidthVar, HeightVar Sequence Name of a sequence or stri[...]

  • Page 159

    SearchWinHeight Property SearchWinHeight Property Applies To Vision Objects: Blob, Correlation, Geom etric, ImageOp Description Defines the height of an object's search window . Usage VGet Sequence.Object . SearchWinHeight , var VSet Sequence.Object . SearchWinHeight , value Sequence Name of a sequence or string variable containing a sequence [...]

  • Page 160

    SearchWinLeft Property SearchWinLeft Property Applies To Vision Objects: Blob, Correlation, Geom etric, ImageOp Description Defines the X coordinate of the left side of an object's search w indow. Usage VGet Sequence.Object . SearchWinLeft , var VSet Sequence.Object . SearchWinLeft , value Sequence Name of a sequence or string variable contain[...]

  • Page 161

    SearchWinTop Property SearchWinTop Property Applies To Vision Objects: Blob, Correlation, Geom etric, ImageOp Description Defines the Y coordinate of the top of an object's search w indow. Usage VGet Sequence.Object .SearchWinTop, var VSet Sequence.Object .SearchWinTop, value Sequence Name of a sequence or string variable containing a sequence[...]

  • Page 162

    SearchWinWidth Property SearchWinWidth Property Applies To Vision Objects: Blob, Correlation, Geom etric, ImageOp Description Defines the width of the an object's search w indow. Usage VGet Sequence.Object . SearchWinWidth , var VSet Sequence.Object . SearchWinWidth , value Sequence Name of a sequence or string variable containing a sequence n[...]

  • Page 163

    SeparationAngle Property SeparationAngle Property Applies To Vision Objects: Geometric Description Sets / returns the minim um angle allowed between found objects. Usage VGet Sequence.Object .SeparationAngle, var VSet Sequence.Object .SeparationAngle, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of a[...]

  • Page 164

    SeparationMinX Property SeparationMinX Property Applies To Vision Objects: Geometric Description Sets / returns the minim um distance along the X axis allowed between found objects. Usage VGet Sequence.Object .SeparationMinX, var VSet Sequence.Object .SeparationMinX, value Sequence Name of a sequence or string variable containing a sequence nam e. [...]

  • Page 165

    SeparationMinY Property SeparationMinY Property Applies To Vision Objects: Geometric Description Sets / returns the minim um distance along the Y axis allowed between found objects. Usage VGet Sequence.Object .SeparationMinY, var VSet Sequence.Object .SeparationMinY, value Sequence Name of a sequence or string variable containing a sequence nam e. [...]

  • Page 166

    SeparationScale Property SeparationScale Property Applies To Vision Objects: Geometric Description Sets / returns the minim um scale difference allowed between found objects. Usage VGet Sequence.Object .SeparationScale, var VSet Sequence.Object .SeparationScale, value Sequence Name of a sequence or string variable containing a sequence nam e. Objec[...]

  • Page 167

    SharedEdges Property SharedEdges Property Applies To Vision Objects: Geometric Description Sets / returns whether to allow edges to be shared between found objects. Usage VGet Sequence.Object .SeparationScale, var VSet Sequence.Object .SeparationScale, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of [...]

  • Page 168

    ShowAllResults Result ShowAllResults Result Designtime only Applies To Vision Objects: Blob, Correlation, Edge, Geom etric Description A button is placed in the ShowAllResults result value field which when clicked opens a dialog which shows all the results for this vision object. Remarks The ShowAllResults result is a special type of results which [...]

  • Page 169

    ShowExtensions Property ShowExtensions Property Applies To Vision Objects: Line Description By default, Line objects display a line from a starting re ference (defined by the StartPointObject property) to an ending reference (defined by the EndPointObj ect property). The ShowExtensions property causes the graphics display of the line to be extended[...]

  • Page 170

    ShowModel Property ShowModel Property Designtime only Applies To Vision Objects: Correlation, Geom etric, Polar Description The ShowModel property allows a previously taught mode l to be displayed at various zoom settings. You can also change the model orgin and don’t care pixels for som e models. Remarks Correlation and Geometric Objects: You ca[...]

  • Page 171

    ShowModel Property See Also Correlation Object, Geometric Obj ect, Object Tab, Polar Object Vision Guide 5.0 Reference (Ver.5.3) Rev.1 157[...]

  • Page 172

    ShowProcessing Property ShowProcessing Property Applies To Vision Sequence Description Determines whether im age processing should be displayed with RunTimeFreeze set to True. Usage VGet Sequence . ShowProcessing , var VSet Sequence . ShowProcessing , value Sequence Name of a sequence or string variable containing a sequence nam e. var Boolean vari[...]

  • Page 173

    SizeToFind Property SizeToFind Property Applies To Vision Objects: Blob Description Selects which size of blobs to find. Usage VGet Sequence.Object . SizeToFind , var VSet Sequence.Object . SizeToFind , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object [...]

  • Page 174

    Smoothness Property Smoothness Property Applies To Vision Objects: Geometric Description Sets / returns the smoothness level for the geom etric edge extraction filter. Usage VGet Sequence.Object .Smoothness, var VSet Sequence.Object .Smoothness, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an obje[...]

  • Page 175

    Sort Property Sort Property Applies To Vision Objects: Blob, Correlation, Geom etric Description Sets or returns the sort order us ed for the results of an object. Usage VGet Sequence.Object . Sort , var VSet Sequence.Object . Sort , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string[...]

  • Page 176

    StartPntObjResult Property StartPntObjResult Property Applies To Vision Objects: Edge, Line Description Specifies which result to use from the StartPointObject. Usage VGet Sequence.Object . StartPntObjResult , var VSet Sequence.Object .StartPntObjResult , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name [...]

  • Page 177

    StartPointObject Property StartPointObject Property Applies To Vision Objects: Edge, Line Description Specifies the vision object to connect the starting point of the Line to. (i.e. This property defines the position of the start point of the line.) Usage VGet Sequence.Object . StartPointObject , var VSet Sequence.Object . StartPointObject , value [...]

  • Page 178

    StartPointType Property StartPointType Property Applies To Vision Objects: Edge, Line Description Specifies the type of start point to use for the line object . In m ost cases the start point type will be a point (which usually means the PixelX and PixelY position of the StartPointObject). However, when the StartPointObject for the current line is [...]

  • Page 179

    StartPointType Property Remarks As you can see in the Values Table above, m ost of the StartPointObject's support only 1 StartPointType called Point. This is because most StartPointObject ' s use the PixelX and PixelY position for a reference position for defining a Start or End Point for a line. So when the StartPointObject is defined as[...]

  • Page 180

    Strength Result Strength Result Applies To Vision Objects: Edge Description Returns the strength of the found Edge. Usage VGet Sequence.Object .Strength, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object name. The object must exist in the specified sequen[...]

  • Page 181

    StrengthTarget Property StrengthTarget Property Applies To Vision Objects: Edge Description Sets the desired edge strength to search for. Usage VGet Sequence.Object .StrengthTarget, var VSet Sequence.Object .StrengthTarget, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable [...]

  • Page 182

    StrengthVariation Property StrengthVariation Property Applies To Vision Objects: Edge Description StrengthVariation is the tolerance for the StrengthTarget property. Usage VGet Sequence.Object .StrengthVariation, var VSet Sequence.Object .StrengthVariation, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Nam[...]

  • Page 183

    TargetSequence Property TargetSequence Property Applies To Vision Calibration Description Specifies the vision sequence that is used to find the calibration target(s) during calibration. Usage VGet Calibration. TargetSequence, var VSet Calibration. TargetSequence, value Calibration Name of a calibration or string variable containing a calibration n[...]

  • Page 184

    Thickness Property Thickness Property Applies To Vision Objects: Polar Description Defines the thickness (in pixels) of the ring used for the Polar object. Thickness Radius Usage VGet Sequence.Object .Thickness, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an [...]

  • Page 185

    ThresholdColor Property ThresholdColor Property Applies To Vision Objects: Blob, ImageO p Description Sets or returns the color of the pixels whose gray values fall between the ThresholdHigh and ThresholdLow properties. Usage VGet Sequence.Object . ThresholdColor , var VSet Sequence.Object .ThresholdColor , value Sequence Name of a sequence or stri[...]

  • Page 186

    ThresholdHigh Property ThresholdHigh Property Applies To Vision Objects: Blob, ImageO p Description Sets or returns the ThresholdHigh value for a Blob or ImageOp object. Usage VGet Sequence.Object . ThresholdHigh , var VSet Sequence.Object .ThresholdHigh , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name[...]

  • Page 187

    ThresholdLow Property ThresholdLow Property Applies To Vision Objects: Blob, ImageO p Description Sets or returns the ThresholdLow value for a Blob or ImageOp object. Usage VGet Sequence.Object . ThresholdLow , var VSet Sequence.Object .ThresholdLow , value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of a[...]

  • Page 188

    Time Result Time Result Applies To Vision Sequence Vision Objects: Blob, Correlation, Edge, Geom etric, Polar Description Returns the amount of time (in m illiseconds) required to process the associated vision object or vision sequence. Usage VGet Sequence.Object .Time, var VGet Sequence .Time, var Sequence Name of a sequence or string variable con[...]

  • Page 189

    Timeout Property Timeout Property Applies To Vision Objects: Geometric Description Sets / returns the maxim um search time for a Geometric object. Usage VGet Sequence.Object .Timeout, var VSet Sequence.Object .Timeout, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable conta[...]

  • Page 190

    TotalArea Result TotalArea Result Applies To Vision Objects: Blob Description Returns the sum of areas of all results. Usage VGet Sequence.Object .TotalArea, var Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object name. The object must exist in the specified se[...]

  • Page 191

    TriggerMode Property TriggerMode Property Applies To Vision Sequence Description Specifies the type of trigger signal transition used for electronic shutter release acquisition. Usage VGet Sequence . TriggerMode , var VSet Sequence . TriggerMode , value Sequence Name of a sequence or string variable containing a sequence nam e. var Integer variable[...]

  • Page 192

    TwoRefPoints Property TwoRefPoints Property Applies To Vision Calibration Description Sets / returns whether a calibration should use two reference points instead of one. Usage VGet Calibration. TwoRefPoints, var VSet Calibration. TwoRefPoints, value Calibration Name of a calibration or string variable containing a calibration nam e. var Boolean va[...]

  • Page 193

    UpwardLamp Property UpwardLamp Property Applies To Vision Calibration Description Sets / returns the I/O output bit used for the calibration upward camera lam p. Usage VGet Calibration. UpwardLamp, var VSet Calibration. UpwardLamp, value Calibration Name of a calibration or string variable containing a calibration nam e. var Integer variable that w[...]

  • Page 194

    UpwardSequence Property UpwardSequence Property Applies To Vision Calibration Description UpwardSequence specifies the sequence used by an upw ard looking camera for a mobile calibration target reference. Usage VGet Calibration. UpwardSequence, var VSet Calibration. UpwardSequence, value Calibration Name of a calibration or string variable containi[...]

  • Page 195

    VGet Statement VGet Statement Applies To Vision Sequence Vision Calibration Vision Objects: All Description VGet is used to get the values of proper ties and results in SPEL+ and VB Guide. Usage VGet Sequence . Property, var VGet Calibration . Property, var VGet Sequence . Object . Property, var VGet Sequence . Object . Result [ ( resultIndex ) ] ,[...]

  • Page 196

    VGet Statement Remarks VGet is a powerful part of the Vision Guide structure. It provides the core mechanism to get the property and result values from the vision objects that are run from vision sequences. VGet can be used to get property values before running a vision sequence so that you can check the value of a specific property or even check a[...]

  • Page 197

    VRun Statement VRun Statement Applies To Vision Sequence Description VRun is a SPEL + language statem ent used to initiate execution of vision sequences which were created in the Vision Guide development environm ent. Usage VRun Sequence Sequence Name of a sequence or string variable containing a sequence nam e. Remarks Once a vision sequence has b[...]

  • Page 198

    VSet Statement VSet Statement Applies To Vision Sequence Vision Calibration Vision Objects: All Description VSet is used to set the values of properties from the SPEL + Language. Usage VSet Sequence.Property, value VSet Calibration.Property, value VSet Sequence . Object.Property, value Sequence Name of a sequence or string variable containing a seq[...]

  • Page 199

    VSet Statement Remarks VSet is used to set property values for vision sequences, calibrations, and objects from the SPEL + language. For many vision sequences all the proper property settings will be set from within the Vision Guide development environm ent. However, there are also tim es when you will want to set property values in a SPEL + progra[...]

  • Page 200

    X Property X Property Applies To Vision Objects: Point Description Defines the X coordinate of a Point object. Usage VGet Sequence.Object .X, var VSet Sequence.Object .X, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object name. The object must exist in t[...]

  • Page 201

    X1 Property X1 Property Applies To Vision Objects: Edge, Line Description Defines the X1 coordinate of an object where the (X 1, Y1) coordinate pair defines the position of the starting point of the object. Usage VGet Sequence.Object .X1, var VSet Sequence.Object .X1, value Sequence Name of a sequence or string variable containing a sequence nam e.[...]

  • Page 202

    X2 Property X2 Property Applies To Vision Objects: Edge, Line Description Defines the X2 coordinate of an object where the (X 2, Y2) coordinate pair defines the position of the starting point of the object. Usage VGet Sequence.Object .X2, var VSet Sequence.Object .X2, value Sequence Name of a sequence or string variable containing a sequence nam e.[...]

  • Page 203

    XAvgError Result XAvgError Result Applies To Vision Calibration Description Returns the average calibration error along the X axis. Usage VGet Calibration . XAvgError, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Values Real number in m illimete[...]

  • Page 204

    XMaxError Result XMaxError Result Applies To Vision Calibration Description Returns the maxim um calibration error along the X axis. Usage VGet Calibration . XMaxError, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Values Real number in m illimet[...]

  • Page 205

    XmmPerPixel Result XmmPerPixel Result Applies To Vision Calibration Description Returns the X millim eters/pixel value of the specified calibration. Usage VGet Calibration . XmmPerPixel, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Values Real n[...]

  • Page 206

    XTilt Result XTilt Result Applies To Vision Calibration Description Returns the calibration X tilt result. Usage VGet Calibration . XTilt, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Remarks XTilt is a relative value that indicates camera tilt [...]

  • Page 207

    Y Property Y Property Applies To Vision Objects: Points Description Defines the Y coordinate of a Point object. Usage VGet Sequence.Object .Y, var VSet Sequence.Object .Y, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or string variable containing an object nam e. The object must exist in[...]

  • Page 208

    Y1 Property Y1 Property Applies To Vision Objects: Edge, Line Description Defines the Y1 coordinate of an object where the (X 1, Y1) coordinate pair defines the position of the starting point of the object. Usage VGet Sequence.Object .Y1, var VSet Sequence.Object .Y1, value Sequence Name of a sequence or string variable containing a sequence nam e.[...]

  • Page 209

    Y2 Property Y2 Property Applies To Vision Objects: Edge, Line Description Defines the Y2 coordinate of an object where the (X 2, Y2) coordinate pair defines the position of the starting point of the object. Usage VGet Sequence.Object .Y2, var VSet Sequence.Object .Y2, value Sequence Name of a sequence or string variable containing a sequence nam e.[...]

  • Page 210

    YAxisPntObjResult Property YAxisPntObjResult Property Applies To Vision Objects: Frame Description Specifies which result to use from the YAxisPointObject. Usage VGet Sequence.Object .YAxisPntObjResult, var VSet Sequence.Object .YAxisPntObjResult, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an ob[...]

  • Page 211

    YAxisPoint Property YAxisPoint Property Applies To Vision Objects: Frame Description Defines the vision object to be used as the Y axis point for a Frame object. Usage VGet Sequence.Object .YAxisPoint, var VSet Sequence.Object .YAxisPoint, value Sequence Name of a sequence or string variable containing a sequence nam e. Object Name of an object or [...]

  • Page 212

    YAxisPoint Property Frame Object, Fram e Property, Ob ject Tab, OriginPoint Property 198 Vision Guide 5.0 Reference (Ver.5.3) Rev.1[...]

  • Page 213

    YAvgError Result YAvgError Result Applies To Vision Calibration Description Returns the average calibration error along the Y axis. Usage VGet Calibration . YAvgErr, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Values Real number in m illimeters[...]

  • Page 214

    YMaxError Result YMaxError Result Applies To Vision Calibration Description Returns the maxim um calibration error along the Y axis. Usage VGet Calibration . YMaxErr, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Values Real number in m illimeter[...]

  • Page 215

    YmmPerPixel Result YmmPerPixel Result Applies To Vision Calibration Description Returns the Y millim eters/pixel value of the specified calibration. Usage VGet Calibration . YmmPerPixel, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Values Real n[...]

  • Page 216

    YTilt Result 202 Vision Guide 5.0 Reference (Ver.5.3) Rev.1 YTilt Result Applies To Vision Calibration Description Returns the calibration Y tilt result. Usage VGet Calibration . YTilt, var Calibration Name of a calibration or string variable containing a calibration nam e. var Real variable that will contain the value of the result. Remarks YTilt [...]