ImageView Class Reference

Image viewer with optional text and geometry overlay functionality. More...

#include <ImageView.h>

Inherits QWidget.

Public Types
enum	TextLocation { TOPLEFT, TOPRIGHT, BOTTOMLEFT, BOTTOMRIGHT }
	Text overlay alignment specification. More...

Public Slots
const QColor &	getBackgroundColor () const
void	setBackgroundColor (const QColor &color)
bool	useProgressIndicator ()
void	setUseProgressIndicator (bool use)
bool	useSmoothTransformation ()
void	setSmoothTransformation (bool smooth)
const int	getProgressIndicatorTimeout () const
void	setProgressIndicatorTimeout (int timeout)
void	setInvertColor (bool invert)
bool	getInvertColor ()

Signals
void	clickedImage (const QPoint &point)
	Mouse click coordinates in image. More...

Public Member Functions
	ImageView (QWidget *parent=0)
virtual	~ImageView ()
QSize	sizeHint () const
void	setRgbSwapped (bool swapped)
bool	getRgbSwapped ()
void	addCircle (QPointF &center, double radius, QColor &color, int width, bool persistent=0)
	Draws circle overlay. More...
void	addLine (QLineF &line, QColor &color, int width, bool persistent=0)
	Draws line overlay. More...
void	addPolygon (QPolygonF &polygon, QColor &color, int width, bool persistent=0)
	Draws polygon overlay. More...
void	addPoints (const QList< int > points_x, QList< int > points_y, QColor &color, int width, bool persistent=0)
	Draws points overlay (2D point cloud). More...
void	addText (QString text, int location, QColor color=QColor(Qt::black), bool persistent=0)
	Draws text overlay. More...
void	clearOverlays (bool clear_persistent_items=0)
	Removes overlays. More...
void	rotate (int deg)
	Rotates image display. More...
void	saveImage (QString path=QString(), bool overlay=0)
	Saves current image to file. More...
void	setFrame (const base::samples::DistanceImage &frame)
	Frame input. More...
void	setFrame (const base::samples::frame::Frame &frame)
void	setImage (const QImage &image)
void	setRawImage (const QString &mode, int pixel_size, int width, int height, const char *pbuffer, const int size)
void	refresh ()
void	processImage ()
void	update2 ()
	Wrapper for QWidget::update(). This is due to some QtRuby limitations. More...
int	getHeight () const
	returns the real height of the underlaying widget More...
int	getWidth () const
	returns the real width of the underlaying widget More...

Protected Member Functions
void	resizeEvent (QResizeEvent *event)
void	contextMenuEvent (QContextMenuEvent *event)
bool	eventFilter (QObject *obj, QEvent *event)

Properties
QColor	backgroundColor
	The widget's background color. More...
bool	use_progress_indicator
	Display progress indicator widget if no frames have being received for a defined time. More...
int	progress_indicator_timeout
	The time without frame update in ms after which the progress indicator gets started. More...
bool	use_smooth_transformation
	Usage of antialiasing techniques during image transformation. More...
bool	rgb_swapped
bool	invert_color

Detailed Description

Image viewer with optional text and geometry overlay functionality.

ImageView is designed to display image frames, do minor transformation on the image or enhance it with several possible overlays. The image is always displayed completely while keeping its aspect ratio.

Transformation means resizing and rotation by 90 degree steps. The transformation is only applied to the displayed image and is not kept in saved (exported) images.

There are multiple overlay possibilities to choose from like simple geometric forms or text. Except for text overlays, every overlay is attatched to the image, i.e. any transformation the image might receive is going to be executed on the overlay as well. For example: The overlays are immune to image rotation or scaling. They simple get scaled and rotated as well. Text overlays, on the other hand, are considered as status information. They are attatched to the widget and do not care about image transformation. Nevertheless, they react to widget transformation, e.g. they keep their alignment to the assigned widget corner.

Overlays – image- or widget attatched – may be set persistent or volatile. Volatile overlays are being removed with the next frame update while persistent overlays stay until you remove them. Currently, you can only remove all (persistent) overlays at once.

