152 lines
4.5 KiB
Java
152 lines
4.5 KiB
Java
/*
|
|
* Copyright (C) 2014 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package android.hardware.camera2.params;
|
|
|
|
import static com.android.internal.util.Preconditions.*;
|
|
import static android.hardware.camera2.params.StreamConfigurationMap.checkArgumentFormatInternal;
|
|
|
|
import android.graphics.ImageFormat;
|
|
import android.hardware.camera2.CameraCharacteristics;
|
|
import android.hardware.camera2.utils.HashCodeHelpers;
|
|
import android.graphics.PixelFormat;
|
|
import android.util.Size;
|
|
|
|
/**
|
|
* Immutable class to store a time duration for any given format/size combination.
|
|
*
|
|
* @see CameraCharacteristics#SCALER_AVAILABLE_STREAM_CONFIGURATIONS
|
|
* @see CameraCharacteristics#SCALER_AVAILABLE_MIN_FRAME_DURATIONS
|
|
* @see CameraCharacteristics#SCALER_AVAILABLE_STALL_DURATIONS
|
|
*
|
|
* @hide
|
|
*/
|
|
public final class StreamConfigurationDuration {
|
|
|
|
/**
|
|
* Create a new {@link StreamConfigurationDuration}.
|
|
*
|
|
* @param format image format
|
|
* @param width image width, in pixels (positive)
|
|
* @param height image height, in pixels (positive)
|
|
* @param durationNs duration in nanoseconds (non-negative)
|
|
*
|
|
* @throws IllegalArgumentException
|
|
* if width/height were not positive, or durationNs was negative
|
|
* or if the format was not user-defined in ImageFormat/PixelFormat
|
|
* (IMPL_DEFINED is OK)
|
|
*
|
|
*
|
|
* @hide
|
|
*/
|
|
public StreamConfigurationDuration(
|
|
final int format, final int width, final int height, final long durationNs) {
|
|
mFormat = checkArgumentFormatInternal(format);
|
|
mWidth = checkArgumentPositive(width, "width must be positive");
|
|
mHeight = checkArgumentPositive(height, "height must be positive");
|
|
mDurationNs = checkArgumentNonnegative(durationNs, "durationNs must be non-negative");
|
|
}
|
|
|
|
/**
|
|
* Get the internal image {@code format} in this stream configuration duration
|
|
*
|
|
* @return an integer format
|
|
*
|
|
* @see ImageFormat
|
|
* @see PixelFormat
|
|
*/
|
|
public final int getFormat() {
|
|
return mFormat;
|
|
}
|
|
|
|
|
|
/**
|
|
* Return the width of the stream configuration duration.
|
|
*
|
|
* @return width > 0
|
|
*/
|
|
public int getWidth() {
|
|
return mWidth;
|
|
}
|
|
|
|
/**
|
|
* Return the height of the stream configuration duration
|
|
*
|
|
* @return height > 0
|
|
*/
|
|
public int getHeight() {
|
|
return mHeight;
|
|
}
|
|
|
|
/**
|
|
* Convenience method to return the size of this stream configuration duration.
|
|
*
|
|
* @return a Size with positive width and height
|
|
*/
|
|
public Size getSize() {
|
|
return new Size(mWidth, mHeight);
|
|
}
|
|
|
|
/**
|
|
* Get the time duration (in nanoseconds).
|
|
*
|
|
* @return long >= 0
|
|
*/
|
|
public long getDuration() {
|
|
return mDurationNs;
|
|
}
|
|
|
|
/**
|
|
* Check if this {@link StreamConfigurationDuration} is equal to another
|
|
* {@link StreamConfigurationDuration}.
|
|
*
|
|
* <p>Two vectors are only equal if and only if each of the respective elements is equal.</p>
|
|
*
|
|
* @return {@code true} if the objects were equal, {@code false} otherwise
|
|
*/
|
|
@Override
|
|
public boolean equals(final Object obj) {
|
|
if (obj == null) {
|
|
return false;
|
|
}
|
|
if (this == obj) {
|
|
return true;
|
|
}
|
|
if (obj instanceof StreamConfigurationDuration) {
|
|
final StreamConfigurationDuration other = (StreamConfigurationDuration) obj;
|
|
return mFormat == other.mFormat &&
|
|
mWidth == other.mWidth &&
|
|
mHeight == other.mHeight &&
|
|
mDurationNs == other.mDurationNs;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
@Override
|
|
public int hashCode() {
|
|
return HashCodeHelpers.hashCode(mFormat, mWidth, mHeight,
|
|
(int) mDurationNs, (int)(mDurationNs >>> Integer.SIZE));
|
|
}
|
|
|
|
private final int mFormat;
|
|
private final int mWidth;
|
|
private final int mHeight;
|
|
private final long mDurationNs;
|
|
}
|