# Image
## Image
클라이언트에서 사용되는 Widget Image 객체.
### **속성**
| **ImageID** |
| ----------- |
이미지에 설정된 아이디 값이에요.
\-- 샘플 --
```lua
local Image = Workspace.ScreenUI.Image
local ResourceID = 6800
Image.ImageID = ResourceID
```
| **ImageDrawType** |
| ----------------- |
이미지의 DrawType을 설정하고 얻을 수 있어요 (None, Tile, Slice, Border).
\-- 샘플 --
```lua
local image = Workspace.ScreenUI.Image
image.ImageDrawType = Enum.ImageDrawType.Image
```
| **ImageSliceLeftRight** |
| ----------------------- |
이미지의 DrawType이 Slice, Border일 때의 Slice 좌우영역(각각 0부터 1사이)을 정하고 얻을 수 있어요(Left, Right).
\-- 샘플 --
```lua
local image = Workspace.ScreenUI.Image
image.ImageDrawType = Enum.ImageDrawType.Slice
image.SliceLeftRight = Vector.new(0.5, 0.5, 0) --X : 좌 / Y : 우
```
| **ImageSliceTopBottm** |
| ---------------------- |
이미지의 DrawType이 Slice, Border일 때의 Slice 좌우영역(각각 0부터 1사이)을 정하고 얻을 수 있어요(Top, Bottom).
\-- 샘플 --
```lua
local image = Workspace.ScreenUI.Image
image.ImageDrawType = Enum.ImageDrawType.Slice
image.SliceTopBottom = Vector.new(0.5, 0.5, 0) --X : 상 / Y : 하
```
| **ImageTiling** |
| --------------- |
이미지의 DrawType이 Tile일 때의 옵션값을 설정하고 얻을 수 있어요 (NoTile, Horizontal, Vertical, Both)
\-- 샘플 --
```lua
local image = Workspace.ScreenUI.Image
image.ImageDrawType = Enum.ImageDrawType.Image
image.ImageTiling = Enum.ImageTilingType.Both
```
### **함수**
| **void SetBackgroundColor(Color color)** |
| ---------------------------------------- |
이미지 위젯의 배경 색을 설정할 수 있어요. (변경할 색)
\-- 샘플 --
```lua
local image = Workspace.ScreenUI.Image
image:SetBackgroundColor(Color.new(0, 0, 255, 255))
```
| **Color GetBackgroundColor()** |
| ------------------------------ |
이미지 위젯의 배경 색을 가져올 수 있어요.
\-- 샘플 --
```lua
local image = Workspace.ScreenUI.Image
print(image:GetBackgroundColor())
```
| **void SetImage(number ImageID)** |
| --------------------------------- |
(deprecated) 키값으로 이미지를 설정 할 수 있어요.
| **Vector GetNativeSize()** |
| -------------------------- |
이미지의 원본 크기를 얻을 수 있습니다.
\-- 샘플 --
```lua
local Image = Workspace.ScreenUI.Image
local ImageNativeSize = Image:GetNativeSize()
```
| **void SetNativeSize()** |
| ------------------------ |
이미지를 원본 크기로 되돌립니다.
\-- 샘플 --
```lua
local Image = Workspace.ScreenUI.Image
Image:SetNativeSize()
```
| **void SetImageUrl\_OtherPlatform()** |
| ------------------------------------- |
image:SetImageUrl\_OtherPlatform(download url)
\
## **사용 가능한 부모 오브젝트 기능들**
### **속성**
| **이름** | **설명** |
| ---------------------------------------------------------------------------------------------- | ---------------------------------------- |
| [**Location**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 위치를 변경할 수 있어요. (X좌표 값, Y좌표 값, 0)** |
| [**Rotation**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 회전을 설정할 수 있어요. (설정할 값)** |
| [**Scale**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 스케일을 설정할 수 있어요. (설정할 값)** |
| [**Size**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 크기를 설정할 수 있어요. (가로값, 세로값, 0)** |
| [**ZOrder**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 그리는 순서를 설정할 수 있어요.** |
| [**Visible**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **UI 위젯의 표시 여부를 설정할 수 있어요. (위젯 표시 여부)** |
| [**Interaction**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **UI 위젯의 반응 여부를 설정할 수 있어요. (위젯 반응 여부)** |
| [**Opacity**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 투명 값을 설정할 수 있어요. (설정할 값)** |
| [**AnchorType**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 고정 여부를 설정할 수 있어요. (설정할 타입)** |
| [**IsFill**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 채우기를 설정할 수 있어요.** |
### **이벤트**
| **이름** | **설명** |
| ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**OnVisibleEvent**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | widget이 보여질 때 호출되는 이벤트에요.
연결함수 형식은 function(widget), widget 은 보여지는 widget 객체 입니다.
|
| [**OnInVisibleEvent**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | widget이 안 보여질 때 호출되는 이벤트에요.
연결함수 형식은 function(widget), widget 은 안 보여지는 widget 객체 입니다.
|
| [**OnBeginDragEvent**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | widget의 드래그가 시작 될 때 호출되는 이벤트에요.
연결함수 형식은 function(widget, vector2D), widget은 클릭한 객체, vector2D는 마우스 위치에요.
|
| [**OnCancelDragEvent**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | widget의 드래그가 취소될 때 호출되는 이벤트에요.
연결함수 형식은 function(widget, vector2D), widget은 클릭한 객체, vector2D는 마우스 위치에요.
|
| [**OnEndDragEvent**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | widget의 드래그가 드랍될 때 호출되는 이벤트에요.
연결함수 형식은 function(widget, vector2D, dragwidget), widget은 드랍한 객체, vector2D는 마우스 위치, dragwidget는 드래그한 widget에요.
|
### **함수**
| **이름** | **설명** |
| -------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| [**AddChildUIScene**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **(deprecate) AddChildUIWidget 함수로 이용하세요.** |
| [**AddChildWidget**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **자식 UI 위젯을 추가할 수 있어요. (자식으로 추가할 UI 위젯)** |
| [**SetParentWidget**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **부모 UI 위젯을 설정할 수 있어요. (부모로 설정할 UI 위젯)** |
| [**Delete**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯을 제거할 수 있어요.** |
| [**GetTypeString**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 타입을 문자열로 얻을 수 있어요.** |
| [**GetType**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 타입을 Enum 형식으로 얻을 수 있어요.** |
| [**SetDragWidget**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 DragEvent 발생 시 복사되어 보여질 widget을 세팅해요.** |
| [**SetDragOffset**](https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/widgetbase) | **위젯의 DragWidget에 적용될 Offset 이에요.** |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://ditoland-utplus.gitbook.io/ditoland/api-reference/client/image.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.