Profile Viewport 2.0 rendering events

Resource events

Events related to managing render targets (where the scene is rendered to) are listed below.

Note that this includes events related to managing custom off-screen targets allocated via the API (MRenderTarget). On-screen targets are not MRenderTargets.

• Vp2AcquireOffScreenTarget : Acquire offscreen buffer into which to render
• Vp2AcquireOnScreenTarget : Acquire onscreen buffer
• Vp2CloneOffScreenTarget : Make a copy of an offscreen buffer
• Vp2ReleaseTarget : Release offsceen buffer to buffer pool
• Vp2ResizeTarget : Resize a target. May involve reallocation
• Vp2MapToSystemMemory : Map a hardware target to system (CPU) raster
• Vp2CacheSystemRaster : Copy contents of target to system raster
• Vp2SaveCacheToDisk : Save system raster to disk file
• Vp2CopyRaster : Make a copy of a system raster
• Vp2BlitTargetToImage : Blit a target to a system image
• Vp2BlitTargetToGL : Blit a target to OpenGL context
• Vp2ReleaseTargetToCache : Release target from buffer cache
• Vp2BlitDepthTargetToBuffer : Blit a depth target to a system image

Events related to managing textures are listed below. Note that this includes events related to textures acquired via the API (MTextureManager/MTexture).

• Vp2AcquireFileTexture : Acquire a texture from a file on disk
• Vp2AcquireDataTexture : Acquire a texture from CPU data
• Vp2SaveTexture : Save a texture to disk
• Vp2RawTextureData : Copy GPU texture data to CPU data
• Vp2UpdateTexture : Update a GPU texture in-place

Update phase

The following is a breakdown of some of the main update events. They are listed by functional area and/or scope.

• Scene Level : Vp2UpdateScene is the main scene level update event
• Evaluator Level:
  • Vp2UpdateGeometry : DG evaluation for geometry shapes
  • Vp2UpdateDagObject : DG evaluation for DAG objects
  • Vp2TranslateGeometry : Convert DG geometry data into a renderable form, and add any missing geometry streams (for example, generate surface normals)
  • Vp2UpdateGeometryBuffer : Geometry buffer update
• Shader Level:
  • Vp2ShaderDoDG : DG evaluation for shaders
  • Vp2ShaderItemCompileShader : Shader compilation
  • Vp2ConstructFragmentGraph: Shader construction from fragment graph
  • Vp2ShaderWrite : Shader parameter update
  • Vp2AssignShaderInstance: Shader instance assignment to a render item

The above events generally occur before UI drawables or render items are processed. The main Profiler events associated with UI drawables lists and render lists are:

• Vp2UpdateUI: Build UI drawables. This is done every refresh.
• Vp2BuildRenderLists: Final categorization and filtering of render items before rendering. Will take UI drawables as input as well as render items created by node evaluation. If tracing is enabled via the ogs command, then the trace label to examine the list counts is called Build Render Lists.
• Vp2ClearRenderLists: The render lists that have been built will be flushed during this event, as appropriate.

Rendering

The event that represents a scene render is labelled: Vp2SceneRender.

The event lists can be divided into two: “high” level and “low” level. The “high” level is the functional groupings of the “low” level passes, as well as rendering of lists of UI drawables or render items.