move_x_preset.py

# SPDX-FileCopyrightText: © 2016 Michel Anders (varkenvarken) & contributors
#
# SPDX-License-Identifier: GPL-2.0-or-later

bl_info = {
    "name": "Simple Move X Operator",
    "author": "Your Name",
    "version": (0, 0, 5),
    "blender": (5, 0, 0),
    "location": "Object > Move X",
    "description": "Move the active object along the X axis (with preset)",
    "category": "Object",
}

from bpy.types import Operator
from bpy.props import FloatProperty

# This is literally the same move x operator from the first module
# but with the "PRESET" option added. This will result in a preset
# menu to be shown atop of the amount property when this operator is
# executed, allowing the user to store a value for the amount with
# a given name. This isn´t very useful for a single property, but for
# operators with lots of properties and/or string properties it is.


class OBJECT_OT_move_x(Operator):
    bl_idname = "object.move_x"
    bl_label = "Move X"
    bl_options = {"REGISTER", "UNDO", "PRESET"}

    amount: FloatProperty(
        name="Amount", description="Amount to move along X axis", default=1.0
    )  # type: ignore

    def execute(self, context):
        """Move the active object by a configurable amount along the x-axis"""
        context.active_object.location.x += self.amount
        return {"FINISHED"}

    @classmethod
    def poll(cls, context):
        """Ensure we have an active object and that we are in object mode"""
        return context.active_object is not None and context.mode == "OBJECT"


from bpy.utils import register_class, unregister_class
from bpy.types import VIEW3D_MT_object


def menu_func(self, context):
    self.layout.operator(OBJECT_OT_move_x.bl_idname)


def register():
    register_class(OBJECT_OT_move_x)
    VIEW3D_MT_object.append(menu_func)


def unregister():
    VIEW3D_MT_object.remove(menu_func)
    unregister_class(OBJECT_OT_move_x)


if __name__ == "__main__":
    register()