Accusoft.ImagXpress13.Net
Specify Load Options

Load options (LoadOptions) can be used, if desired, to provide specific instructions when loading an image from file or from stream. If no load options are specified, ImagXpress® uses default values when loading the image.

General Load Options

When more than one of these operations is requested, the order is:

  1. LoadCrop

    Image is cropped to the dimensions specified in CropRectangle. If the dimensions specified are all zeros or null, then no crop occurs when loading.

  2. LoadResize

    Whether the image resizes when loading (Resize). If the parameters are all zeros or null, then no resize occurs when loading. Whether the image aspect ratio will be preserved when loading an image (MaintainAspectRatio).

  3. LoadRotate 

    Whether image is rotated upon loading (Rotation property).

Colorspace Conversions

CMYK Conversion - If a CMYK Tiff image file is loaded into ImagXpress, it is automatically converted to RGB. The application can use the ICM properties to control the CMYK conversion process.

Image Color Management Loading Options

When loading an image into an ImageX object, you can specify how color management is applied.


FTP Loading Options

If username/passwords and proxy settings are needed, set InternetOptions.  

Image Format-Specific Load Options 

CAD (LoadOptionsCad)

JBIG2 (LoadOptionsJbig2)

JPEG (LoadOptionsJpeg)

JpegXR (LoadOptionsJpegXR)

PIC (LoadOptionsPic)

Metafile (LoadOptionsMetafile)

TIFF (LoadOptionsTiff)

Difference Between RAW and Camera Raw

RAW files are uncompressed images that have the image data stored separately from the image header describing the data. This is common in medical and DICOM images. However it is not limited to that environment as the image header and image data may be stored separately in a database. Camera Raw is one of many camera manufacturer's proprietary image file format of the raw analog-to-digital conversion data. This is typically greater than 8-bits per channel. Most camera manufacturer's use a proprietary format that was adapted from an existing file format such as TIFF. For this reason, ImagXpress usually takes additional time verifying the file format when CameraRaw is enabled.

Using the LoadRaw method for loading in a RAW file:

  1. Set LoadOptions.LoadMode to raw, in order to treat the image data as a raw format when loading.
  2. Use the remaining properties within the LoadOptionsRaw class to specify how data loads from the raw data format.
  3. When the image is loaded, the data will be interpreted using the LoadOptionsRaw properties.  

Versus...

Loading a camera manufacturer's proprietary raw image file format:

The ImagXpress control has the ability to inspect an image when loading to determine that an image is in a camera raw format, identify the specific camera raw format of the image, and load the image using that format. 

  1. Make sure that the LoadOptions.LoadMode property is set to Normal, in order to inspect the image data when loading to determine format.
  2. Set LoadOptions.CameraRawEnabled = True to specify that the image should be examined on loading to see if the data is in a camera raw format, and to identify the raw format. 
  3. Load the image, using one of the load methods (e.g. FromFile). The image will be inspected to see if it is in a CameraRaw format as part of the loading process. The image will be decoded using the specific camera raw format detected.

To optimize performance, set CameraRawEnabled to False when it is not needed.

When CameraRawEnabled = True, the image can only be loaded from a file. Loading from a stream is not supported as the entire image must be loaded before the raw format can be recognized.
See Also

 

 


©2017. Accusoft Corporation. All Rights Reserved.

Send Feedback