cam.testing

Fabex ‘testing.py’ © 2012 Vilem Novak

Functions for automated testing.

Attributes

tests
p

Functions

addTestCurve(loc)	Add a test curve to the Blender scene.
addTestMesh(loc)	Add a test mesh to the Blender scene.
deleteFirstVert(ob)	Delete the first vertex of a given object.
testCalc(o)	Test the calculation of the CAM path for a given object.
testCutout(pos)	Test the cutout functionality in the scene.
testPocket(pos)	Test the pocket operation in a 3D scene.
testParallel(pos)	Test the parallel functionality of the CAM operations.
testWaterline(pos)	Test the waterline functionality in the scene.
testSimulation()	Testsimulation function.
cleanUp()	Clean up the Blender scene by removing all objects and CAM
testOperation(i)	Test the operation of a CAM path in Blender.
testAll()	Run tests on all CAM operations in the current scene.

Module Contents

addTestCurve(loc)

Add a test curve to the Blender scene.

This function creates a Bezier circle at the specified location in the Blender scene. It first adds a primitive Bezier circle, then enters edit mode to duplicate the circle twice, resizing each duplicate to half its original size. The function ensures that the transformations are applied in the global orientation and does not use proportional editing.

Parameters:

loc (tuple) – A tuple representing the (x, y, z) coordinates where the Bezier circle will be added in the 3D space.

addTestMesh(loc)

Add a test mesh to the Blender scene.

This function creates a monkey mesh and a plane mesh at the specified location in the Blender scene. It first adds a monkey mesh with a small radius, rotates it, and applies the transformation. Then, it toggles into edit mode, adds a plane mesh, resizes it, and translates it slightly before toggling back out of edit mode.

Parameters:

loc (tuple) – A tuple representing the (x, y, z) coordinates where the meshes will be added in the Blender scene.

deleteFirstVert(ob)

Delete the first vertex of a given object.

This function activates the specified object, enters edit mode, deselects all vertices, selects the first vertex, and then deletes it. The function ensures that the object is properly updated after the deletion.

Parameters:

ob (bpy.types.Object) – The Blender object from which the first

testCalc(o)

Test the calculation of the CAM path for a given object.

This function invokes the Blender operator to calculate the CAM path for the specified object and then deletes the first vertex of that object. It is intended to be used within a Blender environment where the bpy module is available.

Parameters:

o (Object) – The Blender object for which the CAM path is to be calculated.

testCutout(pos)

Test the cutout functionality in the scene.

This function adds a test curve based on the provided position, performs a CAM operation, and sets the strategy to ‘CUTOUT’. It then calls the testCalc function to perform further calculations on the CAM operation.

Parameters:

pos (tuple) – A tuple containing the x and y coordinates for the position of the test curve.

testPocket(pos)

Test the pocket operation in a 3D scene.

This function sets up a pocket operation by adding a test curve based on the provided position. It configures the CAM operation settings for the pocket strategy, enabling helix entry and tangential retraction. Finally, it performs a calculation based on the configured operation.

Parameters:

pos (tuple) – A tuple containing the x and y coordinates for the position of the test curve.

testParallel(pos)

Test the parallel functionality of the CAM operations.

This function adds a test mesh at a specified position and then performs CAM operations in the Blender environment. It sets the ambient behavior of the CAM operation to ‘AROUND’ and configures the material radius around the model. Finally, it calculates the CAM path based on the current scene settings.

Parameters:

pos (tuple) – A tuple containing the x and y coordinates for positioning the test mesh.

testWaterline(pos)

Test the waterline functionality in the scene.

This function adds a test mesh at a specified position and then performs a CAM operation with the strategy set to ‘WATERLINE’. It also configures the optimization pixel size for the operation. The function is intended for use in a 3D environment where waterline calculations are necessary for rendering or simulation.

Parameters:

pos (tuple) – A tuple containing the x and y coordinates for the position of the test mesh.

testSimulation()

Testsimulation function.

cleanUp()

Clean up the Blender scene by removing all objects and CAM operations.

This function selects all objects in the current Blender scene and deletes them. It also removes any CAM operations that are present in the scene. This is useful for resetting the scene to a clean state before performing further operations.

testOperation(i)

Test the operation of a CAM path in Blender.

This function tests a specific CAM operation by comparing the generated CAM path with an existing reference path. It retrieves the CAM operation from the scene and checks if the generated path matches the expected path in terms of vertex count and positions. If there is no existing reference path, it marks the new result as comparable. The function generates a report detailing the results of the comparison, including any discrepancies found.

Parameters:

i (int) – The index of the CAM operation to test.

Returns:

A report summarizing the results of the operation test.

Return type:

str

testAll()

Run tests on all CAM operations in the current scene.

This function iterates through all CAM operations defined in the current Blender scene and executes a test for each operation. The results of these tests are collected into a report string, which is then printed to the console. This is useful for verifying the functionality of CAM operations within the Blender environment.

tests

p