URLs for Sharing Views
There are two single URL based controls, Goto and ShowImage that enable the sharing of views by simply providing recipients with the URL. Goto is the simpler of the two, and enables a link to a particular point in space (RA, Dec and Zoom) to be captured, and then sent, for example, by email. ShowImage is similar, but includes more information (including a link to an image) that enables the sharing of that single image, without the need to write a WTML data file or create a community. If a valid data file does exist, a command line parameter can be used to initiate the Windows Client version.
To capture a link from the AAS WorldWide Telescope, right click to bring up the Finder Scope, select Research then Copy Shortcut from the menu. This will encode the current view into a URL.
The base of the URL is as follows:
Following this there are four required parameters, separated by the ampersand (&) symbol:
|Name to appear on the thumbnail, under Collections > Open Collections > Link Collection.|
|Right ascension (RA) of the view center.|
|Declination (Dec) of the view center.|
|Zoom factor (6 x Field of View).|
|The default behavior is that this will open the image in the Windows Client version of WWT, rather than the Web Client version. This assumes that the mime-type for WTML files is set to the Windows Client.|
If the receiver of the email clicks on this link, it should open up the Web client version of WWT, and provide a thumbnail that can be selected for the specified view to be rendered:
Note that the shortcut can be captured from either the Windows Client or Web
Client versions of WorldWide Telescope. Clicking on the link will open up the
Web Client version unless the
wtml=true parameter is set.
The ShowImage control enables an image to be shared, by embedding information about the image in a URL. The URL could then, for example, be emailed to colleagues who could then view the image in WorldWide Telescope simply by clicking on the link. Unlike Goto, there is no automated way of creating the URL from within WorldWide Telescope.
Of course the image, and optionally a thumbnail of it, must be web accessible for this to work. The image should also have a maximum size of 2048×2048 pixels. If larger sized images are required, then WTML data files should be set up to tile the image correctly (refer to the AAS WorldWide Telescope Data Tools Guide).
The base of the URL is as follows:
Add to this base the following parameters, with an ampersand (&) between each parameter.
|User friendly, but relatively unique name.|
|Right ascension (RA) of the image center (or tangent point) from the plate solution.|
|Pixel position corresponding to the RA.|
|Declination (Dec) of the image center (or tangent point) from the plate solution.|
|Pixel position corresponding to the Dec.|
|Arc seconds per pixel from the plate solution.|
|Rotation east of north.|
|URL encoded link to the original image at the scale and size of the image described in the rest of the URL.|
|The default behavior is that this will open the image in the Windows Client version of WorldWide Telescope, rather than the Web Client version. This assumes that the mime-type for WTML files is set to the Windows Client.|
|Link to the thumbnail image. The thumbnail should be 96x45 pixels.|
|Appropriate credit text.|
|Link to the credit information or image page.|
|True inverts the image, False is the default.|
|True indicates that WorldWide Telescope will slew and zoom on the image only. False (the default) indicates that the image thumbnail will appear under Open Collections and the user must select this to slew and zoom to the image. False also indicates that the user can save the image to their own collections.|
|True indicates that the WTML file will be shown, rather than launched. False is the default.|
The example URL shown below will only result in a default thumbnail and the name being added to the Open Collections. For the user receiving the URL to view the image, they will need to click on the thumbnail.
In this second example the optional parameters
creditsUrl= have been added to improve the experience for the user receiving
the URL. When the image appears, note the better looking thumbnail image, and
the credits text and link in the Properties panel.
In this third example, the collection file is opened as a raw WTML file, causing it to be opened by the Windows client rather than the web client if it is installed.
Loading Files with the Windows Command Line🔗
To open WTML data files or WTT tour files with the Windows client, go through the following steps:
- Open up a Command Prompt window.
- Navigate to the folder containing the
WWTExplorer.exefile. By default this is:
C:\Program Files (x86)\Microsoft Research\Microsoft WorldWide Telescope\
- Type a command such as:
wwtexplorer path\tourfile.wttensuring that the full path and filenames are correct.
- This should open up WWT with either the collection thumbnail from a WTML file displayed under Collections > Open Collections, or will start up a tour if a valid tour file is used as the command line parameter.