Blender Plugin - PhilipPragerUrbina/DOGERAY GitHub Wiki

The best way to make scene files is with the blender plugin! Install and use just like any plugin. Export just like any format! Import may be slow with larger models but it is similar in speed to OBJ.


Things to consider:

Triangulate everything

Camera position is exported

Unfortunately Auto smooth can not be exported from blender. Use edge split modifier instead for same results(make sure to apply)

The one selected object is exported. Multiple materials are supported so you can just combine your objects before export with CTRL J

Make sure to have your textures in the same directory you will be exporting to

World Environment Textures are also exported(Alignment may be different)


Materials

Material type is decided from values in a Principled Shader(make sure your object has one) . For example if metallic is above 0.5 the object will have a metal material in Dogeray.

Here are all the values and what the do:

principled.inputs['Metallic'] >0.5 = Metal

principled.inputs['Specular'] >0.7 = Glossy

principled.inputs['Transmission'] > 0.5 = Glass

principled.inputs['Emission'] >0.5 = Emissive

principled.inputs['Roughness'] = Roughness for metal or glossy , can also be texture

principled.inputs['IOR'] = Refraction index for glass

principled.inputs['Color'] = main color, color texture, or emissive color

Emission color and brightness is done through main color

By default the material is diffuse.


Settings

There are a few export settings:

Samples per Pixel =How many samples per update

Max bounces = Max bounces per ray

Emission Brightness = How much emission colors should be multiplied. Higher Number means brighter lights.

Background Intensity = How intense background light should be. 1 is normal.

FOV = Field of View

There are also two settings for screen/image resolution. Default is 720p which runs pretty well.

There are also a two settings for Depth of field

There is also a setting for the point the camera should look at


Troubleshooting

Converting High Res textures Takes a while!!! Blender may freeze up for a bit after export. Closing blender early might cause you to be missing some textures but the file itself should be fine. You can manually convert textures and put them in the RTS file directory at: https://replit.com/@PhilipPrager1/ppm-converter#main.py

Avoid special characters in texture file names. They may cause the texture to not be read.

If you update the any textures and want to export the RTS file again. Delete the ppm file with the name of the texture in the RTS directory in order to get blender to generate a new one with the updated texture.