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
 
#include "rxtype.h"
 
/*-----------*/
/*- Options -*/
/*-----------*/
 
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 struct aa_rx_geom *
aa_rx_geom_modify_opt( struct aa_rx_geom *src, struct aa_rx_geom_opt *opt );
 
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_RX_TORUS,      
    AA_RX_OCTREE,     
};
 
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;          
};
 
struct aa_rx_shape_torus {
    double angle;          
    double major_radius;   
    double minor_radius;   
};
 
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 struct aa_rx_geom *
aa_rx_geom_torus (
    struct aa_rx_geom_opt *opt,
    double angle,
    double major_radius,
    double minor_radius
    );
 
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*/