redgpu/ezEngine: An open source C++ game engine.

Code/Engine/Foundation/ezEngine.py
1 136 строк50 KB
Sanakan8472
Visualizer Updates (#1614)
19 июл 2025, 21:44
19 июл 2025, 21:44aa18d1e
import lldb.formatters.Logger
import lldb
try:
  import debugpy
except ImportError:
  print("debugpy module not found")

def __lldb_init_module(debugger, internal_dict):
    # comment this in for debug output
    lldb.formatters.Logger._lldb_formatters_debug_level = 2

    try:
        print("debugpy is listening...")
        debugpy.listen(5678)
    except NameError:
        print("debugpy not installed.")

    # Strings
    debugger.HandleCommand('type synthetic add -x "^ezHybridString<.+>$" --python-class ezEngine.ezHybridStringSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezHybridString<.+>$" --python-function ezEngine.ezHybridString_SummaryProvider -w ezEngine')

    debugger.HandleCommand('type synthetic add ezStringBuilder --python-class ezEngine.ezHybridStringSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add ezStringBuilder --python-function ezEngine.ezHybridString_SummaryProvider -w ezEngine')

    debugger.HandleCommand('type synthetic add ezStringView --python-class ezEngine.ezStringViewSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add ezStringView --python-function ezEngine.ezStringView_SummaryProvider -w ezEngine')

    debugger.HandleCommand('type synthetic add ezHashedString --python-class ezEngine.ezHashedStringSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add ezHashedString --python-function ezEngine.ezHashedString_SummaryProvider -w ezEngine')

    debugger.HandleCommand('type summary add ezStringIterator --python-function ezEngine.ezStringIterator_SummaryProvider -w ezEngine')
    debugger.HandleCommand('type summary add ezStringReverseIterator --python-function ezEngine.ezStringIterator_SummaryProvider -w ezEngine') 

    # Containers
    debugger.HandleCommand('type synthetic add -x "^ezDynamicArray<.+>$" --python-class ezEngine.ezDynamicArrayBaseSynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add -x "^ezHybridArray<.+>$" --python-class ezEngine.ezDynamicArrayBaseSynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add -x "^ezSmallArray<.+>$" --python-class ezEngine.ezSmallArraySynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add -x "^ezStaticArray<.+>$" --python-class ezEngine.ezStaticArraySynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add -x "^ezStaticRingBuffer<.+>$" --python-class ezEngine.ezStaticRingBufferSynthProvider -w ezEngine')

    debugger.HandleCommand('type synthetic add -x "^ezArrayPtr<.+>$" --python-class ezEngine.ezArrayPtrSynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add ezByteArrayPtr --python-class ezEngine.ezArrayPtrSynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add ezConstByteArrayPtr --python-class ezEngine.ezArrayPtrSynthProvider -w ezEngine')

    debugger.HandleCommand('type synthetic add -x "^ezHashTable<.+>$" --python-class ezEngine.ezHashTableBaseSynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add -x "^ezHashSet<.+>$" --python-class ezEngine.ezHashTableBaseSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezHashTableBase<.+>::Entry$" --summary-string "key = ${var.key}, value = ${var.value}" -w ezEngine')
    
    debugger.HandleCommand('type synthetic add -x "^ezMap<.+>$" --python-class ezEngine.ezMapSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezMapBase<.+>::Node$" --summary-string "key = ${var.m_Key}, value = ${var.m_Value}" -w ezEngine')
    
    debugger.HandleCommand('type synthetic add -x "^ezSet<.+>$" --python-class ezEngine.ezMapSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezSetBase<.+>::Node$" --summary-string "${var.m_Key}" -w ezEngine')
    
    debugger.HandleCommand('type synthetic add -x "^ezList<.+>$" --python-class ezEngine.ezListSynthProvider -w ezEngine')

    debugger.HandleCommand('type synthetic add -x "^ezDeque<.+>$" --python-class ezEngine.ezDequeSynthProvider -w ezEngine')

    # Basic Types
    debugger.HandleCommand('type synthetic add -x "^ezEnum<.+>$" --python-class ezEngine.ezEnumSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezEnum<.+>$" --python-function ezEngine.ezEnum_SummaryProvider -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezBitflags<.+>$" --python-function ezEngine.ezBitflags_SummaryProvider -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezVec2Template<.+>$" --summary-string "\{ x=${var.x}, y=${var.y} \}" -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezVec3Template<.+>$" --summary-string "\{ x=${var.x}, y=${var.y}, z=${var.z} \}" -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezVec4Template<.+>$" --summary-string "\{ x=${var.x}, y=${var.y}, z=${var.z}, w=${var.w} \}" -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezQuatTemplate<.+>$" --summary-string "\{ x=${var.x}, y=${var.y}, z=${var.z}, w=${var.w} \}" -w ezEngine')
    debugger.HandleCommand('type summary add -x "^ezPlaneTemplate<.+>$" --summary-string "\{ nx=${var.m_vNormal.x}, ny=${var.m_vNormal.y}, nz=${var.m_vNormal.z}, negDist=${var.m_fNegDistance} \}" -w ezEngine')
    debugger.HandleCommand('type summary add "ezColor" --summary-string "\{ r=${var.r}, g=${var.g}, b=${var.b}, a=${var.a} \}" -w ezEngine')
    debugger.HandleCommand('type summary add "ezColorGammaUB" --summary-string "\{ r=${var.r:d}, g=${var.g:d}, b=${var.b:d}, a=${var.a:d} \}" -w ezEngine')
    debugger.HandleCommand('type summary add "ezColorLinearUB" --summary-string "\{ r=${var.r:d}, g=${var.g:d}, b=${var.b:d}, a=${var.a:d} \}" -w ezEngine')
    debugger.HandleCommand('type summary add "ezTime" --summary-string "\{ seconds=${var.m_fTime} \}" -w ezEngine')
    debugger.HandleCommand('type summary add "ezAngle" --python-function ezEngine.ezAngle_SummaryProvider -w ezEngine')
    debugger.HandleCommand('type summary add "ezUuid" --python-function ezEngine.ezUuid_SummaryProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add "ezMat3" --python-class ezEngine.ezMat3SynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add "ezMat4" --python-class ezEngine.ezMat4SynthProvider -w ezEngine')
    debugger.HandleCommand('type synthetic add "ezVariant" --python-class ezEngine.ezVariantSynthProvider -w ezEngine')
    debugger.HandleCommand('type summary add "ezVariant" --python-function ezEngine.ezVariant_SummaryProvider -w ezEngine')

    debugger.HandleCommand('type category enable ezEngine')

#region Strings

def make_string(F):
    data = bytearray(F.GetData().uint8)
    if data[-1] == 0:
        data = data[:-1]
    return data.decode("utf-8")


class ezHybridStringSynthProvider:
    def __init__(self, valobj, dict):
        logger = lldb.formatters.Logger.Logger()
        self.valobj = valobj

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            m_Data = self.valobj.GetChildMemberWithName('m_Data')
            self.m_pElements = m_Data.GetChildMemberWithName('m_pElements')
            self.m_StaticData = m_Data.GetChildAtIndex(1).GetChildAtIndex(0)
            self.m_uiCount = m_Data.GetChildMemberWithName('m_uiCount')
            self.m_uiCapacity = m_Data.GetChildMemberWithName('m_uiCapacity')
            self.m_pAllocator = m_Data.GetChildMemberWithName('m_pAllocator')
            self.local_storage_size = self.m_StaticData.GetType().GetByteSize()
        except Exception as inst:
            logger >> "ezHybridStringSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        return 3

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            if index == 0:
                count = self.m_uiCount.GetValueAsUnsigned(0)
                # Detect if string is probably broken (uninitialized)
                if count > 0x10000000:
                    count = 0
                if count <= self.local_storage_size:
                    return self.m_StaticData.CreateValueFromData('contents', self.m_StaticData.GetData(), self.m_pElements.GetType().GetPointeeType().GetArrayType(count))
                else:
                    return self.m_pElements.CreateValueFromData('contents', self.m_pElements.GetPointeeData(0, count), self.m_pElements.GetType().GetPointeeType().GetArrayType(count))
            elif index == 1:
                return self.m_uiCount
            elif index == 2:
                return self.m_pAllocator
        except Exception as inst:
            logger >> "ezHybridStringSynthProvider.get_child_at_index: " + str(inst)
            return None

def ezHybridString_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        content = valobj.GetChildAtIndex(0)
        count = valobj.GetChildAtIndex(1).GetValueAsUnsigned(0)
        # Detect if string is probably broken (uninitialized)
        if count > 0x10000000:
            count = 0
        if count == 0:
            return "<empty>"
        if count > 1024:
            count = 1024
        return '"' + make_string(content) + '"'
    except Exception as inst:
        logger >> "ezHybridString_SummaryProvider: " + str(inst)
        return "<error>"

class ezStringViewSynthProvider:
    def __init__(self, valobj, dict):
        logger = lldb.formatters.Logger.Logger()
        self.valobj = valobj

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        self.valid = False
        try:
            self.m_pStart = self.valobj.GetChildMemberWithName('m_pStart')
            self.m_uiElementCount = self.valobj.GetChildMemberWithName('m_uiElementCount')

            start = self.m_pStart.GetValueAsUnsigned(0)
            count = self.m_uiElementCount.GetValueAsUnsigned(0)
            if start == 0 or count == 0:
                self.valid = False
            else:
                self.valid = True
                self.count = count
            
        except Exception as inst:
            logger >> "ezStringViewSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        return 1

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        if not self.valid:
            return None

        try:
            count = min(self.count, 256)
            return self.m_pStart.CreateValueFromData('contents', self.m_pStart.GetPointeeData(0, count), self.m_pStart.GetType().GetPointeeType().GetArrayType(count))
        except Exception as inst:
            logger >> "ezStringViewSynthProvider.get_child_at_index: " + str(inst)
            return None

def ezStringView_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        content = valobj.GetChildAtIndex(0)
        # Check if content is empty
        if content.IsValid() == False:
            return "<empty>"
        return '"' + make_string(content) + '"'
    except Exception as inst:
        logger >> "ezStringView_SummaryProvider: " + str(inst)
        return "<error>"

class ezHashedStringSynthProvider:
    def __init__(self, valobj, dict):
        logger = lldb.formatters.Logger.Logger()
        self.valobj = valobj

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        self.valid = False
        try:
            self.m_Data = self.valobj.GetChildMemberWithName('m_Data')
            self.m_pElement = self.m_Data.GetChildMemberWithName('m_pElement')
            self.m_Key = self.m_pElement.GetChildMemberWithName('m_Key')
            self.m_Value = self.m_pElement.GetChildMemberWithName('m_Value')
            self.m_sString = self.m_Value.GetChildMemberWithName('m_sString')
            self.valid = True

        except Exception as inst:
            logger >> "ezHashedStringSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        return 2

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()

        if not self.valid:
            return None

        try:
            if index == 0:
                return self.m_sString
            elif index == 1:
                return self.m_Key
        except Exception as inst:
            logger >> "ezHashedStringSynthProvider.get_child_at_index: " + str(inst)
            return None

def ezHashedString_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        content = valobj.GetChildAtIndex(0)
        return ezHybridString_SummaryProvider(content, dict)
    except Exception as inst:
        logger >> "ezHashedString_SummaryProvider: " + str(inst)
        return "<error>"

def ezStringIterator_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        m_pCurPtr = valobj.GetChildMemberWithName("m_pCurPtr")
        m_pEndPtr = valobj.GetChildMemberWithName("m_pEndPtr")
        curr = m_pCurPtr.GetValueAsUnsigned(0)
        end = m_pEndPtr.GetValueAsUnsigned(0)
        size = min(end - curr, 4) # We need up to 4 bytes to decode one utf8 character
        bytes = m_pCurPtr.GetPointeeData(0, size)
        if size == 0:
            return "<empty>"
        
        for i in range(1, size):
            # Check if the next byte marks the start of a new UTF-8 character
            if (bytes.uint8s[i] & 0xC0) != 0x80:
                size = i
                break
  
        data = bytearray(bytes.uint8s[:size])
        if size > 0:
            char = data.decode('utf-8')[0]
            return f"'{char}'"

    except Exception as inst:
        logger >> "ezStringIterator_SummaryProvider: " + str(inst)
        return "<error>"
    
#endregion

#region Containers
class ArraySynthProvider:
    def __init__(self, valobj, dict):
        self.valobj = valobj

    def set_fields(self, names):
        self.names = names
        self.fields = []
        for name in self.names:
            member = self.valobj.GetChildMemberWithName(name)
            self.fields.append(member)
        
    def get_field_count(self):
        return self.fields.__len__()

    def get_field(self, index):
        return self.fields[index]
    
    def get_array_size(self, countField):
        count = countField.GetValueAsUnsigned(0)
        # Clamp the count to a maximum of 256 elements for performance reasons
        return min(count, 256)
        
    def get_array_element(self, elementsField, elementType, elementSize, index):
        offset = index * elementSize
        return elementsField.CreateChildAtOffset('[' + str(index) + ']', offset, elementType)
        
    def get_array_element_with_fake_index(self, elementsField, elementType, elementSize, index, fakeIndex):
        offset = index * elementSize
        return elementsField.CreateChildAtOffset('[' + str(fakeIndex) + ']', offset, elementType)

        
class ezDynamicArrayBaseSynthProvider(ArraySynthProvider):
    def __init__(self, valobj, dict):
         super().__init__(valobj, dict)

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            super().set_fields(['m_uiCount', 'm_uiCapacity', 'm_pAllocator'])
            self.m_pElements = self.valobj.GetChildMemberWithName('m_pElements')
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.element_type = self.m_pElements.GetType().GetPointeeType()
            self.element_size = self.element_type.GetByteSize()
        except Exception as inst:
            logger >> "ezDynamicArrayBaseSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            return super().get_array_size(self.m_uiCount) + super().get_field_count()
        except Exception as inst:
            logger >> "ezDynamicArrayBaseSynthProvider.num_children: " + str(inst)
            return 0

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            fields = super().get_field_count()
            if index < fields:
                return super().get_field(index)
            
            return super().get_array_element(self.m_pElements, self.element_type, self.element_size, index - fields)
        except Exception as inst:
            logger >> "ezDynamicArrayBaseSynthProvider.get_child_at_index: " + str(inst)
            return None

class ezSmallArraySynthProvider(ArraySynthProvider):
    def __init__(self, valobj, dict):
        super().__init__(valobj, dict)

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            super().set_fields(['m_uiCount', 'm_uiCapacity', 'm_uiUserData'])
            self.m_pElements = self.valobj.GetChildAtIndex(0).GetChildAtIndex(3).GetChildAtIndex(1)
            self.m_StaticData = self.valobj.GetChildAtIndex(0).GetChildAtIndex(3).GetChildAtIndex(0).GetChildAtIndex(0)
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.m_uiCapacity = self.valobj.GetChildMemberWithName('m_uiCapacity')
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)
            self.element_size = self.element_type.GetByteSize()
            self.local_storage_size = self.m_StaticData.GetType().GetByteSize() // self.element_size
        except Exception as inst:
            logger >> "ezSmallArraySynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            return super().get_array_size(self.m_uiCount) + super().get_field_count()
        except Exception as inst:
            logger >> "ezSmallArraySynthProvider.num_children: " + str(inst)
            return 0

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            fields = super().get_field_count()
            if index < fields:
                return super().get_field(index)
                
            if self.m_uiCapacity.GetValueAsUnsigned(0) <= self.local_storage_size:
                return super().get_array_element(self.m_StaticData, self.element_type, self.element_size, index - fields)
            else:
                return super().get_array_element(self.m_pElements, self.element_type, self.element_size, index - fields)
        except Exception as inst:
            logger >> "ezSmallArraySynthProvider.get_child_at_index: " + str(inst)
            return None
        
