zSnapshot Plugin zsnapshot.js WebGL + HTML5 only

by indexofrefraction - (send forum message)

Description

Table of Contents

• Description
• Syntax / XML Usage Example
• Plugin Actions
• Plugin Attributes
• Watermark Examples
• Buy / Order the Plugin
• Forum Discussion Thread

Syntax / XML Usage Example

<plugin name="zsnapshot"
	url="zsnapshot.js"
	preload="true"
	keep="true"
	minres="512"
	maxres="2048"
	aspect="4/3"
	aspectrotate="true"
	watermark=""
        />

• Add zsnapshot.js to your project folder
• In your html (index/tour.html) ensure that you embedd krpano with html5:"only+webgl"
  

  embedpano({ html5:"only+webgl", ... });

• In your main xml (tour.xml) add
  

  <plugin name="zsnapshot" url="zsnapshot.js" keep="true" />

• Take and save a screenshot in any action like this ...
  

  <action name="screenshot">
  	take_snapshot(screenshot,null,null,false,jpg,0.85);
  </action>

• or from javascript ...

  <action name="screenshot" type="javascript">
  	krpano.actions.take_snapshot("screenshot",null,null,false,"jpg",0.85);
  </action>

• or as a layer onclick action ...

  <layer name="screenshot" keep="true"
  	url="screenshot_icon.png" width="32" height="32"
  	onclick="take_snapshot(screenshot,null,null,true,png);"
  </layer>

Plugin Actions

take_snapshot(filename, *width, *height, *hotspots, *type, *quality)

Plugin Attributes

Watermark Examples

• use keep="true" visible="false" enabled="false" to keep the hotspot invisible
• attributes for defining the watermark: url, alpha, width, height, align, x and y

<hotpspot name="mylogo"
    keep="true" visible="false" enabled="false"
    type="image" url="mylogo.png" alpha="1"
    width="200" height="prop"
    align="bottomright" x="25" y="25" />

• use keep="true" visible="false" enabled="false" to keep the hotspot invisible
• attributes for defining the watermark: text, css, alpha, bg, align, x and y
• only simple css is supported (see textfield css)
• renderer="webgl" is required (is default)

<hotpspot name="mytext"
    keep="true" visible="false" enabled="false"
    type="text" bg="false" alpha="1"
    html="[b]hello world[/b]" css="font-size:24px;color:#fff;"
    align="bottomright" x="25" y="25" />

Buy / Order the plugin

• krpano 1.19-pr15 or newer, html5 + webgl only! (Flash is not supported)
• krpano 1.20.1 or newer for high-resolution screenshots
• zSnapshot catches the panorama image and hotspots (if renderer is set to webgl)
• zSnapshot can not catch layers
• iOS does not support saving screenshots directly to its image gallery.
  You still can screenshot into a new tab, but as this leaves the tour,
  screenshot functionality is normally disabled for iOS devices.
• zSnapshot is tied to your krpano license (needs a registered version of krpano)

• All copyrights to zSnapshot 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.

Examples

krpano Forum Discussion Thread