Fungsi D3DXCreateText

Membuat jala yang berisi teks yang ditentukan, menggunakan font yang terkait dengan konteks perangkat.

Sintaks

HRESULT D3DXCreateText(
  _In_  LPDIRECT3DDEVICE9   pDevice,
  _In_  HDC                 hDC,
  _In_  LPCTSTR             pText,
  _In_  FLOAT               Deviation,
  _In_  FLOAT               Extrusion,
  _Out_ LPD3DXMESH          *ppMesh,
  _Out_ LPD3DXBUFFER        *ppAdjacency,
  _Out_ LPGLYPHMETRICSFLOAT pGlyphMetrics
);

Parameter

pDevice [in]

Jenis: LPDIRECT3DDEVICE9

Arahkan ke perangkat yang membuat jala.

hDC [in]

Jenis: HDC

Konteks perangkat, berisi font untuk output. Font yang dipilih oleh konteks perangkat harus berupa font TrueType.

pText [in]

Jenis: LPCTSTR

Penunjuk ke string yang menentukan teks yang akan dihasilkan. Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data string diselesaikan ke LPCSTR. Lihat Keterangan.

Penyimpangan [in]

Jenis: FLOAT

Penyimpangan akor maksimum dari kerangka font TrueType.

Ekstrusi [in]

Jenis: FLOAT

Jumlah untuk mengekstrusi teks ke arah z negatif.

ppMesh [out]

Jenis: LPD3DXMESH*

Penunjuk ke jala yang dikembalikan.

ppAdjacency [out]

Jenis: LPD3DXBUFFER*

Penunjuk ke buffer yang berisi informasi yang berdekatan. Mungkin NULL.

pGlyphMetrics [out]

Jenis: LPGLYPHMETRICSFLOAT

Penunjuk ke array struktur GLYPHMETRICSFLOAT yang berisi data metrik glyph. Setiap elemen berisi informasi tentang posisi dan orientasi glyph yang sesuai dalam string. Jumlah elemen dalam array harus sama dengan jumlah karakter dalam string. Perhatikan bahwa asal dalam setiap struktur tidak relatif terhadap seluruh string, melainkan relatif terhadap sel karakter tersebut. Untuk menghitung seluruh kotak pembatas, tambahkan kenaikan untuk setiap glyph saat melintasi string. Jika Anda tidak peduli dengan ukuran glyph, atur parameter ini ke NULL.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu dari yang berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Keterangan

Pengaturan pengkompilasi juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXCreateTextW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXCreateTextA karena string ANSI sedang digunakan.

Fungsi ini membuat jala dengan opsi pembuatan D3DXMESH_MANAGED dan D3DFVF_XYZ | D3DFVF_NORMAL format vertex fleksibel (FVF).

Persyaratan

Persyaratan	Nilai
Header	D3dx9shape.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Menggambar Bentuk