Layout/Appearance Parameters
pageLayout
string
scroll | flipValues
Defines the animation when moving to another page.
scroll
slides the pages as if they were positioned next to each other (like in FSI Pages mobile).
flip
shows a page turn effect.
noEdgeFlipBelowWidth
integer
Defines if edge flip is turned off below a certain site width.
Example: If set to 400
, the edge flip is turned off when the page is displayed below 400px. Helpful if you have links to articles on a page near to the edges and want to make sure they can be clicked on smartphones, where usually the edge flip action overlaps.
flipCornerSize
float
75Default
Defines the size of the draggable corner of each page that automatically bends (in px). Use 0
to entirely disable the bending corner.
flipEdgeSize
float
50Default
Defines the width of the draggable edge of each page to flip to another page (in px). Use 0
to entirely disable the draggable edge.
dropShadow
boolean
trueDefault
Adds a drop shadow underneath double pages. Only applies if PageLayout
is set to flip
.
dropShadowOpacity
float
infoDefault
Defines the drop shadow opacity. Default is 0.3
from the style sheet class .fsi-pages-root .fsi-page-drop-shadow
. Any value between 0.0
and 1.0
can be set.
dropShadowDistance
float
50Default
Defines the distance of the drop shadow. Default is 50
. Any value between 0.0
and 100.0
can be set.
initialPage
integer
1Default
Specifies the page to display on startup, e.g. 1
for the front cover.
ratio
string
1:1Default
The aspect ratio of pages displayed in FSI Pages.
You can specify any aspect ratio (e.g. 320:240
or 1:2
) or specify auto
to use the aspect ratio of the second image in the image collection.
cropRect
string
0,0,1,1Default
Crop rectangle (left, top, right, bottom
) as 0.0..1.0
. Floating point values to display a given section of an image only.
Default: 0,0,1,1
You cannot use CropRect
AND CropValues
parameters at a time.
If you use both, CropRect
will be ignored.
autoFlipCropRect
boolean
trueDefault
If this parameter is enabled, the right page uses a horizontally flipped crop rect. If it is set to false, both pages use the same crop rect.
cropValues
string
0,0,0,0Default
Defines the amount that should be cut off the image from each side.
Values can be provided as pixel (e.g. 20px
) or percent (e.g. 10%
) or floating point numbers (e.g. 0.25
).
effects
string
The effects
parameter can be used to pass image manipulation parameters to the imaging server.
Typical manipulation parameters include the image saturation (saturation
) and image sharpening (sharpen
).
If no effect is specified, the default settings of the server (profile) apply.
In contrast to all other parameters, defining the parameter effect
adds(!) the string to the existing effects
parameter.
E.g. if your configuration file contains: <effects value="blur(10)" />
and you add to your fsi-viewer
tag effects="sepia()"
,
the resulting effects
parameter value is: blur(10),sepia()
.
If you want to overwrite existing effects values, you can start the effects
parameter with ClearEffects()
.
In the example above, if you add effects="ClearEffects(),sepia()"
to your fsi-viewer
tag, the resulting effects
parameter value is sepia()
only.
ClearEffects()
must be written exactly like this and must be at the start of the effects
parameter value.
mousewheelNavigation
boolean
trueDefault
Defines if navigation with the mousewheel is possible. If activated, you can turn pages while scrolling with the mousewheel.
thumbSize
integer
160Default
The maximum size of thumbnails displayed in the index. The actual width and height depend on the aspect ratio of the pages.
Parameters only valid if PageLayout is set to scroll
.
verticalLayout
boolean
falseDefault
When set to true
, the pages scroll in the vertical direction instead of the usual horizontal.
Note: only valid if PageLayout is set to scroll
!
onePageInView
boolean
falseDefault
Note: only valid if PageLayout is set to scroll
!
doublePageMode
boolean
trueDefault
If set to false
, the pages will not be displayed as coherent double pages.
autoDoublePageMode
boolean
trueDefault
If set to true
, the double page mode automatically activated.
bendEffect
string
glossyDefault
Defines if the pages are shown with a bend effect. none
disables the effect.
frontCover
boolean
trueDefault
Setting FrontCover
parameter to false
disables access to the front cover and forces FSI Pages to display the first image on the first inner left page.
backCover
boolean
trueDefault
Setting BackCover
parameter to false
disables access to the back cover and forces FSI Pages to add a blank content page if required.
frontCoverImage
string
A path to an image to use for the front cover. FSI Pages will use the ImageServer
parameter of FSI Viewer for relative paths.
The cover page(s) will be added to the images in the image list.
backCoverImage
string
A path to an image to use for the back cover. FSI Pages will use the ImageServer
parameter of FSI Viewer for relative paths.
The cover page(s) will be added to the images in the image list.
blankBackCover
boolean
trueDefault
Use a blank page as back cover.
emptyImages
string
Using this parameter you can add blank pages. The value of the parameter must contain one or more image page numbers of the blank pages to be inserted.
E.g. <EmptyImages value="2,10" />
adds two blank pages at page 2 and page 10, moving the other images in your collection correspondingly.
Alternatively you can add <image empty="true" />
nodes to your image collection.
removePages
string
Using this parameter you can remove images from the image collection. The behavior of FSI Pages is exactly as if the images would not be listed in the image collection.
E.g. <EmptyImages value="1,3,4" />
removes the first, third and fourth image in the collection. Please note that removing images takes place before inserting blank pages using the "EmptyImages" parameter.
idleAutoTurn
boolean
falseDefault
Run the FSI Pages in demonstration mode and turn pages automatically when the user does not interact (= moves the mouse) for 2 seconds.
idleAutoTurnMinPage
integer
Loop the auto flip action between IdleAutoTurnMinPage
and IdleAutoTurnMaxPage
. This way you can restrict the auto flip to a range of pages. If the initial page is outside the range specified, FSI Pages flips towards the range before looping between the range specified.
idleAutoTurnMaxPage
integer
Loop the auto flip action between IdleAutoTurnMinPage
and IdleAutoTurnMaxPage
. This way you can restrict the auto flip to a range of pages. If the initial page is outside the range specified, FSI Pages flips towards the range before looping between the range specified.
idleAutoTurnDelay
float
2Default
Show each page for at least n seconds when flipping pages automatically. Please note that a page might be displayed for longer if loading the page takes longer than the time specified.
pageNumbers
boolean
falseDefault
Show or hide page numbers on pages.
firstPageNumber
integer
1Default
Defines with which page number the catalog starts. By default (FirstPageNumber=1
) the front cover is page number one.
You can specify an offset so that the page numbers start with a different value.
This parameter affects page numbers, the index and the display of the current page number in the FSI Pages user interface.
useRomanPageNumbersToPage
integer
0Default
Defines the page number up to which FSI Pages uses Roman page Numbers.
The default value of 0
forces FSI Pages to display Roman numbers for negative numbers and 0.
If you set the value to 5
the display will be like this:
I,II,III,IV,V,6,7,8,9...
Note that you can use the Parameter FirstPageNumber
to offset all page number values.
romanPageNumbersOffset
integer
0Default
Defines the value of the first Roman page number.
The default value of 0
means no offset so that the Roman numbers start with I
.
customPageNumbers
string
Use CustomPageNumbers
to specify custom page numbers as a comma separated string. Items starting with underscore ("_") will not be displayed.
Pages without a custom page number will use the ordinary page numbering.
<CustomPageNumbers value="_cover1,_cover2,3,4,5,_" />
In this case the cover page and the first left page will have no page number.
The first right page will start with page number 3
. The sixth page again has no page number and the seventh and following page will be numbered as usual.
The parameter FirstPageNumber
has no impact on the custom page numbers.
You can therefore use this parameter to modify the value of the first ordinary page number.
customPageNumbersFile
string
Same as CustomPageNumbers
, but the page number values will be loaded from an XML file.
You can either define a path relative to the fsi/config/pages_xml/
directory or an absolute URL. The required format of the XML file is as follows:
<fsi>
<pagenumbers>3,6,7</pagenumbers>
</fsi>
rememberLastViewedPage
boolean
falseDefault
If you enable this parameter FSI Pages stores the page number of the most recently viewed page on the user's computer and displays this page on start up the next time the user views the same catalogue (image collection) again.
rememberLastViewedPageExpireAfter
integer
By default, the last viewed page will be restored on the next visit of a user if you enable the RememberLastViewedPage
parameter. You might want to specify an expiry time after that the last viewed page will be discarded. Please specify the expiry time in seconds, e.g. 3600
for one hour.
By default, the stored pages will be stored infinitely.