fake-bpy-module 20231205__py3-none-any.whl → 20231207__py3-none-any.whl

freestyle/functions.py

@@ -1,1270 +0,0 @@
-import sys
-import typing
-import freestyle.types
-import mathutils
-
-GenericType = typing.TypeVar("GenericType")
-
-
-class ChainingTimeStampF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVoid` > `ChainingTimeStampF1D`
-    '''
-
-    def __init__(self):
-        ''' Builds a ChainingTimeStampF1D object.
-
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D'):
-        ''' Sets the chaining time stamp of the Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        '''
-        pass
-
-
-class Curvature2DAngleF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `Curvature2DAngleF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a Curvature2DAngleF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns a real value giving the 2D curvature (as an angle) of the 1D element to which the `freestyle.types.Interface0D` pointed by the Interface0DIterator belongs. The 2D curvature is evaluated at the Interface0D.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The 2D curvature of the 1D element evaluated at the pointed Interface0D.
-        '''
-        pass
-
-
-class Curvature2DAngleF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `Curvature2DAngleF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a Curvature2DAngleF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the 2D curvature as an angle for an Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The 2D curvature as an angle.
-        '''
-        pass
-
-
-class CurveMaterialF0D:
-    ''' A replacement of the built-in MaterialF0D for stroke creation. MaterialF0D does not work with Curves and Strokes. Line color priority is used to pick one of the two materials at material boundaries. Notes: expects instances of CurvePoint to be iterated over can return None if no fedge can be found
-    '''
-
-    pass
-
-
-class CurveNatureF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DEdgeNature` > `CurveNatureF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a CurveNatureF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'freestyle.types.Nature':
-        ''' Returns the `freestyle.types.Nature` of the 1D element the Interface0D pointed by the Interface0DIterator belongs to.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'freestyle.types.Nature'
-        :return: The nature of the 1D element to which the pointed Interface0D belongs.
-        '''
-        pass
-
-
-class CurveNatureF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DEdgeNature` > `CurveNatureF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a CurveNatureF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D'
-                 ) -> 'freestyle.types.Nature':
-        ''' Returns the nature of the Interface1D (silhouette, ridge, crease, and so on). Except if the Interface1D is a `freestyle.types.ViewEdge`, this result might be ambiguous. Indeed, the Interface1D might result from the gathering of several 1D elements, each one being of a different nature. An integration method, such as the MEAN, might give, in this case, irrelevant results.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: 'freestyle.types.Nature'
-        :return: The nature of the Interface1D.
-        '''
-        pass
-
-
-class DensityF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `DensityF0D`
-    '''
-
-    def __init__(self, sigma: float = 2.0):
-        ''' Builds a DensityF0D object.
-
-        :param sigma: The gaussian sigma value indicating the X value for which the gaussian function is 0.5. It leads to the window size value (the larger, the smoother).
-        :type sigma: float
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the density of the (result) image evaluated at the `freestyle.types.Interface0D` pointed by the Interface0DIterator. This density is evaluated using a pixels square window around the evaluation point and integrating these values using a gaussian.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The density of the image evaluated at the pointed Interface0D.
-        '''
-        pass
-
-
-class DensityF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `DensityF1D`
-    '''
-
-    def __init__(self,
-                 sigma: float = 2.0,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN',
-                 sampling: float = 2.0):
-        ''' Builds a DensityF1D object.
-
-        :param sigma: The sigma used in DensityF0D and determining the window size used in each density query.
-        :type sigma: float
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        :param sampling: the corresponding 0D function is evaluated at each sample point and the result is obtained by combining the resulting values into a single one, following the method specified by integration_type.
-        :type sampling: float
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the density evaluated for an Interface1D. The density is evaluated for a set of points along the Interface1D (using the `freestyle.functions.DensityF0D` functor) with a user-defined sampling and then integrated into a single value using a user-defined integration method.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The density evaluated for an Interface1D.
-        '''
-        pass
-
-
-class GetCompleteViewMapDensityF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetCompleteViewMapDensityF1D`
-    '''
-
-    def __init__(self,
-                 level: int,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN',
-                 sampling: float = 2.0):
-        ''' Builds a GetCompleteViewMapDensityF1D object.
-
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        :param sampling: the corresponding 0D function is evaluated at each sample point and the result is obtained by combining the resulting values into a single one, following the method specified by integration_type.
-        :type sampling: float
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the density evaluated for an Interface1D in the complete viewmap image. The density is evaluated for a set of points along the Interface1D (using the `freestyle.functions.ReadCompleteViewMapPixelF0D` functor) and then integrated into a single value using a user-defined integration method.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The density evaluated for the Interface1D in the complete viewmap image.
-        '''
-        pass
-
-
-class GetCurvilinearAbscissaF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DFloat` > `GetCurvilinearAbscissaF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetCurvilinearAbscissaF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the curvilinear abscissa of the `freestyle.types.Interface0D` pointed by the Interface0DIterator in the context of its 1D element.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The curvilinear abscissa of the pointed Interface0D.
-        '''
-        pass
-
-
-class GetDirectionalViewMapDensityF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetDirectionalViewMapDensityF1D`
-    '''
-
-    def __init__(self,
-                 orientation: int,
-                 level: int,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN',
-                 sampling: float = 2.0):
-        ''' Builds a GetDirectionalViewMapDensityF1D object.
-
-        :param orientation: The number of the directional map we must work with.
-        :type orientation: int
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        :param sampling: the corresponding 0D function is evaluated at each sample point and the result is obtained by combining the resulting values into a single one, following the method specified by integration_type.
-        :type sampling: float
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the density evaluated for an Interface1D in of the steerable viewmaps image. The direction telling which Directional map to choose is explicitly specified by the user. The density is evaluated for a set of points along the Interface1D (using the `freestyle.functions.ReadSteerableViewMapPixelF0D` functor) and then integrated into a single value using a user-defined integration method.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: the density evaluated for an Interface1D in of the steerable viewmaps image.
-        '''
-        pass
-
-
-class GetOccludeeF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DViewShape` > `GetOccludeeF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetOccludeeF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'freestyle.types.ViewShape':
-        ''' Returns the `freestyle.types.ViewShape` that the Interface0D pointed by the Interface0DIterator occludes.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'freestyle.types.ViewShape'
-        :return: The ViewShape occluded by the pointed Interface0D.
-        '''
-        pass
-
-
-class GetOccludeeF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVectorViewShape` > `GetOccludeeF1D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetOccludeeF1D object.
-
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D'
-                 ) -> typing.List['freestyle.types.ViewShape']:
-        ''' Returns a list of occluded shapes covered by this Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: typing.List['freestyle.types.ViewShape']
-        :return: A list of occluded shapes covered by the Interface1D.
-        '''
-        pass
-
-
-class GetOccludersF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DVectorViewShape` > `GetOccludersF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetOccludersF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> typing.List['freestyle.types.ViewShape']:
-        ''' Returns a list of `freestyle.types.ViewShape` objects occluding the `freestyle.types.Interface0D` pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: typing.List['freestyle.types.ViewShape']
-        :return: A list of ViewShape objects occluding the pointed Interface0D.
-        '''
-        pass
-
-
-class GetOccludersF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVectorViewShape` > `GetOccludersF1D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetOccludersF1D object.
-
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D'
-                 ) -> typing.List['freestyle.types.ViewShape']:
-        ''' Returns a list of occluding shapes that cover this Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: typing.List['freestyle.types.ViewShape']
-        :return: A list of occluding shapes that cover the Interface1D.
-        '''
-        pass
-
-
-class GetParameterF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DFloat` > `GetParameterF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetParameterF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the parameter of the `freestyle.types.Interface0D` pointed by the Interface0DIterator in the context of its 1D element.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The parameter of an Interface0D.
-        '''
-        pass
-
-
-class GetProjectedXF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `GetProjectedXF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetProjectedXF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the X 3D projected coordinate of the `freestyle.types.Interface0D` pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The X 3D projected coordinate of the pointed Interface0D.
-        '''
-        pass
-
-
-class GetProjectedXF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetProjectedXF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a GetProjectedXF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the projected X 3D coordinate of an Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The projected X 3D coordinate of an Interface1D.
-        '''
-        pass
-
-
-class GetProjectedYF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `GetProjectedYF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetProjectedYF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the Y 3D projected coordinate of the `freestyle.types.Interface0D` pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The Y 3D projected coordinate of the pointed Interface0D.
-        '''
-        pass
-
-
-class GetProjectedYF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetProjectedYF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a GetProjectedYF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the projected Y 3D coordinate of an Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The projected Y 3D coordinate of an Interface1D.
-        '''
-        pass
-
-
-class GetProjectedZF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `GetProjectedZF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetProjectedZF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the Z 3D projected coordinate of the `freestyle.types.Interface0D` pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The Z 3D projected coordinate of the pointed Interface0D.
-        '''
-        pass
-
-
-class GetProjectedZF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetProjectedZF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a GetProjectedZF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the projected Z 3D coordinate of an Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The projected Z 3D coordinate of an Interface1D.
-        '''
-        pass
-
-
-class GetShapeF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DViewShape` > `GetShapeF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetShapeF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'freestyle.types.ViewShape':
-        ''' Returns the `freestyle.types.ViewShape` containing the Interface0D pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'freestyle.types.ViewShape'
-        :return: The ViewShape containing the pointed Interface0D.
-        '''
-        pass
-
-
-class GetShapeF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVectorViewShape` > `GetShapeF1D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetShapeF1D object.
-
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D'
-                 ) -> typing.List['freestyle.types.ViewShape']:
-        ''' Returns a list of shapes covered by this Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: typing.List['freestyle.types.ViewShape']
-        :return: A list of shapes covered by the Interface1D.
-        '''
-        pass
-
-
-class GetSteerableViewMapDensityF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetSteerableViewMapDensityF1D`
-    '''
-
-    def __init__(self,
-                 level: int,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN',
-                 sampling: float = 2.0):
-        ''' Builds a GetSteerableViewMapDensityF1D object.
-
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        :param sampling: the corresponding 0D function is evaluated at each sample point and the result is obtained by combining the resulting values into a single one, following the method specified by integration_type.
-        :type sampling: float
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the density of the ViewMap for a given Interface1D. The density of each `freestyle.types.FEdge` is evaluated in the proper steerable `freestyle.types.ViewMap` depending on its orientation.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The density of the ViewMap for a given Interface1D.
-        '''
-        pass
-
-
-class GetViewMapGradientNormF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DFloat` > `GetViewMapGradientNormF0D`
-    '''
-
-    def __init__(self, level: int):
-        ''' Builds a GetViewMapGradientNormF0D object.
-
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the norm of the gradient of the global viewmap density image.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The norm of the gradient of the global viewmap density image.
-        '''
-        pass
-
-
-class GetViewMapGradientNormF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetViewMapGradientNormF1D`
-    '''
-
-    def __init__(self,
-                 level: int,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN',
-                 sampling: float = 2.0):
-        ''' Builds a GetViewMapGradientNormF1D object.
-
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        :param sampling: the corresponding 0D function is evaluated at each sample point and the result is obtained by combining the resulting values into a single one, following the method specified by integration_type.
-        :type sampling: float
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the density of the ViewMap for a given Interface1D. The density of each `freestyle.types.FEdge` is evaluated in the proper steerable `freestyle.types.ViewMap` depending on its orientation.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The density of the ViewMap for a given Interface1D.
-        '''
-        pass
-
-
-class GetXF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `GetXF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetXF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the X 3D coordinate of the `freestyle.types.Interface0D` pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The X 3D coordinate of the pointed Interface0D.
-        '''
-        pass
-
-
-class GetXF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetXF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a GetXF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the X 3D coordinate of an Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The X 3D coordinate of the Interface1D.
-        '''
-        pass
-
-
-class GetYF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `GetYF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetYF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the Y 3D coordinate of the `freestyle.types.Interface0D` pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The Y 3D coordinate of the pointed Interface0D.
-        '''
-        pass
-
-
-class GetYF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetYF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a GetYF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the Y 3D coordinate of an Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The Y 3D coordinate of the Interface1D.
-        '''
-        pass
-
-
-class GetZF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `GetZF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a GetZF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the Z 3D coordinate of the `freestyle.types.Interface0D` pointed by the Interface0DIterator.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The Z 3D coordinate of the pointed Interface0D.
-        '''
-        pass
-
-
-class GetZF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `GetZF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a GetZF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the Z 3D coordinate of an Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The Z 3D coordinate of the Interface1D.
-        '''
-        pass
-
-
-class IncrementChainingTimeStampF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVoid` > `IncrementChainingTimeStampF1D`
-    '''
-
-    def __init__(self):
-        ''' Builds an IncrementChainingTimeStampF1D object.
-
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D'):
-        ''' Increments the chaining time stamp of the Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        '''
-        pass
-
-
-class LocalAverageDepthF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `LocalAverageDepthF0D`
-    '''
-
-    def __init__(self, mask_size: float = 5.0):
-        ''' Builds a LocalAverageDepthF0D object.
-
-        :param mask_size: The size of the mask.
-        :type mask_size: float
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns the average depth around the `freestyle.types.Interface0D` pointed by the Interface0DIterator. The result is obtained by querying the depth buffer on a window around that point.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The average depth around the pointed Interface0D.
-        '''
-        pass
-
-
-class LocalAverageDepthF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `LocalAverageDepthF1D`
-    '''
-
-    def __init__(self,
-                 sigma: float,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a LocalAverageDepthF1D object.
-
-        :param sigma: The sigma used in DensityF0D and determining the window size used in each density query.
-        :type sigma: float
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns the average depth evaluated for an Interface1D. The average depth is evaluated for a set of points along the Interface1D (using the `freestyle.functions.LocalAverageDepthF0D` functor) with a user-defined sampling and then integrated into a single value using a user-defined integration method.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The average depth evaluated for the Interface1D.
-        '''
-        pass
-
-
-class MaterialF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DMaterial` > `MaterialF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a MaterialF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'freestyle.types.Material':
-        ''' Returns the material of the object evaluated at the `freestyle.types.Interface0D` pointed by the Interface0DIterator. This evaluation can be ambiguous (in the case of a `freestyle.types.TVertex` for example. This functor tries to remove this ambiguity using the context offered by the 1D element to which the Interface0DIterator belongs to and by arbitrary choosing the material of the face that lies on its left when following the 1D element if there are two different materials on each side of the point. However, there still can be problematic cases, and the user willing to deal with this cases in a specific way should implement its own getMaterial functor.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'freestyle.types.Material'
-        :return: The material of the object evaluated at the pointed Interface0D.
-        '''
-        pass
-
-
-class Normal2DF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DVec2f` > `Normal2DF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a Normal2DF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'mathutils.Vector':
-        ''' Returns a two-dimensional vector giving the normalized 2D normal to the 1D element to which the `freestyle.types.Interface0D` pointed by the Interface0DIterator belongs. The normal is evaluated at the pointed Interface0D.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'mathutils.Vector'
-        :return: The 2D normal of the 1D element evaluated at the pointed Interface0D.
-        '''
-        pass
-
-
-class Normal2DF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVec2f` > `Normal2DF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a Normal2DF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self,
-                 inter: 'freestyle.types.Interface1D') -> 'mathutils.Vector':
-        ''' Returns the 2D normal for the Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: 'mathutils.Vector'
-        :return: The 2D normal for the Interface1D.
-        '''
-        pass
-
-
-class Orientation2DF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVec2f` > `Orientation2DF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds an Orientation2DF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self,
-                 inter: 'freestyle.types.Interface1D') -> 'mathutils.Vector':
-        ''' Returns the 2D orientation of the Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: 'mathutils.Vector'
-        :return: The 2D orientation of the Interface1D.
-        '''
-        pass
-
-
-class Orientation3DF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVec3f` > `Orientation3DF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds an Orientation3DF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self,
-                 inter: 'freestyle.types.Interface1D') -> 'mathutils.Vector':
-        ''' Returns the 3D orientation of the Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: 'mathutils.Vector'
-        :return: The 3D orientation of the Interface1D.
-        '''
-        pass
-
-
-class QuantitativeInvisibilityF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DUnsigned` > `QuantitativeInvisibilityF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a QuantitativeInvisibilityF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> int:
-        ''' Returns the quantitative invisibility of the `freestyle.types.Interface0D` pointed by the Interface0DIterator. This evaluation can be ambiguous (in the case of a `freestyle.types.TVertex` for example). This functor tries to remove this ambiguity using the context offered by the 1D element to which the Interface0D belongs to. However, there still can be problematic cases, and the user willing to deal with this cases in a specific way should implement its own getQIF0D functor.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: int
-        :return: The quantitative invisibility of the pointed Interface0D.
-        '''
-        pass
-
-
-class QuantitativeInvisibilityF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DUnsigned` > `QuantitativeInvisibilityF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a QuantitativeInvisibilityF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> int:
-        ''' Returns the Quantitative Invisibility of an Interface1D element. If the Interface1D is a `freestyle.types.ViewEdge`, then there is no ambiguity concerning the result. But, if the Interface1D results of a chaining (chain, stroke), then it might be made of several 1D elements of different Quantitative Invisibilities.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: int
-        :return: The Quantitative Invisibility of the Interface1D.
-        '''
-        pass
-
-
-class ReadCompleteViewMapPixelF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DFloat` > `ReadCompleteViewMapPixelF0D`
-    '''
-
-    def __init__(self, level: int):
-        ''' Builds a ReadCompleteViewMapPixelF0D object.
-
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Reads a pixel in one of the level of the complete viewmap.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: A pixel in one of the level of the complete viewmap.
-        '''
-        pass
-
-
-class ReadMapPixelF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DFloat` > `ReadMapPixelF0D`
-    '''
-
-    def __init__(self, map_name: str, level: int):
-        ''' Builds a ReadMapPixelF0D object.
-
-        :param map_name: The name of the map to be read.
-        :type map_name: str
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Reads a pixel in a map.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: A pixel in a map.
-        '''
-        pass
-
-
-class ReadSteerableViewMapPixelF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DFloat` > `ReadSteerableViewMapPixelF0D`
-    '''
-
-    def __init__(self, orientation: int, level: int):
-        ''' Builds a ReadSteerableViewMapPixelF0D object.
-
-        :param orientation: The integer belonging to [0, 4] indicating the orientation (E, NE, N, NW) we are interested in.
-        :type orientation: int
-        :param level: The level of the pyramid from which the pixel must be read.
-        :type level: int
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Reads a pixel in one of the level of one of the steerable viewmaps.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: A pixel in one of the level of one of the steerable viewmaps.
-        '''
-        pass
-
-
-class ShapeIdF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DId` > `ShapeIdF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a ShapeIdF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'freestyle.types.Id':
-        ''' Returns the `freestyle.types.Id` of the Shape the `freestyle.types.Interface0D` pointed by the Interface0DIterator belongs to. This evaluation can be ambiguous (in the case of a `freestyle.types.TVertex` for example). This functor tries to remove this ambiguity using the context offered by the 1D element to which the Interface0DIterator belongs to. However, there still can be problematic cases, and the user willing to deal with this cases in a specific way should implement its own getShapeIdF0D functor.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'freestyle.types.Id'
-        :return: The Id of the Shape the pointed Interface0D belongs to.
-        '''
-        pass
-
-
-class TimeStampF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DVoid` > `TimeStampF1D`
-    '''
-
-    def __init__(self):
-        ''' Builds a TimeStampF1D object.
-
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D'):
-        ''' Returns the time stamp of the Interface1D.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        '''
-        pass
-
-
-class VertexOrientation2DF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DVec2f` > `VertexOrientation2DF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a VertexOrientation2DF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'mathutils.Vector':
-        ''' Returns a two-dimensional vector giving the 2D oriented tangent to the 1D element to which the `freestyle.types.Interface0D` pointed by the Interface0DIterator belongs. The 2D oriented tangent is evaluated at the pointed Interface0D.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'mathutils.Vector'
-        :return: The 2D oriented tangent to the 1D element evaluated at the pointed Interface0D.
-        '''
-        pass
-
-
-class VertexOrientation3DF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DVec3f` > `VertexOrientation3DF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a VertexOrientation3DF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator'
-                 ) -> 'mathutils.Vector':
-        ''' Returns a three-dimensional vector giving the 3D oriented tangent to the 1D element to which the `freestyle.types.Interface0D` pointed by the Interface0DIterator belongs. The 3D oriented tangent is evaluated at the pointed Interface0D.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: 'mathutils.Vector'
-        :return: The 3D oriented tangent to the 1D element evaluated at the pointed Interface0D.
-        '''
-        pass
-
-
-class ZDiscontinuityF0D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction0D` > `freestyle.types.UnaryFunction0DDouble` > `ZDiscontinuityF0D`
-    '''
-
-    def __init__(self):
-        ''' Builds a ZDiscontinuityF0D object.
-
-        '''
-        pass
-
-    def __call__(self, it: 'freestyle.types.Interface0DIterator') -> float:
-        ''' Returns a real value giving the distance between the `freestyle.types.Interface0D` pointed by the Interface0DIterator and the shape that lies behind (occludee). This distance is evaluated in the camera space and normalized between 0 and 1. Therefore, if no object is occluded by the shape to which the Interface0D belongs to, 1 is returned.
-
-        :param it: An Interface0DIterator object.
-        :type it: 'freestyle.types.Interface0DIterator'
-        :rtype: float
-        :return: The normalized distance between the pointed Interface0D and the occludee.
-        '''
-        pass
-
-
-class ZDiscontinuityF1D:
-    ''' Class hierarchy: `freestyle.types.UnaryFunction1D` > `freestyle.types.UnaryFunction1DDouble` > `ZDiscontinuityF1D`
-    '''
-
-    def __init__(self,
-                 integration_type:
-                 'freestyle.types.IntegrationType' = 'IntegrationType.MEAN'):
-        ''' Builds a ZDiscontinuityF1D object.
-
-        :param integration_type: The integration method used to compute a single value from a set of values.
-        :type integration_type: 'freestyle.types.IntegrationType'
-        '''
-        pass
-
-    def __call__(self, inter: 'freestyle.types.Interface1D') -> float:
-        ''' Returns a real value giving the distance between an Interface1D and the shape that lies behind (occludee). This distance is evaluated in the camera space and normalized between 0 and 1. Therefore, if no object is occluded by the shape to which the Interface1D belongs to, 1 is returned.
-
-        :param inter: An Interface1D object.
-        :type inter: 'freestyle.types.Interface1D'
-        :rtype: float
-        :return: The normalized distance between the Interface1D and the occludee.
-        '''
-        pass
-
-
-class pyCurvilinearLengthF0D:
-    pass
-
-
-class pyDensityAnisotropyF0D:
-    ''' Estimates the anisotropy of density.
-    '''
-
-    pass
-
-
-class pyDensityAnisotropyF1D:
-    pass
-
-
-class pyGetInverseProjectedZF1D:
-    pass
-
-
-class pyGetSquareInverseProjectedZF1D:
-    pass
-
-
-class pyInverseCurvature2DAngleF0D:
-    pass
-
-
-class pyViewMapGradientNormF0D:
-    pass
-
-
-class pyViewMapGradientNormF1D:
-    pass
-
-
-class pyViewMapGradientVectorF0D:
-    ''' Returns the gradient vector for a pixel.
-    '''
-
-    def __init__(self, level: int):
-        ''' Builds a pyViewMapGradientVectorF0D object.
-
-        :param level: the level at which to compute the gradient
-        :type level: int
-        '''
-        pass