Sdílet prostřednictvím

Názorný postup: Digitalizace programově grafické informace.

  • Článek

Tento názorný postup ukazuje, jak použít Visual Studio diagnostiky grafiky k programovému zachycení informací grafiky z aplikace rozhraní Direct3D.

Tento návod ilustruje tyto úkoly:

  • Příprava vašeho počítače používat programové zachycování.

  • Příprava vaší aplikace používat programové zachycování.

  • Konfigurace názvu a umístění souboru protokolu grafiky.

  • Použití API CaptureCurrentFrame.

Příprava vašeho počítače používat programové zachycování

Sběr programového rozhraní API používá vzdálené nástroje pro Visual Studio k zachytávání funkcí.Počítač, ve kterém bude aplikace spuštěna, musí mít nástroje pro vzdálenou instalaci i v případě, že používáte programové zachycení v místním počítači.Visual Studio nemusí být spuštěn při programovém zachytávání v místním počítači.

Pokud chcete použít vzdálený sběr rozhraní API v aplikace spuštěné v počítači, potřebujete nejprve nainstalovat vzdálené nástroje Visual Studio v tomto počítači.Různé verze vzdálených nástrojů podporují různé hardwarové platformy.Informace o instalaci vzdálených nástrojů naleznete na stránce Stažení vzdálených nástrojů na stránce stahování webu Microsoft.

Alternativně nainstaluje Visual Studio součásti nezbytné k provedení vzdáleného záznamu pro 32bitové aplikace.

[!POZNÁMKA]

Protože většina aplikací počítače se systémem Windows – včetně Visual Studio– není v systému Windows 8 podporovány pro zařízení ARM, je použití vzdálených nástrojů pro aplikaci Visual Studio společně s programovým záznamem rozhraní API jediným způsobem, jak zachytit diagnostiku grafiky na zařízeních ARM.

Příprava vaší aplikace používat programové zachycování

Pokud chcete použít nástroje Diagnostika grafiky, je třeba nejprve zaznamenat grafické informace, na kterých záleží.Informace můžete zachytit programově pomocí CaptureCurrentFrame rozhraní API.

Příprava aplikací k programovému zachytávání informací grafiky

  1. Ujistěte se, že záhlaví vsgcapture.h je součástí zdrojového kódu aplikace.Lze jej zahrnout pouze do jednoho umístění, například do souboru zdrojového kódu, kde budete volat rozhraní API programového zachytávání, nebo do předkompilovaného souboru záhlaví pro volání rozhraní API z více souborů zdrojového kódu.

  2. Kdykoli chcete zachytit aktuální snímek, ve zdrojovém kódu aplikace volejte funkci g_pVsgDbg->CaptureCurrentFrame().Tato metoda nepoužívá žádné parametry a nevrací hodnotu.

Konfigurace názvu a umístění souboru protokolu grafiky

Grafika protokolu je vytvořena v umístění, které je definováno makry DONT_SAVE_VSGLOG_TO_TEMP a VSG_DEFAULT_RUN_FILENAME.

Konfigurace názvu a umístění souboru protokolu grafiky

  • Pokud chcete zabránit zápisu protokolu grafiky do adresáře temp před řádkem #include <vsgcapture.h>, přidejte následující:

    #define DONT_SAVE_VSGLOG_TO_TEMP

    Tuto hodnotu můžete určit k zápisu zápis protokolu grafiky do umístění, které je relativní k pracovnímu adresáři, nebo absolutní cesty definované VSG_DEFAULT_RUN_FILENAME jež je absolutní cestou.

  • Pokud chcete uložit protokol grafiky do jiného umístění nebo mu přiřadit jiný název před řádkem #include <vsgcapture.h>, přidejte následující:

    #define VSG_DEFAULT_RUN_FILENAME <filename>

    Pokud neprovedete tento krok, název souboru bude default.vsglog.Pokud jste nedefinovali DONT_SAVE_VSGLOG_TO_TEMP , pak je umístění souboru ve vztahu k adresáři dočasných souborů relativní; jinak je relativní k pracovnímu adresáři nebo jinému umístění, pokud zadáte absolutní název souboru.

Pro Windows Store apps, umístění dočasného adresáře je specifické pro každého uživatele a aplikace a zpravidla se nachází v umístění, například C:\users\uživatelské jméno\AppData\Local\Packages\název balíčku řady\TempState\.Pro aplikace pracovní plochy je umístění adresáře s dočasnými soubory specifické pro jednotlivé uživatele a obvykle se nachází v umístění jako například C:\Users\uživatelské jméno\Data aplikací\Místní\Temp\.

[!POZNÁMKA]

Pokud chcete provádět zápis do určitého umístění, musíte mít oprávnění k zápisu do tohoto umístění; v opačném případě dojde k chybě.Pamatujte, že aplikace systému Windows Store jsou omezenější než desktopové aplikace v tom, kam mohou zapisovat data, a mohou vyžadovat další konfiguraci pro zápis do určitých umístění.

Zaznamenání grafických informací

Jakmile jste aplikaci připravili pro programové zaznamenání a volitelně konfigurovali umístění a název souboru protokolu grafiky, sestavte aplikaci a poté ji spusťte nebo proveďte ladění, aby byla data zaznamenána; nespouštějte diagnostiku grafiky z Visual Studio při použití API programového zaznamenání.Protokol grafiky je zapsán do zadaného umístění.Pokud chcete zachovat tuto verzi protokolu, přesuňte ji do jiného umístění; jinak bude přepsána při dalším spuštění aplikace.

Tip

Nadále můžete zachytit grafické informace aktivní aplikace ručně při používání programového zachytávání stisknutím klávesy Print Screen.Tuto možnost můžete využít k zaznamenání dalších grafických informací, které nejsou zachyceny použitím programového rozhraní zachytávání API.

Další kroky

Tento návod znázorňuje, jak zachytávat grafické informace programově.Jako další krok zvažte tuto možnost:

  • Naučte se, jak analyzovat zachycené grafické informace pomocí nástrojů Diagnostika grafiky.Viz téma Diagnostika grafiky.

Viz také

Úkoly

Názorný postup: Digitalizace ručně grafické informace.

Koncepty

Zachycení informací grafiky