new_image__ ( : Image : Type, Width, Height : )

Create an unused image.

The operator new_image__ creates an image of the indicated size. The height and width of the image are determined by Height and Width. HORUS supports the following image types:

                 'byte'    (1 byte per pixel, value area: 0..255)
	           'int1'    (1 byte per pixel, signed)
	           'int2'    (2 bytes per pixel, signed)
	           'int4'    (4 bytes per pixel, signed)
	           'real'    (4 bytes per pixel)
	           'complex' (two 'real' matrices)
	           'dvf'     (two 'int1' matrices)
	           'dir'     (1 byte per pixel, value area: 0..180))
	           'cyclic'  (1 byte per pixel; cyclic value area: 0..255)).
The default value 0 is set via the operator set_system(::'init_new_image','true'/'false':).


Parameters

Image (output_object)
image -> object
Created image with new image matrix.

Type (input_control)
string -> string
Pixel type
Default value: 'byte'
List of values: 'int1', 'int2', 'int4', 'byte', 'real', 'direction', 'cyclic', 'complex', 'dvf', 'lut'

Width (input_control)
extent.x -> integer
Width of image
Default value: 512
Suggested values: 128, 256, 512, 1024
Range of values: 1 <= Width <= 512 (lin)
Minimum increment: 1
Recommended increment: 10
Restriction: Width >= 1

Height (input_control)
extent.y -> integer
Height of image
Default value: 512
Suggested values: 128, 256, 512, 1024
Range of values: 1 <= Height <= 512 (lin)
Minimum increment: 1
Recommended increment: 10
Restriction: Height >= 1


Example
new_image__(&New,"byte",width,height);
get_image_pointer__(New,(long*)&pointer,"byte",width,height);
for (row=0; row
Result

If the parameter values are correct, the operator new_image__ returns the value TRUE. Otherwise an exception is raised.


Possible Successors

paint_region__, reduce_domain, get_image_pointer__, copy_obj


Alternatives

create_image, create_image3


See also

reduce_domain, paint_grey__, paint_region__, set_greyval__, get_image_pointer__



Copyright © 1996-1997 MVTec Software GmbH