3D Rendering API v0.5.1 UPDATED! (Way better erformance + new functionalities)

• Vertical rotation of objects
• Custom vertexshaders
• Texture support (may not be implemented, because it would probably be very laggy to use real-time)

• Renders 3D objects
• Ability to walk around
• Ability to look left and right
• Give objects rotation values

• Renders 3D boxes
• Ability to walk left and right
• Ability to look up and down
• Ability to fly up and down
• More efficient code

• The code is now split into an API and a demo :D/>

• Now uses a buffer (to avoid flickering)
• You can now create your own models
• Square objects look square on screen because the not-square pixels have been compensated for
• The oriëntation of objects is now changeable
• Objects are not rendered when they're not in sight
• Sky and ground colors are easily changed as background
• Change sorting algorithm to use table.sort() for better performance
• Added support for Bomb Bloke's blittle API - Render distance is changeable
• Using term.blit() to render the screen for better performance
• Cleaner code

• Added support for multiple renders at the same time
• Polygons are now only rendered from one side unless specified otherwise. (For better performance)
• Crash fix
• Lagspike fixes
• Performance is better

• Added the ability to trace what's on the screen at certain coordinates and returns the index of the object with the index of the polygon of the model that corresponds to that object
• Added the ability to manually load models as a tabl
• Added the ability to get the model of an object my model name if it has already been loaded
• Performance is way better
• The polygons can now have a character and char color in case the BLittle function isn't used
• Way cleaner code
• (Documentation added)
• (More demos and comments added to the improved engine)

jv110, on 06 June 2016 - 05:35 PM said:

You should do a 3D rendering API, not a program in which you can walk around and add blocks.

ReBraLaCC, on 06 June 2016 - 09:53 PM said:

For some reason i cant access the video using the link, whats the name of the video?

Bomb Bloke, on 08 June 2016 - 02:29 AM said:

If you switch the Youtube link from "https" to "http", it'll actually embed into your post.

Bomb Bloke, on 08 June 2016 - 02:29 AM said:

If you switch the Youtube link from "https" to "http", it'll actually embed into your post.

Bomb Bloke, on 09 June 2016 - 02:29 AM said:

You still had URL tags around it, forcing it to be treated as a link. I've removed them.

unnamedcoder, on 11 June 2016 - 06:38 PM said:

Love it! Nice, smooth and efficient, keep it up, it'd be cool if you could implement this into a game engine, for example having map creation, object creation, object placement, etc! Can't wait to see the future updates though!

Xelostar, on 12 June 2016 - 06:56 AM said:

Thank you for your compliment! :D/>
I will split my code into an API other people can use and a demo which you can also edit.
I am almost done doing this! :D/> (I am having a little trouble debugging, but hopefully it will be finished soon. :D/>)

unnamedcoder, on 12 June 2016 - 09:35 PM said:

Xelostar, on 12 June 2016 - 06:56 AM said:

Thank you for your compliment! :D/>
I will split my code into an API other people can use and a demo which you can also edit.
I am almost done doing this! :D/> (I am having a little trouble debugging, but hopefully it will be finished soon. :D/>)

Good luck with the debugging, I'd like to know how you add shapes to the world, do you use files to import them, if so could you show me the code to generate the shapes? I'd love to have a go at making an api which allows you to create new objects for the world and import them, sort of like .mdl files

shapeFrame = {
    coordinates = {
	    {x = -0.5, y = -0.5, z = -0.5}, -- These are the coordinates for one corner
	    {x = -0.5, y = -0.5, z = 0.5},
	    {x = -0.5, y = 0.5, z = 0.5},
	    {x = -0.5, y = 0.5, z = 0.5},
	    {x = 0.5, y = -0.5, z = 0.5},
	    {x = 0.5, y = -0.5, z = 0.5},
	    {x = 0.5, y = 0.5, z = 0.5},
	    {x = 0.5, y = 0.5, z = 0.5},
    },
    lines = {
	    {1, 5, colors.red}, -- Refer to the index numbers of the coordinates and the color of the line
	    {2, 6, colors.red},
	    {3, 7, colors.red},
	    {4, 8, colors.red},
	    {1, 3, colors.red},
	    {2, 4, colors.red},
	    {5, 7, colors.red},
	    {6, 8, colors.red},
	    {1, 2, colors.red},
	    {3, 4, colors.red},
	    {5, 6, colors.red},
	    {7, 8, colors.red},
    }
}

