NAME

Rinchi::CIGIPP::LineOfSightExtendedResponse - Perl extension for the Common Image Generator Interface - Line Of Sight Extended Response data packet. data packet. =head1 SYNOPSIS

use Rinchi::CIGIPP::LineOfSightExtendedResponse;
my $los_xresp = Rinchi::CIGIPP::LineOfSightExtendedResponse->new();

$packet_type = $los_xresp->packet_type();
$packet_size = $los_xresp->packet_size();
$request_ident = $los_xresp->request_ident(57);
$host_frame_number_lsn = $los_xresp->host_frame_number_lsn(4);
$visible = $los_xresp->visible(Rinchi::CIGIPP->Occluded);
$range_valid = $los_xresp->range_valid(Rinchi::CIGIPP->Invalid);
$entity_ident_valid = $los_xresp->entity_ident_valid(Rinchi::CIGIPP->Invalid);
$valid = $los_xresp->valid(Rinchi::CIGIPP->Valid);
$response_count = $los_xresp->response_count(217);
$entity_ident = $los_xresp->entity_ident(41000);
$range = $los_xresp->range(17.74);
$latitude = $los_xresp->latitude(19.293);
$x_offset = $los_xresp->x_offset(14.649);
$longitude = $los_xresp->longitude(57.589);
$y_offset = $los_xresp->y_offset(47.628);
$altitude = $los_xresp->altitude(9.33);
$z_offset = $los_xresp->z_offset(43.407);
$red = $los_xresp->red(89);
$green = $los_xresp->green(122);
$blue = $los_xresp->blue(160);
$alpha = $los_xresp->alpha(242);
$material_code = $los_xresp->material_code(22573);
$normal_vector_azimuth = $los_xresp->normal_vector_azimuth(35.653);
$normal_vector_elevation = $los_xresp->normal_vector_elevation(41.678);

DESCRIPTION

The Line of Sight Extended Response packet is used in response to both Line of Sight Segment Request and Line of Sight Vector Request packets. This packet contains positional data describing the Line of Sight (LOS) intersection point. In addition, it contains the material code and surface-normal unit vector of the polygon at the point of intersection. The packet is sent when the Request Type attribute of the request packet is set to Extended (1).

A Line of Sight Extended Response packet will be sent for each intersection along the LOS segment or vector. The Response Count attribute will contain the total number of responses that are being returned. This will allow the Host to determine when all response packets for the given request have been received.

For responses to Line of Sight Segment Request packets, the Range, Altitude, Latitude, and Longitude attributes specify the range to and position of the intersection point along the LOS test segment. If the destination point specified in the request is occulted, these attributes specify the range to and position of a point on the surface occulting the destination. If the destination point is not occluded, these attributes simply provide the range to and position of the destination point.

For responses to Line of Sight Vector Request packets, the Range, Altitude, Latitude, and Longitude attributes specify the range to and position of the point of intersection between the test vector and a surface. If no intersection occurs within the valid range specified in the request, the Valid attribute is set to Invalid (0).

EXPORT

None by default.

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

new $los_xresp = Rinchi::CIGIPP::LineOfSightExtendedResponse->new()

Constructor for Rinchi::LineOfSightExtendedResponse.

sub packet_type()

$value = $los_xresp->packet_type();

Data Packet Identifier.

This attribute identifies this data packet as the Line of Sight Extended Response packet. The value of this attribute must be 105.

sub packet_size()

$value = $los_xresp->packet_size();

Data Packet Size.

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

sub request_ident([$newValue])

$value = $los_xresp->request_ident($newValue);

LOS ID.

This attribute corresponds to the value of the LOS ID attribute in the associated Line of Sight Segment Request or Line of Sight Vector Request packet.

sub host_frame_number_lsn([$newValue])

$value = $los_xresp->host_frame_number_lsn($newValue);

Host Frame Number LSN.

This attribute contains the least significant nybble of the Host Frame Number attribute of the last IG Control packet received before the LOS data are calculated. This attribute is ignored if the Update Period attribute of the corresponding Line of Sight Segment Request or Line of Sight Vector Request packet was set to zero (0).

sub visible([$newValue])

$value = $los_xresp->visible($newValue);

Visible.

This attribute is used in response to a Line of Sight Segment Request packet and indicates whether the destination point is visible from the source point. This value should be ignored if the packet is in response to a Line of Sight Vector Request packet.

Note: If the LOS segment destination point is within the body of a target entity model, this attribute will be set to Occluded (0) and the Entity ID attribute will contain the ID of that entity.

Occluded   0
Visible    1

sub range_valid([$newValue])

$value = $los_xresp->range_valid($newValue);

Range Valid.

This attribute indicates whether the Range attribute is valid. The range will be invalid if an intersection occurs before the minimum range or beyond the maximum range specified in an LOS vector request. The range will also be invalid if this packet is in response to an LOS segment request.

If Valid is set to Invalid (0), this attribute will also be set to Invalid (0).

Invalid   0
Valid     1

