3d.h

Go to the documentation of this file.

/*=========================================================================

GFX - a small graphics library 

Copyright (C) 2004  Rafael de Oliveira Jannone

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Contact the author:
        by e-mail : rafael AT jannone DOT org
        homepage  : http://jannone.org/gfxlib
        ICQ UIN   : 10115284

See the License at http://www.gnu.org/copyleft/lesser.txt

=========================================================================*/

// 3D.H : 3D graphics and vectors functions (header)

/* === WARNING ==

        This is a work-in-progress, meaning that most of this code is unstable
        and it's subject to future changes.  Also, most of it is very hackish,
        not properly cleaned up nor tested.

   === WARNING == */

// note 1: this code uses fixed-point arithmetic
// note 2: every angle is one byte, to be mapped on the lookup tables
// note 3: you must create the look up tables before doing anything

#ifndef V3D_H
#define V3D_H

#include "gfx.h"

extern int *tcos;

extern int *tsin;

typedef struct {
        int x;  
        int y;  
        int z;  
} vector_t;

typedef struct {
        vector_t* vertexes[3];  
} triangle_t;

typedef struct {
        int pcount;     
        int tcount;     

        vector_t* points;       
        triangle_t* triangles;  
} mesh_t;

typedef struct {
        mesh_t* mesh;   
        u_char rot_x;   
        u_char rot_y;   
        u_char rot_z;   
        int trans_x;    
        int trans_y;    
        int trans_z;    
} object_t;

extern void create_lookup_tables();

extern void destroy_lookup_tables();

extern mesh_t* mesh_new(int pcount, int tcount);

extern void mesh_delete(mesh_t* mesh);

extern void vector_cross_product (vector_t* v1, vector_t* v2, vector_t* r);

extern int vector_cross_product_z (vector_t* v1, vector_t* v2);

extern int vector_dot_product (vector_t* v1, vector_t* v2);

extern int vector_length_squared (vector_t *v);

extern int vector_length(vector_t *v);

extern void vector_normalize(vector_t *p, vector_t *r);

extern void vector_scalar(vector_t *v, int s, vector_t* r);

extern void vector_add(vector_t *v1, vector_t *v2, vector_t *r);

extern void vector_subtract (vector_t *v1, vector_t *v2, vector_t *r);

extern int vector_distance (vector_t *v1, vector_t *v2);

extern void vector_rotate(vector_t* p, u_char angle_x, u_char angle_y, u_char angle_z, vector_t* r);

extern void object_apply_transformations(object_t* obj, vector_t* pbuffer, int x, int y);

extern void object_render_wireframe(surface_t* s, object_t* obj, vector_t* pbuffer);

extern void object_render_flatshading(surface_t* s, object_t* obj, vector_t* pbuffer, int* low, int* high, vector_t* light);

#endif

---