Skip to main content
This object provides functionality for tuning the parameters of saving a black-and-white image to PNG format (IFF_Png format) using the IImage::WriteToFile method. A pointer to this object is passed into the IImage::WriteToFile method as an input parameter, and thus affects the properties of the resulting image. All properties of a newly created object of this type are set to reasonable defaults. See the description of particular property for its default value. The PngExtendedParams object is a persistent object. This means that the object’s current state can be written to persistent storage. Later, the object can be re-created by reading the object’s state from the persistent storage. The following methods provide persistence of the object: Linux: SaveToFile, and LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory, and LoadFromMemory.

Properties

NameTypeDescription
ApplicationEngine, read-onlyReturns the Engine object.
TransparentColorintSets the color which must be replaced by transparent areas when saving the image in PNG format. Only black and white colors are currently supported. <Note> The int value is calculated from the RGB triplet using the formula: ( red value ) + (256 x green value ) + (65536 x blue value ), where red value is the first triplet component, green value is the second triplet component, blue value is the third triplet component. For example, the int value of the color white equals 16777215. </Note> The default value of this property is -1, which means that no colors will be replaced with transparency.

Methods

NameDescription
CopyFromInitializes properties of the current object with values of similar properties of another object.
LoadFromFileRestores the object contents from a file on disk.
LoadFromMemory <Note> : Windows only. </Note>Restores the object contents from the global memory.
SaveToFileSaves the object contents into a file on disk.
SaveToMemory <Note> : Windows only. </Note>Saves the object contents into the global memory.

Output parameter

This object is the output parameter of the CreatePngExtendedParams method of the Engine object.

Input parameter

This object is the input parameter of the WriteToFile method of the Image object.

See also

ImageFileFormatEnum Working with Images Working with Properties