tomwalters@116: // Copyright 2006, Willem van Engen
tomwalters@116: //
tomwalters@116: // AIM-C: A C++ implementation of the Auditory Image Model
tomwalters@116: // http://www.acousticscale.org/AIMC
tomwalters@116: //
tomwalters@116: // Licensed under the Apache License, Version 2.0 (the "License");
tomwalters@116: // you may not use this file except in compliance with the License.
tomwalters@116: // You may obtain a copy of the License at
tomwalters@116: //
tomwalters@116: //     http://www.apache.org/licenses/LICENSE-2.0
tomwalters@116: //
tomwalters@116: // Unless required by applicable law or agreed to in writing, software
tomwalters@116: // distributed under the License is distributed on an "AS IS" BASIS,
tomwalters@116: // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
tomwalters@116: // See the License for the specific language governing permissions and
tomwalters@116: // limitations under the License.
tomwalters@116: 
tom@118: #include <algorithm>
tom@118: 
tomwalters@116: #include "Support/Common.h"
tomwalters@116: 
tom@118: #include "Modules/Output/Graphics/GraphicsView.h"
tom@118: #include "Modules/Output/Graphics/Devices/GraphicsOutputDevice.h"
tomwalters@126: #include "Modules/Output/Graphics/Devices/GraphicsOutputDeviceMovie.h"
tom@118: 
tom@118: namespace aimc {
tomwalters@116: 
tomwalters@116: GraphicsView::GraphicsView(Parameters *parameters) : Module(parameters) {
tomwalters@121:   module_description_ = "Graphics output.";
tomwalters@116:   module_identifier_ = "graphics";
tomwalters@116:   module_type_ = "output";
tomwalters@116:   module_version_ = "$Id: $";
tomwalters@145: 
tomwalters@145:   if (parameters_->DefaultBool("output.images", false)) {
tomwalters@145:     m_pDev = new GraphicsOutputDeviceCairo(parameters_);
tomwalters@145:   } else {
tomwalters@145:     m_pDev = new GraphicsOutputDeviceMovie(parameters_);
tomwalters@145:   }
tomwalters@117:   m_bPlotLabels = false;
tomwalters@117:   m_pAxisX = new GraphAxisSpec();
tomwalters@117:   AIM_ASSERT(m_pAxisX);
tomwalters@117:   m_pAxisY = new GraphAxisSpec();
tomwalters@117:   AIM_ASSERT(m_pAxisY);
tomwalters@117:   m_pAxisFreq = new GraphAxisSpec();
tomwalters@117:   AIM_ASSERT(m_pAxisFreq);
tom@118:   initialized_ = true;
tomwalters@116: 
tomwalters@125:   if (!m_pAxisY->Initialize(parameters_,
tom@118:                             _S("graph.y"),
tom@118:                             -1,
tom@118:                             1,
tom@118:                             Scale::SCALE_LINEAR)) {
tom@118:     LOG_ERROR("Axis initialization failed");
tom@118:     initialized_ = false;
tom@118:   }
tomwalters@126:   m_fMarginLeft = parameters_->DefaultFloat(_S("graph.margin.left"), 0.05);
tomwalters@126:   m_fMarginRight = parameters_->DefaultFloat(_S("graph.margin.right"), 0.005);
tomwalters@126:   m_fMarginTop = parameters_->DefaultFloat(_S("graph.margin.top"), 0.005);
tomwalters@126:   m_fMarginBottom = parameters_->DefaultFloat(_S("graph.margin.bottom"), 0.05);
tomwalters@126:   m_bPlotLabels = parameters_->DefaultBool(_S("graph.plotlabels"), true);
tomwalters@116: 
tomwalters@126:   const char *sGraphType = parameters_->DefaultString(_S("graph.type"), "line");
tomwalters@117:   if (strcmp(sGraphType, _S("line"))==0)
tomwalters@117:     m_iGraphType = GraphTypeLine;
tomwalters@117:   else if (strcmp(sGraphType, _S("colormap"))==0)
tomwalters@117:     m_iGraphType = GraphTypeColormap;
tomwalters@117:   else if (strcmp(sGraphType, _S("none"))==0)
tomwalters@117:     m_iGraphType = GraphTypeNone;
tomwalters@117:   else {
tom@118:     LOG_ERROR(_T("Unrecognized graph type: '%s'"), sGraphType);
tom@118:     initialized_ = false;
tomwalters@117:   }
tomwalters@116: 
tomwalters@126:   if (strcmp(parameters_->DefaultString(_S("graph.mindistance"), "auto"),"auto") == 0)
tomwalters@117:     // -1 means detect later, based on type and Fire() argument
tomwalters@117:     m_fMinPlotDistance = -1;
tomwalters@117:   else
tomwalters@125:     m_fMinPlotDistance = parameters_->GetFloat(_S("graph.mindistance"));
tomwalters@116: }
tomwalters@116: 
tomwalters@116: GraphicsView::~GraphicsView() {
tomwalters@117:   DELETE_IF_NONNULL(m_pAxisX);
tomwalters@117:   DELETE_IF_NONNULL(m_pAxisY);
tomwalters@117:   DELETE_IF_NONNULL(m_pAxisFreq);
tomwalters@116: }
tomwalters@116: 
tom@118: void GraphicsView::ResetInternal() {
tomwalters@126:   if (m_pDev != NULL) {
tomwalters@133:     m_pDev->Reset(global_parameters_);
tomwalters@126:   }
tom@118: }
tomwalters@116: 
tomwalters@116: bool GraphicsView::InitializeInternal(const SignalBank &bank) {
tomwalters@117:   if (!m_pDev) {
tomwalters@117:     LOG_ERROR("Output device not connected");
tomwalters@117:     return false;
tomwalters@117:   }
tomwalters@116: 
tomwalters@116:   float y_min = bank.centre_frequency(0);
tomwalters@116:   float y_max = bank.centre_frequency(bank.channel_count() - 1);
tomwalters@125:   if (!m_pAxisFreq->Initialize(parameters_,
tomwalters@116:                                "graph.freq",
tomwalters@117:                                y_min,
tomwalters@117:                                y_max,
tomwalters@117:                                Scale::SCALE_ERB)) {
tomwalters@126:     LOG_ERROR("Frequency axis init failed.");
tomwalters@116:     return false;
tomwalters@116:   }
tomwalters@116: 
tomwalters@116:   float x_min = 0.0;
tomwalters@116:   float x_max = 1000.0 * bank.buffer_length() / bank.sample_rate();
tomwalters@125:   if (!m_pAxisX->Initialize(parameters_,
tomwalters@116:                             "graph.x",
tomwalters@117:                             x_min,
tomwalters@116:                             x_max,
tomwalters@117:                             Scale::SCALE_LINEAR)) {
tomwalters@126:      LOG_ERROR("Time axis init failed.");
tomwalters@116:      return false;
tomwalters@116:   }
tomwalters@116: 
tomwalters@117:   /* Inform graphics output of maximum number of vertices between
tomwalters@117:    * gBegin*() and gEnd(), for any type of plot. Colormap needs most.
tomwalters@117:    */
tomwalters@126:   LOG_INFO("Initializing graphics output device.");
tomwalters@126:   
tomwalters@126:   if (!m_pDev->Initialize(global_parameters_)) {
tomwalters@126:     LOG_ERROR("Graphics output device init failed.");
tomwalters@116:     return false;
tomwalters@116:   }
tomwalters@126:   m_pDev->Start();
tomwalters@126:   previous_start_time_ = 0;
tom@118:   return true;
tomwalters@116: }
tomwalters@116: 
tomwalters@116: void GraphicsView::Process(const SignalBank &bank) {
tomwalters@117:   float height = 1.0 / bank.channel_count();
tomwalters@117:   float heightMinMargin = height * (1.0f - m_fMarginBottom - m_fMarginTop);
tomwalters@117:   float xScaling = 1.0f;
tomwalters@116: 
tomwalters@117:   m_pDev->gGrab();
tomwalters@117:   PlotAxes(bank);
tomwalters@117:   m_pDev->gColor3f(1.0f, 1.0f, 0.8f);
tomwalters@117:   for (int i = 0; i < bank.channel_count(); i++) {
tomwalters@117:     float yOffs = bank.centre_frequency(i);
tomwalters@117:     yOffs = m_pAxisFreq->m_pScale->FromLinearScaled(yOffs) + 0.5f;
tomwalters@117:     /* Don't plot below zero and stop when above 1, since yOffs is
tomwalters@116:      * monotonically increasing. Because of rounding errors, we need
tomwalters@116:      * to check for yOffs < -1e-6 instead of yOffs < 0. */
tomwalters@117:     if (yOffs < -1e-6)
tomwalters@116:       continue;
tomwalters@117:     if (yOffs > 1)
tomwalters@116:       break;
tomwalters@116: 
tomwalters@116:     // Scale to single channel graphing.
tomwalters@117:     yOffs = yOffs * (1.0f - height) + height / 2.0;
tomwalters@117:     yOffs = yOffs * (1.0f - m_fMarginTop - m_fMarginBottom) + m_fMarginBottom;
tom@118:     PlotData(bank[i], bank.sample_rate(), yOffs, heightMinMargin, xScaling);
tomwalters@117:   }
tomwalters@117:   m_pDev->gRelease();
tomwalters@126:   
tomwalters@126:   frame_rate_ = bank.sample_rate()
tomwalters@126:                 / (bank.start_time() - previous_start_time_);
tomwalters@126:   previous_start_time_ = bank.start_time();
tomwalters@126:   global_parameters_->SetFloat("frame_rate", frame_rate_);
tomwalters@116: }
tomwalters@116: 
tomwalters@116: void GraphicsView::SetAxisScale(Scale::ScaleType iHori,
tomwalters@116:                                 Scale::ScaleType iVert,
tomwalters@116:                                 Scale::ScaleType iFreq) {
tomwalters@117:   AIM_ASSERT(m_pAxisX);
tomwalters@117:   AIM_ASSERT(m_pAxisY);
tomwalters@117:   AIM_ASSERT(m_pAxisFreq);
tomwalters@117:   m_pAxisX->SetDisplayScale(iHori);
tomwalters@117:   m_pAxisY->SetDisplayScale(iVert);
tomwalters@117:   m_pAxisFreq->SetDisplayScale(iFreq);
tomwalters@116: }
tomwalters@116: 
tomwalters@116: void GraphicsView::BeginDataStrip() {
tomwalters@117:   m_iPrevValEqual=0;
tomwalters@117:   m_bFirstPoint=true;
tomwalters@117:   switch(m_iGraphType) {
tomwalters@117:   case GraphTypeLine:
tomwalters@117:     m_pDev->gBeginLineStrip();
tomwalters@117:     break;
tomwalters@117:   case GraphTypeColormap:
tomwalters@117:     m_pDev->gBeginQuadStrip();
tomwalters@117:     break;
tomwalters@117:   case GraphTypeNone:
tomwalters@117:     // Nothing: just for testing computation overhead of graphing
tomwalters@117:     break;
tomwalters@117:   }
tomwalters@116: }
tomwalters@116: 
tomwalters@116: void GraphicsView::PlotDataPoint(float x,
tomwalters@116:                                  float y,
tomwalters@116:                                  float val,
tomwalters@116:                                  float height,
tomwalters@116:                                  bool isLast) {
tomwalters@117:   AIM_ASSERT(m_pDev);
tomwalters@116: 
tomwalters@117:   /* Reduce the number of points plotted by eliminating duplicate values:
tomwalters@117:    *
tomwalters@117:    *             oooo                         o--o
tomwalters@117:    *                 o                       /    o
tomwalters@117:    *        oooo       ooo       =>      o--o      o--o
tomwalters@117:    *    oooo              ooo        o--o              o-o
tomwalters@117:    *
tomwalters@117:    * with 'o' points that are plotted, and '-' by the graphics output
tomwalters@117:    * device interpolated points. We could be smarter and include
tomwalters@117:    * first-order interpolation, but we leave that as an exercise for
tomwalters@117:    * the reader. Please send your patches :)
tomwalters@117:    *
tomwalters@117:    * So, we don't draw points that are too close to the previous value.
tomwalters@117:    * But if the value changes (or it's the last point), we must draw the
tomwalters@117:    * previous point too.
tomwalters@117:    */
tomwalters@117:   if (!m_bFirstPoint
tomwalters@116:       && !isLast
tom@118:       && abs(m_fPrevVal-val) < m_fMinPlotDistance) {
tomwalters@117:     m_iPrevValEqual++;
tomwalters@117:     // Don't set m_fPrevVal to avoid not catching slow changes
tomwalters@117:     m_fPrevX = x;
tomwalters@117:     m_fPrevY = y;
tomwalters@117:     m_fPrevHeight = height;
tomwalters@117:     return;
tomwalters@117:   } else {
tomwalters@117:     if (m_iPrevValEqual > 0) {
tomwalters@117:       // Draw previous point
tomwalters@117:       PlotDataPointDirect(m_fPrevX, m_fPrevY, m_fPrevVal, m_fPrevHeight);
tomwalters@117:     }
tomwalters@117:     m_iPrevValEqual = 0;
tomwalters@117:     m_fPrevVal = val;
tomwalters@117:     m_bFirstPoint = false;
tomwalters@117:   }
tomwalters@117:   PlotDataPointDirect(x, y, val, height);
tomwalters@116: }
tomwalters@116: 
tomwalters@116: void GraphicsView::PlotDataPointDirect(float x,
tomwalters@116:                                        float y,
tomwalters@116:                                        float val,
tomwalters@116:                                        float height) {
tomwalters@117:   // Draw it in the right way
tomwalters@117:   switch(m_iGraphType) {
tomwalters@117:   case GraphTypeLine:
tomwalters@117:     m_pDev->gVertex2f(x, y + val * height);
tomwalters@117:     break;
tomwalters@117:   case GraphTypeColormap:
tomwalters@117:     //! \todo make it a real colormap instead of grayscale
tomwalters@117:     m_pDev->gColor3f(val + 0.5, val + 0.5, val + 0.5);
tomwalters@117:     m_pDev->gVertex2f(x, y - height / 2);
tomwalters@117:     m_pDev->gVertex2f(x, y + height / 2);
tomwalters@117:     break;
tomwalters@117:   case GraphTypeNone:
tomwalters@117:     // Nothing: just for testing computation overhead of graphing
tomwalters@117:     break;
tomwalters@117:   default:
tomwalters@117:     // Shouldn't happen
tomwalters@117:     AIM_ASSERT(0);
tomwalters@117:   }
tomwalters@116: }
tom@118: }  // namespace aimc