Panoramic Photography Services in the Austin, TX Area


PangeaVR for iPhone: Creating Portfolios

PangeaVR

ADVANCED PORTFOLIO TAGS


In addition to the basic tags needed in your portfolio's XML file, there are also several optional tags that work with PangeaVR 1.1 and later.

<thumb>

This tag is used if you want the current panorama to have a preview thumbnail image. This image will appear below the panorama picker where the panorama "about" text goes. The user can toggle between thumbnail-view and text-view.

These images should be a maximum of 300x150 in size since that's the largest they will display in PangeaVR. Larger images will be scaled down, but anything over 500x500 will be discarded. The images can by any aspect ratio, and can be whatever you want to have as the thumbnail (family pet photos are fine too!)

An example of how this might be used in a <panorama> block:

<panorama>

<title>The Grand Canyon</title>

<link>http://www.yoursite.com/grandcanyon.jpg</link>

<about>This a view of the Grand Canyon</about>

<thumb>http://www.yoursite.com/grandcanyonthumbnail.jpg</thumb>

</panorama>

<camera>

The <camera> tag works a little differently than the other tags because it can contain multiple values, not just a single text string. It contains the following optional variables:

initYaw

The camera's initial Yaw rotation. The value is in degrees and can be any number you want. The default is 0º which starts the pano looking at the middle of the equirectangular image (so 180º in pano-space).

initPitch

The camera's initial Pitch rotation, also in degrees. Default is 0º. Positive values pitch up to the zenith, negative values pitch down to the nadir.

initFOV

This is the camera's initial Field of View in degrees. If you do not supply this value the default value is 95º.

minPitch

The minimum pitch to allow. Generally between 0º to -90º.

maxPitch

The maximum pitch to allow. Generally between 0º to 90º.

minFOV

The minimum Field-of-View to allow. Smaller numbers allow the user to zoom in closer. The default is 28º.

maxFOV

The maximum Field-of-View to allow. Larger numbers allow the user to zoom our more. The default is 126º.

autopan

Setting this value will cause the camera to auto-pan when the panorama is first displayed. The value indicates the direction and speed of rotation: Negative values pan to the left, and positive values pan to the right. Values should typically be between 1.0 and 2.0 for good looking panning. The default is 0.0 (no panning) if you do not supply this value.

You can supply all or just some of the above variables in the <camera> tag. Here is an example showing how to set the camera with the initYaw, initFOV, and autopan values:

<panorama>

<title>The Grand Canyon</title>

<link>http://www.yoursite.com/grandcanyon.jpg</link>

<about>This a view of the Grand Canyon</about>

<camera autopan="2.0" initYaw="-90" initFOV="100"> </camera>

</panorama>

<gps>

Here you can enter the GPS coordinates of where the panorama was taken. If you supply this tag, then the Map button will become active, and the user can click it to see the location in the Maps application on the iPhone.

The coordinates must be in one of these two formats:

<gps>30.342311,-98.126926</gps>

<gps>30.342311N,98.126926W</gps>

NOTE: Be certain there are no spaces anywhere in the string. If you accidentally put a space in there then Maps will not launch correctly.



To send feedback or get information: brian@pangeasoft.net

©2005-2009 Pangea Software, Inc.