TRSGPImageAttributes Class

Note
There are two events that are exactly the same, OnChanged and OnChange. The extra event name is to allow easier transition from other Delphi libraries, either the VCL (OnChanged) or FMX (OnChange) libraries. Use either one as needed. Only one event is triggered.

OnChanged

Occurs when the graphics object changes.

Note
There are two events that are exactly the same, OnChanged and OnChange. The extra event name is to allow easier transition from other Delphi libraries, either the VCL (OnChanged) or FMX (OnChange) libraries. Use either one as needed. Only one event is triggered.

Owner

Canvas that owns the object. The Canvas will free this graphics object if it is destroyed. However, to keep memory use under control, it is recommended that you free graphics objects when you are finished with them. (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)

RemapTable[TRSGPColorAdjustType]

Specifies the color-remap table for a specified category.

A color-remap table is an array of TRSGPColorMap structures. Each ColorMap structure has two Color fields: one that specifies an old color and one that specifies a corresponding new color. During rendering, any color that matches one of the old colors in the remap table is changed to the corresponding new color.

Thresholds[TRSGPColorAdjustType]

Specifies the threshold (transparency range) for a specified category.

The threshold is a value from 0 through 1 that specifies a cutoff point for each color component. For example, suppose the threshold is set to 0.7, and suppose you are rendering a color whose red, green, and blue components are 230, 50, and 220. The red component, 230, is greater than 0.7×255, so the red component will be changed to 255 (full intensity). The green component, 50, is less than 0.7×255, so the green component will be changed to 0. The blue component, 220, is greater than 0.7×255, so the blue component will be changed to 255.

WrapMode

Specifies how repeated copies of an image are used to tile an area.

WrapModeClamp

Represents property WrapModeClamp.

WrapModeColor

Specifies the color of pixels outside of a rendered image. This color is visible if the WrapMode property is set to wmClamp and the source rectangle passed to TSGPCanvas.DrawImage method is larger than the image itself.

Top

	Name	Description
	Changed	Call this method when the graphics object changes. It triggers an OnChange event. (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)
	Clone	Creates a copy of the graphics object (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)
	GetHandle	Call this method to acquire a handle from the GDI+ flat API library (Overrides RSGdiPlusGraphics.TRSGPGraphicsObject.GetHandle.)
	Notification(TRSGPCanvas)	Called when the Canvas is releasing control of the graphics object. The canvas will no longer be responsible for freeing the graphics object. (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)
	Prepare(TRectF,Single)	Prepare the graphics object for drawing. Graphics objects respond in this method to upcoming calls. For example, gradient brushes can make sure the gradient will cover the entire rectangle. (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)
	QueryInterface(TGUID,Void)	Represents method QueryInterface(TGUID,Void). (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)
	ReleaseHandle	Releases the underlying GDI+ object back to the GDI+ library. (Overrides RSGdiPlusGraphics.TRSGPGraphicsObject.ReleaseHandle.)
	Reset	Overloaded. Clears all color- and grayscale-adjustment settings for all categories. Use the overload Reset method to clear settings for one category.
	Reset(TRSGPColorAdjustType)	Overloaded. Clears all color- and grayscale-adjustment settings for a specified category. Use the overloaded Reset method to clear all categories.
	Update	Update native graphics object (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)
	_AddRef	Represents method _AddRef. (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)
	_Release	Represents method _Release. (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)

Top

	Name	Description
	FHandle	Represents field FHandle. (Inherited from RSGdiPlusGraphics.TRSGPGraphicsObject.)

Top

An Image Attributes object maintains color and grayscale settings for five adjustment categories: default, bitmap, brush, pen, and text. For example, you can specify a gamma value for the default category, a different gamma value for the bitmap category, and still a different gamma value for the pen category.

The default color- and grayscale-adjustment settings apply to all categories that don't have adjustment settings of their own. For example, if you never specify any adjustment settings for the pen category, then the default settings apply to the pen category.
As soon as you specify a color- or grayscale-adjustment setting for a certain category, the default adjustment settings no longer apply to that category. You can reinstate the default settings for that category by calling Reset method. For example, suppose you specify a gamma value for the default category. If you set the gamma value for the pen category by calling Gammas[catPen], then the default gamma value will not apply to pens. If you later pass catPen to the Reset method, the pen category will revert to the default gamma value.

Reference

•RSGdiPlusGraphics.TRSGPImageAttributes.Reset(TRSGPColorAdjustType)

•RSGdiPlusGraphics