Blob Blame Raw


#ifndef TSTROKE_UTIL_H
#define TSTROKE_UTIL_H

// TnzCore includes
#include "traster.h"

#undef DVAPI
#undef DVVAR

#ifdef TVRENDER_EXPORTS
#define DVAPI DV_EXPORT_API
#define DVVAR DV_EXPORT_VAR
#else
#define DVAPI DV_IMPORT_API
#define DVVAR DV_IMPORT_VAR
#endif

//=================================================

//    Forward declarations

class TStroke;
class TStrokeDeformation;
class TVectorRenderData;

//=================================================

//*******************************************************************************
//    Utility stroke  functions
//*******************************************************************************

/*!
  \brief    Inserts control points in a stroke according to the input deformer.

  \details  This function inserts redundant control points to use in the
            specified deformation.

              \par  Unverified documentation
            The "increaser" studies the gradient (getDelta) of the input deformer
            object, and insert control points if there is increment.\n
            In "extremes" there are the first point of not zero potential and
            the last.\n\n
            Special case (plane at same potential)
*/
DVAPI bool increaseControlPoints(
	TStroke &stroke,					//!< Stroke to be deformed.
	const TStrokeDeformation &deformer, //!< Deformer to be applied.
	double pixelSize = 1.0				//!< Resolution modifier.
	);

//-----------------------------------------------------------------------------

DVAPI void modifyControlPoints(TStroke &stroke,
							   const TStrokeDeformation &deformer);

DVAPI void modifyControlPoints(TStroke &stroke,
							   const TStrokeDeformation &deformer,
							   vector<double> &controlPointLen);

DVAPI void modifyThickness(TStroke &stroke,
						   const TStrokeDeformation &deformer,
						   vector<double> &controlPointLen,
						   bool exponentially = false);

//-----------------------------------------------------------------------------

/*!
  \brief    Transforms a stroke's thickness by a given polynomial function.
*/
DVAPI void transform_thickness(
	TStroke &stroke,	 //!< Stroke whose thickness will be transformed.
	const double poly[], //!< Polynomial coefficients, by increasing degree.
	int deg				 //!< Polynomial degree.
	);

//-----------------------------------------------------------------------------

/*!
  \brief    This function translates an input polyline to the control points
            of a sequence of quadratics.

  \details  The conversion is actually a 2 step process. First, segment midpoints
            are added to the sequence to be used as quadratic endpoints. Each
            "midpoint-vertex-midpoint" triplet is converted independently to
            quadratics, thus ensuring that tangent vectors at midpoints are
            preserved.

            The triplets conversion step allows the following control parameters:

              <UL>
              <LI> \a adherenceTol is the maximum distance allowed for quadratics to approximate a 
                   polyline corner (\p 0 meaning full corner).</LI>
              <LI> Polyline corners whose edges inner product is strictly above \a angleTol are 
                   transformed into full corners. The range for \a angleTol should be <TT>[-1, 1]</TT>.</LI>
              <LI> A quadratic approximating a polyline vertex triplet yields a minimum curvature
                   radius in proximity of the triplet's corner. If the ratios between such
                   radius and the edges extending from the corner are both below \a relativeTol,
                   the triplet is transformed into a full corner. The edges are calculated along
                   fat lines extending from the corner with \a relativeDist half-thickness.</LI>
              </UL>

            Once this first approximating sequence has been produced, an optimal quadratics
            merging step is employed to simplify the overall sequence.

            The \a mergeTol parameter specifies the allowed merging error that can be employed
            in this step (\p 0 meaning no simplification).

  \note     The output cps are thick points with 0 thickness. In other words, thickness
            is not considered, but supplied in output as TStrokes require them for construction.

  \sa       The tcg::polyline_ops::toQuadratics template function.
*/
DVAPI void polylineToQuadratics(
	const std::vector<TPointD> &polyline, //!< Polyline to be translated to quadratics.
	std::vector<TThickPoint> &cps,		  //!< Control points of the output quadratics sequence.
	double adherenceTol = 1.0,			  //!< Maximum distance from quadratic to polyline corner.
	double angleTol = 0.0,				  //!< Inner product threshold for polyline angles.
	double relativeTol = 0.25,
	double relativeDistTol = 0.25,
	double mergeTol = 1.0);

//-----------------------------------------------------------------------------

/*!
  \brief    Draws a stroke on a raster, under the specified rendering parameters.
*/
DVAPI void renderStroke(
	const TVectorRenderData &rd, //!< Render parameters (clipping rect, affine transform, etc).
	const TRaster32P &output,	//!< Destination raster.
	TStroke *stroke				 //!< Stroke to render.
	);

//-----------------------------------------------------------------------------

namespace Toonz
{

/*!
  \brief    Merge an array of stroke in a single stroke.

  \remark   If two consecutive strokes don't touch at the endpoints,
            an additional joining segment is added between them.
*/
DVAPI TStroke *merge(const std::vector<TStroke *> &strokes);

} // namespace Toonz

#endif // TSTROKE_UTIL_H