It is planned to extend ImageView to work as GStreamer video sink in a future version.

Author

Allan Conquest (allan.conquest[at]dfki.de)

Definition at line 47 of file ImageView.h.

Member Enumeration Documentation

TextLocation

enum ImageView::TextLocation

Text overlay alignment specification.

The alignment is relative to the corners of the widget (not to the image!).

Enumerator
TOPLEFT
TOPRIGHT
BOTTOMLEFT
BOTTOMRIGHT

Definition at line 110 of file ImageView.h.

    {
        TOPLEFT,
        TOPRIGHT,
        BOTTOMLEFT,
        BOTTOMRIGHT
    };

Constructor & Destructor Documentation

ImageView()

ImageView::ImageView

(

QWidget *

parent = 0

)

Definition at line 24 of file ImageView.cc.

      : QWidget(parent),
        bgColor(QColor(Qt::black)),
        use_progress_indicator(true),
        use_smooth_transformation(true),
        progress_indicator_timeout(2500),
        rgb_swapped(false),
        invert_color(false),
        progress_indicator_timer(this),
        context_menu(this),
        rotate_image_clockwise_act(this),
        save_image_act(this),
        save_image_overlay_act(this),
        activate_progress_indicator_act(this),
        rgb_swapped_act(this),
        invert_color_act(this)
#ifdef USE_GST
        ,
        pipelineDescription("videotestsrc ! ximagesink"), //qtglvideosink
        use_gl(false)
#endif
{
    setWindowTitle("ImageView");
    setMinimumSize(220,170);
    setContentsMargins(0,0,0,0);
    
    imageItem = NULL;
    
    /* Configure progress indicator */
    progress_indicator.setAnimationDelay(40);
    progress_indicator.setDisplayedWhenStopped(false);
    progress_indicator.resize(30,30);
    progress_indicator.hide();
    
    /* Set up timer for progress indicator */
    progress_indicator_timer.setInterval(getProgressIndicatorTimeout());
    connect(&progress_indicator_timer, SIGNAL(timeout()), this, SLOT(startProgressIndicator()));
    
    setupContextMenu();
    
#ifdef USE_GST
    QGst::PipelinePtr pipeline;
    QGst::ElementPtr videoSrc;
        /* GStreamer setup */
        QGst::init();

//         pipeline = QGst::Parse::launch(pipelineDescription).dynamicCast<QGst::Pipeline>();
        pipeline = QGst::Pipeline::create("pipeline"); // Create hard coded pipeline for debugging
        videoSrc = QGst::ElementFactory::make("videotestsrc");
#endif

    /* Setup inner graphicsscene and view. This scene contains the image and image related overlays. */
    imageScene = new QGraphicsScene(this);
    imageScene->setBackgroundBrush(getBackgroundColor());
    imageScene->installEventFilter(this); // to get mouse press events to emit clicked image coordinate
    
    imageView = new QGraphicsView(imageScene); 
    imageView->setAlignment(Qt::AlignCenter);
    imageView->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    imageView->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    imageView->setFocusPolicy(Qt::NoFocus);
    imageView->setFrameStyle(QFrame::NoFrame);
    imageView->setContentsMargins(0,0,0,0);

#ifdef USE_GST
    if(use_gl) {
        // Indicator to use qtglvideosink (hardware rendering!) instead of qtvideosink
        imageView->setViewport(new QGLWidget); 
    }
    
    QGst::Ui::GraphicsVideoSurface *surface = NULL;
    QGst::Ui::GraphicsVideoWidget *widget = NULL;
    
    surface = new QGst::Ui::GraphicsVideoSurface(view); 
    widget = new QGst::Ui::GraphicsVideoWidget;
    widget->setSurface(surface);
    
    scene->addItem(widget);

    // Connect hard coded pipeline
    pipeline->add(videoSrc, surface->videoSink());
    videoSrc->link(surface->videoSink());
    
    LOG_INFO_S << "Video source name: " << surface->videoSink()->property("name").toString().toStdString();
    
    /* Try to start playing */
    if(!pipeline->setState(QGst::StatePlaying)) {
        // TODO proper fallback handling
        LOG_WARN("Could not play pipeline.");
    }
#else
    imageItem = new QGraphicsPixmapItem;
    
    setSmoothTransformation(use_smooth_transformation);
    
    imageScene->addItem(imageItem);
#endif
    
    /* Setup outer graphicsscene and view. This scene contains fixed overlays like the 
     * image timestamp which are immune to rotation etc. i.e. they stay at the same place
     * nevertheless the inner scene gets rotated or scaled.
     */
    fixedOverlayScene = new QGraphicsScene(this);
    fixedOverlayScene->setBackgroundBrush(Qt::transparent);
    
    fixedOverlayView = new QGraphicsView(fixedOverlayScene, this);
    fixedOverlayView->setAlignment(Qt::AlignCenter);
    fixedOverlayView->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    fixedOverlayView->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
    fixedOverlayView->setFocusPolicy(Qt::NoFocus);
    fixedOverlayView->setFrameStyle(QFrame::NoFrame);
    fixedOverlayView->setContentsMargins(0,0,0,0);
    
    /* Layout for outer scene to help positioning text overlay */
    overlay_grid = new QGraphicsGridLayout;
    
    /* XXX Transparent middle item with variable size (default). This snaps the border items to the border.
     * TODO That seems to eliminate the possibility of a middle widget with fixed size. 
     */
    QGraphicsWidget *label_mi = fixedOverlayScene->addWidget(new QLabel);
    QPalette label_mi_pal;
    label_mi_pal.setColor(QPalette::Window, QColor(Qt::transparent));
    //label_mi_pal.setColor(QPalette::Window, QColor(Qt::white));
    label_mi->setPalette(label_mi_pal);
    label_mi->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
    overlay_grid->addItem(label_mi, 1, 1, Qt::AlignVCenter|Qt::AlignCenter);
    
    overlayWidget = new ContextMenuGraphicsWidget;//new QGraphicsWidget;
    connect(overlayWidget, SIGNAL(contextMenuRequest(QPoint)), this, SLOT(displayContextMenu(QPoint)));
    
    overlayWidget->setLayout(overlay_grid);
    overlayWidget->setZValue(12);
    fixedOverlayScene->addItem(overlayWidget);

    // Nest inner view in outer scene
    imageViewProxy = fixedOverlayScene->addWidget(imageView);
    
    progress_indicator.setParent(fixedOverlayView);
     
    setItemPositions();
    update();
}

