ImageGear for C and C++ on Windows v19.1 - Updated
IG_vect_raster_set_filename
API Reference Guide > Vector Component API Reference > Vector Component Functions Reference > Raster Functions > IG_vect_raster_set_filename

This function attaches a file name to the raster entity to allow saving it as a reference for DWG, DXF and SVG formats.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_vect_raster_set_filename(
      HIG_VECT_ENTITY hEntity, 
      LPCHAR lpName 
);

Arguments:

Name Type Description
hEntity HIG_VECT_ENTITY Handle to the Entity.
lpName LPCHAR Referenced file name.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Remarks:

For DWG and DWF formats, this function can specify either a disk file name or a URL.

If raster file name is an empty string, or starts with "data:image", SVG filter embeds raster data to the image file, otherwise it saves it in a separate file, using the format specified by IG_vect_raster_set_fileformat, and references it in the vector file.

According to SVG specification, readers shall support at least PNG and JPEG formats.

DWG/DXF specifications do not list supported raster formats, but most readers support at least PNG and JPEG.