Skip to main content

Surface components

When building a surface, you can drag and drop different components to your surface. Different components are available for different surface types.

The following table shows for which surface types a component is available.

Component

Touch screen

Media Display

Positional display

Ticket

Background

Yes

Yes

Yes

No

Button

Yes

No

No

No

Extended button

Yes

No

No

No

Text

Yes

Yes

Yes

Yes

Image

Yes

Yes

Yes

Yes

Vertical message

Yes

Yes

Yes

Yes

Link

Yes

No

No

No

URL

Yes

No

No

No

Channel Player

No

Yes

Yes

No

Widget

Yes

Yes

Yes

No

Barcode

No

No

No

No

System information

No

No

No

No

Button and extended button component

The button and extended button are virtual buttons that you can add to touch surfaces. They can be linked to a services, in which case a visit is created in the system when the button is pressed. They can also just link to another page.

surface_editor_button_component.png

The extended button is used when you want a button with several lines of text. Since each button has a permanent unique id, such as button_extended_0, it is possible to dynamically set the text content of the button via a widget. This facilitates the use of different languages etc. To update text in buttons from a widget, in this example for extended button with id button_extended_0, update the following:

$(window.parent.document.getElementById('button_extended_0')).find('.text_single_element').text('First row');
$(window.parent.document.getElementById('button_extended_0')).find('.text_element_2').text('Second row');
$(window.parent.document.getElementById('button_extended_0')).find('.text_element_3').text('Third row');

The button and extended button component have the following settings:

Name

Description

Service

The service to connect the button to (optional).

Text

The text that should be displayed on the button. If the button is connected to a service, there is an Override check box. If it is checked, it is possible to enter your own text for the service button. If unchecked, the external service name is used.

Screen reader text

The text that the user will hear when navigating to the button if a screen reader is enabled. This requires certain devices of Qmatic certified hardware and the ADA keypad option.

Image

Image for the button (a default one is available, but it is possible to select another image of your choice). Accepted formats are: jpg, jpeg, png and bmp. We recommend images with a transparent background.

Link to page

The page to link the button to.

Text color

Button text color.

Text position

Button text position (top and left).

Font

Button text font (default is Arial).

Align

Button text alignment (Left, Right, Center or Justify.)

Background color

Color of the background area of the button.

Keep image aspect ratio

If this check box is checked, the width and height of the image, i.e. the relative horizontal and vertical sizes, are kept. For example, if a graphic has an aspect ratio of 2:1, it means that the width is twice as large as the height. When resizing graphics, it is important to maintain the aspect ratio to avoid stretching the graphic out of proportion.

Image scaling

How the image should scale (Center, Fill, Fit, or Stretch).

Text 2 / Text 3

Here you can edit the settings for the text on row 2 and 3 of the extended button. You can change the Text, Text color, Text position (Top, and Left), Font and how the text should be aligned (Left, Right, Center, or Justified).

Text component

The Text component is used to add plain text to the surface.

The text component has the following settings:

Name

Description

Text

Text to display.

Screen reader text

The text that the user will hear when navigating to the text if a screen reader is enabled. This requires certain devices of Qmatic certified hardware and the ADA keypad option.

Text color

Text color

Font

Text font (default is Arial).

Align

Text alignment (Left, Right, Center or Justify).

Background color

Background color of the text area

Image

You can upload images to you surface. Accepted image formats are: jpg, jpeg, png and bmp. We recommend images with a transparent background.

surface_editor_image_component.png

Note

For ticket layouts, it is only possible to add monochrome bitmap (bmp) pictures.

The image component has the following settings:

Name

Description

Image

Upload an image by clicking Edit.

Keep image aspect ratio

If this check box is checked, the width and height of the image, i.e. the relative horizontal and vertical sizes, are kept. For example, if a graphic has an aspect ratio of 2:1, it means that the width is twice as large as the height. When resizing graphics, it is important to maintain the aspect ratio to avoid stretching the graphic out of proportion.

