blender-addons/btrace/bTrace_props.py

552 lines
19 KiB
Python

# SPDX-License-Identifier: GPL-2.0-or-later
import bpy
from bpy.types import (
Panel,
PropertyGroup,
)
from bpy.props import (
FloatProperty,
EnumProperty,
IntProperty,
BoolProperty,
FloatVectorProperty,
)
# Class to define properties
class TracerProperties(PropertyGroup):
"""Options for tools"""
curve_spline: EnumProperty(
name="Spline",
items=(("POLY", "Poly", "Use Poly spline type"),
("NURBS", "Nurbs", "Use Nurbs spline type"),
("BEZIER", "Bezier", "Use Bezier spline type")),
description="Choose which type of spline to use when curve is created",
default="BEZIER"
)
curve_handle: EnumProperty(
name="Handle",
items=(("ALIGNED", "Aligned", "Use Aligned Handle Type"),
("AUTOMATIC", "Automatic", "Use Auto Handle Type"),
("FREE_ALIGN", "Free Align", "Use Free Handle Type"),
("VECTOR", "Vector", "Use Vector Handle Type")),
description="Choose which type of handle to use when curve is created",
default="VECTOR"
)
curve_resolution: IntProperty(
name="Bevel Resolution",
min=1, max=32,
default=4,
description="Adjust the Bevel resolution"
)
curve_depth: FloatProperty(
name="Bevel Depth",
min=0.0, max=100.0,
default=0.1,
description="Adjust the Bevel depth"
)
curve_u: IntProperty(
name="Resolution U",
min=0, max=64,
default=12,
description="Adjust the Surface resolution"
)
curve_join: BoolProperty(
name="Join Curves",
default=False,
description="Join all the curves after they have been created"
)
curve_smooth: BoolProperty(
name="Smooth",
default=True,
description="Render curve smooth"
)
# Option to Duplicate Mesh
object_duplicate: BoolProperty(
name="Apply to Copy",
default=False,
description="Apply curve to a copy of object"
)
# Distort Mesh options
distort_modscale: IntProperty(
name="Modulation Scale",
min=0, max=50,
default=2,
description="Add a scale to modulate the curve at random points, set to 0 to disable"
)
distort_noise: FloatProperty(
name="Mesh Noise",
min=0.0, max=50.0,
default=0.00,
description="Adjust noise added to mesh before adding curve"
)
# Particle Options
particle_step: IntProperty(
name="Step Size",
min=1, max=50,
default=5,
description="Sample one every this number of frames"
)
particle_auto: BoolProperty(
name="Auto Frame Range",
default=True,
description="Calculate Frame Range from particles life"
)
particle_f_start: IntProperty(
name='Start Frame',
min=1, max=5000,
default=1,
description='Start frame'
)
particle_f_end: IntProperty(
name="End Frame",
min=1, max=5000,
default=250,
description="End frame"
)
# F-Curve Modifier Properties
fcnoise_rot: BoolProperty(
name="Rotation",
default=False,
description="Affect Rotation"
)
fcnoise_loc: BoolProperty(
name="Location",
default=True,
description="Affect Location"
)
fcnoise_scale: BoolProperty(
name="Scale",
default=False,
description="Affect Scale"
)
fcnoise_amp: IntProperty(
name="Amp",
min=1, max=500,
default=5,
description="Adjust the amplitude"
)
fcnoise_timescale: FloatProperty(
name="Time Scale",
min=1, max=500,
default=50,
description="Adjust the time scale"
)
fcnoise_key: BoolProperty(
name="Add Keyframe",
default=True,
description="Keyframe is needed for tool, this adds a LocRotScale keyframe"
)
show_curve_settings: BoolProperty(
name="Curve Settings",
default=False,
description="Change the curve settings for the created curve"
)
material_settings: BoolProperty(
name="Material Settings",
default=False,
description="Change the material settings for the created curve"
)
particle_settings: BoolProperty(
name="Particle Settings",
default=False,
description="Show the settings for the created curve"
)
animation_settings: BoolProperty(
name="Animation Settings",
default=False,
description="Show the settings for the Animations"
)
distort_curve: BoolProperty(
name="Add Distortion",
default=False,
description="Set options to distort the final curve"
)
connect_noise: BoolProperty(
name="F-Curve Noise",
default=False,
description="Adds F-Curve Noise Modifier to selected objects"
)
settings_objectTrace: BoolProperty(
name="Object Trace Settings",
default=False,
description="Trace selected mesh object with a curve"
)
settings_objectsConnect: BoolProperty(
name="Objects Connect Settings",
default=False,
description="Connect objects with a curve controlled by hooks"
)
settings_objectTrace: BoolProperty(
name="Object Trace Settings",
default=False,
description="Trace selected mesh object with a curve"
)
respect_order: BoolProperty(
name="Order",
default=False,
description="Remember order objects were selected"
)
settings_particleTrace: BoolProperty(
name="Particle Trace Settings",
default=False,
description="Trace particle path with a curve"
)
settings_particleConnect: BoolProperty(
name="Particle Connect Settings",
default=False,
description="Connect particles with a curves and animated over particle lifetime"
)
settings_growCurve: BoolProperty(
name="Grow Curve Settings",
default=False,
description="Animate curve bevel over time by keyframing points radius"
)
settings_fcurve: BoolProperty(
name="F-Curve Settings",
default=False,
description="F-Curve Settings"
)
settings_toggle: BoolProperty(
name="Settings",
default=False,
description="Toggle Settings"
)
# Animation Options
anim_auto: BoolProperty(
name="Auto Frame Range",
default=True,
description="Automatically calculate Frame Range"
)
anim_f_start: IntProperty(
name="Start",
min=1, max=2500,
default=1,
description="Start frame / Hidden object"
)
anim_length: IntProperty(
name="Duration",
min=1,
soft_max=1000, max=2500,
default=100,
description="Animation Length"
)
anim_f_fade: IntProperty(
name="Fade After",
min=0,
soft_max=250, max=2500,
default=10,
description="Fade after this frames / Zero means no fade"
)
anim_delay: IntProperty(
name="Grow",
min=0, max=50,
default=5,
description="Frames it takes a point to grow"
)
anim_tails: BoolProperty(
name='Tails on endpoints',
default=True,
description='Set radius to zero for open splines endpoints'
)
anim_keepr: BoolProperty(
name="Keep Radius",
default=True,
description="Try to keep radius data from original curve"
)
animate: BoolProperty(
name="Animate Result",
default=False,
description="Animate the final curve objects"
)
# Convert to Curve options
convert_conti: BoolProperty(
name="Continuous",
default=True,
description="Create a continuous curve using verts from mesh"
)
convert_everyedge: BoolProperty(
name="Every Edge",
default=False,
description="Create a curve from all verts in a mesh"
)
convert_edgetype: EnumProperty(
name="Edge Type for Curves",
items=(("CONTI", "Continuous", "Create a continuous curve using verts from mesh"),
("EDGEALL", "All Edges", "Create a curve from every edge in a mesh")),
description="Choose which type of spline to use when curve is created",
default="CONTI"
)
convert_joinbefore: BoolProperty(
name="Join objects before convert",
default=False,
description="Join all selected mesh to one object before converting to mesh"
)
# Mesh Follow Options
fol_edge_select: BoolProperty(
name="Edge",
default=False,
description="Grow from edges"
)
fol_vert_select: BoolProperty(
name="Vertex",
default=False,
description="Grow from verts"
)
fol_face_select: BoolProperty(
name="Face",
default=True,
description="Grow from faces"
)
fol_mesh_type: EnumProperty(
name="Mesh type",
default="VERTS",
description="Mesh feature to draw cruves from",
items=(("VERTS", "Verts", "Draw from Verts"),
("EDGES", "Edges", "Draw from Edges"),
("FACES", "Faces", "Draw from Faces"),
("OBJECT", "Object", "Draw from Object origin"))
)
fol_start_frame: IntProperty(
name="Start Frame",
min=1, max=2500,
default=1,
description="Start frame for range to trace"
)
fol_end_frame: IntProperty(
name="End Frame",
min=1, max=2500,
default=250,
description="End frame for range to trace"
)
fol_perc_verts: FloatProperty(
name="Reduce selection by",
min=0.001, max=1.000,
default=0.5,
description="percentage of total verts to trace"
)
fol_sel_option: EnumProperty(
name="Selection type",
description="Choose which objects to follow",
default="RANDOM",
items=(("RANDOM", "Random", "Follow Random items"),
("CUSTOM", "Custom Select", "Follow selected items"),
("ALL", "All", "Follow all items"))
)
trace_mat_color: FloatVectorProperty(
name="Material Color",
description="Choose material color",
min=0, max=1,
default=(0.0, 0.3, 0.6),
subtype="COLOR"
)
trace_mat_random: BoolProperty(
name="Random Color",
default=False,
description='Make the material colors random'
)
# Material custom Properties properties
mat_simple_adv_toggle: EnumProperty(
name="Material Options",
items=(("SIMPLE", "Simple", "Show Simple Material Options"),
("ADVANCED", "Advanced", "Show Advanced Material Options")),
description="Choose which Material Options to show",
default="SIMPLE"
)
mat_run_color_blender: BoolProperty(
name="Run Color Blender",
default=False,
description="Generate colors from a color scheme"
)
mmColors: EnumProperty(
items=(("RANDOM", "Random", "Use random colors"),
("CUSTOM", "Custom", "Use custom colors"),
("BW", "Black/White", "Use Black and White"),
("BRIGHT", "Bright Colors", "Use Bright colors"),
("EARTH", "Earth", "Use Earth colors"),
("GREENBLUE", "Green to Blue", "Use Green to Blue colors")),
description="Choose which type of colors the materials uses",
default="BRIGHT",
name="Define a color palette"
)
# Custom property for how many keyframes to skip
mmSkip: IntProperty(
name="frames",
min=1, max=500,
default=20,
description="Number of frames between each keyframes"
)
# Custom property to enable/disable random order for the
mmBoolRandom: BoolProperty(
name="Random Order",
default=False,
description="Randomize the order of the colors"
)
# Custom Color properties
mmColor1: FloatVectorProperty(
min=0, max=1,
default=(0.8, 0.8, 0.8),
description="Custom Color 1", subtype="COLOR"
)
mmColor2: FloatVectorProperty(
min=0, max=1,
default=(0.8, 0.8, 0.3),
description="Custom Color 2",
subtype="COLOR"
)
mmColor3: FloatVectorProperty(
min=0, max=1,
default=(0.8, 0.5, 0.6),
description="Custom Color 3",
subtype="COLOR"
)
mmColor4: FloatVectorProperty(
min=0, max=1,
default=(0.2, 0.8, 0.289),
description="Custom Color 4",
subtype="COLOR"
)
mmColor5: FloatVectorProperty(
min=0, max=1,
default=(1.0, 0.348, 0.8),
description="Custom Color 5",
subtype="COLOR"
)
mmColor6: FloatVectorProperty(
min=0, max=1,
default=(0.4, 0.67, 0.8),
description="Custom Color 6",
subtype="COLOR"
)
mmColor7: FloatVectorProperty(
min=0, max=1,
default=(0.66, 0.88, 0.8),
description="Custom Color 7",
subtype="COLOR"
)
mmColor8: FloatVectorProperty(
min=0, max=1,
default=(0.8, 0.38, 0.22),
description="Custom Color 8",
subtype="COLOR"
)
# BW Color properties
bwColor1: FloatVectorProperty(
min=0, max=1,
default=(0.0, 0.0, 0.0),
description="Black/White Color 1",
subtype="COLOR"
)
bwColor2: FloatVectorProperty(
min=0, max=1,
default=(1.0, 1.0, 1.0),
description="Black/White Color 2",
subtype="COLOR"
)
# Bright Color properties
brightColor1: FloatVectorProperty(
min=0, max=1,
default=(1.0, 0.0, 0.75),
description="Bright Color 1",
subtype="COLOR"
)
brightColor2: FloatVectorProperty(
min=0, max=1,
default=(0.0, 1.0, 1.0),
description="Bright Color 2",
subtype="COLOR"
)
brightColor3: FloatVectorProperty(
min=0, max=1,
default=(0.0, 1.0, 0.0),
description="Bright Color 3",
subtype="COLOR"
)
brightColor4: FloatVectorProperty(
min=0, max=1,
default=(1.0, 1.0, 0.0),
description="Bright Color 4", subtype="COLOR"
)
# Earth Color Properties
earthColor1: FloatVectorProperty(
min=0, max=1,
default=(0.068, 0.019, 0.014),
description="Earth Color 1",
subtype="COLOR"
)
earthColor2: FloatVectorProperty(
min=0, max=1,
default=(0.089, 0.060, 0.047),
description="Earth Color 2",
subtype="COLOR"
)
earthColor3: FloatVectorProperty(
min=0, max=1,
default=(0.188, 0.168, 0.066),
description="Earth Color 3",
subtype="COLOR"
)
earthColor4: FloatVectorProperty(
min=0, max=1,
default=(0.445, 0.296, 0.065),
description="Earth Color 4",
subtype="COLOR"
)
earthColor5: FloatVectorProperty(
min=0, max=1,
default=(0.745, 0.332, 0.065),
description="Earth Color 5",
subtype="COLOR"
)
# Green to Blue Color properties
greenblueColor1: FloatVectorProperty(
min=0, max=1,
default=(0.296, 0.445, 0.074),
description="Green/Blue Color 1",
subtype="COLOR"
)
greenblueColor2: FloatVectorProperty(
min=0, max=1,
default=(0.651, 1.0, 0.223),
description="Green/Blue Color 2",
subtype="COLOR"
)
greenblueColor3: FloatVectorProperty(
min=0, max=1,
default=(0.037, 0.047, 0.084),
description="Green/Blue Color 3",
subtype="COLOR"
)
# Toolbar show/hide booleans for tool options
btrace_menu_items = [
('tool_help', "Choose Tool",
"Pick one of the options below", "INFO", 0),
('tool_objectTrace', "Object Trace",
"Trace selected mesh object with a curve", "FORCE_MAGNETIC", 1),
('tool_objectsConnect', "Objects Connect",
"Connect objects with a curve controlled by hooks", "OUTLINER_OB_EMPTY", 2),
('tool_meshFollow', "Mesh Follow",
"Follow selection items on animated mesh object", "DRIVER", 3),
# ('tool_handwrite', "Handwriting",
# "Create and Animate curve using the grease pencil", "BRUSH_DATA", 4),
('tool_particleTrace', "Particle Trace",
"Trace particle path with a curve", "PARTICLES", 5),
('tool_particleConnect', "Particle Connect",
"Connect particles with a curves and animated over particle lifetime", "MOD_PARTICLES", 6),
('tool_growCurve', "Grow Curve",
"Animate curve bevel over time by keyframing points radius", "META_BALL", 7),
('tool_fcurve', "F-Curve Noise",
"Add F-Curve noise to selected objects", "RNDCURVE", 8),
('tool_colorblender', "Color Blender",
"Pick the color of the created curves", "COLOR", 9),
]
btrace_toolmenu: EnumProperty(
name="Tools",
items=btrace_menu_items,
description="",
default='tool_help'
)