scene_geom.h

Go to the documentation of this file.

/* -*- mode: C; c-basic-offset: 4; -*- */
/* ex: set shiftwidth=4 tabstop=4 expandtab: */
/*
 * Copyright (c) 2015, Rice University
 * All rights reserved.
 *
 * Author(s): Neil T. Dantam <ntd@rice.edu>
 *
 *   Redistribution and use in source and binary forms, with or
 *   without modification, are permitted provided that the following
 *   conditions are met:
 *   * Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *   * Redistributions in binary form must reproduce the above
 *     copyright notice, this list of conditions and the following
 *     disclaimer in the documentation and/or other materials provided
 *     with the distribution.
 *   * Neither the name of copyright holder the names of its
 *     contributors may be used to endorse or promote products derived
 *     from this software without specific prior written permission.
 *
 *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
 *   CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
 *   INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 *   MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 *   DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
 *   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 *   USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 *   AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 *   LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 *   ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *   POSSIBILITY OF SUCH DAMAGE.
 *
 */

#ifndef AMINO_RX_SCENE_GEOM_H
#define AMINO_RX_SCENE_GEOM_H

/*-----------*/
/*- Options -*/
/*-----------*/

struct aa_rx_geom_opt;

AA_API struct aa_rx_geom_opt*
aa_rx_geom_opt_create();

AA_API void
aa_rx_geom_opt_destroy(struct aa_rx_geom_opt*);

AA_API void
aa_rx_geom_opt_set_no_shadow (
    struct aa_rx_geom_opt *opt,
    int no_shadow );

AA_API int
aa_rx_geom_opt_get_no_shadow ( const struct aa_rx_geom_opt *opt );

AA_API int
aa_rx_geom_opt_get_visual ( const struct aa_rx_geom_opt *opt );

AA_API int
aa_rx_geom_opt_get_collision ( const struct aa_rx_geom_opt *opt );

AA_API double
aa_rx_geom_opt_get_color_red ( const struct aa_rx_geom_opt *opt );

AA_API double
aa_rx_geom_opt_get_color_blue ( const struct aa_rx_geom_opt *opt );


AA_API double
aa_rx_geom_opt_get_color_green ( const struct aa_rx_geom_opt *opt );

AA_API double
aa_rx_geom_opt_get_alpha ( const struct aa_rx_geom_opt *opt );

AA_API double
aa_rx_geom_opt_get_specular_red ( const struct aa_rx_geom_opt *opt );

AA_API double
aa_rx_geom_opt_get_specular_blue ( const struct aa_rx_geom_opt *opt );

AA_API double
aa_rx_geom_opt_get_specular_green ( const struct aa_rx_geom_opt *opt );

AA_API void
aa_rx_geom_opt_set_color3 (
    struct aa_rx_geom_opt *opt,
    double red, double blue, double green );

AA_API void
aa_rx_geom_opt_set_alpha (
    struct aa_rx_geom_opt *opt,
    double alpha );

AA_API void
aa_rx_geom_opt_set_visual (
    struct aa_rx_geom_opt *opt,
    int visual );

AA_API void
aa_rx_geom_opt_set_collision (
    struct aa_rx_geom_opt *opt,
    int collision );

AA_API void
aa_rx_geom_opt_set_specular3 (
    struct aa_rx_geom_opt *opt,
    double red, double green, double blue );


AA_API void
aa_rx_geom_opt_set_scale (
    struct aa_rx_geom_opt *opt,
    double scale );

AA_API double
aa_rx_geom_opt_get_scale (
    const struct aa_rx_geom_opt *opt );

/*----------*/
/*- Shapes -*/
/*----------*/


AA_API struct aa_rx_geom *
aa_rx_geom_copy( struct aa_rx_geom *src );

AA_API void
aa_rx_geom_destroy( struct aa_rx_geom *geom );

