o3de/AutomatedTesting/Gem/PythonTests/physics/C12905527_ForceRegion_MagnitudeDeviation.py

"""
All or portions of this file Copyright (c) Amazon.com, Inc. or its affiliates or
its licensors.
For complete copyright and license terms please see the LICENSE at the root of this
distribution (the "License"). All use of this software is governed by the License,
or, if provided, by the license below or the license accompanying this file. Do not
remove or modify any license notices. This file is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
"""

# Test case ID : C12905527
# Test Case Title : Check that deviation occurring in Force Magnitude due to Values in Force direction is not large
# URL of the test case : https://testrail.agscollab.com/index.php?/cases/view/12905527

# fmt: off
class Tests():
    enter_game_mode       = ("Entered game mode",                                       "Failed to enter game mode")
    find_force_region     = ("Force region was found",                                  "Force region was not found")
    find_sphere           = ("Sphere was found",                                        "Sphere was not found")
    sphere_entered_region = ("Sphere entered force region",                             "Sphere did not enter force region")
    sphere_exited_region  = ("Sphere exited force region",                              "Sphere did not exit force region")
    force_magnitude_close = ("The net force magnitude was close to the expected value", "The net force magnitude was not close to the expected value")
    exit_game_mode        = ("Exited game mode",                                        "Couldn't exit game mode")
# fmt: on


def C12905527_ForceRegion_MagnitudeDeviation():
    """
    Summary:
    Runs an automated test to ensure that the calculated net force magnitude is close to the configured value

    Level Description:
    A sphere (Sphere) is positioned above a force region (ForceRegion)
        Sphere has a sphere PhysX collider and PhysX Rigid Body. Gravity is disabled, and it has an initial velocity of
        2 m/s in the Z direction.

        ForceRegion has a box PhysX collider and PhysX Force Region. Magnitude on the force region is set to 1,000,000.0

    Expected Behavior:
    The sphere enters and exits the force region. on_calc_net_force returns a value close to 1,000,000.0

    Test Steps:
    1) Open level
    2) Enter game mode
    3) Validate entities
    4) Wait for the sphere to enter and exit the force region
    5) Check the calculated net force against what we expect
    6) Exit game mode
    7) Close the editor

    Note:
    - This test file must be called from the Open 3D Engine Editor command terminal
    - Any passed and failed tests are written to the Editor.log file.
            Parsing the file or running a log_monitor are required to observe the test results.

    :return: None
    """
    import os
    import sys

    import ImportPathHelper as imports

    imports.init()


    from utils import Report
    from utils import TestHelper as helper

    import azlmbr
    import azlmbr.legacy.general as general

    EXPECTED_MAGNITUDE = 1000000.0
    PERMISSIBLE_ERROR = 0.001  # +/- 0.1%
    TIMEOUT = 1.0

    class Sphere:
        def __init__(self, name):
            self.name = name
            self.id = general.find_game_entity(name)
            self.entered_force_region = False
            self.exited_force_region = False
            self.net_force_magnitude = 0

    def on_trigger_enter(args):
        Report.info("triggered")
        other_id = args[0]
        if other_id.Equal(sphere.id):
            sphere.entered_force_region = True

    def on_trigger_exit(args):
        other_id = args[0]
        if other_id.Equal(sphere.id):
            sphere.exited_force_region = True

    def on_calc_net_force(args):
        other_id = args[1]
        force_magnitude = args[3]

        if other_id.Equal(sphere.id):
            sphere.net_force_magnitude = force_magnitude

    helper.init_idle()
    # 1) Open level
    Report.info(general.get_current_level_name())
    helper.open_level("Physics", "C12905527_ForceRegion_MagnitudeDeviation")

    # 2) Enter game mode
    helper.enter_game_mode(Tests.enter_game_mode)

    # 3) Validate entities
    sphere = Sphere("Sphere")
    force_region_id = general.find_game_entity("ForceRegion")

    Report.critical_result(Tests.find_sphere, sphere.id.IsValid())
    Report.critical_result(Tests.find_force_region, force_region_id.IsValid())

    # Create handlers
    trigger_handler = azlmbr.physics.TriggerNotificationBusHandler()
    trigger_handler.connect(force_region_id)
    trigger_handler.add_callback("OnTriggerEnter", on_trigger_enter)
    trigger_handler.add_callback("OnTriggerExit", on_trigger_exit)

    net_force_handler = azlmbr.physics.ForceRegionNotificationBusHandler()
    net_force_handler.connect(None)
    net_force_handler.add_callback("OnCalculateNetForce", on_calc_net_force)

    # 4) Wait for the sphere to enter and exit the force region
    Report.result(Tests.sphere_entered_region, helper.wait_for_condition(lambda: sphere.entered_force_region, TIMEOUT))
    Report.result(Tests.sphere_exited_region, helper.wait_for_condition(lambda: sphere.exited_force_region, TIMEOUT))

    # 5) Check the calculated net force against what we expect
    absolute_difference = abs(sphere.net_force_magnitude - EXPECTED_MAGNITUDE)
    error = absolute_difference / EXPECTED_MAGNITUDE
    net_force_was_close = error < PERMISSIBLE_ERROR

    Report.result(Tests.force_magnitude_close, net_force_was_close)
    if not net_force_was_close:
        Report.info(
            "\nExpected Magnitude: {}"
            "\nActual Magnitude: {}"
            "\nPermissible Error: {}"
            "\nMeasured Error: {}".format(EXPECTED_MAGNITUDE, sphere.net_force_magnitude, PERMISSIBLE_ERROR, error)
        )

    # 6) Exit game mode
    helper.exit_game_mode(Tests.exit_game_mode)


if __name__ == "__main__":
    import ImportPathHelper as imports
    imports.init()

    from utils import Report
    Report.start_test(C12905527_ForceRegion_MagnitudeDeviation)