NAME

Rinchi::CIGIPP::SensorExtendedResponse - Perl extension for the Common Image Generator Interface - Sensor Extended Response data packet. data packet. =head1 SYNOPSIS

use Rinchi::CIGIPP::SensorExtendedResponse;
my $sensor_xresp = Rinchi::CIGIPP::SensorExtendedResponse->new();

$packet_type = $sensor_xresp->packet_type();
$packet_size = $sensor_xresp->packet_size();
$view_ident = $sensor_xresp->view_ident(15496);
$sensor_ident = $sensor_xresp->sensor_ident(37242);
$entity_ident_valid = $sensor_xresp->entity_ident_valid(Rinchi::CIGIPP->Valid);
$sensor_status = $sensor_xresp->sensor_status(Rinchi::CIGIPP->Searching);
$entity_ident = $sensor_xresp->entity_ident(64212);
$gate_xsize = $sensor_xresp->gate_xsize(22491);
$gate_ysize = $sensor_xresp->gate_ysize(15321);
$gate_xposition = $sensor_xresp->gate_xposition(9.495);
$gate_yposition = $sensor_xresp->gate_yposition(56.78);
$host_frame_number = $sensor_xresp->host_frame_number(22764);
$track_point_latitude = $sensor_xresp->track_point_latitude(75.221);
$track_point_longitude = $sensor_xresp->track_point_longitude(4.123);
$track_point_altitude = $sensor_xresp->track_point_altitude(68.142);

DESCRIPTION

The Sensor Extended Response packet, like the Sensor Response packet, is used to report the gate size and position on a sensor display to the Host. This packet also contains the geodetic position of the sensor track point and the entity ID of the target.

Either this packet or the Sensor Response packet must be sent to the Host during each frame that the specified sensor is active.

EXPORT

None by default.

#==============================================================================

new $sensor_xresp = Rinchi::CIGIPP::SensorExtendedResponse->new()

Constructor for Rinchi::SensorExtendedResponse.

sub packet_type()

$value = $sensor_xresp->packet_type();

Data Packet Identifier.

This attribute identifies this data packet as the Sensor Extended Response packet. The value of this attribute must be 107.

sub packet_size()

$value = $sensor_xresp->packet_size();

Data Packet Size.

This attribute indicates the number of bytes in this data packet. The value of this attribute must be 48.

sub view_ident([$newValue])

$value = $sensor_xresp->view_ident($newValue);

View ID.

This attribute specifies the view that represents the sensor display.

sub sensor_ident([$newValue])

$value = $sensor_xresp->sensor_ident($newValue);

Sensor ID.

This attribute specifies the sensor to which the data in this packet apply.

sub entity_ident_valid([$newValue])

$value = $sensor_xresp->entity_ident_valid($newValue);

Entity ID Valid.

This attribute indicates whether the target is an entity or a non-entity object. If this attribute is set to Valid (1), then Entity ID identifies the target entity.

Invalid   0
Valid     1

sub sensor_status([$newValue])

$value = $sensor_xresp->sensor_status($newValue);

Sensor Status.

This attribute indicates the current tracking state of the sensor.

Searching            0
Tracking             1
ImpendingBreaklock   2
Breaklock            3

sub entity_ident([$newValue])

$value = $sensor_xresp->entity_ident($newValue);

Entity ID.

This attribute indicates the entity ID of the target. This attribute is ignored if Entity ID Valid is set to Invalid (0).

sub gate_xsize([$newValue])

$value = $sensor_xresp->gate_xsize($newValue);

Gate X Size.

This attribute specifies the gate symbol size along the view's X axis.

Note: This size is specified in either pixels or raster lines depending upon the orientation of the display.

sub gate_ysize([$newValue])

$value = $sensor_xresp->gate_ysize($newValue);

Gate Y Size.

This attribute specifies the gate symbol size along the view's Y axis.

Note: This size is specified in either pixels or raster lines depending upon the orientation of the display.

sub gate_xposition([$newValue])

$value = $sensor_xresp->gate_xposition($newValue);

Gate X Position.

This attribute specifies the gate symbol's position along the view's X axis. This position is given as the horizontal angle formed at the sensor eyepoint between the sensor's viewing vector and the center of the track point.

sub gate_yposition([$newValue])

$value = $sensor_xresp->gate_yposition($newValue);

Gate Y Position.

This attribute specifies the gate symbol's position along the view's Y axis. This position is given as the vertical angle formed at the sensor eyepoint between the sensor's viewing vector and the center of the track point.

sub host_frame_number([$newValue])

$value = $sensor_xresp->host_frame_number($newValue);

Host Frame Number.

This attribute indicates the Host frame number at the time that the IG calculates the gate and line-of-sight intersection data.

sub track_point_latitude([$newValue])

$value = $sensor_xresp->track_point_latitude($newValue);

Track Point Latitude.

This attribute indicates the geodetic latitude of the point being tracked by the sensor. This attribute is valid only when the Sensor Status attribute is set to one (1) or two (2).

sub track_point_longitude([$newValue])

$value = $sensor_xresp->track_point_longitude($newValue);

Track Point Longitude.

This attribute indicates the geodetic longitude of the point being tracked by the sensor. This attribute is valid only when the Sensor Status attribute is set to one (1) or two (2).

sub track_point_altitude([$newValue])

$value = $sensor_xresp->track_point_altitude($newValue);

Track Point Altitude.

This attribute indicates the geodetic altitude of the point being tracked by the sensor measured in meters above mean sea level. This attribute is valid only when the Sensor Status attribute is set to one (1) or two (2).

sub pack()

$value = $sensor_xresp->pack();

Returns the packed data packet.

sub unpack()

$value = $sensor_xresp->unpack();

Unpacks the packed data packet.

sub byte_swap()

$obj_name->byte_swap();

Byte swaps the packed data packet.

SEE ALSO

Refer the the Common Image Generator Interface ICD which may be had at this URL: http://cigi.sourceforge.net/specification.php

AUTHOR

Brian M. Ames, <bmames@apk.net>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Brian M. Ames

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6 or, at your option, any later version of Perl 5 you may have available.