Skip to content

Prop

Extends: Node2D

Description

A Prop is a Dungeondraft asset instance of what the user sees as an object from the ObjectTool. See Asset Instance.

Properties

Sprite Sprite
Rect2 Rect
bool HasShadow
bool Mirror
LightOccluder2D[] occluders
bool BlockLight
bool isHighlighted
bool isSelected
Color borderColor
Rect2 SelectRect

Methods

Dictionary Save ( bool copy = false )
void Load ( Dictionary data )
void SetTexture ( Texture texture )
void SetCustomColor ( Color color )
bool HasCustomColor ( )
Color GetCustomColor ( )
void Highlight ( bool value )
void Select ( bool bvalue )
void SetBlockLight ( bool value )
void GenerateOccluder ( )
void ClearOccluders ( )
void UpdateOccluders ( )

Property Descriptions

  • Sprite Sprite:
    The Sprite displaying the Prop. DO NOT MODIFY.

  • Rect2 Rect:
    The Rect2 enclosing the Prop. DO NOT MODIFY.

  • bool HasShadow:
    Set to toggle the shadow.

  • bool Mirror:
    Set to flip the Prop horizontally.

  • LightOccluder2D[] occluders:
    Array of the Godot LightOccluder2D that block light for this Prop.

  • bool BlockLight:
    Gets the flag that indicates if this object blocks light.

  • bool isHighlighted:
    Determines if the Prop is highlighted. Read only, call Highlight() instead to set.

  • bool isSelected:
    Determines if the Prop is visually selected. Read only, call Select() instead to set.

  • Color borderColor:
    This property is set by Dungeondraft to draw a box when this Prop is highlighted or selected. Modify at your own risk.

  • Rect2 SelectRect:
    This property is set by Dungeondraft to determine the size of the box around the Prop when selected. Automatically updated.

Method Descriptions

  • Dictionary Save ( bool copy = false ):
    Save the Prop into the save file format and return it as a Dictionary. The param copy is only used by copy-pasting feature of Dungeondraft.

  • void Load ( Dictionary data ):
    Load a saved Prop data. Used by a saved map file to load existing objects.


  • void SetCustomColor ( Color color ):
    Update to a new custom color and pass the color to the materials.




  • void Select ( bool bvalue ):
    Visually select the Prop. Does not mean it is selected in the SelectTool.

  • void SetBlockLight ( bool value ):
    Toggle whether this Prop blocks lights. Calls GenerateOccluder() or ClearOccluders internally based on value.

  • void GenerateOccluder ( ):
    Generate Occluders, which Dungeondraft uses to block the light.

  • void ClearOccluders ( ):
    Remove Occluders, which Dungeondraft uses to block the light.

  • void UpdateOccluders ( ):
    Refresh Occluders based on the art, which Dungeondraft uses to block the light.