class ezStaticArraySynthProvider(ArraySynthProvider):
    def __init__(self, valobj, dict):
        super().__init__(valobj, dict)

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            super().set_fields(['m_uiCount', 'm_uiCapacity'])
            self.m_Data = self.valobj.GetChildAtIndex(1).GetChildAtIndex(0)
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)
            self.element_size = self.element_type.GetByteSize()
        except Exception as inst:
            logger >> "ezStaticArraySynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            return super().get_array_size(self.m_uiCount) + super().get_field_count()
        except Exception as inst:
            logger >> "ezStaticArraySynthProvider.num_children: " + str(inst)
            return 0

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            fields = super().get_field_count()
            if index < fields:
                return super().get_field(index)
                
            return super().get_array_element(self.m_Data, self.element_type, self.element_size, index - fields)
        except Exception as inst:
            logger >> "ezStaticArraySynthProvider.get_child_at_index: " + str(inst)
            return None

class ezStaticRingBufferSynthProvider(ArraySynthProvider):
    def __init__(self, valobj, dict):
        super().__init__(valobj, dict)

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            super().set_fields(['m_uiCount', 'm_uiFirstElement'])
            self.m_pElements = self.valobj.GetChildMemberWithName('m_pElements')
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.m_uiFirstElement = self.valobj.GetChildMemberWithName('m_uiFirstElement')
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)
            self.element_size = self.element_type.GetByteSize()

            self.m_StaticData = self.valobj.GetChildAtIndex(0).GetChildAtIndex(0)
            self.local_storage_size = self.m_StaticData.GetType().GetByteSize() // self.element_size
        except Exception as inst:
            logger >> "ezStaticRingBufferSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            return super().get_array_size(self.m_uiCount) + super().get_field_count()
        except Exception as inst:
            logger >> "ezStaticRingBufferSynthProvider.update: " + str(inst)
            return 0

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            fields = super().get_field_count()
            if index < fields:
                return super().get_field(index)
            
            index = index - fields
            firstElement = self.m_uiFirstElement.GetValueAsUnsigned(0)
            actualIndex = (firstElement + index) % self.local_storage_size
            offset = actualIndex * self.element_size
            return super().get_array_element_with_fake_index(self.m_pElements, self.element_type, self.element_size, actualIndex, index)
        except Exception as inst:
            logger >> "ezStaticRingBufferSynthProvider.get_child_at_index: " + str(inst)
            return None

