Relation API

Intel® Graphics Performance Analyzers User Guide

Download PDF

ID 767266

Date 3/15/2024

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-F05A0B30-D7AF-4320-B525-E6128F3F24CB

View Details

Document Table of Contents

Document Table of Contents x

Intel® Graphics Performance Analyzers User Guide

Intel® Graphics Performance Analyzers User Guide x

Introduction to Intel® Graphics Performance Analyzers Game Optimization Methodology Install and Launch Intel® GPA Launch Application for Analysis Configure Analysis Settings Analyze Desktop Graphics Applications Quick Start with Profiling Unreal Engine* Games Instrumentation and Tracing Technology API Support Intel® GPA Reference Notices and Disclaimers

Introduction to Intel® Graphics Performance Analyzers x

Get Help

Launch Application for Analysis x

Start a Desktop Application with Graphics Monitor Start a Windows* Mixed Reality Application Connect to a Running Application Analyze Applications in the Network Mode

Configure Analysis Settings x

Configure a Metric Set Customize Keyboard Shortcuts Set Up a Trigger Set Up Tracing Options Set Up Stream Options Set Frame Delimiters

Analyze Desktop Graphics Applications x

Manage Analysis with Graphics Monitor Monitor Real-Time Performance with System Analyzer Identify Issues in Graphics Application Execution with Trace Analyzer Analyze GPU-bound Applications with Graphics Frame Analyzer Optimize Specific Domains

Monitor Real-Time Performance with System Analyzer x

Pause and Resume a Running Application Export Metrics Data with System Analyzer

Analyze GPU-bound Applications with Graphics Frame Analyzer x

Run Render State Experiments with Frame Analyzer Use Advanced Profiling Mode Graphics Frame Analyzer Plugins

Graphics Frame Analyzer Plugins x

Create a Custom Plugin for Graphics Frame Analyzer

Optimize Specific Domains x

Optimize Shaders Analyze Textures Minimize Overdraw Optimize Graphic API States Identify Graphics Elements with Complex Geometry Visualize Color Distribution

Instrumentation and Tracing Technology API Support x

Compile and Link with ITT API Instrument Your Application Minimize ITT API Overhead Clock Domain API Counter API Domain API Marker API Metadata API Relation API String Handle API Thread Naming API Task API

Intel® GPA Reference x

Performance Metrics Reference User Interface Reference

Performance Metrics Reference x

CPU Metrics Device I/O Metrics GPU Metrics Graphics API Metrics Memory Metrics

User Interface Reference x

Graphics Monitor UI Reference Heads-Up Display (HUD) UI Reference System Analyzer UI Reference Graphics Frame Analyzer UI Reference Graphics Trace Analyzer UI Reference

Graphics Monitor UI Reference x

Context Menu Graphics Monitor Control Panel Desktop Applications Tab Universal Windows Applications Tab Options Screen

Graphics Frame Analyzer UI Reference x

Open Frame Capture Multiframe View Profiling View Dependency Viewer

Profiling View x

Main Toolbar Visualization Pane API Log Pane Resources Pane Metrics Pane Experiments Pane

Graphics Trace Analyzer UI Reference x

Open Trace Capture Platform View

Release Notes and System Requirements

Get Started

Intel® Graphics Performance Analyzers User Guide

Introduction to Intel® Graphics Performance Analyzers

Get Help

Game Optimization Methodology

Install and Launch Intel® GPA

Launch Application for Analysis

Start a Desktop Application with Graphics Monitor

Start a Windows* Mixed Reality Application

Connect to a Running Application

Analyze Applications in the Network Mode

Configure Analysis Settings

Configure a Metric Set

Customize Keyboard Shortcuts

Set Up a Trigger

Set Up Tracing Options

Set Up Stream Options

Set Frame Delimiters

Analyze Desktop Graphics Applications

Manage Analysis with Graphics Monitor

Monitor Real-Time Performance with System Analyzer

Pause and Resume a Running Application

Export Metrics Data with System Analyzer

Identify Issues in Graphics Application Execution with Trace Analyzer

Analyze GPU-bound Applications with Graphics Frame Analyzer

Run Render State Experiments with Frame Analyzer

Use Advanced Profiling Mode

Graphics Frame Analyzer Plugins

Create a Custom Plugin for Graphics Frame Analyzer

Optimize Specific Domains

Optimize Shaders

Analyze Textures

Minimize Overdraw

Optimize Graphic API States

Identify Graphics Elements with Complex Geometry

Visualize Color Distribution

Quick Start with Profiling Unreal Engine* Games

Instrumentation and Tracing Technology API Support

Compile and Link with ITT API

Instrument Your Application

Minimize ITT API Overhead

Clock Domain API

Counter API

Domain API

Marker API

Metadata API

Relation API

String Handle API

Thread Naming API

Task API

Intel® GPA Reference

Performance Metrics Reference

CPU Metrics

Device I/O Metrics

GPU Metrics

Graphics API Metrics

Memory Metrics

User Interface Reference

Graphics Monitor UI Reference

Context Menu

Graphics Monitor

Control Panel

Desktop Applications Tab

Universal Windows Applications Tab

Options Screen

Heads-Up Display (HUD) UI Reference

System Analyzer UI Reference

Graphics Frame Analyzer UI Reference

Open Frame Capture

Multiframe View

Profiling View

Main Toolbar

Visualization Pane

API Log Pane

Resources Pane

Metrics Pane

Experiments Pane

Dependency Viewer

Graphics Trace Analyzer UI Reference

Open Trace Capture

Platform View

Notices and Disclaimers

Cookbook

Intel GPA Framework

Visible to Intel only — GUID: GUID-F05A0B30-D7AF-4320-B525-E6128F3F24CB

View Details

Relation API

Relation API binds two named instances, for example, tasks, with a reasonable relation attribute. Relations can be added before or after the actual instances are created and persist independently of the instances.

To logically group a bunch of tasks, you can use different types of relations:

void ITTAPI __itt_relation_add(const __itt_domain *domain, __itt_id head, __itt_relation relation, __itt_id tail)

void ITTAPI __itt_relation_add_ex(const __itt_domain *domain, __itt_clock_domain* clock_domain, unsigned long long timestamp, __itt_id head, __itt_relation relation, __itt_id tail)

Parameters of the primitives:

Type	Parameter	Description
[in]	`__itt_domain* domain`	Relation domain
[in]	`__itt_relation relation`	User-defined logical relation between two named instances
[in]	`__itt_id head`	Metadata name
[in]	`__itt_id tail`	IDs of two named related instances `size_t` count
[in]	`__itt_clock_domain* clock_domain`	User-defined clock domain
[in]	`unsigned long long timestamp`	User-defined timestamp for the corresponding clock domain

Level Two Title

Metadata API String Handle API

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Intel® Graphics Performance Analyzers User Guide

Relation API