Jelajahi Sumber

Merge pull request #4 from guillaume-haerinck/unified_readme

Update readme and check project against 23.10
Joe Bryant 1 tahun lalu
induk
melakukan
01d9f2df29
9 mengubah file dengan 44 tambahan dan 34 penghapusan
  1. 0 1
      Project/Code/enabled_gems.cmake
  2. 2 1
      Project/project.json
  3. 21 0
      Project/project.json.bak0
  4. 21 32
      README.md
  5. TEMPAT SAMPAH
      doc/gameplay.gif
  6. TEMPAT SAMPAH
      doc/project.png
  7. TEMPAT SAMPAH
      doc/screenshot-1.png
  8. TEMPAT SAMPAH
      doc/screenshot-2.png
  9. TEMPAT SAMPAH
      doc/screenshot-3.png

+ 0 - 1
Project/Code/enabled_gems.cmake

@@ -1,6 +1,5 @@
 
 set(ENABLED_GEMS
-    Buongiorno
     Atom
     CameraFramework
     ImGui

+ 2 - 1
Project/project.json

@@ -17,5 +17,6 @@
     "engine": "o3de",
     "external_subdirectories": [
         "../Gems/buongiorno"
-    ]
+    ],
+    "engine_version": "2.2.2"
 }

+ 21 - 0
Project/project.json.bak0

@@ -0,0 +1,21 @@
+{
+    "project_name": "Buongiorno",
+    "project_id": "{9579ef7f-9689-49af-ba1c-846bab6db72c}",
+    "origin": "https://github.com/powervr-graphics/buongiorno-sample",
+    "license": "MIT, https://opensource.org/licenses/MIT",
+    "display_name": "Buon(G.I)orno Sample",
+    "summary": "This project contains the O3DE Buon(G.I)orno sample scene.",
+    "canonical_tags": [
+        "Project"
+    ],
+    "user_tags": [
+        "Buongiorno",
+        "Sample",
+        "Getting Started"
+    ],
+    "icon_path": "preview.png",
+    "engine": "o3de",
+    "external_subdirectories": [
+        "../Gems/buongiorno"
+    ]
+}

+ 21 - 32
README.md

@@ -1,50 +1,39 @@
-# Buon(G.I)orno Sample and Gem for O3DE
+<u>Supported o3de versions</u> : **23.10**
 
-![BuonGIorno_Screenshot](https://user-images.githubusercontent.com/10916957/195835333-f1b4c2a8-e07b-4b2a-bc01-1b418bb969d2.png)
+# Buon(G.I)orno Sample
 
-Buon(G.I.)orno is the stylized representation of a small italian village. The main purpose of this graphics demo is to showcase what it's possible to achieve thanks to Ray-Traced Global Illumination in a mobile-friendly game environment.
+![gameplay](doc/gameplay.gif?raw=true)
 
-## Download and Install
+Buon(G.I.)orno is the stylized representation of a small italian village. The main purpose of this graphics demo is to showcase what it's possible to achieve thanks to Ray-Traced Global Illumination in a mobile-friendly game environment.
 
-### 1. Clone the repository
+## Prerequisites
 
-You can clone the gems to any folder locally, including inside the engine folder. If you clone to a folder inside an existing Git repository (e.g. o3de) you should add the folder to the Git exclude file for the existing repository.
+You need to build or [install O3DE engine](https://o3de.org/download/).
 
-#### Cloning into a folder outside the engine repository folder (Recommended) 
+## How to run
 
-```shell
-# navigate to the desired directory (outside your engine repository folder) and clone the project 
-> git clone https://github.com/o3de/buongiorno-sample.git
-Cloning into 'buongiorno-sample'...
-```
+1. Download (green "Code" button, then "Download ZIP") or clone the github repository (`git clone https://github.com/o3de/buongiorno-sample.git`)
+2. Launch O3DE. It will open the Project manager. Click on the **New Project** button then **Open Existing Project** option.
+3. Navigate to your download (and make sure it is unzipped). Open the **Project** folder. The project should now be registered.
 
-#### Cloning into the engine repository folder
+![project](doc/project.png?raw=true)
 
-```shell
-# clone the project in your existing engine repository folder
-> git clone https://github.com/o3de/buongiorno-sample.git c:/path/to/o3de/buongiorno-sample
-Cloning into 'buongiorno-sample'...
-```
+4. Click on the **Build Project** button, located on the **Buon(G.I)orno Sample** image.
+5. Once the project has been built successfully, use the **Open Editor** button.
+6. The asset pre-processor will run for a bit. Once it is over you will be welcomed with the **Open a Level** window, simply pick the first one.
 
-```shell
-# Add the project folder to the engine git exclude file
-> echo buongiorno-sample > c:/path/to/o3de/.git/info/exclude
-```
+## Project Highlights
 
-### 2. Register the engine, project and gems
+- **Benchmarking**, this scene was made to test performances of O3DE on mobile devices.
+- **Animated environment**, the scene has cars and characters in movement.
 
-```shell
-# register the engine (If you already built O3DE in project-centric mode then you don't need this step.)
-> c:/path/to/o3de/scripts/o3de register --this-engine
+### Screenshots
 
-# register the project 
-> c:/path/to/o3de/scripts/o3de register -pp c:/path/to/buongiorno-sample/Project
+![screenshot](doc/screenshot-3.png?raw=true)
 
-# register the gem (OPTIONAL) - Only needed if you plan to use the gem from another project. 
-> c:/path/to/o3de/scripts/o3de register -gp c:/path/to/buongiorno-sample/Gems/buongiorno
-```
+![screenshot](doc/screenshot-1.png?raw=true)
 
-You are now setup to use these gems in your projects.
+![screenshot](doc/screenshot-2.png?raw=true)
 
 ## License
 

TEMPAT SAMPAH
doc/gameplay.gif


TEMPAT SAMPAH
doc/project.png


TEMPAT SAMPAH
doc/screenshot-1.png


TEMPAT SAMPAH
doc/screenshot-2.png


TEMPAT SAMPAH
doc/screenshot-3.png