Image scaling

How the image should scale (Center, Fill, Fit, or Stretch).

Vertical Message component

The Vertical Message component inserts an area for vertical messages, which are managed in the Context Marketing application.

Note

For a good graphical result, the size of the vertical message area should correspond well to the size of the picture that is to be used in the Context Marketing application. The size of the vertical message area is adjusted in the bottom left area of the Surface Editor window (as with all other components):

The Vertical Message component has the following settings:

Name

Description

Background color

Background color of the vertical message area

Time to show

The length of time that the vertical message should be shown. If the field is left empty, the vertical message is not removed.

Link

Links are used to link to another page of the surface without using a button.

surface_editor_link_component.png

The link component has the following settings:

Name

Description

Text

Text to display for link

Screen reader text

The text that the user will hear when navigating to the text if a screen reader is enabled. This requires certain devices of Qmatic certified hardware and the ADA keypad option.

Link to page

Page to link to

Text color

Link text color

Font

Text font (default is Arial).

Background color

Background color of the link area

URL

The URL component is used to show a part of a web page on a touch screen. It has the following settings:

Name

Description

URL

The URL of the wanted web page.

Channel Player

The Channel Player component is used for creating an area where your playlists are displayed.

surface_editor_channel_player_component.png

Note

For a good graphical result, the size of the channel player area should correspond well to the size of the video, link or image that is to be used in the Context Marketing application.

The channel player component has the following settings:

Name

Description

Keep image aspect ratio

If this check box is checked, then the width and height of the video, i.e the relative horizontal and vertical sizes, are kept. For example, if a video has an aspect ratio of 2:1, it means that the width is twice as large as the height.

Muted

If checked, any video with sound in the playlist is muted.

Widget

Widgets are small web applications that can be added to surfaces, They can do a wide range of things, such as display previously called tickets, play a sound when a customer is called or allow customers to check in on kiosks.

Which settings are available depend on which widget you have selected.

Barcode

You can add a barcode with some kind of system information to your tickets. In the example below, it is used to add a QR code with a link to Mobile Ticket.

surface_editor_barcode_component.png

The barcode component has the following settings:

Name

Description

Barcode type

Options: Interleaved 2/5, ITF-14, Code 39, Code 128, EAN 13 code, DataMatrix (square), DataMatrix (rectangular), and QR Code

System information

System information to use for the barcode. Options: Custom parameter, Current time, Ticket id, Service name, Mobile Ticket URL, or Current date. If you select Custom parameter, you must enter a valid custom parameter name string in the field below.

Customer parameter name

Used when Custom parameter is selected as system information. Device parameter strings are defined in the unit type template of the applicable printer. Example: The string ticketCount is used for Tickets left.

Calculate barcode checksum

Controls whether or not to use barcode checksum calculation.

System information

You can display system information in text.

surface_editor_system_information_component.png

The system information component has the following settings:

Name

Description

System information

System information to use for the barcode. Options: Custom parameter, Current time, Ticket id, Service name, Mobile Ticket URL, or Current date. If you select Custom parameter,, you must enter a valid custom parameter name string in the field below.

Custom parameter name

Used when Custom parameter is selected as system information. Device parameter strings are defined in the unit type template of the applicable printer. Example: The string ticketCount is used for Tickets left.

Font

Text font (default is Arial).

Align

Text alignment (Left, Right, Center or Justify).

Rotation

Text rotation (0, 90, 180 or 270 degrees)

Maximum rows

How many rows the text maximum may stretch over. This is especially useful, if you have very long service names, Branch names, or other custom system information. if you select maximum 1 rows, the text will shrink to fit within the maximum allowed width. It will however never be smaller than 6pt. If you select maximum 2 or 3 rows, long text is rendered on multiple lines and the overflow is cropped.

Preview text

Enter some example system information. When you save and preview your ticket, you can check how the text looks.