replay

package
v1.7.0-dev-20191021 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 18, 2019 License: Apache-2.0 Imports: 36 Imported by: 41

Documentation

Overview

Package replay is used to issue replay requests to replay devices.

Index

Constants

This section is empty.

Variables

View Source 
var Events struct {
	// OnReplay is called when a replay batch is sent to a device.
	OnReplay func(bind.Device, Intent, Config)
}

Events holds a number of callback functions that can be used to monitor replay activity.

Functions

func Execute added in v1.3.1 

func Execute(
	ctx context.Context,
	dependent string,
	payload gapir.Payload,
	handlePost builder.PostDataHandler,
	handleNotification builder.NotificationHandler,
	connection *backgroundConnection,
	memoryLayout *device.MemoryLayout,
	os *device.OS) error

Execute sends the replay payload for execution on the target replay device communicating on connection. decoder will be used for decoding all postback reponses. Once a postback response is decoded, the corresponding handler in the handlers map will be called.

func GetDevice added in v1.2.0 

func GetDevice(ctx context.Context) *path.Device

GetDevice retrieves the target replay device from a context previously annotated by PutDevice.

func GetTimestamps added in v1.3.1 

func GetTimestamps(ctx context.Context, capturePath *path.Capture, device *path.Device, loopCount int32, handler service.TimeStampsHandler) error

GetTimestamps replays the trace and return the start and end timestamps for each commandbuffers

func MakeBackgroundConnection added in v1.5.0 

func MakeBackgroundConnection(ctx context.Context, device bind.Device, conn gapir.Connection, replayABI *device.ABI) (*backgroundConnection, error)

MakeBackgroundConnection creates a connection to the replay device that persists in the background.

func NewMappingPrinter added in v1.2.0 

func NewMappingPrinter(ctx context.Context, path string) transform.Transformer

func PutDevice added in v1.2.0 

func PutDevice(ctx context.Context, m *path.Device) context.Context

PutDevice attaches a target replay device to a Context.

func PutManager 

func PutManager(ctx context.Context, m Manager) context.Context

PutManager attaches a manager to a Context.

Types

type Config 

type Config interface{}

Config is a user-defined type used to describe the type of replay being requested. Replay requests made with configs that have equality (==) will likely be batched into the same replay pass. Configs can be used to force requests into different replay passes. For example, by issuing requests with different configs we can prevent a profiling Request from being issued in the same pass as a Request to render all draw calls in wireframe.

type Custom 

type Custom struct {
	T uint64 // The thread ID
	F func(ctx context.Context, s *api.GlobalState, b *builder.Builder) error
}

Custom is a command issuing custom replay operations to the replay builder b upon Replay().

func (Custom) API 

func (Custom) API() api.API

func (Custom) Alive added in v1.2.0 

func (Custom) Alive() bool

func (Custom) Caller added in v0.6.0 

func (Custom) Caller() api.CmdID

api.Cmd compliance

func (Custom) Clone added in v1.2.0 

func (cmd Custom) Clone(arena.Arena) api.Cmd

func (Custom) CmdFlags 

func (Custom) CmdFlags(context.Context, api.CmdID, *api.GlobalState) api.CmdFlags

func (Custom) CmdName 

func (Custom) CmdName() string

func (Custom) CmdParams added in v1.2.0 

func (Custom) CmdParams() api.Properties

func (Custom) CmdResult added in v1.2.0 

func (Custom) CmdResult() *api.Property

func (Custom) Extras 

func (Custom) Extras() *api.CmdExtras

func (Custom) Mutate 

func (c Custom) Mutate(ctx context.Context, id api.CmdID, s *api.GlobalState,
	b *builder.Builder, w api.StateWatcher) error

func (Custom) SetCaller added in v0.6.0 

func (Custom) SetCaller(api.CmdID)

func (Custom) SetThread 

func (cmd Custom) SetThread(t uint64)

func (Custom) Thread 

func (cmd Custom) Thread() uint64

type EndOfReplay added in v1.6.0 

type EndOfReplay struct {
	// contains filtered or unexported fields
}

