Método ISpatialAudioObjectForHrtf::SetPosition (spatialaudiohrtf.h)
Establece la posición en el espacio 3D, en relación con el agente de escucha, desde el que se representarán los datos de audio ISpatialAudioObjectForHrtf .
Sintaxis
HRESULT SetPosition(
[in] float x,
[in] float y,
[in] float z
);
Parámetros
[in] x
Posición x del objeto de audio, en metros, con respecto al agente de escucha. Los valores positivos están a la derecha del agente de escucha y los valores negativos están a la izquierda.
[in] y
Posición y del objeto de audio, en metros, en relación con el agente de escucha. Los valores positivos están por encima del agente de escucha y los valores negativos se encuentran a continuación.
[in] z
Posición z del objeto de audio, en metros, con respecto al agente de escucha. Los valores positivos están detrás del agente de escucha y los valores negativos están delante.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
No se llamó a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects antes de la llamada a SetPosition. |
|
Se llamó a SetEndOfStream de forma explícita o implícita en un paso de procesamiento de audio anterior. El sistema llama implícitamente a SetEndOfStream si no se llama a GetBuffer dentro de un paso de procesamiento de audio (entre llamadas a ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects e ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects). |
|
ISpatialAudioObjectForHrtf no es de tipo AudioObjectType_Dynamic. Establezca el tipo del objeto de audio con el parámetro type en el método ISpatialAudioObjectRenderStreamBase::ActivateSpatialAudioObjectForHrtf . |
Comentarios
Solo se puede llamar a este método en un ISpatialAudioObjectForHrtf de tipo AudioObjectType_Dynamic. Establezca el tipo del objeto de audio con el parámetro type en el método ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf .
Los valores de posición usan un sistema de coordenadas cartesiano a la derecha, donde cada unidad representa 1 metro. El sistema de coordenadas es relativo al agente de escucha donde el origen (x=0.0, y=0.0, z=0.0) representa el punto central entre los oídos del agente de escucha.
Si nunca se llama a SetPosition , el origen (x=0.0, y=0.0, z=0.0) se usa como posición predeterminada. Después de llamar a SetPosition , la posición establecida se usará para el objeto de audio hasta que se cambie la posición con otra llamada a SetPosition.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | spatialaudiohrtf.h |