본문으로 건너뛰기
실습하기

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

이미지는 문서의 내용을 보완하고 시각적으로 더욱 풍부하게 만들어줍니다.

python-docx를 사용하면 문서에 이미지를 삽입하고, 크기와 위치를 조정하는 등의 스타일링을 할 수 있습니다.

이번 수업에서는 이미지 삽입과 스타일링 방법을 알아보겠습니다.


이미지 삽입하기

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

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

이미지 삽입하기
doc.add_picture('image.png')

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

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


이미지 크기 조정하기

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

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

이미지 크기 조정하기
from docx.shared import Inches

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

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

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

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

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


이미지 위치 조정하기

python-docx에서는 이미지의 위치를 세부적으로 조정하는 기능은 제한적입니다

그러나 이미지 삽입 후 텍스트 정렬을 통해 어느 정도 위치를 조절할 수 있습니다.

기본적으로 이미지 삽입은 현재 커서 위치에 따라 결정되며, 문서의 단락과 관련된 스타일 설정으로 조정할 수 있습니다.

다음 내용이 궁금하다면?

코드프렌즈 PLUS 멤버십 가입 or 강의를 등록해 주세요!