~ImageView()

ImageView::~ImageView ( )

virtual

Definition at line 167 of file ImageView.cc.

{
}

Member Function Documentation

addCircle()

void ImageView::addCircle	(	QPointF &	center,
		double	radius,
		QColor &	color,
		int	width,
		bool	persistent = 0
	)

Draws circle overlay.

Draws a circle overlay with center point center and radius radius. The position has to be submitted in image coordinates with origin in the top left corner.

Parameters

width	pen width
persistent	If false, the overlay gets deleted with the next frame update. Otherwise not.

Definition at line 257 of file ImageView.cc.

{
    QGraphicsEllipseItem *circlePtr = 
            new QGraphicsEllipseItem(QRectF(center.x() - radius/2.0, center.y() - radius/2.0, radius, radius));
    QPen pen;
    pen.setColor(color);
    pen.setWidth(width);
    circlePtr->setPen(pen);
    
    addDrawItem(imageScene, circlePtr, persistent);
}

addLine()

void ImageView::addLine	(	QLineF &	line,
		QColor &	color,
		int	width,
		bool	persistent = 0
	)

Draws line overlay.

Draws a line overlay. The line is specified in line. The position has to be submitted in image coordinates with origin in the top left corner.

Parameters

width	pen width
persistent	If false, the overlay gets deleted with the next frame update. Otherwise not.

Definition at line 269 of file ImageView.cc.

