CDC::GetGlyphOutline

Artykuł
02/27/2013

Pobiera krzywej konspektu lub bitmapy znak konspektu w bieżącej czcionki.

DWORD GetGlyphOutline(
   UINT nChar,
   UINT nFormat,
   LPGLYPHMETRICS lpgm,
   DWORD cbBuffer,
   LPVOID lpBuffer,
   const MAT2* lpmat2
) const;

Parametry

nChar
Określa znak, którego informacje są zwracane.

nFormat
Określa format, w którym funkcja zwraca informacje.Mogą to być jedna z następujących wartości lub 0:

Wartość	Znaczenie
GGO_BITMAP	Zwraca bitmapy glifów.Kiedy funkcja zwraca, bufora wskazywanego przez lpBuffer zawiera mapę bitową 1 bit na piksel, której wiersze start na granice słowa.
GGO_NATIVE	Zwraca krzywej punktów danych w formacie macierzystym rasteryzatora, używając jednostek urządzenia.Jeżeli określono wartość dowolnego przekształcenia określone w lpmat2 jest ignorowana.

Gdy wartość nFormat jest równy 0, funkcja wypełnia GLYPHMETRICS struktury, lecz nie zwraca danych konspektu glifów.

lpgm
Wskazuje na GLYPHMETRICS strukturę, która opisuje położenie glifów w komórce znak.
cbBuffer
Określa rozmiar buforu, do którego funkcja kopiuje informacje o znaku konspektu.Jeśli ta wartość jest równa 0 i nFormat parametr jest albo GGO_BITMAP lub GGO_NATIVE wartości, funkcja zwraca wymagany rozmiar buforu.
lpBuffer
Punkty do buforu, do którego funkcja kopiuje informacje o znaku konspektu.Jeśli nFormat Określa GGO_NATIVE , informacji jest kopiowana w postaci TTPOLYGONHEADER i TTPOLYCURVE struktury.Jeśli wartość ta jest NULL i nFormat albo GGO_BITMAP lub GGO_NATIVE wartości, funkcja zwraca wymagany rozmiar buforu.
lpmat2
Wskazuje na MAT2 strukturę, która zawiera znak macierzy transformacji.Ten parametr nie może być NULLnawet wtedy, gdy GGO_NATIVE określono wartość dla nFormat.

Wartość zwracana

Rozmiar w bajtach buforu wymaganych informacji pobranych, jeśli cbBuffer jest 0 lub lpBuffer jest NULL.W przeciwnym razie jest wartość dodatnia, jeśli funkcja się powiedzie, lub -1 Jeśli błąd.

Uwagi

Aplikację można obracać znaków pobierane w formacie mapy bitowej, określając macierzy transformacji 2-2 w strukturze wskazywanej przez lpmat2.

Konspekt glifów są zwracane jako serii konturów.Każdy kontur jest zdefiniowany przez TTPOLYGONHEADER struktury następuje tyle TTPOLYCURVE struktur, które są wymagane do jego opisu.Wszystkie punkty są zwracane jako POINTFX struktur i reprezentują pozycje bezwzględne, względne nie przenosi.Początkowy punkt podana przez pfxStart członek TTPOLYGONHEADER struktura jest punkt, od której rozpoczyna się konspekt ROZKŁAD.TTPOLYCURVE struktur, które należy wykonać może być łamanej rekordów lub rekordy krzywej składanej.POLYLINE rekordy są serii punktów; linii między punktami opisują konspektu znaku.Rekordy krzywej składanej reprezentują kwadratowe krzywych używanych przez TrueType (czyli kwadratowe b krzywe).