Freestyle Functions (freestyle.functions)¶
This module contains functions operating on vertices (0D elements) and polylines (1D elements). The module is also intended to be a collection of examples for function definition in Python.
User-defined functions inherit one of the following base classes, depending on the object type (0D or 1D) to operate on and the return value type:
freestyle.types.UnaryFunction0DDouble
freestyle.types.UnaryFunction0DEdgeNature
freestyle.types.UnaryFunction0DFloat
freestyle.types.UnaryFunction0DId
freestyle.types.UnaryFunction0DMaterial
freestyle.types.UnaryFunction0DUnsigned
freestyle.types.UnaryFunction0DVec2f
freestyle.types.UnaryFunction0DVec3f
freestyle.types.UnaryFunction0DVectorViewShape
freestyle.types.UnaryFunction0DViewShape
freestyle.types.UnaryFunction1DDouble
freestyle.types.UnaryFunction1DEdgeNature
freestyle.types.UnaryFunction1DFloat
freestyle.types.UnaryFunction1DUnsigned
freestyle.types.UnaryFunction1DVec2f
freestyle.types.UnaryFunction1DVec3f
freestyle.types.UnaryFunction1DVectorViewShape
freestyle.types.UnaryFunction1DVoid
-
class
freestyle.functions.
ChainingTimeStampF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVoid
>ChainingTimeStampF1D
-
__init__
()¶ Builds a ChainingTimeStampF1D object.
-
__call__
(inter)¶ Sets the chaining time stamp of the Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.
-
-
class
freestyle.functions.
Curvature2DAngleF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>Curvature2DAngleF0D
-
__init__
()¶ Builds a Curvature2DAngleF0D object.
-
__call__
(it)¶ 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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The 2D curvature of the 1D element evaluated at the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
Curvature2DAngleF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>Curvature2DAngleF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a Curvature2DAngleF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the 2D curvature as an angle for an Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The 2D curvature as an angle. Return type: float
-
-
class
freestyle.functions.
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
-
class
freestyle.functions.
CurveNatureF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DEdgeNature
>CurveNatureF0D
-
__init__
()¶ Builds a CurveNatureF0D object.
-
__call__
(it)¶ Returns the
freestyle.types.Nature
of the 1D element the Interface0D pointed by the Interface0DIterator belongs to.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The nature of the 1D element to which the pointed Interface0D belongs. Return type: freestyle.types.Nature
-
-
class
freestyle.functions.
CurveNatureF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DEdgeNature
>CurveNatureF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a CurveNatureF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ 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.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The nature of the Interface1D. Return type: freestyle.types.Nature
-
-
class
freestyle.functions.
DensityF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>DensityF0D
-
__init__
(sigma=2.0)¶ Builds a DensityF0D object.
Parameters: sigma (float) – 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).
-
__call__
(it)¶ 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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The density of the image evaluated at the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
DensityF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>DensityF1D
-
__init__
(sigma=2.0, integration_type=IntegrationType.MEAN, sampling=2.0)¶ Builds a DensityF1D object.
Parameters: - sigma (float) – The sigma used in DensityF0D and determining the window size used in each density query.
- integration_type (
freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values. - sampling (float) – The resolution used to sample the chain: 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.
-
__call__
(inter)¶ 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.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The density evaluated for an Interface1D. Return type: float
-
-
class
freestyle.functions.
GetCompleteViewMapDensityF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetCompleteViewMapDensityF1D
-
__init__
(level, integration_type=IntegrationType.MEAN, sampling=2.0)¶ Builds a GetCompleteViewMapDensityF1D object.
Parameters: - level (int) – The level of the pyramid from which the pixel must be read.
- integration_type (
freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values. - sampling (float) – The resolution used to sample the chain: 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.
-
__call__
(inter)¶ 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.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The density evaluated for the Interface1D in the complete viewmap image. Return type: float
-
-
class
freestyle.functions.
GetCurvilinearAbscissaF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DFloat
>GetCurvilinearAbscissaF0D
-
__init__
()¶ Builds a GetCurvilinearAbscissaF0D object.
-
__call__
(it)¶ Returns the curvilinear abscissa of the
freestyle.types.Interface0D
pointed by the Interface0DIterator in the context of its 1D element.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The curvilinear abscissa of the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
GetDirectionalViewMapDensityF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetDirectionalViewMapDensityF1D
-
__init__
(orientation, level, integration_type=IntegrationType.MEAN, sampling=2.0)¶ Builds a GetDirectionalViewMapDensityF1D object.
Parameters: - orientation (int) – The number of the directional map we must work with.
- level (int) – The level of the pyramid from which the pixel must be read.
- integration_type (
freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values. - sampling (float) – The resolution used to sample the chain: 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.
-
__call__
(inter)¶ 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.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: the density evaluated for an Interface1D in of the steerable viewmaps image. Return type: float
-
-
class
freestyle.functions.
GetOccludeeF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DViewShape
>GetOccludeeF0D
-
__init__
()¶ Builds a GetOccludeeF0D object.
-
__call__
(it)¶ Returns the
freestyle.types.ViewShape
that the Interface0D pointed by the Interface0DIterator occludes.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The ViewShape occluded by the pointed Interface0D. Return type: freestyle.types.ViewShape
-
-
class
freestyle.functions.
GetOccludeeF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVectorViewShape
>GetOccludeeF1D
-
__init__
()¶ Builds a GetOccludeeF1D object.
-
__call__
(inter)¶ Returns a list of occluded shapes covered by this Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: A list of occluded shapes covered by the Interface1D. Return type: list of freestyle.types.ViewShape
objects
-
-
class
freestyle.functions.
GetOccludersF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DVectorViewShape
>GetOccludersF0D
-
__init__
()¶ Builds a GetOccludersF0D object.
-
__call__
(it)¶ Returns a list of
freestyle.types.ViewShape
objects occluding thefreestyle.types.Interface0D
pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: A list of ViewShape objects occluding the pointed Interface0D. Return type: list of freestyle.types.ViewShape
objects
-
-
class
freestyle.functions.
GetOccludersF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVectorViewShape
>GetOccludersF1D
-
__init__
()¶ Builds a GetOccludersF1D object.
-
__call__
(inter)¶ Returns a list of occluding shapes that cover this Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: A list of occluding shapes that cover the Interface1D. Return type: list of freestyle.types.ViewShape
objects
-
-
class
freestyle.functions.
GetParameterF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DFloat
>GetParameterF0D
-
__init__
()¶ Builds a GetParameterF0D object.
-
__call__
(it)¶ Returns the parameter of the
freestyle.types.Interface0D
pointed by the Interface0DIterator in the context of its 1D element.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The parameter of an Interface0D. Return type: float
-
-
class
freestyle.functions.
GetProjectedXF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>GetProjectedXF0D
-
__init__
()¶ Builds a GetProjectedXF0D object.
-
__call__
(it)¶ Returns the X 3D projected coordinate of the
freestyle.types.Interface0D
pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The X 3D projected coordinate of the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
GetProjectedXF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetProjectedXF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a GetProjectedXF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the projected X 3D coordinate of an Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The projected X 3D coordinate of an Interface1D. Return type: float
-
-
class
freestyle.functions.
GetProjectedYF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>GetProjectedYF0D
-
__init__
()¶ Builds a GetProjectedYF0D object.
-
__call__
(it)¶ Returns the Y 3D projected coordinate of the
freestyle.types.Interface0D
pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The Y 3D projected coordinate of the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
GetProjectedYF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetProjectedYF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a GetProjectedYF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the projected Y 3D coordinate of an Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The projected Y 3D coordinate of an Interface1D. Return type: float
-
-
class
freestyle.functions.
GetProjectedZF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>GetProjectedZF0D
-
__init__
()¶ Builds a GetProjectedZF0D object.
-
__call__
(it)¶ Returns the Z 3D projected coordinate of the
freestyle.types.Interface0D
pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The Z 3D projected coordinate of the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
GetProjectedZF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetProjectedZF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a GetProjectedZF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the projected Z 3D coordinate of an Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The projected Z 3D coordinate of an Interface1D. Return type: float
-
-
class
freestyle.functions.
GetShapeF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DViewShape
>GetShapeF0D
-
__init__
()¶ Builds a GetShapeF0D object.
-
__call__
(it)¶ Returns the
freestyle.types.ViewShape
containing the Interface0D pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The ViewShape containing the pointed Interface0D. Return type: freestyle.types.ViewShape
-
-
class
freestyle.functions.
GetShapeF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVectorViewShape
>GetShapeF1D
-
__init__
()¶ Builds a GetShapeF1D object.
-
__call__
(inter)¶ Returns a list of shapes covered by this Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: A list of shapes covered by the Interface1D. Return type: list of freestyle.types.ViewShape
objects
-
-
class
freestyle.functions.
GetSteerableViewMapDensityF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetSteerableViewMapDensityF1D
-
__init__
(level, integration_type=IntegrationType.MEAN, sampling=2.0)¶ Builds a GetSteerableViewMapDensityF1D object.
Parameters: - level (int) – The level of the pyramid from which the pixel must be read.
- integration_type (
freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values. - sampling (float) – The resolution used to sample the chain: 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.
-
__call__
(inter)¶ Returns the density of the ViewMap for a given Interface1D. The density of each
freestyle.types.FEdge
is evaluated in the proper steerablefreestyle.types.ViewMap
depending on its orientation.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The density of the ViewMap for a given Interface1D. Return type: float
-
-
class
freestyle.functions.
GetViewMapGradientNormF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DFloat
>GetViewMapGradientNormF0D
-
__init__
(level)¶ Builds a GetViewMapGradientNormF0D object.
Parameters: level (int) – The level of the pyramid from which the pixel must be read.
-
__call__
(it)¶ Returns the norm of the gradient of the global viewmap density image.
Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The norm of the gradient of the global viewmap density image. Return type: float
-
-
class
freestyle.functions.
GetViewMapGradientNormF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetViewMapGradientNormF1D
-
__init__
(level, integration_type=IntegrationType.MEAN, sampling=2.0)¶ Builds a GetViewMapGradientNormF1D object.
Parameters: - level (int) – The level of the pyramid from which the pixel must be read.
- integration_type (
freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values. - sampling (float) – The resolution used to sample the chain: 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.
-
__call__
(inter)¶ Returns the density of the ViewMap for a given Interface1D. The density of each
freestyle.types.FEdge
is evaluated in the proper steerablefreestyle.types.ViewMap
depending on its orientation.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The density of the ViewMap for a given Interface1D. Return type: float
-
-
class
freestyle.functions.
GetXF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>GetXF0D
-
__init__
()¶ Builds a GetXF0D object.
-
__call__
(it)¶ Returns the X 3D coordinate of the
freestyle.types.Interface0D
pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The X 3D coordinate of the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
GetXF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetXF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a GetXF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the X 3D coordinate of an Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The X 3D coordinate of the Interface1D. Return type: float
-
-
class
freestyle.functions.
GetYF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>GetYF0D
-
__init__
()¶ Builds a GetYF0D object.
-
__call__
(it)¶ Returns the Y 3D coordinate of the
freestyle.types.Interface0D
pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The Y 3D coordinate of the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
GetYF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetYF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a GetYF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the Y 3D coordinate of an Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The Y 3D coordinate of the Interface1D. Return type: float
-
-
class
freestyle.functions.
GetZF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>GetZF0D
-
__init__
()¶ Builds a GetZF0D object.
-
__call__
(it)¶ Returns the Z 3D coordinate of the
freestyle.types.Interface0D
pointed by the Interface0DIterator.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The Z 3D coordinate of the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
GetZF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>GetZF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a GetZF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the Z 3D coordinate of an Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The Z 3D coordinate of the Interface1D. Return type: float
-
-
class
freestyle.functions.
IncrementChainingTimeStampF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVoid
>IncrementChainingTimeStampF1D
-
__init__
()¶ Builds an IncrementChainingTimeStampF1D object.
-
__call__
(inter)¶ Increments the chaining time stamp of the Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.
-
-
class
freestyle.functions.
LocalAverageDepthF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>LocalAverageDepthF0D
-
__init__
(mask_size=5.0)¶ Builds a LocalAverageDepthF0D object.
Parameters: mask_size (float) – The size of the mask.
-
__call__
(it)¶ 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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The average depth around the pointed Interface0D. Return type: float
-
-
class
freestyle.functions.
LocalAverageDepthF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>LocalAverageDepthF1D
-
__init__
(sigma, integration_type=IntegrationType.MEAN)¶ Builds a LocalAverageDepthF1D object.
Parameters: - sigma (float) – The sigma used in DensityF0D and determining the window size used in each density query.
- integration_type (
freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ 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.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The average depth evaluated for the Interface1D. Return type: float
-
-
class
freestyle.functions.
MaterialF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DMaterial
>MaterialF0D
-
__init__
()¶ Builds a MaterialF0D object.
-
__call__
(it)¶ 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 afreestyle.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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The material of the object evaluated at the pointed Interface0D. Return type: freestyle.types.Material
-
-
class
freestyle.functions.
Normal2DF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DVec2f
>Normal2DF0D
-
__init__
()¶ Builds a Normal2DF0D object.
-
__call__
(it)¶ 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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The 2D normal of the 1D element evaluated at the pointed Interface0D. Return type: mathutils.Vector
-
-
class
freestyle.functions.
Normal2DF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVec2f
>Normal2DF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a Normal2DF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the 2D normal for the Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The 2D normal for the Interface1D. Return type: mathutils.Vector
-
-
class
freestyle.functions.
Orientation2DF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVec2f
>Orientation2DF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds an Orientation2DF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the 2D orientation of the Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The 2D orientation of the Interface1D. Return type: mathutils.Vector
-
-
class
freestyle.functions.
Orientation3DF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVec3f
>Orientation3DF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds an Orientation3DF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ Returns the 3D orientation of the Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The 3D orientation of the Interface1D. Return type: mathutils.Vector
-
-
class
freestyle.functions.
QuantitativeInvisibilityF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DUnsigned
>QuantitativeInvisibilityF0D
-
__init__
()¶ Builds a QuantitativeInvisibilityF0D object.
-
__call__
(it)¶ Returns the quantitative invisibility of the
freestyle.types.Interface0D
pointed by the Interface0DIterator. This evaluation can be ambiguous (in the case of afreestyle.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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The quantitative invisibility of the pointed Interface0D. Return type: int
-
-
class
freestyle.functions.
QuantitativeInvisibilityF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DUnsigned
>QuantitativeInvisibilityF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a QuantitativeInvisibilityF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ 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.Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The Quantitative Invisibility of the Interface1D. Return type: int
-
-
class
freestyle.functions.
ReadCompleteViewMapPixelF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DFloat
>ReadCompleteViewMapPixelF0D
-
__init__
(level)¶ Builds a ReadCompleteViewMapPixelF0D object.
Parameters: level (int) – The level of the pyramid from which the pixel must be read.
-
__call__
(it)¶ Reads a pixel in one of the level of the complete viewmap.
Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: A pixel in one of the level of the complete viewmap. Return type: float
-
-
class
freestyle.functions.
ReadMapPixelF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DFloat
>ReadMapPixelF0D
-
__init__
(map_name, level)¶ Builds a ReadMapPixelF0D object.
Parameters: - map_name (str) – The name of the map to be read.
- level (int) – The level of the pyramid from which the pixel must be read.
-
__call__
(it)¶ Reads a pixel in a map.
Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: A pixel in a map. Return type: float
-
-
class
freestyle.functions.
ReadSteerableViewMapPixelF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DFloat
>ReadSteerableViewMapPixelF0D
-
__init__
(orientation, level)¶ Builds a ReadSteerableViewMapPixelF0D object.
Parameters: - orientation (int) – The integer belonging to [0, 4] indicating the orientation (E, NE, N, NW) we are interested in.
- level (int) – The level of the pyramid from which the pixel must be read.
-
__call__
(it)¶ Reads a pixel in one of the level of one of the steerable viewmaps.
Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: A pixel in one of the level of one of the steerable viewmaps. Return type: float
-
-
class
freestyle.functions.
ShapeIdF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DId
>ShapeIdF0D
-
__init__
()¶ Builds a ShapeIdF0D object.
-
__call__
(it)¶ Returns the
freestyle.types.Id
of the Shape thefreestyle.types.Interface0D
pointed by the Interface0DIterator belongs to. This evaluation can be ambiguous (in the case of afreestyle.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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The Id of the Shape the pointed Interface0D belongs to. Return type: freestyle.types.Id
-
-
class
freestyle.functions.
TimeStampF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DVoid
>TimeStampF1D
-
__init__
()¶ Builds a TimeStampF1D object.
-
__call__
(inter)¶ Returns the time stamp of the Interface1D.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.
-
-
class
freestyle.functions.
VertexOrientation2DF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DVec2f
>VertexOrientation2DF0D
-
__init__
()¶ Builds a VertexOrientation2DF0D object.
-
__call__
(it)¶ 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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The 2D oriented tangent to the 1D element evaluated at the pointed Interface0D. Return type: mathutils.Vector
-
-
class
freestyle.functions.
VertexOrientation3DF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DVec3f
>VertexOrientation3DF0D
-
__init__
()¶ Builds a VertexOrientation3DF0D object.
-
__call__
(it)¶ 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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The 3D oriented tangent to the 1D element evaluated at the pointed Interface0D. Return type: mathutils.Vector
-
-
class
freestyle.functions.
ZDiscontinuityF0D
¶ Class hierarchy:
freestyle.types.UnaryFunction0D
>freestyle.types.UnaryFunction0DDouble
>ZDiscontinuityF0D
-
__init__
()¶ Builds a ZDiscontinuityF0D object.
-
__call__
(it)¶ 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.Parameters: it ( freestyle.types.Interface0DIterator
) – An Interface0DIterator object.Returns: The normalized distance between the pointed Interface0D and the occludee. Return type: float
-
-
class
freestyle.functions.
ZDiscontinuityF1D
¶ Class hierarchy:
freestyle.types.UnaryFunction1D
>freestyle.types.UnaryFunction1DDouble
>ZDiscontinuityF1D
-
__init__
(integration_type=IntegrationType.MEAN)¶ Builds a ZDiscontinuityF1D object.
Parameters: integration_type ( freestyle.types.IntegrationType
) – The integration method used to compute a single value from a set of values.
-
__call__
(inter)¶ 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.
Parameters: inter ( freestyle.types.Interface1D
) – An Interface1D object.Returns: The normalized distance between the Interface1D and the occludee. Return type: float
-
-
class
freestyle.functions.
pyCurvilinearLengthF0D
¶
-
class
freestyle.functions.
pyDensityAnisotropyF0D
¶ Estimates the anisotropy of density.
-
class
freestyle.functions.
pyDensityAnisotropyF1D
¶
-
class
freestyle.functions.
pyGetInverseProjectedZF1D
¶
-
class
freestyle.functions.
pyGetSquareInverseProjectedZF1D
¶
-
class
freestyle.functions.
pyInverseCurvature2DAngleF0D
¶
-
class
freestyle.functions.
pyViewMapGradientNormF0D
¶
-
class
freestyle.functions.
pyViewMapGradientNormF1D
¶