{                     
    QGraphicsLineItem *linePtr = new QGraphicsLineItem(line);
    QPen pen;
    pen.setColor(color);
    pen.setWidth(width);
    linePtr->setPen(pen);

    addDrawItem(imageScene, linePtr, persistent);
}

addPoints()

void ImageView::addPoints	(	const QList< int >	points_x,
		QList< int >	points_y,
		QColor &	color,
		int	width,
		bool	persistent = 0
	)

Draws points overlay (2D point cloud).

Draws a points overlay. This is to be understood as a 2D point cloud. The position has to be submitted in image coordinates with origin in the top left corner. Since QtRuby has problems with QList<QPoint> slot signatures, this method uses two lists: one for the x-coordinates and one for the y-coordinates.

Example:
You want to draw the pointcloud {(3,4),(6,8)}. Therefore you have to submit
points_x : {3,6}
points_y : {4,8}

Parameters

width	pen width
persistent	If false, the overlay gets deleted with the next frame update. Otherwise not.

Definition at line 280 of file ImageView.cc.

{   
    QList<QPoint> points;
    QList<int>::const_iterator iter1 = points_x.begin();
    QList<int>::const_iterator iter2 = points_y.begin();
    for(;iter1 != points_x.end() && iter2 != points_y.end();++iter1,++iter2)
    {
        points.push_back(QPoint(*iter1,*iter2));
    }

    GraphicsPointsItem *pointsPtr = new GraphicsPointsItem(points);
    QPen pen;
    pen.setColor(color);
    pen.setWidth(width);
    pointsPtr->setPen(pen);

    addDrawItem(imageScene, pointsPtr, persistent);
}

addPolygon()

void ImageView::addPolygon	(	QPolygonF &	polygon,
		QColor &	color,
		int	width,
		bool	persistent = 0
	)

Draws polygon overlay.

Draws a polygon overlay. The polygon is specified in line. The position has to be submitted in image coordinates with origin in the top left corner.

Parameters

width	pen width
persistent	If false, the overlay gets deleted with the next frame update. Otherwise not.

Definition at line 299 of file ImageView.cc.

{              
    LOG_DEBUG_S << "Received polygon. Polygon closed: " << polygon.isClosed();
    LOG_DEBUG_S << "The polygon has a size of " << polygon.size() << ".";
    QGraphicsPolygonItem *polygonPtr = new QGraphicsPolygonItem(polygon);
    QPen pen;
    pen.setColor(color);
    pen.setWidth(width);
    polygonPtr->setPen(pen);

    addDrawItem(imageScene, polygonPtr, persistent);
}

addText()

void ImageView::addText	(	QString	text,
		int	location,
		QColor	color = QColor(Qt::black),
		bool	persistent = 0
	)

Draws text overlay.

Draws a text overlay. The text is immune to image transformation, i.e. rotation or scaling. The text is in monospace style. You can align the text to the corners.

Parameters

location	Text alignment to the corners. The location value is analogous to the TextLocation enum. This is an intermediate solution until we find a way to use the QtRuby binding for enums. For convenience from the ruby side, you can use a wrapper method using symbols. This method is defined in the Vizkit C++ Extensions in image_view_widget.rb.
persistent	If false, the overlay gets deleted with the next frame update. Otherwise not.

See also

TextLocation

Definition at line 312 of file ImageView.cc.