class ezArrayPtrSynthProvider(ArraySynthProvider):
    def __init__(self, valobj, dict):
        super().__init__(valobj, dict)

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            super().set_fields(['m_uiCount'])
            self.m_pPtr = self.valobj.GetChildMemberWithName('m_pPtr')
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)
            self.element_size = self.element_type.GetByteSize()
        except Exception as inst:
            logger >> "ezArrayPtrSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            return super().get_array_size(self.m_uiCount) + super().get_field_count()
        except Exception as inst:
            logger >> "ezArrayPtrSynthProvider.num_children: " + str(inst)
            return 0

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            fields = super().get_field_count()
            if index < fields:
                return super().get_field(index)
                
            return super().get_array_element(self.m_pPtr, self.element_type, self.element_size, index - fields)
        except Exception as inst:
            logger >> "ezArrayPtrSynthProvider.get_child_at_index: " + str(inst)
            return None
    
class ezHashTableBaseSynthProvider(ArraySynthProvider):
    def __init__(self, valobj, dict):
        super().__init__(valobj, dict)

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            super().set_fields(['m_uiCount', 'm_uiCapacity', 'm_pAllocator'])
            self.m_pEntries = self.valobj.GetChildMemberWithName('m_pEntries')
            self.m_pEntryFlags = self.valobj.GetChildMemberWithName('m_pEntryFlags')
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.m_uiCapacity = self.valobj.GetChildMemberWithName('m_uiCapacity')
            self.element_type = self.m_pEntries.GetType().GetPointeeType()
            self.element_size = self.element_type.GetByteSize()
            self.flags_type = self.m_pEntryFlags.GetType().GetPointeeType()
            self.flags_size = self.flags_type.GetByteSize()
            # reading the data through the debugger can take a long time
            # Limit the loops to this number of iterations
            self.maxSteps = 255 
            self.compactedEntries = []
            capacity = self.m_uiCapacity.GetValueAsUnsigned(0)
            fakeIndex = 0
            for index in range(0, capacity):
                flags = super().get_array_element(self.m_pEntryFlags, self.flags_type, self.flags_size, index // 16)
                flags_value = flags.GetValueAsUnsigned(0)
                flags_value = flags_value >> ((index & 15) * 2) & 3
                isvalid = (flags_value & 0x01) == 0x01
                if isvalid:
                    self.compactedEntries.append(super().get_array_element_with_fake_index(self.m_pEntries, self.element_type, self.element_size, index, fakeIndex))
                    fakeIndex += 1
                if fakeIndex >= self.maxSteps:
                    break  # Limit the number of entries to avoid performance issues in the debugger

        except Exception as inst:
            logger >> "ezHashTableBaseSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            return super().get_array_size(self.m_uiCount) + super().get_field_count()
        except Exception as inst:
            logger >> "ezHashTableBaseSynthProvider.num_children: " + str(inst)
            return 0

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            fields = super().get_field_count()
            if index < fields:
                return super().get_field(index)
                
            index = index - fields
            return self.compactedEntries[index]
        except Exception as inst:
            logger >> "ezHashTableBaseSynthProvider.get_child_at_index: " + str(inst)
            return None

class ezListSynthProvider:
    def __init__(self, valobj, dict):
        logger = lldb.formatters.Logger.Logger()
        self.valobj = valobj

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)

            current = self.valobj.GetChildMemberWithName('m_First').GetChildMemberWithName('m_pNext')
            count = self.m_uiCount.GetValueAsUnsigned(0)

            self.compactedEntries = []
            for index in range(0, count):
                value = current.GetChildMemberWithName('m_Data')
                self.compactedEntries.append(value)
                current = current.GetChildMemberWithName('m_pNext')

        except Exception as inst:
            logger >> "ezListSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            numElements = self.m_uiCount.GetValueAsUnsigned(0)
            return numElements + 1
        except Exception as inst:
            logger >> "ezListSynthProvider.num_children: " + str(inst)
            return 0
    
    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            if index < 1:
                return self.m_uiCount

            index = index - 1
            return self.compactedEntries[index].CreateChildAtOffset('[' + str(index) + ']', 0, self.element_type)
        except Exception as inst:
            logger >> "ezListSynthProvider.get_child_at_index: " + str(inst)
            return None

