SamplingGroup Properties

Choose how to sample colors for the point cloud. The `rgb` option gives a 2D image with full colors. The `grayscale` option gives a grayscale (r=g=b) 2D image, which can be acquired faster than full colors. The `disabled` option gives no colors and can allow for even faster captures. The `grayscale` option is not available on all camera models. This setting is deprecated as of SDK 2.14. This setting will be removed in the next SDK major version (SDK 3.0). The recommended way to do a 2D+3D capture is to set a `Settings2D` object in the `Settings/Color` field. Tip: If you want to convert an existing settings.yml file to the recommended API, you can import the .yml file into Zivid Studio and then re-export it to .yml.

For Zivid 2/2+, this setting controls whether to read out the full image sensor and use white projector light or to subsample pixels for specific color channels with corresponding projector light. Picking a specific color channel can help reduce noise and effects of ambient light - projecting blue light is recommended. For Zivid 2+R, the user does not have to set the projection color and should only consider whether to scale the resolution `by2x2` or `by4x4`. Both of these modes will boost the signal strength by about 4x compared to `all`, so the user should consider a corresponding reduction in exposure time. Sampling at a decreased resolution decreases capture time, as less data will be captured and processed.