WW 1.3.2-Plugin: Skripter

[canosso]

Hello,
I made a Plugin where you can make, edit, import and save a Script for World Wind. The script works only for World Wind 1.3.2 and higher, it's called Skripter. Please download the skripter.zip from below and unzip it into your World Wind directory.

The forms looks a little bit overloaded but I didn't like to make a light versions because everyone could use all options. The script points will be stored in a DataGrid which is similar to an Excel spreadsheet,

To start it, choose Plugins and load there Skripter. Afterwards choose in the Tool menu, the item Skripter. Now will see a form with three tabs: Edit, Input from File and Save with a Insert Coordinates Menu. You are now in the Edit Tab., you can easily add points to a script



For using the Heading and the Tilt, look at Greysi's Thread about the Bug with horizontal/vertical angle in Scripts, post #5 , there are files for WW 1.3.3.1 downloadable.
I overlooked the change of WorldCamera.cs in his Issue.


There are a two part solution for By-passing the annoying Tilt problem:

1. Rename Timeline.dll in your World Wind directory to Timeline.dll.old. Copy Timeline.dll.txt from below and rename it Timeline.dll.

or the other possibility:

1. Make a copy of WorldWindAutomation_v1.xsd in your World Wind directory and then replace it with WorldWindAutomation_v1.xsd.angle.txt from below and remove the .txt suffix. In this file the Horizontal and Vertical is replaced with HorizontalAngle and VerticalAngle.

the source code is:
<xs:complexType>
 ÂÂ* ÂÂ* ÂÂ*<xs:all>
 ÂÂ* ÂÂ* ÂÂ*	<xs:element name="Horizontal">
 ÂÂ* ÂÂ* ÂÂ* ÂÂ*.
 ÂÂ* ÂÂ* ÂÂ*	</xs:element>
 ÂÂ* ÂÂ* ÂÂ*	<xs:element name=[b]""Vertical"[/b]>
 ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* ÂÂ* .
 ÂÂ* ÂÂ* ÂÂ*	</xs:element>
 ÂÂ* ÂÂ* ÂÂ*</xs:all>
 ÂÂ* ÂÂ*	</xs:complexType>

Change to:

<xs:complexType>
 ÂÂ* ÂÂ* ÂÂ*<xs:all>
 ÂÂ* ÂÂ* ÂÂ*	<xs:element name="HorizontalAngle">
 ÂÂ* ÂÂ* ÂÂ* ÂÂ*.
 ÂÂ* ÂÂ* ÂÂ*	</xs:element>
 ÂÂ* ÂÂ* ÂÂ*	<xs:element name="VerticalAngle">
 ÂÂ* ÂÂ* ÂÂ* ÂÂ*.
 ÂÂ* ÂÂ* ÂÂ*	</xs:element>
 ÂÂ* ÂÂ* ÂÂ*</xs:all>
 ÂÂ* ÂÂ*	</xs:complexType>

2. Either replace in your scripts Horizontal and Vertical with HorizontalAngle and VerticalAngle or check the By-pass the Heading/Tilt problem by inserting HorizontAngle/VerticalAngle after Change of WorldWindAutomation_v1.xsd if you save a file, you can revert this change if you load a script and choose at this option Yes


Now only the tilt is working, sorry heading at the moment only with small coordinates changes. You can make at the moment only Santa Claus' journey home , sorry for the inconvenience.

Use VerticalExaggeration in Scripts:
In general the WorldWindAutomation_v1.xsd should be changed because there is a wrong spelling of VerticalExaggeration, with only one G, instead of two, also the minInclusive value= should be changed to 0, so scripts could be used for detailed imagery, without having a strange view.

change:
<xs:complexType>
 ÂÂ*	<xs:all>
 ÂÂ* ÂÂ*.
 ÂÂ* ÂÂ*<xs:element ref="VerticalExageration" minOccurs="0"/>
 ÂÂ* ÂÂ*
 ÂÂ*	</xs:all>
 ÂÂ*	.
 ÂÂ*</xs:complexType>

and:

<xs:element name="VerticalExageration">
 ÂÂ*<xs:complexType>
 ÂÂ*	<xs:all>
 ÂÂ* ÂÂ*<xs:element name="ScaleFactor">
 ÂÂ* ÂÂ*	<xs:simpleType>
 ÂÂ* ÂÂ* ÂÂ*<xs:restriction base="xs:float">
 ÂÂ* ÂÂ* ÂÂ*	<xs:minInclusive value="1"/>
 ÂÂ* ÂÂ* ÂÂ*</xs:restriction>
 ÂÂ* ÂÂ*	</xs:simpleType>
 ÂÂ* ÂÂ*</xs:element>
 ÂÂ*	</xs:all>
 ÂÂ*</xs:complexType>
	</xs:element>


To:
<xs:complexType>
 ÂÂ*	<xs:all>
 ÂÂ* ÂÂ*.
 ÂÂ* ÂÂ*<xs:element ref="VerticalExaggeration" minOccurs="0"/>
 ÂÂ* ÂÂ*.
 ÂÂ*	</xs:all>
 ÂÂ*</xs:complexType>

and:
<xs:element name="VerticalExaggeration">
 ÂÂ*<xs:complexType>
 ÂÂ*	<xs:all>
 ÂÂ* ÂÂ*<xs:element name="ScaleFactor">
 ÂÂ* ÂÂ*	<xs:simpleType>
 ÂÂ* ÂÂ* ÂÂ*<xs:restriction base="xs:float">
 ÂÂ* ÂÂ* ÂÂ*	<xs:minInclusive value="0"/>
 ÂÂ* ÂÂ* ÂÂ*</xs:restriction>
 ÂÂ* ÂÂ*	</xs:simpleType>
 ÂÂ* ÂÂ*</xs:element>
 ÂÂ*	</xs:all>
 ÂÂ*</xs:complexType>
	</xs:element>

Please find below WorldWindAutomation_v1.xsd.txt and WorldWindAutomation_v1.xsd.angle.txt, both have a correct spelling and could use the value 0.0,[/b] in the last one Horizontal and Vertical is replaced with HorizontalAngle and VerticalAngle.


Make a script simple:
You will see in the form the current coordinates with current altitude, heading and tilt. Change if wanted the delay time. You can add this data as a first script point with "Add to Script". You can move to next point where the script should go, press the button "Insert the current coordinates" and add this to script.

If you have filled in all points you want to have in the script, choose the "Save" Tab, fill in a script name, change if wanted the number of repeats.
Choose at Use the adapted timeline.dll or by-pass the Heading/Tilt problem with Script change By-pass the Heading/Tilt problem by inserting HorizontAngle/VerticalAngle after Change of WorldWindAutomation_v1.xsd if you chosen to by-pass the tilt problem with changing Scripts and after you changed WorldWindAutomation_v1.xsd.

Choose at LatLong Grid Toggle On if you want to toggle the Latitude & Longitude Lines and Off if you don't want to show them. After Input this option will be set back to No Change for optimizing the Script, normally nobody change this option for each point.

Choose the VerticalExaggeration if you want to change the VerticalExaggeration by Script, this is useful for the tilted view, so your script shows the same VerticalExaggeration like you taken the points. For more detailed imagery, like USGS Digital Ortho, the VerticalExaggeration should be changed to 0.0, otherwise you will have a strange view. This option is only useful if you changed WorldWindAutomation_v1.xsd, like written above.


Then click the "Save the script" button and save it. Ready, you can now call the script under Plug-Ins| Scripts, try it, it should work.

If you know already the coordinates, you can fill them at Latitude and Longitude and add them, you don't need to move World Wind to them. You can also input an URI, the parameters will be separated automaticly.

Options for inserting the current coordinates:
[/b]If no is checked at "Insert current Altitude" or "Insert current Heading/Tilt", then there will be no current Altitude respectively no current Heading/Tilt filled in the form if "Insert the current coordinates" is pressed, you can use this for fixed Altitude or Heading/Tilt.

If no is checked at "Use the Heading and Tilt for the script", the Heading/Tilt will not be added to the script, also if
they are 0.00000.

Insert an URI, GPX Data or DMS Coordinates:
At the Insert Coordinates Menu you'll find 3 items.
1. Insert URI, here you can past an URI in the form, World Wind will go to the coordinates, for this function is the shortcut Crtl+U available.

2. Insert a GPX Track Point, here you can past a GPX Trackpoint in the form, World Wind will go to the coordinates, for this function is the shortcut Crtl+G available.

3. Insert DMS Coordinates, here you can past DMS coordinates in the form, the coordinates should be formatted XX°XX'XX" XX°XX'XX", e.g. 37°49'35" 122°25'18" " with the orientation char before or after the coordinates, World Wind will go to the coordinates, for this function is the shortcut Crtl+D available.


