graphics.h

Go to the documentation of this file.

/*******************************************************
 * Copyright (c) 2014, ArrayFire
 * All rights reserved.
 *
 * This file is distributed under 3-clause BSD license.
 * The complete license agreement can be obtained at:
 * http://arrayfire.com/licenses/BSD-3-Clause
 ********************************************************/
 
#pragma once
 
#include <af/defines.h>
#include <af/array.h>
 
typedef void* af_window;
 
typedef struct {
    int row;
    int col;
    const char* title;
    af_colormap cmap;
} af_cell;
 
#ifdef __cplusplus
namespace af
{
 
class AFAPI Window {
    private:
        af_window wnd;
        /* below attributes are used to track which
         * cell in the grid is being rendered currently */
        int _r;
        int _c;
        ColorMap _cmap;
 
        void initWindow(const int width, const int height, const char* const title);
 
        Window(const Window&);                 // Prevent copy-construction
        Window& operator=(const Window&);      // Prevent assignment
 
    public:
        Window();
 
        Window(const char* const title);
 
        Window(const int width, const int height, const char* const title="ArrayFire");
 
        Window(const af_window window);
 
        ~Window();
 
        // FIXME handle copying properly
 
        af_window get() const { return wnd; }
 
        void setPos(const unsigned x, const unsigned y);
 
        void setTitle(const char* const title);
 
#if AF_API_VERSION >= 31
        void setSize(const unsigned w, const unsigned h);
#endif
 
        void setColorMap(const ColorMap cmap);
 
        void image(const array& in, const char* title=NULL);
 
#if AF_API_VERSION >= 32
        AF_DEPRECATED("Use plot instead")
        void plot3(const array& in, const char* title=NULL);
#endif
 
#if AF_API_VERSION >= 34
        void plot(const array& in, const char* const title=NULL);
#endif
 
#if AF_API_VERSION >= 34
        void plot(const array& X, const array& Y, const array& Z, const char* const title=NULL);
#endif
 