EndOfReplay is a transform that causes a post back at the end of the replay. It can be used to ensure that GAPIS waits for a replay to finish, if there are no postbacks, or no pending postbacks in the replay.

func (*EndOfReplay) AddNotifyInstruction added in v1.6.0 

func (t *EndOfReplay) AddNotifyInstruction(ctx context.Context, out transform.Writer, result func() interface{})

AddNotifyInstruction adds the instruction to the replay stream that will notify GAPIS that the replay has finished. It should be the end (or very near the end) of the replay stream and thus be called from a transform Flush.

func (*EndOfReplay) AddResult added in v1.6.0 

func (t *EndOfReplay) AddResult(r Result)

AddResult adds the given replay result listener to this transform.

func (*EndOfReplay) Flush added in v1.6.0 

func (t *EndOfReplay) Flush(ctx context.Context, out transform.Writer)

func (*EndOfReplay) PostLoop 

func (t *EndOfReplay) PostLoop(ctx context.Context, out transform.Writer)

func (*EndOfReplay) PreLoop 

func (t *EndOfReplay) PreLoop(ctx context.Context, out transform.Writer)

func (*EndOfReplay) Transform added in v1.6.0 

func (t *EndOfReplay) Transform(ctx context.Context, id api.CmdID, cmd api.Cmd, out transform.Writer)

type Exporter added in v1.2.0 

type Exporter interface {
	Manager
	// Export wait for waitRequests replay requests to be sent,
	// it then compiles the instructions for replay and triggers
	// all postback with builder.ErrReplayNotExecuted .
	Export(ctx context.Context, waitRequests int) (*gapir.Payload, error)
}

Exporter stores the input replays and export them as gapir instruction.

func NewExporter added in v1.2.0 

func NewExporter() Exporter

NewExporter creates a new Exporter.

type Generator 

type Generator interface {
	// Replay is called when a replay pass is ready to be sent to the replay
	// device. Replay may filter or transform the list of commands, satisfying
	// all the specified requests and config, before outputting the final
	// command stream to out.
	Replay(
		ctx context.Context,
		intent Intent,
		cfg Config,
		dependentPayload string,
		requests []RequestAndResult,
		device *device.Instance,
		capture *capture.GraphicsCapture,
		out transform.Writer) error
}

Generator is the interface for types that support replay generation.

type InitialPayloadResult added in v1.3.1 

type InitialPayloadResult struct {
	// contains filtered or unexported fields
}

type Intent 

type Intent struct {
	Device  *path.Device  // The path to the device being used for replay.
	Capture *path.Capture // The path to the capture that is being replayed.
}

Intent describes the source capture and replay target information used for issuing a replay request.

type Issue 

type Issue struct {
	Command  api.CmdID        // The command that reported the issue.
	Severity service.Severity // The severity of the issue.
	Error    error            // The issue's error.
}

Issue represents a single replay issue reported by QueryIssues.

type Manager 

type Manager interface {
	// Replay requests that req is to be performed on the device described by
	// intent, using the capture described by intent.
	Replay(
		ctx context.Context,
		intent Intent,
		cfg Config,
		req Request,
		generator Generator,
		hints *service.UsageHints) (val interface{}, err error)
}

Manager executes replay requests.

func GetManager 

func GetManager(ctx context.Context) Manager

GetManager retrieves the manager from a context previously annotated by PutManager.

func New 

func New(ctx context.Context) Manager

New returns a new Manager instance using the database db.

type Profiler added in v1.6.0 

type Profiler interface {
	// Profile execute a profilable replay.
	Profile(
		ctx context.Context,
		intent Intent,
		mgr Manager,
		hints *service.UsageHints,
		overrides *path.OverrideConfig) error
}

Profiler is the interface implemented by replays that can be performed in a profiling mode while capturing profiling data.

type QueryFramebufferAttachment 

type QueryFramebufferAttachment interface {
	QueryFramebufferAttachment(
		ctx context.Context,
		intent Intent,
		mgr Manager,
		after []uint64,
		width, height uint32,
		attachment api.FramebufferAttachment,
		framebufferIndex uint32,
		drawMode service.DrawMode,
		disableReplayOptimization bool,
		displayToSurface bool,
		hints *service.UsageHints) (*image.Data, error)
}

