1
// In what way (read, write, etc) was a resource referenced in a frame -// used to determine if initial contents are needed and to what degree.// These values are used both as states (representing the cumulative previous// accesses to the resource), and state transitions (access by a single// command, modifying the state). This state machine is illustrated below,// with states represented in caps, and transitions in lower case.////         +------------------ NONE -----------------------------+//         |                    |                                |//        read            partialWrite                     completeWrite//         |                    |                                |//         V                    V                                V//       READ             PARTIAL_WRITE --completeWrite--> COMPLETE_WRITE//         |                    |//         |                  read//       write                  |//         |                    V//         |            WRITE_BEFORE_READ//         V                    |//  READ_BEFORE_WRITE <--write--+//// Note://  * All resources begin implicitly in the None state.//  * The transitions labeled "write" correspond to either PartialWrite or//    CompleteWrite (e.g. in the READ state, either a PartialWrite or a//    CompleteWrite moves to the READ_BEFORE_WRITE state).//  * The state transitions for ReadBeforeWrite are simply the composition of//    the transition for read, followed by the transition for write (e.g.//    ReadBeforeWrite moves from NONE state to READBEFOREWRITE state);//    similarly, the state transitions for WriteBeforeRead are the composition//    of the transition for write, followed by the transition for read.//  * All other transitions (excluding ReadBeforeWrite and WriteBeforeRead)//    that are not explicitly shown leave the state unchanged (e.g. a read in//    the COMPLETE_WRITE state remains in the COMPLETE_WRITE state).

1
// 清空m_FrameReferencedResources，如果某个资源被写入了，标记为dirtytemplate <typename Configuration>void ResourceManager<Configuration>::ClearReferencedResources(){    SCOPED_LOCK_OPTIONAL(m_Lock, m_Capturing);    for(auto it = m_FrameReferencedResources.begin(); it != m_FrameReferencedResources.end(); ++it)        {            RecordType *record = GetResourceRecord(it->first);            if(record)            {                if(IncludesWrite(it->second))                    MarkDirtyResource(it->first);                record->Delete(this);            }        }    m_FrameReferencedResources.clear();}

