lesson1Title

lesson2Title

lesson3Title

lesson4Title

lesson5Title

lesson6Title

lesson7Title

lesson8Title

lesson9Title

lesson10Title

lesson11Title

lesson12Title

lesson13Title

lesson14Title

lesson15Title

lesson16Title

lesson17Title

automationIntroBasicsChapter2Title

lesson18Title

automationIntroBasicsChapter1Title

automationIntroBasicsChapter3Title

automationIntroBasicsChapter4Title

from docx import Document
from docx.shared import Inches

# 새 워드 문서 생성
doc = Document()

# 새로운 문서 생성
doc = Document()

# 문서에 level=1의 대제목 추가
doc.add_heading('안녕하세요!', level=1)

# 문서에 단락 추가
doc.add_paragraph("아래에 이미지를 추가합니다")

doc.add_picture('input_image.png', width=Inches(2), height=Inches(2))

doc.add_paragraph("코드프렌즈 로고를 추가했습니다.")

# 문서 저장
doc.save('output_file.docx')

# 문서에 이미지 삽입하고 스타일링하기

문서 작업을 하다보면 콘텐츠의 직관적인 이해를 돕기 위한 `이미지`를 삽입해야 할 때가 있습니다.

*python-docx*를 사용하면 문서에 이미지를 삽입하고, 크기와 위치를 조정하는 등의 작업을 프로그래밍적으로 처리할 수 있습니다.

이번 수업에서는 문서에 **이미지를 삽입하고 크기를 조정**하는 방법을 알아보겠습니다.

<br />

## 이미지 삽입하기

문서에 이미지를 삽입하려면 `add_picture()` 메서드를 사용합니다.

이 메서드는 파일 경로를 인자로 받아 이미지를 문서에 추가합니다.

```python title="이미지 삽입하기"
doc.add_picture('image.png')
```

위 코드는 'image.png' 파일을 문서에 삽입합니다.

이미지 파일 경로는 상대 경로 또는 절대 경로로 지정할 수 있습니다.

<br />

## 이미지 크기 조정하기

이미지를 삽입한 후, `Inches` 또는 `Cm` 클래스를 사용해 크기를 조정할 수 있습니다.

이는 이미지의 너비나 높이를 원하는 크기로 조절할 때 유용합니다.

```python title="이미지 크기 조정하기"
from docx.shared import Inches

doc.add_picture('image.png', width=Inches(2))
```

위 코드는 이미지의 너비를 2인치로 설정하여 문서에 삽입합니다.

높이를 지정하지 않으면 비율에 맞게 자동으로 조정됩니다.

```python title="이미지 높이와 너비 함께 조정하기"
doc.add_picture('image.png', width=Inches(2), height=Inches(3))
```

이 코드는 이미지의 너비를 2인치, 높이를 3인치로 조정하여 삽입하는 예시입니다.

<br />

## 이미지 위치를 세부적으로 조정할 수 있을까요?

*python-docx*으로는 이미지의 위치를 위에서 어느정도 만큼, 왼쪽에서 어느정도 만큼 수준으로 세밀하게 조정할 수 없습니다.

따라서 세밀한 이미지 위치 조정이 필요하다면 먼저 이미지를 삽입한 후, 워드 파일을 열어 수동으로 이미지 위치를 조정해야 합니다.

python-docx 라이브러리를 사용하면 `add_picture()` 메서드를 통해 문서에 이미지를 쉽게 삽입할 수 있습니다. 이는 문서의 시각적 효과를 높이는 데 유용합니다.

### python-docx를 사용하면 문서에 이미지를 삽입할 수 있다.