{   
    /* Positioning */
    int row = 0;
    int col = 0;
    Qt::Alignment alignment = Qt::AlignLeft;
    
    switch(location) {
    case TOPLEFT :
        row = 0;
        col = 0;
        alignment = Qt::AlignTop|Qt::AlignLeft;
        break;
    case TOPRIGHT :
        row = 0;
        col = 2;
        alignment = Qt::AlignTop|Qt::AlignRight;
        break;
    case BOTTOMLEFT :
        row = 2;
        col = 0;
        alignment = Qt::AlignBottom|Qt::AlignLeft;
        break;
    case BOTTOMRIGHT :
        row = 2;
        col = 2;
        alignment = Qt::AlignBottom|Qt::AlignRight;
        break;
    default:
        LOG_WARN("Unsupported text location. Switching to TOPLEFT.");
        addText(text, TOPLEFT, persistent);
        return;
    }
    
    QLabel *label = NULL;
    QGraphicsWidget *textLabel = NULL;
    int margin = 1;
    
    // Avoid displaying empty labels, i.e. labels with margin only and no text
    if(text.isEmpty()) {
        margin = 0;
    }
    
    // Label for text location already exists?
    if(overlayMap.contains(location)) {
        // Alter existing label
        label = overlayMap[location];
        label->setText(text);
        label->adjustSize();
    } else {
        // Add new label to map
        label = new QLabel(text);
        label->setVisible(false);
        label->setSizePolicy(QSizePolicy::MinimumExpanding, QSizePolicy::MinimumExpanding);
        
        overlayMap[location] = label;
        
        textLabel = fixedOverlayScene->addWidget(label);
        overlay_grid->addItem(textLabel, row, col, alignment);
        textLabel->setVisible(true); // TODO use label instead?
    }
    
    QPalette palette;    
    QColor labelBgColor(Qt::white);
    labelBgColor.setAlphaF(0.7);
    palette.setColor(QPalette::Window, labelBgColor);
    palette.setColor(QPalette::WindowText, color);
    palette.setColor(QPalette::Text, color); // <-- this one seems to be working but WindowText should be correct according to docu
        
    label->setPalette(palette);
    label->setMargin(margin);
       
    QFont font("Monospace");
    font.setPointSize(12);
    font.setStyleHint(QFont::TypeWriter);
    label->setFont(font);
    
    label->setMaximumSize(label->sizeHint());
    
//     std::cout << "label size hint: " << label->sizeHint().width() << "," << label->sizeHint().height() << " ('" << text.toStdString().data() << "')" << std::endl;
//     std::cout << "label size: " << label->width() << "," << label->height() << " ('" << text.toStdString().data() << "')" << std::endl;
//     std::cout << "label maximum size: " << label->maximumSize().width() << "," << label->maximumSize().height() << " ('" << text.toStdString().data() << "')" << std::endl;
//     std::cout << "---" << std::endl;
    
    overlay_grid->invalidate();
    //addDrawItem(NULL, textLabel, persistent); // TODO check correctness of deletion etc.
    update();
}

clearOverlays()

void ImageView::clearOverlays

(

bool

clear_persistent_items = 0

)

Removes overlays.

Parameters

persistent

If true, removes also persistent overlays. Otherwise not.

Definition at line 401 of file ImageView.cc.

{
    if(clear_persistent_items) {
        Q_FOREACH(QGraphicsItem *item, persistentDrawItems) {
            item->scene()->removeItem(item);
        }
        persistentDrawItems.clear();
    }
    
    Q_FOREACH(QGraphicsItem *item, volatileDrawItems) {
        item->scene()->removeItem(item);
    }
    volatileDrawItems.clear();
}

clickedImage

void ImageView::clickedImage ( const QPoint &  point )

signal

Mouse click coordinates in image.

Gets emitted if the image receives a mouse click event. The position is in image coordinates where the origin is in the top-left corner.

contextMenuEvent()

void ImageView::contextMenuEvent ( QContextMenuEvent *  event )

protected

Definition at line 591 of file ImageView.cc.

{
   context_menu.exec(event->globalPos());
}

eventFilter()

bool ImageView::eventFilter ( QObject *  obj, QEvent *  event  )

protected

Definition at line 596 of file ImageView.cc.

{
    //std::cout << "Got an event: " << event->type() << std::endl;
    
    if (event->type() == QEvent::GraphicsSceneMousePress) {
         QGraphicsSceneMouseEvent *mouseEvent = static_cast<QGraphicsSceneMouseEvent *>(event);
         
         QPoint scenePos = mouseEvent->scenePos().toPoint();
         
         // Clicked on image scene?
         if(imageScene->sceneRect().contains(scenePos)) {
             LOG_INFO_S << "Clicked at image coordinate (w,h) (" << scenePos.x() << "," << scenePos.y() << ")";
             emit clickedImage(scenePos);
         } 
         
         return true;
     } else {
         // standard event processing
         return QObject::eventFilter(obj, event);
     }
}

