Auto Entourage

Auto Entourage is a Grasshopper plugin for loading entourage images from a folder into Rhino3d.

Adding entourages into architectural illustrations can be an arduous process, especially for larger-scale projects. Auto Entourage is a small Grasshopper plugin for loading entourage images into Rhino. Thus users can directly render entourages alongside their digital model, obviating arduous post-production of renderings.

Type: software plugin
Role: design, development and maintenance
Implementation: Python, Grasshopper, Rhino3d
Date: 2020

︎︎︎view source
︎︎︎Download on Food4Rhino

plugin tutorial

demo: populating a 2d boundary

demo: populating a street model

demo: populating a surface


The plugin consists of two components: imgCrop and AutoEntourage. The preprocess images by cropping out empty margins while the second one loads them into Rhino.


  • Download plugin into Grasshopper's components folder. Restart Rhino/Grasshopper and launch the components using shortcuts crop and ae. Alternatively, locate the components in "display" -> "preview" in the grasshopper menu.

  • Use imgCrop to batch preprocess images by specifying a path to the image folder, and out as a destinate to save the processed images.

  • Use AutoEntourage to load processed entourages into Rhino by specifying a path to the image folder, a set of anchor point to locate the entourages, as well as the imgheight for scaling their heights.


  • AutoEntourage will take item, list, or trees as input, and behaves similarly to the default grasshopper components.

  • Run imgCrop once to preprocess images and reuse them for all future projects.

  • AutoEntourage will take items, lists or trees as input. (With the exception of layerName input). You can expect the component to behave similarly to other default Grasshopper components.

  • When using AutoEngourage, as long as the inputs are unchange, you can load entourages once, and use orient to align entourages to different views.