omni::proj::Tuning Class Reference

A projector tuning holds adjustment and distorsion data for a single projector and screen A tuning consists of a projector, warp grid, blend mask and color correction. It holds a color as well. It can render a projector calibration. More...

#include <Tuning.h>

Collaboration diagram for omni::proj::Tuning:

Public Types
typedef omni::visual::Tuning	visualizer_type

Public Member Functions
	Tuning (Session const &)
	Constructor. More...
void	assignVirtualScreen ()
	Assign virtual screen to tuning. More...
void	setScreen (QScreen const *_screen, int _subScreenIndex)
	Set screen for this tuning. More...
QScreen const *	screen () const
int	subScreenIndex () const
Projector &	projector ()
Projector const &	projector () const
WarpGrid &	warpGrid ()
	Returns reference to warp grid. More...
WarpGrid const &	warpGrid () const
	Returns reference to warp grid (const version) More...
BlendMask &	blendMask ()
	Returns reference to blend mask. More...
BlendMask const &	blendMask () const
	Returns reference to blend mask (const version) More...
PatchList &	patches ()
	Return list of patches. More...
PatchList const &	patches () const
	Return list of patches (const version) More...
ColorCorrection &	colorCorrection ()
	Color correction for projector. More...
ColorCorrection const &	colorCorrection () const
	Color correction for projector (const) More...
QColor	color () const
	Returns color for mapping. More...
void	setColor (QColor const &)
	Sets color for mapping. More...
visualizer_type *	visualizer ()
	Return pointer to visualizer. More...
visualizer_type const *	visualizer () const
	Return pointer to visualizer (const version) More...
visualizer_type *	makeVisualizer ()
	Make visualizer if it is not instantiated yet. More...
bool	hasScreen () const
	Return if a screen is associated with mapping. More...
void	renderCalibration (Calibration &_calib) const
	Render calibration. More...
QRect	screenGeometry () const
	Rectangle of the output screen on desktop. More...
QRect	contentGeometry () const
	Content rectangle (position) inside the screen. More...
Calibration	renderCalibration (CalibrationMode=CalibrationMode::TEXCOORDS) const
	Render and return calibration. More...
int	width () const
	Returns width of screen. More...
int	height () const
	Returns height of screen. More...
bool	outputDisabled () const
	Return flag if output is disabled, projector output is black. More...
bool	outputEnabled () const
	Return flag if output is enabled. More...
void	setOutputDisabled (bool _disabled=true)
	Disable output if _disabled is true, enable otherwise. More...
void	setOutputEnabled (bool _enabled=true)
	Enable output if _enabled is true, disable otherwise. More...
float	overlapOpacity () const
	Return opacity of overlapped blend mask. More...
void	setOverlapOpacity (float)
	Set opacity of overlap mask in blend mode. More...
void	toStream (QDataStream &) const
	Write tuning to stream. More...
void	fromStream (QDataStream &)
	Read tuning from stream. More...
Session const &	session () const
	Return const reference to owning session. More...
int	id () const
	Return id of tuning. More...

Private Attributes
bool	outputDisabled_ = false
bool	overlapOpacity_ = 0.0
QColor	color_
Projector	projector_
QScreen const *	screen_ = nullptr
	Screen this tuning is assigned to. If screen is nullptr, tuning is assigned to virtual screen. More...
int	subScreenIndex_ = 0
	SubScreen index of this tuning. More...
WarpGrid	warpGrid_
BlendMask	blendMask_
ColorCorrection	colorCorrection_
std::unique_ptr< visualizer_type >	viz_
PatchList	patches_
Session const &	session_

Friends
bool	operator== (Tuning const &, Tuning const &)
	Test for equality. More...

Detailed Description

A projector tuning holds adjustment and distorsion data for a single projector and screen A tuning consists of a projector, warp grid, blend mask and color correction. It holds a color as well. It can render a projector calibration.

Member Typedef Documentation

typedef omni::visual::Tuning omni::proj::Tuning::visualizer_type

Constructor & Destructor Documentation

omni::proj::Tuning::Tuning

(

Session const &

_session

)

Constructor.

                                              :
            color_("#FFFFFF"),
            blendMask_(*this),
            session_(_session)
        {
        }

Member Function Documentation

void omni::proj::Tuning::assignVirtualScreen

(

)

Assign virtual screen to tuning.

                                         {
          setScreen(nullptr,0);
        }

BlendMask & omni::proj::Tuning::blendMask

(

)

Returns reference to blend mask.

        {
            return blendMask_;
        }

BlendMask const & omni::proj::Tuning::blendMask

