TipTile Configuration OverView

v5.4
Configuration - (Global attributes)
Configuration & TileItem - (Attributes that can be defined in the root or in TileItems)
TileItem - (Attributes that can be defined in TileItems)
Button - (Attributes that can be defined for additional/alternative buttons)

Configuration

(Global attributes)

- - - Directories - - -
MiscDir
AlgemeenDir
 string
 Content
 Directory with miscellaneous files, like background image and sound files, icons and buttons.

ContentDir
PlaatjesDir
 string
 Content
 Directory with all the content files.

MediaDir
FilmDir
 string
 Content
 Directory containing media files.
By default the same as the ContentDir.

StillsDir string
 Content
 Directory with the still images for tiles with media.
By default the same as ContentDir.

DocDir string
 Content
 Directory with the images that are part of a doc / slide tile.
By default the same as ContentDir.

TextDir
TekstDir
 string
[Obsolete] Used to be the folder where text images were stored.
Included for backward compatibility.

- - - Generic - - -
description
beschrijving
 string
Optional description of the TipTile.
Currently only used in the online viewer.

xSize int
 0
 Number of columns / horizontal size of the TipTile.

ySize int
 0
 Number of rows / vertical size of the TipTile.

AutoSize bool
 false
 Calculates the optimal size for the TipTile - only works if items are automatically generated (not declared)
AutoGenerate bool
 false
 Forces the application to generate items based on the files in the content folder, by deleting the existing definitions
AutoFixedNum int
 0
 Number of images in an automatically generated set, that will always be selected, starting with the first items in a folder.

AutoFixedPrefix string
Makes sure all the images with the defined prefix will be visible on screen.
This ignores the value of AutoFixedNum, but has a similar function.

AutoFill bool
 false
 Fills a randomly generated TipTile with duplicate tiles, if the number of images is too small
MouseVisible bool
 true
 Toggles the visibility of the mouse cursor.
An alternative way is MouseInvisible which overrides this setting.

MouseInvisible
MuisOnzichtbaar
 bool
 false
 Toggles the visibility of the mouse cursor.
Overrides the setting of MouseVisible.

SkipIntroAnimation bool
 false
 Skips the intro animation with tiles spreading from the center.
May be necessary in case of poor performance.

Toets bool
 false
 [Obsolete] Switches to a special mode developed for an old project.
If true a floating image is shown on top of the tile grid.
This image is loaded from the file 'toets.
png'.

Demo bool
 false
 Starts the application in Demo mode.

CreateSchema bool
 false
 Creates an xml-schema for this application.

CreateDocumentation bool
 false
 If this is true the application creates an html-file with documentation.

Style string
 ..\..\TipTileStyle.xml
 Reference to style.
xml file with additional (shared) config data.

name
naam
 string
A name can be included for reference or documentation, or can be shown on the background.

IconImage string
[Redundant] Icon image that can be shown in a menu.

PreviewImage string
[Redundant] Preview image used in the original Surface v1.
0 menu.

Key string
[Redundant] Identifier key used in the online TipTile editor.

- - - Appearance - - -
BackgroundImage
AchtergrondPlaatje
 string
Image file for the background of the TipTile.

BackgroundStretch string
 UniformToFill
 Stretches the background image to fill the screen.

BackgroundColor string
 #000000
 Color of the background if no BackgroundImage is defined.

BackgroundSound
BackgroundMusic
AchtergrondMuziek
 string
Sound playing in a loop on the background of the TipTile
BackgroundSoundMode string
 Silent
 - Silent
- Continuous
- Dimmed
 Behaviour of the background sound when a video or audio on a tile starts.

BorderType string
 none
 - color
- foto
- canon
- none
 Type of border around the tiles.
The default value is 'color' which uses BorderColor.
Others possible values are predefined colors for specific projects.

BorderColor string
 #000000
 Color of the border if BorderType is set to 'color'.

BorderSize int
 4
 Thickness of the border if BorderType is set to 'color'.

StartRandom bool
 false
 Shuffles the tiles at startup, so the tiles will be shown in random places.

Vertical bool
 false
 Special mode for upright screens, where all tiles open with the right side up.

CloseButtons bool
 true
 Shows close buttons.

CloseButtonSize int
 30
 Size of the closebuttons Note: Can be changed in the edit function in the TipTile viewer.
