HIOUtilityMagick

Functions

~HIOUtilityMagick

const char *

GetOutputName

const char *

GetInputName

void

RegisterInputHandlerTypes

HInputHandlerStyle

GetInputStyle

const char *

GetInputTypesString

HFileIOResult

FileInputToImageKey

HFileIOResult

FileInputToImageKey

HFileIOResult

FileInputToImageKey

void

RegisterOutputHandlerTypes

HOutputHandlerStyle

GetOutputStyle

const char *

GetOutputTypesString

HFileIOResult

FileOutputFromImageKey

HFileIOResult

FileOutputFromImageKey

HFileIOResult

FileOutputFromImageKey

HIOUtilityMagick

Detailed Description

class HIOUtilityMagick : public HInputHandler, public HOutputHandler

HIOUtilityMagick is the integration class for the ImageMagick toolkit. This integration is supported on all HOOPS platforms.

The windows distribution of HOOPS/3dF redistributes the ImageMagick development libraries for WIN32. These are located in Dev_Tools/3rdParty/ImageMagick.

For information on ImageMagick see: http://www.imagemagick.org/

Public Functions

~HIOUtilityMagick()
virtual const char *GetOutputName()
Returns

A character pointer denoting the name of the handler.

virtual const char *GetInputName()
Returns

A character pointer denoting the name of the input handler.

virtual void RegisterInputHandlerTypes()

This method registers the image types that are supported by ImageMagick for reading.

virtual HInputHandlerStyle GetInputStyle()
Returns

The type of input style which is HInputHandlerStyleImage.

virtual const char *GetInputTypesString()
Returns

The input extension types that are handled by HIOUtilityMagick which include “jpeg”, “gif”, “bmp” and “tif”.

virtual HFileIOResult FileInputToImageKey(const __wchar_t *filename, HC_KEY *image_key, HC_KEY segment_key, HInputHandlerOptions *options)

This method maps the data in the image file to a HOOPS image defined by image_key.

Parameters
  • FileName – A character pointer denoting the name of the image file to read from.

  • image_key – The pointer to a HOOPS key that will be filled in with a HOOPS image key.

  • segment_key – The HOOPS segment key to create the image_key in i.e. the working segment.

  • options – The file input options.

Returns

The #HFileOutputResult result of the operation.

virtual HFileIOResult FileInputToImageKey(const unsigned short *filename, HC_KEY *image_key, HC_KEY segment_key, HInputHandlerOptions *options)

This method loads image data from a given file to a given HOOPS image key. Note that this must be implemented in a sub-classed HInputHandler instance handling Images.

Parameters
  • filename – The UNICODE name of the file to load.

  • image_key – The pointer to a HOOPS key that will be filled in with a HOOPS image key.

  • segment_key – The HOOPS segment key to create the image_key in — i.e., the working segment.

  • options – An options class containing any needed extra information for operation.

Returns

The HFileInputResult result of the input operation.

virtual HFileIOResult FileInputToImageKey(const char *filename, HC_KEY *image_key, HC_KEY segment_key, HInputHandlerOptions *options)

This method loads image data from a given file to a given HOOPS image key. Note that this must be implemented in a sub-classed HInputHandler instance handling Images.

Parameters
  • filename – The name of the file to load.

  • image_key – The pointer to a HOOPS key that will be filled in with a HOOPS image key.

  • segment_key – The HOOPS segment key to create the image_key in ie. the working segment.

  • options – An options class containing any needed extra information for operation.

Returns

The HFileInputResult result of the input operation.

virtual void RegisterOutputHandlerTypes()

This method registers the image types supported by the Raster Pro toolkit for writing.

virtual HOutputHandlerStyle GetOutputStyle()
Returns

The type of output style which is HOutputHandlerStyleImage.

virtual const char *GetOutputTypesString()
Returns

The output extension types that are handled by HIOUtilityMagick which include “jpeg”, “gif”, “bmp” and “tif”.

virtual HFileIOResult FileOutputFromImageKey(const __wchar_t *filename, HC_KEY image_key, HOutputHandlerOptions *options)

This method exports the raster data contained in image_key to a file. It uses the file extension to determine what type of raster image to create.

Parameters
  • filename – The name of the file to output.

  • image_key – The HOOPS image key to get output image data from.

  • options – The options class containing any needed extra information for the operation.

Returns

The #HFileOutputResult result of the output operation.

HFileIOResult FileOutputFromImageKey(const unsigned short *filename, HC_KEY image_key, HOutputHandlerOptions *options)
virtual HFileIOResult FileOutputFromImageKey(const char *filename, HC_KEY image_key, HOutputHandlerOptions *options)

This method writes image data from a given HOOPS key to a given output file. Note that this must be implemented in a subclassed HOutputHandler instance handling images. This must be implemented in a subclassed HOutputHandler instance handling images.

Parameters
  • filename – The name of the file to output.

  • image_key – The HOOPS image key to get output image data from.

  • options – The options class containing any needed extra information for the operation.

Returns

The #HFileOutputResult result of the output operation.

HIOUtilityMagick()

Constructs an HIOUtilityMagick object.