[에러 해결] [Python OpenCV] 이미지 픽셀 값 변경이 안될 때 원인과 해결

파이썬(Python)과 OpenCV 라이브러리를 사용하여 이미지 처리 작업을 하다 보면, 특정 픽셀의 값을 변경하려는데 아무리 코드를 실행해도 이미지가 편집되지 않아 답답함을 느낄 때가 있습니다. 특히 초보 개발자들이 자주 겪는 문제 중 하나인데요. 오늘은 이러한 ‘이미지 픽셀 변경 실패’의 원인을 명확히 분석하고, 올바른 해결 방법을 제시해 드리겠습니다.

이 문서는 Google 검색 상위 노출과 개발자 사용자 경험(UX)을 최우선으로 고려하여 작성되었습니다. 문제 해결에 필요한 핵심 정보만을 간결하게 전달하며, 관련 코드 예시를 통해 즉시 적용할 수 있도록 돕겠습니다.

1. 에러 발생 상황

개발자는 파이썬과 OpenCV, Matplotlib을 활용하여 이미지 파일의 특정 픽셀을 빨간색으로 변경하고자 합니다. 하지만 코드를 실행해도 해당 픽셀의 색상이 전혀 바뀌지 않는 문제가 발생했습니다.

문제의 코드 예시는 다음과 같습니다:

import cv2 as cv
import os
import matplotlib.pyplot as plt

def readAndWriteImage():

    imPath = ('C:\\Body Type Examination App\\Images\\IMG_9991.jpeg')
    img = cv.imread(imPath)
    imgRGB = cv.cvtColor(img,cv.COLOR_BGR2RGB)

    #plt.figure()
    #plt.imshow(imgRGB)
    #plt.show()
    
    aCertainPixel = imgRGB[242,71]
    aCertainPixel = (255, 0, 0) # 이 부분에서 픽셀 변경을 시도했으나 실패

    plt.figure()
    plt.imshow(imgRGB)
    plt.show()


if __name__ == '__main__':
    readAndWriteImage()

위 코드에서 개발자는 특정 픽셀(242, 71)을 선택한 후, 그 값을 빨간색(RGB 255, 0, 0)으로 변경하려고 했습니다. 하지만 결과는 픽셀이 그대로 유지되는 것이었습니다.

2. 명확한 발생 원인

이 문제는 파이썬 변수 할당과 NumPy 배열(OpenCV 이미지는 기본적으로 NumPy 배열로 처리됨)의 동작 방식을 혼동하면서 발생합니다. 핵심 원인은 다음 두 줄에 있습니다:

aCertainPixel = imgRGB[242,71]
aCertainPixel = (255, 0, 0)

• 첫 번째 줄 aCertainPixel = imgRGB[242,71]은 imgRGB 배열의 (242, 71) 위치에 있는 픽셀 값을 읽어와 aCertainPixel이라는 새로운 변수에 할당하는 역할을 합니다. 이때 imgRGB 배열 자체의 값은 변하지 않습니다.
• 두 번째 줄 aCertainPixel = (255, 0, 0)은 aCertainPixel 변수 자체의 값을 새로운 튜플 (255, 0, 0)로 재할당하는 것입니다. 즉, aCertainPixel 변수가 이전에 담고 있던 픽셀 값은 사라지고, 이제 (255, 0, 0)이라는 새로운 값을 가리키게 됩니다. 이 과정에서도 원본 imgRGB 배열의 (242, 71) 픽셀에는 아무런 변경도 일어나지 않습니다.

결론적으로, aCertainPixel이라는 임시 변수에 픽셀 값을 할당한 후, 그 임시 변수의 값을 변경하는 것은 원본 이미지 배열의 픽셀에 아무런 영향을 주지 않습니다. 원본 배열의 특정 위치를 직접 수정해야만 픽셀이 변경됩니다.

3. 해결 방법 및 코드 예시

