wglUseFontBitmapsA 함수(wingdi.h)

wglUseFontBitmaps 함수는 현재 OpenGL 렌더링 컨텍스트에서 사용할 비트맵 표시 목록 집합을 만듭니다. 비트맵 표시 목록 집합은 디바이스 컨텍스트에서 현재 선택된 글꼴의 문자 모양을 기반으로 합니다. 그런 다음 비트맵을 사용하여 OpenGL 이미지에 문자를 그릴 수 있습니다.

wglUseFontBitmaps 함수는 hdc 매개 변수의 선택한 글꼴에서 첫 번째 문자 모양으로 시작하는 개수 문자 모양 실행에 대해 하나씩 개수 표시 목록을 만듭니다.

구문

BOOL wglUseFontBitmapsA(
  HDC   unnamedParam1,
  DWORD unnamedParam2,
  DWORD unnamedParam3,
  DWORD unnamedParam4
);

매개 변수

unnamedParam1

현재 선택한 글꼴이 현재 OpenGL 렌더링 컨텍스트에서 문자 모양 비트맵 표시 목록을 형성하는 데 사용되는 디바이스 컨텍스트를 지정합니다.

unnamedParam2

문자 모양 비트맵 표시 목록을 형성하는 데 사용할 문자 모양 실행의 첫 번째 문자 모양을 지정합니다.

unnamedParam3

문자 모양 비트맵 표시 목록을 형성하는 데 사용할 문자 모양 실행의 문자 모양 수를 지정합니다. 함수는 실행의 각 문자 모양에 대해 하나씩 개수 표시 목록을 만듭니다.

unnamedParam4

시작 표시 목록을 지정합니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

wglUseFontBitmaps 함수는 현재 OpenGL 렌더링 컨텍스트에서 개수 표시 목록을 정의합니다. 각 표시 목록에는 listBase부터 식별 번호가 있습니다. 각 표시 목록은 glBitmap에 대한 단일 호출로 구성됩니다. bitmap listBase + i의 정의는 hdc에서 지정한 디바이스 컨텍스트에서 현재 선택된 글꼴의 문자 모양 첫 번째 + i에서 가져옵니다. 문자 모양이 정의되지 않은 경우 함수는 해당 문자 모양에 대한 빈 표시 목록을 정의합니다.

wglUseFontBitmaps 함수는 화면 평면에 비트맵 텍스트를 만듭니다. OpenGL에서 개체의 레이블을 지정할 수 있습니다.

현재 버전의 Microsoft OpenGL 구현에서는 이중 버퍼링된 픽셀 형식의 디바이스 컨텍스트에 GDI를 호출할 수 없습니다. 따라서 이러한 디바이스 컨텍스트에서는 GDI 글꼴 및 텍스트 함수를 사용할 수 없습니다. wglUseFontBitmaps 함수를 사용하여 이 제한을 우회하고 이중 버퍼링된 디바이스 컨텍스트에서 텍스트를 그릴 수 있습니다.

함수는 다음과 같이 glBitmap 에 대한 각 호출의 매개 변수를 결정합니다.

glBitmap 매개 변수 의미
width 문자 모양 구조체의 gmBlackBoxX 멤버에 반환된 문자 모양 비트 맵의 너비 입니다.
height(높이) 문자 모양 문자 모양 구조체의 gmBlackBoxY 멤버에 반환된 문자 모양 비트 맵의 높이 입니다.
xorig 문자 모양 구조체의 gmptGlyphOrigin.x 멤버에 반환된 문자 모양 원 점의 x 오프셋입니다.
yorig 문자 모양 구조체의 gmptGlyphOrigin.y 멤버에 반환된 문자 모양 원점의 y 오프 입니다.
xmove 문자 모양 구조체의 gmCellIncX 멤버에 반환된 다음 문자 셀의 원 점까지의 가로 거리입니다.
ymove 문자 모양 구조체gmCellIncY 멤버에 반환된 다음 문자 셀의 원점까지의 세로 거리입니다.
bitmap uFormat이 1인 GetGlyphOutline에서 반환한 문자 모양에 대한 비트맵입니다.
 

예제

다음 코드 예제에서는 wglUseFontBitmaps 를 사용하여 일부 텍스트를 그리는 방법을 보여줍니다.

HDC    hdc; 
HGLRC  hglrc; 
 
// create a rendering context  
hglrc = wglCreateContext (hdc); 
 
// make it the calling thread's current rendering context  
wglMakeCurrent (hdc, hglrc); 
 
// now we can call OpenGL API  
 
// make the system font the device context's selected font  
SelectObject (hdc, GetStockObject (SYSTEM_FONT)); 
 
// create the bitmap display lists  
// we're making images of glyphs 0 thru 254  
// the display list numbering starts at 1000, an arbitrary choice  
wglUseFontBitmaps (hdc, 0, 255, 1000); 
 
// display a string:  
// indicate start of glyph display lists  
glListBase (1000); 
// now draw the characters in a string  
glCallLists (24, GL_UNSIGNED_BYTE, "Hello Windows OpenGL World");

참고

wingdi.h 헤더는 wglUseFontBitmaps를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 wingdi.h
라이브러리 Opengl32.lib
DLL Opengl32.dll

추가 정보

문자 모양

GetGlyphOutline

Windows의 OpenGL

WGL 함수

glBitmap

glCallLists

glListBase

wglUseFontOutlines