Skip to content

Workflow for structured light🔗

  1. Create a structured light model.

    Create a structured light model using

    or read it with

    or read it with

  2. Set the model parameters.

    Set the different structured light model parameters with

    or query them with

    The pattern parameters 'pattern_width', 'pattern_height', 'pattern_orientation', and 'pattern_type', along with the stripe parameters 'min_stripe_width' and 'single_stripe_width', specify the pattern images to be used to illuminate the surface.
    To debug intermediate results, enable the 'persistence' parameter.

  3. Generate the pattern images.

    After setting all relevant parameters, generate the pattern images with

    Make sure that the output images are suitable for the particular setup.

  4. Use the patterns to illuminate the surface and acquire the camera images.

    At this stage, the pattern images are shown on the display. The respective image of the illuminated surface is acquired by the camera for each pattern image.

  5. Decode the acquired images.

    Decode the acquired CameraImages with

    When calling this operator, the correspondence images are created and stored in the model StructuredLightModel.

  6. Get the results.

    The decoded 'correspondence_image' and the 'defect_image', as well as other results can be queried with

    The decoded 'correspondence_image' and the 'defect_image', as well as other results can be queried with

    Obtain the reconstructed surface using

Further operators🔗

The structured light model offers various other operators that help access and update the various parameters of the model.

The operator write_structured_light_model enables writing the structured light model to a file. Note that previously generated pattern images are not written in this file.
A structured light model file can be read using read_structured_light_model.

Furthermore, it is possible to serialize and deserialize the structured light model using serialize_structured_light_model and deserialize_structured_light_model.