enum aa_rx_geom_shape {
    AA_RX_NOSHAPE,    
    AA_RX_MESH,       
    AA_RX_BOX,        
    AA_RX_SPHERE,     
    AA_RX_CYLINDER,   
    AA_RX_CONE,       
    AA_RX_GRID        
};

AA_API const char *aa_rx_geom_shape_str( enum aa_rx_geom_shape shape );

struct aa_rx_shape_box {
    double dimension[3];
};

struct aa_rx_shape_sphere {
    double radius;
};

struct aa_rx_shape_cylinder {
    double height;
    double radius;
};

struct aa_rx_shape_cone {
    double height;
    double start_radius;
    double end_radius;
};


struct aa_rx_shape_grid {
    double dimension[2];
    double delta[2];
    double width;
};

AA_API void *
aa_rx_geom_shape ( const struct aa_rx_geom *g,
                   enum aa_rx_geom_shape *shape_type );

AA_API struct aa_rx_geom *
aa_rx_geom_box (
    struct aa_rx_geom_opt *opt,
    const double dimension[3] );

AA_API struct aa_rx_geom *
aa_rx_geom_sphere (
    struct aa_rx_geom_opt *opt,
    double radius );

AA_API struct aa_rx_geom *
aa_rx_geom_cylinder (
    struct aa_rx_geom_opt *opt,
    double height,
    double radius );

AA_API struct aa_rx_geom *
aa_rx_geom_cone (
    struct aa_rx_geom_opt *opt,
    double height,
    double start_radius,
    double end_radius );

AA_API struct aa_rx_geom *
aa_rx_geom_grid (
    struct aa_rx_geom_opt *opt,
    const double dimension[2],
    const double delta[2],
    double width );

AA_API const struct aa_rx_geom_opt*
aa_rx_geom_get_opt ( const struct aa_rx_geom *geom );

AA_API struct aa_rx_cl_geom *
aa_rx_geom_get_collision ( const struct aa_rx_geom *geom );

AA_API void
aa_rx_geom_set_collision ( struct aa_rx_geom *geom, struct aa_rx_cl_geom * );

struct aa_rx_mesh;

AA_API struct aa_rx_mesh* aa_rx_mesh_create();

AA_API void aa_rx_mesh_destroy( struct aa_rx_mesh * mesh );

AA_API void aa_rx_mesh_set_vertices (
    struct aa_rx_mesh *mesh, size_t n,
    const float *vectors, int copy );

AA_API const float *aa_rx_mesh_get_vertices (
    const struct aa_rx_mesh *mesh, size_t *size );

AA_API const unsigned *aa_rx_mesh_get_indices (
    const struct aa_rx_mesh *mesh, size_t *size );

AA_API void aa_rx_mesh_set_normals (
    struct aa_rx_mesh *mesh, size_t n,
    const float *normals, int copy );

AA_API void aa_rx_mesh_set_indices (
    struct aa_rx_mesh *mesh, size_t n,
    const unsigned *indices, int copy );

AA_API void aa_rx_mesh_set_rgba (
    struct aa_rx_mesh *mesh,
    size_t width, size_t height,
    const uint8_t *rgba, int copy );

AA_API void aa_rx_mesh_set_uv (
    struct aa_rx_mesh *mesh,
    size_t n, const float *uv, int copy );

AA_API void aa_rx_mesh_set_texture (
    struct aa_rx_mesh *mesh,
    const struct aa_rx_geom_opt *opt );

AA_API struct aa_rx_geom *
aa_rx_geom_mesh (
    struct aa_rx_geom_opt *opt,
    struct aa_rx_mesh *mesh );

AA_API void
aa_rx_geom_attach (
    struct aa_rx_sg *sg,
    const char *frame,
    struct aa_rx_geom *geom );

AA_API unsigned
aa_rx_geom_refcount ( const struct aa_rx_geom *g );

AA_API unsigned
aa_rx_mesh_refcount ( const struct aa_rx_mesh *sg );

#endif /*AMINO_RX_SCENE_GEOM_H*/