Package apple.metalperformanceshaders.enums

Class MPSAccelerationStructureUsage

  • public final class MPSAccelerationStructureUsage
extends java.lang.Object
    Options describing how an acceleration structure will be used

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static long FrequentRebuild
      Option indicating that the acceleration structure will be rebuilt frequently.
      static long None
      No usage options specified
      static long PreferCPUBuild
      Prefer building the acceleration structure on the CPU.
      static long PreferGPUBuild
      Prefer building the acceleration structure on the GPU.
      static long Refit
      Enable support for refitting the acceleration structure after it has been built.

    • Method Summary

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • Refit

        public static final long Refit
        Enable support for refitting the acceleration structure after it has been built. This option may reduce raytracing performance so do not use it unless the acceleration structure will be refit.
        See Also:
        Constant Field Values

      • FrequentRebuild

        public static final long FrequentRebuild
        Option indicating that the acceleration structure will be rebuilt frequently. In this case, the acceleration structure may choose a higher performance but lower quality acceleration structure construction algorithm. This option may reduce raytracing performance performance so do not use it unless reduced acceleration structure build time is worth reduced raytracing performance. This option may be useful if, for example, the user is interactively editing a live view of the scene.
        See Also:
        Constant Field Values

      • PreferGPUBuild

        public static final long PreferGPUBuild
        Prefer building the acceleration structure on the GPU. By default, the acceleration structure will be built on the GPU when possible. However, in some cases such as very small triangle counts, the acceleration structure may be built on the CPU. This option will force the acceleration structure to be always be built on the GPU whenever possible.
        See Also:
        Constant Field Values

      • PreferCPUBuild

        public static final long PreferCPUBuild
        Prefer building the acceleration structure on the CPU. By default, the acceleration structure will be built on the GPU when possible, which is typically much faster than building on the CPU. However, in some cases it may be preferable to build on the CPU such as to avoid framerate hitches when the GPU is rendering the user interface.
        See Also:
        Constant Field Values