QueryFramebufferAttachment is the interface implemented by types that can return the content of a framebuffer attachment at a particular point in a capture.

type QueryIssues 

type QueryIssues interface {
	QueryIssues(
		ctx context.Context,
		intent Intent,
		mgr Manager,
		displayToSurface bool,
		hints *service.UsageHints) ([]Issue, error)
}

QueryIssues is the interface implemented by types that can verify the replay performs as expected and without errors. If the capture includes FramebufferObservation commands, this also includes checking the replayed framebuffer matches (within reasonable error) the framebuffer observed at capture time.

type QueryTimestamps added in v1.3.1 

type QueryTimestamps interface {
	QueryTimestamps(
		ctx context.Context,
		intent Intent,
		mgr Manager,
		loopCount int32,
		handler service.TimeStampsHandler,
		hints *service.UsageHints) error
}

QueryTimestamps is the interface implemented by types that can return the timestamps of the execution of commands

type ReplayExecutor added in v1.3.1 

type ReplayExecutor interface {
	// HandlePostData handles the given post data message.
	HandlePostData(context.Context, *gapir.PostData, gapir.Connection) error
	// HandleNotification handles the given notification message.
	HandleNotification(context.Context, *gapir.Notification, gapir.Connection) error
	// HandleFinished is notified when the given replay is finished.
	HandleFinished(context.Context, error, gapir.Connection) error
}

ReplayExecutor handles just the bits related to a specific replay.

type Request 

type Request interface{}

Request is a user-defined type that holds information relevant to a single replay request. An example Request would be one that informs ReplayTransforms to insert a postback of the currently bound render-target content at a specific command.

type RequestAndResult 

type RequestAndResult struct {
	Request Request
	Result  Result
}

RequestAndResult is a pair of Request and Result.

type Result 

type Result func(val interface{}, err error)

Result is the function called for the result of a request. One of val and err must be nil.

func (Result) Do added in v0.9.0 

func (r Result) Do(f func() (val interface{}, err error)) error

Do calls f and passes the return value-error pair to Result.

func (Result) Transform added in v0.9.0 

func (r Result) Transform(f func(in interface{}) (out interface{}, err error)) Result

Transform returns a new Result that passes the non-error value through f before calling the original r.

type SplitGenerator added in v1.3.1 

type SplitGenerator interface {
	Generator
	// GetInitialPayload returns a set of instructions
	// that can be used to set up the replay.
	GetInitialPayload(ctx context.Context,
		capture *path.Capture,
		device *device.Instance,
		out transform.Writer) error
	// CleanupResources returns a set of instructions
	// that can be used to clean up from the Initial payload.
	CleanupResources(ctx context.Context,
		device *device.Instance,
		out transform.Writer) error
}

SplitGenerator is the interface for types that support split-replay generation.

type Support 

type Support interface {
	// GetReplayPriority returns a uint32 representing the preference for
	// replaying this trace on the given device.
	// A lower number represents a higher priority, and Zero represents
	// an inability for the trace to be replayed on the given device.
	GetReplayPriority(context.Context, *device.Instance, *capture.Header) uint32
}

Support is the optional interface implemented by APIs that can describe replay support for particular devices and device types.

Source Files

View all Source files

Directories

Path Synopsis
Package asm contains high-level instructions to control the replay virtual machine.
 Package asm contains high-level instructions to control the replay virtual machine.
Package builder contains the Builder type to build replay payloads.
 Package builder contains the Builder type to build replay payloads.
Package devices contains functions for gathering devices that can replay a capture.
 Package devices contains functions for gathering devices that can replay a capture.
Package opcode holds all the opcodes that are to be interpreted by the replay virtual machine.
 Package opcode holds all the opcodes that are to be interpreted by the replay virtual machine.
Package protocol contains the constants and types used to communicate with the replay system and its virtual-machine interpreter.
 Package protocol contains the constants and types used to communicate with the replay system and its virtual-machine interpreter.
Package value contains the value types used by the replay virtual machine.
 Package value contains the value types used by the replay virtual machine.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.