getBackgroundColor

const QColor & ImageView::getBackgroundColor ( ) const

slot

Definition at line 176 of file ImageView.cc.

{
    return bgColor;
}

getHeight()

int ImageView::getHeight

(

)

const

returns the real height of the underlaying widget

Definition at line 679 of file ImageView.cc.

{
    return imageSize.height();
}

getInvertColor

bool ImageView::getInvertColor ( )

inlineslot

Definition at line 132 of file ImageView.h.

{return invert_color;};

getProgressIndicatorTimeout

const int ImageView::getProgressIndicatorTimeout ( ) const

slot

Definition at line 224 of file ImageView.cc.

{
    return progress_indicator_timeout;
}

getRgbSwapped()

bool ImageView::getRgbSwapped ( )

inline

Definition at line 134 of file ImageView.h.

{return rgb_swapped;};

getWidth()

int ImageView::getWidth

(

)

const

returns the real width of the underlaying widget

Definition at line 684 of file ImageView.cc.

{
    return imageSize.width();
}

processImage()

void ImageView::processImage

(

)

Definition at line 507 of file ImageView.cc.

{
    if(getInvertColor())
        image.invertPixels();
    if(getRgbSwapped())
        image = image.rgbSwapped();
}

refresh()

void ImageView::refresh

(

)

Definition at line 515 of file ImageView.cc.

{
    if(use_progress_indicator) {
        progress_indicator.hide();
        progress_indicator_timer.start();
        progress_indicator.stopAnimation();
    }
    
#ifdef USE_GST
    // TODO
#else
    clearOverlays();

    // Backup image size for detecting size change
    QSize oldSize = imageSize;
    imageSize = image.size();
    //std::cout << "Image size: x=" << image.width() <<", y=" << image.height() << std::endl;
    QPixmap pixmap = QPixmap::fromImage(image);
    pixmap.scaled(size(), Qt::KeepAspectRatio);

    //std::cout << "Pixmap size: x=" << pixmap.width() <<", y=" << pixmap.height() << std::endl;
    if(imageItem) {
        imageItem->setPixmap(pixmap);
    } else {
        LOG_WARN("imageItem undefined!");
    }
    
    //std::cout << "ImageItem BoundingRect: x=" << imageItem->boundingRect().width() <<", y=" << imageItem->boundingRect().height() << std::endl;
    
    /* Resize and repositioning if frame size changes (and on start) */
    if(imageSize != oldSize) {
        LOG_INFO("image size changed. resize.");
        
        // Avoid dynamic scene growth
        imageScene->setSceneRect(0, 0, imageSize.width(), imageSize.height());
        
        setItemPositions();
        
        /* For some reason the first frame is not scaled to fit the full space. 
         * Calling update or even repaint did not help but a simple resize or 
         * setVisible does. On Debian, you have to call both ???
         */
        setVisible(false); setVisible(true); 
        resize(width(),height()-1); 
        resize(width(),height()+1);
    }
    update();
#endif
}

resizeEvent()

void ImageView::resizeEvent ( QResizeEvent *  event )

protected

Definition at line 567 of file ImageView.cc.

{ 
    QWidget::resizeEvent(event);
    
    //fixedOverlayScene->setSceneRect(fixedOverlayScene->itemsBoundingRect());
    QSize eventSize = event->size();
    fixedOverlayScene->setSceneRect(0, 0, eventSize.width(), eventSize.height());
    imageView->resize(eventSize);
    

//    std::cout << "resize event.\nview.width: " << view->width() << "\n"
//              << "view.height: " << view->height() << std::endl;
    
    imageView->fitInView(imageItem, Qt::KeepAspectRatio);
    
    
    fixedOverlayView->resize(eventSize);
    overlayWidget->resize(eventSize);
    setItemPositions();
    LOG_DEBUG_S << "scene dimensions:\n"
            << "fixedOverlayScene (w/h): (" << fixedOverlayScene->width() << "," << fixedOverlayScene->height() << ")\n"
            << "imageScene (w/h): (" << imageScene->width() << "," << imageScene->height() << ")\n";
}