sub entity_ident_valid([$newValue])

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

Entity Ident Valid.

This attribute indicates whether the LOS test vector or segment intersects with an entity (Valid) or a non-entity (Invalid).

Invalid   0
Valid     1

sub valid([$newValue])

$value = $los_xresp->valid($newValue);

Valid.

This attribute indicates whether this packet contains valid data. A value of Invalid (0) indicates that the LOS test segment or vector did not intersect any geometry.

Invalid   0
Valid     1

sub response_count([$newValue])

$value = $los_xresp->response_count($newValue);

Response Count.

This attribute indicates the total number of Line of Sight Extended Response packets the IG will return for the corresponding request.

Note: If Visible is set to Visible (1), then Response Count should be set to 1.

sub entity_ident([$newValue])

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

Entity Identifier.

This attribute indicates the entity with which a LOS test vector or segment intersects. This attribute should be ignored if Entity ID Valid is set to Invalid (0).

sub range([$newValue])

$value = $los_xresp->range($newValue);

Range.

This attribute represents the distance along the LOS test segment or vector from the source point to the point of intersection with a polygon surface.

sub latitude([$newValue])

$value = $los_xresp->latitude($newValue);

Latitude.

If the Entity ID Valid attribute is set to Invalid (0) or if Response Coordinate System in the request packet was set to Geodetic (0), this attribute indicates the geodetic latitude of the point of intersection along the LOS test segment or vector.

If this packet is in response to an LOS segment request and Visible is set to Occluded (0), this point is on the occulting surface. If this packet is in response to an LOS segment request and Visible is set to Visible (1), this point is simply the destination point.

sub x_offset([$newValue])

$value = $los_xresp->x_offset($newValue);

X Offset.

If the Entity ID Valid attribute is set to Valid (1) and Response Coordinate System in the request packet was set to Entity (1), this attribute specifies the offset of the point of intersection of the LOS test segment or vector along the intersected entity's X axis.

sub longitude([$newValue])

$value = $los_xresp->longitude($newValue);

Longitude.

If the Entity ID Valid attribute is set to Invalid (0) or if Response Coordinate System in the request packet was set to Geodetic (0), this attribute indicates the geodetic longitude of the point of intersection along the LOS test segment or vector.

If this packet is in response to an LOS segment request and Visible is set to Occluded (0), this point is on the occulting surface. If this packet is in response to an LOS segment request and Visible is set to Visible (1), this point is simply the destination point.

sub y_offset([$newValue])

$value = $los_xresp->y_offset($newValue);

Y Offset.

If the Entity ID Valid attribute is set to Valid (1) and Response Coordinate System in the request packet was set to Entity (1), this attribute specifies the offset of the point of intersection of the LOS test segment or vector along the intersected entity's Y axis.

sub altitude([$newValue])

$value = $los_xresp->altitude($newValue);

Altitude.

If the Entity ID Valid attribute is set to Invalid (0) or if Response Coordinate System in the request packet was set to Geodetic (0), this attribute indicates the geodetic altitude of the point of intersection along the LOS test segment or vector.

If this packet is in response to a LOS segment request and Visible is set to Occluded (0), this point is on the occulting surface. If this packet is in response to a LOS segment request and Visible is set to Visible (1), this point is simply the destination point.

sub z_offset([$newValue])

$value = $los_xresp->z_offset($newValue);

Z Offset.

If the Entity ID Valid attribute is set to Valid (1) and Response Coordinate System in the request packet was set to Entity (1), this attribute specifies the offset of the point of intersection of the LOS test segment or vector along the intersected entity's Z axis.

sub red([$newValue])

$value = $los_xresp->red($newValue);

Red.

This attribute indicates the red color component of the surface at the point of intersection.

sub green([$newValue])

$value = $los_xresp->green($newValue);

Green.

This attribute indicates the green color component of the surface at the point of intersection.

sub blue([$newValue])

$value = $los_xresp->blue($newValue);

Blue.

This attribute indicates the blue color component of the surface at the point of intersection.

sub alpha([$newValue])

$value = $los_xresp->alpha($newValue);

Alpha.

This attribute indicates the alpha color component of the surface at the point of intersection.

sub material_code([$newValue])

$value = $los_xresp->material_code($newValue);

Material Code.

This attribute indicates the material code of the surface intersected by the LOS test segment or vector.

sub normal_vector_azimuth([$newValue])

$value = $los_xresp->normal_vector_azimuth($newValue);

Normal Vector Azimuth.

This attribute represents the azimuth of the normal unit vector of the surface intersected by the HAT/HOT test vector. This value is the horizontal angle from True North to the vector.

sub normal_vector_elevation([$newValue])

$value = $los_xresp->normal_vector_elevation($newValue);

Normal Vector Elevation.

This attribute represents the elevation of the normal unit vector of the surface intersected by the HAT/HOT test vector. This value is the vertical angle from the geodetic reference plane to the vector.

sub pack()

$value = $los_xresp->pack();

Returns the packed data packet.

sub unpack()

$value = $los_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.