 1ba7429371
			
		
	
	
		1ba7429371
		
	
	
	
	
		
			
			# Objective Provide a starting point for #3951, or a partial solution. Providing a few comment blocks to discuss, and hopefully find better one in the process. ## Solution Since I am pretty new to pretty much anything in this context, I figured I'd just start with a draft for some file level doc blocks. For some of them I found more relevant details (or at least things I considered interessting), for some others there is less. ## Changelog - Moved some existing comments from main() functions in the 2d examples to the file header level - Wrote some more comment blocks for most other 2d examples TODO: - [x] 2d/sprite_sheet, wasnt able to come up with something good yet - [x] all other example groups... Also: Please let me know if the commit style is okay, or to verbose. I could certainly squash these things, or add more details if needed. I also hope its okay to raise this PR this early, with just a few files changed. Took me long enough and I dont wanted to let it go to waste because I lost motivation to do the whole thing. Additionally I am somewhat uncertain over the style and contents of the commets. So let me know what you thing please.
		
			
				
	
	
		
			76 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
			
		
		
	
	
			76 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
| //! This example shows how to configure Physically Based Rendering (PBR) parameters.
 | |
| 
 | |
| use bevy::prelude::*;
 | |
| 
 | |
| fn main() {
 | |
|     App::new()
 | |
|         .add_plugins(DefaultPlugins)
 | |
|         .add_startup_system(setup)
 | |
|         .run();
 | |
| }
 | |
| 
 | |
| /// set up a simple 3D scene
 | |
| fn setup(
 | |
|     mut commands: Commands,
 | |
|     mut meshes: ResMut<Assets<Mesh>>,
 | |
|     mut materials: ResMut<Assets<StandardMaterial>>,
 | |
| ) {
 | |
|     // add entities to the world
 | |
|     for y in -2..=2 {
 | |
|         for x in -5..=5 {
 | |
|             let x01 = (x + 5) as f32 / 10.0;
 | |
|             let y01 = (y + 2) as f32 / 4.0;
 | |
|             // sphere
 | |
|             commands.spawn_bundle(PbrBundle {
 | |
|                 mesh: meshes.add(Mesh::from(shape::Icosphere {
 | |
|                     radius: 0.45,
 | |
|                     subdivisions: 32,
 | |
|                 })),
 | |
|                 material: materials.add(StandardMaterial {
 | |
|                     base_color: Color::hex("ffd891").unwrap(),
 | |
|                     // vary key PBR parameters on a grid of spheres to show the effect
 | |
|                     metallic: y01,
 | |
|                     perceptual_roughness: x01,
 | |
|                     ..default()
 | |
|                 }),
 | |
|                 transform: Transform::from_xyz(x as f32, y as f32 + 0.5, 0.0),
 | |
|                 ..default()
 | |
|             });
 | |
|         }
 | |
|     }
 | |
|     // unlit sphere
 | |
|     commands.spawn_bundle(PbrBundle {
 | |
|         mesh: meshes.add(Mesh::from(shape::Icosphere {
 | |
|             radius: 0.45,
 | |
|             subdivisions: 32,
 | |
|         })),
 | |
|         material: materials.add(StandardMaterial {
 | |
|             base_color: Color::hex("ffd891").unwrap(),
 | |
|             // vary key PBR parameters on a grid of spheres to show the effect
 | |
|             unlit: true,
 | |
|             ..default()
 | |
|         }),
 | |
|         transform: Transform::from_xyz(-5.0, -2.5, 0.0),
 | |
|         ..default()
 | |
|     });
 | |
|     // light
 | |
|     commands.spawn_bundle(PointLightBundle {
 | |
|         transform: Transform::from_xyz(50.0, 50.0, 50.0),
 | |
|         point_light: PointLight {
 | |
|             intensity: 600000.,
 | |
|             range: 100.,
 | |
|             ..default()
 | |
|         },
 | |
|         ..default()
 | |
|     });
 | |
|     // camera
 | |
|     commands.spawn_bundle(OrthographicCameraBundle {
 | |
|         transform: Transform::from_xyz(0.0, 0.0, 8.0).looking_at(Vec3::default(), Vec3::Y),
 | |
|         orthographic_projection: OrthographicProjection {
 | |
|             scale: 0.01,
 | |
|             ..default()
 | |
|         },
 | |
|         ..OrthographicCameraBundle::new_3d()
 | |
|     });
 | |
| }
 |