Object Detection

AI와 함께 읽기
전체 문서 한 파일로 (llms-full.txt)
YoloDetection #ProFx #Node
Object Detection

입력 영상에서 물체를 검출해서, 찾아낸 위치를 흰 사각형으로 칠한 마스크를 출력합니다. 사람・자동차・동물 등, Target 드롭다운에서 고른 종류의 물체를 찾습니다. 동시에 가장 확신도가 높은 검출의 중심 좌표(0~1)도 출력하므로, 검출 위치로 다른 노드를 움직이게 할 수도 있습니다.

  • Target — 검출할 물체의 종류. 초깃값은 Person
  • Enable — 초깃값 ON. OFF일 때는 입력이 그대로 통과합니다
  • Confidence Threshold — 이 확신도를 넘은 검출만 채택합니다. 초깃값 0.25(0~1)
  • Inference Every N Frames — 몇 프레임에 한 번 검출할지. 초깃값 2(숫자를 올릴수록 가벼워집니다)
  • Max Detections — 그릴 검출 수의 상한. 확신도가 높은 순으로 채택합니다. 1~50, 초깃값 10
  • detectedCenterX0 / detectedCenterY0 — 최상위 검출의 중심(0~1). 검출이 0건일 때는 둘 다 0.5를 출력합니다

마스크는 사각형으로 칠하는 방식입니다. 물체의 형태를 따라 오려내는 것이 아닙니다.

같은 물체에 여러 개의 프레임이 겹쳐서 나온 경우, 그것들은 모두 그대로 그려집니다.

검출할 수 있는 것은 Target에서 고른 한 종류뿐입니다. 여러 종류를 동시에 다루고 싶다면 노드를 나눠 주세요.

검출하지 않는 프레임에서는 직전의 마스크가 그대로 출력됩니다. 입력이 연결되지 않았을 때는 검은색이 나옵니다.

입력 포트

Port ID타입
Input TextureRenderTexture
Enablebool
Confidence Thresholdfloat
Inference Every N Framesint
Max Detectionsint

출력 포트

Port ID타입
Mask OutputRenderTexture
detectedCenterX0float
detectedCenterY0float

스크립트에서 설정할 수 있는 멤버

경로타입
enableInputbool
confidenceInputfloat
skipFramesInputint
maxDetectionsInputint
isEnabledbool
confidenceThresholdfloat
inferenceEveryNFramesint
maxDetectionsint

Synapse Apps (스크립팅)

await synapse.modules.create({ type: "YoloDetection" })

같은 페이지를 참조하는 페이지