ShowName bool
 false
 Shows the name at the left and right side of the background
FullScreen bool
 true
 Starts the application fullscreen, instead of as a window.

LargeTiles string
List of tiles that are double in size.
Note: this will hide the tiles to the right, bottom and bottom right of these tiles.
AutoResize bool
 true
 Automatically flips the width and height of a TipTile if a screen is in portrait mode
- - - Spacing - - -
Margin int
 16
 Margin around the tile grid, or:
space between the tiles and the screen edge.
Note: Can be changed in the edit function in the TipTile viewer.
MarginLeft string
Left margin around the tile grid, overrides Margin
MarginRight string
Right margin around the tile grid, overrides Margin
MarginTop string
Left margin around the tile grid, overrides Margin
MarginBottom string
Left margin around the tile grid, overrides Margin
HorSpacing int
 0
 Additional spacing between columns of tiles.
This gives the possibility to separate columns.
The standard spacing value is 8.
Note: Can be changed in the edit function in the TipTile viewer.
VertSpacing int
 0
 Additional spacing between rows of tiles.
This gives the possibility to separate rows.
The standard spacing value is 8.
Note: Can be changed in the edit function in the TipTile viewer.
- - - Behaviour - - -
FullRotation string
 [If undefined, the setting for Vertical is used.]
 Sets the idle animation to rotate the tiles full circle.
Used in combination with Vertical mode.

JumpAnimation bool
 false
 [Redundant - use AnimationType instead] Changes the idle animation into one here tiles jump up a bit.
Useful in combination with Vertical mode.
Cancels AnimationType setting.

AnimationType string
 Rotate
 - Rotate
- Jump
- None
 Type of idle animation.
Options are Rotate (default), Jump or None.

AnimationTime double
 1
 Controls the speed of the idle animation.
For a Rotate animation this is the number of seconds, for a Jump animation it is a multiplier (the time is variable here).

StopIdleOnVideo bool
 true
 Stops the idle animation when a video is playing
BlockScreen bool
 false
 Blocks the screen and stops the idle animation when a tile is opened.

BlockScreenOpacity double
 0,5
 Opacity of the items on the background if the screen is blocked (BlockScreen is true).

MaxOpenItems int
 0
 Number of TileItems that can be opened at the same time.

InstallFonts bool
 true
 Installs fonts from added font files, if available.
If this is false the fonts will be loaded dynamically.

SpeechEnabled bool
 false
 Toggles speech functionality, which turns the info text into speech.
Note: only works properly with English text.
AutoUpdate bool
 false
 Starts the update function to check for new versions of the TipTile
AutoUpdateLocation string
Location of the TipTileUpdater application
TranquilMode bool
 false
 Swtiches to a mode with little distractions (animations, background)
AltTouch bool
 false
 Switches to an alternative method for input on buttons on TileItems.
Switching this on enables mouse input, but might cause problems with touch input.

CloseOnKey string
- Escape
- Space
- Enter
- Any
 If defined closes the application on a keystroke (can be defined or any key).

LoadVideoOnPlay bool
 true
 Flag indicating if the video is loaded when a tile is opened or if the play button is pressed.

QuizReset string
 OpenItem
 Determins when quiz tiles are reset.

DeactTime int
 0
 Determins after how much time (in seconds) of inactivity the applications closes itself.
If the value is 0, the application will keep running.

EditEnabled
RightEditEnabled
 bool
 true
 Toggles the edit functionality.
The edit screen can be opened by rightclicking a logo or touching two logos simultaneously.

SingleTile bool
 false
 Restricts the application to have only one tile open at the same time.

SingleTileClose string
 Automatic
 - Automatic
- Manual
 Defines the way influence between opening and closing tiles in SingleTile mode.
There are two options:
Automatic - opening a tile automatically closes an already open tile, Manual - the open tile must be closed before a new tile can be opened.

AutoOpenTime int
 0
 If larger than 0 this automatically opens a single tile after X seconds.
This value must be at least twice the TileAnimationTime (if it is not, it will be changed).

AutoOpenRandom bool
 true
 Flag indicating if the items that are opened are randomly picked or sequential.
Only works if AutoOpenTime is larger than 0 and StartRandom is false.

