c4d.BaseTime¶

class c4d.BaseTime¶

A BaseTime represents a time value within Cinema 4d.

Here is an example how to use a BaseTime object.

import c4d

bc1 = c4d.BaseTime(5, 10) # reduced to 1/2
bc2 = c4d.BaseTime(5)     # 5/1
bc3 = bc1 / bc2
doc.SetTime(bc3)

Overview¶

Magic Methods
`BaseTime.__add__()`	Add two times and return the result.
`BaseTime.__cmp__()`	Compare two times with each other.
`BaseTime.__div__()`	Divide two times and return the result.
`BaseTime.__eq__()`	Check if two different BaseTime represents the same time.
`BaseTime.__ge__()`	Check if the passed BaseTime is greater or equal than self.
`BaseTime.__gt__()`	Check if the passed BaseTime is greater than self.
`BaseTime.__init__()`	Initializes the internal time value from a real value in seconds.
`BaseTime.__le__()`	Check if the passed BaseTime is lesser or equal than self.
`BaseTime.__lt__()`	Check if the passed BaseTime is lesser than self.
`BaseTime.__mul__()`	Multiply two times and return the result.
`BaseTime.__ne__()`	Check if two different BaseTime don’t represents the same time.
`BaseTime.__sub__()`	Subtract two times and return the result.
Rational Components
`BaseTime.GetDenominator()`	Get the denominator part of the internally stored time.
`BaseTime.GetNumerator()`	Get the numerator part of the internally stored time.
`BaseTime.SetDenominator()`	Get the denominator part of the internally stored time.
`BaseTime.SetNumerator()`	Set the numerator part of the internally stored time.
Time Measurement Operations
`BaseTime.Get()`	Return the time in seconds.
`BaseTime.GetFrame()`	Get the number of frames equivalent to this time for the given number of frames per second.
`BaseTime.Quantize()`	Quantize the internal value so that it is a multiple of the specified framerate.
`BaseTime.TimeDif()`	Check which is the largest between the time and t2.

Members¶

Magic Methods¶

BaseTime.__add__(self, other)¶

Add two times and return the result.

Parameters: other (c4d.BaseTime) – The other value.
Return type: c4d.BaseTime
Returns: The result.

BaseTime.__cmp__(self, other)¶

Compare two times with each other.

Parameters: other (c4d.BaseTime) – The time value to compare with.

BaseTime.__div__(self, other)¶

Divide two times and return the result.

Parameters: other (c4d.BaseTime) – The other value.
Return type: c4d.BaseTime
Returns: The result.

BaseTime.__eq__(self, other)¶

Check if two different BaseTime represents the same time.

Parameters: other (c4d.BaseTime) – The time value to compare with.
Return type: bool
Returns: True if the BaseTime are similar, otherwise False.

BaseTime.__ge__(self, other)¶

Check if the passed BaseTime is greater or equal than self.

Parameters: other (c4d.BaseTime) – The other BaseTime.
Return type: bool
Returns: True if other BaseTime is greater or equal than self

BaseTime.__gt__(self, other)¶

Check if the passed BaseTime is greater than self.

Parameters: other (c4d.BaseTime) – The other BaseTime.
Return type: bool
Returns: True if other BaseTime is greater than self

BaseTime.__init__(self, z=0.0, n=0.0)¶

Initializes the internal time value from a real value in seconds.

This will multiply the seconds by 1000.0 and store it as a fraction with the denominator at 1000.0.

Parameters

z (int) – Optional time in seconds.
n (Union[bool, int]) – If n is False, disable the automatic fraction-reduction and if int, set the denominator.

BaseTime.__le__(self, other)¶

Check if the passed BaseTime is lesser or equal than self.

Parameters: other (c4d.BaseTime) – The other BaseTime.
Return type: bool
Returns: True if other BaseTime is lesser or equal than self

BaseTime.__lt__(self, other)¶

Check if the passed BaseTime is lesser than self.

Parameters: other (c4d.BaseTime) – The other BaseTime.
Return type: bool
Returns: True if other BaseTime is lesser than self

BaseTime.__mul__(self, other)¶

Multiply two times and return the result.

Parameters: other (c4d.BaseTime) – The other value.
Return type: c4d.BaseTime
Returns: The result.

BaseTime.__ne__(self, other)¶

Check if two different BaseTime don’t represents the same time.

Return type: bool
Returns: True if the BaseTime don’t represent the same time, otherwise False.

BaseTime.__sub__(self, other)¶

Subtract two times and return the result.

Parameters: other (c4d.BaseTime) – The other value.
Return type: c4d.BaseTime
Returns: The result.

Rational Components¶

BaseTime.GetDenominator(self)¶

Get the denominator part of the internally stored time.

Return type: float
Returns: The denominator

BaseTime.GetNumerator(self)¶

Get the numerator part of the internally stored time.

Return type: float
Returns: The numerator.

BaseTime.SetDenominator(self, r)¶

Get the denominator part of the internally stored time.

Parameters: r (number) – The denominator.

BaseTime.SetNumerator(self, r)¶

Set the numerator part of the internally stored time.

Parameters: r (number) – The numerator.

Time Measurement Operations¶

BaseTime.Get(self)¶

Return the time in seconds.

Return type: float
Returns: Time in seconds.

BaseTime.GetFrame(self, fps)¶

Get the number of frames equivalent to this time for the given number of frames per second.

Parameters: fps (int) – The number of frames for this time.
Return type: int
Returns: The frames per second to use to calculate the frame number for this time.

BaseTime.Quantize(self, fps)¶

Quantize the internal value so that it is a multiple of the specified framerate.

Parameters: fps (number) – The number of frames per second to make this time a multiple of.

BaseTime.TimeDif(self, t2)¶

Check which is the largest between the time and t2.

Parameters: t2 (c4d.BaseTime) – The time to compare with.
Return type: int
Returns: -1 if the time is < t2, 0 if they are equal and 1 if the time is > t2.

Category	Option	Description
Query	Words and phrases	Search is case-insensitive. Put a phrase in quotes for an exact match. Quoted phrases require every word and disable fuzzy matching.
Terms	OR / AND	Choose whether to match any term or require all terms.
Fuzzy	On / Off	Toggle approximate and prefix matches. Quoted phrases always use strict matching.
Results	Sparse / Dense	Sparse groups multiple hits for one entity and hides its owned API members when the class or module itself matches. Dense lists each match separately.
Sort by	Type / Relevance	Group results by entity type then rank within each group, or rank all results by relevance.
Content	All / API / Manuals / Examples / Resources	Search all documentation, API documentation, manuals, the examples index, or the resources index. Code examples embedded in other sections retain their own content area.
Entity	All / Page / Module / Class / Function / Attribute / Description / Node / Symbol / Icon	Page covers results without a specific entity type. Resource entity types are available with All or Resources; API entity types are available with All or API.
Location	All / Text / Code / Name / Signature	Text covers everything outside code, names, and signatures. Name and Signature are available with All or API.