Changes

Jump to navigation Jump to search

Documentation/Engine/Units/journey events road event

4,044 bytes added, 07:49, 25 February 2022
m
Attributes: Removed obsolete information about set_idx
The '''journey_events_road_event''' unit class is used to define [[Documentation/Engine/Random_Road_Events|Random Road Events]].
 
All cutscenes attributes ('''start_cutscene''', '''end_cutscene''', '''layer_cutscenes''', '''mirror_cutscenes''', '''signs_cutscenes_inner''' and '''signs_cutscenes_outer''' ) use link pointers of: [[Documentation/Engine/Units/journey_events_cutscene|'''journey_events_cutscene''']] for linking cutscene data to each random event.
== Attributes ==
|unsigned
|
|EventIndex which determines used set of 'master' attributes, like 's setminimal spawn distance' or 'probability' (see /def/world/journey_road_event_master.sii).
|-
|start_cutscene
|array<link_ptr>
|
|Array of layer cutscenes (cutscenes placed between start and end cutscenes).This array has more than one element when stacking more types of cutscenes beside each other for example: roadwork should have first layer for signs and second for actual roadwork. Layer usage cabe be seen below: [[#Composition of the road event]]
|-
|mirror_cutscenes
|array<link_ptr>
|
|Array of layer cutscenes Similar as '''layer_cutscenes''' only that it's used for mirror eventopposite road direction. Check '''mirror_active''' attributes for more info.
|-
|layer_min_curve
|0
|Minimal accident duration, accident will be active for this time at least, even if the road has been released (in game minutes).
|-
|area_tag
|token
|NULL
|Limit the road event only to traffic area with certain tag (no tag for no limitation).
|-
|slow_down_passing
|bool
|false
|Should AI vehicles passing the road event in adjacent lane slow down?
|-
|centerline_displacement
|bool
|false
|Should AI vehicle drive near the centerline when passing the road event?
|-
|bridge_forbidden
|bool
|false
|Prevent spawning of this road event on bridges?
|-
|tunnel_forbidden
|bool
|false
|Prevent spawning of this road event in tunnels?
|-
|left_hand_traffic
|bool
|false
|False for right-hand traffic, true for left-hand traffic.
|-
|allowed_lane_types
|array<token>
|
|Array of allowed lane types. Lane type is allowed if it's unit name contains some of the tokens from this array. Empty array means all lane are allowed (but still can be excluded with '''excluded_lane_types''' array).
|-
|excluded_lane_types
|array<token>
|
|Array of excluded lane types. Lane type is excluded if it's unit name contains some of the tokens from the array.
|-
|allowed_road_looks
|array<token>
|
|Array of allowed road looks. Expressed by suffix token of road look units. Empty array means that all road looks are allowed.
|-
|remove_map_sign
|bool
|
|If true then remove conflicting signs (speed limits) on the map overlapping with the road event.
|-
|inner_lane_allowed
|bool
|false
|Is the road event allowed in the most inner lane?
|-
|center_lane_allowed
|bool
|false
|Is the road event allowed in some of the center lanes?
|-
|outer_lane_allowed
|bool
|false
|Is the road event allowed in the most outer lane?
|-
|allowed_lanes_count
|array<unsigned>
|
|Array of allowed road lanes counts. Empty array means no constraint.
|-
|mirror_active
|bool
|false
|Should road event spawn in the opposite direction too? The opposite direction must fulfill all conditions of the road event. However '''mirror_cutscenes''' will be used in opposite direction instead of '''layer_cutscenes'''.
|-
|forward_allowed
|bool
|true
|Is the road event allowed in the forward direction (nodes[0] -> nodes[1])?
|-
|backward_allowed
|bool
|true
|Is the road event allowed in the backward direction (nodes[1] -> nodes[0])?
|-
|signs_cutscenes_outer
|array<link_ptr>
|
|Array of cutscenes for signs of the most outer lane. More info: [[Documentation/Engine/Random Road Events#Signage]].
|-
|signs_distances_outer
|array<float>
|
|Array of same size as '''signs_cutscenes_outer''' defining distances of signs for the most outer lane, where positive values will place signs before road event and negative will place it after. More info: [[Documentation/Engine/Random Road Events#Signage]].
|-
|signs_cutscenes_inner
|array<link_ptr>
|
|Array of cutscenes for signs of the most inner lane. More info: [[Documentation/Engine/Random Road Events#Signage]].
|-
|signs_distances_inner
|array<float>
|
|Array of same size as '''signs_cutscenes_inner''' defining distances of signs for the most inner lane, where positive values will place signs before road event and negative will place it after. More info: [[Documentation/Engine/Random Road Events#Signage]].
|-
|parent
|link_ptr
|NULL
|Road event parent, all non explicitly defined values are inherited from the parent.
|}
 
= Composition of the road event =
[[File:Engine random event composition.jpg|1024px|Layers in road event]]

Navigation menu