OpacityOnClose double
 1
 Defines the opacity of a tile that has been opened and closed again, to keep track of which tile has been opened/viewed.

ResetOpacityOnClose int
 0
 Time (in seconds) after which the opacity resets (through fade) on a tile that has been opened and closed.
If this value is 0 the opacity doesn't reset.

SingleTouch bool
 false
 Starts the application in single touch mode.

StayOnTop bool
 true
 Puts the window on top.

SingleInstance bool
 true
 Allows only one instance of TipTile to be running.

PinCode string
Secures the TipTile so it can only be opened with the right pincode
AppBasePath string
 App
 Folder where applications that can be started from the TipTile can be found.
The path is relative to the location of the configfile.

AppButtonAlignment string
 Right
 - Left
- Center
- Right
 Defines the place for the app button on a tile.
Options are Left, Center or Right (default).
Note: Center may cause conflicts with other buttons.
Credits string
Line of text on the background
CreditsPlacing string
 TopBottom
 - Bottom
- TopBottom
- LeftRight
- All
 Places the credits line appears
CreditsFont string
 Segoe UI
 Font for the credits line
CreditsSize int
 16
 Text size for the credits line
CreditsColor string
 #A0FFFFFF
 Color of the credits line - can also be used to set opacity
- - - Media - - -
Volume int
 70
 Changes the volume of the tile media and background sound.
Range is 0 - 100.
Note: Can be changed in the edit function in the TipTile viewer.
VolumeVisible bool
 false
 Shows volume sliders at the short sides of the screen.

VideoSliderVisible bool
 false
 Shows a slider to scrub through a video.

JukeboxEnabled bool
 false
 Toggles the jukebox setting which continuously plays a random media file from the TipTile
SpeedRatio double
 1
 Changes the speed of media playback.
If this is set to a volume other then 1, a toggle button will make it possible to switch between normal and alternative speed.

SpeedButtonVisible bool
 true
 Only visible if SpeedRation is not 1.
Shows a button to toggle the speed between the alternative and normal speedratio
AutoPlay bool
 false
 Flag indicating if a video or audio clip on a tile automatically starts playing when the tile is opened.

HidePlayButton bool
 false
 Hides the play button when AutoPlay is true.

- - - Scroll list - - -
OpenFromScroll bool
 false
 Replaces the tile grid for a scrolling list at the bottom side of the screen.

WrapScroll bool
 false
 Wraps the scrolling list, so it never ends.

ScrollSize int
 192
 Size of items in the scroll list.

ScrollPosition string
 Bottom
 - Top
- Bottom
- Center
 Place of the scroll list.

AutoScroll bool
 true
 Makes the scroll list scroll automatically.

ScrollSpeed double
 1
 Speed modifier for the scroll list.
Only used if AutoScroll is true.

- - - Text - - -
TextType
TekstType
 string
 render
 [Obsolete] Used to indicate whether text was rendered or loaded from an image.
The second option is only available for backward compatitibility
FontName string
 Segoe UI
 Fontfamily of the info text.

FontWeight string
 Regular
 - Light
- Regular
- DemiBold
- Bold
- ExtraBold
 Fontweight of the info text.

TextFront string
 #ffffff
 Color of the info text.

TextBack string
 #000000
 Background color of the info text area.

DropText
SubText
 bool
 true
 Puts the info text beneath the tile.

ScrollableText bool
 false
 Makes large blocks of text scrollable.

TextAlignment string
 Left
 - Left
- Right
- Center
- Justify
- L
- R
- C
- J
 Sets the alignment of the info text.

TextBorderColor string
 [TextFront]
 Color of the border around a text area - if different from the color of the text
TextBorderWidth int
 2
 Width of the border around a text area
RelTextMargin double
 1
 Changes the width of the text block.
The base margin is 24, which is multiplied by this value.

TextOpacity double
 0,9
 Opacity of the info text (or image).

- - - Numbers - - -
Numbered bool
 false
 Special mode where all tiles are numbered.
The numbers are visible on both open and closed tiles.

NumberSize int
 20
 Size of the numbers which are visible if Numbered is true.

NumberColor string
 #ffffff
 Colour of the numbers which are visible if Numbered is true.

NumberShadow double
 0
 Adds a shadow to the numbers which are visible if Numbered is true.
