Control the display of object graphics
DisplayTimes <ObjectPath> {DisplayOption} {Action} [<Parameters>]
You can control the display of object graphics based on times, access intervals, or time components using the DisplayTimes command. The DisplayTimes command allows you to control whether and when object graphics appear in the 2D and 3D Graphics window(s).
Note: This command is deprecated for vehicles, use the Graphics CustomIntervals (Vehicles) and Graphics AccessIntervals (Vehicles) commands to modify display intervals for vehicles.
{DisplayOption} and {Action} can be:
| {DisplayOption} | {Action} | <Parameters> | Description |
|---|---|---|---|
| State | Interval | N/A | Uses the time intervals set with the
Intervals, Access, or TimeComponent {DisplayOption} to control the
display of object graphics.
Note: {DisplayOption} is automatically changed to Intervals if {State} is set to Interval. |
| AlwaysOn | N/A | Object graphics are always on, regardless of the display intervals set. | |
| AlwaysOff | N/A | Object graphics are always off, regardless of the display intervals set. | |
| Access | N/A | Object graphics display only during access to another object specified. | |
| Intervals | Clear | N/A | Removes all intervals from the list of display times so that the object displays according to the {State}. |
| Add | <NumIntervalPairs> "<IntervalStart>" "<IntervalStop>" ["<IntervalStart2>" "<IntervalStop2>"...] | {State} will be set to Interval. Object graphics only appear during the intervals set. The number of "<StartTime>" and "<StopTime>" value pairs to be entered depends upon the number interval pairs specified. | |
| Delete | <NumIntervalPairs> "<IntervalStart>" "<IntervalStop>" ["<IntervalStart2>" "<IntervalStop2>"...] | Specify the intervals to be deleted. The number of "<StartTime>" and "<StopTime>" value pairs to be deleted depends upon the <NumIntervalPairs> specified. The command will Nack if no intervals are deleted. If {State} is set to Access, it will be changed to Interval. | |
| Replace | <NumIntervalPairs> "<IntervalStart>" "<IntervalStop>" ["<IntervalStart2>" "<IntervalStop2>"...] | Removes all existing intervals and adds those entered using this command. | |
| File | {Load | Add} "<FilePath>" | Read in an interval file to use for display times. If Load is specified, the intervals from the file will Replace any existing intervals. If Add is specified then the intervals in the file will be Added to the existing interval list. The intervals within the file must be within the object's time period or they will not be loaded. Duplicate intervals will not be added. | |
| ReplaceLastTime | "<NewEndTime>" | Replace the end time of the last interval with the time specified. The object must have intervals defined and the "<NewEndTime>" must be after the start time of the last interval. | |
| Access | Clear | N/A | Removes all display intervals based on access times from the display times list. |
| <ToAccessObjectPath> | N/A | {State} is set to Intervals. Sets display intervals based on access to the <ToAccessObjectPath> specified so that object graphics display only during access between these two objects. | |
| TimeComponent | "<TimeComponent>" | N/A | Specify an Interval or Interval List
time component for the display times. Any existing display times
will be replaced with the times from the Interval or Interval List
component.
For the specification of "<TimeComponent>", see Component Specification. |
To add a display interval for AreaTarget1 in the current scenario so that it appears at 1 a.m. to 2 a.m. and 4 a.m. to 5 a.m.:
DisplayTimes */AreaTarget/AreaTarget1 Intervals Add 2 "1 Jan 2000 01:00:00.0" "1 Jan 2000 02:00:00.0" "1 Jan 2000 04:00:00.0" "1 Jan 2000 05:00:00.0"
To set the display of object label and marker so that they display at all times:
DisplayTimes */LineTarget/Lt1 State AlwaysOn
Replace the existing interval list for Facility1 with the intervals in Target1.int:
DisplayTimes */Facility/Facility1 Intervals File Load "C:\stk50DB\Target1.int"
Delete the interval specified for Sensor1:
DisplayTimes */Satellite/Satellite1/Sensor/Sensor1 Intervals Delete 1 "1 Jul 2005 20:44:05.396" "1 Jul 2005 22:54:24.00"
Replace the end time of the last interval with the specified time:
DisplayTimes */Satellite/Satellite1/Sensor/Sensor1 Intervals ReplaceLastTime "2 Jul 2007 11:28:00.00"
Set the display times for the Sensor to the times in the Interval List component:
DisplayTimes */Satellite/ScenTestSat/Sensor/ScenSatSn TimeComponent "Facility/ScenTestFac LightingIntervals.Sunlight Interval List"
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10.1
STK Programming Interface 11.0.1