UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
FAQ
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine and Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
Rendering-Related Classes

Unigine::Cigi::ICigiLosSegmentRequest Class

Header: #include <CigiClientInterface.h>
Inherits: ICigiHostPacket
Warning
The CIGIClient plugin is deprecated and no longer supported. For more information on working with CIGI please refer to the IG Application section.

This class represents the CIGI LOS (Line of Sight) Segment Request packet interface.

Notice
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:

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:

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:

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.
Notice
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: 2019-02-14