AddImageDirectFromString
Manipulação de imagens
Descrição
Cria um XObject de imagem diretamente de bytes de amostra de imagem já codificados, em vez de detectar um formato de contêiner como PNG, TIFF ou JPEG.
Comportamento de versão do PDF: o filtro de imagem JBIG2Decode exige PDF 1.4, enquanto JPXDecode, Crypt e amostras de imagem com BitsPerComponent = 16 exigem PDF 1.5. Quando um documento está definido abaixo da versão exigida e a versão de salvamento não está travada, AddImageDirectFromString eleva automaticamente a versão do documento e registra JBIG2Decode filter, JPXDecode filter, Crypt filter ou 16-bit image samples em AutoBumpedFeatures. Se o chamador travar uma versão de salvamento menor, o gate de compatibilidade rejeita o salvamento com LastErrorCode 602.
Sintaxe
Delphi
Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;Parâmetros
| Source | Dados de imagem brutos ou codificados a armazenar no stream da imagem. |
|---|---|
| Width | Image width in pixels. |
| Height | Image height in pixels. |
| BitsPerComponent | Número de bits por componente de amostra. Dicionários de imagem do PDF permitem 1, 2, 4 e 8 em versões anteriores; amostras de 16 bits são do PDF 1.5. |
| ColorSpace | Nome ou texto de array de espaço de cores do PDF para o dicionário da imagem, por exemplo /DeviceGray, /DeviceRGB, ou um array de espaço de cores indexado. |
| Filter | PDF stream filter name, such as FlateDecode, DCTDecode, or JPXDecode. Use an empty string for unfiltered data. |
| Decode | Texto opcional do array PDF Decode. Passe uma string vazia quando nenhuma entrada Decode for necessária. |
| Interpolate | Valor diferente de zero grava o flag /Interpolate true. |
Valores retornados
| 0 | A imagem não pôde ser criada, ou o modo PDF/A atual proíbe o filtro solicitado. |
|---|---|
| Non-zero | O novo ImageID. A imagem criada é selecionada para as operações de imagem seguintes. |
Observações
O modo PDF/A rejeita LZWDecode em todos os parts e rejeita JBIG2Decode / JPXDecode no PDF/A-1. O chamador é responsável por casar os bytes de Source com o ColorSpace, Filter, Decode, dimensões e profundidade de amostra declarados.
Veja também
AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage