Skip to content

3D height map

A terrain with hills where 3D physics objects can stand.

Authors and contributors to this experimental extension: D8H.

Warning

This is an extension made by a community member and it only got through a light review by the GDevelop extension team. As such, we can't guarantee it meets all the quality standards of fully reviewed extensions.

A terrain with hills where objects with the 3D physics behavior can stand.

A terrain can be built from:

Read more...

Tip

Learn how to install new extensions by following a step-by-step guide.

3D height map

A terrain with hills in 3D.

Object properties

  • Grid dimension X (🔢 Number). Default value is 65.
  • Grid dimension Y (🔢 Number). Default value is 65.
  • Color (🎨 Color). Default value is 255;255;255.
  • Wireframe (🔘 Boolean).
  • Height map (optional) (🗂️ Resource).
  • Image offset X (🔢 Number, Distance). Default value is 0.
  • Image offset Y (🔢 Number, Distance). Default value is 0.
See internal technical details
  • Grid dimension X is stored as GridDimensionX (Number). Default value is 65.
  • Grid dimension Y is stored as GridDimensionY (Number). Default value is 65.
  • Color is stored as Color (Color). Default value is 255;255;255.
  • Wireframe is stored as Wireframe (Boolean). Default value is ``.
  • Height map (optional) is stored as HeightMapImage (Resource). Default value is ``.
  • Image offset X is stored as ImageOffsetX (Number). Unit is Pixel. Default value is 0.
  • Image offset Y is stored as ImageOffsetY (Number). Unit is Pixel. Default value is 0.

Object actions

Update height map
Update the height map. This is done automatically at the end of every frame, but it can be used manually to avoid a 1-frame delay.

See parameters & details
  • Parameter 0: 👾 Object

Technical note: parameter 1 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is HeightMap3D::HeightMap3D::ForceUpdate.

Load height map
Load a height map from an image file.

See parameters & details
  • Parameter 0: 👾 Object
  • Parameter 1 (imageResource): Image
  • Parameter 2 (🔢 Number): Image cropping offset on X
  • Parameter 3 (🔢 Number): Image cropping offset on Y

Technical note: parameter 4 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is HeightMap3D::HeightMap3D::LoadFromImage.

Grid value
Change the field value at a grid index. The value is bewteen 0 and 1.

See parameters & details
  • Parameter 0: 👾 Object
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Value
  • Parameter 3 (🔢 Number): X grid index
  • Parameter 4 (🔢 Number): Y grid index

Technical note: parameter 5 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is HeightMap3D::HeightMap3D::SetGridValue.

Object conditions

Field point Z
Compare the field Z for a given position in the scene.

See parameters & details
  • Parameter 0: 👾 Object
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare
  • Parameter 3 (🔢 Number): X position in the scene
  • Parameter 4 (🔢 Number): Y position in the scene

Technical note: parameter 5 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is HeightMap3D::HeightMap3D::FieldZ.

Grid dimension X
Compare the number of points in the grid on X axis.

See parameters & details
  • Parameter 0: 👾 Object
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is HeightMap3D::HeightMap3D::GridDimensionX.

Grid dimension Y
Compare the number of points in the grid on Y axis.

See parameters & details
  • Parameter 0: 👾 Object
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare

Technical note: parameter 3 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is HeightMap3D::HeightMap3D::GridDimensionY.

Grid value
Compare the field value at a grid index. The value is bewteen 0 and 1.

See parameters & details
  • Parameter 0: 👾 Object
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare
  • Parameter 3 (🔢 Number): X grid index
  • Parameter 4 (🔢 Number): Y grid index

Technical note: parameter 5 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is HeightMap3D::HeightMap3D::GridValue.

Object expressions

Expression Description
Object.FieldZ(number, number) Return the field Z for a given position in the scene.
🔢 Number X position in the scene
🔢 Number Y position in the scene
Object.GridDimensionX() Return the number of points in the grid on X axis.
Object.GridDimensionY() Return the number of points in the grid on Y axis.
Object.GridValue(number, number) Return the field value at a grid index. The value is bewteen 0 and 1.
🔢 Number X grid index
🔢 Number Y grid index

3D physics height map

A terrain with hills where 3D physics objects can stand.

No expressions for this behavior.

This page is an auto-generated reference page about the 3D height map extension for GDevelop, the open-source, AI-powered, cross-platform game engine designed for everyone. Learn more about all GDevelop extensions here.