Xelostar, on 12 June 2016 - 10:07 PM said:

unnamedcoder, on 12 June 2016 - 09:35 PM said:

Xelostar, on 12 June 2016 - 06:56 AM said:

Thank you for your compliment! :D/>
I will split my code into an API other people can use and a demo which you can also edit.
I am almost done doing this! :D/> (I am having a little trouble debugging, but hopefully it will be finished soon. :D/>)

Good luck with the debugging, I'd like to know how you add shapes to the world, do you use files to import them, if so could you show me the code to generate the shapes? I'd love to have a go at making an api which allows you to create new objects for the world and import them, sort of like .mdl files

Well, I was thinking about that myself, but I like working together! :D/>
I will probably use some kind of table with relatve coordinates and a few things to draw the lines and stuff. The frame currently looks something like this:

shapeFrame = {
	coordinates = {
		{x = -0.5, y = -0.5, z = -0.5}, -- These are the coordinates for one corner
		{x = -0.5, y = -0.5, z = 0.5},
		{x = -0.5, y = 0.5, z = 0.5},
		{x = -0.5, y = 0.5, z = 0.5},
		{x = 0.5, y = -0.5, z = 0.5},
		{x = 0.5, y = -0.5, z = 0.5},
		{x = 0.5, y = 0.5, z = 0.5},
		{x = 0.5, y = 0.5, z = 0.5},
	},
	lines = {
		{1, 5, colors.red}, -- Refer to the index numbers of the coordinates and the color of the line
		{2, 6, colors.red},
		{3, 7, colors.red},
		{4, 8, colors.red},
		{1, 3, colors.red},
		{2, 4, colors.red},
		{5, 7, colors.red},
		{6, 8, colors.red},
		{1, 2, colors.red},
		{3, 4, colors.red},
		{5, 6, colors.red},
		{7, 8, colors.red},
	}
}

If you can pull such a thing off, I will make my API able to load those kind of models. If you have a better idea of how a model can be saved, please let me know.

Xelostar, on 12 June 2016 - 10:07 PM said:

Well, I was thinking about that myself, but I like working together! :D/>
I will probably use some kind of table with relatve coordinates and a few things to draw the lines and stuff. The frame currently looks something like this:

shapeFrame = {
	coordinates = {
		{x = -0.5, y = -0.5, z = -0.5}, -- These are the coordinates for one corner
		{x = -0.5, y = -0.5, z = 0.5},
		{x = -0.5, y = 0.5, z = 0.5},
		{x = -0.5, y = 0.5, z = 0.5},
		{x = 0.5, y = -0.5, z = 0.5},
		{x = 0.5, y = -0.5, z = 0.5},
		{x = 0.5, y = 0.5, z = 0.5},
		{x = 0.5, y = 0.5, z = 0.5},
	},
	lines = {
		{1, 5, colors.red}, -- Refer to the index numbers of the coordinates and the color of the line
		{2, 6, colors.red},
		{3, 7, colors.red},
		{4, 8, colors.red},
		{1, 3, colors.red},
		{2, 4, colors.red},
		{5, 7, colors.red},
		{6, 8, colors.red},
		{1, 2, colors.red},
		{3, 4, colors.red},
		{5, 6, colors.red},
		{7, 8, colors.red},
	}
}

If you can pull such a thing off, I will make my API able to load those kind of models. If you have a better idea of how a model can be saved, please let me know.

unnamedcoder, on 13 June 2016 - 03:56 PM said:

–snip–
could you possibly provide a 2d linedrawing api for me?

paintutils.drawLine(x1, y1, x2, y2, color)

