pycatia.navigator_interfaces.marker_2Ds

Module initially auto generated using V5Automation files from CATIA V5 R28 on 2020-06-11 12:40:47.360445

Warning

The notes denoted “CAA V5 Visual Basic Help” are to be used as reference only. They are there as a guide as to how the visual basic / catscript functions work and thus help debugging in pycatia.

class pycatia.navigator_interfaces.marker_2Ds.Marker2Ds(com_object)

Note

CAA V5 Visual Basic Help (2020-06-11 12:40:47.360445)

System.IUnknown
System.IDispatch
System.CATBaseUnknown
System.CATBaseDispatch
System.Collection
Marker2Ds

A collection of Marker2Ds objects.
add2_d_arrow(i_coordinates: tuple) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Add2DArrow(CATSafeArrayVariant iCoordinates) As
Marker2D

Creates an arrow marker 2D and adds it to the marker 2D collection. The
arrow is defined using the coordinates of its head and tail
points.

Parameters:

iCoordinates
The coordinates

iCoordinates(0) is the X coordinate of the head
point
iCoordinates(1) is the Y coordinate of the head
point
iCoordinates(2) is the X coordinate of the tail
point
iCoordinates(3) is the Y coordinate of the tail point


Returns:
The created marker 2D
Example:

This example creates a new marker 2D in the TheMarker2Ds
collection.


Dim NewMarker2DArrow As Marker2D
Set NewMarker2DArrow = TheMarker2Ds.Add2DArrow(Positions)
Parameters:

i_coordinates (tuple) –

Return type:

Marker2D

add2_d_circle(i_coordinates: tuple, i_fill_status: int) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Add2DCircle(CATSafeArrayVariant iCoordinates,
long iFillStatus) As Marker2D

Creates a circle marker 2D and adds it to the marker 2D collection. The
circle is defined using the coordinates of its center and a point through which
it passes.

Parameters:

iCoordinates
The coordinates

iCoordinates(0) is the X coordinate of the
center
iCoordinates(1) is the Y coordinate of the
center
iCoordinates(2) is the X coordinate of the a point on the
circle
iCoordinates(3) is the Y coordinate of the a point on the
circle

iFillStatus
The filling status (1 the figure is filled, 0 the figure is not
filled).

Returns:
The created marker 2D
Example:

This example creates a new marker 2D in the TheMarker2Ds
collection.


Dim NewMarker2DCircle As Marker2D
Set NewMarker2DCircle = TheMarker2Ds.Add2DCircle(Positions, 0)
Parameters:
  • i_coordinates (tuple) –

  • i_fill_status (int) –

Return type:

Marker2D

add2_d_free_hand(i_coordinates: tuple) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Add2DFreeHand(CATSafeArrayVariant iCoordinates) As
Marker2D

Creates a free hand drawing marker 2D and adds it to the marker 2D
collection. The free hand drawing is defined using the coordinates of a series
of points.

Parameters:

iCoordinates
The coordinates

iCoordinates(0) is the X coordinate of the first
point
iCoordinates(1) is the Y coordinate of the first
point
iCoordinates(2) is the X coordinate of the second
point
iCoordinates(3) is the Y coordinate of the second
point
iCoordinates(n*2-2) is the X coordinate of the n-th
point
iCoordinates(n*2-1) is the Y coordinate of the n-th point


Returns:
The created marker 2D
Example:

This example creates a new marker 2D in the TheMarker2Ds
collection.


Dim NewMarker2DFreeHand As Marker2D
Set NewMarker2DFreeHand = TheMarker2Ds.Add2DFreeHand(Positions)
Parameters:

i_coordinates (tuple) –

Return type:

Marker2D

add2_d_line(i_coordinates: tuple) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Add2DLine(CATSafeArrayVariant iCoordinates) As
Marker2D

Creates a line marker 2D and adds it to the marker 2D collection. The line
segment is defined using the coordinates of its two
endpoints.

Parameters:

iCoordinates
The coordinates of the endpoints

iCoordinates(0) is the X coordinate of the first
endpoint
iCoordinates(1) is the Y coordinate of the first
endpoint
iCoordinates(2) is the X coordinate of the second
endpoint
iCoordinates(3) is the Y coordinate of the second endpoint


Returns:
The created marker 2D
Example:

This example creates a new marker 2D in the TheMarker2Ds
collection.


Dim NewMarker2DLine As Marker2D
Set NewMarker2DLine = TheMarker2Ds.Add2DLine(Positions)
Parameters:

