krpano XML 레퍼런스

• CUBE
  육면체 파노라마 이미지 - 6개의 이미지, 각 면당 1개의 이미지.
• CUBESTRIP
  한개의 낱장 이미지로 된 'imagestrip' 형 육면체 파노라마 이미지. 지원하는 큐브스트라이프 형식은 6x1, 1x6, 3x2 또는 2x3 형식입니다. 큐브면 정렬은 항상 이렇게 되야 합니다: L,F,R,B,U,D (krpano 기본).
• SPHERE
  구형 / 등장방형 파노라마 이미지.
  부분 마노라마는 hfov, vfov 그리고 voffset 값을 임의로 설정하여 가능합니다.
• CYLINDER
  원기둥형 파노라마 이미지.
  부분 파노라마는 hfov, vfov 그리고 voffset 값을 임의로 설정하여 가능합니다.
• ... 설정하지 않을 경우:
  type을 설정하지 않으면, 뷰어는 <image> 태그 안에 있는 태그들에 의해 자동으로 type을 정의하려고 시도합니다 (non-multires 이미지일 경우에만 동작합니다).

• stereoformat="TB" - 위/아래(Top/Bottom)
• stereoformat="SBS" - 옆으로 나란히(Side-By-Side)

<image stereo="true" stereolabels="1|2">
  <cube url="pano_%s_%t.jpg" />
</image>

<image stereo="true" stereoformat="TB">
  <sphere url="plugin:video" />
</image>

• fov="180.0"
  • 어안렌즈 이미지의 화각 (각도로 설정).
  • 크롭 사이즈와 연관됨.
  • 소스: PTGUI의 화각(fov) 이미지 파라미터에서 직접 가져올 수 있습니다.
• align="yaw|pitch|roll"
  • 이미지의 정렬 / 회전 / 수평  (각도로 설정).
  • 소스: PTGUI의 미니지 파라미터에서 직접 가져올 수 있습니다.
    (예를 들면. 이미지를 정렬 / 수평을 교정하는 데 수직선 컨트롤 포인트 사용)
• crop="left|right|top|bottom"
  • 어안렌즈 사진의 원형 크롭 경계 (필셀로 설정).
  • 원형 경계는 화각 크기와 관계되어있습니다.
  • 소스: PTGUI의 크롭 설정에서 직접 가져올 수 있습니다.
• lenscp="a|b|c|d|e"
  • 렌즈 교정 파라미터.
  • 소스: PTGUI의 렌즈 설정에서 직접 가져올 수 있습니다.

<area mode="align"
      align="lefttop"
      x="0"
      y="0"
      width="100%"
      height="100%"
      />

<area mode="border"
      left="0"
      top="0"
      right="0"
      bottom="0"
      />

• VR 모드는 1.0으로 설정합니다,
• 3D-HSBS-support를 갖춘 3D-TV 스크린은 0.5로 설정합니다.

• auto - 모든 좌표는 안전 영역을 기준으로 합니다 (그 안에서).
• h-only - 자동과 동일하지만, 안전 영역의 수평 부분만 영향 받고, 수직 부분은 전체 디스플레이 높이를 사용합니다.
• off - 안정 영역은 무시되고, 모든 좌표는 전체 디스플레이 영역을 기준으로 합니다. onresize 이벤트 안에서는 안전 영역의 머리글자를 display.safearea_inset를 통해 수동적으로 관리해야 할 필요가 있습니다.
• test:t r b l - 임의적 안정 영역 머리글자 설정 값이 디바이스와 호환되는 지 테스트 / 시뮬레이트하기 위해 정의합니다.

• auto (기본)
  자동 모드 - 큐브-면-이미지 크기가 1024px, 2048px 또는 4096px 처럼 2의 제곱승이고 타일형이 아닌 단일 해상도 파노라마인 경우 - 또는 - 타일 크기가 256px, 512px 또는 1024px과 같은 타일/다중 해상도 파노라마일 경우 자동으로 mipmapping을 사용합니다.
• force
  mipmapping를 강제로 사용 - 이미지를 자동으로 다음에 사용할 수 있는 2의 제곱승으로 크기를 맞추게 해서 mipmapping를 사용하게 합니다. 참고 - 자동 크기 조절은 다소 로딩을 지연시킬 수 있습니다.
