This page has been translated automatically.
视频教程
界面
要领
高级
实用建议
专业(SIM)
UnigineEditor
界面概述
资源工作流程
版本控制
设置和首选项
项目开发
调整节点参数
Setting Up Materials
设置属性
照明
Sandworm
使用编辑器工具执行特定任务
如何擴展編輯器功能
嵌入式节点类型
Nodes
Objects
Effects
Decals
光源
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
编程
基本原理
搭建开发环境
使用范例
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
材质和着色器
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
创建内容
内容优化
材质
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials

Unigine::Cigi::CigiClientInterface Class

Header: #include <CigiClientInterface.h>
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 Client interface.

Notice
CIGI plugin must be loaded.

CigiClientInterface Class

Members


init ( int version, const char * host, int send, int recv, int size = 1432 ) #

Initializes the CIGI Client using the given parameters.

Arguments

  • int version - CIGI protocol version. One of the CIGI_VERSION_* values.
  • const char * host - CIGI Host address.
  • int send - TCP port number to be used for sending packets to the CIGI Host.
  • int recv - TCP port number to be used for receiving packets from the CIGI Host.
  • int size - Packet size. The default value is 1432.

int isInitialized ( ) #

Returns a value indicating if the CIGI Client was initialized successfully.

Return value

1 if the CIGI Client was initialized successfully; otherwise, 0.

IView * getView ( int view_id ) #

Returns the interface of the specified view.
Notice
The specified view will be created, if it doesn't exist yet.

Arguments

  • int view_id - ID of the view.

Return value

Pointer to the view interface.

IViewGroup * getViewGroup ( int group_id ) #

Returns the interface of the specified view group.
Notice
The specified view group will be created, if it doesn't exist yet.

Arguments

  • int group_id - ID of the view group.

Return value

Pointer to the view group interface.

Entity * getEntity ( int entity_id ) #

Returns the interface of the specified entity.
Notice
The specified entity will be created, if it doesn't exist yet.

Arguments

  • int entity_id - ID of the entity.

Return value

Pointer to the entity interface.

void loadEntityTypes ( const char * file_name ) #

Loads entity definitions from the specified .xml file.

Arguments

  • const char * file_name - Path to the .xml file with entity definitions. By default entity definitions will be loaded from the "entity_types.xml" file.

int findEntityType ( const char * type_name ) #

Returns the entity type ID by its name.
Notice
Entity type IDs are defined in the entity definition file.

Arguments

  • const char * type_name - Entity type name.

Return value

Entity type ID.

int findComponentID ( int entity_type, const char * name ) #

Returns the ID of the component with the given name, which belongs to the specified entity type.

Arguments

  • int entity_type - Entity type ID.
  • const char * name - Component name.

Return value

Component ID.

void setIGMode ( int mode ) #

Sets the current IG mode.

Arguments

int getIGMode ( ) #

Returns the current IG mode.

Return value

IG mode. One of the CIGI_MODE_* values.

void setIGStatus ( int status ) #

Sets the current IG status.

Arguments

  • int status - IG status. The following values are supported:
    • 0 - normal
    • 1-255 - an error has occurred

int getIGStatus ( ) #

Returns the current IG status.

Return value

IG status. The following values are supported:
  • 0 - normal
  • 1-255 - an error has occurred

void setDatabase ( int db ) #

Sets the database to be used.

Arguments

  • int db - ID of the database to be used.

int getDatabase ( ) #

Returns the database currently used.

Return value

ID of the database currently used.

int getInterpolation ( ) #

Returns a value indicating if interpolation and extrapolation are enabled.

Return value

1 if interpolation and extrapolation are enabled; otherwise, 0.

int getIGFrame ( ) #

Returns the number of the current frame for the IG.

Return value

Current IG frame number.

int getHostFrame ( ) #

Returns the number of the current frame for the Host.

Return value

Current Host frame number.

double getHostTime ( ) #

Returns the current Host time (with latency corrections).

Return value

Current Host time, in seconds.

double getLastReceivedHostTime ( ) #

Returns the last received Host time.

Return value

Last received Host time, in seconds.

int isPacketsReceived ( ) #

Returns a value indicating if packets where received from the Host after the last update().

Return value

