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.

ComponentTouch screenMedia DisplayPositional displayTicket
BackgroundYesYesYesNo
ButtonYesNoNoNo
Extended buttonYesNoNoNo
TextYesYesYesYes
ImageYesYesYesYes
Vertical messageYesYesYesYes
LinkYesNoNoNo
URLYesNoNoNo
Channel PlayerNoYesYesNo
WidgetYesYesYesNo
BarcodeNoNoNoNo
System informationNoNoNoNo

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:

NameDescription
ServiceThe service to connect the button to (optional).
TextThe 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 textThe 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.
ImageImage 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 pageThe page to link the button to.
Text colorButton text color.
Text positionButton text position (top and left).
FontButton text font (default is Arial).
AlignButton text alignment (Left, Right, Center or Justify.)
Background colorColor of the background area of the button.
Keep image aspect ratioIf 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 scalingHow the image should scale (Center, Fill, Fit, or Stretch).
Text 2 / Text 3Here 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:

NameDescription
TextText to display.
Screen reader textThe 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 colorText color
FontText font (default is Arial).
AlignText alignment (Left, Right, Center or Justify).
Background colorBackground 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:

NameDescription
ImageUpload an image by clicking Edit.
Keep image aspect ratioIf 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 scalingHow 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:

NameDescription
Background colorBackground color of the vertical message area
Time to showThe length of time that the vertical message should be shown. If the field is left empty, the vertical message is not removed.

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:

NameDescription
TextText to display for link
Screen reader textThe 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 pagePage to link to
Text colorLink text color
FontText font (default is Arial).
Background colorBackground 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:

NameDescription
URLThe 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:

NameDescription
Keep image aspect ratioIf 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.
MutedIf 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:

NameDescription
Barcode typeOptions: Interleaved 2/5, ITF-14, Code 39, Code 128, EAN 13 code, DataMatrix (square), DataMatrix (rectangular), and QR Code
System informationSystem 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 nameUsed 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 checksumControls 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:

NameDescription
System informationSystem 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 nameUsed 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.
FontText font (default is Arial).
AlignText alignment (Left, Right, Center or Justify).
RotationText rotation (0, 90, 180 or 270 degrees)
Maximum rowsHow 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 textEnter some example system information. When you save and preview your ticket, you can check how the text looks.