class ezDequeSynthProvider(ArraySynthProvider):
    def __init__(self, valobj, dict):
        super().__init__(valobj, dict)

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            super().set_fields(['m_uiCount', 'm_pAllocator'])
            self.m_pChunks = self.valobj.GetChildMemberWithName('m_pChunks')
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.first_element = self.valobj.GetChildMemberWithName('m_uiFirstElement').GetValueAsUnsigned(0)
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)
            self.element_size = self.element_type.GetByteSize()

            self.chunk_type = self.m_pChunks.GetType().GetPointeeType()
            self.chunk_pointer_size = self.chunk_type.GetByteSize()

            self.m_uiChunkSize = self.valobj.GetChildMemberWithName('m_uiChunkSize')
            self.chunk_size = self.m_uiChunkSize.GetValueAsUnsigned(0)
            if (4096 // self.element_size) < 32:
                self.chunk_size = 32
            else:
                self.chunk_size = 4096 // self.element_size
            
        except Exception as inst:
            logger >> "ezDequeSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            return super().get_array_size(self.m_uiCount) + super().get_field_count()
        except Exception as inst:
            logger >> "ezDequeSynthProvider.num_children: " + str(inst)
            return 0

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            fields = super().get_field_count()
            if index < fields:
                return super().get_field(index)
            
            index = index - fields
            realIndex = self.first_element + index
            chunkIndex = realIndex // self.chunk_size
            chunkOffset = realIndex % self.chunk_size
            chunk = super().get_array_element(self.m_pChunks, self.chunk_type, self.chunk_pointer_size, chunkIndex)
            element = super().get_array_element_with_fake_index(chunk, self.element_type, self.element_size, chunkOffset, index)
            return element
        except Exception as inst:
            logger >> "ezDequeSynthProvider.get_child_at_index: " + str(inst)
            return None

class ezMapSynthProvider:
    def __init__(self, valobj, dict):
        logger = lldb.formatters.Logger.Logger()
        self.valobj = valobj
        # reading the data through the debugger can take a long time
        # Limit the loops to this number of iterations
        self.maxSteps = 1000 
        self.lastNodeIndex = -2
        self.lastNode = None

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            self.lastNodeIndex = -2
            self.lastNode = None
            self.m_uiCount = self.valobj.GetChildMemberWithName('m_uiCount')
            self.m_pRoot = self.valobj.GetChildMemberWithName('m_pRoot')
            self.m_NilNodeAddr = self.valobj.GetChildMemberWithName('m_NilNode').GetLoadAddress()
            self.element_type = self.m_pRoot.GetType().GetPointeeType()
            self.element_size = self.element_type.GetByteSize()
        except Exception as inst:
            logger >> "ezMapSynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            numElements = self.m_uiCount.GetValueAsUnsigned(0)
            if numElements > 0xff000000:
                return 1
            numElements = min(numElements, 256)
            return numElements + 1
        except Exception as inst:
            logger >> "ezMapSynthProvider.num_children: " + str(inst)
            return 0

    def GetLink(self, node, index):
        return node.Dereference().GetChildMemberWithName('m_pLink').GetChildAtIndex(index)

    def GetParent(self, node):
        return node.Dereference().GetChildMemberWithName('m_pParent')

    def GetLeftMost(self):
        node = self.m_pRoot
        steps = self.maxSteps

        while self.GetLink(node, 0).GetValueAsUnsigned() != self.m_NilNodeAddr and steps > 0:
            node = self.GetLink(node, 0)
            steps = steps -1

        if steps == 0:
            return None

        return node

    def NextNode(self, node):
        rightNode = self.GetLink(node, 1)

        steps = self.maxSteps

        # if this element has a right child, go there and then search for the left most child of that
        if rightNode.GetValueAsUnsigned() != self.GetLink(rightNode, 1).GetValueAsUnsigned():
            node = rightNode

            while self.GetLink(node, 0).GetValueAsUnsigned() != self.GetLink(self.GetLink(node, 0), 0).GetValueAsUnsigned() and steps > 0:
                node = self.GetLink(node, 0)
                steps = steps - 1

            if steps == 0:
                return None

            return node

        parent = self.GetParent(node)
        parentParent = self.GetParent(parent)

        # if this element has a parent and this element is that parents left child, go directly to the parent
        if parent.GetValueAsUnsigned() != parentParent.GetValueAsUnsigned() and self.GetLink(parent, 0).GetValueAsUnsigned() == node.GetValueAsUnsigned():
            return parent

        # if this element has a parent and this element is that parents right child, search for the next parent, whose left child this is
        if parent.GetValueAsUnsigned() != parentParent.GetValueAsUnsigned() and self.GetLink(parent, 1).GetValueAsUnsigned() == node.GetValueAsUnsigned():
            while self.GetLink(self.GetParent(node), 1).GetValueAsUnsigned() == node.GetValueAsUnsigned() and steps > 0:
                node = self.GetParent(node)
                steps = steps - 1

            if steps == 0:
                return None

            # if we are the root node
            parent = self.GetParent(node)
            if (parent.GetValueAsUnsigned() == 0) or (parent.GetValueAsUnsigned() == self.GetParent(parent).GetValueAsUnsigned()):
                return None

            return parent

        return None   

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            if index < 1:
                if index == 0:
                    return self.m_uiCount
            else:
                index = index - 1

            if index >= self.num_children():
                return None
            node = self.GetLeftMost()
            stepsLeft = index

            # Can we re-use the last cached result?
            if index == self.lastNodeIndex + 1:
                node = self.lastNode
                stepsLeft = 1

            while node and stepsLeft > 0:
                node = self.NextNode(node)
                stepsLeft = stepsLeft - 1

            if node:
                self.lastNode = node
                self.lastNodeIndex = index
                return node.CreateChildAtOffset('[' + str(index) + ']', 0, node.GetType().GetPointeeType())

            return None

        except Exception as inst:
            logger >> "ezMapSynthProvider.get_child_at_index: " + str(inst)
            return None

#endregion

#region Enums and Bitflags

class ezEnumSynthProvider:
    def __init__(self, valobj, dict):
        self.valobj = valobj


    def update(self):
        self.value = "?"
        logger = lldb.formatters.Logger.Logger()
        try:
            enum_name = self.valobj.GetType().GetTemplateArgumentType(0).GetName() + "::Enum"
            enum_type = self.valobj.GetTarget().FindTypes(enum_name).GetTypeAtIndex(0)
            value = self.valobj.GetChildMemberWithName("m_Value").GetValueAsUnsigned()
            self.value = "? ({})".format(value)
            for v in enum_type.GetEnumMembers():
                if value == v.GetValueAsUnsigned():
                    self.value = "{} ({})".format(v.GetName(), v.GetValueAsUnsigned())
                    break
        except Exception as inst:
            logger >> "ezEnumSynthProvider.update: " + str(inst)
        return False

    def num_children(self):
        return 1

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            return self.valobj.CreateValueFromExpression('Value', '"' + self.value + '"')
        except Exception as inst:
            logger >> "ezEnumSynthProvider.get_child_at_index: " + str(inst)
            return None

def ezEnum_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        content = valobj.GetChildAtIndex(0)
        return make_string(content)
    except Exception as inst:
        logger >> "ezEnum_SummaryProvider: " + str(inst)
        return "<error>"

def ezBitflags_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        content = valobj.GetChildAtIndex(0).GetChildAtIndex(0)
        type = valobj.GetType().GetTemplateArgumentType(0)
        enum_name = type.GetName() + "::Enum"
        enum_type = valobj.GetTarget().FindTypes(enum_name).GetTypeAtIndex(0)

        value = content.GetValueAsUnsigned(0)
        flags_list = []
        for v in enum_type.GetEnumMembers():
            bit_value = v.GetValueAsUnsigned()
            # Skip if none or more than one bit is set (must be a power of 2 to have exactly one bit)
            if bit_value == 0 or (bit_value & (bit_value - 1)) != 0:
                continue
            if value & bit_value:
                flags_list.append(v.GetName())     

        if not flags_list:
            return "None (0)"
        return " | ".join(flags_list) + f" ({value})"
    except Exception as inst:
        logger >> "ezBitflags_SummaryProvider: " + str(inst)
        return "<error>"
    
#endregion

#region Basic Types

def ezAngle_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        m_fRadian = valobj.GetChildAtIndex(0)
        radian_value = float(m_fRadian.GetValue())

        degree_value = radian_value * 180.0 / 3.14159265358979323846
        return f"{{ Degree={degree_value:.2f}° }}"
    except Exception as inst:
        logger >> "ezAngle_SummaryProvider: " + str(inst)
        return "<error>"
    
def ezUuid_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        m_uiHigh = valobj.GetChildAtIndex(0)
        m_uiLow = valobj.GetChildAtIndex(1)
        m_uiHighValue = m_uiHigh.GetValueAsUnsigned(0)
        m_uiLowValue = m_uiLow.GetValueAsUnsigned(0)

        high_bytes = m_uiHighValue.to_bytes(8, byteorder='little')
        low_bytes = m_uiLowValue.to_bytes(8, byteorder='little')
        time_low = int.from_bytes(high_bytes[0:4], byteorder='little')
        time_mid = int.from_bytes(high_bytes[4:6], byteorder='little')
        time_hi_version = int.from_bytes(high_bytes[6:8], byteorder='little')
        clock_seq = int.from_bytes(low_bytes[0:2], byteorder='big')
        node = int.from_bytes(low_bytes[2:8], byteorder='big')

        uuid_str = f"{time_low:08x}-{time_mid:04x}-{time_hi_version:04x}-{clock_seq:04x}-{node:012x}"
        return uuid_str
        
    except Exception as inst:
        logger >> "ezUuid_SummaryProvider: " + str(inst)
        return "<error>"

class ezMat3SynthProvider:
    def __init__(self, valobj, dict):
        self.valobj = valobj

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            self.m_fElementsCM = self.valobj.GetChildMemberWithName('m_fElementsCM')
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)
            self.element_size = self.element_type.GetByteSize()
            
        except Exception as inst:
            logger >> "ezMat3SynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        return 4

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            if index == 0:
                expr = f"(ezVec3*)" +str(self.m_fElementsCM.GetAddress())
                Column0 = self.valobj.CreateValueFromExpression('Column0', expr)
                return Column0
            if index == 1:
                address = self.m_fElementsCM.GetAddress()
                address.OffsetAddress(self.element_size * 3)
                expr = f"(ezVec3*)" +str(address)
                Column1 = self.valobj.CreateValueFromExpression('Column1', expr)
                return Column1
            if index == 2:
                address = self.m_fElementsCM.GetAddress()
                address.OffsetAddress(self.element_size * 6)
                expr = f"(ezVec3*)" +str(address)
                Column2 = self.valobj.CreateValueFromExpression('Column2', expr)
                return Column2
            if index == 3:
                return self.m_fElementsCM
        except Exception as inst:
            logger >> "ezMat3SynthProvider.get_child_at_index: " + str(inst)
            return None
        