(

)

const

Returns reference to blend mask (const version)

        {
            return blendMask_;
        }

QColor omni::proj::Tuning::color

(

)

const

Returns color for mapping.

        {
            return color_;
        }

ColorCorrection & omni::proj::Tuning::colorCorrection

(

)

Color correction for projector.

                                                 {
            return colorCorrection_;
        }

ColorCorrection const & omni::proj::Tuning::colorCorrection

(

)

const

Color correction for projector (const)

                                                             {
            return colorCorrection_;
        }

QRect omni::proj::Tuning::contentGeometry

(

)

const

Content rectangle (position) inside the screen.

                                            {
          QRect _screenRect(screenGeometry());
          int _w = session_.screenSetup().subScreenWidth(screen());

          QRect _contentRect(_w * subScreenIndex(),0,_w,_screenRect.height());
          return _contentRect;
        }

void omni::proj::Tuning::fromStream

(

QDataStream &

_is

)

Read tuning from stream.

Reset visualizer

                                                {
            /// Reset visualizer
            viz_.reset();

            PropertyMap _map;
            _is >> _map;
            QRect _screenRect = _map.getValue<QRect>("screenGeometry");
            if (!_screenRect.isNull()) {
              screen_ = ScreenSetup::screenFromRect(_screenRect);
            }
            OMNI_DEBUG << _screenRect << screen_;

            _map.get("subScreenIndex", subScreenIndex_);
            _map.get("color",color_);
            _map.get("projector",projector_);
            _map.get("warpGrid",warpGrid_);
            _map.get("blendMask",blendMask_);
            _map.get("outputDisabled",outputDisabled_);
            _map.get("overlapOpacity",overlapOpacity_);
            _map.get("colorCorrection",colorCorrection_);
            _map.get("patches",patches_);
        }

bool omni::proj::Tuning::hasScreen

(

)

const

Return if a screen is associated with mapping.

        {
            return screen_ != nullptr;
        }

int omni::proj::Tuning::height

(

)

const

Returns height of screen.

        {
          return contentGeometry().height();
        }

int omni::proj::Tuning::id

(

)

const

Return id of tuning.

                             {
          int i = 0;
          for (auto& _tuning : session().tunings()) {
            if (_tuning.get() == this) return i;
            ++i;
          }
          return -1;
        }

Tuning::visualizer_type * omni::proj::Tuning::makeVisualizer

(

)

Make visualizer if it is not instantiated yet.

                                                      {
          if (!QOpenGLContext::currentContext()) return nullptr;

          if (!viz_) {
            viz_.reset(new visualizer_type(*this));
          }
          if (!viz_->initialized()) {
            viz_->update();
          }
          return visualizer();
        }

bool omni::proj::Tuning::outputDisabled

(

)

const

Return flag if output is disabled, projector output is black.

                                          {
            return outputDisabled_;
        }

bool omni::proj::Tuning::outputEnabled

(

)

const

Return flag if output is enabled.

                                         {
            return !outputDisabled();
        }

float omni::proj::Tuning::overlapOpacity

(

)

const

Return opacity of overlapped blend mask.

                                           {
            return overlapOpacity_;
        }

PatchList & omni::proj::Tuning::patches

(

)

Return list of patches.

                                               {
          return patches_;
        }

PatchList const & omni::proj::Tuning::patches

(

)

const

Return list of patches (const version)

                                                     {
          return patches_;
        }

Projector & omni::proj::Tuning::projector

(

)

        {
            return projector_;
        }

Projector const & omni::proj::Tuning::projector

(

)

const

        {
            return projector_;
        }

void omni::proj::Tuning::renderCalibration

(

Calibration &

_calib

)

const

Render calibration.

              {
          _calib.render(*this,session_.exportSettings().outputMode());
        }

Calibration omni::proj::Tuning::renderCalibration

(

CalibrationMode

_outputMode = CalibrationMode::TEXCOORDS

)

const

Render and return calibration.

                                             {
            return Calibration(*this,_outputMode);
        }

QScreen const * omni::proj::Tuning::screen

(

)

const

        {
            return screen_;
        }

QRect omni::proj::Tuning::screenGeometry

(

)

const

Rectangle of the output screen on desktop.

                                           {
          return session_.screenSetup().screenGeometry(screen());
        }

Session const & omni::proj::Tuning::session

(

)

const

Return const reference to owning session.

                                             {
          return session_;
        }

void omni::proj::Tuning::setColor

(

QColor const &

_color

)

Sets color for mapping.

        {
            color_ = _color;
        }

void omni::proj::Tuning::setOutputDisabled