Value should be between 0 and 1.
A value of 0,25 gives a subtle shadow.
This may affect the performance, especially during the intro animation.

- - - Titles - - -
TitleFont string
 Segoe UI
 Font family of the titles on unopened tiles.

TitleFontSize int
 20
 Size of the titles on unopened tiles.

TitleFontWeight string
 Regular
 - Light
- Regular
- DemiBold
- Bold
- ExtraBold
 Fontweight of the titles on unopened tiles.

TitleColor string
 #ffffff
 Colour of the titles on unopened tiles.

TitleBackground string
 #00000000
 Background color of a title
TitlePadding double
 8
 Room around the text that shows the background (only if a TitleBackground is declared)
TitleShadow double
 0
 Adds a shadow to the titles on unopened tiles.
Value should be between 0 and 1.
A value of 0.
25 gives a subtle shadow.
This may affect the performance, especially during the intro animation.

TitleAlignment string
 Center
 - Top
- Bottom
- Left
- Right
- Center
- TopLeft
- TopRight
- BottomLeft
- BottomRight
 Defines the place of the title on an unopened tile.

TitleWidth int
 100
 Relative width of the text (in percentage).

TitleOpacity double
 1
 Opacity of the title.
(0-1)
TitleMargin double
 4
 Margin between the title and the tile edge.

TitleVertMargin double
 -999
 Optional margin between the title and the top and bottom edges.
This overrides TitleMargin and is used to prevent the title overlapping buttons.

TitleVisibility string
 OnClosed
 - OnClosed
- OnOpened
- Always
 Defines when the text is visible.

TitleContentAlignment string
 Center
 - Left
- Right
- Center
 Text alignment within the text block.

TitlePlaceHolder string
Placeholder text that is is shown when the text is supposedly invisible as defined in the TitleVisibility
TitlePlaceHolderFontSize int
 40
 Font size for the placeholder text, if such a text is defined.

ShowInputTitle bool
 true
 Shows the title of an input item (if there is any) as title, overwriting any defined title text.

TitleScaling bool
 true
 Toggles the scaling of the title when the size of the tile changes.

- - - Flip - - -
DoubleSided bool
 false
 Makes all tiles double sided.
The idle animation will alternate between the two sides.

FrontViewOnly bool
 false
 [Obsolete - use DoubleSidedViewMode] Doubled side items always open to the front side.

BackViewOnly bool
 false
 [Obsolete - use DoubleSidedViewMode] Double sided items always open to the back side.

DoubleSidedViewMode string
 Mixed
 - FrontView
- BackView
- Mixed
 Determins which side of the tile is shown when it opens.
Options are front view only, back view only and mixed.

- - - Web - - -
StayOnPage bool
 false
 Limits access of tiles with a webview to the target page.
Only relevant in the Pro version.

StayOnDomain bool
 true
 Limits access of tiles with a webview to the target domain.
Only relevant in the Pro version.

- - - Doc - - -
FixedDocMargin bool
 false
 Defines whether the spacing between images in a collection should be fixed or not.
With variable margins the images will be spaced evenly to fit one image in the tile area.

FixedDocMultiplier double
 1
 Defines the width of the scroll window in the tile, compared to the first image.
Only works if FixedDocMargin is true.
This makes it possible to show two or more images at the same time (or show a part of the next image).

- - - Logo - - -
LogoOpacity
ShowLogo
 double
 1
 Changes the visibitly (opacity) of the corner logos.
Value ranges from 0 to 100.

LogoMargin int
 0
 Distance between logos and corners.

LogoStyle string
Switches the way (place and size) the logos are shown.
Default is corner logos.
Only other option is 'Top' which shows one large logo at the top of the screen.

LogoOnTop bool
 false
 Puts the logos over the tile, so they are always visible.

- - - Global tile settings - - -
OpenTime int
 60
 Time in seconds a tile stays upon when it is not touched.
Resets after a touch.
Normally this is 60 seconds.
For presentations this could be somewhere between 5 or 10 seconds.
Note: Can be changed in the edit function in the TipTile viewer.
TileAnimationTime double
 0,5
 Time in seconds a tile takes to open or close.

Thumbs bool
 false
 [Obsolete]Flag that indicates if images are loaded from a 'Thumbs' folder with smaller image versions.
