view Framework/Viewport/IViewport.h @ 1213:86a8266b8888 broker

moving the scene from IViewport to ViewportController
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 04 Dec 2019 17:54:10 +0100
parents 00e6bff9ea39
children 9efa66d8d3f8
line wrap: on
line source

/**
 * Stone of Orthanc
 * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics
 * Department, University Hospital of Liege, Belgium
 * Copyright (C) 2017-2019 Osimis S.A., Belgium
 *
 * This program is free software: you can redistribute it and/or
 * modify it under the terms of the GNU Affero General Public License
 * as published by the Free Software Foundation, either version 3 of
 * the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 **/

#pragma once

#include "../Scene2D/ICompositor.h"
#include "../Scene2D/Scene2D.h"
#include "../Scene2D/ScenePoint2D.h"

namespace OrthancStone
{
  /**
   * Class that combines a Scene2D with a canvas where to draw the
   * scene. A call to "Refresh()" will update the content of the
   * canvas. A "IViewport" can possibly be accessed from several
   * threads depending on the rendering back-end (e.g. in SDL or Qt):
   * The "ILock" subclass implements the locking mechanism to modify
   * the content of the scene. 
   *
   * NB: The lock must be a "recursive_mutex", as the viewport
   * controller can lock it a second time (TODO - Why so?).
   **/  
  class IViewport : public boost::noncopyable
  {
  public:
    class ILock : public boost::noncopyable
    {
    public:
      virtual ~ILock()
      {
      }

      // Get the center of the given pixel, in canvas coordinates
      virtual ScenePoint2D GetPixelCenterCoordinates(int x, int y) = 0;

      virtual bool HasCompositor() const = 0;

      virtual ICompositor& GetCompositor() = 0;

      virtual void FitContent(Scene2D& scene) = 0;
    };   
    
    virtual ~IViewport()
    {
    }

    // Can be invoked from any thread (notably from the thread of the
    // Stone context)
    virtual void Invalidate() = 0;

    // Must be invoked from the main (GUI) thread
    virtual void Paint(const Scene2D& scene) = 0;

    virtual void UpdateSize(unsigned int width,
                            unsigned int height) = 0;

    virtual ILock* Lock() = 0;
  };
}