Show messages
If you want to use the script for the education or the inform somebody else, there would be messages useful. You can fill them in, choose the "Horizontal Position" and the "Vertical Position" and it will be added to this point. They could be also added without coordinates. If you want to stop showing the message, choose Yes at "Stop showing the message". If a new message is added, the old one will not be shown anymore.

These are all input options.

Editing, Removing and Inserting new Script points
For removing the current entry "Remove Current Entry", "Remove All Entries" deletes all entries except the first, this one will be replaced with your input.

For Editing an entry press "Edit Current Entry", the form will filled with data of this entry also World Wind will move to this place if the entry has coordinates. You can now edit this data in the form, add messages, remove the heading/tilt, change the delay and so on. If you press "Add to Script", the entry will be replaced with the data of the form, normally.

You see on the right side the Textbox "Insert Position", normally there is no number in the box, only after you press "Edit Current Entry", you see a number, that is the entry number.

You can insert not replace the entry if you choose no at "Replace Entry at Insert Position", if you also choose yes at "Insert multiple lines" you will insert all input until you choose no at this option. You can also simple input a number at "Insert Position" and choose no for the first option and yes for the second and you insert all points at the entry number, you filled in.


Moving the Script points
[/b]For moving the current entry there are 4 options, the Arrow buttons. First choose the row you want to move and then press the button.

The ^-Button is for moving the entry up. The v-Button is for moving the entry below. The ArrowUp-Button is for moving the entry on top of the list. The ArrowDown-Button is for moving the entry on the bottom of the list.


Import Files
You can either import a GPX track file or a Script file, the last one for editing, append and so on.

Fill in the delay time, Altitude and if wanted heading and Tilt Also you can choose, if you want to append the file to the script or not. If no is checked, it has the same function like "Remove All Entries".

If you import a GPX track file, press "Open a GPX file", open the file and the points will be added to the Script Points.

For a script file you can choose "Use the Delay Time of the Script" and "Use the Heading/Tilt of the Script", if no is checked the delay time respectively the heading/tilt of this tab will be used.

Import a Text/CSV File to a Layer

For a Text/CSV File you have to change the column headers of this file. Mandatory is Latitude & Longitude or URI. You can also have a DelayTime, Altitude, HT (=Using the Heading/Tilt), Horizontal, Vertical, M (=Using the Message), Message, HorizontalMessage, VerticalMessage, DisplayMessage, VerticalExaggeration, LatLonGrid column.

Please first choose how the values are separated or better in which format you saved it. The best format to use, is separated by Tabs, you will not have the problems to look in the file how it is separated. Because in countries with comma as decimal separator, the CSV file will be separated by a semicolon. Then choose the Kind of coordinates, Decimal Point or Comma for standard coordinates or DMS for DMS coordinates, e.g. N 47°40'43" E 15°43'52".


Saving the File
Please fill in the script name, the repeats and if wanted a short description.

Choose at [b]Use the adapted timeline.dll or by-pass the Heading/Tilt problem with Script changeBy-pass the Heading/Tilt problem by inserting HorizontAngle/VerticalAngle after Change of WorldWindAutomation_v1.xsd if you chosen to by-pass the tilt problem with changing Scripts and after you changed WorldWindAutomation_v1.xsd.

Check the For only using the Script with WW 1.3.1: Change the Coordinates from 00.00000 to" 00000E-5 for International users with comma as decimal seperator if you are from a country with comma as decimal separator and want to use the scripts for WW 1.3.1,too.

You can also choose if you want to view in the direction of the next point automatically, your input data of view, view to North with tilt or no heading and tilt.
For the delay time you can choose if you want to use the delay time filled in, constant velocity or constant velocity with altitude change .

Then press Save the Script, choose a name for the file and press Save, you can now use the file.


Known Problems

With tilt data in your script, your view will be outside of the point with large distance to the point, this a problem of World Wind.

World Wind does not use at the moment the heading, if there is a large coordinates change, tilt only after the change of Timeline.dll in your World Wind directory of WorldWindAutomation_v1.xsd and different names for Horizontal and Vertical.

Without change of WorldWindAutomation_v1.xsd the VerticalExaggeration couldn't be used and the will be an error message.

Handbook with pictures, pdf, 148 kb

