Added basic lights components example in 3D

render/basic_lights_3d/all.texture_profiles

@@ -0,0 +1,18 @@
+path_settings {
+  path: "**"
+  profile: "Default"
+}
+profiles {
+  name: "Default"
+  platforms {
+    os: OS_ID_GENERIC
+    formats {
+      format: TEXTURE_FORMAT_RGBA
+      compression_level: BEST
+      compression_type: COMPRESSION_TYPE_DEFAULT
+    }
+    mipmaps: false
+    max_texture_size: 0
+    premultiply_alpha: true
+  }
+}

render/basic_lights_3d/assets/models/cars/police.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/cars_kenney/police.glb"
+name: "police"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_cars.png"
+  }
+}

render/basic_lights_3d/assets/models/city/building-type-a.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/building-type-a.glb"
+name: "building-type-a"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/building-type-b.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/building-type-b.glb"
+name: "building-type-b"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/building-type-c.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/building-type-c.glb"
+name: "building-type-c"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/building-type-d.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/building-type-d.glb"
+name: "building-type-d"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/building-type-e.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/building-type-e.glb"
+name: "building-type-e"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/building-type-f.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/building-type-f.glb"
+name: "building-type-f"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/building-type-g.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/building-type-g.glb"
+name: "building-type-g"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/driveway-long.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/driveway-long.glb"
+name: "driveway-long"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/tree-large.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/tree-large.glb"
+name: "tree-large"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/city/tree-small.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/city_kenney/tree-small.glb"
+name: "tree-small"
+create_go_bones: false
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_city.png"
+  }
+}

render/basic_lights_3d/assets/models/road/light-curved.model

@@ -0,0 +1,11 @@
+mesh: "/assets/meshes/road_kenney/light-curved.glb"
+name: "light-curved-double"
+materials {
+  name: "colormap"
+  material: "/builtins/materials/model_instanced_lit.material"
+  textures {
+    sampler: "tex0"
+    texture: "/assets/textures/colormap_roads.png"
+  }
+}
+create_go_bones: false

render/basic_lights_3d/example.md

@@ -0,0 +1,87 @@
+---
+name: Basic Lights 3D
+tags: render, 3d
+title: Basic Lights 3D
+brief: This example shows how ambient, directional, point, and spot lights affect 3D models that use built-in lit materials.
+author: aglitchman
+scripts:  car.script, orbit_camera.script
+thumbnail: thumbnail.webp
+---
+
+This example sets up a small 3D city scene with several light component types.
+The police car moves through the street so its headlights, rear lights,
+and siren lights can be seen on nearby models.
+
+You can orbit the camera around the scene with the mouse or touch input.
+
+Read more about [Light components in the manual](https://defold.com/manuals/light/).
+
+## What You'll Learn
+
+- How to add ambient, directional, point, and spot light components to a 3D scene.
+- How to use built-in lit model materials that respond to light components.
+- How changing or animating properties of the parent game object of light components affect them.
+
+## Setup
+
+The bootstrap collection `example/basic_lights_3d.collection` contains a simple city scene made from model components.
+There is also:
+
+- a camera game object with camera component and `orbit_camera.script`
+- a `lights` game object that groups the scene lights, lamp, and moving car with light components
+
+![setup](setup.png)
+
+All visible models in this scene use `/builtins/materials/model_instanced_lit.material`.
+Lit built-in materials are an example for model components to receive and react to the light from Defold Light components introduced in Defold 1.13.1.
+
+You can use a material variant that matches the model:
+
+- `/builtins/materials/model_lit.material` for a regular static model.
+- `/builtins/materials/model_instanced_lit.material` for static models that utilise GPU instancing.
+- `/builtins/materials/model_skinned_lit.material` for a skinned (animated) model.
+- `/builtins/materials/model_skinned_instanced_lit.material` for skinned (animated( models that can be instanced.
+
+In the model file, the `colormap` material slot has assigned `model_instanced_lit.material`,
+and the texture sampler `tex0` points to the color map used by that model group.
+
+![material](material.png)
+
+## How It Works
+
+The `sun` game object contains two light components.
+
+The `ambient_light` adds a constant color to the shading of the models,
+so that unlit sides of the models are not completely black.
+
+The `directional_light` represents distant light, like sunlight,
+and uses the parent game object's rotation to define the light direction.
+
+The police siren lights on the car uses two point light components.
+The point light is used as a light source that has a position in the world,
+and a spherical area around it defined by the `range`.
+It uses the parent's game objects position and scale.
+It also has a `color` and `intensity`.
+
+The `red_light` and the `blue_light` are child game objects of the car, so they move with it.
+The `car.script` animates the scale of the two light game objects at different times,
+which makes the red and blue light contribution pulse, like the police siren lights.
+
+![pointlight](pointlight.png)
+
+The headlights, rear lights, and street lamp use spot light components.
+A spot light is for a light that has a volume in a shape of a cone, e.g. flashlights, lamps or car's lights.
+It has the same `color`, `intensity`, and `range` controls as a point light,
+plus `inner_cone_angle` and `outer_cone_angle` to shape the beam.
+It uses the parent's game objects position, scale and rotation.
+In this scene the headlights are yellow spot lights with a long range,
+the rear lights are shorter red spot lights,
+and the street lamp points downward from the lamp model.
+
+![spotlight](spotlight.png)
+
+The car movement is intentionally simple - `car.script` just animates the car position back and forth,
+flips its rotation every five seconds, and animates the scale of the siren lights.
+The lighting behavior itself comes from the light components and the built-in lit model materials.
+
+All the models in the example are from [Kenney asset packs](https://kenney.nl/assets/) (Road, City and Cars), licensed under CC0.