im2uint8

영상을 8비트의 부호 없는 정수로 변환

구문

J = im2uint8(I)

J = im2uint8(I,"indexed")

설명

J = im2uint8(I)는 회색조, RGB 또는 이진 영상 I를 uint8형으로 변환하고 필요에 따라 데이터를 다시 스케일링하거나 오프셋합니다.

입력 영상의 데이터형이 uint8형이면 출력 영상이 동일합니다. 입력 영상의 데이터형이 logical형이면 im2uint8은 true 값을 갖는 요소를 255로 변경합니다.

J = im2uint8(I,"indexed")는 인덱스 영상 I를 uint8형으로 변환하고 필요에 따라 데이터를 오프셋합니다.

예제

uint16형 배열을 uint8형 배열로 변환하기

uint16 데이터형의 배열을 만듭니다.

I = reshape(uint16(linspace(0,65535,25)),[5 5])

I = 5×5 uint16 matrix

       0   13653   27306   40959   54613
    2731   16384   30037   43690   57343
    5461   19114   32768   46421   60074
    8192   21845   35498   49151   62804
   10923   24576   38229   51882   65535

이 배열을 uint8 데이터형으로 변환합니다.

I2 = im2uint8(I)

I2 = 5×5 uint8 matrix

     0    53   106   159   213
    11    64   117   170   223
    21    74   128   181   234
    32    85   138   191   244
    43    96   149   202   255

입력 인수

I — 입력 영상

숫자형 배열 | 논리형 배열

입력 영상으로, 임의의 크기와 차원을 갖는 숫자형 배열 또는 논리형 배열로 지정됩니다.

• I가 회색조 영상 또는 RGB 영상인 경우 uint8, uint16, int16, double, single 또는 logical 데이터형일 수 있습니다. im2uint8 함수는 double 및 single 데이터형의 영상이 [0, 1] 범위의 값을 가질 것으로 예상합니다. I에 [0, 1] 범위 밖에 있는 값이 있는 경우 rescale 함수를 사용하여 값을 예상 범위로 다시 스케일링할 수 있습니다.

• I가 인덱스 영상인 경우 uint8, uint16, double 또는 logical 데이터형일 수 있습니다. 인덱스 영상이 double 데이터형인 경우 최댓값은 256 이하여야 합니다. 인덱스 영상이 데이터형 uint16형인 경우 최댓값은 255 이하여야 합니다.

• I가 이진 영상인 경우 logical형이어야 합니다.

데이터형: single | double | int16 | uint8 | uint16 | logical

출력 인수

J — uint8 데이터형 영상

숫자형 배열

uint8 데이터형 영상으로, 입력 영상 I와 같은 크기의 숫자형 배열로 반환됩니다.

데이터형: uint8

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• im2uint8 함수는 C 코드 생성을 지원합니다(MATLAB^® Coder™가 필요함). 일반적인 MATLAB Host Computer 타깃 플랫폼을 선택할 경우 im2uint8 함수는 미리 컴파일된 플랫폼별 공유 라이브러리를 사용하는 코드를 생성합니다. 공유 라이브러리를 사용하면 성능 최적화가 유지되지만 코드를 생성할 수 있는 타깃 플랫폼이 제한됩니다. 자세한 내용은 Types of Code Generation Support in Image Processing Toolbox 항목을 참조하십시오.

GPU 코드 생성
GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

이 함수는 GPU 배열을 완전히 지원합니다. 자세한 내용은 GPU를 사용한 영상 처리 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2021b: 스레드 기반 환경 지원

im2uint8 함수는 이제 스레드 기반 환경을 지원합니다.

참고 항목

im2double | im2int16 | im2single | im2uint16 | uint8