position.c

Go to the documentation of this file.

/*!
   \file lib/nviz/position.c

   \brief Nviz library -- Position, focus settings

   Based on visualization/nviz/src/position.c

   (C) 2008, 2010 by the GRASS Development Team
   This program is free software under the GNU General Public License
   (>=v2). Read the file COPYING that comes with GRASS for details.

   \author Updated/modified by Martin Landa <landa.martin gmail.com> (Google SoC 2008/2010)
 */

#include <grass/glocale.h>
#include <grass/nviz.h>

/*!
   Initialize view, position, lighting settings (focus)

   Set position to center of view
 */
void Nviz_init_view(nv_data * data)
{
    GS_init_view();
    Nviz_set_focus_state(1);    /* center of view */

    /* set default lights (1 & 2) */
    Nviz_set_light_position(data, 1, 0.68, -0.68, 0.80, 0.0);
    Nviz_set_light_bright(data, 1, 0.8);
    Nviz_set_light_color(data, 1, 255, 255, 255);
    Nviz_set_light_ambient(data, 1, 0.2);
    Nviz_set_light_position(data, 2, 0.0, 0.0, 1.0, 0.0);
    Nviz_set_light_bright(data, 2, 0.5);
    Nviz_set_light_color(data, 2, 255, 255, 255);
    Nviz_set_light_ambient(data, 2, 0.3);

    return;
}

/*!
   \brief Set focus state

   \param state_flag 1 for center view, 0 use viewdir

   \return 1 on success
   \return 0 on failure
 */
int Nviz_set_focus_state(int state_flag)
{
    if (state_flag == 1)
        GS_set_infocus();       /* return center of view */
    else if (state_flag == 0)
        GS_set_nofocus();       /* no center of view -- use viewdir */
    else {
        G_warning(_("Unable to set focus"));
        return 0;
    }

    return 1;
}

/*!
   \brief Set focus based on loaded map

   If <i>map</i> is MAP_OBJ_UNDEFINED, set focus from first
   surface/volume in the list.

   \param type map object type
   \param id map object id

   \return 0 on no focus
   \return id id of map object used for setting focus
 */
int Nviz_set_focus_map(int type, int id)
{
    if (GS_num_surfs() < 0 && GVL_num_vols() < 0) {
        GS_set_nofocus();
        return 0;
    }

    if (type == MAP_OBJ_UNDEFINED) {
        int *surf_list, num_surfs, *vol_list;

        if (GS_num_surfs() > 0) {
            surf_list = GS_get_surf_list(&num_surfs);
            id = surf_list[0];
            G_free(surf_list);

            GS_set_focus_center_map(id);
        }

        if (GVL_num_vols() > 0) {
            vol_list = GVL_get_vol_list(&num_surfs);
            id = vol_list[0];
            G_free(vol_list);

            GVL_set_focus_center_map(id);
        }
        return id;
    }

    if (type == MAP_OBJ_SURF) {
        GS_set_focus_center_map(id);
    }
    else if (type == MAP_OBJ_VOL) {
        GVL_set_focus_center_map(id);
    }

    return id;
}

/*!
   \brief Get focus

   \param data nviz data
   \param x,y,z focus coordinates
 */
int Nviz_get_focus(nv_data * data, float *x, float *y, float *z)
{
    float realto[3];

    /* Get current center */
    GS_get_focus(realto);
    *x = realto[0];
    *y = realto[1];
    *z = realto[2];
    /* old nviz code is more complicated and it doesn't work properly, */
    /* no idea why */

    return 1;

}

/*!
   \brief Set focus

   \param data nviz data
   \param x, y, z focus coordinates
 */
int Nviz_set_focus(nv_data * data, float x, float y, float z)
{
    float realto[3];

    realto[0] = x;
    realto[1] = y;
    realto[2] = z;
    GS_set_focus(realto);
    /* old nviz code is more complicated and it doesn't work properly, */
    /* no idea why */

    return 1;

}

/*!
   \brief Test focus

   \param data nviz data
 */
int Nviz_has_focus(nv_data * data)
{
    float realto[3];

    if (GS_get_focus(realto))
        return 1;
    else
        return 0;
}

/*!
   \brief Get xy range

   \param data nviz data
 */
float Nviz_get_xyrange(nv_data * data)
{
    return data->xyrange;
}

/*!
   \brief Get z range

   \param data nviz data
   \param min,max z range
 */
int Nviz_get_zrange(nv_data * data, float *min, float *max)
{
    GS_get_zrange_nz(min, max);
    return 1;
}

/*!
   \brief Get largest dimension

   \param data nviz data
 */
float Nviz_get_longdim(nv_data * data)
{
    float dim;

    GS_get_longdim(&dim);

    return dim;
}