GLFrameViewController.h

Go to the documentation of this file.

/*
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */
 
#ifndef META_OCEAN_PLATFORM_APPLE_IOS_GL_FRAME_VIEW_CONTROLLER_H
#define META_OCEAN_PLATFORM_APPLE_IOS_GL_FRAME_VIEW_CONTROLLER_H
 
#include "ocean/platform/apple/ios/IOS.h"
#include "ocean/platform/apple/ios/GLRendererViewController.h"
 
#include "ocean/math/Line3.h"
#include "ocean/math/Quaternion.h"
 
#include "ocean/media/FrameMedium.h"
 
#include "ocean/rendering/UndistortedBackground.h"
 
#ifndef __OBJC__
    #error Platform::Apple::IOS::GLFrameViewController.h needs to be included from an ObjectiveC++ file
#endif
 
/**
 * The GLFrameViewController implements a view controller that is mainly able to display medium objects.
 * The view controller is derived from an OpenGLES view controller so that we can ensure the best performance possible.
 * @see Apple::MacOS::FrameMediumView.
 * @ingroup platformappleios
 */
@interface GLFrameViewController : GLRendererViewController
 
/**
 * Sets or changes the frame medium to be displayed.
 * @param frameMedium The frame medium to be displayed, must be valid
 */
-(void)setFrameMedium:(const Ocean::Media::FrameMediumRef&)frameMedium;
 
/**
 * Sets or changes the frame medium to be displayed.
 * @param frameMedium The frame medium to be displayed, must be valid
 * @param adjustFov True, to adjust the view's field of view to the medium's field of view; False, to keep the view's field of view as is
 */
-(void)setFrameMedium:(const Ocean::Media::FrameMediumRef&)frameMedium andAdjustFov:(bool)adjustFov;
 
/**
 * Sets or changes the frame medium to be displayed.
 * @param frameMedium The frame medium to be displayed, must be valid
 * @param display_R_medium Explicit rotation between medium and display, and invalid rotation to use the medium's and framebuffer's transformations to determine the rotation
 */
-(void)setFrameMedium:(const Ocean::Media::FrameMediumRef&)frameMedium withRotation:(const Ocean::Quaternion&)display_R_medium;
 
/**
 * Sets or changes the frame medium to be displayed.
 * @param frameMedium The frame medium to be displayed, must be valid
 * @param display_R_medium Explicit rotation between medium and display, and invalid rotation to use the medium's and framebuffer's transformations to determine the rotation
 * @param adjustFov True, to adjust the view's field of view to the medium's field of view; False, to keep the view's field of view as is
 */
-(void)setFrameMedium:(const Ocean::Media::FrameMediumRef&)frameMedium withRotation:(const Ocean::Quaternion&)display_R_medium andAdjustFov:(bool)adjustFov;
 
/**
 * Returns the current frame medium.
 * @return The frame medium which is currently displayed
 */
-(Ocean::Media::FrameMediumRef)frameMedium;
 
/**
 * Converts a 2D location defined in the view's coordinate system to a location defined in the coordinate system of the medium (an image frame).
 * @param viewPoint The 2D location within this view
 * @return The corresponding 2D location within the image frame of the medium, a negative coordinate (-1, -1), in case no valid mapping exists
 */
-(CGPoint)view2medium:(CGPoint)viewPoint;
 
@end
 
@interface GLFrameViewController ()
{
    @protected
 
        /// The undistorted background.
        Ocean::Rendering::UndistortedBackgroundRef renderingUndistortedBackground_;
 
        /// The frame medium of the background which is stored as long as the view hasn't been initialized.
        Ocean::Media::FrameMediumRef intermediateBackgroundFrameMedium_;
 
        /// True, to adjust the field of view of the view automatically so that the background medium is entirely covered.
        bool intermediateBackgroundAdjustFov_;
 
        /// State determining that the view's field of view has to be adjusted to the background's field of view.
        bool adjustFovXToBackground_;
}
 
@end
 
#endif // META_OCEAN_PLATFORM_APPLE_IOS_GL_FRAME_VIEW_CONTROLLER_H