Images as Planes: Improve option panels #104936

Closed
Sun Kim wants to merge 9 commits from persun/blender-addons:iap_options_ui into main

When changing the target branch, be careful to rebase the branch in your fork to match. See documentation.
Showing only changes of commit 6573541033 - Show all commits

View File

@ -609,7 +609,7 @@ class IMPORT_IMAGE_OT_to_plane(Operator, AddObjectHelper):
# Properties - Importing # Properties - Importing
force_reload: BoolProperty( force_reload: BoolProperty(
name="Force Reload", default=False, name="Force Reload", default=False,
description="Force reloading of the image if already opened elsewhere in Blender" description="Force reload the image if it is already opened elsewhere in Blender"
) )
image_sequence: BoolProperty( image_sequence: BoolProperty(
@ -629,7 +629,10 @@ class IMPORT_IMAGE_OT_to_plane(Operator, AddObjectHelper):
'Z-': Vector(( 0, 0, -1)), 'Z-': Vector(( 0, 0, -1)),
} }
offset: BoolProperty(name="Offset Planes", default=True, description="Offset Planes From Each Other") offset: BoolProperty(
name="Offset Planes", default=True,
description="Offset planes from each other. "
"If disabled, multiple planes will be created at the same location")
OFFSET_MODES = ( OFFSET_MODES = (
('X+', "X+", "Side by Side to the Left"), ('X+', "X+", "Side by Side to the Left"),
@ -640,24 +643,24 @@ class IMPORT_IMAGE_OT_to_plane(Operator, AddObjectHelper):
('Z-', "Z-", "Stacked Below"), ('Z-', "Z-", "Stacked Below"),
) )
offset_axis: EnumProperty( offset_axis: EnumProperty(
name="Orientation", default='X+', items=OFFSET_MODES, name="Offset Direction", default='X+', items=OFFSET_MODES,
description="How planes are oriented relative to each others' local axis" description="How planes are oriented relative to each others' local axis"
) )
offset_amount: FloatProperty( offset_amount: FloatProperty(
name="Offset", soft_min=0, default=0.1, description="Space between planes", name="Offset Distance", soft_min=0, default=0.1, description="Set distance between each plane",
subtype='DISTANCE', unit='LENGTH' subtype='DISTANCE', unit='LENGTH'
) )
AXIS_MODES = ( AXIS_MODES = (
('X+', "X+", "Facing Positive X"), ('X+', "X+", "Facing positive X"),
('Y+', "Y+", "Facing Positive Y"), ('Y+', "Y+", "Facing positive Y"),
('Z+', "Z+ (Up)", "Facing Positive Z"), ('Z+', "Z+", "Facing positive Z"),
('X-', "X-", "Facing Negative X"), ('X-', "X-", "Facing negative X"),
('Y-', "Y-", "Facing Negative Y"), ('Y-', "Y-", "Facing negative Y"),
('Z-', "Z- (Down)", "Facing Negative Z"), ('Z-', "Z-", "Facing negative Z"),
('CAM', "Face Camera", "Facing Camera"), ('CAM', "Face Camera", "Facing camera"),
('CAM_AX', "Main Axis", "Facing the Camera's dominant axis"), ('CAM_AX', "Camera's Main Axis", "Facing the camera's dominant axis"),
) )
align_axis: EnumProperty( align_axis: EnumProperty(
name="Align", default='CAM_AX', items=AXIS_MODES, name="Align", default='CAM_AX', items=AXIS_MODES,
@ -667,7 +670,7 @@ class IMPORT_IMAGE_OT_to_plane(Operator, AddObjectHelper):
prev_align_axis: EnumProperty( prev_align_axis: EnumProperty(
items=AXIS_MODES + (('NONE', '', ''),), default='NONE', options={'HIDDEN', 'SKIP_SAVE'}) items=AXIS_MODES + (('NONE', '', ''),), default='NONE', options={'HIDDEN', 'SKIP_SAVE'})
align_track: BoolProperty( align_track: BoolProperty(
name="Track Camera", default=False, description="Always face the camera" name="Track Camera", default=False, description="Add a constraint to make the planes to track the camera"
) )
# ----------------- # -----------------
@ -686,21 +689,21 @@ class IMPORT_IMAGE_OT_to_plane(Operator, AddObjectHelper):
SIZE_MODES = ( SIZE_MODES = (
('ABSOLUTE', "Absolute", "Use absolute size"), ('ABSOLUTE', "Absolute", "Use absolute size"),
('CAMERA', "Camera Relative", "Scale to the camera frame"), ('CAMERA', "Scale to Camera Frame", "Scale to fit or fill the camera frame"),
('DPI', "Dpi", "Use definition of the image as dots per inch"), ('DPI', "Pixels per Inch", "Scale based on pixels per inch"),
('DPBU', "Dots/BU", "Use definition of the image as dots per Blender Unit"), ('DPBU', "Pixels per Blender Unit", "Scale based on pixels per Blender Unit"),
) )
size_mode: EnumProperty( size_mode: EnumProperty(
name="Size Mode", default='ABSOLUTE', items=SIZE_MODES, name="Size Mode", default='ABSOLUTE', items=SIZE_MODES,
update=update_size_mode, update=update_size_mode,
description="How the size of the plane is computed") description="Set how the size of the plane is computed")
FILL_MODES = ( FILL_MODES = (
('FILL', "Fill", "Fill camera frame, spilling outside the frame"), ('FILL', "Fill", "Fill camera frame, spilling outside the frame"),
('FIT', "Fit", "Fit entire image within the camera frame"), ('FIT', "Fit", "Fit entire image within the camera frame"),
) )
fill_mode: EnumProperty(name="Scale", default='FILL', items=FILL_MODES, fill_mode: EnumProperty(name="Scale", default='FILL', items=FILL_MODES,
description="How large in the camera frame is the plane") description="Method to scale the plane with the camera frame")
height: FloatProperty(name="Height", description="Height of the created plane", height: FloatProperty(name="Height", description="Height of the created plane",
default=1.0, min=0.001, soft_min=0.001, subtype='DISTANCE', unit='LENGTH') default=1.0, min=0.001, soft_min=0.001, subtype='DISTANCE', unit='LENGTH')
@ -713,13 +716,13 @@ class IMPORT_IMAGE_OT_to_plane(Operator, AddObjectHelper):
SHADERS = ( SHADERS = (
('PRINCIPLED',"Principled","Principled Shader"), ('PRINCIPLED',"Principled","Principled Shader"),
('SHADELESS', "Shadeless", "Only visible to camera and reflections"), ('SHADELESS', "Shadeless", "Only visible to camera and reflections"),
('EMISSION', "Emit", "Emission Shader"), ('EMISSION', "Emission", "Emission Shader"),
) )
shader: EnumProperty(name="Shader", items=SHADERS, default='PRINCIPLED', description="Node shader to use") shader: EnumProperty(name="Shader", items=SHADERS, default='PRINCIPLED', description="Node shader to use")
emit_strength: FloatProperty( emit_strength: FloatProperty(
name="Strength", min=0.0, default=1.0, soft_max=10.0, name="Emission Strength", min=0.0, default=1.0, soft_max=10.0,
step=100, description="Brightness of Emission Texture") step=100, description="Strength of emission")
use_transparency: BoolProperty( use_transparency: BoolProperty(
name="Use Alpha", default=True, name="Use Alpha", default=True,
@ -751,11 +754,11 @@ class IMPORT_IMAGE_OT_to_plane(Operator, AddObjectHelper):
overwrite_material: BoolProperty( overwrite_material: BoolProperty(
name="Overwrite Material", default=True, name="Overwrite Material", default=True,
description="Overwrite existing Material (based on material name)") description="Overwrite existing material with the same name)")
compositing_nodes: BoolProperty( compositing_nodes: BoolProperty(
name="Setup Corner Pin", default=False, name="Setup Corner Pin", default=False,
description="Build Compositor Nodes to reference this image " description="Build compositor nodes to reference this image "
"without re-rendering") "without re-rendering")
# ------------------ # ------------------