#include <SkContourMeasure.h>

Inheritance diagram for SkContourMeasure:

Public Types
enum	MatrixFlags { kGetPosition_MatrixFlag = 0x01 , kGetTangent_MatrixFlag = 0x02 , kGetPosAndTan_MatrixFlag = kGetPosition_MatrixFlag \| kGetTangent_MatrixFlag }

Public Member Functions
SkScalar	length () const

bool	getPosTan (SkScalar distance, SkPoint position, SkVector tangent) const

bool	getMatrix (SkScalar distance, SkMatrix *matrix, MatrixFlags flags=kGetPosAndTan_MatrixFlag) const

bool	getSegment (SkScalar startD, SkScalar stopD, SkPath *dst, bool startWithMoveTo) const

bool	isClosed () const

Public Member Functions inherited from SkRefCntBase
	SkRefCntBase ()

virtual	~SkRefCntBase ()

bool	unique () const

void	ref () const

void	unref () const

Friends
class	SkContourMeasureIter

class	SkPathMeasurePriv

Detailed Description

Definition at line 22 of file SkContourMeasure.h.

Member Enumeration Documentation

◆ MatrixFlags

enum SkContourMeasure::MatrixFlags

Enumerator
kGetPosition_MatrixFlag
kGetTangent_MatrixFlag
kGetPosAndTan_MatrixFlag

Definition at line 33 of file SkContourMeasure.h.

                     {
        kGetPosition_MatrixFlag     = 0x01,
        kGetTangent_MatrixFlag      = 0x02,
        kGetPosAndTan_MatrixFlag    = kGetPosition_MatrixFlag | kGetTangent_MatrixFlag
    };

Member Function Documentation

◆ getMatrix()

bool SkContourMeasure::getMatrix	(	SkScalar	distance,
		SkMatrix *	matrix,
		MatrixFlags	flags = `kGetPosAndTan_MatrixFlag`
	)		const

Pins distance to 0 <= distance <= getLength(), and then computes the corresponding matrix (by calling getPosTan). Returns false if there is no path, or a zero-length path was specified, in which case matrix is unchanged.

Definition at line 633 of file SkContourMeasure.cpp.

                                                                                             {
    SkPoint     position;
    SkVector    tangent;
 
    if (this->getPosTan(distance, &position, &tangent)) {
        if (matrix) {
            if (flags & kGetTangent_MatrixFlag) {
                matrix->setSinCos(tangent.fY, tangent.fX, 0, 0);
            } else {
                matrix->reset();
            }
            if (flags & kGetPosition_MatrixFlag) {
                matrix->postTranslate(position.fX, position.fY);
            }
        }
        return true;
    }
    return false;
}

◆ getPosTan()

bool SkContourMeasure::getPosTan	(	SkScalar	distance,
		SkPoint *	position,
		SkVector *	tangent
	)		const

Pins distance to 0 <= distance <= length(), and then computes the corresponding position and tangent.

Definition at line 607 of file SkContourMeasure.cpp.

                                                                                         {
    if (SkIsNaN(distance)) {
        return false;
    }
 
    const SkScalar length = this->length();
    SkASSERT(length > 0 && !fSegments.empty());
 
    // pin the distance to a legal range
    if (distance < 0) {
        distance = 0;
    } else if (distance > length) {
        distance = length;
    }
 
    SkScalar        t;
    const Segment*  seg = this->distanceToSegment(distance, &t);
    if (SkIsNaN(t)) {
        return false;
    }
 
    SkASSERT((unsigned)seg->fPtIndex < (unsigned)fPts.size());
    compute_pos_tan(&fPts[seg->fPtIndex], seg->fType, t, pos, tangent);
    return true;
}

◆ getSegment()

bool SkContourMeasure::getSegment	(	SkScalar	startD,
		SkScalar	stopD,
		SkPath *	dst,
		bool	startWithMoveTo
	)		const

Given a start and stop distance, return in dst the intervening segment(s). If the segment is zero-length, return false, else return true. startD and stopD are pinned to legal values (0..getLength()). If startD > stopD then return false (and leave dst untouched). Begin the segment with a moveTo if startWithMoveTo is true

Definition at line 653 of file SkContourMeasure.cpp.

                                                              {
    SkASSERT(dst);
 
    SkScalar length = this->length();    // ensure we have built our segments
 
    if (startD < 0) {
        startD = 0;
    }
    if (stopD > length) {
        stopD = length;
    }
    if (!(startD <= stopD)) {   // catch NaN values as well
        return false;
    }
    if (fSegments.empty()) {
        return false;
    }
 
    SkPoint  p;
    SkScalar startT, stopT;
    const Segment* seg = this->distanceToSegment(startD, &startT);
    if (!SkIsFinite(startT)) {
        return false;
    }
    const Segment* stopSeg = this->distanceToSegment(stopD, &stopT);
    if (!SkIsFinite(stopT)) {
        return false;
    }
    SkASSERT(seg <= stopSeg);
    if (startWithMoveTo) {
        compute_pos_tan(&fPts[seg->fPtIndex], seg->fType, startT, &p, nullptr);
        dst->moveTo(p);
    }
 
    if (seg->fPtIndex == stopSeg->fPtIndex) {
        SkContourMeasure_segTo(&fPts[seg->fPtIndex], seg->fType, startT, stopT, dst);
    } else {
        do {
            SkContourMeasure_segTo(&fPts[seg->fPtIndex], seg->fType, startT, SK_Scalar1, dst);
            seg = SkContourMeasure::Segment::Next(seg);
            startT = 0;
        } while (seg->fPtIndex < stopSeg->fPtIndex);
        SkContourMeasure_segTo(&fPts[seg->fPtIndex], seg->fType, 0, stopT, dst);
    }
 
    return true;
}

◆ isClosed()

bool SkContourMeasure::isClosed ( ) const

inline

Return true if the contour is closed()

Definition at line 58 of file SkContourMeasure.h.

58{ return fIsClosed; }

◆ length()

SkScalar SkContourMeasure::length ( ) const

inline

Return the length of the contour.

Definition at line 26 of file SkContourMeasure.h.

26{ return fLength; }

Friends And Related Function Documentation

◆ SkContourMeasureIter

friend class SkContourMeasureIter

friend

Definition at line 92 of file SkContourMeasure.h.

◆ SkPathMeasurePriv

friend class SkPathMeasurePriv