IMAQ Flatten Image to String VI
Owning Palette: Image ManagementInstalled With: NI Vision Development ModuleReturns the string representation of an image using the provided options.
Image is a reference to the source image. |
|||||||
Compression (None) specifies the compression method to use when flattening the image to a string. The following values are valid:
|
|||||||
Type of Flatten (Image and Vision Info) specifies what type of data to store in the string. The following values are valid:
|
|||||||
error in (no error) describes the error status before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
|
|||||||
Quality (750) specifies the quality of the image stored in the string. The default value is 750. Quality is a measure of the compression method, such that a lower compression factor results in higher image quality. The allowable range for Quality is 0 to 1000. As you lower the Quality value, you increase the amount of loss that occurs during compression.
|
|||||||
Data String is the LabVIEW string containing the string representation of the image. Use the Unflatten from String LabVIEW primitive to convert this string back to an image. If an image has the same name as the flattened image in memory, when the string is unflattened, the contents of the flattened image string are copied to the image. Otherwise, a new image with a unique name is created that contains the contents of the flattened image string. |
|||||||
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
|