UE Plugin (4.27)

Patch notes v0.2.0

Blueprints

BP_Coala

Create Cells Async

Create Streets Async

Create Buildings Async

Create Water Async

Place Coala Pois Async

Place Custom Pois Async

Decorate Area

BP_Coala_Interface

Blueprints

BP_Coala

reorganize configurable values
- add missing configuration variables and wrapper for easier map customization (see list below)
- everything plugin related is grouped under the "Coala" category inside the details pannel
  - Pois
    - Poi Configuration
    - Custom Poi Configuration
  - Setup
    - Coala Scale
    - Elevation Scale
    - Area Load Buffer
    - Get Weather Updates
    - Get Weather Delay
    - GPS Accuracy
    - [NEW] Request Context
      - Dropdown list where you decide which data layer you want for map generation
        support multiple selections
  - Streets
    - Street Z Offset
    - Street Default Render Config
    - Streets Config
  - AreaController
    - Player Current Lat
    - Player Current Lon
  - Dev
    - Player Editor Start Lon
    - Player Editor Start Lat
    - [NEW] Enable Movement by Click
      - If checked, you can move on the map by faking GPS data and forwarding it to the plugin
        Editor - right mouse button
        Mobile - click on the screen
      - Print Variables to Screen
    - Decoration
      - Area Decoration Configuration
  - Cell
    - Cell Default Render Config
    - Render Config Cell
  - Crime
    - Render Crimes
    - Crime Render Config
  - Transportation
    - Transportation Render Config
  - Buildings
    - Building Render Config
  - Water
    - Water Render Config
Blueprint logic graph rework
- cleanup unneeded variables and duplicated logic regarding map generation
- rework old linear map generation with a new async map generation logic that is driven by nodes and delegates
- COALA map data request asynchronously in the background
- asynchronously layer generation nodes (see below)
  - improved useability by adding delegates
    - let you continue work with a spawned object asynchronously in blueprints
- a whole new documentation

Create Cells Async

starts creating the cells (terrain) in the background and let you continue with other work
- inputs
  - Area
    - from which COALA area data do you want to generate the terrain
      - Tip: 3D terrain is only generated if elevation data are available in this area object. They are only provided if selected on the request context dropdown.
  - Cell Default Render Config
    - this config is used if none of the other ones are matching
  - Render Config Cell
    - Collection of cell render configuration objects that will use if the requirements are met
- provided delegate
  - On Done
    - called if the generation is done
      - parameter
        Cell Mesh Actor - the generated parent actor that "holds" the mesh
        Area - the area data that was used for the generation process

Create Streets Async

starts creating the street meshes in the background and let you continue with other work
- inputs
  - Area
    - from which COALA area data do you want to generate the street meshes
  - Default Render Config
    - this config is used if none of the other ones are matching
  - Render Config
    - Collection of render configuration objects that will use if the requirements are met
- provided delegate
  - On Done
    - called if the generation is done
      - parameter
        Area - the area data that was used for the generation process

Create Buildings Async

starts creating the building meshes in the background and let you continue with other work
- inputs
  - Area
    - from which COALA area data do you want to generate the street meshes
  - Render Config
    - used configuration object for building generation (materials, UV calculation, mesh merging, level clamping, scaling and limiting, ... )
- provided delegate
  - On Building Created
    - Called if ONE building is generated
      - Tip: Only make sense if "Merge Meshes" is disabled in the used building render configuration.
        parameter
        Cell Mesh Actor - the generated actor that holds the mesh information
        Area - the area data that was used for this building generation
  - On Done
    - called if the generation is done
      - parameter
        Area - the area data that was used for the generation process

Create Water Async

starts creating the building meshes in the background and let you continue with other work
- inputs
  - Area
    - from which COALA area data do you want to generate the water meshes
  - Render Config
    - used configuration object for water generation (materials, UV calculation, mesh merging, outline )
- provided delegate
  - On Water Created
    - Called if ONE water mesh is generated
      - parameter
        Water Mesh Actor - the generated actor that holds the mesh information
  - On Done
    - called if the generation is done
      - parameter
        Area - the area data that was used for the generation process

Place Coala Pois Async

starts placing the COALA point of interest in the background and let you continue with other work
- inputs
  - Area
    - from which COALA area data do you want to place the COALA point of interest
      - Tip: Not CUSTOM point of interest
  - Coala Poi Configuration
    - used configuration object for deciding which object should be placed on the map on the point of interest position
- provided delegate
  - On Poi Placed
    - Called if ONE point of interest is placed
      - parameter
        Poi Actor - the placed actor that represents the point of interest
  - On Done
    - called if the placement is done
      - parameter
        Area - the area data that was used for the generation process

Place Custom Pois Async

starts placing your custom point of interest in the background and let you continue with other work
- inputs
  - Area
    - from which COALA area data do you want to place your custom point of interest
      - Tip: Not COALA point of interest
  - Custom Poi Configuration
    - used configuration object for deciding which object should be placed on the map on the custom point of interest position
- provided delegate
  - On Custom Poi Placed
    - Called if ONE custom point of interest is placed
      - parameter
        Custom Poi Actor - the placed actor that represents the custom point of interest
  - On Done
    - called if the placement is done
      - parameter
        Area - the area data that was used for the generation process

Decorate Area

starts decorating the area in the background and let you continue with other work
- inputs
  - Area
    - from which COALA area data do you want to have a better-looking map
  - Configs
    - used configuration object for deciding which object should be placed on the map
- provided delegate
  - On Decoration Object Placed
    - Called if ONE decoration object is placed.
      - parameter
        Decoration Object - the placed object
  - On Done
    - called if the placement is done
      - parameter
        Area - the area data that was used for the generation process

BP_Coala_Interface

reorganize configurable values
- everything plugin related is grouped under the "Coala" category inside the details pannel
  - Widget
    - Player Widget - the UI/HUD that will be used
    - Loading Widget - the UI/HUD that will be used on start to prevent the users view to the map generation
    - Movement Widget
  - Setup
    - Show Loading - do you want to have a loading widget on the very first map generation
- blueprint improvements
- event-driven automatic disable loading screen if all needed areas for the map generation are done
  - this is achieved by cooperating with the new events provided by BP_Coala
    - Request Coala Area - fired as soon as new COALA area data are requested
    - Map Loaded - fired as soon as all areas are generated for the map
      - to prevent that the app user see how the map is actually generated

Page updated

Report abuse