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 [unused]
   \param x,y,z focus coordinates
 */
int Nviz_get_focus(nv_data *data UNUSED, 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 [unused]
   \param x, y, z focus coordinates
 */
int Nviz_set_focus(nv_data *data UNUSED, 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 [unused]
 */
int Nviz_has_focus(nv_data *data UNUSED)
{
    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 [unused]
   \param min,max z range
 */
int Nviz_get_zrange(nv_data *data UNUSED, float *min, float *max)
{
    GS_get_zrange_nz(min, max);
    return 1;
}
 
/*!
   \brief Get largest dimension
 
   \param data nviz data [unused]
 */
float Nviz_get_longdim(nv_data *data UNUSED)
{
    float dim;
 
    GS_get_longdim(&dim);
 
    return dim;
}