# Warehouse asset licenses and attribution

The third-party models and textures in this directory are free assets under
two licenses:

* **CC0 1.0 Universal (CC0-1.0)** for the Poly Haven props and textures:
  copying, modification, commercial use and redistribution are allowed
  without attribution. The legal text is in
  [LICENSE-CC0-1.0.txt](LICENSE-CC0-1.0.txt).
* **CC BY 4.0** for the forklift, the pallet jack, the pallets and the
  cartons from Sketchfab: the same freedoms, provided the authors are
  credited as below (https://creativecommons.org/licenses/by/4.0/). Each of
  these folders keeps the `license.txt` that Sketchfab ships with the model.

The pallet racking, the building, the light fixtures, the floor markings and
the textures in `textures/generated/` are generated by
`examples/tools/generate_warehouse_rscene.py` and
`examples/tools/prepare_warehouse_assets.py`.

## Poly Haven (CC0)

Provider's license statement: https://polyhaven.com/license. Powered by Poly Haven.

| Asset | Author | Used as |
| --- | --- | --- |
| [Rollershutter Door](https://polyhaven.com/a/rollershutter_door) | MP | `props/rollershutter_door`, closed dock doors |
| [Hand Truck](https://polyhaven.com/a/hand_truck) | Mutanzom3D | `props/hand_truck` |
| [Cardboard Box 01](https://polyhaven.com/a/cardboard_box_01) | Rahul Chaudhary | `props/cardboard_box_01`, loose cartons |
| [Barrel_01](https://polyhaven.com/a/Barrel_01) | Jorge Camacho | `props/Barrel_01`, red drums |
| [Barrel 03](https://polyhaven.com/a/barrel_03) | Serhii Khromov | `props/barrel_03`, blue drums |
| [Korean Fire Extinguisher 01](https://polyhaven.com/a/korean_fire_extinguisher_01) | UM JOORIN | `props/korean_fire_extinguisher_01` |
| [Plastic Crate 03](https://polyhaven.com/a/plastic_crate_03) | Pacific Penguin | `props/plastic_crate_03` |
| [Propane Tank](https://polyhaven.com/a/propane_tank) | Slinc | `props/propane_tank` |
| [Wet Floor Sign 01](https://polyhaven.com/a/WetFloorSign_01) | Fran Calvente | `props/WetFloorSign_01` |
| [Steel Frame Shelves 01](https://polyhaven.com/a/steel_frame_shelves_01) | James Ray Cock | `props/steel_frame_shelves_01` |
| [Security Camera 01](https://polyhaven.com/a/security_camera_01) | Alexander Otterbeck, Yann Kervran | `props/security_camera_01` |
| [Metal Office Desk](https://polyhaven.com/a/metal_office_desk) | Ulan Cabanilla | `props/metal_office_desk`, packing desk |
| [Tool Cart](https://polyhaven.com/a/tool_cart) | Savva Zakharov | `props/tool_cart` |
| [Concrete Floor Worn 001](https://polyhaven.com/a/concrete_floor_worn_001) | Dimitrios Savva, Rico Cilliers | floor (colour map brightened) |
| [Corrugated Iron](https://polyhaven.com/a/corrugated_iron) | Jenelle van Heerden, Dimitrios Savva | wall cladding |
| [Concrete Wall 004](https://polyhaven.com/a/concrete_wall_004) | Dario Barresi, Charlotte Baglioni | precast wall panels |
| [Corrugated Iron 02](https://polyhaven.com/a/corrugated_iron_02) | Jenelle van Heerden, Sergej Majboroda | roof sheeting |

The scene also uses files of the city example in `../city`, credited in
[../city/ATTRIBUTION.md](../city/ATTRIBUTION.md): the sky HDR (Poly Haven's
Kloofendal 48d Partly Cloudy Pure Sky), the yard asphalt (Poly Haven's
Asphalt 02) and the traffic cones (BlendKit's photoscanned traffic cone), all
CC0.

## Sketchfab (CC BY 4.0)

Credits, as the authors ask for them:

* `forklift`: This work is based on "Forklift Truck" (https://sketchfab.com/3d-models/forklift-truck-060f3f8bc7de4e6ca2f348d414702e9d) by louis-muir (https://sketchfab.com/louir-muir) licensed under CC-BY-4.0 (http://creativecommons.org/licenses/by/4.0/)
* `pallet_jack`: This work is based on "Pallet Jack (Low Poly)" (https://sketchfab.com/3d-models/pallet-jack-low-poly-55397e1bb66a48bd9d6e1ef93d8456cc) by Berk Gedik (https://sketchfab.com/berkgedik) licensed under CC-BY-4.0 (http://creativecommons.org/licenses/by/4.0/)
* `pallets`: This work is based on "Wooden Pallets" (https://sketchfab.com/3d-models/wooden-pallets-dba5c00928cd400796d9f6fffdd724b3) by Erroratten (https://sketchfab.com/erroratten) licensed under CC-BY-4.0 (http://creativecommons.org/licenses/by/4.0/)
* `cartons`: This work is based on "Set of Cardboard Boxes" (https://sketchfab.com/3d-models/set-of-cardboard-boxes-8986ba512f704ac5b253286a0d1ad8bb) by NotAnotherApocalypticCo. (https://sketchfab.com/notanotherapocalypticco) licensed under CC-BY-4.0 (http://creativecommons.org/licenses/by/4.0/)

Changes made: the node transforms are baked into Z-up meshes in metres with
one primitive per material; the forklift is scaled to 3.4 m and turned to
face +x; the pallets are scaled to 1.2 m x 1.0 m x 0.144 m and their
specular-glossiness materials converted to metallic-roughness; each carton of
the set is its own model, centred with its footprint on the axes; and the
textures are reduced to 1K or 2K JPEG files.

## Local preparation

`examples/tools/download_warehouse_assets.py` downloads the sources and
records their URLs and SHA-256 hashes in [sources.json](sources.json); the
Sketchfab models need the API token of a free Sketchfab account.
`examples/tools/prepare_warehouse_assets.py` prepares the models as described
above, gives the static props `.rasset` colliders, brightens the floor's
colour map, generates the textures in `textures/generated/` and runs
`examples/tools/generate_warehouse_rscene.py`, which writes the meshes in
`building/` and the scene. [manifest.json](manifest.json) records the hashes
of the prepared files.

This notice covers the third-party assets in this directory. It does not
change the licenses of RaiSim, rayrai or the example code.