# 그림 도형 추가

## Content

보다 정보가 풍부한 리포트를 작성하기 위해 템플릿 시트에 그림(Shape 형태)을 추가할 수 있습니다. 리포트 시트에서는 셀 확장에 따라 그림의 위치가 달라질 수 있습니다.
리포트 시트에서는 그림이 그룹화를 지원하지 않지만, 특정한 **위치 지정 전략**에 따라 동작합니다. 그림은 시작 행(`startRow`)과 시작 열(`startColumn`) 기준으로 배치되며, 해당 셀의 [핀 고정](/spreadjs/docs/v18/features/reportsheet/template-sheet-setting/set-pin) 속성에 따라 고정 위치 전략을 따릅니다(`static` 셀과 동일한 스케일 전략 적용). 크기는 템플릿 시트에 설정된 그림 크기와 동일하게 유지되며, 리포트 생성 시 변하지 않습니다.
아래는 그림 위치 지정의 대표적인 예시입니다:
**예제 1** : 그림의 상단 또는 왼쪽이 확장되는 셀과 같은 행 또는 열에 위치한 경우, 그림은 현재 확장되는 셀이 처음 확장한 셀 위치 기준으로 배치됩니다.

| **템플릿 시트** | **리포트 시트** |
| ------ | ------ |
| ![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/d37fbce1-6a37-43ce-b728-dd79fba68421/image.b00238.png?width=500) | ![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/d37fbce1-6a37-43ce-b728-dd79fba68421/image.50076c.png?width=500) |

**예제 2** :확장되는 셀이 그림보다 앞쪽(왼쪽 또는 위쪽)에 있을 경우, 확장 셀이 그림을 뒤로 밀어냅니다.

| **템플릿 시트** | **리포트 시트** |
| ------ | ------ |
| ![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/d37fbce1-6a37-43ce-b728-dd79fba68421/image.1211a7.png?width=500) | ![image](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/d37fbce1-6a37-43ce-b728-dd79fba68421/image.dfe4fb.png?width=500) |

그림을 추가하려면 `addPictureShape` 메서드를 사용하며, 그림의 **이름(name)**, **소스 경로(source)**, **좌표(x, y)** 및 **크기(width, height)** 를 지정해야 합니다.
다음은 템플릿 시트에 그림을 추가하는 코드 예시입니다:

```auto
// 템플릿시트에 그림 도형 추가
let picture = templateSheet.shapes.addPictureShape("picture", '/imageSrc.png', 0, 0, 200, 200); 

// 그림 도형 조정
picture.startRow(0);
picture.endRow(6)
picture.startColumn(6);
picture.endColumn(6);
picture.startColumnOffset(60);
```