• off
  mipmapping을 사용하지 않습니다.

• true (데스크탑에서 기본)
  항상 타일을 즉각적으로 로드하고 추가합니다.
• auto (모바일과 태블릿에서 기본)
  스크린상에 직접적인 사용자-상호작용이 있는 동안에는 재로딩하지 않습니다. 직접적인 사용자-상호작용이 없이 움직이는(작성된 lookto 움직임, 자동회전, 자이로, ...) 동안에는 재로딩을 가볍게 지연하고 계획합니다.
• false
  움직이는 동안에는 절대 재로딩하지 않습니다. 오직 멈춰 있을 때만 재로딩합니다.

• "natural" (기본) - 핫스팟들은 관찰자 시점쪽으로 회전된 상태를 유지합니다.
• "screenspace" - 핫스팟 들은 기기의 스크린 쪽으로 회전된 상태를 유지합니다 (VR 모드가 아닌 상태로 보는 것과 같지만, VR은 평평한(flat) 장면이 없어서 스크린을 기분으로 둔 물체들은 이상하게 보여집니다).

• advantages: 좋은 품질, 높은 품질에서 더 빠르다
• disadvantages: 느리다 (특히 많은 요소를 렌더링 할 경우), 자동 밉 맵핑(mipmapping)이 안된다

• drag - drag the pano image.
• moveto - move the pano image.
• drag3d - free-axis 3d dragging (Flash only).

• true - When enabled (the default) a 'relative' mapping between the drag control input and the pano view movement will be used. This is less accurate but gives a better control feeling at larger field-of-views and when using fisheye distortions.
• false - When disabled an 'absolute' mapping between the drag control input and the pano view movement will be used. That means when dragging point A in the pano image to point B. the view will exactly follow that movement.

• true - When enabled (the default) a 'relative' mapping between the moveto control input and the pano view movement will be used. This is less accurate but gives a better control feeling at larger field-of-views and when using fisheye distortions.
• false - When disabled an 'absolute' mapping between the moveto control input and the pano view movement will be used.

• image
  • The default - uses the url file as image.
• container
  • Use this layer / plugin as container element for other layer / plugin elements.
  • The layer / plugin element need to have width and height settings!
  • The container element can have a background shape, which can be controlled by the bgcolor, bgalpha, bgborder, bgroundedge, bgshadow and bgcapture settings.
• text
  • Use this layer / plugin as textfield.

url.flash="plugin.swf

url.html5="plugin.js

<style name="style1" alpha="0.5" scale="0.5" ... />

<plugin  name="p1" ... style="style1" />
<plugin  name="p2" ... style="style1" />
<hotspot name="h1" ... style="style1" />

crop="x-position|y-position|width|height"

• STAGE - this parent allows to align a layer / plugin OUTSIDE the pano area.
• BGLAYER - this parent allows to align a layer / plugin BEHIND the pano.
  (e.g. for partial panos)

parent="name"

parent="layer[name]"

parent="hotspot[name]"

parent="STAGE"

parent="BGLAYER"

bgborder="widths color alpha"

• widths
  The border line-widths. This can be either just one size value for all sides or a comma separated list of values to define different widths for each side.
  There are four way to set the widths:
  • 1 value ⇒ use the same width for all sides.
  • 2 values: 1,2 ⇒ 1=Top&Bottom, 2=Left&Right width.
  • 3 values: 1,2,3 ⇒ 1=Top, 2=Left&Right, 3=Bottom width.
  • 4 values: 1,2,3,4 ⇒ 1=Top, 2=Right, 3=Bottom, 4=Left width.
• color (optionally)
  The color of the border lines. The default is 0x000000 (black).
• alpha (optionally)
  Transparency / alpha of the border lines (0.0 to 1.0, default=1.0).

bgshadow="xoffset yoffset blur color alpha"

bgshadow="xoffset yoffset blur spread color alpha inset, ..."

• xoffset, yoffset
  The offset / distance of the shadow in pixels.
