c4d.DescID – a DescID class

An ID class for description elements. Contains a stack of DescLevel objects.

The description ID is used to exactly identify a parameter value.

class c4d.DescID

• DescID.__init__()
• DescID.__str__()

• DescID.__lshift__()
• DescID.__getitem__()

• DescID.__eq__()
• DescID.__ne__()

• DescID.SetId()
• DescID.PushId()
• DescID.PopId()

• DescID.GetDepth()

Methods

DescID.__init__([id1[, id2, id3]])

Create a DescID instance up to three levels:

dId = c4d.DescID()
dId = c4d.DescID(dId) #copy constructor
dId = c4d.DescID(10) #first level with given ID
dId = c4d.DescID(DescLevel(10), DescLevel(20), DescLevel(30)) #set three levels

Parameters:

• id1 – see example
• id2 (DescLevel) – Second level.
• id3 (DescLevel) – Third level.

DescID.__str__()

Returns the DescID as string. Called if str() is wrapped around an instance of DescID. (see __str__).:

dId = c4d.DescID(c4d.DescLevel(30))
print dId                # output '(30, 0, 0)'

Return type:str Returns:The DescID as string.

DescID.__lshift__(self, other)

Returns the result of popping shift levels from the bottom of the stack:

dId = c4d.DescID(c4d.DescLevel(30), c4d.DescLevel(40), c4d.DescLevel(50))
diD<<2

Raises IndexError:  Raise if other is out of depth. Parameter:other (int) – Number of levels to pop, 0 <= shift < GetDepth(). Return type:DescID Returns:Result.

DescID.__getitem__(self, key)

Returns the level at position key in the stack:

dId = c4d.DescID(c4d.DescLevel(30), c4d.DescLevel(40), c4d.DescLevel(50))
diD[2]

Raises IndexError:  Raise if key is out of depth. Parameter:key (int) – Position, 0 <= shift < GetDepth(). Return type:DescLevel Returns:The level at the specified position.

DescID.__eq__(self, other)

Checks if all levels are equal.

DescID.__ne__(self, other)

The reverse of __eq__.

DescID.SetId(subid)

Set the highest level to subid.

Parameter:subid (DescLevel) – New toplevel.

DescID.PushId(subid)

Push a new level onto the stack.

Parameter:subid (DescLevel) – Level to push.

DescID.PopId()

Pops the highest level from the stack.

DescID.GetDepth()

Return the depth.

Return type:int Returns:The depth.