Base Paintable
Base class for all Paintable entities. This class provides customization for materials, exposing common functions to allow you to set custom material parameters, including loading textures from disk.
🧑💻API Source
This page is auto-generated! The Functions, Properties and Events described here are defined in our GitHub's API Repository! Feel free to commit suggestions and changes to the source .json API files!
👪Base Class
This is a Base Class. Base Classes are abstract definitions used to share common methods and events between related child classes, thus you cannot spawn it directly.
Classes that share methods and events from this Base Class: Billboard, Blueprint, Cable, Character, CharacterSimple, Decal, Grenade, Melee, Prop, StaticMesh, Text3D, VehicleWheeled, VehicleWater, Weapon.
Classes that share methods and events from this Base Class: Billboard, Blueprint, Cable, Character, CharacterSimple, Decal, Grenade, Melee, Prop, StaticMesh, Text3D, VehicleWheeled, VehicleWater, Weapon.
🦠 Functions
| Returns | Name | Description | |
|---|---|---|---|
 | Color | GetMaterialColorParameter | Gets a Color parameter from this Actor's material |
| float | GetMaterialScalarParameter | Gets a Scalar parameter from this Actor's material |
| string | GetMaterialTextureParameter | Gets a Texture parameter from this Actor's material |
| Vector | GetMaterialVectorParameter | Gets a Vector parameter from this Actor's material |
| ResetMaterial | Resets the material from the specified index to the original one | |
| SetMaterial | Sets the material at the specified index of this Actor | |
| SetMaterialColorParameter | Sets a Color parameter in this Actor's material | |
 | SetMaterialFromCanvas | Sets the material at the specified index of this Actor to a Canvas object | |
| SetMaterialFromSceneCapture | Sets the material at the specified index of this Actor to a SceneCapture object | |
| SetMaterialFromWebUI | Sets the material at the specified index of this Actor to a WebUI object | |
| SetMaterialScalarParameter | Sets a Scalar parameter in this Actor's material | |
| SetMaterialTextureParameter | Sets a texture parameter in this Actor's material to an image on disk | |
| SetMaterialVectorParameter | Sets a Vector parameter in this Actor's material | |
| SetPhysicalMaterial | Overrides this Actor's Physical Material with a new one |
GetMaterialColorParameter
Gets a Color parameter from this Actor's material
— Returns Color (or nil if parameter was not found).
local color = my_paintable:GetMaterialColorParameter(parameter_name, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| integer | index? | -1 | The material index to get |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to get the material parameter. Pass empty to get from main mesh only |
See also SetMaterialColorParameter.
GetMaterialScalarParameter
Gets a Scalar parameter from this Actor's material
— Returns float (or nil if parameter was not found).
local scalar = my_paintable:GetMaterialScalarParameter(parameter_name, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| integer | index? | -1 | The material index to get |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to get the material parameter. Pass empty to get from main mesh only |
See also SetMaterialScalarParameter.
GetMaterialTextureParameter
Gets a Texture parameter from this Actor's material
— Returns string (or nil if parameter was not found).
local texture = my_paintable:GetMaterialTextureParameter(parameter_name, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| integer | index? | -1 | The material index to get |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to get the material parameter. Pass empty to get from main mesh only |
See also SetMaterialTextureParameter.
GetMaterialVectorParameter
Gets a Vector parameter from this Actor's material
— Returns Vector (or nil if parameter was not found).
local vector = my_paintable:GetMaterialVectorParameter(parameter_name, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| integer | index? | -1 | The material index to get |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to get the material parameter. Pass empty to get from main mesh only |
See also SetMaterialVectorParameter.
ResetMaterial
Resets the material from the specified index to the original one
my_paintable:ResetMaterial(index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| integer | index? | -1 | The material index to apply (-1 means all indices) |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to reset the material. Pass empty to reset on main mesh only |
SetMaterial
Sets the material at the specified index of this Actor
my_paintable:SetMaterial(material_path, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Material Reference | material_path | Required parameter | The new Material to apply |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to apply the material. Pass empty to set on main mesh only |
SetMaterialColorParameter
Sets a Color parameter in this Actor's material
my_paintable:SetMaterialColorParameter(parameter_name, color, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| Color | color | Required parameter | The value to set |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to apply the material parameter. Pass empty to set on main mesh only |
See also GetMaterialColorParameter.
SetMaterialFromCanvas
Sets the material at the specified index of this Actor to a Canvas object
my_paintable:SetMaterialFromCanvas(canvas, index?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Canvas | canvas | Required parameter | The Canvas object to use as a material |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
SetMaterialFromSceneCapture
Sets the material at the specified index of this Actor to a SceneCapture object
my_paintable:SetMaterialFromSceneCapture(scene_capture, index?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| SceneCapture | scene_capture | Required parameter | The SceneCapture object to use as a material |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
SetMaterialFromWebUI
Sets the material at the specified index of this Actor to a WebUI object
my_paintable:SetMaterialFromWebUI(webui, index?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| WebUI | webui | Required parameter | The WebUI object to use as a material |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
SetMaterialScalarParameter
Sets a Scalar parameter in this Actor's material
my_paintable:SetMaterialScalarParameter(parameter_name, scalar, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| float | scalar | Required parameter | The value to set |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to apply the material parameter. Pass empty to set on main mesh only |
See also GetMaterialScalarParameter.
SetMaterialTextureParameter
Sets a texture parameter in this Actor's material to an image on disk
my_paintable:SetMaterialTextureParameter(parameter_name, texture_path, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| Image Path | texture_path | Required parameter | The path to the texture |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to apply the material parameter. Pass empty to set on main mesh only |
See also GetMaterialTextureParameter.
SetMaterialVectorParameter
Sets a Vector parameter in this Actor's material
my_paintable:SetMaterialVectorParameter(parameter_name, vector, index?, attachable_id?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| string | parameter_name | Required parameter | The name of the material parameter |
| Vector | vector | Required parameter | The value to set |
| integer | index? | -1 | The material index to apply (-1 means all indices) |
| string | attachable_id? | | The attachable ID (set with AddSkeletalMeshAttached or AddStaticMeshAttached) to apply the material parameter. Pass empty to set on main mesh only |
See also GetMaterialVectorParameter.
SetPhysicalMaterial
Overrides this Actor's Physical Material with a new one
my_paintable:SetPhysicalMaterial(physical_material_path)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Material Reference | physical_material_path | Required parameter | The Physical Material to override |