Unigine::Cigi::ICigiLosSegmentRequest Class
Header: | #include <CigiClientInterface.h> |
Inherits: | ICigiHostPacket |
This class represents the CIGI LOS (Line of Sight) Segment Request packet interface.
CIGI plugin must be loaded.
ICigiLosSegmentRequest Class
Members
int getLosID()
Returns the LOS ID specified in the packet.Return value
LOS ID.int getSrcEntityID()
Returns the Source Entity ID specified in the packet.Return value
Source Entity ID.int getDestEntityID()
Returns the value of the Destination Entity ID parameter specified in the packet. Defines the entity to which the test segment endpoints shall be relative.Return value
Destination Entity ID.int getRequestType()
Returns the value of the Request Type parameter specified in the packet. Determines what type of response the IG will return for this request.Return value
Request Type parameter value. The following values are supported:- 0 - Basic. The IG shall respond with a Line of Sight Response packet.
- 1 - Extended. The IG shall respond with a Line of Sight Extended Response packet.
int getSrcCoordSystem()
Returns the value of the Source Point Coordinate System parameter specified in the packet. It indicates the coordinate system relative to which the test segment source endpoint is specified.Return value
Source Point Coordinate System parameter value. The following values are supported:- 0 - Geodetic. The point shall be given by latitude, longitude, and altitude.
- 1 - Entity. The point shall be defined relative to the reference point of the entity specified by Entity ID.
int getDestCoordSystem()
Returns the value of the Destination Point Coordinate System parameter specified in the packet. It indicates the coordinate system relative to which the test segment destination endpoint is specified.Return value
Destination Point Coordinate System parameter value. The following values are supported:- 0 - Geodetic. The endpoint shall be given as a latitude, longitude, and altitude.
- 1 - Entity. There are two cases:
- If Destination Entity ID Valid is set to Not Valid (0) than the endpoint shall be defined relative to the reference point of the entity specified by Source Entity ID.
- If Destination Entity ID Valid is set to Valid (1) than the endpoint shall be defined relative to the reference point of the entity specified by Destination Entity ID.
int getRespCoordSystem()
Returns the value of the Responce Coordinate System parameter specified in the packet. This value specifies the coordinate system to be used in the response.Return value
Responce Coordinate System parameter value. The following values are supported:- 0 - Geodetic. The intersection point shall be reported as a latitude, longitude, and altitude.
- 1 - Entity. The intersection point shall be specified relative to the reference point of the intersected entity.
int getDestEntityValid()
Returns the value of the Destination Entity ID Valid parameter specified in the packet. Determines whether the Destination Entity ID parameter contains a valid entity ID.Return value
Destination entity valid parameter value. The following values are supported:- 0 - Not Valid. The destination endpoint shall be defined with respect to either the source entity (specified by Source Entity ID) or the Geodetic coordinate system as determined by the Destination Point Coordinate System parameter.
- 1 - Valid. The destination endpoint shall be defined with respect to the entity specified by Destination Entity ID, only if Destination Point Coordinate System is set to Entity (1).
int getAlphaThreshold()
Returns the value of the Alpha Threshold parameter specified in the packet. Defines the minimum alpha value (i.e., minimum opacity) a surface may have for an LOS response to be generated.Return value
Alpha Threshold parameter value.int getUpdatePeriod()
Returns the value of the Update Period parameter specified in the packet. Specifies the interval between successive responses to this request.Return value
Update Period parameter value. The following values are supported:- 0 - One-Shot request.
- >0 - update period. The value of n>0 indicates that the IG shall return response every nth frame.
int getMaterialMask()
Returns the value of the Material Mask parameter specified in the packet. Specifies the environmental and cultural features to be included in LOS segment testing.Return value
Material Mask parameter value. Each bit represents a material code range; setting that bit to one (1) shall cause the IG to register intersections with polygons whose material codes are within that range.Material code ranges are IG-dependent.
const Math::dvec3& getSrcPosition()
Returns Source Point position represented as a three-component vector of Source Latitude, Source Longitude, Source Altitude or Source X Offset, Source Y Offset, Source Z Offset parameters values specified in the packet corresponding to the Source Point Coordinate System parameter value.Return value
Three-component vector that defines Source Point position. The following values are supported:- [Latitude, Longitude, Altitude] - if Source Point Coordinate System is set to Geodetic (0).
- [X Offset, Y Offset, Z Offset] - if Source Point Coordinate System is set to Entity (1).
const Math::dvec3& getDestPosition()
Returns Destination Point position represented as a three-component vector of Destination Latitude, Destination Longitude, Destination Altitude or Destination X Offset, Destination Y Offset, Destination Z Offset parameters values specified in the packet corresponding to the Destination Point Coordinate System parameter value.Return value
Three-component vector that defines Destination Point position. The following values are supported:- [Latitude, Longitude, Altitude] - if Destination Point Coordinate System is set to Geodetic (0).
- [X Offset, Y Offset, Z Offset] - if Destination Point Coordinate System is set to Entity (1). This offset may be relative to either the source entity or destination entity, depending upon the value of the Destination Entity ID Valid flag.
Last update: 2018-08-10
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)