ID2D1PathGeometry1::ComputePointAndSegmentAtLength(FLOAT,UINT32,constD2D1_MATRIX_3X2_F&,FLOAT,D2D1_POINT_DESCRIPTION*) (d2d1_1.h)

Calcula el punto que existe a una distancia determinada a lo largo de la geometría de la ruta de acceso junto con el índice del segmento en el que se encuentra el punto y el vector direccional en ese punto.

Sintaxis

HRESULT ComputePointAndSegmentAtLength(
        FLOAT                     length,
        UINT32                    startSegment,
  [ref] const D2D1_MATRIX_3X2_F & worldTransform,
        FLOAT                     flatteningTolerance,
  [out] D2D1_POINT_DESCRIPTION    *pointDescription
);

Parámetros

length

Tipo: FLOAT

Distancia a lo largo del camino.

startSegment

Tipo: UINT32

Índice del segmento en el que se va a empezar a caminar. Nota: Este índice es global para toda la ruta de acceso, no solo una figura determinada.

[ref] worldTransform

Tipo: const D2D1_MATRIX_3X2_F

Transformación que se va a aplicar al camino antes de caminar.

flatteningTolerance

Tipo: FLOAT

Tolerancia de aplanamiento que se va a usar al caminar por un arco o segmento Bezier. La tolerancia de aplanamiento es el error máximo permitido al construir una aproximación poligonal de la geometría. Ningún punto de la representación poligonal diverge de la geometría original por más que la tolerancia de aplanamiento. Los valores menores generan resultados más precisos pero hacen que la ejecución sea más lenta.

[out] pointDescription

Tipo: D2D1_POINT_DESCRIPTION*

Cuando este método devuelve, contiene una descripción del punto que se puede encontrar en la ubicación especificada.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

HRESULT	Descripción
S_OK	No se ha producido ningún error.
E_OUTOFMEMORY	Direct2D no pudo asignar memoria suficiente para completar la llamada.
E_INVALIDARG	Una de las entradas estaba en un intervalo no válido.

Requisitos

Plataforma de destino	Windows
Encabezado	d2d1_1.h (incluya D2d1_1.h)
Library	D2d1_3.lib
Archivo DLL	D2d1_3.dll

Consulte también

ID2D1PathGeometry1