CONVERT PICTURE
CONVERT PICTURE ( imagem ; codec {; compressao} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| imagem | Picture | → | Imagem a ser convertida |
| ← | Imagem convertida | ||
| codec | Text | → | Codec de identificação de Imagem |
| compressao | Real | → | Qualidade da compressão |
Descrição
O comando CONVERT PICTURE converte imagem em um novo tipo.
O parâmetro codec indica o tipo de imagem a gerar. Um codec pode ser uma extensão (por exemplo, “.gif”), um tipo Mime (por exemplo, “image/jpeg”).
Pode obter uma lista de codecs disponíveis utilizando o comando PICTURE CODEC LIST.
Se o campo ou variável imagem é de tipo composto (se por exemplo for o resultado da ação copiar -pegar), só a informação correspondente ao tipo codec se conserva na imagem resultante.
Nota: Se o tipo de codec solicitado é o mesmo que o tipo original da imagem, não se realiza nenhuna conversão e a imagem se devolve "tal qual" (exceto quando se utiliza o parâmetro compressao, ver a continuação).
O parâmetro opcional compressao, se for passada, permite definir a qualidade de compressão a aplicar a imagem resultante quando se utiliza um Codec compatível. Em compressao, passe um valor entre 0 e 1 para especificar a qualidade da compressão, onde 0 é a qualidade mais medíocre (alta compressão) e 1 a melhor qualidade (compressão baixa). Este parâmetro só é considerado quando o codec for compatível com a compressão (por exemplo JPEG o HDPhoto) e for compatível com os APIs WIC e ImageIO. Portanto, não pode ser utilizado com Codecs administrados por QuickTime unicamente. Para maior informação sobre os APIs de gestão de imagem em 4D, consulte a seção Imagens. Por padrão, se omitir o parâmetro compressao, se aplica a melhor qualidade (compressão =1).
Nota: Se quiser chamar CONVERT PICTURE com o tipo de imagem que não for compatível em versões 4D de 64-bits (tais como PICT), tenha certeza de que a conversão é realizada em uma versão 4D de 32-bits, na qual o tipo original é compatível. Para saber mais, veja a página Mudar de versões 32-bits a versões 64-bits.
Exemplo 1
Conversão da imagem vpFoto ao formato jpeg:
CONVERT PICTURE(vpFoto;".jpg")
Exemplo 2
Conversão de uma imagem com qualidade de 60%:
CONVERT PICTURE(vPicture;".JPG";0.6)