Skip to content

Codice Cards

A Codice is a square 2D marker with a unique code number. A Codice card is a Codice printed on paper or card. When someone holds a card against the screen, MT Showcase reads the code and does whatever that code is set up to do: open a personal space, launch content, erase annotations, change the volume, and more.

Codice markers also work under physical objects. On touch tables, a marker is often attached to the underside of an object, such as a plastic block or a glass, so the object becomes a tangible controller.

You set up codes on the Codice DB page.

Tip

You do not need printed cards to test your setup. The player can simulate markers with the keyboard and mouse. See Test Codice Cards Without Printed Markers.

The Codice DB page

Click Codice DB in the left navigation. The page has three parts:

  • Types, on the left: the ten code types, each with the number of codes of that type, plus Guest for the guest pool settings. Types that are not yet available are marked Coming Soon.
  • Codes: the codes of the selected type, with a Search codes… box.
  • Details: the settings of the selected code. Edit them and click Save.

Codice DB with Personal selected: type list with counts on the left, demo personal codes in the middle and Code 13001's detail panel on the right, with the person's name and email, Clear content on close and the Personal space settings

Code types

Type What the card does
Widget Trigger Launches content that you design, such as an image, a video, a menu or a web page. This is sometimes called Codice content. See Widget Trigger codes.
Personal Belongs to one person. Opens their personal space, where they can collect items and send them to themselves. See Personal codes.
Eraser Erases pen and finger annotations. See Eraser codes.
Volume Controls volume: turn the card to turn the volume up or down. On a widget, it changes that widget's volume; on the background, the app's master volume.
Admin Override While the card is on a widget, the widget shows a full toolbar and title bar, even if the app normally hides them. Staff can use it to pin, maximize or close content in a locked-down app. The extra controls disappear when the card is lifted.
Jog Wheel Controls video playback on the widget under the card: turn the card to change playback speed, and move it sideways to move through the timeline.
Loupe Shows a magnifying lens at the card. Turn the card to zoom.
Spotlight Darkens the screen except for a bright circle around the card. Turn the card to change the size of the circle.
Pen Palette Coming soon. Will set the annotation pen color by turning and moving the card.
Scenario Load Coming soon. Will switch each player to a chosen app when the card is placed. In 26.11.1 a Scenario Load card made in the editor does not switch apps yet.

Eraser and Admin Override cards work in every app, anywhere on the screen. Every other card type works only inside a Codice detector, so add one to each app where cards should work. See Codice detectors.

Find a card's code number

To set up a code, you need the card's code number. The easiest way to read it is with the Input visualizer widget:

  1. Click Structures and select the app's structure.
  2. On the Overlay layer row, open the … menu, choose Add Widget, and add Input visualizer.
  3. Hold the card against the screen anywhere. The Input visualizer outlines the card and writes labels along its sides. The code number is the one labeled Code:, for example Code: 501. The separate Marker id label is a tracking number for that touch, not the card's code, so do not use it when you set up the card.
  4. When you have noted your codes, delete the Input visualizer: open its … menu in the tree and choose Delete.

In the Overlay layer, the Input visualizer covers the whole screen and needs no setup. In the Main layer, it is an ordinary widget that you must position and pin before use.

Input visualizer in the Overlay layer: a green rectangle outlines a Codice card on the screen, with the text Code: 501 on one side and Marker id: 10 on the other

Codice detectors

A Codice detector marks the area of the screen where Codice cards work. A card does something only when it is placed inside a detector that responds to it. Outside every detector, the card is ignored. An app with no detector recognizes Eraser and Admin Override cards only.

To add one, open the app's structure, open the … menu on the Main layer row, choose Add Widget, and add Codice detector. By default it covers the whole wall and responds to every card type, so one detector is enough for most apps.

The detector is invisible and does not get in the way of touches. A card placed on a widget inside the detector's area still acts on that widget.