Speeds up the loading of large TipTiles with large images.
Since v3.
3 the existence of thumbnail images is automatically detected from the existence of a 'Thumbs' folder.

FullSize bool
 false
 Flag that indicates if extra large versions of the images are loaded from a FullSize folder when a tile is opened.
Necessary with high resolution images in large TipTiles.

OpenToCenter bool
 false
 [Redundant - use OpenOptions] Opens a tile larger than normal, at the center of the screen and oriented the right side up.
Mainly useful in combination with Vertical mode.

RelOpenSize int
 0
 Relative size of an open tile (in percentage).
Note: only works if OpenOption is Center or Presentation.
ButtonStyle string
- [empty]
- _Old
- _White
- _Red
 Icon set used for the tile buttons.
Note: Can be changed in the edit function in the TipTile viewer.
ButtonSize int
 32
 Size of the tile buttons.
Note: Can be changed in the edit function in the TipTile viewer.
ButtonOpacity double
 0,7
 Opacity of the tile buttons.

ButtonMargin double
 8
 Margin between the buttons on the tiles and the edge.
This can be a negative value, placing the buttons (partly) outside the tile.

MaxTileSize double
 ∞
 Sets a maximum size for tiles in a TipTile with only a small number of tiles.

- - - Language buttons - - -
GlowButton bool
 false
 Puts a glow effect around a selected language button, useful for buttons that are not round.
The alternative is a white on black ring
GlowSize double
 8
 Sets the size of the glow effect on a selected language button.

RingMargin double
 1,6
 Difference between the size of the button and the ring around it.

RingThickness double
 1
 Thickness of the ring.

AvailableLanguages string
Pipe delimited list of available languages (codes)
LanguageButtons bool
 true
 Show automatically generated language buttons.

LanguageButtonLayout string
 CornerLeft
 - SideCenter,CornerLeft, CornerRight
 Placing of language buttons.
Note: SideCenter workst best if there are no standard CloseButtons.


Configuration & TileItem

(Attributes that can be defined in the root or in TileItems)

TotalImage
Totaal
 bool
 false
 Shows the complete image on an unopened tile.

title string
Optional title that is shown on an unopened tile.
Can be defined in the root (for a copyright notice) or on a tile.

ShowInfo bool
 false
 Flag that defines whether the text area will be shown right after opening a tile.

HideInfoButton bool
 false
 Hides the info button when ShowInfo is true.

Transparent bool
 false
 Makes the background of a tile transparent.
This can be defined in the root or for each tile.
Note: this will cancel the border setting (a transparent tile has no border).
TileBackgroundColor string
 #000000
 Background colour of a transparent tile.

TileShadowSize double
 0
 Adds a shadow to the tiles and sets the size.
Note: a larger size will dramatically affect performance.
InputTemplate string
Template for the layout and data of an input item.

InputFontSize int
 12
 Size of the text on an input item.

InputCaptionFontSize int
 12
 Size of the text on the captions.
This overrides the InputFontSize.

FontSize int
 12
 Size of the info text.
Note: Can be changed in the edit function in the TipTile viewer.
MaxSize string
Maximum size a tile can be stretched to.
By default this is slightly smaller than the screen size
OpenOptions string
- Center
- Half
- Crossed
- CrossedTop
- CrossedBottom
- Medium
- Large
- ExtraLarge
- TwoThird
- Presentation
- FullScreen
 Changes the way tiles open.
There are several options:
• Center - tiles open extra large (200%) at the center of the screen, at more or less level (vertical) orientation.
• Half - tiles open on their half of the screen.
• Crossed - tiles open on the other half of the screen.
• CrossedTop - sames as Crossed, on the top half of the screen.
• CrossedBottom - sames as Crossed, on the botttom half of the screen.
• Medium - tiles open at medium size (125%), towards the center.
• Large - tiles open large (175%), near the center of the screen at a random angle.
• ExtraLarge - tiles open large (225%), near the center of the screen at a random angle.
• TwoThird - tiles open large (max.
two thirds of the height or width of the screen) , at the center of the screen (or a bit higher if they have text) at more or less level (vertical) orientation.
• Presentation - tiles open extra large (300%) at the center of the screen, at more or less level (vertical) orientation.
• FullScreen - tiles open at a height or width that is the same is the height or width of the screen, at a zero degree angle.

