Record Class GuiRenderExecutionStats

java.lang.Object
java.lang.Record
com.render.api.gui.GuiRenderExecutionStats
Record Components:
passId - monotonically increasing GUI-pass identifier
copies - submitted texture or shader copy operations
effectPasses - submitted filter, mask, or layer-composite draw passes
targetAcquisitions - successful transient target leases
reusedTargets - leases served by existing targets
allocatedTargetBytes - bytes of targets created during the pass
residentTargetBytes - live and retired target bytes at pass completion
peakLeasedTargetBytes - maximum bytes held by simultaneous leases during the pass
maskRasterPixels - mask pixels generated on the CPU, excluding cached rasters
maskCacheHits - CPU raster or unchanged target-upload cache hits
maskUploadBytes - RGBA bytes uploaded to mask textures
maskRasterNanos - CPU mask rasterization time, excluding upload and image conversion
failures - reported backend degradation or failure at pass completion

public record GuiRenderExecutionStats(long passId, long copies, long effectPasses, long targetAcquisitions, long reusedTargets, long allocatedTargetBytes, long residentTargetBytes, long peakLeasedTargetBytes, long maskRasterPixels, long maskCacheHits, long maskUploadBytes, long maskRasterNanos, List<String> failures) extends Record
Immutable counters for the last completed extracted GUI pass, shared by all GUI/HUD hosts in that pass.

These count submitted backend operations, not GPU completion or elapsed GPU time. Copies include shader-based bounded copies; effect passes exclude those copies. Pool bytes include retained view-transition leases, and allocation bytes count newly created targets rather than reused targets. Use GuiHostView.renderStats() for the separate per-host compilation plan.

  • Field Details

  • Constructor Details

    • GuiRenderExecutionStats

      public GuiRenderExecutionStats(long passId, long copies, long effectPasses, long targetAcquisitions, long reusedTargets, long allocatedTargetBytes, long residentTargetBytes, long peakLeasedTargetBytes, long maskRasterPixels, long maskCacheHits, long maskUploadBytes, long maskRasterNanos, List<String> failures)
      Creates an instance of a GuiRenderExecutionStats record class.
      Parameters:
      passId - the value for the passId record component
      copies - the value for the copies record component
      effectPasses - the value for the effectPasses record component
      targetAcquisitions - the value for the targetAcquisitions record component
      reusedTargets - the value for the reusedTargets record component
      allocatedTargetBytes - the value for the allocatedTargetBytes record component
      residentTargetBytes - the value for the residentTargetBytes record component
      peakLeasedTargetBytes - the value for the peakLeasedTargetBytes record component
      maskRasterPixels - the value for the maskRasterPixels record component
      maskCacheHits - the value for the maskCacheHits record component
      maskUploadBytes - the value for the maskUploadBytes record component
      maskRasterNanos - the value for the maskRasterNanos record component
      failures - the value for the failures record component
  • Method Details

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object
    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object
    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. Reference components are compared with Objects::equals(Object,Object); primitive components are compared with the compare method from their corresponding wrapper classes.
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.
    • passId

      public long passId()
      Returns the value of the passId record component.
      Returns:
      the value of the passId record component
    • copies

      public long copies()
      Returns the value of the copies record component.
      Returns:
      the value of the copies record component
    • effectPasses

      public long effectPasses()
      Returns the value of the effectPasses record component.
      Returns:
      the value of the effectPasses record component
    • targetAcquisitions

      public long targetAcquisitions()
      Returns the value of the targetAcquisitions record component.
      Returns:
      the value of the targetAcquisitions record component
    • reusedTargets

      public long reusedTargets()
      Returns the value of the reusedTargets record component.
      Returns:
      the value of the reusedTargets record component
    • allocatedTargetBytes

      public long allocatedTargetBytes()
      Returns the value of the allocatedTargetBytes record component.
      Returns:
      the value of the allocatedTargetBytes record component
    • residentTargetBytes

      public long residentTargetBytes()
      Returns the value of the residentTargetBytes record component.
      Returns:
      the value of the residentTargetBytes record component
    • peakLeasedTargetBytes

      public long peakLeasedTargetBytes()
      Returns the value of the peakLeasedTargetBytes record component.
      Returns:
      the value of the peakLeasedTargetBytes record component
    • maskRasterPixels

      public long maskRasterPixels()
      Returns the value of the maskRasterPixels record component.
      Returns:
      the value of the maskRasterPixels record component
    • maskCacheHits

      public long maskCacheHits()
      Returns the value of the maskCacheHits record component.
      Returns:
      the value of the maskCacheHits record component
    • maskUploadBytes

      public long maskUploadBytes()
      Returns the value of the maskUploadBytes record component.
      Returns:
      the value of the maskUploadBytes record component
    • maskRasterNanos

      public long maskRasterNanos()
      Returns the value of the maskRasterNanos record component.
      Returns:
      the value of the maskRasterNanos record component
    • failures

      public List<String> failures()
      Returns the value of the failures record component.
      Returns:
      the value of the failures record component