mapteksdk.data.ribbons module
Ribbon data types.
These are similar to edge data types. The primary difference is the lines connecting the points have a width and an angle.
- class RibbonChain(object_id=None, lock_type=LockType.READWRITE)
Bases:
Polyline,_RibbonMixin,TwoSidedColouringMixinA Polyline, except each edge has a width and angle.
Examples
Creates a ribbon chain with uniform 1m width which undergoes a 180 degree rotation from the first point of the ribbon to the last.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import RibbonChain >>> import numpy as np >>> if __name__ == "__main__": ... with Project() as project: ... point_count = 20 ... with project.new("loops/example_open_loop", RibbonChain) as ribbon: ... ribbon.points = np.full((point_count, 3), 0, dtype=np.float64) ... ribbon.points[:, 1] = range(point_count) ... ribbon.point_angles = np.linspace( ... -np.pi / 2, np.pi / 2, point_count) ... ribbon.point_width = 1.0
Assigning an array to the point width can be done to change the width of the ribbon at each point. For example, the following example is the same as the above except that the point width goes from 0.5m at the zeroth point to 2.5m at the final point.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import RibbonChain >>> import numpy as np >>> if __name__ == "__main__": ... with Project() as project: ... point_count = 20 ... with project.new("loops/example_open_loop_2", RibbonChain) as ribbon: ... ribbon.points = np.full((point_count, 3), 0, dtype=np.float64) ... ribbon.points[:, 1] = range(point_count) ... ribbon.point_angles = np.linspace( ... -np.pi / 2, np.pi / 2, point_count) ... ribbon.point_width = np.linspace(0.5, 2.5, 20)
- classmethod static_type()
Return the type of edge network as stored in a Project.
This can be used for determining if the type of an object is an edge network.
- property id: ObjectID[RibbonChain]
Object ID that uniquely references this object in the project.
- Returns
The unique id of this object.
- Return type
- property point_colours: ColourArray
The point colours array.
Warning
RibbonChains colour the entire ribbon using the first value in point_colours. The other values are ignored. You should colour the ribbon using the front_colour property instead.
- attribute_names()
Returns a list containing the names of all object-level attributes.
Use this to iterate over the object attributes.
- Returns
List containing the attribute names.
- Return type
list
Examples
Iterate over all object attributes of the object stared at “target” and print their values.
>>> from mapteksdk.project import Project >>> project = Project() >>> with project.read("target") as read_object: ... for name in read_object.attribute_names(): ... print(name, ":", read_object.get_attribute(name))
- property back_colour: ndarray
The colour used to colour the back of the object.
The back colour is represented by an RGB colour instead of a RGBA colour. The back colour cannot be transparent, so it does not have an alpha component.
Setting the back colour will set has_two_sided_colouring to True.
Notes
The default back colour is red (220, 0, 0).
The back colour can still be read if has_two_sided_colouring is False, however it will not be used to visualise the object.
Examples
Setting the back colour sets the object to use two sided colouring (if it is not using it already). The following example demonstrates this by creating a square with one facet coloured yellow, one facet coloured cyan and the back of both facets coloured grey.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import Surface >>> if __name__ == "__main__": ... with Project() as project: ... with project.new("surfaces/two_sided", Surface) as surface: ... surface.points = [ ... [-5, -5, 0], [5, -5, 0], [5, 5, 0], [-5, 5, 0] ... ] ... surface.facets = [[0, 1, 2], [0, 2, 3]] ... surface.facet_colours = [ ... [255, 255, 0, 255], [0, 255, 255, 255] ... ] ... surface.back_colour = [127, 127, 127]
- close()
Closes the object and saves the changes to the Project.
Attempting to read or edit properties of an object after closing it will raise a ReadOnlyError.
- property closed: bool
If this object has been closed.
Attempting to read or edit a closed object will raise an ObjectClosedError. Such an error typically indicates an error in the script and should not be caught.
Examples
If the object was opened with the Project.new(), Project.edit() or Project.read() in a “with” block, this will be True until the with block is closed and False afterwards.
>>> with self.project.new("cad/point_set", PointSet) as point_set: >>> point_set.points = [[1, 2, 3], [4, 5, 6]] >>> print("closed?", point_set.closed) >>> print("closed?", point_set.closed) closed? False closed? True
- property coordinate_system: mapteksdk.data.coordinate_systems.CoordinateSystem | None
The coordinate system the points of this object are in.
- Raises
ReadOnlyError – If set on an object open for read-only.
Warning
Setting this property does not change the points. This is only a label stating the coordinate system the points are in.
Notes
If the object has no coordinate system, this will be None.
Changes are done directly in the project and will not be undone if an error occurs.
Examples
Creating an edge network and setting the coordinate system to be WGS84. Note that setting the coordinate system does not change the points. It is only stating which coordinate system the points are in.
>>> from pyproj import CRS >>> from mapteksdk.project import Project >>> from mapteksdk.data import Polygon >>> project = Project() >>> with project.new("cad/rectangle", Polygon) as new_edges: ... # Coordinates are in the form [longitude, latitude] ... new_edges.points = [[112, 9], [112, 44], [154, 44], [154, 9]] ... new_edges.coordinate_system = CRS.from_epsg(4326)
Often a standard map projection is not convenient or accurate for a given application. In such cases a local transform can be provided to allow coordinates to be specified in a more convenient system. The below example defines a local transform where the origin is translated 1.2 degrees north and 2.1 degree east, points are scaled to be twice as far from the horizontal origin and the coordinates are rotated 45 degrees clockwise about the horizontal_origin. Note that the points of the polygon are specified in the coordinate system after the local transform has been applied.
>>> import math >>> from pyproj import CRS >>> from mapteksdk.project import Project >>> from mapteksdk.data import Polygon, CoordinateSystem, LocalTransform >>> project = Project() >>> transform = LocalTransform( ... horizontal_origin = [1.2, 2.1], ... horizontal_scale_factor = 2, ... horizontal_rotation = math.pi / 4) >>> system = CoordinateSystem(CRS.from_epsg(20249), transform) >>> with project.new("cad/rectangle_transform", Polygon) as new_edges: ... new_edges.points = [[112, 9], [112, 44], [154, 44], [154, 9]] ... new_edges.coordinate_system = system
See also
mapteksdk.data.coordinate_systems.CoordinateSystemAllows for a coordinate system to be defined with an optional local transform.
- property created_date: datetime
The date and time (in UTC) of when this object was created.
- Returns
The date and time the object was created. 0:0:0 1/1/1970 if the operation failed.
- Return type
datetime.datetime
- delete_all_attributes()
Delete all object attributes attached to an object.
This only deletes object attributes and has no effect on PrimitiveAttributes.
- Raises
RuntimeError – If all attributes cannot be deleted.
- delete_attribute(attribute)
Deletes a single object-level attribute.
Deleting a non-existent object attribute will not raise an error.
- Parameters
attribute (str) – Name of attribute to delete.
- Returns
True if the object attribute existed and was deleted; False if the object attribute did not exist.
- Return type
bool
- Raises
RuntimeError – If the attribute cannot be deleted.
- delete_edge_attribute(attribute_name)
Delete a edge attribute by name.
- Parameters
attribute_name (str) – The name of attribute
- Raises
Exception – If the object is opened in read-only mode.
- delete_point_attribute(attribute_name)
Delete a point attribute by name.
This is equivalent to: point_attributes.delete_attribute(attribute_name)
- Parameters
attribute_name (str) – The name of attribute
- Raises
Exception – If the object is opened in read-only mode.
ValueError – If the primitive type is not supported.
- dissociate_raster(raster)
Removes the raster from the object.
This is done directly on the Project and will not be undone if an error occurs.
- Parameters
raster (Raster | ObjectID[Raster]) – The raster to dissociate.
- Returns
True if the raster was successfully dissociated from the object, False if the raster was not associated with the object.
- Return type
bool
- Raises
TypeError – If raster is not a Raster.
ReadOnlyError – If this object is open for read-only.
Notes
This only removes the association between the Raster and the object, it does not clear the registration information from the Raster.
Examples
Dissociate the first raster found on a picked object.
>>> from mapteksdk.project import Project >>> from mapteksdk import operations >>> project = Project() >>> oid = operations.object_pick( ... support_label="Pick an object to remove a raster from.") ... with project.edit(oid) as data_object: ... report = f"There were no raster to remove from {oid.path}" ... for index in data_object.rasters: ... data_object.dissociate_raster(data_object.rasters[index]) ... report = f"Removed raster {index} from {oid.path}" ... break ... # Now that the raster is dissociated and the object is closed, ... # the raster can be associated with a different object. ... operations.write_report("Remove Raster", report)
- property edge_attributes: PrimitiveAttributes
Access to custom edge attributes.
These are arrays of values of the same type, with one value for each edge.
Use Object.edge_attributes[attribute_name] to access the edge attribute called attribute_name. See PrimitiveAttributes for valid operations on edge attributes.
- Returns
Access to the edge attributes.
- Return type
- Raises
ValueError – If the type of the attribute is not supported.
Warning
For Surfaces if you have changed the points or facets in the object, you must call save() before accessing the edge attributes.
- property edge_colours: ColourArray
The colours of the edges.
The edge colours are represented as a numpy array of RGBA colours, with one colour for each edge.
- property edge_count
The count of edges in the object.
- property edge_selection: BooleanArray
A 1D ndarray representing which edges are selected.
edge_selection[i] = True indicates edge i is selected.
- property edges
A 2D Numpy array of edges of the form: [[i0, j0], [i1, j1], …, [iN, jN]] where N is the number of edges and all iK and jK are valid indices in Object.points.
Warning
For Surfaces the edges are derived from the points and facets. If any changes are made to the points or facets, the corresponding changes to the edges will not be made until save() has been called.
Notes
Invalid edges are removed during save().
- property front_colour: Colour
The colour used for the front of the ribbon.
The front of a ribbon is coloured using the front_colour and the back of the ribbon is coloured using the back_colour.
Notes
The front of the ribbon can also be coloured by setting the point_colours, however only the first colour will be used by the viewer. It is preferable to always set the front colour of the ribbon.
If both the point_colours and the front_colour is set, the point_colours will be ignored and the front_colour will be used.
- get_attribute(name)
Returns the value for the attribute with the specified name.
- Parameters
name (str) – The name of the object attribute to get the value for.
- Returns
The value of the object attribute name. For dtype = datetime.datetime this is an integer representing the number of milliseconds since 1st Jan 1970. For dtype = datetime.date this is a tuple of the form: (year, month, day).
- Return type
ObjectAttributeTypes
- Raises
KeyError – If there is no object attribute called name.
Warning
In the future this function may be changed to return datetime.datetime and datetime.date objects instead of the current representation for object attributes of type datetime.datetime or datetime.date.
- get_attribute_type(name)
Returns the type of the attribute with the specified name.
- Parameters
name (str) – Name of the attribute whose type should be returned.
- Returns
The type of the object attribute name.
- Return type
ObjectAttributeDataTypes
- Raises
KeyError – If there is no object attribute called name.
- get_colour_map()
Return the ID of the colour map object associated with this object.
- Returns
The ID of the colour map object or null object ID if there is no colour map.
- Return type
- property has_two_sided_colouring: bool
True if this surface has two sided colouring.
If this is True, the point, edge and facet colours are used to colour the “front” of the surface, and the back colour is used to colour the “back” of the surface.
If this is False, the point, edge and facet colours are used to colour both the back and the front of the surface.
Examples
This property can be used to check if an object uses two sided colouring. The following example uses this property to write a report on the picked object stating whether it has two sided colouring:
>>> from mapteksdk.project import Project >>> from mapteksdk.operations import object_pick, write_report >>> if __name__ == "__main__": ... with Project() as project: ... oid = object_pick( ... label="Pick an object to query two sided colouring.") ... title = f"Does '{oid.path}' use two sided colouring?" ... with project.read(oid) as read_object: ... try: ... write_report(title, str(read_object.has_two_sided_colouring)) ... except AttributeError: ... write_report(title, "Unknown")
- property is_read_only: bool
If this object is read-only.
This will return True if the object was open with Project.read() and False if it was open with Project.edit() or Project.new(). Attempting to edit a read-only object will raise an error.
- property lock_type: LockType
Indicates whether operating in read-only or read-write mode.
Use the is_read_only property instead for checking if an object is open for reading or editing.
- Returns
The type of lock on this object. This will be LockType.ReadWrite if the object is open for editing and LockType.Read if the object is open for reading.
- Return type
LockType
- property modified_date: datetime
The date and time (in UTC) of when this object was last modified.
- Returns
The date and time this object was last modified. 0:0:0 1/1/1970 if the operation failed.
- Return type
datetime.datetime
- property point_angles: FloatArray
The angles of the ribbon at each point.
- property point_attributes: PrimitiveAttributes
Access the custom point attributes.
These are arrays of values of the same type, with one value for each point.
Use Object.point_attributes[attribute_name] to access the point attribute called attribute_name. See PrimitiveAttributes for valid operations on point attributes.
- Returns
Access to the point attributes.
- Return type
- Raises
ValueError – If the type of the attribute is not supported.
- property point_count: int
The number of points in this object.
- property point_normals: Vector3DArray
The point normals at each point.
This is a unit vector for each point indicating the normal to the ribbon at that point.
- Raises
StaleDataError – If the object is open for editing and either the points or the point_angles have been read since the last time the object was saved. Call save() or close the object after editing the point normals or point angles to stop this error from being raised.
Notes
The point normals are derived from the points and the point_angles. If either the points or the point_angles are changed, the values of this array are only recalculated when save() is called.
Though the point normals array only needs to be recalculated if the points or point_angles are edited, only reading them will trigger a StaleDataError to be raised if the object is open for editing. This is because it is not practical for the SDK to verify that the array has been edited.
- property point_selection: BooleanArray
An array which indicates which points have been selected.
This is an array of booleans of shape (N,) where N is the point count. If the ith element in this array is True, then the ith point is selected. If the ith element in this array is False, then the ith point is not selected.
Examples
To get if the ith point is selected:
>>> point_i_selected = point_set.point_selection[i]
The point selection can be used to filter the arrays of other per-point properties down to only include the values of selected points. The following snippet demonstrates getting the colours of only the selected points in an object:
>>> selected_colours = point_set.point_colours[point_set.point_selection]
- property point_visibility: BooleanArray
An array which indicates which points are visible.
This is an array of booleans of shape (N,) where N is the point count. If the ith element in this array is True, then the ith point is visible. If the ith element in this array is False, then the ith point is invisible.
Examples
To get if the ith point is visible:
>>> point_i_visible = point_set.point_visibility[i]
The point visibility can be used to filter the arrays of other per-point properties down to only include the values of visible points. The following snippet demonstrates getting the colours of only the visible points in an object:
>>> visible_colours = point_set.point_colours[point_set.point_visibility]
- property point_widths: FloatArray
The width of the ribbon at each point.
- Raises
ValueError – If any value in point_width is negative.
- property point_z: FloatArray
The Z coordinates of the points.
- Raises
ValueError – If set using a string which cannot be converted to a float.
ValueError – If set to a value which cannot be broadcast to the right shape.
TypeError – If set using a value which cannot be converted to a float.
- property points: PointArray
The three dimensional points in the object.
This is a numpy array of shape (N, 3) where N is the point count. This is of the form: [[x1, y1, z1], [x2, y2, z2], …, [xN, yN, zN]]
To get the ith point:
>>> point_i = point_set.points[i]
Similarly, to get the x, y and z coordinates of the ith point:
>>> x, y, z = point_set.points[i]
- Raises
AttributeError – If attempting to set the points on an object which does not support setting points.
Examples
Create a new point set and set the points:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() ... with project.new("cad/test_points", PointSet) as new_points: ... new_points.points = [[0, 0, 0], [1, 0, 0], [1, 1, 0], ... [0, 1, 0], [0, 2, 2], [0, -1, 3]]
Print the second point from the point set defined above.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.read("cad/test_points") as read_points: ... print(read_points.points[2]) [1., 1., 0.]
Then set the 2nd point to [1, 2, 3]:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.edit("cad/test_points") as edit_points: ... edit_points.points[2] = [1, 2, 3]
Iterate over all of the points and print them.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.read("cad/test_points") as read_points: >>> for point in read_points.points: >>> print(point) [0., 0., 0.] [1., 0., 0.] [1., 2., 3.] [0., 1., 0.] [0., 2., 2.] [0., -1., 3.]
Print all points with y > 0 using numpy. Note that index has one element for each point which will be true if that point has y > 0 and false otherwise. This is then used to retrieve the points with y > 0.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.read("cad/test_points") as read_points: ... index = read_points.points[:, 1] > 0 ... print(read_points.points[index]) [[1. 2. 3.] [0. 1. 0.] [0. 2. 2.]]
To add a new point to a PointSet, the numpy row_stack function can be used. This is demonstrated by the following example which creates a point set and then opens it for editing and adds an extra point. The original points are coloured blue and the new point is coloured red.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> import numpy as np >>> if __name__ == "__main__": ... with Project() as project: ... with project.new("cad/append_single_example", PointSet ... ) as point_set: ... point_set.points = [ ... [-1, -1, 0], [1, -1, 0], [-1, 1, 0], [1, 1, 0] ... ] ... point_set.point_colours = [0, 0, 255, 255] ... with project.edit(point_set.id) as edit_set: ... edit_set.points = np.row_stack((edit_set.points, [0, 0, 1])) ... edit_set.point_colours[-1] = [255, 0, 0, 255]
The row stack function can also be used to add multiple points to an object at once, as demonstrated in the following example:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> import numpy as np >>> if __name__ == "__main__": ... original_points = [[-1, -1, 1], [1, -1, 1], [-1, 1, 1], [1, 1, 1]] ... new_points = [[-1, -1, 2], [1, -1, 2], [-1, 1, 2], [1, 1, 2]] ... with Project() as project: ... with project.new("cad/append_multiple_example", PointSet ... ) as point_set: ... point_set.points = original_points ... point_set.point_colours = [0, 0, 255, 255] ... with project.edit(point_set.id) as edit_set: ... original_point_count = edit_set.point_count ... edit_set.points = np.row_stack((edit_set.points, new_points)) ... new_point_count = edit_set.point_count ... edit_set.point_colours[ ... original_point_count:new_point_count] = [255, 0, 0, 255]
The row stack function can combine more than two point arrays if required by adding additional arrays to the tuple passed to the function. This is demonstrated by the following example, which creates a new point set containing the points from the point sets in the previous two examples plus a third set of points defined in the script. Make sure to run the previous two examples before running this one.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> import numpy as np >>> if __name__ == "__main__": ... extra_points = [[-2, -2, 3], [2, -2, 3], [-2, 2, 3], [2, 2, 3]] ... with Project() as project: ... with project.new("cad/triple_point_stack", PointSet) as new_set, \ ... project.read("cad/append_single_example") as single_set, \ ... project.read("cad/append_multiple_example") as multiple_set: ... new_set.points = np.row_stack(( ... extra_points, ... single_set.points, ... multiple_set.points ... ))
- property rasters: dict[int, ObjectID[Raster]]
The raster associated with this object.
This is a dictionary of raster indices and Object IDs of the raster images currently associated with this object.
The keys are the raster ids and the values are the Object IDs of the associated rasters. Note that all raster ids are integers however they may not be consecutive - for example, an object may have raster ids 0, 1, 5 and 200.
Notes
Rasters with higher indices appear on top of rasters with lower indices. The maximum possible raster id is 255.
Removing a raster from this dictionary will not remove the raster association from the object. Use dissociate_raster to do this.
Examples
Iterate over all rasters on an object and invert the colours. Note that this will fail if there is no object at the path “target” and it will do nothing if no rasters are associated with the target.
>>> from mapteksdk.project import Project >>> project = Project() >>> with project.read("target") as read_object: ... for raster in read_object.rasters.values(): ... with project.edit(raster) as edit_raster: ... edit_raster.pixels[:, :3] = 255 - edit_raster.pixels[:, :3]
- remove_points(point_indices)
Remove one or more points from the object.
Calling this function is preferable to altering the points array because this function also removes the point properties associated with the removed points (e.g. point colours, point visibility, etc).
This operation is performed directly on the Project and will not be undone if an error occurs.
- Parameters
point_indices (npt.ArrayLike) – The index of the point to remove or a list of indices of points to remove. Indices should only contain 32-bit unsigned integer (They should be greater than or equal to 0 and less than 2**32). Any index greater than or equal to the point count is ignored. Passing an index less than zero is not supported. It will not delete the last point.
- Returns
If passed a single point index, True if the point was removed and False if it was not removed. If passed an iterable of point indices, True if the object supports removing points and False otherwise.
- Return type
bool
- Raises
ReadOnlyError – If called on an object not open for editing. This error indicates an issue with the script and should not be caught.
Warning
Any unsaved changes to the object when this function is called are discarded before any points are deleted. If you wish to keep these changes, call save() before calling this function.
Examples
Deleting a point through this function is preferable over removing the point from the points array because this function also deletes the properties associated with the deleted points. For example, all points will remain the same colour after the deletion operation, which points are visible will remain the same, etc. This is shown in the following script:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> red = [255, 0, 0, 255] >>> blue = [0, 0, 255, 255] >>> with project.new("cad/deletion_example", PointSet) as point_set: ... point_set.points = [[0, 0, 0], [1, 0, 0], [0, 1, 0], [1, 1, 0]] ... point_set.point_colours = [red, red, blue, blue] ... point_set.point_attributes["attribute"] = [0, 1, 2, 3] >>> with project.edit(point_set.id) as edit_set: ... edit_set.remove_points((1, 2)) ... print("points\n", edit_set.points) ... print("colours\n", edit_set.point_colours) ... print("attribute\n", edit_set.point_attributes["attribute"]) points [[0. 0. 0.] [1. 1. 0.]] colours [[255 0 0 255] [ 0 0 255 255]] attribute [0 3]
- save()
Save the changes made to the object.
Generally a user does not need to call this function, because it is called automatically at the end of a with block using Project.new() or Project.edit().
- save_edge_attribute(attribute_name, data)
Create and/or edit the values of the edge attribute attribute_name.
This is equivalent to Object.edge_attributes[attribute_name] = data
- Parameters
attribute_name (str) – The name of attribute.
data (npt.ArrayLike) – An array_like of a base type data to store for the attribute per-primitive.
- Raises
Exception – If the object is opened in read-only mode.
ValueError – If the type of the attribute is not supported.
- save_point_attribute(attribute_name, data)
Create and/or edit the values of the point attribute attribute_name.
This is equivalent to Object.point_attributes[attribute_name] = data.
- Parameters
attribute_name (str) – The name of attribute
data (npt.ArrayLike) – An array_like of length point_count containing the values for attribute_name.
- Raises
Exception – If the object is opened in read-only mode.
ValueError – If the type of the attribute is not supported.
- set_attribute(name, dtype, data)
Sets the value for the object attribute with the specified name.
This will overwrite any existing attribute with the specified name.
- Parameters
name (str) – The name of the object attribute for which the value should be set.
dtype (type[Union[NoneType, Type[NoneType], ctypes.c_bool, ctypes.c_byte, ctypes.c_ubyte, ctypes.c_short, ctypes.c_ushort, ctypes.c_long, ctypes.c_ulong, ctypes.c_longlong, ctypes.c_ulonglong, ctypes.c_float, ctypes.c_double, ctypes.c_char_p, datetime.datetime, datetime.date]] | None) – The type of data to assign to the attribute. This should be a type from the ctypes module or datetime.datetime or datetime.date. Passing bool is equivalent to passing ctypes.c_bool. Passing str is equivalent to passing ctypes.c_char_p. Passing int is equivalent to passing ctypes.c_int16. Passing float is equivalent to passing ctypes.c_double.
data (Any) – The value to assign to object attribute name. For dtype = datetime.datetime this can either be a datetime object or timestamp which will be passed directly to datetime.utcfromtimestamp(). For dtype = datetime.date this can either be a date object or a tuple of the form: (year, month, day).
- Raises
ValueError – If dtype is an unsupported type.
TypeError – If value is an inappropriate type for object attribute name.
ValueError – If name starts or ends with whitespace or is empty.
RuntimeError – If a different error occurs.
Warning
Object attributes are saved separately from the object itself - any changes made by this function (assuming it does not raise an error) will be saved even if save() is not called (for example, due to an error being raised by another function).
Examples
Create an object attribute on an object at “target” and then read its value.
>>> import ctypes >>> from mapteksdk.project import Project >>> project = Project() >>> with project.edit("target") as edit_object: ... edit_object.set_attribute("count", ctypes.c_int16, 0) ... with project.read("target") as read_object: ... print(read_object.get_attribute("count")) 0
- class RibbonLoop(object_id=None, lock_type=LockType.READWRITE)
Bases:
Polygon,_RibbonMixin,TwoSidedColouringMixinA Polygon, except each edge has a width and angle.
Examples
The following example creates a square ribbon loop with the ribbon making a 180 degree twist.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import RibbonLoop >>> import numpy as np >>> if __name__ == "__main__": ... with Project() as project: ... point_count = 20 ... with project.new("loops/example_closed_loop", RibbonLoop) as ribbon: ... ribbon.points = [[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]] ... ribbon.point_angles = [ ... -np.pi / 2, -np.pi / 4, np.pi / 4, np.pi / 2 ... ] ... ribbon.point_width = 0.1
- classmethod static_type()
Return the type of edge network as stored in a Project.
This can be used for determining if the type of an object is an edge network.
- attribute_names()
Returns a list containing the names of all object-level attributes.
Use this to iterate over the object attributes.
- Returns
List containing the attribute names.
- Return type
list
Examples
Iterate over all object attributes of the object stared at “target” and print their values.
>>> from mapteksdk.project import Project >>> project = Project() >>> with project.read("target") as read_object: ... for name in read_object.attribute_names(): ... print(name, ":", read_object.get_attribute(name))
- property back_colour: ndarray
The colour used to colour the back of the object.
The back colour is represented by an RGB colour instead of a RGBA colour. The back colour cannot be transparent, so it does not have an alpha component.
Setting the back colour will set has_two_sided_colouring to True.
Notes
The default back colour is red (220, 0, 0).
The back colour can still be read if has_two_sided_colouring is False, however it will not be used to visualise the object.
Examples
Setting the back colour sets the object to use two sided colouring (if it is not using it already). The following example demonstrates this by creating a square with one facet coloured yellow, one facet coloured cyan and the back of both facets coloured grey.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import Surface >>> if __name__ == "__main__": ... with Project() as project: ... with project.new("surfaces/two_sided", Surface) as surface: ... surface.points = [ ... [-5, -5, 0], [5, -5, 0], [5, 5, 0], [-5, 5, 0] ... ] ... surface.facets = [[0, 1, 2], [0, 2, 3]] ... surface.facet_colours = [ ... [255, 255, 0, 255], [0, 255, 255, 255] ... ] ... surface.back_colour = [127, 127, 127]
- close()
Closes the object and saves the changes to the Project.
Attempting to read or edit properties of an object after closing it will raise a ReadOnlyError.
- property closed: bool
If this object has been closed.
Attempting to read or edit a closed object will raise an ObjectClosedError. Such an error typically indicates an error in the script and should not be caught.
Examples
If the object was opened with the Project.new(), Project.edit() or Project.read() in a “with” block, this will be True until the with block is closed and False afterwards.
>>> with self.project.new("cad/point_set", PointSet) as point_set: >>> point_set.points = [[1, 2, 3], [4, 5, 6]] >>> print("closed?", point_set.closed) >>> print("closed?", point_set.closed) closed? False closed? True
- property coordinate_system: mapteksdk.data.coordinate_systems.CoordinateSystem | None
The coordinate system the points of this object are in.
- Raises
ReadOnlyError – If set on an object open for read-only.
Warning
Setting this property does not change the points. This is only a label stating the coordinate system the points are in.
Notes
If the object has no coordinate system, this will be None.
Changes are done directly in the project and will not be undone if an error occurs.
Examples
Creating an edge network and setting the coordinate system to be WGS84. Note that setting the coordinate system does not change the points. It is only stating which coordinate system the points are in.
>>> from pyproj import CRS >>> from mapteksdk.project import Project >>> from mapteksdk.data import Polygon >>> project = Project() >>> with project.new("cad/rectangle", Polygon) as new_edges: ... # Coordinates are in the form [longitude, latitude] ... new_edges.points = [[112, 9], [112, 44], [154, 44], [154, 9]] ... new_edges.coordinate_system = CRS.from_epsg(4326)
Often a standard map projection is not convenient or accurate for a given application. In such cases a local transform can be provided to allow coordinates to be specified in a more convenient system. The below example defines a local transform where the origin is translated 1.2 degrees north and 2.1 degree east, points are scaled to be twice as far from the horizontal origin and the coordinates are rotated 45 degrees clockwise about the horizontal_origin. Note that the points of the polygon are specified in the coordinate system after the local transform has been applied.
>>> import math >>> from pyproj import CRS >>> from mapteksdk.project import Project >>> from mapteksdk.data import Polygon, CoordinateSystem, LocalTransform >>> project = Project() >>> transform = LocalTransform( ... horizontal_origin = [1.2, 2.1], ... horizontal_scale_factor = 2, ... horizontal_rotation = math.pi / 4) >>> system = CoordinateSystem(CRS.from_epsg(20249), transform) >>> with project.new("cad/rectangle_transform", Polygon) as new_edges: ... new_edges.points = [[112, 9], [112, 44], [154, 44], [154, 9]] ... new_edges.coordinate_system = system
See also
mapteksdk.data.coordinate_systems.CoordinateSystemAllows for a coordinate system to be defined with an optional local transform.
- property created_date: datetime
The date and time (in UTC) of when this object was created.
- Returns
The date and time the object was created. 0:0:0 1/1/1970 if the operation failed.
- Return type
datetime.datetime
- delete_all_attributes()
Delete all object attributes attached to an object.
This only deletes object attributes and has no effect on PrimitiveAttributes.
- Raises
RuntimeError – If all attributes cannot be deleted.
- delete_attribute(attribute)
Deletes a single object-level attribute.
Deleting a non-existent object attribute will not raise an error.
- Parameters
attribute (str) – Name of attribute to delete.
- Returns
True if the object attribute existed and was deleted; False if the object attribute did not exist.
- Return type
bool
- Raises
RuntimeError – If the attribute cannot be deleted.
- delete_edge_attribute(attribute_name)
Delete a edge attribute by name.
- Parameters
attribute_name (str) – The name of attribute
- Raises
Exception – If the object is opened in read-only mode.
- delete_point_attribute(attribute_name)
Delete a point attribute by name.
This is equivalent to: point_attributes.delete_attribute(attribute_name)
- Parameters
attribute_name (str) – The name of attribute
- Raises
Exception – If the object is opened in read-only mode.
ValueError – If the primitive type is not supported.
- dissociate_raster(raster)
Removes the raster from the object.
This is done directly on the Project and will not be undone if an error occurs.
- Parameters
raster (Raster | ObjectID[Raster]) – The raster to dissociate.
- Returns
True if the raster was successfully dissociated from the object, False if the raster was not associated with the object.
- Return type
bool
- Raises
TypeError – If raster is not a Raster.
ReadOnlyError – If this object is open for read-only.
Notes
This only removes the association between the Raster and the object, it does not clear the registration information from the Raster.
Examples
Dissociate the first raster found on a picked object.
>>> from mapteksdk.project import Project >>> from mapteksdk import operations >>> project = Project() >>> oid = operations.object_pick( ... support_label="Pick an object to remove a raster from.") ... with project.edit(oid) as data_object: ... report = f"There were no raster to remove from {oid.path}" ... for index in data_object.rasters: ... data_object.dissociate_raster(data_object.rasters[index]) ... report = f"Removed raster {index} from {oid.path}" ... break ... # Now that the raster is dissociated and the object is closed, ... # the raster can be associated with a different object. ... operations.write_report("Remove Raster", report)
- property edge_attributes: PrimitiveAttributes
Access to custom edge attributes.
These are arrays of values of the same type, with one value for each edge.
Use Object.edge_attributes[attribute_name] to access the edge attribute called attribute_name. See PrimitiveAttributes for valid operations on edge attributes.
- Returns
Access to the edge attributes.
- Return type
- Raises
ValueError – If the type of the attribute is not supported.
Warning
For Surfaces if you have changed the points or facets in the object, you must call save() before accessing the edge attributes.
- property edge_colours: ColourArray
The colours of the edges.
The edge colours are represented as a numpy array of RGBA colours, with one colour for each edge.
- property edge_count
The count of edges in the object.
- property edge_selection: BooleanArray
A 1D ndarray representing which edges are selected.
edge_selection[i] = True indicates edge i is selected.
- property edges
A 2D Numpy array of edges of the form: [[i0, j0], [i1, j1], …, [iN, jN]] where N is the number of edges and all iK and jK are valid indices in Object.points.
Warning
For Surfaces the edges are derived from the points and facets. If any changes are made to the points or facets, the corresponding changes to the edges will not be made until save() has been called.
Notes
Invalid edges are removed during save().
- property front_colour: Colour
The colour used for the front of the ribbon.
The front of a ribbon is coloured using the front_colour and the back of the ribbon is coloured using the back_colour.
Notes
The front of the ribbon can also be coloured by setting the point_colours, however only the first colour will be used by the viewer. It is preferable to always set the front colour of the ribbon.
If both the point_colours and the front_colour is set, the point_colours will be ignored and the front_colour will be used.
- get_attribute(name)
Returns the value for the attribute with the specified name.
- Parameters
name (str) – The name of the object attribute to get the value for.
- Returns
The value of the object attribute name. For dtype = datetime.datetime this is an integer representing the number of milliseconds since 1st Jan 1970. For dtype = datetime.date this is a tuple of the form: (year, month, day).
- Return type
ObjectAttributeTypes
- Raises
KeyError – If there is no object attribute called name.
Warning
In the future this function may be changed to return datetime.datetime and datetime.date objects instead of the current representation for object attributes of type datetime.datetime or datetime.date.
- get_attribute_type(name)
Returns the type of the attribute with the specified name.
- Parameters
name (str) – Name of the attribute whose type should be returned.
- Returns
The type of the object attribute name.
- Return type
ObjectAttributeDataTypes
- Raises
KeyError – If there is no object attribute called name.
- get_colour_map()
Return the ID of the colour map object associated with this object.
- Returns
The ID of the colour map object or null object ID if there is no colour map.
- Return type
- property has_two_sided_colouring: bool
True if this surface has two sided colouring.
If this is True, the point, edge and facet colours are used to colour the “front” of the surface, and the back colour is used to colour the “back” of the surface.
If this is False, the point, edge and facet colours are used to colour both the back and the front of the surface.
Examples
This property can be used to check if an object uses two sided colouring. The following example uses this property to write a report on the picked object stating whether it has two sided colouring:
>>> from mapteksdk.project import Project >>> from mapteksdk.operations import object_pick, write_report >>> if __name__ == "__main__": ... with Project() as project: ... oid = object_pick( ... label="Pick an object to query two sided colouring.") ... title = f"Does '{oid.path}' use two sided colouring?" ... with project.read(oid) as read_object: ... try: ... write_report(title, str(read_object.has_two_sided_colouring)) ... except AttributeError: ... write_report(title, "Unknown")
- property id: ObjectID[RibbonLoop]
Object ID that uniquely references this object in the project.
- Returns
The unique id of this object.
- Return type
- property is_read_only: bool
If this object is read-only.
This will return True if the object was open with Project.read() and False if it was open with Project.edit() or Project.new(). Attempting to edit a read-only object will raise an error.
- property lock_type: LockType
Indicates whether operating in read-only or read-write mode.
Use the is_read_only property instead for checking if an object is open for reading or editing.
- Returns
The type of lock on this object. This will be LockType.ReadWrite if the object is open for editing and LockType.Read if the object is open for reading.
- Return type
LockType
- property modified_date: datetime
The date and time (in UTC) of when this object was last modified.
- Returns
The date and time this object was last modified. 0:0:0 1/1/1970 if the operation failed.
- Return type
datetime.datetime
- property point_angles: FloatArray
The angles of the ribbon at each point.
- property point_attributes: PrimitiveAttributes
Access the custom point attributes.
These are arrays of values of the same type, with one value for each point.
Use Object.point_attributes[attribute_name] to access the point attribute called attribute_name. See PrimitiveAttributes for valid operations on point attributes.
- Returns
Access to the point attributes.
- Return type
- Raises
ValueError – If the type of the attribute is not supported.
- property point_count: int
The number of points in this object.
- property point_normals: Vector3DArray
The point normals at each point.
This is a unit vector for each point indicating the normal to the ribbon at that point.
- Raises
StaleDataError – If the object is open for editing and either the points or the point_angles have been read since the last time the object was saved. Call save() or close the object after editing the point normals or point angles to stop this error from being raised.
Notes
The point normals are derived from the points and the point_angles. If either the points or the point_angles are changed, the values of this array are only recalculated when save() is called.
Though the point normals array only needs to be recalculated if the points or point_angles are edited, only reading them will trigger a StaleDataError to be raised if the object is open for editing. This is because it is not practical for the SDK to verify that the array has been edited.
- property point_selection: BooleanArray
An array which indicates which points have been selected.
This is an array of booleans of shape (N,) where N is the point count. If the ith element in this array is True, then the ith point is selected. If the ith element in this array is False, then the ith point is not selected.
Examples
To get if the ith point is selected:
>>> point_i_selected = point_set.point_selection[i]
The point selection can be used to filter the arrays of other per-point properties down to only include the values of selected points. The following snippet demonstrates getting the colours of only the selected points in an object:
>>> selected_colours = point_set.point_colours[point_set.point_selection]
- property point_visibility: BooleanArray
An array which indicates which points are visible.
This is an array of booleans of shape (N,) where N is the point count. If the ith element in this array is True, then the ith point is visible. If the ith element in this array is False, then the ith point is invisible.
Examples
To get if the ith point is visible:
>>> point_i_visible = point_set.point_visibility[i]
The point visibility can be used to filter the arrays of other per-point properties down to only include the values of visible points. The following snippet demonstrates getting the colours of only the visible points in an object:
>>> visible_colours = point_set.point_colours[point_set.point_visibility]
- property point_widths: FloatArray
The width of the ribbon at each point.
- Raises
ValueError – If any value in point_width is negative.
- property point_z: FloatArray
The Z coordinates of the points.
- Raises
ValueError – If set using a string which cannot be converted to a float.
ValueError – If set to a value which cannot be broadcast to the right shape.
TypeError – If set using a value which cannot be converted to a float.
- property points: PointArray
The three dimensional points in the object.
This is a numpy array of shape (N, 3) where N is the point count. This is of the form: [[x1, y1, z1], [x2, y2, z2], …, [xN, yN, zN]]
To get the ith point:
>>> point_i = point_set.points[i]
Similarly, to get the x, y and z coordinates of the ith point:
>>> x, y, z = point_set.points[i]
- Raises
AttributeError – If attempting to set the points on an object which does not support setting points.
Examples
Create a new point set and set the points:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() ... with project.new("cad/test_points", PointSet) as new_points: ... new_points.points = [[0, 0, 0], [1, 0, 0], [1, 1, 0], ... [0, 1, 0], [0, 2, 2], [0, -1, 3]]
Print the second point from the point set defined above.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.read("cad/test_points") as read_points: ... print(read_points.points[2]) [1., 1., 0.]
Then set the 2nd point to [1, 2, 3]:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.edit("cad/test_points") as edit_points: ... edit_points.points[2] = [1, 2, 3]
Iterate over all of the points and print them.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.read("cad/test_points") as read_points: >>> for point in read_points.points: >>> print(point) [0., 0., 0.] [1., 0., 0.] [1., 2., 3.] [0., 1., 0.] [0., 2., 2.] [0., -1., 3.]
Print all points with y > 0 using numpy. Note that index has one element for each point which will be true if that point has y > 0 and false otherwise. This is then used to retrieve the points with y > 0.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> with project.read("cad/test_points") as read_points: ... index = read_points.points[:, 1] > 0 ... print(read_points.points[index]) [[1. 2. 3.] [0. 1. 0.] [0. 2. 2.]]
To add a new point to a PointSet, the numpy row_stack function can be used. This is demonstrated by the following example which creates a point set and then opens it for editing and adds an extra point. The original points are coloured blue and the new point is coloured red.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> import numpy as np >>> if __name__ == "__main__": ... with Project() as project: ... with project.new("cad/append_single_example", PointSet ... ) as point_set: ... point_set.points = [ ... [-1, -1, 0], [1, -1, 0], [-1, 1, 0], [1, 1, 0] ... ] ... point_set.point_colours = [0, 0, 255, 255] ... with project.edit(point_set.id) as edit_set: ... edit_set.points = np.row_stack((edit_set.points, [0, 0, 1])) ... edit_set.point_colours[-1] = [255, 0, 0, 255]
The row stack function can also be used to add multiple points to an object at once, as demonstrated in the following example:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> import numpy as np >>> if __name__ == "__main__": ... original_points = [[-1, -1, 1], [1, -1, 1], [-1, 1, 1], [1, 1, 1]] ... new_points = [[-1, -1, 2], [1, -1, 2], [-1, 1, 2], [1, 1, 2]] ... with Project() as project: ... with project.new("cad/append_multiple_example", PointSet ... ) as point_set: ... point_set.points = original_points ... point_set.point_colours = [0, 0, 255, 255] ... with project.edit(point_set.id) as edit_set: ... original_point_count = edit_set.point_count ... edit_set.points = np.row_stack((edit_set.points, new_points)) ... new_point_count = edit_set.point_count ... edit_set.point_colours[ ... original_point_count:new_point_count] = [255, 0, 0, 255]
The row stack function can combine more than two point arrays if required by adding additional arrays to the tuple passed to the function. This is demonstrated by the following example, which creates a new point set containing the points from the point sets in the previous two examples plus a third set of points defined in the script. Make sure to run the previous two examples before running this one.
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> import numpy as np >>> if __name__ == "__main__": ... extra_points = [[-2, -2, 3], [2, -2, 3], [-2, 2, 3], [2, 2, 3]] ... with Project() as project: ... with project.new("cad/triple_point_stack", PointSet) as new_set, \ ... project.read("cad/append_single_example") as single_set, \ ... project.read("cad/append_multiple_example") as multiple_set: ... new_set.points = np.row_stack(( ... extra_points, ... single_set.points, ... multiple_set.points ... ))
- property rasters: dict[int, ObjectID[Raster]]
The raster associated with this object.
This is a dictionary of raster indices and Object IDs of the raster images currently associated with this object.
The keys are the raster ids and the values are the Object IDs of the associated rasters. Note that all raster ids are integers however they may not be consecutive - for example, an object may have raster ids 0, 1, 5 and 200.
Notes
Rasters with higher indices appear on top of rasters with lower indices. The maximum possible raster id is 255.
Removing a raster from this dictionary will not remove the raster association from the object. Use dissociate_raster to do this.
Examples
Iterate over all rasters on an object and invert the colours. Note that this will fail if there is no object at the path “target” and it will do nothing if no rasters are associated with the target.
>>> from mapteksdk.project import Project >>> project = Project() >>> with project.read("target") as read_object: ... for raster in read_object.rasters.values(): ... with project.edit(raster) as edit_raster: ... edit_raster.pixels[:, :3] = 255 - edit_raster.pixels[:, :3]
- remove_points(point_indices)
Remove one or more points from the object.
Calling this function is preferable to altering the points array because this function also removes the point properties associated with the removed points (e.g. point colours, point visibility, etc).
This operation is performed directly on the Project and will not be undone if an error occurs.
- Parameters
point_indices (npt.ArrayLike) – The index of the point to remove or a list of indices of points to remove. Indices should only contain 32-bit unsigned integer (They should be greater than or equal to 0 and less than 2**32). Any index greater than or equal to the point count is ignored. Passing an index less than zero is not supported. It will not delete the last point.
- Returns
If passed a single point index, True if the point was removed and False if it was not removed. If passed an iterable of point indices, True if the object supports removing points and False otherwise.
- Return type
bool
- Raises
ReadOnlyError – If called on an object not open for editing. This error indicates an issue with the script and should not be caught.
Warning
Any unsaved changes to the object when this function is called are discarded before any points are deleted. If you wish to keep these changes, call save() before calling this function.
Examples
Deleting a point through this function is preferable over removing the point from the points array because this function also deletes the properties associated with the deleted points. For example, all points will remain the same colour after the deletion operation, which points are visible will remain the same, etc. This is shown in the following script:
>>> from mapteksdk.project import Project >>> from mapteksdk.data import PointSet >>> project = Project() >>> red = [255, 0, 0, 255] >>> blue = [0, 0, 255, 255] >>> with project.new("cad/deletion_example", PointSet) as point_set: ... point_set.points = [[0, 0, 0], [1, 0, 0], [0, 1, 0], [1, 1, 0]] ... point_set.point_colours = [red, red, blue, blue] ... point_set.point_attributes["attribute"] = [0, 1, 2, 3] >>> with project.edit(point_set.id) as edit_set: ... edit_set.remove_points((1, 2)) ... print("points\n", edit_set.points) ... print("colours\n", edit_set.point_colours) ... print("attribute\n", edit_set.point_attributes["attribute"]) points [[0. 0. 0.] [1. 1. 0.]] colours [[255 0 0 255] [ 0 0 255 255]] attribute [0 3]
- save()
Save the changes made to the object.
Generally a user does not need to call this function, because it is called automatically at the end of a with block using Project.new() or Project.edit().
- save_edge_attribute(attribute_name, data)
Create and/or edit the values of the edge attribute attribute_name.
This is equivalent to Object.edge_attributes[attribute_name] = data
- Parameters
attribute_name (str) – The name of attribute.
data (npt.ArrayLike) – An array_like of a base type data to store for the attribute per-primitive.
- Raises
Exception – If the object is opened in read-only mode.
ValueError – If the type of the attribute is not supported.
- save_point_attribute(attribute_name, data)
Create and/or edit the values of the point attribute attribute_name.
This is equivalent to Object.point_attributes[attribute_name] = data.
- Parameters
attribute_name (str) – The name of attribute
data (npt.ArrayLike) – An array_like of length point_count containing the values for attribute_name.
- Raises
Exception – If the object is opened in read-only mode.
ValueError – If the type of the attribute is not supported.
- set_attribute(name, dtype, data)
Sets the value for the object attribute with the specified name.
This will overwrite any existing attribute with the specified name.
- Parameters
name (str) – The name of the object attribute for which the value should be set.
dtype (type[Union[NoneType, Type[NoneType], ctypes.c_bool, ctypes.c_byte, ctypes.c_ubyte, ctypes.c_short, ctypes.c_ushort, ctypes.c_long, ctypes.c_ulong, ctypes.c_longlong, ctypes.c_ulonglong, ctypes.c_float, ctypes.c_double, ctypes.c_char_p, datetime.datetime, datetime.date]] | None) – The type of data to assign to the attribute. This should be a type from the ctypes module or datetime.datetime or datetime.date. Passing bool is equivalent to passing ctypes.c_bool. Passing str is equivalent to passing ctypes.c_char_p. Passing int is equivalent to passing ctypes.c_int16. Passing float is equivalent to passing ctypes.c_double.
data (Any) – The value to assign to object attribute name. For dtype = datetime.datetime this can either be a datetime object or timestamp which will be passed directly to datetime.utcfromtimestamp(). For dtype = datetime.date this can either be a date object or a tuple of the form: (year, month, day).
- Raises
ValueError – If dtype is an unsupported type.
TypeError – If value is an inappropriate type for object attribute name.
ValueError – If name starts or ends with whitespace or is empty.
RuntimeError – If a different error occurs.
Warning
Object attributes are saved separately from the object itself - any changes made by this function (assuming it does not raise an error) will be saved even if save() is not called (for example, due to an error being raised by another function).
Examples
Create an object attribute on an object at “target” and then read its value.
>>> import ctypes >>> from mapteksdk.project import Project >>> project = Project() >>> with project.edit("target") as edit_object: ... edit_object.set_attribute("count", ctypes.c_int16, 0) ... with project.read("target") as read_object: ... print(read_object.get_attribute("count")) 0
- property point_colours: ColourArray
The point colours array.
Warning
RibbonLoops colour the entire ribbon using the first value in point_colours. The other values are ignored. You should colour the ribbon using the front_colour property instead.