# HelloVulkan

**Repository Path**: mirrors_GPUOpen-LibrariesAndSDKs/HelloVulkan

## Basic Information

- **Project Name**: HelloVulkan
- **Description**: Introductory Vulkan sample
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Hello Vulkan
============

Welcome to a Vulkan™ "Hello Triangle" sample which shows how to set up a window, set up a Vulkan context, and render a triangle. This sample is designed to help you get started with Vulkan and does not use any wrappers or helper libraries - pure Vulkan all the way.

License
-------

MIT: see `LICENSE.txt` for details.

System requirements
-------------------

* AMD Radeon™ GCN-based GPU (HD 7000 series or newer)
  * Or other Vulkan™ compatible discrete GPU 
* 64-bit Windows® 7 (SP1 with the [Platform Update](https://msdn.microsoft.com/en-us/library/windows/desktop/jj863687.aspx)), Windows® 8.1, or Windows® 10
* Visual Studio® 2013 or Visual Studio® 2015
* Graphics driver with Vulkan support
  * For example, AMD Radeon Software Crimson Edition 16.5.2 or later
* The [Vulkan SDK](https://vulkan.lunarg.com) must be installed

Building
--------

Visual Studio files can be found in the `hellovulkan\build` directory.

If you need to regenerate the Visual Studio files, open a command prompt in the `hellovulkan\premake` directory and run `..\..\premake\premake5.exe vs2015` (or `..\..\premake\premake5.exe vs2013` for Visual Studio 2013.)

Vulkan also supports Linux®, of course, and Premake can generate GNU Makefiles. However, at this time, the sample itself is Windows specific (because the helper code in Window.h/.cpp is Windows specific).

Third-party software
------------------

* Premake is distributed under the terms of the BSD License. See `premake\LICENSE.txt`.

Known issues
------------

The sample uses `PRESENT_MODE_FIFO` to run with VSync. On the NVIDIA 365.19 driver, FIFO is ignored and the sample will exit after a very brief period of time. You can increase the number of frames rendered to ensure it remains visible for a couple of seconds.

Attribution
-----------

* AMD, the AMD Arrow logo, Radeon, and combinations thereof are either registered trademarks or trademarks of Advanced Micro Devices, Inc. in the United States and/or other countries.
* Microsoft, Visual Studio, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
* Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
* Vulkan and the Vulkan logo are trademarks of the Khronos Group, Inc.