        void plot(const array& X, const array& Y, const char* const title=NULL);
 
#if AF_API_VERSION >= 34
        void scatter(const array& in, const af::markerType marker = AF_MARKER_POINT,
                     const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 34
        void scatter(const array& X, const array& Y, const array& Z,
                     const af::markerType marker = AF_MARKER_POINT, const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 33
        void scatter(const array& X, const array& Y,
                     const af::markerType marker = AF_MARKER_POINT, const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 33
        AF_DEPRECATED("Use scatter instead")
        void scatter3(const array& P, const af::markerType marker = AF_MARKER_POINT,
                      const char* const title = NULL);
#endif
 
        void hist(const array& X, const double minval, const double maxval, const char* const title=NULL);
 
#if AF_API_VERSION >= 32
        void surface(const array& S, const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 32
        void surface(const array& xVals, const array& yVals, const array& S, const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 34
        void vectorField(const array& points, const array& directions, const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 34
        void vectorField(const array& xPoints, const array& yPoints, const array& zPoints,
                         const array& xDirs  , const array& yDirs  , const array& zDirs  ,
                         const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 34
        void vectorField(const array& xPoints, const array& yPoints,
                         const array& xDirs  , const array& yDirs  ,
                         const char* const title = NULL);
#endif
 
#if AF_API_VERSION >= 34
        void setAxesLimits(const array &x, const array &y, const bool exact = false);
#endif
 
#if AF_API_VERSION >= 34
        void setAxesLimits(const array &x, const array &y, const array &z,
                           const bool exact = false);
#endif
 
#if AF_API_VERSION >= 34
        void setAxesLimits(const float xmin, const float xmax,
                           const float ymin, const float ymax,
                           const bool exact = false);
#endif
 
#if AF_API_VERSION >= 34
        void setAxesLimits(const float xmin, const float xmax,
                           const float ymin, const float ymax,
                           const float zmin, const float zmax,
                           const bool exact = false);
#endif
 
#if AF_API_VERSION >= 34
        void setAxesTitles(const char * const xtitle = "X-Axis",
                           const char * const ytitle = "Y-Axis",
                           const char * const ztitle = NULL);
#endif
 
#if AF_API_VERSION >= 37
        void setAxesLabelFormat(const char *const xformat = "4.1%f",
                                const char *const yformat = "4.1%f",
                                const char *const zformat = NULL);
#endif
 
        void grid(const int rows, const int cols);
 
        void show();
 
        bool close();
 
#if AF_API_VERSION >= 33
        void setVisibility(const bool isVisible);
#endif
 
        inline Window& operator()(const int r, const int c) {
            _r = r; _c = c;
            return *this;
        }
};
 
}
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
AFAPI af_err af_create_window(af_window *out, const int width, const int height, const char* const title);
 
AFAPI af_err af_set_position(const af_window wind, const unsigned x, const unsigned y);
 
AFAPI af_err af_set_title(const af_window wind, const char* const title);
 
#if AF_API_VERSION >= 31
AFAPI af_err af_set_size(const af_window wind, const unsigned w, const unsigned h);
#endif
 
AFAPI af_err af_draw_image(const af_window wind, const af_array in, const af_cell* const props);
 
AF_DEPRECATED("Use af_draw_plot_nd or af_draw_plot_2d instead")
AFAPI af_err af_draw_plot(const af_window wind, const af_array X, const af_array Y, const af_cell* const props);
 
#if AF_API_VERSION >= 32
AF_DEPRECATED("Use af_draw_plot_nd or af_draw_plot_3d instead")
AFAPI af_err af_draw_plot3(const af_window wind, const af_array P, const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_plot_nd(const af_window wind, const af_array P, const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_plot_2d(const af_window wind, const af_array X, const af_array Y,
                             const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_plot_3d(const af_window wind,
                             const af_array X, const af_array Y, const af_array Z,
                             const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 33
AF_DEPRECATED("Use af_draw_scatter_nd or af_draw_scatter_2d instead")
AFAPI af_err af_draw_scatter(const af_window wind, const af_array X, const af_array Y,
                             const af_marker_type marker, const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 33
AF_DEPRECATED("Use af_draw_scatter_nd or af_draw_scatter_3d instead")
AFAPI af_err af_draw_scatter3(const af_window wind, const af_array P,
                              const af_marker_type marker, const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_scatter_nd(const af_window wind, const af_array P,
                                const af_marker_type marker, const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_scatter_2d(const af_window wind, const af_array X, const af_array Y,
                                const af_marker_type marker, const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_scatter_3d(const af_window wind,
                                const af_array X, const af_array Y, const af_array Z,
                                const af_marker_type marker, const af_cell* const props);
#endif
 
AFAPI af_err af_draw_hist(const af_window wind, const af_array X, const double minval, const double maxval, const af_cell* const props);
 
#if AF_API_VERSION >= 32
AFAPI af_err af_draw_surface(const af_window wind, const af_array xVals, const af_array yVals, const af_array S, const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_vector_field_nd(const af_window wind,
                const af_array points, const af_array directions,
                const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_vector_field_3d(
                const af_window wind,
                const af_array xPoints, const af_array yPoints, const af_array zPoints,
                const af_array xDirs, const af_array yDirs, const af_array zDirs,
                const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_draw_vector_field_2d(
                const af_window wind,
                const af_array xPoints, const af_array yPoints,
                const af_array xDirs, const af_array yDirs,
                const af_cell* const props);
#endif
 
AFAPI af_err af_grid(const af_window wind, const int rows, const int cols);
 
#if AF_API_VERSION >= 34
AFAPI af_err af_set_axes_limits_compute(const af_window wind,
                                        const af_array x, const af_array y, const af_array z,
                                        const bool exact,
                                        const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_set_axes_limits_2d(const af_window wind,
                                   const float xmin, const float xmax,
                                   const float ymin, const float ymax,
                                   const bool exact,
                                   const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_set_axes_limits_3d(const af_window wind,
                                   const float xmin, const float xmax,
                                   const float ymin, const float ymax,
                                   const float zmin, const float zmax,
                                   const bool exact,
                                   const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 34
AFAPI af_err af_set_axes_titles(const af_window wind,
                                const char * const xtitle,
                                const char * const ytitle,
                                const char * const ztitle,
                                const af_cell* const props);
#endif
 
#if AF_API_VERSION >= 37
AFAPI af_err af_set_axes_label_format(const af_window wind,
                                      const char *const xformat,
                                      const char *const yformat,
                                      const char *const zformat,
                                      const af_cell *const props);
#endif
 
AFAPI af_err af_show(const af_window wind);
 
AFAPI af_err af_is_window_closed(bool *out, const af_window wind);
 
#if AF_API_VERSION >= 33
AFAPI af_err af_set_visibility(const af_window wind, const bool is_visible);
#endif
 
AFAPI af_err af_destroy_window(const af_window wind);
 
#ifdef __cplusplus
}
 
#endif