Its main attributes:

  • Size and Location: the area in which the detector reacts to cards.
  • Codice types this detector responds to: the card types that work in this detector's area. All types are ticked by default. Untick a type to make its cards do nothing here.
  • Valid Codices: optionally, the codes this detector accepts, for example 5,20,50-75. Leave it empty to accept every code. Personal and unregistered cards that are not on the list launch the detector's Content for invalid Codices, if you set it. Other cards that are not on the list are ignored.
  • Allow unregistered Codice markers?: when on, a card that isn't registered opens a temporary personal space. The visitor can collect items, type an email address and send the items. They can also register the card permanently. An unregistered card has no Personal Folder page, so its space always works by email, whatever Personal space collection mode the theme sets. Off by default.
  • Collect widgets with Codice: what happens when someone places their personal card on a widget: Disabled, Add to personal space, Email with confirmation (the default) or Direct email. In the two email modes, a card with no email address adds the widget to its personal space instead. If the Main layer has several detectors, the first one decides this setting for the whole app.
  • Rotate personal space towards Codice and Codice rotation offset: for touch tables. See Table Mode.

A card must pass both lists: its type must be ticked and, if Valid Codices is not empty, its code must be on the list.

Structures page with Detector A selected in the Main layer: Allow unregistered Codice markers?, Codice rotation offset, Collect widgets with Codice, and Codice types this detector responds to with all 9 types ticked, from Personal to Scenario Load, above Valid Codices and Content for invalid Codices

Give parts of the wall different jobs

You can add several detectors with different areas and settings. For example:

  • A detector over a video with only Volume and Jog Wheel ticked makes a control zone: those cards work on the video, and a Loupe or personal card placed there does nothing.
  • A detector across the bottom of a table with only Personal ticked keeps personal spaces at the edge where people stand.

Where detectors overlap, a card works if any one of them responds to it.

Changed in Showcase 26.11.1

In earlier 26.x versions, Volume, Jog Wheel, Loupe, Spotlight and Widget Trigger cards worked anywhere in every app, with or without a Codice detector. From 26.11.1 they need one. If these cards stop working after an update, add a Codice detector to the app's Main layer.

Create a code

  1. On the Codice DB page, click New Code.
  2. Choose the Type.
  3. Enter the Code Number. The Editor checks the number when you leave the field. If another code already uses it, the Editor tells you, and → Go to that code opens the existing code.
  4. Fill in the settings for the type. They are described in the sections below.
  5. Optionally, set Offsets. They apply to Volume, Admin Override, Jog Wheel, Loupe and Spotlight cards. X and Y (in pixels) move the point the card acts on away from the marker's center, for example when the marker sits off-center under an object. R (in degrees) corrects the card's angle, for example for a marker printed or attached at a slant.
  6. Click Save Code.

New Code dialog with Type Widget Trigger, Code Number 99, Scope App-local, App My First App, offsets and Save Code

Print the card and hand it out. See Create your own Codice cards.

Name a code

A code number alone says little about what a card is for. Give each code a name, such as Bean bag video or Lobby volume:

  1. On the Codice DB page, select the code's type, then the code.
  2. In the details, enter the Name.
  3. Click Save.

The name appears under the code number in the list, and the Search codes… box finds codes by name as well as by number. A personal code without a name of its own shows its person's name.

Names are kept when you export and import the Codice DB. When an imported 1.14 personal marker becomes a Widget Trigger, the person's name becomes the code's name. The player does not use names; a card is still recognized by its number. Names need MT Showcase 26.10.0 or later.

Codice DB with Code 2610 selected: the list shows Bean bag video under the code number, and the details show the Name field filled in above Code Number and Scope

Widget Trigger codes

A Widget Trigger code launches content that you design when someone places the card. Anyone with a card of that code number can use it.

