Función CreateHalftonePalette (wingdi.h)

La función CreateHalftonePalette crea una paleta de tono medio para el contexto de dispositivo (DC) especificado.

Syntax

HPALETTE CreateHalftonePalette(
  [in] HDC hdc
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

Valor de retorno

Si la función se ejecuta correctamente, el valor devuelto es un identificador de una paleta lógica de medio tono.

Si se produce un error en la función, el valor devuelto es cero.

Remarks

Una aplicación debe crear una paleta de medios tonos cuando el modo de ajuste de un contexto de dispositivo se establece en HALFTONE. La paleta lógica de tono medio devuelta por CreateHalftonePalette debe seleccionarse y realizarse en el contexto del dispositivo antes de llamar a la función StretchBlt o StretchDIBits .

La paleta de tonos medio contiene los 20 colores estáticos del sistema más un conjunto independiente del dispositivo de colores (un cubo de color RGB de 6x6x6 y tonos grises adicionales) elegido para aproximar una amplia gama de colores cuando se dithera una imagen. Las entradas de color exactas son un detalle de implementación y no se garantiza que sean idénticas entre dispositivos o versiones de Windows; las aplicaciones no deben depender de valores de paleta específicos ni de ningún algoritmo de dithering concreto. Para inspeccionar las entradas en tiempo de ejecución, llame a GetPaletteEntries en el identificador de paleta devuelto.

Cuando ya no necesite la paleta, llame a la función DeleteObject para eliminarla.

Requisitos

Consulte también

Funciones de color

Información general sobre colores

DeleteObject

GetPaletteEntries

RealizePalette

SelectPalette

SetStretchBltMode

StretchBlt

StretchDIBits