This page has been translated automatically.
视频教程
界面
要领
高级
实用建议
基础
专业(SIM)
UnigineEditor
界面概述
资源工作流程
Version Control
设置和首选项
项目开发
调整节点参数
Setting Up Materials
设置属性
照明
Sandworm
使用编辑器工具执行特定任务
如何擴展編輯器功能
嵌入式节点类型
Nodes
Objects
Effects
Decals
光源
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
编程
基本原理
搭建开发环境
使用范例
C++
C#
UnigineScript
统一的Unigine着色器语言 UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
材质和着色器
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口(API)参考
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::MutexAdvance Class

Header: #include <UnigineThread.h>

Template class that wraps a generic mutex type with additional lock state tracking for faster lock state queries and reduced contention in some concurrent scenarios.

By maintaining an atomic flag (is_locked), this class allows quick checks for lock status without acquiring the underlying mutex, while providing standard locking interfaces.

MutexType - The underlying mutex type used for locking. The type must provide lock(), tryLock(), unlock() methods.

This class has the following aliases:

Alias Description Type
MutexSlimAdvance Alias for MutexAdvance using MutexSlim as the base mutex. Adds lock state tracking to a Windows SRW Lock. MutexSlim
MutexCriticalSectionAdvance Alias for MutexAdvance using MutexCriticalSection as the base mutex. Adds lock state tracking to a Windows CRITICAL_SECTION. MutexCriticalSection
MutexPThreadAdvance Alias for MutexAdvance using MutexPThread as the base mutex. Adds lock state tracking to a Linux pthread_mutex_t. MutexPThread

MutexAdvance Class

Members


MutexAdvance ( ) #

Default constructor. Initializes the internal mutex and sets the lock state to unlocked.

void lock ( ) #

Acquires the internal mutex and marks the lock state as active.

void unlock ( ) #

Releases the internal mutex and marks the lock state as inactive.

bool tryLock ( ) #

Attempts to acquire the lock without blocking. First checks the internal flag for a fast-path rejection, then tries to acquire the underlying mutex.

Return value

Returns true if the lock was successfully acquired, false otherwise.

bool isLocked ( ) #

Returns the current lock status of the mutex by checking the internal flag.

Return value

Returns true if the lock is currently held, false otherwise.

void waitForce ( ) #

Forces the current thread to wait by acquiring and immediately releasing the lock.

void wait ( ) #

Waits for the mutex to be released if it is currently locked. Returns immediately if the lock is not held.

The information on this page is valid for UNIGINE 2.20 SDK.

Last update: 2025-07-10
Build: ()