gpu

Oct 31, 2026

Changes in this version

+ const AcceptedFeaturesWebGPUBatch

+ const CapsetWebGPUBatch

+ const CmdGetCapset

+ const CmdGetCapsetInfo

+ const FlagFence

+ const FlagInfoRingIdx

+ const RespOKCapset

+ const RespOKCapsetInfo

+ var ErrBadContext = commonGPUError("go-virtio/gpu: context id 0")

+ var ErrEmptyFrame = commonGPUError("go-virtio/gpu: empty webgpu-batch frame")

+ var ErrFenceNotEchoed = commonGPUError(...)

+ var ErrFrameTooLarge = commonGPUError("go-virtio/gpu: webgpu-batch frame too large for one SUBMIT_3D")

+ var ErrNotWebGPUBatch = commonGPUError("go-virtio/gpu: capset is not webgpu-batch")

+ var ErrRingIndex = commonGPUError("go-virtio/gpu: ring index above 63")

+ var ErrVirglBufferTooLarge = commonGPUError("go-virtio/gpu: virgl command buffer above 1024 bytes")

+ var ErrWebGPUBatchUnavailable = commonGPUError(...)

+ func DecodeRespCapset(resp []byte, maxSize uint32) ([]byte, bool)

+ func DecodeWebGPUBatchCaps(resp []byte, info CapsetInfo) (wgpubatch.Caps, error)

+ func EncodeCtxCreateWebGPUBatch(ctxID uint32, debugName string) []byte

+ func EncodeGetCapset(id, version uint32) []byte

+ func EncodeGetCapsetInfo(index uint32) []byte

+ func EncodeSubmit3DHeader(ctx uint32, size uint32, fence Fence) ([]byte, error)

+ func NegotiateWebGPUBatchFeatures(deviceFeatures uint64) (negotiated uint64, ok bool)

+ type CapsetInfo struct

+ ID uint32

+ MaxSize uint32

+ MaxVersion uint32

+ func DecodeRespCapsetInfo(resp []byte) (CapsetInfo, bool)

+ type Fence struct

+ ID uint64

+ On bool

+ Ring uint8

+ Ringed bool

type VirtioGPU

+ func OpenVirtioGPUWebGPUBatch(t common.Transport) (*VirtioGPU, error)

+ func (g *VirtioGPU) CreateWebGPUBatchContext(ctxID uint32, debugName string) error

+ func (g *VirtioGPU) SubmitWebGPUBatch(ctxID uint32, frame []byte, fence Fence) error

+ func (g *VirtioGPU) WebGPUBatchCaps() (wgpubatch.Caps, error)

Jun 10, 2026

Changes in this version

+ const AcceptedFeaturesVenus

+ const BlobFlagUseCrossDevice

+ const BlobFlagUseMappable

+ const BlobFlagUseShareable

+ const BlobMemGuest

+ const BlobMemHost3D

+ const BlobMemHost3DGuest

+ const CapsetVenus

+ const CapsetVirgl

+ const CapsetVirgl2

+ const CmdResourceCreateBlob

+ const CmdResourceMapBlob

+ const CmdResourceUnmapBlob

+ const CmdSetScanoutBlob

+ const FeatureContextInit

+ const FeatureResourceBlob

+ const RespOKMapInfo

+ func DecodeRespMapInfo(resp []byte) (mapInfo uint32, ok bool)

+ func EncodeCtxCreateVenus(ctxID uint32, debugName string) []byte

+ func EncodeResourceCreateBlob(p BlobCreateParams) []byte

+ func EncodeResourceMapBlob(ctxID, resourceID uint32, offset uint64) []byte

+ func NegotiateVenusFeatures(deviceFeatures uint64) (negotiated uint64, ok bool)

+ type BlobCreateParams struct

+ BlobFlags uint32

+ BlobID uint64

+ BlobMem uint32

+ CtxID uint32

+ NrEntries uint32

+ ResourceID uint32

+ Size uint64

Jun 10, 2026

Changes in this version

type VirtioGPU

+ func (g *VirtioGPU) DrawTexturedTriangle(scanoutID uint32, verts [15]float32, tex []byte, texW, texH uint32) error

Jun 10, 2026

Changes in this version

type VirtioGPU

+ func (g *VirtioGPU) DrawTriangle(scanoutID uint32, verts [9]float32, color [4]float32) error

Jun 9, 2026

Changes in this version

+ const AcceptedFeatures3D

+ const CmdCtxAttachResource

+ const CmdCtxCreate

+ const CmdCtxDestroy

+ const CmdCtxDetachResource

+ const CmdResourceCreate3D

+ const CmdSubmit3D

+ const CmdTransferFromHost3D

+ const CmdTransferToHost3D

+ const FeatureVirgl

+ var ErrVirglUnavailable = commonGPUError("go-virtio/gpu: host does not support VIRTIO_GPU_F_VIRGL (no virglrenderer)")

type VirtioGPU

+ func OpenVirtioGPU3D(t common.Transport) (*VirtioGPU, error)

+ func (g *VirtioGPU) ClearScreen(scanoutID uint32, r, gr, b, a float32) error

Jun 9, 2026

Changes in this version

+ const AcceptedFeatures

+ const CommandPollIterations

+ const ControlQueueIdx

+ const ControlQueueSize

+ const CursorQueueIdx

+ const CursorQueueSize

+ const DeviceType

+ var ErrFeaturesNotOK = commonGPUError("go-virtio/gpu: FEATURES_OK status bit didn't stick after DriverFeature write")

+ var ErrFramebufferTooLarge = commonGPUError("go-virtio/gpu: framebuffer dimensions are zero or exceed the supported bound")

+ var ErrGPUCommandFailed = commonGPUError("go-virtio/gpu: device returned an error response to a control command")

+ var ErrInitWrongDeviceID = commonGPUError("go-virtio/gpu: PCI device ID is not 0x1050 (modern GPU device)")

+ var ErrNoScanout = commonGPUError("go-virtio/gpu: no usable scanout (none enabled, or scanout id out of range)")

+ var ErrNotModernDevice = commonGPUError("go-virtio/gpu: device doesn't offer VIRTIO_F_VERSION_1 (legacy-only)")

+ var ErrQueueNotAvailable = commonGPUError("go-virtio/gpu: device reports QueueSize=0 for a required queue")

+ var ErrRequestTimeout = commonGPUError("go-virtio/gpu: command poll timeout (device did not complete the command)")

+ func AcceptFeatures(deviceFeatures uint64) (uint64, error)

+ type Display struct

+ Enabled bool

+ Height uint32

+ ScanoutID uint32

+ Width uint32

+ type Framebuffer struct

+ Height uint32

+ Pix []byte

+ ResourceID uint32

+ Width uint32

+ func (fb *Framebuffer) Flush() error

+ type VirtioGPU struct

+ Cfg *common.ModernConfig

+ NegotiatedFeatures uint64

+ NumScanouts uint32

+ func OpenVirtioGPU(t common.Transport) (*VirtioGPU, error)

+ func (g *VirtioGPU) ControlQueue() *common.Virtqueue

+ func (g *VirtioGPU) DisplayInfo() ([]Display, error)

+ func (g *VirtioGPU) SetupFramebuffer(scanoutID, width, height uint32) (*Framebuffer, error)