From 7dc0543f4c85f74b44a87da7ab738dfb6598cf26 Mon Sep 17 00:00:00 2001 From: Jason Date: Wed, 24 Apr 2024 14:03:49 -0700 Subject: [PATCH] Refine player configuration extension comment (#3056) b/311035005 (cherry picked from commit eb43364ac08b080ede065aca1a07c5f459017cea) --- starboard/extension/player_configuration.h | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/starboard/extension/player_configuration.h b/starboard/extension/player_configuration.h index c041c2c53692..3770196b81e7 100644 --- a/starboard/extension/player_configuration.h +++ b/starboard/extension/player_configuration.h @@ -32,14 +32,17 @@ typedef struct StarboardExtensionPlayerConfigurationApi { // The fields below this point were added in version 1 or later. - // This is used to ask the underlying starboard player using decode - // to texture mode to render video frames when it's available, no matter - // what output mode is passed in SbPlayerCreate(). This function can be - // null. + // This is used to ask the underlying starboard player prefer to use decode + // to texture mode to render video frames when it's available. This function + // can be null. + // When decode to texture mode is prefereed, SbPlayerGetPreferredOutputMode() + // should return kSbPlayerOutputModeDecodeToTexture if it's supported. void (*SetDecodeToTexturePreferred)(bool preferred); - // This is used to ask the underlying starboard player using tunnel mode - // when it's available. This function can be null. + // This is used to ask the underlying starboard player prefer to use tunnel + // mode when it's available. This function can be null. + // When tunnel mode is prefereed, the platform should use tunnel mode for + // primary player if it's supported. void (*SetTunnelModePreferred)(bool preferred); } StarboardExtensionPlayerConfigurationApi;