unreal.PVGraftDistributorSettings

class unreal.PVGraftDistributorSettings(outer: Object | None = None, name: Name | str = 'None')

Bases: PVBaseSettings

PVGraft Distributor Settings

C++ Source:

  • Plugin: ProceduralVegetationEditor

  • Module: ProceduralVegetation

  • File: PVGraftDistributorSettings.h

Editor Properties: (see get_editor_property/set_editor_property)

  • break_debugger (bool): [Read-Write] If a debugger is attached, a breakpoint will be triggered in the execution code to enable debugging. Only applies when inspecting a debug object. Transient and Editor-only.

  • category (Text): [Read-Write]

  • condition_settings (PVDistributionConditionParams): [Read-Write] Filtering conditions (light, scale, tip, health, etc.).

  • debug (bool): [Read-Write]

  • debug_buffer_size (int32): [Read-Write] Size (in number of floats) of the shader debug print buffer.

  • debug_settings (PCGDebugVisualizationSettings): [Read-Write]

  • description (Text): [Read-Write]

  • determinism_settings (PCGDeterminismSettings): [Read-Write]

  • dump_cooked_hlsl (bool): [Read-Write] Dump the cooked HLSL into the log after it is generated.

  • dump_data_descriptions (bool): [Read-Write] Dump the data descriptions of input/output pins to the log.

  • enabled (bool): [Read-Write]

  • execute_on_gpu (bool): [Read-Write] Whether this node should be executed on the GPU.

  • execution_dependency_required (bool): [Read-Write] If enabled, the execution dependency pin will require to be connected for execution (as any other required pin) and will be used for culling.

  • expose_to_library (bool): [Read-Write]

  • hormone_based_settings (PVDistributionHormoneBasedParams): [Read-Write] Hormone-driven distribution rules (ethylene threshold, scale, angle).

  • mode (PVDistributionSettingsMode): [Read-Write] Choose parametric or hormone-based distribution.

    Parametric: parametric distribution leveraging ramps and gradients to control distribution. HormoneBased: uses the Grower’s growth data for natural-looking placement.

  • only_expose_in_debug_mode (bool): [Read-Write]

  • parametric_settings (PVDistributionParametricParams): [Read-Write] Parametric distribution rules (density, spacing, axil angle).

  • print_shader_debug_values (bool): [Read-Write] Enable use of ‘WriteDebugValue(uint Index, float Value)’ function in your kernel. Allows you to write float values to a buffer for logging on the CPU.

  • profile_kernel_index (int32): [Read-Write] Index of kernel emitted by this node to repeatedly dispatch every frame to enable profiling. Set to -1 to disable profiling. PCG_GPU_KERNEL_PROFILING must be defined in PCG.Build.cs.

  • random_seed (int32): [Read-Write] Random seed for graft placement.

    Independent of the Grower’s RandomSeed. Same seed = identical graft layout.

  • recompute_light (bool): [Read-Write] Recompute per-bud light after grafts are placed.

    When enabled, grafts contribute to light occlusion calculations affecting downstream nodes. Useful if you have additional Foliage Distributors or Senescence-aware nodes after the Grafter. Off = grafts will retain their incoming light data and will not consider its context after distribution.

  • seed (int32): [Read-Write]

  • trigger_render_capture (bool): [Read-Write] Will trigger a render capture when this node executes and a debug object is selected in the graph editor. Transient and Editor-only. Render captures must be enabled (e.g. -AttachRenderDoc or -AttachPIX).

  • use_seed (bool): [Read-Write] deprecated: Implement the PCGSettings virtual UseSeed() override.

  • vector_settings (PVDistributionVectorParams): [Read-Write] Orientation rules: aim, face, roll/pitch/yaw.

  • visualization (PVSettingsVisualization): [Read-Write]