CompositionSettings
public class CompositionSettings
Composition settings for dual concurrent camera. It includes alpha value for blending, offset in x, y coordinates, scale of width and height, and styling options like rounded corners and borders. The offset, and scale of width and height are specified in normalized device coordinates(NDCs). The offset is applied after scale. The origin of normalized device coordinates is at the center of the viewing volume. The positive X-axis extends to the right, the positive Y-axis extends upwards.The x, y values range from -1 to 1. E.g. scale with (0.5f, 0.5f) and offset with (0.5f, 0.5f) is the bottom-right quadrant of the output device.
Styling options like rounded corner ratio and border width ratio are normalized from 0 to 1, where a ratio of 1 is relative to half of the smaller dimension of the frame.
Composited dual camera frames preview and recording can be supported using CompositionSettings and SingleCameraConfig. The z-order of composition is determined by the order of camera configs to bind. Currently the background color will be black by default. The resolution of camera frames for preview and recording will be determined by resolution selection strategy configured for each use case and the scale of width and height set in CompositionSettings, so it is recommended to use 16:9 aspect ratio strategy for preview if 16:9 quality selector is configured for video capture. The mirroring and rotation of the camera frame will be applied after composition because both cameras are using the same use cases.
The following code snippet demonstrates how to display in Picture-in-Picture mode:
16 -------------------------------- | c0 | | | | | | | | --------- | 9 | | | | | | c1 | | | | | | | --------- | -------------------------------- c0: primary camera c1: secondary cameraResolutionSelector resolutionSelector = new ResolutionSelector.Builder() .setAspectRatioStrategy( AspectRatioStrategy.RATIO_16_9_FALLBACK_AUTO_STRATEGY) .build(); Preview preview = new Preview.Builder() .setResolutionSelector(resolutionSelector) .build(); preview.setSurfaceProvider(mSinglePreviewView.getSurfaceProvider()); UseCaseGroup useCaseGroup = new UseCaseGroup.Builder() .addUseCase(preview) .addUseCase(mVideoCapture) .build(); SingleCameraConfig primary = new SingleCameraConfig( cameraSelectorPrimary, useCaseGroup, new CompositionSettings.Builder() .setAlpha(1.0f) .setOffset(0.0f, 0.0f) .setScale(1.0f, 1.0f) .build(), lifecycleOwner); SingleCameraConfig secondary = new SingleCameraConfig( cameraSelectorSecondary, useCaseGroup, new CompositionSettings.Builder() .setAlpha(1.0f) .setOffset(-0.3f, -0.4f) .setScale(0.3f, 0.3f) .build(), lifecycleOwner); cameraProvider.bindToLifecycle(ImmutableList.of(primary, secondary));
Summary
Nested types |
|---|
public final class CompositionSettings.BuilderA builder for |
Constants |
|
|---|---|
static final CompositionSettings |
Default composition settings, which will display in full screen with no offset and scale. |
Public methods |
|
|---|---|
float |
getAlpha()Gets the alpha. |
@ColorInt int |
Gets the border color. |
@FloatRange(from = 0, to = 1) float |
Gets the border width as a normalized ratio from 0 to 1. |
@NonNull Pair<Float, Float> |
Gets the offset. |
@FloatRange(from = 0, to = 1) float |
Gets the rounded corner ratio. |
@NonNull Pair<Float, Float> |
getScale()Gets the scale. |
@IntRange(from = 0) int |
Gets the z-order. |
Constants
DEFAULT
public static final CompositionSettings DEFAULT
Default composition settings, which will display in full screen with no offset and scale.
Public methods
getBorderColor
public @ColorInt int getBorderColor()
Gets the border color.
| Returns | |
|---|---|
@ColorInt int |
border color value. |
getBorderWidthRatio
public @FloatRange(from = 0, to = 1) float getBorderWidthRatio()
Gets the border width as a normalized ratio from 0 to 1.
0 means no border. 1 means the border width equals half of the smaller dimension of the frame, which causes the borders to meet at the center and fill the smaller dimension. The ratio is relative to half of the smaller dimension of the frame, consistent with getRoundedCornerRatio.
| Returns | |
|---|---|
@FloatRange(from = 0, to = 1) float |
border width ratio value. |
getRoundedCornerRatio
public @FloatRange(from = 0, to = 1) float getRoundedCornerRatio()
Gets the rounded corner ratio.
The value is normalized from 0 to 1. 0 means no rounding (sharp corners). 1 means fully rounded (the radius of the rounded corners equals half of the smaller dimension of the frame, making the frame a circle if it's square, or pill-shaped if it's rectangular).
| Returns | |
|---|---|
@FloatRange(from = 0, to = 1) float |
rounded corner ratio value. |
getScale
public @NonNull Pair<Float, Float> getScale()
Gets the scale. Negative value means mirroring in X or Y direction.
getZOrder
public @IntRange(from = 0) int getZOrder()
Gets the z-order.
| Returns | |
|---|---|
@IntRange(from = 0) int |
z-order value. |