Vixen
02b45cc4
csharp
public sealed class GraphicsOptions

What the host builds the frame out of.

No guide page documents this yet — the page shows what the code says about itself.

Remarks

Names and capacities, and nothing about where the passes go — that is the compositor document's, which is the division the whole renderer is built on. What is here is the handful of decisions that join a document to a host: which resource the window is, which view the camera fills, which stage the world draws in, and how much geometry the scene is allowed.

The three names default to the ones DefaultFrame uses, so a project that authors its own compositor either keeps those names or says here what it called them instead. They are strings rather than an enum because a document is authored data: the set of resources in a frame is open, and a host that could only bind names it had compiled in could not run a frame somebody wrote after it shipped.

Fields and properties (14)

  • public bool Enabled

    Whether the host opens a device and draws the world at all.

  • public IList<ISceneRendererFactory> Factories

    Extra node kinds the frame may name, beyond the ones the builder knows itself.

  • public string? Compositor

    The address of the compositor to load, or for the built-in frame.

  • public string View

    The name of the view the camera fills.

  • public string Stage

    The name of the stage the world's drawables are extracted into.

  • public IList<string> CasterStages

    Stages an object is extracted into as well as Stage.

  • public string ParticleStage

    The name of the stage particle emitters are drawn in, or empty for a frame with none.

  • public string Output

    The name of the resource the window's image is lent to the frame as.

  • public IList<GraphicsBackend> Backends

    Which graphics APIs to try, most preferred first.

  • public PixelFormat Format

    The format to ask the swapchain for.

  • public PresentMode PresentMode

    How the swapchain waits for the display.

  • public int VertexCapacity

    How many vertices the scene's shared geometry buffer holds.

  • public int IndexCapacity

    How many indices it holds.

  • public Int2 WindowlessSize

    What size to draw at when there is no window to take a size from.

Used by (18)

  • PbrShowcaseGamePbrShowcase
  • ThirdPersonShooterGameThirdPersonShooter
  • TriangleGameHelloTriangle
  • VideoGameVideoPlayback
  • VirtualGeometryGameVirtualGeometry
  • AppBuilderVixen.App.Hosting
  • AppConfigVixen.App.Hosting
  • AppGraphicsVixen.App.Hosting
  • IGraphicsBackendVixen.App.Hosting
  • AppBackendTestsVixen.App.Tests
  • BackendVixen.App
  • CountingBackendVixen.App.Tests
  • GraphicsHostVixen.App
  • HeadlessVixen.App.Tests
  • HostedRendererTestsVixen.App.Tests
  • NoGraphicsGameVixen.App.Tests
  • PlatformHostVixen.App
  • RealmVixen.Live.Realm