zFilter is a postpocessing WebGL shader plugin for dynamic effects on your panorama image, layers and hotspots. It allows you to add visual effects for startup intros, scene changes, information popups, etc. Setting or tweening simple attributes adjusts the brightness, saturation or blurs your panorama, layers or hotpots!
or just use the full block above with all attibutes on their default values.
A simple intro for example, can be done by setting initial attribute values in combination with an onstart action tweening the attributes back to the defaults.
Note: zFilter is optimized to minimize the performance load on your devices. If all attributes are set to their default values, the plugin stays idle and does not affect the performance at all.
order is used to set a default order or specific orders for zfilter attributes
order is never undefined. If omitted, it will be set to the highest order on stack
Next to the global plugin order, order also allows to set the zfilter internal order
The internal order can be changed using attribute names without assignment
global order assignments (numbers) precede the zfilter internal order (names)
Examples:
order="5" sets the order for all zfilter attributes
order="5|blur=7|adjust=3" sets separate orders for blur and adjust
order="5|blur|sobel" sets the internal order to execute blur before sobel while the order is 5 for all zfilter attributes, the internal order is now iorder=""adjust|blur|swirl|pixelate|ripple|split|fblur|sobel|blendcolor|vignettecolor|mixcolor""
order="5|blendcolor=4|blur|sobel" set the internal order to execute blur before sobel under a default order of 5 with a special order for blendcolor
Notes:
adjust filters (brightness, contrast, saturation, etc) are implemented as a combined postprocessing filter and therefore can't get ordered individually
If multiple postprocessing plugins are used, you should give each of them an individual order, otherwise you may experience unwanted filter interference
order is only supported with krpano 1.20 or newer!
iorder is used to get the zfilter internal order
iorder is read only, to change values order must be used!
it considers separate global orders for zfilter attributes
Example:
order="2|blur=3|fblur=1" will result in: iorder=""fblur|adjust|swirl|pixelate|ripple|sobel|split|blendcolor|vignettecolor|mixcolor|blur""
webvr is used suppress zfilter for certain webvr levels
zFilter is highly optimized and performs great on deskops, tablets and mobiles. Sadly this is not the case for true webVR (ie. Oculus Go, Quest, Rift, etc), where most devices have a poor WebGL performance.
Therefore the default is webvr="2" which suppresses zfilter for true webVR
possible values/levels for the webvr attribute are: 0=normal / no VR, 1=fake VR, 2=mobile VR, 3=true WebVR
With low fquality settings fblur shows some visual noise, but even with maxed out fquality it is still faster than the standard blur filter.
It is recomended to set per device values, as done above under Syntax. The chosen values are low on purpose to get the best device support.
blur is a quality blur without any visual artefacts
Note: blur uses an intelligent, performance optimized algorithm, but the higher the blur value, the more WebGL shader passes are needed. On low performance devices you should avoid high blur values or use fblur.
32bit ARGB values consist of 4 bytes, each with a range of hexadecimal 0x00 to 0xff. Normally 32bit ARGB values are used for colors and are mapped to alpha, red, green and blue, but zFilter can also map them to other parameters as in the vignettecolor attibute. The byte to shader parameter mapping is described above for each attribute.
You can set 32bit ARGB values by Numbers or Strings in decimal or hex format
Reading a 32bit ARGB value returns a String in hexadecimal format
Examples:
an ARGB value of 0x801eff64 means: 0x8000ff00 --> A = 0x80/128, R = 0x1e/30, G = 0xFF/255, B = 0x64/100
This is a commercial plugin - to use it, it must be purchased. Before you buy, please check the Compatibility / Requirements / Limitations!
zFilter is split up in modules which can be purchased separately. If additional modules are ordered at a later time, you will receive a combined build containing all (new and older) purchases.
Compatibility / Requirements / Limitations
krpano 1.19-pr15 or newer, html5 + webgl only! (Flash is not supported)
krpano 1.20 or newer to use the postprocessing phase and order attributes
zFilter works on the panorama image and on hotspots with renderer=webgl
Layer and hotspot filters support a limited set of effects and require renderer=css3d
Browser support for layer and hotpot filters my vary and is not guaranteed
support for true webVR is experimental only
zFilter is tied to your krpano license (needs a registered version of krpano)
License
All copyrights to zFilter are exclusively owned by indexofrefraction.
This plugin is offered as a commercial plugin. It is provided "As Is" without warranty of any kind, either express or implied, including any warranty of quality, merchantability, or fitness for a particular purpose. In no event will the author of the plugin be liable for loss of data, costs of procurement of substitute goods or services or any special, consequential or incidental damages, under any cause of action and regardless of whether or not the plugin author have been advised of the possibility of such damage. This limitation will apply notwithstanding any failure of essential purpose of any limited remedy provided herein. In any event the plugin author will have no liability arising out of this agreement.
Buy zFilter modules
Release discount until 2020-02-15 ! 49€ - 20% = 39€ (for all modules)
In the purchase form, please register using the exact name and email you are using for your krpano license You can check your registration information with the "krpano Tools" application.
* VAT: Depending on your country or company status VAT may be added to the price. In the Share‑It order form select your country and enter your VAT/UID number to remove the VAT. The correct price will be shown on the next page in the order form.