GroundVehicle Visualization

Top  Previous  Next

There are many options available for GroundVehicle visualization. The user can set the tail color, tail length and body scale of the GroundVehicle. The user can also define tick marks and include annotations. Please see the Generating Output Guide for more information.


There are a variety of Sample Mission Plans (included with your FreeFlyer installation) that demonstrate various applications of these topics. Continue to the Generating Output Samples page to view descriptions and images of these examples.



Visualization Options

The image below shows how some of the FreeFlyer's visualization options look in a View Window. This shows a naval ship 3D model, with plus tick marks, an annotation, and a yellow tail.


Example Visualization

Example Visualization


The following aspects of the GroundVehicle visualization can be specified via FreeFlyer Script or the GroundVehicle Object Editor:


Tail Color

The tail shows the past positions of the GroundVehicle, and can be any color. See the Color Reference guide for more information.


GroundVehicle1.Color = ColorTools.Yellow;


Body Scale

The BodyScale property defines how large the GroundVehicle looks compared to other objects.

GroundVehicle1.BodyScale = 100000; // Default


History Mode

The HistoryMode property of the GroundVehicle allows the user to specify whether the tail of the GroundVehicle will be unlimited or wrapped. If the history mode is set to wrap, the Tail Length option specifies how long (in number of steps) the tail will persist in the view. Use caution in setting unlimited tail lengths, or in using tail lengths longer than 10,000 - 30,000 points. Tail lengths exceeding this range can cause memory problems due to the large amount of relative position data that must be maintained. The maximum tail length that can be used safely depends on the amount of memory in the system and the number of objects managed by the Mission View.

GroundVehicle1.HistoryMode = 0; // 0 - Wrapping, 1 - Unlimited

GroundVehicle1.TailLength  = 100;


Tick Marks

If desired, FreeFlyer will place a marker at the end of each GroundVehicle step. The following choices are available for tick marks.




Circle (Open or Solid)

Square (Open or Solid)

Diamond (Open or Solid)

Up Triangle (Open or Solid)

Down Triangle (Open or Solid)


The tick type can also be assigned via script in the following way:


GroundVehicle1.TickType = "Cross";



You may annotate the GroundVehicle with a description of some sort. The annotations will appear with every tick mark.

GroundVehicle1.Annotation = "Vehicle";


3D Model

You can use any one of the following built in 3D models to represent the GroundVehicle in the 3D view, or use a custom model from an external file. A flattened 2D representation of the 3D model will appear in 2D map views.




M1 Abrams Tank


Semi-Trailer Truck


This can also be assigned via script in the following way.


GroundVehicle1.ThreeDModelFile = "Internal::Pickup";



You can also choose not to display a 3D model for your GroundVehicle, and instead display only its name and/or an icon (an image file). This can be useful when you don't have an accurate 3D model, or when you want to distinguish between different ground objects at a glance even when zoomed out.


ViewWindow1.SetObjectIcon(GroundVehicle1.ObjectId, "diamond_open.png");

ViewWindow1.SetShowIcon(GroundVehicle1.ObjectId, 1);



The default settings create a GroundVehicle with a Van model at a scale of 100000, a yellow tail that lasts for 100 steps, with no tick marks or annotations.


GroundVehicle Visualization Editor

GroundVehicle Visualization Editor



See Also

Generating Output Guide


Vehicle 3D Models

Generating Movies