CollectPattern¶
This command searches for a calibration pattern of the size specified in Pattern and puts it into the pattern buffer. If you set the DecodeData parameter to true, the global Pattern setting will be ignored and the pattern will be inserted into the buffer with its decoded size.
In addition to putting them into the pattern buffer, the command also returns the detected patterns in the Patterns result node. The command will also try to match all patterns detected in the left image with the patterns from the right image. If such a match is found the pattern will also be listed in the Stereo result node.
Note
Each pattern’s grid spacing will be stored together with the pattern point coordinates in the global pattern buffer. The grid spacing is either determined by decoding the pattern’s dot centers when specifying DecodeData as true, or by the global GridSpacing parameter.
Note
Please note that you should always clear the pattern buffer with DiscardPatterns before collecting a new pattern while tracking a non-static pattern pose.
Note
You cannot detect patterns on images where the camera’s projector is on, unless you use the Projector parameter.
Error Symbols
PatternNotFound |
Cause: The calibration pattern of the defined size could not be located in both images, possible problems preventing the correct pattern detection are:
Solution: Make sure the pattern is clearly and completely visible in both camera images. Replace or clean the pattern if it’s damaged. |
PatternNotDecodable |
Cause: The DecodeData parameter was specified as true but the pattern data could not be read. Possible causes for decoding problems could be:
Solution: Ensure that the data dots are visible and not damaged in at least one of the images. Replace or clean the pattern, if the data dots are corrupted. |