Saltar para o conteúdo principal
Versão: 20 R5 BETA

Imagens

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

Formatos Nativos Compatíveis

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. The specific features of the different formats (shading, transparent areas, etc.) will be retained when they are copied and pasted, and will be displayed without alteration. This native support is valid for all pictures stored in 4D forms: static pictures pasted in Design mode, pictures pasted into inputs objects at runtime, etc.

Os formatos de imagem mais comuns são compatíveis com ambas as plataformas: .jpeg, .gif, .png, .tiff, .bmp, etc. 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. To find out which codecs are available, you must use the PICTURE CODEC LIST command (see also the picture data type description).

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 admite 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

As telas de alta resolução têm uma densidade de pixels maior do que as telas padrão tradicionais. For pictures to render correctly on high resolution displays, the number of pixels in the picture must be multiplied by the scale factor (i.e., two times larger, three times larger, etc.).

When using high resolution pictures, you can specify the scale factor by adding "@nx" in the picture's name (where n designates the scale factor). In the table below, you can see that the scale factor is indicated in the names of the high resolution pictures, _circle@2x.png_ and _circle@3x.png_.

Tipo de exibiçãoFator de EscalaExemplo
Resolução ‘standard’Densidade de pixel 1:1.1x
circle.png
Alta resoluçãoA densidade de pixels aumentou por um factor de 2 ou 3.
2x3x
circle@2x.png
circle@3x.png

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

4D dá automaticamente prioridade às imagens com a resolução mais alta. Por exemplo, ao usar duas telas (uma de alta resolução e outra padrão) e mover um formulário de uma tela para outra, 4D renderiza automaticamente a resolução mais alta possível da imagem. Even if a command or property specifies circle.png, _circle@3x.png_ will be used (if it exists).

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çãoComportamento
Soltar o pegarIf the picture has:
  • 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)If the picture's display format is:
  • 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.

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

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.

At runtime, 4D will automatically load the light or dark image according to the current form color scheme.

Coordenadas do mouse numa imagem

4D lets you retrieve the local coordinates of the mouse in an input object associated with a picture expression, in case of a click or a hovering, even if a scroll or zoom has been applied to the picture. 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.

The coordinates are returned in the MouseX and MouseY System Variables. As coordenadas são expressas em píxeis em relação ao canto superior esquerdo da imagem (0,0). If the mouse is outside of the picture coordinates system, -1 is returned in MouseX and MouseY.

You can get the value of these variables as part of the On Clicked, On Double Clicked, On Mouse up, On Mouse Enter, or On Mouse Move form events.