for lineNr, lineCoordinates in pairs(linesToDraw) do
  paintutils.drawLine(lineCoordinates.x, lineCoordinates.y, lineCoordinates.x2, lineCoordinates.y2, lineColor)
end

Xelostar, on 13 June 2016 - 04:55 PM said:

I want to see what you come up with! :)/>
If you want to have a 2d line drawing API, you could just use:

paintutils.drawLine(x1, y1, x2, y2, color)

But I assume you want something like this:

for lineNr, lineCoordinates in pairs(linesToDraw) do
  paintutils.drawLine(lineCoordinates.x, lineCoordinates.y, lineCoordinates.x2, lineCoordinates.y2, lineColor)
end

Anyway, please let me know when you are getting somewhere! :)/>

Restioson, on 14 June 2016 - 02:36 PM said:

This looks really amazing! Nice work! +1

Xelostar, on 14 June 2016 - 01:36 PM said:

That is kind of how my 3D printer modeling program works… :P/>
I advise you to wait until I release my API. Then you can use it to draw what people are creating.
Well, it still is hard to create a program for creating models…
Maybe you can make it so that the user can click somewhere on the screen (2d) and then give a height value to that point. Later the user can connect these points to draw lines. I wish you a lot of succes! :D/>

unnamedcoder, on 14 June 2016 - 04:00 PM said:

Xelostar, on 14 June 2016 - 01:36 PM said:

That is kind of how my 3D printer modeling program works… :P/>
I advise you to wait until I release my API. Then you can use it to draw what people are creating.
Well, it still is hard to create a program for creating models…
Maybe you can make it so that the user can click somewhere on the screen (2d) and then give a height value to that point. Later the user can connect these points to draw lines. I wish you a lot of succes! :D/>

Yeah I was thinking about that, I could make it next month, since I have to do exams starting monday and it is getting hectic for me, I need to spend my time on revision etc. I know exactly how I'm going to do it, I'll just need some time, also could you specify the dimensions of the model?

Xelostar, on 14 June 2016 - 04:33 PM said:

unnamedcoder, on 14 June 2016 - 04:00 PM said:

Xelostar, on 14 June 2016 - 01:36 PM said:

That is kind of how my 3D printer modeling program works… :P/>
I advise you to wait until I release my API. Then you can use it to draw what people are creating.
Well, it still is hard to create a program for creating models…
Maybe you can make it so that the user can click somewhere on the screen (2d) and then give a height value to that point. Later the user can connect these points to draw lines. I wish you a lot of succes! :D/>

Yeah I was thinking about that, I could make it next month, since I have to do exams starting monday and it is getting hectic for me, I need to spend my time on revision etc. I know exactly how I'm going to do it, I'll just need some time, also could you specify the dimensions of the model?

Awesome! Take your time! :)/>
If you mean that x and z are length and width and that y is the height, jsut like in minecraft, then here is your answer.
If you mean how big it shoud be:
from (-0.5, -0.5, -0.5) to (0.5, 0.5, 0.5) would be great! :)/>

unnamedcoder, on 16 June 2016 - 04:12 PM said:

Xelostar, on 14 June 2016 - 04:33 PM said:

unnamedcoder, on 14 June 2016 - 04:00 PM said:

Xelostar, on 14 June 2016 - 01:36 PM said:

That is kind of how my 3D printer modeling program works… :P/>
I advise you to wait until I release my API. Then you can use it to draw what people are creating.
Well, it still is hard to create a program for creating models…
Maybe you can make it so that the user can click somewhere on the screen (2d) and then give a height value to that point. Later the user can connect these points to draw lines. I wish you a lot of succes! :D/>

Yeah I was thinking about that, I could make it next month, since I have to do exams starting monday and it is getting hectic for me, I need to spend my time on revision etc. I know exactly how I'm going to do it, I'll just need some time, also could you specify the dimensions of the model?

Awesome! Take your time! :)/>
If you mean that x and z are length and width and that y is the height, jsut like in minecraft, then here is your answer.
If you mean how big it shoud be:
from (-0.5, -0.5, -0.5) to (0.5, 0.5, 0.5) would be great! :)/>

Alright, I've made a quick mock-up for the program, I was thinking of something like this:

Sorry for the messy handwriting :P/>

Xelostar, on 16 June 2016 - 08:32 PM said:

Looks promising! I want the model to be a 1 by 1 by 1. For other sizes, I will probably add a rotation and a size value. :-)
Can you make the "drawing space" a 10 by 10? That would be useful. I will probably upload by API tomorrow. :D/>

unnamedcoder, on 16 June 2016 - 09:14 PM said:

Xelostar, on 16 June 2016 - 08:32 PM said:

Looks promising! I want the model to be a 1 by 1 by 1. For other sizes, I will probably add a rotation and a size value. :-)
Can you make the "drawing space" a 10 by 10? That would be useful. I will probably upload by API tomorrow. :D/>

Sure, 10 by 10, I won't be able to make this until the 7th of July, so unless u wanna make it, go ahead

jv110, on 18 June 2016 - 01:27 AM said:

Can I maybe help? I can add filled faces and textures. I don't wanna help the competitor, but I don't think this is really the same thing.

function drawFilledFace(face) --or something like that
    ...
end

face = {
  color = colors.red,
  coordinates = {
    {x = 10, y = 8},
    {x = 10, y = 10},
    {x = 20, y = 18},
    {x = 15, y = 8},
  },
}

Xelostar, on 18 June 2016 - 07:46 AM said:

–snip–

Incinirate, on 18 June 2016 - 07:49 AM said:

Xelostar, on 18 June 2016 - 07:46 AM said:

–snip–

Not to intrude or anything, but a good way of storing faces (in my experience) is to just reference vertices, it cuts down on memory and redundancy.
This looks really nice though! Can't wait to see what it turns into! :D/>

Xelostar, on 18 June 2016 - 08:08 AM said:

Incinirate, on 18 June 2016 - 07:49 AM said:

Xelostar, on 18 June 2016 - 07:46 AM said:

–snip–

Not to intrude or anything, but a good way of storing faces (in my experience) is to just reference vertices, it cuts down on memory and redundancy.
This looks really nice though! Can't wait to see what it turns into! :D/>

I have thought of an algorithm. I don't really know what you mean with reference verticles. Can you send me a link? I also just noticed that there is a GPU API. It seems to be work-in-progres, though. Anyway, thank you for your compliment! :)/>

vert1 = {0,0,0}
vert2 = {1,0,0}
vert3 = {0,1,0}
face = {vert1,vert2,vert3}

Incinirate, on 18 June 2016 - 08:12 AM said:

Sorry, should have been a little more explicit, what I meant is, that since you already have defined vertices for drawing lines to create objects, you can reference 3/4 of them to create a triange/quad respectively. For example:

vert1 = {0,0,0}
vert2 = {1,0,0}
vert3 = {0,1,0}
face = {vert1,vert2,vert3}

You then have all the information to draw a triangle in face, you can easily change it to work with quadrilaterals as well.

face = { {0,0,0}, {1,0,0}, {0,1,0} }

Bomb Bloke, on 08 June 2016 - 02:29 AM said:

If you switch the Youtube link from "https" to "http", it'll actually embed into your post.

[url="https://www.youtube.com/watch?v=-zEXvgoZhLs"]https://www.youtube.com/watch?v=Sc_2kFtxfdQ[/url]
[media]http://www.youtube.com/watch?v=Sc_2kFtxfdQ[/media]

http://www.youtube.com/watch?v=-zEXvgoZhLs
http://www.youtube.com/watch?v=Sc_2kFtxfdQ

Bomb Bloke, on 19 May 2017 - 03:08 PM said:

Currently I see:

[url="https://www.youtube.com/watch?v=-zEXvgoZhLs"]https://www.youtube.com/watch?v=Sc_2kFtxfdQ[/url]
[media]http://www.youtube.com/watch?v=Sc_2kFtxfdQ[/media]

You probably want:

http://www.youtube.com/watch?v=-zEXvgoZhLs
http://www.youtube.com/watch?v=Sc_2kFtxfdQ