1
void GLResourceManager::ContextPrepare_InitialState(GLResource res){    GLInitialContents initContents;    initContents.type = res.Namespace;    ResourceId id = GetID(res);    if(res.Namespace == eResBuffer)    {        // get the length of the buffer        uint32_t length = 4;        GL.glGetNamedBufferParameterivEXT(res.name, eGL_BUFFER_SIZE, (GLint *)&length);        // save old bindings        GLuint oldbuf1 = 0, oldbuf2 = 0;        GL.glGetIntegerv(eGL_COPY_READ_BUFFER_BINDING, (GLint *)&oldbuf1);        GL.glGetIntegerv(eGL_COPY_WRITE_BUFFER_BINDING, (GLint *)&oldbuf2);        // create a new buffer big enough to hold the contents        GLuint buf = 0;        GL.glGenBuffers(1, &buf);        GL.glBindBuffer(eGL_COPY_WRITE_BUFFER, buf);        GL.glNamedBufferDataEXT(buf, (GLsizeiptr)RDCMAX(length, 4U), NULL, eGL_STATIC_READ);        // bind the live buffer for copying        GL.glBindBuffer(eGL_COPY_READ_BUFFER, res.name);        // do the actual copy        if(length > 0)            GL.glCopyBufferSubData(eGL_COPY_READ_BUFFER, eGL_COPY_WRITE_BUFFER, 0, 0, (GLsizeiptr)length);        // workaround for some drivers - mapping/unmapping here seems to help avoid problems mapping        // later.        GL.glMapNamedBufferEXT(buf, eGL_READ_ONLY);        GL.glUnmapNamedBufferEXT(buf);        // restore old bindings        GL.glBindBuffer(eGL_COPY_READ_BUFFER, oldbuf1);        GL.glBindBuffer(eGL_COPY_WRITE_BUFFER, oldbuf2);        initContents.resource = GLResource(res.ContextShareGroup, eResBuffer, buf);        initContents.bufferLength = length;    }    else if(res.Namespace == eResProgram)    {        // ...    }    // else ...

1
void WrappedOpenGL::glBindBuffer(GLenum target, GLuint buffer){    SERIALISE_TIME_CALL(GL.glBindBuffer(target, buffer)); // 真正的GL指令调用    ContextData &cd = GetCtxData();    size_t idx = BufferIdx(target); // 获取到当前逻辑Context中对应target槽位    if(IsActiveCapturing(m_State)) // 如果是处于ActiveCapturing状态下    {        Chunk *chunk = NULL;        if(buffer == 0)        {            cd.m_BufferRecord[idx] = NULL;        }        else        {            // 每个资源都对应一个ResourceRecord对象，这里是获取到新绑定的资源对应的ResourceRecord            cd.m_BufferRecord[idx] = GetResourceManager()->GetResourceRecord(BufferRes(GetCtx(), buffer));            if(cd.m_BufferRecord[idx] == NULL)            {                RDCERR("Called glBindBuffer with unrecognised or deleted buffer");                return;            }        }        {            USE_SCRATCH_SERIALISER();            SCOPED_SERIALISE_CHUNK(gl_CurChunk);            Serialise_glBindBuffer(ser, target, buffer); // 序列化和反序列化都是用这个函数            if(cd.m_BufferRecord[idx])                cd.m_BufferRecord[idx]->datatype = target;            chunk = scope.Get();        }        if(buffer)        {            FrameRefType refType = eFrameRef_Read;            // these targets write to the buffer            if(target == eGL_ATOMIC_COUNTER_BUFFER || target == eGL_COPY_WRITE_BUFFER ||                target == eGL_PIXEL_PACK_BUFFER || target == eGL_SHADER_STORAGE_BUFFER ||                target == eGL_TRANSFORM_FEEDBACK_BUFFER)                refType = eFrameRef_ReadBeforeWrite;            // 这里就是前面提到的，更新资源的引用状态            GetResourceManager()->MarkResourceFrameReferenced(cd.m_BufferRecord[idx]->GetResourceID(),                refType);        }        // binding this buffer mutates VAO state, mark it as written.        if(target == eGL_ELEMENT_ARRAY_BUFFER)        {            GLResourceRecord *varecord = cd.m_VertexArrayRecord;            if(varecord)                GetResourceManager()->MarkVAOReferenced(varecord->Resource, eFrameRef_ReadBeforeWrite);        }

1
template <typename SerialiserType>bool GLResourceManager::Serialise_InitialState(SerialiserType &ser, ResourceId id,GLResourceRecord *record,const GLInitialContents *initial){    m_State = m_Driver->GetState();    GLInitialContents initContents;    if(initial)        initContents = *initial;    SERIALISE_ELEMENT(id).TypedAs("GLResource"_lit).Important();    SERIALISE_ELEMENT_LOCAL(Type, initial->type);    if(IsReplayingAndReading())    {        m_Driver->AddResourceCurChunk(id);    }    if(Type == eResBuffer)    {        GLResource mappedBuffer = GLResource(MakeNullResource);        uint32_t BufferContentsSize = 0;        byte *BufferContents = NULL;        if(ser.IsWriting())        {            mappedBuffer = initial->resource;            BufferContentsSize = initial->bufferLength;            BufferContents = (byte *)GL.glMapNamedBufferEXT(mappedBuffer.name, eGL_READ_ONLY);            if(!BufferContents)                RDCERR("Couldn't map initial contents buffer for readback!");        }        // Serialise this separately so that it can be used on reading to prepare the upload memory        SERIALISE_ELEMENT(BufferContentsSize);        // not using SERIALISE_ELEMENT_ARRAY so we can deliberately avoid allocation - we serialise        // directly into upload memory        ser.Serialise("BufferContents"_lit, BufferContents, BufferContentsSize, SerialiserFlags::NoFlags)            .Important();        if(mappedBuffer.name)            GL.glUnmapNamedBufferEXT(mappedBuffer.name);        SERIALISE_CHECK_READ_ERRORS();    }    // else ...}

1
enum class ActionFlags : uint32_t{NoFlags = 0x0000,// typesClear = 0x0001,Drawcall = 0x0002,Dispatch = 0x0004,MeshDispatch = 0x0008,CmdList = 0x0010,SetMarker = 0x0020,PushMarker = 0x0040,PopMarker = 0x0080,Present = 0x0100,MultiAction = 0x0200,Copy = 0x0400,Resolve = 0x0800,GenMips = 0x1000,PassBoundary = 0x2000,DispatchRay = 0x4000,BuildAccStruct = 0x8000,// flagsIndexed = 0x010000,Instanced = 0x020000,Auto = 0x040000,Indirect = 0x080000,ClearColor = 0x100000,ClearDepthStencil = 0x200000,BeginPass = 0x400000,EndPass = 0x800000,CommandBufferBoundary = 0x1000000,};