AddImageDirectFromString
Manejo de imágenes
Descripción
Crea un XObject de imagen directamente a partir de bytes de muestras de imagen ya codificados, en vez de detectar un formato de contenedor como PNG, TIFF o JPEG
Comportamiento de la versión de 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 establece por debajo de la versión requerida 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 quien llama bloquea una versión de guardado inferior, la compuerta 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 | Ancho 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 imágenes PDF permiten 1, 2, 4 y 8 en versiones anteriores; las muestras de 16 bits son PDF 1.5 |
| ColorSpace | Nombre de espacio de color PDF o texto de matriz para el diccionario de imágenes, por ejemplo /DeviceGray, /DeviceRGB o una matriz de espacio de color indexado |
| Filter | Nombre de filtro de flujo PDF, como FlateDecode, DCTDecode o JPXDecode. Use una cadena vacía para datos sin filtrar |
| Decode | Texto opcional del arreglo Decode de PDF. Pase una cadena vacía cuando no se necesite una entrada Decode |
| Interpolate | Un valor distinto de cero escribe el indicador /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 las operaciones de imagen posteriores |
Observaciones
El modo PDF/A rechaza LZWDecode en todas las partes y rechaza JBIG2Decode / JPXDecode en PDF/A-1. La persona que llama 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