harfang3d/languages/hg_python/DESCRIPTION.rst
2023-06-08 22:17:16 +02:00

4.2 KiB

image

Harfang for Python

3D real time visualization framework

Harfang is a 3D real time visualization framework for the industry, the education and for scientists. It grants developpers the ability to create applications ranging from data visualization to games.

See https://www.harfang3d.com/license for licensing terms.


Quickstart, command line method (Windows/Linux)
  1. Clone the tutorials' repository:
    • git clone https://github.com/harfang3d/tutorials-hg2.git
  2. Enter the repository:
    • cd tutorials-hg2
  3. Compile the tutorial resources:
    • python3 -m harfang.bin assetc resources
    • After the compilation process finishes, you should see a resources_compiled folder next to the resources folder.
  4. Run the tutorials:
    • D:\tutorials-hg2>python3 draw_lines.py

Quickstart, drag & drop method (Windows)
  1. Download the tutorials https://github.com/harfang3d/tutorials-hg2 and unzip them to your computer (eg. d:/tutorials-hg2).
  2. To compile the tutorial resources, download assetc for your platform: https://dev.harfang3d.com/releases/
  3. Drag and drop the tutorial resources folder on the `assetc executable -OR- execute assetc passing it the path to the tutorial resources folder (eg. assetc d:/tutorials-hg2/resources).

image

After the compilation process finishes, you should see a resources_compiled folder next to the resources folder. You can now execute the tutorials from the folder you unzipped them to.

D:\tutorials-hg2>python draw_lines.py

Alternatively you can open the tutorial folder and run the provided debug targets using Visual Studio Code


Screenshots

The following screenshots were captured on a 2060RTX in 1080P running at 60FPS, GI is performed using screen space raytracing and does not require RTX capable hardware.


The NVIDIA USD Attic using the AAA renderer (Courtesy of NVIDIA)

image


Marine Melodies (interactive musical experience)

image


Cyber City (CyberPunk City, CyberPunk Girl and Robot R32 by art-equilibrium, ILranch and ZeroArt3d)

image

image


Sun Temple (Sun Temple, courtesy of the Open Research Content Archive)

image

image


Cafe Exterior (Bistro, courtesy of the Open Research Content Archive)

image

image


Sponza Atrium (Sponza Atrium GLTF, courtesy of Crytek/Themaister)

image

image


Features
Scene API
  • Node & component based
  • Performance oriented
Rendering pipeline
  • Low-spec PBR rendering pipeline
  • High-spec 'AAA' rendering pipeline (screen space GI & reflection)
  • Support of user pipeline shaders
VR API
  • VR support via OpenVR/SteamVR with Eye tracking
  • Compatible with the HTC Vive/Vive Pro, Valve Index, Lenovo Explorer, Oculus Rift S
Physics API
  • Rigid bodies, collisions, mechanical constraints
  • Ray casting
  • Fast & accurate
Audio API
  • Play/stream WAV/OGG formats
  • 3D audio spatialization

More information on https://www.harfang3d.com/