Compartir a través de

Método ID2D1Geometry::Outline(constD2D1_MATRIX_3X2_F*,FLOAT,ID2D1SimplifiedGeometrySink*) (d2d1.h)

  • Artículo

Calcula el esquema de la geometría y escribe el resultado en un ID2D1SimplifiedGeometrySink.

Sintaxis

HRESULT Outline(
  [in, optional] const D2D1_MATRIX_3X2_F     *worldTransform,
                 FLOAT                       flatteningTolerance,
  [in]           ID2D1SimplifiedGeometrySink *geometrySink
);

Parámetros

[in, optional] worldTransform

Tipo: const D2D1_MATRIX_3X2_F*

Transformación que se va a aplicar al esquema de geometría o NULL.

flatteningTolerance

Tipo: FLOAT

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.

[in] geometrySink

Tipo: ID2D1SimplifiedGeometrySink*

Id2D1SimplifiedGeometrySink al que se anexa el contorno transformado de la geometría.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El método Outline permite al autor de la llamada generar una geometría con un relleno equivalente a la geometría de entrada, con las siguientes propiedades adicionales:

  • La geometría de salida no contiene intersecciones transversales; es decir, los segmentos pueden tocar, pero nunca cruzan.
  • Las figuras más externas de la geometría de salida están orientadas a las agujas del reloj.
  • La geometría de salida es invariable en modo de relleno; es decir, el relleno de la geometría no depende de la elección del modo de relleno.

    Para obtener más información sobre el modo de relleno, consulte D2D1_FILL_MODE.

Además, el método Outline puede ser útil para quitar partes redundantes de dichas geometrías para simplificar geometrías complejas. También puede ser útil en combinación con ID2D1GeometryGroup para crear uniones entre varias geometrías simultáneamente.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1.h
Library D2d1.lib
Archivo DLL D2d1.dll

Consulte también

ID2D1Geometry