Renderer settings

If the data in a column can be shown as something other than text, like a link, an image, or a shape, you can configure this using the renderer settings (or Show as field) in the visualization properties. The renderer settings is available in some visualizations only, for example in tables, but might also be used in some labels or tooltips.

Note: Some of the functionality described here can only be authored or accessed using the installed Spotfire client.

Note: If you apply renderer settings from the visualization properties, the settings are applied to the selected visualizations only. If you apply renderer settings from the Add/Edit Default Renderer dialog in Tools > Options > Application in the installed client, the settings are applied to all new visualizations.

There are a number of different renderers available in the application, but not all might be available at all times. Which options you see depends on the context and the data. Your company might also have defined other renderers, which are not listed here.

Image from URL renderer settings

Your Spotfire Administrator might have specified that only certain URIs should be allowed to link to. If that is the case, then a list of the Allowed URLs will be shown in the settings dialog. An administrator can add more addresses to the Whitelist for Allowed URIs preference found under Application Preferences in Tools > Administration Manager, in the installed client.

If an allowed URI includes a wildcard character (for example, http://*.example.com/), then you can use any path within that specified domain.

To make a directory on a company network location allowed, specify the path to the folder in the preference. The path must start with file://.

For example:

file://Q:\MyCompany\Images

Note: Because local network paths may be unavailable to other users, the recommended procedure is to use a URL rather than a local network path when publishing analyses to the library.

For users running Spotfire without a server, see Updating the whitelist for allowed URIs when running the installed Spotfire client without a server.

Width and Height

If the website allows, you can also specify the width and height of the rendered image (in pixels):

http://MyCompany.com/Images/{$}/image?width={$width}&height={$height}

If $width and $height are included in the link template, the image will be rendered using the width and height specified by your current table row height/column width, or, in the case of labels or tooltips, by the size set using the size slider. If not included, the default size will be rendered and changing the size will simply enlarge or shrink the default image.

Geometry renderer settings

If your data contains geometries, you can sometimes show the geometric shapes in the visualization. See Specifying new geocoding tables for more information about requirements on the data, to be able to show geometries.

In the visualization properties, you can also specify the Fill color, Border color, and the Border weight (thickness of the line) of the geometry.

Link renderer settings

This renderer is used to show the values in a column as clickable links.

Example:

If the link template is entered as follows, http://www.domain.com/{$}.html, the resulting link would redirect you according to the table below:


Cell value	URL
a	http://www.domain.com/a.html
b	http://www.domain.com/b.html
c	http://www.domain.com/c.html
d	http://www.domain.com/d.html
e	http://www.domain.com/e.html

Note: If your company wants to link to something other than http-addresses, an administrator has the possibility to modify the preferences Allow Additional Uri Schemes and Additional Uri Schemes in the installed client using Administration Manager.

Specifying defaults

You can specify default renderer settings for many different content types from Tools > Options > Application in the installed client, using the Add/Edit Default Renderer dialog.

Enter the content type for which you want to add a default renderer in the dialog.

Use the form toplevel/subtype, for example, text/html or image/jpg.

Note: Do not use a space when specifying the content type.

For Geometry columns the content type should be set to application/x-wkb if you want to show the geometry information as images.

If you want to show chemical structures from an SDFile then the content type should be set to chemical/x-mdl-molfile for the molfile column.

Click Settings to define additional settings for the content type, when applicable.

Note: Changes of the default settings will not affect visualizations created before you made the changes. Such visualizations must be updated in the visualization properties. For example, to show the shapes from a Geometry column in an older table, open visualization properties for the selected table, go to the Columns section and change the renderer for the Geometry column to Geometry.

Label rendering

In the label rendering section of the visualization properties, you might see different options depending on what you have selected, which axis you are looking at, and what your company has configured.

Column

If a hierarchy is used on the axis you can specify a different renderer for different columns in the hierarchy.

For example, you might have added both a "Country" and a "Flag" column to an axis and the flags should be shown as images whereas the countries should be shown as text.

Note that defined hierarchies cannot be changed to anything other than text, so they will not show up in this list.
Get content from

The Get content from section is only available if at least one virtual column producer is available.

Your company might have configured some type of virtual column producers that can take the values from the selected column and transform them in one way or another to produce a desired output. For example, you might be able to select Structure Column here, to show molecular structures from an information link in the labels.

For embedded images in the current data table, or when fetching data via a URL, you should leave this setting at (Selected column).

If the selected source has some settings available, you can reach those by clicking on the settings button. For example, this is where you would specify which information link to retrieve structures from, if your company has enabled a virtual column producer for showing chemical structures.
Show as

The Show as section is where you select how the data in the selected column should be interpreted.

For example, use Text for plain text labels. Use Image if there are binary images in your data that you want to use as labels. Use Image from URL if the image is picked from a web resource location. You might need to change the Image from URL renderer settings by clicking on the settings button and modifying the link syntax so that it fits your current data.

Use Geometry if your data is a shapefile or GeoJSON file and you want to show the geometrical shapes in the labels.

If other types of columns, for example, structure columns, are used to label by, then you would select a renderer for showing structure images here.

If the selected Show as method has some settings available that can be modified, you can reach them by clicking on the Settings button.
Max size
The Max size setting is not applicable when images are shown in cross tables, but it can be applicable when more than one image column is used on the axis and for specifying the size of images shown in tooltips.

It allows you to specify a max size to use when multiple image columns are used as labels on an axis.

If only one hierarchy level with images is used then the size of the label images is determined by the space available in the visualization. You might be able to increase or decrease the size of the images by moving the axis, or by increasing the size of the entire visualization.

Images are also automatically shown in the tooltips when used as axis labels. In this case, this slider is used to specify the size of the images in the tooltips.

When more than one image column is used on the axis, the max size can be used to make sure that one of the images does not grow larger than the specified max size.