AddImageDirectFromString
Manejo de imágenes
Descripción
Crea un XObject de imagen directamente a partir de bytes de muestras de imagen ya codificados en lugar de detectar un formato contenedor como PNG, TIFF o JPEG
Comportamiento de la versión PDF: el filtro de imagen JBIG2Decode requiere PDF 1.4, mientras que JPXDecode, Crypt y las muestras de imagen con BitsPerComponent = 16 requieren PDF 1.5. Cuando un documento se configura con una versión inferior a la necesaria y la versión de guardado no está bloqueada, AddImageDirectFromString eleva automáticamente la versión del documento y registra JBIG2Decode filter, JPXDecode filter, Crypt filter o 16-bit image samples en AutoBumpedFeatures. Si el llamador bloquea una versión de guardado inferior, la comprobación de compatibilidad rechaza el guardado con LastErrorCode 602
Sintaxis
Delphi
Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;Parámetros
| Source | Datos de imagen sin procesar o codificados que se almacenarán en el flujo de imagen |
|---|---|
| Width | Anchura de la imagen en píxeles |
| Height | Altura de la imagen en píxeles |
| BitsPerComponent | Número de bits por componente de muestra. Los diccionarios de imagen PDF permiten 1, 2, 4 y 8 en las versiones anteriores; las muestras de 16 bits corresponden a PDF 1.5 |
| ColorSpace | Nombre de espacio de color PDF o texto de matriz para el diccionario de imagen, como /DeviceGray, /DeviceRGB o una matriz indexada |
| Filter | Nombre del filtro de flujo PDF, como FlateDecode, DCTDecode o JPXDecode. Utilice una cadena vacía para los datos sin filtrar |
| Decode | Texto opcional de la matriz Decode de PDF. Pase una cadena vacía cuando no se necesite una entrada Decode |
| Interpolate | Un valor distinto de cero escribe la marca /Interpolate true |
Valores devueltos
| 0 | No se pudo crear la imagen o el modo PDF/A actual prohíbe el filtro solicitado |
|---|---|
| Non-zero | El nuevo ImageID. La imagen creada queda seleccionada para operaciones de imagen posteriores |
Observaciones
El modo PDF/A rechaza LZWDecode en todas las partes y rechaza JBIG2Decode / JPXDecode en PDF/A-1. El llamador es responsable de hacer coincidir los bytes de Source con los valores declarados de ColorSpace, Filter, Decode, las dimensiones y la profundidad de muestra
Véase también
AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage