UE3:UIComp_DrawImage (UT3)

Object >> Component >> UIComponent >> UIComp_DrawComponents >> UIComp_DrawImage

Package: 

Engine

Within class: 

UIObject

Implemented interfaces: 

CustomPropertyItemHandler, UIStyleResolver

Direct subclasses:

UIComp_DrawTeamColoredImage, UIComp_UTDrawStateImage

This class in other games:

UDK

This component encapsulates rendering a UITexture for widgets. It is responsible for managing any image formatting data that is required for a particular widget (thus inappropriate for storage in UIStyles).

The style used for rendering the ImageRef is defined by whichever widget owns this component. It is the widget's responsibility to call ApplyImageStyle when the widget receives a call to OnStyleResolved for the UIStyleReference which is intended to be used as the style for this image.

Copyright 1998-2007 Epic Games, Inc. All Rights Reserved

Properties

Property group 'StyleOverride'

ImageRef

Type: UITexture

Modifiers: instanced, editinlineuse

The utility wrapper for the image that this component should render. Automatically created by the component when given an material/texture to render.

StyleCustomization

Type: UIRoot.UIImageStyleOverride

Contains values for customizing and overriding rendering and formatting values designated by this component's style.

Default value:

Member	Value
DrawColor	Member Value A 1.0 B 1.0 G 1.0 R 1.0
Formatting[0]	Member Value AdjustmentType ADJUST_Normal
Formatting[1]	Member Value AdjustmentType ADJUST_Normal
Opacity	1.0

Internal variables

ImageStyle

Type: UIRoot.UIStyleReference

Modifiers: private

The style to use for rendering this component's image. If the style is invalid, the component will use the owning widget's PrimaryStyle, if possible.

Default value:

Member	Value
DefaultStyleTag	'DefaultImageStyle'
RequiredStyleClass	Class'Engine.UIStyle_Image'

StyleResolverTag

Type: name

The tag used to fulfill the UIStyleResolver interface's GetStyleResolverTag method. Value should be set by the owning widget.

Default value: 'Image Style'

Native functions

DisableCustomColor

native final function DisableCustomColor ()

Disables image color customization allowing the image to use the values from the applied style.

DisableCustomCoordinates

native final function DisableCustomCoordinates ()

Disables image coordinate customization allowing the image to use the values from the applied style.

DisableCustomFormatting

native final function DisableCustomFormatting ()

Disables image formatting customization allowing the image to use the values from the applied style.

DisableCustomOpacity

native final function DisableCustomOpacity ()

Disables the custom opacity level for this comp

DisableCustomPadding

native final function DisableCustomPadding ()

Disables the custom padding for this component.

GetAppliedImageStyle

native final noexport function UIStyle_Image GetAppliedImageStyle (optional UIState DesiredMenuState)

Returns the image style data being used by this image rendering component. If the component's ImageStyle is not set, the style data will be pulled from the owning widget's primary style.

Parameters:

• DesiredMenuState - the menu state for the style data to retrieve; if not speicified, uses the owning widget's current menu state.

Returns:

the image style data used to render this component's image for the specified menu state.

Note: noexport because we the native version is also handles optionally resolving the image style data from the active skin, so it takes a few more parameters.

GetImage

native final function Surface GetImage () const

Returns the texture or material assigned to this component.

GetStyleResolverTag

native final virtual function name GetStyleResolverTag ()

Specified by: UIStyleResolver.GetStyleResolverTag

Returns the tag assigned to this UIStyleResolver by the owning widget

NotifyResolveStyle

native final virtual function bool NotifyResolveStyle (UISkin ActiveSkin, bool bClearExistingValue, optional UIState CurrentMenuState, const optional name StylePropertyName)

Specified by: UIStyleResolver.NotifyResolveStyle

Resolves the image style for this image rendering component.

Parameters:

• ActiveSkin - the skin the use for resolving the style reference.
• bClearExistingValue - if TRUE, style references will be invalidated first.
• CurrentMenuState - the menu state to use for resolving the style data; if not specified, uses the current menu state of the owning widget.
• StyleProperty - if specified, only the style reference corresponding to the specified property will be resolved; otherwise, all style references will be resolved.

SetColor

native final function SetColor (Object.LinearColor NewColor)

Enables image color customization and changes the component's override color to the value specified.

Parameters:

• NewColor - the color to use for rendering this component's image

SetCoordinates

native final function SetCoordinates (UIRoot.TextureCoordinates NewCoordinates)

Enables image coordinate customization and changes the component's override coordinates to the value specified.

Parameters:

• NewCoordinates - the UV coordinates to use for rendering this component's image

SetFormatting

native final function SetFormatting (UIRoot.EUIOrientation Orientation, UIRoot.UIImageAdjustmentData NewFormattingData)

Enables image formatting customization and changes the component's formatting override data to the value specified.

Parameters:

• Orientation - indicates which orientation to modify
• NewFormattingData - the new value to use for rendering this component's image.

SetImage

native final function SetImage (Surface NewImage)

Changes the image for this component, creating the wrapper UITexture if necessary.

Parameters:

• NewImage - the new texture or material to use in this component

SetOpacity

native final function SetOpacity (float NewOpacity)

Enables a custom opacity and changes the component's override opacity to the value specified.

Parameters:

• NewOpacity - the alpha to use for rendering this component's string

SetPadding

native final function SetPadding (float HorizontalPadding, float VerticalPadding)

Enables custom padding and changes the component's override padding to the value specified.

Parameters:

• HorizontalPadding - new vertical padding value to use (assuming a screen height of DEFAULT_SIZE_Y); will be scaled based on actual resolution. Specify -1 to indicate that VerticalPadding should not be changed (useful when changing only the horizontal padding)

SetStyleResolverTag

native final virtual function bool SetStyleResolverTag (name NewResolverTag)

Specified by: UIStyleResolver.SetStyleResolverTag

Changes the tag assigned to the UIStyleResolver to the specified value.

Returns:

TRUE if the name was changed successfully; FALSE otherwise.