Defining Image Collections - NeptuneLabs FSI Viewer JS User Manual

9 FSI Pages Add-on
The CropRect parameter defines a cropping rectangle applied to the source image.
The four points to define this rectangle are floating point numbers ranging from 0.0
to 1.0, representing the edges of the image. The rectangle is defined by four floats,
the order is Left, Top, Right, Bottom. The default rectangle is "0,0,1,1" which
displays the entire image without any cropping. The rectangle "0,0,0.5,0.5" will crop
the image to the top left quarter while "0.5,0.5,1,1" will crop to the bottom right
quarter.
If set, the CropRect aspect ratio will define the pages aspect ratio in FSI Pages. If
CropValues (see below) are defined, the CropRect will be ignored.
CropValues
In contrast to CropRect above, the CropValues can also be given in pixel or percent.
CropValues are used to define a certain area of the source image to be cut off. E.g.
the CropValue "10px,20px,5%,10%" will remove 10 Pixel from the left and 20 Pixel
from the top of the image while also removing 5% from the right and 10% from the
bottom. If CropValues are defined, any given CropRect will be ignored.
Margin/Padding
Page margins can additionally be defined to adjust the appearance of the images in
FSI Pages. A page margin will hide the part of the image as defined, while padding
will add some white space to the pages. Please refer to the image (XYZXYZXYZ)
AutoCropPages
This will crop each image to fit the pages aspect ratio automatically.
ImageAlign
Mostly used for photo albums with FSI Pages. If the source image does not fill the
entire page, this defines the alignment of the image. Default value is "TC" which
stands for Top Center. Possible values are all combinations of the vertical
alignments (Top, Center, Bottom) and horizontal alignments (Left, Center, Right).
A complete reference of all → Parameters defining Layout and Appearance can be
found at the end of this chapter.

9.6 Defining Image Collections

The images to be displayed in FSI Pages have to be defined in an <images> node
added to your XML configuration file. The format and the options of the collections
are the same as those of the → 11 FSI Showcase Add-on collections.
There are three different ways of defining image lists:
1. Retrieving automatically generated image lists from FSI Server The most
convenient way to create image collections is using the template system of
NeptuneLabs - FSI Viewer 250