이미지 스택

압축된 비디오 프레임을 고정 크기 FIFO 스택에 누적합니다.

압축된 비디오 프레임을 고정 크기 스택에 누적하여, 가장 최근 N개의 프레임을 JPEG로 인코딩된 바이너리 블롭으로 반환합니다. 공유 호스팅 안전성을 위해 설계되었으며, 프레임은 항상 JPEG로 압축되고 해상도 제한에 맞도록 다운샘플링되어 메모리 부족 상태를 방지합니다.

이 블록의 작동 방식

1. 각 워크플로 사이클마다 비디오 프레임(WorkflowImageData)을 받습니다.

2. 프레임이 구성된 해상도 제한(기본 1920x1080)을 초과하면 종횡비를 유지한 채 다운샘플링합니다.

3. 품질 75로 프레임을 JPEG로 인코딩하고 결과 바이트를 저장합니다.

4. 카메라별 FIFO 버퍼(deque)를 최대 stack_size 개의 압축 프레임까지 유지합니다. 버퍼가 가득 차면 가장 오래된 프레임이 자동으로 제거됩니다.

5. 만약 stack_size 가 호출 사이에 변경되면(예: 동적 선택기를 통해), 버퍼 크기가 조정되고 기존 프레임은 새 제한까지 유지됩니다.

6. 만약 clear 입력이 True이면 현재 프레임을 추가하기 전에 버퍼를 비웁니다.

7. JPEG 바이트 블롭 목록(최신순)과 현재 프레임 수를 출력합니다.

일반적인 사용 사례

• 동작 / 활동 인식: N개의 프레임 클립을 누적한 뒤, 여러 이미지를 추론할 수 있는 비전-언어 모델(예: Google Gemini, Qwen)에 전달하여 동작을 분류하고, 이벤트를 감지하거나, 장면에서 일어나고 있는 일을 설명합니다.

• 타임랩스 스냅샷: 주기적인 시각 비교를 위해 마지막 N개의 프레임을 수집합니다.

• 이벤트 버퍼링: 관심 이벤트를 중심으로 프레임의 롤링 윈도우를 유지합니다.

유형 식별자

단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/image_stack@v1 워크플로우에 이 블록을 단계로 추가하려면.

속성

이름	유형	설명	참조
name	str	이 단계에 대한 고유 식별자를 입력하세요..	❌
stack_size	정수	스택에 유지할 최대 프레임 수(1-64)입니다. 스택이 가득 차면 가장 오래된 프레임이 제거됩니다..	✅
resolution_width	정수	픽셀 단위의 최대 프레임 너비(64-1920)입니다. 이보다 넓은 프레임은 종횡비를 유지한 채 다운샘플링됩니다..	✅
resolution_height	정수	픽셀 단위의 최대 프레임 높이(64-1080)입니다. 이보다 높은 프레임은 종횡비를 유지한 채 다운샘플링됩니다..	✅
clear	bool	True이면 현재 프레임을 추가하기 전에 전체 프레임 버퍼를 비웁니다. 장면 변경 시 상태를 초기화할 때 유용합니다..	✅

이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.

런타임 호환성

소프트 - 런타임 호스팅 서버리스, 전용 배포; 실행 원격; 입력 비디오 : 프레임 스택은 video_identifier별로 프로세스 메모리에 저장됩니다. 상태 비저장 또는 다중 복제본 HTTP 런타임에서 원격 단계 실행을 사용하면 연속된 프레임이 서로 다른 워커 프로세스에서 처리될 수 있으므로, 스택이 초기화되거나 일부 프레임 기록만 포함할 수 있습니다. 안정적인 프레임 간 결과를 위해서는 지속적인 WebRTC 세션에서 로컬 단계 실행을 사용하세요.

소프트 - 입력 이미지 : 이 블록은 비디오나 반복 프레임 워크플로의 시간적 문맥에 의존합니다. 정지 이미지/사진에는 추적, 비교, 집계 또는 시각화할 의미 있는 히스토리가 없으므로 이 블록은 거의 또는 전혀 이점을 제공하지 않습니다.

입력 및 출력 바인딩

사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 이미지 스택 버전 v1 을 가지고 있는지.

입력 및 출력 바인딩

• 입력

  • 이미지 (이미지): 스택에 추가할 비디오 프레임입니다..

  • stack_size (정수): 스택에 유지할 최대 프레임 수(1-64)입니다. 스택이 가득 차면 가장 오래된 프레임이 제거됩니다..

  • resolution_width (정수): 픽셀 단위의 최대 프레임 너비(64-1920)입니다. 이보다 넓은 프레임은 종횡비를 유지한 채 다운샘플링됩니다..

  • resolution_height (정수): 픽셀 단위의 최대 프레임 높이(64-1080)입니다. 이보다 높은 프레임은 종횡비를 유지한 채 다운샘플링됩니다..

  • clear (boolean): True이면 현재 프레임을 추가하기 전에 전체 프레임 버퍼를 비웁니다. 장면 변경 시 상태를 초기화할 때 유용합니다..

• 출력

  • frames (list_of_values): 모든 유형의 값 목록.

  • frames_count (정수): 정수 값.

예시 JSON 정의

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/image_stack@v1",
	    "image": "$inputs.image",
	    "stack_size": 5,
	    "resolution_width": 640,
	    "resolution_height": 480,
	    "clear": false
	}