이미지 배열의 특정 픽셀 값을 변경하려면, 해당 픽셀의 인덱스를 직접 사용하여 값을 할당해야 합니다. 즉, aCertainPixel이라는 중간 변수를 사용하지 않고, imgRGB[행, 열] = 새로운_값 형태로 직접 할당해야 합니다.

올바른 픽셀 변경 방법은 다음과 같습니다:

import cv2 as cv
import os
import matplotlib.pyplot as plt

def readAndWriteImage():

    imPath = ('C:\\Body Type Examination App\\Images\\IMG_9991.jpeg')
    img = cv.imread(imPath)
    
    # 이미지를 읽지 못했을 경우 예외 처리 추가 (UX 개선)
    if img is None:
        print(f"오류: 이미지를 불러올 수 없습니다. 경로를 확인해주세요: {imPath}")
        return

    imgRGB = cv.cvtColor(img,cv.COLOR_BGR2RGB)
    
    # 픽셀 변경 전 값 확인 (디버깅 용이)
    print(f"변경 전 픽셀 (242,71) 값: {imgRGB[242,71]}")

    # 올바른 픽셀 변경 방법: 이미지 배열의 해당 위치에 직접 값을 할당
    imgRGB[242,71] = (255, 0, 0) # R, G, B 순서로 빨간색 할당

    # 픽셀 변경 후 값 확인
    print(f"변경 후 픽셀 (242,71) 값: {imgRGB[242,71]}")

    plt.figure()
    plt.imshow(imgRGB)
    plt.title('Pixel Changed Image') # 제목 추가
    plt.show()


if __name__ == '__main__':
    readAndWriteImage()

위 코드에서는 imgRGB[242,71] = (255, 0, 0)과 같이 직접 이미지 배열의 특정 위치에 새로운 픽셀 값을 할당합니다. 이렇게 하면 원본 이미지 배열의 해당 픽셀 값이 성공적으로 변경되고, Matplotlib으로 이미지를 표시했을 때 변경된 픽셀을 확인할 수 있습니다.

4. 향후 예방을 위한 팁

이와 같은 실수를 방지하고 효율적인 이미지 처리 작업을 위해 다음 팁들을 참고하세요:

1. NumPy 배열의 작동 방식 이해: OpenCV 이미지는 NumPy 배열이므로, NumPy의 인덱싱과 슬라이싱, 그리고 값 할당 방식을 정확히 이해하는 것이 중요합니다. 배열의 특정 요소를 수정할 때는 array[index] = value 형태로 직접 접근해야 합니다.
2. 변수와 배열 요소의 구분: 파이썬에서 변수에 어떤 값을 할당할 때, 그것이 원본 데이터 구조를 변경하는 것인지 아니면 단순히 새로운 값을 변수에 연결하는 것인지를 항상 염두에 두세요. 특히 리스트나 배열과 같은 가변(mutable) 객체를 다룰 때는 주의가 필요합니다.
3. 디버깅 습관: 픽셀 값이 제대로 변경되었는지 확신이 서지 않을 때는 변경 전후로 해당 픽셀의 값을 출력(print(imgRGB[행, 열]))하여 확인하는 습관을 들이세요. 이는 문제의 원인을 빠르게 파악하는 데 큰 도움이 됩니다.
4. 오류 처리: cv.imread()와 같이 외부 리소스를 사용하는 함수는 이미지를 불러오지 못할 경우 None을 반환할 수 있습니다. if img is None:과 같은 코드로 예외 처리를 추가하여 프로그램의 안정성을 높이는 것이 좋습니다.
5. 원본 이미지 보존: 이미지 데이터를 조작할 때 원본 이미지를 유지하고 싶다면, 작업 전에 img.copy()를 사용하여 이미지의 복사본을 만들어 작업하는 것을 권장합니다.

이 문서를 통해 Python과 OpenCV에서 이미지 픽셀 변경 시 겪는 문제를 해결하고, 더 나아가 NumPy 배열에 대한 이해를 높이는 데 도움이 되었기를 바랍니다. 앞으로도 효율적인 코드 작성과 안정적인 이미지 처리 작업에 성공하시길 응원합니다.