• blur
  The blur radius / range in pixels - defines how strong the shadow will be blurred.
  0 = no blur ⇒ sharp edges.
• spread (Advanced Syntax, HTML5 only)
  Spreading of the shadow in pixels - expand (positive values) or shrink (negative values) the shadow.
• color
  The color of the shadow.
• alpha
  The alpha / transparency of the shadow.
• inset (Advanced Syntax, HTML5 only, optionally)
  When the text "inset" will be added as last parameter, then the shadow will be an inner shadow instead of an outer shadow.
• ... (Advanced Syntax, HTML5 only, optionally)
  Add another shadow (comma separated).

• image
  • The default - uses the url file as image.
• text
  • Use this hotspot as textfield.

url.flash="animatedhotspot.swf

url.html5="animatedhotspot.gif

<style name="style1" alpha="0.5" scale="0.5" ... />

<plugin  name="p1" ... style="style1" />
<plugin  name="p2" ... style="style1" />
<hotspot name="h1" ... style="style1" />

• When a name attribute will be defined then this events element will be an independent local events element.
• Without name attribute the global events were set.

• Should this named <events> element be kept or removed when loading a new pano or scene.
• See also the notes in the loadpano() action.

• This event will be called when switching to fullscreen mode.

• This event will be called when switching back from the fullscreen mode to the normal window mode.

• This event will be called when the loading of the xml file or the xml code of scene was completed.
• After this event the user-control, the pano-viewing and the dynamic loading of the pano images will start.

• This event will be called when the loading of the preview image was completed.

• This event will be called when the loading of the pano image is done.
• When using multi-resolution images, then this event will be called once when all parts for the current-view were loaded completely.

• This event will be called when there is a new pano image and all information about it (type, imagesize, hfov, vfov) are available.

• This event will be called when the current pano will be removed (e.g. before a new pano will be loaded).

• This event will be called when a new scene will be loaded (similar to the onxmlcomplete event but only for scenes).

• These events will be called on errors:
  • The onxmlerror event will be called on xml-loading or xml-parsing errors,
  • and the onloaderror event on image-loading errors (all kind of images: pano, layer or hotspot images).
• When an event will be not set, then the default error processing will be done - that means a fatal-error on xml-errors and an error message in the krpano log on image-errors.
• By using the onxmlerror event and some custom error handling, it would be still possible to continue using the viewer on an xml-error.
• The error message will be stored in the lasterror variable.
• Note - the onxmlerror event is only available in the HTML5 viewer!

• This event will be called when a key is pressed down.
• They keycode of the pressed key will be stored in the keycode variable.
• When a key will be hold pressed down, then the system automatically sends repeating onkeydown events. This could be optionally disabled with the control.keydownrepeat setting.

• This event will be called when a pressed key is released.
• They keycode of the released key will be stored in the keycode variable.

• This event will be called when there was a mouse click in the pano.

• Special events for single / double click detection.
• Different to the normal onclick event (which will be fired instantly on every click) the onsingleclick event can be delayed a bit (up to ~400ms) because it checks if there might be a second click for detection as double-click.
• There can be either:
  • One single-click event (delayed a bit compared to a normal onclick event).
  • Two single-click events - when the mouse was moved too far between the two clicks.
  • One double-click event - when there were two quick clicks and almost no mouse-movement between them.
• The mouse.clickx and mouse.clicky variables are storing the coordinates of the mouse where the last click had happened.
• Touch usage is also supported (e.g. 'tap' and 'double-tap').

• This event will be called when the mouse button was pressed down in the pano.

• This event will be called when the previously pressed mouse button was released.

• This event will be called when the mouse-wheel was used or when the pano was zoomed by a touch zoom-gesture.
• The delta of the mouse-wheel usage will be stored in the wheeldelta and wheeldelta_raw variables.
• On touch devices there is no real mouse-wheel, but this event will be called too when using the 2-finger zooming gesture. The wheeldelta variables will be set to positive or negative values depending if zooming in or out. The wheeldelta_touchscale variable will provide more detailed information about the gesture zooming in this case.

• This event will be called before the contextmenu will be opened and could be used to modify the contextmenu items (e.g. changing the caption or the onclick action) before displaying to match the current situation or need.