THotPDF.DecodeLoadedImageColorKeyMask Método
Construye el bitmap de máscara color-key de una imagen cargada cuyo diccionario contiene una entrada /Mask en forma de array
Declaración
function DecodeLoadedImageColorKeyMask(
AImageStream: THPDFStreamObject): TBitmap;
Unidad
HPDFDoc
Parámetros
| Nombre | Propósito |
|---|---|
AImageStream | Objeto de stream de imagen cargado cuyo diccionario contiene el array /Mask color-key |
Valor de retorno
Bitmap de escala de grises de 24 bits con las dimensiones de la imagen, donde el negro marca los píxeles cuyas muestras caen todas dentro de sus rangos de componente y el blanco marca los píxeles con algún componente fuera de su rango; nil cuando la imagen no es elegible
Notas de uso
- La elegibilidad replica las reglas de máscara color-key del PDF: la imagen debe ser decodificable, no ser una image mask, tener de 1 a 4 componentes de color y poseer un array /Mask de 2 valores por componente
- Los rangos se comparan con las muestras tal y como están almacenadas, antes de
/Decode; para una imagen Indexed eso es el índice de paleta, de modo que dos entradas del mismo color pueden enmascararse de forma distinta - Los streams DCTDecode, JPXDecode, JBIG2Decode y con codificación CCITT devuelven nil: los códecs con pérdida no conservan valores de muestra exactos
RenderLoadedPageToBitmapyBuildLoadedPageSVGaplican esta máscara cuando dibujan la imagen- La decodificación respeta el presupuesto de bytes de decodificación configurado, de modo que las imágenes hostiles o demasiado grandes fallan de forma limpia en lugar de agotar la memoria
- El bitmap devuelto es propiedad del llamador; combínelo con
DecodeLoadedImageStreampara previsualizar qué regiones tratará el visor como enmascaradas