(

bool

_disabled = true

)

Disable output if _disabled is true, enable otherwise.

                                                     {
            outputDisabled_ = _disabled;
        }

void omni::proj::Tuning::setOutputEnabled

(

bool

_enabled = true

)

Enable output if _enabled is true, disable otherwise.

                                                   {
            setOutputDisabled(!_enabled);
        }

void omni::proj::Tuning::setOverlapOpacity

(

float

_overlapOpacity

)

Set opacity of overlap mask in blend mode.

                                                            {
            overlapOpacity_ = _overlapOpacity;
        }

void omni::proj::Tuning::setScreen	(	QScreen const *	_screen,
		int	_subScreenIndex
	)

Set screen for this tuning.

        {
          screen_ = _screen;
          subScreenIndex_ = _subScreenIndex;
          projector_.setAspectRatio(session_.screenSetup().subScreenAspectRatio(screen()));
          blendMask_.setBrush(100.0,blendMask_.brush().feather(),blendMask_.brush().opacity(),blendMask_.brush().invert());
        }

int omni::proj::Tuning::subScreenIndex

(

)

const

        {
          if (!screen_) {
            // Calculate subscreen index by iterating tuning
            int _index = 0;
            for (auto& _tuning : session_.tunings()) {
              if (_tuning->hasScreen()) continue;
              if (_tuning.get() == this) return _index;
              ++_index;
            }
            return 0;
          }
          return subScreenIndex_;
        }

void omni::proj::Tuning::toStream

(

QDataStream &

_os

)

const

Write tuning to stream.

                                                    {
            PropertyMap _map;
            _map("color",color_)
                ("projector",projector_)
                ("warpGrid",warpGrid_)
                ("blendMask",blendMask_)
                ("outputDisabled",outputDisabled_)
                ("overlapOpacity",overlapOpacity_)
                ("colorCorrection",colorCorrection_)
                ("patches",patches_)
                ;

            _map("screenGeometry", screenGeometry());
            _map("contentGeometry", contentGeometry());
            _map("subScreenIndex", subScreenIndex_);
            _os << _map;
        }

Tuning::visualizer_type * omni::proj::Tuning::visualizer

(

)

Return pointer to visualizer.

                                                  {
          return viz_.get();
        }

Tuning::visualizer_type const * omni::proj::Tuning::visualizer

(

)

const

Return pointer to visualizer (const version)

                                                              {
          return viz_.get();
        }

WarpGrid & omni::proj::Tuning::warpGrid

(

)

Returns reference to warp grid.

        {
            return warpGrid_;
        }

WarpGrid const & omni::proj::Tuning::warpGrid

(

)

const

Returns reference to warp grid (const version)

        {
            return warpGrid_;
        }

int omni::proj::Tuning::width

(

)

const

Returns width of screen.

        {
          return contentGeometry().width();
        }

Friends And Related Function Documentation

bool operator== ( Tuning const &  _lhs, Tuning const &  _rhs  )

friend

Test for equality.

        {
            return
                OMNI_TEST_MEMBER_EQUAL(color_) &&
                OMNI_TEST_MEMBER_EQUAL(projector_) &&
                OMNI_TEST_MEMBER_EQUAL(warpGrid_) &&
                OMNI_TEST_MEMBER_EQUAL(blendMask_) &&
                OMNI_TEST_MEMBER_EQUAL(outputDisabled_) &&
                OMNI_TEST_MEMBER_EQUAL(overlapOpacity_) &&
                OMNI_TEST_MEMBER_EQUAL(colorCorrection_);
        }

Field Documentation

BlendMask omni::proj::Tuning::blendMask_

private

QColor omni::proj::Tuning::color_

private

ColorCorrection omni::proj::Tuning::colorCorrection_

private

bool omni::proj::Tuning::outputDisabled_ = false

private

bool omni::proj::Tuning::overlapOpacity_ = 0.0

private

PatchList omni::proj::Tuning::patches_

private

Projector omni::proj::Tuning::projector_

private

QScreen const* omni::proj::Tuning::screen_ = nullptr

private

Screen this tuning is assigned to. If screen is nullptr, tuning is assigned to virtual screen.

Session const& omni::proj::Tuning::session_

private

int omni::proj::Tuning::subScreenIndex_ = 0

private

SubScreen index of this tuning.

std::unique_ptr<visualizer_type> omni::proj::Tuning::viz_

private

WarpGrid omni::proj::Tuning::warpGrid_

private

---

The documentation for this class was generated from the following files:

• include/omni/proj/Tuning.h
• src/lib/proj/Tuning.cpp