On Mon, Nov 7, 2016 at 4:14 PM, Vittorio Giovara
<vittorio.giov...@gmail.com> wrote:
> While no decoder currently exports spherical information, this type
> represents a frame property that has to be passed through from container
> to frames.
>
> Signed-off-by: Vittorio Giovara <vittorio.giov...@gmail.com>
> ---
> +/**
> + * This structure describes how to handle spherical videos, outlining
> + * information about projection, initial layout, and any other view modifier.
> + *
> + * @note The struct must be allocated with av_spherical_alloc() and
> + *       its size is not a part of the public ABI.
> + */
> +typedef struct AVSphericalMapping {
> +    /**
> +     * Projection type.
> +     */
> +    enum AVSphericalProjection projection;
> +
> +    /* @defgroup orientation
> +     * @{
> +     * Pose values measuring rotation in degrees to be applied to the
> +     * projection. The transform order should be yaw, pitch, and roll.
> +     */
> +
> +    double yaw;   ///< Clockwise around the up vector [-180, 180].
> +    double pitch; ///< Counter-clockwise around the right vector [-90, 90].
> +    double roll;  ///< Counter-clockwise around the forward vector [-180, 
> 180].
> +
> +    /**
> +     * @}
> +     */
> +
> +    /**
> +     * @defgroup bounds
> +     * @{
> +     * Amount of pixels to crop the edge of the video surface.
> +     * @note for cubemap projections these values apply to each face.
> +     */
> +
> +    unsigned int left_off;   ///< Pixels to crop from the left.
> +    unsigned int top_off;    ///< Pixels to crop from the top.
> +    unsigned int right_off;  ///< Pixels to crop from the right.
> +    unsigned int bottom_off; ///< Pixels to crop from the bottom.
> +
> +    /**
> +     * @}
> +     */
> +} AVSphericalMapping;
> +

by the way, i'm pretty sure doxygen doesn't do what i mean here, any
ideas how to improve docs format?
-- 
Vittorio
_______________________________________________
libav-devel mailing list
libav-devel@libav.org
https://lists.libav.org/mailman/listinfo/libav-devel

Reply via email to