gfx - GitLite

KO | EN

gitlite — search

#javascript #python #llm #go #golang #android #machine-learning #deep-learning #linux #docker #java #awesome-list #security #open-source

gfx

(★ 5,398)

[maintenance mode] A low-overhead Vulkan-like GPU API for Rust.

파일 탐색기

최종 버전 다운로드 (.zip)

- - CI.yml
- CONTRIBUTING.md
- ISSUE_TEMPLATE.md
- PULL_REQUEST_TEMPLATE.md
- - main.rs
- - main.rs
  - README.md
  - screenshot.png
- - main.rs
- - main.rs
- - main.rs
  - README.md
  - screenshot.png
- Cargo.toml
- README.md
- dx_depth_coordinates.png
- dx_texture_coordinates.png
- getting_started.md
- gfx-chip-logo.drawio
- gl_depth_coordinates.png
- gl_render_coordinates.png
- gl_texture_coordinates.png
- hal.svg
- logo.png
- README.md
- research.md
- vk_render_coordinates.png
- - Cargo.toml
- - Cargo.toml
  - README.md
- - blit.ron
- - buffer.raw
  - copy.frag
  - copy.vert
  - fill-10-bytes.raw
  - fill-8-bytes.raw
  - fill.comp
  - image.raw
  - passthrough.frag
  - passthrough.vert
  - vertex-offset.frag
  - vertex-offset.raw
  - vertex-offset.vert
- - ci.ron
  - local.ron
- - basic.ron
  - compute.ron
  - large.ron
  - transfer.ron
  - vertex-offset.ron
.gitignore
.monocodus
bors.toml
Cargo.toml
CHANGELOG.md
deny.toml
LICENSE-APACHE
LICENSE-MIT
Makefile
README.md
rustfmt.toml

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/gfx-rs/gfx

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd gfx

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Rust

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

cargo build --release

Rust 프로젝트를 컴파일합니다.

cargo run

빌드 후 바로 실행까지 진행합니다.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="info/logo.png">
</p>
<p align="center">
  <a href="https://matrix.to/#/#gfx:matrix.org">
    <img src="https://img.shields.io/badge/Matrix-%23gfx%3Amatrix.org-blueviolet.svg" alt="Matrix room">
  </a>
  <a href="https://crates.io/crates/gfx-hal">
      <img src="https://img.shields.io/crates/v/gfx-hal.svg?label=gfx-hal" alt = "gfx-hal on crates.io">
  </a>
  <a href="https://github.com/gfx-rs/gfx/actions">
      <img src="https://github.com/gfx-rs/gfx/workflows/CI/badge.svg" alt="Build Status">
  </a>
  <br>
  <strong><a href="info/getting_started.md">Getting Started</a> | <a href="http://docs.rs/gfx-hal">Documentation</a> | <a href="http://gfx-rs.github.io/">Blog</a> | <a href="https://opencollective.com/gfx-rs">Funding</a> </strong>
</p>

# gfx-rs

gfx-rs is a low-level, cross-platform graphics and compute abstraction library in Rust. It consists of the following components:

## gfx-hal deprecation

As of the v0.9 release, gfx-hal is now in maintenance mode. gfx-hal development was mainly driven by [wgpu](https://github.com/gfx-rs/wgpu), which has now switched to its own GPU abstraction called [wgpu-hal](https://github.com/gfx-rs/wgpu/pull/1471). For this reason, gfx-hal development has switched to maintenance only, until the developers figure out the story for gfx-portability. Read more about the transition in [#3768](https://github.com/gfx-rs/gfx/discussions/3768).

## hal

* `gfx-hal` which is gfx's hardware abstraction layer: a Vulkan-ic mostly unsafe API which translates to native graphics backends.
* `gfx-backend-*` which contains graphics backends for various platforms:
  * [Vulkan](src/backend/vulkan) (runs on Linux, Windows, and Android)
  * [DirectX 12](src/backend/dx12) and [DirectX 11](src/backend/dx11)
  * [Metal](src/backend/metal) (runs on macOS and iOS)
  * [OpenGL ES3](src/backend/gl) (runs on Linux/BSD, Android, and WASM/WebGL2)
* `gfx-warden` which is a data-driven reference test framework, used to verify consistency across all graphics backends.

gfx-rs is hard to use, it's recommended for performance-sensitive libraries and engines. If that's not your domain, take a look at [wgpu-rs](https://github.com/gfx-rs/wgpu-rs) for a safe and simple alternative.

## Hardware Abstraction Layer

The Hardware Abstraction Layer (HAL), is a thin, low-level graphics and compute layer which translates API calls to various backends, which allows for cross-platform support. The API of this layer is based on the Vulkan API, adapted to be more Rust-friendly.

<p align="center"><img src="info/hal.svg" alt="Hardware Abstraction Layer (HAL)" /></p>

Currently HAL has backends for Vulkan, DirectX 12/11, Metal, and OpenGL/OpenGL ES/WebGL.

The HAL layer is consumed directly by user applications or libraries. HAL is also used in efforts such as [gfx-portability](https://github.com/gfx-rs/portability).

See the [Big Picture](https://gfx-rs.github.io/2020/11/16/big-picture.html) blog post for connections.

## The old `gfx` crate (pre-ll)

This repository was originally home to the [`gfx`](https://crates.io/crates/gfx) crate, which is now deprecated. You can find the latest versions of the code for that crate in the [`pre-ll`](https://github.com/gfx-rs/gfx/tree/pre-ll) branch of this repository.

The master branch of this repository is now focused on developing [`gfx-hal`](https://crates.io/crates/gfx-hal) and its associated backend and helper libraries, as described above. `gfx-hal` is a complete rewrite of `gfx`, but it is not necessarily the direct successor to `gfx`. Instead, it serves a different purpose than the original `gfx` crate, by being "lower level" than the original. Hence, the name of `gfx-hal` was originally `ll`, which stands for "lower level", and the original `gfx` is now referred to as `pre-ll`.

The spiritual successor to the original `gfx` is actually [`wgpu`](https://github.com/gfx-rs/wgpu-rs), which stands on a similar level of abstraction to the old `gfx` crate, but with a modernized API that is more fit for being used over Vulkan/DX12/Metal. If you want something similar to the old `gfx` crate that is being actively developed, `wgpu` is probably what you're looking for, rather than `gfx-hal`.

## Contributing

We are actively looking for new contributors and aim to be welcoming and helpful to anyone that is interested! We know the code base can be a bit intimidating in size and depth at first, and to this end we have a [label](https://github.com/gfx-rs/gfx/issues?q=is%3Aissue+is%3Aopen+label%3Acontributor-friendly) on the issue tracker which marks issues that are new contributor friendly and have some basic direction for completion in the issue comments. If you have any questions about any of these issues (or any other issues) you may want to work on, please comment on GitHub and/or drop a message in our [Matrix chat](https://matrix.to/#/#gfx:matrix.org)!

## License

[license]: #license

This repository is licensed under either of

* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.