다음을 통해 공유

Device.StretchRectangle 메서드

  • 아티클

업데이트: 2007년 11월

소스 사각형의 내용을 대상 사각형에 복사합니다.

네임스페이스:  Microsoft.WindowsMobile.DirectX.Direct3D
어셈블리:  Microsoft.WindowsMobile.DirectX(Microsoft.WindowsMobile.DirectX.dll)

구문

‘선언
Public Sub StretchRectangle ( _
    sourceSurface As Surface, _
    sourceRectangle As Rectangle, _
    destSurface As Surface, _
    destRectangle As Rectangle, _
    filter As TextureFilter _
)
‘사용 방법
Dim instance As Device
Dim sourceSurface As Surface
Dim sourceRectangle As Rectangle
Dim destSurface As Surface
Dim destRectangle As Rectangle
Dim filter As TextureFilter

instance.StretchRectangle(sourceSurface, _
    sourceRectangle, destSurface, destRectangle, _
    filter)

public void StretchRectangle(
    Surface sourceSurface,
    Rectangle sourceRectangle,
    Surface destSurface,
    Rectangle destRectangle,
    TextureFilter filter
)

public:
void StretchRectangle(
    Surface^ sourceSurface, 
    Rectangle sourceRectangle, 
    Surface^ destSurface, 
    Rectangle destRectangle, 
    TextureFilter filter
)

public function StretchRectangle(
    sourceSurface : Surface, 
    sourceRectangle : Rectangle, 
    destSurface : Surface, 
    destRectangle : Rectangle, 
    filter : TextureFilter
)

매개 변수

  • sourceRectangle
    형식: System.Drawing.Rectangle

    소스 사각형을 나타내는 Rectangle 개체입니다. nullNull 참조(Visual Basic의 경우 Nothing)이면 전체 소스 표면이 사용됩니다.

  • destRectangle
    형식: System.Drawing.Rectangle

    대상 사각형을 나타내는 Rectangle 개체입니다. nullNull 참조(Visual Basic의 경우 Nothing)이면 전체 대상 표면이 사용됩니다.

설명

소스 사각형은 복사본에 의해 확장되고 필터링될 수 있습니다. 이 메서드는 비디오 스트림의 가로 세로 비율을 변경하는 데 사용되는 경우가 많습니다.

연산의 결과로 확장되거나 축소되는 경우 모든 표면 조합이 StretchRectangle에 유효한 것은 아닙니다. 다른 요소에는 관련된 표면 형식과 해당 형식이 포함됩니다.

다음 표에는 유효한 표면 대상 형식 조합이 나와 있습니다.

소스 형식

질감

RT 질감

RT

화면 외부 평면

질감

아니요

예

예

아니요

RT 질감

아니요

예

예

아니요

RT

아니요

예

예

아니요

화면 외부 평면

아니요

예

예

예, 그러나 확장하지 않는 경우에만 해당

필터링이 지정된 경우 드라이버에서 StretchRectangleFilterCaps를 설정하지 않으면 StretchRectangle에서 오류가 발생합니다. None이 지정되어 있으면 드라이버에서 필터링 알고리즘을 선택합니다.

호출에서 확장이나 축소가 발생하지 않는 경우 StretchRectangle 호출에서 깊이 스텐실 표면을 사용할 수 있습니다. 다음 제한은 StretchRectangle을 호출하여 복사되는 경우 DepthStencil 표면에도 적용됩니다.

  • 두 표면이 형식을 변환하지 않는 동일한 형식이어야 합니다.

  • 확장이나 축소가 허용되지 않습니다.

  • 전체 표면만 복사될 수 있습니다. 부분 사각형 복사본은 허용되지 않습니다.

질감 맵이 내부 정보와 변경 사각형 테이블을 사용하도록 디자인되었기 때문에 응용 프로그램에서는 StretchRectangle이 아니라 CopyRects 또는 UpdateTexture를 사용하여 질감 맵을 로드해야 합니다.

동일한 표면에서 사각형 간의 확장은 지원되지 않습니다. 색 변환에 대해 하드웨어를 테스트하려면 변환에 대한 소프트웨어 에뮬레이션이 지원되지 않으므로 Manager의 CheckDeviceFormatConversion 메서드를 사용합니다. 이 메서드는 동일한 형식의 표면 간 확장이 지원되는지 여부도 나타냅니다. 표면 중 하나에 DXTn 압축 형식이 있으면 확장이나 축소가 지원되지 않습니다. 소스 표면은 다중 샘플링되지 않아야 합니다.

권한

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

플랫폼

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Compact Framework

3.5, 2.0에서 지원

참고 항목

참조

Device 클래스

Device 멤버

Microsoft.WindowsMobile.DirectX.Direct3D 네임스페이스