# ImageLabel

Roblox Engine API class from Roblox Studio 0.744.0.7441077 (version-7aaa6838d36c4448).

- Inherits from, nearest first: [GuiLabel](https://rapi.sleaze.dev/classes/GuiLabel.md), [GuiObject](https://rapi.sleaze.dev/classes/GuiObject.md), [GuiBase2d](https://rapi.sleaze.dev/classes/GuiBase2d.md), [GuiBase](https://rapi.sleaze.dev/classes/GuiBase.md), [Instance](https://rapi.sleaze.dev/classes/Instance.md), [Object](https://rapi.sleaze.dev/classes/Object.md)
- Memory category: Gui
- HTML page: https://rapi.sleaze.dev/classes/ImageLabel/
- Roblox documentation: https://create.roblox.com/docs/reference/engine/classes/ImageLabel

A 2D user interface element that displays a single non-interactive image.

## Properties

### ContentImageSize

```luau
ImageLabel.ContentImageSize: Vector2 = Vector2.zero
```

- Tags: Hidden, Read only, Roblox script security, Read capabilities: UI

### Image

```luau
ImageLabel.Image: string = ""
```

- Tags: Read capabilities: UI

The image content displayed by the UI element. Reads and writes to [`ImageContent`](https://rapi.sleaze.dev/classes/ImageLabel.md).

### ImageColor3

```luau
ImageLabel.ImageColor3: Color3 = Color3.new(1, 1, 1)
```

- Tags: Read capabilities: UI

Determines how a rendered image will be colorized.

### ImageContent

```luau
ImageLabel.ImageContent: Content
```

- Tags: Read capabilities: UI

The image content displayed by the UI element. Supports [asset URIs](https://create.roblox.com/docs/projects/assets#asset-uris) and [`EditableImage`](https://rapi.sleaze.dev/classes/EditableImage.md) objects.

### ImageRectOffset

```luau
ImageLabel.ImageRectOffset: Vector2 = Vector2.zero
```

- Tags: Read capabilities: UI

The offset in pixels of the sub-area of an image to be displayed.

### ImageRectSize

```luau
ImageLabel.ImageRectSize: Vector2 = Vector2.zero
```

- Tags: Read capabilities: UI

Determines the size in pixels of the sub-area of an image to be displayed.

### ImageTransparency

```luau
ImageLabel.ImageTransparency: number = 0
```

- Tags: Read capabilities: UI

Determines the transparency of the rendered image.

### IsLoaded

```luau
ImageLabel.IsLoaded: boolean = false
```

- Tags: Read only, Read capabilities: UI

Indicates whether the image has finished loading from Roblox.

### LocalizedImageContent

```luau
ImageLabel.LocalizedImageContent: Content
```

- Tags: Not replicated, Read: Roblox script security, Write: Not accessible, Read capabilities: UI, Load only

### ResampleMode

```luau
ImageLabel.ResampleMode: Enum.ResamplerMode = Enum.ResamplerMode.Default
```

- Tags: Read capabilities: UI

Selects the image resampling mode for the label.

### ScaleType

```luau
ImageLabel.ScaleType: Enum.ScaleType = Enum.ScaleType.Stretch
```

- Tags: Read capabilities: UI

Determines how an image will scale if displayed in a UI element whose size differs from the source image.

### SliceCenter

```luau
ImageLabel.SliceCenter: Rect = Rect.new(0, 0, 0, 0)
```

- Tags: Read capabilities: UI

Sets the slice boundaries of a 9-sliced image.

### SliceScale

```luau
ImageLabel.SliceScale: number = 1
```

- Tags: Read capabilities: UI

Scales the 9-slice edges by the specified ratio.

### TileSize

```luau
ImageLabel.TileSize: UDim2 = UDim2.new(1, 0, 1, 0)
```

- Tags: Read capabilities: UI

Sets the tiling size of the [`ImageLabel`](https://rapi.sleaze.dev/classes/ImageLabel.md).

## Methods

### SetEnableContentImageSizeChangedEvents

```luau
ImageLabel:SetEnableContentImageSizeChangedEvents(enabled: boolean)
```

- Tags: Roblox script security, Capabilities: UI

## Inherited members

- From [GuiObject](https://rapi.sleaze.dev/classes/GuiObject.md): `SelectionImageObject`, `ClipsDescendants`, `Draggable`, `Active`, `AnchorPoint`, `AutomaticSize`, `BackgroundColor3`, `BackgroundTransparency`, `BorderColor3`, `BorderMode`, `BorderSizePixel`, `InputSink`, `Interactable`, `LayoutOrder`, `Position`, `Rotation`, `SelectionRect2D`, `Sink`, `Size`, `SizeConstraint`, `Visible`, `ZIndex`, `BackgroundColor`, `BorderColor`, `Transparency`, `DragBeginConnectionCount`, `DragStoppedConnectionCount`, `MouseEnterConnectionCount`, `MouseLeaveConnectionCount`, `MouseMovedConnectionCount`, `MouseWheelBackwardConnectionCount`, `MouseWheelForwardConnectionCount`, `NextSelectionDown`, `NextSelectionLeft`, `NextSelectionRight`, `NextSelectionUp`, `Selectable`, `SelectionOrder`, `GuiState`, `TweenPositionInternal`, `TweenSizeAndPositionInternal`, `TweenSizeInternal`, `TweenPosition`, `TweenSize`, `TweenSizeAndPosition`, `InputBegan`, `InputChanged`, `InputEnded`, `MouseEnter`, `MouseLeave`, `MouseMoved`, `MouseWheelBackward`, `MouseWheelForward`, `SelectionGained`, `SelectionLost`, `TouchLongPress`, `TouchPan`, `TouchPinch`, `TouchRotate`, `TouchSwipe`, `TouchTap`, `DragBegin`, `DragStopped`
- From [GuiBase2d](https://rapi.sleaze.dev/classes/GuiBase2d.md): `AbsolutePosition`, `AbsoluteRotation`, `AbsoluteSize`, `ActiveQueryNames`, `ReplicatedInsertionOrder`, `ClippedRect`, `IsNotOccluded`, `RawRect2D`, `TotalGroupScale`, `AutoLocalize`, `RootLocalizationTable`, `Localize`, `SelectionBehaviorDown`, `SelectionBehaviorLeft`, `SelectionBehaviorRight`, `SelectionBehaviorUp`, `SelectionGroup`, `SelectionChanged`
- From [Instance](https://rapi.sleaze.dev/classes/Instance.md): `Archivable`, `archivable`, `Attributes`, `AttributesReplicate`, `AttributesSerialize`, `HistoryId`, `Name`, `Parent`, `PredictionMode`, `PropertyStatusStudio`, `RobloxLocked`, `SerializedOverrides`, `SourceAssetId`, `Tags`, `UniqueId`, `numExpectedDirectChildren`, `DataCost`, `Capabilities`, `DefinesCapabilities`, `IsInSandbox`, `Sandboxed`, `AddTag`, `ClearAllChildren`, `Clone`, `Destroy`, `FindFirstAncestor`, `FindFirstAncestorOfClass`, `FindFirstAncestorWhichIsA`, `FindFirstChild`, `FindFirstChildOfClass`, `FindFirstChildWhichIsA`, `FindFirstDescendant`, `GetActor`, `GetAttribute`, `GetAttributeChangedSignal`, `GetAttributes`, `GetChildren`, `GetDebugId`, `GetDescendants`, `GetFullName`, `GetStyled`, `GetStyledPropertyChangedSignal`, `GetTags`, `HasTag`, `IsAncestorOf`, `IsDescendantOf`, `IsPropertyModified`, `QueryDescendants`, `RemoveTag`, `ResetPropertyToDefault`, `SetAttribute`, `WaitForChild`, `Remove`, `children`, `clone`, `destroy`, `findFirstChild`, `getChildren`, `isDescendantOf`, `remove`, `AncestryChanged`, `AttributeChanged`, `ChildAdded`, `ChildRemoved`, `DescendantAdded`, `DescendantRemoving`, `Destroying`, `StyledPropertiesChanged`, `childAdded`
- From [Object](https://rapi.sleaze.dev/classes/Object.md): `ClassName`, `className`, `GetPropertyChangedSignal`, `IsA`, `isA`, `Changed`