AeroModel

AeroModel

Documentation

align (alias verticalAlign)

Controls the vertical alignment of the aircraft within the generated canvas.

Values

ValueDescription
bottomThe aircraft sits on a common ground line. All angles of the same aircraft share the same visual baseline. Recommended for fleets.
center (implicit default)Vertically centered. This is the behavior of the pre-rendered asset served without composition.
topAircraft anchored at the top. Useful for layouts where the bottom area carries text.

Important: if align is not present in the URL, the API serves the pre-rendered asset directly (fast, cache HIT). As soon as you set align=bottom (or center or top), the request goes through the composition pipeline and the image is repositioned on the fly.

Why this parameter

Without align=bottom, different views (front, back, profile, 3/4) have very different bbox sizes. If composed side by side, the fuselage baseline jumps from one image to the next. align=bottom guarantees a consistent presentation — for example for a fleet selector or a comparator. Best combined with scale=fleet to also normalize aircraft size.

Behavior

  • The option routes the request through the composition pipeline (equivalent to pitch, scale, or background).
  • A safety margin (~4% of canvas height) prevents the aircraft from touching the edge.
  • The image is clamped to the frame: if content is larger than canvas, alignment falls back to center for that call.
  • Response header: x-compose-align: bottom|center|top.

API examples

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=0&align=bottom
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=90&align=bottom
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=180&align=bottom
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=top&align=center

The first three images share the same ground line.

Cross-fleet baseline

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A380&airline=EK&angle=90&scale=fleet&align=bottom
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=B737&airline=AF&angle=90&scale=fleet&align=bottom

→ A380 and B737 share the same baseline AND respect their real-world size ratio.

Visual examples

Four views of the same A320 Air France with align=bottom — baseline consistent across all:

0° (front)90° (right profile)180° (rear)270° (left profile)

center vs top vs bottom comparison (right profile):

align=topalign=centeralign=bottom

Errors

  • align must be top, center or bottom → unknown value.

See also