rotate()

void ImageView::rotate

(

int

deg

)

Rotates image display.

Rotates the image display about deg degrees. The image gets fit into the widget by keeping its aspect ratio.

Definition at line 416 of file ImageView.cc.

{
    imageView->rotate(deg);
    imageView->fitInView(imageItem, Qt::KeepAspectRatio);
    //view->fitInView(view->sceneRect(), Qt::KeepAspectRatio);
}

saveImage()

void ImageView::saveImage	(	QString	path = QString(),
		bool	overlay = 0
	)

Saves current image to file.

The saved image is either the plain original image or said image with overlays (depending on overlay). The saved image size is always the size of the original image.

Parameters

path	Save destination. If not submitted, a file chooser dialog is presented.
overlay	Saves overlays, too if set to true. Otherwise only the image is being saved.

Definition at line 423 of file ImageView.cc.

{
    QImage saveImage(imageScene->sceneRect().size().toSize(), image.format());
    saveImage.fill(0); // Painter cannnot handle null image
    
    /* Get destination path if not submitted */
    if(path.isEmpty()) {
        path = QFileDialog::getSaveFileName(this, "Save Image",
                                last_path,
                                "Images (*.png)");
        last_path = path;
    }
    
    /* Save original image or also the overlay? */
    if(overlay) {
        QPainter painter(&saveImage);
        
        // Render image and image overlays first
        imageScene->render(&painter);
        
        QSize oldSize = size();
        QSize newSize = imageScene->sceneRect().size().toSize();
        
        // Hide image view from outer scene. It is already painted.
        imageViewProxy->hide();
        
        fixedOverlayScene->setSceneRect(imageScene->sceneRect());
        overlayWidget->resize(newSize);
        
        // Render outer scene (text overlays) on top
        fixedOverlayScene->render(&painter);
        
        imageViewProxy->show();
        
        // restore old sizes
        resize(oldSize.width(),oldSize.height()+1);
        resize(oldSize.width(),oldSize.height()-1);
    } else {
        saveImage = image;
    }
    
    saveImage.save(path, "PNG", 80);
}

setBackgroundColor

void ImageView::setBackgroundColor ( const QColor &  color )

slot

Definition at line 181 of file ImageView.cc.

{
    bgColor = color;
    imageScene->setBackgroundBrush(bgColor);
}

setFrame() [1/2]

void ImageView::setFrame

(

const base::samples::DistanceImage &

frame

)

Frame input.

Parameters

frame

The image to be displayed next. The display gets updated immediately.

Definition at line 467 of file ImageView.cc.

{  

    base::samples::frame::Frame bframe(frame.width,frame.height,16); 
    std::vector<uint16_t> v(frame.data.size());
    for(unsigned int i=0;i<v.size();i++){
        v[i] = frame.data[i];
    }

    bframe.setImage((uint8_t*)&v[0],frame.data.size()*2);
    if(1 == frame_converter.copyFrameToQImageRGB888(image,bframe)) {
        LOG_WARN("Frame size changed while converting frame to QImage (says converter)");
    }
    processImage();
    refresh();
}

setFrame() [2/2]

void ImageView::setFrame

(

const base::samples::frame::Frame &

frame

)

Definition at line 484 of file ImageView.cc.

{   
    if(1 == frame_converter.copyFrameToQImageRGB888(image,frame)) {
        LOG_WARN("Frame size changed while converting frame to QImage (says converter)");
    }
    processImage();
    refresh();
}

setImage()

void ImageView::setImage

(

const QImage &

image

)

Definition at line 500 of file ImageView.cc.

{   
    this->image = image.copy();
    processImage();
    refresh();
}

setInvertColor

void ImageView::setInvertColor ( bool  invert )

slot

Definition at line 689 of file ImageView.cc.

{
    if(invert_color == invert)
        return;
    invert_color=invert;
    image.invertPixels();
    refresh();
}