For large projects, please use skripterlarge.zip, there is no difference in functionality, only the form is larger and the Script Points are in a seperate Tab.

I hope that I helped you.


canosso

[adamhill]

Dude, you ROCK!

adam...

[bull]

Very cool, just tested it and it works well

[Beansprout]

Wicked

Sugggestion for improvement: Let it accept worldwind:// links, so people can add a point by justpasting in the worldwind:// link they've copied to the clipboard in World Wind, or copied to the clipboard via one of the worldwind:/ links on www.worldwindcentral.com. I think that'd make it even easier to make scripts, if it's possible

Dear Canosso

This looks great: I have been using your earlier version and the new facilities are just what I was looking for. But I can't seem to fire up Skripter: here's what I have done so far:

1. I downloaded skripter.zip and extracted it into my World Wind directory (ie C:\Program Files\NASA\World Wind 1.3)

2. Because of the path info it correctly stored skripter.cs into C:\Program Files\NASA\World Wind 1.3\Plugins

3. Here's the confusing bit: when you say "To start it, choose Plugins and load there Skripter" - Where do I choose "Plugins"? Are you just confirming here that skripter.cs should be sitting in the Plugins folder, or is there something else involved?

4. Then you say "Afterwards choose in the Tool menu, the item Skripter" but in my case it doesn't show up there.

5. Also you say "The script works only for World Wind 1.3.2 and higher" but the highest numbered release on the World Wind website today is 1.3.1.1 so I'm confused here.

I'd be most grateful for your help on this.

Best wishes

Alcinoos


[quote=canosso,Jul 2 2005, 01:45 PM]
Hello,
I made a Plugin where you can make, edit, import and save a Script for World Wind. The script works only for World Wind 1.3.2 and higher, it's called Skripter. Please download the scripter.zip from below and unzip it into your World Wind directory.

The forms looks a little bit overloaded but I didn't like to make a light versions because everyone could use all options. The script points will be stored in a DataGrid which is similar to an Excel spreadsheet, but not so easy to Edit,

To start it, choose Plugins and load there Skripter. Afterwards choose in the Tool menu, the item Skripter. Now will see a form with three tabs: Edit, Input from File and Save. You are now in the Edit Tab., now you can easily add points to a script.

[m_k]

Originally posted by Alcinoos@Jul 5 2005, 02:28 PM
5. Also you say "The script works only for World Wind 1.3.2 and higher" but the highest numbered release on the World Wind website today is 1.3.1.1 so I'm confused here.

Quoted post

1.3.2 is still in testing
You can download alpha 2 from
http://forum.worldwindcentral.com/...showtopic=3634
or one of the betas
http://builds.worldwind.arc.nasa.gov:80/latest/trunk/

[quote: 1.3.2 is still in testing
You can download alpha 2 from...]


OK many thanks, it loads OK. But I now have the following performance problems:

1. If I enter any values (inc 0) for the Viewing Direction and Vertical view, the screen zooms in to a close elevation that does not correspond to the Altitude setting

2. If I repeat two entries with a difference in only one of the above values (eg setting the Vertical view to 45 degrees) then although the picture rotates when using "Edit current entry" there is no effect when I run the script.

Any ideas?

Alcinoos

[canosso]

Hello Alcinoos,

Originally posted by Alcinoos@Jul 5 2005, 11:25 AM
[quote: 1.3.2 is still in testing
You can download alpha 2 from...]
OK many thanks, it loads OK. But I now have the following performance problems:

1. If I enter any values (inc 0) for the Viewing Direction and Vertical view, the screen zooms in to a close elevation that does not correspond to the Altitude setting

2. If I repeat two entries with a difference in only one of the above values (eg setting the Vertical view to 45 degrees) then although the picture rotates when using "Edit current entry" there is no effect when I run the script.

Any ideas?

Alcinoos

Quoted post

That is not my fault, that is the GotoLatLon Function with the tilt, this function does not work correct, maybe only for International users. At the moment, the viewing direction is not implemented. I would be glad if it works, without tilt it works correct.
You can test the problem if you copy a coordinate with tilt and paste it, you will not be on the same place again.

canosso

[canosso]

Hello,
some redesign made and the wished import functions for an URI added, also DMS coordinates and GPX Points could be pasted.

canosso

[Tom Sweetser]

hey all. it's all workin fine, script plays thru, no problems...but where/how do i actually save out a movie? thanks

tom