Imagens

4D inclui suporte específico para imagens utilizadas nos seus formulários.

Formatos Nativos Suportados

4D integra a gestão nativa dos formatos de imagem. Isso significa que imagens serão mostradas e armazenadas em seu formato original, sem qualquer interpretação em 4D. As funcionalidades específicas dos formatos diferentes (sombreado, áreas transparentes, etc) serão retidas quando forem copiadas e coladas, e serão exibidas sem alteração. Essa compatibilidade nativa é válida para todas as imagens armazenadas nos formulários de 4D: imagens estáticas coladas no modo Desenho, imagens coladas em objetos de entrada em execução, etc.

The most common picture formats are supported of both platforms: .jpeg, .gif, .png, .tiff, .bmp, etc. On macOS, the .pdf format is also available for encoding and decoding. Em macOS, o formato pdf também está disponível para codificar e decodificar.

A lista completa dos formatos suportados varia de acordo com o sistema operativo e os codecs personalizados que são instalados nas máquinas. Para descobrir quais os codecs disponíveis, deve utilizar o comando PICTURE CODEC LIST (ver também a descrição do tipo de dados imagem).

Formato de imagem não disponível

Um ícone específico é exibido para imagens salvas em um formato que não esteja disponível no mecanismo. A extensão do formato faltante é mostrado na parte inferior do ícone:

O ícone é usado automaticamente onde a imagem precisar ser exibida:

O ícone indica que a imagem não pode ser exibida ou manipulada localmente - mas pode ser salva sem alteração para que possa ser exibida em outros dispositivos. Por exemplo esse é o caso para imagens PDF em Windows ou para imagens no formato PICT.

Imagens em alta resolução

4D suporta imagens de alta resolução tanto em plataformas MacOS como Windows. As imagens de alta resolução podem ser definidas quer por factor de escala quer por dpi.

Factor de escala

Os ecrãs de alta resolução têm uma maior densidade de píxeis do que os ecrãs padrão tradicionais. Para que as imagens sejam renderizadas correctamente em ecrãs de alta resolução, o número de pixels na imagem deve ser multiplicado pelo factor de escala * (ou seja*, duas vezes maior, três vezes maior, etc.).

Ao utilizar imagens de alta resolução, pode especificar o factor de escala adicionando "@nx" no nome da imagem (onde n designa o factor de escala). No quadro abaixo, pode ver que o fator de escala está indicado nos nomes das imagens de alta resolução, circle@2x.png e circle@3x.png.

Display Type	Factor de escala	Exemplo
Resolução ‘standard’	Densidade de pixel 1:1.	1x circle.png
Alta resolução	A densidade de pixels aumentou por um factor de 2 ou 3.	2x 3x circle@2x.png circle@3x.png

As imagens de alta resolução com a convenção @nx podem ser utilizadas nos seguintes objectos:

• Imagens estáticas
• Botões/radio/caixas de verificação
• Botões imagem/Pop-ups imagem
• Tab controls
• Cabeçalhos de list box
• Ícones de menu

4D dá automaticamente prioridade às imagens com a resolução mais alta. 4D automatically prioritizes pictures with the highest resolution. Mesmo que um comando ou propriedade especifique circle.png, circle@3x.png será utilizado (se existir).

Note que a priorização da resolução ocorre apenas para a apresentação de imagens no ecrã, não havendo priorização automática durante a impressão.

DPI (macOS and Windows)

While 4D automatically prioritizes the highest resolution, there are, however, some behavioral differences depending on screen and image dpi(*), and picture format:

Operação	Comportamento
Soltar o pegar	Se a imagem tiver: 72dpi or 96dpi - The picture is "Center" formatted and the object containing the picture has the same number of pixels. Other dpi - The picture is "Scaled to fit" formatted and the object containing the picture is equal to (picture's number of pixels * screen dpi) / (picture's dpi) No dpi - The picture is "Scaled to fit" formatted.
Automatic Size (Form Editor context menu)	Se o formato de apresentação da imagem é: Scaled - The object containing the picture is resized according to (picture's number of pixels * screen dpi) / (picture's dpi) Not scaled - The object containing the picture has the same number of pixels as the picture.

(*) Normalmente, macOS = 72 dpi, Windows = 96 dpi

Imagens em modo escuro (apenas macOS)

You can define specific pictures and icons to be used instead of standard pictures when forms use the dark scheme.

Uma imagem em modo escuro é definida da seguinte forma:

• dark mode picture has the same name as the standard (light scheme) version with the suffix "_dark"
• a imagem do modo escuro é guardada ao lado da versão padrão.

Em tempo de execução, 4D carregará automaticamente a imagem clara ou escura de acordo com o esquema de cores do formulário atual.

Coordenadas do rato numa imagem

4D permite recuperar as coordenadas locais do mouse em um objeto de entrada associado a uma expressão de imagem, no caso de que clique ou passe o cursor por cima, mesmo se não tiver aplicado um deslocamento ou zoom na imagem. Esse mecanismo, similar ao de um mapa de imagens, pode ser utilizado, por exemplo, para manejar barras de botões deslocáveis ou a interface de um software de cartografia.

As coordenadas são devolvidas nas Variáveis de Sistema. MouseX eMouseY. The coordinates are expressed in pixels with respect to the top left corner of the picture (0,0). Se o mouse estiver fora do sistema de coordenadas da imagem, se devolverá -1 em MouseX e MouseY.

Pode obter o valor dessas variáveis como parte dos eventos formulário On Clicked, On Double Clicked, On Mouse up, On Mouse Enter, ou On Mouse Move.