setProgressIndicatorTimeout

void ImageView::setProgressIndicatorTimeout ( int  timeout )

slot

Definition at line 229 of file ImageView.cc.

{
    progress_indicator_timeout = timeout;
    progress_indicator_timer.setInterval(timeout);
}

setRawImage()

void ImageView::setRawImage	(	const QString &	mode,
		int	pixel_size,
		int	width,
		int	height,
		const char *	pbuffer,
		const int	size
	)

Definition at line 493 of file ImageView.cc.

{
    frame_converter.copyFrameToQImageRGB888(image,mode, pixel_size, width, height,pbuffer,size);
    processImage();
    refresh();
}

setRgbSwapped()

void ImageView::setRgbSwapped

(

bool

swapped

)

Definition at line 697 of file ImageView.cc.

{
    if(rgb_swapped == swapped)
        return;
    rgb_swapped=swapped;
    image = image.rgbSwapped();
    refresh();
}

setSmoothTransformation

void ImageView::setSmoothTransformation ( bool  smooth )

slot

Definition at line 215 of file ImageView.cc.

{
    use_smooth_transformation = smooth;
    if(smooth)
        imageItem->setTransformationMode(Qt::SmoothTransformation);
    else
        imageItem->setTransformationMode(Qt::FastTransformation);
}

setUseProgressIndicator

void ImageView::setUseProgressIndicator ( bool  use )

slot

Definition at line 193 of file ImageView.cc.

{
    use_progress_indicator = use;
    progress_indicator.hide();
    
    if(use) {
        progress_indicator_timer.start();
        // TODO Maybe unwanted behavior since the timer starts even if there is not a single frame yet.
        //      But it is nice if you trigger the use of the progress indicator while the replay is stopped.
    }
    else {
        // Disable possibly already running widget
        progress_indicator_timer.stop();
        progress_indicator.stopAnimation();
    }
}

sizeHint()

QSize ImageView::sizeHint

(

)

const

Definition at line 171 of file ImageView.cc.

{
    return QSize(500,500);
}

update2()

void ImageView::update2

(

)

Wrapper for QWidget::update(). This is due to some QtRuby limitations.

Definition at line 667 of file ImageView.cc.

{
    QWidget::update();
}

useProgressIndicator

bool ImageView::useProgressIndicator ( )

slot

Definition at line 187 of file ImageView.cc.

{
    return use_progress_indicator;
}

useSmoothTransformation

bool ImageView::useSmoothTransformation ( )

slot

Definition at line 210 of file ImageView.cc.

{
    return use_smooth_transformation;
}

Property Documentation

backgroundColor

QColor ImageView::backgroundColor

readwrite

The widget's background color.

You see the widget's background color in the areas not covered by the image. This is likely to happen because of the keeping of the images aspect ratio while fitting it in the view.

Definition at line 59 of file ImageView.h.

invert_color

bool ImageView::invert_color

readwrite

Definition at line 80 of file ImageView.h.

progress_indicator_timeout

int ImageView::progress_indicator_timeout

readwrite

The time without frame update in ms after which the progress indicator gets started.

Definition at line 68 of file ImageView.h.

rgb_swapped

bool ImageView::rgb_swapped

readwrite

Definition at line 79 of file ImageView.h.

use_progress_indicator

bool ImageView::use_progress_indicator

readwrite

Display progress indicator widget if no frames have being received for a defined time.

See also

ProgressIndicator

Definition at line 65 of file ImageView.h.

use_smooth_transformation

bool ImageView::use_smooth_transformation

readwrite

Usage of antialiasing techniques during image transformation.

Do antialiased transformation by using costly techniques like bilinear filtering. That produces higher CPU load but the displayed image is much smoother. This property only applies to the displayed image - not to the overlays.

Definition at line 77 of file ImageView.h.

---

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

• /build/rock-master-18.09-gui-rock-widget-collection-0.20180124/src/image_view/ImageView.h
• /build/rock-master-18.09-gui-rock-widget-collection-0.20180124/src/image_view/ImageView.cc