Funzione DrvQueryFontCaps (winddi.h)

Articolo
03/15/2023

La funzione DrvQueryFontCaps definisce le funzionalità del driver del tipo di carattere.

Sintassi

LONG DrvQueryFontCaps(
  ULONG culCaps,
  ULONG *pulCaps
);

Parametri

culCaps

Specifica il numero di valori ULONG nella matrice a cui punta il parametro pulCaps che può essere scritto dal driver del tipo di carattere.

pulCaps

Puntatore a una matrice che riceve il numero di valori specificati nel primo parametro. Gli elementi della matrice hanno i significati seguenti:

Elemento	Significato
pulCaps[0]	Conteggio del numero di valori ULONG nella matrice completa. Se culCaps è minore di questo valore, il chiamante riceverà una matrice incompleta.
pulCaps[1]	Set di flag che possono essere uno o più dei valori seguenti: QC_OUTLINES Se questo flag è impostato, il driver del tipo di carattere può restituire una descrizione della struttura dei glifi. Inoltre, si presuppone che i tipi di carattere siano scalabili. I tipi di carattere bitmap non hanno questo flag impostato. QC_1BIT Indica che il driver del tipo di carattere è in grado di restituire bitmap monocromatiche di ogni glifo. QC_4BIT Indica che il driver del tipo di carattere è in grado di restituire bitmap antialiased a 4 bit per pixel. Ogni pixel nella bitmap è rappresentato da un valore senza segno a 4 bit nell'intervallo compreso tra 0 e 15, con 16 sfumature di grigio.

Elemento

Significato

pulCaps[0]

Conteggio del numero di valori ULONG nella matrice completa. Se culCaps è minore di questo valore, il chiamante riceverà una matrice incompleta.

pulCaps[1]

Set di flag che possono essere uno o più dei valori seguenti:

QC_OUTLINES
Se questo flag è impostato, il driver del tipo di carattere può restituire una descrizione della struttura dei glifi. Inoltre, si presuppone che i tipi di carattere siano scalabili. I tipi di carattere bitmap non hanno questo flag impostato.

QC_1BIT
Indica che il driver del tipo di carattere è in grado di restituire bitmap monocromatiche di ogni glifo.

QC_4BIT
Indica che il driver del tipo di carattere è in grado di restituire bitmap antialiased a 4 bit per pixel. Ogni pixel nella bitmap è rappresentato da un valore senza segno a 4 bit nell'intervallo compreso tra 0 e 15, con 16 sfumature di grigio.

Valore restituito

Il valore restituito è il numero di valori ULONG scritti nel buffer di destinazione se la funzione ha esito positivo. In caso contrario, è FD_ERROR.

Commenti

Un driver potrebbe segnalare che supporta più formati per un tipo di carattere. Ad esempio, un driver potrebbe, in linea di principio, restituire con QC_1BIT e QC_4BIT set, a indicare che è in grado di restituire sia versioni monocromatiche che antialiased del tipo di carattere. Tutte le bitmap generate da un driver di tipo di carattere devono iniziare e terminare con limiti a 32 bit. Se necessario, la fine di una bitmap deve essere "riempita" per soddisfare questo requisito.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	winddi.h (include Winddi.h)

Vedi anche

DrvQueryFont

DrvQueryFontTree

Condividi tramite