Método ID2D1SpriteBatch::SetSprites (d2d1_3.h)

Novedades las propiedades de los sprites especificados en este lote de sprite. Si se proporciona un valor NULL para cualquier propiedad, esa propiedad no se modificará para ese sprite.

Sintaxis

HRESULT SetSprites(
                 UINT32                  startIndex,
                 UINT32                  spriteCount,
  [in, optional] const D2D1_RECT_F       *destinationRectangles,
  [in, optional] const D2D1_RECT_U       *sourceRectangles,
  [in, optional] const D2D1_COLOR_F      *colors,
  [in, optional] const D2D1_MATRIX_3X2_F *transforms,
                 UINT32                  destinationRectanglesStride,
                 UINT32                  sourceRectanglesStride,
                 UINT32                  colorsStride,
                 UINT32                  transformsStride
);

Parámetros

startIndex

Tipo: UINT32

Índice del primer sprite de este lote de sprite que se va a actualizar.

spriteCount

Tipo: UINT32

Número de sprites que se van a actualizar con nuevas propiedades. Esto determina cuántos pasos se leerán en cada matriz determinada de Direct2D.

[in, optional] destinationRectangles

Tipo: const D2D1_RECT_F*

Puntero a una matriz que contiene los rectángulos de destino que especifican dónde dibujar los sprites en el contexto del dispositivo de destino.

[in, optional] sourceRectangles

Tipo: const D2D1_RECT_U*

Puntero a una matriz que contiene los rectángulos de origen que especifican las regiones del mapa de bits de origen que se van a dibujar como sprites.

Direct2D usará todo el mapa de bits de origen para sprites a los que se les asigna un valor NULL o InfiniteRectU. Si este parámetro se omite por completo o se establece en un valor NULL, Direct2D usará todo el mapa de bits de origen para todos los sprites actualizados.

[in, optional] colors

Tipo: const D2D1_COLOR_F*

Puntero a una matriz que contiene los colores que se van a aplicar a cada sprite. El color de salida es el resultado de la multiplicación por componentes del color del mapa de bits de origen y el color proporcionado. El color de salida no está sujeta.

Direct2D no cambiará el color de los sprites asignados a un valor NULL. Si este parámetro se omite por completo o se establece en un valor NULL, Direct2D no cambiará el color de ninguno de los sprites actualizados.

[in, optional] transforms

Tipo: const D2D1_MATRIX_3X2_F*

Puntero a una matriz que contiene las transformaciones que se van a aplicar al rectángulo de destino de cada sprite.

Direct2D no transformará el rectángulo de destino de ningún sprite que tenga asignado un valor NULL. Si este parámetro se omite por completo o se establece en un valor NULL, Direct2D no transformará el rectángulo de destino de ninguno de los sprites actualizados.

destinationRectanglesStride

Tipo: UINT32

Especifica la distancia, en bytes, entre cada rectángulo de la matriz destinationRectangles. Si proporciona un intervalo de 0, se usará el mismo rectángulo de destino para cada sprite actualizado.

sourceRectanglesStride

Tipo: UINT32

Especifica la distancia, en bytes, entre cada rectángulo de la matriz sourceRectangles (si se especifica esa matriz). Si proporciona un intervalo de 0, se usará el mismo rectángulo de origen para cada sprite actualizado.

colorsStride

Tipo: UINT32

Especifica la distancia, en bytes, entre cada color de la matriz colors (si se especifica esa matriz). Si proporciona un intervalo de 0, se usará el mismo color para cada sprite actualizado.

transformsStride

Tipo: UINT32

Especifica la distancia, en bytes, entre cada transformación de la matriz de transformaciones (si se especifica esa matriz). Si proporciona un intervalo de 0, se usará la misma transformación para cada sprite actualizado.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se realiza correctamente. Devuelve E_INVALIDARG si se pasó un valor no válido al método . En este caso, esta llamada a SetSprites no modifica ningún sprites.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d2d1_3.h
Library	D2d1.lib
Archivo DLL	D2d1.dll

Consulte también

ID2D1SpriteBatch