Module: Points_To_Image

Description:

From a set of input points, creates an image where all pixels containing an input point has a given value distinct from the other pixels. Pixel values for those containing points from the input cluster can have a constant value, or take the value from a given data column in the input point set. All those not containing any pixel will have a constant value (that is specified).

Position and dimensions of the output image can be defined manually in the corresponding ports, or if an input image is connected, it will be used as reference.

Left image: input point set, and bounding box of the output image. Right: tagged voxels in the output image (note the anisotropic volex size), and bounding box of the input point set.
NOTES :

If you want your output image to have a particular transformation matrix (e.g. with some specific rotation or scaling), this can only be achieved by connecting an input image, the transformation matrix cannot be set manually.
If several points map to the same output pixel and pixel greylevel is set to a given input point cluster data column, then the output value will be the data associated to the first point in the point set. If in verbose mode (see the Commands section), a message is printed in the console each time this happens. Also, a message at the end displays the number of pixels tagged in the output, so substracting the number of input points by this value will give you the number of collisions.

Connections:

Points

[required]
The input points, a HxCluster.

Image

[optional]
The input image, an instance of HxUniformScalarField3.

Ports:

Data

Type of data for the output pixels containing input points. It can either be a constant value, or values taken from a data column in the input point set (if data columns are defined).

Values

Values used for the output pixels, respectively for those containing a point (if constant data is set in previous port), and those not containing any point.

Column

If Data column type is set in Data port, then this port specifies the index of the column to use. The output data type will be set accordingly.

Origin

If no input image is connected, you must position the output image. Origin of the bounding box of the image.

Box

Size of the bounding box of the image.

Resolution

Number of pixels in the X, Y, and Z directions.

Action button

Push this button to create the image.

Commands:

Additional options can be accessed when typing in the console Points_To_Image COMMAND_NAME.

`verbose`

Displays various information. Retype to hide info.

`create`

Runs the computation. Returns the name of the output, so it can be used in a script, such as set RESULT [Points_To_Image create].