class ezMat4SynthProvider:
    def __init__(self, valobj, dict):
        self.valobj = valobj

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            self.m_fElementsCM = self.valobj.GetChildMemberWithName('m_fElementsCM')
            self.element_type = self.valobj.GetType().GetTemplateArgumentType(0)
            self.element_size = self.element_type.GetByteSize()
            
        except Exception as inst:
            logger >> "ezMat4SynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        return 5

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            if index == 0:
                expr = f"(ezVec4*)" +str(self.m_fElementsCM.GetAddress())
                Column0 = self.valobj.CreateValueFromExpression('Column0', expr)
                return Column0
            if index == 1:
                address = self.m_fElementsCM.GetAddress()
                address.OffsetAddress(self.element_size * 4)
                expr = f"(ezVec4*)" +str(address)
                Column1 = self.valobj.CreateValueFromExpression('Column1', expr)
                return Column1
            if index == 2:
                address = self.m_fElementsCM.GetAddress()
                address.OffsetAddress(self.element_size * 8)
                expr = f"(ezVec4*)" +str(address)
                Column2 = self.valobj.CreateValueFromExpression('Column2', expr)
                return Column2
            if index == 3:
                address = self.m_fElementsCM.GetAddress()
                address.OffsetAddress(self.element_size * 12)
                expr = f"(ezVec4*)" +str(address)
                Column3 = self.valobj.CreateValueFromExpression('Column3', expr)
                return Column3
            if index == 4:
                return self.m_fElementsCM
        except Exception as inst:
            logger >> "ezMat4SynthProvider.get_child_at_index: " + str(inst)
            return None