i_coordinates (tuple) –

Return type:

Marker2D

add2_d_picture(i_coordinates: tuple, i_path: str) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Add2DPicture(CATSafeArrayVariant iCoordinates,
CATBSTR iPath) As Marker2D

Creates a picture marker 2D and adds it to the marker 2D collection. The
picture is defined as a rectangle whose bottom-left and top-right corners are
given.

Parameters:

iCoordinates
The coordinates of the corners

iCoordinates(0) is the X coordinate of the bottom-left
point
iCoordinates(1) is the Y coordinate of the bottom-left
point
iCoordinates(2) is the X coordinate of the top-right
point
iCoordinates(3) is the Y coordinate of the top-right point


iPath
The path to the picture file

Returns:
The created marker 2D
Example:

This example creates a new marker 2D in the TheMarker2Ds
collection.


Dim NewMarker2DPicture As Marker2D
Set NewMarker2DPicture = TheMarker2Ds.Add2DPicture(Positions, “e:picture.bmp”)
Parameters:
  • i_coordinates (tuple) –

  • i_path (str) –

Return type:

Marker2D

add2_d_rectangle(i_coordinates: tuple, i_fill_status: int) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Add2DRectangle(CATSafeArrayVariant iCoordinates,
long iFillStatus) As Marker2D

Creates a rectangle marker 2D and adds it to the marker 2D collection. The
rectangle is defined using the coordinates of its bottom-left and top-right
corners.

Parameters:

iCoordinates
The coordinates

iCoordinates(0) is the X coordinate of the bottom-left
point
iCoordinates(1) is the Y coordinate of the bottom-left
point
iCoordinates(2) is the X coordinate of the top-right
point
iCoordinates(3) is the Y coordinate of the top-right point


iFillStatus
The filling status (1 the figure is filled, 0 the figure is not
filled).

Returns:
The created marker 2D
Example:

This example creates a new marker 2D in the TheMarker2Ds
collection.


Dim NewMarker2DRectangle As Marker2D
Set NewMarker2DRectangle = TheMarker2Ds.Add2DRectangle(Positions, 0)
Parameters:
  • i_coordinates (tuple) –

  • i_fill_status (int) –

Return type:

Marker2D

add2_d_text(i_coordinates: tuple, i_text: str) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Add2DText(CATSafeArrayVariant iCoordinates,
CATBSTR iText) As Marker2D

Creates a text marker 2D and adds it to the marker 2D collection. The text
is anchored using the coordinates of its bottom-left
point.

Parameters:

iCoordinates
The coordinates

iCoordinates(0) is the X coordinate of the bottom-left
point
iCoordinates(1) is the Y coordinate of the bottom-left point


iText
The text

Returns:
The created marker 2D
Example:

This example creates a new marker 2D in the TheMarker2Ds
collection.


Dim NewMarker2DText As Marker2D
Set NewMarker2DText = TheMarker2Ds.Add2DText(Positions, “example”)
Parameters:
  • i_coordinates (tuple) –

  • i_text (str) –

Return type:

Marker2D

item(i_index: cat_variant) Marker2D

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Func Item(CATVariant iIndex) As Marker2D

Returns a marker 2D using its index from the Marker2Ds
collection.

Parameters:

iIndex
The index of the marker 2D to retrieve from the collection of
Marker2Ds. As a numerics, this index is the rank of the marker 2D in the
collection. The index of the first marker 2D in the collection is 1, and the
index of the last marker 2D is Count.

Returns:
The retrieved marker 2D
Example:

This example retrieves in ThisMarker2D the ninth marker 2D

from the TheMarker2Ds collection.


Dim ThisMarker2D As Marker2D
Set ThisMarker2D = TheMarker2Ds.Item(9)
Parameters:

i_index (cat_variant) –

Return type:

Marker2D

remove(i_index: cat_variant) None

Note

CAA V5 Visual Basic Help (2020-07-06 14:02:20.222384))
o Sub Remove(CATVariant iIndex)

Removes a marker 2D from the Marker2Ds collection.

Parameters:

iIndex
The index of the marker 2D to retrieve from he collection of
Marker2Ds. As a numerics, this index is the rank of the marker 2D in the
collection. The index of the first marker 2D in the collection is 1, and the
index of the last marker 2D is Count.

Example:

The following example removes the tenth marker 2D from the
TheMarker2Ds collection.


TheMarker2Ds.Remove(10)
Parameters:

i_index (cat_variant) –

Return type:

None