StretchVideoToFill bool
 true
 This stretches the video to fill the entire tile, deforming the video if it has a different aspect ration than the tile image.
This used to be the default behaviour.

RotateItem bool
 true
 Toggles the idle animation with rotating items.

FixedRotation int
 -1
 Defines the angle of the rotation in the idle animation.
Normally this should be a multiple of 90°.

FixedOpenRotation int
 -1
 Defines the angle of the tile when opened.
Especially (or only) useful in combination with fixed rotation.

AlignOpenRotation bool
 false
 Aligns the rotation on an opened tile with the rotation on the tile when closed.
Especially usefull in combination with fixed rotation.

Language string
Selected language


TileItem

(Attributes that can be defined in TileItems)

name
naam
 string
Item name, only used internally as identifier.

type
soort
 string
 image
 - image
- media
- doc
- list
- form
- quiz
- scroll
- web
- input
 Type of tile item.

content string
Content file for the tile.
The file type depends on the tile type.

text
tekst
 string
Text shown in the text area on or below the tile.

still string
Image shown on unopened tile if the content type is not an image.

url string
[Obsolete] Path to the webpage that is shown in a web tile.
The new option is to set the type to web, and define the url in Content, with the image defined as Still.
Note: this only works in the Pro version.
org_content string
[Redundant] Original name of the content file.
Only used for documentation.

IsIcon bool
 false
 [Redundant] Indicates if the tile image is used as icon.
Only relevant in the online TipTile editor.

hor_align string
 Center
 - Left
- Right
- Center
 Horizontal alignment of the image on the tile, defining the cutout that is shown on an unopened tile.

ver_align string
 Center
 - Top
- Bottom
- Center
 Vertical alignment of the image on the tile, defining the cutout that is shown on an unopened tile.

Visible bool
 true
 Gives the option to hide tile.

RelTextMargin double
 1
 Changes the width of the text block.
The base margin is 24, which is multiplied by this value.

FixedPosition
FixPos
 bool
 false
 Fixes the tile to its startup position.
Only relevant in combination with StartRandom.

CanOpen bool
 true
 Indicates if a tile can be opened or if it is just added as decoration.

CanRotate bool
 false
 Lets a tile rotate if it is tapped.
Only works if CanOpen is false.

NoFlip bool
 false
 Makes tiles not flippable (=one sided) in a TipTile where IsFlip is true.

MailConfig string
Data file for mail form.
The file should be in the Content directory.

MailContent string
Content that should be in the mail message that is sent out.
This can be plain text or an attachment.
For the latter case the fomat should be 'Attach:[filename]'
DocType string
 PNG
 - PNG
- XPS
 [Almost redundant] Defines the type of document or collection.
This should be XPS for an XPS-document, otherwise a collection of images will be shown.

ScrollType string
 Hor
 - Hor
- Ver
 Defines in which direction an image, document or collection can be scrolled.
This is used for both Doc and Scroll tiles.
Options are Hor(izontal) and Ver(tical).

FormSource
lijst
 string
[Untested] File with the form field data.
This can be a filename (in the Content folder) or a full path.

FormStorage
data
 string
 form_output.txt
 [Untested] File where form is stored.
This can be a filename (in the Content folder) or a full path.

ButtonColor
knopkleur
 string
Color of the buttons on a form tile.

App string
Application that can be opened from this tile.

tagnr int
 -1
 [Obsolete] Defines which tag opens the tile when a tagged object is put on the screen.



Button

(Attributes that can be defined for additional/alternative buttons)

Width int
 -1
 Width of the button
Height int
 -1
 Height of the button
Size int
 80
 Size of the button, serves as default value for Height and Width
X int
 0
 Horizontal coordinate of the button
Y int
 0
 Vertical coordinate of the button
Orientation int
 0
 Orientation of the button
Image string
Image file for the button
Action string
 Close
 - Close
- App:
- SetLang:
 Action the button should trigger.
Current options are:
• Close
• App:[app location]
• SetLang:[language code]
OnItem bool
 false
 Puts this button on each tile item.

Alignment string
 TL
 Sets the horizontal and vertical alignment when the button is put on the screen or on a tile item.
This also changes the interpretation of X and Y.


(233)