class ezVariantSynthProvider:

    variantMap = {}
    variantTargetTypeMap = {}

    def __init__(self, valobj, dict):
        self.valobj = valobj
        if not ezVariantSynthProvider.variantMap:
            enum_type = self.valobj.GetTarget().FindTypes("ezVariantType::Enum").GetTypeAtIndex(0)
            for v in enum_type.GetEnumMembers():
                bit_value = v.GetValueAsUnsigned()
                ezVariantSynthProvider.variantMap[bit_value] = v.GetName()
            
            ezVariantSynthProvider.variantTargetTypeMap["Bool"] = "bool"
            ezVariantSynthProvider.variantTargetTypeMap["Int8"] = "ezInt8"
            ezVariantSynthProvider.variantTargetTypeMap["UInt8"] = "ezUInt8"
            ezVariantSynthProvider.variantTargetTypeMap["Int16"] = "ezInt16"
            ezVariantSynthProvider.variantTargetTypeMap["UInt16"] = "ezUInt16"
            ezVariantSynthProvider.variantTargetTypeMap["Int32"] = "ezInt32"
            ezVariantSynthProvider.variantTargetTypeMap["UInt32"] = "ezUInt32"
            ezVariantSynthProvider.variantTargetTypeMap["Int64"] = "ezInt64"
            ezVariantSynthProvider.variantTargetTypeMap["UInt64"] = "ezUInt64"
            ezVariantSynthProvider.variantTargetTypeMap["Float"] = "float"
            ezVariantSynthProvider.variantTargetTypeMap["Double"] = "double"
            ezVariantSynthProvider.variantTargetTypeMap["Color"] = "ezColor"
            ezVariantSynthProvider.variantTargetTypeMap["Vector2"] = "ezVec2"
            ezVariantSynthProvider.variantTargetTypeMap["Vector3"] = "ezVec3"
            ezVariantSynthProvider.variantTargetTypeMap["Vector4"] = "ezVec4"
            ezVariantSynthProvider.variantTargetTypeMap["Vector2I"] = "ezVec2I32"
            ezVariantSynthProvider.variantTargetTypeMap["Vector3I"] = "ezVec3I32"
            ezVariantSynthProvider.variantTargetTypeMap["Vector4I"] = "ezVec4I32"
            ezVariantSynthProvider.variantTargetTypeMap["Vector2U"] = "ezVec2U32"
            ezVariantSynthProvider.variantTargetTypeMap["Vector3U"] = "ezVec3U32"
            ezVariantSynthProvider.variantTargetTypeMap["Vector4U"] = "ezVec4U32"
            ezVariantSynthProvider.variantTargetTypeMap["Quaternion"] = "ezQuat"
            ezVariantSynthProvider.variantTargetTypeMap["Matrix3"] = "ezMat3"
            ezVariantSynthProvider.variantTargetTypeMap["Matrix4"] = "ezMat4"
            ezVariantSynthProvider.variantTargetTypeMap["Transform"] = "ezTransform"
            ezVariantSynthProvider.variantTargetTypeMap["String"] = "ezString"
            ezVariantSynthProvider.variantTargetTypeMap["StringView"] = "ezStringView"
            ezVariantSynthProvider.variantTargetTypeMap["DataBuffer"] = "ezDataBuffer"
            ezVariantSynthProvider.variantTargetTypeMap["Time"] = "ezTime"
            ezVariantSynthProvider.variantTargetTypeMap["Uuid"] = "ezUuid"
            ezVariantSynthProvider.variantTargetTypeMap["Angle"] = "ezAngle"
            ezVariantSynthProvider.variantTargetTypeMap["ColorGamma"] = "ezColorGammaUB"
            ezVariantSynthProvider.variantTargetTypeMap["HashedString"] = "ezHashedString"
            ezVariantSynthProvider.variantTargetTypeMap["TempHashedString"] = "ezTempHashedString"
            ezVariantSynthProvider.variantTargetTypeMap["VariantArray"] = "ezVariantArray"
            ezVariantSynthProvider.variantTargetTypeMap["VariantDictionary"] = "ezVariantDictionary"
            ezVariantSynthProvider.variantTargetTypeMap["TypedPointer"] = "ezTypedPointer"

    def update(self):
        logger = lldb.formatters.Logger.Logger()
        try:
            self.m_Data = self.valobj.GetChildMemberWithName('m_Data')
            self.m_Ptr = self.m_Data.EvaluateExpression('shared->m_Ptr')
            self.m_sharedType = self.m_Data.EvaluateExpression('shared->m_pType')
            self.m_inlineType = self.m_Data.EvaluateExpression('inlined.m_pType')
            self.m_uiType = self.valobj.GetChildMemberWithName('m_uiType')
            self.m_bIsShared = self.valobj.GetChildMemberWithName('m_bIsShared')
            
        except Exception as inst:
            logger >> "ezMat4SynthProvider.update: " + str(inst)

        return False

    def num_children(self):
        return 3

    def get_child_at_index(self, index):
        logger = lldb.formatters.Logger.Logger()
        try:
            if index == 0:
                typeValue = self.m_uiType.GetValueAsUnsigned(0)
                return self.valobj.CreateValueFromExpression('Type', f"(ezVariantType::Enum) {typeValue}")
                return self.m_uiType
            if index == 1:
                typeValue = self.m_uiType.GetValueAsUnsigned(0)
                isShared = self.m_bIsShared.GetValueAsUnsigned(0)
                # Choose the correct data source based on isShared
                if isShared != 0:
                    address = self.m_Ptr.GetValueAsUnsigned()
                else:
                    address = self.m_Data.GetAddress()
                # Check if we can map the typeValue to a type name
                if typeValue in ezVariantSynthProvider.variantMap:
                    typeName = ezVariantSynthProvider.variantMap[typeValue]
                    if typeName in ezVariantSynthProvider.variantTargetTypeMap:
                        targetType = ezVariantSynthProvider.variantTargetTypeMap[typeName]
                        expr = f"*reinterpret_cast<{targetType}*>({address})"
                        return self.valobj.CreateValueFromExpression('Value', expr)

                if 'Invalid' == ezVariantSynthProvider.variantMap[typeValue]:
                    return self.valobj.CreateValueFromExpression('Invalid', 'nullptr')
                
                if 'TypedObject' == ezVariantSynthProvider.variantMap[typeValue]:
                    # For TypedObject, we extract the name of the RTTI type and build an expression to cast to it
                    if isShared != 0:
                        rtti = self.m_sharedType
                    else:
                        rtti = self.m_inlineType
                    typeName = rtti.GetChildMemberWithName('m_sTypeName')
                    typeNameStr = str(typeName.GetSummary()).replace('"', '') # A bit hacky, it depends on the ezStringView summary provider
                    expr = f"({typeNameStr}*){address}"
                    return self.valobj.CreateValueFromExpression('Value', expr)

                return self.m_Data
            if index == 2:
                return self.m_bIsShared
        except Exception as inst:
            logger >> "ezVariantSynthProvider.get_child_at_index: " + str(inst)
            return None
        
def ezVariant_SummaryProvider(valobj, dict):
    logger = lldb.formatters.Logger.Logger()
    try:
        type = valobj.GetChildAtIndex(0).GetValue()
        value = valobj.GetChildAtIndex(1)
        valueSummary = value.GetSummary()
        valueValue = value.GetValue()
        summaryString = f"({type}) "
        if valueSummary is not None and valueSummary != "":
            summaryString += valueSummary
        elif valueValue is not None and valueValue != "":
            summaryString += valueValue
        return summaryString
    except Exception as inst:
        logger >> "ezVariant_SummaryProvider: " + str(inst)
        return "<error>"
    
#endregion