Note that the rich-text editor is not your friend. Use the light switch up the top left of the posting dialogue box in order to toggle it.

Tag365, on 26 May 2017 - 01:35 AM said:

Why don't you disable the rich text editor by default???

dawid26pl, on 01 September 2017 - 07:50 PM said:

I would really love to see how it would look with shadows

Jummit, on 12 September 2017 - 08:36 AM said:

dawid26pl, on 01 September 2017 - 07:50 PM said:

I would really love to see how it would look with shadows

I think you could make cool shaders if you change the palette to a white-gray-black thing. I don't like the default colors. Look: you could make this!

Gorzoid, on 12 September 2017 - 10:30 AM said:

Jummit, on 12 September 2017 - 08:36 AM said:

dawid26pl, on 01 September 2017 - 07:50 PM said:

I would really love to see how it would look with shadows

I think you could make cool shaders if you change the palette to a white-gray-black thing. I don't like the default colors. Look: you could make this!

Your proxy is leaking you l337 h4x0r

Jummit, on 12 September 2017 - 08:36 AM said:

dawid26pl, on 01 September 2017 - 07:50 PM said:

I would really love to see how it would look with shadows

I think you could make cool shaders if you change the palette to a white-gray-black thing. I don't like the default colors. Look: you could make this!

Xelostar, on 11 November 2017 - 01:13 PM said:

Also: how do I change the title?

SquidDev, on 11 November 2017 - 01:21 PM said:

Xelostar, on 11 November 2017 - 01:13 PM said:

Also: how do I change the title?

When editing the original post, press "Use full editor" at the bottom - that will allow you to edit the title, tags, and post settings.

On topic, the update looks nice. I'm always impressed when people manage to achieve a relatively high FPS with these things. In your video there seemed to be a couple of issues with disappearing faces - I'm wondering if that's a bug in your renderer or was it just the background and shape had the same colour?

jv110, on 14 February 2018 - 04:29 AM said:

Can it render textures in the first place? If you add that feature, you'll see the reason why what you're trying to make hasn't been made before. Doom isn't 3D, by the way.

LoganDark2, on 14 February 2018 - 06:11 PM said:

Mediafire why?!

Why not pastebin or GitHub?

Xelostar, on 15 February 2018 - 11:08 AM said:

my pastebin is 100% full since I have a free account.

KingofGamesYami, on 15 February 2018 - 02:13 PM said:

There is no limit to # of public pastes on a free pastebin account.

Xelostar, on 15 February 2018 - 11:37 PM said:

There is. It's 25. Once you have reached that many pastes, you can only paste as a guest. If you want me to, I can send a screenshot?

Xelostar, on 15 February 2018 - 11:37 PM said:

There is. It's 25. Once you have reached that many pastes, you can only paste as a guest. If you want me to, I can send a screenshot?

roger109z, on 19 February 2018 - 05:20 AM said:

would it be possible for you to give a little documentation on the API? like what the arguments are and such
thanks in advance!

Xelostar, on 19 February 2018 - 10:53 AM said:

roger109z, on 19 February 2018 - 05:20 AM said:

would it be possible for you to give a little documentation on the API? like what the arguments are and such
thanks in advance!

Yes, some people have asked me now. It's fairly simple, so I assumed people would be able to figure it out, but I understand a documentation could be very helpful. It's coming soon. :)/>

Another thing:
could you make an option to rotate on the X axis?

also I noticed while making a model it's hard to know which axis something shows on
The API looks amazing so far though!

Xelostar, on 19 February 2018 - 10:06 PM said:

For the backface culling? Yeah, I had that too. I just made the models at once and then I swapped all the ones that were wrong. I don't know if there's an easier way. Maybe if someone made a modelling program :P/>
Thanks for the compliment! :D/>

EDIT: quotes messed up, but you still get my point ;)/>

roger109z, on 20 February 2018 - 12:05 AM said:

maybe you could have an option while making the face to set which way it faces? I don't really know how this would be stored though
Also you deserve it this API is super cool!
EDIT: I am attempting to make a game with your api, kind of like a tdm/ffa first person shooter btw