WGPU

Layout of this module should be guided by the evolving WebGPU Specification.

Introduction

Introduction to WebGPU

WebGPU is a future web standard for graphics and compute, developed by the W3C. It is currently (August 2021) an emerging technology, and not yet stable. In addition to its JavaScript API, there are also early attempts to create a native binding (ie. a C language binding). Two implementations of the native binding are:

• wgpu-native: a Mozilla-backed WebGPU native implementation, written in Rust, used in the Firefox web browser. This is the binding to which this Haskell library is currently tied.
• dawn: a Google-backed WebGPU native implementation, written in C++, used in the Chrome web browser. In the future, we hope to support this backend too.

The native bindings to WebGPU have the potential to become a portable, next-generation GPU API which is easy to use. Vulkan is also currently available across platforms, but it is very low-level. In the opinion of the author of this package, Vulkan is very difficult to use directly from Haskell. It would benefit greatly from a shim layer which performs common tasks and streamlines many operations. Not unexpectedly, that is exactly the role that WebGPU native can play.

Platform Support

Currently, only macOS (with the Metal backend) is supported. The limitation is not fundamental and only exists because, so far, only macOS surface creation has been implemented. In the future, other backends should be added.

Dependence on GLFW-b

This package currently uses only GLFW-b for windowing and event processing. Clearly, it is undesirable to be tied to only a single library for this purpose, when options like sdl2 are available and might be preferred by many users.

GFLW is used because it is the windowing library used in the C examples from wgpu-native and it exposes an API to obtain a pointer to the underlying windowing system's native window. In the future, other options will be investigated as time permits.

Structure of Bindings

The bindings to wgpu-native are structured in three packages:

1. The wgpu-raw-hs-codegen package is a code generator for the raw bindings. It creates all the packages named WGPU.Raw.Generated.* (without exception!), using a custom code generator based on `langage-c`. This package is not in Hackage, since it is only used offline.
2. The wgpu-raw-hs package provides raw bindings to wgpu-native. These raw bindings are mostly auto-generated, but have some manual curation of top-level types and function aliases. They are "raw" in the sense that they contain raw pointers and are not usable without manual management of memory to construct all the C structs that must be passed to the API.

3. The wgpu-hs package (this one) provides high-level bindings. These bindings are written manually. They are improvements on the raw bindings in the following ways:

   • There are no more raw Ptr types. Memory for structs passed to the raw API is managed using a type class (ToRaw) that encapsulates a mapping between high-level API types and raw types. The possibility to allocate memory as part of this conversion (and later free it) is achieved by embedding conversion to the raw types inside the ContT continuation monad.
   • There are no callbacks. Several WebGPU native calls use callbacks to indicate completion rather than blocking. The author decided that, in the Haskell context, blocking was probably preferable. So, internally, these calls are converted into a blocking form by waiting on MVars that are set by the callbacks.
   • Several parts of the API are tweaked slightly to more closely resemble the Rust API. This is done in cases where, for example, a parameter to the C API is unused except in one branch of a sum type. When this can be done easily enough, it is preferred to using the flattened "union" approach.
   • Names are de-duplicated. Where possible, names are identical to the C API (sometimes with prefixes removed). However, where name conflicts exist, names are changed to somewhat-idiomatic Haskell variants.

Native Library Handling

The native library for wgpu-native is not required at compile-time for this package. Indeed, other packages containing executables that depend on this one can be compiled without the native library! Instead, the library is loaded dynamically and its symbols bound at runtime. This has the benefit that the Haskell tooling need not be concerned with handling a Rust library (yay!), but it is a point of common failure at runtime. To achieve this independence, the header files for wgpu-native are packaged inside wgpu-raw-hs. Of course, care should be taken to ensure that a fully-compatible version of the library is used at runtime.

Initialization

The first step in using these Haskell bindings is to obtain an Instance. This acts as a handle to the rest of the API. An Instance is obtained at runtime by loading a dynamic library containing the WGPU binding symbols. Currently, only the C/Rust library from wgpu-native is supported.

To load the dynamic library and obtain an instance, use the withInstance bracketing function:

withInstance "libwgpu_native.dylib" (Just logStdout) $ inst -> do
  -- set the logging level (optional)
  setLogLevel inst Warn
  -- run the rest of the program...

After creating an Instance, you may next want to create a surface.

data Instance

Instance of the WGPU API.

An instance is loaded from a dynamic library using the withInstance function.

Instances

Show Instance

Defined in WGPU.Internal.Instance

Methods

showsPrec :: Int -> Instance -> ShowS

show :: Instance -> String

showList :: [Instance] -> ShowS

ToRaw Instance WGPUHsInstance

Defined in WGPU.Internal.Instance

Methods

raw :: Instance -> ContT c IO WGPUHsInstance

withInstance

Arguments

:: FilePath

Name of the wgpu-native dynamic library, or a complete path to it.

-> Maybe LogCallback

Optional logging callback. Just logStdout can be supplied here to print log messages to stdout for debugging purposes.

-> (Instance -> IO a)

The Program. A function which takes an Instance and returns an IO action that uses the instance.

-> IO a

IO action which loads the WGPU Instance, passes it to the program, and returns the result of running the program.

Load the WGPU API from a dynamic library and supply an Instance to a program.

Surface

A Surface is a handle to a platform-specific presentable surface, like a window. Currently, only GLFW windows are supported for surface creation. Once you have a GLFW window, you may create a Surface for it using the createGLFWSurface function.

Once you have a Surface, the next step is usually to request an adapter that is compatible with it.

data Surface

Handle to a presentable surface.

A Surface presents a platform-specific surface (eg. a window) on to which rendered images may be presented. A Surface can be created for a GLFW window using createGLFWSurface.

Instances

Eq Surface

Defined in WGPU.Internal.Surface

Methods

(==) :: Surface -> Surface -> Bool

(/=) :: Surface -> Surface -> Bool

Show Surface

Defined in WGPU.Internal.Surface

Methods

showsPrec :: Int -> Surface -> ShowS

show :: Surface -> String

showList :: [Surface] -> ShowS

ToRaw Surface WGPUSurface

Defined in WGPU.Internal.Surface

Methods

raw :: Surface -> ContT c IO WGPUSurface

createGLFWSurface

Arguments

:: Instance

API instance.

-> Window

GLFW window for which the surface will be created.

-> IO Surface

IO action to create the surface.

Create a WGPU Surface for a GLFW Window.

This function is not part of the wgpu-native API, but is part of the Haskell API until the native WGPU API has a better story around windowing.

Adapter

An Adapter is a handle to a physical device. For example, a physical display adaptor (GPU) or a software renderer. Currently you obtain an adapter using requestAdapter, which requests an adapter that is compatible with an existing Surface.

After obtaining an adapter, you will typically want to request a device.

data Adapter

Handle to a physical graphics and/or compute device.

Request an Adapter for a Surface using the requestAdapter function.

Instances

Eq Adapter

Defined in WGPU.Internal.Adapter

Methods

(==) :: Adapter -> Adapter -> Bool

(/=) :: Adapter -> Adapter -> Bool

Show Adapter

Defined in WGPU.Internal.Adapter

Methods

showsPrec :: Int -> Adapter -> ShowS

show :: Adapter -> String

showList :: [Adapter] -> ShowS

ToRaw Adapter WGPUAdapter

Defined in WGPU.Internal.Adapter

Methods

raw :: Adapter -> ContT c IO WGPUAdapter

requestAdapter

Arguments

:: Surface

Existing surface for which to request an Adapter.

-> IO (Maybe Adapter)

The returned Adapter, if it could be retrieved.

Request an Adapter that is compatible with a given Surface.

This action blocks until an available adapter is returned.

Device

A Device is an open connection to a graphics and/or compute device. A Device is created using the requestDevice function.

