NAME

Rinchi::CIGIPP::ConformalClampedEntityControl - Perl extension for the Common Image Generator Interface - Conformal Clamped Entity Control data packet. data packet. =head1 SYNOPSIS

use Rinchi::CIGIPP::ConformalClampedEntityControl;
my $ccent_ctl = Rinchi::CIGIPP::ConformalClampedEntityControl->new();

$packet_type = $ccent_ctl->packet_type();
$packet_size = $ccent_ctl->packet_size();
$entity_ident = $ccent_ctl->entity_ident(57935);
$yaw = $ccent_ctl->yaw(39.75);
$latitude = $ccent_ctl->latitude(57.645);
$longitude = $ccent_ctl->longitude(70.599);

DESCRIPTION

The Conformal Clamped Entity Control packet is used to set spatial data for conformal, ground- or ocean-clamped entities. This packet is offered as a lightweight alternative to the Entity Control packet.

Because the entity type and other necessary attributes are not specified in this packet, it may not be used to instantiate (create) an entity. Before using this packet to manipulate an entity, the Host must first instantiate that entity by sending an Entity Control packet and should set the Ground/Ocean Clamp attribute to Conformal (2). If a non-existent entity is referenced by a Conformal Clamped Entity Control packet, the packet will be ignored.

An entity's current roll, pitch, and altitude offsets (specified in the last Entity Control packet referencing the entity) will be maintained when the IG receives a Conformal Clamped Entity Control packet describing that entity. If this packet is applied to an unclamped or non-conformal clamped entity, its current absolute roll, pitch, and altitude will be maintained.

EXPORT

None by default.

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

new $ccent_ctl = Rinchi::CIGIPP::ConformalClampedEntityControl->new()

Constructor for Rinchi::ConformalClampedEntityControl.

sub packet_type()

$value = $ccent_ctl->packet_type();

Data Packet Identifier.

This attribute identifies this data packet as the Conformal Clamped Entity Control packet. The value of this attribute must be 3.

sub packet_size()

$value = $ccent_ctl->packet_size();

Data Packet Size.

This attribute indicates the number of bytes in this data packet. Thevalue of this attribute must be 24.

sub entity_ident([$newValue])

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

Entity ID.

This attribute epresents the entity to which this packet will be applied. A value of zero (0) corresponds to the Ownship.

sub yaw([$newValue])

$value = $ccent_ctl->yaw($newValue);

Yaw.

This attribute specifies the instantaneous heading of the entity as measured from True North.

sub latitude([$newValue])

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

Latitude.

This attribute specifies the entity's geodetic latitude.

sub longitude([$newValue])

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

Longitude.

This attribute specifies the entity's geodetic longitude.

sub pack()

$value = $ccent_ctl->pack();

Returns the packed data packet.

sub unpack()

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