Skip to main content

Icons

The Icons View (Main Menu / Admin / Icons) shows the set of icons managed by the Txture server and allows you to upload and manage custom Icons.

There are two panels in this report: the top panel displays the default Icons (which are fixed and included within Txture) as well as your custom uploaded icons. The bottom panel allows you to upload a custom Icon.

Uploading a Custom Icon

Uploading a custom Icon involves selecting an image file, as well as assigning a name to the Icon. Txture supports two kinds of images: *.png (raster graphics) and *.svg (vector graphics). For optimal display, all uploaded images should be quadratic.

Custom PNG Icons

For raster graphics, the following restrictions apply:

  • The image must be in Portable Network Graphics (PNG) format.
  • The image should have a size of 128x128. Larger images will be scaled down.
  • The image should have a transparent background.

Custom SVG Icons

For vector graphics, the following restrictions apply:

  • The image must be in Scalable Vector Graphics (SVG) format.
  • The image must not be larger than 16KiB. Larger images will be rejected.
  • Filters are not supported in the SVG, only basic shapes and lines are allowed.

When uploading an SVG icon, the server will perform a check if the icon can be properly rasterized or not (for image export in Reports later on). If this rasterization attempt fails (e.g. because the SVG contains non-standard elements), the image will be rejected.

Some limitaions are:

  • external resources must be inlined as DataURIs,
  • by-id references in xlink:href are not supported,
  • clip-path="url(#id)" attribues might not work correctly.

In some special cases the svg is accepted but is not correctly rendered in PDF files. You can preview the rendered PDF via the PDF button in the upper left corner of each icon.