Setting What it does
Scope Global: the code works in every app that has a Codice detector. App-local: the code works only in the app you choose in App. App-local codes let the same card do different things in different apps.
Trigger content Click Edit trigger content to design what the card launches. It becomes available after you save the code.
Trigger mode Fire and Forget: the content opens when the card is placed and stays open. Hold — closes when the marker lifts: the content is open only while the card is on the screen.
Launch when the marker is lifted Reverses the behavior: the content opens when the card is lifted instead of when it is placed, and closes when the card is placed on the screen again. Before MT Showcase 26.11.1 the content stayed open, and every further lift opened another copy.
Move contents with the marker The content follows the card as it moves and turns. A menu launched this way can be steered by turning the card.

Design the trigger content

Edit trigger content opens the code's Codice content in the structure editor. It has two slots:

  • Widgets launched around codice marker: each widget's Location is measured from the card. Use this slot for content that opens next to the card.
  • Widgets launched at absolute screen locations: each widget's Location is measured from the top-left corner of the screen. Use this slot for content that always opens in the same place.

Add widgets to the slots the same way as anywhere else: open the slot's … menu and choose Add Widget. You can launch almost anything that goes in the Main or Menu layer: viewers, a finger menu, a web page, an app switcher, and so on. You usually launch one widget, but you can launch several.

The Codice content itself also has Content opening animation duration, which sets how quickly the launched content fades in.

The detail panel summarizes what the code launches, for example 1 around the marker · 0 at fixed positions.

Personal codes

A Personal code belongs to one person. When they place their card, their personal space opens. They can drag items from the app into it and then send the items to themselves by email, or open them on their phone through a QR code. A personal code works in every app on the server that has a Codice detector.

To create one, set Type to Personal in New Code and fill in First Name, Last Name and Email. For the full procedure, the person's Personal Folder page and its Access QR, see Create a Personal Folder with an Access QR.

Personal codes also have these settings. From Showcase 26.11.1 there is no PIN enabled setting and no Reset PIN button: a person does not enter a PIN to open their personal space.

Before Showcase 26.11.1

The form had a PIN enabled setting and a Reset PIN button, but the setting had no effect on the wall. A value already stored on a code is kept; saving the code does not change or clear it.

Setting What it does
Clear content on close When the personal space is closed on the wall, the items it opened close too.
Personal space: Collection mode, Title, Info text Override the theme's personal space settings for this person only. Leave them on Use the theme setting or empty to follow the theme.
Group Codes in the same group share a group content set, named Group 1, Group 2 and so on. Its items appear in every member's personal space and Personal Folder page, after the person's own items. Choose an existing group, or New group… to start a new one; None removes the code from its group. After saving, Open group Content Set opens the group's content set.
Open linked Content Set Opens the content set that holds the items in this person's personal space.
External IDs Links this code to identifiers from connected systems, such as a badge ID from a visitor registration system. Shown only when integrations are enabled. See Audience Integrations.

Personal cards need a Codice detector in the app, like every card type except Eraser and Admin Override. The detector also decides what happens to cards that are not registered and to widgets that someone places a card on.

Personal space settings

The look and behavior of the personal space come from the Personal space component of the app's theme. Click Defaults, open the theme, and go to Components > Personal space:

  • Personal space collection mode:
    • Email contents to user: the personal space has an envelope button that emails the collected items to the person's address.
    • Show Personal Folder access QR: the personal space shows a QR code that opens the person's Personal Folder page on their phone.
    • Show QR and email envelope: both.
  • Personal space title: for example Welcome to your personal space.
  • Personal space info text: guidance for the visitor. An empty space shows the text inside it. Once the space holds items, the text is hidden and visitors tap the ? button on the space to see it as a tooltip. <br> adds a line break. Visitors open their Personal Folder with the QR code, so do not try to print an address in the text. From Showcase 26.11.1 <link> prints nothing, in the theme's text and in a personal code's own Info text. Before that it printed the Personal Folder address, which contains the person's access token, or in email mode their email address. If an existing info text uses <link>, remove it and the words that lead up to it, for example "go to".
  • Toolbar: optional. A toolbar with Pin button and Close button is often convenient.