(According to the WebGPU API documentation, a Device may also be "lost". However, it's not yet clear how that event will be signalled to the C API, nor how to handle it.)

data Device

An open connection to a graphics and/or compute device.

A Device may be created using the requestDevice function.

Instances

Eq Device

Defined in WGPU.Internal.Device

Methods

(==) :: Device -> Device -> Bool

(/=) :: Device -> Device -> Bool

Show Device

Defined in WGPU.Internal.Device

Methods

showsPrec :: Int -> Device -> ShowS

show :: Device -> String

showList :: [Device] -> ShowS

ToRaw Device WGPUDevice

Defined in WGPU.Internal.Device

Methods

raw :: Device -> ContT c IO WGPUDevice

data DeviceDescriptor

Describes a Device.

Constructors

DeviceDescriptor

Fields

• deviceLabel :: !Text

  Debug label for the device.

• features :: !Features

  Features that the device should support.

• limits :: !Limits

  Limits that the device should support (minimum values).

Instances

Eq DeviceDescriptor

Defined in WGPU.Internal.Device

Methods

(==) :: DeviceDescriptor -> DeviceDescriptor -> Bool

(/=) :: DeviceDescriptor -> DeviceDescriptor -> Bool

Show DeviceDescriptor

Defined in WGPU.Internal.Device

Methods

showsPrec :: Int -> DeviceDescriptor -> ShowS

show :: DeviceDescriptor -> String

showList :: [DeviceDescriptor] -> ShowS

Default DeviceDescriptor

Defined in WGPU.Internal.Device

Methods

def :: DeviceDescriptor

ToRaw DeviceDescriptor WGPUDeviceExtras

Defined in WGPU.Internal.Device

Methods

raw :: DeviceDescriptor -> ContT c IO WGPUDeviceExtras

data Limits

Device limits.

Represents the set of limits an adapter/device supports.

Constructors

Limits

Fields

• maxTextureDimension1D :: !Word32

  Maximum allowed value for the width of a 1D texture.

• maxTextureDimension2D :: !Word32

  Maximum allowed value for the width and height of a 2D texture.

• maxTextureDimension3D :: !Word32

  Maximum allowed value for the width, height or depth of a 3D texture.

• maxTextureArrayLayers :: !Word32

  Maximum allowed value for the array layers of a texture.

• maxBindGroups :: !Word32

  Amount of bind groups that can be attached to a pipeline at the same time.

• maxDynamicStorageBuffersPerPipelineLayout :: !Word32

  Amount of storage buffer bindings that can be dynamic in a single pipeline.

• maxStorageBuffersPerShaderStage :: !Word32

  Amount of sampled textures visible in a single shader stage.

• maxStorageBufferBindingSize :: !Word32

  Maximum size in bytes of a binding to a uniform buffer.

Instances

Eq Limits

Defined in WGPU.Internal.Device

Methods

(==) :: Limits -> Limits -> Bool

(/=) :: Limits -> Limits -> Bool

Show Limits

Defined in WGPU.Internal.Device

Methods

showsPrec :: Int -> Limits -> ShowS

show :: Limits -> String

showList :: [Limits] -> ShowS

Default Limits

Defined in WGPU.Internal.Device

Methods

def :: Limits

newtype Features

Device features that are not guaranteed to be supported.

• NOTE: The Rust API currently has far more extensive Features. Perhaps they have not yet been ported to the C API? https://docs.rs/wgpu-types/0.9.0/wgpu_types/struct.Features.html

Constructors

Features

Fields

• textureAdapterSpecificFormatFeatures :: Bool

Instances

Eq Features

Defined in WGPU.Internal.Device

Methods

(==) :: Features -> Features -> Bool

(/=) :: Features -> Features -> Bool

Show Features

Defined in WGPU.Internal.Device

Methods

showsPrec :: Int -> Features -> ShowS

show :: Features -> String

showList :: [Features] -> ShowS

Default Features

Defined in WGPU.Internal.Device

Methods

def :: Features

ToRaw Features WGPUNativeFeature

Defined in WGPU.Internal.Device

Methods

raw :: Features -> ContT c IO WGPUNativeFeature

requestDevice

Arguments

:: Adapter

Adapter for which the device will be returned.

-> DeviceDescriptor

The features and limits requested for the device.

-> IO (Maybe Device)

The returned Device, if it could be retrieved.

Requests a connection to a physical device, creating a logical device.

This action blocks until an available device is returned.

Textures and Views

data TextureView

Handle to a texture view.

A TextureView describes a texture and associated metadata needed by a rendering pipeline or bind group.

Instances

Eq TextureView

Defined in WGPU.Internal.Texture

Methods

(==) :: TextureView -> TextureView -> Bool

(/=) :: TextureView -> TextureView -> Bool

Show TextureView

Defined in WGPU.Internal.Texture

Methods

showsPrec :: Int -> TextureView -> ShowS

show :: TextureView -> String

showList :: [TextureView] -> ShowS

ToRaw TextureView WGPUTextureView

Defined in WGPU.Internal.Texture

Methods

raw :: TextureView -> ContT c IO WGPUTextureView

data TextureViewDimension

Dimensions of a particular texture view.

Constructors

TextureViewDimension1D

TextureViewDimension2D

TextureViewDimension2DArray

TextureViewDimensionCube

TextureViewDimensionCubeArray

TextureViewDimension3D

Instances

Eq TextureViewDimension

Defined in WGPU.Internal.Texture

Methods

(==) :: TextureViewDimension -> TextureViewDimension -> Bool

(/=) :: TextureViewDimension -> TextureViewDimension -> Bool

Show TextureViewDimension

Defined in WGPU.Internal.Texture

Methods

showsPrec :: Int -> TextureViewDimension -> ShowS

show :: TextureViewDimension -> String

showList :: [TextureViewDimension] -> ShowS

ToRaw TextureViewDimension WGPUTextureViewDimension

Defined in WGPU.Internal.Texture

Methods

raw :: TextureViewDimension -> ContT c IO WGPUTextureViewDimension

data TextureFormat

Texture data format.

Constructors

TextureFormatR8Unorm

TextureFormatR8Snorm

TextureFormatR8Uint

TextureFormatR8Sint

TextureFormatR16Uint

TextureFormatR16Sint

TextureFormatR16Float

TextureFormatRG8Unorm

TextureFormatRG8Snorm

TextureFormatRG8Uint

TextureFormatRG8Sint

TextureFormatR32Float

TextureFormatR32Uint

TextureFormatR32Sint

TextureFormatRG16Uint

TextureFormatRG16Sint

TextureFormatRG16Float

TextureFormatRGBA8Unorm

TextureFormatRGBA8UnormSrgb

TextureFormatRGBA8Snorm

TextureFormatRGBA8Uint

TextureFormatRGBA8Sint

TextureFormatBGRA8Unorm

TextureFormatBGRA8UnormSrgb

TextureFormatRGB10A2Unorm

TextureFormatRG11B10Ufloat

TextureFormatRGB9E5Ufloat

TextureFormatRG32Float

TextureFormatRG32Uint

TextureFormatRG32Sint

TextureFormatRGBA16Uint

TextureFormatRGBA16Sint

TextureFormatRGBA16Float

TextureFormatRGBA32Float

TextureFormatRGBA32Uint

TextureFormatRGBA32Sint

TextureFormatDepth32Float

TextureFormatDepth24Plus

TextureFormatDepth24PlusStencil8

TextureFormatStencil8

TextureFormatBC1RGBAUnorm

TextureFormatBC1RGBAUnormSrgb

TextureFormatBC2RGBAUnorm

TextureFormatBC2RGBAUnormSrgb

TextureFormatBC3RGBAUnorm

TextureFormatBC3RGBAUnormSrgb

TextureFormatBC4RUnorm

TextureFormatBC4RSnorm

TextureFormatBC5RGUnorm

TextureFormatBC5RGSnorm

TextureFormatBC6HRGBUfloat

TextureFormatBC6HRGBFloat

TextureFormatBC7RGBAUnorm

TextureFormatBC7RGBAUnormSrgb

Instances

Eq TextureFormat

Defined in WGPU.Internal.Texture

Methods

(==) :: TextureFormat -> TextureFormat -> Bool

(/=) :: TextureFormat -> TextureFormat -> Bool

Show TextureFormat

Defined in WGPU.Internal.Texture

Methods

showsPrec :: Int -> TextureFormat -> ShowS

show :: TextureFormat -> String

showList :: [TextureFormat] -> ShowS

ToRaw TextureFormat WGPUTextureFormat

Defined in WGPU.Internal.Texture

Methods

raw :: TextureFormat -> ContT c IO WGPUTextureFormat

data TextureUsage

Different ways you can use a texture.

The usages determine from what kind of memory the texture is allocated, and in what actions the texture can partake.

Constructors

TextureUsageCopySrc

TextureUsageCopyDst

TextureUsageSampled

TextureUsageStorage

TextureUsageRenderAttachment

Instances

Eq TextureUsage

Defined in WGPU.Internal.Texture

Methods

(==) :: TextureUsage -> TextureUsage -> Bool

(/=) :: TextureUsage -> TextureUsage -> Bool

Show TextureUsage

Defined in WGPU.Internal.Texture

Methods

showsPrec :: Int -> TextureUsage -> ShowS

show :: TextureUsage -> String

showList :: [TextureUsage] -> ShowS

ToRaw TextureUsage WGPUTextureUsage

Defined in WGPU.Internal.Texture

Methods

raw :: TextureUsage -> ContT c IO WGPUTextureUsage

Swapchain

data SwapChain

Instances

Eq SwapChain

Defined in WGPU.Internal.SwapChain

Methods

(==) :: SwapChain -> SwapChain -> Bool

(/=) :: SwapChain -> SwapChain -> Bool

Show SwapChain

Defined in WGPU.Internal.SwapChain

Methods

showsPrec :: Int -> SwapChain -> ShowS

show :: SwapChain -> String

showList :: [SwapChain] -> ShowS

ToRaw SwapChain WGPUSwapChain

Defined in WGPU.Internal.SwapChain

Methods

raw :: SwapChain -> ContT c IO WGPUSwapChain

data SwapChainDescriptor

Describes a swapchain.

Constructors

SwapChainDescriptor

Fields

• swapChainLabel :: !Text

  Debugging label for the swap chain.

• usage :: !TextureUsage

  The usage of the swap chain. The only supported usage is TextureUsageRenderAttachment.

• swapChainFormat :: !TextureFormat

  Texture format of the swap chain. The only guaranteed formats are TextureFormatBgra8Unorm and TextureFormatBgra8UnormSrgb. To determine the preferred texture format for a surface, use the getSwapChainPreferredFormat function.

• width :: !Word32

  Width of the swap chain. Must be the same size as the surface.

• height :: !Word32

  Height of the swap chain. Must be the same size as the surface.

• presentMode :: !PresentMode

  Presentation mode of the swap chain.

Instances

Eq SwapChainDescriptor

Defined in WGPU.Internal.SwapChain

Methods

(==) :: SwapChainDescriptor -> SwapChainDescriptor -> Bool

(/=) :: SwapChainDescriptor -> SwapChainDescriptor -> Bool

Show SwapChainDescriptor

Defined in WGPU.Internal.SwapChain

Methods

showsPrec :: Int -> SwapChainDescriptor -> ShowS

show :: SwapChainDescriptor -> String

showList :: [SwapChainDescriptor] -> ShowS

ToRaw SwapChainDescriptor WGPUSwapChainDescriptor

Defined in WGPU.Internal.SwapChain

Methods

raw :: SwapChainDescriptor -> ContT c IO WGPUSwapChainDescriptor

data PresentMode

Behaviour of the presentation engine based on frame rate.

Constructors

PresentModeImmediate

The presentation engine does not wait for a vertical blanking period and the request is presented immediately. This is a low-latency presentation mode, but visible tearing may be observed. Will fallback to Fifo if unavailable on the selected platform and backend. Not optimal for mobile.

PresentModeMailbox

The presentation engine waits for the next vertical blanking period to update the current image, but frames may be submitted without delay. This is a low-latency presentation mode and visible tearing will not be observed. Will fallback to Fifo if unavailable on the selected platform and backend. Not optimal for mobile.

PresentModeFifo

The presentation engine waits for the next vertical blanking period to update the current image. The framerate will be capped at the display refresh rate, corresponding to the VSync. Tearing cannot be observed. Optimal for mobile.

Instances

Eq PresentMode

Defined in WGPU.Internal.SwapChain

Methods

(==) :: PresentMode -> PresentMode -> Bool

(/=) :: PresentMode -> PresentMode -> Bool

Show PresentMode

Defined in WGPU.Internal.SwapChain

Methods

showsPrec :: Int -> PresentMode -> ShowS

show :: PresentMode -> String

showList :: [PresentMode] -> ShowS

ToRaw PresentMode WGPUPresentMode

Defined in WGPU.Internal.SwapChain

Methods

raw :: PresentMode -> ContT c IO WGPUPresentMode

getSwapChainPreferredFormat

Arguments

:: Surface

Surface for which to obtain an optimal texture format.

-> Adapter

Adapter for which to obtain an optimal texture format.

-> IO TextureFormat

IO action which returns the optimal texture format.

Returns an optimal texture format to use for the swapchain with this adapter and surface.

createSwapChain

Arguments

:: Device

Device for which the SwapChain will be created.

-> Surface

Surface for which the SwapChain will be created.

-> SwapChainDescriptor

Description of the SwapChain to be created.

-> IO SwapChain

IO action which creates the swap chain.

Createa a new SwapChain which targets a Surface.

To determine the preferred TextureFormat for the Surface, use the getSwapChainPreferredFormat function.

getSwapChainCurrentTextureView

Arguments

:: SwapChain

Swap chain from which to fetch the current texture view.

-> IO TextureView

IO action which returns the current swap chain texture view.

Get the TextureView for the current swap chain frame.

swapChainPresent

Arguments

:: SwapChain

Swap chain to present.

-> IO ()

IO action which presents the swap chain image.

Present the latest swap chain image.

Samplers

Resource Binding

data BindGroupLayout

Handle to a binding group layout.

A BindGroupLayout is a handle to the GPU-side layout of a binding group.

Instances

Eq BindGroupLayout

Defined in WGPU.Internal.Binding

Methods

(==) :: BindGroupLayout -> BindGroupLayout -> Bool

(/=) :: BindGroupLayout -> BindGroupLayout -> Bool

Show BindGroupLayout

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> BindGroupLayout -> ShowS

show :: BindGroupLayout -> String

showList :: [BindGroupLayout] -> ShowS

ToRaw BindGroupLayout WGPUBindGroupLayout

Defined in WGPU.Internal.Binding

Methods

raw :: BindGroupLayout -> ContT c IO WGPUBindGroupLayout

data BindGroupLayoutDescriptor

Describes a BindGroupLayout.

Constructors

BindGroupLayoutDescriptor

Fields

• bindGroupLabel :: !Text

  Debug label of the bind group layout.

• entries :: Vector BindGroupLayoutEntry

  Sequence of entries in this bind group layout.

Instances

Eq BindGroupLayoutDescriptor

Defined in WGPU.Internal.Binding

Methods

(==) :: BindGroupLayoutDescriptor -> BindGroupLayoutDescriptor -> Bool

(/=) :: BindGroupLayoutDescriptor -> BindGroupLayoutDescriptor -> Bool

Show BindGroupLayoutDescriptor

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> BindGroupLayoutDescriptor -> ShowS

show :: BindGroupLayoutDescriptor -> String

showList :: [BindGroupLayoutDescriptor] -> ShowS

ToRaw BindGroupLayoutDescriptor WGPUBindGroupLayoutDescriptor

Defined in WGPU.Internal.Binding

Methods

raw :: BindGroupLayoutDescriptor -> ContT c IO WGPUBindGroupLayoutDescriptor

data BindGroupLayoutEntry

Describes a single binding inside a bind group.

Constructors

BindGroupLayoutEntry

Fields

• binding :: !Binding

  Binding index. Must match a shader index, and be unique inside a bind group layout.

• visibility :: !ShaderStage

  Which shader stages can see this binding.

• bindGroupLayoutEntryType :: !BindingType

  Type of the binding.

Instances

Eq BindGroupLayoutEntry

Defined in WGPU.Internal.Binding

Methods

(==) :: BindGroupLayoutEntry -> BindGroupLayoutEntry -> Bool

(/=) :: BindGroupLayoutEntry -> BindGroupLayoutEntry -> Bool

Show BindGroupLayoutEntry

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> BindGroupLayoutEntry -> ShowS

show :: BindGroupLayoutEntry -> String

showList :: [BindGroupLayoutEntry] -> ShowS

ToRaw BindGroupLayoutEntry WGPUBindGroupLayoutEntry

Defined in WGPU.Internal.Binding

Methods

raw :: BindGroupLayoutEntry -> ContT c IO WGPUBindGroupLayoutEntry

newtype Binding

Binding index.

This must match a shader index, and be unique inside a binding group layout.

Constructors

Binding

Fields

• unBinding :: Word32

Instances

Eq Binding

Defined in WGPU.Internal.Binding

Methods

(==) :: Binding -> Binding -> Bool

(/=) :: Binding -> Binding -> Bool

Show Binding

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> Binding -> ShowS

show :: Binding -> String

showList :: [Binding] -> ShowS

ToRaw Binding Word32

Defined in WGPU.Internal.Binding

Methods

raw :: Binding -> ContT c IO Word32

data ShaderStage

Describes the shader stages from which a binding will be visible.

Constructors

ShaderStage

Fields

• stageVertex :: !Bool

  Binding is visible from the vertex shader of a render pipeline.

• stageFragment :: !Bool

  Binding is visible from the fragment shader of a render pipeline.

• stageCompute :: !Bool

  Binding is visible from the compute shader of a compute pipeline.

Instances

Eq ShaderStage

Defined in WGPU.Internal.Binding

Methods

(==) :: ShaderStage -> ShaderStage -> Bool

(/=) :: ShaderStage -> ShaderStage -> Bool

Show ShaderStage

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> ShaderStage -> ShowS

show :: ShaderStage -> String

showList :: [ShaderStage] -> ShowS

ToRaw ShaderStage WGPUShaderStageFlags

Defined in WGPU.Internal.Binding

Methods

raw :: ShaderStage -> ContT c IO WGPUShaderStageFlags

data BindingType

Specifies type of a binding.

Constructors

BindingTypeBuffer !BufferBindingLayout

A buffer binding.

BindingTypeSampler !SamplerBindingLayout

A sampler that can be used to sample a texture.

BindingTypeTexture !TextureBindingLayout

A texture binding.

BindingTypeStorageTexture !StorageTextureBindingLayout

A storage texture.

Instances

Eq BindingType

Defined in WGPU.Internal.Binding

Methods

(==) :: BindingType -> BindingType -> Bool

(/=) :: BindingType -> BindingType -> Bool

Show BindingType

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> BindingType -> ShowS

show :: BindingType -> String

showList :: [BindingType] -> ShowS

data BufferBindingLayout

A buffer binding.

Constructors

BufferBindingLayout

Fields

• bindingBufferLayoutType :: !BufferBindingType

  Sub-type of the buffer binding.

• hasDynamicOffset :: !Bool

  Indicates that the binding has a dynamic offset. One offset must be passed when setting the bind group in the render pass.

• minBindingSize :: !(SMaybe Word64)

  Minimum size of a corresponding buffer binding required to match this entry.

Instances

Eq BufferBindingLayout

Defined in WGPU.Internal.Binding

Methods

(==) :: BufferBindingLayout -> BufferBindingLayout -> Bool

(/=) :: BufferBindingLayout -> BufferBindingLayout -> Bool

Show BufferBindingLayout

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> BufferBindingLayout -> ShowS

show :: BufferBindingLayout -> String

showList :: [BufferBindingLayout] -> ShowS

ToRaw BufferBindingLayout WGPUBufferBindingLayout

Defined in WGPU.Internal.Binding

Methods

raw :: BufferBindingLayout -> ContT c IO WGPUBufferBindingLayout

data SamplerBindingLayout

A sampler binding that can be used to sample a texture.

Constructors

SamplerBindingLayoutFiltering

SamplerBindingLayoutNonFiltering

SamplerBindingLayoutComparison

Instances

Eq SamplerBindingLayout

Defined in WGPU.Internal.Binding

Methods

(==) :: SamplerBindingLayout -> SamplerBindingLayout -> Bool

(/=) :: SamplerBindingLayout -> SamplerBindingLayout -> Bool

Show SamplerBindingLayout

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> SamplerBindingLayout -> ShowS

show :: SamplerBindingLayout -> String

showList :: [SamplerBindingLayout] -> ShowS

ToRaw SamplerBindingLayout WGPUSamplerBindingLayout

Defined in WGPU.Internal.Binding

Methods

raw :: SamplerBindingLayout -> ContT c IO WGPUSamplerBindingLayout

data TextureBindingLayout

A texture binding.

Constructors

TextureBindingLayout

Fields

• sampleType :: !TextureSampleType

  Sample type of the texture binding.

• textureViewDimension :: !TextureViewDimension

  Dimension of the texture view that is going to be sampled.

• multiSampled :: !Bool

  True if the texture has a sample count greater than 1.

Instances

Eq TextureBindingLayout

Defined in WGPU.Internal.Binding

Methods

(==) :: TextureBindingLayout -> TextureBindingLayout -> Bool

(/=) :: TextureBindingLayout -> TextureBindingLayout -> Bool

Show TextureBindingLayout

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> TextureBindingLayout -> ShowS

show :: TextureBindingLayout -> String

showList :: [TextureBindingLayout] -> ShowS

ToRaw TextureBindingLayout WGPUTextureBindingLayout

Defined in WGPU.Internal.Binding

Methods

raw :: TextureBindingLayout -> ContT c IO WGPUTextureBindingLayout

data StorageTextureBindingLayout

A storage texture binding.

Constructors

StorageTextureBindingLayout

Fields

• access :: !StorageTextureAccess

  Permitted access to this texture.

• storageTextureFormat :: !TextureFormat

  Format of the texture.

• storageTextureViewDimension :: !TextureViewDimension

  Dimension of the texture view that is going to be sampled.

Instances

Eq StorageTextureBindingLayout

Defined in WGPU.Internal.Binding

Methods

(==) :: StorageTextureBindingLayout -> StorageTextureBindingLayout -> Bool

(/=) :: StorageTextureBindingLayout -> StorageTextureBindingLayout -> Bool

Show StorageTextureBindingLayout

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> StorageTextureBindingLayout -> ShowS

show :: StorageTextureBindingLayout -> String

showList :: [StorageTextureBindingLayout] -> ShowS

ToRaw StorageTextureBindingLayout WGPUStorageTextureBindingLayout

Defined in WGPU.Internal.Binding

Methods

raw :: StorageTextureBindingLayout -> ContT c IO WGPUStorageTextureBindingLayout

data StorageTextureAccess

Specific method of allowed access to a storage texture.

Constructors

StorageTextureAccessReadOnly

StorageTextureAccessWriteOnly

StorageTextureAccessReadWrite

Instances

Eq StorageTextureAccess

Defined in WGPU.Internal.Binding

Methods

(==) :: StorageTextureAccess -> StorageTextureAccess -> Bool

(/=) :: StorageTextureAccess -> StorageTextureAccess -> Bool

Show StorageTextureAccess

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> StorageTextureAccess -> ShowS

show :: StorageTextureAccess -> String

showList :: [StorageTextureAccess] -> ShowS

ToRaw StorageTextureAccess WGPUStorageTextureAccess

Defined in WGPU.Internal.Binding

Methods

raw :: StorageTextureAccess -> ContT c IO WGPUStorageTextureAccess

data TextureSampleType

Specific type of a sample in a texture binding.

Constructors

TextureSampleTypeFloat

Fields

• filterable :: !Bool

TextureSampleTypeDepth

TextureSampleTypeSignedInt

TextureSampleTypeUnsignedInt

Instances

Eq TextureSampleType

Defined in WGPU.Internal.Binding

Methods

(==) :: TextureSampleType -> TextureSampleType -> Bool

(/=) :: TextureSampleType -> TextureSampleType -> Bool

Show TextureSampleType

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> TextureSampleType -> ShowS

show :: TextureSampleType -> String

showList :: [TextureSampleType] -> ShowS

ToRaw TextureSampleType WGPUTextureSampleType

Defined in WGPU.Internal.Binding

Methods

raw :: TextureSampleType -> ContT c IO WGPUTextureSampleType

data BufferBindingType

Specific type of a buffer binding.

Constructors

Uniform

Storage

Fields

• readOnly :: !Bool

Instances

Eq BufferBindingType

Defined in WGPU.Internal.Binding

Methods

(==) :: BufferBindingType -> BufferBindingType -> Bool

(/=) :: BufferBindingType -> BufferBindingType -> Bool

Show BufferBindingType

Defined in WGPU.Internal.Binding

Methods

showsPrec :: Int -> BufferBindingType -> ShowS

show :: BufferBindingType -> String

showList :: [BufferBindingType] -> ShowS

ToRaw BufferBindingType WGPUBufferBindingType

Defined in WGPU.Internal.Binding

Methods

raw :: BufferBindingType -> ContT c IO WGPUBufferBindingType

createBindGroupLayout

Arguments

:: Device

The device for which the bind group layout will be created.

-> BindGroupLayoutDescriptor

Description of the bind group layout.

-> IO BindGroupLayout

IO action that creates a bind group layout.

Creates a BindGroupLayout.

Shader Modules

data ShaderModule

Handle to a compiled shader module.

Instances

Eq ShaderModule

Defined in WGPU.Internal.Shader

Methods

(==) :: ShaderModule -> ShaderModule -> Bool

(/=) :: ShaderModule -> ShaderModule -> Bool

Show ShaderModule

Defined in WGPU.Internal.Shader

Methods

showsPrec :: Int -> ShaderModule -> ShowS

show :: ShaderModule -> String

showList :: [ShaderModule] -> ShowS

ToRaw ShaderModule WGPUShaderModule

Defined in WGPU.Internal.Shader

Methods

raw :: ShaderModule -> ContT c IO WGPUShaderModule

data ShaderModuleDescriptor

Descriptor for a shader module.

Constructors

ShaderModuleDescriptor

Fields

• shaderLabel :: !Text

  Debug label of the shader module.

• source :: !ShaderSource

  Source code for the shader.

Instances

Eq ShaderModuleDescriptor

Defined in WGPU.Internal.Shader

Methods

(==) :: ShaderModuleDescriptor -> ShaderModuleDescriptor -> Bool

(/=) :: ShaderModuleDescriptor -> ShaderModuleDescriptor -> Bool

Show ShaderModuleDescriptor

Defined in WGPU.Internal.Shader

Methods

showsPrec :: Int -> ShaderModuleDescriptor -> ShowS

show :: ShaderModuleDescriptor -> String

showList :: [ShaderModuleDescriptor] -> ShowS

ToRaw ShaderModuleDescriptor WGPUShaderModuleDescriptor

Defined in WGPU.Internal.Shader

Methods

raw :: ShaderModuleDescriptor -> ContT c IO WGPUShaderModuleDescriptor

data ShaderSource

Source for a shader module.

Constructors

ShaderSourceSPIRV !SPIRV

Use shader source from a SPIRV module (pre-compiled).

ShaderSourceWGSL !WGSL

Use shader source from WGSL string.

Instances

Eq ShaderSource

Defined in WGPU.Internal.Shader

Methods

(==) :: ShaderSource -> ShaderSource -> Bool

(/=) :: ShaderSource -> ShaderSource -> Bool

Show ShaderSource

Defined in WGPU.Internal.Shader

Methods

showsPrec :: Int -> ShaderSource -> ShowS

show :: ShaderSource -> String

showList :: [ShaderSource] -> ShowS

newtype SPIRV

Pre-compiled SPIRV module bytes.

Constructors

SPIRV ByteString

Instances

Eq SPIRV

Defined in WGPU.Internal.Shader

Methods

(==) :: SPIRV -> SPIRV -> Bool

(/=) :: SPIRV -> SPIRV -> Bool

Show SPIRV

Defined in WGPU.Internal.Shader

Methods

showsPrec :: Int -> SPIRV -> ShowS

show :: SPIRV -> String

showList :: [SPIRV] -> ShowS

ToRaw SPIRV WGPUShaderModuleSPIRVDescriptor

Defined in WGPU.Internal.Shader

Methods

raw :: SPIRV -> ContT c IO WGPUShaderModuleSPIRVDescriptor

newtype WGSL

WGSL shader source code.

Constructors

WGSL Text

Instances

Eq WGSL

Defined in WGPU.Internal.Shader

Methods

(==) :: WGSL -> WGSL -> Bool

(/=) :: WGSL -> WGSL -> Bool

Show WGSL

Defined in WGPU.Internal.Shader

Methods

showsPrec :: Int -> WGSL -> ShowS

show :: WGSL -> String

showList :: [WGSL] -> ShowS

ToRaw WGSL WGPUShaderModuleWGSLDescriptor

Defined in WGPU.Internal.Shader

Methods

raw :: WGSL -> ContT c IO WGPUShaderModuleWGSLDescriptor

newtype ShaderEntryPoint

Name of a shader entry point.

Constructors

ShaderEntryPoint

Fields

• unShaderEntryPoint :: Text

Instances

Eq ShaderEntryPoint

Defined in WGPU.Internal.Shader

Methods

(==) :: ShaderEntryPoint -> ShaderEntryPoint -> Bool

(/=) :: ShaderEntryPoint -> ShaderEntryPoint -> Bool

Show ShaderEntryPoint

Defined in WGPU.Internal.Shader

Methods

showsPrec :: Int -> ShaderEntryPoint -> ShowS

show :: ShaderEntryPoint -> String

showList :: [ShaderEntryPoint] -> ShowS

IsString ShaderEntryPoint

Defined in WGPU.Internal.Shader

Methods

fromString :: String -> ShaderEntryPoint

ToRawPtr ShaderEntryPoint CChar

Defined in WGPU.Internal.Shader

Methods

rawPtr :: ShaderEntryPoint -> ContT c IO (Ptr CChar)

createShaderModule

Arguments

:: Device

Device for the shader.

-> ShaderModuleDescriptor

Descriptor of the shader module.

-> IO ShaderModule

IO action producing the shader module.

Create a shader module from either SPIR-V or WGSL source code.

createShaderModuleSPIRV

Arguments

:: Device

Device for which the shader should be created.

-> Text

Debugging label for the shader.

-> SPIRV

Shader source code (SPIR-V bytestring).

-> IO ShaderModule

IO action creating the shader module.

Create a shader module from SPIR-V source code.

createShaderModuleWGSL

Arguments

:: Device

Device for which the shader should be created.

-> Text

Debugging label for the shader.

-> WGSL

Shader source code (WGSL source string).

-> IO ShaderModule

IO action creating the shader module.

Create a shader module from WGSL source code.

Pipelines

Compute

Render

data PipelineLayout

Instances

Eq PipelineLayout

Defined in WGPU.Internal.Pipeline

Methods

(==) :: PipelineLayout -> PipelineLayout -> Bool

(/=) :: PipelineLayout -> PipelineLayout -> Bool

Show PipelineLayout

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> PipelineLayout -> ShowS

show :: PipelineLayout -> String

showList :: [PipelineLayout] -> ShowS

ToRaw PipelineLayout WGPUPipelineLayout

Defined in WGPU.Internal.Pipeline

Methods

raw :: PipelineLayout -> ContT c IO WGPUPipelineLayout

data RenderPipeline

Instances

Eq RenderPipeline

Defined in WGPU.Internal.RenderPass

Methods

(==) :: RenderPipeline -> RenderPipeline -> Bool

(/=) :: RenderPipeline -> RenderPipeline -> Bool

Show RenderPipeline

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> RenderPipeline -> ShowS

show :: RenderPipeline -> String

showList :: [RenderPipeline] -> ShowS

ToRaw RenderPipeline WGPURenderPipeline

Defined in WGPU.Internal.RenderPass

Methods

raw :: RenderPipeline -> ContT c IO WGPURenderPipeline

data PipelineLayoutDescriptor

Describes a pipeline layout.

Constructors

PipelineLayoutDescriptor

Fields

• pipelineLabel :: !Text

  Debug label of the pipeline layout.

• bindGroupLayouts :: !(Vector BindGroupLayout)

  Bind groups that this pipeline uses.

Instances

Eq PipelineLayoutDescriptor

Defined in WGPU.Internal.Pipeline

Methods

(==) :: PipelineLayoutDescriptor -> PipelineLayoutDescriptor -> Bool

(/=) :: PipelineLayoutDescriptor -> PipelineLayoutDescriptor -> Bool

Show PipelineLayoutDescriptor

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> PipelineLayoutDescriptor -> ShowS

show :: PipelineLayoutDescriptor -> String

showList :: [PipelineLayoutDescriptor] -> ShowS

ToRaw PipelineLayoutDescriptor WGPUPipelineLayoutDescriptor

Defined in WGPU.Internal.Pipeline

Methods

raw :: PipelineLayoutDescriptor -> ContT c IO WGPUPipelineLayoutDescriptor

data RenderPipelineDescriptor

Describes a render (graphics) pipeline.

Constructors

RenderPipelineDescriptor

Fields

• renderPipelineLabel :: !Text

  Debug label of the pipeline.

• layout :: !(SMaybe PipelineLayout)

  The layout of bind groups for this pipeline.

• vertex :: !VertexState

  Vertex state.

• primitive :: !PrimitiveState

  Primitive state.

• depthStencil :: !(SMaybe DepthStencilState)

  Depth stencil state.

• multisample :: !MultisampleState

  Multisample state.

• fragment :: !(SMaybe FragmentState)

  Fragment state.

Instances

Eq RenderPipelineDescriptor

Defined in WGPU.Internal.Pipeline

Methods

(==) :: RenderPipelineDescriptor -> RenderPipelineDescriptor -> Bool

(/=) :: RenderPipelineDescriptor -> RenderPipelineDescriptor -> Bool

Show RenderPipelineDescriptor

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> RenderPipelineDescriptor -> ShowS

show :: RenderPipelineDescriptor -> String

showList :: [RenderPipelineDescriptor] -> ShowS

ToRaw RenderPipelineDescriptor WGPURenderPipelineDescriptor

Defined in WGPU.Internal.Pipeline

Methods

raw :: RenderPipelineDescriptor -> ContT c IO WGPURenderPipelineDescriptor

data VertexFormat

Vertex format for a vertex attribute.

Constructors

VertexFormatUint8x2

VertexFormatUint8x4

VertexFormatSint8x2

VertexFormatSint8x4

VertexFormatUnorm8x2

VertexFormatUnorm8x4

VertexFormatSnorm8x2

VertexFormatSnorm8x4

VertexFormatUint16x2

VertexFormatUint16x4

VertexFormatSint16x2

VertexFormatSint16x4

VertexFormatUnorm16x2

VertexFormatUnorm16x4

VertexFormatSnorm16x2

VertexFormatSnorm16x4

VertexFormatFloat16x2

VertexFormatFloat16x4

VertexFormatFloat32

VertexFormatFloat32x2

VertexFormatFloat32x3

VertexFormatFloat32x4

VertexFormatUint32

VertexFormatUint32x2

VertexFormatUint32x3

VertexFormatUint32x4

VertexFormatSint32

VertexFormatSint32x2

VertexFormatSint32x3

VertexFormatSint32x4

Instances

Eq VertexFormat

Defined in WGPU.Internal.Pipeline

Methods

(==) :: VertexFormat -> VertexFormat -> Bool

(/=) :: VertexFormat -> VertexFormat -> Bool

Show VertexFormat

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> VertexFormat -> ShowS

show :: VertexFormat -> String

showList :: [VertexFormat] -> ShowS

ToRaw VertexFormat WGPUVertexFormat

Convert a VertexFormat to its raw representation.

Defined in WGPU.Internal.Pipeline

Methods

raw :: VertexFormat -> ContT c IO WGPUVertexFormat

data VertexAttribute

Vertex inputs (attributes) to shaders.

Constructors

VertexAttribute

Fields

• vertexFormat :: VertexFormat

  Format of the input.

• offset :: Word64

  Byte offset of the start of the input.

• shaderLocation :: Word32

  Location for this input. Must match the location in the shader.

Instances

Eq VertexAttribute

Defined in WGPU.Internal.Pipeline

Methods

(==) :: VertexAttribute -> VertexAttribute -> Bool

(/=) :: VertexAttribute -> VertexAttribute -> Bool

Show VertexAttribute

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> VertexAttribute -> ShowS

show :: VertexAttribute -> String

showList :: [VertexAttribute] -> ShowS

ToRaw VertexAttribute WGPUVertexAttribute

Defined in WGPU.Internal.Pipeline

Methods

raw :: VertexAttribute -> ContT c IO WGPUVertexAttribute

data InputStepMode

Determines when vertex data is advanced.

Constructors

InputStepModeVertex

Input data is advanced every vertex.

InputStepModeInstance

Input data is advanced every instance.

Instances

Eq InputStepMode

Defined in WGPU.Internal.Pipeline

Methods

(==) :: InputStepMode -> InputStepMode -> Bool

(/=) :: InputStepMode -> InputStepMode -> Bool

Show InputStepMode

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> InputStepMode -> ShowS

show :: InputStepMode -> String

showList :: [InputStepMode] -> ShowS

ToRaw InputStepMode WGPUInputStepMode

Convert an InputStepMode to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: InputStepMode -> ContT c IO WGPUInputStepMode

data VertexBufferLayout

Describes how a vertex buffer is interpreted.

Constructors

VertexBufferLayout

Fields

• arrayStride :: !Word64

  The stride, in bytes, between elements of the buffer.

• stepMode :: !InputStepMode

  How often the vertex buffer is stepped forward (per vertex or per instance).

• attributes :: !(Vector VertexAttribute)

  List of attributes that comprise a single vertex.

Instances

Eq VertexBufferLayout

Defined in WGPU.Internal.Pipeline

Methods

(==) :: VertexBufferLayout -> VertexBufferLayout -> Bool

(/=) :: VertexBufferLayout -> VertexBufferLayout -> Bool

Show VertexBufferLayout

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> VertexBufferLayout -> ShowS

show :: VertexBufferLayout -> String

showList :: [VertexBufferLayout] -> ShowS

ToRaw VertexBufferLayout WGPUVertexBufferLayout

Defined in WGPU.Internal.Pipeline

Methods

raw :: VertexBufferLayout -> ContT c IO WGPUVertexBufferLayout

data VertexState

Describes the vertex process in a render pipeline.

Constructors

VertexState

Fields

• vertexShaderModule :: !ShaderModule

  The compiled shader module for this stage.

• vertexEntryPoint :: !ShaderEntryPoint

  The name of the entry point in the compiled shader. There must be a function that returns void with this name in the shader.

• buffers :: !(Vector VertexBufferLayout)

  The format of any vertex buffers used with this pipeline.

Instances

Eq VertexState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: VertexState -> VertexState -> Bool

(/=) :: VertexState -> VertexState -> Bool

Show VertexState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> VertexState -> ShowS

show :: VertexState -> String

showList :: [VertexState] -> ShowS

ToRaw VertexState WGPUVertexState

Defined in WGPU.Internal.Pipeline

Methods

raw :: VertexState -> ContT c IO WGPUVertexState

data PrimitiveTopology

Primitive type out of which an input mesh is composed.

Constructors

PrimitiveTopologyPointList

PrimitiveTopologyLineList

PrimitiveTopologyLineStrip

PrimitiveTopologyTriangleList

PrimitiveTopologyTriangleStrip

Instances

Eq PrimitiveTopology

Defined in WGPU.Internal.Pipeline

Methods

(==) :: PrimitiveTopology -> PrimitiveTopology -> Bool

(/=) :: PrimitiveTopology -> PrimitiveTopology -> Bool

Show PrimitiveTopology

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> PrimitiveTopology -> ShowS

show :: PrimitiveTopology -> String

showList :: [PrimitiveTopology] -> ShowS

Default PrimitiveTopology

Defined in WGPU.Internal.Pipeline

Methods

def :: PrimitiveTopology

ToRaw PrimitiveTopology WGPUPrimitiveTopology

Convert a PrimitiveTopology to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: PrimitiveTopology -> ContT c IO WGPUPrimitiveTopology

data IndexFormat

Format of indices used within a pipeline.

Constructors

IndexFormatUint16

Indices are 16-bit unsigned integers (Word16)

IndexFormatUint32

Indices are 32-bit unsigned integers (Word32)

Instances

Eq IndexFormat

Defined in WGPU.Internal.Pipeline

Methods

(==) :: IndexFormat -> IndexFormat -> Bool

(/=) :: IndexFormat -> IndexFormat -> Bool

Show IndexFormat

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> IndexFormat -> ShowS

show :: IndexFormat -> String

showList :: [IndexFormat] -> ShowS

ToRaw IndexFormat WGPUIndexFormat

Convert an IndexFormat to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: IndexFormat -> ContT c IO WGPUIndexFormat

data FrontFace

Winding order which classifies the "front" face.

Constructors

FrontFaceCCW

Triangles with counter-clockwise vertices are the front face.

FrontFaceCW

Triangles with clockwise vertices are the front face.

Instances

Eq FrontFace

Defined in WGPU.Internal.Pipeline

Methods

(==) :: FrontFace -> FrontFace -> Bool

(/=) :: FrontFace -> FrontFace -> Bool

Show FrontFace

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> FrontFace -> ShowS

show :: FrontFace -> String

showList :: [FrontFace] -> ShowS

Default FrontFace

Defined in WGPU.Internal.Pipeline

Methods

def :: FrontFace

ToRaw FrontFace WGPUFrontFace

Convert a FrontFace to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: FrontFace -> ContT c IO WGPUFrontFace

data CullMode

Whether to cull the face of a vertex.

Constructors

CullModeFront

Cull the front face.

CullModeBack

Cull the back face.

CullModeNone

Do not cull either face.

Instances

Eq CullMode

Defined in WGPU.Internal.Pipeline

Methods

(==) :: CullMode -> CullMode -> Bool

(/=) :: CullMode -> CullMode -> Bool

Show CullMode

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> CullMode -> ShowS

show :: CullMode -> String

showList :: [CullMode] -> ShowS

Default CullMode

Defined in WGPU.Internal.Pipeline

Methods

def :: CullMode

ToRaw CullMode WGPUCullMode

Convert a CullMode to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: CullMode -> ContT c IO WGPUCullMode

data PrimitiveState

Describes the state of primitive assembly and rasterization in a render pipeline.

Differences between this and the Rust API: - no clamp_depth member - no polygon_mode member - no conservative member

Constructors

PrimitiveState

Fields

• topology :: !PrimitiveTopology

  The primitive topology used to interpret vertices.

• stripIndexFormat :: !(SMaybe IndexFormat)

  When drawing strip topologies with indices, this is the required format for the index buffer. This has no effect for non-indexed or non-strip draws.

• frontFace :: !FrontFace

  The face to consider the front for the purpose of culling and stencil operations.

• cullMode :: !CullMode

  The face culling mode.

Instances

Eq PrimitiveState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: PrimitiveState -> PrimitiveState -> Bool

(/=) :: PrimitiveState -> PrimitiveState -> Bool

Show PrimitiveState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> PrimitiveState -> ShowS

show :: PrimitiveState -> String

showList :: [PrimitiveState] -> ShowS

Default PrimitiveState

Defined in WGPU.Internal.Pipeline

Methods

def :: PrimitiveState

ToRaw PrimitiveState WGPUPrimitiveState

Defined in WGPU.Internal.Pipeline

Methods

raw :: PrimitiveState -> ContT c IO WGPUPrimitiveState

data StencilOperation

Operation to perform on a stencil value.

Constructors

StencilOperationKeep

StencilOperationZero

StencilOperationReplace

StencilOperationInvert

StencilOperationIncrementClamp

StencilOperationDecrementClamp

StencilOperationIncrementWrap

StencilOperationDecrementWrap

Instances

Eq StencilOperation

Defined in WGPU.Internal.Pipeline

Methods

(==) :: StencilOperation -> StencilOperation -> Bool

(/=) :: StencilOperation -> StencilOperation -> Bool

Show StencilOperation

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> StencilOperation -> ShowS

show :: StencilOperation -> String

showList :: [StencilOperation] -> ShowS

ToRaw StencilOperation WGPUStencilOperation

Convert a StencilOperation to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: StencilOperation -> ContT c IO WGPUStencilOperation

data StencilState

State of the stencil operation (fixed pipeline stage).

Constructors

StencilState

Fields

• front :: !StencilFaceState

  Front face mode.

• back :: !StencilFaceState

  Back face mode.

• readMask :: !Word8

  Stencil values are AND-ed with this mask when reading and writing from the stencil buffer.

• writeMask :: !Word8

  Stencil values are AND-ed with this mask when writing to the stencil buffer.

Instances

Eq StencilState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: StencilState -> StencilState -> Bool

(/=) :: StencilState -> StencilState -> Bool

Show StencilState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> StencilState -> ShowS

show :: StencilState -> String

showList :: [StencilState] -> ShowS

data DepthBiasState

Describes the biasing setting for the depth target.

Constructors

DepthBiasState

Fields

• constant :: !Int32
• slopeScale :: !Float

  Slope depth biasing factor.

• clamp :: !Float

  Depth bias clamp value (absolute).

Instances

Eq DepthBiasState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: DepthBiasState -> DepthBiasState -> Bool

(/=) :: DepthBiasState -> DepthBiasState -> Bool

Show DepthBiasState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> DepthBiasState -> ShowS

show :: DepthBiasState -> String

showList :: [DepthBiasState] -> ShowS

data DepthStencilState

Describes the depth / stencil state of a render pipeline.

Constructors

DepthStencilState

Fields

• depthStencilTextureFormat :: !TextureFormat

  Format of the depth/stencil buffer. This must be a special depth format, and must match the format of the depth/stencil attachment in the command encoder.

• depthWriteEnabled :: !Bool

  If disabled, depth will not be written to.

• depthCompare :: !CompareFunction

  Comparison function used to compare depth values in the depth test.

• stencil :: !StencilState

  Stencil state.

• bias :: !DepthBiasState

  Depth bias state.

Instances

Eq DepthStencilState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: DepthStencilState -> DepthStencilState -> Bool

(/=) :: DepthStencilState -> DepthStencilState -> Bool

Show DepthStencilState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> DepthStencilState -> ShowS

show :: DepthStencilState -> String

showList :: [DepthStencilState] -> ShowS

ToRaw DepthStencilState WGPUDepthStencilState

Defined in WGPU.Internal.Pipeline

Methods

raw :: DepthStencilState -> ContT c IO WGPUDepthStencilState

data MultisampleState

Describes the multi-sampling state of a render pipeline.

Constructors

MultisampleState

Fields

• count :: Word32

  Number of samples calculated per pixel (for MSAA). For non-multisampled textures, this should be 1.

• mask :: Word32

  Bitmask that restricts the samples of a pixel modified by this pipeline. All samples can be enabled by using 0XFFFFFFFF (ie. zero complement).

• alphaToCoverageEnabled :: Bool

  When enabled, produces another sample mask per pixel based on the alpha output value, and that is AND-ed with the sample mask and the primitive coverage to restrict the set of samples affected by a primitive.

Instances

Eq MultisampleState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: MultisampleState -> MultisampleState -> Bool

(/=) :: MultisampleState -> MultisampleState -> Bool

Show MultisampleState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> MultisampleState -> ShowS

show :: MultisampleState -> String

showList :: [MultisampleState] -> ShowS

ToRaw MultisampleState WGPUMultisampleState

Defined in WGPU.Internal.Pipeline

Methods

raw :: MultisampleState -> ContT c IO WGPUMultisampleState

data BlendFactor

Alpha blend factor.

Constructors

BlendFactorZero

BlendFactorOne

BlendFactorSrc

BlendFactorOneMinusSrc

BlendFactorSrcAlpha

BlendFactorOneMinusSrcAlpha

BlendFactorDst

BlendFactorOneMinusDst

BlendFactorDstAlpha

BlendFactorOneMinusDstAlpha

BlendFactorSrcAlphaSaturated

BlendFactorConstant

BlendFactorOneMinusConstant

Instances

Eq BlendFactor

Defined in WGPU.Internal.Pipeline

Methods

(==) :: BlendFactor -> BlendFactor -> Bool

(/=) :: BlendFactor -> BlendFactor -> Bool

Show BlendFactor

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> BlendFactor -> ShowS

show :: BlendFactor -> String

showList :: [BlendFactor] -> ShowS

ToRaw BlendFactor WGPUBlendFactor

Convert a BlendFactor to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: BlendFactor -> ContT c IO WGPUBlendFactor

data BlendOperation

Alpha blending operation.

Constructors

BlendOperationAdd

BlendOperationSubtract

BlendOperationReverseSubtract

BlendOperationMin

BlendOperationMax

Instances

Eq BlendOperation

Defined in WGPU.Internal.Pipeline

Methods

(==) :: BlendOperation -> BlendOperation -> Bool

(/=) :: BlendOperation -> BlendOperation -> Bool

Show BlendOperation

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> BlendOperation -> ShowS

show :: BlendOperation -> String

showList :: [BlendOperation] -> ShowS

ToRaw BlendOperation WGPUBlendOperation

Convert a BlendOperation to its raw value.

Defined in WGPU.Internal.Pipeline

Methods

raw :: BlendOperation -> ContT c IO WGPUBlendOperation

data BlendComponent

Describes the blend component of a pipeline.

Constructors

BlendComponent

Fields

• srcFactor :: !BlendFactor

  Multiplier for the source, which is produced by the fragment shader.

• dstFactor :: !BlendFactor

  Multiplier for the destination, which is stored in the target.

• operation :: !BlendOperation

  Binary operation applied to the source and destination, multiplied by their respective factors.

Instances

Eq BlendComponent

Defined in WGPU.Internal.Pipeline

Methods

(==) :: BlendComponent -> BlendComponent -> Bool

(/=) :: BlendComponent -> BlendComponent -> Bool

Show BlendComponent

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> BlendComponent -> ShowS

show :: BlendComponent -> String

showList :: [BlendComponent] -> ShowS

Default BlendComponent

Defined in WGPU.Internal.Pipeline

Methods

def :: BlendComponent

ToRaw BlendComponent WGPUBlendComponent

Defined in WGPU.Internal.Pipeline

Methods

raw :: BlendComponent -> ContT c IO WGPUBlendComponent

data BlendState

Describes the blend state of a render pipeline.

Constructors

BlendState

Fields

• blendColor :: !BlendComponent

  Color equation.

• blendAlpha :: !BlendComponent

  Alpha equation.

Instances

Eq BlendState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: BlendState -> BlendState -> Bool

(/=) :: BlendState -> BlendState -> Bool

Show BlendState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> BlendState -> ShowS

show :: BlendState -> String

showList :: [BlendState] -> ShowS

ToRaw BlendState WGPUBlendState

Defined in WGPU.Internal.Pipeline

Methods

raw :: BlendState -> ContT c IO WGPUBlendState

data ColorWriteMask

Describes which color channels are written.

Constructors

ColorWriteMask

Fields

• maskRed :: !Bool
• maskGreen :: !Bool
• maskBlue :: !Bool
• maskAlpha :: !Bool

Instances

Eq ColorWriteMask

Defined in WGPU.Internal.Pipeline

Methods

(==) :: ColorWriteMask -> ColorWriteMask -> Bool

(/=) :: ColorWriteMask -> ColorWriteMask -> Bool

Show ColorWriteMask

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> ColorWriteMask -> ShowS

show :: ColorWriteMask -> String

showList :: [ColorWriteMask] -> ShowS

ToRaw ColorWriteMask WGPUColorWriteMask

Defined in WGPU.Internal.Pipeline

Methods

raw :: ColorWriteMask -> ContT c IO WGPUColorWriteMask

data ColorTargetState

Describes the color state of a render pipeline.

Constructors

ColorTargetState

Fields

• colorTextureFormat :: !TextureFormat

  The texture format of the image that this pipeline will render to. Must match the format of the corresponding color attachment in the command encoder.

• blend :: !(SMaybe BlendState)

  The blending that is used for this pipeline.

• colorWriteMask :: !ColorWriteMask

  Mask which enables or disables writes to different color/alpha channels.

Instances

Eq ColorTargetState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: ColorTargetState -> ColorTargetState -> Bool

(/=) :: ColorTargetState -> ColorTargetState -> Bool

Show ColorTargetState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> ColorTargetState -> ShowS

show :: ColorTargetState -> String

showList :: [ColorTargetState] -> ShowS

ToRaw ColorTargetState WGPUColorTargetState

Defined in WGPU.Internal.Pipeline

Methods

raw :: ColorTargetState -> ContT c IO WGPUColorTargetState

data FragmentState

Describes the fragment processing in a render pipeline.

Constructors

FragmentState

Fields

• fragmentShaderModule :: !ShaderModule

  The compiled shader module for this stage.

• fragmentEntryPoint :: !ShaderEntryPoint

  The entry point in the compiled shader. There must be a function that returns void with this name in the shader.

• targets :: !(Vector ColorTargetState)

  The color state of the render targets.

Instances

Eq FragmentState

Defined in WGPU.Internal.Pipeline

Methods

(==) :: FragmentState -> FragmentState -> Bool

(/=) :: FragmentState -> FragmentState -> Bool

Show FragmentState

Defined in WGPU.Internal.Pipeline

Methods

showsPrec :: Int -> FragmentState -> ShowS

show :: FragmentState -> String

showList :: [FragmentState] -> ShowS

ToRaw FragmentState WGPUFragmentState

Defined in WGPU.Internal.Pipeline

Methods

raw :: FragmentState -> ContT c IO WGPUFragmentState

createPipelineLayout

Arguments

:: Device

The device for which the pipeline layout will be created.

-> PipelineLayoutDescriptor

Descriptor of the pipeline.

-> IO PipelineLayout

Create a pipeline layout.

createRenderPipeline :: Device -> RenderPipelineDescriptor -> IO RenderPipeline

colorWriteMaskAll :: ColorWriteMask

A ColorWriteMask that writes all colors and the alpha value.

Command Buffers

data CommandBuffer

Instances

Eq CommandBuffer

Defined in WGPU.Internal.CommandBuffer

Methods

(==) :: CommandBuffer -> CommandBuffer -> Bool

(/=) :: CommandBuffer -> CommandBuffer -> Bool

Show CommandBuffer

Defined in WGPU.Internal.CommandBuffer

Methods

showsPrec :: Int -> CommandBuffer -> ShowS

show :: CommandBuffer -> String

showList :: [CommandBuffer] -> ShowS

ToRaw CommandBuffer WGPUCommandBuffer

Defined in WGPU.Internal.CommandBuffer

Methods

raw :: CommandBuffer -> ContT c IO WGPUCommandBuffer

Command Encoding

data CommandEncoder

Handle to an encoder for a series of GPU operations.

A command encoder can record render passes, compute passes, and transfer operations between driver-managed resources like buffers and textures.

Instances

Eq CommandEncoder

Defined in WGPU.Internal.CommandEncoder

Methods

(==) :: CommandEncoder -> CommandEncoder -> Bool

(/=) :: CommandEncoder -> CommandEncoder -> Bool

Show CommandEncoder

Defined in WGPU.Internal.CommandEncoder

Methods

showsPrec :: Int -> CommandEncoder -> ShowS

show :: CommandEncoder -> String

showList :: [CommandEncoder] -> ShowS

ToRaw CommandEncoder WGPUCommandEncoder

Defined in WGPU.Internal.CommandEncoder

Methods

raw :: CommandEncoder -> ContT c IO WGPUCommandEncoder

data RenderPassEncoder

Instances

Eq RenderPassEncoder

Defined in WGPU.Internal.RenderPass

Methods

(==) :: RenderPassEncoder -> RenderPassEncoder -> Bool

(/=) :: RenderPassEncoder -> RenderPassEncoder -> Bool

Show RenderPassEncoder

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> RenderPassEncoder -> ShowS

show :: RenderPassEncoder -> String

showList :: [RenderPassEncoder] -> ShowS

ToRaw RenderPassEncoder WGPURenderPassEncoder

Defined in WGPU.Internal.RenderPass

Methods

raw :: RenderPassEncoder -> ContT c IO WGPURenderPassEncoder

data Color

RGBA double-precision color.

Constructors

Color

Fields

• red :: Double
• green :: Double
• blue :: Double
• alpha :: Double

Instances

Eq Color

Defined in WGPU.Internal.Color

Methods

(==) :: Color -> Color -> Bool

(/=) :: Color -> Color -> Bool

Show Color

Defined in WGPU.Internal.Color

Methods

showsPrec :: Int -> Color -> ShowS

show :: Color -> String

showList :: [Color] -> ShowS

ToRaw Color WGPUColor

Defined in WGPU.Internal.Color

Methods

raw :: Color -> ContT c IO WGPUColor

data LoadOp a

Operation to perform to the output attachment at the start of a render pass.

Constructors

LoadOpClear !a

Clear with the specified color value.

LoadOpLoad

Load from memory.

Instances

Eq a => Eq (LoadOp a)

Defined in WGPU.Internal.RenderPass

Methods

(==) :: LoadOp a -> LoadOp a -> Bool

(/=) :: LoadOp a -> LoadOp a -> Bool

Show a => Show (LoadOp a)

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> LoadOp a -> ShowS

show :: LoadOp a -> String

showList :: [LoadOp a] -> ShowS

data StoreOp

Operation to perform to the output attachment at the end of the render pass.

Constructors

StoreOpStore

Store the result.

StoreOpClear

Discard the result.

Instances

Eq StoreOp

Defined in WGPU.Internal.RenderPass

Methods

(==) :: StoreOp -> StoreOp -> Bool

(/=) :: StoreOp -> StoreOp -> Bool

Show StoreOp

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> StoreOp -> ShowS

show :: StoreOp -> String

showList :: [StoreOp] -> ShowS

ToRaw StoreOp WGPUStoreOp

Defined in WGPU.Internal.RenderPass

Methods

raw :: StoreOp -> ContT c IO WGPUStoreOp

data Operations a

Constructors

Operations

Fields

• load :: !(LoadOp a)
• store :: StoreOp

Instances

Eq a => Eq (Operations a)

Defined in WGPU.Internal.RenderPass

Methods

(==) :: Operations a -> Operations a -> Bool

(/=) :: Operations a -> Operations a -> Bool

Show a => Show (Operations a)

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> Operations a -> ShowS

show :: Operations a -> String

showList :: [Operations a] -> ShowS

data RenderPassColorAttachment

Describes a color attachment to a render pass.

Constructors

RenderPassColorAttachment

Fields

• colorView :: !TextureView

  The view to use as an attachment.

• resolveTarget :: !(SMaybe TextureView)

  The view that will receive output if multisampling is used.

• operations :: !(Operations Color)

  What operations will be performed on this color attachment.

Instances

Eq RenderPassColorAttachment

Defined in WGPU.Internal.RenderPass

Methods

(==) :: RenderPassColorAttachment -> RenderPassColorAttachment -> Bool

(/=) :: RenderPassColorAttachment -> RenderPassColorAttachment -> Bool

Show RenderPassColorAttachment

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> RenderPassColorAttachment -> ShowS

show :: RenderPassColorAttachment -> String

showList :: [RenderPassColorAttachment] -> ShowS

ToRaw RenderPassColorAttachment WGPURenderPassColorAttachment

Defined in WGPU.Internal.RenderPass

Methods

raw :: RenderPassColorAttachment -> ContT c IO WGPURenderPassColorAttachment

data RenderPassDepthStencilAttachment

Describes a depth/stencil attachment to a render pass.

Constructors

RenderPassDepthStencilAttachment

Fields

• depthStencilView :: !TextureView

  The view to use as an attachment.

• depthOps :: !(SMaybe (Operations Float))

  What operations will be performed on the depth part.

• stencilOps :: !(SMaybe (Operations Word32))

  What operations will be performed on the stencil part.

Instances

Eq RenderPassDepthStencilAttachment

Defined in WGPU.Internal.RenderPass

Methods

(==) :: RenderPassDepthStencilAttachment -> RenderPassDepthStencilAttachment -> Bool

(/=) :: RenderPassDepthStencilAttachment -> RenderPassDepthStencilAttachment -> Bool

Show RenderPassDepthStencilAttachment

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> RenderPassDepthStencilAttachment -> ShowS

show :: RenderPassDepthStencilAttachment -> String

showList :: [RenderPassDepthStencilAttachment] -> ShowS

ToRaw RenderPassDepthStencilAttachment WGPURenderPassDepthStencilAttachment

Defined in WGPU.Internal.RenderPass

Methods

raw :: RenderPassDepthStencilAttachment -> ContT c IO WGPURenderPassDepthStencilAttachment

data RenderPassDescriptor

Describes the attachments of a render pass.

Constructors

RenderPassDescriptor

Fields

• renderPassLabel :: !Text

  Debugging label for the render pass.

• colorAttachments :: !(Vector RenderPassColorAttachment)

  Color attachments of the render pass.

• depthStencilAttachment :: !(SMaybe RenderPassDepthStencilAttachment)

  Depth and stencil attachments of the render pass.

Instances

Eq RenderPassDescriptor

Defined in WGPU.Internal.RenderPass

Methods

(==) :: RenderPassDescriptor -> RenderPassDescriptor -> Bool

(/=) :: RenderPassDescriptor -> RenderPassDescriptor -> Bool

Show RenderPassDescriptor

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> RenderPassDescriptor -> ShowS

show :: RenderPassDescriptor -> String

showList :: [RenderPassDescriptor] -> ShowS

ToRaw RenderPassDescriptor WGPURenderPassDescriptor

Defined in WGPU.Internal.RenderPass

Methods

raw :: RenderPassDescriptor -> ContT c IO WGPURenderPassDescriptor

data Range a

Half open range. It includes the start value but not the end value.

Constructors

Range

Fields

• rangeStart :: !a
• rangeLength :: !a

Instances

Eq a => Eq (Range a)

Defined in WGPU.Internal.RenderPass

Methods

(==) :: Range a -> Range a -> Bool

(/=) :: Range a -> Range a -> Bool

Show a => Show (Range a)

Defined in WGPU.Internal.RenderPass

Methods

showsPrec :: Int -> Range a -> ShowS

show :: Range a -> String

showList :: [Range a] -> ShowS

createCommandEncoder

Arguments

:: Device

Device for which to create the command encoder.

-> Text

Debug label for the command encoder.

-> IO CommandEncoder

IO action that returns the command encoder.

Create an empty command encoder.

commandEncoderFinish

Arguments

:: CommandEncoder

Command encoder to finish.

-> Text

Debugging label for the command buffer.

-> IO CommandBuffer

IO action which returns the command buffer.

Finish encoding commands, returning a command buffer.

beginRenderPass

Arguments

:: CommandEncoder

CommandEncoder to contain the render pass.

-> RenderPassDescriptor

Description of the render pass.

-> IO RenderPassEncoder

IO action which returns the render pass encoder.

Begins recording of a render pass.

renderPassSetPipeline

Arguments

:: RenderPassEncoder

Render pass encoder on which to act.

-> RenderPipeline

Render pipeline to set active.

-> IO ()

IO action which sets the active render pipeline.

Sets the active render pipeline.

Subsequent draw calls will exhibit the behaviour defined by the pipeline.

renderPassDraw

Arguments

:: RenderPassEncoder

Render pass encoder on which to act.

-> Range Word32

Range of vertices to draw.

-> Range Word32

Range of instances to draw.

-> IO ()

IO action which stores the draw command.

Draws primitives from the active vertex buffers.

endRenderPass

Arguments

:: RenderPassEncoder

Render pass encoder on which to finish recording.

-> IO ()

IO action that finishes recording.

Finish recording of a render pass.

Queue

data Queue

Instances

Eq Queue

Defined in WGPU.Internal.Queue

Methods

(==) :: Queue -> Queue -> Bool

(/=) :: Queue -> Queue -> Bool

Show Queue

Defined in WGPU.Internal.Queue

Methods

showsPrec :: Int -> Queue -> ShowS

show :: Queue -> String

showList :: [Queue] -> ShowS

ToRaw Queue WGPUQueue

Defined in WGPU.Internal.Queue

Methods

raw :: Queue -> ContT c IO WGPUQueue

getQueue :: Device -> IO Queue

Get the queue for a device.

queueSubmit :: Queue -> Vector CommandBuffer -> IO ()

Submit a list of command buffers to a device queue.

Version

data Version

Version of WGPU native.

Constructors

Version

Fields

• major :: !Word8
• minor :: !Word8
• patch :: !Word8
• subPatch :: !Word8

Instances

Eq Version

Defined in WGPU.Internal.Instance

Methods

(==) :: Version -> Version -> Bool

(/=) :: Version -> Version -> Bool

Show Version

Defined in WGPU.Internal.Instance

Methods

showsPrec :: Int -> Version -> ShowS

show :: Version -> String

showList :: [Version] -> ShowS

getVersion :: Instance -> IO Version

Return the exact version of the WGPU native instance.

versionToText :: Version -> Text

Convert a Version value to a text string.

>>> versionToText (Version 0 9 2 2)
"v0.9.2.2"

Logging

data LogLevel

Logging level.

Constructors

Trace

Debug

Info

Warn

Error

Instances

Eq LogLevel

Defined in WGPU.Internal.Instance

Methods

(==) :: LogLevel -> LogLevel -> Bool

(/=) :: LogLevel -> LogLevel -> Bool

Show LogLevel

Defined in WGPU.Internal.Instance

Methods

showsPrec :: Int -> LogLevel -> ShowS

show :: LogLevel -> String

showList :: [LogLevel] -> ShowS

type LogCallback = LogLevel -> Text -> IO ()

Logging callback function.

setLogLevel :: Instance -> LogLevel -> IO ()

Set the current logging level for the instance.

logStdout :: LogLevel -> Text -> IO ()

A logging function which prints to stdout.

This logging function can be supplied to withInstance to print logging messages to stdout for debugging purposes.

logLevelToText :: LogLevel -> Text

Convert a LogLevel to a text string.

Multipurpose

data CompareFunction

Comparison function used for depth and stencil operations.

Constructors

CompareFunctionNever

CompareFunctionLess

CompareFunctionEqual

CompareFunctionLessEqual

CompareFunctionGreater

CompareFunctionNotEqual

CompareFunctionGreaterEqual

CompareFunctionAlways

Instances

Eq CompareFunction

Defined in WGPU.Internal.Multipurpose

Methods

(==) :: CompareFunction -> CompareFunction -> Bool

(/=) :: CompareFunction -> CompareFunction -> Bool

Show CompareFunction

Defined in WGPU.Internal.Multipurpose

Methods

showsPrec :: Int -> CompareFunction -> ShowS

show :: CompareFunction -> String

showList :: [CompareFunction] -> ShowS

ToRaw CompareFunction WGPUCompareFunction

Convert a CompareFunction to its raw value.

Defined in WGPU.Internal.Multipurpose

Methods

raw :: CompareFunction -> ContT c IO WGPUCompareFunction

Extras

Strict Maybe

data SMaybe a

Strict version of the Maybe type.

Constructors

SNothing

SJust !a

Instances

Eq a => Eq (SMaybe a)

Defined in WGPU.Internal.SMaybe

Methods

(==) :: SMaybe a -> SMaybe a -> Bool

(/=) :: SMaybe a -> SMaybe a -> Bool

Show a => Show (SMaybe a)

Defined in WGPU.Internal.SMaybe

Methods

showsPrec :: Int -> SMaybe a -> ShowS

show :: SMaybe a -> String

showList :: [SMaybe a] -> ShowS