====== CreateImage ======
This logic creates simple arbitrary 2D or 3D (geometric) objects of a specified size. These objects can be used as example data or masks during image processing. The objects are binary, which means that all pixel values are either set to one (white pixel) or zero (black pixel).

===== Usage =====
Will create an image of a geometrical object with pixel values of 1. The created shape or volume is either mass-centered or x/y/z shifted (in pixel) relative to the center of the canvas/volume, if the respective parameters are set. To mask any image or volume with the created image/volume, create a “mask” with this CreateImage logic, setting the same dimensions (DimX/Y/Z) as your original image(s) / volume(s) which is/are to be masked. Subject the output of this logic to the [[eyes:logics:arithmeticswithtwoimages]] logic to multiply (a stack of) image(s)/ volume(s) with your mask. Areas which are black (pixel value = 0) within the mask image/volume will be erased from the original image(s) / volume(s). 

===== Parameters and I/O =====
Several types of shapes/volumes may be created: 

|< 100% 30% >|
^ Shape                 ^ Dimensionality ^
| disc                  | 2D             | 
| sphere                | 3D             | 
| rectangle             | 2D             | 
| cuboid                | 3D             | 
| cylinder              | 3D             | 

|< 100% 30% >|
^ Parameters              ^ Description     ^
| Image size X            | Size of canvas/volume in x direction       |
| Image size Y            | Size of canvas/volume in y direction       |
| Image size Z            | Size of canvas/volume in z direction       |
| Depth [percent/pixel]   | Depth of created object in pixels or percent of the total canvas/volume size (z-axis) |
| Height [percent/pixel]  | Height of created object in pixels or percent of the total canvas/volume size (y-axis) |
| Width [percent/pixel]   | Width of created object in pixels or percent of the total canvas/volume size (x-axis) |
| X shift from center     | Shift on x-axis in pixel, can be positive and negative regarding the direction |
| Y shift from center     | Shift on y-axis in pixel, can be positive and negative regarding the direction |
| Z shift from center     | Shift on y-axis in pixel, can be positive and negative regarding the direction |