1 if packets were received from the Host after the last update(); otherwise, 0.

void setPlayer ( int view_id ) #

Sets the view with the given ID as a current one.

Arguments

  • int view_id - ID of the view to be set.

void useSynckerViewAsViewID ( int enabled ) #

Enables or disables an option to use of Syncker View IDs as View IDs for CIGI.
Notice
This method is to be called on Syncker Master only.

Arguments

  • int enabled - 1 to use Syncker View IDs as View IDs for CIGI; 0 - to use own View IDs.

int isSynckerViewUsedAsViewID ( ) #

Returns a value indicating if Syncker View IDs are used as View IDs for CIGI.

Return value

1 if Syncker View IDs are used as View IDs for CIGI; otherwise, 0.

void setConnectCallback ( Unigine::CallbackBase * func ) #

Sets a callback function to be fired when the Host has connected.

Arguments

Unigine::CallbackBase * getConnectCallback ( ) #

Returns a callback to be fired when the Host has connected.

Return value

Callback pointer.

void setReceivePacketCallback ( int cigi_opcode, Unigine::CallbackBase * func ) #

Sets a callback function to be fired when a packet of the specified type has been received from the Host.

Arguments

Unigine::CallbackBase * getReceivePacketCallback ( int cigi_opcode ) #

Returns a callback to be fired when a packet of the specified type has been received from the Host.

Arguments

  • int cigi_opcode - CIGI data packet opcode. One of the CIGI_OPCODE_* values.

Return value

Callback pointer.

void setCreateComponentCallback ( int component_class, int entity_type, int component_id, Unigine::CallbackBase * func ) #

Sets a callback function to be fired on creation of the specified type of component with the specified ID and the specified entity type.

Arguments

  • int component_class - CIGI component class. One of the CIGI_COMPONENT_* values.
  • int entity_type - Entity type ID.
    Notice
    This value is used only when the component type is set to CIGI_COMPONENT_ENTITY.
  • int component_id - Component ID.
  • Unigine::CallbackBase * func - Callback pointer.

Unigine::CallbackBase * getCreateComponentCallback ( int component_class, int entity_type, int component_id ) #

Returns a callback to be fired on creation of the specified type of component with the specified ID and the specified entity type.

Arguments

  • int component_class - CIGI component class. One of the CIGI_COMPONENT_* values.
  • int entity_type - Entity type ID.
    Notice
    This value is used only when the component type is set to CIGI_COMPONENT_ENTITY.
  • int component_id - Component ID.

Return value

Callback pointer.

void setDestroyComponentCallback ( int component_class, int entity_type, int component_id, Unigine::CallbackBase * func ) #

Sets a callback function to be fired on deletion of the specified type of component with the specified ID and the specified entity type.

Arguments

  • int component_class - CIGI component class. One of the CIGI_COMPONENT_* values.
  • int entity_type - Entity type ID.
    Notice
    This value is used only when the component type is set to CIGI_COMPONENT_ENTITY.
  • int component_id - Component ID.
  • Unigine::CallbackBase * func - Callback pointer.

Unigine::CallbackBase * getDestroyComponentCallback ( int component_class, int entity_type, int component_id ) #

Returns a callback to be fired on deletion of the specified type of component with the specified ID and the specified entity type.

Arguments

  • int component_class - CIGI component class. One of the CIGI_COMPONENT_* values.
  • int entity_type - Entity type ID.
    Notice
    This value is used only when the component type is set to CIGI_COMPONENT_ENTITY.
  • int component_id - Component ID.

Return value

Callback pointer.

int getNumHostPackets ( ) #

Returns the total number of packets received from the Host.

Return value

Total number of packets received from the Host.

ICigiHostPacket * getHostPacket ( int num ) #

Returns the specified CIGI Host packet.

Arguments

  • int num - ID of the Host packet.

Return value

CIGI Host packet.

void addIGPacket ( ICigiIGPacket * packet ) #

Sends the specified IG packet to the Host.

Arguments

  • ICigiIGPacket * packet - IG Packet to be sent to the Host.

int showDebug ( ) #

Returns a value indicating if the debug information is to be displayed.

Return value

1 if the debug information is to be displayed; otherwise, 0.
Last update: 2019-11-28
Build: ()