put 명령

  • 아티클

put 명령은 표시에 사용되는 원본 이미지 및 대상 창의 영역을 정의합니다. 디지털 비디오 및 비디오 오버레이 디바이스는 이 명령을 인식합니다.

이 명령을 보내려면 다음과 같이 lpszCommand 매개 변수가 설정된 mciSendString 함수를 호출합니다.

_stprintf_s(
  lpszCommand, 
  TEXT("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
);

매개 변수

lpszDeviceID

MCI 디바이스의 식별자입니다. 이 식별자 또는 별칭은 디바이스를 열 때 할당됩니다.

lpszRegions

영역을 정의하기 위한 플래그입니다. 다음 표에서는 put 명령과 각 형식에서 사용하는 플래그를 인식하는 디바이스 유형을 나열합니다.

값 의미 의미
digitalvideo 사각형의 직사각형원본 원본에 있는 사각형 프레임 프레임의 대상 대상 직사각형창의 사각형 창 클라이언트 창 클라이언트 사각형에 있는 비디오 비디오
오버레이 사각형프레임 프레임의 대상 대상 직사각형의 원본 원본 비디오 사각형 비디오

다음 표에서는 lpszRegions 매개 변수에 지정할 수 있는 플래그와 해당 의미를 나열합니다.

값 의미
destination 대상 창의 전체 클라이언트 영역을 선택하여 데이터를 표시합니다.
대상(사각형) 이미지를 표시하는 데 사용되는 대상 창의 클라이언트 영역 일부를 선택합니다. 디스플레이 창의 영역을 지정하고 디바이스가 스트레칭을 지원하면 원본 이미지가 대상 오프셋 및 익스텐트까지 확장됩니다.
frame 들어오는 비디오 이미지를 받을 전체 프레임 버퍼를 선택합니다.
사각형의 프레임 들어오는 비디오 이미지를 받을 프레임 버퍼의 일부를 선택합니다.
source 대상 창에 표시할 전체 이미지를 선택합니다.
직사각형의 원본 대상 창에 표시할 이미지의 일부를 선택합니다. 원본 이미지의 영역을 지정하고 디바이스가 스트레칭을 지원하면 원본 이미지가 대상 오프셋 및 익스텐트까지 확장됩니다.
비디오 프레임 버퍼에서 캡처할 전체 들어오는 비디오 이미지를 선택합니다.
사각형의 비디오 프레임 버퍼에서 캡처할 들어오는 비디오 이미지의 일부를 선택합니다.
시간 범위 디스플레이의 초기 창 크기를 복원합니다. 이 명령은 창도 표시합니다.
사각형의 창 표시 창의 크기와 위치를 변경합니다. "style child" 플래그가 open 명령에 사용된 경우 지정된 사각형은 표시 창의 부모 창(일반적으로 바탕 화면)을 기준으로 합니다. 높이 또는 너비를 변경하지 않고 창의 위치를 변경하려면 높이와 너비에 대해 0을 지정합니다.
창 클라이언트 창의 클라이언트 영역을 복원합니다.
사각형의 창 클라이언트 창의 클라이언트 영역 크기와 위치를 변경합니다. 지정된 사각형은 클라이언트 창의 부모 창을 기준으로 합니다. 높이 또는 너비를 변경하지 않고 창의 위치를 변경하려면 높이와 너비에 대해 0을 지정합니다.

플래그에 사각형이 포함된 경우 사각형 좌표는 창 원본 또는 이미지 원본을 기준으로 하며 X1 Y1 X2 Y2로 지정됩니다. 좌표 X1Y1 은 왼쪽 위 모서리를 지정하고 좌표 X2Y2 는 사각형의 너비와 높이를 지정합니다.

lpszFlags

"wait", "notify" 또는 둘 다일 수 있습니다. 디지털 비디오 디바이스의 경우 "테스트"를 지정할 수도 있습니다. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다.

설명

put 명령은 비디오 오버레이 디바이스로 작업할 때 다음 사각형 중 하나 이상을 정의합니다.

  • 비디오 사각형은 캡처할 들어오는 비디오 이미지의 영역을 정의합니다.
  • 프레임 사각형은 들어오는 비디오 이미지를 수신하는 프레임 버퍼의 영역을 정의합니다.
  • 원본 사각형은 대상 사각형에 복사되는 프레임 버퍼의 영역을 정의합니다.
  • 대상 사각형은 비디오 이미지를 수신하는 표시 창 클라이언트 영역의 영역을 정의합니다.

비디오 사각형은 원본 사각형이 대상 사각형과 관련된 것과 동일한 방식으로 프레임 사각형과 관련이 있습니다. 확장은 비디오 사각형에서 프레임 사각형으로, 원본 사각형에서 대상 사각형까지 발생할 수 있습니다. 모든 디바이스가 스트레치를 지원하는 것은 아니며 집합 명령을 사용하여 스트레칭을 사용하도록 설정해야 합니다.

다음 명령은 비디오, 프레임 및 원본에 대한 세 가지 영역을 정의합니다.

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

이 예제의 지역은 다음과 같이 정의됩니다.

  • 왼쪽 위 모서리에서 원점 120픽셀부터 들어오는 비디오 데이터의 200x200픽셀 영역이 프레임 버퍼에 캡처됩니다.
  • 비디오 데이터는 프레임 버퍼의 왼쪽 위 모서리에 있는 200x200픽셀 영역에 배치됩니다.
  • 전송은 프레임 버퍼의 왼쪽 위 모서리에 있는 200x200픽셀 영역에서 대상 창으로 전송됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]

추가 정보

Mci

MCI 명령 문자열

열기

set