입력 이미지와 마스킹 이미지를 이용해서 inpaint 처리된 결과 이미지를 응답받는 모듈입니다.

Installation & Update

만약 첫 사내 registry 설치를 시도하신다면, 로그인이 되어있지 않기에 진행이 불가능합니다. 그런 경우에는 아래의 명령 및 id/pw 입력을 1회 수행합니다.

npm login --registry http://ohoolabs.iptime.org:4873/

• [id/pw] : [ohoolabs/5오후랩스!]

npm을 통해 설치합니다. (오후랩스에서 관리하는 사설서버를 이용합니다.)

npm i ohoo-inpaint --registry http://ohoolabs.iptime.org:4873/

해당 모듈의 버전 업데이트를 대응하기 위해선,

npm update ohoo-inpaint --registry http://ohoolabs.iptime.org:4873/

위와 같이 업데이트 합니다.

** 사설서버의 경우, 현재 시경님께서 관리해주고 계십니다.
** 도메인의 경우, 현재 진구님께서 관리해주고 계십니다.

• [*** ~ 24.07.05]: 기존 경로 http://112.220.148.232:4873/
• [24.07.05 ~ ***]: 사무실 이전으로 인한 변경 예정 -> http://ohoolabs.iptime.org:4873/

Getting started

웹서비스 환경설정 구성

해당 모듈을 사용하는 웹서비스에서는 crossOriginIsolated 모드가 활성화되어야 합니다. (onnxruntion-web 모듈의 고성능 활성화 조건입니다.)
https://web.dev/articles/cross-origin-isolation-guide?hl=ko 를 참고하세요.

crossOriginIsolated 모드가 정상 적용되었는지에 대한 쉬운 검증 방법은
해당 모듈을 웹페이지에서 개발자모드를 통해 콘솔영역에서 아래의 코드를 수행했을 때 true 이면 잘 적용되었다고 판단할 수 있습니다.

console.log(crossOriginIsolated)

모듈 설정

import inpaint from "ohoo-inpaint";

해당 기능을 사용할 컴포넌트에서 위와 같이 모듈을 가져옵니다.
기능 활용을 위해서는 init, run 의 동작이 필요합니다. 아래에서 추가로 설명합니다.

inpaint.init(options)

위의 로직은 접속시 1회만 수행합니다. (해당 로직을 수행하지 않은 경우, run(...) 메소드가 동작하지 않습니다.)
options 에 대한 설정은 코드 코멘트를 참고해주세요.

inpaint.run(image, mask)

대상 이미지(image)와 변경할 영역을 표시하는 마스크 이미지(mask)를 참고하여 inpaint처리된 bass64 이미지 url을 취득합니다.

Demo

이해를 돕기위해, 해당 모듈을 이용해서 동작하고 있는 데모 프로젝트를 공유합니다.

https://gitlab.com/team_babel/webdemo-hub

해당 프로젝트 실행 후, 첫 페이지에 있는 라우터 이동버튼을 활용해서 관련 데모에 접근할 수 있습니다.