If a person puts their personal card down again while their personal space is still open, the open space moves to the card and comes to the front. From Showcase 26.11.1 Showcase does not open a second space for the same card. A different card still opens its own space.

If the server's public address is localhost, because no Public Showcase URL is set under Network & Public Access, a phone cannot open a Personal Folder link. From Showcase 26.11.1 the personal space then shows "Personal Folder links are not set up on this wall yet" in place of the QR code. Collecting items and sending them by email work as before. To get the QR code back, set the Public Showcase URL; see Public addresses.

A personal space on the wall with a title bar, one collected green image tile, a question-mark button, a trash button and the message Personal Folder links are not set up on this wall yet where the QR code would be

If a person collects a file or web address that is already in their space, the space keeps its one tile instead of adding a second. An annotated copy is a new item and gets its own tile. Items stored twice before MT Showcase 26.11.1 are left as they are.

In every mode, the personal space also has a trash button. Visitors drag an item onto it to remove the item from their space, and confirm the removal.

A personal space while an item is dragged onto the trash button: the space dims behind a magenta trash icon and the question Remove this from your folder?, with the choices Remove and Keep below it

For large videos and PDFs, you can give the media library item a Codice URL. Emails then contain the link instead of the file. See Media library.

Personal space opened by a Personal code in Show QR and email envelope mode: the title Welcome to your personal space, three collected product images, a QR code (blurred here), an envelope button, a delete (trash) button, and the info text shown in a tooltip from the ? button

Eraser codes

Eraser cards rub out pen and finger annotations. Any card with an eraser code works for anyone.

Codes 611, 612 and 613 are built-in global erasers on every server, so you can print any of them as an eraser card straight away. To make more eraser codes, create a code with Type Eraser. Eraser settings:

  • Mode: Rectangle (set Width (px) and Height (px)) or Circle (set Radius (px)). This is the size of the area the card erases.

Eraser cards always work, anywhere on the screen. They do not need a Codice detector in the app.

To erase the annotations on a widget, put the card down on that widget. Sliding the card in from the background onto the widget does not erase.

Other card types

Type Settings
Volume Degrees per % volume: how far the card must be turned to change the volume by one percent.
Admin Override None. An Admin Override card works anywhere on the screen and needs no Codice detector, so staff can use it in any app.
Jog Wheel Min Playback Speed (%), Max Playback Speed (%), Max Speed Angle (°) (how far to turn for maximum speed), Scrub Sensitivity, Reverse rotation and Invert scrubbing.
Loupe Lens Diameter (px) and Zoom Sensitivity.
Spotlight Dim Level (%) (how dark the rest of the screen gets), Default Diameter (px), Min Diameter (px) and Max Diameter (px).

Guest pool

Click Guest in the type list to set up the guest pool: a range of codes set aside as guest cards, such as a stack of unassigned cards at an event's front desk.

  1. Enter the Pool Expression: a range or list of codes, such as 900-999 or 1,2,5,10-100. The Editor shows how many codes the expression contains.
  2. Optionally, turn on Unknown codes trigger guest registration.
  3. Click Save Pool Config.

Note

In the current release the guest pool settings are saved but not yet used on the wall: a code in the pool behaves like any other code that is not registered in the Codice DB.

What an unregistered card does on the wall depends on the app's Codice detector. When Allow unregistered Codice markers? is on, any card that is not registered in the Codice DB opens a temporary personal space where the visitor can send items to an email address and register the card. Before MT Showcase 26.11.1, this worked only when the theme's Personal space collection mode included email; with the QR mode the space showed "Unable to fetch collection URL!". See Codice detectors.

The temporary personal space that an unregistered card opens: a title bar, an open envelope icon and the info text below it, with no collected items

Create your own Codice cards

You can download ready-made sets of Codice markers as PDFs, or generate your own markers as PNG files with the MultiTaction MarkerFactory application. Print them on paper or card and hand them out. For printing guidelines and downloads, see Codice Markers.