Image

This article describes how to configure the Image component and details each of its properties.

The Image component allows you to display graphics within your Squirrel projects. Media types supported include .jpg, .png, .bmp, .gif, etc.

Image Properties

The Image component properties consist of LAYOUT & POSITONING, GENERAL, STYLING, and DYNAMIC VISIBILITY sections.

This guide will describe all sections besides the Layout & Positioning and Dynamic Visiblity sections, as these are generic to each component. A separate guide and tutorial for each can be found by clicking the links above.

The component properties are set and edited using different methods, some have multiple methods, some just one. See this Set Property Values article for more information on using the different methods.


GENERAL

  • Source image from

    • My Library – select an image from the Image Library, uploaded from your computer

    • URL – get the image from a web link

    • Unsplash – search for an image in the Unsplash library

My Library

Upload image — The Import button is only available when the My Library option is selected in the 'Source image from' property. Click to open the File Explorer window and locate the image source file.

Once selected, the Image will be uploaded and can be accessed through the Image Library.

URL

Image URL — Available only when the URL option is selected in the 'Source image from' property. Type or paste the URL into the property field, or bind to a cell in the spreadsheet containing the required image's URL.

Note that for both URL and Unsplash sources, the project must have access to the internet when it is running, for the image to be displayed

Unsplash

Search — The search box is available when the Unsplash option is chosen. Type in a search term and hit return to see a selection of related images. Click on one of the images to insert it into your project.

  • Opacity – This determines the transparency of the Image component and can be set in 4 different ways:

    • Using the opacity slider

    • Typing in a value

    • Using the spinner buttons (values are adjusted by 10% per click)

    • Binding to value in a spreadsheet cell

  • Resize image to component – Checking this option will constrain the image size to the proportions of the Image component.

  • Maintain aspect ratio – This option maintains the image’s natural width-to-height ratio (its aspect ratio) as the component is resized, ensuring the image is not distorted by the resize. (This option is only available when “Resize image to component” is selected)

  • Block mouse events – Checking this option will stop mouse interactions with components covered by the Image component, e.g. a slider component sitting on a layer beneath the image component would not function. A partially covered component may still have some functionality. The option is checked by default.

STYLING

Corners - adjust the slider to adjust the roundness of the image component's corners.

Last updated

Was this helpful?